@pactor-app/ui 1.9.0 → 1.11.0

package/dist/components/index.d.cts

@@ -145,6 +145,7 @@ interface BreadcrumbProps {
 /**
  * Breadcrumb 适配器（shadcn kit）：items 声明路径，带 href 的非末项
  * 渲染为可点击链接，末项渲染为当前页纯文本（aria-current="page"）。
+ * 链接站内路径的普通左键点击走渲染上下文路由（同 Link 组件规则）。
  */
 declare function Breadcrumb({ items, className, style }: BreadcrumbProps): React.JSX.Element;
 
@@ -155,6 +156,8 @@ type ButtonSize = 'small' | 'middle' | 'large';
 interface ButtonProps {
     /** 按钮文本；也可用 children 渲染内容 */
     text?: string;
+    /** 图标名（Icon 白名单，kebab-case / PascalCase 均可），渲染在文本前 */
+    icon?: string;
     /** 变体，默认 default */
     variant?: ButtonVariant;
     /** 危险态 */
@@ -176,9 +179,10 @@ interface ButtonProps {
  * Button 适配器（shadcn kit）：vendored shadcn Button（cva 变体）。
  * props 契约与 pactor-components（antd 版）一致；`submit: true` 时作为
  * Form 的提交按钮（type=submit）；danger 映射 destructive（link/text
- * 变体保持原样、文字标红）；loading 显示旋转图标并禁用。
+ * 变体保持原样、文字标红）；loading 显示旋转图标并禁用（优先于 icon）；
+ * `icon` 渲染文本前图标（对齐 Alert 的 icon 通道）。
  */
-declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
+declare function Button({ text, icon, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
 
 interface ButtonGroupProps {
     /** 通用：根节点 class（与内置样式合并） */
@@ -216,6 +220,9 @@ interface InputProps {
     onChange?: (value: string) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -226,7 +233,7 @@ interface InputProps {
  * 表单项为去原语化结构（design D3）：`<div data-slot="form-item">` +
  * `<label htmlFor>` 与控件 `useId` 关联。
  */
-declare function Input({ name, label, rules, value, type, placeholder, disabled, allowClear, onChange, className, style, }: InputProps): React.JSX.Element;
+declare function Input({ name, label, rules, value, type, placeholder, disabled, allowClear, onChange, className, controlClassName, style, }: InputProps): React.JSX.Element;
 
 interface CalendarProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */
@@ -738,6 +745,8 @@ declare function Empty({ title, description, children, className, style }: Empty
 interface FieldProps {
     /** 表单项标签 */
     label?: string;
+    /** 必填标记（label 前渲染红色 `*`；仅视觉标记，校验仍由 Form rules 承担） */
+    required?: boolean;
     /** 辅助说明文案 */
     description?: string;
     /** 错误文案（声明式展示，如校验失败信息） */
@@ -751,9 +760,10 @@ interface FieldProps {
 }
 /**
  * Field 适配器（shadcn kit）：通用表单项容器（Base UI Field 封装）；
- * label / description / error 为框架级 props，error 声明式强制展示。
+ * label / description / error 为框架级 props，error 声明式强制展示；
+ * `required` 在 label 前渲染必填星号（对齐 antd Form.Item required 语义）。
  */
-declare function Field({ label, description, error, children, className, style }: FieldProps): React.JSX.Element;
+declare function Field({ label, required, description, error, children, className, style }: FieldProps): React.JSX.Element;
 
 interface FlexProps {
     /** 主轴方向，默认 horizontal */
@@ -1090,9 +1100,10 @@ interface LinkProps {
     children?: ReactNode;
 }
 /**
- * Link 链接（shadcn kit）：渲染原生 `<a href>`——自然跳转，
- * 目标可以是宿主任意路由（嵌入模式的主要跳转方式，见
- * spec: embedded-page-view 的「自然跳转」）。
+ * Link 链接（shadcn kit）：渲染原生 `<a href>` 保留原生语义；
+ * 站内路径（`/` 开头）的普通左键点击拦截后走渲染上下文路由
+ * （`route.navigate`，嵌入模式可注入宿主路由），外链 / 锚点 /
+ * 修饰键点击 / 显式 target 保持浏览器自然跳转。
  */
 declare function Link({ href, text, target, className, style, children }: LinkProps): React.JSX.Element;
 
@@ -1280,6 +1291,8 @@ interface RadioGroupProps {
     rules?: FieldRule[];
     /** 选项列表 */
     options?: RadioGroupOption[];
+    /** 选项排列方向，默认 vertical */
+    direction?: 'horizontal' | 'vertical';
     /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
     value?: string | number | boolean;
     disabled?: boolean;
@@ -1293,9 +1306,10 @@ interface RadioGroupProps {
 /**
  * RadioGroup 适配器（shadcn kit）：基于 vendored RadioGroup（Base UI）；
  * Base UI RadioGroup 的 value 原生支持 string/number/boolean，
- * onChange 传出选中项原始 value。
+ * onChange 传出选中项原始 value。`direction` 控制选项横/纵排列；
+ * label 经 htmlFor 关联 Base UI 隐藏原生 input，点击 label 即选中对应项。
  */
-declare function RadioGroup({ name, label, rules, options, value, disabled, onChange, className, style, }: RadioGroupProps): React.JSX.Element;
+declare function RadioGroup({ name, label, rules, options, direction, value, disabled, onChange, className, style, }: RadioGroupProps): React.JSX.Element;
 
 /** 可拖拽面板；`children` 为 DSL 子树，经 renderChildren 渲染 */
 interface ResizablePanelData {
@@ -1369,6 +1383,9 @@ interface SelectProps {
     onChange?: (value: unknown) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件包裹节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -1382,7 +1399,7 @@ interface SelectProps {
  * popup 时（如表单初始值回填），Trigger 同样显示 label（对齐原 Radix 坑
  * 的对应场景，见 design D2/风险表）。
  */
-declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, className, style, }: SelectProps): React.JSX.Element;
+declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, className, controlClassName, style, }: SelectProps): React.JSX.Element;
 
 interface SeparatorProps {
     /** 方向，默认 horizontal */

package/dist/components/index.d.ts

@@ -145,6 +145,7 @@ interface BreadcrumbProps {
 /**
  * Breadcrumb 适配器（shadcn kit）：items 声明路径，带 href 的非末项
  * 渲染为可点击链接，末项渲染为当前页纯文本（aria-current="page"）。
+ * 链接站内路径的普通左键点击走渲染上下文路由（同 Link 组件规则）。
  */
 declare function Breadcrumb({ items, className, style }: BreadcrumbProps): React.JSX.Element;
 
@@ -155,6 +156,8 @@ type ButtonSize = 'small' | 'middle' | 'large';
 interface ButtonProps {
     /** 按钮文本；也可用 children 渲染内容 */
     text?: string;
+    /** 图标名（Icon 白名单，kebab-case / PascalCase 均可），渲染在文本前 */
+    icon?: string;
     /** 变体，默认 default */
     variant?: ButtonVariant;
     /** 危险态 */
@@ -176,9 +179,10 @@ interface ButtonProps {
  * Button 适配器（shadcn kit）：vendored shadcn Button（cva 变体）。
  * props 契约与 pactor-components（antd 版）一致；`submit: true` 时作为
  * Form 的提交按钮（type=submit）；danger 映射 destructive（link/text
- * 变体保持原样、文字标红）；loading 显示旋转图标并禁用。
+ * 变体保持原样、文字标红）；loading 显示旋转图标并禁用（优先于 icon）；
+ * `icon` 渲染文本前图标（对齐 Alert 的 icon 通道）。
  */
-declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
+declare function Button({ text, icon, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
 
 interface ButtonGroupProps {
     /** 通用：根节点 class（与内置样式合并） */
@@ -216,6 +220,9 @@ interface InputProps {
     onChange?: (value: string) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -226,7 +233,7 @@ interface InputProps {
  * 表单项为去原语化结构（design D3）：`<div data-slot="form-item">` +
  * `<label htmlFor>` 与控件 `useId` 关联。
  */
-declare function Input({ name, label, rules, value, type, placeholder, disabled, allowClear, onChange, className, style, }: InputProps): React.JSX.Element;
+declare function Input({ name, label, rules, value, type, placeholder, disabled, allowClear, onChange, className, controlClassName, style, }: InputProps): React.JSX.Element;
 
 interface CalendarProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */
@@ -738,6 +745,8 @@ declare function Empty({ title, description, children, className, style }: Empty
 interface FieldProps {
     /** 表单项标签 */
     label?: string;
+    /** 必填标记（label 前渲染红色 `*`；仅视觉标记，校验仍由 Form rules 承担） */
+    required?: boolean;
     /** 辅助说明文案 */
     description?: string;
     /** 错误文案（声明式展示，如校验失败信息） */
@@ -751,9 +760,10 @@ interface FieldProps {
 }
 /**
  * Field 适配器（shadcn kit）：通用表单项容器（Base UI Field 封装）；
- * label / description / error 为框架级 props，error 声明式强制展示。
+ * label / description / error 为框架级 props，error 声明式强制展示；
+ * `required` 在 label 前渲染必填星号（对齐 antd Form.Item required 语义）。
  */
-declare function Field({ label, description, error, children, className, style }: FieldProps): React.JSX.Element;
+declare function Field({ label, required, description, error, children, className, style }: FieldProps): React.JSX.Element;
 
 interface FlexProps {
     /** 主轴方向，默认 horizontal */
@@ -1090,9 +1100,10 @@ interface LinkProps {
     children?: ReactNode;
 }
 /**
- * Link 链接（shadcn kit）：渲染原生 `<a href>`——自然跳转，
- * 目标可以是宿主任意路由（嵌入模式的主要跳转方式，见
- * spec: embedded-page-view 的「自然跳转」）。
+ * Link 链接（shadcn kit）：渲染原生 `<a href>` 保留原生语义；
+ * 站内路径（`/` 开头）的普通左键点击拦截后走渲染上下文路由
+ * （`route.navigate`，嵌入模式可注入宿主路由），外链 / 锚点 /
+ * 修饰键点击 / 显式 target 保持浏览器自然跳转。
  */
 declare function Link({ href, text, target, className, style, children }: LinkProps): React.JSX.Element;
 
@@ -1280,6 +1291,8 @@ interface RadioGroupProps {
     rules?: FieldRule[];
     /** 选项列表 */
     options?: RadioGroupOption[];
+    /** 选项排列方向，默认 vertical */
+    direction?: 'horizontal' | 'vertical';
     /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
     value?: string | number | boolean;
     disabled?: boolean;
@@ -1293,9 +1306,10 @@ interface RadioGroupProps {
 /**
  * RadioGroup 适配器（shadcn kit）：基于 vendored RadioGroup（Base UI）；
  * Base UI RadioGroup 的 value 原生支持 string/number/boolean，
- * onChange 传出选中项原始 value。
+ * onChange 传出选中项原始 value。`direction` 控制选项横/纵排列；
+ * label 经 htmlFor 关联 Base UI 隐藏原生 input，点击 label 即选中对应项。
  */
-declare function RadioGroup({ name, label, rules, options, value, disabled, onChange, className, style, }: RadioGroupProps): React.JSX.Element;
+declare function RadioGroup({ name, label, rules, options, direction, value, disabled, onChange, className, style, }: RadioGroupProps): React.JSX.Element;
 
 /** 可拖拽面板；`children` 为 DSL 子树，经 renderChildren 渲染 */
 interface ResizablePanelData {
@@ -1369,6 +1383,9 @@ interface SelectProps {
     onChange?: (value: unknown) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件包裹节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -1382,7 +1399,7 @@ interface SelectProps {
  * popup 时（如表单初始值回填），Trigger 同样显示 label（对齐原 Radix 坑
  * 的对应场景，见 design D2/风险表）。
  */
-declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, className, style, }: SelectProps): React.JSX.Element;
+declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, className, controlClassName, style, }: SelectProps): React.JSX.Element;
 
 interface SeparatorProps {
     /** 方向，默认 horizontal */

package/dist/components/index.js

@@ -71,7 +71,7 @@ import {
   createComponentRegistry,
   registerBuiltinComponents,
   useFormContext
-} from "../chunk-KUFQSYTS.js";
+} from "../chunk-HW6M3BEF.js";
 import {
   ICONS,
   Icon,
@@ -81,8 +81,8 @@ import {
   normalizeIconName,
   useSidebarDrawer
 } from "../chunk-PECP7DJB.js";
-import "../chunk-VT5XP4U4.js";
-import "../chunk-F42SGQNW.js";
+import "../chunk-NVORKHWX.js";
+import "../chunk-XUHJ5YSG.js";
 import "../chunk-VM4FESQB.js";
 import "../chunk-WKJUCGV4.js";
 export {