@chenzy-design/svelte 0.1.0

package/dist/notification/meta.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Notification — see specs/components/feedback/Notification.spec.md
+ */
+export declare const meta: {
+    readonly name: "Notification";
+    readonly category: "feedback";
+    readonly description: "通知提醒框：命令式全局反馈 API（notification.open/success/info/warning/error/close/update/destroyAll）。比 Toast 更丰富——标题 + 内容 + 图标；6 方位独立堆叠；单例容器惰性挂载到 body；自动关闭 + 悬停暂停 + maxCount 按方位 FIFO 淘汰 + 同 id 去重更新；error/warning role=alert(assertive)、其余 role=status(polite)；可选 showProgress 倒计时进度条（命令式 rAF + 悬停同步暂停）、footer 操作区 Snippet、theme(light/dark)；RTL（direction=rtl 镜像卡片布局并左右互换方位）、Esc 关闭最近一条（window keydown + cleanup）、notification.config({ direction, getPopupContainer }) 配置全局方向与容器挂载点（默认 ltr + body，对齐 Modal/Dropdown getContainer）。";
+    readonly exports: readonly ["notification"];
+    readonly imperative: true;
+    readonly config: {
+        readonly direction: "全局默认书写方向 'ltr'|'rtl'（per-item direction 优先）";
+        readonly getPopupContainer: "() => HTMLElement，容器宿主挂载目标（默认 body）；须在首条通知前调用方生效";
+    };
+    readonly props: readonly [{
+        readonly name: "id";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "指定 id；已存在则原地更新";
+    }, {
+        readonly name: "title";
+        readonly type: "string";
+        readonly default: "—";
+        readonly desc: "通知标题";
+    }, {
+        readonly name: "content";
+        readonly type: "string";
+        readonly default: "—";
+        readonly desc: "通知正文";
+    }, {
+        readonly name: "type";
+        readonly type: "'default'|'success'|'info'|'warning'|'error'";
+        readonly default: "'default'";
+        readonly desc: "语义类型，决定图标与强调色";
+    }, {
+        readonly name: "duration";
+        readonly type: "number";
+        readonly default: "4.5";
+        readonly desc: "自动关闭秒数；0 持久";
+    }, {
+        readonly name: "placement";
+        readonly type: "'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'";
+        readonly default: "'topRight'";
+        readonly desc: "弹出位置，每方位独立堆叠";
+    }, {
+        readonly name: "closable";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示关闭按钮";
+    }, {
+        readonly name: "pauseOnHover";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "悬停/聚焦时暂停定时器";
+    }, {
+        readonly name: "showProgress";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "底部倒计时进度条，随 duration 递减；悬停/聚焦时与定时器同步暂停（duration=0 时不显示）";
+    }, {
+        readonly name: "theme";
+        readonly type: "'light'|'dark'";
+        readonly default: "'light'";
+        readonly desc: "卡片主题；dark 为深色卡片";
+    }, {
+        readonly name: "direction";
+        readonly type: "'ltr'|'rtl'";
+        readonly default: "'ltr'（可经 notification.config 改默认）";
+        readonly desc: "RTL 时镜像卡片布局（关闭按钮/图标/文案/进度方向翻转）并左右互换方位";
+    }, {
+        readonly name: "footer";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "底部操作区插槽（按钮等），渲染在内容下方";
+    }, {
+        readonly name: "onClose";
+        readonly type: "(id: string, reason: 'timeout'|'manual'|'replace'|'destroyAll') => void";
+        readonly default: "undefined";
+        readonly desc: "关闭回调，附关闭原因";
+    }];
+    readonly events: readonly [{
+        readonly name: "onClose";
+        readonly desc: "单条关闭（超时/手动/被替换/清空）时触发，带 id 与 reason";
+    }];
+    readonly slots: readonly [];
+    readonly a11y: {
+        readonly hasRole: true;
+        readonly focusable: false;
+        readonly note: "error/warning 用 role=alert + aria-live=assertive，其余 role=status + aria-live=polite；标题 aria-labelledby、内容 aria-describedby；关闭按钮 button + aria-label「关闭」。不抢焦点、不锁滚动。";
+    };
+    readonly tokens: readonly ["--cd-notification-width", "--cd-notification-bg", "--cd-notification-color-title", "--cd-notification-color-content", "--cd-notification-border", "--cd-notification-radius", "--cd-notification-shadow", "--cd-notification-padding", "--cd-notification-gap", "--cd-notification-icon-success", "--cd-notification-icon-info", "--cd-notification-icon-warning", "--cd-notification-icon-error", "--cd-notification-close-color", "--cd-notification-close-color-hover", "--cd-notification-title-size", "--cd-notification-content-size", "--cd-notification-z", "--cd-notification-offset", "--cd-notification-motion-duration", "--cd-notification-progress-height", "--cd-notification-progress-color", "--cd-notification-bg-dark", "--cd-notification-border-dark", "--cd-notification-color-title-dark", "--cd-notification-color-content-dark", "--cd-notification-close-color-dark", "--cd-notification-close-color-hover-dark"];
+    readonly responsive: false;
+    readonly examples: readonly [{
+        readonly title: "成功";
+        readonly code: "notification.success({ title: '已上传', content: '文件保存成功' })";
+    }, {
+        readonly title: "错误";
+        readonly code: "notification.error({ title: '保存失败', content: '网络中断' })";
+    }, {
+        readonly title: "常驻";
+        readonly code: "notification.open({ title: '提醒', duration: 0 })";
+    }, {
+        readonly title: "RTL";
+        readonly code: "notification.info({ title: 'مرحبا', content: 'نص', direction: 'rtl' })";
+    }, {
+        readonly title: "全局配置";
+        readonly code: "notification.config({ direction: 'rtl', getPopupContainer: () => document.getElementById('app')! })";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/notification/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/notification/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmHP,CAAC"}

package/dist/notification/meta.js

@@ -0,0 +1,118 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Notification — see specs/components/feedback/Notification.spec.md
+ */
+export const meta = {
+    name: 'Notification',
+    category: 'feedback',
+    description: '通知提醒框：命令式全局反馈 API（notification.open/success/info/warning/error/close/update/destroyAll）。比 Toast 更丰富——标题 + 内容 + 图标；6 方位独立堆叠；单例容器惰性挂载到 body；自动关闭 + 悬停暂停 + maxCount 按方位 FIFO 淘汰 + 同 id 去重更新；error/warning role=alert(assertive)、其余 role=status(polite)；可选 showProgress 倒计时进度条（命令式 rAF + 悬停同步暂停）、footer 操作区 Snippet、theme(light/dark)；RTL（direction=rtl 镜像卡片布局并左右互换方位）、Esc 关闭最近一条（window keydown + cleanup）、notification.config({ direction, getPopupContainer }) 配置全局方向与容器挂载点（默认 ltr + body，对齐 Modal/Dropdown getContainer）。',
+    exports: ['notification'],
+    imperative: true,
+    config: {
+        direction: "全局默认书写方向 'ltr'|'rtl'（per-item direction 优先）",
+        getPopupContainer: '() => HTMLElement，容器宿主挂载目标（默认 body）；须在首条通知前调用方生效',
+    },
+    props: [
+        { name: 'id', type: 'string', default: 'undefined', desc: '指定 id；已存在则原地更新' },
+        { name: 'title', type: 'string', default: '—', desc: '通知标题' },
+        { name: 'content', type: 'string', default: '—', desc: '通知正文' },
+        {
+            name: 'type',
+            type: "'default'|'success'|'info'|'warning'|'error'",
+            default: "'default'",
+            desc: '语义类型，决定图标与强调色',
+        },
+        {
+            name: 'duration',
+            type: 'number',
+            default: '4.5',
+            desc: '自动关闭秒数；0 持久',
+        },
+        {
+            name: 'placement',
+            type: "'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'",
+            default: "'topRight'",
+            desc: '弹出位置，每方位独立堆叠',
+        },
+        { name: 'closable', type: 'boolean', default: 'true', desc: '是否显示关闭按钮' },
+        { name: 'pauseOnHover', type: 'boolean', default: 'true', desc: '悬停/聚焦时暂停定时器' },
+        {
+            name: 'showProgress',
+            type: 'boolean',
+            default: 'false',
+            desc: '底部倒计时进度条，随 duration 递减；悬停/聚焦时与定时器同步暂停（duration=0 时不显示）',
+        },
+        {
+            name: 'theme',
+            type: "'light'|'dark'",
+            default: "'light'",
+            desc: '卡片主题；dark 为深色卡片',
+        },
+        {
+            name: 'direction',
+            type: "'ltr'|'rtl'",
+            default: "'ltr'（可经 notification.config 改默认）",
+            desc: 'RTL 时镜像卡片布局（关闭按钮/图标/文案/进度方向翻转）并左右互换方位',
+        },
+        {
+            name: 'footer',
+            type: 'Snippet',
+            default: 'undefined',
+            desc: '底部操作区插槽（按钮等），渲染在内容下方',
+        },
+        {
+            name: 'onClose',
+            type: "(id: string, reason: 'timeout'|'manual'|'replace'|'destroyAll') => void",
+            default: 'undefined',
+            desc: '关闭回调，附关闭原因',
+        },
+    ],
+    events: [{ name: 'onClose', desc: '单条关闭（超时/手动/被替换/清空）时触发，带 id 与 reason' }],
+    slots: [],
+    a11y: {
+        hasRole: true,
+        focusable: false,
+        note: 'error/warning 用 role=alert + aria-live=assertive，其余 role=status + aria-live=polite；标题 aria-labelledby、内容 aria-describedby；关闭按钮 button + aria-label「关闭」。不抢焦点、不锁滚动。',
+    },
+    tokens: [
+        '--cd-notification-width',
+        '--cd-notification-bg',
+        '--cd-notification-color-title',
+        '--cd-notification-color-content',
+        '--cd-notification-border',
+        '--cd-notification-radius',
+        '--cd-notification-shadow',
+        '--cd-notification-padding',
+        '--cd-notification-gap',
+        '--cd-notification-icon-success',
+        '--cd-notification-icon-info',
+        '--cd-notification-icon-warning',
+        '--cd-notification-icon-error',
+        '--cd-notification-close-color',
+        '--cd-notification-close-color-hover',
+        '--cd-notification-title-size',
+        '--cd-notification-content-size',
+        '--cd-notification-z',
+        '--cd-notification-offset',
+        '--cd-notification-motion-duration',
+        '--cd-notification-progress-height',
+        '--cd-notification-progress-color',
+        '--cd-notification-bg-dark',
+        '--cd-notification-border-dark',
+        '--cd-notification-color-title-dark',
+        '--cd-notification-color-content-dark',
+        '--cd-notification-close-color-dark',
+        '--cd-notification-close-color-hover-dark',
+    ],
+    responsive: false,
+    examples: [
+        { title: '成功', code: "notification.success({ title: '已上传', content: '文件保存成功' })" },
+        { title: '错误', code: "notification.error({ title: '保存失败', content: '网络中断' })" },
+        { title: '常驻', code: "notification.open({ title: '提醒', duration: 0 })" },
+        { title: 'RTL', code: "notification.info({ title: 'مرحبا', content: 'نص', direction: 'rtl' })" },
+        {
+            title: '全局配置',
+            code: "notification.config({ direction: 'rtl', getPopupContainer: () => document.getElementById('app')! })",
+        },
+    ],
+};

package/dist/notification/store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Notification — 命令式全局通知提醒框入口。
+ * 模块级单例 store + 惰性挂载的单例 NotificationContainer（首次调用时 mount 到 body）。
+ * 复用 @chenzy-design/core 的 createNotificationStore（无框架依赖的队列 + 定时器）。
+ * 与 Toast 同构，差异：数据含 title + content、6 方位独立堆叠、无 loading 类型；
+ * 命令式入参是 NotificationOptions 配置对象（不像 Toast 首参是 string）。
+ * See specs/components/feedback/Notification.spec.md
+ */
+import { type NotificationOptions, type NotificationPlacement, type NotificationDirection } from '@chenzy-design/core';
+/**
+ * 全局通知配置（命令式单例特有）。容器经 mount() 挂在 Svelte 组件树之外，
+ * 拿不到 ConfigProvider context，故 RTL / 挂载容器只能经此命令式入口配置：
+ *  - direction：未显式指定 direction 的通知的默认书写方向（rtl 镜像布局并左右互换方位）。
+ *  - getPopupContainer：容器宿主挂载目标（默认 body），对齐 Modal/Dropdown getContainer。
+ *  - top/bottom/left/right：六方位容器与视口边缘的偏移（CSS 像素字符串或数字）。
+ *  - zIndex：通知容器层叠优先级。
+ *  - duration：全局默认自动关闭秒数（0 = 常驻），可被单条 options.duration 覆盖。
+ * 须在首条通知前调用方对挂载点生效（容器惰性挂载且单例，仅挂一次）。
+ */
+export interface NotificationConfig {
+    direction?: NotificationDirection;
+    getPopupContainer?: () => HTMLElement | null | undefined;
+    /** 通知容器距视口顶部偏移（CSS 值，如 '24px' 或数字像素），适用于 topLeft/top/topRight 方位 */
+    top?: number | string;
+    /** 通知容器距视口底部偏移 */
+    bottom?: number | string;
+    /** 通知容器距视口左侧偏移 */
+    left?: number | string;
+    /** 通知容器距视口右侧偏移 */
+    right?: number | string;
+    /** 通知容器 z-index */
+    zIndex?: number;
+    /** 全局默认自动关闭秒数（0 = 常驻）；可被单条 notification.xxx({ duration }) 覆盖 */
+    duration?: number;
+}
+/**
+ * Svelte 层扩展选项（core NotificationOptions 的超集）：
+ *  - showClose: closable 的别名（Semi 文档用 showClose），两者等价，showClose 优先。
+ *  - onCloseClick: 仅在用户点击关闭按钮时触发（与 onClose 区分：onClose 在任何关闭方式时触发）。
+ */
+export interface SvelteNotificationOptions extends NotificationOptions {
+    /** closable 的别名（Semi 文档用 showClose）；showClose 优先于 closable */
+    showClose?: boolean;
+    /** 仅在用户点击关闭按钮时触发；onClose 在所有关闭方式（timeout/manual/replace/destroyAll）时触发 */
+    onCloseClick?: (id: string) => void;
+}
+export declare const onCloseClickMap: Map<string, (id: string) => void>;
+/** 位置偏移 getter：供 NotificationContainer 读取并注入 inline style（config() 后生效）。 */
+export declare function getPositionOffsets(): Pick<NotificationConfig, 'top' | 'bottom' | 'left' | 'right' | 'zIndex'>;
+export declare const notification: {
+    /**
+     * 配置全局通知行为：direction（默认书写方向）、getPopupContainer（容器挂载目标）、
+     * top/bottom/left/right/zIndex（容器位置偏移）、duration（全局默认自动关闭秒数）。
+     * 命令式单例特性——须在首条通知前调用方对挂载点生效。向后兼容：不调用即 ltr + body。
+     */
+    config: (cfg: NotificationConfig) => void;
+    /** 完整选项打开一条通知，返回其 id。 */
+    open: (opts: SvelteNotificationOptions) => string;
+    success: (opts: SvelteNotificationOptions) => string;
+    info: (opts: SvelteNotificationOptions) => string;
+    warning: (opts: SvelteNotificationOptions) => string;
+    error: (opts: SvelteNotificationOptions) => string;
+    /** 手动关闭指定通知。 */
+    close: (id: string) => void;
+    /** 按同 id 更新一条通知（store.open 对已存在 id 走原地更新 + 重启定时器）。 */
+    update: (id: string, opts: SvelteNotificationOptions) => string;
+    /** 清空全部通知，或仅清空指定方位。 */
+    destroyAll: (placement?: NotificationPlacement) => void;
+};
+//# sourceMappingURL=store.d.ts.map

package/dist/notification/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notification/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAGL,KAAK,mBAAmB,EAExB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;IACzD,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAWD;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAGD,eAAO,MAAM,eAAe,mBAAwB,MAAM,KAAK,IAAI,CAAG,CAAC;AAEvE,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,CAE7G;AA0ED,eAAO,MAAM,YAAY;IACvB;;;;OAIG;kBACW,kBAAkB,KAAG,IAAI;IAYvC,yBAAyB;iBACZ,yBAAyB,KAAG,MAAM;oBAO/B,yBAAyB,KAAG,MAAM;iBACrC,yBAAyB,KAAG,MAAM;oBAC/B,yBAAyB,KAAG,MAAM;kBACpC,yBAAyB,KAAG,MAAM;IAChD,gBAAgB;gBACJ,MAAM,KAAG,IAAI;IACzB,sDAAsD;iBACzC,MAAM,QAAQ,yBAAyB,KAAG,MAAM;IAS7D,uBAAuB;6BACE,qBAAqB,KAAG,IAAI;CAEtD,CAAC"}

package/dist/notification/store.js

@@ -0,0 +1,135 @@
+/**
+ * Notification — 命令式全局通知提醒框入口。
+ * 模块级单例 store + 惰性挂载的单例 NotificationContainer（首次调用时 mount 到 body）。
+ * 复用 @chenzy-design/core 的 createNotificationStore（无框架依赖的队列 + 定时器）。
+ * 与 Toast 同构，差异：数据含 title + content、6 方位独立堆叠、无 loading 类型；
+ * 命令式入参是 NotificationOptions 配置对象（不像 Toast 首参是 string）。
+ * See specs/components/feedback/Notification.spec.md
+ */
+import { createNotificationStore, } from '@chenzy-design/core';
+let store = null;
+let containerMounted = false;
+let globalDirection = 'ltr';
+let getPopupContainer;
+let globalDuration;
+let positionOffsets = {};
+// onCloseClick 回调按 id 存储在模块级 Map，NotificationContainer 关闭按钮点击时查找并调用。
+export const onCloseClickMap = new Map();
+/** 位置偏移 getter：供 NotificationContainer 读取并注入 inline style（config() 后生效）。 */
+export function getPositionOffsets() {
+    return positionOffsets;
+}
+function ensureStore() {
+    if (!store) {
+        store = createNotificationStore({
+            maxCount: 5,
+            defaultDuration: globalDuration ?? 4.5,
+        });
+    }
+    return store;
+}
+function resolveOpts(opts) {
+    const { showClose, onCloseClick, ...rest } = opts;
+    // showClose 优先于 closable；都未传则 core 默认 true。
+    const closable = showClose !== undefined ? showClose : rest.closable;
+    const coreOpts = {
+        ...rest,
+        ...(closable !== undefined ? { closable } : {}),
+        direction: opts.direction !== undefined
+            ? opts.direction
+            : globalDirection,
+    };
+    // 若有 onCloseClick，在 onClose 钩子中清理 map（防内存泄漏）。
+    if (onCloseClick) {
+        const origOnClose = coreOpts.onClose;
+        coreOpts.onClose = (closedId, reason) => {
+            onCloseClickMap.delete(closedId);
+            origOnClose?.(closedId, reason);
+        };
+    }
+    return { coreOpts, onCloseClick };
+}
+/**
+ * 惰性挂载容器：首次调用时动态 import + mount NotificationContainer 到 body。
+ * mount 是 async（动态 import），但调用方的 s.open 已同步把数据写进 store；
+ * 容器在 mount 时立即同步读一次 store.getItems()，不会丢首条通知。
+ */
+async function ensureContainer() {
+    if (containerMounted || typeof document === 'undefined')
+        return;
+    containerMounted = true;
+    const { mount } = await import('svelte');
+    const { default: NotificationContainer } = await import('./NotificationContainer.svelte');
+    const host = document.createElement('div');
+    host.className = 'cd-notification-host';
+    // 挂载到 getPopupContainer() 指定容器（默认 body），对齐 Modal/Dropdown getContainer。
+    const target = getPopupContainer?.() ?? document.body;
+    target.appendChild(host);
+    mount(NotificationContainer, { target: host, props: { store: ensureStore() } });
+}
+function show(type, opts) {
+    const s = ensureStore();
+    void ensureContainer();
+    const merged = { ...opts };
+    merged.type = type;
+    const { coreOpts, onCloseClick } = resolveOpts(merged);
+    const id = s.open(coreOpts);
+    if (onCloseClick)
+        onCloseClickMap.set(id, onCloseClick);
+    return id;
+}
+export const notification = {
+    /**
+     * 配置全局通知行为：direction（默认书写方向）、getPopupContainer（容器挂载目标）、
+     * top/bottom/left/right/zIndex（容器位置偏移）、duration（全局默认自动关闭秒数）。
+     * 命令式单例特性——须在首条通知前调用方对挂载点生效。向后兼容：不调用即 ltr + body。
+     */
+    config: (cfg) => {
+        if (cfg.direction !== undefined)
+            globalDirection = cfg.direction;
+        if ('getPopupContainer' in cfg)
+            getPopupContainer = cfg.getPopupContainer;
+        if (cfg.duration !== undefined)
+            globalDuration = cfg.duration;
+        const next = {};
+        if (cfg.top !== undefined)
+            next.top = cfg.top;
+        if (cfg.bottom !== undefined)
+            next.bottom = cfg.bottom;
+        if (cfg.left !== undefined)
+            next.left = cfg.left;
+        if (cfg.right !== undefined)
+            next.right = cfg.right;
+        if (cfg.zIndex !== undefined)
+            next.zIndex = cfg.zIndex;
+        positionOffsets = next;
+    },
+    /** 完整选项打开一条通知，返回其 id。 */
+    open: (opts) => {
+        void ensureContainer();
+        const { coreOpts, onCloseClick } = resolveOpts(opts);
+        const id = ensureStore().open(coreOpts);
+        if (onCloseClick)
+            onCloseClickMap.set(id, onCloseClick);
+        return id;
+    },
+    success: (opts) => show('success', opts),
+    info: (opts) => show('info', opts),
+    warning: (opts) => show('warning', opts),
+    error: (opts) => show('error', opts),
+    /** 手动关闭指定通知。 */
+    close: (id) => ensureStore().close(id, 'manual'),
+    /** 按同 id 更新一条通知（store.open 对已存在 id 走原地更新 + 重启定时器）。 */
+    update: (id, opts) => {
+        void ensureContainer();
+        const merged = { ...opts };
+        merged.id = id;
+        const { coreOpts, onCloseClick } = resolveOpts(merged);
+        const newId = ensureStore().open(coreOpts);
+        if (onCloseClick)
+            onCloseClickMap.set(newId, onCloseClick);
+        return newId;
+    },
+    /** 清空全部通知，或仅清空指定方位。 */
+    destroyAll: (placement) => ensureStore().destroyAll(placement),
+};

package/dist/overflow-list/OverflowList.a11y.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OverflowList.a11y.test.d.ts.map

package/dist/overflow-list/OverflowList.a11y.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverflowList.a11y.test.d.ts","sourceRoot":"","sources":["../../src/overflow-list/OverflowList.a11y.test.ts"],"names":[],"mappings":""}

package/dist/overflow-list/OverflowList.a11y.test.js

@@ -0,0 +1,41 @@
+// OverflowList a11y：溢出列表。
+// 根容器 role=group 透明保留子项语义 + aria-label 提供可访问名；
+// 离屏测量层 aria-hidden（不进可达性树）。
+// jsdom 无布局，不会真实折叠出 +N 节点；本套件只断言静态 ARIA + axe（折叠行为留给 Playwright）。
+import { describe, it, expect, beforeAll } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import OverflowListFixture from './OverflowListA11yFixture.svelte';
+// jsdom 无 ResizeObserver（OverflowList 用其测量溢出）。仅在本测试内补一个 no-op 桩，
+// 不改基建/组件源码——溢出测量/折叠不在静态 a11y 测试范围（留给 Playwright）。
+beforeAll(() => {
+    if (!('ResizeObserver' in globalThis)) {
+        globalThis.ResizeObserver = class {
+            observe() { }
+            unobserve() { }
+            disconnect() { }
+        };
+    }
+});
+describe('OverflowList a11y', () => {
+    it('collapse 模式：根 role=group + aria-label，离屏测量层 aria-hidden，无 axe violations', async () => {
+        const { container } = renderWithLocale(OverflowListFixture, {});
+        const group = container.querySelector('[role="group"]');
+        expect(group).not.toBeNull();
+        expect(group?.getAttribute('aria-label')).toBe('Toolbar');
+        // 离屏测量层移出可达性树。
+        const measure = container.querySelector('.cd-overflow-list__measure');
+        expect(measure?.getAttribute('aria-hidden')).toBe('true');
+        await expectNoAxeViolations(container);
+    });
+    it('scroll 模式：可见层可聚焦 + role=group + 可访问名，无 axe violations', async () => {
+        const { container } = renderWithLocale(OverflowListFixture, {
+            props: { mode: 'scroll', ariaLabel: 'Scrollable tags' },
+        });
+        const visible = container.querySelector('.cd-overflow-list__visible');
+        // scroll 模式可见层为可聚焦滚动容器（tabindex=0）+ group + 可访问名。
+        expect(visible?.getAttribute('tabindex')).toBe('0');
+        expect(visible?.getAttribute('role')).toBe('group');
+        expect(visible?.getAttribute('aria-label')).toBe('Scrollable tags');
+        await expectNoAxeViolations(container);
+    });
+});

package/dist/overflow-list/OverflowList.kbd.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OverflowList.kbd.test.d.ts.map

package/dist/overflow-list/OverflowList.kbd.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverflowList.kbd.test.d.ts","sourceRoot":"","sources":["../../src/overflow-list/OverflowList.kbd.test.ts"],"names":[],"mappings":""}

package/dist/overflow-list/OverflowList.kbd.test.js

@@ -0,0 +1,28 @@
+// OverflowList 键盘 e2e（browser project / 真实 chromium），scroll 模式可聚焦滚动容器。
+// scroll 模式下可见层（.cd-overflow-list__visible）成为滚动容器，tabindex=0 + role=group +
+// aria-label，键盘用户可 Tab 聚焦后用方向键滚动（浏览器对聚焦滚动容器原生支持，WCAG 2.1.1）。
+//   Tab 从前置按钮进入 → 焦点落到可滚动可见层（真实焦点 + 可访问名存在）。
+import { describe, it, expect } from 'vitest';
+import { page } from 'vitest/browser';
+import { renderKbdFixture, userEvent } from '../test-utils/kbd.js';
+import OverflowListKbdFixture from './OverflowListKbdFixture.svelte';
+function loc(el) {
+    return page.elementLocator(el);
+}
+describe('OverflowList 键盘 e2e（scroll 模式可聚焦滚动容器）', () => {
+    it('Tab 聚焦可滚动可见层（tabindex=0 + 可访问名）', async () => {
+        const { baseElement } = renderKbdFixture(OverflowListKbdFixture);
+        const scroller = baseElement.querySelector('.cd-overflow-list__visible');
+        expect(scroller).not.toBeNull();
+        // scroll 模式可见层可聚焦 + 有可访问名 + group 角色。
+        expect(scroller.tabIndex).toBe(0);
+        expect(scroller.getAttribute('role')).toBe('group');
+        expect(scroller.getAttribute('aria-label')).toBe('Tags');
+        // Tab 从前置按钮进入 → 焦点落到可滚动可见层（真实焦点）。
+        const before = baseElement.querySelector('[data-testid="before"]');
+        before.focus();
+        await expect.element(loc(before)).toHaveFocus();
+        await userEvent.tab();
+        await expect.element(loc(scroller)).toHaveFocus();
+    });
+});