@apexhub/apex-ui-react 1.2.0 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/dist/index.cjs +3363 -3328
  2. package/dist/index.d.ts +26 -22
  3. package/dist/index.mjs +3363 -3328
  4. package/dist/llm/alert.tokens.txt +1 -1
  5. package/dist/llm/alert.txt +3 -3
  6. package/dist/llm/apex-provider.txt +3 -2
  7. package/dist/llm/auto-complete.tokens.txt +1 -1
  8. package/dist/llm/auto-complete.txt +1 -1
  9. package/dist/llm/avatar.tokens.txt +1 -1
  10. package/dist/llm/avatar.txt +1 -1
  11. package/dist/llm/breadcrumb.tokens.txt +46 -96
  12. package/dist/llm/breadcrumb.txt +8 -8
  13. package/dist/llm/button.tokens.txt +1 -1
  14. package/dist/llm/button.txt +16 -8
  15. package/dist/llm/card.tokens.txt +3 -1
  16. package/dist/llm/card.txt +24 -1
  17. package/dist/llm/cascader.tokens.txt +15 -7
  18. package/dist/llm/cascader.txt +25 -6
  19. package/dist/llm/checkbox.tokens.txt +10 -2
  20. package/dist/llm/checkbox.txt +24 -13
  21. package/dist/llm/collapse.tokens.txt +1 -1
  22. package/dist/llm/collapse.txt +1 -1
  23. package/dist/llm/date-picker.tokens.txt +10 -10
  24. package/dist/llm/date-picker.txt +7 -3
  25. package/dist/llm/divider.tokens.txt +1 -1
  26. package/dist/llm/divider.txt +1 -1
  27. package/dist/llm/drawer.tokens.txt +2 -2
  28. package/dist/llm/drawer.txt +2 -2
  29. package/dist/llm/dropdown.tokens.txt +1 -1
  30. package/dist/llm/dropdown.txt +1 -1
  31. package/dist/llm/form.tokens.txt +3 -1
  32. package/dist/llm/form.txt +1 -1
  33. package/dist/llm/grid.txt +9 -9
  34. package/dist/llm/image.tokens.txt +1 -1
  35. package/dist/llm/image.txt +2 -2
  36. package/dist/llm/input-number.tokens.txt +4 -4
  37. package/dist/llm/input-number.txt +8 -3
  38. package/dist/llm/input.tokens.txt +4 -4
  39. package/dist/llm/input.txt +4 -2
  40. package/dist/llm/layout.tokens.txt +1 -1
  41. package/dist/llm/layout.txt +1 -1
  42. package/dist/llm/menu.tokens.txt +21 -8
  43. package/dist/llm/menu.txt +19 -12
  44. package/dist/llm/message.tokens.txt +1 -1
  45. package/dist/llm/message.txt +1 -1
  46. package/dist/llm/modal.tokens.txt +1 -1
  47. package/dist/llm/modal.txt +9 -9
  48. package/dist/llm/notification.tokens.txt +1 -1
  49. package/dist/llm/notification.txt +1 -1
  50. package/dist/llm/pagination.tokens.txt +6 -4
  51. package/dist/llm/pagination.txt +18 -9
  52. package/dist/llm/popover.tokens.txt +4 -14
  53. package/dist/llm/popover.txt +3 -3
  54. package/dist/llm/progress.tokens.txt +1 -1
  55. package/dist/llm/progress.txt +4 -4
  56. package/dist/llm/radio.tokens.txt +11 -6
  57. package/dist/llm/radio.txt +38 -1
  58. package/dist/llm/rate.tokens.txt +1 -1
  59. package/dist/llm/rate.txt +1 -1
  60. package/dist/llm/select.tokens.txt +4 -4
  61. package/dist/llm/select.txt +8 -7
  62. package/dist/llm/skeleton.tokens.txt +1 -1
  63. package/dist/llm/skeleton.txt +1 -1
  64. package/dist/llm/spin.tokens.txt +1 -1
  65. package/dist/llm/spin.txt +1 -1
  66. package/dist/llm/steps.tokens.txt +1 -1
  67. package/dist/llm/steps.txt +1 -1
  68. package/dist/llm/switch.tokens.txt +1 -1
  69. package/dist/llm/switch.txt +1 -1
  70. package/dist/llm/table.tokens.txt +2 -2
  71. package/dist/llm/table.txt +16 -13
  72. package/dist/llm/tabs.tokens.txt +1 -1
  73. package/dist/llm/tabs.txt +1 -1
  74. package/dist/llm/tag.tokens.txt +1 -2
  75. package/dist/llm/tag.txt +7 -8
  76. package/dist/llm/tooltip.tokens.txt +1 -1
  77. package/dist/llm/tooltip.txt +1 -1
  78. package/dist/llm/tree-select.tokens.txt +7 -6
  79. package/dist/llm/tree-select.txt +32 -22
  80. package/dist/llm/tree.tokens.txt +1 -3
  81. package/dist/llm/tree.txt +11 -15
  82. package/dist/llm/typography.tokens.txt +1 -1
  83. package/dist/llm/typography.txt +1 -1
  84. package/dist/llm/upload.tokens.txt +5 -1
  85. package/dist/llm/upload.txt +4 -2
  86. package/dist/llms-full.txt +321 -184
  87. package/dist/llms.txt +1 -1
  88. package/dist/style.css +1716 -1240
  89. package/llms-full.txt +321 -184
  90. package/llms.txt +1 -1
  91. package/package.json +1 -1
  92. package/src/alert/llm.txt +3 -3
  93. package/src/alert/tokens.txt +1 -1
  94. package/src/apex-provider/llm.txt +3 -2
  95. package/src/auto-complete/llm.txt +1 -1
  96. package/src/auto-complete/tokens.txt +1 -1
  97. package/src/avatar/llm.txt +1 -1
  98. package/src/avatar/tokens.txt +1 -1
  99. package/src/breadcrumb/llm.txt +8 -8
  100. package/src/breadcrumb/tokens.txt +46 -96
  101. package/src/button/llm.txt +16 -8
  102. package/src/button/tokens.txt +1 -1
  103. package/src/card/llm.txt +24 -1
  104. package/src/card/tokens.txt +3 -1
  105. package/src/cascader/llm.txt +25 -6
  106. package/src/cascader/tokens.txt +15 -7
  107. package/src/checkbox/llm.txt +24 -13
  108. package/src/checkbox/tokens.txt +10 -2
  109. package/src/collapse/llm.txt +1 -1
  110. package/src/collapse/tokens.txt +1 -1
  111. package/src/date-picker/llm.txt +7 -3
  112. package/src/date-picker/tokens.txt +10 -10
  113. package/src/divider/llm.txt +1 -1
  114. package/src/divider/tokens.txt +1 -1
  115. package/src/drawer/llm.txt +2 -2
  116. package/src/drawer/tokens.txt +2 -2
  117. package/src/dropdown/llm.txt +1 -1
  118. package/src/dropdown/tokens.txt +1 -1
  119. package/src/form/llm.txt +1 -1
  120. package/src/form/tokens.txt +3 -1
  121. package/src/grid/llm.txt +9 -9
  122. package/src/image/llm.txt +2 -2
  123. package/src/image/tokens.txt +1 -1
  124. package/src/input/llm.txt +4 -2
  125. package/src/input/tokens.txt +4 -4
  126. package/src/input-number/llm.txt +8 -3
  127. package/src/input-number/tokens.txt +4 -4
  128. package/src/layout/llm.txt +1 -1
  129. package/src/layout/tokens.txt +1 -1
  130. package/src/menu/llm.txt +19 -12
  131. package/src/menu/tokens.txt +21 -8
  132. package/src/message/llm.txt +1 -1
  133. package/src/message/tokens.txt +1 -1
  134. package/src/modal/llm.txt +9 -9
  135. package/src/modal/tokens.txt +1 -1
  136. package/src/notification/llm.txt +1 -1
  137. package/src/notification/tokens.txt +1 -1
  138. package/src/pagination/llm.txt +18 -9
  139. package/src/pagination/tokens.txt +6 -4
  140. package/src/popover/llm.txt +3 -3
  141. package/src/popover/tokens.txt +4 -14
  142. package/src/progress/llm.txt +4 -4
  143. package/src/progress/tokens.txt +1 -1
  144. package/src/radio/llm.txt +38 -1
  145. package/src/radio/tokens.txt +11 -6
  146. package/src/rate/llm.txt +1 -1
  147. package/src/rate/tokens.txt +1 -1
  148. package/src/select/llm.txt +8 -7
  149. package/src/select/tokens.txt +4 -4
  150. package/src/skeleton/llm.txt +1 -1
  151. package/src/skeleton/tokens.txt +1 -1
  152. package/src/spin/llm.txt +1 -1
  153. package/src/spin/tokens.txt +1 -1
  154. package/src/steps/llm.txt +1 -1
  155. package/src/steps/tokens.txt +1 -1
  156. package/src/switch/llm.txt +1 -1
  157. package/src/switch/tokens.txt +1 -1
  158. package/src/table/llm.txt +16 -13
  159. package/src/table/tokens.txt +2 -2
  160. package/src/tabs/llm.txt +1 -1
  161. package/src/tabs/tokens.txt +1 -1
  162. package/src/tag/llm.txt +7 -8
  163. package/src/tag/tokens.txt +1 -2
  164. package/src/tooltip/llm.txt +1 -1
  165. package/src/tooltip/tokens.txt +1 -1
  166. package/src/tree/llm.txt +11 -15
  167. package/src/tree/tokens.txt +1 -3
  168. package/src/tree-select/llm.txt +32 -22
  169. package/src/tree-select/tokens.txt +7 -6
  170. package/src/typography/llm.txt +1 -1
  171. package/src/typography/tokens.txt +1 -1
  172. package/src/upload/llm.txt +4 -2
  173. package/src/upload/tokens.txt +5 -1
package/dist/index.d.ts CHANGED
@@ -310,7 +310,7 @@ export declare const Breadcrumb: React_2.FC<BreadcrumbProps> & {
310
310
  Link: React_2.FC<BreadcrumbLinkProps>;
311
311
  };
312
312
 
313
- /** 自定义项渲染(对齐 antd) */
313
+ /** 自定义上级项渲染(当前页始终使用 `title`,避免生成可点击节点) */
314
314
  export declare type BreadcrumbItemRender = (route: BreadcrumbRouteItem, params: Record<string, string | number>, routes: BreadcrumbItemType[], paths: string[]) => React_2.ReactNode;
315
315
 
316
316
  /** 面包屑项 */
@@ -324,7 +324,7 @@ export declare const BreadcrumbLink: React_2.FC<BreadcrumbLinkProps>;
324
324
  /**
325
325
  * 单项链接(T2:`Slot` / `asChild`)
326
326
  *
327
- * - 默认类名对齐 Button `type="text"` 的 medium 尺寸,消费 `--button-text-default`
327
+ * - 默认类名使用 Button `text`(Figma subtle-text)的 medium 尺寸,上级链接有 Hover / Focus 反馈
328
328
  * - `className` / `style` 仅挂在最外层 `<a>` 或 `asChild` 合并后的子元素
329
329
  */
330
330
  export declare interface BreadcrumbLinkProps extends React_2.ComponentProps<'a'> {
@@ -366,13 +366,13 @@ export declare interface BreadcrumbRouteItem {
366
366
  type?: 'section';
367
367
  /** 展示名称(可内嵌图标) */
368
368
  title?: React_2.ReactNode;
369
- /** 链接;与 `path` 互斥,同时存在时优先 `href` */
369
+ /** 上级项链接;末项作为当前页始终不可点击。与 `path` 共存时优先 `href` */
370
370
  href?: string;
371
371
  /** 相对路径段;累加并支持 `:key` + `Breadcrumb.params` */
372
372
  path?: string;
373
373
  /** 该项最外层 DOM 的类名(`li` 或链接/文案壳层,非 `Breadcrumb` 根) */
374
374
  className?: string;
375
- /** 单击事件 */
375
+ /** 上级链接单击事件;末项不会绑定 */
376
376
  onClick?: React_2.MouseEventHandler<HTMLAnchorElement | HTMLElement>;
377
377
  }
378
378
 
@@ -389,7 +389,7 @@ export declare interface BreadcrumbSeparatorItem {
389
389
  separator?: React_2.ReactNode;
390
390
  }
391
391
 
392
- export declare function Button({ type, variant, tone, size, disabled, loading, loadingIcon, htmlType, href, target, asChild, icon, block, onClick, children, className, style, ref, ...restProps }: ButtonProps): React_2.JSX.Element;
392
+ export declare function Button({ type, variant, tone, size, disabled, loading, loadingIcon, htmlType, href, target, asChild, icon, suffixIcon, block, onClick, children, className, style, ref, ...restProps }: ButtonProps): React_2.JSX.Element;
393
393
 
394
394
  export declare namespace Button {
395
395
  var displayName: string;
@@ -423,16 +423,16 @@ export declare interface ButtonProps extends Omit<React_2.ButtonHTMLAttributes<H
423
423
  * - `main`: solid emphasis
424
424
  * - `outline`: bordered emphasis
425
425
  * - `secondary`: neutral filled action
426
- * - `text` / `link`: low-emphasis actions
427
- * - `icon`: icon-only action with hover fill
426
+ * - `text` / `text-secondary` / `link`: low-emphasis actions
427
+ * - `icon` / `icon-primary`: icon-only actions with hover fill
428
428
  * - `icon-transparent`: icon-only action, fully transparent background
429
429
  * @since 0.1.0
430
430
  */
431
431
  variant?: ButtonVariants['variant'];
432
432
  /**
433
433
  * Visual intent. `main`, `outline`, and `icon` support every tone;
434
- * `icon-transparent`, `secondary`, `text`, and `link` use `default`.
435
- * `secondary`, `text`, and `link` use `default`.
434
+ * `icon-primary`, `icon-transparent`, `secondary`, `text`,
435
+ * `text-secondary`, and `link` use `default`.
436
436
  * When omitted, the legacy `danger` type resolves to `error`; other types
437
437
  * resolve to `default`.
438
438
  * @since 0.1.0
@@ -493,6 +493,8 @@ export declare interface ButtonProps extends Omit<React_2.ButtonHTMLAttributes<H
493
493
  * 前置图标。loading 为 true 时此 prop 被 loading 指示器替换
494
494
  */
495
495
  icon?: React_2.ReactNode;
496
+ /** 尾部图标;loading 时仍保留在文案后方。 */
497
+ suffixIcon?: React_2.ReactNode;
496
498
  /**
497
499
  * 是否撑满父容器宽度(`display: flex; width: 100%`)
498
500
  * @default false
@@ -533,7 +535,7 @@ declare type ButtonVariants = VariantProps<typeof buttonVariants>;
533
535
  * TypeScript 会自动从这里推断 ButtonProps 的 variant 类型
534
536
  */
535
537
  declare const buttonVariants: (props?: ({
536
- variant?: "icon" | "secondary" | "text" | "link" | "main" | "outline" | "icon-transparent" | null | undefined;
538
+ variant?: "icon" | "secondary" | "text" | "link" | "main" | "outline" | "text-secondary" | "icon-primary" | "icon-transparent" | null | undefined;
537
539
  tone?: "default" | "success" | "warning" | "error" | null | undefined;
538
540
  size?: "small" | "medium" | null | undefined;
539
541
  block?: boolean | null | undefined;
@@ -560,6 +562,8 @@ export declare const Card: React_2.FC<CardProps>;
560
562
  * 根据是否传入 title/extra 自动切换「有标题」「无标题」两种形态。
561
563
  */
562
564
  export declare interface CardProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'title'> {
565
+ /** 卡片表面层级;primary 用于页面主容器,secondary 用于嵌套区域 */
566
+ variant?: 'primary' | 'secondary';
563
567
  /** 卡片标题,存在时渲染头部区域 */
564
568
  title?: React_2.ReactNode;
565
569
  /** 卡片右上角操作区域;与 title 任一存在即渲染 header */
@@ -3245,7 +3249,7 @@ export declare interface ModalProps {
3245
3249
  /**
3246
3250
  * 自定义宽度(px 数字或 CSS 长度);设置后覆盖 `size` 对应的宽度。
3247
3251
  * 面板高度按内容自然增长,不受宽度对应尺寸档的最小高度约束;超出视口时由外层容器整体滚动。
3248
- * 未显式传 `size` 时,数字或 px 宽度仍按 420 / 560 / 720 断点匹配尺寸样式。
3252
+ * 未显式传 `size` 时,数字或 px 宽度仍按 420 / 720 / 1000 断点匹配尺寸样式。
3249
3253
  * 兼容:`size` 省略时 `sm` / `md` 字符串仍按 `size` 处理。
3250
3254
  */
3251
3255
  width?: string | number;
@@ -3467,9 +3471,9 @@ export declare interface PaginationProps {
3467
3471
  * 未传 → total > 50 时自动 true;显式 false → 永远关;显式 true → 永远开
3468
3472
  */
3469
3473
  showSizeChanger?: boolean;
3470
- /** 显示快速跳转输入 @default false */
3474
+ /** 兼容旧调用方;当前 React 设计不渲染快速跳转输入 */
3471
3475
  showQuickJumper?: boolean;
3472
- /** 自定义总数显示函数;不传则不渲染总数区域 */
3476
+ /** 兼容旧调用方;当前 React 设计不渲染总数区域 */
3473
3477
  showTotal?: ShowTotalFn;
3474
3478
  /** 总页数 ≤ 1 时不渲染整个组件 @default false */
3475
3479
  hideOnSinglePage?: boolean;
@@ -5149,13 +5153,13 @@ export declare interface TableProps<RecordType = Record<string, unknown>> extend
5149
5153
  rowKey?: RowKey<RecordType>;
5150
5154
  /**
5151
5155
  * 加载态;普通表格用 3 行骨架占位,`scroll.y` / `flexHeight` 场景按表体可用高度自动填满。
5152
- * 骨架行高跟随 `size`(`--table-size-height-content` + block padding,视觉 28/32/40),加载时替换数据行。
5156
+ * 骨架行高跟随 `size`(`--table-size-height-content` + block padding,视觉 32/40/40),加载时替换数据行。
5153
5157
  * @default false
5154
5158
  */
5155
5159
  loading?: boolean;
5156
5160
  /**
5157
- * 尺寸;`small` / `medium` / `large` 对应 token 的 sm / md / la。
5158
- * 单元格内容区最小高度为 `--table-size-height-content`,加上 `--table-spacing-padding-y` 后视觉下限 28/32/40。
5161
+ * 尺寸;`small` 使用 block-md token,`medium` / `large` 使用 block-la token。
5162
+ * 单元格内容区最小高度为 `--table-size-height-content`,加上 `--table-spacing-padding-y` 后视觉下限 32/40/40。
5159
5163
  * 表体可继续被内容撑高,不锁死行高。
5160
5164
  * 字号全 size 一致:表头 `text-*-body`(14/20),内容 `text-*-caption`(12/18)。
5161
5165
  * 非 `ellipsis` 纯文本列可多行撑高;`ellipsis` 纯文本列保持单行截断。
@@ -5235,8 +5239,8 @@ export declare interface TableProps<RecordType = Record<string, unknown>> extend
5235
5239
  /**
5236
5240
  * 行选择配置。受控 / 非受控双轨;变化时同步触发 `onChange`。
5237
5241
  *
5238
- * 开启后注入单列 `__apex_selection__`:默认与序号合并(显示行号,行 hover / 已选 / 焦点时切换为选择控件);
5239
- * 设 `showIndex: false` 可恢复为始终显示 checkbox / radio。
5242
+ * 开启后注入单列 `__apex_selection__`,默认始终显示 checkbox / radio;
5243
+ * 设 `showIndex: true` 才将序号与选择列合并(行 hover / 已选 / 焦点时切换为选择控件)。
5240
5244
  */
5241
5245
  export declare interface TableRowSelection<RecordType = Record<string, unknown>> {
5242
5246
  /**
@@ -5262,9 +5266,9 @@ export declare interface TableRowSelection<RecordType = Record<string, unknown>>
5262
5266
  */
5263
5267
  hideSelectAll?: boolean;
5264
5268
  /**
5265
- * 是否将序号与选择列合并:默认显示序号,行 hover / 已选 / 键盘焦点时切换为选择控件。
5269
+ * 是否将序号与选择列合并:启用后默认显示序号,行 hover / 已选 / 键盘焦点时切换为选择控件。
5266
5270
  * 序号按当前页连续编号(分页时为全局序号:`(current - 1) * pageSize + index + 1`)。
5267
- * @default true
5271
+ * @default false
5268
5272
  */
5269
5273
  showIndex?: boolean;
5270
5274
  /** 固定选择列方向;须配合 `scroll.x` 与数字 `columnWidth` 使用 */
@@ -5470,7 +5474,7 @@ export declare namespace Tag {
5470
5474
 
5471
5475
  export declare type TagColor = TagPresetColor | string;
5472
5476
 
5473
- export declare type TagPresetColor = 'default' | 'brand' | 'success' | 'warning' | 'error';
5477
+ export declare type TagPresetColor = 'default' | 'brand' | 'success' | 'warning' | 'error' | 'grey';
5474
5478
 
5475
5479
  /**
5476
5480
  * Tag 组件属性。
@@ -5489,7 +5493,7 @@ export declare interface TagProps extends Omit<React_2.HTMLAttributes<HTMLElemen
5489
5493
  * 标签色(支持预设值与自定义色字符串)。
5490
5494
  * 自定义字符串会作为 `backgroundColor` / `borderColor` 注入 inline style;
5491
5495
  * `data-color` 同步输出原始值,便于消费方覆盖。
5492
- * @default 'default'
5496
+ * @default 'grey'
5493
5497
  */
5494
5498
  color?: TagColor;
5495
5499
  /**