@phoenix-wing/kt-codegen 0.4.1 → 0.4.2

package/dist/renderer/caa-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caa-renderer.d.ts","sourceRoot":"","sources":["../../src/renderer/caa-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAMjC,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,2oBAI1B,CAAC;AAEX,mDAAmD;AACnD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,sBAAsB,GACjC,uBAAuB,CAWzB"}

package/dist/renderer/caa-renderer.js

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: Apache-2.0
+import { KT_CODEGEN_CAA_COMMAND_FAMILIES } from "./caa-command-families.js";
+import { KT_CODEGEN_CAA_DIALOG_FAMILIES } from "./caa-dialog-family.js";
+import { KT_CODEGEN_CAA_FEATURE_FAMILIES } from "./caa-feature-families.js";
+import { ktCodegenRenderRegisteredFamilies } from "./family-registry.js";
+/** CAA 只在这里组合能力；具体模板归各 block family 所有。 */
+export const KT_CODEGEN_CAA_FAMILIES = [
+    ...KT_CODEGEN_CAA_FEATURE_FAMILIES,
+    ...KT_CODEGEN_CAA_DIALOG_FAMILIES,
+    ...KT_CODEGEN_CAA_COMMAND_FAMILIES,
+];
+/** 通过 family registry 生成已迁移 CAA block，并报告未注册目标。 */
+export function ktCodegenRenderCaa(context, algorithms) {
+    return ktCodegenRenderRegisteredFamilies(context, algorithms, KT_CODEGEN_CAA_FAMILIES, {
+        supportedTargets: [
+            "caa.core",
+            "caa.model",
+            "caa.feature-io",
+            "caa.control",
+            "caa.dialog",
+        ],
+        noFamilyMessage: (target) => `${target} has no migrated CAA block renderer yet.`,
+    });
+}
+//# sourceMappingURL=caa-renderer.js.map

package/dist/renderer/caa-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caa-renderer.js","sourceRoot":"","sources":["../../src/renderer/caa-renderer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAOtC,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,sBAAsB,CAAC;AAEzE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,+BAA+B;IAClC,GAAG,8BAA8B;IACjC,GAAG,+BAA+B;CAC1B,CAAC;AAEX,mDAAmD;AACnD,MAAM,UAAU,kBAAkB,CAChC,OAAiC,EACjC,UAAkC;IAElC,OAAO,iCAAiC,CAAC,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE;QACrF,gBAAgB,EAAE;YAChB,UAAU;YACV,WAAW;YACX,gBAAgB;YAChB,aAAa;YACb,YAAY;SACb;QACD,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,0CAA0C;KACjF,CAAC,CAAC;AACL,CAAC"}

package/dist/renderer/cpp-parameter-family.d.ts

@@ -0,0 +1,7 @@
+import type { KtCodegenDefaultValueFormatter, KtCodegenRendererContext, KtCodegenRendererResult } from "../KtCodegenRenderer.js";
+import type { KtCodegenRendererFamily } from "./family-registry.js";
+export declare const KT_CODEGEN_CPP_PARAMETER_BLOCKS: readonly ["PARAM CONSTRUCTOR", "PARAM DECLARATION", "PARAM DESTRUCTOR", "PARAM EQUAL"];
+export declare const KT_CODEGEN_CPP_PARAMETER_FAMILIES: readonly [KtCodegenRendererFamily<KtCodegenDefaultValueFormatter>];
+/** 通过 block family 注册表生成普通 C++ Parameter 目标。 */
+export declare function ktCodegenRenderCppParameter(context: KtCodegenRendererContext, formatDefaultValue: KtCodegenDefaultValueFormatter): KtCodegenRendererResult;
+//# sourceMappingURL=cpp-parameter-family.d.ts.map

package/dist/renderer/cpp-parameter-family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpp-parameter-family.d.ts","sourceRoot":"","sources":["../../src/renderer/cpp-parameter-family.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAQpE,eAAO,MAAM,+BAA+B,wFAKK,CAAC;AAgFlD,eAAO,MAAM,iCAAiC,oEAEyC,CAAC;AAExF,gDAAgD;AAChD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,wBAAwB,EACjC,kBAAkB,EAAE,8BAA8B,GACjD,uBAAuB,CAUzB"}

package/dist/renderer/cpp-parameter-family.js

@@ -0,0 +1,77 @@
+// SPDX-License-Identifier: Apache-2.0
+import { ktCodegenRenderRegisteredFamilies } from "./family-registry.js";
+import { ktCodegenRenderLegacyEnd, ktCodegenRenderLegacyNotes, ktCodegenRenderLegacyStart, } from "./legacy-compatibility.js";
+export const KT_CODEGEN_CPP_PARAMETER_BLOCKS = [
+    "PARAM CONSTRUCTOR",
+    "PARAM DECLARATION",
+    "PARAM DESTRUCTOR",
+    "PARAM EQUAL",
+];
+/** 按旧 VB 规则生成一个普通 C++ Parameter 自动代码块的逻辑行。 */
+function ktCodegenRenderCppParameterLines(region, items, formatDefaultValue) {
+    const prefix = region.start.linePrefix;
+    const lines = ktCodegenRenderLegacyStart(region);
+    switch (region.blockKey) {
+        case "PARAM CONSTRUCTOR":
+            for (const item of items) {
+                const initializerPrefix = item.id === 1 ? ": " : ", ";
+                lines.push(`${prefix}${initializerPrefix}${item.paramString}(${formatDefaultValue(item)}) // ${item.id}`);
+            }
+            // 旧方法使用 Trim 写出 End，故 clang-format 与 End 不保留 `_prefix`。
+            lines.push("", "// clang-format on", `// ${region.end.text}`);
+            return lines;
+        case "PARAM EQUAL":
+            for (const item of items) {
+                // 旧 VB 使用 IndexOf("*") > 0；星号位于首字符时不会注释该行。
+                const pointerPrefix = item.dataType.indexOf("*") > 0 ? "// " : "";
+                lines.push(`${prefix}${pointerPrefix}${item.paramString} = iOriginal.${item.paramString}; // ${item.id}`);
+            }
+            return [...lines, ...ktCodegenRenderLegacyEnd(region)];
+        case "PARAM DESTRUCTOR":
+            for (const item of items) {
+                if (item.dataType.toLowerCase() === "catispecobject_var") {
+                    lines.push(`${prefix}${item.paramString} = NULL_var; // ${item.id}`);
+                }
+                else if (item.dataType.includes("*")) {
+                    lines.push(`${prefix}${item.paramString} = NULL; // ${item.id}`);
+                }
+                else {
+                    lines.push(`${prefix}// ${item.paramString} = ${formatDefaultValue(item, true)}; // ${item.id}`);
+                }
+            }
+            return [...lines, ...ktCodegenRenderLegacyEnd(region)];
+        case "PARAM DECLARATION":
+            lines.push("", `${prefix}// @app Kt Auto Code`, `${prefix}// @version 5.0.0, (2024)`, "");
+            items.forEach((item, index) => {
+                if (index > 0)
+                    lines.push("");
+                lines.push(...ktCodegenRenderLegacyNotes(item, prefix));
+                lines.push(`${prefix}${item.dataType} ${item.paramString};`);
+            });
+            return [...lines, ...ktCodegenRenderLegacyEnd(region)];
+        default:
+            return [];
+    }
+}
+const cppParameterFamily = {
+    id: "cpp.parameter",
+    blockKeys: KT_CODEGEN_CPP_PARAMETER_BLOCKS,
+    renderRegion(context, region, formatDefaultValue) {
+        const items = context.param.items.filter((item) => item.nameSuffix === region.nameSuffix && item.id >= 1);
+        return {
+            items,
+            lines: ktCodegenRenderCppParameterLines(region, items, formatDefaultValue),
+        };
+    },
+};
+export const KT_CODEGEN_CPP_PARAMETER_FAMILIES = [
+    cppParameterFamily,
+];
+/** 通过 block family 注册表生成普通 C++ Parameter 目标。 */
+export function ktCodegenRenderCppParameter(context, formatDefaultValue) {
+    return ktCodegenRenderRegisteredFamilies(context, formatDefaultValue, KT_CODEGEN_CPP_PARAMETER_FAMILIES, {
+        supportedTargets: ["cpp.parameter"],
+        noFamilyMessage: (target) => `${target} has no registered C++ block family.`,
+    });
+}
+//# sourceMappingURL=cpp-parameter-family.js.map

package/dist/renderer/cpp-parameter-family.js.map

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

package/dist/renderer/dialog-support.d.ts

@@ -0,0 +1,6 @@
+import type { KtCodegenItem } from "../KtCodegenItem.js";
+/** 取得旧 UI 多控件分支使用的集合起始下标；不支持时返回 `null`。 */
+export declare function ktCodegenLegacyDialogListIndex(dataType: string, includeFloat: boolean): number | null;
+/** 生成移除下划线后的旧 CAA/Qt 控件成员后缀。 */
+export declare function ktCodegenDialogParamName(item: KtCodegenItem): string;
+//# sourceMappingURL=dialog-support.d.ts.map

package/dist/renderer/dialog-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-support.d.ts","sourceRoot":"","sources":["../../src/renderer/dialog-support.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,2CAA2C;AAC3C,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,OAAO,GACpB,MAAM,GAAG,IAAI,CAKf;AAED,gCAAgC;AAChC,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAEpE"}

package/dist/renderer/dialog-support.js

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: Apache-2.0
+/** 取得旧 UI 多控件分支使用的集合起始下标；不支持时返回 `null`。 */
+export function ktCodegenLegacyDialogListIndex(dataType, includeFloat) {
+    if (dataType === "CATRawColldouble")
+        return 1;
+    if (dataType === "ListKtdouble" || dataType === "ListKtint")
+        return 0;
+    if (includeFloat && dataType === "ListKtfloat")
+        return 0;
+    return null;
+}
+/** 生成移除下划线后的旧 CAA/Qt 控件成员后缀。 */
+export function ktCodegenDialogParamName(item) {
+    return item.paramString.replaceAll("_", "");
+}
+//# sourceMappingURL=dialog-support.js.map

package/dist/renderer/dialog-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-support.js","sourceRoot":"","sources":["../../src/renderer/dialog-support.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,2CAA2C;AAC3C,MAAM,UAAU,8BAA8B,CAC5C,QAAgB,EAChB,YAAqB;IAErB,IAAI,QAAQ,KAAK,kBAAkB;QAAE,OAAO,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,cAAc,IAAI,QAAQ,KAAK,WAAW;QAAE,OAAO,CAAC,CAAC;IACtE,IAAI,YAAY,IAAI,QAAQ,KAAK,aAAa;QAAE,OAAO,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,wBAAwB,CAAC,IAAmB;IAC1D,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/renderer/family-registry.d.ts

@@ -0,0 +1,28 @@
+import { type KtCodegenBlockKey } from "../blocks/legacy-blocks.js";
+import type { KtCodegenMarkerRegion } from "../KtCodegenMarker.js";
+import type { KtCodegenItem } from "../KtCodegenItem.js";
+import type { KtCodegenRendererContext, KtCodegenRendererResult } from "../KtCodegenRenderer.js";
+/** 一个 family 对单个安全 Marker 区域的纯渲染结果。 */
+export interface KtCodegenRenderedRegion {
+    readonly items: readonly KtCodegenItem[];
+    readonly lines: readonly string[];
+}
+/**
+ * Block family strategy：注册表只映射能力，模板实现留在各 family 模块。
+ *
+ * `services` 由 Core 注入并保持只读，避免 family 反向依赖 Core。
+ */
+export interface KtCodegenRendererFamily<TServices> {
+    readonly id: string;
+    readonly blockKeys: readonly KtCodegenBlockKey[];
+    renderRegion(context: KtCodegenRendererContext, region: KtCodegenMarkerRegion, services: TServices): KtCodegenRenderedRegion;
+}
+export interface KtCodegenFamilyRegistryOptions {
+    readonly supportedTargets: readonly KtCodegenRendererContext["target"][];
+    readonly noFamilyMessage: (target: KtCodegenRendererContext["target"]) => string;
+}
+/** 建立不可重复的 block → family 能力映射；注册表本身不含模板。 */
+export declare function ktCodegenCreateRendererFamilyRegistry<TServices>(families: readonly KtCodegenRendererFamily<TServices>[]): ReadonlyMap<KtCodegenBlockKey, KtCodegenRendererFamily<TServices>>;
+/** 用 family 注册表生成一个目标，统一处理 artifact 绑定、兼容告警和待迁移诊断。 */
+export declare function ktCodegenRenderRegisteredFamilies<TServices>(context: KtCodegenRendererContext, services: TServices, families: readonly KtCodegenRendererFamily<TServices>[], options: KtCodegenFamilyRegistryOptions): KtCodegenRendererResult;
+//# sourceMappingURL=family-registry.d.ts.map

package/dist/renderer/family-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family-registry.d.ts","sourceRoot":"","sources":["../../src/renderer/family-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAMjC,uCAAuC;AACvC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB,CAAC,SAAS;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,YAAY,CACV,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,qBAAqB,EAC7B,QAAQ,EAAE,SAAS,GAClB,uBAAuB,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,wBAAwB,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzE,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC;CAClF;AAED,6CAA6C;AAC7C,wBAAgB,qCAAqC,CAAC,SAAS,EAC7D,QAAQ,EAAE,SAAS,uBAAuB,CAAC,SAAS,CAAC,EAAE,GACtD,WAAW,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC,CAcpE;AAED,sDAAsD;AACtD,wBAAgB,iCAAiC,CAAC,SAAS,EACzD,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,SAAS,EACnB,QAAQ,EAAE,SAAS,uBAAuB,CAAC,SAAS,CAAC,EAAE,EACvD,OAAO,EAAE,8BAA8B,GACtC,uBAAuB,CAmDzB"}

package/dist/renderer/family-registry.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: Apache-2.0
+import { ktCodegenGetBlock } from "../blocks/legacy-blocks.js";
+import { ktCodegenAppendRegionArtifact, ktCodegenLegacyDeprecatedDiagnostic, } from "./legacy-compatibility.js";
+/** 建立不可重复的 block → family 能力映射；注册表本身不含模板。 */
+export function ktCodegenCreateRendererFamilyRegistry(families) {
+    const registry = new Map();
+    for (const family of families) {
+        for (const blockKey of family.blockKeys) {
+            const existing = registry.get(blockKey);
+            if (existing) {
+                throw new Error(`Renderer block ${blockKey} is registered by both ${existing.id} and ${family.id}.`);
+            }
+            registry.set(blockKey, family);
+        }
+    }
+    return registry;
+}
+/** 用 family 注册表生成一个目标，统一处理 artifact 绑定、兼容告警和待迁移诊断。 */
+export function ktCodegenRenderRegisteredFamilies(context, services, families, options) {
+    const registry = ktCodegenCreateRendererFamilyRegistry(families);
+    const artifacts = [];
+    const diagnostics = [];
+    const requestedBlocks = new Set(context.blockKeys);
+    for (const region of context.markerRegions) {
+        const family = registry.get(region.blockKey);
+        if (!family ||
+            !requestedBlocks.has(region.blockKey) ||
+            ktCodegenGetBlock(region.blockKey).target !== context.target) {
+            continue;
+        }
+        const rendered = family.renderRegion(context, region, services);
+        const artifactCount = artifacts.length;
+        ktCodegenAppendRegionArtifact(context, region, rendered.items, rendered.lines, artifacts, diagnostics);
+        if (artifacts.length > artifactCount &&
+            ktCodegenGetBlock(region.blockKey).legacyState === "legacy-deprecated") {
+            diagnostics.push(ktCodegenLegacyDeprecatedDiagnostic(region));
+        }
+    }
+    const targetBlocks = context.blockKeys.filter((blockKey) => ktCodegenGetBlock(blockKey).target === context.target);
+    const pendingBlocks = targetBlocks.filter((blockKey) => !registry.has(blockKey));
+    const targetSupported = options.supportedTargets.includes(context.target);
+    const status = targetSupported && pendingBlocks.length === 0 ? "ready" : "scaffold";
+    if (status === "scaffold") {
+        diagnostics.push({
+            code: "renderer.blocks-pending",
+            severity: "info",
+            message: pendingBlocks.length > 0
+                ? `${context.target} still has pending blocks: ${pendingBlocks.join(", ")}.`
+                : options.noFamilyMessage(context.target),
+            path: { source: "renderer", field: context.target },
+        });
+    }
+    return { status, artifacts, diagnostics };
+}
+//# sourceMappingURL=family-registry.js.map

package/dist/renderer/family-registry.js.map

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

package/dist/renderer/legacy-compatibility.d.ts

@@ -0,0 +1,16 @@
+import type { KtCodegenArtifact } from "../api/contracts.js";
+import type { KtCodegenMarkerRegion } from "../KtCodegenMarker.js";
+import type { KtCodegenItem } from "../KtCodegenItem.js";
+import type { KtCodegenParamSpecListClassifier, KtCodegenRendererContext } from "../KtCodegenRenderer.js";
+import type { KtCodegenDiagnostic } from "../model/diagnostic.js";
+/** 按旧 `CodeAppendNotes` 的0/1/2模式创建 Doxygen 注释。 */
+export declare function ktCodegenRenderLegacyNotes(item: KtCodegenItem, prefix: string, mode?: 0 | 1 | 2, isParamSpecList?: KtCodegenParamSpecListClassifier): string[];
+/** 创建旧 Start 标记和 clang-format off 头部。 */
+export declare function ktCodegenRenderLegacyStart(region: KtCodegenMarkerRegion): string[];
+/** 创建标准旧 clang-format on 和 End 标记尾部。 */
+export declare function ktCodegenRenderLegacyEnd(region: KtCodegenMarkerRegion): string[];
+/** 把逻辑行组装为绑定安全区域的 artifact，或返回快照缺失诊断。 */
+export declare function ktCodegenAppendRegionArtifact(context: KtCodegenRendererContext, region: KtCodegenMarkerRegion, items: readonly KtCodegenItem[], lines: readonly string[], artifacts: KtCodegenArtifact[], diagnostics: KtCodegenDiagnostic[]): void;
+/** 兼容 family 统一产生废弃旧块告警，模板模块无需重复协议文案。 */
+export declare function ktCodegenLegacyDeprecatedDiagnostic(region: KtCodegenMarkerRegion): KtCodegenDiagnostic;
+//# sourceMappingURL=legacy-compatibility.d.ts.map

package/dist/renderer/legacy-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-compatibility.d.ts","sourceRoot":"","sources":["../../src/renderer/legacy-compatibility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,gCAAgC,EAChC,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,kDAAkD;AAClD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,CAAC,GAAG,CAAC,GAAG,CAAK,EACnB,eAAe,CAAC,EAAE,gCAAgC,GACjD,MAAM,EAAE,CAiBV;AAED,yCAAyC;AACzC,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAGlF;AAED,wCAAwC;AACxC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAGhF;AAoBD,yCAAyC;AACzC,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,iBAAiB,EAAE,EAC9B,WAAW,EAAE,mBAAmB,EAAE,GACjC,IAAI,CAqBN;AAED,yCAAyC;AACzC,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,qBAAqB,GAC5B,mBAAmB,CAWrB"}

package/dist/renderer/legacy-compatibility.js

@@ -0,0 +1,77 @@
+// SPDX-License-Identifier: Apache-2.0
+/** 按旧 `CodeAppendNotes` 的0/1/2模式创建 Doxygen 注释。 */
+export function ktCodegenRenderLegacyNotes(item, prefix, mode = 0, isParamSpecList) {
+    const lines = [`${prefix}/**`, `${prefix} * @brief ${item.name}`];
+    if (mode === 1) {
+        lines.push(`${prefix} * @param[in] value ${item.dataType}`, `${prefix} * @return HRESULT`);
+    }
+    else if (mode === 2) {
+        lines.push(`${prefix} * @return ${isParamSpecList?.(item) ? "HRESULT" : item.dataType}`);
+    }
+    if (item.author.length > 0)
+        lines.push(`${prefix} * @author ${item.author}`);
+    if (item.createDate.length > 0)
+        lines.push(`${prefix} * @date ${item.createDate}`);
+    if (item.notes.length > 0)
+        lines.push(`${prefix} * @note ${item.notes}`);
+    lines.push(`${prefix} * @id ${item.id}`, `${prefix} */`);
+    return lines;
+}
+/** 创建旧 Start 标记和 clang-format off 头部。 */
+export function ktCodegenRenderLegacyStart(region) {
+    const prefix = region.start.linePrefix;
+    return [`${prefix}// ${region.start.text}`, "", `${prefix}// clang-format off`];
+}
+/** 创建标准旧 clang-format on 和 End 标记尾部。 */
+export function ktCodegenRenderLegacyEnd(region) {
+    const prefix = region.start.linePrefix;
+    return ["", `${prefix}// clang-format on`, `${prefix}// ${region.end.text}`];
+}
+/** 从快照推断一个区域写回时应继续使用的换行符。 */
+function ktCodegenResolveRegionEol(context, region) {
+    const file = context.snapshot.files.find((candidate) => candidate.path === region.path && candidate.fingerprint === region.sourceFingerprint);
+    if (!file)
+        return null;
+    const eol = file.eol === "crlf" || (file.eol === undefined && file.text.includes("\r\n"))
+        ? "\r\n"
+        : "\n";
+    const endTail = file.text.slice(region.end.markerEndOffset, region.end.lineEndOffset);
+    return { eol, hasFinalEol: endTail.includes("\n") || endTail.includes("\r") };
+}
+/** 把逻辑行组装为绑定安全区域的 artifact，或返回快照缺失诊断。 */
+export function ktCodegenAppendRegionArtifact(context, region, items, lines, artifacts, diagnostics) {
+    const lineEnding = ktCodegenResolveRegionEol(context, region);
+    if (!lineEnding) {
+        diagnostics.push({
+            code: "renderer.source-snapshot-missing",
+            severity: "error",
+            message: `Marker region ${region.id} no longer has its source snapshot.`,
+            path: { source: "renderer", file: region.path, field: region.blockKey },
+        });
+        return;
+    }
+    const body = lines.join(lineEnding.eol);
+    artifacts.push({
+        id: `kt.codegen.artifact:${context.target}:${region.id}`,
+        regionId: region.id,
+        target: context.target,
+        blockKey: region.blockKey,
+        classId: region.classId,
+        content: lineEnding.hasFinalEol ? `${body}${lineEnding.eol}` : body,
+        sourceParameters: items.map((item) => item.paramString),
+    });
+}
+/** 兼容 family 统一产生废弃旧块告警，模板模块无需重复协议文案。 */
+export function ktCodegenLegacyDeprecatedDiagnostic(region) {
+    return {
+        code: "renderer.legacy-deprecated-block",
+        severity: "warning",
+        message: `${region.blockKey} is retained for compatibility; its archived VB method is marked discarded.`,
+        path: {
+            source: "renderer",
+            file: region.path,
+            field: region.blockKey,
+        },
+    };
+}
+//# sourceMappingURL=legacy-compatibility.js.map

package/dist/renderer/legacy-compatibility.js.map

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

package/dist/renderer/qt-dialog-family.d.ts

@@ -0,0 +1,7 @@
+import type { KtCodegenQtAlgorithms, KtCodegenRendererContext, KtCodegenRendererResult } from "../KtCodegenRenderer.js";
+import type { KtCodegenRendererFamily } from "./family-registry.js";
+export declare const KT_CODEGEN_QT_BLOCKS: readonly ["QT UPDATE DIALOG", "QT UPDATE INFORS"];
+export declare const KT_CODEGEN_QT_FAMILIES: readonly [KtCodegenRendererFamily<KtCodegenQtAlgorithms>];
+/** 通过 block family 注册表生成 Qt Dialog/Parameter 双向更新目标。 */
+export declare function ktCodegenRenderQt(context: KtCodegenRendererContext, algorithms: KtCodegenQtAlgorithms): KtCodegenRendererResult;
+//# sourceMappingURL=qt-dialog-family.d.ts.map

package/dist/renderer/qt-dialog-family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qt-dialog-family.d.ts","sourceRoot":"","sources":["../../src/renderer/qt-dialog-family.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAOpE,eAAO,MAAM,oBAAoB,mDAGgB,CAAC;AAqQlD,eAAO,MAAM,sBAAsB,2DAE2C,CAAC;AAE/E,wDAAwD;AACxD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,qBAAqB,GAChC,uBAAuB,CAKzB"}

package/dist/renderer/qt-dialog-family.js

@@ -0,0 +1,231 @@
+// SPDX-License-Identifier: Apache-2.0
+import { ktCodegenDialogParamName, ktCodegenLegacyDialogListIndex, } from "./dialog-support.js";
+import { ktCodegenRenderRegisteredFamilies } from "./family-registry.js";
+import { ktCodegenRenderLegacyEnd, ktCodegenRenderLegacyStart, } from "./legacy-compatibility.js";
+export const KT_CODEGEN_QT_BLOCKS = [
+    "QT UPDATE DIALOG",
+    "QT UPDATE INFORS",
+];
+/** 按旧 `CreateQTUpdateDialog` 规则把共享参数写入 Qt 控件。 */
+function ktCodegenRenderQtUpdateDialogLines(region, items, isPointOrVector3DType) {
+    const prefix = region.start.linePrefix;
+    const lines = ktCodegenRenderLegacyStart(region);
+    for (const item of items) {
+        lines.push("");
+        const dialogPointer = item.isParamDlg ? "dialogMore->" : "ui->";
+        const param = `parameter->${item.paramString}`;
+        const name = ktCodegenDialogParamName(item);
+        let notes = `// ${item.id}, ${item.paramString}, ${item.notes}`;
+        const generated = [];
+        if (item.componentCount <= 0) {
+            notes += `,NO ACTION, ${item.component},${item.componentCount}`;
+        }
+        else if (item.component === "QListWidget") {
+            generated.push(`${prefix}KT_AUTO_FIELD_SET_LINE(${dialogPointer}listWidget${name}, ${param});`);
+        }
+        else if (item.component === "QDoubleSpinBox" || item.component === "QSpinBox") {
+            const componentStem = item.component === "QDoubleSpinBox" ? "doubleSpinBox" : "spinBox";
+            const component = `${dialogPointer}${componentStem}${name}`;
+            if (isPointOrVector3DType(item.dataType)) {
+                const unitFactor = item.unit === "mm" ? " * 0.001" : "";
+                generated.push(`${prefix}${component}X->setValue(${param}.GetX()${unitFactor});`, `${prefix}${component}Y->setValue(${param}.GetY()${unitFactor});`, `${prefix}${component}Z->setValue(${param}.GetZ()${unitFactor});`);
+            }
+            else if (item.componentCount === 1) {
+                generated.push(`${prefix}${component}->setValue(${param});`);
+            }
+            else {
+                const indexSub = ktCodegenLegacyDialogListIndex(item.dataType, item.component === "QSpinBox");
+                if (indexSub === null) {
+                    notes += "Data type is not suitable for auto code.";
+                }
+                else {
+                    const unitFactor = item.unit === "mm" ? " * 0.001" : "";
+                    for (let index = 0; index < item.componentCount; index += 1) {
+                        generated.push(`${prefix}${component}${index}->setValue(${param}[${index + indexSub}]${unitFactor});`);
+                    }
+                }
+            }
+        }
+        else if (item.component.startsWith("QCheckBox")) {
+            const component = `${dialogPointer}checkBox${name}`;
+            if (item.componentCount === 1) {
+                generated.push(`${prefix}${component}->setChecked(${param});`);
+            }
+            else {
+                for (let index = 0; index < item.componentCount; index += 1) {
+                    generated.push(`${prefix}${component}${index}->setChecked( ${param} & (1<<${index}));`);
+                }
+            }
+        }
+        else if (item.component.startsWith("QRadioButton")) {
+            const component = `${dialogPointer}radioButton${name}`;
+            const count = item.componentCount === 1 ? 2 : item.componentCount;
+            const lastIndex = count - 1;
+            generated.push(`${prefix}if (${param}>${lastIndex} || ${param}<0) ${param}=0;//Correct`);
+            for (let index = 0; index < count; index += 1) {
+                generated.push(`${prefix}${component}${index}->setChecked( ${param}==${index});`);
+            }
+        }
+        else if (item.component.startsWith("QComboBox")) {
+            const component = `${dialogPointer}comboBox${name}`;
+            if (item.dataType === "int" ||
+                item.dataType === "short" ||
+                item.dataType === "uint32_t") {
+                generated.push(`${prefix}${component}->setCurrentIndex(${param});`);
+            }
+            else if (item.dataType === "QString") {
+                generated.push(`${prefix}${component}->setEditText(${param});`);
+            }
+            else {
+                // 原 VB 使用普通字符串而非插值字符串，故输出中保留字面占位符。
+                generated.push(`${prefix}${component}->setEditText(QString::fromLocal8Bit({strParamSame}.str()));`);
+            }
+        }
+        else if (item.component === "QLineEdit") {
+            const component = `${dialogPointer}lineEdit${name}`;
+            const value = item.dataType === "KtString"
+                ? ` QString::fromLocal8Bit(${param}.str()) `
+                : param;
+            if (item.componentCount === 1) {
+                generated.push(`${prefix}${component}->setText( ${value});`);
+            }
+            else {
+                for (let index = 0; index < item.componentCount; index += 1) {
+                    generated.push(`${prefix}${component}${index}->setText(${value}[${index + 1}]);`);
+                }
+            }
+        }
+        else {
+            const supportNote = item.component.length === 0 || item.component === "QPushButton"
+                ? ""
+                : " (Not Support)";
+            notes += `,NO ACTION, ${item.component}${supportNote},${item.componentCount}`;
+        }
+        lines.push(`${prefix}${notes}`, ...generated);
+    }
+    return [...lines, ...ktCodegenRenderLegacyEnd(region)];
+}
+/** 按旧 `CreateQTUpdateInfors` 规则把 Qt 控件值写回共享参数。 */
+function ktCodegenRenderQtUpdateInforsLines(region, items, isPointOrVector3DType) {
+    const prefix = region.start.linePrefix;
+    const lines = ktCodegenRenderLegacyStart(region);
+    for (const item of items) {
+        lines.push("");
+        const dialogPointer = item.isParamDlg ? "dialogMore->" : "ui->";
+        const param = `parameter->${item.paramString}`;
+        const name = ktCodegenDialogParamName(item);
+        let notes = `// ${item.id}, ${item.paramString}, ${item.notes}`;
+        const generated = [];
+        const convertToInt = item.tcKind === "tk_integer" && item.dataType.toLowerCase() !== "int";
+        if (item.componentCount <= 0) {
+            notes += `,NO ACTION, ${item.component},${item.componentCount}`;
+        }
+        else if (item.component === "QDoubleSpinBox" || item.component === "QSpinBox") {
+            const componentStem = item.component === "QDoubleSpinBox" ? "doubleSpinBox" : "spinBox";
+            const component = `${dialogPointer}${componentStem}${name}`;
+            if (isPointOrVector3DType(item.dataType)) {
+                const unitFactor = item.unit === "mm" ? " * 1000.0" : "";
+                generated.push(`${prefix}${param}.SetX(${component}X->value()${unitFactor});`, `${prefix}${param}.SetY(${component}Y->value()${unitFactor});`, `${prefix}${param}.SetZ(${component}Z->value()${unitFactor});`);
+            }
+            else if (item.componentCount === 1) {
+                const value = `${component}->value()`;
+                if (item.component === "QDoubleSpinBox" && item.dataType === "int") {
+                    generated.push(`${prefix}${param} = Kt::round(${value}); //round to int`);
+                }
+                else {
+                    generated.push(`${prefix}${param} = ${value};`);
+                }
+            }
+            else {
+                const indexSub = ktCodegenLegacyDialogListIndex(item.dataType, true);
+                if (indexSub === null) {
+                    notes += "Data type is not suitable for auto code.";
+                }
+                else {
+                    for (let index = 0; index < item.componentCount; index += 1) {
+                        const value = `${component}${index}->value()`;
+                        const rounded = item.component === "QDoubleSpinBox" && item.dataType === "int"
+                            ? `Kt::round(${value})`
+                            : value;
+                        generated.push(`${prefix}${param}[${index + indexSub}] = ${rounded};${rounded !== value ? " //round to int" : ""}`);
+                    }
+                }
+            }
+        }
+        else if (item.component.startsWith("QCheckBox")) {
+            const component = `${dialogPointer}checkBox${name}`;
+            if (item.componentCount === 1) {
+                generated.push(`${prefix}${param} = ${component}->isChecked();`);
+            }
+            else {
+                generated.push(`${prefix}${param}=0;`);
+                for (let index = 0; index < item.componentCount; index += 1) {
+                    generated.push(`${prefix}if (${component}${index}->isChecked()) { ${param} = ${param} | (1<<${index}); }`);
+                }
+            }
+        }
+        else if (item.component.startsWith("QRadioButton")) {
+            const component = `${dialogPointer}radioButton${name}`;
+            const count = item.componentCount === 1 ? 2 : item.componentCount;
+            generated.push(`${prefix}${param} = 0;//默认值0`);
+            for (let index = 0; index < count; index += 1) {
+                generated.push(`${prefix}if (${component}${index}->isChecked())`, `${prefix}    ${param} = ${convertToInt ? `(${item.dataType})` : ""}${index};${convertToInt ? "}" : ""}`);
+            }
+        }
+        else if (item.component.startsWith("QComboBox")) {
+            const component = `${dialogPointer}comboBox${name}`;
+            if (item.dataType === "int" ||
+                item.dataType === "short" ||
+                item.dataType === "uint32_t") {
+                generated.push(`${prefix}${param} = ${component}->currentIndex();`);
+            }
+            else if (item.dataType === "QString") {
+                generated.push(`${prefix}${param} = ${component}->currentText();`);
+            }
+            else {
+                generated.push(`${prefix}${param} = ${component}->currentText().toLocal8Bit().constData();`);
+            }
+        }
+        else if (item.component === "QLineEdit") {
+            const component = `${dialogPointer}lineEdit${name}`;
+            const conversion = item.dataType === "KtString" ? ".toLocal8Bit().constData()" : "";
+            if (item.componentCount === 1) {
+                generated.push(`${prefix}${param} = ${component}->text()${conversion};`);
+            }
+            else {
+                for (let index = 0; index < item.componentCount; index += 1) {
+                    generated.push(`${prefix}${param}[${index + 1}] = ${component}${index}->text()${conversion};`);
+                }
+            }
+        }
+        else {
+            notes += `,NO ACTION, ${item.component} (Not Support),${item.componentCount}`;
+        }
+        lines.push(`${prefix}${notes}`, ...generated);
+    }
+    return [...lines, ...ktCodegenRenderLegacyEnd(region)];
+}
+const qtDialogFamily = {
+    id: "qt.dialog",
+    blockKeys: KT_CODEGEN_QT_BLOCKS,
+    renderRegion(context, region, algorithms) {
+        const items = context.param.items.filter((item) => item.nameSuffix === region.nameSuffix && item.id >= 1);
+        return {
+            items,
+            lines: region.blockKey === "QT UPDATE DIALOG"
+                ? ktCodegenRenderQtUpdateDialogLines(region, items, algorithms.isPointOrVector3DType)
+                : ktCodegenRenderQtUpdateInforsLines(region, items, algorithms.isPointOrVector3DType),
+        };
+    },
+};
+export const KT_CODEGEN_QT_FAMILIES = [
+    qtDialogFamily,
+];
+/** 通过 block family 注册表生成 Qt Dialog/Parameter 双向更新目标。 */
+export function ktCodegenRenderQt(context, algorithms) {
+    return ktCodegenRenderRegisteredFamilies(context, algorithms, KT_CODEGEN_QT_FAMILIES, {
+        supportedTargets: ["qt.dialog", "qt.parameter"],
+        noFamilyMessage: (target) => `${target} has no registered Qt block family.`,
+    });
+}
+//# sourceMappingURL=qt-dialog-family.js.map