@phoenix-wing/kt-codegen 0.4.1

package/dist/KtCodegenAdapter.js.map

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

package/dist/KtCodegenApply.d.ts

@@ -0,0 +1,93 @@
+import type { KtCodegenBlockKey } from "./blocks/legacy-blocks.js";
+import type { KtCodegenDiagnostic } from "./model/diagnostic.js";
+import type { KtCodegenPlan, KtCodegenTargetStatus } from "./api/contracts.js";
+export interface KtCodegenApplySource {
+    readonly path: string;
+    readonly text: string;
+    readonly fingerprint: string;
+}
+export interface KtCodegenApplyChange {
+    readonly path: string;
+    readonly before: string;
+    readonly after: string;
+    readonly regionCount: number;
+    readonly regions: readonly KtCodegenApplyRegionChange[];
+}
+/** 单个 Artifact 在 Apply 投影中绑定的区域元数据，供宿主逐区域审计。 */
+export interface KtCodegenApplyRegionChange {
+    readonly id: string;
+    readonly artifactId: string;
+    readonly blockKey: KtCodegenBlockKey;
+    readonly classId: string;
+    readonly nameSuffix: string;
+    /** 从0开始的 Start Marker 行号。 */
+    readonly line: number;
+}
+export interface KtCodegenApplyProjection {
+    readonly changes: readonly KtCodegenApplyChange[];
+    readonly diagnostics: readonly KtCodegenDiagnostic[];
+}
+export interface KtCodegenApplyBlockSummary {
+    readonly blockKey: KtCodegenBlockKey;
+    readonly regionCount: number;
+    readonly artifactCount: number;
+    readonly paths: readonly string[];
+}
+export interface KtCodegenApplyTargetSummary {
+    readonly target: string;
+    readonly status: KtCodegenTargetStatus;
+    readonly artifactCount: number;
+}
+export interface KtCodegenApplyPlanSummary {
+    readonly canApply: boolean;
+    readonly regionCount: number;
+    readonly artifactCount: number;
+    readonly diagnosticCount: number;
+    readonly targets: readonly KtCodegenApplyTargetSummary[];
+    readonly blocks: readonly KtCodegenApplyBlockSummary[];
+    readonly missingBlockKeys: readonly KtCodegenBlockKey[];
+    readonly blocksWithoutArtifacts: readonly KtCodegenBlockKey[];
+}
+export interface KtCodegenApplyWrite<TTarget> {
+    readonly target: TTarget;
+    readonly before: Uint8Array;
+    readonly after: Uint8Array;
+}
+export interface KtCodegenApplyWritePort<TTarget> {
+    readFile(target: TTarget): PromiseLike<Uint8Array>;
+    writeFile(target: TTarget, content: Uint8Array): PromiseLike<void>;
+}
+export declare class KtCodegenApplyConcurrentChangeError<TTarget = unknown> extends Error {
+    readonly target: TTarget;
+    readonly name = "KtCodegenApplyConcurrentChangeError";
+    constructor(target: TTarget);
+}
+export type KtCodegenApplyCommitResult<TTarget> = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly error: unknown;
+    readonly rollbackFailures: readonly TTarget[];
+};
+/**
+ * 汇总计划中的 Target、控制符区域和 Artifact 绑定关系。
+ *
+ * 返回结构化数据而不生成宿主日志，Desk Tools、VS Code 和测试可各自决定
+ * 如何呈现“控制符未命中”或“区域没有产物”等信息。
+ */
+export declare function ktCodegenInspectApplyPlan(plan: KtCodegenPlan): KtCodegenApplyPlanSummary;
+/** 生成器统一产出 LF；Apply 投影按目标源码换行写回。 */
+export declare function ktCodegenNormalizeGeneratedEol(text: string, eol: "lf" | "crlf"): string;
+/**
+ * 纯 Apply 投影：一次性验证计划、指纹和区域重叠后，产生整文件新文本。
+ * 本函数不访问文件系统，也不修改传入的计划或源码快照。
+ */
+export declare function ktCodegenProjectApply(plan: KtCodegenPlan, sources: readonly KtCodegenApplySource[]): KtCodegenApplyProjection;
+/**
+ * 多文件 Apply 的宿主无关事务边界。
+ *
+ * 每个目标写入前复读并与 before 比较；失败时逆序恢复已尝试目标。回滚只
+ * 覆盖仍等于本次 after 的文件，避免误删 Apply 期间出现的第三方修改。
+ */
+export declare function ktCodegenCommitApplyWrites<TTarget>(port: KtCodegenApplyWritePort<TTarget>, writes: readonly KtCodegenApplyWrite<TTarget>[]): Promise<KtCodegenApplyCommitResult<TTarget>>;
+//# sourceMappingURL=KtCodegenApply.d.ts.map

package/dist/KtCodegenApply.d.ts.map

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

package/dist/KtCodegenApply.js

@@ -0,0 +1,194 @@
+// SPDX-License-Identifier: Apache-2.0
+export class KtCodegenApplyConcurrentChangeError extends Error {
+    target;
+    name = "KtCodegenApplyConcurrentChangeError";
+    constructor(target) {
+        super("源码在 Apply 最终写入前再次变化");
+        this.target = target;
+    }
+}
+function ktCodegenApplyDiagnostic(code, message, file, row) {
+    return {
+        code,
+        severity: "error",
+        message,
+        ...(file ? { path: { source: "source", file, row: row ?? 0, column: 0 } } : {}),
+    };
+}
+/**
+ * 汇总计划中的 Target、控制符区域和 Artifact 绑定关系。
+ *
+ * 返回结构化数据而不生成宿主日志，Desk Tools、VS Code 和测试可各自决定
+ * 如何呈现“控制符未命中”或“区域没有产物”等信息。
+ */
+export function ktCodegenInspectApplyPlan(plan) {
+    const artifactsByRegion = new Map();
+    for (const artifact of plan.artifacts) {
+        artifactsByRegion.set(artifact.regionId, (artifactsByRegion.get(artifact.regionId) ?? 0) + 1);
+    }
+    const blocks = plan.blockKeys.map((blockKey) => {
+        const regions = plan.markerRegions.filter((region) => region.blockKey === blockKey);
+        return {
+            blockKey,
+            regionCount: regions.length,
+            artifactCount: regions.reduce((total, region) => total + (artifactsByRegion.get(region.id) ?? 0), 0),
+            paths: [...new Set(regions.map((region) => region.path))].sort(),
+        };
+    });
+    return {
+        canApply: plan.canApply,
+        regionCount: plan.markerRegions.length,
+        artifactCount: plan.artifacts.length,
+        diagnosticCount: plan.diagnostics.length,
+        targets: plan.targets.map((target) => ({
+            target: target.target,
+            status: target.status,
+            artifactCount: target.artifactCount,
+        })),
+        blocks,
+        missingBlockKeys: blocks.filter((block) => block.regionCount === 0).map((block) => block.blockKey),
+        blocksWithoutArtifacts: blocks
+            .filter((block) => block.regionCount > 0 && block.artifactCount === 0)
+            .map((block) => block.blockKey),
+    };
+}
+/** 生成器统一产出 LF；Apply 投影按目标源码换行写回。 */
+export function ktCodegenNormalizeGeneratedEol(text, eol) {
+    return text.replace(/\r\n|\r|\n/g, eol === "crlf" ? "\r\n" : "\n");
+}
+/**
+ * 纯 Apply 投影：一次性验证计划、指纹和区域重叠后，产生整文件新文本。
+ * 本函数不访问文件系统，也不修改传入的计划或源码快照。
+ */
+export function ktCodegenProjectApply(plan, sources) {
+    if (!plan.canApply) {
+        return {
+            changes: [],
+            diagnostics: [ktCodegenApplyDiagnostic("apply.plan-not-applicable", "当前预检计划包含错误或没有可应用的生成产物。")],
+        };
+    }
+    const diagnostics = [];
+    const sourceByPath = new Map(sources.map((source) => [source.path, source]));
+    const regionById = new Map(plan.markerRegions.map((region) => [region.id, region]));
+    const replacementsByPath = new Map();
+    const usedRegions = new Set();
+    for (const artifact of plan.artifacts) {
+        const region = regionById.get(artifact.regionId);
+        if (!region) {
+            diagnostics.push(ktCodegenApplyDiagnostic("apply.region-not-found", `生成产物 ${artifact.id} 对应的控制符区域已不存在。`));
+            continue;
+        }
+        if (usedRegions.has(region.id)) {
+            diagnostics.push(ktCodegenApplyDiagnostic("apply.duplicate-region", `控制符区域 ${region.blockKey} 收到多个生成产物，已阻止写入。`, region.path, region.start.line));
+            continue;
+        }
+        usedRegions.add(region.id);
+        const replacements = replacementsByPath.get(region.path) ?? [];
+        replacements.push({
+            start: region.replaceStartOffset,
+            end: region.replaceEndOffset,
+            content: artifact.content,
+            line: region.start.line,
+            fingerprint: region.sourceFingerprint,
+            region: {
+                id: region.id,
+                artifactId: artifact.id,
+                blockKey: region.blockKey,
+                classId: region.classId,
+                nameSuffix: region.nameSuffix,
+                line: region.start.line,
+            },
+        });
+        replacementsByPath.set(region.path, replacements);
+    }
+    const changes = [];
+    for (const [path, replacements] of replacementsByPath) {
+        const source = sourceByPath.get(path);
+        if (!source) {
+            diagnostics.push(ktCodegenApplyDiagnostic("apply.source-missing", "Apply 前无法重新读取源码文件。", path));
+            continue;
+        }
+        const expectedFingerprints = new Set(replacements.map((item) => item.fingerprint));
+        if (expectedFingerprints.size !== 1 || !expectedFingerprints.has(source.fingerprint)) {
+            diagnostics.push(ktCodegenApplyDiagnostic("apply.source-changed", "源码在预检后发生变化，请重新预检后再 Apply。", path, replacements[0]?.line));
+            continue;
+        }
+        const ordered = [...replacements].sort((left, right) => right.start - left.start);
+        let previousStart = source.text.length;
+        let output = source.text;
+        let valid = true;
+        const sourceEol = source.text.includes("\r\n") ? "crlf" : "lf";
+        for (const replacement of ordered) {
+            if (replacement.start < 0
+                || replacement.end < replacement.start
+                || replacement.end > source.text.length
+                || replacement.end > previousStart) {
+                diagnostics.push(ktCodegenApplyDiagnostic("apply.invalid-range", "预检区域偏移无效或互相重叠，请清理缓存后重新预检。", path, replacement.line));
+                valid = false;
+                break;
+            }
+            const content = ktCodegenNormalizeGeneratedEol(replacement.content, sourceEol);
+            output = output.slice(0, replacement.start) + content + output.slice(replacement.end);
+            previousStart = replacement.start;
+        }
+        if (valid && output !== source.text) {
+            changes.push({
+                path,
+                before: source.text,
+                after: output,
+                regionCount: replacements.length,
+                regions: [...replacements]
+                    .sort((left, right) => left.start - right.start)
+                    .map((replacement) => replacement.region),
+            });
+        }
+    }
+    return { changes: diagnostics.length ? [] : changes, diagnostics };
+}
+/**
+ * 多文件 Apply 的宿主无关事务边界。
+ *
+ * 每个目标写入前复读并与 before 比较；失败时逆序恢复已尝试目标。回滚只
+ * 覆盖仍等于本次 after 的文件，避免误删 Apply 期间出现的第三方修改。
+ */
+export async function ktCodegenCommitApplyWrites(port, writes) {
+    const attempted = [];
+    try {
+        for (const write of writes) {
+            const current = await port.readFile(write.target);
+            if (!ktCodegenBytesEqual(current, write.before)) {
+                throw new KtCodegenApplyConcurrentChangeError(write.target);
+            }
+            attempted.push(write);
+            await port.writeFile(write.target, write.after);
+        }
+        return { ok: true };
+    }
+    catch (error) {
+        const rollbackFailures = [];
+        for (const write of [...attempted].reverse()) {
+            try {
+                const current = await port.readFile(write.target);
+                if (!ktCodegenBytesEqual(current, write.after)) {
+                    rollbackFailures.push(write.target);
+                    continue;
+                }
+                await port.writeFile(write.target, write.before);
+            }
+            catch {
+                rollbackFailures.push(write.target);
+            }
+        }
+        return { ok: false, error, rollbackFailures };
+    }
+}
+function ktCodegenBytesEqual(left, right) {
+    if (left.byteLength !== right.byteLength)
+        return false;
+    for (let index = 0; index < left.byteLength; index += 1) {
+        if (left[index] !== right[index])
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=KtCodegenApply.js.map

package/dist/KtCodegenApply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenApply.js","sourceRoot":"","sources":["../src/KtCodegenApply.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAuEtC,MAAM,OAAO,mCAAuD,SAAQ,KAAK;IAGnD;IAFV,IAAI,GAAG,qCAAqC,CAAC;IAE/D,YAA4B,MAAe;QACzC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QADH,WAAM,GAAN,MAAM,CAAS;IAE3C,CAAC;CACF;AAUD,SAAS,wBAAwB,CAC/B,IAAY,EACZ,OAAe,EACf,IAAa,EACb,GAAY;IAEZ,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,OAAO;QACjB,OAAO;QACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAmB;IAC3D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACpF,OAAO;YACL,QAAQ;YACR,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YACpG,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;SACjE,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM;QACtC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;QACpC,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;QACxC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CAAC;QACH,MAAM;QACN,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;QAClG,sBAAsB,EAAE,MAAM;aAC3B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,CAAC;aACrE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,8BAA8B,CAC5C,IAAY,EACZ,GAAkB;IAElB,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAmB,EACnB,OAAwC;IAExC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,CAAC,wBAAwB,CACpC,2BAA2B,EAC3B,wBAAwB,CACzB,CAAC;SACH,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAA0B,EAAE,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAO7B,CAAC;IACN,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,WAAW,CAAC,IAAI,CAAC,wBAAwB,CACvC,wBAAwB,EACxB,QAAQ,QAAQ,CAAC,EAAE,gBAAgB,CACpC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,WAAW,CAAC,IAAI,CAAC,wBAAwB,CACvC,wBAAwB,EACxB,SAAS,MAAM,CAAC,QAAQ,kBAAkB,EAC1C,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,KAAK,CAAC,IAAI,CAClB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/D,YAAY,CAAC,IAAI,CAAC;YAChB,KAAK,EAAE,MAAM,CAAC,kBAAkB;YAChC,GAAG,EAAE,MAAM,CAAC,gBAAgB;YAC5B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;YACvB,WAAW,EAAE,MAAM,CAAC,iBAAiB;YACrC,MAAM,EAAE;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI;aACxB;SACF,CAAC,CAAC;QACH,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,WAAW,CAAC,IAAI,CAAC,wBAAwB,CAAC,sBAAsB,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC,CAAC;YAC/F,SAAS;QACX,CAAC;QACD,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACnF,IAAI,oBAAoB,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YACrF,WAAW,CAAC,IAAI,CAAC,wBAAwB,CACvC,sBAAsB,EACtB,2BAA2B,EAC3B,IAAI,EACJ,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,CACtB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAClF,IAAI,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACvC,IAAI,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IAAI,KAAK,GAAG,IAAI,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/D,KAAK,MAAM,WAAW,IAAI,OAAO,EAAE,CAAC;YAClC,IACE,WAAW,CAAC,KAAK,GAAG,CAAC;mBAClB,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,KAAK;mBACnC,WAAW,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM;mBACpC,WAAW,CAAC,GAAG,GAAG,aAAa,EAClC,CAAC;gBACD,WAAW,CAAC,IAAI,CAAC,wBAAwB,CACvC,qBAAqB,EACrB,2BAA2B,EAC3B,IAAI,EACJ,WAAW,CAAC,IAAI,CACjB,CAAC,CAAC;gBACH,KAAK,GAAG,KAAK,CAAC;gBACd,MAAM;YACR,CAAC;YACD,MAAM,OAAO,GAAG,8BAA8B,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC/E,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACtF,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC;QACpC,CAAC;QACD,IAAI,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,YAAY,CAAC,MAAM;gBAChC,OAAO,EAAE,CAAC,GAAG,YAAY,CAAC;qBACvB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;qBAC/C,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;AACrE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAsC,EACtC,MAA+C;IAE/C,MAAM,SAAS,GAAmC,EAAE,CAAC;IACrD,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChD,MAAM,IAAI,mCAAmC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9D,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtB,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,gBAAgB,GAAc,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAClD,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC/C,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBACpC,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAChD,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAgB,EAAE,KAAiB;IAC9D,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACvD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/KtCodegenBlockPresentation.d.ts

@@ -0,0 +1,14 @@
+import { type KtCodegenBlockKey } from "./blocks/legacy-blocks.js";
+export interface KtCodegenBlockPresentation {
+    readonly key: KtCodegenBlockKey;
+    readonly legacyId: number;
+    readonly title: string;
+    readonly controlWords: string;
+    readonly notes: string;
+}
+/** 跨 VS Code/Desk Tools 复用的控制符表格展示数据。 */
+export declare const KT_CODEGEN_BLOCK_PRESENTATIONS: readonly KtCodegenBlockPresentation[];
+export type KtCodegenBlockPreset = "all" | "none" | "cpp-only" | "field-code";
+/** 复现旧 VB 的全选、全不选、C++ only 与 Field Code 选择规则。 */
+export declare function ktCodegenBlockKeysForPreset(preset: KtCodegenBlockPreset): KtCodegenBlockKey[];
+//# sourceMappingURL=KtCodegenBlockPresentation.d.ts.map

package/dist/KtCodegenBlockPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenBlockPresentation.d.ts","sourceRoot":"","sources":["../src/KtCodegenBlockPresentation.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAsCnC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,yCAAyC;AACzC,eAAO,MAAM,8BAA8B,EAAE,SAAS,0BAA0B,EAO3E,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAE9E,iDAAiD;AACjD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,GAC3B,iBAAiB,EAAE,CAOrB"}

package/dist/KtCodegenBlockPresentation.js

@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: Apache-2.0
+import { KT_CODEGEN_LEGACY_BLOCKS, } from "./blocks/legacy-blocks.js";
+/** 旧 VB `KevinControlTitle` 的32个用户可读标题，顺序与 legacyId 一致。 */
+const KT_CODEGEN_LEGACY_BLOCK_TITLES = [
+    "CATALOG Param define",
+    "Param on Tree",
+    "Implement CPP Get",
+    "Implement CPP Set",
+    "Implement HEAD Get",
+    "Implement HEAD Set",
+    "Implement PARAM Get",
+    "Implement PARAM Set",
+    "Interface HEAD Get",
+    "Interface HEAD Set",
+    "PARAM Initial",
+    "PARAM define",
+    "PARAM destructor",
+    "PARAM equal",
+    "Dialog Change Notify",
+    "Update CAA Dialog",
+    "Update CAA param",
+    "Update QT Dialog",
+    "Update QT param",
+    "Dlg Define Field Type",
+    "Dlg Set Active Field",
+    "Dlg Get Selector List",
+    "Cmd Agent Declare",
+    "Cmd Agent Constructor",
+    "Cmd Agent Destructor",
+    "Cmd Agent Build Graph",
+    "Cmd Agent Update State",
+    "Cmd Agent fia Clear",
+    "Cmd Action Pda",
+    "Cmd Action Fia",
+    "Cmd Element Selected",
+    "Cmd Set Active Field",
+];
+/** 跨 VS Code/Desk Tools 复用的控制符表格展示数据。 */
+export const KT_CODEGEN_BLOCK_PRESENTATIONS = KT_CODEGEN_LEGACY_BLOCKS.map((block) => ({
+    key: block.key,
+    legacyId: block.legacyId,
+    title: KT_CODEGEN_LEGACY_BLOCK_TITLES[block.legacyId] ?? block.key,
+    controlWords: block.key,
+    notes: block.legacyCall,
+}));
+/** 复现旧 VB 的全选、全不选、C++ only 与 Field Code 选择规则。 */
+export function ktCodegenBlockKeysForPreset(preset) {
+    if (preset === "none")
+        return [];
+    return KT_CODEGEN_LEGACY_BLOCKS
+        .filter((block) => preset === "all"
+        || (preset === "cpp-only" && block.legacyId >= 10 && block.legacyId <= 13)
+        || (preset === "field-code" && block.legacyId >= 19 && block.legacyId <= 31))
+        .map((block) => block.key);
+}
+//# sourceMappingURL=KtCodegenBlockPresentation.js.map

package/dist/KtCodegenBlockPresentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenBlockPresentation.js","sourceRoot":"","sources":["../src/KtCodegenBlockPresentation.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,wBAAwB,GAEzB,MAAM,2BAA2B,CAAC;AAEnC,2DAA2D;AAC3D,MAAM,8BAA8B,GAAG;IACrC,sBAAsB;IACtB,eAAe;IACf,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,oBAAoB;IACpB,eAAe;IACf,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,sBAAsB;IACtB,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,iBAAiB;IACjB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,mBAAmB;IACnB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,wBAAwB;IACxB,qBAAqB;IACrB,gBAAgB;IAChB,gBAAgB;IAChB,sBAAsB;IACtB,sBAAsB;CACd,CAAC;AAUX,yCAAyC;AACzC,MAAM,CAAC,MAAM,8BAA8B,GACzC,wBAAwB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,GAAG,EAAE,KAAK,CAAC,GAAG;IACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;IACxB,KAAK,EAAE,8BAA8B,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,GAAG;IAClE,YAAY,EAAE,KAAK,CAAC,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC,UAAU;CACxB,CAAC,CAAC,CAAC;AAIN,iDAAiD;AACjD,MAAM,UAAU,2BAA2B,CACzC,MAA4B;IAE5B,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,wBAAwB;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK;WAC9B,CAAC,MAAM,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;WACvE,CAAC,MAAM,KAAK,YAAY,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;SAC9E,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC"}

package/dist/KtCodegenController.d.ts

@@ -0,0 +1,68 @@
+import type { KtCodegenDataResult } from "./model/diagnostic.js";
+import type { KtCodegenLegacyCsvWriteOptions } from "./legacy/csv.js";
+import type { KtCodegenAnalyzeRequest, KtCodegenPlan } from "./api/contracts.js";
+import { KtCodegenAdapter } from "./KtCodegenAdapter.js";
+import { KtCodegenCore } from "./KtCodegenCore.js";
+import { KtCodegenParam } from "./KtCodegenParam.js";
+import { KtCodegenReader } from "./KtCodegenReader.js";
+/**
+ * 宿主编排层：维护共享 Param，并协调 Reader、Adapter 与 Core。
+ *
+ * `kt-auto-code` 或 `phoenix-desk-tools` 通常持有一个 Controller。界面、表格和
+ * 生成流程都通过 `param` 访问同一数据实例。Controller 不实现具体 CSV/JSON
+ * 语法，也不包含目标代码生成算法。
+ */
+export declare class KtCodegenController {
+    /** 最近一次成功读取的旧 JSON 根字段顺序；CSV/原生数据不带布局模板。 */
+    private legacyJsonRootKeys;
+    /** MVC-C 各消费者共享的唯一参数数据实例。 */
+    readonly param: KtCodegenParam;
+    /** CSV/JSON 输入边界；先读取临时数据，不直接修改共享实例。 */
+    readonly reader: KtCodegenReader;
+    /** 旧格式写出和共享实例原地更新边界。 */
+    readonly adapter: KtCodegenAdapter;
+    /** 与 UI 和文件系统无关的 Analyze/生成核心。 */
+    readonly core: KtCodegenCore;
+    /**
+     * 创建 Controller，并允许宿主注入共享数据或自定义职责实现。
+     *
+     * 未注入的对象使用标准默认实现。`param` 属性本身只读，避免宿主意外替换
+     * 共享实例；其中的公开字段仍可按 MVC-C 约定直接修改。
+     */
+    constructor(options?: {
+        param?: KtCodegenParam;
+        reader?: KtCodegenReader;
+        adapter?: KtCodegenAdapter;
+        core?: KtCodegenCore;
+    });
+    /**
+     * 读取旧 v4 JSON；只有完整读取成功后才原地更新共享 `param`。
+     *
+     * 失败时保留此前所有共享数据，并通过结果返回诊断。
+     */
+    readJson(input: string | unknown): KtCodegenDataResult<KtCodegenParam>;
+    /**
+     * 读取旧17列 CSV；只有完整读取成功后才原地更新共享 `param`。
+     *
+     * 失败时保留此前所有共享数据，并通过结果返回诊断。
+     */
+    readCsv(text: string): KtCodegenDataResult<KtCodegenParam>;
+    /** 将当前共享数据写成旧 v4 JSON，不执行文件系统写入。 */
+    writeJson(space?: number): KtCodegenDataResult<string>;
+    /** 将当前共享数据写成旧17列 CSV，不执行文件系统写入。 */
+    writeCsv(options?: KtCodegenLegacyCsvWriteOptions): KtCodegenDataResult<string>;
+    /** 清空共享数据内容，但不替换 `param`、`items` 等共享容器引用。 */
+    clear(): void;
+    /**
+     * 使用当前共享数据分析指定目标，并返回不可直接写文件的生成计划。
+     *
+     * 当前会扫描调用者提供的源码快照；普通 C++、CAA 与 Qt 共三十二块
+     * 可以产生 artifact。Analyze 只返回计划，不直接写文件。
+     */
+    analyze(request: Omit<KtCodegenAnalyzeRequest, "param">): KtCodegenPlan;
+    /** 把成功读取的临时数据应用到共享实例；失败结果直接向调用者传递。 */
+    private applyReadResult;
+    /** 成功解析后的第二次轻量读取只提取布局，不参与数据语义。 */
+    private readRootKeys;
+}
+//# sourceMappingURL=KtCodegenController.d.ts.map

package/dist/KtCodegenController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenController.d.ts","sourceRoot":"","sources":["../src/KtCodegenController.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EACV,uBAAuB,EACvB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,4CAA4C;IAC5C,OAAO,CAAC,kBAAkB,CAAgB;IAE1C,6BAA6B;IAC7B,SAAgB,KAAK,EAAE,cAAc,CAAC;IAEtC,uCAAuC;IACvC,SAAgB,MAAM,EAAE,eAAe,CAAC;IAExC,wBAAwB;IACxB,SAAgB,OAAO,EAAE,gBAAgB,CAAC;IAE1C,kCAAkC;IAClC,SAAgB,IAAI,EAAE,aAAa,CAAC;IAEpC;;;;;OAKG;gBACS,OAAO,GAAE;QACnB,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,MAAM,CAAC,EAAE,eAAe,CAAC;QACzB,OAAO,CAAC,EAAE,gBAAgB,CAAC;QAC3B,IAAI,CAAC,EAAE,aAAa,CAAC;KACjB;IAON;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,mBAAmB,CAAC,cAAc,CAAC;IAMtE;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,cAAc,CAAC;IAM1D,oCAAoC;IACpC,SAAS,CAAC,KAAK,SAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAIjD,mCAAmC;IACnC,QAAQ,CAAC,OAAO,GAAE,8BAAmC,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAInF,6CAA6C;IAC7C,KAAK,IAAI,IAAI;IAKb;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,OAAO,CAAC,GAAG,aAAa;IAIvE,sCAAsC;IACtC,OAAO,CAAC,eAAe;IAQvB,kCAAkC;IAClC,OAAO,CAAC,YAAY;CAUrB"}

package/dist/KtCodegenController.js

@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: Apache-2.0
+import { KtCodegenAdapter } from "./KtCodegenAdapter.js";
+import { KtCodegenCore } from "./KtCodegenCore.js";
+import { KtCodegenParam } from "./KtCodegenParam.js";
+import { KtCodegenReader } from "./KtCodegenReader.js";
+/**
+ * 宿主编排层：维护共享 Param，并协调 Reader、Adapter 与 Core。
+ *
+ * `kt-auto-code` 或 `phoenix-desk-tools` 通常持有一个 Controller。界面、表格和
+ * 生成流程都通过 `param` 访问同一数据实例。Controller 不实现具体 CSV/JSON
+ * 语法，也不包含目标代码生成算法。
+ */
+export class KtCodegenController {
+    /** 最近一次成功读取的旧 JSON 根字段顺序；CSV/原生数据不带布局模板。 */
+    legacyJsonRootKeys = [];
+    /** MVC-C 各消费者共享的唯一参数数据实例。 */
+    param;
+    /** CSV/JSON 输入边界；先读取临时数据，不直接修改共享实例。 */
+    reader;
+    /** 旧格式写出和共享实例原地更新边界。 */
+    adapter;
+    /** 与 UI 和文件系统无关的 Analyze/生成核心。 */
+    core;
+    /**
+     * 创建 Controller，并允许宿主注入共享数据或自定义职责实现。
+     *
+     * 未注入的对象使用标准默认实现。`param` 属性本身只读，避免宿主意外替换
+     * 共享实例；其中的公开字段仍可按 MVC-C 约定直接修改。
+     */
+    constructor(options = {}) {
+        this.param = options.param ?? new KtCodegenParam();
+        this.reader = options.reader ?? new KtCodegenReader();
+        this.adapter = options.adapter ?? new KtCodegenAdapter();
+        this.core = options.core ?? new KtCodegenCore();
+    }
+    /**
+     * 读取旧 v4 JSON；只有完整读取成功后才原地更新共享 `param`。
+     *
+     * 失败时保留此前所有共享数据，并通过结果返回诊断。
+     */
+    readJson(input) {
+        const result = this.applyReadResult(this.reader.readJson(input));
+        if (result.ok && result.value)
+            this.legacyJsonRootKeys = this.readRootKeys(input);
+        return result;
+    }
+    /**
+     * 读取旧17列 CSV；只有完整读取成功后才原地更新共享 `param`。
+     *
+     * 失败时保留此前所有共享数据，并通过结果返回诊断。
+     */
+    readCsv(text) {
+        const result = this.applyReadResult(this.reader.readCsv(text));
+        if (result.ok && result.value)
+            this.legacyJsonRootKeys = [];
+        return result;
+    }
+    /** 将当前共享数据写成旧 v4 JSON，不执行文件系统写入。 */
+    writeJson(space = 4) {
+        return this.adapter.writeJson(this.param, space, this.legacyJsonRootKeys);
+    }
+    /** 将当前共享数据写成旧17列 CSV，不执行文件系统写入。 */
+    writeCsv(options = {}) {
+        return this.adapter.writeCsv(this.param, options);
+    }
+    /** 清空共享数据内容，但不替换 `param`、`items` 等共享容器引用。 */
+    clear() {
+        this.adapter.clear(this.param);
+        this.legacyJsonRootKeys = [];
+    }
+    /**
+     * 使用当前共享数据分析指定目标，并返回不可直接写文件的生成计划。
+     *
+     * 当前会扫描调用者提供的源码快照；普通 C++、CAA 与 Qt 共三十二块
+     * 可以产生 artifact。Analyze 只返回计划，不直接写文件。
+     */
+    analyze(request) {
+        return this.core.analyze(this.param, request);
+    }
+    /** 把成功读取的临时数据应用到共享实例；失败结果直接向调用者传递。 */
+    applyReadResult(result) {
+        if (!result.ok || !result.value)
+            return result;
+        this.adapter.replace(this.param, result.value);
+        return { ...result, value: this.param };
+    }
+    /** 成功解析后的第二次轻量读取只提取布局，不参与数据语义。 */
+    readRootKeys(input) {
+        try {
+            const value = typeof input === "string" ? JSON.parse(input) : input;
+            return typeof value === "object" && value !== null && !Array.isArray(value)
+                ? Object.keys(value)
+                : [];
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=KtCodegenController.js.map

package/dist/KtCodegenController.js.map

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