@epoint-testtech/ep-stage-skill 0.0.16 → 0.0.17

package/dist/src/testcase/query-component-map.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 查询组件形态映射 —— 装配器 / calibrate / validation 三方共用的单一事实来源。
+ *
+ * 纪律（与 docs/00-memory/miniui-component-forms.md 互为镜像，改一必改另一）：
+ * - 白名单内组件：骨架 glue 用例承载（有对应交互实现）；
+ * - 白名单外组件（上游显式写了但未识别）：用例路由到 AI 桶（uncoveredCandidates），
+ *   不再静默压扁成 listbox 生成必败 glue 用例；
+ * - 上游未写 component（缺失）：回退 input 保住 CRUD 主链路，inference-trace 记 defaulted，
+ *   由 calibrate 在运行前用 elementmap 的运行时 controlType 纠正错误回退。
+ */
+/** 骨架 glue 支持的查询组件类型（白名单）。 */
+export type QueryComponentKind = 'input' | 'listbox' | 'datepicker' | 'tree';
+/** 白名单数组形态（供 validation/calibrate 做包含判断）。 */
+export declare const GLUE_QUERY_COMPONENT_WHITELIST: readonly QueryComponentKind[];
+/**
+ * 组件解析三态：
+ * - mapped：显式命中映射表（含上游直接写白名单类型名）；
+ * - defaulted：上游未写 component/type，回退 input（保住 CRUD 锚点主链路）；
+ * - unrecognized：上游显式写了但未在映射表，应路由 AI 桶。
+ */
+export type QueryComponentResolution = {
+    kind: QueryComponentKind;
+    raw: string;
+    source: 'mapped';
+} | {
+    kind: 'input';
+    raw: '';
+    source: 'defaulted';
+} | {
+    kind: null;
+    raw: string;
+    source: 'unrecognized';
+};
+/**
+ * 解析查询字段的组件形态。
+ *
+ * @param fieldInfo - 含可选 type/component 的字段描述（code_list queryFields 条目或 elementmap 条目）。
+ * @returns 三态解析结果。
+ */
+export declare function resolveQueryComponent(fieldInfo: {
+    type?: string;
+    component?: string;
+}): QueryComponentResolution;
+/**
+ * 判断组件值是否落在 glue 白名单（含 MiniUI 原名经映射后命中的情况）。
+ *
+ * @param component - code_list component 值或运行时 controlType。
+ * @returns 可解析为白名单类型时为 true。
+ */
+export declare function isGlueQueryComponent(component: string): component is QueryComponentKind;
+//# sourceMappingURL=query-component-map.d.ts.map

package/dist/src/testcase/query-component-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-component-map.d.ts","sourceRoot":"","sources":["../../../src/testcase/query-component-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAE7E,6CAA6C;AAC7C,eAAO,MAAM,8BAA8B,EAAE,SAAS,kBAAkB,EAKvE,CAAC;AAwBF;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAChC;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,wBAAwB,CAUhH;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,kBAAkB,CAEvF"}

package/dist/src/testcase/query-component-map.js

@@ -0,0 +1,64 @@
+/**
+ * 查询组件形态映射 —— 装配器 / calibrate / validation 三方共用的单一事实来源。
+ *
+ * 纪律（与 docs/00-memory/miniui-component-forms.md 互为镜像，改一必改另一）：
+ * - 白名单内组件：骨架 glue 用例承载（有对应交互实现）；
+ * - 白名单外组件（上游显式写了但未识别）：用例路由到 AI 桶（uncoveredCandidates），
+ *   不再静默压扁成 listbox 生成必败 glue 用例；
+ * - 上游未写 component（缺失）：回退 input 保住 CRUD 主链路，inference-trace 记 defaulted，
+ *   由 calibrate 在运行前用 elementmap 的运行时 controlType 纠正错误回退。
+ */
+/** 白名单数组形态（供 validation/calibrate 做包含判断）。 */
+export const GLUE_QUERY_COMPONENT_WHITELIST = [
+    'input',
+    'listbox',
+    'datepicker',
+    'tree',
+];
+/**
+ * 显式映射表：code_list component / 运行时 controlType（MiniUI 类名）→ 骨架类型。
+ * 键全部小写；解析时输入统一转小写后查表。
+ */
+const COMPONENT_KIND_MAP = {
+    input: 'input',
+    'mini-textbox': 'input',
+    'mini-password': 'input',
+    'mini-textarea': 'input',
+    listbox: 'listbox',
+    'mini-combobox': 'listbox',
+    'mini-listbox': 'listbox',
+    datepicker: 'datepicker',
+    'mini-datepicker': 'datepicker',
+    'mini-daterangepicker': 'datepicker',
+    'mini-monthpicker': 'datepicker',
+    tree: 'tree',
+    'mini-filtertree': 'tree',
+    'mini-tree': 'tree',
+    'mini-treeselect': 'tree',
+};
+/**
+ * 解析查询字段的组件形态。
+ *
+ * @param fieldInfo - 含可选 type/component 的字段描述（code_list queryFields 条目或 elementmap 条目）。
+ * @returns 三态解析结果。
+ */
+export function resolveQueryComponent(fieldInfo) {
+    const raw = fieldInfo.type ?? fieldInfo.component ?? '';
+    if (!raw) {
+        return { kind: 'input', raw: '', source: 'defaulted' };
+    }
+    const kind = COMPONENT_KIND_MAP[raw.toLowerCase()];
+    if (kind) {
+        return { kind, raw, source: 'mapped' };
+    }
+    return { kind: null, raw, source: 'unrecognized' };
+}
+/**
+ * 判断组件值是否落在 glue 白名单（含 MiniUI 原名经映射后命中的情况）。
+ *
+ * @param component - code_list component 值或运行时 controlType。
+ * @returns 可解析为白名单类型时为 true。
+ */
+export function isGlueQueryComponent(component) {
+    return Boolean(component) && COMPONENT_KIND_MAP[component.toLowerCase()] !== undefined;
+}

package/dist/src/validation/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/validation/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAsB,MAAM,kCAAkC,CAAC;AAcnG;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CAuHrE"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/validation/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAA4C,MAAM,kCAAkC,CAAC;AAezH;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,CA2KrE"}

package/dist/src/validation/contract.js

@@ -1,3 +1,4 @@
+import { isGlueQueryComponent } from '../testcase/query-component-map.js';
 const ALLOWED_STRATEGIES = new Set(['glue', 'ai']);
 /**
  * 断言值为非空字符串，否则抛错。
@@ -80,13 +81,19 @@ export function validateContract(obj) {
     if (!slotsRec.export || typeof slotsRec.export !== 'object') {
         throw new Error('contract.json5 缺 scenario.skeletonSlots.export');
     }
-    if (!slotsRec.export || typeof slotsRec.export !== 'object') {
-        throw new Error('contract.json5 缺 scenario.skeletonSlots.export');
-    }
     const exportSlot = slotsRec.export;
     requireString(exportSlot.moduleId, 'scenario.skeletonSlots.export.moduleId');
     requireString(exportSlot.label, 'scenario.skeletonSlots.export.label');
     requireString(exportSlot.mode, 'scenario.skeletonSlots.export.mode');
+    if (exportSlot.locators !== undefined) {
+        const exportLocators = exportSlot.locators;
+        if (exportLocators.exportButton !== undefined) {
+            requireString(exportLocators.exportButton, 'scenario.skeletonSlots.export.locators.exportButton');
+        }
+        if (exportLocators.exportContainer !== undefined) {
+            requireString(exportLocators.exportContainer, 'scenario.skeletonSlots.export.locators.exportContainer');
+        }
+    }
     // scenario.skeletonSlots.childGrids（可选）
     if (slotsRec.childGrids !== undefined) {
         if (!Array.isArray(slotsRec.childGrids)) {
@@ -128,5 +135,40 @@ export function validateContract(obj) {
     if (!Array.isArray(raw.unresolvedSlots)) {
         throw new Error('contract.json5 缺 unresolvedSlots[]');
     }
+    const unresolvedSlots = raw.unresolvedSlots;
+    // 白名单交叉一致性：searchFields.component 与 searchConditions / AI 通道记录必须各就各位。
+    // （calibrate 改写契约后同样过本门禁，保证装配期与校准期不分裂。）
+    const crudSlots = slotsRec.crud;
+    const searchConditions = Array.isArray(crudSlots.searchConditions)
+        ? crudSlots.searchConditions
+        : [];
+    const conditionLabels = new Set(searchConditions.map((c) => String(c.label ?? '')));
+    const gapIds = new Set(sc.gapCandidates.map((g) => String(g.gapId ?? '')));
+    for (const sf of sc.searchFields) {
+        const component = String(sf.component);
+        const label = String(sf.label);
+        const field = String(sf.field);
+        if (isGlueQueryComponent(component)) {
+            if (!conditionLabels.has(label)) {
+                throw new Error(`contract.json5 白名单组件缺槽位：searchFields[${label}].component=${component} 为白名单类型，` +
+                    `但 scenario.skeletonSlots.crud.searchConditions 中无对应条目`);
+            }
+        }
+        else {
+            if (conditionLabels.has(label)) {
+                throw new Error(`contract.json5 未识别组件混入 glue 槽位：searchFields[${label}].component=${component} 不在白名单，` +
+                    `不应出现在 searchConditions（用例应走 AI 通道）`);
+            }
+            const expectedGapId = `query-component:${field}`;
+            if (!gapIds.has(expectedGapId)) {
+                throw new Error(`contract.json5 未识别组件未走 AI 通道路由：searchFields[${label}].component=${component}，缺 gapCandidates[gapId=${expectedGapId}]`);
+            }
+            const hasUnresolvedRecord = unresolvedSlots.some((slot) => slot.kind === 'unsupported_query_component' && slot.slotPath.includes(label));
+            if (!hasUnresolvedRecord) {
+                throw new Error(`contract.json5 未识别组件未登记 unresolvedSlots：searchFields[${label}].component=${component}，` +
+                    `需 kind=unsupported_query_component 且 slotPath 含「${label}」的记录`);
+            }
+        }
+    }
     return raw;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoint-testtech/ep-stage-skill",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",