tango-ui-cw 1.0.10 → 1.2.0

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

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

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

@@ -1,38 +1,41 @@
-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;
+import type {
+  CSSProperties,
+  HTMLAttributes,
+  ReactNode,
+  Ref,
+} from "react";
+
+/** Mark sx slot 名列表 */
+export type MarkSlotNames = readonly ["root"];
+
+/** 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

@@ -1,52 +1,107 @@
-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;
+import type { CSSProperties, HTMLAttributes, ReactNode } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type ModalSlotNames = readonly ["overlay", "container", "header", "title", "closeBtn", "content", "footer"];
+export type ModalI18nKey = "title" | "okText" | "cancelText" | "closeAriaLabel" | "confirmTitle" | "successTitle" | "errorTitle" | "warningTitle" | (string & {});
+
+export type ModalLocaleText = Partial<{
+  title: string;
+  okText: string;
+  cancelText: string;
+  closeAriaLabel: string;
+  // added by clayw on 20260624: 静态方法默认标题
+  confirmTitle: string;
+  successTitle: string;
+  errorTitle: string;
+  warningTitle: 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；支持返回 Promise，自动 loading */
+  onOk?: () => void | Promise<void>;
+  /** 容器宽度 */
+  width?: string | number;
+  /** Style extension via CSSFab sx */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  /** 点击遮罩是否关闭 */
+  maskClosable?: boolean;
+  /** 自定义底部按钮，传入后替代默认的取消/确定 */
+  footerButtons?: ModalFooterButton[];
+  /**
+   * 底部区域控制：
+   * - `undefined`：使用 footerButtons 或默认取消/确定按钮
+   * - `null`：不渲染底部区域
+   * - `ReactNode`：自定义底部内容
+   * added by clayw on 20260624
+   */
+  footer?: ReactNode | null;
+  /**
+   * 关闭时是否卸载 children DOM，适用于需要重置内部状态的场景
+   * added by clayw on 20260624
+   */
+  destroyOnClose?: boolean;
+  /** 覆盖 locale 文案 */
+  localeText?: ModalLocaleText;
+}
+
+/** 静态方法配置 */
+export interface ModalStaticConfig {
+  title?: string;
+  content?: ReactNode;
+  okText?: string;
+  cancelText?: string;
+  onOk?: () => void | Promise<void>;
+  onCancel?: () => void;
+  width?: string | number;
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+  maskClosable?: boolean;
+  footerButtons?: ModalFooterButton[];
+  localeText?: ModalLocaleText;
+}
+
+/** 静态方法返回值 */
+export interface ModalStaticResult {
+  close: () => void;
+  update: (config: Partial<ModalStaticConfig>) => void;
+}
+
+// added by clayw on 20260624: 静态方法类型声明
+interface ModalStaticMethods {
+  confirm: (config: ModalStaticConfig) => ModalStaticResult;
+  success: (config: ModalStaticConfig) => ModalStaticResult;
+  error: (config: ModalStaticConfig) => ModalStaticResult;
+  warning: (config: ModalStaticConfig) => ModalStaticResult;
+}
+
+// Modal 组件类型 = 函数签名 + 静态方法
+interface ModalComponent extends ModalStaticMethods {
+  (props: ModalProps): JSX.Element;
+}
+
+declare const Modal: ModalComponent;
+
+export { Modal };
+export default Modal;

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

@@ -1,30 +1,47 @@
-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;
+import type { CSSProperties, ReactNode } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type NoticeSlotNames = readonly ["root", "icon", "content"];
+export type NoticeType = "success" | "fail" | "caution";
+export type NoticeVariant = "default" | "md";
+// added by clayw on 20260624: placement 四角位置类型（大小写均可）
+export type NoticePlacement = "TL" | "TR" | "BL" | "BR" | "tl" | "tr" | "bl" | "br";
+
+export interface NoticeProps extends React.HTMLAttributes<HTMLDivElement> {
+  /** 通知类型 */
+  type?: NoticeType;
+  /** 图标（default 模式和 placement 模式显示，md 模式隐藏） */
+  icon?: ReactNode;
+  /** 通知内容 */
+  message?: ReactNode;
+  /** 变体：default 顶部居中，md 左下角 */
+  variant?: NoticeVariant;
+  /**
+   * 四角位置，优先级高于 variant
+   * added by clayw on 20260624
+   */
+  placement?: NoticePlacement;
+  /** 自动关闭时间（ms），0 或不传则不自动关闭 */
+  duration?: number;
+  /** 关闭回调 */
+  onClose?: () => void;
+  /** 样式扩展 */
+  sx?: SxValue;
+  style?: CSSProperties;
+  className?: string;
+}
+
+/** useNotice 调用的 options 参数 */
+// added by clayw on 20260624
+export interface NoticeCallOptions {
+  variant?: NoticeVariant;
+  duration?: number;
+  placement?: NoticePlacement;
+  key?: string;
+}
+
+declare const Notice: React.ForwardRefExoticComponent<
+  NoticeProps & React.RefAttributes<HTMLDivElement>
+>;
+
+export default Notice;

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

@@ -1,42 +1,56 @@
-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;
+import type { CSSProperties, HTMLAttributes, ReactNode } from "react";
+import type { SxValue } from "../CSSFab";
+
+export type SearchSlotNames = readonly ["root", "input", "button", "prefix", "clearIcon"];
+export type SearchSize = "small" | "medium" | "large" | "huge";
+
+export type SearchI18nKey = "placeholder" | "btnText" | (string & {});
+
+export type SearchLocaleText = Partial<{
+  placeholder: string;
+  btnText: string;
+  // added by clayw on 20260624
+  clearAriaLabel: string;
+  countTemplate: 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;
+  /** 输入值变化回调，参数为当前输入值 */
+  onChange?: (value: string) => void;
+  /** 受控值 */
+  value?: string;
+  /** 非受控默认值 */
+  defaultValue?: string;
+  /** 是否禁用 */
+  disabled?: boolean;
+  /** 占位文案，优先级高于 i18n */
+  placeholder?: string;
+  /** 搜索按钮文案，优先级高于 i18n */
+  btnText?: string;
+  /** 搜索按钮图标路径，传入后替代 btnText */
+  path?: string;
+  /** 覆盖 locale 文案 */
+  localeText?: SearchLocaleText;
+  /** 前缀图标/文字，位于输入框内左侧 added by clayw on 20260624 */
+  prefix?: ReactNode;
+  /** 是否显示清除按钮，默认 true，值为空时隐藏图标 added by clayw on 20260624 */
+  allowClear?: boolean;
+  /** 是否显示字数统计，默认 false，支持 i18n added by clayw on 20260624 */
+  showCount?: boolean;
+  /** 最大字符数，默认 524288 added by clayw on 20260624 */
+  maxLength?: number;
+}
+
+declare function Search(props: SearchProps): JSX.Element;
+
+export { Search };
+export default Search;

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

@@ -1,59 +1,60 @@
-import type {
-  CSSProperties,
-  HTMLAttributes,
-  ReactNode,
-  Ref,
-} from "react";
-
-/** Space 布局变体 */
-export type SpaceType =
-  | "default"
-  | "inline"
-  | "flex"
-  | "inlineFlex"
-  | "grid"
-  | "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 };
+import type {
+  CSSProperties,
+  HTMLAttributes,
+  ReactNode,
+  Ref,
+} from "react";
+
+/** Space sx slot 名列表 */
+export type SpaceSlotNames = readonly ["root"];
+
+/** Space 布局变体 */
+export type SpaceType =
+  | "default"
+  | "inline"
+  | "flex"
+  | "inlineFlex"
+  | "grid"
+  | "circle"
+  | "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 };