tango-ui-cw 1.0.10 → 1.2.0

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

@@ -1,107 +1,109 @@
-import type {
-  ButtonHTMLAttributes,
-  CSSProperties,
-  ElementType,
-  ReactNode,
-} from "react";
-import type { SxValue } from "../CSSFab";
-
-export type ButtonVariant = "default" | "transparent" | "danger" | "success";
-export type ButtonSize = "small" | "medium" | "large" | "huge";
-export type LoadingMode = boolean | "light" | "dark" | [boolean | "light" | "dark", "light" | "dark"];
-export type ButtonI18nKey =
-  | "default"
-  | "loading"
-  | "submit"
-  | "confirm"
-  | "cancel"
-  | "search"
-  | "save"
-  | "delete"
-  | "back"
-  | "next"
-  | "prev"
-  | "add"
-  | (string & {});
-
-export type ButtonLocaleText = Partial<
-  Record<
-    | "default"
-    | "loading"
-    | "iconAlt"
-    | "submit"
-    | "confirm"
-    | "cancel"
-    | "search"
-    | "save"
-    | "delete"
-    | "back"
-    | "next"
-    | "prev"
-    | "add"
-    | string,
-    string
-  >
->;
-
-export interface ButtonProps
-  extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "style" | "className" | "children"> {
-  type?: ButtonVariant;
-  size?: ButtonSize;
-  sx?: SxValue;
-  style?: CSSProperties;
-  className?: string;
-  children?: ReactNode;
-  disabled?: boolean;
-  outline?: boolean;
-  icon?: ElementType | ReactNode | string;
-  iconPosition?: "left" | "right";
-  loading?: LoadingMode;
-  i18nKey?: ButtonI18nKey;
-  localeText?: ButtonLocaleText;
-}
-
-declare function Button(props: ButtonProps): JSX.Element;
-
-// MaterialButton 类型
-export type MaterialButtonVariant = "default" | "transparent" | "danger" | "success";
-export type MaterialButtonSize = "small" | "medium" | "large" | "huge";
-
-export interface MaterialButtonLocaleText {
-  default?: string;
-  loading?: string;
-  iconAlt?: string;
-  [key: string]: string | undefined;
-}
-
-export interface MaterialButtonProps
-  extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "style" | "className" | "children"> {
-  type?: MaterialButtonVariant;
-  size?: MaterialButtonSize;
-  sx?: SxValue;
-  style?: CSSProperties;
-  className?: string;
-  children?: ReactNode;
-  disabled?: boolean;
-  outline?: boolean;
-  icon?: ElementType | ReactNode | string;
-  iconPosition?: "left" | "right";
-  loading?: LoadingMode;
-  i18nKey?: string;
-  localeText?: MaterialButtonLocaleText;
-  /** 涟漪颜色，默认使用 --material-button-ripple */
-  rippleColor?: string;
-}
-
-declare function MaterialButton(props: MaterialButtonProps): JSX.Element;
-
-// antd 风格：Button.MaterialButton / const { MaterialButton } = Button
-interface ButtonNamespace {
-  (props: ButtonProps): JSX.Element;
-  MaterialButton: typeof MaterialButton;
-}
-
-declare const ButtonWithType: ButtonNamespace;
-export { ButtonWithType as Button };
-export { MaterialButton };
-export default Button;
+import type {
+  ButtonHTMLAttributes,
+  CSSProperties,
+  ElementType,
+  ReactNode,
+} from "react";
+import type { SxValue } from "../CSSFab";
+
+export type ButtonSlotNames = readonly ["root", "content", "icon", "loading"];
+export type ButtonVariant = "default" | "transparent" | "danger" | "success";
+export type ButtonSize = "small" | "medium" | "large" | "huge";
+export type LoadingMode = boolean | "light" | "dark" | [boolean | "light" | "dark", "light" | "dark"];
+export type ButtonI18nKey =
+  | "default"
+  | "loading"
+  | "submit"
+  | "confirm"
+  | "cancel"
+  | "search"
+  | "save"
+  | "delete"
+  | "back"
+  | "next"
+  | "prev"
+  | "add"
+  | (string & {});
+
+export type ButtonLocaleText = Partial<
+  Record<
+    | "default"
+    | "loading"
+    | "iconAlt"
+    | "submit"
+    | "confirm"
+    | "cancel"
+    | "search"
+    | "save"
+    | "delete"
+    | "back"
+    | "next"
+    | "prev"
+    | "add"
+    | string,
+    string
+  >
+>;
+
+export interface ButtonProps
+  extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "style" | "className" | "children"> {
+  type?: ButtonVariant;
+  size?: ButtonSize;
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  children?: ReactNode;
+  disabled?: boolean;
+  outline?: boolean;
+  icon?: ElementType | ReactNode | string;
+  iconPosition?: "left" | "right";
+  loading?: LoadingMode;
+  i18nKey?: ButtonI18nKey;
+  localeText?: ButtonLocaleText;
+}
+
+declare function Button(props: ButtonProps): JSX.Element;
+
+// MaterialButton 类型
+export type MaterialButtonSlotNames = readonly ["root", "content", "icon", "loading"];
+export type MaterialButtonVariant = "default" | "transparent" | "danger" | "success";
+export type MaterialButtonSize = "small" | "medium" | "large" | "huge";
+
+export interface MaterialButtonLocaleText {
+  default?: string;
+  loading?: string;
+  iconAlt?: string;
+  [key: string]: string | undefined;
+}
+
+export interface MaterialButtonProps
+  extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "style" | "className" | "children"> {
+  type?: MaterialButtonVariant;
+  size?: MaterialButtonSize;
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  children?: ReactNode;
+  disabled?: boolean;
+  outline?: boolean;
+  icon?: ElementType | ReactNode | string;
+  iconPosition?: "left" | "right";
+  loading?: LoadingMode;
+  i18nKey?: string;
+  localeText?: MaterialButtonLocaleText;
+  /** 涟漪颜色，默认使用 --material-button-ripple */
+  rippleColor?: string;
+}
+
+declare function MaterialButton(props: MaterialButtonProps): JSX.Element;
+
+// antd 风格：Button.MaterialButton / const { MaterialButton } = Button
+interface ButtonNamespace {
+  (props: ButtonProps): JSX.Element;
+  MaterialButton: typeof MaterialButton;
+}
+
+declare const ButtonWithType: ButtonNamespace;
+export { ButtonWithType as Button };
+export { MaterialButton };
+export default Button;

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

@@ -0,0 +1,40 @@
+import type {
+  CSSProperties,
+  HTMLAttributes,
+  ReactNode,
+  Ref,
+} from "react";
+
+/** Card sx slot 名列表 */
+export type CardSlotNames = readonly ["root", "header", "body"];
+
+/** sx 值类型 */
+export type SxValue =
+  | string
+  | { tw?: string; className?: string; css?: CSSProperties; style?: CSSProperties }
+  | Record<string, unknown>;
+
+/** Card Props */
+export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, "style" | "title"> {
+  /** 卡片标题 */
+  title?: ReactNode;
+  /** 卡片标题右侧额外内容（如操作按钮） */
+  extra?: ReactNode;
+  /** 是否显示边框 */
+  bordered?: boolean;
+  /** 样式扩展 */
+  sx?: SxValue;
+  /** 行内样式 */
+  style?: CSSProperties;
+  /** 额外 CSS 类名 */
+  className?: string;
+  /** 卡片内容 */
+  children?: ReactNode;
+  /** ref 转发 */
+  ref?: Ref<HTMLDivElement>;
+}
+
+declare const Card: React.ForwardRefExoticComponent<
+  CardProps & React.RefAttributes<HTMLDivElement>
+>;
+export default Card;

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

@@ -1,41 +1,42 @@
-import type { CSSProperties, InputHTMLAttributes } from "react";
-import type { SxValue } from "../CSSFab";
-
-export type ColorPickerSize = "small" | "medium" | "large";
-export type ColorPickerFormat = "hex" | "rgb" | "hsl";
-export type ColorPickerShowText = boolean | ColorPickerFormat;
-export type ColorPickerI18nKey = "hex" | "rgb" | "hsl" | (string & {});
-export type ColorPickerLocaleText = Partial<
-  Record<"hex" | "rgb" | "hsl" | string, string>
->;
-
-export interface ColorPickerProps
-  extends Omit<InputHTMLAttributes<HTMLInputElement>, "style" | "className" | "size" | "type" | "value" | "onChange"> {
-  /** 受控颜色值（HEX） */
-  value?: string;
-  /** 非受控默认颜色值 */
-  defaultValue?: string;
-  /** 颜色变化回调，参数为 HEX 值 */
-  onChange?: (hex: string) => void;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 是否显示颜色文本；传格式字符串仅显示对应格式 */
-  showText?: ColorPickerShowText;
-  /** 文本输出格式（showText 为 true 时决定主格式） */
-  format?: ColorPickerFormat;
-  /** 尺寸变体 */
-  size?: ColorPickerSize;
-  /** Style extension via CSSFab sx */
-  sx?: SxValue;
-  style?: CSSProperties;
-  className?: string;
-  /** i18n key */
-  i18nKey?: ColorPickerI18nKey;
-  /** 覆盖 locale 文案 */
-  localeText?: ColorPickerLocaleText;
-}
-
-declare function ColorPicker(props: ColorPickerProps): JSX.Element;
-
-export { ColorPicker };
-export default ColorPicker;
+import type { CSSProperties, InputHTMLAttributes } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type ColorPickerSlotNames = readonly ["root", "input", "text"];
+export type ColorPickerSize = "small" | "medium" | "large";
+export type ColorPickerFormat = "hex" | "rgb" | "hsl";
+export type ColorPickerShowText = boolean | ColorPickerFormat;
+export type ColorPickerI18nKey = "hex" | "rgb" | "hsl" | (string & {});
+export type ColorPickerLocaleText = Partial<
+  Record<"hex" | "rgb" | "hsl" | string, string>
+>;
+
+export interface ColorPickerProps
+  extends Omit<InputHTMLAttributes<HTMLInputElement>, "style" | "className" | "size" | "type" | "value" | "onChange"> {
+  /** 受控颜色值（HEX） */
+  value?: string;
+  /** 非受控默认颜色值 */
+  defaultValue?: string;
+  /** 颜色变化回调，参数为 HEX 值 */
+  onChange?: (hex: string) => void;
+  /** 是否禁用 */
+  disabled?: boolean;
+  /** 是否显示颜色文本；传格式字符串仅显示对应格式 */
+  showText?: ColorPickerShowText;
+  /** 文本输出格式（showText 为 true 时决定主格式） */
+  format?: ColorPickerFormat;
+  /** 尺寸变体 */
+  size?: ColorPickerSize;
+  /** Style extension via CSSFab sx */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  /** i18n key */
+  i18nKey?: ColorPickerI18nKey;
+  /** 覆盖 locale 文案 */
+  localeText?: ColorPickerLocaleText;
+}
+
+declare function ColorPicker(props: ColorPickerProps): JSX.Element;
+
+export { ColorPicker };
+export default ColorPicker;

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

@@ -1,41 +1,42 @@
-import type { CSSProperties, HTMLAttributes } from "react";
-import type { SxValue } from "../CSSFab";
-
-export type DateType =
-  | "default"
-  | "line"
-  | "full"
-  | "full-line"
-  | "year-week"
-  | "year-week-line"
-  | "week-time"
-  | "no-s"
-  | "no-s-line";
-
-export type DateI18nKey = DateType | (string & {});
-
-export type DateLocaleText = Partial<{
-  weekdayPrefix: string;
-  weekdayShortPrefix: string;
-}>;
-
-export interface DateProps
-  extends Omit<HTMLAttributes<HTMLDivElement>, "style" | "className"> {
-  /** 显示格式类型 */
-  type?: DateType;
-  /** 中文星期简写：true 显示"周X"，false 显示"星期X" */
-  single?: boolean;
-  /** Style extension via CSSFab sx */
-  sx?: SxValue;
-  style?: CSSProperties;
-  className?: string;
-  /** i18n key，可指定 type 作为快捷格式 */
-  i18nKey?: DateI18nKey;
-  /** 覆盖 locale 文案 */
-  localeText?: DateLocaleText;
-}
-
-declare function DateDisplay(props: DateProps): JSX.Element;
-
-export { DateDisplay };
-export default DateDisplay;
+import type { CSSProperties, HTMLAttributes } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type DateSlotNames = readonly ["root", "date", "weekday", "time"];
+export type DateType =
+  | "default"
+  | "line"
+  | "full"
+  | "full-line"
+  | "year-week"
+  | "year-week-line"
+  | "week-time"
+  | "no-s"
+  | "no-s-line";
+
+export type DateI18nKey = DateType | (string & {});
+
+export type DateLocaleText = Partial<{
+  weekdayPrefix: string;
+  weekdayShortPrefix: string;
+}>;
+
+export interface DateProps
+  extends Omit<HTMLAttributes<HTMLDivElement>, "style" | "className"> {
+  /** 显示格式类型 */
+  type?: DateType;
+  /** 中文星期简写：true 显示"周X"，false 显示"星期X" */
+  single?: boolean;
+  /** Style extension via CSSFab sx */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  /** i18n key，可指定 type 作为快捷格式 */
+  i18nKey?: DateI18nKey;
+  /** 覆盖 locale 文案 */
+  localeText?: DateLocaleText;
+}
+
+declare function DateDisplay(props: DateProps): JSX.Element;
+
+export { DateDisplay };
+export default DateDisplay;

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

@@ -1,49 +1,54 @@
-import type { CSSProperties, HTMLAttributes } from "react";
-import type { SxValue } from "../CSSFab";
-
-export type DatePickerSize = "small" | "medium" | "large";
-
-export type DatePickerI18nKey = "placeholder" | "placeholderTime" | "timeLabel" | "confirm" | "cancel" | "prevMonth" | "nextMonth" | (string & {});
-
-export type DatePickerLocaleText = Partial<{
-  placeholder: string;
-  placeholderTime: string;
-  timeLabel: string;
-  confirm: string;
-  cancel: string;
-  prevMonth: string;
-  nextMonth: string;
-  weekDays: string[];
-  monthFormat: string;
-}>;
-
-export interface DatePickerProps
-  extends Omit<HTMLAttributes<HTMLDivElement>, "style" | "className" | "onChange"> {
-  /** 受控值（YYYY-MM-DD 或 YYYY-MM-DD HH:mm） */
-  value?: string;
-  /** 非受控默认值 */
-  defaultValue?: string;
-  /** 日期变化回调：(formatted, raw) => void */
-  onChange?: (formatted: string, raw: string) => void;
-  /** 是否禁用 */
-  disabled?: boolean;
-  /** 是否显示时间选择 */
-  time?: boolean;
-  /** 尺寸变体 */
-  size?: DatePickerSize;
-  /** Style extension via CSSFab sx */
-  sx?: SxValue;
-  style?: CSSProperties;
-  className?: string;
-  /** i18n key */
-  i18nKey?: DatePickerI18nKey;
-  /** 覆盖 locale 文案 */
-  localeText?: DatePickerLocaleText;
-  /** 输入框占位文本，优先级高于 i18n / localeText */
-  placeholder?: string;
-}
-
-declare function DatePicker(props: DatePickerProps): JSX.Element;
-
-export { DatePicker };
-export default DatePicker;
+import type { CSSProperties, HTMLAttributes } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type DatePickerSize = "small" | "medium" | "large";
+
+export type DatePickerSlotNames = readonly ["root", "input", "panel", "header", "body", "footer"];
+
+export type DatePickerI18nKey = "placeholder" | "placeholderTime" | "timeLabel" | "confirm" | "cancel" | "prevMonth" | "nextMonth" | "hourLabel" | "minuteLabel" | "panelAriaLabel" | (string & {});
+
+export type DatePickerLocaleText = Partial<{
+  placeholder: string;
+  placeholderTime: string;
+  timeLabel: string;
+  confirm: string;
+  cancel: string;
+  prevMonth: string;
+  nextMonth: string;
+  weekDays: string[];
+  monthFormat: string;
+  hourLabel: string;
+  minuteLabel: string;
+  panelAriaLabel: string;
+}>;
+
+export interface DatePickerProps
+  extends Omit<HTMLAttributes<HTMLDivElement>, "style" | "className" | "onChange"> {
+  /** 受控值（YYYY-MM-DD 或 YYYY-MM-DD HH:mm） */
+  value?: string;
+  /** 非受控默认值 */
+  defaultValue?: string;
+  /** 日期变化回调：(formatted, raw) => void */
+  onChange?: (formatted: string, raw: string) => void;
+  /** 是否禁用 */
+  disabled?: boolean;
+  /** 是否显示时间选择 */
+  time?: boolean;
+  /** 尺寸变体 */
+  size?: DatePickerSize;
+  /** Style extension via CSSFab sx */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  /** i18n key */
+  i18nKey?: DatePickerI18nKey;
+  /** 覆盖 locale 文案 */
+  localeText?: DatePickerLocaleText;
+  /** 输入框占位文本，优先级高于 i18n / localeText */
+  placeholder?: string;
+}
+
+declare function DatePicker(props: DatePickerProps): JSX.Element;
+
+export { DatePicker };
+export default DatePicker;