@chenzy-design/core 0.1.0

package/dist/inert-background.js

@@ -0,0 +1,92 @@
+/**
+ * useInertBackground — hide page content behind a modal overlay from assistive
+ * tech and pointer/keyboard interaction while the overlay is open.
+ *
+ * Pass the overlay's portal root (the element appended to body/getContainer).
+ * Every *sibling* of that root (the rest of the page, plus any overlay opened
+ * earlier) is marked `inert` + `aria-hidden="true"`; on release the originals
+ * are restored. See specs/components/feedback/Modal.spec.md §6 ("背景内容对 SR
+ * aria-hidden/inert").
+ *
+ * Stacked overlays: a module-level stack tracks every active overlay root. Only
+ * the *topmost* (most recently activated) overlay drives the inert set — its
+ * siblings (including lower overlays) get hidden, while the topmost overlay
+ * itself stays interactive. When it releases, the previous overlay re-applies.
+ * This keeps nested Modal/Drawer/SideSheet correct without inerting the layer
+ * the user is currently working in.
+ *
+ * No framework deps; client-only (guards document). Returned function releases.
+ */
+const INERT_MARK = 'data-cd-inert-bg';
+// Active overlay roots, in activation order. Last = topmost.
+const stack = [];
+// Elements we marked, with the attribute values to restore on release.
+// We toggle the `inert` *attribute* (not the IDL property) so it reflects
+// consistently across browsers and SSR-ish DOM impls.
+let hidden = [];
+function clearHidden() {
+    for (const { el, prevInert, prevAriaHidden } of hidden) {
+        if (prevInert)
+            el.setAttribute('inert', '');
+        else
+            el.removeAttribute('inert');
+        if (prevAriaHidden === null)
+            el.removeAttribute('aria-hidden');
+        else
+            el.setAttribute('aria-hidden', prevAriaHidden);
+    }
+    hidden = [];
+}
+function apply() {
+    // Restore whatever the previous topmost overlay hid, then re-hide for the new
+    // topmost. Simpler and correct than diffing when the active root changes.
+    clearHidden();
+    const top = stack[stack.length - 1];
+    if (!top || !top.parentNode)
+        return;
+    const parent = top.parentNode;
+    for (const node of Array.from(parent.childNodes)) {
+        if (!(node instanceof HTMLElement))
+            continue;
+        if (node === top)
+            continue;
+        // Never inert another active overlay root that sits above us — but since we
+        // always hide for the *topmost*, every other root here is below `top`, so
+        // hiding them is what we want.
+        hidden.push({
+            el: node,
+            prevInert: node.hasAttribute('inert'),
+            prevAriaHidden: node.getAttribute('aria-hidden'),
+        });
+        node.setAttribute('inert', '');
+        node.setAttribute('aria-hidden', 'true');
+    }
+}
+/**
+ * Mark `root`'s siblings inert/aria-hidden. `root` should be the overlay's
+ * portal root element. Returns a release function (idempotent).
+ */
+export function useInertBackground(root) {
+    if (typeof document === 'undefined' || !root)
+        return () => { };
+    root.setAttribute(INERT_MARK, '');
+    stack.push(root);
+    apply();
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        const i = stack.indexOf(root);
+        if (i !== -1)
+            stack.splice(i, 1);
+        root.removeAttribute(INERT_MARK);
+        apply();
+    };
+}
+/** test-only reset of internal state */
+export function __resetInertBackground() {
+    clearHidden();
+    stack.length = 0;
+}
+//# sourceMappingURL=inert-background.js.map

package/dist/inert-background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inert-background.js","sourceRoot":"","sources":["../src/inert-background.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC,6DAA6D;AAC7D,MAAM,KAAK,GAAkB,EAAE,CAAC;AAChC,uEAAuE;AACvE,0EAA0E;AAC1E,sDAAsD;AACtD,IAAI,MAAM,GAIL,EAAE,CAAC;AAER,SAAS,WAAW;IAClB,KAAK,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,MAAM,EAAE,CAAC;QACvD,IAAI,SAAS;YAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;;YACvC,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,cAAc,KAAK,IAAI;YAAE,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;;YAC1D,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,GAAG,EAAE,CAAC;AACd,CAAC;AAED,SAAS,KAAK;IACZ,8EAA8E;IAC9E,0EAA0E;IAC1E,WAAW,EAAE,CAAC;IACd,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU;QAAE,OAAO;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,IAAI,YAAY,WAAW,CAAC;YAAE,SAAS;QAC7C,IAAI,IAAI,KAAK,GAAG;YAAE,SAAS;QAC3B,4EAA4E;QAC5E,0EAA0E;QAC1E,+BAA+B;QAC/B,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,IAAI;YACR,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;YACrC,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAiB;IAClD,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAE9D,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,EAAE,CAAC;IAER,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,GAAG,EAAE;QACV,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjC,KAAK,EAAE,CAAC;IACV,CAAC,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,sBAAsB;IACpC,WAAW,EAAE,CAAC;IACd,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/inert-background.test.d.ts

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

package/dist/inert-background.test.d.ts.map

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

package/dist/inert-background.test.js

@@ -0,0 +1,62 @@
+// @vitest-environment jsdom
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { useInertBackground, __resetInertBackground, } from './inert-background.js';
+let page;
+let overlayA;
+beforeEach(() => {
+    document.body.innerHTML = '';
+    page = document.createElement('div');
+    page.id = 'page';
+    overlayA = document.createElement('div');
+    overlayA.id = 'overlay-a';
+    document.body.append(page, overlayA);
+});
+afterEach(() => {
+    __resetInertBackground();
+    document.body.innerHTML = '';
+});
+describe('useInertBackground', () => {
+    it('hides siblings of the overlay root and restores on release', () => {
+        const release = useInertBackground(overlayA);
+        expect(page.getAttribute('aria-hidden')).toBe('true');
+        expect(page.hasAttribute('inert')).toBe(true);
+        // the overlay root itself stays interactive
+        expect(overlayA.getAttribute('aria-hidden')).toBeNull();
+        expect(overlayA.hasAttribute('inert')).toBe(false);
+        release();
+        expect(page.getAttribute('aria-hidden')).toBeNull();
+        expect(page.hasAttribute('inert')).toBe(false);
+    });
+    it('release is idempotent', () => {
+        const release = useInertBackground(overlayA);
+        release();
+        release();
+        expect(page.getAttribute('aria-hidden')).toBeNull();
+    });
+    it('restores a pre-existing aria-hidden value', () => {
+        page.setAttribute('aria-hidden', 'false');
+        const release = useInertBackground(overlayA);
+        expect(page.getAttribute('aria-hidden')).toBe('true');
+        release();
+        expect(page.getAttribute('aria-hidden')).toBe('false');
+    });
+    it('stacked overlays: topmost hides lower overlay, keeps itself interactive', () => {
+        const overlayB = document.createElement('div');
+        overlayB.id = 'overlay-b';
+        document.body.appendChild(overlayB);
+        const releaseA = useInertBackground(overlayA);
+        expect(page.hasAttribute('inert')).toBe(true);
+        // B opens on top → page AND overlayA become inert; B stays interactive.
+        const releaseB = useInertBackground(overlayB);
+        expect(page.hasAttribute('inert')).toBe(true);
+        expect(overlayA.hasAttribute('inert')).toBe(true);
+        expect(overlayB.hasAttribute('inert')).toBe(false);
+        // B closes → A is topmost again: page inert, A interactive.
+        releaseB();
+        expect(page.hasAttribute('inert')).toBe(true);
+        expect(overlayA.hasAttribute('inert')).toBe(false);
+        releaseA();
+        expect(page.hasAttribute('inert')).toBe(false);
+    });
+});
+//# sourceMappingURL=inert-background.test.js.map

package/dist/inert-background.test.js.map

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

package/dist/input-number.d.ts

@@ -0,0 +1,34 @@
+/**
+ * createInputNumber helpers — framework-agnostic numeric primitives for InputNumber.
+ * Pure functions only (clamp/boundaryMode, precision round, float-safe step,
+ * locale-aware default formatting). The svelte layer owns DOM, listeners and
+ * the editing-text state machine; it delegates the math here so it stays testable.
+ * See specs/components/input/InputNumber.spec.md §3.
+ */
+/** Boundary handling: 'clamp' pins to [min,max]; 'strict' rejects out-of-range. */
+export type BoundaryMode = 'clamp' | 'strict';
+/**
+ * clampWithMode — apply min/max according to boundaryMode.
+ * - 'clamp': returns the value pinned into [min,max].
+ * - 'strict': returns null when `n` lies outside [min,max] (caller rolls back).
+ */
+export declare function clampWithMode(n: number, min: number, max: number, mode?: BoundaryMode): number | null;
+/** Which boundary (if any) `n` touches/exceeds given [min,max]. */
+export declare function boundaryHitOf(n: number, min: number, max: number): 'min' | 'max' | null;
+/** round `n` to `precision` decimal places (undefined → unchanged). */
+export declare function roundToPrecision(n: number, precision?: number): number;
+/** count of decimal places in a number's default string form. */
+export declare function decimalsOf(n: number): number;
+/**
+ * addStep — float-safe addition using integer scaling, avoiding 0.1+0.2 drift.
+ */
+export declare function addStep(base: number, delta: number): number;
+/**
+ * formatWithLocale — default display string for a value using Intl.NumberFormat,
+ * cached per (locale, options). Used only when a `locale` is supplied and no
+ * custom formatter is given; otherwise the svelte layer keeps `String(n)`.
+ */
+export declare function formatWithLocale(n: number, locale: string, options?: Intl.NumberFormatOptions): string;
+/** reset the Intl format cache (test determinism). */
+export declare function __resetNumberFormatCache(): void;
+//# sourceMappingURL=input-number.d.ts.map

package/dist/input-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-number.d.ts","sourceRoot":"","sources":["../src/input-number.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,YAAsB,GAC3B,MAAM,GAAG,IAAI,CAMf;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAIvF;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAItE;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI3D;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GACjC,MAAM,CAQR;AAED,sDAAsD;AACtD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/input-number.js

@@ -0,0 +1,69 @@
+/**
+ * createInputNumber helpers — framework-agnostic numeric primitives for InputNumber.
+ * Pure functions only (clamp/boundaryMode, precision round, float-safe step,
+ * locale-aware default formatting). The svelte layer owns DOM, listeners and
+ * the editing-text state machine; it delegates the math here so it stays testable.
+ * See specs/components/input/InputNumber.spec.md §3.
+ */
+/**
+ * clampWithMode — apply min/max according to boundaryMode.
+ * - 'clamp': returns the value pinned into [min,max].
+ * - 'strict': returns null when `n` lies outside [min,max] (caller rolls back).
+ */
+export function clampWithMode(n, min, max, mode = 'clamp') {
+    if (mode === 'strict') {
+        if (n < min || n > max)
+            return null;
+        return n;
+    }
+    return Math.min(max, Math.max(min, n));
+}
+/** Which boundary (if any) `n` touches/exceeds given [min,max]. */
+export function boundaryHitOf(n, min, max) {
+    if (n <= min && Number.isFinite(min))
+        return 'min';
+    if (n >= max && Number.isFinite(max))
+        return 'max';
+    return null;
+}
+/** round `n` to `precision` decimal places (undefined → unchanged). */
+export function roundToPrecision(n, precision) {
+    if (precision === undefined)
+        return n;
+    const factor = 10 ** precision;
+    return Math.round(n * factor) / factor;
+}
+/** count of decimal places in a number's default string form. */
+export function decimalsOf(n) {
+    const s = String(n);
+    const dot = s.indexOf('.');
+    return dot === -1 ? 0 : s.length - dot - 1;
+}
+/**
+ * addStep — float-safe addition using integer scaling, avoiding 0.1+0.2 drift.
+ */
+export function addStep(base, delta) {
+    const decimals = Math.max(decimalsOf(base), decimalsOf(delta));
+    const factor = 10 ** decimals;
+    return (Math.round(base * factor) + Math.round(delta * factor)) / factor;
+}
+const numberFormatCache = new Map();
+/**
+ * formatWithLocale — default display string for a value using Intl.NumberFormat,
+ * cached per (locale, options). Used only when a `locale` is supplied and no
+ * custom formatter is given; otherwise the svelte layer keeps `String(n)`.
+ */
+export function formatWithLocale(n, locale, options) {
+    const key = `${locale}|${JSON.stringify(options ?? {})}`;
+    let fmt = numberFormatCache.get(key);
+    if (!fmt) {
+        fmt = new Intl.NumberFormat(locale, options);
+        numberFormatCache.set(key, fmt);
+    }
+    return fmt.format(n);
+}
+/** reset the Intl format cache (test determinism). */
+export function __resetNumberFormatCache() {
+    numberFormatCache.clear();
+}
+//# sourceMappingURL=input-number.js.map

package/dist/input-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-number.js","sourceRoot":"","sources":["../src/input-number.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,CAAS,EACT,GAAW,EACX,GAAW,EACX,OAAqB,OAAO;IAE5B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW;IAC/D,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,CAAS,EAAE,SAAkB;IAC5D,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,IAAI,SAAS,CAAC;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AACzC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAa;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC;AAC3E,CAAC;AAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,CAAS,EACT,MAAc,EACd,OAAkC;IAElC,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IACzD,IAAI,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC7C,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,wBAAwB;IACtC,iBAAiB,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/input-number.test.d.ts

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

package/dist/input-number.test.d.ts.map

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

package/dist/input-number.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { clampWithMode, boundaryHitOf, roundToPrecision, decimalsOfNumber, addNumberStep, formatWithLocale, __resetNumberFormatCache, } from './index.js';
+describe('clampWithMode', () => {
+    it('clamp mode pins into range', () => {
+        expect(clampWithMode(15, 0, 10, 'clamp')).toBe(10);
+        expect(clampWithMode(-5, 0, 10, 'clamp')).toBe(0);
+        expect(clampWithMode(5, 0, 10, 'clamp')).toBe(5);
+    });
+    it('clamp is the default mode', () => {
+        expect(clampWithMode(99, 0, 10)).toBe(10);
+    });
+    it('strict mode returns null when out of range', () => {
+        expect(clampWithMode(15, 0, 10, 'strict')).toBeNull();
+        expect(clampWithMode(-1, 0, 10, 'strict')).toBeNull();
+    });
+    it('strict mode keeps in-range value', () => {
+        expect(clampWithMode(5, 0, 10, 'strict')).toBe(5);
+        expect(clampWithMode(0, 0, 10, 'strict')).toBe(0);
+        expect(clampWithMode(10, 0, 10, 'strict')).toBe(10);
+    });
+});
+describe('boundaryHitOf', () => {
+    it('detects min/max touches', () => {
+        expect(boundaryHitOf(0, 0, 10)).toBe('min');
+        expect(boundaryHitOf(10, 0, 10)).toBe('max');
+        expect(boundaryHitOf(5, 0, 10)).toBeNull();
+    });
+    it('ignores infinite bounds', () => {
+        expect(boundaryHitOf(-1e9, -Infinity, Infinity)).toBeNull();
+        expect(boundaryHitOf(1e9, -Infinity, Infinity)).toBeNull();
+    });
+});
+describe('roundToPrecision', () => {
+    it('rounds to given decimals', () => {
+        expect(roundToPrecision(1.2345, 2)).toBe(1.23);
+        expect(roundToPrecision(1.235, 2)).toBe(1.24);
+    });
+    it('passes through when precision undefined', () => {
+        expect(roundToPrecision(1.2345)).toBe(1.2345);
+    });
+});
+describe('decimalsOfNumber', () => {
+    it('counts decimals', () => {
+        expect(decimalsOfNumber(1)).toBe(0);
+        expect(decimalsOfNumber(1.5)).toBe(1);
+        expect(decimalsOfNumber(0.001)).toBe(3);
+    });
+});
+describe('addNumberStep', () => {
+    it('avoids float drift', () => {
+        expect(addNumberStep(0.1, 0.2)).toBe(0.3);
+        expect(addNumberStep(0.3, -0.1)).toBe(0.2);
+    });
+    it('handles integers', () => {
+        expect(addNumberStep(5, 1)).toBe(6);
+        expect(addNumberStep(5, -10)).toBe(-5);
+    });
+});
+describe('formatWithLocale', () => {
+    beforeEach(() => __resetNumberFormatCache());
+    it('formats with grouping per locale', () => {
+        expect(formatWithLocale(1234567, 'en-US')).toBe('1,234,567');
+    });
+    it('honors options', () => {
+        expect(formatWithLocale(0.5, 'en-US', { style: 'percent' })).toBe('50%');
+    });
+    it('caches instances per (locale, options)', () => {
+        const a = formatWithLocale(1, 'en-US');
+        const b = formatWithLocale(2, 'en-US');
+        expect(a).toBe('1');
+        expect(b).toBe('2');
+    });
+});
+//# sourceMappingURL=input-number.test.js.map

package/dist/input-number.test.js.map

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

package/dist/list-selection.d.ts

@@ -0,0 +1,38 @@
+/**
+ * List selection state — framework-agnostic, pure functions.
+ * Toggling / range-selecting row keys for a selectable List. No DOM, no
+ * framework deps, no mutable module state — the render layer owns the controlled
+ * `selectedKeys` and only feeds the next set to `onSelectionChange`.
+ * See specs/components/show/List.spec.md.
+ */
+export type ListKey = string | number;
+export type SelectionMode = 'single' | 'multiple';
+/**
+ * Compute the next selected-key set after clicking row `key`.
+ *
+ * - `single`: clicking an unselected row selects only it; clicking the already
+ *   selected row clears the selection (toggle).
+ * - `multiple`: clicking toggles `key`'s membership, preserving the rest.
+ *
+ * Pure: returns a brand new Set; never mutates `current`.
+ *
+ * @param current  the current selected-key set (controlled value)
+ * @param key      the row key being toggled
+ * @param mode     'single' | 'multiple'
+ */
+export declare function toggleSelection(current: ReadonlySet<ListKey>, key: ListKey, mode: SelectionMode): Set<ListKey>;
+/**
+ * Compute the next selected-key set for a shift range-select between the anchor
+ * row and the just-clicked row (multiple mode only). All keys in the inclusive
+ * index range [min(anchor, target), max(anchor, target)] are added to the
+ * current selection.
+ *
+ * Pure: returns a brand new Set; never mutates `current`.
+ *
+ * @param current     the current selected-key set
+ * @param orderedKeys the full ordered list of row keys (index = row position)
+ * @param anchorIndex the index of the last single-clicked (anchor) row
+ * @param targetIndex the index of the shift-clicked row
+ */
+export declare function rangeSelection(current: ReadonlySet<ListKey>, orderedKeys: readonly ListKey[], anchorIndex: number, targetIndex: number): Set<ListKey>;
+//# sourceMappingURL=list-selection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-selection.d.ts","sourceRoot":"","sources":["../src/list-selection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAC7B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,aAAa,GAClB,GAAG,CAAC,OAAO,CAAC,CAUd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAC7B,WAAW,EAAE,SAAS,OAAO,EAAE,EAC/B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,GAAG,CAAC,OAAO,CAAC,CAUd"}

package/dist/list-selection.js

@@ -0,0 +1,61 @@
+/**
+ * List selection state — framework-agnostic, pure functions.
+ * Toggling / range-selecting row keys for a selectable List. No DOM, no
+ * framework deps, no mutable module state — the render layer owns the controlled
+ * `selectedKeys` and only feeds the next set to `onSelectionChange`.
+ * See specs/components/show/List.spec.md.
+ */
+/**
+ * Compute the next selected-key set after clicking row `key`.
+ *
+ * - `single`: clicking an unselected row selects only it; clicking the already
+ *   selected row clears the selection (toggle).
+ * - `multiple`: clicking toggles `key`'s membership, preserving the rest.
+ *
+ * Pure: returns a brand new Set; never mutates `current`.
+ *
+ * @param current  the current selected-key set (controlled value)
+ * @param key      the row key being toggled
+ * @param mode     'single' | 'multiple'
+ */
+export function toggleSelection(current, key, mode) {
+    if (mode === 'single') {
+        // Toggle: re-clicking the sole selected row clears it.
+        if (current.has(key) && current.size === 1)
+            return new Set();
+        return new Set([key]);
+    }
+    const next = new Set(current);
+    if (next.has(key))
+        next.delete(key);
+    else
+        next.add(key);
+    return next;
+}
+/**
+ * Compute the next selected-key set for a shift range-select between the anchor
+ * row and the just-clicked row (multiple mode only). All keys in the inclusive
+ * index range [min(anchor, target), max(anchor, target)] are added to the
+ * current selection.
+ *
+ * Pure: returns a brand new Set; never mutates `current`.
+ *
+ * @param current     the current selected-key set
+ * @param orderedKeys the full ordered list of row keys (index = row position)
+ * @param anchorIndex the index of the last single-clicked (anchor) row
+ * @param targetIndex the index of the shift-clicked row
+ */
+export function rangeSelection(current, orderedKeys, anchorIndex, targetIndex) {
+    const next = new Set(current);
+    if (anchorIndex < 0 || targetIndex < 0)
+        return next;
+    const lo = Math.max(0, Math.min(anchorIndex, targetIndex));
+    const hi = Math.min(orderedKeys.length - 1, Math.max(anchorIndex, targetIndex));
+    for (let i = lo; i <= hi; i += 1) {
+        const k = orderedKeys[i];
+        if (k !== undefined)
+            next.add(k);
+    }
+    return next;
+}
+//# sourceMappingURL=list-selection.js.map

package/dist/list-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-selection.js","sourceRoot":"","sources":["../src/list-selection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA6B,EAC7B,GAAY,EACZ,IAAmB;IAEnB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,uDAAuD;QACvD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAC7D,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;;QAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA6B,EAC7B,WAA+B,EAC/B,WAAmB,EACnB,WAAmB;IAEnB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IAChF,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

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

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

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

package/dist/list-selection.test.js

@@ -0,0 +1,61 @@
+import { describe, expect, it } from 'vitest';
+import { toggleSelection, rangeSelection } from './list-selection.js';
+describe('toggleSelection (single)', () => {
+    it('selects only the clicked row', () => {
+        const next = toggleSelection(new Set([1]), 2, 'single');
+        expect([...next]).toEqual([2]);
+    });
+    it('clears when re-clicking the sole selected row', () => {
+        const next = toggleSelection(new Set([2]), 2, 'single');
+        expect(next.size).toBe(0);
+    });
+    it('replaces a different existing selection', () => {
+        const next = toggleSelection(new Set([5, 6]), 6, 'single');
+        expect([...next]).toEqual([6]);
+    });
+    it('does not mutate the input set', () => {
+        const cur = new Set([1]);
+        toggleSelection(cur, 2, 'single');
+        expect([...cur]).toEqual([1]);
+    });
+});
+describe('toggleSelection (multiple)', () => {
+    it('adds an unselected key', () => {
+        const next = toggleSelection(new Set([1]), 2, 'multiple');
+        expect([...next].sort()).toEqual([1, 2]);
+    });
+    it('removes a selected key', () => {
+        const next = toggleSelection(new Set([1, 2]), 2, 'multiple');
+        expect([...next]).toEqual([1]);
+    });
+    it('does not mutate the input set', () => {
+        const cur = new Set([1, 2]);
+        toggleSelection(cur, 3, 'multiple');
+        expect([...cur].sort()).toEqual([1, 2]);
+    });
+});
+describe('rangeSelection', () => {
+    const keys = ['a', 'b', 'c', 'd', 'e'];
+    it('adds inclusive range between anchor and target', () => {
+        const next = rangeSelection(new Set(['a']), keys, 1, 3);
+        expect([...next].sort()).toEqual(['a', 'b', 'c', 'd']);
+    });
+    it('works regardless of click direction', () => {
+        const next = rangeSelection(new Set(), keys, 3, 1);
+        expect([...next].sort()).toEqual(['b', 'c', 'd']);
+    });
+    it('clamps out-of-bounds target index', () => {
+        const next = rangeSelection(new Set(), keys, 0, 99);
+        expect([...next].sort()).toEqual(['a', 'b', 'c', 'd', 'e']);
+    });
+    it('returns current copy when anchor missing', () => {
+        const next = rangeSelection(new Set(['a']), keys, -1, 3);
+        expect([...next]).toEqual(['a']);
+    });
+    it('does not mutate the input set', () => {
+        const cur = new Set(['a']);
+        rangeSelection(cur, keys, 1, 3);
+        expect([...cur]).toEqual(['a']);
+    });
+});
+//# sourceMappingURL=list-selection.test.js.map

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

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

package/dist/live-announcer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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');  // 立即打断
+ */
+export type Politeness = 'polite' | 'assertive';
+export interface LiveAnnouncer {
+    /** 把文案写入对应级别的单例 region 供屏幕阅读器播报。默认 polite。 */
+    announce(message: string, politeness?: Politeness): void;
+}
+/**
+ * 获取全局单例播报器。多次调用返回等价 API（共享同一对 region 节点），
+ * 首次写入时才惰性挂载 region（SSR 下不挂载）。
+ */
+export declare function useLiveAnnouncer(): LiveAnnouncer;
+/** 测试 only：移除单例 region 并复位模块状态。 */
+export declare function __resetLiveAnnouncer(): void;
+//# sourceMappingURL=live-announcer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"live-announcer.d.ts","sourceRoot":"","sources":["../src/live-announcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1D;AAwDD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,mCAAmC;AACnC,wBAAgB,oBAAoB,IAAI,IAAI,CAM3C"}