@chenzy-design/core 0.1.0

package/dist/live-announcer.js

@@ -0,0 +1,89 @@
+/**
+ * useLiveAnnouncer — 全库通用的单例 ARIA live region 播报原语。
+ *
+ * 动态状态变化（排序/筛选/翻页/越界/选择…）需要让屏幕阅读器播报，但若每个
+ * 组件各自渲染 `aria-live` 容器，会出现重复/竞争且难以统一。本原语在 body 上
+ * 命令式挂载两个全局唯一的 region（polite + assertive），所有组件复用同一对节点。
+ *
+ * - 红线 #3：region DOM 命令式创建/挂载 + 命令式写入 + cleanup；模块级单例复用，
+ *   不依赖任何框架 effect。客户端 only（守 `document`，SSR 下静默 no-op）。
+ * - region 视觉隐藏（sr-only：absolute + 1px + clip），不可用 display:none /
+ *   visibility:hidden（会被辅助技术忽略）。
+ * - 级别策略（WAI-ARIA APG）：polite 排队播报（默认，状态结果类）；assertive
+ *   立即打断（错误/紧急）。
+ * - 同一文案连续两次也能被重播：先清空再写入，触发新一次 AT 播报。
+ *
+ * 文案由调用方在组件层经 `@chenzy-design/locale` 本地化后传入（本原语不含文案）。
+ *
+ * 参考 packages/svelte/src/toast/live-region.ts（Toast 自带的 region 范式），
+ * 但本原语放在 core，供全库组件复用。Toast/Notification 仍用各自既有 region。
+ *
+ * @example
+ * const announcer = useLiveAnnouncer();
+ * announcer.announce('已按名称升序排序');           // polite
+ * announcer.announce('表单提交失败', 'assertive');  // 立即打断
+ */
+// 模块级单例：整库共享同一对 region 节点。
+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-live-region';
+    // 视觉隐藏但对辅助技术可见（不可用 display:none / visibility:hidden）。
+    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;
+}
+function announce(message, politeness = 'polite') {
+    // 空消息直接 no-op：不挂载 region（懒挂载，仅真正播报时才创建）。
+    if (!message)
+        return;
+    const r = ensureRegions();
+    if (!r)
+        return;
+    const target = politeness === 'assertive' ? r.assertive : r.polite;
+    // 先清空，确保重复文案也会触发新一次播报。
+    target.textContent = '';
+    // 同步写入即可被 AT 捕获；保持纯命令式、无 effect。
+    target.textContent = message;
+}
+/**
+ * 获取全局单例播报器。多次调用返回等价 API（共享同一对 region 节点），
+ * 首次写入时才惰性挂载 region（SSR 下不挂载）。
+ */
+export function useLiveAnnouncer() {
+    return { announce };
+}
+/** 测试 only：移除单例 region 并复位模块状态。 */
+export function __resetLiveAnnouncer() {
+    if (regions) {
+        regions.polite.remove();
+        regions.assertive.remove();
+        regions = null;
+    }
+}
+//# sourceMappingURL=live-announcer.js.map

package/dist/live-announcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-announcer.js","sourceRoot":"","sources":["../src/live-announcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAcH,2BAA2B;AAC3B,IAAI,OAAO,GAAuB,IAAI,CAAC;AAEvC,SAAS,UAAU,CAAC,UAAsB;IACxC,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACzC,0DAA0D;IAC1D,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACzC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvC,EAAE,CAAC,SAAS,GAAG,gBAAgB,CAAC;IAChC,sDAAsD;IACtD,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC;IACnB,CAAC,CAAC,QAAQ,GAAG,UAAU,CAAC;IACxB,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;IAChB,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;IACjB,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC;IAChB,CAAC,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACtB,CAAC,CAAC,IAAI,GAAG,eAAe,CAAC;IACzB,CAAC,CAAC,QAAQ,GAAG,YAAY,CAAC;IAC1B,CAAC,CAAC,UAAU,GAAG,QAAQ,CAAC;IACxB,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IACf,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,aAAyB,QAAQ;IAClE,yCAAyC;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO;IACrB,MAAM,CAAC,GAAG,aAAa,EAAE,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,OAAO;IACf,MAAM,MAAM,GAAG,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnE,uBAAuB;IACvB,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,iCAAiC;IACjC,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC3B,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/live-announcer.test.d.ts

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

package/dist/live-announcer.test.d.ts.map

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

package/dist/live-announcer.test.js

@@ -0,0 +1,70 @@
+// @vitest-environment jsdom
+import { afterEach, describe, expect, it } from 'vitest';
+import { useLiveAnnouncer, __resetLiveAnnouncer } from './live-announcer.js';
+afterEach(() => {
+    __resetLiveAnnouncer();
+});
+function regions() {
+    return Array.from(document.querySelectorAll('.cd-live-region'));
+}
+describe('useLiveAnnouncer', () => {
+    it('lazily mounts a pair of polite + assertive regions on first announce', () => {
+        expect(regions()).toHaveLength(0);
+        const a = useLiveAnnouncer();
+        a.announce('hello');
+        const els = regions();
+        expect(els).toHaveLength(2);
+        const polite = els.find((e) => e.getAttribute('aria-live') === 'polite');
+        const assertive = els.find((e) => e.getAttribute('aria-live') === 'assertive');
+        expect(polite).toBeTruthy();
+        expect(assertive).toBeTruthy();
+        expect(polite.getAttribute('role')).toBe('status');
+        expect(assertive.getAttribute('role')).toBe('alert');
+        expect(polite.getAttribute('aria-atomic')).toBe('true');
+    });
+    it('reuses the same singleton region across multiple useLiveAnnouncer() calls', () => {
+        useLiveAnnouncer().announce('a');
+        useLiveAnnouncer().announce('b');
+        expect(regions()).toHaveLength(2);
+    });
+    it('defaults to polite and writes the message into the polite region', () => {
+        const a = useLiveAnnouncer();
+        a.announce('sorted by name');
+        const polite = regions().find((e) => e.getAttribute('aria-live') === 'polite');
+        const assertive = regions().find((e) => e.getAttribute('aria-live') === 'assertive');
+        expect(polite.textContent).toBe('sorted by name');
+        expect(assertive.textContent).toBe('');
+    });
+    it('routes assertive announcements to the assertive region', () => {
+        const a = useLiveAnnouncer();
+        a.announce('submit failed', 'assertive');
+        const polite = regions().find((e) => e.getAttribute('aria-live') === 'polite');
+        const assertive = regions().find((e) => e.getAttribute('aria-live') === 'assertive');
+        expect(assertive.textContent).toBe('submit failed');
+        expect(polite.textContent).toBe('');
+    });
+    it('re-announces identical consecutive messages by clearing first', () => {
+        const a = useLiveAnnouncer();
+        const polite = () => regions().find((e) => e.getAttribute('aria-live') === 'polite');
+        a.announce('page 2');
+        expect(polite().textContent).toBe('page 2');
+        // simulate AT reading + DOM still holding the text, then same message again
+        a.announce('page 2');
+        expect(polite().textContent).toBe('page 2');
+    });
+    it('is a no-op for empty messages and does not mount regions', () => {
+        const a = useLiveAnnouncer();
+        a.announce('');
+        expect(regions()).toHaveLength(0);
+    });
+    it('__resetLiveAnnouncer removes the regions and resets the singleton', () => {
+        useLiveAnnouncer().announce('x');
+        expect(regions()).toHaveLength(2);
+        __resetLiveAnnouncer();
+        expect(regions()).toHaveLength(0);
+        // a fresh announce re-mounts
+        useLiveAnnouncer().announce('y');
+        expect(regions()).toHaveLength(2);
+    });
+});
+//# sourceMappingURL=live-announcer.test.js.map

package/dist/live-announcer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-announcer.test.js","sourceRoot":"","sources":["../src/live-announcer.test.ts"],"names":[],"mappings":"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"}

package/dist/lottie-icon.d.ts

@@ -0,0 +1,88 @@
+/**
+ * createLottieIcon helpers — framework-agnostic Lottie icon logic.
+ * Pure decision functions (reduced-motion resolution, size mapping, autoplay
+ * gating) plus a player-adapter interface so the library never hard-depends on
+ * lottie-web — consumers inject any player. The svelte layer owns the mount
+ * node + adapter lifecycle. See specs/components/other/LottieIcon.spec.md §3
+ * (dependency-injected adapter; src fetch / visible / segments deferred).
+ */
+export type LottieTrigger = 'auto' | 'hover' | 'manual';
+export type LottieSize = 'small' | 'default' | 'large';
+/**
+ * Render backend the injected player should use. Mirrors lottie-web's
+ * `renderer` option ('svg' | 'canvas' | 'html'). Optional everywhere so legacy
+ * factories that ignore it keep their default ('svg') behaviour.
+ */
+export type LottieRenderer = 'svg' | 'canvas' | 'html';
+/**
+ * Frame segment to play: a `[start, end]` frame pair, or a named marker string
+ * resolved against the animation data's `markers`. See `resolveSegments`.
+ */
+export type LottieSegments = [number, number] | string;
+/** Minimal player adapter the host injects (e.g. wrapping lottie-web). */
+export interface LottiePlayerAdapter {
+    play(): void;
+    pause(): void;
+    stop(): void;
+    /** jump to a specific frame and hold (used for reduced-motion static frame) */
+    goToFrame?(frame: number): void;
+    /**
+     * Play a resolved `[start, end]` frame segment. Optional: when the injected
+     * player lacks it, the host falls back to `play()`. The svelte layer always
+     * passes a numeric pair (named markers resolved via `resolveSegments`).
+     */
+    playSegments?(segments: [number, number]): void;
+    destroy(): void;
+}
+/** Factory the host passes: builds an adapter for the given container + data. */
+export type LottiePlayerFactory = (config: {
+    container: HTMLElement;
+    data: unknown;
+    loop: boolean | number;
+    autoplay: boolean;
+    speed: number;
+    /** Resolved initial `[start, end]` frame segment, when `segments` is set. */
+    segment?: [number, number];
+    /**
+     * Render backend ('svg' | 'canvas' | 'html'), forwarded to e.g. lottie-web's
+     * `renderer` option. Optional & backward-compatible: omitted when the host's
+     * `canvas`/`renderer` prop is unset, so legacy factories default to 'svg'.
+     */
+    renderer?: LottieRenderer;
+}) => LottiePlayerAdapter;
+/**
+ * Resolve the host `canvas` / `renderer` prop into a concrete renderer backend
+ * for the factory (pure). `renderer` (explicit string) wins; otherwise
+ * `canvas === true` → 'canvas'. Returns `undefined` when neither is set so the
+ * host omits `renderer` entirely and legacy factories keep their 'svg' default.
+ */
+export declare function resolveRenderer(canvas: boolean | undefined, renderer: LottieRenderer | undefined): LottieRenderer | undefined;
+/**
+ * Resolve a `segments` prop into a concrete `[start, end]` frame pair.
+ * - `[start, end]` numeric pair → returned as-is.
+ * - marker name string → looked up in the data's `markers` (`cm` name,
+ *   `tm` start time, `dr` duration); resolves to `[tm, tm + dr]`.
+ * Returns `null` when unresolvable (no markers / name not found / bad input)
+ * so the host can fall back to playing the whole animation.
+ */
+export declare function resolveSegments(segments: LottieSegments | undefined, data: unknown): [number, number] | null;
+/**
+ * Is `src` a usable animation source URL (non-empty string). Pure guard used
+ * by the host to decide whether to kick off a fetch.
+ */
+export declare function isLottieSrc(src: unknown): src is string;
+/** Map a size token (or raw px number) to a pixel value. */
+export declare function resolveSize(size: LottieSize | number): number;
+/**
+ * Resolve whether animation should run: an explicit `reducedMotion` prop wins;
+ * otherwise follow the system `prefers-reduced-motion`. Returns true when
+ * animation is ALLOWED (i.e. NOT reduced).
+ */
+export declare function resolveAnimated(reducedMotionProp: boolean | undefined, systemReduced: boolean): boolean;
+/**
+ * Should the icon start playing on mount, given trigger + autoplay + whether
+ * animation is allowed (reduced-motion). Only `auto` honors autoplay; hover &
+ * manual never autoplay.
+ */
+export declare function shouldAutoplay(trigger: LottieTrigger, autoplay: boolean, animated: boolean): boolean;
+//# sourceMappingURL=lottie-icon.d.ts.map

package/dist/lottie-icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lottie-icon.d.ts","sourceRoot":"","sources":["../src/lottie-icon.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;AAEvD,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,+EAA+E;IAC/E,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAChD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE;IACzC,SAAS,EAAE,WAAW,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,KAAK,mBAAmB,CAAC;AAE1B;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,QAAQ,EAAE,cAAc,GAAG,SAAS,GACnC,cAAc,GAAG,SAAS,CAI5B;AASD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,IAAI,EAAE,OAAO,GACZ,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiBzB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAEvD;AAID,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,iBAAiB,EAAE,OAAO,GAAG,SAAS,EACtC,aAAa,EAAE,OAAO,GACrB,OAAO,CAGT;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAGT"}

package/dist/lottie-icon.js

@@ -0,0 +1,84 @@
+/**
+ * createLottieIcon helpers — framework-agnostic Lottie icon logic.
+ * Pure decision functions (reduced-motion resolution, size mapping, autoplay
+ * gating) plus a player-adapter interface so the library never hard-depends on
+ * lottie-web — consumers inject any player. The svelte layer owns the mount
+ * node + adapter lifecycle. See specs/components/other/LottieIcon.spec.md §3
+ * (dependency-injected adapter; src fetch / visible / segments deferred).
+ */
+/**
+ * Resolve the host `canvas` / `renderer` prop into a concrete renderer backend
+ * for the factory (pure). `renderer` (explicit string) wins; otherwise
+ * `canvas === true` → 'canvas'. Returns `undefined` when neither is set so the
+ * host omits `renderer` entirely and legacy factories keep their 'svg' default.
+ */
+export function resolveRenderer(canvas, renderer) {
+    if (renderer != null)
+        return renderer;
+    if (canvas === true)
+        return 'canvas';
+    return undefined;
+}
+/**
+ * Resolve a `segments` prop into a concrete `[start, end]` frame pair.
+ * - `[start, end]` numeric pair → returned as-is.
+ * - marker name string → looked up in the data's `markers` (`cm` name,
+ *   `tm` start time, `dr` duration); resolves to `[tm, tm + dr]`.
+ * Returns `null` when unresolvable (no markers / name not found / bad input)
+ * so the host can fall back to playing the whole animation.
+ */
+export function resolveSegments(segments, data) {
+    if (segments == null)
+        return null;
+    if (Array.isArray(segments)) {
+        const [start, end] = segments;
+        if (typeof start === 'number' && typeof end === 'number' && Number.isFinite(start) && Number.isFinite(end)) {
+            return [start, end];
+        }
+        return null;
+    }
+    if (typeof segments !== 'string')
+        return null;
+    const markers = data?.markers;
+    if (!Array.isArray(markers))
+        return null;
+    const marker = markers.find((m) => m && m.cm === segments);
+    if (!marker || typeof marker.tm !== 'number')
+        return null;
+    const start = marker.tm;
+    const end = start + (typeof marker.dr === 'number' ? marker.dr : 0);
+    return [start, end];
+}
+/**
+ * Is `src` a usable animation source URL (non-empty string). Pure guard used
+ * by the host to decide whether to kick off a fetch.
+ */
+export function isLottieSrc(src) {
+    return typeof src === 'string' && src.trim().length > 0;
+}
+const SIZE_PX = { small: 16, default: 20, large: 24 };
+/** Map a size token (or raw px number) to a pixel value. */
+export function resolveSize(size) {
+    return typeof size === 'number' ? size : SIZE_PX[size];
+}
+/**
+ * Resolve whether animation should run: an explicit `reducedMotion` prop wins;
+ * otherwise follow the system `prefers-reduced-motion`. Returns true when
+ * animation is ALLOWED (i.e. NOT reduced).
+ */
+export function resolveAnimated(reducedMotionProp, systemReduced) {
+    if (reducedMotionProp !== undefined)
+        return !reducedMotionProp;
+    return !systemReduced;
+}
+/**
+ * Should the icon start playing on mount, given trigger + autoplay + whether
+ * animation is allowed (reduced-motion). Only `auto` honors autoplay; hover &
+ * manual never autoplay.
+ */
+export function shouldAutoplay(trigger, autoplay, animated) {
+    if (!animated)
+        return false;
+    return trigger === 'auto' && autoplay;
+}
+//# sourceMappingURL=lottie-icon.js.map

package/dist/lottie-icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lottie-icon.js","sourceRoot":"","sources":["../src/lottie-icon.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmDH;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA2B,EAC3B,QAAoC;IAEpC,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO,SAAS,CAAC;AACnB,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAoC,EACpC,IAAa;IAEb,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC;QAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3G,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAI,IAAwD,EAAE,OAAO,CAAC;IACnF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,OAAO,GAA+B,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAElF,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,IAAyB;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,iBAAsC,EACtC,aAAsB;IAEtB,IAAI,iBAAiB,KAAK,SAAS;QAAE,OAAO,CAAC,iBAAiB,CAAC;IAC/D,OAAO,CAAC,aAAa,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAsB,EACtB,QAAiB,EACjB,QAAiB;IAEjB,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,OAAO,KAAK,MAAM,IAAI,QAAQ,CAAC;AACxC,CAAC"}

package/dist/lottie-icon.test.d.ts

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

package/dist/lottie-icon.test.d.ts.map

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

package/dist/lottie-icon.test.js

@@ -0,0 +1,88 @@
+import { describe, expect, it } from 'vitest';
+import { resolveSize, resolveAnimated, shouldAutoplay, resolveSegments, isLottieSrc, resolveRenderer, } from './lottie-icon.js';
+describe('resolveSize', () => {
+    it('maps size tokens to px', () => {
+        expect(resolveSize('small')).toBe(16);
+        expect(resolveSize('default')).toBe(20);
+        expect(resolveSize('large')).toBe(24);
+    });
+    it('passes through raw numbers', () => {
+        expect(resolveSize(48)).toBe(48);
+    });
+});
+describe('resolveAnimated', () => {
+    it('explicit reducedMotion prop wins over system', () => {
+        expect(resolveAnimated(true, false)).toBe(false); // forced reduce → not animated
+        expect(resolveAnimated(false, true)).toBe(true); // forced motion → animated despite system
+    });
+    it('follows system when prop is undefined', () => {
+        expect(resolveAnimated(undefined, false)).toBe(true); // system not reduced → animated
+        expect(resolveAnimated(undefined, true)).toBe(false); // system reduced → not animated
+    });
+});
+describe('shouldAutoplay', () => {
+    it('auto + autoplay + animated → true', () => {
+        expect(shouldAutoplay('auto', true, true)).toBe(true);
+    });
+    it('not animated (reduced-motion) → never autoplay', () => {
+        expect(shouldAutoplay('auto', true, false)).toBe(false);
+    });
+    it('autoplay=false → no autoplay', () => {
+        expect(shouldAutoplay('auto', false, true)).toBe(false);
+    });
+    it('hover/manual triggers never autoplay', () => {
+        expect(shouldAutoplay('hover', true, true)).toBe(false);
+        expect(shouldAutoplay('manual', true, true)).toBe(false);
+    });
+});
+describe('resolveSegments', () => {
+    it('passes through a numeric frame pair', () => {
+        expect(resolveSegments([10, 60], null)).toEqual([10, 60]);
+    });
+    it('returns null for undefined / invalid pairs', () => {
+        expect(resolveSegments(undefined, null)).toBeNull();
+        // @ts-expect-error invalid tuple
+        expect(resolveSegments(['a', 'b'], null)).toBeNull();
+        expect(resolveSegments([NaN, 5], null)).toBeNull();
+    });
+    it('resolves a named marker against data.markers (tm + dr)', () => {
+        const data = { markers: [{ cm: 'hover', tm: 30, dr: 20 }, { cm: 'idle', tm: 0, dr: 30 }] };
+        expect(resolveSegments('hover', data)).toEqual([30, 50]);
+        expect(resolveSegments('idle', data)).toEqual([0, 30]);
+    });
+    it('returns null when marker missing or no markers', () => {
+        expect(resolveSegments('nope', { markers: [{ cm: 'x', tm: 1, dr: 1 }] })).toBeNull();
+        expect(resolveSegments('x', {})).toBeNull();
+        expect(resolveSegments('x', null)).toBeNull();
+    });
+    it('treats marker without dr as a zero-length point', () => {
+        expect(resolveSegments('p', { markers: [{ cm: 'p', tm: 12 }] })).toEqual([12, 12]);
+    });
+});
+describe('isLottieSrc', () => {
+    it('true for non-empty strings', () => {
+        expect(isLottieSrc('https://x/a.json')).toBe(true);
+        expect(isLottieSrc('  /local.json ')).toBe(true);
+    });
+    it('false for empty / non-string', () => {
+        expect(isLottieSrc('')).toBe(false);
+        expect(isLottieSrc('   ')).toBe(false);
+        expect(isLottieSrc(undefined)).toBe(false);
+        expect(isLottieSrc({})).toBe(false);
+    });
+});
+describe('resolveRenderer', () => {
+    it('explicit renderer wins over canvas', () => {
+        expect(resolveRenderer(true, 'html')).toBe('html');
+        expect(resolveRenderer(false, 'svg')).toBe('svg');
+        expect(resolveRenderer(undefined, 'canvas')).toBe('canvas');
+    });
+    it('canvas=true maps to canvas when no explicit renderer', () => {
+        expect(resolveRenderer(true, undefined)).toBe('canvas');
+    });
+    it('undefined (omitted) for default svg / backward compat', () => {
+        expect(resolveRenderer(false, undefined)).toBeUndefined();
+        expect(resolveRenderer(undefined, undefined)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=lottie-icon.test.js.map

package/dist/lottie-icon.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lottie-icon.test.js","sourceRoot":"","sources":["../src/lottie-icon.test.ts"],"names":[],"mappings":"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"}

package/dist/notification.d.ts

@@ -0,0 +1,61 @@
+export type NotificationType = 'default' | 'success' | 'info' | 'warning' | 'error';
+export type NotificationPlacement = 'topLeft' | 'top' | 'topRight' | 'bottomLeft' | 'bottom' | 'bottomRight';
+export type NotificationCloseReason = 'timeout' | 'manual' | 'replace' | 'destroyAll';
+export type NotificationTheme = 'light' | 'dark';
+export type NotificationDirection = 'ltr' | 'rtl';
+export interface NotificationOptions {
+    id?: string;
+    title?: string;
+    content?: string;
+    type?: NotificationType;
+    /** auto-dismiss seconds; 0 = persist */
+    duration?: number;
+    placement?: NotificationPlacement;
+    closable?: boolean;
+    pauseOnHover?: boolean;
+    /** show a countdown progress bar that tracks the remaining auto-dismiss time */
+    showProgress?: boolean;
+    /** visual theme of the card */
+    theme?: NotificationTheme;
+    /** writing direction; 'rtl' mirrors the card layout and swaps left/right placement */
+    direction?: NotificationDirection;
+    /**
+     * footer action area. Opaque to core (framework-agnostic) — the render layer
+     * (svelte) treats it as a Snippet. Typed `unknown` here to avoid a framework dep.
+     */
+    footer?: unknown;
+    onClose?: (id: string, reason: NotificationCloseReason) => void;
+}
+export interface NotificationItem {
+    id: string;
+    title: string;
+    content: string;
+    type: NotificationType;
+    duration: number;
+    placement: NotificationPlacement;
+    closable: boolean;
+    pauseOnHover: boolean;
+    showProgress: boolean;
+    theme: NotificationTheme;
+    direction: NotificationDirection;
+    footer: unknown;
+    onClose: ((id: string, reason: NotificationCloseReason) => void) | undefined;
+}
+export interface NotificationStoreOptions {
+    maxCount?: number;
+    defaultDuration?: number;
+    /** default writing direction applied to items that don't specify one */
+    defaultDirection?: NotificationDirection;
+}
+export interface NotificationStore {
+    getItems(): NotificationItem[];
+    subscribe(listener: (items: NotificationItem[]) => void): () => void;
+    open(options: NotificationOptions): string;
+    close(id: string, reason?: NotificationCloseReason): void;
+    destroyAll(placement?: NotificationPlacement): void;
+    pause(id: string): void;
+    resume(id: string): void;
+    destroy(): void;
+}
+export declare function createNotificationStore(storeOptions?: NotificationStoreOptions): NotificationStore;
+//# sourceMappingURL=notification.d.ts.map

package/dist/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AACpF,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,KAAK,GACL,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,aAAa,CAAC;AAClB,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;AACtF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,KAAK,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gFAAgF;IAChF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,sFAAsF;IACtF,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,qBAAqB,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,qBAAqB,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,IAAI,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAC3C,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1D,UAAU,CAAC,SAAS,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AASD,wBAAgB,uBAAuB,CACrC,YAAY,GAAE,wBAA6B,GAC1C,iBAAiB,CA2HnB"}