@epoint-testtech/ep-stage-skill 0.0.4-alpha.1 → 0.0.6

package/dist/src/generators/stage-skeleton-script.d.ts

@@ -9,10 +9,14 @@
 import type { CrudBusinessModuleContract } from '../contracts/crud-business-module.js';
 export type StageSkeletonCrudDeletePolicy = 'success_delete' | 'blocked_by_business_rule';
 export type StageSkeletonCrudDataValueStrategy = 'timestamp_prefix' | 'fixed_value';
+export type StageSkeletonCrudListboxValueStrategy = 'explicit' | 'first_non_placeholder';
+export type StageSkeletonCrudListboxSearchAssertion = 'contains_row_anchor' | 'none';
 export type StageSkeletonCrudListboxSelectionSlot = {
     field: string;
     label: string;
-    value: string;
+    value?: string;
+    valueStrategy?: StageSkeletonCrudListboxValueStrategy;
+    skipValues?: string[];
 };
 export type StageSkeletonCrudInputSearchConditionSlot = {
     component: 'input';
@@ -31,10 +35,45 @@ export type StageSkeletonCrudListboxSearchConditionSlot = {
     component: 'listbox';
     field: string;
     label: string;
-    value: string;
+    value?: string;
+    valueStrategy?: StageSkeletonCrudListboxValueStrategy;
+    skipValues?: string[];
+    searchAssertion?: StageSkeletonCrudListboxSearchAssertion;
     createSelections?: StageSkeletonCrudListboxSelectionSlot[];
 };
 export type StageSkeletonCrudSearchConditionSlot = StageSkeletonCrudInputSearchConditionSlot | StageSkeletonCrudListboxSearchConditionSlot;
+/**
+ * 子表列槽位（生成器层形态，与 skeleton ChildGridColumnSlot 保持一致）。
+ */
+export type StageSkeletonChildGridColumnSlot = {
+    field: string;
+    label: string;
+    component: 'input' | 'listbox';
+    required: boolean;
+    modelRef?: string;
+};
+/**
+ * 子表槽位（生成器层形态，与 skeleton ChildGridFlowSlots 保持一致）。
+ */
+export type StageSkeletonChildGridFlowSlots = {
+    gridId: string;
+    label: string;
+    pageRole: 'add' | 'edit';
+    editMode: 'cell_edit' | 'row_button_dialog' | 'none';
+    columns: StageSkeletonChildGridColumnSlot[];
+    locators: {
+        container: string;
+        addRowButton: string;
+        deleteSelectedButton: string;
+        grid: string;
+        editWrapInput: string;
+        editWrapListboxTrigger: string;
+        editWrapListboxInput: string;
+        rowCheckboxByIndex: string;
+        cellByIndexAndField: string;
+        cellValueByIndexAndField: string;
+    };
+};
 /**
  * stage-skeleton CRUD 骨架槽位。
  *
@@ -66,18 +105,6 @@ export type StageSkeletonCrudFlowSlots = {
         blockedDeleteMessage?: string;
     };
 };
-/**
- * 生成 stage-skeleton 测试脚本的输入参数。
- *
- * @property contract CRUD 业务模块契约
- * @property menuNavigation 菜单路径，传给 MenuPage.navigateToMenu
- * @property testName 生成的测试用例名称
- */
-export type StageSkeletonScriptOptions = {
-    contract: CrudBusinessModuleContract;
-    menuNavigation: string;
-    testName?: string;
-};
 /**
  * 将 CRUD 业务模块契约映射为 stage-skeleton 的 CrudFlowSlots。
  *
@@ -94,14 +121,54 @@ export declare function mapContractToStageSkeletonCrudSlots(contract: CrudBusine
  */
 export declare function renderStageSkeletonCrudSlots(slots: StageSkeletonCrudFlowSlots): string;
 /**
- * 生成动作级 CRUD + Export Playwright 测试脚本。
+ * 将子表槽位数组渲染为 TypeScript 对象字面量。
  *
- * 每个标准工作流（Create / Read / Update / Delete / Export）独立输出为
- * 一个 test case，使用 GlueWorkflowRecorder 记录执行报告。
- * 末尾保留 `// @stage-gap-append` 标记供 gap Custom test 追加。
+ * @param slots - 子表槽位数组
+ * @returns TypeScript 源码
+ */
+export declare function renderChildGridSlots(slots: StageSkeletonChildGridFlowSlots[]): string;
+/**
+ * fromSlots 入口生成参数（新协议，不依赖 CrudBusinessModuleContract）。
  *
- * @param options 生成参数
+ * 所有数据均来自入参：crudSlots 直接是 StageSkeletonCrudFlowSlots，
+ * exportSlot 是 contract.scenario.skeletonSlots.export 三元槽位，
+ * moduleId/moduleLabel 来自 testcase + contract.base.module，
+ * directUrl/primaryRole/requirementName 用于生成登录 + 直达链接进入模块的 openModule。
+ */
+export type GenerateStageSkeletonCrudSpecFromSlotsOptions = {
+    moduleId: string;
+    moduleLabel: string;
+    directUrl: string;
+    primaryRole: string;
+    requirementName: string;
+    crudSlots: StageSkeletonCrudFlowSlots;
+    exportSlot: {
+        moduleId: string;
+        label: string;
+        mode: string;
+    };
+    childGridSlots?: StageSkeletonChildGridFlowSlots[];
+};
+/**
+ * 基于 skeletonSlots 槽位生成动作级 CRUD + Export Playwright 测试脚本（新协议 fromSlots 入口）。
+ *
+ * 与 {@link generateStageSkeletonCrudSpec} 输出同构的 spec 模板
+ * （test.describe / recorder / openModule / Create-Read-Update-Delete-Export），
+ * 但所有数据来自入参槽位，**不接收 CrudBusinessModuleContract、不 import 它、
+ * 不调 mapContractToStageSkeletonCrudSlots**。
+ *
+ * - crudSlots 直接调 {@link renderStageSkeletonCrudSlots}（复用现有 render）。
+ * - exportSlot 调 {@link renderExportSlotsFromSlot}（listIframeSrcKeyword 取自 crudSlots.frames）。
+ * - deletePolicy 从 crudSlots.assertions.deletePolicy 取（不再从 contract.flows.delete 推）。
+ *
+ * @param options 生成参数（全部来自 contract.skeletonSlots + testcase 导航/模块信息）
  * @returns 完整的 `.spec.ts` 源码
  */
-export declare function generateStageSkeletonCrudSpec(options: StageSkeletonScriptOptions): string;
+export declare function generateStageSkeletonCrudSpecFromSlots(options: GenerateStageSkeletonCrudSpecFromSlotsOptions): string;
+/**
+ * @deprecated 旧 v2 协议入口已删除（新链路改用 {@link generateStageSkeletonCrudSpecFromSlots}）。
+ * 原实现接收 CrudBusinessModuleContract 并经 mapContractToStageSkeletonCrudSlots 映射，
+ * 新协议不再依赖 contract 直传，故整段移除。下方保留的 contract→slots 辅助函数
+ * 与 renderExportSlots(contract) 仅为历史参考，新链路不引用。
+ */
 //# sourceMappingURL=stage-skeleton-script.d.ts.map

package/dist/src/generators/stage-skeleton-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-skeleton-script.d.ts","sourceRoot":"","sources":["../../../src/generators/stage-skeleton-script.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,0BAA0B,EAAiF,MAAM,sCAAsC,CAAC;AAEtK,MAAM,MAAM,6BAA6B,GAAG,gBAAgB,GAAG,0BAA0B,CAAC;AAC1F,MAAM,MAAM,kCAAkC,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEpF,MAAM,MAAM,qCAAqC,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kCAAkC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,2CAA2C,GAAG;IACxD,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,qCAAqC,EAAE,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAC5C,yCAAyC,GACzC,2CAA2C,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,oCAAoC,EAAE,CAAC;IACzD,MAAM,EAAE;QACN,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,8BAA8B,EAAE,MAAM,CAAC;QACvC,6BAA6B,EAAE,MAAM,CAAC;QACtC,cAAc,EAAE,MAAM,CAAC;QACvB,4BAA4B,EAAE,MAAM,CAAC;QACrC,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,UAAU,EAAE;QACV,YAAY,EAAE,6BAA6B,CAAC;QAC5C,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAuRF;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,0BAA0B,CA0CpH;AA6DD;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAwBtF;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAoMzF"}
+{"version":3,"file":"stage-skeleton-script.d.ts","sourceRoot":"","sources":["../../../src/generators/stage-skeleton-script.ts"],"names":[],"mappings":"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"}