@hkyhy/marsun-components-core 0.1.63 → 0.1.66

package/dist/components/Alert/Alert.d.ts

@@ -0,0 +1,28 @@
+import { CSSProperties, ReactNode } from 'react';
+export type AlertType = 'info' | 'success' | 'warning' | 'error';
+export interface MarsunAlertProps {
+    /** 语义类型，默认 info */
+    type?: AlertType;
+    /** 主文案（必填，建议 ≤2 行） */
+    message: ReactNode;
+    /** 补充说明；含可操作链接/按钮时再加 */
+    description?: ReactNode;
+    /** 是否展示左侧图标，默认 true */
+    showIcon?: boolean;
+    /** 自定义图标，优先级高于默认语义图标 */
+    icon?: ReactNode;
+    /** 右侧操作区（如按钮） */
+    action?: ReactNode;
+    /** 是否可关闭 */
+    closable?: boolean;
+    /** 关闭回调（受控关闭时由业务处理；未受控时内部隐藏） */
+    onClose?: () => void;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * 显性提示条：语义色 + 左侧强调线 + core Icons。
+ * 静态说明请用 Info + TooltipInfo，勿滥用本组件作页面常驻说明。
+ */
+declare const MarsunAlert: React.FC<MarsunAlertProps>;
+export default MarsunAlert;

package/dist/components/Alert/Alert.js

@@ -0,0 +1,74 @@
+import { jsxs as i, jsx as r } from "react/jsx-runtime";
+import e from "classnames";
+import { useState as b } from "react";
+import a from "./style.module.scss.js";
+import { X as v } from "../Icons/X.js";
+import { CircleX as z } from "../Icons/CircleX.js";
+import { CircleAlert as C } from "../Icons/CircleAlert.js";
+import { CircleCheck as g } from "../Icons/CircleCheck.js";
+import { Info as x } from "../Icons/Info.js";
+const A = {
+  info: /* @__PURE__ */ r(x, { size: 16, "aria-hidden": !0 }),
+  success: /* @__PURE__ */ r(g, { size: 16, "aria-hidden": !0 }),
+  warning: /* @__PURE__ */ r(C, { size: 16, "aria-hidden": !0 }),
+  error: /* @__PURE__ */ r(z, { size: 16, "aria-hidden": !0 })
+}, F = ({
+  type: s = "info",
+  message: m,
+  description: l,
+  showIcon: u = !0,
+  icon: o,
+  action: n,
+  closable: c = !1,
+  onClose: t,
+  className: d,
+  style: f
+}) => {
+  const [h, p] = b(!1);
+  if (h) return null;
+  const N = () => {
+    t == null || t(), p(!0);
+  };
+  return /* @__PURE__ */ i(
+    "div",
+    {
+      role: "alert",
+      className: e(
+        "marsun-alert",
+        a["marsun-alert"],
+        `marsun-alert--${s}`,
+        a[`marsun-alert--${s}`],
+        d
+      ),
+      style: f,
+      children: [
+        u ? /* @__PURE__ */ r("span", { className: e("marsun-alert-icon", a["marsun-alert-icon"]), "aria-hidden": !0, children: o ?? A[s] }) : null,
+        /* @__PURE__ */ i("div", { className: e("marsun-alert-body", a["marsun-alert-body"]), children: [
+          /* @__PURE__ */ r("div", { className: e("marsun-alert-message", a["marsun-alert-message"]), children: m }),
+          l != null && l !== !1 ? /* @__PURE__ */ r(
+            "div",
+            {
+              className: e("marsun-alert-description", a["marsun-alert-description"]),
+              children: l
+            }
+          ) : null
+        ] }),
+        n ? /* @__PURE__ */ r("div", { className: e("marsun-alert-action", a["marsun-alert-action"]), children: n }) : null,
+        c ? /* @__PURE__ */ r(
+          "button",
+          {
+            type: "button",
+            className: e("marsun-alert-close", a["marsun-alert-close"]),
+            "aria-label": "关闭",
+            onClick: N,
+            children: /* @__PURE__ */ r(v, { size: 14 })
+          }
+        ) : null
+      ]
+    }
+  );
+};
+export {
+  F as default
+};
+//# sourceMappingURL=Alert.js.map

package/dist/components/Alert/Alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alert.js","sources":["../../../src/components/Alert/Alert.tsx"],"sourcesContent":["import classNames from 'classnames';\nimport type { CSSProperties, ReactNode } from 'react';\nimport { useState } from 'react';\nimport { CircleAlert, CircleCheck, CircleX, Info, X } from '../Icons';\nimport styles from './style.module.scss';\n\nexport type AlertType = 'info' | 'success' | 'warning' | 'error';\n\nexport interface MarsunAlertProps {\n  /** 语义类型，默认 info */\n  type?: AlertType;\n  /** 主文案（必填，建议 ≤2 行） */\n  message: ReactNode;\n  /** 补充说明；含可操作链接/按钮时再加 */\n  description?: ReactNode;\n  /** 是否展示左侧图标，默认 true */\n  showIcon?: boolean;\n  /** 自定义图标，优先级高于默认语义图标 */\n  icon?: ReactNode;\n  /** 右侧操作区（如按钮） */\n  action?: ReactNode;\n  /** 是否可关闭 */\n  closable?: boolean;\n  /** 关闭回调（受控关闭时由业务处理；未受控时内部隐藏） */\n  onClose?: () => void;\n  className?: string;\n  style?: CSSProperties;\n}\n\nconst DEFAULT_ICON: Record<AlertType, ReactNode> = {\n  info: <Info size={16} aria-hidden />,\n  success: <CircleCheck size={16} aria-hidden />,\n  warning: <CircleAlert size={16} aria-hidden />,\n  error: <CircleX size={16} aria-hidden />,\n};\n\n/**\n * 显性提示条：语义色 + 左侧强调线 + core Icons。\n * 静态说明请用 Info + TooltipInfo，勿滥用本组件作页面常驻说明。\n */\nconst MarsunAlert: React.FC<MarsunAlertProps> = ({\n  type = 'info',\n  message,\n  description,\n  showIcon = true,\n  icon,\n  action,\n  closable = false,\n  onClose,\n  className,\n  style,\n}) => {\n  const [closed, setClosed] = useState(false);\n  if (closed) return null;\n\n  const handleClose = () => {\n    onClose?.();\n    setClosed(true);\n  };\n\n  return (\n    <div\n      role=\"alert\"\n      className={classNames(\n        'marsun-alert',\n        styles['marsun-alert'],\n        `marsun-alert--${type}`,\n        styles[`marsun-alert--${type}`],\n        className,\n      )}\n      style={style}\n    >\n      {showIcon ? (\n        <span className={classNames('marsun-alert-icon', styles['marsun-alert-icon'])} aria-hidden>\n          {icon ?? DEFAULT_ICON[type]}\n        </span>\n      ) : null}\n      <div className={classNames('marsun-alert-body', styles['marsun-alert-body'])}>\n        <div className={classNames('marsun-alert-message', styles['marsun-alert-message'])}>\n          {message}\n        </div>\n        {description != null && description !== false ? (\n          <div\n            className={classNames('marsun-alert-description', styles['marsun-alert-description'])}\n          >\n            {description}\n          </div>\n        ) : null}\n      </div>\n      {action ? (\n        <div className={classNames('marsun-alert-action', styles['marsun-alert-action'])}>\n          {action}\n        </div>\n      ) : null}\n      {closable ? (\n        <button\n          type=\"button\"\n          className={classNames('marsun-alert-close', styles['marsun-alert-close'])}\n          aria-label=\"关闭\"\n          onClick={handleClose}\n        >\n          <X size={14} />\n        </button>\n      ) : null}\n    </div>\n  );\n};\n\nexport default MarsunAlert;\n"],"names":["DEFAULT_ICON","jsx","Info","CircleCheck","CircleAlert","CircleX","MarsunAlert","type","message","description","showIcon","icon","action","closable","onClose","className","style","closed","setClosed","useState","handleClose","jsxs","classNames","styles","X"],"mappings":";;;;;;;;;AA6BA,MAAMA,IAA6C;AAAA,EACjD,MAAM,gBAAAC,EAACC,GAAA,EAAK,MAAM,IAAI,eAAW,IAAC;AAAA,EAClC,SAAS,gBAAAD,EAACE,GAAA,EAAY,MAAM,IAAI,eAAW,IAAC;AAAA,EAC5C,SAAS,gBAAAF,EAACG,GAAA,EAAY,MAAM,IAAI,eAAW,IAAC;AAAA,EAC5C,OAAO,gBAAAH,EAACI,GAAA,EAAQ,MAAM,IAAI,eAAW,GAAA,CAAC;AACxC,GAMMC,IAA0C,CAAC;AAAA,EAC/C,MAAAC,IAAO;AAAA,EACP,SAAAC;AAAA,EACA,aAAAC;AAAA,EACA,UAAAC,IAAW;AAAA,EACX,MAAAC;AAAA,EACA,QAAAC;AAAA,EACA,UAAAC,IAAW;AAAA,EACX,SAAAC;AAAA,EACA,WAAAC;AAAA,EACA,OAAAC;AACF,MAAM;AACJ,QAAM,CAACC,GAAQC,CAAS,IAAIC,EAAS,EAAK;AAC1C,MAAIF,EAAQ,QAAO;AAEnB,QAAMG,IAAc,MAAM;AACxB,IAAAN,KAAA,QAAAA,KACAI,EAAU,EAAI;AAAA,EAChB;AAEA,SACE,gBAAAG;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,WAAWC;AAAA,QACT;AAAA,QACAC,EAAO,cAAc;AAAA,QACrB,iBAAiBhB,CAAI;AAAA,QACrBgB,EAAO,iBAAiBhB,CAAI,EAAE;AAAA,QAC9BQ;AAAA,MAAA;AAAA,MAEF,OAAAC;AAAA,MAEC,UAAA;AAAA,QAAAN,IACC,gBAAAT,EAAC,QAAA,EAAK,WAAWqB,EAAW,qBAAqBC,EAAO,mBAAmB,CAAC,GAAG,eAAW,IACvF,UAAAZ,KAAQX,EAAaO,CAAI,GAC5B,IACE;AAAA,QACJ,gBAAAc,EAAC,SAAI,WAAWC,EAAW,qBAAqBC,EAAO,mBAAmB,CAAC,GACzE,UAAA;AAAA,UAAA,gBAAAtB,EAAC,OAAA,EAAI,WAAWqB,EAAW,wBAAwBC,EAAO,sBAAsB,CAAC,GAC9E,UAAAf,EAAA,CACH;AAAA,UACCC,KAAe,QAAQA,MAAgB,KACtC,gBAAAR;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,WAAWqB,EAAW,4BAA4BC,EAAO,0BAA0B,CAAC;AAAA,cAEnF,UAAAd;AAAA,YAAA;AAAA,UAAA,IAED;AAAA,QAAA,GACN;AAAA,QACCG,IACC,gBAAAX,EAAC,OAAA,EAAI,WAAWqB,EAAW,uBAAuBC,EAAO,qBAAqB,CAAC,GAC5E,UAAAX,EAAA,CACH,IACE;AAAA,QACHC,IACC,gBAAAZ;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,MAAK;AAAA,YACL,WAAWqB,EAAW,sBAAsBC,EAAO,oBAAoB,CAAC;AAAA,YACxE,cAAW;AAAA,YACX,SAASH;AAAA,YAET,UAAA,gBAAAnB,EAACuB,GAAA,EAAE,MAAM,GAAA,CAAI;AAAA,UAAA;AAAA,QAAA,IAEb;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGV;"}

package/dist/components/Alert/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Alert } from './Alert';
+export type { MarsunAlertProps, AlertType } from './Alert';

package/dist/components/Alert/style.module.scss.js

@@ -0,0 +1,17 @@
+const a = {
+  "marsun-alert": "_marsun-alert_dsoal_1",
+  "marsun-alert-icon": "_marsun-alert-icon_dsoal_13",
+  "marsun-alert-body": "_marsun-alert-body_dsoal_23",
+  "marsun-alert-message": "_marsun-alert-message_dsoal_29",
+  "marsun-alert-description": "_marsun-alert-description_dsoal_36",
+  "marsun-alert-action": "_marsun-alert-action_dsoal_44",
+  "marsun-alert-close": "_marsun-alert-close_dsoal_50",
+  "marsun-alert--info": "_marsun-alert--info_dsoal_70",
+  "marsun-alert--success": "_marsun-alert--success_dsoal_78",
+  "marsun-alert--warning": "_marsun-alert--warning_dsoal_86",
+  "marsun-alert--error": "_marsun-alert--error_dsoal_94"
+};
+export {
+  a as default
+};
+//# sourceMappingURL=style.module.scss.js.map

package/dist/components/Alert/style.module.scss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.module.scss.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/components/Form/index.d.ts

@@ -11,6 +11,7 @@ export type { FormDataSyncProps } from './FormDataSync';
 /** @kne/form-info — 业务从包根导入，勿直连 @kne/form-info */
 export { FormInfo, Form, FormModal, FormSteps, FormStepsModal, List, TableList, MultiField, Input, TextArea, Select, TreeSelect, InputNumber, Switch, RadioGroup, SubmitButton, ResetButton, CancelButton, } from './kneFormInfo';
 export type { FormInfoProps, FormProps, FormModalProps, FormStepsProps, FormStepsModalProps, ListProps, TableListProps, MultiFieldProps, } from './kneFormInfo';
+export { normalizeLabelTips, withNormalizedLabelTips } from './normalizeLabelTips';
 /** @kne/react-form — 引擎 API；默认组件为 ReactForm（勿与 FormInfo 的 Form 混淆） */
 export { ReactForm, GroupList, useField, useFormApi, useFormContext, useGroup, useSubmit, useReset, RULES, preset, interceptors, compileErrMsg, computedFieldValueFromFormData, computedFormDataFormState, filterEmpty, findField, formUtils, isEmpty, isNotEmpty, matchFields, stateToError, stateToIsPass, } from './kneReactForm';
 export type { GroupListRenderProps } from './kneReactForm';

package/dist/components/Form/kneFormInfo.d.ts

@@ -3,6 +3,8 @@ import { ComponentType, FC, ReactNode } from 'react';
 type FieldProps = {
     name: string;
     label?: ReactNode;
+    /** 字符串自动变 Info 悬停；也可传 ReactNode / (props)=>ReactNode 自定义 */
+    labelTips?: ReactNode | ((props: FieldProps) => ReactNode);
     rule?: string;
     placeholder?: string;
     disabled?: boolean;
@@ -37,7 +39,10 @@ export declare const TableList: FC<Omit<TableListProps, "itemTitle"> & {
     itemTitle?: (ctx: ItemTitleCtx) => string;
 }>;
 export declare const MultiField: FC<MultiFieldProps>;
-export declare const Input: ComponentType<FieldProps>;
+type KneInputType = ComponentType<FieldProps> & {
+    Password: ComponentType<FieldProps>;
+};
+export declare const Input: KneInputType;
 export declare const TextArea: ComponentType<FieldProps>;
 export declare const Select: ComponentType<FieldProps>;
 export declare const TreeSelect: ComponentType<FieldProps>;
@@ -47,3 +52,4 @@ export declare const RadioGroup: ComponentType<FieldProps>;
 export declare const SubmitButton: ComponentType<ButtonProps>;
 export declare const ResetButton: ComponentType<ButtonProps>;
 export declare const CancelButton: ComponentType<ButtonProps>;
+export { normalizeLabelTips, withNormalizedLabelTips } from './normalizeLabelTips';

package/dist/components/Form/kneFormInfo.js

@@ -1,25 +1,43 @@
 /* empty css                                               */
-import t, { Form as o, FormModal as s, FormSteps as e, FormStepsModal as n, List as a, MultiField as r, TableList as c } from "@kne/form-info";
-import { CancelButton as u, Input as m, InputNumber as i, RadioGroup as l, ResetButton as p, Select as S, SubmitButton as F, Switch as $, TextArea as d, TreeSelect as B } from "@kne/react-form-antd";
-const I = t, L = o, R = s, f = e, x = n, h = a, w = c, A = r, C = m, G = d, N = S, g = B, j = i, k = $, q = l, v = F, y = p, z = u;
+import s, { Form as e, FormModal as n, FormSteps as a, FormStepsModal as r, List as c, MultiField as i, TableList as m } from "@kne/form-info";
+import { CancelButton as u, ResetButton as l, SubmitButton as p, Input as S, TextArea as d, Select as F, TreeSelect as $, InputNumber as b, Switch as T, RadioGroup as B } from "@kne/react-form-antd";
+import { withNormalizedLabelTips as t } from "./normalizeLabelTips.js";
+import { normalizeLabelTips as H } from "./normalizeLabelTips.js";
+const R = s, x = e, h = n, N = a, A = r, C = c, G = m, z = i, o = S, I = t(o), P = Object.assign(I, {
+  Password: t(o.Password)
+}), g = t(
+  d
+), j = t(
+  F
+), y = t(
+  $
+), K = t(
+  b
+), O = t(
+  T
+), W = t(
+  B
+), k = p, q = l, v = u;
 export {
-  z as CancelButton,
-  L as Form,
-  I as FormInfo,
-  R as FormModal,
-  f as FormSteps,
-  x as FormStepsModal,
-  C as Input,
-  j as InputNumber,
-  h as List,
-  A as MultiField,
-  q as RadioGroup,
-  y as ResetButton,
-  N as Select,
-  v as SubmitButton,
-  k as Switch,
-  w as TableList,
-  G as TextArea,
-  g as TreeSelect
+  v as CancelButton,
+  x as Form,
+  R as FormInfo,
+  h as FormModal,
+  N as FormSteps,
+  A as FormStepsModal,
+  P as Input,
+  K as InputNumber,
+  C as List,
+  z as MultiField,
+  W as RadioGroup,
+  q as ResetButton,
+  j as Select,
+  k as SubmitButton,
+  O as Switch,
+  G as TableList,
+  g as TextArea,
+  y as TreeSelect,
+  H as normalizeLabelTips,
+  t as withNormalizedLabelTips
 };
 //# sourceMappingURL=kneFormInfo.js.map

package/dist/components/Form/kneFormInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"kneFormInfo.js","sources":["../../../src/components/Form/kneFormInfo.ts"],"sourcesContent":["/**\n * 经 core 再导出 @kne/form-info（业务唯一入口）。\n * 布局组件来自 @kne/form-info；字段组件须从 @kne/react-form-antd 具名导入\n * （form-info 的 `export *` 在 Vite 下经 namespace 读取时常为 undefined）。\n */\nimport '@kne/form-info/dist/index.css';\nimport FormInfoBase, {\n  Form as KneForm,\n  FormModal as KneFormModal,\n  FormSteps as KneFormSteps,\n  FormStepsModal as KneFormStepsModal,\n  List as KneList,\n  MultiField as KneMultiField,\n  TableList as KneTableList,\n  type FormModalProps,\n  type FormProps,\n  type FormStepsModalProps,\n  type FormStepsProps,\n  type ListProps,\n  type MultiFieldProps,\n  type TableListProps,\n  type FormInfoProps,\n} from '@kne/form-info';\nimport {\n  CancelButton as KneCancelButton,\n  Input as KneInput,\n  InputNumber as KneInputNumber,\n  RadioGroup as KneRadioGroup,\n  ResetButton as KneResetButton,\n  Select as KneSelect,\n  SubmitButton as KneSubmitButton,\n  Switch as KneSwitch,\n  TextArea as KneTextArea,\n  TreeSelect as KneTreeSelect,\n} from '@kne/react-form-antd';\nimport type { ComponentType, FC, ReactNode } from 'react';\n\ntype FieldProps = {\n  name: string;\n  label?: ReactNode;\n  rule?: string;\n  placeholder?: string;\n  disabled?: boolean;\n  block?: boolean;\n  rows?: number;\n  options?: unknown[];\n  [key: string]: unknown;\n};\n\ntype ButtonProps = {\n  children?: ReactNode;\n  type?: string;\n  loading?: boolean;\n  [key: string]: unknown;\n};\n\ntype ItemTitleCtx = { index: number; data?: Record<string, unknown> };\n\nexport type {\n  FormInfoProps,\n  FormProps,\n  FormModalProps,\n  FormStepsProps,\n  FormStepsModalProps,\n  ListProps,\n  TableListProps,\n  MultiFieldProps,\n};\n\nexport const FormInfo = FormInfoBase;\nexport const Form = KneForm;\nexport const FormModal = KneFormModal as FC<FormModalProps & { children?: ReactNode }>;\nexport const FormSteps = KneFormSteps as FC<FormStepsProps>;\nexport const FormStepsModal = KneFormStepsModal as FC<FormStepsModalProps>;\n\nexport const List = KneList as FC<\n  Omit<ListProps, 'itemTitle'> & {\n    maxLength?: number;\n    itemTitle?: (ctx: ItemTitleCtx) => string;\n  }\n>;\nexport const TableList = KneTableList as FC<\n  Omit<TableListProps, 'itemTitle'> & {\n    itemTitle?: (ctx: ItemTitleCtx) => string;\n  }\n>;\nexport const MultiField = KneMultiField as FC<MultiFieldProps>;\n\nexport const Input = KneInput as ComponentType<FieldProps>;\nexport const TextArea = KneTextArea as ComponentType<FieldProps>;\nexport const Select = KneSelect as ComponentType<FieldProps>;\nexport const TreeSelect = KneTreeSelect as ComponentType<FieldProps>;\nexport const InputNumber = KneInputNumber as ComponentType<FieldProps>;\nexport const Switch = KneSwitch as ComponentType<FieldProps>;\nexport const RadioGroup = KneRadioGroup as ComponentType<FieldProps>;\nexport const SubmitButton = KneSubmitButton as ComponentType<ButtonProps>;\nexport const ResetButton = KneResetButton as ComponentType<ButtonProps>;\nexport const CancelButton = KneCancelButton as ComponentType<ButtonProps>;\n"],"names":["FormInfo","FormInfoBase","Form","KneForm","FormModal","KneFormModal","FormSteps","KneFormSteps","FormStepsModal","KneFormStepsModal","List","KneList","TableList","KneTableList","MultiField","KneMultiField","Input","KneInput","TextArea","KneTextArea","Select","KneSelect","TreeSelect","KneTreeSelect","InputNumber","KneInputNumber","Switch","KneSwitch","RadioGroup","KneRadioGroup","SubmitButton","KneSubmitButton","ResetButton","KneResetButton","CancelButton","KneCancelButton"],"mappings":";;;AAqEO,MAAMA,IAAWC,GACXC,IAAOC,GACPC,IAAYC,GACZC,IAAYC,GACZC,IAAiBC,GAEjBC,IAAOC,GAMPC,IAAYC,GAKZC,IAAaC,GAEbC,IAAQC,GACRC,IAAWC,GACXC,IAASC,GACTC,IAAaC,GACbC,IAAcC,GACdC,IAASC,GACTC,IAAaC,GACbC,IAAeC,GACfC,IAAcC,GACdC,IAAeC;"}
+{"version":3,"file":"kneFormInfo.js","sources":["../../../src/components/Form/kneFormInfo.ts"],"sourcesContent":["/**\n * 经 core 再导出 @kne/form-info（业务唯一入口）。\n * 布局组件来自 @kne/form-info；字段组件须从 @kne/react-form-antd 具名导入\n * （form-info 的 `export *` 在 Vite 下经 namespace 读取时常为 undefined）。\n *\n * 字段 `labelTips`：字符串由 {@link withNormalizedLabelTips} 统一包成 Info+TooltipInfo。\n */\nimport '@kne/form-info/dist/index.css';\nimport FormInfoBase, {\n  Form as KneForm,\n  FormModal as KneFormModal,\n  FormSteps as KneFormSteps,\n  FormStepsModal as KneFormStepsModal,\n  List as KneList,\n  MultiField as KneMultiField,\n  TableList as KneTableList,\n  type FormModalProps,\n  type FormProps,\n  type FormStepsModalProps,\n  type FormStepsProps,\n  type ListProps,\n  type MultiFieldProps,\n  type TableListProps,\n  type FormInfoProps,\n} from '@kne/form-info';\nimport {\n  CancelButton as KneCancelButton,\n  Input as KneInput,\n  InputNumber as KneInputNumber,\n  RadioGroup as KneRadioGroup,\n  ResetButton as KneResetButton,\n  Select as KneSelect,\n  SubmitButton as KneSubmitButton,\n  Switch as KneSwitch,\n  TextArea as KneTextArea,\n  TreeSelect as KneTreeSelect,\n} from '@kne/react-form-antd';\nimport type { ComponentType, FC, ReactNode } from 'react';\nimport { withNormalizedLabelTips } from './normalizeLabelTips';\n\ntype FieldProps = {\n  name: string;\n  label?: ReactNode;\n  /** 字符串自动变 Info 悬停；也可传 ReactNode / (props)=>ReactNode 自定义 */\n  labelTips?: ReactNode | ((props: FieldProps) => ReactNode);\n  rule?: string;\n  placeholder?: string;\n  disabled?: boolean;\n  block?: boolean;\n  rows?: number;\n  options?: unknown[];\n  [key: string]: unknown;\n};\n\ntype ButtonProps = {\n  children?: ReactNode;\n  type?: string;\n  loading?: boolean;\n  [key: string]: unknown;\n};\n\ntype ItemTitleCtx = { index: number; data?: Record<string, unknown> };\n\nexport type {\n  FormInfoProps,\n  FormProps,\n  FormModalProps,\n  FormStepsProps,\n  FormStepsModalProps,\n  ListProps,\n  TableListProps,\n  MultiFieldProps,\n};\n\nexport const FormInfo = FormInfoBase;\nexport const Form = KneForm;\nexport const FormModal = KneFormModal as FC<FormModalProps & { children?: ReactNode }>;\nexport const FormSteps = KneFormSteps as FC<FormStepsProps>;\nexport const FormStepsModal = KneFormStepsModal as FC<FormStepsModalProps>;\n\nexport const List = KneList as FC<\n  Omit<ListProps, 'itemTitle'> & {\n    maxLength?: number;\n    itemTitle?: (ctx: ItemTitleCtx) => string;\n  }\n>;\nexport const TableList = KneTableList as FC<\n  Omit<TableListProps, 'itemTitle'> & {\n    itemTitle?: (ctx: ItemTitleCtx) => string;\n  }\n>;\nexport const MultiField = KneMultiField as FC<MultiFieldProps>;\n\ntype KneInputType = ComponentType<FieldProps> & { Password: ComponentType<FieldProps> };\nconst KneInputTyped = KneInput as unknown as KneInputType;\nconst InputWrapped = withNormalizedLabelTips(KneInputTyped);\nexport const Input = Object.assign(InputWrapped, {\n  Password: withNormalizedLabelTips(KneInputTyped.Password),\n}) as KneInputType;\n\nexport const TextArea = withNormalizedLabelTips(\n  KneTextArea as ComponentType<FieldProps>,\n) as ComponentType<FieldProps>;\nexport const Select = withNormalizedLabelTips(\n  KneSelect as ComponentType<FieldProps>,\n) as ComponentType<FieldProps>;\nexport const TreeSelect = withNormalizedLabelTips(\n  KneTreeSelect as ComponentType<FieldProps>,\n) as ComponentType<FieldProps>;\nexport const InputNumber = withNormalizedLabelTips(\n  KneInputNumber as ComponentType<FieldProps>,\n) as ComponentType<FieldProps>;\nexport const Switch = withNormalizedLabelTips(\n  KneSwitch as ComponentType<FieldProps>,\n) as ComponentType<FieldProps>;\nexport const RadioGroup = withNormalizedLabelTips(\n  KneRadioGroup as ComponentType<FieldProps>,\n) as ComponentType<FieldProps>;\n\nexport const SubmitButton = KneSubmitButton as ComponentType<ButtonProps>;\nexport const ResetButton = KneResetButton as ComponentType<ButtonProps>;\nexport const CancelButton = KneCancelButton as ComponentType<ButtonProps>;\n\nexport { normalizeLabelTips, withNormalizedLabelTips } from './normalizeLabelTips';\n"],"names":["FormInfo","FormInfoBase","Form","KneForm","FormModal","KneFormModal","FormSteps","KneFormSteps","FormStepsModal","KneFormStepsModal","List","KneList","TableList","KneTableList","MultiField","KneMultiField","KneInputTyped","KneInput","InputWrapped","withNormalizedLabelTips","Input","TextArea","KneTextArea","Select","KneSelect","TreeSelect","KneTreeSelect","InputNumber","KneInputNumber","Switch","KneSwitch","RadioGroup","KneRadioGroup","SubmitButton","KneSubmitButton","ResetButton","KneResetButton","CancelButton","KneCancelButton"],"mappings":";;;;;AA0EO,MAAMA,IAAWC,GACXC,IAAOC,GACPC,IAAYC,GACZC,IAAYC,GACZC,IAAiBC,GAEjBC,IAAOC,GAMPC,IAAYC,GAKZC,IAAaC,GAGpBC,IAAgBC,GAChBC,IAAeC,EAAwBH,CAAa,GAC7CI,IAAQ,OAAO,OAAOF,GAAc;AAAA,EAC/C,UAAUC,EAAwBH,EAAc,QAAQ;AAC1D,CAAC,GAEYK,IAAWF;AAAA,EACtBG;AACF,GACaC,IAASJ;AAAA,EACpBK;AACF,GACaC,IAAaN;AAAA,EACxBO;AACF,GACaC,IAAcR;AAAA,EACzBS;AACF,GACaC,IAASV;AAAA,EACpBW;AACF,GACaC,IAAaZ;AAAA,EACxBa;AACF,GAEaC,IAAeC,GACfC,IAAcC,GACdC,IAAeC;"}

package/dist/components/Form/normalizeLabelTips.d.ts

@@ -0,0 +1,14 @@
+import { ComponentType, ReactNode } from 'react';
+/**
+ * kne 原生会把字符串 `labelTips` 直接拼进 label 旁正文。
+ * core 约定：字符串 / 数字 → Info + TooltipInfo（悬停说明）；
+ * 已是 ReactNode / function → 原样透传（业务可自定义）。
+ * 必填仍用 `rule="REQ"`，不要把「必填/选填」写进 tip。
+ */
+export declare function normalizeLabelTips(labelTips: unknown): ReactNode | undefined;
+type WithLabelTips = {
+    labelTips?: unknown;
+};
+/** 包装 kne 字段：拦截 labelTips 字符串并规范化 */
+export declare function withNormalizedLabelTips<P extends WithLabelTips>(Comp: ComponentType<P>): ComponentType<P>;
+export {};

package/dist/components/Form/normalizeLabelTips.js

@@ -0,0 +1,40 @@
+import { jsx as r } from "react/jsx-runtime";
+import s from "../TooltipInfo/TooltipInfo.js";
+import { Info as f } from "../Icons/Info.js";
+function l(t) {
+  if (!(t == null || t === !1)) {
+    if (typeof t == "string" || typeof t == "number") {
+      const i = String(t).trim();
+      return i ? /* @__PURE__ */ r(
+        s,
+        {
+          type: "note",
+          note: { title: "说明", description: i },
+          minWidth: 220,
+          maxWidth: 360,
+          children: /* @__PURE__ */ r(
+            f,
+            {
+              size: 14,
+              "aria-label": "说明",
+              style: { marginLeft: 4, cursor: "pointer", verticalAlign: "-2px" }
+            }
+          )
+        }
+      ) : void 0;
+    }
+    return t;
+  }
+}
+function u(t) {
+  const i = (o) => {
+    const { labelTips: a, ...m } = o, e = l(a);
+    return /* @__PURE__ */ r(t, { ...m, ...e !== void 0 ? { labelTips: e } : {} });
+  }, n = t.displayName || t.name || "Field";
+  return i.displayName = `WithNormalizedLabelTips(${n})`, i;
+}
+export {
+  l as normalizeLabelTips,
+  u as withNormalizedLabelTips
+};
+//# sourceMappingURL=normalizeLabelTips.js.map

package/dist/components/Form/normalizeLabelTips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeLabelTips.js","sources":["../../../src/components/Form/normalizeLabelTips.tsx"],"sourcesContent":["import type { ComponentType, ReactNode } from 'react';\nimport { Info } from '@/components/Icons';\nimport { TooltipInfo } from '@/components/TooltipInfo';\n\n/**\n * kne 原生会把字符串 `labelTips` 直接拼进 label 旁正文。\n * core 约定：字符串 / 数字 → Info + TooltipInfo（悬停说明）；\n * 已是 ReactNode / function → 原样透传（业务可自定义）。\n * 必填仍用 `rule=\"REQ\"`，不要把「必填/选填」写进 tip。\n */\nexport function normalizeLabelTips(labelTips: unknown): ReactNode | undefined {\n  if (labelTips == null || labelTips === false) {\n    return undefined;\n  }\n  if (typeof labelTips === 'string' || typeof labelTips === 'number') {\n    const text = String(labelTips).trim();\n    if (!text) {\n      return undefined;\n    }\n    return (\n      <TooltipInfo\n        type=\"note\"\n        note={{ title: '说明', description: text }}\n        minWidth={220}\n        maxWidth={360}\n      >\n        <Info\n          size={14}\n          aria-label=\"说明\"\n          style={{ marginLeft: 4, cursor: 'pointer', verticalAlign: '-2px' }}\n        />\n      </TooltipInfo>\n    );\n  }\n  return labelTips as ReactNode;\n}\n\ntype WithLabelTips = { labelTips?: unknown };\n\n/** 包装 kne 字段：拦截 labelTips 字符串并规范化 */\nexport function withNormalizedLabelTips<P extends WithLabelTips>(\n  Comp: ComponentType<P>,\n): ComponentType<P> {\n  const Wrapped = (props: P) => {\n    const { labelTips, ...rest } = props;\n    const next = normalizeLabelTips(labelTips);\n    return <Comp {...(rest as P)} {...(next !== undefined ? { labelTips: next } : {})} />;\n  };\n  const name = Comp.displayName || Comp.name || 'Field';\n  Wrapped.displayName = `WithNormalizedLabelTips(${name})`;\n  return Wrapped;\n}\n"],"names":["normalizeLabelTips","labelTips","text","jsx","TooltipInfo","Info","withNormalizedLabelTips","Comp","Wrapped","props","rest","next","name"],"mappings":";;;AAUO,SAASA,EAAmBC,GAA2C;AAC5E,MAAI,EAAAA,KAAa,QAAQA,MAAc,KAGvC;AAAA,QAAI,OAAOA,KAAc,YAAY,OAAOA,KAAc,UAAU;AAClE,YAAMC,IAAO,OAAOD,CAAS,EAAE,KAAA;AAC/B,aAAKC,IAIH,gBAAAC;AAAA,QAACC;AAAA,QAAA;AAAA,UACC,MAAK;AAAA,UACL,MAAM,EAAE,OAAO,MAAM,aAAaF,EAAA;AAAA,UAClC,UAAU;AAAA,UACV,UAAU;AAAA,UAEV,UAAA,gBAAAC;AAAA,YAACE;AAAA,YAAA;AAAA,cACC,MAAM;AAAA,cACN,cAAW;AAAA,cACX,OAAO,EAAE,YAAY,GAAG,QAAQ,WAAW,eAAe,OAAA;AAAA,YAAO;AAAA,UAAA;AAAA,QACnE;AAAA,MAAA,IAbF;AAAA,IAgBJ;AACA,WAAOJ;AAAA;AACT;AAKO,SAASK,EACdC,GACkB;AAClB,QAAMC,IAAU,CAACC,MAAa;AAC5B,UAAM,EAAE,WAAAR,GAAW,GAAGS,EAAA,IAASD,GACzBE,IAAOX,EAAmBC,CAAS;AACzC,WAAO,gBAAAE,EAACI,GAAA,EAAM,GAAIG,GAAa,GAAIC,MAAS,SAAY,EAAE,WAAWA,EAAA,IAAS,CAAA,EAAC,CAAI;AAAA,EACrF,GACMC,IAAOL,EAAK,eAAeA,EAAK,QAAQ;AAC9C,SAAAC,EAAQ,cAAc,2BAA2BI,CAAI,KAC9CJ;AACT;"}

package/dist/components/Layout/ModulePageShell/index.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { PageShellActionItem } from '../PageShell';
 export type ModulePageShellProps = {
     title?: string;
     description?: ReactNode;
@@ -8,7 +9,7 @@ export type ModulePageShellProps = {
     spinning?: boolean;
     /** 是否同步 title/description/actions 到 PageShellProvider（App 顶栏），默认 true */
     syncPageMeta?: boolean;
-    actions?: Record<string, unknown>[];
+    actions?: PageShellActionItem[];
     children?: ReactNode;
     className?: string;
     bodyClassName?: string;

package/dist/components/Layout/ModulePageShell/index.js

@@ -27,13 +27,7 @@ const w = ({
   }, [m, r, i, n, a]), /* @__PURE__ */ h("div", { className: l("module-page-shell", o["module-page-shell"], t), children: [
     s ? /* @__PURE__ */ e("div", { className: l("module-page-breadcrumb", o["module-page-breadcrumb"]), children: s }) : null,
     d ? /* @__PURE__ */ e("div", { className: l("module-page-toolbar", o["module-page-toolbar"]), children: d }) : null,
-    /* @__PURE__ */ e(
-      "div",
-      {
-        className: l("module-page-body", o["module-page-body"], g),
-        children: /* @__PURE__ */ e(N, { spinning: f, children: p })
-      }
-    )
+    /* @__PURE__ */ e("div", { className: l("module-page-body", o["module-page-body"], g), children: /* @__PURE__ */ e(N, { spinning: f, children: p }) })
   ] });
 };
 export {

package/dist/components/Layout/ModulePageShell/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/components/Layout/ModulePageShell/index.tsx"],"sourcesContent":["import classNames from 'classnames';\nimport type { ReactNode } from 'react';\nimport { useEffect } from 'react';\nimport PageSpin from '../PageSpin';\nimport { usePageShell } from '../PageShell';\nimport styles from './style.module.scss';\n\nexport type ModulePageShellProps = {\n  title?: string;\n  description?: ReactNode;\n  breadcrumb?: ReactNode;\n  toolbar?: ReactNode;\n  /** 页面级 loading，与 usePageShellLoading 注册的 ctx loading 合并 */\n  spinning?: boolean;\n  /** 是否同步 title/description/actions 到 PageShellProvider（App 顶栏），默认 true */\n  syncPageMeta?: boolean;\n  actions?: Record<string, unknown>[];\n  children?: ReactNode;\n  className?: string;\n  bodyClassName?: string;\n};\n\nconst ModulePageShell: React.FC<ModulePageShellProps> = ({\n  title,\n  description,\n  breadcrumb,\n  toolbar,\n  spinning = false,\n  syncPageMeta = true,\n  actions,\n  children,\n  className,\n  bodyClassName,\n}) => {\n  const { setPageMeta, pageLoading: ctxLoading } = usePageShell();\n  const showSpinning = Boolean(spinning || ctxLoading);\n\n  useEffect(() => {\n    if (!syncPageMeta) return;\n    setPageMeta({\n      title,\n      description,\n      actionItems: actions,\n    });\n    return () => setPageMeta({});\n  }, [title, description, actions, syncPageMeta, setPageMeta]);\n\n  return (\n    <div className={classNames('module-page-shell', styles['module-page-shell'], className)}>\n      {breadcrumb ? (\n        <div className={classNames('module-page-breadcrumb', styles['module-page-breadcrumb'])}>\n          {breadcrumb}\n        </div>\n      ) : null}\n\n      {toolbar ? (\n        <div className={classNames('module-page-toolbar', styles['module-page-toolbar'])}>\n          {toolbar}\n        </div>\n      ) : null}\n\n      <div\n        className={classNames('module-page-body', styles['module-page-body'], bodyClassName)}\n      >\n        <PageSpin spinning={showSpinning}>{children}</PageSpin>\n      </div>\n    </div>\n  );\n};\n\nexport default ModulePageShell;\n"],"names":["ModulePageShell","title","description","breadcrumb","toolbar","spinning","syncPageMeta","actions","children","className","bodyClassName","setPageMeta","ctxLoading","usePageShell","showSpinning","useEffect","jsxs","classNames","styles","jsx","PageSpin"],"mappings":";;;;;;AAsBA,MAAMA,IAAkD,CAAC;AAAA,EACvD,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,YAAAC;AAAA,EACA,SAAAC;AAAA,EACA,UAAAC,IAAW;AAAA,EACX,cAAAC,IAAe;AAAA,EACf,SAAAC;AAAA,EACA,UAAAC;AAAA,EACA,WAAAC;AAAA,EACA,eAAAC;AACF,MAAM;AACJ,QAAM,EAAE,aAAAC,GAAa,aAAaC,EAAA,IAAeC,EAAA,GAC3CC,IAAe,GAAQT,KAAYO;AAEzC,SAAAG,EAAU,MAAM;AACd,QAAKT;AACL,aAAAK,EAAY;AAAA,QACV,OAAAV;AAAA,QACA,aAAAC;AAAA,QACA,aAAaK;AAAA,MAAA,CACd,GACM,MAAMI,EAAY,EAAE;AAAA,EAC7B,GAAG,CAACV,GAAOC,GAAaK,GAASD,GAAcK,CAAW,CAAC,GAGzD,gBAAAK,EAAC,SAAI,WAAWC,EAAW,qBAAqBC,EAAO,mBAAmB,GAAGT,CAAS,GACnF,UAAA;AAAA,IAAAN,IACC,gBAAAgB,EAAC,OAAA,EAAI,WAAWF,EAAW,0BAA0BC,EAAO,wBAAwB,CAAC,GAClF,UAAAf,EAAA,CACH,IACE;AAAA,IAEHC,IACC,gBAAAe,EAAC,OAAA,EAAI,WAAWF,EAAW,uBAAuBC,EAAO,qBAAqB,CAAC,GAC5E,UAAAd,EAAA,CACH,IACE;AAAA,IAEJ,gBAAAe;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,WAAWF,EAAW,oBAAoBC,EAAO,kBAAkB,GAAGR,CAAa;AAAA,QAEnF,UAAA,gBAAAS,EAACC,GAAA,EAAS,UAAUN,GAAe,UAAAN,EAAA,CAAS;AAAA,MAAA;AAAA,IAAA;AAAA,EAC9C,GACF;AAEJ;"}
+{"version":3,"file":"index.js","sources":["../../../../src/components/Layout/ModulePageShell/index.tsx"],"sourcesContent":["import classNames from 'classnames';\nimport type { ReactNode } from 'react';\nimport { useEffect } from 'react';\nimport PageSpin from '../PageSpin';\nimport { usePageShell, type PageShellActionItem } from '../PageShell';\nimport styles from './style.module.scss';\n\nexport type ModulePageShellProps = {\n  title?: string;\n  description?: ReactNode;\n  breadcrumb?: ReactNode;\n  toolbar?: ReactNode;\n  /** 页面级 loading，与 usePageShellLoading 注册的 ctx loading 合并 */\n  spinning?: boolean;\n  /** 是否同步 title/description/actions 到 PageShellProvider（App 顶栏），默认 true */\n  syncPageMeta?: boolean;\n  actions?: PageShellActionItem[];\n  children?: ReactNode;\n  className?: string;\n  bodyClassName?: string;\n};\n\nconst ModulePageShell: React.FC<ModulePageShellProps> = ({\n  title,\n  description,\n  breadcrumb,\n  toolbar,\n  spinning = false,\n  syncPageMeta = true,\n  actions,\n  children,\n  className,\n  bodyClassName,\n}) => {\n  const { setPageMeta, pageLoading: ctxLoading } = usePageShell();\n  const showSpinning = Boolean(spinning || ctxLoading);\n\n  useEffect(() => {\n    if (!syncPageMeta) return;\n    setPageMeta({\n      title,\n      description,\n      actionItems: actions,\n    });\n    return () => setPageMeta({});\n  }, [title, description, actions, syncPageMeta, setPageMeta]);\n\n  return (\n    <div className={classNames('module-page-shell', styles['module-page-shell'], className)}>\n      {breadcrumb ? (\n        <div className={classNames('module-page-breadcrumb', styles['module-page-breadcrumb'])}>\n          {breadcrumb}\n        </div>\n      ) : null}\n\n      {toolbar ? (\n        <div className={classNames('module-page-toolbar', styles['module-page-toolbar'])}>\n          {toolbar}\n        </div>\n      ) : null}\n\n      <div className={classNames('module-page-body', styles['module-page-body'], bodyClassName)}>\n        <PageSpin spinning={showSpinning}>{children}</PageSpin>\n      </div>\n    </div>\n  );\n};\n\nexport default ModulePageShell;\n"],"names":["ModulePageShell","title","description","breadcrumb","toolbar","spinning","syncPageMeta","actions","children","className","bodyClassName","setPageMeta","ctxLoading","usePageShell","showSpinning","useEffect","jsxs","classNames","styles","jsx","PageSpin"],"mappings":";;;;;;AAsBA,MAAMA,IAAkD,CAAC;AAAA,EACvD,OAAAC;AAAA,EACA,aAAAC;AAAA,EACA,YAAAC;AAAA,EACA,SAAAC;AAAA,EACA,UAAAC,IAAW;AAAA,EACX,cAAAC,IAAe;AAAA,EACf,SAAAC;AAAA,EACA,UAAAC;AAAA,EACA,WAAAC;AAAA,EACA,eAAAC;AACF,MAAM;AACJ,QAAM,EAAE,aAAAC,GAAa,aAAaC,EAAA,IAAeC,EAAA,GAC3CC,IAAe,GAAQT,KAAYO;AAEzC,SAAAG,EAAU,MAAM;AACd,QAAKT;AACL,aAAAK,EAAY;AAAA,QACV,OAAAV;AAAA,QACA,aAAAC;AAAA,QACA,aAAaK;AAAA,MAAA,CACd,GACM,MAAMI,EAAY,EAAE;AAAA,EAC7B,GAAG,CAACV,GAAOC,GAAaK,GAASD,GAAcK,CAAW,CAAC,GAGzD,gBAAAK,EAAC,SAAI,WAAWC,EAAW,qBAAqBC,EAAO,mBAAmB,GAAGT,CAAS,GACnF,UAAA;AAAA,IAAAN,IACC,gBAAAgB,EAAC,OAAA,EAAI,WAAWF,EAAW,0BAA0BC,EAAO,wBAAwB,CAAC,GAClF,UAAAf,EAAA,CACH,IACE;AAAA,IAEHC,IACC,gBAAAe,EAAC,OAAA,EAAI,WAAWF,EAAW,uBAAuBC,EAAO,qBAAqB,CAAC,GAC5E,UAAAd,EAAA,CACH,IACE;AAAA,IAEJ,gBAAAe,EAAC,OAAA,EAAI,WAAWF,EAAW,oBAAoBC,EAAO,kBAAkB,GAAGR,CAAa,GACtF,UAAA,gBAAAS,EAACC,GAAA,EAAS,UAAUN,GAAe,UAAAN,GAAS,EAAA,CAC9C;AAAA,EAAA,GACF;AAEJ;"}

package/dist/components/Layout/PageShell/PageShellContext.d.ts

@@ -1,8 +1,15 @@
-import { ReactNode } from 'react';
+import { Key, ReactNode } from 'react';
+/** ButtonGroup list 项：对象配置 或 自定义渲染函数（如 Dropdown 主按钮） */
+export type PageShellActionItem = Record<string, unknown> | ((props: {
+    className?: string;
+    key?: Key;
+}, ctx?: {
+    isDropdown?: boolean;
+}) => ReactNode);
 export type PageShellMeta = {
     title?: string;
     description?: ReactNode;
-    actionItems?: Record<string, unknown>[];
+    actionItems?: PageShellActionItem[];
 };
 type PageShellContextValue = {
     meta: PageShellMeta;

package/dist/components/Layout/PageShell/PageShellContext.js

@@ -1,39 +1,39 @@
-import { jsx as f } from "react/jsx-runtime";
-import { useState as g, useCallback as r, useMemo as d, useContext as m, useEffect as L, createContext as M } from "react";
-const c = {}, l = M({
-  meta: c,
+import { jsx as d } from "react/jsx-runtime";
+import { useState as c, useCallback as r, useMemo as m, useContext as L, useEffect as M, createContext as S } from "react";
+const g = {}, u = S({
+  meta: g,
   setPageMeta: () => {
   },
   pageLoading: !1,
   setPageLoading: () => {
   }
 });
-function S() {
-  return m(l);
+function h() {
+  return L(u);
 }
-function p(t) {
-  const { setPageLoading: e } = S();
-  L(() => (e(t), () => e(!1)), [t, e]);
+function p(o) {
+  const { setPageLoading: a } = h();
+  M(() => (a(o), () => a(!1)), [o, a]);
 }
-function C({ children: t }) {
-  const [e, u] = g(c), [o, P] = g(!1), s = r((a) => {
-    u(a);
-  }, []), n = r((a) => {
-    P(a);
-  }, []), i = d(
+function x({ children: o }) {
+  const [a, l] = c(g), [s, P] = c(!1), n = r((e) => {
+    l((t) => t.title === e.title && t.description === e.description && t.actionItems === e.actionItems ? t : e);
+  }, []), i = r((e) => {
+    P((t) => t === e ? t : e);
+  }, []), f = m(
     () => ({
-      meta: e,
-      setPageMeta: s,
-      pageLoading: o,
-      setPageLoading: n
+      meta: a,
+      setPageMeta: n,
+      pageLoading: s,
+      setPageLoading: i
     }),
-    [e, s, o, n]
+    [a, n, s, i]
   );
-  return /* @__PURE__ */ f(l.Provider, { value: i, children: t });
+  return /* @__PURE__ */ d(u.Provider, { value: f, children: o });
 }
 export {
-  C as PageShellProvider,
-  S as usePageShell,
+  x as PageShellProvider,
+  h as usePageShell,
   p as usePageShellLoading
 };
 //# sourceMappingURL=PageShellContext.js.map

package/dist/components/Layout/PageShell/PageShellContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"PageShellContext.js","sources":["../../../../src/components/Layout/PageShell/PageShellContext.tsx"],"sourcesContent":["import type { ReactNode } from 'react';\nimport { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';\n\nexport type PageShellMeta = {\n  title?: string;\n  description?: ReactNode;\n  actionItems?: Record<string, unknown>[];\n};\n\ntype PageShellContextValue = {\n  meta: PageShellMeta;\n  setPageMeta: (next: PageShellMeta) => void;\n  pageLoading: boolean;\n  setPageLoading: (loading: boolean) => void;\n};\n\nconst EMPTY_META: PageShellMeta = {};\n\nconst PageShellContext = createContext<PageShellContextValue>({\n  meta: EMPTY_META,\n  setPageMeta: () => {},\n  pageLoading: false,\n  setPageLoading: () => {},\n});\n\nexport function usePageShell() {\n  return useContext(PageShellContext);\n}\n\n/** 深层子组件向 Layout body Spin 注册 loading（卸载时自动清除） */\nexport function usePageShellLoading(spinning: boolean) {\n  const { setPageLoading } = usePageShell();\n  useEffect(() => {\n    setPageLoading(spinning);\n    return () => setPageLoading(false);\n  }, [spinning, setPageLoading]);\n}\n\nexport type PageShellProviderProps = {\n  children: ReactNode;\n};\n\nexport function PageShellProvider({ children }: PageShellProviderProps) {\n  const [meta, setMeta] = useState<PageShellMeta>(EMPTY_META);\n  const [pageLoading, setPageLoadingState] = useState(false);\n\n  const setPageMeta = useCallback((next: PageShellMeta) => {\n    setMeta(next);\n  }, []);\n\n  const setPageLoading = useCallback((loading: boolean) => {\n    setPageLoadingState(loading);\n  }, []);\n\n  const value = useMemo(\n    () => ({\n      meta,\n      setPageMeta,\n      pageLoading,\n      setPageLoading,\n    }),\n    [meta, setPageMeta, pageLoading, setPageLoading],\n  );\n\n  return <PageShellContext.Provider value={value}>{children}</PageShellContext.Provider>;\n}\n"],"names":["EMPTY_META","PageShellContext","createContext","usePageShell","useContext","usePageShellLoading","spinning","setPageLoading","useEffect","PageShellProvider","children","meta","setMeta","useState","pageLoading","setPageLoadingState","setPageMeta","useCallback","next","loading","value","useMemo","jsx"],"mappings":";;AAgBA,MAAMA,IAA4B,CAAA,GAE5BC,IAAmBC,EAAqC;AAAA,EAC5D,MAAMF;AAAA,EACN,aAAa,MAAM;AAAA,EAAC;AAAA,EACpB,aAAa;AAAA,EACb,gBAAgB,MAAM;AAAA,EAAC;AACzB,CAAC;AAEM,SAASG,IAAe;AAC7B,SAAOC,EAAWH,CAAgB;AACpC;AAGO,SAASI,EAAoBC,GAAmB;AACrD,QAAM,EAAE,gBAAAC,EAAA,IAAmBJ,EAAA;AAC3B,EAAAK,EAAU,OACRD,EAAeD,CAAQ,GAChB,MAAMC,EAAe,EAAK,IAChC,CAACD,GAAUC,CAAc,CAAC;AAC/B;AAMO,SAASE,EAAkB,EAAE,UAAAC,KAAoC;AACtE,QAAM,CAACC,GAAMC,CAAO,IAAIC,EAAwBb,CAAU,GACpD,CAACc,GAAaC,CAAmB,IAAIF,EAAS,EAAK,GAEnDG,IAAcC,EAAY,CAACC,MAAwB;AACvD,IAAAN,EAAQM,CAAI;AAAA,EACd,GAAG,CAAA,CAAE,GAECX,IAAiBU,EAAY,CAACE,MAAqB;AACvD,IAAAJ,EAAoBI,CAAO;AAAA,EAC7B,GAAG,CAAA,CAAE,GAECC,IAAQC;AAAA,IACZ,OAAO;AAAA,MACL,MAAAV;AAAA,MACA,aAAAK;AAAA,MACA,aAAAF;AAAA,MACA,gBAAAP;AAAA,IAAA;AAAA,IAEF,CAACI,GAAMK,GAAaF,GAAaP,CAAc;AAAA,EAAA;AAGjD,SAAO,gBAAAe,EAACrB,EAAiB,UAAjB,EAA0B,OAAAmB,GAAe,UAAAV,EAAA,CAAS;AAC5D;"}
+{"version":3,"file":"PageShellContext.js","sources":["../../../../src/components/Layout/PageShell/PageShellContext.tsx"],"sourcesContent":["import type { Key, ReactNode } from 'react';\nimport { createContext, useCallback, useContext, useEffect, useMemo, useState } from 'react';\n\n/** ButtonGroup list 项：对象配置 或 自定义渲染函数（如 Dropdown 主按钮） */\nexport type PageShellActionItem =\n  | Record<string, unknown>\n  | ((props: { className?: string; key?: Key }, ctx?: { isDropdown?: boolean }) => ReactNode);\n\nexport type PageShellMeta = {\n  title?: string;\n  description?: ReactNode;\n  actionItems?: PageShellActionItem[];\n};\n\ntype PageShellContextValue = {\n  meta: PageShellMeta;\n  setPageMeta: (next: PageShellMeta) => void;\n  pageLoading: boolean;\n  setPageLoading: (loading: boolean) => void;\n};\n\nconst EMPTY_META: PageShellMeta = {};\n\nconst PageShellContext = createContext<PageShellContextValue>({\n  meta: EMPTY_META,\n  setPageMeta: () => {},\n  pageLoading: false,\n  setPageLoading: () => {},\n});\n\nexport function usePageShell() {\n  return useContext(PageShellContext);\n}\n\n/** 深层子组件向 Layout body Spin 注册 loading（卸载时自动清除） */\nexport function usePageShellLoading(spinning: boolean) {\n  const { setPageLoading } = usePageShell();\n  useEffect(() => {\n    setPageLoading(spinning);\n    return () => setPageLoading(false);\n  }, [spinning, setPageLoading]);\n}\n\nexport type PageShellProviderProps = {\n  children: ReactNode;\n};\n\nexport function PageShellProvider({ children }: PageShellProviderProps) {\n  const [meta, setMeta] = useState<PageShellMeta>(EMPTY_META);\n  const [pageLoading, setPageLoadingState] = useState(false);\n\n  const setPageMeta = useCallback((next: PageShellMeta) => {\n    setMeta((prev) => {\n      if (\n        prev.title === next.title &&\n        prev.description === next.description &&\n        prev.actionItems === next.actionItems\n      ) {\n        return prev;\n      }\n      return next;\n    });\n  }, []);\n\n  const setPageLoading = useCallback((loading: boolean) => {\n    setPageLoadingState((prev) => (prev === loading ? prev : loading));\n  }, []);\n\n  const value = useMemo(\n    () => ({\n      meta,\n      setPageMeta,\n      pageLoading,\n      setPageLoading,\n    }),\n    [meta, setPageMeta, pageLoading, setPageLoading],\n  );\n\n  return <PageShellContext.Provider value={value}>{children}</PageShellContext.Provider>;\n}\n"],"names":["EMPTY_META","PageShellContext","createContext","usePageShell","useContext","usePageShellLoading","spinning","setPageLoading","useEffect","PageShellProvider","children","meta","setMeta","useState","pageLoading","setPageLoadingState","setPageMeta","useCallback","next","prev","loading","value","useMemo","jsx"],"mappings":";;AAqBA,MAAMA,IAA4B,CAAA,GAE5BC,IAAmBC,EAAqC;AAAA,EAC5D,MAAMF;AAAA,EACN,aAAa,MAAM;AAAA,EAAC;AAAA,EACpB,aAAa;AAAA,EACb,gBAAgB,MAAM;AAAA,EAAC;AACzB,CAAC;AAEM,SAASG,IAAe;AAC7B,SAAOC,EAAWH,CAAgB;AACpC;AAGO,SAASI,EAAoBC,GAAmB;AACrD,QAAM,EAAE,gBAAAC,EAAA,IAAmBJ,EAAA;AAC3B,EAAAK,EAAU,OACRD,EAAeD,CAAQ,GAChB,MAAMC,EAAe,EAAK,IAChC,CAACD,GAAUC,CAAc,CAAC;AAC/B;AAMO,SAASE,EAAkB,EAAE,UAAAC,KAAoC;AACtE,QAAM,CAACC,GAAMC,CAAO,IAAIC,EAAwBb,CAAU,GACpD,CAACc,GAAaC,CAAmB,IAAIF,EAAS,EAAK,GAEnDG,IAAcC,EAAY,CAACC,MAAwB;AACvD,IAAAN,EAAQ,CAACO,MAELA,EAAK,UAAUD,EAAK,SACpBC,EAAK,gBAAgBD,EAAK,eAC1BC,EAAK,gBAAgBD,EAAK,cAEnBC,IAEFD,CACR;AAAA,EACH,GAAG,CAAA,CAAE,GAECX,IAAiBU,EAAY,CAACG,MAAqB;AACvD,IAAAL,EAAoB,CAACI,MAAUA,MAASC,IAAUD,IAAOC,CAAQ;AAAA,EACnE,GAAG,CAAA,CAAE,GAECC,IAAQC;AAAA,IACZ,OAAO;AAAA,MACL,MAAAX;AAAA,MACA,aAAAK;AAAA,MACA,aAAAF;AAAA,MACA,gBAAAP;AAAA,IAAA;AAAA,IAEF,CAACI,GAAMK,GAAaF,GAAaP,CAAc;AAAA,EAAA;AAGjD,SAAO,gBAAAgB,EAACtB,EAAiB,UAAjB,EAA0B,OAAAoB,GAAe,UAAAX,EAAA,CAAS;AAC5D;"}

package/dist/components/Layout/PageShell/index.d.ts

@@ -1,2 +1,2 @@
-export { PageShellProvider, usePageShell, usePageShellLoading, } from './PageShellContext';
-export type { PageShellMeta, PageShellProviderProps } from './PageShellContext';
+export { PageShellProvider, usePageShell, usePageShellLoading } from './PageShellContext';
+export type { PageShellMeta, PageShellProviderProps, PageShellActionItem, } from './PageShellContext';

package/dist/components/Layout/index.d.ts

@@ -3,7 +3,7 @@ export type { PageHeaderLayoutProps } from './PageHeaderLayout';
 export { default as PageSpin } from './PageSpin';
 export type { PageSpinProps } from './PageSpin';
 export { PageShellProvider, usePageShell, usePageShellLoading } from './PageShell';
-export type { PageShellMeta, PageShellProviderProps } from './PageShell';
+export type { PageShellMeta, PageShellProviderProps, PageShellActionItem } from './PageShell';
 export { default as ModulePageShell } from './ModulePageShell';
 export type { ModulePageShellProps } from './ModulePageShell';
 export { AgentAppShell } from './AgentAppShell';

package/dist/components/StateBar/StateBar.d.ts

@@ -1,14 +1,29 @@
 import { TabsProps } from 'antd';
-import { CSSProperties, ReactNode } from 'react';
+import { CSSProperties, MouseEvent, ReactNode } from 'react';
+import { IconName } from '../Icons';
 import { DescriptionItem } from '../Descriptions/CommonDescriptions';
 export type StateBarType = 'tab' | 'radio' | 'step';
+/** Tab 项旁操作（icon + 可选文案提示 + 点击） */
+export type StateBarActionItem = {
+    /** Icons 注册表名，如 `Info` / `Plus` / `Pencil` */
+    iconType: IconName;
+    /** Tooltip 文案；缺省不包 Tooltip */
+    label?: string;
+    onClick?: (e: MouseEvent<HTMLElement>) => void;
+    disabled?: boolean;
+    className?: string;
+    /** 图标尺寸，默认 14 */
+    size?: number;
+};
 export type StateBarOption = {
     key: string;
     /** 选项卡标题（优先于 label） */
     tab?: ReactNode;
     label?: ReactNode;
-    /** 标题旁 Info + TooltipInfo（对齐 Modal/InteractiveBlock）；为空不展示 icon */
+    /** 标题旁 Info + TooltipInfo（对齐 Modal/InteractiveBlock）；为空不展示 */
     info?: DescriptionItem[];
+    /** 标题旁额外操作图标（可与 info 并存） */
+    actions?: StateBarActionItem[];
     children?: ReactNode;
     disabled?: boolean;
     className?: string;