weaver-e10-builder 1.6.4 → 1.6.6

package/dist/commands/wf-form-layout-init-reviewed.js

@@ -0,0 +1,71 @@
+import { AuthSession } from '../core/auth.js';
+import { ApiClient } from '../core/client.js';
+import { resolveLayoutTarget } from '../services/form-layout-io.js';
+import { parseLayoutJson } from '../services/form-layout-source/json.js';
+import { distinctOutput, readJson, writeJson } from '../services/form-layout-source/artifact.js';
+import { applyWorkflowLayoutInit, prepareWorkflowLayoutInit } from '../services/workflow-layout-init-reviewed.js';
+export function registerWorkflowLayoutInitReviewedCommands(wfForm, program) {
+    const layout = wfForm.commands.find(command => command.name() === 'layout');
+    if (!layout)
+        throw new Error('必须先注册 wf-form layout');
+    layout.command('init-reviewed')
+        .description('预览并应用流程表单 PC 布局样式模板，保存后回读验证')
+        .argument('<formId>', '流程表单 ID')
+        .option('--layout-id <id>', '指定布局；不传则使用默认布局')
+        .option('--style-template <name|id>', '同布局类型下已启用的样式模板')
+        .option('--easy-template <name|id>', '表格式 PC 简易模板；与 --style-template 互斥')
+        .option('--read-only', '业务字段只读')
+        .option('--required', '业务字段必填')
+        .option('--single-row', '业务字段独占一行')
+        .option('--no-generate-collapse', '不生成折叠分组')
+        .option('--preview-only', '只生成预览，不保存')
+        .option('--preview <file>', '应用已保存的预览，可用 @file')
+        .option('--out <file>', '保存预览或执行报告')
+        .action(async (formId, o) => {
+        try {
+            if (o.previewOnly && o.preview)
+                throw new Error('--preview-only 与 --preview 不能同时使用');
+            if (o.previewOnly && !o.out)
+                throw new Error('--preview-only 需要 --out 保存计划');
+            if (!o.previewOnly && !o.preview)
+                throw new Error('请先运行 --preview-only --out <file>，执行时传 --preview @<file>');
+            if (o.out)
+                distinctOutput(o.out, [o.preview]);
+            const auth = await AuthSession.fromOptions(program.opts());
+            if (!auth)
+                throw new Error('无法加载认证信息');
+            const client = new ApiClient(auth, 1, parseLayoutJson);
+            const baseUrl = auth.getBaseUrl();
+            const target = await resolveLayoutTarget(client, baseUrl, formId, { module: 'workflow', idType: 'form', viewId: o.layoutId });
+            const options = {};
+            if (o.styleTemplate !== undefined)
+                options.styleTemplate = o.styleTemplate;
+            if (o.easyTemplate !== undefined)
+                options.easyTemplate = o.easyTemplate;
+            for (const key of ['readOnly', 'required', 'singleRow'])
+                if (o[key] !== undefined)
+                    options[key] = o[key];
+            if (o.generateCollapse === false)
+                options.generateCollapse = false;
+            if (o.previewOnly) {
+                const plan = await prepareWorkflowLayoutInit(client, baseUrl, target, options);
+                writeJson(o.out, plan);
+                console.log(JSON.stringify({ ...plan, out: o.out }, null, 2));
+            }
+            else {
+                const reviewed = readJson(o.preview);
+                const result = await applyWorkflowLayoutInit(client, baseUrl, target, options, reviewed);
+                if (o.out)
+                    writeJson(o.out, result);
+                console.log(JSON.stringify({ ...result, ...(o.out ? { out: o.out } : {}) }, null, 2));
+                if (!result.saved)
+                    process.exitCode = 1;
+            }
+        }
+        catch (error) {
+            console.error(`流程布局初始化失败: ${error.message}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=wf-form-layout-init-reviewed.js.map

package/dist/commands/wf-form-layout-init-reviewed.js.map

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

package/dist/commands/wf-form.d.ts

@@ -7,6 +7,7 @@ import { ApiClient } from '../core/client.js';
 export declare function initWorkflowFormLayout(client: ApiClient, baseUrl: string, formId: string, o?: {
     layoutId?: string;
     styleTemplate?: string;
+    styleTemplateType?: 0 | 1;
     readOnly?: boolean;
     required?: boolean;
     singleRow?: boolean;

package/dist/commands/wf-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wf-form.d.ts","sourceRoot":"","sources":["../../src/commands/wf-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAyP9C;;;gHAGgH;AAChH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAClD,CAAC,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,EAC9I,KAAK,GAAE;IAAE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAAO,GACnD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiEzE;AAWD,yCAAyC;AACzC,UAAU,SAAS;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxE,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,aAG1B,CAAC;AAEH;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EACtF,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GACvE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiIlC;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAg/DtE"}
+{"version":3,"file":"wf-form.d.ts","sourceRoot":"","sources":["../../src/commands/wf-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAyP9C;;;gHAGgH;AAChH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAClD,CAAC,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,EACzK,KAAK,GAAE;IAAE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAAO,GACnD,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiEzE;AAWD,yCAAyC;AACzC,UAAU,SAAS;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxE,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,aAG1B,CAAC;AAEH;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EACtF,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GACvE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiIlC;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAg/DtE"}

package/dist/commands/wf-form.js

@@ -275,7 +275,7 @@ export async function initWorkflowFormLayout(client, baseUrl, formId, o = {}, ho
     const initRes = await client.post(`${baseUrl}${ROUTE}/view/relate/initLayout`, {
         formId, module: MODULE, apiModule: 'workflow/form', layoutId: meta.layoutId,
         generateCollapse: o.generateCollapse !== false,
-        styleTemplateId, styleTemplateType: 1,
+        styleTemplateId, styleTemplateType: o.styleTemplateType ?? 1,
         configs: finalConfigs, addLayout: false, ecodeType: ['js', 'css'], initMode: '1',
         groupFieldIds: groupIds,
         customParam: { terminal: '', objId: formId },
@@ -452,10 +452,10 @@ export async function buildFieldJsonObj(client, baseUrl, fieldName, fieldType, t
     return jsonObj;
 }
 export function registerWorkflowFormCommands(program) {
-    const wfForm = program.command('wf-form').description('流程表单（工作流程表单）管理：read / add-field / edit-field / delete-field / add-detail-table / layout init');
+    const wfForm = program.command('wf-form').description('流程表单：字段、明细表、分组、权限、联动、公式、数据范围及布局管理');
     // ---------- wf-form read ----------
     wfForm.command('read')
-        .description('读取流程表单字段（getConfig）')
+        .description('读取流程表单字段与结构')
         .argument('<formId>', '流程表单 formId（workflow create-workflow 回吐）')
         .action(async (formId) => {
         try {
@@ -1034,7 +1034,7 @@ export function registerWorkflowFormCommands(program) {
     });
     // ---------- wf-form linkage ----------
     wfForm.command('linkage')
-        .description('显隐联动管理（/api/workflow/core/form/setting/viewlinkage）')
+        .description('字段和布局组件的显示属性联动')
         .argument('<formId>', '流程表单 formId')
         .argument('<name>', '联动名称')
         .requiredOption('--config <json>', '联动配置 JSON：{"conditions":[{"field":"请假天数","operator":"EQUAL","value":"3"}],"actions":[{"prop":"hide","fields":["请假事由"]}]}。prop: hide/show/edit/readonly/required/hideLine；'
@@ -1139,7 +1139,7 @@ export function registerWorkflowFormCommands(program) {
         }
     });
     // ---------- wf-form formula ----------
-    const formulaCmd = wfForm.command('formula').description('字段函数公式（/api/excel/formula/*，module=workflow）');
+    const formulaCmd = wfForm.command('formula').description('流程表单字段的函数公式');
     /** 解析 {主表.字段} / {明细表名.字段} 引用 → FormulaParam（用 getConfig 解析字段）。 */
     async function buildWfFormulaParams(client, baseUrl, formId, expression) {
         const errors = [];
@@ -1499,7 +1499,7 @@ export function registerWorkflowFormCommands(program) {
         }
     });
     wfForm.command('edit-field')
-        .description('编辑流程表单已有字段（read-modify-write：getFormField 读全字段 → 改 → saveFormFieldNew 重存）')
+        .description('编辑流程表单已有字段，保留未指定的属性')
         .argument('<formId>', '流程表单 formId')
         .argument('<fieldId>', '字段 fieldId（被带出的目标字段，如 联系方式）')
         .option('--title <title>', '修改字段标题')
@@ -1612,7 +1612,7 @@ export function registerWorkflowFormCommands(program) {
     });
     // ---------- wf-form field-options ----------
     wfForm.command('field-options')
-        .description('给流程表单 Select/SelectMultiple 字段配选项（read-modify-write：getFormField 读全字段 → 改 options → saveFormFieldNew 重存）')
+        .description('设置流程表单单选或多选字段的选项')
         .argument('<formId>', '流程表单 formId')
         .argument('<fieldId>', 'Select/SelectMultiple 字段 fieldId')
         .requiredOption('--options <json>', '选项列表 [{"name":"事假"},...] 或 @文件路径')
@@ -1686,7 +1686,7 @@ export function registerWorkflowFormCommands(program) {
     // businessId=workflowId（非 formId），formId=流程表单 formId，controlId=EBuilder 字段 fieldId，
     // browserType="ebuilder/form_ebuilder"，scopeType="scopeSql"，scopeInfoRender=条件树 JSON 字符串。
     wfForm.command('ebuilder-scope')
-        .description('关联浏览数据范围（如关联客户只选客户状态=启用）。--rule "目标表字段:操作:值"')
+        .description('设置关联 EBuilder 字段的可选数据范围；用 --rule 指定目标表字段条件')
         .argument('<formId>', '流程表单 formId')
         .argument('<ebuilderFieldId>', 'EBuilder 关联字段 fieldId（controlId）')
         .requiredOption('--workflow-id <wfId>', '工作流程 ID（businessId）')
@@ -1802,7 +1802,7 @@ export function registerWorkflowFormCommands(program) {
     });
     // ---------- wf-form add-detail-table ----------
     wfForm.command('add-detail-table')
-        .description('给流程表单加明细子表（saveSubForm 建子表 + 加首字段使其可见；--init 放入布局）')
+        .description('新增流程表单明细表；可添加首字段并放入布局')
         .argument('<formId>', '流程表单 formId')
         .argument('<name>', '明细表名')
         .argument('[firstFieldName]', '首字段名（强烈建议传；空子表 getConfig 读不到）')
@@ -1886,7 +1886,7 @@ export function registerWorkflowFormCommands(program) {
     //                             dataKey:"f_"+refFieldId, children:[分组字段]} + 顶层 groupFieldIds:[refFieldId]
     //   （对齐 eb 表 form-create.ts FLOW 分组结构 / 记忆 field-group-saveFieldGroup-api）
     wfForm.command('group')
-        .description('字段分组（建分组/分配字段/布局 Collapse 折叠，对齐 eb 表）。一次建全部分组')
+        .description('创建字段分组、分配字段并设置布局折叠')
         .argument('<formId>', '流程表单 formId')
         .requiredOption('--groups <json>', '分组定义 JSON：{"分组名":["字段名或ID",...]}，可 @文件路径')
         .action(async (formId, o) => {
@@ -2035,7 +2035,7 @@ export function registerWorkflowFormCommands(program) {
         }
     });
     // ---------- wf-form layout init ----------
-    const layoutCmd = wfForm.command('layout').description('布局管理');
+    const layoutCmd = wfForm.command('layout').description('流程表单布局：新建、删除、初始化及样式模板预览应用');
     // ---------- wf-form layout add（添加布局）----------
     // 给流程表单新增一套布局（formLayoutMultiple 多布局，PC/移动端多套并存不覆盖）。
     // 抓包（mulinquan 2026-08-25）：POST /api/workflow/core/form/layout/save
@@ -2044,7 +2044,7 @@ export function registerWorkflowFormCommands(program) {
     //           local:true, copyConfig:{formDataLinkage:true, excelLinkage:true}, formId }
     //   → data.formLayoutMultiple.id = 新布局 layoutId。FLOW=流式 EXCEL=表格式（实测两种都成功）。
     layoutCmd.command('add')
-        .description('添加一套新布局（layout/save）：FLOW 流式 / EXCEL 表格式，PC/移动端多套并存不覆盖。返回新布局 ID')
+        .description('添加一套新布局；支持流式或表格式、PC 或移动端，并返回布局 ID')
         .argument('<formId>', '流程表单 formId')
         .requiredOption('--name <name>', '布局名称（如 "项目立项流程PC1"）')
         .option('--layout-type <type>', '布局类型：FLOW 流式(默认) / EXCEL 表格式', 'FLOW')
@@ -2089,7 +2089,7 @@ export function registerWorkflowFormCommands(program) {
     //   body: { layoutId, workflowId, terminal:'PC' } → data=true，**效果=从布局列表删除该布局**
     //   （用户确认：emptyNodeLayout 实际就是把布局删掉，不是"保留布局清空节点"）。
     layoutCmd.command('delete')
-        .description('删除一套布局（emptyNodeLayout：从布局列表移除）。传 layoutId（layout add 返回的 formLayoutMultiple.id）')
+        .description('删除指定布局；layoutId 可从 layout add 的结果取得')
         .argument('<formId>', '流程表单 formId')
         .argument('<layoutId>', '要删除的布局 ID（wf-form layout add 返回的 layoutId）')
         .option('--workflow-id <id>', '工作流 ID（不传用 formId 兜底）')
@@ -2117,10 +2117,10 @@ export function registerWorkflowFormCommands(program) {
         }
     });
     layoutCmd.command('init')
-        .description('初始化/重建流程表单布局（initLayout）：按 layoutType 选模板（FLOW 默认）+ 设字段 readOnly/required/singleRow')
+        .description('初始化或重建流程表单布局，应用模板并设置字段只读、必填等属性')
         .argument('<formId>', '流程表单 formId')
         .option('--layout-id <id>', '要重建哪一套布局（formLayoutMultiple.id，即节点独立布局的 layoutId）；不传 = 默认布局')
-        .option('--style-template <name|id>', '样式模板 id（默认按 layoutType：FLOW=820...01 / EXCEL=700...08）')
+        .option('--style-template <id>', '样式模板 ID；按名称选择及应用前预览请用 layout init-reviewed')
         .option('--read-only', '字段只读')
         .option('--required', '字段必填')
         .option('--single-row', '独占一行')
@@ -2149,7 +2149,7 @@ export function registerWorkflowFormCommands(program) {
     // 运行时布局看 initLayout 保存的 comps.config。initLayout 是唯一保存路径（saveConfig 实测 404）。
     // 因此：getConfig 读 configs → 未指定业务字段强制可编辑（防 FLOW 锁死）→ 按名/ID 改指定字段 → initLayout 重存。
     wfForm.command('field-prop')
-        .description('设置流程表单字段属性：必填/只读/可编辑/独占一行（getConfig 读 → 改 → initLayout 保存到运行时布局）')
+        .description('设置流程表单字段的必填、只读、可编辑及独占一行属性')
         .argument('<formId>', '流程表单 formId')
         .option('--required <fields...>', '设为必填（required=true）')
         .option('--no-required <fields...>', '取消必填（required=false）')