@pactor-app/ui 1.10.0 → 1.12.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,10 @@ type ButtonSize = 'small' | 'middle' | 'large';
 interface ButtonProps {
     /** 按钮文本；也可用 children 渲染内容 */
     text?: string;
+    /** 图标名（Icon 白名单，kebab-case / PascalCase 均可），渲染在文本前 */
+    icon?: string;
+    /** 提示文案：hover / focus 按钮时展示 Tooltip */
+    tooltip?: string;
     /** 变体，默认 default */
     variant?: ButtonVariant;
     /** 危险态 */
@@ -176,9 +181,11 @@ 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 通道）；`tooltip` 经 vendored
+ * Tooltip 包装（Trigger render 合并到按钮本体）。
  */
-declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
+declare function Button({ text, icon, tooltip, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
 
 interface ButtonGroupProps {
     /** 通用：根节点 class（与内置样式合并） */
@@ -216,6 +223,9 @@ interface InputProps {
     onChange?: (value: string) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -226,7 +236,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 +748,8 @@ declare function Empty({ title, description, children, className, style }: Empty
 interface FieldProps {
     /** 表单项标签 */
     label?: string;
+    /** 必填标记（label 前渲染红色 `*`；仅视觉标记，校验仍由 Form rules 承担） */
+    required?: boolean;
     /** 辅助说明文案 */
     description?: string;
     /** 错误文案（声明式展示，如校验失败信息） */
@@ -751,9 +763,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 +1103,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;
 
@@ -1372,6 +1386,9 @@ interface SelectProps {
     onChange?: (value: unknown) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件包裹节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -1385,7 +1402,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 */
@@ -1698,11 +1715,15 @@ declare function Tabs({ items, activeKey, variant, onChange, className, style }:
 
 /** DSL Text 语义类型 */
 type TextType = 'default' | 'secondary' | 'success' | 'warning' | 'danger';
+/** DSL Text 字号（middle 缺省继承上下文字号） */
+type TextSize = 'small' | 'middle' | 'large';
 interface TextProps {
     /** 文本内容（可含表达式）；也可用 children 渲染 */
     text?: string;
     /** 语义类型（颜色） */
     type?: TextType;
+    /** 字号：small 12 / middle 继承（缺省）/ large 18 */
+    size?: TextSize;
     /** 加粗 */
     strong?: boolean;
     /** 删除线 */
@@ -1717,8 +1738,8 @@ interface TextProps {
     style?: CSSProperties;
     children?: ReactNode;
 }
-/** Text 适配器（shadcn kit）：普通文本渲染，语义类型 + 修饰（粗体/删除线/下划线/斜体） */
-declare function Text({ text, type, strong, delete: del, underline, italic, className, style, children, }: TextProps): React.JSX.Element;
+/** Text 适配器（shadcn kit）：普通文本渲染，语义类型 + 字号 + 修饰（粗体/删除线/下划线/斜体） */
+declare function Text({ text, type, size, strong, delete: del, underline, italic, className, style, children, }: TextProps): React.JSX.Element;
 
 interface TextareaProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */

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,10 @@ type ButtonSize = 'small' | 'middle' | 'large';
 interface ButtonProps {
     /** 按钮文本；也可用 children 渲染内容 */
     text?: string;
+    /** 图标名（Icon 白名单，kebab-case / PascalCase 均可），渲染在文本前 */
+    icon?: string;
+    /** 提示文案：hover / focus 按钮时展示 Tooltip */
+    tooltip?: string;
     /** 变体，默认 default */
     variant?: ButtonVariant;
     /** 危险态 */
@@ -176,9 +181,11 @@ 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 通道）；`tooltip` 经 vendored
+ * Tooltip 包装（Trigger render 合并到按钮本体）。
  */
-declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
+declare function Button({ text, icon, tooltip, variant, danger, size, loading, disabled, submit, onClick, className, style, children, }: ButtonProps): React.JSX.Element;
 
 interface ButtonGroupProps {
     /** 通用：根节点 class（与内置样式合并） */
@@ -216,6 +223,9 @@ interface InputProps {
     onChange?: (value: string) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件本身） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -226,7 +236,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 +748,8 @@ declare function Empty({ title, description, children, className, style }: Empty
 interface FieldProps {
     /** 表单项标签 */
     label?: string;
+    /** 必填标记（label 前渲染红色 `*`；仅视觉标记，校验仍由 Form rules 承担） */
+    required?: boolean;
     /** 辅助说明文案 */
     description?: string;
     /** 错误文案（声明式展示，如校验失败信息） */
@@ -751,9 +763,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 +1103,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;
 
@@ -1372,6 +1386,9 @@ interface SelectProps {
     onChange?: (value: unknown) => void;
     /** 通用：根节点 class（Form 内为 form-item 容器，独立渲染时为控件包裹） */
     className?: string;
+    /** 控件本体 class（无论是否在 Form 内都挂控件包裹节点；独立渲染时与
+     *  className 同点合并——Form 内需要精确设置控件样式（如宽度）时使用） */
+    controlClassName?: string;
     /** 通用：根节点内联样式（同 className 的挂载规则） */
     style?: CSSProperties;
 }
@@ -1385,7 +1402,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 */
@@ -1698,11 +1715,15 @@ declare function Tabs({ items, activeKey, variant, onChange, className, style }:
 
 /** DSL Text 语义类型 */
 type TextType = 'default' | 'secondary' | 'success' | 'warning' | 'danger';
+/** DSL Text 字号（middle 缺省继承上下文字号） */
+type TextSize = 'small' | 'middle' | 'large';
 interface TextProps {
     /** 文本内容（可含表达式）；也可用 children 渲染 */
     text?: string;
     /** 语义类型（颜色） */
     type?: TextType;
+    /** 字号：small 12 / middle 继承（缺省）/ large 18 */
+    size?: TextSize;
     /** 加粗 */
     strong?: boolean;
     /** 删除线 */
@@ -1717,8 +1738,8 @@ interface TextProps {
     style?: CSSProperties;
     children?: ReactNode;
 }
-/** Text 适配器（shadcn kit）：普通文本渲染，语义类型 + 修饰（粗体/删除线/下划线/斜体） */
-declare function Text({ text, type, strong, delete: del, underline, italic, className, style, children, }: TextProps): React.JSX.Element;
+/** Text 适配器（shadcn kit）：普通文本渲染，语义类型 + 字号 + 修饰（粗体/删除线/下划线/斜体） */
+declare function Text({ text, type, size, strong, delete: del, underline, italic, className, style, children, }: TextProps): React.JSX.Element;
 
 interface TextareaProps {
     /** 字段名；在 Form 内声明 name 即自动成为表单项 */

package/dist/components/index.js

@@ -71,7 +71,7 @@ import {
   createComponentRegistry,
   registerBuiltinComponents,
   useFormContext
-} from "../chunk-M4PHRT2N.js";
+} from "../chunk-3KCE7ROX.js";
 import {
   ICONS,
   Icon,
@@ -80,10 +80,10 @@ import {
   Sidebar,
   normalizeIconName,
   useSidebarDrawer
-} from "../chunk-PECP7DJB.js";
-import "../chunk-VT5XP4U4.js";
+} from "../chunk-2B5YV2HR.js";
+import "../chunk-XEK5NQJA.js";
 import "../chunk-XUHJ5YSG.js";
-import "../chunk-VM4FESQB.js";
+import "../chunk-AUSWAD26.js";
 import "../chunk-WKJUCGV4.js";
 export {
   Accordion,