tango-ui-cw 1.0.10 → 1.2.0

package/dist/component/TTable/index.d.ts

@@ -1,76 +1,117 @@
-import type { CSSProperties, ReactNode } from "react";
-import type { SxValue } from "../CSSFab";
-
-/** 列定义 */
-export interface TableColumn<T = Record<string, unknown>> {
-  title: string;
-  dataIndex: string;
-  key?: string | number;
-  width?: string | number;
-  hide?: boolean;
-  render?: (value: unknown, row: T, rowIndex: number) => ReactNode;
-}
-
-/** 分页配置 */
-export interface TablePagination {
-  /** 翻页栏位置，默认 "bottom" */
-  placement?: "top" | "bottom";
-  /** 每页条数，默认 10 */
-  pageSize?: number;
-  /** 每页条数选项，默认 [10, 20, 50, 100] */
-  pageSizeOptions?: number[];
-  /** 是否显示总数，默认 true */
-  showTotal?: boolean;
-  /** 是否显示条/页切换，默认 true */
-  showSizeChanger?: boolean;
-}
-
-/** i18n 覆盖字段 */
-export interface TableLocaleText {
-  empty?: string;
-  prev?: string;
-  next?: string;
-  page?: string;
-  total?: string;
-  perPage?: string;
-  [key: string]: string | undefined;
-}
-
-export interface TableProps {
-  /** 数据源 */
-  dataSource?: Record<string, unknown>[];
-  /** 列定义 */
-  columns?: TableColumn[];
-  /** sx 样式扩展 */
-  sx?: SxValue;
-  /** 行内样式 */
-  style?: CSSProperties;
-  /** 额外 CSS 类名 */
-  className?: string;
-  /** 分页配置，不传或 false 不分页 */
-  pagination?: TablePagination | false | null;
-  /** 隐藏列，支持 dataIndex 数组或单个字符串 */
-  hide?: string[] | string;
-  /** 行 className，支持函数 (row, rowIndex, rowParity) => string */
-  rowClassName?: ((row: Record<string, unknown>, rowIndex: number, rowParity: "even" | "odd") => string) | string;
-  /** 行 style，支持函数 (row, rowIndex, rowParity) => CSSProperties */
-  rowStyle?: ((row: Record<string, unknown>, rowIndex: number, rowParity: "even" | "odd") => CSSProperties) | CSSProperties;
-  /** 单元格 className，支持函数 (row, col, rowIndex, colIndex, rowParity, colParity) => string */
-  cellClassName?:
-    | ((row: Record<string, unknown>, col: TableColumn, rowIndex: number, colIndex: number, rowParity: "even" | "odd", colParity: "even" | "odd") => string)
-    | string;
-  /** 单元格 style，支持函数 */
-  cellStyle?:
-    | ((row: Record<string, unknown>, col: TableColumn, rowIndex: number, colIndex: number, rowParity: "even" | "odd", colParity: "even" | "odd") => CSSProperties)
-    | CSSProperties;
-  /** 自定义 hover 颜色（覆盖默认主题 hover） */
-  hoverColor?: string;
-  /** i18n key */
-  i18nKey?: string;
-  /** 覆盖内置文案 */
-  localeText?: TableLocaleText;
-}
-
-declare function Table(props: TableProps): JSX.Element;
-
-export default Table;
+/** Table sx slot 名列表 */
+export type TableSlotNames = readonly ["root", "wrapper", "thead", "headerCell", "body", "row", "cell", "empty", "pagination", "loading", "footer"];
+
+import type { CSSProperties, ReactNode } from "react";
+import type { SxValue } from "../CSSFab";
+
+/** 列定义 */
+export interface TableColumn<T = Record<string, unknown>> {
+  title: string;
+  dataIndex: string;
+  key?: string | number;
+  width?: string | number;
+  hide?: boolean;
+  // added by clayw on 20260623
+  /** 是否开启数字排序，默认 false */
+  sortable?: boolean;
+  // added by clayw on 20260623
+  /** 是否固定列，最后一列 fixed=true 固定右侧，其余固定左侧，默认 false */
+  fixed?: boolean;
+  render?: (value: unknown, row: T, rowIndex: number) => ReactNode;
+}
+
+/** 分页配置 */
+export interface TablePagination {
+  /** 翻页栏位置，默认 "bottom" */
+  placement?: "top" | "bottom";
+  /** 每页条数，默认 10 */
+  pageSize?: number;
+  /** 每页条数选项，默认 [10, 20, 50, 100] */
+  pageSizeOptions?: number[];
+  /** 是否显示总数，默认 true */
+  showTotal?: boolean;
+  /** 是否显示条/页切换，默认 true */
+  showSizeChanger?: boolean;
+}
+
+// added by clayw on 20260624
+/** 行选择配置 */
+export interface TableRowSelection<T = Record<string, unknown>> {
+  /** 选择类型，仅支持 checkbox */
+  type?: "checkbox";
+  /** 受控选中的行 key 列表 */
+  selectedRowKeys?: (string | number)[];
+  /** 选择变化回调 */
+  onChange?: (selectedRowKeys: (string | number)[], selectedRows: T[]) => void;
+  /** 是否固定选择列，默认 true（横向滚动时选择列始终可见）；设为 false 取消固定 */
+  fixed?: boolean;
+  /** 选择列宽度，默认 50 */
+  width?: string | number;
+}
+
+/** i18n 覆盖字段 */
+export interface TableLocaleText {
+  empty?: string;
+  prev?: string;
+  next?: string;
+  page?: string;
+  total?: string;
+  perPage?: string;
+  // added by clayw on 20260624
+  /** 行选择 footer 计数模板，支持 {total} 和 {selected} 占位 */
+  selectedSummary?: string;
+  /** 全选复选框 aria-label */
+  selectAll?: string;
+  /** 行选择复选框 aria-label */
+  selectRow?: string;
+  [key: string]: string | undefined;
+}
+
+export interface TableProps {
+  /** 数据源 */
+  dataSource?: Record<string, unknown>[];
+  /** 列定义 */
+  columns?: TableColumn[];
+  /** sx 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 分页配置，不传或 false 不分页 */
+  pagination?: TablePagination | false | null;
+  /** 隐藏列，支持 dataIndex 数组或单个字符串 */
+  hide?: string[] | string;
+  /** 行 className，支持函数 (row, rowIndex, rowParity) => string */
+  rowClassName?: ((row: Record<string, unknown>, rowIndex: number, rowParity: "even" | "odd") => string) | string;
+  /** 行 style，支持函数 (row, rowIndex, rowParity) => CSSProperties */
+  rowStyle?: ((row: Record<string, unknown>, rowIndex: number, rowParity: "even" | "odd") => CSSProperties) | CSSProperties;
+  /** 单元格 className，支持函数 (row, col, rowIndex, colIndex, rowParity, colParity) => string */
+  cellClassName?:
+    | ((row: Record<string, unknown>, col: TableColumn, rowIndex: number, colIndex: number, rowParity: "even" | "odd", colParity: "even" | "odd") => string)
+    | string;
+  /** 单元格 style，支持函数 */
+  cellStyle?:
+    | ((row: Record<string, unknown>, col: TableColumn, rowIndex: number, colIndex: number, rowParity: "even" | "odd", colParity: "even" | "odd") => CSSProperties)
+    | CSSProperties;
+  /** 自定义 hover 颜色（覆盖默认主题 hover） */
+  hoverColor?: string;
+  // added by clayw on 20260624
+  /** 加载状态，默认自动模式：dataSource 为空时显示骨架屏；传 true 强制骨架屏；传 false 关闭骨架屏 */
+  loading?: boolean;
+  // added by clayw on 20260624
+  /** 行选择配置 */
+  rowSelection?: TableRowSelection;
+  // added by clayw on 20260624
+  /** 行事件，参考 AntD 写法：(record, rowIndex) => ({ onClick: event => {}, onDoubleClick: event => {} }) */
+  onRow?: (record: Record<string, unknown>, rowIndex: number) => React.HTMLAttributes<HTMLTableRowElement>;
+  /** i18n key */
+  i18nKey?: string;
+  /** 覆盖内置文案 */
+  localeText?: TableLocaleText;
+}
+
+declare function Table(props: TableProps): JSX.Element;
+
+export default Table;
+

package/dist/component/TTooltip/index.d.ts

@@ -1,31 +1,34 @@
-import type { CSSProperties, ReactNode } from "react";
-import type { SxValue } from "../CSSFab";
-
-export type TooltipPlacement = "top" | "bottom" | "left" | "right";
-
-export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
-  /** 触发元素 */
-  children?: ReactNode;
-  /** 提示内容 */
-  title?: ReactNode;
-  /** 弹出方向 */
-  placement?: TooltipPlacement;
-  /** 受控模式：是否可见 */
-  open?: boolean;
-  /** 非受控默认是否可见 */
-  defaultOpen?: boolean;
-  /** 可见状态变化回调 */
-  onOpenChange?: (open: boolean) => void;
-  /** 是否禁用提示 */
-  disabled?: boolean;
-  /** 样式扩展 */
-  sx?: SxValue;
-  style?: CSSProperties;
-  className?: string;
-}
-
-declare const Tooltip: React.ForwardRefExoticComponent<
-  TooltipProps & React.RefAttributes<HTMLDivElement>
->;
-
-export default Tooltip;
+import type { CSSProperties, ReactNode } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type TooltipSlotNames = readonly ["root", "tooltip"];
+export type TooltipPlacement = "top" | "bottom" | "left" | "right";
+
+export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+  /** 触发元素 */
+  children?: ReactNode;
+  /** 提示内容 */
+  title?: ReactNode;
+  /** 弹出方向 */
+  placement?: TooltipPlacement;
+  /** 受控模式：是否可见 */
+  open?: boolean;
+  /** 非受控默认是否可见 */
+  defaultOpen?: boolean;
+  /** 可见状态变化回调 */
+  onOpenChange?: (open: boolean) => void;
+  /** 是否禁用提示 */
+  disabled?: boolean;
+  /** z-index 层叠顺序，默认 50 */
+  zIndex?: number;
+  /** 样式扩展 */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+}
+
+declare const Tooltip: React.ForwardRefExoticComponent<
+  TooltipProps & React.RefAttributes<HTMLDivElement>
+>;
+
+export default Tooltip;

package/dist/component/TUpload/index.d.ts

@@ -1,45 +1,74 @@
-import type { CSSProperties, ReactNode } from "react";
-
-export interface UploadProps {
-  /** 样式扩展（字符串/对象/slot） */
-  sx?: string | object;
-  /** 行内样式 */
-  style?: CSSProperties;
-  /** 额外 CSS 类名 */
-  className?: string;
-  /** 允许的文件类型（同 HTML accept 属性） */
-  accept?: string;
-  /** 是否多选 */
-  multiple?: boolean;
-  /** 文件变化回调 */
-  onChange?: (files: File[]) => void;
-  /** 上传前校验，返回 false 阻止，返回 LIST_IGNORE 不展示 */
-  beforeUpload?: (file: File, fileList: File[]) => boolean | Promise<boolean | symbol | File | Blob | undefined>;
-  /** 受控文件列表 */
-  files?: File[];
-  /** 是否显示文件列表 */
-  showUploadList?: boolean;
-  /** 多选时最大文件数 */
-  maxCount?: number;
-  /** 单文件最大体积（MB） */
-  maxSize?: number;
-  /** 选择按钮文字 */
-  btnText?: string;
-  /** 选择按钮样式 */
-  btnStyle?: CSSProperties;
-  /** 是否显示文件大小 */
-  showSize?: boolean;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 子元素 */
-  children?: ReactNode;
-}
-
-/** beforeUpload 返回此值时，文件不展示在列表中 */
-export const LIST_IGNORE: unique symbol;
-
-declare const Upload: ((props: UploadProps) => JSX.Element) & {
-  LIST_IGNORE: typeof LIST_IGNORE;
-};
-
-export default Upload;
+import type { CSSProperties } from "react";
+
+/** Upload sx slot 名列表 */
+export type UploadSlotNames = readonly ["root", "button", "list", "item", "dragger", "preview"];
+
+// added by clayw on 20260624: Upload i18n 文案类型
+export interface UploadLocaleText {
+  /** 选择按钮文字 */
+  btnText?: string;
+  /** 拖拽区域提示文字 */
+  dragPlaceholder?: string;
+  /** 拖拽悬停时提示文字 */
+  dragActivePlaceholder?: string;
+}
+
+export interface UploadProps {
+  /** 样式扩展（字符串/对象/slot） */
+  sx?: string | object;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 允许的文件类型（同 HTML accept 属性） */
+  accept?: string;
+  /** 是否多选 */
+  multiple?: boolean;
+  /** 文件变化回调 */
+  onChange?: (files: File[]) => void;
+  /** 上传前校验，返回 false 阻止，返回 LIST_IGNORE 不展示 */
+  beforeUpload?: (file: File, fileList: File[]) => boolean | Promise<boolean | symbol | File | Blob | undefined>;
+  /** 受控文件列表 */
+  files?: File[];
+  /** 是否显示文件列表 */
+  showUploadList?: boolean;
+  /** 多选时最大文件数 */
+  maxCount?: number;
+  /** 单文件最大体积（MB） */
+  maxSize?: number;
+  /** 选择按钮文字（覆盖 i18n 默认） */
+  btnText?: string;
+  /** 选择按钮样式 */
+  btnStyle?: CSSProperties;
+  /** 是否显示文件大小 */
+  showSize?: boolean;
+  /** 是否禁用 */
+  disabled?: boolean;
+  // added by clayw on 20260624: 拖拽上传新增 props
+  /** 是否启用拖拽上传（启用后渲染拖拽区域代替按钮） */
+  draggable?: boolean;
+  /** 拖拽区域提示文字（覆盖 i18n 默认） */
+  dragPlaceholder?: string;
+  /** 拖拽文件悬停时提示文字（覆盖 i18n 默认） */
+  dragActivePlaceholder?: string;
+  // added by clayw on 20260624: i18n 文案覆盖
+  /** i18n 文案覆盖，优先级高于 prop 和 i18n Provider */
+  localeText?: UploadLocaleText;
+  // added by clayw on 20260624: 预览 + loading 新增 props
+  /** 是否显示图片缩略图预览（原生 img 实现，后续可用 Image 组件替换） */
+  preview?: boolean;
+  /** 是否显示上传中状态（按钮模式传 Button loading，拖拽模式显示 spinner overlay） */
+  loading?: boolean;
+}
+
+/** beforeUpload 返回此值时，文件不展示在列表中 */
+export const LIST_IGNORE: unique symbol;
+
+// added by clayw on 20260624: Upload i18n key 类型
+export type UploadI18nKey = "upload.btnText" | "upload.dragPlaceholder" | "upload.dragActivePlaceholder";
+
+declare const Upload: ((props: UploadProps) => JSX.Element) & {
+  LIST_IGNORE: typeof LIST_IGNORE;
+};
+
+export default Upload;