one-design-next 0.0.45 → 0.0.46

package/dist/_interrupt-types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Interrupt · 对话中断协议（无 UI）
+ *
+ * Clarify（要信息）与 Approval（要授权）分轨组件，只共享本协议。
+ * 见讲演录：interrupt-clarify-approval-split
+ *
+ * 业界对照：
+ * - Claude `canUseTool`（AskUserQuestion vs tool permission）
+ * - LangChain `interrupt` + approve/edit/reject/respond
+ * - OpenAI Agents `interruption` / `needsApproval`
+ */
+/** 中断意图：收集信息 | 授权副作用 */
+export type InterruptIntent = 'clarify' | 'approve';
+/** 中断生命周期 */
+export type InterruptStatus = 'pending' | 'resolved' | 'skipped';
+/**
+ * 中断最小信封。
+ * `payload` 由 intent 分发：clarify → Clarify*Spec；approve → ApprovalSpec。
+ * 具体 Spec 类型在各组件目录定义，协议层不反向依赖 UI。
+ */
+export interface InterruptBase<TPayload = unknown> {
+    id: string;
+    intent: InterruptIntent;
+    status: InterruptStatus;
+    payload: TPayload;
+}

package/dist/_interrupt-types.js

@@ -0,0 +1 @@
+export {};

package/dist/approval/index.d.ts

@@ -0,0 +1,72 @@
+import * as React from 'react';
+import './style';
+export type ApprovalDecision = 'approve' | 'reject';
+/** 参数来源：已获取 / AI 推测 / 待用户填 */
+export type ApprovalFieldSource = 'fetched' | 'inferred' | 'user';
+export type ApprovalFieldControl = 'text' | 'number' | 'textarea' | 'select' | 'radio' | 'multi-select' | 'date' | 'date-range' | 'switch' | 'custom'
+/** 复合对象：嵌套分组，自身无值 */
+ | 'group'
+/** 复合列表：按 itemFields 重复；values 用扁平点路径 `listKey.i.relKey` */
+ | 'list';
+export interface ApprovalFieldOption {
+    value: string;
+    label: string;
+}
+export interface ApprovalField {
+    key: string;
+    label: string;
+    control: ApprovalFieldControl;
+    source: ApprovalFieldSource;
+    required?: boolean;
+    readOnly?: boolean;
+    options?: ApprovalFieldOption[];
+    placeholder?: string;
+    /** control='group'：子节点（完整 key，如 tag_insight_content.audience_id） */
+    children?: ApprovalField[];
+    /** control='list'：单项字段 schema（相对 key，如 tag_id） */
+    itemFields?: ApprovalField[];
+    /** control='list'：最少行数，默认 1 */
+    minItems?: number;
+    /** control='list'：最多行数 */
+    maxItems?: number;
+    /** control='custom' 时由消费方渲染 */
+    render?: (ctx: {
+        value: unknown;
+        onChange: (next: unknown) => void;
+        readOnly: boolean;
+    }) => React.ReactNode;
+}
+export interface ApprovalSpec {
+    /** 待授权动作说明 */
+    description: string;
+    /** 写操作工具 / 任务短名；有 fields 时显示在标题下辅助描述中 */
+    title?: string;
+    actionLabel: string;
+    rejectLabel?: string;
+    destructive?: boolean;
+    resolvedLabel?: string;
+    rejectedLabel?: string;
+    /**
+     * 当前步可见的参数树。分支 / 条件显隐由 Host 算好再传入；
+     * 组件不内置业务路由引擎。
+     */
+    fields?: ApprovalField[];
+}
+export interface ApprovalResolvePayload {
+    decision: ApprovalDecision;
+    values?: Record<string, unknown>;
+}
+export interface ApprovalProps {
+    spec: ApprovalSpec;
+    values?: Record<string, unknown>;
+    defaultValues?: Record<string, unknown>;
+    onValuesChange?: (values: Record<string, unknown>) => void;
+    resolved?: ApprovalDecision | null;
+    onResolve?: (payload: ApprovalResolvePayload) => void;
+    className?: string;
+}
+export declare function Approval({ spec, values: valuesProp, defaultValues, onValuesChange, resolved: resolvedProp, onResolve, className, }: ApprovalProps): React.JSX.Element;
+export declare namespace Approval {
+    var displayName: string;
+}
+export default Approval;

package/dist/approval/index.js

@@ -0,0 +1,607 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e2) { throw _e2; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e3) { didErr = true; err = _e3; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import * as React from 'react';
+import clsx from 'clsx';
+import Button from "../button";
+import DatePicker from "../date-picker";
+import DateRangePicker from "../date-range-picker";
+import Icon from "../icon";
+import Input from "../input";
+import InputNumber from "../input-number";
+import Select from "../select";
+import Switch from "../switch";
+import Radio from "../radio";
+import "./style";
+
+/* ------------------------------------------------------------------ */
+/*  Types                                                              */
+/* ------------------------------------------------------------------ */
+
+/** 参数来源：已获取 / AI 推测 / 待用户填 */
+
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                            */
+/* ------------------------------------------------------------------ */
+
+var SOURCE_LABEL = {
+  fetched: '已获取',
+  inferred: 'AI 推测',
+  user: '待填写'
+};
+function isEmptyValue(value) {
+  if (value === undefined || value === null) return true;
+  if (typeof value === 'string') return value.trim() === '';
+  if (Array.isArray(value)) return value.length === 0;
+  return false;
+}
+function isContainer(field) {
+  return field.control === 'group' || field.control === 'list';
+}
+
+/** 保持 Host 声明序（先名称后类型等由 Host 控制，组件不按来源重排） */
+function normalizeNodes(fields) {
+  return fields.map(function (f) {
+    if (f.control === 'group' && f.children) {
+      return _objectSpread(_objectSpread({}, f), {}, {
+        children: normalizeNodes(f.children)
+      });
+    }
+    return f;
+  });
+}
+function getListLength(values, listKey, minItems) {
+  var prefix = "".concat(listKey, ".");
+  var maxIdx = -1;
+  for (var _i = 0, _Object$keys = Object.keys(values); _i < _Object$keys.length; _i++) {
+    var k = _Object$keys[_i];
+    if (!k.startsWith(prefix)) continue;
+    var head = k.slice(prefix.length).split('.')[0];
+    var idx = Number(head);
+    if (Number.isInteger(idx) && idx >= 0) maxIdx = Math.max(maxIdx, idx);
+  }
+  return Math.max(maxIdx + 1, minItems);
+}
+
+/** 删除 index 行后，将更高下标键前移 */
+function removeListItem(values, listKey, index) {
+  var prefix = "".concat(listKey, ".");
+  var next = {};
+  for (var _i2 = 0, _Object$entries = Object.entries(values); _i2 < _Object$entries.length; _i2++) {
+    var _Object$entries$_i = _slicedToArray(_Object$entries[_i2], 2),
+      k = _Object$entries$_i[0],
+      v = _Object$entries$_i[1];
+    if (!k.startsWith(prefix)) {
+      next[k] = v;
+      continue;
+    }
+    var rest = k.slice(prefix.length);
+    var dot = rest.indexOf('.');
+    if (dot < 0) continue;
+    var idx = Number(rest.slice(0, dot));
+    var rel = rest.slice(dot + 1);
+    if (!Number.isInteger(idx) || idx < 0) {
+      next[k] = v;
+      continue;
+    }
+    if (idx === index) continue;
+    if (idx > index) {
+      next["".concat(listKey, ".").concat(idx - 1, ".").concat(rel)] = v;
+    } else {
+      next[k] = v;
+    }
+  }
+  return next;
+}
+function collectLeafSlots(fields, values) {
+  var out = [];
+  var _iterator = _createForOfIteratorHelper(fields),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var f = _step.value;
+      if (f.control === 'group' && f.children) {
+        out.push.apply(out, _toConsumableArray(collectLeafSlots(f.children, values)));
+        continue;
+      }
+      if (f.control === 'list' && f.itemFields) {
+        var _f$minItems;
+        var min = (_f$minItems = f.minItems) !== null && _f$minItems !== void 0 ? _f$minItems : 1;
+        var len = getListLength(values, f.key, min);
+        for (var i = 0; i < len; i += 1) {
+          var _iterator2 = _createForOfIteratorHelper(f.itemFields),
+            _step2;
+          try {
+            for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+              var item = _step2.value;
+              out.push({
+                field: item,
+                key: "".concat(f.key, ".").concat(i, ".").concat(item.key)
+              });
+            }
+          } catch (err) {
+            _iterator2.e(err);
+          } finally {
+            _iterator2.f();
+          }
+        }
+        continue;
+      }
+      if (!isContainer(f)) {
+        out.push({
+          field: f,
+          key: f.key
+        });
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return out;
+}
+
+/** radio 未选时默认第一项，写入 values 供校验与提交 */
+function applyRadioDefaults(fields, values) {
+  var next = _objectSpread({}, values);
+  var changed = false;
+  var _iterator3 = _createForOfIteratorHelper(collectLeafSlots(fields, values)),
+    _step3;
+  try {
+    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+      var _slot$field$options;
+      var slot = _step3.value;
+      if (slot.field.control !== 'radio') continue;
+      if (!isEmptyValue(next[slot.key])) continue;
+      var first = (_slot$field$options = slot.field.options) === null || _slot$field$options === void 0 || (_slot$field$options = _slot$field$options[0]) === null || _slot$field$options === void 0 ? void 0 : _slot$field$options.value;
+      if (first == null) continue;
+      next[slot.key] = first;
+      changed = true;
+    }
+  } catch (err) {
+    _iterator3.e(err);
+  } finally {
+    _iterator3.f();
+  }
+  return changed ? next : values;
+}
+function parseDate(value) {
+  if (value instanceof Date && !Number.isNaN(value.getTime())) return value;
+  if (typeof value !== 'string' || !value.trim()) return null;
+  var d = new Date(value);
+  return Number.isNaN(d.getTime()) ? null : d;
+}
+function parseDateRange(value) {
+  if (Array.isArray(value) && value.length === 2) {
+    var _a = parseDate(value[0]);
+    var _b = parseDate(value[1]);
+    if (_a && _b) return [_a, _b];
+  }
+  if (typeof value !== 'string' || !value.includes(',')) return null;
+  var _value$split$map = value.split(',').map(function (x) {
+      return x.trim();
+    }),
+    _value$split$map2 = _slicedToArray(_value$split$map, 2),
+    s = _value$split$map2[0],
+    e = _value$split$map2[1];
+  var a = parseDate(s);
+  var b = parseDate(e);
+  if (a && b) return [a, b];
+  return null;
+}
+
+/* ------------------------------------------------------------------ */
+/*  Leaf control                                                       */
+/* ------------------------------------------------------------------ */
+
+function FieldControl(_ref) {
+  var _field$placeholder, _field$options, _field$options2, _field$placeholder2;
+  var field = _ref.field,
+    value = _ref.value,
+    _onChange = _ref.onChange,
+    disabled = _ref.disabled,
+    controlId = _ref.controlId;
+  var readOnly = disabled || !!field.readOnly;
+  if (field.control === 'custom' && field.render) {
+    return field.render({
+      value: value,
+      onChange: _onChange,
+      readOnly: readOnly
+    });
+  }
+  switch (field.control) {
+    case 'text':
+      return /*#__PURE__*/React.createElement(Input, {
+        id: controlId,
+        size: "small",
+        value: typeof value === 'string' ? value : value == null ? '' : String(value),
+        placeholder: field.placeholder,
+        disabled: readOnly,
+        onChange: function onChange(_e, v) {
+          return _onChange(v);
+        }
+      });
+    case 'number':
+      return /*#__PURE__*/React.createElement(InputNumber, {
+        id: controlId,
+        size: "small",
+        value: typeof value === 'number' ? value : value == null || value === '' ? null : Number(value),
+        placeholder: field.placeholder,
+        disabled: readOnly,
+        onChange: function onChange(v) {
+          return _onChange(v);
+        }
+      });
+    case 'textarea':
+      return /*#__PURE__*/React.createElement(Input.Textarea, {
+        id: controlId,
+        size: "small",
+        value: typeof value === 'string' ? value : value == null ? '' : String(value),
+        placeholder: field.placeholder,
+        disabled: readOnly,
+        autoSize: {
+          minRows: 2,
+          maxRows: 6
+        },
+        onChange: function onChange(_e, v) {
+          return _onChange(v);
+        }
+      });
+    case 'select':
+      return /*#__PURE__*/React.createElement(Select, {
+        size: "small",
+        value: value == null || value === '' ? undefined : value,
+        placeholder: (_field$placeholder = field.placeholder) !== null && _field$placeholder !== void 0 ? _field$placeholder : '请选择',
+        disabled: readOnly,
+        options: field.options,
+        onChange: function onChange(v) {
+          return _onChange(v);
+        },
+        style: {
+          width: '100%'
+        }
+      });
+    case 'radio':
+      return /*#__PURE__*/React.createElement(Radio.Group, {
+        size: "small",
+        value: value == null || value === '' ? (_field$options = field.options) !== null && _field$options !== void 0 && _field$options[0] ? String(field.options[0].value) : undefined : String(value),
+        options: (_field$options2 = field.options) === null || _field$options2 === void 0 ? void 0 : _field$options2.map(function (o) {
+          return {
+            value: String(o.value),
+            label: o.label,
+            disabled: readOnly
+          };
+        }),
+        onChange: function onChange(v) {
+          return _onChange(v);
+        }
+      });
+    case 'multi-select':
+      return /*#__PURE__*/React.createElement(Select, {
+        mode: "multiple",
+        size: "small",
+        value: Array.isArray(value) ? value : [],
+        placeholder: (_field$placeholder2 = field.placeholder) !== null && _field$placeholder2 !== void 0 ? _field$placeholder2 : '请选择',
+        disabled: readOnly,
+        options: field.options,
+        onChange: function onChange(v) {
+          return _onChange(v);
+        },
+        style: {
+          width: '100%'
+        }
+      });
+    case 'date':
+      return /*#__PURE__*/React.createElement(DatePicker, {
+        value: parseDate(value),
+        disabled: readOnly,
+        onChange: function onChange(_date, info) {
+          return _onChange(info.dateString || '');
+        }
+      });
+    case 'date-range':
+      return /*#__PURE__*/React.createElement(DateRangePicker, {
+        value: parseDateRange(value),
+        disabled: readOnly,
+        onChange: function onChange(_dates, info) {
+          return _onChange(info.dateString || '');
+        }
+      });
+    case 'switch':
+      return /*#__PURE__*/React.createElement(Switch, {
+        size: "small",
+        checked: !!value,
+        disabled: readOnly,
+        onChange: function onChange(checked) {
+          return _onChange(checked);
+        }
+      });
+    default:
+      return null;
+  }
+}
+function FieldRow(_ref2) {
+  var field = _ref2.field,
+    absKey = _ref2.absKey,
+    value = _ref2.value,
+    onChange = _ref2.onChange,
+    locked = _ref2.locked;
+  var controlId = "odn-approval-field-".concat(absKey.replace(/\./g, '-'));
+  return /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval-field": true,
+    "data-source": field.source,
+    "data-control": field.control,
+    "data-required": field.required || undefined
+  }, /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval-field-meta": true
+  }, /*#__PURE__*/React.createElement("label", {
+    htmlFor: controlId,
+    "data-odn-approval-field-label": true
+  }, field.label), /*#__PURE__*/React.createElement("span", {
+    "data-odn-approval-field-source": true
+  }, SOURCE_LABEL[field.source]), !field.required ? /*#__PURE__*/React.createElement("span", {
+    "data-odn-approval-field-optional": true
+  }, "\u9009\u586B") : null), /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval-field-control": true
+  }, /*#__PURE__*/React.createElement(FieldControl, {
+    field: field,
+    value: value,
+    onChange: onChange,
+    disabled: locked,
+    controlId: controlId
+  })));
+}
+
+/* ------------------------------------------------------------------ */
+/*  Tree nodes                                                         */
+/* ------------------------------------------------------------------ */
+
+function FieldNode(_ref3) {
+  var field = _ref3.field,
+    values = _ref3.values,
+    onPatch = _ref3.onPatch,
+    locked = _ref3.locked,
+    depth = _ref3.depth;
+  if (field.control === 'group') {
+    var _field$children;
+    var children = normalizeNodes((_field$children = field.children) !== null && _field$children !== void 0 ? _field$children : []);
+    var leafSlots = collectLeafSlots([field], values);
+    var pending = leafSlots.filter(function (s) {
+      return s.field.source === 'user';
+    }).length;
+    return /*#__PURE__*/React.createElement("div", {
+      "data-odn-approval-group": true,
+      "data-source": field.source,
+      "data-depth": depth
+    }, /*#__PURE__*/React.createElement("div", {
+      "data-odn-approval-group-header": true
+    }, /*#__PURE__*/React.createElement("span", {
+      "data-odn-approval-group-title": true
+    }, field.label), /*#__PURE__*/React.createElement("span", {
+      "data-odn-approval-field-source": true
+    }, SOURCE_LABEL[field.source]), pending > 0 ? /*#__PURE__*/React.createElement("span", {
+      "data-odn-approval-group-hint": true
+    }, "\u5F85\u586B ", pending, " \u9879") : /*#__PURE__*/React.createElement("span", {
+      "data-odn-approval-group-hint": true
+    }, "\u5DF2\u9F50")), /*#__PURE__*/React.createElement("div", {
+      "data-odn-approval-group-body": true
+    }, children.map(function (child) {
+      return /*#__PURE__*/React.createElement(FieldNode, {
+        key: child.key,
+        field: child,
+        values: values,
+        onPatch: onPatch,
+        locked: locked,
+        depth: depth + 1
+      });
+    })));
+  }
+  if (field.control === 'list') {
+    var _field$itemFields, _field$minItems;
+    var itemFields = (_field$itemFields = field.itemFields) !== null && _field$itemFields !== void 0 ? _field$itemFields : [];
+    var minItems = (_field$minItems = field.minItems) !== null && _field$minItems !== void 0 ? _field$minItems : 1;
+    var maxItems = field.maxItems;
+    var length = getListLength(values, field.key, minItems);
+    var addItem = function addItem() {
+      if (locked) return;
+      if (maxItems != null && length >= maxItems) return;
+      // 仅靠 length+1：写入占位空串触发长度增长
+      var first = itemFields[0];
+      if (!first) return;
+      onPatch(_objectSpread(_objectSpread({}, values), {}, _defineProperty({}, "".concat(field.key, ".").concat(length, ".").concat(first.key), '')));
+    };
+    var removeItem = function removeItem(index) {
+      if (locked) return;
+      if (length <= minItems) return;
+      onPatch(removeListItem(values, field.key, index));
+    };
+    return /*#__PURE__*/React.createElement("div", {
+      "data-odn-approval-list": true,
+      "data-source": field.source,
+      "data-depth": depth
+    }, /*#__PURE__*/React.createElement("div", {
+      "data-odn-approval-list-header": true
+    }, /*#__PURE__*/React.createElement("span", {
+      "data-odn-approval-group-title": true
+    }, field.label), /*#__PURE__*/React.createElement("span", {
+      "data-odn-approval-field-source": true
+    }, SOURCE_LABEL[field.source]), /*#__PURE__*/React.createElement("span", {
+      "data-odn-approval-group-hint": true
+    }, length, " \u9879"), !locked ? /*#__PURE__*/React.createElement(Button, {
+      size: "small",
+      intent: "normal",
+      disabled: maxItems != null && length >= maxItems,
+      onClick: addItem
+    }, "\u6DFB\u52A0") : null), /*#__PURE__*/React.createElement("div", {
+      "data-odn-approval-list-body": true
+    }, Array.from({
+      length: length
+    }, function (_, index) {
+      return /*#__PURE__*/React.createElement("div", {
+        key: "".concat(field.key, ".").concat(index),
+        "data-odn-approval-list-item": true
+      }, /*#__PURE__*/React.createElement("div", {
+        "data-odn-approval-list-item-meta": true
+      }, /*#__PURE__*/React.createElement("span", {
+        "data-odn-approval-list-item-index": true
+      }, "#", index + 1), !locked && length > minItems ? /*#__PURE__*/React.createElement(Button, {
+        size: "small",
+        intent: "normal",
+        onClick: function onClick() {
+          return removeItem(index);
+        }
+      }, "\u5220\u9664") : null), /*#__PURE__*/React.createElement("div", {
+        "data-odn-approval-list-item-fields": true
+      }, itemFields.map(function (item) {
+        var absKey = "".concat(field.key, ".").concat(index, ".").concat(item.key);
+        return /*#__PURE__*/React.createElement(FieldRow, {
+          key: absKey,
+          field: item,
+          absKey: absKey,
+          value: values[absKey],
+          onChange: function onChange(next) {
+            return onPatch(_objectSpread(_objectSpread({}, values), {}, _defineProperty({}, absKey, next)));
+          },
+          locked: locked
+        });
+      })));
+    })));
+  }
+  return /*#__PURE__*/React.createElement(FieldRow, {
+    field: field,
+    absKey: field.key,
+    value: values[field.key],
+    onChange: function onChange(next) {
+      return onPatch(_objectSpread(_objectSpread({}, values), {}, _defineProperty({}, field.key, next)));
+    },
+    locked: locked
+  });
+}
+
+/* ------------------------------------------------------------------ */
+/*  Approval                                                           */
+/* ------------------------------------------------------------------ */
+
+export function Approval(_ref4) {
+  var _spec$resolvedLabel, _spec$rejectedLabel;
+  var spec = _ref4.spec,
+    valuesProp = _ref4.values,
+    defaultValues = _ref4.defaultValues,
+    onValuesChange = _ref4.onValuesChange,
+    resolvedProp = _ref4.resolved,
+    onResolve = _ref4.onResolve,
+    className = _ref4.className;
+  var _React$useState = React.useState(null),
+    _React$useState2 = _slicedToArray(_React$useState, 2),
+    internalResolved = _React$useState2[0],
+    setInternalResolved = _React$useState2[1];
+  var _React$useState3 = React.useState(defaultValues !== null && defaultValues !== void 0 ? defaultValues : {}),
+    _React$useState4 = _slicedToArray(_React$useState3, 2),
+    internalValues = _React$useState4[0],
+    setInternalValues = _React$useState4[1];
+  var isResolvedControlled = resolvedProp !== undefined;
+  var isValuesControlled = valuesProp !== undefined;
+  var resolved = isResolvedControlled ? resolvedProp : internalResolved;
+  var values = isValuesControlled ? valuesProp : internalValues;
+  var locked = !!resolved;
+  var fields = React.useMemo(function () {
+    var _spec$fields;
+    return normalizeNodes((_spec$fields = spec.fields) !== null && _spec$fields !== void 0 ? _spec$fields : []);
+  }, [spec.fields]);
+  var patchValues = function patchValues(next) {
+    if (!isValuesControlled) setInternalValues(next);
+    onValuesChange === null || onValuesChange === void 0 || onValuesChange(next);
+  };
+  var valuesWithDefaults = React.useMemo(function () {
+    return applyRadioDefaults(fields, values);
+  }, [fields, values]);
+  var leafSlots = React.useMemo(function () {
+    return collectLeafSlots(fields, valuesWithDefaults);
+  }, [fields, valuesWithDefaults]);
+  var canApprove = leafSlots.every(function (slot) {
+    if (!slot.field.required) return true;
+    return !isEmptyValue(valuesWithDefaults[slot.key]);
+  });
+  var handleResolve = function handleResolve(decision) {
+    if (locked) return;
+    if (decision === 'approve' && !canApprove) return;
+    if (!isResolvedControlled) setInternalResolved(decision);
+    onResolve === null || onResolve === void 0 || onResolve({
+      decision: decision,
+      values: _objectSpread({}, valuesWithDefaults)
+    });
+  };
+  var resolvedMain = resolved === 'approve' ? (_spec$resolvedLabel = spec.resolvedLabel) !== null && _spec$resolvedLabel !== void 0 ? _spec$resolvedLabel : spec.description : resolved === 'reject' ? (_spec$rejectedLabel = spec.rejectedLabel) !== null && _spec$rejectedLabel !== void 0 ? _spec$rejectedLabel : spec.description : null;
+  var showSummary = !!resolved && !!resolvedMain && resolvedMain !== spec.description;
+  var hasFields = fields.length > 0;
+  return /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval": true,
+    "data-destructive": spec.destructive || undefined,
+    "data-resolved": resolved || undefined,
+    "data-has-fields": hasFields || undefined,
+    className: clsx(className)
+  }, /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval-body": true
+  }, /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval-heading": true
+  }, /*#__PURE__*/React.createElement("p", {
+    "data-odn-approval-text": true
+  }, resolved ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Icon, {
+    name: resolved === 'approve' ? 'check' : 'close',
+    size: 14,
+    "data-odn-approval-icon": true
+  }), /*#__PURE__*/React.createElement("span", {
+    "data-odn-approval-resolved-main": true
+  }, resolvedMain), showSummary ? /*#__PURE__*/React.createElement("span", {
+    "data-odn-approval-resolved-summary": true,
+    title: spec.description
+  }, "\xB7 \u539F\u95EE\u9898\uFF1A", spec.description) : null) : /*#__PURE__*/React.createElement(React.Fragment, null, spec.destructive ? /*#__PURE__*/React.createElement(Icon, {
+    name: "alert-triangle",
+    size: 14,
+    "data-odn-approval-icon": true,
+    "data-destructive": true
+  }) : null, /*#__PURE__*/React.createElement("span", null, spec.description)))), hasFields && !resolved ? /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval-fields": true
+  }, fields.map(function (field) {
+    return /*#__PURE__*/React.createElement(FieldNode, {
+      key: field.key,
+      field: field,
+      values: valuesWithDefaults,
+      onPatch: patchValues,
+      locked: locked,
+      depth: 0
+    });
+  })) : null), !resolved ? /*#__PURE__*/React.createElement("div", {
+    "data-odn-approval-actions": true
+  }, spec.rejectLabel ? /*#__PURE__*/React.createElement(Button, {
+    size: "small",
+    intent: "normal",
+    onClick: function onClick() {
+      return handleResolve('reject');
+    }
+  }, spec.rejectLabel) : null, /*#__PURE__*/React.createElement(Button, {
+    size: "small",
+    intent: spec.destructive ? 'danger' : 'primary',
+    disabled: !canApprove,
+    onClick: function onClick() {
+      return handleResolve('approve');
+    }
+  }, spec.actionLabel)) : null);
+}
+Approval.displayName = 'Approval';
+export default Approval;

package/dist/approval/style/index.css

@@ -0,0 +1,308 @@
+@charset "UTF-8";
+/**
+ * Approval · 授权确认
+ * 轻量态：紧凑横条（文案 + 按钮垂直居中）。
+ * 写操作审参（data-has-fields）：对齐 Composer box——
+ *   圆角 12px、描边 black-6、内边距 10px、底部分割线通栏。
+ * destructive 只影响主按钮与警告 icon，不整卡变红。
+ */
+[data-odn-approval] {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  width: 100%;
+  box-sizing: border-box;
+  padding: 12px 16px;
+  border-radius: 10px;
+  border: 1px solid var(--odn-color-black-5);
+  background: var(--odn-color-bg-elevated);
+}
+
+/* 写操作审参：与 Composer box 同规格 */
+[data-odn-approval][data-has-fields] {
+  flex-direction: column;
+  align-items: stretch;
+  gap: 0;
+  padding: 0;
+  border-radius: 12px;
+  border: 1px solid var(--odn-color-black-6);
+}
+
+[data-odn-approval-body] {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  min-width: 0;
+  flex: 1;
+}
+
+[data-odn-approval][data-has-fields] [data-odn-approval-body] {
+  padding: 10px;
+  flex: none;
+  gap: 6px;
+}
+
+[data-odn-approval-heading] {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  min-width: 0;
+}
+
+[data-odn-approval-text] {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  margin: 0;
+  min-width: 0;
+  font-size: 14px;
+  line-height: 1.5;
+  color: var(--odn-color-black-12);
+}
+[data-odn-approval-text] > span {
+  min-width: 0;
+}
+
+[data-odn-approval-icon] {
+  flex-shrink: 0;
+  color: var(--odn-color-black-9);
+}
+[data-odn-approval-icon][data-destructive] {
+  color: var(--odn-color-danger, #dc2626);
+}
+
+[data-odn-approval-fields] {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding-top: 0;
+}
+
+/* 灰底块包住每个叶子表单项：上下结构（标签 → 控件） */
+[data-odn-approval-field] {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 10px;
+  border-radius: 8px;
+  background: var(--odn-color-black-2);
+  box-sizing: border-box;
+}
+
+/* radio：选项间距收紧（组件默认横排 gap=24px，审批卡内过疏） */
+[data-odn-approval-field][data-control=radio] [data-odn-radio-group] {
+  --odn-radio-gap-small: 12px;
+  --odn-radio-gap-medium: 12px;
+}
+
+/* 复合分组 */
+[data-odn-approval-group],
+[data-odn-approval-list] {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 10px;
+  border-radius: 8px;
+  border: 1px solid var(--odn-color-black-4);
+  background: var(--odn-color-bg-elevated);
+  box-sizing: border-box;
+}
+
+[data-odn-approval-group-header],
+[data-odn-approval-list-header] {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
+[data-odn-approval-group-title] {
+  font-size: 12px;
+  line-height: 1.4;
+  font-weight: 600;
+  color: var(--odn-color-black-11);
+}
+
+[data-odn-approval-group-hint] {
+  font-size: 11px;
+  line-height: 1.4;
+  color: var(--odn-color-black-8);
+}
+
+[data-odn-approval-group-body],
+[data-odn-approval-list-body] {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+[data-odn-approval-list-item] {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 8px;
+  border-radius: 6px;
+  background: var(--odn-color-black-1);
+  box-sizing: border-box;
+}
+
+[data-odn-approval-list-item-meta] {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+}
+
+[data-odn-approval-list-item-index] {
+  font-size: 11px;
+  color: var(--odn-color-black-8);
+}
+
+[data-odn-approval-list-item-fields] {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+/* 嵌套组略缩进 */
+[data-odn-approval-group] [data-odn-approval-group],
+[data-odn-approval-group] [data-odn-approval-list] {
+  background: var(--odn-color-black-1);
+}
+
+[data-odn-approval-field-meta] {
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+  flex-wrap: wrap;
+  gap: 6px;
+}
+
+[data-odn-approval-field-label] {
+  font-size: 12px;
+  line-height: 1.4;
+  color: var(--odn-color-black-9);
+  font-weight: 600;
+}
+
+[data-odn-approval-field-optional] {
+  font-size: 12px;
+  font-weight: 400;
+  color: var(--odn-color-black-8);
+}
+
+[data-odn-approval-field-source] {
+  flex-shrink: 0;
+  font-size: 11px;
+  line-height: 1.4;
+  padding: 1px 6px;
+  border-radius: 4px;
+  color: var(--odn-color-black-9);
+  /* 字段已是 black-2 灰底，徽标用更深一档以免糊在一起 */
+  background: var(--odn-color-black-3);
+}
+
+[data-odn-approval-field][data-source=user] [data-odn-approval-field-source] {
+  color: var(--odn-color-brand-8);
+  background: color-mix(in srgb, var(--odn-color-brand-6) 12%, transparent);
+}
+
+[data-odn-approval-field][data-source=inferred] [data-odn-approval-field-source] {
+  color: var(--odn-color-black-10);
+  background: color-mix(in srgb, var(--odn-color-black-4) 80%, transparent);
+}
+
+[data-odn-approval-field-control] {
+  min-width: 0;
+  width: 100%;
+}
+[data-odn-approval-field-control] [data-odn-input],
+[data-odn-approval-field-control] [data-odn-input-number],
+[data-odn-approval-field-control] [data-odn-select] {
+  width: 100%;
+  box-sizing: border-box;
+}
+[data-odn-approval-field-control] {
+  /* 与 Input/Select small（约 30px）对齐；DatePicker 默认触发器是 36px */
+}
+[data-odn-approval-field-control] [data-odn-date-picker-container],
+[data-odn-approval-field-control] [data-odn-date-picker-container-range] {
+  width: 100%;
+}
+[data-odn-approval-field-control] [data-odn-date-picker-input] {
+  height: 30px;
+  font-size: 12px;
+  line-height: 1.5;
+  padding: 4px 28px 4px 12px;
+  border-radius: 6px;
+}
+
+[data-odn-approval-actions] {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  flex-shrink: 0;
+}
+
+/* 通栏分割线；下/左/右 padding 均为 10px，对齐 Composer box */
+[data-odn-approval][data-has-fields] [data-odn-approval-actions] {
+  width: 100%;
+  box-sizing: border-box;
+  margin: 0;
+  padding: 10px;
+  border-top: 1px solid var(--odn-color-black-4);
+}
+
+/**
+ * dock 挂载：与 ClarifyDock attach 同规则——
+ * 左右 16px 对齐 Composer 外层 padding，使描边与 composer-box 等宽；
+ * 与 Composer 间距 4px。
+ */
+[data-odn-approval-attach] {
+  padding-left: 16px;
+  padding-right: 16px;
+  margin-bottom: 4px;
+}
+
+/* 锁态 */
+[data-odn-approval][data-resolved=approve] {
+  border-color: color-mix(in srgb, var(--odn-color-brand-6) 35%, var(--odn-color-black-5));
+  background: color-mix(in srgb, var(--odn-color-brand-6) 8%, var(--odn-color-bg-elevated));
+}
+
+[data-odn-approval][data-resolved=reject] {
+  background: color-mix(in srgb, var(--odn-color-black-3) 60%, var(--odn-color-bg-elevated));
+}
+
+[data-odn-approval][data-resolved=approve] [data-odn-approval-icon] {
+  color: var(--odn-color-brand-6);
+}
+
+[data-odn-approval][data-resolved=approve] [data-odn-approval-resolved-main] {
+  color: var(--odn-color-brand-8);
+  font-weight: 500;
+}
+
+[data-odn-approval][data-resolved=approve] [data-odn-approval-resolved-summary] {
+  color: color-mix(in srgb, var(--odn-color-brand-7) 70%, transparent);
+}
+
+[data-odn-approval][data-resolved=reject] [data-odn-approval-resolved-main] {
+  color: var(--odn-color-black-11);
+  font-weight: 500;
+}
+
+[data-odn-approval][data-resolved=reject] [data-odn-approval-resolved-summary] {
+  color: var(--odn-color-black-9);
+}
+
+[data-odn-approval-resolved-summary] {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: 13px;
+}

package/dist/approval/style/index.d.ts

@@ -0,0 +1,2 @@
+import '../../style';
+import './index.scss';

package/dist/approval/style/index.js

@@ -0,0 +1,2 @@
+import "../../style";
+import "./index.css";

package/dist/index.d.ts

@@ -56,6 +56,7 @@ export { default as VirtualList, type VirtualListProps } from './virtual-list';
 export { default as ActionBar, type ActionBarProps } from './action-bar';
 export { default as AgentStep, type AgentStepProps, type AgentStepGroupProps } from './agent-step';
 export { default as AgentThink, type AgentThinkProps } from './agent-think';
+export { default as Approval, type ApprovalProps, type ApprovalSpec, type ApprovalDecision, type ApprovalResolvePayload, type ApprovalField, type ApprovalFieldSource, type ApprovalFieldControl, type ApprovalFieldOption, } from './approval';
 export { default as Artifact, type ArtifactProps } from './artifact';
 export { default as Attachments, type AttachmentsProps } from './attachments';
 export { default as CodeBlock, type CodeBlockProps } from './code-block';
@@ -78,4 +79,5 @@ export { default as UserBubble, type UserBubbleProps } from './user-bubble';
 export { default as Welcome, type WelcomeProps } from './welcome';
 export type { ToolCall, ToolStatus, Source, Attachment, PreviewTarget, PreviewTab, SendMeta, ComposerSegment, ComposerTextSegment, ComposerInvocationSegment, ComposerMentionSegment, TextData, InvocationData, MentionData, InlineRefState, SkillItem, SkillGroup, AgentEvent, Conversation, MessageSnapshot, ChatMessage } from './_genui-types';
 export { ComposerSegmentType } from './_genui-types';
+export type { InterruptIntent, InterruptStatus, InterruptBase, } from './_interrupt-types';
 export { rawValueToSegments, segmentsToReadableText, segmentsHasContent, isTextSegment, isInvocationSegment, isMentionSegment, type SegmentsToReadableTextOptions, } from './composer/segments';

package/dist/index.js

@@ -62,6 +62,7 @@ export { default as VirtualList } from "./virtual-list";
 export { default as ActionBar } from "./action-bar";
 export { default as AgentStep } from "./agent-step";
 export { default as AgentThink } from "./agent-think";
+export { default as Approval } from "./approval";
 export { default as Artifact } from "./artifact";
 export { default as Attachments } from "./attachments";
 export { default as CodeBlock } from "./code-block";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "one-design-next",
-  "version": "0.0.45",
+  "version": "0.0.46",
   "description": "One Design Next from TAD@tencent.com",
   "packageManager": "pnpm@11.8.0",
   "module": "dist/index.js",