@chenzy-design/core 0.1.0

package/dist/notification.js

@@ -0,0 +1,133 @@
+/**
+ * createNotificationStore — framework-agnostic singleton notification queue.
+ * Same queue + timer model as the toast store, but groups by 6 placements and
+ * carries richer data (title/content/footer). Auto-dismiss with hover pause,
+ * FIFO maxCount per placement, id-based dedup/update. No DOM, no framework deps.
+ * See specs/components/feedback/Notification.spec.md §3.
+ */
+import { useId } from './id.js';
+export function createNotificationStore(storeOptions = {}) {
+    const { maxCount = 5, defaultDuration = 4.5, defaultDirection = 'ltr' } = storeOptions;
+    let items = [];
+    const timers = new Map();
+    const listeners = new Set();
+    function emit() {
+        const snapshot = items.slice();
+        for (const l of listeners)
+            l(snapshot);
+    }
+    function now() {
+        return Date.now();
+    }
+    function clearTimer(id) {
+        const rec = timers.get(id);
+        if (rec?.timer != null) {
+            clearTimeout(rec.timer);
+            rec.timer = null;
+        }
+    }
+    function startTimer(id, ms) {
+        if (ms <= 0)
+            return;
+        const rec = { timer: null, remaining: ms, startedAt: now() };
+        rec.timer = setTimeout(() => close(id, 'timeout'), ms);
+        timers.set(id, rec);
+    }
+    function close(id, reason = 'manual') {
+        const item = items.find((t) => t.id === id);
+        if (!item)
+            return;
+        clearTimer(id);
+        timers.delete(id);
+        items = items.filter((t) => t.id !== id);
+        emit();
+        item.onClose?.(id, reason);
+    }
+    function open(options) {
+        const id = options.id ?? useId('cd-notification');
+        const placement = options.placement ?? 'topRight';
+        const item = {
+            id,
+            title: options.title ?? '',
+            content: options.content ?? '',
+            type: options.type ?? 'default',
+            duration: options.duration ?? defaultDuration,
+            placement,
+            closable: options.closable ?? true,
+            pauseOnHover: options.pauseOnHover ?? true,
+            showProgress: options.showProgress ?? false,
+            theme: options.theme ?? 'light',
+            direction: options.direction ?? defaultDirection,
+            footer: options.footer,
+            onClose: options.onClose,
+        };
+        const existingIndex = items.findIndex((t) => t.id === id);
+        if (existingIndex >= 0) {
+            clearTimer(id);
+            timers.delete(id);
+            items = items.map((t, i) => (i === existingIndex ? item : t));
+        }
+        else {
+            items = [...items, item];
+            // FIFO per placement
+            const samePlacement = items.filter((t) => t.placement === placement);
+            if (samePlacement.length > maxCount) {
+                const oldest = samePlacement[0];
+                clearTimer(oldest.id);
+                timers.delete(oldest.id);
+                items = items.filter((t) => t.id !== oldest.id);
+                oldest.onClose?.(oldest.id, 'replace');
+            }
+        }
+        emit();
+        startTimer(id, item.duration * 1000);
+        return id;
+    }
+    function destroyAll(placement) {
+        const targets = placement ? items.filter((t) => t.placement === placement) : items.slice();
+        for (const t of targets) {
+            clearTimer(t.id);
+            timers.delete(t.id);
+        }
+        const ids = new Set(targets.map((t) => t.id));
+        items = items.filter((t) => !ids.has(t.id));
+        emit();
+        for (const t of targets)
+            t.onClose?.(t.id, 'destroyAll');
+    }
+    function pause(id) {
+        const rec = timers.get(id);
+        if (!rec || rec.timer == null)
+            return;
+        clearTimeout(rec.timer);
+        rec.remaining = Math.max(0, rec.remaining - (now() - rec.startedAt));
+        rec.timer = null;
+    }
+    function resume(id) {
+        const rec = timers.get(id);
+        if (!rec || rec.timer != null || rec.remaining <= 0)
+            return;
+        rec.startedAt = now();
+        rec.timer = setTimeout(() => close(id, 'timeout'), rec.remaining);
+    }
+    return {
+        getItems: () => items.slice(),
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        open,
+        close,
+        destroyAll,
+        pause,
+        resume,
+        destroy() {
+            for (const t of items)
+                clearTimer(t.id);
+            timers.clear();
+            items = [];
+            listeners.clear();
+        },
+    };
+}
+//# sourceMappingURL=notification.js.map

package/dist/notification.js.map

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

package/dist/notification.test.d.ts

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

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

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

package/dist/notification.test.js

@@ -0,0 +1,103 @@
+import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
+import { createNotificationStore } from './notification.js';
+describe('createNotificationStore', () => {
+    beforeEach(() => vi.useFakeTimers());
+    afterEach(() => vi.useRealTimers());
+    it('opens a notification and returns its id', () => {
+        const s = createNotificationStore();
+        const id = s.open({ title: 'Done', content: 'Saved', duration: 0 });
+        expect(typeof id).toBe('string');
+        expect(s.getItems()[0]?.title).toBe('Done');
+        s.destroy();
+    });
+    it('auto-dismisses after duration (default 4.5s)', () => {
+        const s = createNotificationStore();
+        s.open({ title: 'x' });
+        vi.advanceTimersByTime(4499);
+        expect(s.getItems().length).toBe(1);
+        vi.advanceTimersByTime(1);
+        expect(s.getItems().length).toBe(0);
+        s.destroy();
+    });
+    it('duration 0 persists', () => {
+        const s = createNotificationStore();
+        s.open({ title: 'stay', duration: 0 });
+        vi.advanceTimersByTime(100000);
+        expect(s.getItems().length).toBe(1);
+        s.destroy();
+    });
+    it('id dedup updates in place', () => {
+        const s = createNotificationStore();
+        const id = s.open({ title: 'v1', duration: 0 });
+        s.open({ id, title: 'v2', duration: 0 });
+        expect(s.getItems().length).toBe(1);
+        expect(s.getItems()[0]?.title).toBe('v2');
+        s.destroy();
+    });
+    it('FIFO is per-placement', () => {
+        const s = createNotificationStore({ maxCount: 2 });
+        s.open({ title: 'a', placement: 'topRight', duration: 0 });
+        s.open({ title: 'b', placement: 'topRight', duration: 0 });
+        s.open({ title: 'c', placement: 'topRight', duration: 0 });
+        // topRight evicts oldest 'a'
+        const tr = s.getItems().filter((t) => t.placement === 'topRight');
+        expect(tr.map((t) => t.title)).toEqual(['b', 'c']);
+        // a different placement is unaffected
+        s.open({ title: 'd', placement: 'bottomLeft', duration: 0 });
+        expect(s.getItems().filter((t) => t.placement === 'bottomLeft').length).toBe(1);
+        s.destroy();
+    });
+    it('close and destroyAll (optionally by placement)', () => {
+        const s = createNotificationStore();
+        const a = s.open({ title: 'a', placement: 'topRight', duration: 0 });
+        s.open({ title: 'b', placement: 'bottomLeft', duration: 0 });
+        s.close(a);
+        expect(s.getItems().map((t) => t.title)).toEqual(['b']);
+        s.open({ title: 'c', placement: 'topRight', duration: 0 });
+        s.destroyAll('topRight'); // only topRight cleared
+        expect(s.getItems().map((t) => t.title)).toEqual(['b']);
+        s.destroyAll(); // all cleared
+        expect(s.getItems().length).toBe(0);
+        s.destroy();
+    });
+    it('pause/resume preserves remaining time', () => {
+        const s = createNotificationStore();
+        const id = s.open({ title: 'x', duration: 4 });
+        vi.advanceTimersByTime(1000);
+        s.pause(id);
+        vi.advanceTimersByTime(10000);
+        expect(s.getItems().length).toBe(1);
+        s.resume(id);
+        vi.advanceTimersByTime(3000);
+        expect(s.getItems().length).toBe(0);
+        s.destroy();
+    });
+    it('default type and placement', () => {
+        const s = createNotificationStore();
+        s.open({ title: 'x', duration: 0 });
+        const item = s.getItems()[0];
+        expect(item.type).toBe('default');
+        expect(item.placement).toBe('topRight');
+        s.destroy();
+    });
+    it('showProgress/theme/footer default to off/light/undefined', () => {
+        const s = createNotificationStore();
+        s.open({ title: 'x', duration: 0 });
+        const item = s.getItems()[0];
+        expect(item.showProgress).toBe(false);
+        expect(item.theme).toBe('light');
+        expect(item.footer).toBeUndefined();
+        s.destroy();
+    });
+    it('carries showProgress/theme/footer through to the item', () => {
+        const s = createNotificationStore();
+        const footer = { __snippet: true };
+        s.open({ title: 'x', duration: 0, showProgress: true, theme: 'dark', footer });
+        const item = s.getItems()[0];
+        expect(item.showProgress).toBe(true);
+        expect(item.theme).toBe('dark');
+        expect(item.footer).toBe(footer);
+        s.destroy();
+    });
+});
+//# sourceMappingURL=notification.test.js.map

package/dist/notification.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.test.js","sourceRoot":"","sources":["../src/notification.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;IACrC,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC;IAEpC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvB,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACvC,EAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,GAAG,uBAAuB,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3D,6BAA6B;QAC7B,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC;QAClE,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QACnD,sCAAsC;QACtC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACX,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,wBAAwB;QAClD,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,cAAc;QAC9B,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACZ,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACb,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QACpC,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,GAAG,uBAAuB,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/E,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/overflow-list.d.ts

@@ -0,0 +1,102 @@
+/**
+ * createOverflowList helpers — framework-agnostic overflow-collapse math.
+ * Pure functions only: given measured item widths + container width, compute
+ * how many leading items fit before the rest collapse into a "+N" node. No DOM,
+ * no framework deps, no internal mutable state — the svelte layer measures DOM
+ * (ResizeObserver) and feeds widths in. See specs/components/show/OverflowList.spec.md §3.
+ * The fit math is axis-agnostic — horizontal/vertical only changes which DOM
+ * dimension the svelte layer measures — and `computeOverflowPartition` adds
+ * `collapseFrom: 'start' | 'end'` for head- vs tail-collapse.
+ */
+export interface OverflowComputeInput {
+    /** measured main-axis size of each item, in document order */
+    itemSizes: readonly number[];
+    /** available container main-axis size */
+    containerSize: number;
+    /** main-axis size of the "+N" overflow node (reserved when collapsing) */
+    overflowSize: number;
+    /** gap between adjacent items */
+    gap: number;
+    /** items that must never be collapsed (indexes) */
+    alwaysVisible?: readonly number[];
+    /** never collapse below this many visible items (prefer overflow instead) */
+    minVisibleItems?: number;
+}
+export interface OverflowComputeResult {
+    /** number of leading items rendered visibly */
+    visibleCount: number;
+    /** number of items collapsed into the overflow node */
+    overflowCount: number;
+}
+/**
+ * Compute how many leading items fit. If all fit, no overflow node is reserved.
+ * Otherwise reserve `overflowSize` (+ a gap) and fit as many leading items as
+ * possible. `alwaysVisible` indexes and `minVisibleItems` raise the floor.
+ */
+export declare function computeVisibleCount(input: OverflowComputeInput): OverflowComputeResult;
+/** which end the overflow node collapses from: trailing (`end`) or leading (`start`) */
+export type CollapseFrom = 'end' | 'start';
+export interface OverflowPartitionInput extends OverflowComputeInput {
+    /** collapse trailing items (`end`, default) or leading items (`start`) */
+    collapseFrom?: CollapseFrom;
+}
+export interface OverflowPartitionResult extends OverflowComputeResult {
+    /** indexes rendered visibly, in document order */
+    visibleIndexes: number[];
+    /** indexes collapsed into the overflow node, in document order */
+    overflowIndexes: number[];
+}
+/**
+ * Partition items into visible + overflow honoring `collapseFrom`. The fit math
+ * is direction-agnostic (the svelte layer feeds the main-axis sizes regardless
+ * of horizontal/vertical), so the same {@link computeVisibleCount} drives both
+ * ends — for `start` we mirror the size array, fit the same number of items, and
+ * map the kept window back to the trailing positions.
+ *
+ * `end`  → visible = leading [0..k), overflow = trailing [k..count)
+ * `start`→ visible = trailing [count-k..count), overflow = leading [0..count-k)
+ *
+ * `alwaysVisible` indexes and `minVisibleItems` raise the visible-count floor in
+ * both directions (mirrored for `start`).
+ */
+export declare function computeOverflowPartition(input: OverflowPartitionInput): OverflowPartitionResult;
+/**
+ * Tabs dropdown-overflow partition input. Given measured tab sizes + the bar's
+ * available main-axis size, decide which leading tabs render inline and which
+ * collapse into a "more" trigger. Pure math: the svelte layer measures DOM
+ * (ResizeObserver) and feeds sizes in. The active tab is always kept visible
+ * (Semi behavior) — if it would collapse, it is pulled into the visible set so
+ * the selected panel's tab is never hidden behind the dropdown.
+ */
+export interface TabOverflowInput {
+    /** measured main-axis size of each tab, in document order */
+    tabSizes: readonly number[];
+    /** available main-axis size of the tab bar (minus reserved chrome) */
+    containerSize: number;
+    /** main-axis size of the "more" trigger (reserved when collapsing) */
+    moreSize: number;
+    /** gap between adjacent tabs */
+    gap: number;
+    /** index of the active tab; always kept in the visible set when valid */
+    activeIndex?: number;
+}
+export interface TabOverflowResult {
+    /** tab indexes rendered inline, in document order */
+    visibleIndexes: number[];
+    /** tab indexes collapsed into the "more" dropdown, in document order */
+    overflowIndexes: number[];
+}
+/**
+ * Partition tabs into visible (inline) and overflow (collapsed into "more").
+ * Reuses {@link computeVisibleCount} for the leading-fit math, then guarantees
+ * the active tab is visible by swapping it into the last visible slot if it
+ * landed in the overflow set.
+ */
+export declare function computeTabOverflow(input: TabOverflowInput): TabOverflowResult;
+/**
+ * Apply hysteresis: keep the previous visibleCount unless the new computation
+ * differs by enough to cross the threshold band, preventing flicker at the
+ * boundary width. Returns the count to actually render.
+ */
+export declare function applyHysteresis(prev: number, next: number, prevContainerSize: number, containerSize: number, threshold: number): number;
+//# sourceMappingURL=overflow-list.d.ts.map

package/dist/overflow-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow-list.d.ts","sourceRoot":"","sources":["../src/overflow-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;CACvB;AAWD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAsCtF;AAED,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAC;AAE3C,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,0EAA0E;IAC1E,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,kDAAkD;IAClD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kEAAkE;IAClE,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,GAC5B,uBAAuB,CAiCzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,wEAAwE;IACxE,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAqC7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,MAAM,EACzB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,MAAM,CAOR"}

package/dist/overflow-list.js

@@ -0,0 +1,159 @@
+/**
+ * createOverflowList helpers — framework-agnostic overflow-collapse math.
+ * Pure functions only: given measured item widths + container width, compute
+ * how many leading items fit before the rest collapse into a "+N" node. No DOM,
+ * no framework deps, no internal mutable state — the svelte layer measures DOM
+ * (ResizeObserver) and feeds widths in. See specs/components/show/OverflowList.spec.md §3.
+ * The fit math is axis-agnostic — horizontal/vertical only changes which DOM
+ * dimension the svelte layer measures — and `computeOverflowPartition` adds
+ * `collapseFrom: 'start' | 'end'` for head- vs tail-collapse.
+ */
+/** sum of `n` item sizes plus the gaps between them */
+function rowWidth(sizes, n, gap) {
+    if (n <= 0)
+        return 0;
+    let total = 0;
+    for (let i = 0; i < n; i += 1)
+        total += sizes[i] ?? 0;
+    total += gap * (n - 1);
+    return total;
+}
+/**
+ * Compute how many leading items fit. If all fit, no overflow node is reserved.
+ * Otherwise reserve `overflowSize` (+ a gap) and fit as many leading items as
+ * possible. `alwaysVisible` indexes and `minVisibleItems` raise the floor.
+ */
+export function computeVisibleCount(input) {
+    const { itemSizes, containerSize, overflowSize, gap, alwaysVisible = [], minVisibleItems = 0, } = input;
+    const count = itemSizes.length;
+    if (count === 0)
+        return { visibleCount: 0, overflowCount: 0 };
+    // Everything fits → no collapse.
+    if (rowWidth(itemSizes, count, gap) <= containerSize) {
+        return { visibleCount: count, overflowCount: 0 };
+    }
+    // Need to collapse: reserve room for the overflow node.
+    const reserved = overflowSize + gap;
+    let visible = 0;
+    for (let n = 1; n <= count; n += 1) {
+        if (rowWidth(itemSizes, n, gap) + reserved <= containerSize) {
+            visible = n;
+        }
+        else {
+            break;
+        }
+    }
+    // Honor floors: alwaysVisible highest index + 1, and minVisibleItems.
+    const maxAlways = alwaysVisible.length ? Math.max(...alwaysVisible) + 1 : 0;
+    const floor = Math.min(count, Math.max(visible, maxAlways, minVisibleItems));
+    visible = Math.max(visible, floor);
+    // If the floor pushed us to render everything, there's no overflow.
+    if (visible >= count)
+        return { visibleCount: count, overflowCount: 0 };
+    return { visibleCount: visible, overflowCount: count - visible };
+}
+/**
+ * Partition items into visible + overflow honoring `collapseFrom`. The fit math
+ * is direction-agnostic (the svelte layer feeds the main-axis sizes regardless
+ * of horizontal/vertical), so the same {@link computeVisibleCount} drives both
+ * ends — for `start` we mirror the size array, fit the same number of items, and
+ * map the kept window back to the trailing positions.
+ *
+ * `end`  → visible = leading [0..k), overflow = trailing [k..count)
+ * `start`→ visible = trailing [count-k..count), overflow = leading [0..count-k)
+ *
+ * `alwaysVisible` indexes and `minVisibleItems` raise the visible-count floor in
+ * both directions (mirrored for `start`).
+ */
+export function computeOverflowPartition(input) {
+    const { itemSizes, collapseFrom = 'end', alwaysVisible = [] } = input;
+    const count = itemSizes.length;
+    if (collapseFrom === 'end') {
+        const { visibleCount, overflowCount } = computeVisibleCount(input);
+        const visibleIndexes = [];
+        const overflowIndexes = [];
+        for (let i = 0; i < count; i += 1) {
+            if (i < visibleCount)
+                visibleIndexes.push(i);
+            else
+                overflowIndexes.push(i);
+        }
+        return { visibleCount, overflowCount, visibleIndexes, overflowIndexes };
+    }
+    // start: mirror so the same leading-fit math keeps the *trailing* window.
+    const mirroredSizes = [...itemSizes].reverse();
+    // mirror alwaysVisible indexes too (i → count-1-i).
+    const mirroredAlways = alwaysVisible.map((i) => count - 1 - i);
+    const { visibleCount } = computeVisibleCount({
+        ...input,
+        itemSizes: mirroredSizes,
+        alwaysVisible: mirroredAlways,
+    });
+    const overflowCount = count - visibleCount;
+    const firstVisible = overflowCount; // [overflowCount .. count) stay visible
+    const visibleIndexes = [];
+    const overflowIndexes = [];
+    for (let i = 0; i < count; i += 1) {
+        if (i < firstVisible)
+            overflowIndexes.push(i);
+        else
+            visibleIndexes.push(i);
+    }
+    return { visibleCount, overflowCount, visibleIndexes, overflowIndexes };
+}
+/**
+ * Partition tabs into visible (inline) and overflow (collapsed into "more").
+ * Reuses {@link computeVisibleCount} for the leading-fit math, then guarantees
+ * the active tab is visible by swapping it into the last visible slot if it
+ * landed in the overflow set.
+ */
+export function computeTabOverflow(input) {
+    const { tabSizes, containerSize, moreSize, gap, activeIndex } = input;
+    const count = tabSizes.length;
+    if (count === 0)
+        return { visibleIndexes: [], overflowIndexes: [] };
+    const { visibleCount } = computeVisibleCount({
+        itemSizes: tabSizes,
+        containerSize,
+        overflowSize: moreSize,
+        gap,
+    });
+    // Leading tabs are visible by default.
+    const visible = new Set();
+    for (let i = 0; i < visibleCount; i += 1)
+        visible.add(i);
+    // Guarantee the active tab is visible: if it overflowed, swap it for the last
+    // leading visible tab (which is then pushed into overflow). Keeps the visible
+    // count stable so the "more" reservation still holds.
+    if (activeIndex !== undefined &&
+        activeIndex >= 0 &&
+        activeIndex < count &&
+        !visible.has(activeIndex) &&
+        visibleCount > 0) {
+        visible.delete(visibleCount - 1);
+        visible.add(activeIndex);
+    }
+    const visibleIndexes = [];
+    const overflowIndexes = [];
+    for (let i = 0; i < count; i += 1) {
+        if (visible.has(i))
+            visibleIndexes.push(i);
+        else
+            overflowIndexes.push(i);
+    }
+    return { visibleIndexes, overflowIndexes };
+}
+/**
+ * Apply hysteresis: keep the previous visibleCount unless the new computation
+ * differs by enough to cross the threshold band, preventing flicker at the
+ * boundary width. Returns the count to actually render.
+ */
+export function applyHysteresis(prev, next, prevContainerSize, containerSize, threshold) {
+    // Only damp tiny size wobbles; a real resize (beyond threshold) always applies.
+    if (Math.abs(containerSize - prevContainerSize) <= threshold && next !== prev) {
+        // within the dead-band: prefer keeping more items visible (avoid collapse churn)
+        return Math.max(prev, next);
+    }
+    return next;
+}
+//# sourceMappingURL=overflow-list.js.map

package/dist/overflow-list.js.map

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

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

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

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

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