@phoenix-wing/kt-codegen 0.4.1

package/dist/KtCodegenMarker.js

@@ -0,0 +1,246 @@
+// SPDX-License-Identifier: Apache-2.0
+import { KT_CODEGEN_LEGACY_BLOCKS, } from "./blocks/legacy-blocks.js";
+const KT_CODEGEN_MARKER_START = "START KEVIN CAA WIZARD SECTION";
+const KT_CODEGEN_MARKER_END = "END KEVIN CAA WIZARD SECTION";
+function isArchivedBlockKey(value) {
+    return KT_CODEGEN_LEGACY_BLOCKS.some((block) => block.key === value);
+}
+/**
+ * 旧 Kevin 自动代码控制标记的构造与只读扫描器。
+ *
+ * 本类复现 `KevinCAAFileGuide` 的 `START/END KEVIN CAA WIZARD SECTION`
+ * 文本协议和缩进提取规则，但不生成业务代码、不修改源码，也不写文件。
+ * 对旧实现会静默吞掉的嵌套、错配和孤立标记，本类返回明确 error 诊断。
+ */
+export class KtCodegenMarker {
+    /** 根据共享参数和后缀创建旧标记使用的类身份。 */
+    createClassId(param, nameSuffix) {
+        return `${param.namePrefix}${param.nameMiddle}${nameSuffix}`;
+    }
+    /**
+     * 创建包含 `//` 的旧格式 Start 标记整行。
+     *
+     * `linePrefix` 对应旧 VB `_prefix`，通常是空字符串、空格或制表符缩进。
+     */
+    createStart(param, nameSuffix, blockKey, linePrefix = "") {
+        return `${linePrefix}// ${KT_CODEGEN_MARKER_START} ${this.createClassId(param, nameSuffix)} ${blockKey}`;
+    }
+    /**
+     * 创建包含 `//` 的旧格式 End 标记整行。
+     *
+     * `linePrefix` 对应旧 VB `_prefix`，应与配对 Start 使用相同前缀。
+     */
+    createEnd(param, nameSuffix, blockKey, linePrefix = "") {
+        return `${linePrefix}// ${KT_CODEGEN_MARKER_END} ${this.createClassId(param, nameSuffix)} ${blockKey}`;
+    }
+    /**
+     * 扫描宿主提供的不可变源码快照，返回可安全替换的旧自动代码区域。
+     *
+     * 扫描仅匹配当前 Param 中出现的 `NameSuffix` 和调用者允许的 block key。
+     * 其他类或未请求 block 的合法标记保持不变，便于同一文件容纳多套生成数据。
+     */
+    scan(param, snapshot, blockKeys = KT_CODEGEN_LEGACY_BLOCKS.map((block) => block.key)) {
+        const expectedClassIds = new Map();
+        for (const item of param.items) {
+            const classId = this.createClassId(param, item.nameSuffix);
+            if (!expectedClassIds.has(classId))
+                expectedClassIds.set(classId, item.nameSuffix);
+        }
+        const requestedBlocks = new Set(blockKeys);
+        const regions = [];
+        const diagnostics = [];
+        for (const file of snapshot.files) {
+            this.scanFile(file, expectedClassIds, requestedBlocks, regions, diagnostics);
+        }
+        return { regions, diagnostics };
+    }
+    /** 顺序扫描单个文件，并保持旧实现一次只处理一个打开块的基本模型。 */
+    scanFile(file, expectedClassIds, requestedBlocks, regions, diagnostics) {
+        let open = null;
+        for (const line of this.splitLines(file.text)) {
+            const parsed = this.parseLine(file.path, line);
+            if (parsed.diagnostic) {
+                diagnostics.push(parsed.diagnostic);
+                if (open)
+                    open.invalid = true;
+            }
+            if (!parsed.marker)
+                continue;
+            if (!isArchivedBlockKey(parsed.marker.blockKey) ||
+                !requestedBlocks.has(parsed.marker.blockKey)) {
+                if (open) {
+                    diagnostics.push(this.sourceDiagnostic(parsed.marker.kind === "start"
+                        ? "marker.nested-start"
+                        : "marker.mismatched-end", "error", `${parsed.marker.kind === "start" ? "Start" : "End"} marker ${parsed.marker.classId} ${parsed.marker.blockKey} appears inside the open ${open.marker.classId} ${open.marker.blockKey} region.`, file.path, line.number, parsed.marker.column));
+                    open.invalid = true;
+                }
+                continue;
+            }
+            const nameSuffix = expectedClassIds.get(parsed.marker.classId);
+            if (nameSuffix === undefined) {
+                if (open && parsed.marker.kind === "start") {
+                    diagnostics.push(this.sourceDiagnostic("marker.nested-start", "error", `A foreign Start marker appears before ${open.marker.classId} ${open.marker.blockKey} is closed.`, file.path, line.number, parsed.marker.column));
+                    open.invalid = true;
+                }
+                else if (open && parsed.marker.kind === "end") {
+                    diagnostics.push(this.sourceDiagnostic("marker.mismatched-end", "error", `End marker ${parsed.marker.classId} ${parsed.marker.blockKey} does not close ${open.marker.classId} ${open.marker.blockKey}.`, file.path, line.number, parsed.marker.column));
+                    open.invalid = true;
+                }
+                continue;
+            }
+            const knownMarker = {
+                ...parsed.marker,
+                blockKey: parsed.marker.blockKey,
+            };
+            const marker = this.toMarkerPoint(file.path, knownMarker, nameSuffix);
+            if (marker.kind === "start") {
+                if (open) {
+                    diagnostics.push(this.sourceDiagnostic("marker.nested-start", "error", `Start marker ${marker.classId} ${marker.blockKey} appears before ${open.marker.classId} ${open.marker.blockKey} is closed.`, file.path, marker.line, marker.column));
+                    open.invalid = true;
+                    continue;
+                }
+                open = { marker, invalid: false };
+                continue;
+            }
+            if (!open) {
+                diagnostics.push(this.sourceDiagnostic("marker.orphan-end", "error", `End marker ${marker.classId} ${marker.blockKey} has no preceding Start marker.`, file.path, marker.line, marker.column));
+                continue;
+            }
+            if (open.marker.classId !== marker.classId ||
+                open.marker.blockKey !== marker.blockKey) {
+                diagnostics.push(this.sourceDiagnostic("marker.mismatched-end", "error", `End marker ${marker.classId} ${marker.blockKey} does not close ${open.marker.classId} ${open.marker.blockKey}.`, file.path, marker.line, marker.column));
+                open.invalid = true;
+                continue;
+            }
+            if (!open.invalid) {
+                regions.push({
+                    id: `${file.path}:${open.marker.lineStartOffset}:${marker.lineEndOffset}`,
+                    path: file.path,
+                    sourceFingerprint: file.fingerprint,
+                    classId: marker.classId,
+                    nameSuffix: marker.nameSuffix,
+                    blockKey: marker.blockKey,
+                    start: open.marker,
+                    end: marker,
+                    bodyStartOffset: open.marker.lineEndOffset,
+                    bodyEndOffset: marker.lineStartOffset,
+                    replaceStartOffset: open.marker.lineStartOffset,
+                    replaceEndOffset: marker.lineEndOffset,
+                });
+            }
+            open = null;
+        }
+        if (open) {
+            diagnostics.push(this.sourceDiagnostic("marker.missing-end", "error", `Start marker ${open.marker.classId} ${open.marker.blockKey} has no matching End marker.`, file.path, open.marker.line, open.marker.column));
+        }
+    }
+    /** 将文件文本拆成保留精确绝对偏移的逻辑行。 */
+    splitLines(text) {
+        const lines = [];
+        let startOffset = 0;
+        let number = 0;
+        while (startOffset < text.length) {
+            let newlineOffset = startOffset;
+            while (newlineOffset < text.length &&
+                text[newlineOffset] !== "\r" &&
+                text[newlineOffset] !== "\n") {
+                newlineOffset += 1;
+            }
+            let endOffset = newlineOffset;
+            if (newlineOffset < text.length) {
+                endOffset =
+                    text[newlineOffset] === "\r" && text[newlineOffset + 1] === "\n"
+                        ? newlineOffset + 2
+                        : newlineOffset + 1;
+            }
+            lines.push({
+                number,
+                text: text.slice(startOffset, newlineOffset),
+                startOffset,
+                endOffset,
+            });
+            startOffset = endOffset;
+            number += 1;
+        }
+        return lines;
+    }
+    /** 解析单行中的旧标记；普通源码行返回空结果。 */
+    parseLine(path, line) {
+        const startColumn = line.text.indexOf(KT_CODEGEN_MARKER_START);
+        const endColumn = line.text.indexOf(KT_CODEGEN_MARKER_END);
+        if (startColumn < 0 && endColumn < 0)
+            return { marker: null, diagnostic: null };
+        if (startColumn >= 0 && endColumn >= 0) {
+            return {
+                marker: null,
+                diagnostic: this.sourceDiagnostic("marker.ambiguous-line", "error", "One source line contains both Start and End Kevin markers.", path, line.number, Math.min(startColumn, endColumn)),
+            };
+        }
+        const kind = startColumn >= 0 ? "start" : "end";
+        const column = kind === "start" ? startColumn : endColumn;
+        const label = kind === "start" ? KT_CODEGEN_MARKER_START : KT_CODEGEN_MARKER_END;
+        const payloadColumn = column + label.length;
+        if (line.text[payloadColumn] !== " ") {
+            return {
+                marker: null,
+                diagnostic: this.sourceDiagnostic("marker.malformed", "error", "Kevin marker must contain one space before its class identity.", path, line.number, column),
+            };
+        }
+        const payloadStartColumn = payloadColumn + 1;
+        const payload = line.text.slice(payloadStartColumn).trimEnd();
+        const separatorColumn = payload.indexOf(" ");
+        if (separatorColumn < 1 || separatorColumn === payload.length - 1) {
+            return {
+                marker: null,
+                diagnostic: this.sourceDiagnostic("marker.malformed-payload", "error", "Kevin marker must contain a class identity followed by a block discriminator.", path, line.number, column),
+            };
+        }
+        const classId = payload.slice(0, separatorColumn);
+        const blockKey = payload.slice(separatorColumn + 1).trim();
+        const beforeMarker = line.text.slice(0, column);
+        const commentColumn = beforeMarker.lastIndexOf("//");
+        const linePrefix = commentColumn >= 0 ? beforeMarker.slice(0, commentColumn) : "";
+        const markerEndColumn = payloadStartColumn + payload.length;
+        return {
+            marker: {
+                kind,
+                classId,
+                blockKey,
+                line,
+                column,
+                markerEndColumn,
+                text: line.text.slice(column, markerEndColumn),
+                linePrefix,
+            },
+            diagnostic: null,
+        };
+    }
+    /** 将内部解析记录转换为公开、可审计的绝对定位结构。 */
+    toMarkerPoint(path, marker, nameSuffix) {
+        return {
+            kind: marker.kind,
+            path,
+            classId: marker.classId,
+            nameSuffix,
+            blockKey: marker.blockKey,
+            line: marker.line.number,
+            column: marker.column,
+            lineStartOffset: marker.line.startOffset,
+            lineEndOffset: marker.line.endOffset,
+            markerStartOffset: marker.line.startOffset + marker.column,
+            markerEndOffset: marker.line.startOffset + marker.markerEndColumn,
+            text: marker.text,
+            linePrefix: marker.linePrefix,
+        };
+    }
+    /** 创建带文件、行、列定位的源码诊断。 */
+    sourceDiagnostic(code, severity, message, file, row, column) {
+        return {
+            code,
+            severity,
+            message,
+            path: { source: "source", file, row, column },
+        };
+    }
+}
+//# sourceMappingURL=KtCodegenMarker.js.map

package/dist/KtCodegenMarker.js.map

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

package/dist/KtCodegenOptions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 旧界面的 Combo 候选值。
+ *
+ * 数据仍是普通 string。未知值不会在这里或 Reader/Adapter 中被清空；
+ * UI 可以用 has* 方法标记错误，并等待用户主动选择新值。本类不持有 UI
+ * 状态，也不修改 `KtCodegenItem`。
+ */
+export declare class KtCodegenOptions {
+    /** 旧 VB/Qt 界面为 `TCKind` 提供的固定 Combo 候选值。 */
+    static readonly tcKinds: readonly ["", "tk_boolean", "tk_double", "tk_string", "tk_specobject", "tk_integer", "tk_null", "tk_void", "tk_short", "tk_char", "tk_octet", "tk_any", "tk_long", "tk_ushort", "tk_ulong", "tk_float", "tk_except", "tk_enum", "tk_sequence", "tk_objref", "tk_TypeCode", "tk_Principal", "tk_struct", "tk_union", "tk_array", "tk_alias", "tk_external", "tk_list", "tk_component", "tk_error", "tk_techno"];
+    /** 旧 VB/Qt 界面为 `CATAttrInOut` 提供的固定 Combo 候选值。 */
+    static readonly catAttrInOutValues: readonly ["", "sp_IN", "sp_NEUTRAL", "sp_OUT"];
+    /**
+     * 旧 VB/Qt 界面为 `Component` 提供的 CAA 与 Qt 控件候选值。
+     *
+     * `-CAA Component-` 和 `-QT Component-` 是旧列表中的分组显示项，继续保留
+     * 以便宿主复现旧界面；是否允许用户实际选择由 UI 决定。
+     */
+    static readonly components: readonly ["", "-CAA Component-", "SelectorList", "CheckButton", "RadioButton", "Spinner", "Combo", "PushButton", "Editor", "Label", "MultiList", "-QT Component-", "QListWidget", "QDoubleSpinBox", "QSpinBox", "QLineEdit", "QComboBox", "QRadioButton", "QCheckBox", "QTableWidget", "QTableView"];
+    /** 判断字符串是否属于已知 `TCKind` 候选值，不修改传入值。 */
+    static hasTcKind(value: string): boolean;
+    /** 判断字符串是否属于已知 `CATAttrInOut` 候选值，不修改传入值。 */
+    static hasCatAttrInOut(value: string): boolean;
+    /** 判断字符串是否属于已知 `Component` 候选值，不修改传入值。 */
+    static hasComponent(value: string): boolean;
+    /** 公共候选值检查的内部实现。 */
+    private static includes;
+}
+//# sourceMappingURL=KtCodegenOptions.d.ts.map

package/dist/KtCodegenOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenOptions.d.ts","sourceRoot":"","sources":["../src/KtCodegenOptions.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,4CAA4C;IAC5C,gBAAuB,OAAO,iZAgCnB;IAEX,kDAAkD;IAClD,gBAAuB,kBAAkB,iDAK9B;IAEX;;;;;OAKG;IACH,gBAAuB,UAAU,uSAsBtB;IAEX,uCAAuC;WACzB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI/C,6CAA6C;WAC/B,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIrD,0CAA0C;WAC5B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlD,oBAAoB;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ;CAGxB"}

package/dist/KtCodegenOptions.js

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * 旧界面的 Combo 候选值。
+ *
+ * 数据仍是普通 string。未知值不会在这里或 Reader/Adapter 中被清空；
+ * UI 可以用 has* 方法标记错误，并等待用户主动选择新值。本类不持有 UI
+ * 状态，也不修改 `KtCodegenItem`。
+ */
+export class KtCodegenOptions {
+    /** 旧 VB/Qt 界面为 `TCKind` 提供的固定 Combo 候选值。 */
+    static tcKinds = [
+        "", // 未指定类型
+        "tk_boolean", // 布尔类型
+        "tk_double", // 双精度浮点类型
+        "tk_string", // 字符串类型
+        "tk_specobject", // CAA SpecObject 类型
+        "tk_integer", // 旧生成器使用的整数类型
+        "tk_null", // 空类型
+        "tk_void", // void 类型
+        "tk_short", // 短整型
+        "tk_char", // 字符类型
+        "tk_octet", // 八位字节类型
+        "tk_any", // CORBA Any 类型
+        "tk_long", // 长整型
+        "tk_ushort", // 无符号短整型
+        "tk_ulong", // 无符号长整型
+        "tk_float", // 单精度浮点类型
+        "tk_except", // 异常类型
+        "tk_enum", // 枚举类型
+        "tk_sequence", // 序列类型
+        "tk_objref", // 对象引用类型
+        "tk_TypeCode", // CORBA TypeCode 类型
+        "tk_Principal", // CORBA Principal 类型
+        "tk_struct", // 结构体类型
+        "tk_union", // 联合体类型
+        "tk_array", // 数组类型
+        "tk_alias", // 类型别名
+        "tk_external", // 旧生成器扩展的外部类型
+        "tk_list", // 旧生成器扩展的列表类型
+        "tk_component", // 旧生成器扩展的组件类型
+        "tk_error", // 旧生成器扩展的错误类型
+        "tk_techno", // 旧生成器扩展的技术对象类型
+    ];
+    /** 旧 VB/Qt 界面为 `CATAttrInOut` 提供的固定 Combo 候选值。 */
+    static catAttrInOutValues = [
+        "", // 未指定方向
+        "sp_IN", // 输入属性
+        "sp_NEUTRAL", // 中性属性
+        "sp_OUT", // 输出属性
+    ];
+    /**
+     * 旧 VB/Qt 界面为 `Component` 提供的 CAA 与 Qt 控件候选值。
+     *
+     * `-CAA Component-` 和 `-QT Component-` 是旧列表中的分组显示项，继续保留
+     * 以便宿主复现旧界面；是否允许用户实际选择由 UI 决定。
+     */
+    static components = [
+        "", // 不生成控件
+        "-CAA Component-", // CAA 控件分组标题
+        "SelectorList", // CAA 选择列表
+        "CheckButton", // CAA 复选按钮
+        "RadioButton", // CAA 单选按钮
+        "Spinner", // CAA 数值调节控件
+        "Combo", // CAA 下拉选择控件
+        "PushButton", // CAA 普通按钮
+        "Editor", // CAA 文本编辑控件
+        "Label", // CAA 文本标签
+        "MultiList", // CAA 多列或多选列表
+        "-QT Component-", // Qt 控件分组标题
+        "QListWidget", // Qt 列表控件
+        "QDoubleSpinBox", // Qt 双精度数值控件
+        "QSpinBox", // Qt 整数数值控件
+        "QLineEdit", // Qt 单行文本控件
+        "QComboBox", // Qt 下拉选择控件
+        "QRadioButton", // Qt 单选按钮
+        "QCheckBox", // Qt 复选框
+        "QTableWidget", // Qt 基于 Item 的表格控件
+        "QTableView", // Qt Model/View 表格控件
+    ];
+    /** 判断字符串是否属于已知 `TCKind` 候选值，不修改传入值。 */
+    static hasTcKind(value) {
+        return this.includes(this.tcKinds, value);
+    }
+    /** 判断字符串是否属于已知 `CATAttrInOut` 候选值，不修改传入值。 */
+    static hasCatAttrInOut(value) {
+        return this.includes(this.catAttrInOutValues, value);
+    }
+    /** 判断字符串是否属于已知 `Component` 候选值，不修改传入值。 */
+    static hasComponent(value) {
+        return this.includes(this.components, value);
+    }
+    /** 公共候选值检查的内部实现。 */
+    static includes(values, value) {
+        return values.includes(value);
+    }
+}
+//# sourceMappingURL=KtCodegenOptions.js.map

package/dist/KtCodegenOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenOptions.js","sourceRoot":"","sources":["../src/KtCodegenOptions.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAC3B,4CAA4C;IACrC,MAAM,CAAU,OAAO,GAAG;QAC/B,EAAE,EAAE,QAAQ;QACZ,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,QAAQ;QACrB,eAAe,EAAE,oBAAoB;QACrC,YAAY,EAAE,cAAc;QAC5B,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,OAAO;QAClB,UAAU,EAAE,SAAS;QACrB,QAAQ,EAAE,eAAe;QACzB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,SAAS;QACtB,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE,OAAO;QAClB,aAAa,EAAE,OAAO;QACtB,WAAW,EAAE,SAAS;QACtB,aAAa,EAAE,oBAAoB;QACnC,cAAc,EAAE,qBAAqB;QACrC,WAAW,EAAE,QAAQ;QACrB,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,OAAO;QACnB,UAAU,EAAE,OAAO;QACnB,aAAa,EAAE,cAAc;QAC7B,SAAS,EAAE,cAAc;QACzB,cAAc,EAAE,cAAc;QAC9B,UAAU,EAAE,cAAc;QAC1B,WAAW,EAAE,gBAAgB;KACrB,CAAC;IAEX,kDAAkD;IAC3C,MAAM,CAAU,kBAAkB,GAAG;QAC1C,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,OAAO;QACrB,QAAQ,EAAE,OAAO;KACT,CAAC;IAEX;;;;;OAKG;IACI,MAAM,CAAU,UAAU,GAAG;QAClC,EAAE,EAAE,QAAQ;QACZ,iBAAiB,EAAE,aAAa;QAChC,cAAc,EAAE,WAAW;QAC3B,aAAa,EAAE,WAAW;QAC1B,aAAa,EAAE,WAAW;QAC1B,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,aAAa;QACtB,YAAY,EAAE,WAAW;QACzB,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,cAAc;QAC3B,gBAAgB,EAAE,YAAY;QAC9B,aAAa,EAAE,UAAU;QACzB,gBAAgB,EAAE,aAAa;QAC/B,UAAU,EAAE,YAAY;QACxB,WAAW,EAAE,YAAY;QACzB,WAAW,EAAE,YAAY;QACzB,cAAc,EAAE,UAAU;QAC1B,WAAW,EAAE,SAAS;QACtB,cAAc,EAAE,mBAAmB;QACnC,YAAY,EAAE,qBAAqB;KAC3B,CAAC;IAEX,uCAAuC;IAChC,MAAM,CAAC,SAAS,CAAC,KAAa;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,6CAA6C;IACtC,MAAM,CAAC,eAAe,CAAC,KAAa;QACzC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,0CAA0C;IACnC,MAAM,CAAC,YAAY,CAAC,KAAa;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,oBAAoB;IACZ,MAAM,CAAC,QAAQ,CAAC,MAAyB,EAAE,KAAa;QAC9D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC"}

package/dist/KtCodegenParam.d.ts

@@ -0,0 +1,60 @@
+import { KtCodegenItem } from "./KtCodegenItem.js";
+/** 配置数据进入统一模型之前的来源格式。 */
+export type KtCodegenSourceFormat = "legacy-v4-json" | "legacy-17-column-csv" | "native";
+/** 读取旧配置时保留的格式、协议和扩展字段信息。 */
+export interface KtCodegenSource {
+    /** 当前实例最初来自旧 v4 JSON、旧17列 CSV，还是原生 TS 创建。 */
+    format: KtCodegenSourceFormat;
+    /** 旧 JSON 根字段 `type`；当前兼容值为 `100106`。 */
+    legacyType: string;
+    /** 旧 JSON 根字段 `version`；当前兼容值为 `4.0`。 */
+    legacyVersion: string;
+    /** 输入文件中的原始表头顺序，用于兼容检查和问题诊断。 */
+    headers: string[];
+    /** 未被当前模型识别的旧 JSON 根字段，写回时不得丢失。 */
+    extensions: Record<string, unknown>;
+}
+/**
+ * KtCodegen 的唯一共享参数数据容器。
+ *
+ * 对应旧 VB `KevinCAAFileGuide` 的类级 `_Name*` 与 `_FieldList`、C++
+ * `KtaControlConfigData`，以及 Qt `KtdAutoCodeParam` 的配置子集。文件路径、
+ * 搜索文本、选中行等宿主运行状态不属于本类。
+ *
+ * 所有成员公开、可变，不生成 getter/setter。Model、View、Controller、Core
+ * 和 Renderer 应共享同一个实例；一处修改会立即对其他持有者可见。
+ *
+ * 本类只维护数据和最小构造初始化，不负责 CSV/JSON、校验、清空、复制或
+ * 代码生成。这些操作分别属于 Reader、Adapter、Controller 和 Core。
+ */
+export declare class KtCodegenParam {
+    /** 原生模型类型标识，用于与其他 Phoenix Wing 数据对象区分。 */
+    kind: "kt.codegen";
+    /** TypeScript 领域模型版本；与旧文件的 `version: 4.0` 相互独立。 */
+    schemaVersion: 1;
+    /** 输入配置的来源协议、原始表头和未知扩展字段。 */
+    source: KtCodegenSource;
+    /** 类名或生成符号的公共前缀，对应旧配置 `NamePrefix`。 */
+    namePrefix: string;
+    /** 类名或生成符号的主体名称，对应旧配置 `NameMiddle`。 */
+    nameMiddle: string;
+    /** 生成代码使用的命名空间，对应旧配置 `NameSpace`。 */
+    nameSpace: string;
+    /** 列表或集合生成时使用的追加函数名，对应旧配置 `AppendFunction`。 */
+    appendFunction: string;
+    /**
+     * 当前配置包含的参数项。
+     *
+     * Controller 通过 Adapter 使用原数组 `splice` 更新内容，避免持有此数组
+     * 引用的 UI、Core 或 Renderer 在重新读取配置后失去共享关系。
+     */
+    items: KtCodegenItem[];
+    /**
+     * 创建共享参数数据，并可用同名字段进行初始化。
+     *
+     * 构造时复制 `source`、`headers`、`extensions` 和 `items`，避免初始化对象
+     * 与新实例意外共享可变的嵌套容器。不会执行读写、校验或自动修正。
+     */
+    constructor(initial?: Partial<KtCodegenParam>);
+}
+//# sourceMappingURL=KtCodegenParam.d.ts.map

package/dist/KtCodegenParam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenParam.d.ts","sourceRoot":"","sources":["../src/KtCodegenParam.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,yBAAyB;AACzB,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,sBAAsB,GACtB,QAAQ,CAAC;AAEb,6BAA6B;AAC7B,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,MAAM,EAAE,qBAAqB,CAAC;IAE9B,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAc;IACzB,0CAA0C;IACnC,IAAI,EAAE,YAAY,CAAgB;IAEzC,mDAAmD;IAC5C,aAAa,EAAE,CAAC,CAAK;IAE5B,6BAA6B;IACtB,MAAM,EAAE,eAAe,CAM5B;IAEF,uCAAuC;IAChC,UAAU,EAAE,MAAM,CAAM;IAE/B,uCAAuC;IAChC,UAAU,EAAE,MAAM,CAAM;IAE/B,qCAAqC;IAC9B,SAAS,EAAE,MAAM,CAAM;IAE9B,+CAA+C;IACxC,cAAc,EAAE,MAAM,CAAM;IAEnC;;;;;OAKG;IACI,KAAK,EAAE,aAAa,EAAE,CAAM;IAEnC;;;;;OAKG;gBACS,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;CAiB9C"}

package/dist/KtCodegenParam.js

@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: Apache-2.0
+import { KtCodegenItem } from "./KtCodegenItem.js";
+/**
+ * KtCodegen 的唯一共享参数数据容器。
+ *
+ * 对应旧 VB `KevinCAAFileGuide` 的类级 `_Name*` 与 `_FieldList`、C++
+ * `KtaControlConfigData`，以及 Qt `KtdAutoCodeParam` 的配置子集。文件路径、
+ * 搜索文本、选中行等宿主运行状态不属于本类。
+ *
+ * 所有成员公开、可变，不生成 getter/setter。Model、View、Controller、Core
+ * 和 Renderer 应共享同一个实例；一处修改会立即对其他持有者可见。
+ *
+ * 本类只维护数据和最小构造初始化，不负责 CSV/JSON、校验、清空、复制或
+ * 代码生成。这些操作分别属于 Reader、Adapter、Controller 和 Core。
+ */
+export class KtCodegenParam {
+    /** 原生模型类型标识，用于与其他 Phoenix Wing 数据对象区分。 */
+    kind = "kt.codegen";
+    /** TypeScript 领域模型版本；与旧文件的 `version: 4.0` 相互独立。 */
+    schemaVersion = 1;
+    /** 输入配置的来源协议、原始表头和未知扩展字段。 */
+    source = {
+        format: "native",
+        legacyType: "100106",
+        legacyVersion: "4.0",
+        headers: [],
+        extensions: {},
+    };
+    /** 类名或生成符号的公共前缀，对应旧配置 `NamePrefix`。 */
+    namePrefix = "";
+    /** 类名或生成符号的主体名称，对应旧配置 `NameMiddle`。 */
+    nameMiddle = "";
+    /** 生成代码使用的命名空间，对应旧配置 `NameSpace`。 */
+    nameSpace = "";
+    /** 列表或集合生成时使用的追加函数名，对应旧配置 `AppendFunction`。 */
+    appendFunction = "";
+    /**
+     * 当前配置包含的参数项。
+     *
+     * Controller 通过 Adapter 使用原数组 `splice` 更新内容，避免持有此数组
+     * 引用的 UI、Core 或 Renderer 在重新读取配置后失去共享关系。
+     */
+    items = [];
+    /**
+     * 创建共享参数数据，并可用同名字段进行初始化。
+     *
+     * 构造时复制 `source`、`headers`、`extensions` 和 `items`，避免初始化对象
+     * 与新实例意外共享可变的嵌套容器。不会执行读写、校验或自动修正。
+     */
+    constructor(initial) {
+        if (!initial)
+            return;
+        this.kind = initial.kind ?? this.kind;
+        this.schemaVersion = initial.schemaVersion ?? this.schemaVersion;
+        this.source = {
+            ...this.source,
+            ...initial.source,
+            headers: [...(initial.source?.headers ?? this.source.headers)],
+            extensions: { ...(initial.source?.extensions ?? this.source.extensions) },
+        };
+        this.namePrefix = initial.namePrefix ?? this.namePrefix;
+        this.nameMiddle = initial.nameMiddle ?? this.nameMiddle;
+        this.nameSpace = initial.nameSpace ?? this.nameSpace;
+        this.appendFunction = initial.appendFunction ?? this.appendFunction;
+        this.items = (initial.items ?? this.items).map((item) => new KtCodegenItem(item));
+    }
+}
+//# sourceMappingURL=KtCodegenParam.js.map

package/dist/KtCodegenParam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenParam.js","sourceRoot":"","sources":["../src/KtCodegenParam.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA0BnD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,cAAc;IACzB,0CAA0C;IACnC,IAAI,GAAiB,YAAY,CAAC;IAEzC,mDAAmD;IAC5C,aAAa,GAAM,CAAC,CAAC;IAE5B,6BAA6B;IACtB,MAAM,GAAoB;QAC/B,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,QAAQ;QACpB,aAAa,EAAE,KAAK;QACpB,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,EAAE;KACf,CAAC;IAEF,uCAAuC;IAChC,UAAU,GAAW,EAAE,CAAC;IAE/B,uCAAuC;IAChC,UAAU,GAAW,EAAE,CAAC;IAE/B,qCAAqC;IAC9B,SAAS,GAAW,EAAE,CAAC;IAE9B,+CAA+C;IACxC,cAAc,GAAW,EAAE,CAAC;IAEnC;;;;;OAKG;IACI,KAAK,GAAoB,EAAE,CAAC;IAEnC;;;;;OAKG;IACH,YAAY,OAAiC;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC;QACjE,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,OAAO,CAAC,MAAM;YACjB,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9D,UAAU,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;SAC1E,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC;QACxD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC;QACxD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC;QACrD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,CAAC;QACpE,IAAI,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC;CACF"}

package/dist/KtCodegenReader.d.ts

@@ -0,0 +1,23 @@
+import type { KtCodegenDataResult } from "./model/diagnostic.js";
+import type { KtCodegenParam } from "./KtCodegenParam.js";
+/**
+ * CSV/JSON 输入边界。
+ *
+ * Reader 把旧配置解析成新的临时 `KtCodegenParam`，不持有共享状态，也不会
+ * 直接修改 Controller 的共享实例。是否应用读取结果由 Controller 决定。
+ */
+export declare class KtCodegenReader {
+    /**
+     * 读取旧 v4 JSON 字符串或已经解析的对象。
+     *
+     * 保留未知根字段和列表外字符串；协议、列类型或必填字段问题通过诊断返回。
+     */
+    readJson(input: string | unknown): KtCodegenDataResult<KtCodegenParam>;
+    /**
+     * 读取旧17列 CSV。
+     *
+     * 同时兼容旧 Qt 简单 CSV 和 RFC 4180 引号；不会自动清空未知 Combo 字符串。
+     */
+    readCsv(text: string): KtCodegenDataResult<KtCodegenParam>;
+}
+//# sourceMappingURL=KtCodegenReader.d.ts.map

package/dist/KtCodegenReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenReader.d.ts","sourceRoot":"","sources":["../src/KtCodegenReader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,mBAAmB,CAAC,cAAc,CAAC;IAItE;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,cAAc,CAAC;CAG3D"}

package/dist/KtCodegenReader.js

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: Apache-2.0
+import { ktCodegenParseLegacyCsv } from "./legacy/csv.js";
+import { ktCodegenParseLegacyV4Json } from "./legacy/v4-json.js";
+/**
+ * CSV/JSON 输入边界。
+ *
+ * Reader 把旧配置解析成新的临时 `KtCodegenParam`，不持有共享状态，也不会
+ * 直接修改 Controller 的共享实例。是否应用读取结果由 Controller 决定。
+ */
+export class KtCodegenReader {
+    /**
+     * 读取旧 v4 JSON 字符串或已经解析的对象。
+     *
+     * 保留未知根字段和列表外字符串；协议、列类型或必填字段问题通过诊断返回。
+     */
+    readJson(input) {
+        return ktCodegenParseLegacyV4Json(input);
+    }
+    /**
+     * 读取旧17列 CSV。
+     *
+     * 同时兼容旧 Qt 简单 CSV 和 RFC 4180 引号；不会自动清空未知 Combo 字符串。
+     */
+    readCsv(text) {
+        return ktCodegenParseLegacyCsv(text);
+    }
+}
+//# sourceMappingURL=KtCodegenReader.js.map

package/dist/KtCodegenReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KtCodegenReader.js","sourceRoot":"","sources":["../src/KtCodegenReader.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAGtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,KAAuB;QAC9B,OAAO,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF"}