openxiangda 1.0.26 → 1.0.28

package/openxiangda-skills/references/style-system.md

@@ -1,6 +1,6 @@
-# OpenXiangda 样式体系参考
-
-> 本文档面向 AI Agent，约束代码页面/表单/工作流自定义节点的样式编写规范。**严禁硬编码颜色、间距、圆角、字号、阴影**，统一通过三层变量体系消费设计 Token。
+# OpenXiangda 样式体系参考
+
+> 本文档面向 AI Agent，提供代码页面/表单/工作流自定义节点的推荐样式基线。平台 CSS 变量与语义类是优先选择，不是唯一选择；当业务视觉、品牌表达、图表、看板、动效或复杂布局需要更精确控制时，可以使用 Tailwind 普通工具类、Tailwind 任意值、局部 CSS、页面级 CSS 变量或必要的 inline style。
 
 ---
 
@@ -32,7 +32,7 @@
 └──────────────────────────────────────────────────────────────┘
 ```
 
-**核心原则**：所有视觉 Token 来源于 Layer 1 的 CSS Variables；AntD 与 Tailwind 都只是 Layer 1 的消费者。
+**核心原则**：平台视觉基线优先来源于 Layer 1 的 CSS Variables；AntD 与 Tailwind 默认消费这套变量。业务页面可以在 `.sy-app-workspace` 命名空间内扩展页面级样式，不要求所有视觉值都必须来自内置 Token。
 
 ### 1.2 为什么不使用 Shadow DOM
 
@@ -54,9 +54,9 @@
 
 ---
 
-## 2. Layer 1：CSS Variables 设计 Token
-
-> 唯一真源（Single Source of Truth）。**所有变量同时挂载在 `:root` 与 `.sy-app-workspace`**，前者用于全局可用，后者保证命名空间生效时不依赖根选择器。
+## 2. Layer 1：CSS Variables 设计 Token
+
+> 推荐基线。**所有平台变量同时挂载在 `:root` 与 `.sy-app-workspace`**，前者用于全局可用，后者保证命名空间生效时不依赖根选择器。页面可以继续定义自己的局部变量，例如 `--sales-dashboard-accent`、`--kanban-column-width`。
 
 ```css
 :root, .sy-app-workspace {
@@ -199,9 +199,9 @@ export function AppThemeProvider({ children }: { children: React.ReactNode }) {
 
 ---
 
-## 4. Layer 3：Tailwind 语义化工具类
-
-`tailwind-preset.ts` 基于 CSS Variables 扩展语义化类，**优先使用语义类**而非数值类。
+## 4. Layer 3：Tailwind 语义化工具类
+
+`tailwind-preset.ts` 基于 CSS Variables 扩展语义化类。语义类适合常规后台页面、表单、列表和状态展示；普通 Tailwind 工具类与任意值适合特殊布局、品牌视觉、图表容器、复杂动效和一次性精调。
 
 ### 4.1 颜色类
 
@@ -247,110 +247,117 @@ export function AppThemeProvider({ children }: { children: React.ReactNode }) {
 | `text-xl-sy` | `font-size: var(--sy-font-size-xl)` |
 | `text-2xl-sy` | `font-size: var(--sy-font-size-2xl)` |
 
-> 通用 Tailwind 数值类（如 `p-4`、`text-sm`）仍可使用，但**当存在语义类时优先用语义类**。
-
----
-
-## 5. 禁止规则（AI Agent 必须遵守）
-
-| # | 规则 | 反例 | 正例 |
-|---|---|---|---|
-| 1 | **禁止硬编码颜色** | `color: #333`、`className="bg-[#1677ff]"` | `text-default`、`bg-container` 或 `var(--sy-color-primary)` |
-| 2 | **禁止硬编码间距** | `padding: 16px`、`className="p-[24px]"` | `p-form`、`var(--sy-spacing-md)` |
-| 3 | **禁止用数值类替代语义类** | `className="rounded-md gap-4"`（用于表单时）| `className="rounded-form gap-form"` |
-| 4 | **禁止内联颜色/间距** | `<div style={{ color: '#1677ff', padding: 16 }}>` | `<div className="text-primary p-form">` |
-| 5 | **禁止绕过 ConfigProvider 直接覆盖 antd 类名** | `.ant-btn { background: red }` | 通过 `theme.token.colorPrimary` 或自定义类组合 |
-| 6 | **禁止 antd 弹层挂到 body** | 默认行为 | 通过 `getPopupContainer` 锚定到 `.sy-app-workspace` |
-| 7 | **禁止在样式中假设白色/黑色背景** | `color: #fff`（在深色主题失效）| `text-default`，让 Token 决定 |
-
----
-
-## 6. 正确示例 vs 错误示例
-
-### 示例 1：主操作按钮的容器
-
-```tsx
-// ❌ 错误：硬编码颜色 + 硬编码间距
-<div style={{ background: '#fff', padding: 24, borderRadius: 6 }}>
-  <button style={{ background: '#1677ff', color: '#fff' }}>提交</button>
-</div>
-
-// ✅ 正确：语义类 + antd 组件
-<div className="bg-container p-form rounded-form">
-  <Button type="primary">提交</Button>
-</div>
-```
-
-### 示例 2：表单字段布局
-
-```tsx
-// ❌ 错误：随意数值类
-<div className="flex flex-col gap-[16px] p-[24px]">
-  <Input className="h-[32px]" />
-  <Input className="h-[32px]" />
-</div>
-
-// ✅ 正确：表单语义类
-<div className="flex flex-col gap-form p-form">
-  <Input />
-  <Input />
-</div>
-```
-
-### 示例 3：状态文案
-
-```tsx
-// ❌ 错误：直接写颜色值
-<span style={{ color: '#52c41a' }}>已通过</span>
-<span style={{ color: '#ff4d4f' }}>已驳回</span>
-
-// ✅ 正确：状态语义类
-<span className="text-success">已通过</span>
-<span className="text-error">已驳回</span>
-```
-
-### 示例 4：卡片容器
-
-```tsx
-// ❌ 错误：阴影硬编码
-<div style={{
-  background: '#fff',
-  boxShadow: '0 6px 16px rgba(0,0,0,0.08)',
-  borderRadius: 8
-}}>...</div>
-
-// ✅ 正确：语义类
-<div className="bg-container shadow-card rounded-card">...</div>
-```
-
-### 示例 5：次要文本 + 提示
-
-```tsx
-// ❌ 错误：rgba 硬编码
-<p style={{ color: 'rgba(0,0,0,0.65)', fontSize: 12 }}>提示信息</p>
-
-// ✅ 正确：层级语义
-<p className="text-secondary text-sm-sy">提示信息</p>
-```
-
-### 示例 6：自定义代码节点的 CSS（局部样式表）
-
-```css
-/* ❌ 错误 */
-.my-node-card {
-  background: #ffffff;
-  border: 1px solid #d9d9d9;
-  padding: 16px;
-}
-
-/* ✅ 正确 */
-.sy-app-workspace .my-node-card {
-  background: var(--sy-color-bg-container);
-  border: 1px solid var(--sy-color-border);
-  padding: var(--sy-spacing-md);
-  border-radius: var(--sy-radius-md);
-}
-```
+> 通用 Tailwind 数值类（如 `p-4`、`text-sm`）和任意值（如 `grid-cols-[240px_1fr]`、`bg-[#0f766e]`）都可以使用。常规业务组件优先使用语义类，特殊页面按实际视觉需求选择更合适的 Tailwind/CSS 写法。
+
+---
+
+## 5. 推荐顺序与硬边界
+
+| # | 场景 | 推荐做法 | 允许的扩展 |
+|---|---|---|---|
+| 1 | 常规后台、列表、表单、详情页 | 优先用语义类、平台 CSS 变量和 antd token，保证与平台一致 | 可用 `p-4`、`gap-6`、`text-sm` 等 Tailwind 普通类做快速布局 |
+| 2 | 品牌化首页、门户、看板、数据大屏、营销视觉 | 按视觉目标设计，不要为了套 Token 牺牲效果 | 可用 Tailwind 任意值、CSS 渐变、图片背景、页面级变量、局部 CSS |
+| 3 | 精确布局、复杂 Grid、图表容器、动效 | Tailwind 普通类/任意值和 `styles.css` 都可以直接使用 | 例如 `grid-cols-[280px_1fr]`、`h-[calc(100vh-64px)]`、`transition-[height]` |
+| 4 | 需要运行时动态值 | 少量 inline style 可以使用，尤其是动态尺寸、颜色、坐标、图表变量 | 避免把大段静态样式写进 inline style，静态样式优先放到 class/CSS |
+| 5 | antd 主题 | 优先通过 `ConfigProvider.theme`、CSS 变量和 `className` 控制 | 如确实要覆盖内部 class，必须限定在页面命名空间内，并接受升级风险 |
+| 6 | antd 弹层、Drawer、Modal、DatePicker、Select | 这是硬要求：通过 `getPopupContainer` 锚定到 `.sy-app-workspace` 或就近容器 | 否则弹层可能丢样式或被宿主页面污染 |
+| 7 | CSS 作用域 | 这是硬要求：业务 CSS 必须在 `.sy-app-workspace` 或页面根类下收敛作用域 | 避免写全局裸选择器污染宿主平台 |
+
+---
+
+## 6. 推荐示例与可接受变体
+
+### 示例 1：主操作按钮的容器
+
+```tsx
+// 常规后台表单：推荐用语义类 + antd 组件
+<div className="bg-container p-form rounded-form">
+  <Button type="primary">提交</Button>
+</div>
+
+// 品牌化或特殊视觉：可以使用 Tailwind 任意值 / 自定义 CSS
+<div style={{ background: '#fff', padding: 24, borderRadius: 6 }}>
+  <button style={{ background: '#1677ff', color: '#fff' }}>提交</button>
+</div>
+```
+
+### 示例 2：表单字段布局
+
+```tsx
+// 推荐：表单语义类
+<div className="flex flex-col gap-form p-form">
+  <Input />
+  <Input />
+</div>
+
+// 可接受：特殊布局精调用 Tailwind 普通类 / 任意值
+<div className="flex flex-col gap-[18px] p-6">
+  <Input className="h-[32px]" />
+  <Input className="h-[32px]" />
+</div>
+```
+
+### 示例 3：状态文案
+
+```tsx
+// 推荐：平台状态语义
+<span className="text-success">已通过</span>
+<span className="text-error">已驳回</span>
+
+// 可接受：页面专属状态色
+<span className="text-[#16a34a]">已通过</span>
+<span style={{ color: riskLevelColor }}>风险等级</span>
+```
+
+### 示例 4：卡片容器
+
+```tsx
+// 推荐：语义类
+<div className="bg-container shadow-card rounded-card">...</div>
+
+// 可接受：特殊卡片视觉
+<div style={{
+  background: '#fff',
+  boxShadow: '0 6px 16px rgba(0,0,0,0.08)',
+  borderRadius: 8
+}}>...</div>
+```
+
+### 示例 5：次要文本 + 提示
+
+```tsx
+// 推荐：层级语义
+<p className="text-secondary text-sm-sy">提示信息</p>
+
+// 可接受：需要匹配图表或品牌视觉时直接设定
+<p className="text-[13px] text-slate-500">提示信息</p>
+```
+
+### 示例 6：自定义代码节点的 CSS（局部样式表）
+
+```css
+/* 避免：全局裸选择器，容易污染宿主页面 */
+.my-node-card {
+  background: #ffffff;
+  border: 1px solid #d9d9d9;
+  padding: 16px;
+}
+
+/* 推荐：限定在平台命名空间或页面根类下 */
+.sy-app-workspace .my-node-card {
+  background: var(--sy-color-bg-container);
+  border: 1px solid var(--sy-color-border);
+  padding: var(--sy-spacing-md);
+  border-radius: var(--sy-radius-md);
+}
+
+/* 可接受：页面专属视觉值，只要作用域收敛 */
+.sy-app-workspace .sales-dashboard .my-node-card {
+  background: linear-gradient(135deg, #0f766e, #0ea5e9);
+  border-radius: 14px;
+  padding: 20px;
+}
+```
 
 ---
 

package/openxiangda-skills/references/workflow-v3.md

@@ -2,6 +2,50 @@
 
 Workflow definitions are JSON objects saved by `openxiangda workflow create`.
 
+AI-authored workflows should prefer compile-time TypeScript SDK when the user does not need canvas editing. The SDK compiles local `workflow.ts` into the current v3 graph JSON, so the backend still uses the existing workflow engine for approval tasks, copy tasks, callback waits, branch advancement, operation logs, and process completion events.
+
+Example `src/workflows/expense_approval/workflow.ts`:
+
+```ts
+import { defineWorkflow } from "openxiangda/workflow";
+
+export default defineWorkflow({
+  build(flow) {
+    const start = flow.start();
+    const approve = flow.approval("manager_approval", {
+      label: "主管审批",
+      approverType: "ext_target_approval",
+      approvals: ["USER_MANAGER"],
+      approvalNames: ["主管"],
+      multiApprove: "or",
+    });
+    const copy = flow.copy("copy_finance", {
+      label: "抄送财务",
+      approverType: "ext_target_approval",
+      approvals: ["USER_FINANCE"],
+      approvalNames: ["财务"],
+    });
+    const end = flow.end();
+    flow.sequence(start, approve, copy, end);
+  },
+});
+```
+
+Resource manifest:
+
+```json
+{
+  "code": "expense_approval",
+  "formCode": "expense",
+  "workflowFile": "../../../workflows/expense_approval/workflow.ts",
+  "definitionFile": "definition.v3.json",
+  "previewFile": "preview.json",
+  "publish": true
+}
+```
+
+During `openxiangda resource publish`, the CLI compiles `workflowFile`, writes `definitionFile` and `previewFile` when configured, sends v3 `definitionJson` to the backend, and stores the preview in `viewJson` for read-only frontend display.
+
 Minimum shape:
 
 ```json

package/openxiangda-skills/skills/openxiangda-page/SKILL.md

@@ -60,7 +60,7 @@ Read these references only when editing page code:
 - `../../references/pages/page-sdk.md`
 - `../../references/notifications.md` — notification resources and `sdk.notification` usage. Read before adding reminders, alerts, or message templates to a page.
 - `../../references/pages/publish-flow.md`
-- `../../references/style-system.md` — three-layer style architecture, CSS namespace, and the no-hardcoded-color rule. Read before writing any page CSS or Tailwind class.
+- `../../references/style-system.md` — three-layer style architecture, CSS namespace, and flexible Tailwind/CSS guidance. Read before writing substantial page CSS or Tailwind classes.
 - `../../references/architecture-patterns.md` — CRUD data flow, `DataManagementList` pattern, and recommended `src/pages/<pageCode>/` layout. Read before scaffolding a new page or list view.
 - `../../references/component-guide.md` — when to pick platform components, raw Ant Design, or custom components. Read before introducing a new component.
 - `../../references/troubleshooting.md` — known failure modes (missing styles, `options` runtime errors, broken option rendering, etc.) and their fixes. Read when something does not behave as expected.
@@ -82,7 +82,7 @@ Read these references only when editing page code:
 - Do not scatter hardcoded `/view/...&isRenderNav=false` URLs through page code. Use the runtime navigation API or the local route helper generated for the app shell.
 - Platform menus should bind only the formal app-shell code page for user-facing entry points. Original forms, workflows, and native view pages may remain as development / maintenance resources or permission targets, but should not become the product navigation shell.
 - For prod, explicitly run with `--profile prod`; never rely on the current profile for release operations.
-- Follow the style system in `../../references/style-system.md`: never hardcode colors, fonts, spacing, or radii — use the platform CSS variables and the page CSS namespace.
+- Follow the style system in `../../references/style-system.md`: prefer platform CSS variables, semantic Tailwind classes, and the page CSS namespace for consistency, but do not force every visual value through built-in tokens. Tailwind ordinary utilities, Tailwind arbitrary values, local CSS, page-level CSS variables, and small dynamic inline styles are allowed when they better match the product design.
 - For list / detail / CRUD pages, follow `../../references/architecture-patterns.md` (e.g. `DataManagementList`) before writing custom data-fetching loops.
 - Query pages must use pagination with structured conditions. Do not fetch a large `pageSize` and filter in the browser; avoid default `searchKeyWord`, and build multi-field fuzzy search with explicit `filterGroup` + `OR`.
 - Pick components per `../../references/component-guide.md`: prefer the platform component, fall back to Ant Design, and only build a custom component when neither fits.

package/openxiangda-skills/skills/openxiangda-workflow-automation/SKILL.md

@@ -52,6 +52,10 @@ Use `workflow pull` to inspect the live definition. Use logical workflow codes l
 
 JS_CODE is the backend execution escape hatch for workflow and automation. Use it when the logic must run on the server after a backend trigger, such as a fixed cron schedule, a form date-field schedule, a form submit/update/delete/field-change event, or a workflow approval/process event. It is appropriate for cross-form data queries, create/update/batch update operations, process termination, platform API calls, external HTTP calls, and complex orchestration that the frontend cannot handle reliably.
 
+For new AI-authored automations, prefer code-first `automation_code_ts` resources instead of visual v3 graph definitions. Put the source in `src/automations/<resourceCode>/index.ts`, define `definition.code.json` with `kind: "automation_code_ts"`, and provide `preview.json` for read-only frontend display. Use `ctx.logger.debug/info/warn/error(message, data?)` at every important step; OpenXiangda can inspect logs with `automation executions`, `automation logs`, and `automation diagnose`.
+
+For new AI-authored workflows where users do not need canvas editing, prefer compile-time `workflow.ts` using `openxiangda/workflow`. The CLI compiles it to v3 `definitionJson` and `preview.json`; the backend still runs the normal workflow engine for approval tasks, copy tasks, callback waits, branch advancement, and process records.
+
 Do not use JS_CODE for simple UI interactions, ordinary form validation, display-only page behavior, or logic that belongs in a normal React code page. For non-trivial backend logic, prefer JS_CODE V2 trusted Node scripts over large inline snippets. AI-authored JS_CODE source must be TypeScript:
 
 1. Put source in `sy-lowcode-app-workspace/src/js-code-nodes/<scriptCode>/index.ts`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "OpenXiangda CLI, workspace build tools, runtime SDK, and form components.",
   "private": false,
   "bin": {
@@ -26,6 +26,11 @@
       "import": "./packages/sdk/dist/build/index.mjs",
       "require": "./packages/sdk/dist/build/index.cjs"
     },
+    "./workflow": {
+      "types": "./packages/sdk/dist/workflow/index.d.ts",
+      "import": "./packages/sdk/dist/workflow/index.mjs",
+      "require": "./packages/sdk/dist/workflow/index.cjs"
+    },
     "./tailwind-preset": {
       "types": "./packages/sdk/dist/styles/tailwind-preset.d.ts",
       "import": "./packages/sdk/dist/styles/tailwind-preset.mjs",

package/packages/sdk/dist/workflow/index.cjs

@@ -0,0 +1,230 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/sdk/src/workflow/index.ts
+var workflow_exports = {};
+__export(workflow_exports, {
+  WorkflowBuilder: () => WorkflowBuilder,
+  defineWorkflow: () => defineWorkflow
+});
+module.exports = __toCommonJS(workflow_exports);
+function sanitizeId(value) {
+  return String(value || "").trim().replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function createPosition(index) {
+  return { x: 400, y: 100 + index * 150 };
+}
+var WorkflowBuilder = class {
+  constructor(meta = {}) {
+    this.meta = meta;
+    this.nodes = [];
+    this.edges = [];
+    this.flowConfig = {};
+    this.globalSettings = {};
+    this.data = {
+      retrieveSingle: (id, data) => this.node("data_retrieve_single", id, {
+        type: "data_retrieve_single",
+        label: data.label || "\u83B7\u53D6\u5355\u6761\u6570\u636E",
+        filterType: data.filterType || "condition",
+        ...data
+      }),
+      retrieveBatch: (id, data) => this.node("data_retrieve_batch", id, {
+        type: "data_retrieve_batch",
+        label: data.label || "\u83B7\u53D6\u591A\u6761\u6570\u636E",
+        filterType: data.filterType || "condition",
+        ...data
+      }),
+      create: (id, data) => this.node("data_create", id, {
+        type: "data_create",
+        label: data.label || "\u65B0\u589E\u6570\u636E",
+        insertType: data.insertType || "form",
+        assignments: data.assignments || [],
+        ...data
+      }),
+      update: (id, data) => this.node("data_update", id, {
+        type: "data_update",
+        label: data.label || "\u66F4\u65B0\u6570\u636E",
+        updateType: data.updateType || "direct_form",
+        assignments: data.assignments || [],
+        noneOperation: data.noneOperation || "ignored",
+        ...data
+      })
+    };
+    this.globalSettings = { ...meta.globalSettings || {} };
+  }
+  start(id = "start", data = {}) {
+    return this.node("start", id, { label: "\u5F00\u59CB\u8282\u70B9", ...data });
+  }
+  end(id = "end", data = {}) {
+    return this.node("end", id, { label: "\u7ED3\u675F\u8282\u70B9", ...data });
+  }
+  approval(id, data) {
+    return this.node("approval", id, {
+      label: data.label || "\u5BA1\u6279",
+      value: data.value || "",
+      approverType: data.approverType || "ext_target_approval",
+      approvals: data.approvals || [],
+      approvalNames: data.approvalNames || [],
+      multiApprove: data.multiApprove || "or",
+      ...data
+    });
+  }
+  copy(id, data) {
+    return this.node("copy", id, {
+      label: data.label || "\u6284\u9001",
+      value: data.value || "",
+      approverType: data.approverType || "ext_target_approval",
+      approvals: data.approvals || [],
+      approvalNames: data.approvalNames || [],
+      ...data
+    });
+  }
+  jsCode(id, data) {
+    return this.node("js_code", id, {
+      label: data.label || "JS\u4EE3\u7801\u8282\u70B9",
+      runtimeMode: "trusted_node",
+      sourceType: data.sourceFile ? "file_snapshot" : data.sourceType || "inline",
+      timeout: data.timeout || data.timeoutMs || 3e4,
+      ...data
+    });
+  }
+  callbackWait(id, data) {
+    return this.node("callback_wait", id, {
+      type: "callback_wait",
+      label: data.label || "\u56DE\u8C03\u7B49\u5F85",
+      timeoutSeconds: data.timeoutSeconds || 86400,
+      timeoutStrategy: data.timeoutStrategy || "FAIL",
+      ...data
+    });
+  }
+  connectorCall(id, data) {
+    return this.node("connector_call", id, {
+      type: "connector_call",
+      label: data.label || "\u8FDE\u63A5\u5668",
+      timeout: data.timeout || 3e4,
+      ...data
+    });
+  }
+  workNotification(id, data) {
+    return this.node("work_notification", id, {
+      label: data.label || "\u5DE5\u4F5C\u901A\u77E5",
+      buttonText: data.buttonText || "\u67E5\u770B\u8BE6\u60C5",
+      linkType: data.linkType || "current_form",
+      ...data
+    });
+  }
+  dingtalkCard(id, data) {
+    return this.node("dingtalk_card", id, {
+      config: {
+        type: "dingtalk_card",
+        label: data.label || "\u9489\u9489\u6D88\u606F\u5361\u7247",
+        sameFieldStrategy: "create",
+        ...data.config || data
+      }
+    });
+  }
+  condition(id, data) {
+    return this.node("condition_branch", id, {
+      type: "condition_branch",
+      label: data.label || "\u6761\u4EF6\u5206\u652F",
+      condition: data.condition || { ruleType: "group", condition: "AND", rules: [] },
+      isElse: data.isElse === true,
+      priority: data.priority || "1",
+      trueNodeId: data.trueNodeId,
+      falseNodeId: data.falseNodeId,
+      ...data
+    });
+  }
+  node(type, id, data) {
+    const nodeId = sanitizeId(id);
+    if (!nodeId) throw new Error("workflow node id is required");
+    if (this.nodes.some((node) => node.id === nodeId)) {
+      throw new Error(`duplicate workflow node id: ${nodeId}`);
+    }
+    this.nodes.push({
+      id: nodeId,
+      type,
+      data,
+      position: createPosition(this.nodes.length)
+    });
+    if (Array.isArray(data.fieldPermissions)) {
+      this.flowConfig[nodeId] = data.fieldPermissions;
+    }
+    return nodeId;
+  }
+  edge(source, target, data = {}) {
+    const id = data.id || `edge_${source}_${target}`;
+    this.edges.push({
+      id,
+      source,
+      target,
+      type: data.type || "custom",
+      ...data.label ? { label: data.label } : {}
+    });
+  }
+  sequence(...refs) {
+    for (let index = 0; index < refs.length - 1; index += 1) {
+      this.edge(refs[index], refs[index + 1]);
+    }
+  }
+  setFieldPermissions(nodeId, permissions) {
+    this.flowConfig[nodeId] = permissions;
+  }
+  setGlobalSettings(settings) {
+    this.globalSettings = { ...this.globalSettings, ...settings };
+  }
+  compile() {
+    return {
+      definitionJson: {
+        version: "v3",
+        nodes: this.nodes,
+        edges: this.edges,
+        flowConfig: this.flowConfig,
+        globalSettings: this.globalSettings
+      },
+      previewJson: {
+        kind: "workflow_code_preview",
+        version: "preview_v1",
+        sourceMode: "workflow_code_ts",
+        steps: this.nodes.map((node) => ({
+          id: node.id,
+          type: node.type,
+          label: node.data?.label || node.id,
+          config: node.data
+        })),
+        edges: this.edges.map((edge) => ({
+          source: edge.source,
+          target: edge.target,
+          label: edge.label
+        }))
+      }
+    };
+  }
+};
+function defineWorkflow(input) {
+  return {
+    __openxiangdaWorkflow: true,
+    compile() {
+      const builder = new WorkflowBuilder(input);
+      input.build(builder);
+      return builder.compile();
+    }
+  };
+}
+//# sourceMappingURL=index.cjs.map

package/packages/sdk/dist/workflow/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/workflow/index.ts"],"sourcesContent":["export type WorkflowNodeRef = string;\n\nexport interface WorkflowCompileResult {\n  definitionJson: {\n    version: \"v3\";\n    nodes: any[];\n    edges: any[];\n    flowConfig: Record<string, any[]>;\n    globalSettings: Record<string, any>;\n  };\n  previewJson: {\n    kind: \"workflow_code_preview\";\n    version: \"preview_v1\";\n    steps: any[];\n    edges: any[];\n    sourceMode: \"workflow_code_ts\";\n  };\n}\n\nexport interface WorkflowDefinitionInput {\n  name?: string;\n  formCode?: string;\n  formUuid?: string;\n  globalSettings?: Record<string, any>;\n  build: (flow: WorkflowBuilder) => void;\n}\n\ntype NodeOptions = Record<string, any>;\n\nfunction sanitizeId(value: string) {\n  return String(value || \"\")\n    .trim()\n    .replace(/[^a-zA-Z0-9_-]/g, \"_\");\n}\n\nfunction createPosition(index: number) {\n  return { x: 400, y: 100 + index * 150 };\n}\n\nexport class WorkflowBuilder {\n  private nodes: any[] = [];\n  private edges: any[] = [];\n  private flowConfig: Record<string, any[]> = {};\n  private globalSettings: Record<string, any> = {};\n\n  constructor(private readonly meta: Omit<WorkflowDefinitionInput, \"build\"> = {}) {\n    this.globalSettings = { ...(meta.globalSettings || {}) };\n  }\n\n  start(id = \"start\", data: NodeOptions = {}): WorkflowNodeRef {\n    return this.node(\"start\", id, { label: \"开始节点\", ...data });\n  }\n\n  end(id = \"end\", data: NodeOptions = {}): WorkflowNodeRef {\n    return this.node(\"end\", id, { label: \"结束节点\", ...data });\n  }\n\n  approval(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"approval\", id, {\n      label: data.label || \"审批\",\n      value: data.value || \"\",\n      approverType: data.approverType || \"ext_target_approval\",\n      approvals: data.approvals || [],\n      approvalNames: data.approvalNames || [],\n      multiApprove: data.multiApprove || \"or\",\n      ...data,\n    });\n  }\n\n  copy(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"copy\", id, {\n      label: data.label || \"抄送\",\n      value: data.value || \"\",\n      approverType: data.approverType || \"ext_target_approval\",\n      approvals: data.approvals || [],\n      approvalNames: data.approvalNames || [],\n      ...data,\n    });\n  }\n\n  jsCode(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"js_code\", id, {\n      label: data.label || \"JS代码节点\",\n      runtimeMode: \"trusted_node\",\n      sourceType: data.sourceFile ? \"file_snapshot\" : data.sourceType || \"inline\",\n      timeout: data.timeout || data.timeoutMs || 30000,\n      ...data,\n    });\n  }\n\n  callbackWait(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"callback_wait\", id, {\n      type: \"callback_wait\",\n      label: data.label || \"回调等待\",\n      timeoutSeconds: data.timeoutSeconds || 86400,\n      timeoutStrategy: data.timeoutStrategy || \"FAIL\",\n      ...data,\n    });\n  }\n\n  connectorCall(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"connector_call\", id, {\n      type: \"connector_call\",\n      label: data.label || \"连接器\",\n      timeout: data.timeout || 30000,\n      ...data,\n    });\n  }\n\n  workNotification(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"work_notification\", id, {\n      label: data.label || \"工作通知\",\n      buttonText: data.buttonText || \"查看详情\",\n      linkType: data.linkType || \"current_form\",\n      ...data,\n    });\n  }\n\n  dingtalkCard(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"dingtalk_card\", id, {\n      config: {\n        type: \"dingtalk_card\",\n        label: data.label || \"钉钉消息卡片\",\n        sameFieldStrategy: \"create\",\n        ...(data.config || data),\n      },\n    });\n  }\n\n  condition(id: string, data: NodeOptions): WorkflowNodeRef {\n    return this.node(\"condition_branch\", id, {\n      type: \"condition_branch\",\n      label: data.label || \"条件分支\",\n      condition: data.condition || { ruleType: \"group\", condition: \"AND\", rules: [] },\n      isElse: data.isElse === true,\n      priority: data.priority || \"1\",\n      trueNodeId: data.trueNodeId,\n      falseNodeId: data.falseNodeId,\n      ...data,\n    });\n  }\n\n  data = {\n    retrieveSingle: (id: string, data: NodeOptions) =>\n      this.node(\"data_retrieve_single\", id, {\n        type: \"data_retrieve_single\",\n        label: data.label || \"获取单条数据\",\n        filterType: data.filterType || \"condition\",\n        ...data,\n      }),\n    retrieveBatch: (id: string, data: NodeOptions) =>\n      this.node(\"data_retrieve_batch\", id, {\n        type: \"data_retrieve_batch\",\n        label: data.label || \"获取多条数据\",\n        filterType: data.filterType || \"condition\",\n        ...data,\n      }),\n    create: (id: string, data: NodeOptions) =>\n      this.node(\"data_create\", id, {\n        type: \"data_create\",\n        label: data.label || \"新增数据\",\n        insertType: data.insertType || \"form\",\n        assignments: data.assignments || [],\n        ...data,\n      }),\n    update: (id: string, data: NodeOptions) =>\n      this.node(\"data_update\", id, {\n        type: \"data_update\",\n        label: data.label || \"更新数据\",\n        updateType: data.updateType || \"direct_form\",\n        assignments: data.assignments || [],\n        noneOperation: data.noneOperation || \"ignored\",\n        ...data,\n      }),\n  };\n\n  node(type: string, id: string, data: NodeOptions): WorkflowNodeRef {\n    const nodeId = sanitizeId(id);\n    if (!nodeId) throw new Error(\"workflow node id is required\");\n    if (this.nodes.some((node) => node.id === nodeId)) {\n      throw new Error(`duplicate workflow node id: ${nodeId}`);\n    }\n    this.nodes.push({\n      id: nodeId,\n      type,\n      data,\n      position: createPosition(this.nodes.length),\n    });\n    if (Array.isArray(data.fieldPermissions)) {\n      this.flowConfig[nodeId] = data.fieldPermissions;\n    }\n    return nodeId;\n  }\n\n  edge(source: WorkflowNodeRef, target: WorkflowNodeRef, data: NodeOptions = {}) {\n    const id = data.id || `edge_${source}_${target}`;\n    this.edges.push({\n      id,\n      source,\n      target,\n      type: data.type || \"custom\",\n      ...(data.label ? { label: data.label } : {}),\n    });\n  }\n\n  sequence(...refs: WorkflowNodeRef[]) {\n    for (let index = 0; index < refs.length - 1; index += 1) {\n      this.edge(refs[index], refs[index + 1]);\n    }\n  }\n\n  setFieldPermissions(nodeId: WorkflowNodeRef, permissions: any[]) {\n    this.flowConfig[nodeId] = permissions;\n  }\n\n  setGlobalSettings(settings: Record<string, any>) {\n    this.globalSettings = { ...this.globalSettings, ...settings };\n  }\n\n  compile(): WorkflowCompileResult {\n    return {\n      definitionJson: {\n        version: \"v3\",\n        nodes: this.nodes,\n        edges: this.edges,\n        flowConfig: this.flowConfig,\n        globalSettings: this.globalSettings,\n      },\n      previewJson: {\n        kind: \"workflow_code_preview\",\n        version: \"preview_v1\",\n        sourceMode: \"workflow_code_ts\",\n        steps: this.nodes.map((node) => ({\n          id: node.id,\n          type: node.type,\n          label: node.data?.label || node.id,\n          config: node.data,\n        })),\n        edges: this.edges.map((edge) => ({\n          source: edge.source,\n          target: edge.target,\n          label: edge.label,\n        })),\n      },\n    };\n  }\n}\n\nexport function defineWorkflow(input: WorkflowDefinitionInput) {\n  return {\n    __openxiangdaWorkflow: true,\n    compile() {\n      const builder = new WorkflowBuilder(input);\n      input.build(builder);\n      return builder.compile();\n    },\n  };\n}\n"],"mappings":"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","names":[]}