@phoenix-wing/kt-codegen 0.4.1

package/dist/KtCodegenTableData.js

@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: Apache-2.0
+import { KtCodegenItem } from "./KtCodegenItem.js";
+/** VS Code Webview、DeskTools 与表格组件之间交换的整表快照类型。 */
+export const KT_CODEGEN_TABLE_DATA_KIND = "kt.codegen.table-data";
+/** 当前 KtCodegenTableData 协议版本。 */
+export const KT_CODEGEN_TABLE_DATA_SCHEMA_VERSION = 1;
+/** 创建一个会复制 Item 的安全整表快照。 */
+export function ktCodegenCloneTableData(data) {
+    return {
+        kind: KT_CODEGEN_TABLE_DATA_KIND,
+        schemaVersion: KT_CODEGEN_TABLE_DATA_SCHEMA_VERSION,
+        documentRevision: Math.max(0, Math.trunc(data.documentRevision)),
+        selectedRow: data.selectedRow === null ? null : Math.trunc(data.selectedRow),
+        items: data.items.map((item) => new KtCodegenItem(item)),
+    };
+}
+//# sourceMappingURL=KtCodegenTableData.js.map

package/dist/KtCodegenTableData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenTableData.js","sourceRoot":"","sources":["../src/KtCodegenTableData.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,kDAAkD;AAClD,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAgC,CAAC;AAE3E,kCAAkC;AAClC,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAU,CAAC;AAiB/D,4BAA4B;AAC5B,MAAM,UAAU,uBAAuB,CAAC,IAAwB;IAC9D,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,aAAa,EAAE,oCAAoC;QACnD,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChE,WAAW,EAAE,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;QAC5E,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/api/analyze.d.ts

@@ -0,0 +1,8 @@
+import type { KtCodegenAnalyzeRequest, KtCodegenPlan } from "./contracts.js";
+import type { KtCodegenRenderer } from "../KtCodegenRenderer.js";
+import { KtCodegenMarker } from "../KtCodegenMarker.js";
+/**
+ * 执行无文件写入的参数代码生成分析，并聚合目标计划、artifact 和诊断。
+ */
+export declare function ktCodegenAnalyze(request: KtCodegenAnalyzeRequest, renderers: readonly KtCodegenRenderer[], marker?: KtCodegenMarker): KtCodegenPlan;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/api/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/api/analyze.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,uBAAuB,EAEvB,aAAa,EAEd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAWxD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,EAChC,SAAS,EAAE,SAAS,iBAAiB,EAAE,EACvC,MAAM,GAAE,eAAuC,GAC9C,aAAa,CAqHf"}

package/dist/api/analyze.js

@@ -0,0 +1,102 @@
+// SPDX-License-Identifier: Apache-2.0
+import { KT_CODEGEN_LEGACY_BLOCKS, ktCodegenIsBlockKey, } from "../blocks/legacy-blocks.js";
+import { ktCodegenHasDiagnosticErrors } from "../model/diagnostic.js";
+import { ktCodegenIsTargetId } from "../model/target.js";
+import { ktCodegenValidateParam } from "../model/validate.js";
+import { KtCodegenMarker } from "../KtCodegenMarker.js";
+function ktCodegenModelDiagnostic(code, severity, message, field) {
+    return { code, severity, message, path: { source: "model", field } };
+}
+/**
+ * 执行无文件写入的参数代码生成分析，并聚合目标计划、artifact 和诊断。
+ */
+export function ktCodegenAnalyze(request, renderers, marker = new KtCodegenMarker()) {
+    const diagnostics = [];
+    diagnostics.push(...ktCodegenValidateParam(request.param));
+    const targetIds = [];
+    const targetSet = new Set();
+    request.targets.forEach((target) => {
+        if (!ktCodegenIsTargetId(target)) {
+            diagnostics.push(ktCodegenModelDiagnostic("target.unknown", "error", `Unknown parameter code generation target: ${target}.`, "targets"));
+            return;
+        }
+        if (targetSet.has(target)) {
+            diagnostics.push(ktCodegenModelDiagnostic("target.duplicate", "warning", `Duplicate target ${target} was ignored.`, "targets"));
+            return;
+        }
+        targetSet.add(target);
+        targetIds.push(target);
+    });
+    if (targetIds.length === 0) {
+        diagnostics.push(ktCodegenModelDiagnostic("target.empty", "error", "At least one target is required.", "targets"));
+    }
+    const requestedBlockKeys = request.blockKeys ?? KT_CODEGEN_LEGACY_BLOCKS.map((block) => block.key);
+    const blockKeys = [];
+    const blockSet = new Set();
+    requestedBlockKeys.forEach((blockKey) => {
+        if (!ktCodegenIsBlockKey(blockKey)) {
+            diagnostics.push(ktCodegenModelDiagnostic("block.unknown", "error", `Unknown legacy block key: ${blockKey}.`, "blockKeys"));
+            return;
+        }
+        if (!blockSet.has(blockKey)) {
+            blockSet.add(blockKey);
+            blockKeys.push(blockKey);
+        }
+    });
+    const markerScan = request.snapshot
+        ? marker.scan(request.param, request.snapshot, blockKeys)
+        : { regions: [], diagnostics: [] };
+    diagnostics.push(...markerScan.diagnostics);
+    const targetPlans = [];
+    const artifacts = [];
+    for (const target of targetIds) {
+        const renderer = renderers.find((candidate) => candidate.targets.includes(target));
+        if (!renderer) {
+            diagnostics.push(ktCodegenModelDiagnostic("renderer.missing", "error", `No renderer is registered for ${target}.`, "targets"));
+            targetPlans.push({ target, rendererId: "", status: "unsupported", artifactCount: 0 });
+            continue;
+        }
+        const result = renderer.render({
+            param: request.param,
+            target,
+            blockKeys,
+            snapshot: request.snapshot ?? { files: [] },
+            markerRegions: markerScan.regions,
+        });
+        artifacts.push(...result.artifacts);
+        diagnostics.push(...result.diagnostics);
+        targetPlans.push({
+            target,
+            rendererId: renderer.id,
+            status: result.status,
+            artifactCount: result.artifacts.length,
+        });
+    }
+    const regionIds = new Set(markerScan.regions.map((region) => region.id));
+    const artifactsHaveRegions = artifacts.every((artifact) => regionIds.has(artifact.regionId));
+    for (const artifact of artifacts) {
+        if (regionIds.has(artifact.regionId))
+            continue;
+        diagnostics.push({
+            code: "artifact.region-not-found",
+            severity: "error",
+            message: `Artifact ${artifact.id} references unknown marker region ${artifact.regionId}.`,
+            path: { source: "renderer", field: artifact.id },
+        });
+    }
+    const allReady = targetPlans.length > 0 && targetPlans.every((target) => target.status === "ready");
+    const hasErrors = ktCodegenHasDiagnosticErrors(diagnostics);
+    return {
+        kind: "kt.codegen.plan",
+        schemaVersion: 1,
+        phase: allReady ? "preview" : "scaffold",
+        targets: targetPlans,
+        blockKeys,
+        artifacts,
+        markerRegions: markerScan.regions,
+        diagnostics,
+        hasChanges: artifacts.length > 0,
+        canApply: !hasErrors && allReady && artifacts.length > 0 && artifactsHaveRegions,
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/api/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/api/analyze.ts"],"names":[],"mappings":"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"}

package/dist/api/contracts.d.ts

@@ -0,0 +1,93 @@
+import type { KtCodegenBlockKey } from "../blocks/legacy-blocks.js";
+import type { KtCodegenDiagnostic } from "../model/diagnostic.js";
+import type { KtCodegenTargetId } from "../model/target.js";
+import type { KtCodegenParam } from "../KtCodegenParam.js";
+import type { KtCodegenMarkerRegion } from "../KtCodegenMarker.js";
+/** Analyze 使用的单个源码文件不可变快照。 */
+export interface KtCodegenSourceFileSnapshot {
+    /** 宿主提供的稳定文件路径。 */
+    readonly path: string;
+    /** 已按宿主编码策略解码的 Unicode 文本。 */
+    readonly text: string;
+    /** Analyze/Apply 并发检查使用的内容指纹。 */
+    readonly fingerprint: string;
+    /** 原文件编码名称，由宿主在最终写回时使用。 */
+    readonly encoding?: string;
+    /** 原文件换行风格。 */
+    readonly eol?: "lf" | "crlf";
+}
+/** 一次 Analyze 可见的全部源码文件快照。 */
+export interface KtCodegenSnapshot {
+    /** 只读文件快照集合。 */
+    readonly files: readonly KtCodegenSourceFileSnapshot[];
+}
+/** Renderer 生成的单个候选代码产物。 */
+export interface KtCodegenArtifact {
+    /** artifact 在当前计划中的稳定身份。 */
+    readonly id: string;
+    /** artifact 要替换的 `KtCodegenMarkerRegion.id`。 */
+    readonly regionId: string;
+    /** 产物所属生成目标。 */
+    readonly target: KtCodegenTargetId;
+    /** 产物对应的旧自动代码块身份。 */
+    readonly blockKey: KtCodegenBlockKey;
+    /** 标记匹配和宿主展示使用的目标类身份。 */
+    readonly classId: string;
+    /** Renderer 生成的候选代码文本。 */
+    readonly content: string;
+    /** 参与生成此产物的参数符号名，用于追踪和诊断。 */
+    readonly sourceParameters: readonly string[];
+}
+/** `KtCodegenCore.analyze` 的完整内部请求。 */
+export interface KtCodegenAnalyzeRequest {
+    /** MVC-C 各层共享的参数数据实例。 */
+    readonly param: KtCodegenParam;
+    /** 请求的生成目标；接收运行时字符串以便对未知值产生诊断。 */
+    readonly targets: readonly string[];
+    /** 可选的自动代码块白名单；省略时使用全部旧 block key。 */
+    readonly blockKeys?: readonly string[];
+    /** 可选源码快照；没有真实源码时可用于 scaffold 分析。 */
+    readonly snapshot?: KtCodegenSnapshot;
+}
+/** 单个目标在 Analyze 计划中的实现状态。 */
+export type KtCodegenTargetStatus = "ready" | "scaffold" | "unsupported";
+/** Analyze 对单个请求目标的处理结果。 */
+export interface KtCodegenTargetPlan {
+    /** 已规范化的生成目标。 */
+    readonly target: KtCodegenTargetId;
+    /** 实际处理此目标的 Renderer 身份；不支持时为空字符串。 */
+    readonly rendererId: string;
+    /** Renderer 的实现和可用状态。 */
+    readonly status: KtCodegenTargetStatus;
+    /** 此目标产生的 artifact 数量。 */
+    readonly artifactCount: number;
+}
+/**
+ * 一次参数代码生成 Analyze 的不可变计划。
+ *
+ * 计划只描述标记区域、候选产物、目标状态和诊断；Wing 的
+ * `KtCodegenApply` 可形成宿主无关投影与事务，真实文件 Port 和 UI 由宿主提供。
+ */
+export interface KtCodegenPlan {
+    /** 计划类型标识。 */
+    readonly kind: "kt.codegen.plan";
+    /** 计划数据结构版本。 */
+    readonly schemaVersion: 1;
+    /** scaffold 表示仍有生成器未迁移；preview 表示可进入预览阶段。 */
+    readonly phase: "scaffold" | "preview";
+    /** 各生成目标的处理状态。 */
+    readonly targets: readonly KtCodegenTargetPlan[];
+    /** 本次计划允许处理的自动代码块身份。 */
+    readonly blockKeys: readonly KtCodegenBlockKey[];
+    /** 所有 Renderer 产生的候选产物。 */
+    readonly artifacts: readonly KtCodegenArtifact[];
+    /** 源码快照中与当前 Param 和 block 白名单匹配的安全标记区域。 */
+    readonly markerRegions: readonly KtCodegenMarkerRegion[];
+    /** Analyze 和 Renderer 汇总的诊断。 */
+    readonly diagnostics: readonly KtCodegenDiagnostic[];
+    /** 是否包含至少一个候选修改。 */
+    readonly hasChanges: boolean;
+    /** 当前计划是否满足进入 Apply 的基本条件。 */
+    readonly canApply: boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/api/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/api/contracts.ts"],"names":[],"mappings":"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"}

package/dist/api/contracts.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/api/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/api/contracts.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

package/dist/api/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./analyze.js";
+export * from "./contracts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAEA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+export * from "./analyze.js";
+export * from "./contracts.js";
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/blocks/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./legacy-blocks.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/blocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAEA,cAAc,oBAAoB,CAAC"}

package/dist/blocks/index.js

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: Apache-2.0
+export * from "./legacy-blocks.js";
+//# sourceMappingURL=index.js.map

package/dist/blocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,cAAc,oBAAoB,CAAC"}

package/dist/blocks/legacy-blocks.d.ts

@@ -0,0 +1,309 @@
+/** 旧生成块在 VB 源码中的有效性标记。 */
+export type KtCodegenLegacyBlockState = "active" | "legacy-deprecated";
+/** 当前 TypeScript 迁移阶段。 */
+export type KtCodegenBlockMigrationStatus = "pending" | "in-progress" | "migrated";
+/**
+ * 从旧 `KevinControlID`、`KevinControlWords` 和 `CreateCAAItem` 提取的32个
+ * 稳定自动代码块身份及迁移依据。
+ *
+ * `legacyCall` 保留 VB 分派调用的精确写法；`legacySourceLine` 指向当前归档
+ * `KevinCAAFileGuide.vb` 中方法定义的起始行，便于迁移和 golden test 审计。
+ */
+export declare const KT_CODEGEN_LEGACY_BLOCKS: readonly [{
+    readonly legacyId: 0;
+    readonly key: "CATALOG PARAMS";
+    readonly platform: "caa";
+    readonly target: "caa.feature-io";
+    readonly legacyCall: "CreateCAACatalogParam()";
+    readonly legacySourceLine: 495;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 1;
+    readonly key: "FACTRY ON TREE";
+    readonly platform: "caa";
+    readonly target: "caa.model";
+    readonly legacyCall: "CreateCAAFactoryOnTree()";
+    readonly legacySourceLine: 1725;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 2;
+    readonly key: "IMPLEMENTS CPP GET";
+    readonly platform: "caa";
+    readonly target: "caa.feature-io";
+    readonly legacyCall: "CreateCAAImplementsCppGet()";
+    readonly legacySourceLine: 824;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 3;
+    readonly key: "IMPLEMENTS CPP SET";
+    readonly platform: "caa";
+    readonly target: "caa.feature-io";
+    readonly legacyCall: "CreateCAAImplementsCppSet()";
+    readonly legacySourceLine: 951;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 4;
+    readonly key: "IMPLEMENTS HEAD GET";
+    readonly platform: "caa";
+    readonly target: "caa.core";
+    readonly legacyCall: "CreateCAAInterfacesGet(False)";
+    readonly legacySourceLine: 676;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 5;
+    readonly key: "IMPLEMENTS HEAD SET";
+    readonly platform: "caa";
+    readonly target: "caa.core";
+    readonly legacyCall: "CreateCAAInterfacesSet(False)";
+    readonly legacySourceLine: 743;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 6;
+    readonly key: "IMPLEMENTS PARAM GET";
+    readonly platform: "caa";
+    readonly target: "caa.feature-io";
+    readonly legacyCall: "CreateCAAImplementsCppParamsClassGet()";
+    readonly legacySourceLine: 1027;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 7;
+    readonly key: "IMPLEMENTS PARAM SET";
+    readonly platform: "caa";
+    readonly target: "caa.feature-io";
+    readonly legacyCall: "CreateCAAImplementsCppParamsClassSet()";
+    readonly legacySourceLine: 1063;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 8;
+    readonly key: "INTERFACES HEAD GET";
+    readonly platform: "caa";
+    readonly target: "caa.model";
+    readonly legacyCall: "CreateCAAInterfacesGet(True)";
+    readonly legacySourceLine: 676;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 9;
+    readonly key: "INTERFACES HEAD SET";
+    readonly platform: "caa";
+    readonly target: "caa.model";
+    readonly legacyCall: "CreateCAAInterfacesSet(True)";
+    readonly legacySourceLine: 743;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 10;
+    readonly key: "PARAM CONSTRUCTOR";
+    readonly platform: "cpp";
+    readonly target: "cpp.parameter";
+    readonly legacyCall: "CreateCAAParamConstructor()";
+    readonly legacySourceLine: 543;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 11;
+    readonly key: "PARAM DECLARATION";
+    readonly platform: "cpp";
+    readonly target: "cpp.parameter";
+    readonly legacyCall: "CreateCAAParamDeclaration()";
+    readonly legacySourceLine: 644;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 12;
+    readonly key: "PARAM DESTRUCTOR";
+    readonly platform: "cpp";
+    readonly target: "cpp.parameter";
+    readonly legacyCall: "CreateCAAParamDestructor()";
+    readonly legacySourceLine: 608;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 13;
+    readonly key: "PARAM EQUAL";
+    readonly platform: "cpp";
+    readonly target: "cpp.parameter";
+    readonly legacyCall: "CreateCAAParamEqual()";
+    readonly legacySourceLine: 579;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 14;
+    readonly key: "DIALOG NOTIFY";
+    readonly platform: "caa";
+    readonly target: "caa.dialog";
+    readonly legacyCall: "CreateCAADialogNotifyValueChange()";
+    readonly legacySourceLine: 1603;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 15;
+    readonly key: "UPDATE DIALOG";
+    readonly platform: "caa";
+    readonly target: "caa.dialog";
+    readonly legacyCall: "CreateCAAUpdateDialog()";
+    readonly legacySourceLine: 1124;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 16;
+    readonly key: "UPDATE INFORS";
+    readonly platform: "caa";
+    readonly target: "caa.dialog";
+    readonly legacyCall: "CreateCAAUpdateInfors()";
+    readonly legacySourceLine: 1347;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 17;
+    readonly key: "QT UPDATE DIALOG";
+    readonly platform: "qt";
+    readonly target: "qt.dialog";
+    readonly legacyCall: "CreateQTUpdateDialog()";
+    readonly legacySourceLine: 1809;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 18;
+    readonly key: "QT UPDATE INFORS";
+    readonly platform: "qt";
+    readonly target: "qt.parameter";
+    readonly legacyCall: "CreateQTUpdateInfors()";
+    readonly legacySourceLine: 2096;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 19;
+    readonly key: "DLG DEFINE FIELD TYPE";
+    readonly platform: "caa";
+    readonly target: "caa.dialog";
+    readonly legacyCall: "DlgDefineFieldType()";
+    readonly legacySourceLine: 3141;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 20;
+    readonly key: "DLG SET ACTIVE FIELD";
+    readonly platform: "caa";
+    readonly target: "caa.dialog";
+    readonly legacyCall: "DlgSetActiveField()";
+    readonly legacySourceLine: 3169;
+    readonly legacyState: "legacy-deprecated";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 21;
+    readonly key: "DLG GET SELECTOR LIST";
+    readonly platform: "caa";
+    readonly target: "caa.dialog";
+    readonly legacyCall: "DlgGetSelectorList()";
+    readonly legacySourceLine: 3199;
+    readonly legacyState: "legacy-deprecated";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 22;
+    readonly key: "CMD AGENT DECLARE";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdAgentDeclare()";
+    readonly legacySourceLine: 3238;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 23;
+    readonly key: "CMD AGENT CONSTRUCTOR";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdAgentConstructor()";
+    readonly legacySourceLine: 3269;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 24;
+    readonly key: "CMD AGENT DESTRUCTOR";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdAgentDestructor()";
+    readonly legacySourceLine: 3290;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 25;
+    readonly key: "CMD AGENT BUILD GRAPH";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdAgentBuildGraph()";
+    readonly legacySourceLine: 3313;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 26;
+    readonly key: "CMD AGENT UPDATE STATE";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdAgentUpdateState()";
+    readonly legacySourceLine: 3436;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 27;
+    readonly key: "CMD AGENT FIA CLEAR";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdAgentFiaClear()";
+    readonly legacySourceLine: 3414;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 28;
+    readonly key: "CMD ACTION PDA";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdActionPda()";
+    readonly legacySourceLine: 3497;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 29;
+    readonly key: "CMD ACTION FIA";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdActionFia()";
+    readonly legacySourceLine: 3561;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 30;
+    readonly key: "CMD ELEMENT SELECTED";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdElementSelected()";
+    readonly legacySourceLine: 3621;
+    readonly legacyState: "legacy-deprecated";
+    readonly migrationStatus: "migrated";
+}, {
+    readonly legacyId: 31;
+    readonly key: "CMD SET ACTIVE FIELD";
+    readonly platform: "caa";
+    readonly target: "caa.control";
+    readonly legacyCall: "CmdSetActiveField()";
+    readonly legacySourceLine: 3686;
+    readonly legacyState: "active";
+    readonly migrationStatus: "migrated";
+}];
+/** 旧自动代码标记使用的稳定 block key 联合类型。 */
+export type KtCodegenBlockKey = (typeof KT_CODEGEN_LEGACY_BLOCKS)[number]["key"];
+/** 单个旧生成块的完整迁移元数据。 */
+export type KtCodegenBlock = (typeof KT_CODEGEN_LEGACY_BLOCKS)[number];
+/** 判断运行时字符串是否为已知旧自动代码 block key。 */
+export declare function ktCodegenIsBlockKey(value: string): value is KtCodegenBlockKey;
+/** 根据稳定 key 取得旧生成块及其迁移依据。 */
+export declare function ktCodegenGetBlock(key: KtCodegenBlockKey): KtCodegenBlock;
+//# sourceMappingURL=legacy-blocks.d.ts.map

package/dist/blocks/legacy-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-blocks.d.ts","sourceRoot":"","sources":["../../src/blocks/legacy-blocks.ts"],"names":[],"mappings":"AAIA,0BAA0B;AAC1B,MAAM,MAAM,yBAAyB,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAEvE,0BAA0B;AAC1B,MAAM,MAAM,6BAA6B,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0UlC,CAAC;AAEJ,mCAAmC;AACnC,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;AAEjF,sBAAsB;AACtB,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMvE,oCAAoC;AACpC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,6BAA6B;AAC7B,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,cAAc,CAIxE"}