@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/notification/meta.d.ts

@@ -1,110 +1,133 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * Notification — see specs/components/feedback/Notification.spec.md
+ * Notification — 严格对齐 Semi Design（semi-ui/notification）。
  */
 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 description: "通知提醒框：命令式全局反馈 API（notification.open/success/info/warning/error/close/destroyAll/config + useNotification）。严格对齐 Semi——标题 + 内容 + 图标；六方位独立堆叠；单例容器惰性挂载到 getPopupContainer()（默认 body）；duration 秒自动关闭（0 常驻）+ hover 暂停/重启定时器 + 同 id 原地更新；role=alert + aria-labelledby 关联标题；theme(normal/light) 填充样式；icon 自定义图标；onClick 点击回调；onCloseClick 关闭按钮回调；notification.config({ top/bottom/left/right/position/duration/zIndex/direction/getPopupContainer }) 全局配置（首次生效）。useNotification() 返回 [api, holderStore]，配合 <NotificationHolder store={holderStore}> 让通知继承组件树上下文。";
+    readonly exports: readonly ["notification", "useNotification", "NotificationHolder"];
     readonly imperative: true;
     readonly config: {
-        readonly direction: "全局默认书写方向 'ltr'|'rtl'（per-item direction 优先）";
-        readonly getPopupContainer: "() => HTMLElement，容器宿主挂载目标（默认 body）；须在首条通知前调用方生效";
+        readonly top: "弹出位置 top（number | string），首次生效";
+        readonly bottom: "弹出位置 bottom（number | string），首次生效";
+        readonly left: "弹出位置 left（number | string），首次生效";
+        readonly right: "弹出位置 right（number | string），首次生效";
+        readonly position: "默认弹出位置 'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'（默认 topRight）";
+        readonly duration: "默认自动关闭秒数（默认 3，0 常驻）";
+        readonly zIndex: "通知列表 z-index（默认 1010，首次生效）";
+        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 desc: "指定 id；已存在则原地更新（对齐 Semi）";
     }, {
         readonly name: "title";
-        readonly type: "string";
-        readonly default: "—";
-        readonly desc: "通知标题";
+        readonly type: "string | Snippet";
+        readonly default: "''";
+        readonly desc: "通知标题（string 文本或 Snippet）";
     }, {
         readonly name: "content";
-        readonly type: "string";
-        readonly default: "—";
-        readonly desc: "通知正文";
+        readonly type: "string | Snippet";
+        readonly default: "''";
+        readonly desc: "通知内容（string 文本或 Snippet）";
     }, {
         readonly name: "type";
         readonly type: "'default'|'success'|'info'|'warning'|'error'";
         readonly default: "'default'";
-        readonly desc: "语义类型，决定图标与强调色";
+        readonly desc: "语义类型，决定内置图标与强调色";
     }, {
         readonly name: "duration";
         readonly type: "number";
-        readonly default: "4.5";
-        readonly desc: "自动关闭秒数；0 持久";
+        readonly default: "3";
+        readonly desc: "自动关闭秒数，单位 s，0 时不自动关闭";
     }, {
-        readonly name: "placement";
-        readonly type: "'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'";
+        readonly name: "position";
+        readonly type: "'top'|'bottom'|'topLeft'|'topRight'|'bottomLeft'|'bottomRight'";
         readonly default: "'topRight'";
         readonly desc: "弹出位置，每方位独立堆叠";
     }, {
-        readonly name: "closable";
+        readonly name: "showClose";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "是否显示关闭按钮";
+        readonly desc: "是否展示关闭按钮";
     }, {
-        readonly name: "pauseOnHover";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "悬停/聚焦时暂停定时器";
+        readonly name: "theme";
+        readonly type: "'normal'|'light'";
+        readonly default: "'normal'";
+        readonly desc: "填充样式；light 为多色浅填充（提高与界面对比）";
     }, {
-        readonly name: "showProgress";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "底部倒计时进度条，随 duration 递减；悬停/聚焦时与定时器同步暂停（duration=0 时不显示）";
+        readonly name: "icon";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "左上角自定义图标（覆盖类型内置图标）";
     }, {
-        readonly name: "theme";
-        readonly type: "'light'|'dark'";
-        readonly default: "'light'";
-        readonly desc: "卡片主题；dark 为深色卡片";
+        readonly name: "zIndex";
+        readonly type: "number";
+        readonly default: "1010";
+        readonly desc: "弹层 z-index，首次设置一次生效";
     }, {
         readonly name: "direction";
         readonly type: "'ltr'|'rtl'";
         readonly default: "'ltr'（可经 notification.config 改默认）";
-        readonly desc: "RTL 时镜像卡片布局（关闭按钮/图标/文案/进度方向翻转）并左右互换方位";
+        readonly desc: "RTL 时镜像卡片布局（图标/内容 margin 方向翻转）";
     }, {
-        readonly name: "footer";
-        readonly type: "Snippet";
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement";
+        readonly default: "() => document.body";
+        readonly desc: "指定父级 DOM，容器将渲染至该 DOM（首条通知生效）";
+    }, {
+        readonly name: "onClick";
+        readonly type: "(e: MouseEvent) => void";
         readonly default: "undefined";
-        readonly desc: "底部操作区插槽（按钮等），渲染在内容下方";
+        readonly desc: "点击通知的回调";
     }, {
         readonly name: "onClose";
-        readonly type: "(id: string, reason: 'timeout'|'manual'|'replace'|'destroyAll') => void";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "通知关闭回调（主动关闭、延时到达关闭都会触发）";
+    }, {
+        readonly name: "onCloseClick";
+        readonly type: "(id: string) => void";
         readonly default: "undefined";
-        readonly desc: "关闭回调，附关闭原因";
+        readonly desc: "主动点击关闭按钮时的回调";
     }];
     readonly events: readonly [{
         readonly name: "onClose";
-        readonly desc: "单条关闭（超时/手动/被替换/清空）时触发，带 id 与 reason";
+        readonly desc: "通知关闭时触发（主动关闭 / 延时到达 / destroyAll）";
+    }, {
+        readonly name: "onClick";
+        readonly desc: "点击通知卡片时触发";
+    }, {
+        readonly name: "onCloseClick";
+        readonly desc: "主动点击关闭按钮时触发，带 id";
     }];
     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 note: "role=alert（对齐 Semi）；标题经 aria-labelledby 关联；关闭按钮为 IconButton，带 ariaLabel「关闭」。不抢焦点、不锁滚动。";
     };
-    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-title-weight", "--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 tokens: readonly ["--cd-color-notification-bg-default", "--cd-color-notification-info-icon", "--cd-color-notification-warning-icon", "--cd-color-notification-danger-icon", "--cd-color-notification-success-icon", "--cd-color-notification-title-text", "--cd-color-notification-content-text", "--cd-color-notification-closebtn-icon", "--cd-color-notification-warning-light-bg", "--cd-color-notification-warning-light-border", "--cd-color-notification-success-light-bg", "--cd-color-notification-success-light-border", "--cd-color-notification-info-light-bg", "--cd-color-notification-info-light-border", "--cd-color-notification-danger-light-bg", "--cd-color-notification-danger-light-border", "--cd-color-notification-ambient-bg", "--cd-width-notification-notice", "--cd-width-notification-notice-minwidth", "--cd-width-notification-notice-icon", "--cd-width-notification-notice-border", "--cd-spacing-notification-list-margin", "--cd-spacing-notification-list-padding", "--cd-spacing-notification-notice-paddingtop", "--cd-spacing-notification-notice-paddingright", "--cd-spacing-notification-notice-paddingbottom", "--cd-spacing-notification-notice-paddingleft", "--cd-spacing-notification-notice-margin", "--cd-spacing-notification-notice-marginright", "--cd-spacing-notification-notice-title-marginbottom", "--cd-spacing-notification-notice-content-wrapper-marginright", "--cd-spacing-notification-notice-icon-marginright", "--cd-radius-notification-notice", "--cd-font-notification-notice-title-fontweight", "--cd-font-notification-notice-content-fontweight"];
     readonly responsive: false;
     readonly examples: readonly [{
-        readonly title: "成功";
-        readonly code: "notification.success({ title: '已上传', content: '文件保存成功' })";
+        readonly title: "普通通知";
+        readonly code: "notification.open({ title: 'Hi, Bytedance', content: 'ies dance dance dance', duration: 3 })";
     }, {
-        readonly title: "错误";
-        readonly code: "notification.error({ title: '保存失败', content: '网络中断' })";
+        readonly title: "成功";
+        readonly code: "notification.success({ title: '上传完成', content: '文件已保存' })";
     }, {
-        readonly title: "常驻";
-        readonly code: "notification.open({ title: '提醒', duration: 0 })";
+        readonly title: "多色";
+        readonly code: "notification.info({ title: 'Hi', content: '…', theme: 'light' })";
     }, {
-        readonly title: "RTL";
-        readonly code: "notification.info({ title: 'مرحبا', content: 'نص', direction: 'rtl' })";
+        readonly title: "常驻 + 手动关闭";
+        readonly code: "const id = notification.info({ content: 'Not auto close', duration: 0 }); notification.close(id)";
     }, {
-        readonly title: "全局配置";
-        readonly code: "notification.config({ direction: 'rtl', getPopupContainer: () => document.getElementById('app')! })";
+        readonly title: "更新内容";
+        readonly code: "const id = notification.open({ content: 'v1' }); notification.open({ id, content: 'v2' })";
     }];
 };
 //# sourceMappingURL=meta.d.ts.map

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

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

package/dist/notification/meta.js

@@ -1,119 +1,130 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * Notification — see specs/components/feedback/Notification.spec.md
+ * Notification — 严格对齐 Semi Design（semi-ui/notification）。
  */
 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'],
+    description: '通知提醒框：命令式全局反馈 API（notification.open/success/info/warning/error/close/destroyAll/config + useNotification）。严格对齐 Semi——标题 + 内容 + 图标；六方位独立堆叠；单例容器惰性挂载到 getPopupContainer()（默认 body）；duration 秒自动关闭（0 常驻）+ hover 暂停/重启定时器 + 同 id 原地更新；role=alert + aria-labelledby 关联标题；theme(normal/light) 填充样式；icon 自定义图标；onClick 点击回调；onCloseClick 关闭按钮回调；notification.config({ top/bottom/left/right/position/duration/zIndex/direction/getPopupContainer }) 全局配置（首次生效）。useNotification() 返回 [api, holderStore]，配合 <NotificationHolder store={holderStore}> 让通知继承组件树上下文。',
+    exports: ['notification', 'useNotification', 'NotificationHolder'],
     imperative: true,
     config: {
-        direction: "全局默认书写方向 'ltr'|'rtl'（per-item direction 优先）",
-        getPopupContainer: '() => HTMLElement，容器宿主挂载目标（默认 body）；须在首条通知前调用方生效',
+        top: '弹出位置 top（number | string），首次生效',
+        bottom: '弹出位置 bottom（number | string），首次生效',
+        left: '弹出位置 left（number | string），首次生效',
+        right: '弹出位置 right（number | string），首次生效',
+        position: "默认弹出位置 'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'（默认 topRight）",
+        duration: '默认自动关闭秒数（默认 3，0 常驻）',
+        zIndex: '通知列表 z-index（默认 1010，首次生效）',
+        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: 'id', type: 'string', default: 'undefined', desc: '指定 id；已存在则原地更新（对齐 Semi）' },
+        { name: 'title', type: 'string | Snippet', default: "''", desc: '通知标题（string 文本或 Snippet）' },
+        { name: 'content', type: 'string | Snippet', default: "''", desc: '通知内容（string 文本或 Snippet）' },
         {
             name: 'type',
             type: "'default'|'success'|'info'|'warning'|'error'",
             default: "'default'",
-            desc: '语义类型，决定图标与强调色',
+            desc: '语义类型，决定内置图标与强调色',
         },
+        { name: 'duration', type: 'number', default: '3', desc: '自动关闭秒数，单位 s，0 时不自动关闭' },
         {
-            name: 'duration',
-            type: 'number',
-            default: '4.5',
-            desc: '自动关闭秒数；0 持久',
-        },
-        {
-            name: 'placement',
-            type: "'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'",
+            name: 'position',
+            type: "'top'|'bottom'|'topLeft'|'topRight'|'bottomLeft'|'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: 'showClose', type: 'boolean', default: 'true', desc: '是否展示关闭按钮' },
         {
             name: 'theme',
-            type: "'light'|'dark'",
-            default: "'light'",
-            desc: '卡片主题；dark 为深色卡片',
+            type: "'normal'|'light'",
+            default: "'normal'",
+            desc: '填充样式；light 为多色浅填充（提高与界面对比）',
         },
+        { name: 'icon', type: 'Snippet', default: 'undefined', desc: '左上角自定义图标（覆盖类型内置图标）' },
+        { name: 'zIndex', type: 'number', default: '1010', desc: '弹层 z-index，首次设置一次生效' },
         {
             name: 'direction',
             type: "'ltr'|'rtl'",
             default: "'ltr'（可经 notification.config 改默认）",
-            desc: 'RTL 时镜像卡片布局（关闭按钮/图标/文案/进度方向翻转）并左右互换方位',
+            desc: 'RTL 时镜像卡片布局（图标/内容 margin 方向翻转）',
         },
         {
-            name: 'footer',
-            type: 'Snippet',
-            default: 'undefined',
-            desc: '底部操作区插槽（按钮等），渲染在内容下方',
+            name: 'getPopupContainer',
+            type: '() => HTMLElement',
+            default: '() => document.body',
+            desc: '指定父级 DOM，容器将渲染至该 DOM（首条通知生效）',
         },
+        { name: 'onClick', type: '(e: MouseEvent) => void', default: 'undefined', desc: '点击通知的回调' },
         {
             name: 'onClose',
-            type: "(id: string, reason: 'timeout'|'manual'|'replace'|'destroyAll') => void",
+            type: '() => void',
             default: 'undefined',
-            desc: '关闭回调，附关闭原因',
+            desc: '通知关闭回调（主动关闭、延时到达关闭都会触发）',
         },
+        {
+            name: 'onCloseClick',
+            type: '(id: string) => void',
+            default: 'undefined',
+            desc: '主动点击关闭按钮时的回调',
+        },
+    ],
+    events: [
+        { name: 'onClose', desc: '通知关闭时触发（主动关闭 / 延时到达 / destroyAll）' },
+        { name: 'onClick', desc: '点击通知卡片时触发' },
+        { name: 'onCloseClick', desc: '主动点击关闭按钮时触发，带 id' },
     ],
-    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「关闭」。不抢焦点、不锁滚动。',
+        note: 'role=alert（对齐 Semi）；标题经 aria-labelledby 关联；关闭按钮为 IconButton，带 ariaLabel「关闭」。不抢焦点、不锁滚动。',
     },
     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-title-weight',
-        '--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',
+        '--cd-color-notification-bg-default',
+        '--cd-color-notification-info-icon',
+        '--cd-color-notification-warning-icon',
+        '--cd-color-notification-danger-icon',
+        '--cd-color-notification-success-icon',
+        '--cd-color-notification-title-text',
+        '--cd-color-notification-content-text',
+        '--cd-color-notification-closebtn-icon',
+        '--cd-color-notification-warning-light-bg',
+        '--cd-color-notification-warning-light-border',
+        '--cd-color-notification-success-light-bg',
+        '--cd-color-notification-success-light-border',
+        '--cd-color-notification-info-light-bg',
+        '--cd-color-notification-info-light-border',
+        '--cd-color-notification-danger-light-bg',
+        '--cd-color-notification-danger-light-border',
+        '--cd-color-notification-ambient-bg',
+        '--cd-width-notification-notice',
+        '--cd-width-notification-notice-minwidth',
+        '--cd-width-notification-notice-icon',
+        '--cd-width-notification-notice-border',
+        '--cd-spacing-notification-list-margin',
+        '--cd-spacing-notification-list-padding',
+        '--cd-spacing-notification-notice-paddingtop',
+        '--cd-spacing-notification-notice-paddingright',
+        '--cd-spacing-notification-notice-paddingbottom',
+        '--cd-spacing-notification-notice-paddingleft',
+        '--cd-spacing-notification-notice-margin',
+        '--cd-spacing-notification-notice-marginright',
+        '--cd-spacing-notification-notice-title-marginbottom',
+        '--cd-spacing-notification-notice-content-wrapper-marginright',
+        '--cd-spacing-notification-notice-icon-marginright',
+        '--cd-radius-notification-notice',
+        '--cd-font-notification-notice-title-fontweight',
+        '--cd-font-notification-notice-content-fontweight',
     ],
     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')! })",
-        },
+        { title: '普通通知', code: "notification.open({ title: 'Hi, Bytedance', content: 'ies dance dance dance', duration: 3 })" },
+        { title: '成功', code: "notification.success({ title: '上传完成', content: '文件已保存' })" },
+        { title: '多色', code: "notification.info({ title: 'Hi', content: '…', theme: 'light' })" },
+        { title: '常驻 + 手动关闭', code: "const id = notification.info({ content: 'Not auto close', duration: 0 }); notification.close(id)" },
+        { title: '更新内容', code: "const id = notification.open({ content: 'v1' }); notification.open({ id, content: 'v2' })" },
     ],
 };

package/dist/notification/store.d.ts

@@ -1,70 +1,85 @@
 /**
- * Notification — 命令式全局通知提醒框入口。
- * 模块级单例 store + 惰性挂载的单例 NotificationContainer（首次调用时 mount 到 body）。
- * 复用 @chenzy-design/core 的 createNotificationStore（无框架依赖的队列 + 定时器）。
- * 与 Toast 同构，差异：数据含 title + content、6 方位独立堆叠、无 loading 类型；
- * 命令式入参是 NotificationOptions 配置对象（不像 Toast 首参是 string）。
- * See specs/components/feedback/Notification.spec.md
+ * Notification — 命令式全局通知提醒框入口，严格对齐 Semi Design
+ * （semi-ui/notification/index.tsx 的静态方法 + config + useNotification）。
+ * 模块级单例 store + 惰性挂载的单例 NotificationContainer（首次调用时 mount 到
+ * getPopupContainer() 或 body）。复用 @chenzy-design/core 的 createNotificationStore
+ * （无框架依赖的队列 + 定时器，语义对齐 Semi foundation）。
+ *
+ * 对齐 Semi 静态 API：open/info/success/warning/error/close/destroyAll/config/useNotification。
+ * See semi-ui/notification/index.tsx
  */
-import { type NotificationOptions, type NotificationPlacement, type NotificationDirection } from '@chenzy-design/core';
+import { type NotificationStore, type NotificationOptions, type NotificationPosition, 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 覆盖。
- * 须在首条通知前调用方对挂载点生效（容器惰性挂载且单例，仅挂一次）。
+ * 全局配置（对齐 Semi Notification.config）。容器经 mount() 挂在 Svelte 组件树之外，
+ * 拿不到 ConfigProvider context，故位置偏移 / 挂载容器只能经此命令式入口配置：
+ *  - top/bottom/left/right：list 与视口边缘的偏移（CSS 值或数字像素），首次生效。
+ *  - position：默认弹出位置（对齐 Semi defaultConfig.position）。
+ *  - duration：默认自动关闭秒数（0 = 常驻），可被单条 options.duration 覆盖。
+ *  - zIndex：通知列表 z-index（对齐 Semi，默认 1010，首次生效）。
+ *  - direction：默认书写方向（Svelte 命令式入口特有；per-item direction 优先）。
+ *  - getPopupContainer：容器宿主挂载目标（默认 body，对齐 Semi getPopupContainer）。
  */
 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 }) 覆盖 */
+    position?: NotificationPosition;
     duration?: number;
+    zIndex?: number;
+    direction?: NotificationDirection;
+    getPopupContainer?: () => HTMLElement | null | undefined;
 }
 /**
- * Svelte 层扩展选项（core NotificationOptions 的超集）：
- *  - showClose: closable 的别名（Semi 文档用 showClose），两者等价，showClose 优先。
- *  - onCloseClick: 仅在用户点击关闭按钮时触发（与 onClose 区分：onClose 在任何关闭方式时触发）。
+ * Svelte 命令式选项（对齐 Semi NoticeProps）。title/content/icon 可为 string 文本或
+ * Svelte Snippet（对齐 Semi ReactNode）；其余与 core NotificationOptions 一致。
+ * 额外的 getPopupContainer（per-notice）：首条通知的该值决定容器挂载点（对齐 Semi）。
  */
-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>;
+export type SvelteNotificationOptions = NotificationOptions & {
+    getPopupContainer?: () => HTMLElement | null | undefined;
+};
+type PositionOffsets = Pick<NotificationConfig, 'top' | 'bottom' | 'left' | 'right' | 'zIndex'>;
 /** 位置偏移 getter：供 NotificationContainer 读取并注入 inline style（config() 后生效）。 */
-export declare function getPositionOffsets(): Pick<NotificationConfig, 'top' | 'bottom' | 'left' | 'right' | 'zIndex'>;
+export declare function getPositionOffsets(): PositionOffsets;
 export declare const notification: {
     /**
-     * 配置全局通知行为：direction（默认书写方向）、getPopupContainer（容器挂载目标）、
-     * top/bottom/left/right/zIndex（容器位置偏移）、duration（全局默认自动关闭秒数）。
-     * 命令式单例特性——须在首条通知前调用方对挂载点生效。向后兼容：不调用即 ltr + body。
+     * 配置全局通知行为（对齐 Semi Notification.config）：top/bottom/left/right/zIndex（位置偏移，
+     * 首次生效）、position（默认位置）、duration（默认自动关闭秒数）、direction（默认方向）、
+     * getPopupContainer（容器挂载目标）。须在首条通知前调用方对挂载点 / 偏移生效。
      */
     config: (cfg: NotificationConfig) => void;
-    /** 完整选项打开一条通知，返回其 id。 */
+    /** 展示一条通知（type=default），返回其 id（对齐 Semi open；已存在 id 原地更新）。 */
     open: (opts: SvelteNotificationOptions) => string;
     success: (opts: SvelteNotificationOptions) => string;
     info: (opts: SvelteNotificationOptions) => string;
     warning: (opts: SvelteNotificationOptions) => string;
     error: (opts: SvelteNotificationOptions) => string;
-    /** 手动关闭指定通知。 */
+    /** 手动关闭指定通知（对齐 Semi close）。 */
     close: (id: string) => void;
-    /** 按同 id 更新一条通知（store.open 对已存在 id 走原地更新 + 重启定时器）。 */
-    update: (id: string, opts: SvelteNotificationOptions) => string;
-    /** 清空全部通知，或仅清空指定方位。 */
-    destroyAll: (placement?: NotificationPlacement) => void;
+    /** 清空全部通知（对齐 Semi destroyAll）。 */
+    destroyAll: () => void;
 };
+/** useNotification Hook 返回的 api（对齐 Semi：info/success/warning/error/open/close）。 */
+export interface NotificationHookApi {
+    open: (opts: SvelteNotificationOptions) => string;
+    success: (opts: SvelteNotificationOptions) => string;
+    info: (opts: SvelteNotificationOptions) => string;
+    warning: (opts: SvelteNotificationOptions) => string;
+    error: (opts: SvelteNotificationOptions) => string;
+    close: (id: string) => void;
+}
+/**
+ * useNotification — Svelte 版 Hook（对齐 Semi Notification.useNotification）。
+ * 返回 [api, holderStore]：
+ *  - api：info/success/warning/error/open/close（局部，不含全局的 config/destroyAll）；
+ *  - holderStore：传给 <NotificationHolder store={holderStore} /> 渲染在组件树内，
+ *    使经此 api 创建的通知渲染在 holder 所在位置，继承该处上下文（如 LocaleProvider）。
+ * 与全局单例不同：本 Hook 的 store 与容器是局部的，不挂 body。
+ * 用法：
+ *   const [api, holderStore] = useNotification();
+ *   // 模板中：<NotificationHolder store={holderStore} />
+ *   // 事件中：api.info({ title, content })
+ */
+export declare function useNotification(): [NotificationHookApi, NotificationStore];
+export {};
 //# sourceMappingURL=store.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notification/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1D;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG;IAC5D,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1D,CAAC;AAUF,KAAK,eAAe,GAAG,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;AAGhG,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AA6CD,eAAO,MAAM,YAAY;IACvB;;;;OAIG;kBACW,kBAAkB,KAAG,IAAI;IAavC,6DAA6D;iBAChD,yBAAyB,KAAG,MAAM;oBAC/B,yBAAyB,KAAG,MAAM;iBACrC,yBAAyB,KAAG,MAAM;oBAC/B,yBAAyB,KAAG,MAAM;kBACpC,yBAAyB,KAAG,MAAM;IAChD,+BAA+B;gBACnB,MAAM,KAAG,IAAI;IACzB,kCAAkC;sBAClB,IAAI;CACrB,CAAC;AAEF,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,MAAM,CAAC;IAClD,OAAO,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,MAAM,CAAC;IAClD,OAAO,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,MAAM,CAAC;IACrD,KAAK,EAAE,CAAC,IAAI,EAAE,yBAAyB,KAAK,MAAM,CAAC;IACnD,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,IAAI,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAc1E"}