@vaebe/ccui 2.0.1-beta.2 → 2.0.1-beta.3

package/message/src/use-message.d.ts

@@ -0,0 +1,35 @@
+import type { Component } from 'vue';
+import type { MessageGlobalConfig, MessageHandle, MessageOptions } from './message-types';
+
+export interface UseMessageReturn {
+    message: {
+        open(options: MessageOptions): MessageHandle;
+        info(content: string | MessageOptions, duration?: number): MessageHandle;
+        success(content: string | MessageOptions, duration?: number): MessageHandle;
+        warning(content: string | MessageOptions, duration?: number): MessageHandle;
+        error(content: string | MessageOptions, duration?: number): MessageHandle;
+        loading(content: string | MessageOptions, duration?: number): MessageHandle;
+        config(cfg: MessageGlobalConfig): void;
+        destroy(): void;
+    };
+    holder: Component;
+}
+/**
+ * `useMessage()`：返回 `{ message, holder }` 对象（**不是 React 风格元组**）。
+ *
+ * - `holder` 是 Vue 组件，必须挂到模板中：`<component :is="holder" />`
+ * - 容器渲染在当前 Vue 子树里，自动继承父组件 provide 的 ConfigProvider / 主题等上下文
+ * - 与模块级 `message` 不同：模块级用独立 `createApp`，**无法**拿到调用方应用的 inject
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * const { message, holder } = useMessage()
+ * message.success('hi', 2)
+ * </script>
+ * <template>
+ *   <component :is="holder" />
+ * </template>
+ * ```
+ */
+export declare function useMessage(): UseMessageReturn;

package/modal/index.d.ts

@@ -0,0 +1,24 @@
+import type { App } from 'vue';
+import type { ModalFuncOptions, ModalFuncReturn } from './src/confirm-types';
+import ModalComp from './src/modal';
+import { useModal } from './src/use-modal';
+interface ModalNamespace extends Record<string, unknown> {
+    install?: (app: App) => void;
+    confirm: (options?: ModalFuncOptions) => ModalFuncReturn;
+    info: (options?: ModalFuncOptions) => ModalFuncReturn;
+    success: (options?: ModalFuncOptions) => ModalFuncReturn;
+    error: (options?: ModalFuncOptions) => ModalFuncReturn;
+    warning: (options?: ModalFuncOptions) => ModalFuncReturn;
+    destroyAll: () => void;
+}
+declare const Modal: typeof ModalComp & ModalNamespace;
+export { Modal, useModal };
+export type { ModalFuncOptions, ModalFuncReturn } from './src/confirm-types';
+export type { UseModalReturn } from './src/use-modal';
+declare const _default: {
+    title: string;
+    category: string;
+    status: string;
+    install(app: App): void;
+};
+export default _default;

package/modal/src/confirm-types.d.ts

@@ -0,0 +1,30 @@
+import type { VNode } from 'vue';
+export type ModalFuncType = 'confirm' | 'info' | 'success' | 'error' | 'warning';
+export interface ModalFuncOptions {
+    title?: string | VNode;
+    content?: string | VNode;
+    type?: ModalFuncType;
+    icon?: string | VNode;
+    width?: number | string;
+    centered?: boolean;
+    mask?: boolean;
+    maskClosable?: boolean;
+    closeOnEsc?: boolean;
+    closable?: boolean;
+    okText?: string;
+    cancelText?: string;
+    okType?: 'primary' | 'danger' | 'default';
+    okButtonProps?: Record<string, unknown>;
+    cancelButtonProps?: Record<string, unknown>;
+    onOk?: () => void | Promise<unknown>;
+    onCancel?: () => void | Promise<unknown>;
+    afterClose?: () => void;
+    zIndex?: number;
+    wrapClassName?: string;
+}
+export interface ModalFuncReturn {
+    /** 强制销毁此 modal */
+    destroy: () => void;
+    /** 更新 modal 的 options，可传部分字段做合并；或传函数返回新对象 */
+    update: (updater: Partial<ModalFuncOptions> | ((prev: ModalFuncOptions) => Partial<ModalFuncOptions>)) => void;
+}

package/modal/src/confirm.d.ts

@@ -0,0 +1,17 @@
+import type { AppContext } from 'vue';
+import type { ModalFuncOptions, ModalFuncReturn, ModalFuncType } from './confirm-types';
+interface ParentContext {
+    provides?: Record<string | symbol, unknown>;
+    appContext?: AppContext;
+}
+/**
+ * 渲染单个命令式 Modal。返回 destroy / update 句柄。
+ *
+ * - 默认 `type='confirm'` 显示 OK + Cancel；其他 type 单 OK 按钮
+ * - `onOk` 返回 Promise 时按钮进入 loading，resolve 后关闭；reject 不关闭（错误传递给调用方）
+ */
+export declare function modalFunc(options?: ModalFuncOptions, parentCtx?: ParentContext): ModalFuncReturn;
+/** 销毁所有当前活跃的命令式 modal */
+export declare function modalDestroyAll(): void;
+export declare function createTypedFunc(type: ModalFuncType): (options?: ModalFuncOptions, parentCtx?: ParentContext) => ModalFuncReturn;
+export {};

package/modal/src/modal-types.d.ts

@@ -0,0 +1,175 @@
+import type { ExtractPropTypes, PropType, VNode } from 'vue';
+import type { CcSemanticClasses, CcSemanticStyles } from '../../shared/hooks/use-semantic';
+export type ModalType = 'info' | 'success' | 'warning' | 'error' | 'confirm';
+/**
+ * `closable` 复合配置：
+ *
+ * - `boolean`：显示/隐藏关闭按钮
+ * - `{ closeIcon, disabled, ariaLabel }`：自定义关闭按钮
+ *   - `closeIcon`：接 string（Iconify name）/ VNode；同时支持 `close-icon` slot 高优先级
+ *   - `disabled`：禁用关闭按钮（仍渲染，但点击无效）
+ *   - `ariaLabel`：自定义 aria-label
+ */
+export interface ModalClosableObject {
+    closeIcon?: VNode | string;
+    disabled?: boolean;
+    ariaLabel?: string;
+}
+export type ModalClosable = boolean | ModalClosableObject;
+export declare const modalProps: {
+    /**
+     * 显示对话框。支持 `v-model:visible`。
+     */
+    readonly visible: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly title: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly width: {
+        readonly type: PropType<number | string>;
+        readonly default: 520;
+    };
+    /**
+     * 关闭按钮配置。`boolean` 或 `{ closeIcon, disabled, ariaLabel }` 复合对象。
+     */
+    readonly closable: {
+        readonly type: PropType<ModalClosable>;
+        readonly default: true;
+    };
+    readonly maskClosable: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 是否支持键盘 Esc 关闭。
+     */
+    readonly closeOnEsc: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly centered: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly mask: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly okText: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly cancelText: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly okType: {
+        readonly type: PropType<"primary" | "danger" | "default">;
+        readonly default: "primary";
+    };
+    /**
+     * @deprecated 请改用 `confirmLoading`。
+     */
+    readonly okLoading: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 确认按钮 loading 状态。显式优先于 `okLoading`。
+     */
+    readonly confirmLoading: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /**
+     * @deprecated 请改用 `footer` slot 或 `footer={null}`。
+     */
+    readonly hideFooter: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * footer 内容。
+     *
+     * - `null`：隐藏 footer
+     * - `string`：纯文本 footer
+     * - `VNode`：自定义内容
+     * - 默认（`undefined`）：渲染内置 OK/Cancel 按钮
+     *
+     * `footer` slot 优先级高于此 prop。
+     */
+    readonly footer: {
+        readonly type: PropType<string | VNode | null>;
+        readonly default: undefined;
+    };
+    readonly destroyOnClose: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /**
+     * 默认 false 时由 destroyOnClose 控制；设为 true 时初次挂载即渲染内容（即使未打开），关闭后保留 DOM。
+     * 与 `<KeepAlive>` 语义对齐。
+     */
+    readonly keepAlive: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly zIndex: {
+        readonly type: NumberConstructor;
+        readonly default: 1000;
+    };
+    /**
+     * 是否把浮层 Teleport 到 `document.body`。
+     */
+    readonly appendToBody: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 对话框外层 wrap 节点的 className。
+     */
+    readonly wrapClassName: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 对话框 zoom transition 名。
+     */
+    readonly transitionName: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 遮罩 fade transition 名。
+     */
+    readonly maskTransitionName: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * 关闭后是否把焦点还给触发节点。默认 true。
+     * 触发节点通过 `data-ccui-modal-trigger` 自动捕获；外部也可通过 `expose.restoreFocus(el)` 显式指定。
+     */
+    readonly focusTriggerAfterClose: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 语义化 DOM className 注入。可用 key：`root` / `wrap` / `mask` / `header` / `body` / `footer`。
+     */
+    readonly classNames: {
+        readonly type: PropType<CcSemanticClasses>;
+        readonly default: undefined;
+    };
+    /**
+     * 语义化 DOM style 注入。可用 key 与 classNames 一致。
+     */
+    readonly styles: {
+        readonly type: PropType<CcSemanticStyles>;
+        readonly default: undefined;
+    };
+};
+export type ModalProps = ExtractPropTypes<typeof modalProps>;

package/modal/src/modal.d.ts

@@ -0,0 +1,99 @@
+import type { VNode } from 'vue';
+
+declare const _default: import("vue").DefineComponent<{
+    readonly zIndex: number;
+    readonly title: string;
+    readonly mask: boolean;
+    readonly width: string | number;
+    readonly visible: boolean;
+    readonly closable: import("./modal-types").ModalClosable;
+    readonly transitionName: string;
+    readonly okText: string;
+    readonly cancelText: string;
+    readonly maskClosable: boolean;
+    readonly closeOnEsc: boolean;
+    readonly destroyOnClose: boolean;
+    readonly keepAlive: boolean;
+    readonly appendToBody: boolean;
+    readonly focusTriggerAfterClose: boolean;
+    readonly centered: boolean;
+    readonly okType: "default" | "primary" | "danger";
+    readonly okLoading: boolean;
+    readonly hideFooter: boolean;
+    readonly wrapClassName: string;
+    readonly maskTransitionName: string;
+    readonly footer?: string | VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }> | null | undefined;
+    readonly classNames?: import("../../shared/hooks/use-semantic").CcSemanticClasses | undefined;
+    readonly styles?: import("../../shared/hooks/use-semantic").CcSemanticStyles | undefined;
+    readonly confirmLoading?: boolean | undefined;
+}, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}> | null, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("open" | "cancel" | "close" | "ok" | "update:visible" | "opened" | "closed" | "after-open-change")[], "open" | "cancel" | "close" | "ok" | "update:visible" | "opened" | "closed" | "after-open-change", import("vue").PublicProps, Readonly<{
+    readonly zIndex: number;
+    readonly title: string;
+    readonly mask: boolean;
+    readonly width: string | number;
+    readonly visible: boolean;
+    readonly closable: import("./modal-types").ModalClosable;
+    readonly transitionName: string;
+    readonly okText: string;
+    readonly cancelText: string;
+    readonly maskClosable: boolean;
+    readonly closeOnEsc: boolean;
+    readonly destroyOnClose: boolean;
+    readonly keepAlive: boolean;
+    readonly appendToBody: boolean;
+    readonly focusTriggerAfterClose: boolean;
+    readonly centered: boolean;
+    readonly okType: "default" | "primary" | "danger";
+    readonly okLoading: boolean;
+    readonly hideFooter: boolean;
+    readonly wrapClassName: string;
+    readonly maskTransitionName: string;
+    readonly footer?: string | VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }> | null | undefined;
+    readonly classNames?: import("../../shared/hooks/use-semantic").CcSemanticClasses | undefined;
+    readonly styles?: import("../../shared/hooks/use-semantic").CcSemanticStyles | undefined;
+    readonly confirmLoading?: boolean | undefined;
+}> & Readonly<{
+    onClose?: ((...args: any[]) => any) | undefined;
+    onCancel?: ((...args: any[]) => any) | undefined;
+    onOpen?: ((...args: any[]) => any) | undefined;
+    "onUpdate:visible"?: ((...args: any[]) => any) | undefined;
+    onOpened?: ((...args: any[]) => any) | undefined;
+    onClosed?: ((...args: any[]) => any) | undefined;
+    "onAfter-open-change"?: ((...args: any[]) => any) | undefined;
+    onOk?: ((...args: any[]) => any) | undefined;
+}>, {
+    readonly zIndex: number;
+    readonly footer: string | VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }> | null;
+    readonly title: string;
+    readonly mask: boolean;
+    readonly width: string | number;
+    readonly visible: boolean;
+    readonly closable: import("./modal-types").ModalClosable;
+    readonly classNames: import("../../shared/hooks/use-semantic").CcSemanticClasses;
+    readonly styles: import("../../shared/hooks/use-semantic").CcSemanticStyles;
+    readonly transitionName: string;
+    readonly okText: string;
+    readonly cancelText: string;
+    readonly maskClosable: boolean;
+    readonly closeOnEsc: boolean;
+    readonly destroyOnClose: boolean;
+    readonly keepAlive: boolean;
+    readonly appendToBody: boolean;
+    readonly focusTriggerAfterClose: boolean;
+    readonly centered: boolean;
+    readonly okType: "default" | "primary" | "danger";
+    readonly okLoading: boolean;
+    readonly confirmLoading: boolean;
+    readonly hideFooter: boolean;
+    readonly wrapClassName: string;
+    readonly maskTransitionName: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/modal/src/use-modal.d.ts

@@ -0,0 +1,34 @@
+import type { Component } from 'vue';
+import type { ModalFuncOptions, ModalFuncReturn } from './confirm-types';
+export interface UseModalReturn {
+    modal: {
+        confirm: (options?: ModalFuncOptions) => ModalFuncReturn;
+        info: (options?: ModalFuncOptions) => ModalFuncReturn;
+        success: (options?: ModalFuncOptions) => ModalFuncReturn;
+        error: (options?: ModalFuncOptions) => ModalFuncReturn;
+        warning: (options?: ModalFuncOptions) => ModalFuncReturn;
+    };
+    holder: Component;
+}
+/**
+ * `useModal()`：返回 `{ modal, holder }` 对象（**不是** React `[modal, contextHolder]` 元组）。
+ *
+ * - `holder` 是 Vue 组件，必须挂到模板中：`<component :is="holder" />`
+ * - `modal.confirm({...})` 等命令式调用会继承调用组件树的 provide / ConfigProvider / 主题 / locale 等 inject
+ * - 与全局 `Modal.confirm` 的最大差异：全局版走独立 `createApp`，拿不到调用方 app 的 inject 链
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * const { modal, holder } = useModal()
+ * function ask() {
+ *   modal.confirm({ title: '?', content: '确定要这么做？', onOk: () => fetch('/delete') })
+ * }
+ * </script>
+ * <template>
+ *   <component :is="holder" />
+ *   <button @click="ask">删除</button>
+ * </template>
+ * ```
+ */
+export declare function useModal(): UseModalReturn;

package/notification/index.d.ts

@@ -0,0 +1,21 @@
+import type { App } from 'vue';
+import notification from './src/notification';
+import { useNotification } from './src/use-notification';
+export { notification, useNotification };
+export type { UseNotificationReturn } from './src/use-notification';
+export declare const Notification: {
+    open: (options: import("./src/notification-types").NotificationOptions) => import("./src/notification-types").NotificationHandle;
+    info: (options: import("./src/notification-types").NotificationOptions) => import("./src/notification-types").NotificationHandle;
+    success: (options: import("./src/notification-types").NotificationOptions) => import("./src/notification-types").NotificationHandle;
+    warning: (options: import("./src/notification-types").NotificationOptions) => import("./src/notification-types").NotificationHandle;
+    error: (options: import("./src/notification-types").NotificationOptions) => import("./src/notification-types").NotificationHandle;
+    config(cfg: import("./src/notification-types").NotificationGlobalConfig): void;
+    destroy(): void;
+};
+declare const _default: {
+    title: string;
+    category: string;
+    status: string;
+    install(app: App): void;
+};
+export default _default;

package/notification/src/notification-item.d.ts

@@ -0,0 +1,49 @@
+declare const _default: import("vue").DefineComponent<{
+    readonly type: import("./notification-types").NotificationType;
+    readonly title: string;
+    readonly icon: string;
+    readonly description: string | import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly id: string;
+    readonly role: import("./notification-types").NotificationAriaRole;
+    readonly pauseOnHover: boolean;
+    readonly duration: number;
+    readonly showClose: boolean;
+    readonly customClass: string;
+    readonly classNames?: import("../../shared/hooks/use-semantic").CcSemanticClasses | undefined;
+    readonly styles?: import("../../shared/hooks/use-semantic").CcSemanticStyles | undefined;
+}, () => JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("close" | "destroy")[], "close" | "destroy", import("vue").PublicProps, Readonly<{
+    readonly type: import("./notification-types").NotificationType;
+    readonly title: string;
+    readonly icon: string;
+    readonly description: string | import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly id: string;
+    readonly role: import("./notification-types").NotificationAriaRole;
+    readonly pauseOnHover: boolean;
+    readonly duration: number;
+    readonly showClose: boolean;
+    readonly customClass: string;
+    readonly classNames?: import("../../shared/hooks/use-semantic").CcSemanticClasses | undefined;
+    readonly styles?: import("../../shared/hooks/use-semantic").CcSemanticStyles | undefined;
+}> & Readonly<{
+    onClose?: ((...args: any[]) => any) | undefined;
+    onDestroy?: ((...args: any[]) => any) | undefined;
+}>, {
+    readonly type: import("./notification-types").NotificationType;
+    readonly title: string;
+    readonly icon: string;
+    readonly description: string | import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly classNames: import("../../shared/hooks/use-semantic").CcSemanticClasses;
+    readonly styles: import("../../shared/hooks/use-semantic").CcSemanticStyles;
+    readonly role: import("./notification-types").NotificationAriaRole;
+    readonly pauseOnHover: boolean;
+    readonly duration: number;
+    readonly showClose: boolean;
+    readonly customClass: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/notification/src/notification-types.d.ts

@@ -0,0 +1,91 @@
+import type { ExtractPropTypes, PropType, VNode } from 'vue';
+import type { CcSemanticClasses, CcSemanticStyles } from '../../shared/hooks/use-semantic';
+export type NotificationType = 'info' | 'success' | 'warning' | 'error';
+export type NotificationPlacement = 'top' | 'topRight' | 'topLeft' | 'bottom' | 'bottomRight' | 'bottomLeft';
+export type NotificationAriaRole = 'alert' | 'status';
+export interface NotificationOptions {
+    title?: string;
+    description?: string | VNode;
+    type?: NotificationType;
+    duration?: number;
+    placement?: NotificationPlacement;
+    showClose?: boolean;
+    onClose?: () => void;
+    icon?: string;
+    customClass?: string;
+    role?: NotificationAriaRole;
+    pauseOnHover?: boolean;
+    classNames?: CcSemanticClasses;
+    styles?: CcSemanticStyles;
+}
+export interface NotificationGlobalConfig {
+    top?: number | string;
+    bottom?: number | string;
+    duration?: number;
+    maxCount?: number;
+    stack?: boolean;
+    pauseOnHover?: boolean;
+    role?: NotificationAriaRole;
+    placement?: NotificationPlacement;
+    getContainer?: () => HTMLElement;
+}
+export declare const notificationItemProps: {
+    readonly id: {
+        readonly type: StringConstructor;
+        readonly required: true;
+    };
+    readonly title: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly description: {
+        readonly type: PropType<string | VNode>;
+        readonly default: "";
+    };
+    readonly type: {
+        readonly type: PropType<NotificationType>;
+        readonly default: NotificationType;
+    };
+    readonly duration: {
+        readonly type: NumberConstructor;
+        readonly default: 4500;
+    };
+    readonly showClose: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly icon: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly customClass: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly role: {
+        readonly type: PropType<NotificationAriaRole>;
+        readonly default: NotificationAriaRole;
+    };
+    readonly pauseOnHover: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 语义化 DOM className 注入。可用 key：`root` / `icon` / `content` / `close`。
+     */
+    readonly classNames: {
+        readonly type: PropType<CcSemanticClasses>;
+        readonly default: undefined;
+    };
+    /**
+     * 语义化 DOM style 注入。可用 key 与 classNames 一致。
+     */
+    readonly styles: {
+        readonly type: PropType<CcSemanticStyles>;
+        readonly default: undefined;
+    };
+};
+export type NotificationItemProps = ExtractPropTypes<typeof notificationItemProps>;
+export interface NotificationHandle {
+    close: () => void;
+}

package/notification/src/notification.d.ts

@@ -0,0 +1,20 @@
+import type { NotificationAriaRole, NotificationGlobalConfig, NotificationHandle, NotificationOptions, NotificationPlacement } from './notification-types';
+
+declare function normalizeDuration(input: number | undefined, defaultSeconds: number): number;
+declare function open(options: NotificationOptions): NotificationHandle;
+declare const notification: {
+    open: typeof open;
+    info: (options: NotificationOptions) => NotificationHandle;
+    success: (options: NotificationOptions) => NotificationHandle;
+    warning: (options: NotificationOptions) => NotificationHandle;
+    error: (options: NotificationOptions) => NotificationHandle;
+    config(cfg: NotificationGlobalConfig): void;
+    destroy(): void;
+};
+export declare const _notificationInternal: {
+    normalizeDuration: typeof normalizeDuration;
+    globalConfig: NotificationGlobalConfig;
+    PLACEMENTS: NotificationPlacement[];
+};
+export default notification;
+export type { NotificationAriaRole };

package/notification/src/use-notification.d.ts

@@ -0,0 +1,34 @@
+import type { Component } from 'vue';
+import type { NotificationGlobalConfig, NotificationHandle, NotificationOptions } from './notification-types';
+
+export interface UseNotificationReturn {
+    notification: {
+        open(options: NotificationOptions): NotificationHandle;
+        info(options: NotificationOptions): NotificationHandle;
+        success(options: NotificationOptions): NotificationHandle;
+        warning(options: NotificationOptions): NotificationHandle;
+        error(options: NotificationOptions): NotificationHandle;
+        config(cfg: NotificationGlobalConfig): void;
+        destroy(): void;
+    };
+    holder: Component;
+}
+/**
+ * `useNotification()`：返回 `{ notification, holder }` 对象（**不是 React 风格元组**）。
+ *
+ * - `holder` 是 Vue 组件，必须挂到模板中：`<component :is="holder" />`
+ * - 容器渲染在当前 Vue 子树里，自动继承父组件 provide 的 ConfigProvider / 主题等上下文
+ * - 与模块级 `notification` 不同：模块级用独立 `createApp`，**无法**拿到调用方应用的 inject
+ *
+ * @example
+ * ```vue
+ * <script setup>
+ * const { notification, holder } = useNotification()
+ * notification.success({ title: 'hi', duration: 2 })
+ * </script>
+ * <template>
+ *   <component :is="holder" />
+ * </template>
+ * ```
+ */
+export declare function useNotification(): UseNotificationReturn;