@chenzy-design/svelte 0.1.0

package/dist/toast/ToastContainer.svelte

@@ -0,0 +1,184 @@
+<!--
+  ToastContainer — 单例容器，订阅 store 渲染全部 toast。
+  由 store.ts 惰性 mount 到 body 下的宿主节点；仅此一个实例。
+  按 6 方位（topLeft/top/topRight/bottomLeft/bottom/bottomRight）分组渲染独立堆叠列，
+  对齐 Notification 的方位实现。向后兼容：旧的纯 top/bottom 用法仍居中堆叠不变。
+  进出场用 svelte/transition fly（运行时驱动，退场后 DOM 正常卸载，不卡 from 帧）；
+  重排用 animate:flip。reduced-motion 时 fly duration 降为 0。
+  红线 #2：方位分组（grouped）/进出场偏移（flyParams）为派生纯函数。
+  红线：render 不读 effect 写的状态——toasts 初始同步读一次（拿到惰性挂载前已入队的首条），
+  $effect 仅做订阅 + cleanup 退订。
+-->
+<script lang="ts">
+  import { fly } from 'svelte/transition';
+  import { flip } from 'svelte/animate';
+  import { prefersReducedMotion } from 'svelte/motion';
+  import type { ToastStore, ToastItem, ToastPosition } from '@chenzy-design/core';
+  import ToastItemView from './ToastItem.svelte';
+  import { getToastConfig } from './store.js';
+
+  interface Props {
+    store: ToastStore;
+  }
+
+  let { store }: Props = $props();
+
+  // 初始同步读一次：捕获惰性挂载前已入队的首条 toast。
+  // 用函数包裹读取，避免 state 初始化器直接引用 prop 触发 state_referenced_locally。
+  // core 的 subscribe 不会立即回放当前值，因此必须在此先读一次。
+  function readInitial(): ToastItem[] {
+    return store.getToasts();
+  }
+  let toasts = $state<ToastItem[]>(readInitial());
+
+  // 桥接外部（非 Svelte runes）store：订阅写入本地 state，cleanup 退订。
+  // 这是 store->state 的单向桥，无法用 $derived 表达（外部 store 非响应式源）。
+  $effect(() => {
+    const unsub = store.subscribe((v) => {
+      toasts = v;
+    });
+    return unsub;
+  });
+
+  const positions: ToastPosition[] = [
+    'topLeft',
+    'top',
+    'topRight',
+    'bottomLeft',
+    'bottom',
+    'bottomRight',
+  ];
+
+  const flyDuration = $derived(prefersReducedMotion.current ? 0 : 220);
+  const flipDuration = $derived(prefersReducedMotion.current ? 0 : 200);
+
+  // 红线 #2：方位分组纯派生——按 6 方位过滤当前 toasts。
+  const grouped = $derived(
+    positions.map((p) => ({
+      position: p,
+      items: toasts.filter((t) => t.position === p),
+    })),
+  );
+
+  // 每方位进出场偏移：左侧从左滑入、右侧从右滑入、居中走垂直（对齐 Notification）。
+  function flyParams(position: ToastPosition): { x: number; y: number } {
+    if (position === 'topLeft' || position === 'bottomLeft') return { x: -24, y: 0 };
+    if (position === 'topRight' || position === 'bottomRight') return { x: 24, y: 0 };
+    return { x: 0, y: position === 'top' ? -16 : 16 };
+  }
+
+  function handleClose(id: string) {
+    store.remove(id, 'manual');
+  }
+  function handlePause(id: string) {
+    store.pause(id);
+  }
+  function handleResume(id: string) {
+    store.resume(id);
+  }
+
+  // 全局配置衍生样式变量（应用到容器的 CSS 自定义属性）。
+  function toPx(v: number | string | undefined): string | undefined {
+    if (v === undefined) return undefined;
+    return typeof v === 'number' ? `${v}px` : v;
+  }
+
+  const cfg = $derived(getToastConfig());
+  const configStyle = $derived(() => {
+    const parts: string[] = [];
+    if (cfg.zIndex !== undefined) parts.push(`--cd-toast-z: ${cfg.zIndex}`);
+    if (cfg.top !== undefined) parts.push(`--cd-toast-config-top: ${toPx(cfg.top)}`);
+    if (cfg.bottom !== undefined) parts.push(`--cd-toast-config-bottom: ${toPx(cfg.bottom)}`);
+    if (cfg.left !== undefined) parts.push(`--cd-toast-config-left: ${toPx(cfg.left)}`);
+    if (cfg.right !== undefined) parts.push(`--cd-toast-config-right: ${toPx(cfg.right)}`);
+    return parts.length > 0 ? parts.join('; ') : undefined;
+  });
+
+  // 任一 toast 带 stack 标志时，整组容器附加 stacked class。
+  const hasStack = $derived(toasts.some((t) => t.stack));
+</script>
+
+{#each grouped as group (group.position)}
+  {#if group.items.length > 0}
+    <div
+      class={['cd-toast-stack', `cd-toast-stack--${group.position}`, hasStack && 'cd-toast-wrapper--stacked']}
+      style={configStyle()}
+    >
+      {#each group.items as t (t.id)}
+        <div
+          class="cd-toast-stack__item"
+          in:fly={{ ...flyParams(group.position), duration: flyDuration }}
+          out:fly={{ ...flyParams(group.position), duration: flyDuration }}
+          animate:flip={{ duration: flipDuration }}
+        >
+          <ToastItemView
+            toast={t}
+            onClose={handleClose}
+            onPause={handlePause}
+            onResume={handleResume}
+          />
+        </div>
+      {/each}
+    </div>
+  {/if}
+{/each}
+
+<style>
+  .cd-toast-stack {
+    position: fixed;
+    z-index: var(--cd-toast-z);
+    display: flex;
+    flex-direction: column;
+    gap: var(--cd-toast-stack-gap);
+    inline-size: max-content;
+    max-inline-size: calc(100vw - 32px);
+    pointer-events: none;
+  }
+
+  .cd-toast-stack--topLeft {
+    top: 24px;
+    left: 24px;
+    align-items: flex-start;
+  }
+
+  .cd-toast-stack--top {
+    top: 24px;
+    left: 50%;
+    transform: translateX(-50%);
+    align-items: center;
+  }
+
+  .cd-toast-stack--topRight {
+    top: 24px;
+    right: 24px;
+    align-items: flex-end;
+  }
+
+  .cd-toast-stack--bottomLeft {
+    bottom: 24px;
+    left: 24px;
+    align-items: flex-start;
+    flex-direction: column-reverse;
+  }
+
+  .cd-toast-stack--bottom {
+    bottom: 24px;
+    left: 50%;
+    transform: translateX(-50%);
+    align-items: center;
+    flex-direction: column-reverse;
+  }
+
+  .cd-toast-stack--bottomRight {
+    bottom: 24px;
+    right: 24px;
+    align-items: flex-end;
+    flex-direction: column-reverse;
+  }
+
+  .cd-toast-stack__item {
+    inline-size: auto;
+    max-inline-size: 100%;
+    pointer-events: none;
+  }
+</style>

package/dist/toast/ToastContainer.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { ToastStore } from '@chenzy-design/core';
+interface Props {
+    store: ToastStore;
+}
+declare const ToastContainer: import("svelte").Component<Props, {}, "">;
+type ToastContainer = ReturnType<typeof ToastContainer>;
+export default ToastContainer;
+//# sourceMappingURL=ToastContainer.svelte.d.ts.map

package/dist/toast/ToastContainer.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToastContainer.svelte.d.ts","sourceRoot":"","sources":["../../src/toast/ToastContainer.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,qBAAqB,CAAC;AAK9E,UAAU,KAAK;IACb,KAAK,EAAE,UAAU,CAAC;CACnB;AAwGH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/toast/ToastItem.svelte

@@ -0,0 +1,247 @@
+<!--
+  ToastItem — 单条轻提示卡片（纯视觉）。
+  类型图标 + 内容 + 可选关闭按钮；pauseOnHover 经 mouseenter/leave + focusin/out 暂停/恢复定时器。
+  a11y：卡片 role=presentation + aria-live=off（不充当 live region）；所有文案播报统一走单例
+  live region（见 live-region.ts），由 store.ts 在新增/更新 toast 时命令式写入，避免每条卡片
+  各自 region 造成的重复/竞争播报。error -> assertive，其余 -> polite。
+  关闭按钮 button + aria-label「关闭」，不抢焦点、不锁滚动。
+  loading 用 CSS infinite rotate spinner（旋转 animation 非显隐 from 帧问题，安全）。
+-->
+<script lang="ts">
+  import type { ToastItem, ToastType } from '@chenzy-design/core';
+  import { useLocale } from '../locale-provider/index.js';
+
+  interface Props {
+    toast: ToastItem;
+    onClose: (id: string) => void;
+    onPause: (id: string) => void;
+    onResume: (id: string) => void;
+  }
+
+  let { toast, onClose, onPause, onResume }: Props = $props();
+  const loc = useLocale();
+
+  function handlePause() {
+    if (toast.pauseOnHover) onPause(toast.id);
+  }
+  function handleResume() {
+    if (toast.pauseOnHover) onResume(toast.id);
+  }
+</script>
+
+{#snippet typeIcon(type: ToastType)}
+  {#if type === 'success'}
+    <svg class="cd-toast-item__icon-svg" viewBox="0 0 16 16" aria-hidden="true" focusable="false">
+      <circle cx="8" cy="8" r="7" fill="none" stroke="currentColor" stroke-width="1.4" />
+      <path
+        fill="none"
+        stroke="currentColor"
+        stroke-width="1.6"
+        stroke-linecap="round"
+        stroke-linejoin="round"
+        d="M5 8.2l2 2 4-4.4"
+      />
+    </svg>
+  {:else if type === 'warning'}
+    <svg class="cd-toast-item__icon-svg" viewBox="0 0 16 16" aria-hidden="true" focusable="false">
+      <path
+        fill="none"
+        stroke="currentColor"
+        stroke-width="1.4"
+        stroke-linejoin="round"
+        d="M8 1.5l6.5 12h-13z"
+      />
+      <path stroke="currentColor" stroke-width="1.4" stroke-linecap="round" d="M8 6.5v3.2" />
+      <circle cx="8" cy="11.6" r="0.85" fill="currentColor" />
+    </svg>
+  {:else if type === 'error'}
+    <svg class="cd-toast-item__icon-svg" viewBox="0 0 16 16" aria-hidden="true" focusable="false">
+      <circle cx="8" cy="8" r="7" fill="none" stroke="currentColor" stroke-width="1.4" />
+      <path
+        stroke="currentColor"
+        stroke-width="1.6"
+        stroke-linecap="round"
+        d="M5.5 5.5l5 5M10.5 5.5l-5 5"
+      />
+    </svg>
+  {:else if type === 'loading'}
+    <svg
+      class="cd-toast-item__icon-svg cd-toast-item__spinner"
+      viewBox="0 0 16 16"
+      aria-hidden="true"
+      focusable="false"
+    >
+      <circle cx="8" cy="8" r="6.4" fill="none" stroke="currentColor" stroke-width="1.6" opacity="0.25" />
+      <path
+        fill="none"
+        stroke="currentColor"
+        stroke-width="1.6"
+        stroke-linecap="round"
+        d="M8 1.6a6.4 6.4 0 0 1 6.4 6.4"
+      />
+    </svg>
+  {:else}
+    <svg class="cd-toast-item__icon-svg" viewBox="0 0 16 16" aria-hidden="true" focusable="false">
+      <circle cx="8" cy="8" r="7" fill="none" stroke="currentColor" stroke-width="1.4" />
+      <path stroke="currentColor" stroke-width="1.4" stroke-linecap="round" d="M8 7.2v4" />
+      <circle cx="8" cy="4.7" r="0.85" fill="currentColor" />
+    </svg>
+  {/if}
+{/snippet}
+
+<div
+  class={['cd-toast-item', `cd-toast-item--${toast.type}`, `cd-toast-item--${toast.theme}`, toast.theme === 'light' && 'cd-toast-item--light']}
+  style={toast.textMaxWidth !== 450 ? `max-inline-size: ${typeof toast.textMaxWidth === 'number' ? `${toast.textMaxWidth}px` : toast.textMaxWidth}` : undefined}
+  role="presentation"
+  aria-live="off"
+  onmouseenter={handlePause}
+  onmouseleave={handleResume}
+  onfocusin={handlePause}
+  onfocusout={handleResume}
+>
+  {#if toast.icon !== false}
+    <span class="cd-toast-item__icon">
+      {#if toast.icon && toast.icon !== true}
+        {@render toast.icon()}
+      {:else}
+        {@render typeIcon(toast.type)}
+      {/if}
+    </span>
+  {/if}
+  <span class="cd-toast-item__content">{toast.content}</span>
+  {#if toast.showClose}
+    <button
+      type="button"
+      class="cd-toast-item__close"
+      aria-label={loc().t('Toast.close')}
+      onclick={() => onClose(toast.id)}
+    >
+      <svg viewBox="0 0 16 16" aria-hidden="true" focusable="false">
+        <path
+          stroke="currentColor"
+          stroke-width="1.4"
+          stroke-linecap="round"
+          d="M4 4l8 8M12 4l-8 8"
+        />
+      </svg>
+    </button>
+  {/if}
+</div>
+
+<style>
+  .cd-toast-item {
+    display: flex;
+    gap: var(--cd-toast-gap);
+    align-items: center;
+    box-sizing: border-box;
+    padding: var(--cd-toast-padding);
+    max-inline-size: var(--cd-toast-max-width);
+    min-inline-size: var(--cd-toast-min-width);
+    background: var(--cd-toast-bg);
+    color: var(--cd-toast-color-text);
+    font-size: var(--cd-toast-font-size);
+    line-height: 1.5;
+    border-radius: var(--cd-toast-radius);
+    box-shadow: var(--cd-toast-shadow);
+    pointer-events: auto;
+  }
+
+  .cd-toast-item__icon {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: 1.125em;
+    block-size: 1.125em;
+  }
+
+  .cd-toast-item__icon-svg {
+    inline-size: 100%;
+    block-size: 100%;
+  }
+
+  .cd-toast-item--info .cd-toast-item__icon {
+    color: var(--cd-toast-color-icon-info);
+  }
+  .cd-toast-item--success .cd-toast-item__icon {
+    color: var(--cd-toast-color-icon-success);
+  }
+  .cd-toast-item--warning .cd-toast-item__icon {
+    color: var(--cd-toast-color-icon-warning);
+  }
+  .cd-toast-item--error .cd-toast-item__icon {
+    color: var(--cd-toast-color-icon-error);
+  }
+  .cd-toast-item--loading .cd-toast-item__icon {
+    color: var(--cd-toast-color-icon-info);
+  }
+
+  /* dark 主题：深色卡片，文案/关闭色覆盖为 token（对齐 Notification dark theme） */
+  .cd-toast-item--dark {
+    background: var(--cd-toast-bg-dark);
+    color: var(--cd-toast-color-text-dark);
+  }
+  .cd-toast-item--dark .cd-toast-item__close {
+    color: var(--cd-toast-color-close-dark);
+  }
+  .cd-toast-item--dark .cd-toast-item__close:hover {
+    color: var(--cd-toast-color-close-hover-dark);
+  }
+
+  .cd-toast-item__content {
+    flex: 1 1 auto;
+    min-inline-size: 0;
+    overflow-wrap: anywhere;
+  }
+
+  .cd-toast-item__close {
+    display: inline-flex;
+    flex: none;
+    align-items: center;
+    justify-content: center;
+    inline-size: 1.25em;
+    block-size: 1.25em;
+    padding: 0;
+    margin: 0;
+    border: none;
+    background: transparent;
+    color: var(--cd-toast-color-close);
+    cursor: pointer;
+    border-radius: var(--cd-radius-1);
+    transition: color var(--cd-toast-motion-duration) ease;
+  }
+
+  .cd-toast-item__close:hover {
+    color: var(--cd-toast-color-close-hover);
+  }
+
+  .cd-toast-item__close:focus-visible {
+    outline: 2px solid var(--cd-color-primary);
+    outline-offset: 1px;
+  }
+
+  .cd-toast-item__close svg {
+    inline-size: 100%;
+    block-size: 100%;
+  }
+
+  .cd-toast-item__spinner {
+    transform-origin: center;
+    animation: cd-toast-spin 0.8s linear infinite;
+  }
+
+  @keyframes cd-toast-spin {
+    to {
+      transform: rotate(360deg);
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .cd-toast-item__spinner {
+      animation-duration: 1.6s;
+    }
+    .cd-toast-item__close {
+      transition: none;
+    }
+  }
+</style>

package/dist/toast/ToastItem.svelte.d.ts

@@ -0,0 +1,11 @@
+import type { ToastItem } from '@chenzy-design/core';
+interface Props {
+    toast: ToastItem;
+    onClose: (id: string) => void;
+    onPause: (id: string) => void;
+    onResume: (id: string) => void;
+}
+declare const ToastItem: import("svelte").Component<Props, {}, "">;
+type ToastItem = ReturnType<typeof ToastItem>;
+export default ToastItem;
+//# sourceMappingURL=ToastItem.svelte.d.ts.map

package/dist/toast/ToastItem.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToastItem.svelte.d.ts","sourceRoot":"","sources":["../../src/toast/ToastItem.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,qBAAqB,CAAC;AAI9D,UAAU,KAAK;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAyEH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/toast/index.d.ts

@@ -0,0 +1,4 @@
+export { Toast, type ToastPromiseMessages, type ToastConfig } from './store.js';
+export { meta as toastMeta } from './meta.js';
+export type { ToastType, ToastOptions, ToastItem, ToastPosition, ToastTheme, } from '@chenzy-design/core';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/toast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,UAAU,GACX,MAAM,qBAAqB,CAAC"}

package/dist/toast/index.js

@@ -0,0 +1,2 @@
+export { Toast } from './store.js';
+export { meta as toastMeta } from './meta.js';

package/dist/toast/live-region.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 单例 ARIA live region — 承载所有 toast 文案的屏幕阅读器播报。
+ *
+ * 视觉上的多个 toast 卡片各自独立，但 a11y 播报统一走这里的两个全局唯一
+ * region（polite + assertive），避免每条卡片各自 role/aria-live 导致的重复/竞争。
+ *
+ * 红线 #3：region DOM 命令式创建/挂载到 body + 写入 + cleanup。模块级单例，
+ * 多次 toast 复用同一对节点；__resetLiveRegion 供测试清理。客户端 only（守 document）。
+ *
+ * 级别策略（参考 WAI-ARIA APG / Semi，对齐 spec §6）：error / warning -> assertive
+ * （立即打断），info / success / loading -> polite。region 视觉隐藏（sr-only），仅供辅助技术读取。
+ */
+import type { ToastType } from '@chenzy-design/core';
+/**
+ * 把一条 toast 文案写入对应级别的单例 region 供屏幕阅读器播报。
+ * 同文案连续两次也能被重播：先清空再写入（textContent 重新赋值触发 AT 播报）。
+ */
+export declare function announce(message: string, type: ToastType): void;
+/** 测试 only：移除单例 region 并复位模块状态。 */
+export declare function __resetLiveRegion(): void;
+//# sourceMappingURL=live-region.d.ts.map

package/dist/toast/live-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-region.d.ts","sourceRoot":"","sources":["../../src/toast/live-region.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AA2CrD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAS/D;AAED,mCAAmC;AACnC,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}

package/dist/toast/live-region.js

@@ -0,0 +1,57 @@
+let regions = null;
+function makeRegion(politeness) {
+    const el = document.createElement('div');
+    // role=status 隐含 polite；role=alert 隐含 assertive。同时显式标注更稳。
+    el.setAttribute('role', politeness === 'assertive' ? 'alert' : 'status');
+    el.setAttribute('aria-live', politeness);
+    el.setAttribute('aria-atomic', 'true');
+    el.className = 'cd-toast-live-region';
+    // 视觉隐藏但对辅助技术可见（不可用 display:none / visibility:hidden，会被 AT 忽略）。
+    const s = el.style;
+    s.position = 'absolute';
+    s.width = '1px';
+    s.height = '1px';
+    s.margin = '-1px';
+    s.padding = '0';
+    s.overflow = 'hidden';
+    s.clip = 'rect(0 0 0 0)';
+    s.clipPath = 'inset(50%)';
+    s.whiteSpace = 'nowrap';
+    s.border = '0';
+    return el;
+}
+function ensureRegions() {
+    if (typeof document === 'undefined')
+        return null;
+    if (!regions) {
+        const polite = makeRegion('polite');
+        const assertive = makeRegion('assertive');
+        document.body.appendChild(polite);
+        document.body.appendChild(assertive);
+        regions = { polite, assertive };
+    }
+    return regions;
+}
+/**
+ * 把一条 toast 文案写入对应级别的单例 region 供屏幕阅读器播报。
+ * 同文案连续两次也能被重播：先清空再写入（textContent 重新赋值触发 AT 播报）。
+ */
+export function announce(message, type) {
+    const r = ensureRegions();
+    if (!r || !message)
+        return;
+    // spec §6：error / warning 立即打断（assertive），其余排队播报（polite）。
+    const target = type === 'error' || type === 'warning' ? r.assertive : r.polite;
+    // 先清空，确保重复文案也会触发新一次播报。
+    target.textContent = '';
+    // 同步直接写入即可被 AT 捕获；保持纯命令式、无 effect。
+    target.textContent = message;
+}
+/** 测试 only：移除单例 region 并复位模块状态。 */
+export function __resetLiveRegion() {
+    if (regions) {
+        regions.polite.remove();
+        regions.assertive.remove();
+        regions = null;
+    }
+}

package/dist/toast/meta.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Toast — see specs/components/feedback/Toast.spec.md
+ */
+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 imperative: true;
+    readonly props: readonly [{
+        readonly name: "content";
+        readonly type: "string";
+        readonly default: "—";
+        readonly desc: "提示文本（必填）";
+    }, {
+        readonly name: "id";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "指定 id；已存在则原地更新并重启定时器";
+    }, {
+        readonly name: "type";
+        readonly type: "'info'|'success'|'warning'|'error'|'loading'";
+        readonly default: "'info'";
+        readonly desc: "语义类型，决定图标与色";
+    }, {
+        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 name: "closable";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示关闭按钮";
+    }, {
+        readonly name: "pauseOnHover";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "悬停/聚焦时暂停定时器";
+    }, {
+        readonly name: "theme";
+        readonly type: "'light'|'dark'";
+        readonly default: "'light'";
+        readonly desc: "卡片主题；dark 为深色卡片";
+    }, {
+        readonly name: "onClose";
+        readonly type: "(id: string, reason: 'timeout'|'manual'|'replace'|'destroyAll') => void";
+        readonly default: "undefined";
+        readonly desc: "关闭回调，附关闭原因";
+    }, {
+        readonly name: "icon";
+        readonly type: "Snippet | false";
+        readonly default: "undefined";
+        readonly desc: "自定义图标 snippet；false 隐藏图标";
+    }, {
+        readonly name: "showClose";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示关闭按钮（closable 别名）";
+    }, {
+        readonly name: "textMaxWidth";
+        readonly type: "number | string";
+        readonly default: "450";
+        readonly desc: "内容区最大宽度（px 数字或 CSS 字符串）";
+    }, {
+        readonly name: "stack";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "堆叠显示：容器附加 cd-toast-wrapper--stacked class";
+    }];
+    readonly events: readonly [{
+        readonly name: "onClose";
+        readonly desc: "单条关闭（超时/手动/被替换/清空）时触发，带 id 与 reason";
+    }];
+    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 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-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 responsive: false;
+    readonly examples: readonly [{
+        readonly title: "成功";
+        readonly code: "Toast.success('已保存')";
+    }, {
+        readonly title: "错误";
+        readonly code: "Toast.error('保存失败')";
+    }, {
+        readonly title: "加载（持久）";
+        readonly code: "Toast.loading('上传中', { duration: 0 })";
+    }, {
+        readonly title: "右下角";
+        readonly code: "Toast.info('已同步', { position: 'bottomRight' })";
+    }, {
+        readonly title: "深色主题";
+        readonly code: "Toast.success('已保存', { theme: 'dark' })";
+    }, {
+        readonly title: "promise";
+        readonly code: "Toast.promise(save(), { loading: '保存中…', success: '已保存', error: (e) => `失败：${e.message}` })";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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