将 @dbml/core 从 10.x 升级到 11.x

根据 TypeScript 类型自动比较 @dbml/core 10.3.1 与 11.1.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	2
已修改的签名	4
已删除的类或接口成员	62
已修改的类或接口成员	19
新增弃用	0
要求变化（engines、peer 依赖）	0
新增导出	12

已删除的导出

import	export	kind	之前
`@dbml/core`	`CompilerError`	class	`class`
`@dbml/core`	`formatRecordValue`	variable	`any`

已修改的签名

export	之前	之后
`@dbml/core · Color`	`#${string}` \| "none"	`any`
`@dbml/core · Token`	`interface`	`any`
`@dbml/core · Element`	`class`	`any`
`@dbml/core · RawNote`	`interface`	`any`

已删除的类或接口成员

member	import	之前
`Ref.bind`	`@dbml/core`	`(selection: any): void`
`Ref.error`	`@dbml/core`	`(message: string): void`
`Ref.token`	`@dbml/core`	`Token`
`Ref.selection`	`@dbml/core`	`string`
`Enum.bind`	`@dbml/core`	`(selection: any): void`
`Enum.error`	`@dbml/core`	`(message: string): void`
`Enum.selection`	`@dbml/core`	`string`
`Check.id`	`@dbml/core`	`number`
`Check.bind`	`@dbml/core`	`(selection: any): void`
`Check.error`	`@dbml/core`	`(message: string): void`
`Check.token`	`@dbml/core`	`Token`
`Check.selection`	`@dbml/core`	`string`
`Field.id`	`@dbml/core`	`number`
`Field.bind`	`@dbml/core`	`(selection: any): void`
`Field.error`	`@dbml/core`	`(message: string): void`
`Field.token`	`@dbml/core`	`Token`
`Field.selection`	`@dbml/core`	`string`
`Index.id`	`@dbml/core`	`number`
`Index.bind`	`@dbml/core`	`(selection: any): void`
`Index.error`	`@dbml/core`	`(message: string): void`
`Index.token`	`@dbml/core`	`Token`
`Index.selection`	`@dbml/core`	`string`
`Table.bind`	`@dbml/core`	`(selection: any): void`
`Table.error`	`@dbml/core`	`(message: string): void`
`Table.token`	`@dbml/core`	`Token`
`Table.selection`	`@dbml/core`	`string`
`Schema.id`	`@dbml/core`	`number`
`Schema.bind`	`@dbml/core`	`(selection: any): void`
`Schema.error`	`@dbml/core`	`(message: string): void`
`Schema.token`	`@dbml/core`	`Token`
`Schema.selection`	`@dbml/core`	`string`
`Database.bind`	`@dbml/core`	`(selection: any): void`
`Database.error`	`@dbml/core`	`(message: string): void`
`Database.token`	`@dbml/core`	`Token`
`Database.selection`	`@dbml/core`	`string`
`Endpoint.id`	`@dbml/core`	`number`
`Endpoint.bind`	`@dbml/core`	`(selection: any): void`
`Endpoint.error`	`@dbml/core`	`(message: string): void`
`Endpoint.token`	`@dbml/core`	`Token`
`Endpoint.selection`	`@dbml/core`	`string`
`EnumValue.id`	`@dbml/core`	`number`
`EnumValue.bind`	`@dbml/core`	`(selection: any): void`
`EnumValue.error`	`@dbml/core`	`(message: string): void`
`EnumValue.token`	`@dbml/core`	`Token`
`EnumValue.selection`	`@dbml/core`	`string`
`StickyNote.bind`	`@dbml/core`	`(selection: any): void`
`StickyNote.error`	`@dbml/core`	`(message: string): void`
`StickyNote.token`	`@dbml/core`	`Token`
`StickyNote.selection`	`@dbml/core`	`string`
`TableGroup.bind`	`@dbml/core`	`(selection: any): void`
`TableGroup.error`	`@dbml/core`	`(message: string): void`
`TableGroup.token`	`@dbml/core`	`Token`
`TableGroup.selection`	`@dbml/core`	`string`
`IndexColumn.id`	`@dbml/core`	`number`
`IndexColumn.bind`	`@dbml/core`	`(selection: any): void`
`IndexColumn.error`	`@dbml/core`	`(message: string): void`
`IndexColumn.token`	`@dbml/core`	`Token`
`IndexColumn.selection`	`@dbml/core`	`string`
`TablePartial.bind`	`@dbml/core`	`(selection: any): void`
`TablePartial.error`	`@dbml/core`	`(message: string): void`
`TablePartial.token`	`@dbml/core`	`Token`
`TablePartial.selection`	`@dbml/core`	`string`

已修改的类或接口成员

member	之前	之后
`Ref.color`	`Color \| undefined`	`any`
`Ref.export`	`(): { endpoints: { schemaName: string; tableName: string; fieldNames: string[]; relation: any; }[]; name: string; onDelete: any; onUpdate: any; injectedPartialId?: number \| undefined; }`	`(): { endpoints: { schemaName: string; tableName: string; fieldNames: string[]; relation: any; }[]; name: string; onDelete: any; onUpdate: any; metadata: CustomMetadata; injectedPartialId?: number \| undefined; }`
`Ref.constructor`	`({ name, endpoints, onDelete, onUpdate, token, schema }: RawRef): Ref`	`({ name, endpoints, onDelete, onUpdate, note, metadata, token, schema }: RawRef): Ref`
`Ref.shallowExport`	`(): { name: string; onDelete: any; onUpdate: any; injectedPartialId?: number \| undefined; }`	`(): { name: string; onDelete: any; onUpdate: any; metadata: CustomMetadata; injectedPartialId?: number \| undefined; note: string; }`
`RawRef.color`	`Color \| undefined`	`any`
`RawSchema.note`	`RawNote \| undefined`	`any`
`RawSchema.token`	`Token \| undefined`	`any`
`RawSchema.noteToken`	`Token \| null \| undefined`	`any`
`StickyNote.color`	`Color \| undefined`	`any`
`StickyNote.export`	`(): { name: string; content: string; color?: Color \| undefined; metadata: CustomMetadata; }`	`(): { name: string; content: string; color?: any; metadata: CustomMetadata; }`
`IndexColumn.export`	`(): { type: any; value: any; }`	`(): { type: any; value: any; sortOrder?: "desc" \| undefined; }`
`IndexColumn.constructor`	`({ type, value, index }: { type: any; value: any; index: any; }): IndexColumn`	`({ type, value, sortOrder, index }: { type: any; value: any; sortOrder?: "desc" \| undefined; index: any; }): IndexColumn`
`IndexColumn.shallowExport`	`(): { type: any; value: any; }`	`(): { type: any; value: any; sortOrder?: "desc" \| undefined; }`
`NormalizedRef.color`	`Color \| undefined`	`any`
`RawStickyNote.color`	`Color \| undefined`	`any`
`NormalizedNote.color`	`Color \| undefined`	`any`
`CompilerDiagnostics.map`	`(callback: (diag: CompilerDiagnostic) => CompilerDiagnostic): CompilerError`	`(callback: (diag: CompilerDiagnostic) => CompilerDiagnostic): CompilerDiagnostics`
`CompilerDiagnostics.constructor`	`(diags: CompilerDiagnostic[]): CompilerError`	`(diags: CompilerDiagnostic[]): CompilerDiagnostics`
`CompilerDiagnostics.static create`	`(nestedDiags: unknown): CompilerError`	`(nestedDiags: unknown): CompilerDiagnostics`

新增弃用

未发现。

要求变化（engines、peer 依赖）

未发现。

新增导出 (12)

import	export	kind
`@dbml/core`	`Diagnostic`	variable
`@dbml/core`	`CompileInfo`	variable
`@dbml/core`	`CompileError`	variable
`@dbml/core`	`CompileWarning`	variable
`@dbml/core`	`applyTextEdits`	variable
`@dbml/core`	`CompileErrorCode`	variable
`@dbml/core`	`formatTypedValue`	variable
`@dbml/core`	`FileSpecifierInfo`	variable
`@dbml/core`	`DiagnosticQuickFix`	variable
`@dbml/core`	`CustomMetadataValue`	variable
`@dbml/core`	`syncElementMetadata`	variable
`@dbml/core`	`CustomMetadataValueType`	variable

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 @dbml/core 从 10 升级到 11 有哪些不兼容变更？

在 @dbml/core 10.3.1 与 11.1.0 之间，Vigia 发现 2 个已删除的导出、4 个已修改的签名，以及 81 个已删除或修改的类或接口成员。

@dbml/core 11 中弃用了哪些内容？

@dbml/core 11.1.0 中有 0 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/@dbml/core/upgrade?from=10.3.1&to=11.1.0