@chenzy-design/core 0.1.0

package/dist/scroll-list.js

@@ -0,0 +1,175 @@
+/**
+ * createScrollList helpers — framework-agnostic single-column picker math.
+ * Pure functions only: scroll offset ↔ selected index mapping, disabled-item
+ * skipping, and keyboard target resolution. No DOM, no framework deps, no
+ * internal mutable state — the render layer (svelte) owns scroll state and the
+ * actual CSS scroll-snap. See specs/components/show/ScrollList.spec.md §3
+ * (single-column subset; momentum/cyclic/multi-column deferred).
+ */
+/** Map a scrollTop offset to the centered item index (clamped to range). */
+export function offsetToIndex(scrollTop, itemHeight, count) {
+    if (itemHeight <= 0 || count <= 0)
+        return 0;
+    const raw = Math.round(scrollTop / itemHeight);
+    return Math.max(0, Math.min(count - 1, raw));
+}
+/** The scrollTop that centers a given index. */
+export function indexToOffset(index, itemHeight) {
+    return index * itemHeight;
+}
+/** Index of an item by value, or -1. */
+export function indexOfValue(items, value) {
+    if (value === undefined)
+        return -1;
+    return items.findIndex((it) => it.value === value);
+}
+/**
+ * Resolve the nearest enabled index at or after `from` in `dir` (+1/-1).
+ * If none exists in that direction, returns the original `from` unchanged.
+ */
+export function nextEnabledIndex(items, from, dir) {
+    let i = from + dir;
+    while (i >= 0 && i < items.length) {
+        if (!items[i]?.disabled)
+            return i;
+        i += dir;
+    }
+    return from;
+}
+/** First enabled index (for Home / value resolution), or -1 if all disabled. */
+export function firstEnabledIndex(items) {
+    for (let i = 0; i < items.length; i += 1) {
+        if (!items[i]?.disabled)
+            return i;
+    }
+    return -1;
+}
+/** Last enabled index (for End), or -1 if all disabled. */
+export function lastEnabledIndex(items) {
+    for (let i = items.length - 1; i >= 0; i -= 1) {
+        if (!items[i]?.disabled)
+            return i;
+    }
+    return -1;
+}
+/**
+ * Resolve the target index for a keyboard action from the current index.
+ * Returns the current index when the action can't move (boundary / all
+ * neighbors disabled). `page` is how many rows PageUp/PageDown move.
+ */
+export function keyboardTarget(items, current, key, page = 3) {
+    switch (key) {
+        case 'ArrowUp':
+            return nextEnabledIndex(items, current, -1);
+        case 'ArrowDown':
+            return nextEnabledIndex(items, current, 1);
+        case 'Home': {
+            const f = firstEnabledIndex(items);
+            return f === -1 ? current : f;
+        }
+        case 'End': {
+            const l = lastEnabledIndex(items);
+            return l === -1 ? current : l;
+        }
+        case 'PageUp': {
+            let target = current;
+            for (let n = 0; n < page; n += 1) {
+                const nxt = nextEnabledIndex(items, target, -1);
+                if (nxt === target)
+                    break;
+                target = nxt;
+            }
+            return target;
+        }
+        case 'PageDown': {
+            let target = current;
+            for (let n = 0; n < page; n += 1) {
+                const nxt = nextEnabledIndex(items, target, 1);
+                if (nxt === target)
+                    break;
+                target = nxt;
+            }
+            return target;
+        }
+        default:
+            return current;
+    }
+}
+// ---------------------------------------------------------------------------
+// cyclic（循环列）—— 无限轮：用「重复 N 份」+ 中段定位实现。
+// 渲染层把 data 重复 `repeat` 份铺成一个长列表（virtual count = count*repeat），
+// 滚到靠近首/尾时命令式跳回中段（无动画），视觉无缝。下面是纯索引数学。
+// ---------------------------------------------------------------------------
+/** 正取模（结果恒非负），把任意整数索引折回 [0, count)。 */
+export function wrapIndex(index, count) {
+    if (count <= 0)
+        return 0;
+    return ((index % count) + count) % count;
+}
+/**
+ * cyclic 列的「虚拟总行数」。把真实 count 重复 repeat 份，
+ * repeat 必须为奇数且 >= 3，使「中段」居中。count<=0 返回 0。
+ */
+export function cyclicVirtualCount(count, repeat) {
+    if (count <= 0)
+        return 0;
+    return count * Math.max(3, repeat | 1);
+}
+/**
+ * cyclic 列的「中段基准虚拟索引」：把真实索引 logical 映射到位于正中那一份的虚拟索引。
+ * 例如 count=24、repeat=5 → 中段从 2*24=48 起，logical=9 → 57。
+ */
+export function cyclicCenterIndex(logical, count, repeat) {
+    if (count <= 0)
+        return 0;
+    const r = Math.max(3, repeat | 1);
+    const mid = Math.floor(r / 2);
+    return mid * count + wrapIndex(logical, count);
+}
+/**
+ * cyclic 滚动落定后，判断是否需要把虚拟索引「重定位」回中段（避免滚出重复区边界）。
+ * 返回新的虚拟索引（与传入逻辑值同余、但落在中段），渲染层据此命令式无动画跳转。
+ * 当 virtualIndex 已在安全中段（距首尾各至少 count 行）时返回原值（无需跳）。
+ */
+export function cyclicRecenter(virtualIndex, count, repeat) {
+    if (count <= 0)
+        return 0;
+    const r = Math.max(3, repeat | 1);
+    const total = count * r;
+    // 安全区：[count, total-count)。在区内不动。
+    if (virtualIndex >= count && virtualIndex < total - count)
+        return virtualIndex;
+    const logical = wrapIndex(virtualIndex, count);
+    return cyclicCenterIndex(logical, count, repeat);
+}
+/**
+ * 推进一帧惯性：指数衰减 v' = v * decay^(dt/16.67)，位移取平均速度积分。
+ * @param velocity 当前速度（px/ms，正=向下/scrollTop 增大）
+ * @param dt       帧间隔（ms）
+ * @param decay    每 ~16.67ms（60fps 一帧）的衰减系数，默认 0.95
+ * @param minV     停止阈值（px/ms），默认 0.02
+ */
+export function momentumStep(velocity, dt, decay = 0.95, minV = 0.02) {
+    const frames = dt / (1000 / 60);
+    const next = velocity * Math.pow(decay, frames);
+    // 平均速度积分（梯形）得位移，避免高速时单帧跨度过大。
+    const delta = ((velocity + next) / 2) * dt;
+    return { velocity: next, delta, done: Math.abs(next) < minV };
+}
+/**
+ * 根据当前 scrollTop 与剩余速度预测「最终吸附目标行」（含一点惯性前瞻），clamp 到 [0,count)。
+ * 用于释放瞬间直接算出目标行，再 smooth 吸附（比逐帧更稳，避免抖动）。
+ * @param scrollTop 当前偏移
+ * @param velocity  当前速度（px/ms）
+ * @param itemHeight 行高
+ * @param count     行数
+ * @param projection 速度前瞻系数（默认 80：v*80 px 的滑行预估）
+ */
+export function projectSettleIndex(scrollTop, velocity, itemHeight, count, projection = 80) {
+    if (itemHeight <= 0 || count <= 0)
+        return 0;
+    const projected = scrollTop + velocity * projection;
+    const raw = Math.round(projected / itemHeight);
+    return Math.max(0, Math.min(count - 1, raw));
+}
+//# sourceMappingURL=scroll-list.js.map

package/dist/scroll-list.js.map

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

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

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

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

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

package/dist/scroll-list.test.js

@@ -0,0 +1,135 @@
+import { describe, expect, it } from 'vitest';
+import { offsetToIndex, indexToOffset, indexOfValue, nextEnabledIndex, firstEnabledIndex, lastEnabledIndex, keyboardTarget, wrapIndex, cyclicVirtualCount, cyclicCenterIndex, cyclicRecenter, momentumStep, projectSettleIndex, } from './scroll-list.js';
+const items = [
+    { value: 0, label: '0' },
+    { value: 1, label: '1', disabled: true },
+    { value: 2, label: '2' },
+    { value: 3, label: '3' },
+    { value: 4, label: '4', disabled: true },
+    { value: 5, label: '5' },
+];
+describe('offset ↔ index', () => {
+    it('rounds offset to nearest index and clamps', () => {
+        expect(offsetToIndex(0, 36, 6)).toBe(0);
+        expect(offsetToIndex(40, 36, 6)).toBe(1); // 40/36 ≈ 1.1 → 1
+        expect(offsetToIndex(90, 36, 6)).toBe(3); // 90/36 = 2.5 → 3 (round half up)
+        expect(offsetToIndex(9999, 36, 6)).toBe(5); // clamp to last
+        expect(offsetToIndex(-50, 36, 6)).toBe(0); // clamp to first
+    });
+    it('indexToOffset centers an index', () => {
+        expect(indexToOffset(0, 36)).toBe(0);
+        expect(indexToOffset(3, 36)).toBe(108);
+    });
+    it('handles degenerate inputs', () => {
+        expect(offsetToIndex(10, 0, 6)).toBe(0);
+        expect(offsetToIndex(10, 36, 0)).toBe(0);
+    });
+});
+describe('indexOfValue', () => {
+    it('finds the index of a value', () => {
+        expect(indexOfValue(items, 3)).toBe(3);
+        expect(indexOfValue(items, 99)).toBe(-1);
+        expect(indexOfValue(items, undefined)).toBe(-1);
+    });
+});
+describe('enabled-index navigation (skips disabled)', () => {
+    it('nextEnabledIndex skips disabled in both directions', () => {
+        expect(nextEnabledIndex(items, 0, 1)).toBe(2); // skip disabled 1
+        expect(nextEnabledIndex(items, 3, 1)).toBe(5); // skip disabled 4
+        expect(nextEnabledIndex(items, 2, -1)).toBe(0); // skip disabled 1
+    });
+    it('returns the same index at a boundary', () => {
+        expect(nextEnabledIndex(items, 5, 1)).toBe(5); // no enabled after
+        expect(nextEnabledIndex(items, 0, -1)).toBe(0); // no enabled before
+    });
+    it('first/last enabled', () => {
+        expect(firstEnabledIndex(items)).toBe(0);
+        expect(lastEnabledIndex(items)).toBe(5);
+        expect(firstEnabledIndex([{ value: 'x', label: 'x', disabled: true }])).toBe(-1);
+    });
+});
+describe('keyboardTarget', () => {
+    it('ArrowUp/Down skip disabled', () => {
+        expect(keyboardTarget(items, 0, 'ArrowDown')).toBe(2);
+        expect(keyboardTarget(items, 2, 'ArrowUp')).toBe(0);
+    });
+    it('Home/End jump to first/last enabled', () => {
+        expect(keyboardTarget(items, 3, 'Home')).toBe(0);
+        expect(keyboardTarget(items, 0, 'End')).toBe(5);
+    });
+    it('PageDown moves up to `page` enabled rows, stopping at boundary', () => {
+        // from 0, page 3, enabled order: 0→2→3→5 ; 3 steps → 5
+        expect(keyboardTarget(items, 0, 'PageDown', 3)).toBe(5);
+        // from 0, page 2 → 0→2→3 → index 3
+        expect(keyboardTarget(items, 0, 'PageDown', 2)).toBe(3);
+    });
+    it('PageUp stops at the first enabled', () => {
+        expect(keyboardTarget(items, 5, 'PageUp', 10)).toBe(0);
+    });
+});
+describe('cyclic 循环索引', () => {
+    it('wrapIndex 正取模折回 [0,count)', () => {
+        expect(wrapIndex(0, 24)).toBe(0);
+        expect(wrapIndex(24, 24)).toBe(0);
+        expect(wrapIndex(25, 24)).toBe(1);
+        expect(wrapIndex(-1, 24)).toBe(23);
+        expect(wrapIndex(-25, 24)).toBe(23);
+        expect(wrapIndex(5, 0)).toBe(0);
+    });
+    it('cyclicVirtualCount 重复奇数份', () => {
+        expect(cyclicVirtualCount(24, 5)).toBe(120);
+        expect(cyclicVirtualCount(24, 4)).toBe(120); // 4 |1 = 5
+        expect(cyclicVirtualCount(24, 1)).toBe(72); // min 3
+        expect(cyclicVirtualCount(0, 5)).toBe(0);
+    });
+    it('cyclicCenterIndex 映射到中段', () => {
+        // count=24, repeat=5 → mid=2 → 中段从 48 起
+        expect(cyclicCenterIndex(9, 24, 5)).toBe(57);
+        expect(cyclicCenterIndex(0, 24, 5)).toBe(48);
+        expect(cyclicCenterIndex(24 + 9, 24, 5)).toBe(57); // 同余
+    });
+    it('cyclicRecenter 仅在边界外重定位', () => {
+        // total=120, 安全区 [24,96)
+        expect(cyclicRecenter(57, 24, 5)).toBe(57); // 区内不动
+        expect(cyclicRecenter(10, 24, 5)).toBe(cyclicCenterIndex(10, 24, 5)); // 越下界
+        expect(cyclicRecenter(100, 24, 5)).toBe(cyclicCenterIndex(wrapIndex(100, 24), 24, 5));
+        // 重定位后必同余
+        expect(wrapIndex(cyclicRecenter(5, 24, 5), 24)).toBe(5);
+    });
+});
+describe('惯性物理 momentum', () => {
+    it('momentumStep 按帧指数衰减且方向不变', () => {
+        const s = momentumStep(1, 16.67, 0.95, 0.02);
+        expect(s.velocity).toBeLessThan(1);
+        expect(s.velocity).toBeGreaterThan(0);
+        expect(s.delta).toBeGreaterThan(0);
+        expect(s.done).toBe(false);
+    });
+    it('momentumStep 低于阈值标记 done', () => {
+        const s = momentumStep(0.01, 16.67, 0.95, 0.02);
+        expect(s.done).toBe(true);
+    });
+    it('momentumStep 负速度（向上）位移为负', () => {
+        const s = momentumStep(-1, 16.67);
+        expect(s.delta).toBeLessThan(0);
+        expect(s.velocity).toBeGreaterThan(-1);
+    });
+    it('momentumStep 连续推进速度单调收敛到 0', () => {
+        let v = 2;
+        for (let i = 0; i < 200; i += 1)
+            v = momentumStep(v, 16.67).velocity;
+        expect(Math.abs(v)).toBeLessThan(0.02);
+    });
+    it('projectSettleIndex 含速度前瞻并 clamp', () => {
+        // scrollTop 0，速度 0 → 行 0
+        expect(projectSettleIndex(0, 0, 36, 24)).toBe(0);
+        // scrollTop=360（行10），向下速度前瞻 80px：(360+80)/36≈12.2 → round 12
+        expect(projectSettleIndex(360, 1, 36, 24, 80)).toBe(12);
+        // clamp 到末行
+        expect(projectSettleIndex(99999, 5, 36, 24)).toBe(23);
+        // clamp 到首行
+        expect(projectSettleIndex(0, -5, 36, 24)).toBe(0);
+        expect(projectSettleIndex(0, 0, 0, 24)).toBe(0);
+    });
+});
+//# sourceMappingURL=scroll-list.test.js.map

package/dist/scroll-list.test.js.map

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

package/dist/scroll-lock.d.ts

@@ -0,0 +1,11 @@
+/**
+ * useScrollLock — lock body scroll while an overlay (Modal/Drawer) is open.
+ * Compensates for the scrollbar width to avoid layout shift. Reference-counted
+ * so nested/stacked overlays don't unlock prematurely. Call the returned
+ * function to release. No framework deps; client-only (guards window/document).
+ * See specs/components/feedback/Modal.spec.md §6.
+ */
+export declare function useScrollLock(): () => void;
+/** test-only reset of the internal counter */
+export declare function __resetScrollLock(): void;
+//# sourceMappingURL=scroll-lock.d.ts.map

package/dist/scroll-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-lock.d.ts","sourceRoot":"","sources":["../src/scroll-lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,wBAAgB,aAAa,IAAI,MAAM,IAAI,CA4B1C;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}

package/dist/scroll-lock.js

@@ -0,0 +1,45 @@
+/**
+ * useScrollLock — lock body scroll while an overlay (Modal/Drawer) is open.
+ * Compensates for the scrollbar width to avoid layout shift. Reference-counted
+ * so nested/stacked overlays don't unlock prematurely. Call the returned
+ * function to release. No framework deps; client-only (guards window/document).
+ * See specs/components/feedback/Modal.spec.md §6.
+ */
+let lockCount = 0;
+let savedOverflow = '';
+let savedPaddingRight = '';
+export function useScrollLock() {
+    if (typeof document === 'undefined')
+        return () => { };
+    const body = document.body;
+    if (lockCount === 0) {
+        savedOverflow = body.style.overflow;
+        savedPaddingRight = body.style.paddingRight;
+        // scrollbar-width compensation so content doesn't jump
+        const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
+        if (scrollbarWidth > 0) {
+            const current = parseFloat(window.getComputedStyle(body).paddingRight) || 0;
+            body.style.paddingRight = `${current + scrollbarWidth}px`;
+        }
+        body.style.overflow = 'hidden';
+    }
+    lockCount += 1;
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        lockCount = Math.max(0, lockCount - 1);
+        if (lockCount === 0) {
+            body.style.overflow = savedOverflow;
+            body.style.paddingRight = savedPaddingRight;
+        }
+    };
+}
+/** test-only reset of the internal counter */
+export function __resetScrollLock() {
+    lockCount = 0;
+    savedOverflow = '';
+    savedPaddingRight = '';
+}
+//# sourceMappingURL=scroll-lock.js.map

package/dist/scroll-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-lock.js","sourceRoot":"","sources":["../src/scroll-lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,IAAI,SAAS,GAAG,CAAC,CAAC;AAClB,IAAI,aAAa,GAAG,EAAE,CAAC;AACvB,IAAI,iBAAiB,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAE3B,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;QAC5C,uDAAuD;QACvD,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC;QAChF,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5E,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,OAAO,GAAG,cAAc,IAAI,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACjC,CAAC;IACD,SAAS,IAAI,CAAC,CAAC;IAEf,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,aAAa,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,iBAAiB,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB;IAC/B,SAAS,GAAG,CAAC,CAAC;IACd,aAAa,GAAG,EAAE,CAAC;IACnB,iBAAiB,GAAG,EAAE,CAAC;AACzB,CAAC"}

package/dist/scroll-lock.test.d.ts

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

package/dist/scroll-lock.test.d.ts.map

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

package/dist/scroll-lock.test.js

@@ -0,0 +1,55 @@
+import { describe, expect, it, beforeEach, afterEach, vi } from 'vitest';
+import { useScrollLock, __resetScrollLock } from './scroll-lock.js';
+// node test env has no DOM; stub the minimal document/window surface useScrollLock touches.
+function makeDom() {
+    const body = { style: { overflow: '', paddingRight: '' } };
+    return {
+        document: {
+            body,
+            documentElement: { clientWidth: 1000 },
+        },
+        window: {
+            innerWidth: 1000, // == clientWidth → no scrollbar compensation
+            getComputedStyle: () => ({ paddingRight: '0px' }),
+        },
+    };
+}
+describe('useScrollLock', () => {
+    let dom;
+    beforeEach(() => {
+        __resetScrollLock();
+        dom = makeDom();
+        vi.stubGlobal('document', dom.document);
+        vi.stubGlobal('window', dom.window);
+    });
+    afterEach(() => vi.unstubAllGlobals());
+    it('locks body overflow and releases it', () => {
+        const release = useScrollLock();
+        expect(dom.document.body.style.overflow).toBe('hidden');
+        release();
+        expect(dom.document.body.style.overflow).toBe('');
+    });
+    it('is reference-counted: nested locks unlock only at zero', () => {
+        const r1 = useScrollLock();
+        const r2 = useScrollLock();
+        expect(dom.document.body.style.overflow).toBe('hidden');
+        r1();
+        expect(dom.document.body.style.overflow).toBe('hidden'); // still held by r2
+        r2();
+        expect(dom.document.body.style.overflow).toBe('');
+    });
+    it('release is idempotent', () => {
+        const release = useScrollLock();
+        release();
+        release(); // no throw, no double-decrement
+        expect(dom.document.body.style.overflow).toBe('');
+    });
+    it('restores the original overflow value', () => {
+        dom.document.body.style.overflow = 'scroll';
+        const release = useScrollLock();
+        expect(dom.document.body.style.overflow).toBe('hidden');
+        release();
+        expect(dom.document.body.style.overflow).toBe('scroll');
+    });
+});
+//# sourceMappingURL=scroll-lock.test.js.map

package/dist/scroll-lock.test.js.map

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

package/dist/sider.d.ts

@@ -0,0 +1,26 @@
+import { type Breakpoint } from './breakpoints.js';
+export type SiderTrigger = 'click' | 'breakpoint';
+export type { Breakpoint };
+export interface SiderOptions {
+    /** controlled collapsed value; when provided, internal state is not mutated */
+    collapsed?: boolean;
+    defaultCollapsed?: boolean;
+    /** auto-collapse below this breakpoint */
+    breakpoint?: Breakpoint;
+    onChange?: (collapsed: boolean, trigger: SiderTrigger) => void;
+    onBreakpoint?: (matched: boolean, breakpoint: Breakpoint) => void;
+}
+export interface SiderApi {
+    /** stable id for aria-controls */
+    readonly id: string;
+    /** current collapsed state */
+    getCollapsed(): boolean;
+    /** subscribe to collapsed changes; returns unsubscribe */
+    subscribe(listener: (collapsed: boolean) => void): () => void;
+    toggle(): void;
+    setCollapsed(value: boolean, trigger?: SiderTrigger): void;
+    /** start matchMedia breakpoint watching (call on mount). no-op without breakpoint. */
+    watchBreakpoint(): () => void;
+}
+export declare function createSider(options?: SiderOptions): SiderApi;
+//# sourceMappingURL=sider.d.ts.map

package/dist/sider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sider.d.ts","sourceRoot":"","sources":["../src/sider.ts"],"names":[],"mappings":"AAMA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,IAAI,OAAO,CAAC;IACxB,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9D,MAAM,IAAI,IAAI,CAAC;IACf,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3D,sFAAsF;IACtF,eAAe,IAAI,MAAM,IAAI,CAAC;CAC/B;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,YAAiB,GAAG,QAAQ,CAsDhE"}

package/dist/sider.js

@@ -0,0 +1,55 @@
+/**
+ * createSider — framework-agnostic collapse state machine for Layout.Sider.
+ * Handles controlled/uncontrolled collapse + optional breakpoint matchMedia.
+ * No DOM rendering, no framework deps. See specs/components/basic/Layout.spec.md.
+ */
+import { useId } from './id.js';
+import { BREAKPOINTS } from './breakpoints.js';
+export function createSider(options = {}) {
+    const { collapsed: controlled, defaultCollapsed = false, breakpoint, onChange, onBreakpoint, } = options;
+    const isControlled = controlled !== undefined;
+    let internal = isControlled ? controlled : defaultCollapsed;
+    const listeners = new Set();
+    function current() {
+        return isControlled ? controlled : internal;
+    }
+    function emit() {
+        for (const l of listeners)
+            l(current());
+    }
+    function setCollapsed(value, trigger = 'click') {
+        if (!isControlled) {
+            if (internal === value)
+                return;
+            internal = value;
+            emit();
+        }
+        onChange?.(value, trigger);
+    }
+    return {
+        id: useId('cd-sider'),
+        getCollapsed: current,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        toggle() {
+            setCollapsed(!current(), 'click');
+        },
+        setCollapsed,
+        watchBreakpoint() {
+            if (!breakpoint || typeof window === 'undefined' || !window.matchMedia) {
+                return () => { };
+            }
+            const mql = window.matchMedia(`(max-width: ${BREAKPOINTS[breakpoint] - 0.02}px)`);
+            const handle = (e) => {
+                onBreakpoint?.(e.matches, breakpoint);
+                setCollapsed(e.matches, 'breakpoint');
+            };
+            handle(mql);
+            mql.addEventListener('change', handle);
+            return () => mql.removeEventListener('change', handle);
+        },
+    };
+}
+//# sourceMappingURL=sider.js.map

package/dist/sider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sider.js","sourceRoot":"","sources":["../src/sider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAmB,MAAM,kBAAkB,CAAC;AA4BhE,MAAM,UAAU,WAAW,CAAC,UAAwB,EAAE;IACpD,MAAM,EACJ,SAAS,EAAE,UAAU,EACrB,gBAAgB,GAAG,KAAK,EACxB,UAAU,EACV,QAAQ,EACR,YAAY,GACb,GAAG,OAAO,CAAC;IAEZ,MAAM,YAAY,GAAG,UAAU,KAAK,SAAS,CAAC;IAC9C,IAAI,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC5D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE1D,SAAS,OAAO;QACd,OAAO,YAAY,CAAC,CAAC,CAAE,UAAsB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3D,CAAC;IACD,SAAS,IAAI;QACX,KAAK,MAAM,CAAC,IAAI,SAAS;YAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,SAAS,YAAY,CAAC,KAAc,EAAE,UAAwB,OAAO;QACnE,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,QAAQ,KAAK,KAAK;gBAAE,OAAO;YAC/B,QAAQ,GAAG,KAAK,CAAC;YACjB,IAAI,EAAE,CAAC;QACT,CAAC;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC;QACrB,YAAY,EAAE,OAAO;QACrB,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM;YACJ,YAAY,CAAC,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,YAAY;QACZ,eAAe;YACb,IAAI,CAAC,UAAU,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACvE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,eAAe,WAAW,CAAC,UAAU,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;YAClF,MAAM,MAAM,GAAG,CAAC,CAAuC,EAAQ,EAAE;gBAC/D,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBACtC,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YACxC,CAAC,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,CAAC;YACZ,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvC,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sider.test.d.ts

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

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

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

package/dist/sider.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it, vi } from 'vitest';
+import { createSider } from './sider.js';
+describe('createSider', () => {
+    it('uncontrolled: toggles and notifies subscribers', () => {
+        const s = createSider({ defaultCollapsed: false });
+        const seen = [];
+        s.subscribe((c) => seen.push(c));
+        expect(s.getCollapsed()).toBe(false);
+        s.toggle();
+        expect(s.getCollapsed()).toBe(true);
+        expect(seen).toEqual([true]);
+    });
+    it('controlled: does not mutate internal, still fires onChange', () => {
+        const onChange = vi.fn();
+        const s = createSider({ collapsed: false, onChange });
+        s.toggle();
+        expect(s.getCollapsed()).toBe(false); // unchanged (controlled)
+        expect(onChange).toHaveBeenCalledWith(true, 'click');
+    });
+    it('exposes a stable id for aria-controls', () => {
+        const s = createSider();
+        expect(s.id).toMatch(/^cd-sider-/);
+    });
+    it('watchBreakpoint is a no-op without a breakpoint', () => {
+        const s = createSider();
+        expect(typeof s.watchBreakpoint()).toBe('function');
+    });
+});
+//# sourceMappingURL=sider.test.js.map

package/dist/sider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sider.test.js","sourceRoot":"","sources":["../src/sider.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,yBAAyB;QAC/D,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC;QACxB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC;QACxB,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/spin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * createSpinController — framework-agnostic loading-state debouncer for Spin.
+ * Handles `delay` (wait before showing, to avoid flicker on fast requests) and
+ * `minShowTime` (keep showing at least this long once shown). Uses timers only;
+ * SSR-safe because the consumer starts it in a client effect. No DOM, no
+ * framework deps. See specs/components/feedback/Spin.spec.md §3.
+ */
+export interface SpinOptions {
+    delay?: number;
+    minShowTime?: number;
+    /** initial spinning request */
+    spinning?: boolean;
+}
+export interface SpinController {
+    /** the debounced, effective visibility — what the render layer should show */
+    getEffective(): boolean;
+    /** subscribe to effective-visibility changes; returns unsubscribe */
+    subscribe(listener: (effective: boolean) => void): () => void;
+    /** push a new spinning request (controlled by the host) */
+    setSpinning(value: boolean): void;
+    /** clear timers (call on unmount) */
+    destroy(): void;
+}
+export declare function createSpinController(options?: SpinOptions): SpinController;
+//# sourceMappingURL=spin.d.ts.map