tango-ui-cw 0.9.9 → 1.0.1

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

@@ -0,0 +1,133 @@
+import type {
+  CSSProperties,
+  HTMLAttributes,
+  ReactNode,
+  Ref,
+} from "react";
+
+/** sx 值类型（引用自 CSSFab） */
+export type SxValue =
+  | string
+  | { tw?: string; className?: string; css?: CSSProperties; style?: CSSProperties }
+  | Record<string, unknown>;
+
+/** Layout 主容器 Props */
+export interface LayoutProps extends Omit<HTMLAttributes<HTMLElement>, "style"> {
+  /** 是否包含侧边栏（不传则自动检测 Sider 子组件） */
+  hasSider?: boolean;
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 子元素 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLElement>;
+}
+
+/** Header Props */
+export interface LayoutHeaderProps extends Omit<HTMLAttributes<HTMLElement>, "style"> {
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 子元素 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLElement>;
+}
+
+/** Footer Props */
+export interface LayoutFooterProps extends Omit<HTMLAttributes<HTMLElement>, "style"> {
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 子元素 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLElement>;
+}
+
+/** Sider Props */
+export interface LayoutSiderProps extends Omit<HTMLAttributes<HTMLElement>, "style"> {
+  /** 侧边栏宽度，默认取 --layout-sider-width */
+  width?: string | number;
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 子元素 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLElement>;
+}
+
+/** Content Props */
+export interface LayoutContentProps extends Omit<HTMLAttributes<HTMLElement>, "style"> {
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 子元素 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLElement>;
+}
+
+/** Toc Props（右侧目录导航） */
+export interface LayoutTocProps extends Omit<HTMLAttributes<HTMLElement>, "style"> {
+  /** 目录导航宽度，默认取 --layout-toc-width */
+  width?: string | number;
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 子元素 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLElement>;
+}
+
+/** Layout 复合组件类型 */
+interface LayoutComponent
+  extends React.ForwardRefExoticComponent<
+    LayoutProps & React.RefAttributes<HTMLElement>
+  > {
+  Header: React.ForwardRefExoticComponent<
+    LayoutHeaderProps & React.RefAttributes<HTMLElement>
+  >;
+  Footer: React.ForwardRefExoticComponent<
+    LayoutFooterProps & React.RefAttributes<HTMLElement>
+  >;
+  Sider: React.ForwardRefExoticComponent<
+    LayoutSiderProps & React.RefAttributes<HTMLElement>
+  >;
+  Content: React.ForwardRefExoticComponent<
+    LayoutContentProps & React.RefAttributes<HTMLElement>
+  >;
+  Toc: React.ForwardRefExoticComponent<
+    LayoutTocProps & React.RefAttributes<HTMLElement>
+  >;
+}
+
+export declare const Header: LayoutComponent["Header"];
+export declare const Footer: LayoutComponent["Footer"];
+export declare const Sider: LayoutComponent["Sider"];
+export declare const Content: LayoutComponent["Content"];
+export declare const Toc: LayoutComponent["Toc"];
+
+declare const Layout: LayoutComponent;
+export default Layout;

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

@@ -0,0 +1,33 @@
+import type {
+  CSSProperties,
+  HTMLAttributes,
+  ReactNode,
+  Ref,
+} from "react";
+
+/** sx 值类型 */
+export type SxValue =
+  | string
+  | { tw?: string; className?: string; css?: CSSProperties; style?: CSSProperties }
+  | Record<string, unknown>;
+
+/** Line Props */
+export interface LineProps extends Omit<HTMLAttributes<HTMLDivElement>, "style"> {
+  /** 分隔线间距尺寸 */
+  size?: "small" | "medium" | "large" | "huge";
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 分隔线中间文本，不传则显示纯线 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLDivElement>;
+}
+
+declare const Line: React.ForwardRefExoticComponent<
+  LineProps & React.RefAttributes<HTMLDivElement>
+>;
+export default Line;

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

@@ -0,0 +1,38 @@
+import type {
+  CSSProperties,
+  HTMLAttributes,
+  ReactNode,
+  Ref,
+} from "react";
+
+/** sx 值类型 */
+export type SxValue =
+  | string
+  | { tw?: string; className?: string; css?: CSSProperties; style?: CSSProperties }
+  | Record<string, unknown>;
+
+/** Mark 高亮标记颜色预设 */
+export type MarkColor = "default" | "primary" | "success" | "warning" | "danger";
+
+/** Mark Props */
+export interface MarkProps extends Omit<HTMLAttributes<HTMLElement>, "style"> {
+  /** 高亮颜色预设 */
+  color?: MarkColor;
+  /** 是否启用美化模式（圆角+内边距） */
+  beauty?: boolean;
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 标记内容 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLElement>;
+}
+
+declare const Mark: React.ForwardRefExoticComponent<
+  MarkProps & React.RefAttributes<HTMLElement>
+>;
+export default Mark;

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

@@ -0,0 +1,52 @@
+import type { CSSProperties, HTMLAttributes, ReactNode } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type ModalI18nKey = "title" | "okText" | "cancelText" | "closeAriaLabel" | (string & {});
+
+export type ModalLocaleText = Partial<{
+  title: string;
+  okText: string;
+  cancelText: string;
+  closeAriaLabel: string;
+}>;
+
+export type ModalFooterButton = {
+  key: string;
+  text: string;
+  onClick: () => void;
+};
+
+export interface ModalProps
+  extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "style" | "className"> {
+  /** 模态框内容 */
+  children?: ReactNode;
+  /** 标题，优先级高于 i18n */
+  title?: string;
+  /** 确定按钮文案，优先级高于 i18n */
+  okText?: string;
+  /** 取消按钮文案，优先级高于 i18n */
+  cancelText?: string;
+  /** 是否打开 */
+  open?: boolean;
+  /** 关闭回调 */
+  onClose?: () => void;
+  /** 确定回调，若未传则默认调用 onClose */
+  onOk?: () => void;
+  /** 容器宽度 */
+  width?: string | number;
+  /** Style extension via CSSFab sx */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  /** 点击遮罩是否关闭 */
+  maskClosable?: boolean;
+  /** 自定义底部按钮，传入后替代默认的取消/确定 */
+  footerButtons?: ModalFooterButton[];
+  /** 覆盖 locale 文案 */
+  localeText?: ModalLocaleText;
+}
+
+declare function Modal(props: ModalProps): JSX.Element;
+
+export { Modal };
+export default Modal;

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

@@ -0,0 +1,30 @@
+import type { CSSProperties, ReactNode } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type NoticeType = "success" | "fail" | "caution";
+export type NoticeVariant = "default" | "md";
+
+export interface NoticeProps extends React.HTMLAttributes<HTMLDivElement> {
+  /** 通知类型 */
+  type?: NoticeType;
+  /** 图标（default 模式显示，md 模式隐藏） */
+  icon?: ReactNode;
+  /** 通知内容 */
+  message?: ReactNode;
+  /** 变体：default 顶部居中，md 左下角 */
+  variant?: NoticeVariant;
+  /** 自动关闭时间（ms），0 或不传则不自动关闭 */
+  duration?: number;
+  /** 关闭回调 */
+  onClose?: () => void;
+  /** 样式扩展 */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+}
+
+declare const Notice: React.ForwardRefExoticComponent<
+  NoticeProps & React.RefAttributes<HTMLDivElement>
+>;
+
+export default Notice;

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

@@ -0,0 +1,42 @@
+import type { CSSProperties, HTMLAttributes } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type SearchSize = "small" | "medium" | "large" | "huge";
+
+export type SearchI18nKey = "placeholder" | "btnText" | (string & {});
+
+export type SearchLocaleText = Partial<{
+  placeholder: string;
+  btnText: string;
+}>;
+
+export interface SearchProps
+  extends Omit<HTMLAttributes<HTMLInputElement>, "style" | "className" | "onSearch" | "placeholder"> {
+  /** 尺寸 */
+  size?: SearchSize;
+  /** Style extension via CSSFab sx */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  /** 搜索回调，参数为输入框当前值 */
+  onSearch?: (value: string) => void;
+  /** 受控值 */
+  value?: string;
+  /** 非受控默认值 */
+  defaultValue?: string;
+  /** 是否禁用 */
+  disabled?: boolean;
+  /** 占位文案，优先级高于 i18n */
+  placeholder?: string;
+  /** 搜索按钮文案，优先级高于 i18n */
+  btnText?: string;
+  /** 搜索按钮图标路径，传入后替代 btnText */
+  path?: string;
+  /** 覆盖 locale 文案 */
+  localeText?: SearchLocaleText;
+}
+
+declare function Search(props: SearchProps): JSX.Element;
+
+export { Search };
+export default Search;

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

@@ -0,0 +1,56 @@
+import type {
+  CSSProperties,
+  HTMLAttributes,
+  ReactNode,
+  Ref,
+} from "react";
+
+/** Space 布局变体 */
+export type SpaceType =
+  | "default"
+  | "inline"
+  | "circle"
+  | "triangle"
+  | "halfCircle"
+  | "fixed"
+  | "absolute"
+  | "relative";
+
+/** sx 单个 slot 值 */
+export interface SxSlotValue {
+  tw?: string;
+  className?: string;
+  css?: CSSProperties;
+  style?: CSSProperties;
+}
+
+/** sx 字符串 / 对象 / slot */
+export type SxValue =
+  | string
+  | SxSlotValue
+  | Record<string, SxSlotValue | string | undefined>;
+
+export interface SpaceProps
+  extends Omit<HTMLAttributes<HTMLDivElement>, "style"> {
+  /** 布局变体 */
+  type?: SpaceType;
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 子元素 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLDivElement>;
+}
+
+/** 默认导出：Space 组件 */
+declare const Space: React.ForwardRefExoticComponent<
+  SpaceProps & React.RefAttributes<HTMLDivElement>
+>;
+
+export default Space;
+
+export type { SpaceType, SxValue, SxSlotValue };

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

@@ -0,0 +1,76 @@
+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;

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

@@ -0,0 +1,31 @@
+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;

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

@@ -0,0 +1,45 @@
+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;

package/dist/component/index.d.ts

@@ -0,0 +1,147 @@
+export {
+  Button,
+  MaterialButton,
+  type MaterialButtonLocaleText,
+  type MaterialButtonProps,
+  type MaterialButtonSize,
+  type MaterialButtonVariant,
+  type ButtonI18nKey,
+  type ButtonLocaleText,
+  type ButtonProps,
+  type ButtonSize,
+  type ButtonVariant,
+  type LoadingMode,
+  default as TangoButton,
+} from "./TButton";
+
+export {
+  Banner,
+  type BannerI18nKey,
+  type BannerLevel,
+  type BannerLocaleText,
+  type BannerProps,
+  type BannerSize,
+  default as TangoBanner,
+} from "./TBanner";
+
+export {
+  ColorPicker,
+  type ColorPickerFormat,
+  type ColorPickerI18nKey,
+  type ColorPickerLocaleText,
+  type ColorPickerProps,
+  type ColorPickerShowText,
+  type ColorPickerSize,
+  default as TangoColorPicker,
+} from "./TColorPicker";
+export {
+  DateDisplay,
+  type DateI18nKey,
+  type DateLocaleText,
+  type DateProps,
+  type DateType,
+  default as TangoDate,
+} from "./TDate";
+export {
+  DatePicker,
+  type DatePickerI18nKey,
+  type DatePickerLocaleText,
+  type DatePickerProps,
+  type DatePickerSize,
+  default as TangoDatePicker,
+} from "./TDatePicker";
+export {
+  Drawer,
+  type DrawerFooterButton,
+  type DrawerI18nKey,
+  type DrawerLocaleText,
+  type DrawerProps,
+  type DrawerType,
+  default as TangoDrawer,
+} from "./TDrawer";
+export {
+  Input,
+  MaterialInput,
+  type MaterialInputLocaleText,
+  type MaterialInputProps,
+  type MaterialInputSize,
+  type InputProps,
+  type InputSize,
+  type InputStatus,
+  type InputType,
+  default as TangoInput,
+} from "./TInput";
+export {
+  default as Layout,
+  Header,
+  Footer,
+  Sider,
+  Content,
+  Toc,
+  type LayoutProps,
+  type LayoutHeaderProps,
+  type LayoutFooterProps,
+  type LayoutSiderProps,
+  type LayoutContentProps,
+  type LayoutTocProps,
+} from "./TLayout";
+export {
+  default as Line,
+  type LineProps,
+} from "./TLine";
+
+export {
+  default as Mark,
+  type MarkColor,
+  type MarkProps,
+} from "./TMark";
+export {
+  Modal,
+  type ModalFooterButton,
+  type ModalI18nKey,
+  type ModalLocaleText,
+  type ModalProps,
+  default as TangoModal,
+} from "./TModal";
+export {
+  default as Notice,
+  type NoticeType,
+  type NoticeVariant,
+  type NoticeProps,
+  default as TangoNotice,
+} from "./TNotice";
+export {
+  Search,
+  type SearchI18nKey,
+  type SearchLocaleText,
+  type SearchProps,
+  type SearchSize,
+  default as TangoSearch,
+} from "./TSearch";
+export {
+  default as Space,
+  type SpaceProps,
+  type SpaceType,
+  type SxSlotValue,
+  type SxValue,
+} from "./TSpace";
+export {
+  default as Table,
+  type TableColumn,
+  type TableLocaleText,
+  type TablePagination,
+  type TableProps,
+} from "./TTable";
+export {
+  default as Tooltip,
+  type TooltipPlacement,
+  type TooltipProps,
+  default as TangoTooltip,
+} from "./TTooltip";
+export {
+  default as Upload,
+  type UploadProps,
+  default as TangoUpload,
+} from "./TUpload";
+
+export * from "./CSSFab";