wechen-agent-editor-v1 1.1.0 → 1.1.1

package/README.md

@@ -75,6 +75,17 @@ export function AgentPage() {
 
 **有损字段**：导出会去掉 RF 运行期字段与部分边样式；导入会按边 `id` 重新分配 `sourceHandle`/`targetHandle`。详见类型 **`WechenBackendWorkflowJson`** 的 JSDoc。
 
+**节点类型映射**（画布 ↔ DTO）：
+
+| 画布 | DTO `nodes[].type` | 说明 |
+|------|-------------------|------|
+| `pill` | `start` | 入口 |
+| `mainAgent` | `agent` | 主 Agent |
+| `card`（默认） | `task` | 通用任务 |
+| `card` + `data.backendNodeType` | `condition` / `api` / `script` | 扩展类型；导入后写回 `backendNodeType` |
+
+自定义节点若需稳定 DTO 类型，请在 `node.data` 设置 **`backendNodeType`**（取值与 `WechenBackendWorkflowNodeType` 一致）。
+
 ```tsx
 import {
   WechenAgentEditor,
@@ -103,6 +114,33 @@ const flow = importBackendWorkflowToFlow(dtoFromApi);
 
 本仓库 **playground** 提供对照：`npm run dev:minimal` 为最小页；默认 `npm run dev` 为带场景 JSON 与工具栏的完整演示（见 `playground/README.md`）。
 
+### 编辑器与 Agent 运行时
+
+本包是 **编排 UI + 序列化 + ref API**，**不包含** Agent / LLM **执行引擎**。推荐分层：
+
+```
+WechenAgentEditor（编排） → onSave / exportBackendWorkflowJson → 宿主持久化 → 你们的运行时调度
+```
+
+- **`onTestRun` / `ref.testRun()`**：仅触发宿主回调，具体执行由宿主实现。
+- **`validateWechenAgentFlow(flow)`**：纯函数图校验（默认不阻断保存）；可在 `onBeforeSave` 内返回 `false` 拦截。
+- **ref 增删改查**：`getSnapshot` / `patchNodeData` / `removeNode` / `addNode` / `addNodeFromLibrary` / `addEdge` / `connect` / `replaceFlow`（见 `WechenAgentEditorRef`）。
+
+```tsx
+import { validateWechenAgentFlow } from "wechen-agent-editor-v1";
+
+<WechenAgentEditor
+  onBeforeSave={(snap) => {
+    const { valid, issues } = validateWechenAgentFlow(snap.flow);
+    if (!valid) {
+      console.warn(issues);
+      return false;
+    }
+  }}
+  onSave={(s) => { /* POST exportBackendWorkflowJson(s, meta) */ }}
+/>
+```
+
 ---
 
 ## 安装
@@ -154,12 +192,106 @@ import "wechen-agent-editor-v1/style.css";
 
 antd 5 为 CSS-in-JS，请用 **`ConfigProvider`** 包裹应用（与官方用法一致）。
 
+### 嵌入 flex 布局
+
+在 **列方向 flex** 页面中，推荐与 playground 相同的外层结构：父级定高（或 `100vh`），编辑器所在子项使用 **`flex: 1`**、**`minHeight: 0`**，编辑器根节点会 **`flex: 1`** 并 **`height/width: 100%`** 填满该区域。
+
+```tsx
+<div style={{ height: "100vh", display: "flex", flexDirection: "column", minHeight: 0 }}>
+  <YourToolbar />
+  <div style={{ flex: 1, minHeight: 0, display: "flex", flexDirection: "column" }}>
+    <WechenAgentEditor {...props} />
+  </div>
+</div>
+```
+
+**行为说明**：自 **1.1.x** 起，画布区域 **不再** 默认施加 `min-height: 400px`；若需要最小可视高度，请对编辑器传入 **`minHeight`** prop，或在页面级容器设置 `min-height`。
+
+### 骨架 CSS 类名（自定义样式）
+
+加载 **`wechen-agent-editor-v1/style.css`** 后，可用下列稳定类名覆盖布局分区样式（与根 **`className`** 合并，不会替换默认类）：
+
+| 类名 | 区域 |
+| --- | --- |
+| `wechen-agent-editor` | 根布局 |
+| `wechen-agent-editor--reading` | 阅读模式根修饰 |
+| `wechen-agent-editor__workspace` | 工作区（顶栏 + 主体） |
+| `wechen-agent-editor__header` | 顶栏 |
+| `wechen-agent-editor__body` | 主体行（左栏 + 画布 + 右栏） |
+| `wechen-agent-editor__library-sider` | 左侧组件库 Sider |
+| `wechen-agent-editor__library-panel` | 组件库面板内容 |
+| `wechen-agent-editor__main` | 中间主内容 |
+| `wechen-agent-editor__canvas` / `wechen-agent-canvas` | 画布壳（二者同元素，后者为兼容别名） |
+| `wechen-agent-editor__config-sider` | 右侧配置 Sider |
+| `wechen-agent-editor__config-panel` | 配置面板内容 |
+
+```css
+/* 例：自定义顶栏背景 */
+.wechen-agent-editor__header {
+  background: #fafafa !important;
+}
+```
+
+### 国际化（壳层 vs 宿主自定义）
+
+编辑器是 **编排基座**：画布节点由 **`renderFlowNode`**、右侧内容区由 **`renderConfigPanel` / `renderNodeConfig`** 自定义时，**业务文案由宿主自行 i18n**。包内 **`localeMessages`** 仅覆盖 **壳层**（顶栏按钮、左右栏分区标题、组件库搜索/空状态、画布缩放控件等；经 React Flow **`ariaLabelConfig`** 注入）。
+
+#### 语言契约（`localeMessages` 大 JSON）
+
+| 条件 | 编辑器显示语言 |
+| --- | --- |
+| **未传** `localeMessages` | **始终内置中文**（`DEFAULT_ZH_CN`），与 antd `ConfigProvider`、浏览器语言 **无关** |
+| **已传** `localeMessages` | **仅以该 JSON 为准**；缺失 key **不回退中文**，显示 key 字符串 |
+| 存在 `localeTranslate` | **最高优先级**（便于对接 i18next） |
+
+语言包 **key 为默认中文**（与界面中文一致），便于对照扩展，例如 `{ "保存": "Save", "配置": "Settings" }`。代码中可用 **`LOCALE_KEYS`** / **`FALLBACK_LOCALE_KEYS`** 常量（值为中文 key，如 `LOCALE_KEYS.HEADER_SAVE === "保存"`）。
+
+生产推荐：从 **`exportWechenAgentEditorLocaleBundle()`** 复制整表，将 value 译为目标语言后传入；或用 **`mergeWechenAgentEditorLocaleMessages(译文)`** 在宿主侧生成完整大 JSON。
+
+```tsx
+import {
+  WechenAgentEditor,
+  LOCALE_KEYS,
+  mergeWechenAgentEditorLocaleMessages,
+  validateLocaleMessagesCompleteness,
+} from "wechen-agent-editor-v1";
+
+// 中文（默认）：不传 localeMessages
+<WechenAgentEditor renderConfigPanel={(ctx) => <MyPanel {...ctx} />} />;
+
+// 英文：key 为中文，value 为目标语言
+const enPack = mergeWechenAgentEditorLocaleMessages({
+  保存: "Save",
+  配置: "Settings",
+  组件库: "Component library",
+  // 或使用常量： [LOCALE_KEYS.HEADER_SAVE]: "Save",
+});
+validateLocaleMessagesCompleteness(enPack);
+
+<WechenAgentEditor localeMessages={enPack} />;
+```
+
+```tsx
+// antd 与编辑器语言独立配置
+<ConfigProvider locale={antdLocale}>
+  <WechenAgentEditor localeMessages={wechenEditorLocalePack} />
+</ConfigProvider>
+```
+
+- **`exportWechenAgentEditorShellLocaleBundle('zh-CN')`**：仅壳层 key（生产常用子集）。
+- **`exportWechenAgentEditorFallbackLocaleBundle`**：内置回退面板 key（未传 `renderConfigPanel` 时）。
+- **`exportWechenAgentEditorLocaleBundle`**：壳层 + 回退 **完整** key 表（推荐作翻译模板）。
+- **`configSiderTitle`**：可完全覆盖右侧栏外框标题。
+- **`validateLocaleMessagesCompleteness`**：检查大 JSON 是否缺 key（开发期 `console.warn`）。
+
+完整契约演示见 `playground/src/App.tsx`（中文不传包；English 传 `playgroundLocaleEnFull.ts`）。
+
 ### 嵌入尺寸、`readOnly` 与 `readingMode`
 
-根组件默认 **`height` / `width` 为 `100%`**，可通过 **`className` / `style`** 透传；可选 **`minHeight`**。请保证父级链路上有**明确高度**（如 flex 子项 `flex:1` + `minHeight:0`、固定 `height` 等），否则中间画布可能无法撑满。
+根组件默认 **`height` / `width` 为 `100%`**，**`flex: 1`**、**`minHeight: 0`**（便于 flex 父级）；可通过 **`className` / `style`** 透传；可选 **`minHeight`**。请保证父级链路上有**明确高度**（见上文 flex 示例），否则中间画布可能无法撑满。
 
 - **`readOnly`**：禁止对图的增删改（拖入、连线、删除键、拖动节点等），仍可使用平移/缩放查看。**`readOnly`** 与 **`readingMode`** 会出现在 **`renderConfigPanel` / `renderNodeConfig`** 的入参中，便于对表单设 **`disabled`**。
-- **`readingMode`**：**仅展示中间流程画布**（隐藏顶栏与左右栏），并**禁用选中**与一切改图，适合文档内嵌、大屏预览等纯展示场景（隐含只读）。
+- **`readingMode`**：**仅展示中间流程画布**（隐藏顶栏与左右栏），并**禁用选中**与一切改图，适合文档内嵌、大屏预览等纯展示场景（隐含只读）。根节点会附加 **`wechen-agent-editor--reading`**。
 
 ### 删除守卫（`onBeforeRemoveNode` / `onBeforeRemoveEdge`）
 
@@ -187,7 +319,7 @@ L1 工厂同样支持：`buildWechenAgentEditorProps({ onBeforeRemoveNode: ... }
 
 ### 组件库 legacy 接线桩（`flowHandles`，可选）
 
-**已弃用优先**：编排默认以 **四边感应区** 为准。**`libraryGroups`** 中每项仍可设置 **`flowHandles`** 以兼容旧版「声明桩位」：`FlowHandleSpec[]` 或 **`mode: 'even'`** 自动均分。拖入后写入 **`data.flowHandles`**；**`card` / `mainAgent`** 在 **`flowHandles` 展开非空** 时仍走声明桩渲染。**`renderFlowNode`** 自定义整节点时由宿主自行决定接线方式。类型见 **`expandFlowHandlesConfig`**、**`findComponentLibraryItem`** 等导出。
+**已弃用优先**：编排默认以 **四边感应区** 为准。**`libraryGroups`** 中每项仍可设置 **`flowHandles`** 以兼容旧版「声明桩位」：`FlowHandleSpec[]` 或 **`mode: 'even'`** 自动均分。拖入后写入 **`data.flowHandles`**；**`card` / `mainAgent`** 在 **`flowHandles` 展开非空** 时仍走声明桩渲染。**`renderFlowNode`** 仅自定义节点 **内容区**（字段与样式）；内置外壳与接线桩（感应区或 **`flowHandles`**）**始终保留**，**勿** 在 `renderFlowNode` 内放置 `Handle`。类型见 **`expandFlowHandlesConfig`**、**`findComponentLibraryItem`** 等导出。
 
 ### Monaco Worker
 
@@ -202,7 +334,8 @@ L1 工厂同样支持：`buildWechenAgentEditorProps({ onBeforeRemoveNode: ... }
 - **连线**：从节点的 source Handle 拖到 target Handle；选中边可在右侧调整动画与**执行方向**等。**执行方向**与 **`source` → `target`** 一致：箭头在 **目标** 端；选「反向」会 **交换源与目标**（及 handle），不再依赖仅反转 dash 的持久化字段。历史 **`edge.data.wechenFlowDirection: 'reverse'`** 在 **`normalizeWechenAgentFlowJson` / `cloneWechenAgentFlow` / `parseWechenAgentFlowJson`** 中 **幂等归一** 为交换端点并清除该键。宿主也可调用 **`swapWechenFlowEdgeEndpoints(edge)`** 得到与内置面板一致的 **`patchEdge`** 补丁。
 - **数据合并**：节点 `data` 的更新遵循导出的 **`mergeNodeData`**（对象深度合并，数组在补丁中出现时整段替换）。`patchNode` / ref 的 **`patchNodeData`** 将补丁合并进 `node.data`；**`patchEdge`** 为边的顶层浅合并。
 - **自定义右侧面板**：可选 **`renderConfigPanel`**（节点与连线统一入口）或 **`renderNodeConfig`**；同时存在时以 `renderConfigPanel` 为准（返回 `undefined` 时回退内置）。
-- **顶栏按钮**：可选 **`renderHeaderActions`**，入参含与默认行为一致的 **`save`** / **`testRun`** 及 **`editorRef`**。
+- **顶栏左侧**：可选 **`renderHeaderLeading`**，入参含当前解析标题 **`title`**（与 **`ref.getTitle()`** 一致）及 **`editorRef`**；未传时显示默认 `Title`。改标题数据仍用 **`title` prop** 或 **`replaceFlow`**。
+- **顶栏右侧**：可选 **`renderHeaderActions`**，入参含与默认行为一致的 **`save`** / **`testRun`** 及 **`editorRef`**。左右可 **同时** 自定义。Playground：`?tab=header-leading`、`?tab=header-actions`。
 
 完整类型与符号列表以 **`src/index.ts`** 的导出为准。
 
@@ -217,6 +350,9 @@ L1 工厂同样支持：`buildWechenAgentEditorProps({ onBeforeRemoveNode: ... }
 | Monaco | 已在首屏前完成 **worker 引导**（见上文「Monaco Worker」） |
 | 空画布 | **未传 `initialFlow`** 时中间画布无预置节点；业务示例需 **`cloneWechenAgentFlow(defaultInitialFlow)`** 或 `ref.replaceFlow(...)` 显式注入 |
 | 烟测 | 拖入节点、四向连线、`readOnly` / `readingMode`、保存或 `getSnapshot` 取流 |
+| ref 增图 | `ref.addNodeFromLibrary` / `ref.connect` 与拖放、连线行为一致 |
+| DTO 往返 | `exportBackendWorkflowJson` → `importBackendWorkflowToFlow` → `replaceFlow`；`condition`/`api`/`script` 经 `data.backendNodeType` |
+| 图校验 | `validateWechenAgentFlow`；可选 `onBeforeSave` 拦截 |
 
 ---
 
@@ -225,7 +361,7 @@ L1 工厂同样支持：`buildWechenAgentEditorProps({ onBeforeRemoveNode: ... }
 ```bash
 npm install
 npm install --prefix playground
-npm run dev              # 完整 playground（场景 JSON + 工具栏）
+npm run dev              # Playground 文档站（分 Tab 演示；ref 全表见 ?tab=ref-api，见 playground/README.md）
 npm run dev:minimal      # 仅最小宿主集成（对照 README「快速开始」）
 ```
 

package/dist/WechenAgentEditor.d.ts

@@ -1,11 +1,17 @@
 import { CSSProperties, ReactNode } from 'react';
 import { ComponentLibraryGroup, WechenAgentComponentLibraryList } from './config/componentLibraryConfig';
-import { WechenAgentEditorRef, WechenAgentFlowJson, WechenAgentHeaderActionsRenderContext, WechenAgentSnapshot, WechenBeforeRemoveEdgeFn, WechenBeforeRemoveNodeFn } from './flowTypes';
+import { WechenAgentEditorRef, WechenAgentFlowJson, WechenAgentHeaderActionsRenderContext, WechenAgentHeaderLeadingRenderContext, WechenAgentSnapshot, WechenBeforeRemoveEdgeFn, WechenBeforeRemoveNodeFn, WechenBeforeSaveFn } from './flowTypes';
 import { WechenAgentRenderFlowNodeFn } from './WechenAgentEditorContext';
 import { WechenAgentRenderNodeConfigFn } from './panels/NodeConfigPanel';
 import { WechenAgentRenderConfigPanelFn } from './wechenAgentConfigPanel';
+import { WechenAgentEditorLocaleMessages, WechenAgentEditorLocaleTranslateFn } from './i18n/defaultLocaleMessages';
+/** 编排语义：图为可执行 AI 流程结构；节点为功能模块，连线为执行顺序/控制流（持久化 `flow` 供运行时消费）。 */
+export type WechenConfigSiderTitleContext = {
+    kind: "node" | "edge" | null;
+};
+export type WechenConfigSiderTitleFn = (ctx: WechenConfigSiderTitleContext) => string;
 export interface WechenAgentEditorProps {
-    /** 顶栏标题；不传则使用 `initialFlow.title`，再没有则使用内置 `DEFAULT_TITLE` */
+    /** 顶栏标题；不传则使用 `initialFlow.title`，再没有则使用 `LOCALE_KEYS.HEADER_DEFAULT_TITLE`（默认「Agent 编辑」） */
     title?: string;
     /**
      * 初始画布，结构与保存时 **`WechenAgentSnapshot.flow`** 完全一致（`WechenAgentFlowJson`：`title?` + `nodes` + `edges`）。
@@ -22,8 +28,8 @@ export interface WechenAgentEditorProps {
      */
     mapComponentLibraryList?: (list: WechenAgentComponentLibraryList) => WechenAgentComponentLibraryList;
     /**
-     * 自定义画布节点渲染；参数为 React Flow `NodeProps`（含 `id`、`data`、`type`、`selected` 等）。
-     * 若使用自定义节点，请自行放置 `Handle` 以保留连线能力。
+     * 自定义画布节点 **内容区**（字段与样式）；参数为 React Flow `NodeProps`。
+     * 内置外壳与接线桩（四边感应或 `data.flowHandles`）始终保留；**勿** 在返回值内放置 `Handle`。
      */
     renderFlowNode?: WechenAgentRenderFlowNodeFn;
     /**
@@ -38,7 +44,13 @@ export interface WechenAgentEditorProps {
      */
     renderConfigPanel?: WechenAgentRenderConfigPanelFn;
     /**
-     * 自定义顶栏 **右侧** 操作区（左侧 CRAFT + 标题不变）。未传时显示默认「保存」「测试运行」。
+     * 自定义顶栏 **左侧** leading 区（默认 `Title` + 解析后的 `headerTitle`）。
+     * 返回 `null` / `undefined` 时左侧为空白（不显示默认标题）。
+     * 改标题数据仍用 `title` prop / `replaceFlow`；本回调仅负责呈现。
+     */
+    renderHeaderLeading?: (ctx: WechenAgentHeaderLeadingRenderContext) => ReactNode;
+    /**
+     * 自定义顶栏 **右侧** 操作区。未传时显示默认「保存」「测试运行」。
      * 返回 `null` / `undefined` 时右侧为空白（不显示默认按钮）。
      */
     renderHeaderActions?: (ctx: WechenAgentHeaderActionsRenderContext) => ReactNode;
@@ -57,6 +69,11 @@ export interface WechenAgentEditorProps {
      * `readOnly` / `readingMode` 下 **不调用** 本回调。
      */
     onBeforeRemoveEdge?: WechenBeforeRemoveEdgeFn;
+    /**
+     * 保存前回调；同步返回 **`false`** 时取消该次保存（顶栏与 `ref.save()`）。
+     * `readOnly` / `readingMode` 下 **不调用**。
+     */
+    onBeforeSave?: WechenBeforeSaveFn;
     /**
      * 为真时禁止对图的增删改（拖入、连线、删除键、拖动节点等）；仍允许平移/缩放。
      * 标志会传入 `renderConfigPanel` / `renderNodeConfig` 便于禁用表单。
@@ -73,6 +90,22 @@ export interface WechenAgentEditorProps {
     className?: string;
     /** 透传根 `Layout` 的 `style`（在默认宽高之后合并，便于覆盖） */
     style?: CSSProperties;
+    /**
+     * 编辑器壳层 + 内置回退路径的 **语言包大 JSON**（**key 为默认中文**，如 `"保存"`、`"配置"`）。
+     *
+     * - **未传**：始终显示内置中文（`DEFAULT_ZH_CN`），与 antd `ConfigProvider`、浏览器语言无关。
+     * - **已传**：仅以本对象为准；缺失 key 显示 key 字符串，**不回退**中文。
+     *   生产请传入与 `exportWechenAgentEditorLocaleBundle()` 同 key 集合的完整译文，
+     *   或先用 `mergeWechenAgentEditorLocaleMessages` 在宿主侧合并成整包。
+     *
+     * 自定义 `renderConfigPanel` / `renderFlowNode` 内业务文案由宿主自行 i18n。
+     */
+    localeMessages?: WechenAgentEditorLocaleMessages;
+    /** 优先于 `localeMessages`；`defaultText` 来自 `DEFAULT_ZH_CN[key]`。 */
+    localeTranslate?: WechenAgentEditorLocaleTranslateFn;
+    /** 覆盖右侧栏外框标题；未传时使用 `LOCALE_KEYS.SIDER_CONFIG_TITLE`（默认「配置」）。 */
+    configSiderTitle?: string | WechenConfigSiderTitleFn;
 }
+export type { WechenAgentEditorLocaleMessages, WechenAgentEditorLocaleTranslateFn, } from './i18n/defaultLocaleMessages';
 export declare const WechenAgentEditor: import('react').ForwardRefExoticComponent<WechenAgentEditorProps & import('react').RefAttributes<WechenAgentEditorRef>>;
 //# sourceMappingURL=WechenAgentEditor.d.ts.map

package/dist/WechenAgentEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WechenAgentEditor.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditor.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAa,SAAS,EAAa,MAAM,OAAO,CAAC;AAe5E,OAAO,KAAK,EACV,qBAAqB,EACrB,+BAA+B,EAChC,MAAM,iCAAiC,CAAC;AA0BzC,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qCAAqC,EACrC,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAU/E,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,yDAAyD;IACzD,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACxC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CACxB,IAAI,EAAE,+BAA+B,KAClC,+BAA+B,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IACjD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;IACnD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,qCAAqC,KAAK,SAAS,CAAC;IAChF,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAmkBD,eAAO,MAAM,iBAAiB,yHAyE7B,CAAC"}
+{"version":3,"file":"WechenAgentEditor.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditor.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAa,SAAS,EAAa,MAAM,OAAO,CAAC;AAc5E,OAAO,KAAK,EACV,qBAAqB,EACrB,+BAA+B,EAChC,MAAM,iCAAiC,CAAC;AAuBzC,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,qCAAqC,EACrC,qCAAqC,EACrC,mBAAmB,EAEnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAI/E,OAAO,KAAK,EACV,+BAA+B,EAC/B,kCAAkC,EACnC,MAAM,8BAA8B,CAAC;AAMtC,iEAAiE;AAEjE,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,GAAG,EAAE,6BAA6B,KAAK,MAAM,CAAC;AAEtF,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,yDAAyD;IACzD,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACxC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,CACxB,IAAI,EAAE,+BAA+B,KAClC,+BAA+B,CAAC;IACrC;;;OAGG;IACH,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C;;;OAGG;IACH,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;IACjD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;IACnD;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,qCAAqC,KAAK,SAAS,CAAC;IAChF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,qCAAqC,KAAK,SAAS,CAAC;IAChF,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjD,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACpD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C;;;OAGG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,+BAA+B,CAAC;IACjD,kEAAkE;IAClE,eAAe,CAAC,EAAE,kCAAkC,CAAC;IACrD,gEAAgE;IAChE,gBAAgB,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAAC;CACtD;AAED,YAAY,EACV,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,8BAA8B,CAAC;AAyqBtC,eAAO,MAAM,iBAAiB,yHA4F7B,CAAC"}

package/dist/WechenAgentEditorContext.d.ts

@@ -1,8 +1,13 @@
 import { NodeProps } from '@xyflow/react';
 import { ReactNode } from 'react';
+/**
+ * 自定义画布节点 **内容区**（字段展示与样式）。
+ * 内置节点外壳、选中态与接线桩（`ZoneHandles` / `DeclaredHandles`）由包保留；
+ * **勿** 在返回值内放置 `@xyflow/react` `Handle`。
+ */
 export type WechenAgentRenderFlowNodeFn = (props: NodeProps) => ReactNode;
 export interface WechenAgentEditorRenderContextValue {
-    /** 自定义画布节点外观；未设置时使用内置 MainAgent / Card / Pill 节点 UI */
+    /** 自定义节点内容区；未设置时使用内置默认字段块 */
     renderFlowNode?: WechenAgentRenderFlowNodeFn;
 }
 export declare const WechenAgentEditorRenderContext: import('react').Context<WechenAgentEditorRenderContextValue | null>;

package/dist/WechenAgentEditorContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WechenAgentEditorContext.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditorContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,2BAA2B,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;AAE1E,MAAM,WAAW,mCAAmC;IAClD,uDAAuD;IACvD,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C;AAED,eAAO,MAAM,8BAA8B,qEACsB,CAAC;AAElE,wBAAgB,0BAA0B,IAAI,mCAAmC,CAEhF"}
+{"version":3,"file":"WechenAgentEditorContext.d.ts","sourceRoot":"","sources":["../src/WechenAgentEditorContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC;AAE1E,MAAM,WAAW,mCAAmC;IAClD,6BAA6B;IAC7B,cAAc,CAAC,EAAE,2BAA2B,CAAC;CAC9C;AAED,eAAO,MAAM,8BAA8B,qEACsB,CAAC;AAElE,wBAAgB,0BAA0B,IAAI,mCAAmC,CAEhF"}

package/dist/backendWorkflowJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backendWorkflowJson.d.ts","sourceRoot":"","sources":["../src/backendWorkflowJson.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI/G;;GAEG;AACH,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,MAAM,6BAA6B,GACrC,OAAO,GACP,OAAO,GACP,MAAM,GACN,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AAEb,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,6BAA6B,CAAC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4HD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,EAChD,IAAI,EAAE,yBAAyB,GAC9B,yBAAyB,CAY3B;AAiDD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,yBAAyB,GAAG,mBAAmB,CAgB/F;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAyC9F"}
+{"version":3,"file":"backendWorkflowJson.d.ts","sourceRoot":"","sources":["../src/backendWorkflowJson.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqC,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAI/G;;GAEG;AACH,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D,2CAA2C;AAC3C,MAAM,MAAM,6BAA6B,GACrC,OAAO,GACP,OAAO,GACP,MAAM,GACN,WAAW,GACX,KAAK,GACL,QAAQ,CAAC;AAgCb,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,6BAA6B,CAAC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA+HD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,mBAAmB,GAAG,mBAAmB,EAChD,IAAI,EAAE,yBAAyB,GAC9B,yBAAyB,CAY3B;AA2DD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,yBAAyB,GAAG,mBAAmB,CAgB/F;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,yBAAyB,CAyC9F"}

package/dist/config/componentLibraryConfig.d.ts

@@ -31,7 +31,7 @@ export interface ComponentLibraryItem {
     addButtonSlot?: ReactNode | null;
     /**
      * @deprecated 默认节点优先使用 **左右感应区** 动态接线（见 README）；仅当需兼容旧版声明桩时保留。
-     * 拖入画布后写入 `data.flowHandles`；使用 `renderFlowNode` 覆盖整节点时由宿主自行决定。
+     * 拖入画布后写入 `data.flowHandles`；与 `renderFlowNode` 可并存（桩由包渲染，自定义仅替换内容区）。
      */
     flowHandles?: FlowHandlesConfig;
 }

package/dist/flow/flowGraphMutations.d.ts

@@ -0,0 +1,21 @@
+import { Connection, Edge, Node } from '@xyflow/react';
+import { ComponentLibraryGroup } from '../config/componentLibraryConfig';
+export interface CreateNodeFromLibraryItemOptions {
+    groupKey: string;
+    itemKey: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    id?: string;
+}
+/**
+ * 由组件库条目构造节点（与画布拖放一致）。非法 groupKey/itemKey 返回 `null`。
+ */
+export declare function createNodeFromLibraryItem(libraryGroups: ComponentLibraryGroup[], options: CreateNodeFromLibraryItemOptions): Node | null;
+export type NodeLookupFn = (id: string) => Node | undefined;
+/**
+ * 由连接构造边（与画布 `onConnect` 一致）。非法连接或端点不存在返回 `null`。
+ */
+export declare function createEdgeFromConnection(connection: Connection, getNode: NodeLookupFn, edgeId?: string): Edge | null;
+//# sourceMappingURL=flowGraphMutations.d.ts.map

package/dist/flow/flowGraphMutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowGraphMutations.d.ts","sourceRoot":"","sources":["../../src/flow/flowGraphMutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,kCAAkC,CAAC;AAU1C,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,qBAAqB,EAAE,EACtC,OAAO,EAAE,gCAAgC,GACxC,IAAI,GAAG,IAAI,CAoBb;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;AAE5D;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,GAAG,IAAI,CAoBb"}

package/dist/flow/flowValidation.d.ts

@@ -0,0 +1,24 @@
+import { WechenAgentFlowJson } from '../flowTypes';
+export type WechenFlowValidationSeverity = "error" | "warning";
+export interface WechenFlowValidationIssue {
+    ruleId: string;
+    severity: WechenFlowValidationSeverity;
+    message: string;
+    nodeId?: string;
+    edgeId?: string;
+}
+export interface WechenFlowValidationResult {
+    valid: boolean;
+    issues: WechenFlowValidationIssue[];
+}
+export interface ValidateWechenAgentFlowOptions {
+    /** 检查是否存在入口类节点（pill 或 `data.backendNodeType === 'start'`） */
+    checkMissingStart?: boolean;
+    /** 检查非入口节点是否完全无边连接 */
+    checkOrphanNodes?: boolean;
+}
+/**
+ * 对画布 flow 做轻量合法性检查（纯函数，不阻断保存除非宿主使用 `onBeforeSave`）。
+ */
+export declare function validateWechenAgentFlow(flow: WechenAgentFlowJson, options?: ValidateWechenAgentFlowOptions): WechenFlowValidationResult;
+//# sourceMappingURL=flowValidation.d.ts.map

package/dist/flow/flowValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowValidation.d.ts","sourceRoot":"","sources":["../../src/flow/flowValidation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,4BAA4B,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,yBAAyB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,8BAA8B;IAC7C,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sBAAsB;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAeD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,8BAA8B,GACvC,0BAA0B,CAgE5B"}

package/dist/flow/nodes/CardNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CardNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/CardNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CA+CxC"}
+{"version":3,"file":"CardNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/CardNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CA2CxC"}

package/dist/flow/nodes/MainAgentNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MainAgentNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/MainAgentNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,2CA2D7C"}
+{"version":3,"file":"MainAgentNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/MainAgentNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAO/C,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,2CAiD7C"}

package/dist/flow/nodes/NodeHandlesLayer.d.ts

@@ -0,0 +1,6 @@
+import { FlowHandlesConfig } from '../../config/flowHandleTypes';
+export declare function NodeHandlesLayer({ nodeId, flowHandles, }: {
+    nodeId: string;
+    flowHandles?: FlowHandlesConfig;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NodeHandlesLayer.d.ts.map

package/dist/flow/nodes/NodeHandlesLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeHandlesLayer.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/NodeHandlesLayer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAKtE,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,WAAW,GACZ,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC,2CAMA"}

package/dist/flow/nodes/PillNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PillNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/PillNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CAuBxC"}
+{"version":3,"file":"PillNode.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/PillNode.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM/C,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,2CAsBxC"}

package/dist/flow/nodes/flowNodeDefaultContent.d.ts

@@ -0,0 +1,11 @@
+import { MainAgentNodeData, SimpleNodeData } from '../../flowTypes';
+export declare function MainAgentDefaultFields({ data }: {
+    data: MainAgentNodeData;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function CardDefaultFields({ data }: {
+    data: SimpleNodeData;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function PillDefaultFields({ data }: {
+    data: SimpleNodeData;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=flowNodeDefaultContent.d.ts.map

package/dist/flow/nodes/flowNodeDefaultContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowNodeDefaultContent.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/flowNodeDefaultContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEzE,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,2CAW3E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,2CAEnE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,2CAEnE"}

package/dist/flow/nodes/flowNodeHandleLayout.d.ts

@@ -0,0 +1,4 @@
+import { FlowHandlesConfig, FlowHandleSpec } from '../../config/flowHandleTypes';
+export declare function getExpandedFlowHandleSpecs(flowHandles: FlowHandlesConfig | undefined): FlowHandleSpec[];
+export declare function usesDeclaredFlowHandles(flowHandles: FlowHandlesConfig | undefined): boolean;
+//# sourceMappingURL=flowNodeHandleLayout.d.ts.map

package/dist/flow/nodes/flowNodeHandleLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowNodeHandleLayout.d.ts","sourceRoot":"","sources":["../../../src/flow/nodes/flowNodeHandleLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGtF,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,iBAAiB,GAAG,SAAS,GACzC,cAAc,EAAE,CAKlB;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,iBAAiB,GAAG,SAAS,GACzC,OAAO,CAET"}

package/dist/flowTypes.d.ts

@@ -1,5 +1,5 @@
 import { RefObject } from 'react';
-import { Edge, FitViewOptions, Node, Viewport, ViewportHelperFunctionOptions } from '@xyflow/react';
+import { Connection, Edge, FitViewOptions, Node, Viewport, ViewportHelperFunctionOptions } from '@xyflow/react';
 import { FlowHandlesConfig } from './config/flowHandleTypes';
 /** 删除守卫回调返回值：`false` 拒绝；`true` / `undefined` / `void` 允许。 */
 export type WechenDeleteGuardResult = boolean | void;
@@ -13,6 +13,28 @@ export type WechenBeforeRemoveNodeFn = (node: Node) => WechenDeleteGuardResult;
  * 因删除节点而 **级联移除** 的边 **不会** 触发本回调。
  */
 export type WechenBeforeRemoveEdgeFn = (edge: Edge) => WechenDeleteGuardResult;
+/**
+ * 保存前宿主回调。同步返回 **`false`** 取消该次保存（顶栏保存与 `ref.save()` 均生效）。
+ * `readOnly` / `readingMode` 下 **不调用** 本回调。
+ */
+export type WechenBeforeSaveFn = (snapshot: WechenAgentSnapshot) => WechenDeleteGuardResult;
+/** `ref.addNodeFromLibrary` 入参 */
+export interface WechenAddNodeFromLibraryOptions {
+    groupKey: string;
+    itemKey: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    id?: string;
+}
+/** `ref.connect` 入参 */
+export interface WechenConnectOptions {
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+}
 /**
  * 画布完整结构（初始值与持久化）：`title` + `nodes` + `edges`。
  * **`initialFlow` prop** 与 **`WechenAgentSnapshot.flow`**（以及 `flowJson` 反序列化结果）为同一形状，可互换使用。
@@ -60,6 +82,18 @@ export interface WechenAgentSnapshot {
      */
     flowJson: string;
 }
+/**
+ * 传给 `renderHeaderLeading` 的上下文：提供当前解析标题与 `editorRef`，便于自定义顶栏左侧品牌/标题区。
+ */
+export interface WechenAgentHeaderLeadingRenderContext {
+    /** 与顶栏默认标题、`ref.getTitle()` 一致的当前解析标题 */
+    title: string;
+    /**
+     * 与 `<WechenAgentEditor ref={...} />` 为同一 ref 对象（推荐对象 ref）。
+     * 首帧或 StrictMode 下 `current` 可能为 `null`，应在事件或 `useEffect` 内使用。
+     */
+    editorRef: RefObject<WechenAgentEditorRef | null>;
+}
 /**
  * 传给 `renderHeaderActions` 的上下文：语义化操作与宿主 `ref` 一致，便于自定义顶栏右侧时调用。
  */
@@ -136,5 +170,20 @@ export interface WechenAgentEditorRef {
     removeEdge(edgeId: string): void;
     /** 与 `getSnapshot().flowJson` 相同，便于仅要字符串时使用 */
     getFlowJson(): string;
+    /**
+     * 从组件库创建节点（与拖放一致）。`readOnly` / `readingMode` 下返回 `null`。
+     * 非法 `groupKey` / `itemKey` 或 id 冲突时返回 `null`。
+     */
+    addNodeFromLibrary(options: WechenAddNodeFromLibraryOptions): Node | null;
+    /**
+     * 插入节点。id 已存在或只读时返回 `null`。
+     */
+    addNode(node: Node): Node | null;
+    /**
+     * 创建边（与画布连线一致）。非法连接或只读时返回 `null`。
+     */
+    addEdge(connection: Connection): Edge | null;
+    /** `addEdge` 的便捷封装 */
+    connect(options: WechenConnectOptions): Edge | null;
 }
 //# sourceMappingURL=flowTypes.d.ts.map

package/dist/flowTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowTypes.d.ts","sourceRoot":"","sources":["../src/flowTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,IAAI,EACJ,cAAc,EACd,IAAI,EACJ,QAAQ,EACR,6BAA6B,EAC9B,MAAM,eAAe,CAAC;AAEvB,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,IAAI,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,uBAAuB,CAAC;AAE/E;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,wDAAwD;AACxD,MAAM,WAAW,iBAAkB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,8DAA8D;IAC9D,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,gDAAgD;IAChD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,SAAS,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sFAAsF;IACtF,QAAQ,IAAI,MAAM,CAAC;IACnB,WAAW,IAAI,mBAAmB,CAAC;IACnC,oCAAoC;IACpC,OAAO,IAAI,mBAAmB,CAAC;IAC/B,QAAQ,IAAI,IAAI,EAAE,CAAC;IACnB,QAAQ,IAAI,IAAI,EAAE,CAAC;IACnB,iCAAiC;IACjC,IAAI,IAAI,IAAI,CAAC;IACb,oCAAoC;IACpC,OAAO,IAAI,IAAI,CAAC;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpE;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,qEAAqE;IACrE,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7C,qCAAqC;IACrC,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAAC;IACnC,mCAAmC;IACnC,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAExC,qDAAqD;IACrD,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,6BAA6B;IAC7B,WAAW,IAAI,QAAQ,CAAC;IACxB,6BAA6B;IAC7B,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAE/E;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC,+CAA+C;IAC/C,WAAW,IAAI,MAAM,CAAC;CACvB"}
+{"version":3,"file":"flowTypes.d.ts","sourceRoot":"","sources":["../src/flowTypes.ts"],"names":[],"mappings":"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"}

package/dist/hostEditorConfig.d.ts

@@ -32,6 +32,7 @@ export interface WechenHostEditorConfig {
     onTestRun?: WechenAgentEditorProps["onTestRun"];
     onBeforeRemoveNode?: WechenAgentEditorProps["onBeforeRemoveNode"];
     onBeforeRemoveEdge?: WechenAgentEditorProps["onBeforeRemoveEdge"];
+    onBeforeSave?: WechenAgentEditorProps["onBeforeSave"];
     /**
      * 完整覆盖左侧组件库。与 {@link library} 二选一：**本字段优先**；
      * 设置后忽略 `library`。
@@ -43,7 +44,12 @@ export interface WechenHostEditorConfig {
     renderFlowNode?: WechenAgentEditorProps["renderFlowNode"];
     renderNodeConfig?: WechenAgentEditorProps["renderNodeConfig"];
     renderConfigPanel?: WechenAgentEditorProps["renderConfigPanel"];
+    renderHeaderLeading?: WechenAgentEditorProps["renderHeaderLeading"];
     renderHeaderActions?: WechenAgentEditorProps["renderHeaderActions"];
+    /** 见 {@link WechenAgentEditorProps.localeMessages}：未传=中文；已传=语言包大 JSON。 */
+    localeMessages?: WechenAgentEditorProps["localeMessages"];
+    localeTranslate?: WechenAgentEditorProps["localeTranslate"];
+    configSiderTitle?: WechenAgentEditorProps["configSiderTitle"];
 }
 /**
  * 将 {@link WechenHostEditorConfig} 展开为可直接 `<WechenAgentEditor {...props} />` 的 props。

package/dist/hostEditorConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostEditorConfig.d.ts","sourceRoot":"","sources":["../src/hostEditorConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAwB,MAAM,iCAAiC,CAAC;AAEnG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,sCAAsC;AACtC,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,uBAAuB,CAAC;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,kBAAkB,CAAC,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAClE,kBAAkB,CAAC,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAClE;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACxC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,uBAAuB,CAAC,EAAE,sBAAsB,CAAC,yBAAyB,CAAC,CAAC;IAC5E,cAAc,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAC1D,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAC9D,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAChE,mBAAmB,CAAC,EAAE,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;CACrE;AAwDD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CA2BlG"}
+{"version":3,"file":"hostEditorConfig.d.ts","sourceRoot":"","sources":["../src/hostEditorConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,qBAAqB,EAAwB,MAAM,iCAAiC,CAAC;AAEnG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,sCAAsC;AACtC,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,uBAAuB,CAAC;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,sBAAsB,CAAC,aAAa,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAChD,kBAAkB,CAAC,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAClE,kBAAkB,CAAC,EAAE,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAClE,YAAY,CAAC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACtD;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACxC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,uBAAuB,CAAC,EAAE,sBAAsB,CAAC,yBAAyB,CAAC,CAAC;IAC5E,cAAc,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAC1D,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;IAC9D,iBAAiB,CAAC,EAAE,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAChE,mBAAmB,CAAC,EAAE,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;IACpE,mBAAmB,CAAC,EAAE,sBAAsB,CAAC,qBAAqB,CAAC,CAAC;IACpE,0EAA0E;IAC1E,cAAc,CAAC,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;IAC1D,eAAe,CAAC,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;IAC5D,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;CAC/D;AAwDD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,sBAAsB,GAAG,sBAAsB,CAkClG"}

package/dist/i18n/LocaleContext.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+import { WechenAgentEditorLocaleMessages, WechenAgentEditorLocaleTranslateFn } from './defaultLocaleMessages';
+export interface EditorLocaleContextValue {
+    t: (key: string) => string;
+    messages: Readonly<Record<string, string>>;
+}
+export interface EditorLocaleProviderProps {
+    /**
+     * 目标语言的大 JSON（**key 为默认中文**，见 `LOCALE_KEYS` / `exportWechenAgentEditorLocaleBundle`）。
+     * 未传 → 内置中文；已传 → 仅以该对象为准（见 `resolveLocaleMessage`）。
+     */
+    localeMessages?: WechenAgentEditorLocaleMessages;
+    localeTranslate?: WechenAgentEditorLocaleTranslateFn;
+    children: ReactNode;
+}
+/** @internal 供测试与 Provider 共用 */
+export declare function createEditorLocaleContextValue({ localeMessages, localeTranslate, }: EditorLocaleProviderProps): EditorLocaleContextValue;
+export declare function EditorLocaleProvider({ localeMessages, localeTranslate, children, }: EditorLocaleProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useEditorLocale(): EditorLocaleContextValue;
+//# sourceMappingURL=LocaleContext.d.ts.map

package/dist/i18n/LocaleContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleContext.d.ts","sourceRoot":"","sources":["../../src/i18n/LocaleContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3E,OAAO,KAAK,EACV,+BAA+B,EAC/B,kCAAkC,EACnC,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,wBAAwB;IACvC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5C;AAOD,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,+BAA+B,CAAC;IACjD,eAAe,CAAC,EAAE,kCAAkC,CAAC;IACrD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,iCAAiC;AACjC,wBAAgB,8BAA8B,CAAC,EAC7C,cAAc,EACd,eAAe,GAChB,EAAE,yBAAyB,GAAG,wBAAwB,CAYtD;AAED,wBAAgB,oBAAoB,CAAC,EACnC,cAAc,EACd,eAAe,EACf,QAAQ,GACT,EAAE,yBAAyB,2CAS3B;AAED,wBAAgB,eAAe,IAAI,wBAAwB,CAE1D"}

package/dist/i18n/buildReactFlowAriaLabelConfig.d.ts

@@ -0,0 +1,4 @@
+import { AriaLabelConfig } from '@xyflow/react';
+/** 将编辑器壳层 `t()` 映射为 React Flow `ariaLabelConfig`（画布缩放等控件）。 */
+export declare function buildReactFlowAriaLabelConfig(t: (key: string) => string): Partial<AriaLabelConfig>;
+//# sourceMappingURL=buildReactFlowAriaLabelConfig.d.ts.map

package/dist/i18n/buildReactFlowAriaLabelConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildReactFlowAriaLabelConfig.d.ts","sourceRoot":"","sources":["../../src/i18n/buildReactFlowAriaLabelConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,8DAA8D;AAC9D,wBAAgB,6BAA6B,CAC3C,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GACzB,OAAO,CAAC,eAAe,CAAC,CAO1B"}

package/dist/i18n/defaultLocaleMessages.d.ts

@@ -0,0 +1,6 @@
+import { WechenAgentEditorLocaleKey } from './localeKeys';
+export declare const DEFAULT_ZH_CN: Record<WechenAgentEditorLocaleKey, string>;
+/** 语言包：key 为默认中文（见 `LOCALE_KEYS`）；value 为目标语言文案。 */
+export type WechenAgentEditorLocaleMessages = Partial<Record<WechenAgentEditorLocaleKey, string>>;
+export type WechenAgentEditorLocaleTranslateFn = (key: string, defaultText: string) => string | undefined;
+//# sourceMappingURL=defaultLocaleMessages.d.ts.map

package/dist/i18n/defaultLocaleMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultLocaleMessages.d.ts","sourceRoot":"","sources":["../../src/i18n/defaultLocaleMessages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAGpE,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,+BAA+B,GAAG,OAAO,CACnD,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAC3C,CAAC;AAEF,MAAM,MAAM,kCAAkC,GAAG,CAC/C,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,CAAC"}