@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/toast/meta.d.ts

@@ -1,90 +1,121 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * Toast — see specs/components/feedback/Toast.spec.md
+ * Toast — 严格对齐 Semi Design（semi-ui/toast）。
  */
 export declare const meta: {
     readonly name: "Toast";
     readonly category: "feedback";
-    readonly description: "轻提示：命令式全局反馈 API（Toast.info/success/warning/error/loading/open/promise/close/update/destroyAll）。单例容器惰性挂载到 body；类型预设图标 + 自动消失 + 悬停暂停 + 按方位 maxCount FIFO 淘汰 + 同 id 去重更新；6 方位独立堆叠（topLeft/top/topRight/bottomLeft/bottom/bottomRight，对齐 Notification）多条同方位纵向堆叠不重叠；theme(light/dark) 卡片主题；Toast.promise(promise, { loading, success, error }) 传入 Promise 自动 pending→resolve/reject 切文案（success/error 可为函数接收值，默认文案经 @chenzy-design/locale）；a11y 播报走单例 ARIA live region（error->assertive、其余->polite），卡片本身纯视觉无 role/aria-live。";
-    readonly exports: readonly ["Toast", "ToastPromiseMessages"];
+    readonly description: "轻提示：命令式全局反馈 API（Toast.info/success/warning/error/open/close/destroyAll/config/useToast + ToastFactory.create），严格对齐 Semi Design。单例容器惰性挂载到 body（wrapper 固定顶部居中，config 的 top/left/bottom/right 整体偏移）；type=info/success/warning/error/default（default 无内置图标）；theme=normal（白）/light（多色填充+描边）；stack 多条堆叠、Hover 展开（3D 透视折叠）；duration 自动关闭（0 常驻）、mouseenter 暂停/mouseleave 从头计时；showClose 关闭按钮（复用 IconButton）；textMaxWidth 内容最大宽度；content/icon 支持 string 或 Snippet；对已存在 id 再调 info/success 即原地更新。useToast() 返回 [api, holderStore] 经 <ToastHolder> 渲染在组件树内继承上下文；ToastFactory.create(config) 创建带独立 config 的新实例（如 getPopupContainer）。a11y：卡片 role=alert + aria-label=\"{type} type\"（对齐 Semi），关闭按钮 IconButton 带可访问名。";
+    readonly exports: readonly ["Toast", "ToastFactory", "useToast", "ToastHolder"];
     readonly imperative: true;
     readonly props: readonly [{
         readonly name: "content";
-        readonly type: "string";
-        readonly default: "—";
-        readonly desc: "提示文本（必填）";
+        readonly type: "string | Snippet";
+        readonly default: "''";
+        readonly desc: "提示内容（必填），支持文本或自定义 Snippet";
     }, {
         readonly name: "id";
         readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "指定 id；已存在则原地更新并重启定时器";
+        readonly desc: "自定义 ToastId；已存在则原地合并更新并重启定时器";
     }, {
         readonly name: "type";
-        readonly type: "'info'|'success'|'warning'|'error'|'loading'";
-        readonly default: "'info'";
-        readonly desc: "语义类型，决定图标与色";
+        readonly type: "'info'|'success'|'warning'|'error'|'default'";
+        readonly default: "'default'";
+        readonly desc: "语义类型，决定图标与色；default 无内置图标";
     }, {
         readonly name: "duration";
         readonly type: "number";
         readonly default: "3";
-        readonly desc: "自动消失秒数；0 持久。loading 默认 0";
-    }, {
-        readonly name: "position";
-        readonly type: "'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'";
-        readonly default: "'top'";
-        readonly desc: "出现方位，每方位独立纵向堆叠";
+        readonly desc: "自动关闭秒数；0 = 不自动关闭（须手动关闭）";
     }, {
-        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: "textMaxWidth";
+        readonly type: "number | string";
+        readonly default: "450";
+        readonly desc: "内容的最大宽度";
     }, {
         readonly name: "theme";
-        readonly type: "'light'|'dark'";
-        readonly default: "'light'";
-        readonly desc: "卡片主题；dark 为深色卡片";
+        readonly type: "'normal'|'light'";
+        readonly default: "'normal'";
+        readonly desc: "填充样式；'light' 浅色填充 + 类型描边";
     }, {
-        readonly name: "onClose";
-        readonly type: "(id: string, reason: 'timeout'|'manual'|'replace'|'destroyAll') => void";
-        readonly default: "undefined";
-        readonly desc: "关闭回调，附关闭原因";
+        readonly name: "stack";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "是否堆叠 Toast（多条叠一摞、Hover 展开）";
     }, {
         readonly name: "icon";
-        readonly type: "Snippet | false";
+        readonly type: "Snippet";
         readonly default: "undefined";
-        readonly desc: "自定义图标 snippet；false 隐藏图标";
+        readonly desc: "自定义图标（覆盖类型内置图标）";
     }, {
-        readonly name: "showClose";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "是否显示关闭按钮（closable 别名）";
+        readonly name: "direction";
+        readonly type: "'ltr'|'rtl'";
+        readonly default: "'ltr'";
+        readonly desc: "书写方向";
     }, {
-        readonly name: "textMaxWidth";
+        readonly name: "onClose";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "toast 关闭时的回调（无参数，对齐 Semi）";
+    }];
+    readonly config: readonly [{
+        readonly name: "top";
         readonly type: "number | string";
-        readonly default: "450";
-        readonly desc: "内容区最大宽度（px 数字或 CSS 字符串）";
+        readonly default: "-";
+        readonly desc: "弹出位置 top（wrapper 整体偏移）";
     }, {
-        readonly name: "stack";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "堆叠显示：容器附加 cd-toast-wrapper--stacked class";
+        readonly name: "bottom";
+        readonly type: "number | string";
+        readonly default: "-";
+        readonly desc: "弹出位置 bottom";
+    }, {
+        readonly name: "left";
+        readonly type: "number | string";
+        readonly default: "-";
+        readonly desc: "弹出位置 left";
+    }, {
+        readonly name: "right";
+        readonly type: "number | string";
+        readonly default: "-";
+        readonly desc: "弹出位置 right";
+    }, {
+        readonly name: "zIndex";
+        readonly type: "number";
+        readonly default: "1010";
+        readonly desc: "wrapper z-index";
+    }, {
+        readonly name: "theme";
+        readonly type: "'normal'|'light'";
+        readonly default: "'normal'";
+        readonly desc: "默认填充样式";
+    }, {
+        readonly name: "duration";
+        readonly type: "number";
+        readonly default: "3";
+        readonly desc: "默认自动关闭延时（秒），0 不自动关闭";
+    }, {
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement | null";
+        readonly default: "() => document.body";
+        readonly desc: "指定容器挂载父级 DOM";
     }];
     readonly events: readonly [{
         readonly name: "onClose";
-        readonly desc: "单条关闭（超时/手动/被替换/清空）时触发，带 id 与 reason";
+        readonly desc: "toast 关闭时触发（无参数，对齐 Semi）";
     }];
     readonly slots: readonly [];
     readonly a11y: {
         readonly hasRole: true;
         readonly focusable: false;
-        readonly note: "所有文案播报走 body 上单例 ARIA live region（全局唯一一对：role=status/aria-live=polite + role=alert/aria-live=assertive）；error 走 assertive 立即打断，其余走 polite。store 在新增/更新 toast 时命令式写入 region 文案，卡片本身纯视觉、不带 role/aria-live，避免多 region 重复/竞争播报。关闭按钮 button + aria-label「关闭」。不抢焦点、不锁滚动。";
+        readonly note: "每张 toast 卡片自身 role=alert + aria-label=\"{type} type\"（对齐 Semi），屏幕阅读器直接播报卡片内容。关闭按钮 IconButton 带 aria-label（locale Toast.close）。不抢焦点、不锁滚动。";
     };
-    readonly tokens: readonly ["--cd-toast-bg", "--cd-toast-color-text", "--cd-toast-color-icon-info", "--cd-toast-color-icon-success", "--cd-toast-color-icon-warning", "--cd-toast-color-icon-error", "--cd-toast-color-close", "--cd-toast-color-close-hover", "--cd-toast-radius", "--cd-toast-shadow", "--cd-toast-padding", "--cd-toast-gap", "--cd-toast-font-size", "--cd-toast-font-weight", "--cd-toast-max-width", "--cd-toast-min-width", "--cd-toast-stack-gap", "--cd-toast-z", "--cd-toast-motion-duration", "--cd-toast-bg-dark", "--cd-toast-color-text-dark", "--cd-toast-color-close-dark", "--cd-toast-color-close-hover-dark"];
+    readonly tokens: readonly ["--cd-color-toast-bg-default", "--cd-color-toast-text-default", "--cd-color-toast-warning-icon", "--cd-color-toast-success-icon", "--cd-color-toast-info-icon", "--cd-color-toast-danger-icon", "--cd-color-toast-warning-light-bg", "--cd-color-toast-warning-light-icon", "--cd-color-toast-warning-light-border", "--cd-color-toast-success-light-bg", "--cd-color-toast-success-light-icon", "--cd-color-toast-success-light-border", "--cd-color-toast-info-light-bg", "--cd-color-toast-info-light-icon", "--cd-color-toast-info-light-border", "--cd-color-toast-danger-light-bg", "--cd-color-toast-danger-light-icon", "--cd-color-toast-danger-light-border", "--cd-spacing-toast-wrapper-top", "--cd-spacing-toast-content-paddingy", "--cd-spacing-toast-content-paddingx", "--cd-spacing-toast-content-paddingtop", "--cd-spacing-toast-content-paddingbottom", "--cd-spacing-toast-content-paddingleft", "--cd-spacing-toast-content-paddingright", "--cd-spacing-toast-content-margin", "--cd-spacing-toast-content-close-btn-margintop", "--cd-spacing-toast-content-text-marginleft", "--cd-spacing-toast-content-text-marginright", "--cd-spacing-toast-perspective-originy", "--cd-spacing-toast-perspective", "--cd-width-toast-wrapper", "--cd-width-toast-light-border", "--cd-radius-toast-content", "--cd-font-toast-content-fontweight"];
     readonly responsive: false;
     readonly examples: readonly [{
         readonly title: "成功";
@@ -93,17 +124,17 @@ export declare const meta: {
         readonly title: "错误";
         readonly code: "Toast.error('保存失败')";
     }, {
-        readonly title: "加载（持久）";
-        readonly code: "Toast.loading('上传中', { duration: 0 })";
+        readonly title: "堆叠";
+        readonly code: "Toast.info({ content: '已同步', stack: true })";
     }, {
-        readonly title: "右下角";
-        readonly code: "Toast.info('已同步', { position: 'bottomRight' })";
+        readonly title: "多色";
+        readonly code: "Toast.warning({ content: '存储空间不足', theme: 'light' })";
     }, {
-        readonly title: "深色主题";
-        readonly code: "Toast.success('已保存', { theme: 'dark' })";
+        readonly title: "常驻";
+        readonly code: "Toast.info({ content: '手动关闭', duration: 0 })";
     }, {
-        readonly title: "promise";
-        readonly code: "Toast.promise(save(), { loading: '保存中…', success: '已保存', error: (e) => `失败：${e.message}` })";
+        readonly title: "更新";
+        readonly code: "const id = 'x'; Toast.info({ content: '处理中', id }); Toast.success({ content: '完成', id })";
     }];
 };
 //# sourceMappingURL=meta.d.ts.map

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

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

package/dist/toast/meta.js

@@ -1,95 +1,102 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * Toast — see specs/components/feedback/Toast.spec.md
+ * Toast — 严格对齐 Semi Design（semi-ui/toast）。
  */
 export const meta = {
     name: 'Toast',
     category: 'feedback',
-    description: '轻提示：命令式全局反馈 API（Toast.info/success/warning/error/loading/open/promise/close/update/destroyAll）。单例容器惰性挂载到 body；类型预设图标 + 自动消失 + 悬停暂停 + 按方位 maxCount FIFO 淘汰 + 同 id 去重更新；6 方位独立堆叠（topLeft/top/topRight/bottomLeft/bottom/bottomRight，对齐 Notification）多条同方位纵向堆叠不重叠；theme(light/dark) 卡片主题；Toast.promise(promise, { loading, success, error }) 传入 Promise 自动 pending→resolve/reject 切文案（success/error 可为函数接收值，默认文案经 @chenzy-design/locale）；a11y 播报走单例 ARIA live region（error->assertive、其余->polite），卡片本身纯视觉无 role/aria-live。',
-    exports: ['Toast', 'ToastPromiseMessages'],
+    description: '轻提示：命令式全局反馈 API（Toast.info/success/warning/error/open/close/destroyAll/config/useToast + ToastFactory.create），严格对齐 Semi Design。单例容器惰性挂载到 body（wrapper 固定顶部居中，config 的 top/left/bottom/right 整体偏移）；type=info/success/warning/error/default（default 无内置图标）；theme=normal（白）/light（多色填充+描边）；stack 多条堆叠、Hover 展开（3D 透视折叠）；duration 自动关闭（0 常驻）、mouseenter 暂停/mouseleave 从头计时；showClose 关闭按钮（复用 IconButton）；textMaxWidth 内容最大宽度；content/icon 支持 string 或 Snippet；对已存在 id 再调 info/success 即原地更新。useToast() 返回 [api, holderStore] 经 <ToastHolder> 渲染在组件树内继承上下文；ToastFactory.create(config) 创建带独立 config 的新实例（如 getPopupContainer）。a11y：卡片 role=alert + aria-label="{type} type"（对齐 Semi），关闭按钮 IconButton 带可访问名。',
+    exports: ['Toast', 'ToastFactory', 'useToast', 'ToastHolder'],
     imperative: true,
     props: [
-        { name: 'content', type: 'string', default: '—', desc: '提示文本（必填）' },
-        { name: 'id', type: 'string', default: 'undefined', desc: '指定 id；已存在则原地更新并重启定时器' },
+        { name: 'content', type: 'string | Snippet', default: "''", desc: '提示内容（必填），支持文本或自定义 Snippet' },
+        { name: 'id', type: 'string', default: 'undefined', desc: '自定义 ToastId；已存在则原地合并更新并重启定时器' },
         {
             name: 'type',
-            type: "'info'|'success'|'warning'|'error'|'loading'",
-            default: "'info'",
-            desc: '语义类型，决定图标与色',
+            type: "'info'|'success'|'warning'|'error'|'default'",
+            default: "'default'",
+            desc: '语义类型，决定图标与色；default 无内置图标',
         },
         {
             name: 'duration',
             type: 'number',
             default: '3',
-            desc: '自动消失秒数；0 持久。loading 默认 0',
+            desc: '自动关闭秒数；0 = 不自动关闭（须手动关闭）',
         },
-        {
-            name: 'position',
-            type: "'topLeft'|'top'|'topRight'|'bottomLeft'|'bottom'|'bottomRight'",
-            default: "'top'",
-            desc: '出现方位，每方位独立纵向堆叠',
-        },
-        { name: 'closable', type: 'boolean', default: 'true', desc: '是否显示关闭按钮' },
-        { name: 'pauseOnHover', type: 'boolean', default: 'true', desc: '悬停/聚焦时暂停定时器' },
+        { name: 'showClose', type: 'boolean', default: 'true', desc: '是否展示关闭按钮' },
+        { name: 'textMaxWidth', type: 'number | string', default: '450', desc: '内容的最大宽度' },
         {
             name: 'theme',
-            type: "'light'|'dark'",
-            default: "'light'",
-            desc: '卡片主题；dark 为深色卡片',
-        },
-        {
-            name: 'onClose',
-            type: "(id: string, reason: 'timeout'|'manual'|'replace'|'destroyAll') => void",
-            default: 'undefined',
-            desc: '关闭回调，附关闭原因',
+            type: "'normal'|'light'",
+            default: "'normal'",
+            desc: "填充样式；'light' 浅色填充 + 类型描边",
         },
-        { name: 'icon', type: 'Snippet | false', default: 'undefined', desc: '自定义图标 snippet；false 隐藏图标' },
-        { name: 'showClose', type: 'boolean', default: 'true', desc: '是否显示关闭按钮（closable 别名）' },
-        { name: 'textMaxWidth', type: 'number | string', default: '450', desc: '内容区最大宽度（px 数字或 CSS 字符串）' },
-        { name: 'stack', type: 'boolean', default: 'false', desc: '堆叠显示：容器附加 cd-toast-wrapper--stacked class' },
+        { name: 'stack', type: 'boolean', default: 'false', desc: '是否堆叠 Toast（多条叠一摞、Hover 展开）' },
+        { name: 'icon', type: 'Snippet', default: 'undefined', desc: '自定义图标（覆盖类型内置图标）' },
+        { name: 'direction', type: "'ltr'|'rtl'", default: "'ltr'", desc: '书写方向' },
+        { name: 'onClose', type: '() => void', default: 'undefined', desc: 'toast 关闭时的回调（无参数，对齐 Semi）' },
     ],
-    events: [{ name: 'onClose', desc: '单条关闭（超时/手动/被替换/清空）时触发，带 id 与 reason' }],
+    config: [
+        { name: 'top', type: 'number | string', default: '-', desc: '弹出位置 top（wrapper 整体偏移）' },
+        { name: 'bottom', type: 'number | string', default: '-', desc: '弹出位置 bottom' },
+        { name: 'left', type: 'number | string', default: '-', desc: '弹出位置 left' },
+        { name: 'right', type: 'number | string', default: '-', desc: '弹出位置 right' },
+        { name: 'zIndex', type: 'number', default: '1010', desc: 'wrapper z-index' },
+        { name: 'theme', type: "'normal'|'light'", default: "'normal'", desc: '默认填充样式' },
+        { name: 'duration', type: 'number', default: '3', desc: '默认自动关闭延时（秒），0 不自动关闭' },
+        { name: 'getPopupContainer', type: '() => HTMLElement | null', default: '() => document.body', desc: '指定容器挂载父级 DOM' },
+    ],
+    events: [{ name: 'onClose', desc: 'toast 关闭时触发（无参数，对齐 Semi）' }],
     slots: [],
     a11y: {
         hasRole: true,
         focusable: false,
-        note: '所有文案播报走 body 上单例 ARIA live region（全局唯一一对：role=status/aria-live=polite + role=alert/aria-live=assertive）；error 走 assertive 立即打断，其余走 polite。store 在新增/更新 toast 时命令式写入 region 文案，卡片本身纯视觉、不带 role/aria-live，避免多 region 重复/竞争播报。关闭按钮 button + aria-label「关闭」。不抢焦点、不锁滚动。',
+        note: '每张 toast 卡片自身 role=alert + aria-label="{type} type"（对齐 Semi），屏幕阅读器直接播报卡片内容。关闭按钮 IconButton 带 aria-label（locale Toast.close）。不抢焦点、不锁滚动。',
     },
     tokens: [
-        '--cd-toast-bg',
-        '--cd-toast-color-text',
-        '--cd-toast-color-icon-info',
-        '--cd-toast-color-icon-success',
-        '--cd-toast-color-icon-warning',
-        '--cd-toast-color-icon-error',
-        '--cd-toast-color-close',
-        '--cd-toast-color-close-hover',
-        '--cd-toast-radius',
-        '--cd-toast-shadow',
-        '--cd-toast-padding',
-        '--cd-toast-gap',
-        '--cd-toast-font-size',
-        '--cd-toast-font-weight',
-        '--cd-toast-max-width',
-        '--cd-toast-min-width',
-        '--cd-toast-stack-gap',
-        '--cd-toast-z',
-        '--cd-toast-motion-duration',
-        '--cd-toast-bg-dark',
-        '--cd-toast-color-text-dark',
-        '--cd-toast-color-close-dark',
-        '--cd-toast-color-close-hover-dark',
+        '--cd-color-toast-bg-default',
+        '--cd-color-toast-text-default',
+        '--cd-color-toast-warning-icon',
+        '--cd-color-toast-success-icon',
+        '--cd-color-toast-info-icon',
+        '--cd-color-toast-danger-icon',
+        '--cd-color-toast-warning-light-bg',
+        '--cd-color-toast-warning-light-icon',
+        '--cd-color-toast-warning-light-border',
+        '--cd-color-toast-success-light-bg',
+        '--cd-color-toast-success-light-icon',
+        '--cd-color-toast-success-light-border',
+        '--cd-color-toast-info-light-bg',
+        '--cd-color-toast-info-light-icon',
+        '--cd-color-toast-info-light-border',
+        '--cd-color-toast-danger-light-bg',
+        '--cd-color-toast-danger-light-icon',
+        '--cd-color-toast-danger-light-border',
+        '--cd-spacing-toast-wrapper-top',
+        '--cd-spacing-toast-content-paddingy',
+        '--cd-spacing-toast-content-paddingx',
+        '--cd-spacing-toast-content-paddingtop',
+        '--cd-spacing-toast-content-paddingbottom',
+        '--cd-spacing-toast-content-paddingleft',
+        '--cd-spacing-toast-content-paddingright',
+        '--cd-spacing-toast-content-margin',
+        '--cd-spacing-toast-content-close-btn-margintop',
+        '--cd-spacing-toast-content-text-marginleft',
+        '--cd-spacing-toast-content-text-marginright',
+        '--cd-spacing-toast-perspective-originy',
+        '--cd-spacing-toast-perspective',
+        '--cd-width-toast-wrapper',
+        '--cd-width-toast-light-border',
+        '--cd-radius-toast-content',
+        '--cd-font-toast-content-fontweight',
     ],
     responsive: false,
     examples: [
         { title: '成功', code: "Toast.success('已保存')" },
         { title: '错误', code: "Toast.error('保存失败')" },
-        { title: '加载（持久）', code: "Toast.loading('上传中', { duration: 0 })" },
-        { title: '右下角', code: "Toast.info('已同步', { position: 'bottomRight' })" },
-        { title: '深色主题', code: "Toast.success('已保存', { theme: 'dark' })" },
-        {
-            title: 'promise',
-            code: "Toast.promise(save(), { loading: '保存中…', success: '已保存', error: (e) => `失败：${e.message}` })",
-        },
+        { title: '堆叠', code: "Toast.info({ content: '已同步', stack: true })" },
+        { title: '多色', code: "Toast.warning({ content: '存储空间不足', theme: 'light' })" },
+        { title: '常驻', code: "Toast.info({ content: '手动关闭', duration: 0 })" },
+        { title: '更新', code: "const id = 'x'; Toast.info({ content: '处理中', id }); Toast.success({ content: '完成', id })" },
     ],
 };

package/dist/toast/store.d.ts

@@ -1,67 +1,95 @@
 /**
- * Toast — 命令式全局轻提示入口。
- * 模块级单例 store + 惰性挂载的单例 ToastContainer（首次调用时 mount 到 body）。
- * 复用 @chenzy-design/core 的 createToastStore（无框架依赖的队列 + 定时器）。
- * See specs/components/feedback/Toast.spec.md
+ * Toast — 命令式全局轻提示入口，严格对齐 Semi Design
+ * （semi-ui/toast/index.tsx 的静态方法 + config + useToast + ToastFactory）。
+ * 每个 Toast 实例 = 模块级单例 store + 惰性挂载的单例 ToastContainer（首次调用时
+ * mount 到 getPopupContainer() 或 body）。复用 @chenzy-design/core 的 createToastStore
+ * （无框架依赖的队列 + 定时器，语义对齐 Semi foundation）。
+ *
+ * 对齐 Semi 静态 API：info/success/warning/error/open/close/destroyAll/config/useToast。
+ * ToastFactory.create(config) 创建带独立 config 的新 Toast（对齐 Semi ToastFactory.create）。
+ * See semi-ui/toast/index.tsx
+ */
+import { type ToastStore, type ToastOptions, type ToastTheme } from '@chenzy-design/core';
+/**
+ * 全局配置（对齐 Semi ConfigProps）。容器经 mount() 挂在 Svelte 组件树之外，拿不到
+ * ConfigProvider context，故位置偏移 / 挂载容器 / 默认值只能经此命令式入口配置：
+ *  - top/bottom/left/right：wrapper 与视口边缘的偏移（CSS 值或数字像素）。
+ *  - zIndex：wrapper z-index（对齐 Semi，默认 1010）。
+ *  - theme：默认卡片主题（normal/light）。
+ *  - duration：默认自动关闭秒数（0 = 常驻），可被单条 options.duration 覆盖。
+ *  - getPopupContainer：容器宿主挂载目标（默认 body，对齐 Semi getPopupContainer）。
  */
-import { type ToastOptions } from '@chenzy-design/core';
-/** Toast.config() 全局配置。 */
 export interface ToastConfig {
-    /** 卡片主题（全局默认值）。 */
-    theme?: 'light' | 'dark';
-    /** 容器层级。 */
-    zIndex?: number;
-    /** 容器距顶部偏移（px 数字或 CSS 字符串）。 */
     top?: number | string;
-    /** 容器距底部偏移（px 数字或 CSS 字符串）。 */
     bottom?: number | string;
-    /** 容器距左侧偏移（px 数字或 CSS 字符串）。 */
     left?: number | string;
-    /** 容器距右侧偏移（px 数字或 CSS 字符串）。 */
     right?: number | string;
+    zIndex?: number;
+    theme?: ToastTheme;
+    duration?: number;
+    getPopupContainer?: () => HTMLElement | null | undefined;
 }
-/** 读取当前全局配置（供 ToastContainer 消费）。 */
-export declare function getToastConfig(): ToastConfig;
 /**
- * Toast.promise 文案：可为静态字符串，或接收 resolve 值 / reject 原因的函数（对齐 sonner / AntD）。
+ * Svelte 命令式选项（对齐 Semi ToastReactProps）。content/icon 可为 string 文本或
+ * Svelte Snippet（对齐 Semi ReactNode）。允许传 string 简写（对齐 Semi info(opts|string)）。
+ * 额外的 getPopupContainer（per-toast）：首条 toast 的该值决定容器挂载点（对齐 Semi）。
  */
-type PromiseMessage<T> = string | ((value: T) => string);
-export interface ToastPromiseMessages<T> {
-    /** pending 阶段文案；省略走 locale 默认 promiseLoading */
-    loading?: string;
-    /** resolve 文案；省略走 locale 默认 promiseSuccess */
-    success?: PromiseMessage<T>;
-    /** reject 文案；省略走 locale 默认 promiseError */
-    error?: PromiseMessage<unknown>;
-}
-/** 透传给底层 toast 的额外选项（position/theme/duration 等），content/type 由 promise 阶段接管。 */
-type PromiseToastOptions = Partial<Omit<ToastOptions, 'content' | 'type' | 'id'>>;
-export declare const Toast: {
-    info: (content: string, opts?: Partial<Omit<ToastOptions, "content">>) => string;
-    success: (content: string, opts?: Partial<Omit<ToastOptions, "content">>) => string;
-    warning: (content: string, opts?: Partial<Omit<ToastOptions, "content">>) => string;
-    error: (content: string, opts?: Partial<Omit<ToastOptions, "content">>) => string;
-    loading: (content: string, opts?: Partial<Omit<ToastOptions, "content">>) => string;
-    /** 完整选项打开一条 toast，返回其 id。 */
-    open: (opts: ToastOptions) => string;
-    /**
-     * promise API：传入 Promise，pending 显示 loading toast，resolve→success、reject→error 切文案。
-     * 返回原 Promise 以便继续链式/await（对齐 sonner / AntD message.promise）。
-     *
-     * 红线 #3：单条 toast 经同 id update 命令式切换状态（loading→success/error），
-     * 计时由底层 store 接管（loading 持久 duration:0，success/error 用默认 3s 自动关闭）；
-     * .then/.catch 是 Promise 自身的生命周期回调，无需额外手动 cleanup（toast 自身定时器在 store 内 cleanup）。
-     * 默认文案经 @chenzy-design/locale（回退 en_US，无 Provider context）；调用方可经 messages 覆盖。
-     */
-    promise: <T>(promise: Promise<T>, messages?: ToastPromiseMessages<T>, opts?: PromiseToastOptions) => Promise<T>;
-    /** 手动关闭指定 toast。 */
+export type SvelteToastOptions = Omit<ToastOptions, 'type'> & {
+    getPopupContainer?: () => HTMLElement | null | undefined;
+};
+/** info/success/warning/error/open 的入参：完整 options 或 string 简写。 */
+type OptsOrString = SvelteToastOptions | string;
+/** 位置偏移 + zIndex，供 ToastContainer 读取注入 wrapper inline style。 */
+export type ToastPositionConfig = Pick<ToastConfig, 'top' | 'bottom' | 'left' | 'right' | 'zIndex'>;
+/** 一个 Toast 实例的公开 API（对齐 Semi 静态方法集）。 */
+export interface ToastInstanceApi {
+    info: (opts: OptsOrString) => string;
+    success: (opts: OptsOrString) => string;
+    warning: (opts: OptsOrString) => string;
+    error: (opts: OptsOrString) => string;
+    /** 展示一条 type=default 的 toast（对齐 Semi 无 open，但保留 default 入口）。 */
+    open: (opts: OptsOrString) => string;
     close: (id: string) => void;
-    /** 按同 id 更新一条 toast（store.add 对已存在 id 走原地更新 + 重启定时器）。 */
-    update: (id: string, opts: Partial<ToastOptions>) => string;
-    /** 清空全部 toast。 */
     destroyAll: () => void;
-    /** 设置全局配置（theme/zIndex/top/bottom/left/right 位置偏移）。 */
     config: (cfg: ToastConfig) => void;
+}
+/**
+ * 默认全局 Toast（对齐 Semi 默认导出）。含 useToast Hook（挂静态方法上，对齐 Semi Toast.useToast）。
+ */
+export declare const Toast: ToastInstanceApi & {
+    useToast: typeof useToast;
+};
+/**
+ * ToastFactory.create(config) — 创建带独立 config 的新 Toast（对齐 Semi ToastFactory.create）。
+ * 常用于覆盖全局配置（如 getPopupContainer 指定自定义容器）。返回的实例含 useToast。
+ */
+export declare const ToastFactory: {
+    create(config?: ToastConfig): ToastInstanceApi & {
+        useToast: typeof useToast;
+    };
 };
+export declare function getToastConfig(): ToastPositionConfig;
+/** useToast Hook 返回的 api（对齐 Semi：info/success/warning/error/open/close）。 */
+export interface ToastHookApi {
+    info: (opts: OptsOrString) => string;
+    success: (opts: OptsOrString) => string;
+    warning: (opts: OptsOrString) => string;
+    error: (opts: OptsOrString) => string;
+    open: (opts: OptsOrString) => string;
+    close: (id: string) => void;
+}
+/**
+ * useToast — Svelte 版 Hook（对齐 Semi Toast.useToast）。
+ * 返回 [api, holderStore]：
+ *  - api：info/success/warning/error/open/close（局部，不含全局的 config/destroyAll）；
+ *  - holderStore：传给 <ToastHolder store={holderStore} /> 渲染在组件树内，
+ *    使经此 api 创建的 toast 渲染在 holder 所在位置，继承该处上下文（如 LocaleProvider）。
+ * 与全局单例不同：本 Hook 的 store 与容器是局部的，不挂 body。
+ * 用法：
+ *   const [toast, contextHolder] = useToast();
+ *   // 模板中：<ToastHolder store={contextHolder} />
+ *   // 事件中：toast.success({ content })
+ */
+export declare function useToast(): [ToastHookApi, ToastStore];
 export {};
 //# sourceMappingURL=store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/toast/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,YAAY,EAElB,MAAM,qBAAqB,CAAC;AAO7B,2BAA2B;AAC3B,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,YAAY;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAID,qCAAqC;AACrC,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AA6CD;;GAEG;AACH,KAAK,cAAc,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC5B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACjC;AAED,gFAAgF;AAChF,KAAK,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AAOlF,eAAO,MAAM,KAAK;oBACA,MAAM,SAAS,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;uBAElD,MAAM,SAAS,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;uBAErD,MAAM,SAAS,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;qBAEvD,MAAM,SAAS,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;uBAEnD,MAAM,SAAS,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAExE,6BAA6B;iBAChB,YAAY,KAAG,MAAM;IAMlC;;;;;;;;OAQG;cACO,CAAC,WACA,OAAO,CAAC,CAAC,CAAC,aACT,oBAAoB,CAAC,CAAC,CAAC,SAC3B,mBAAmB,KACxB,OAAO,CAAC,CAAC,CAAC;IAgCb,oBAAoB;gBACR,MAAM,KAAG,IAAI;IACzB,yDAAyD;iBAC5C,MAAM,QAAQ,OAAO,CAAC,YAAY,CAAC,KAAG,MAAM;IAQzD,kBAAkB;sBACF,IAAI;IACpB,uDAAuD;kBACzC,WAAW,KAAG,IAAI;CAGjC,CAAC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/toast/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,YAAY,EAEjB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,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,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1D;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG;IAC5D,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF,kEAAkE;AAClE,KAAK,YAAY,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAMhD,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,WAAW,EACX,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAC/C,CAAC;AAEF,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACtC,gEAAgE;IAChE,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;CACpC;AAuGD;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,gBAAgB,GAAG;IACrC,QAAQ,EAAE,OAAO,QAAQ,CAAC;CAW3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY;oBACP,WAAW,GAAG,gBAAgB,GAAG;QAAE,QAAQ,EAAE,OAAO,QAAQ,CAAA;KAAE;CAc/E,CAAC;AAGF,wBAAgB,cAAc,IAAI,mBAAmB,CAEpD;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAoBrD"}