@4399ywkf/design 2.1.0 → 2.1.1

package/dist/FormDesigner/card/templates/feishuOrderConfirm.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ════════ 订单待确认 —— 卡片「数据回填 + 确认提交」范式实例 ════════
+ *
+ * 翻译自飞书 CardKit 案例「您有订单待确认」，但不停在外观复刻：按
+ * feishuLeaveApproval 的范式重新接通了挂载回填 + 一键确认的真链路，
+ * 给「待确认 / 待支付 / 待签收」一类只需一个动作的卡片做样板。
+ *
+ * 与 feishuLeaveApproval 共享同一套三件套：
+ *  ① 布局        全部展示字段 (markdown) 排在 formContainer 内，右下角放唯一动作按钮
+ *  ② 数据结构    回填字段叶子名扁平：OrderHeader / OrderItem1..3 /
+ *                OrderAmount / InvoiceSequence / PaymentTerm /
+ *                PaymentFrequency / TenantName
+ *  ③ 事件↔后端   onMount api_request → set_values 整批回填；按钮
+ *                form_submit + api_request(mode='form') 提交确认；
+ *                后端按业务推下一张卡（已确认 / 已超期…），前端不切态
+ *
+ * ──── 参考接口契约（mock 见 test/mock-server.mjs）────
+ *  GET  /api/order/detail
+ *    · 订单 id 由后端按卡片烘焙进 url，前端不传（card-state-switching 决策）
+ *    · resp: { code:0, data: { OrderHeader, OrderItem1..3, OrderAmount,
+ *      InvoiceSequence, PaymentTerm, PaymentFrequency, TenantName } }
+ *      —— 展示字段是 markdown，值是「直接展示串」（含 markdown 语法），
+ *         回填后整串覆盖占位 props.content
+ *  POST /api/order/confirm
+ *    · body: { json:<卡片 schema>, value:<全表值> }（mode='form' 自动打包）
+ *    · resp: { code:0, data:{} }；成功后后端重推「已确认」卡
+ *
+ * ──── 关键实现点（与 feishuLeaveApproval 完全一致，照抄即可）────
+ *  · markdown 字段的占位整串放 `props.content`，**不要放 `default`**：
+ *    markdown 渲染取 value||props.content，根本不读 default；放 default 会让
+ *    占位变成"字段值"，预览态 PreviewFR 的 watch 链每次重渲染会把 default 再
+ *    灌回去，盖掉 onMount 刚回填的值（表现：日志显示已赋值，UI 仍是占位）。
+ *  · 行内「label : value」用左右两列。label 是固定文案，仍用 markdown 写死；
+ *    value 才是要回填的字段。所以左 label 不需要 name，也不进 set_values 列表。
+ *  · 回填字段统一配 `title:`（与左列文案一致）+ `props.showTitle: false`：
+ *    title 给 schema 层留下「这字段的标签是什么」的元信息，showTitle:false 抑制
+ *    frCardFieldLabel 的纵向渲染，保留原版「左 label / 右 value」横向视觉。
+ *  · 提交统一用 body.mode='form'：整包送 { json:schema, value:全表值 }，避免
+ *    {{字段}} 在卡片模式下需要点号全路径的坑（见 card-submit-paradigm 备忘）。
+ *  · lockForm:true —— 提交在途锁整卡，防止用户连点。
+ *  · 原版的「先票后款 / 14 天 / 按年支付」从纯 `div` 改成 `markdown`：div 不是
+ *    表单组件，set_values 改不到它的 text；改 markdown 才能进 form state、被回填。
+ */
+export declare const feishuOrderConfirm: any;