@chenzy-design/core 0.1.0

package/dist/highlight.d.ts

@@ -0,0 +1,57 @@
+/**
+ * highlight — framework-agnostic text highlight chunking with overlap merging.
+ * Pure: given a source string + search words (or precomputed match ranges),
+ * returns a flat, ordered, non-overlapping sequence of chunks
+ * [{ text, matched }] covering the whole source. No DOM, no regex side effects
+ * on caller input. The render layer maps chunks → <mark>/snippet.
+ *
+ * Overlap handling: when multiple search words match overlapping regions, the
+ * ranges are merged so a character is wrapped at most once (no nested/duplicated
+ * markup). Adjacent (touching) matched ranges are also coalesced.
+ * See specs/components/show/Highlight.spec.md.
+ */
+/** A half-open match range [start, end) into the source string. */
+export interface HighlightRange {
+    start: number;
+    end: number;
+}
+/** One contiguous piece of the source: either a match or plain text. */
+export interface HighlightChunk {
+    text: string;
+    matched: boolean;
+}
+export interface FindRangesOptions {
+    /** match case-sensitively (default false) */
+    caseSensitive?: boolean;
+    /** match all occurrences (default true); false = first occurrence only */
+    highlightAll?: boolean;
+    /** treat words as literal text by escaping regex (default true) */
+    autoEscape?: boolean;
+}
+/**
+ * Find raw (possibly overlapping) match ranges of `words` in `source`.
+ *
+ * Each word is scanned independently, so ranges from different words may
+ * overlap (e.g. "ab" and "bc" in "abc" → [0,2] and [1,3]); feed the result to
+ * mergeRanges / chunksFromRanges to normalize. Returns ranges in document
+ * order. An invalid regex source (autoEscape=false misuse) for any word is
+ * silently skipped (that word contributes no ranges).
+ */
+export declare function findRanges(source: string, words: string | string[], options?: FindRangesOptions): HighlightRange[];
+/**
+ * Merge overlapping or adjacent ranges into a sorted, non-overlapping set.
+ * Handles: overlap, containment, adjacency (touching ends), and duplicates.
+ */
+export declare function mergeRanges(ranges: HighlightRange[]): HighlightRange[];
+/**
+ * Slice `source` into an ordered, gap-free chunk sequence using `ranges`.
+ * `ranges` may overlap; they are merged first, so output chunks never overlap
+ * and concatenating their text reproduces `source` exactly.
+ */
+export declare function chunksFromRanges(source: string, ranges: HighlightRange[]): HighlightChunk[];
+/**
+ * One-shot: find matches of `words` in `source` and return merged,
+ * non-overlapping chunks. The render layer iterates the result directly.
+ */
+export declare function highlightChunks(source: string, words: string | string[], options?: FindRangesOptions): HighlightChunk[];
+//# sourceMappingURL=highlight.d.ts.map

package/dist/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../src/highlight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAaD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,OAAO,GAAE,iBAAsB,GAC9B,cAAc,EAAE,CA8BlB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAmBtE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAgB3F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,OAAO,GAAE,iBAAsB,GAC9B,cAAc,EAAE,CAIlB"}

package/dist/highlight.js

@@ -0,0 +1,124 @@
+/**
+ * highlight — framework-agnostic text highlight chunking with overlap merging.
+ * Pure: given a source string + search words (or precomputed match ranges),
+ * returns a flat, ordered, non-overlapping sequence of chunks
+ * [{ text, matched }] covering the whole source. No DOM, no regex side effects
+ * on caller input. The render layer maps chunks → <mark>/snippet.
+ *
+ * Overlap handling: when multiple search words match overlapping regions, the
+ * ranges are merged so a character is wrapped at most once (no nested/duplicated
+ * markup). Adjacent (touching) matched ranges are also coalesced.
+ * See specs/components/show/Highlight.spec.md.
+ */
+const RE_SPECIAL = /[.*+?^${}()|[\]\\]/g;
+function escapeRegExp(s) {
+    return s.replace(RE_SPECIAL, '\\$&');
+}
+function normalizeWords(words) {
+    const arr = Array.isArray(words) ? words : [words];
+    return arr.filter((w) => typeof w === 'string' && w.length > 0);
+}
+/**
+ * Find raw (possibly overlapping) match ranges of `words` in `source`.
+ *
+ * Each word is scanned independently, so ranges from different words may
+ * overlap (e.g. "ab" and "bc" in "abc" → [0,2] and [1,3]); feed the result to
+ * mergeRanges / chunksFromRanges to normalize. Returns ranges in document
+ * order. An invalid regex source (autoEscape=false misuse) for any word is
+ * silently skipped (that word contributes no ranges).
+ */
+export function findRanges(source, words, options = {}) {
+    if (!source)
+        return [];
+    const list = normalizeWords(words);
+    if (list.length === 0)
+        return [];
+    const { caseSensitive = false, highlightAll = true, autoEscape = true } = options;
+    const flags = `${caseSensitive ? '' : 'i'}g`;
+    const ranges = [];
+    for (const word of list) {
+        const src = autoEscape ? escapeRegExp(word) : word;
+        let re;
+        try {
+            re = new RegExp(src, flags);
+        }
+        catch {
+            continue; // skip this word, keep the rest highlighting
+        }
+        let m;
+        while ((m = re.exec(source)) !== null) {
+            const matched = m[0];
+            if (matched.length === 0) {
+                re.lastIndex += 1; // avoid infinite loop on zero-length match
+                continue;
+            }
+            ranges.push({ start: m.index, end: m.index + matched.length });
+            if (!highlightAll)
+                break;
+        }
+    }
+    ranges.sort((a, b) => a.start - b.start || a.end - b.end);
+    return ranges;
+}
+/**
+ * Merge overlapping or adjacent ranges into a sorted, non-overlapping set.
+ * Handles: overlap, containment, adjacency (touching ends), and duplicates.
+ */
+export function mergeRanges(ranges) {
+    const valid = ranges.filter((r) => r.end > r.start);
+    if (valid.length <= 1)
+        return valid.slice();
+    const sorted = valid.slice().sort((a, b) => a.start - b.start || a.end - b.end);
+    const first = sorted[0];
+    const merged = [{ start: first.start, end: first.end }];
+    for (let i = 1; i < sorted.length; i++) {
+        const cur = sorted[i];
+        const last = merged[merged.length - 1];
+        // overlap or adjacency (cur.start <= last.end) → extend
+        if (cur.start <= last.end) {
+            if (cur.end > last.end)
+                last.end = cur.end;
+        }
+        else {
+            merged.push({ start: cur.start, end: cur.end });
+        }
+    }
+    return merged;
+}
+/**
+ * Slice `source` into an ordered, gap-free chunk sequence using `ranges`.
+ * `ranges` may overlap; they are merged first, so output chunks never overlap
+ * and concatenating their text reproduces `source` exactly.
+ */
+export function chunksFromRanges(source, ranges) {
+    if (!source)
+        return [];
+    const merged = mergeRanges(ranges);
+    if (merged.length === 0)
+        return [{ text: source, matched: false }];
+    const chunks = [];
+    let cursor = 0;
+    for (const { start, end } of merged) {
+        const s = Math.max(0, Math.min(start, source.length));
+        const e = Math.max(s, Math.min(end, source.length));
+        if (s > cursor)
+            chunks.push({ text: source.slice(cursor, s), matched: false });
+        if (e > s)
+            chunks.push({ text: source.slice(s, e), matched: true });
+        cursor = e;
+    }
+    if (cursor < source.length)
+        chunks.push({ text: source.slice(cursor), matched: false });
+    return chunks;
+}
+/**
+ * One-shot: find matches of `words` in `source` and return merged,
+ * non-overlapping chunks. The render layer iterates the result directly.
+ */
+export function highlightChunks(source, words, options = {}) {
+    if (!source)
+        return [];
+    const ranges = findRanges(source, words, options);
+    return chunksFromRanges(source, ranges);
+}
+//# sourceMappingURL=highlight.js.map

package/dist/highlight.js.map

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

package/dist/highlight.test.d.ts

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

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

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

package/dist/highlight.test.js

@@ -0,0 +1,155 @@
+import { describe, expect, it } from 'vitest';
+import { chunksFromRanges, findRanges, highlightChunks, mergeRanges, } from './highlight.js';
+describe('mergeRanges', () => {
+    it('returns empty for empty input', () => {
+        expect(mergeRanges([])).toEqual([]);
+    });
+    it('drops zero-length / inverted ranges', () => {
+        expect(mergeRanges([{ start: 3, end: 3 }, { start: 5, end: 2 }])).toEqual([]);
+    });
+    it('sorts disjoint ranges', () => {
+        expect(mergeRanges([
+            { start: 5, end: 7 },
+            { start: 0, end: 2 },
+        ])).toEqual([
+            { start: 0, end: 2 },
+            { start: 5, end: 7 },
+        ]);
+    });
+    it('merges overlapping ranges', () => {
+        expect(mergeRanges([
+            { start: 0, end: 4 },
+            { start: 2, end: 6 },
+        ])).toEqual([{ start: 0, end: 6 }]);
+    });
+    it('merges adjacent (touching) ranges', () => {
+        expect(mergeRanges([
+            { start: 0, end: 3 },
+            { start: 3, end: 6 },
+        ])).toEqual([{ start: 0, end: 6 }]);
+    });
+    it('absorbs a contained range', () => {
+        expect(mergeRanges([
+            { start: 0, end: 10 },
+            { start: 3, end: 5 },
+        ])).toEqual([{ start: 0, end: 10 }]);
+    });
+    it('collapses duplicates', () => {
+        expect(mergeRanges([
+            { start: 1, end: 4 },
+            { start: 1, end: 4 },
+        ])).toEqual([{ start: 1, end: 4 }]);
+    });
+    it('does not mutate the input array', () => {
+        const input = [
+            { start: 5, end: 7 },
+            { start: 0, end: 2 },
+        ];
+        const snapshot = JSON.parse(JSON.stringify(input));
+        mergeRanges(input);
+        expect(input).toEqual(snapshot);
+    });
+});
+describe('findRanges', () => {
+    it('finds all occurrences by default', () => {
+        expect(findRanges('a-a-a', 'a')).toEqual([
+            { start: 0, end: 1 },
+            { start: 2, end: 3 },
+            { start: 4, end: 5 },
+        ]);
+    });
+    it('honors highlightAll=false (first only)', () => {
+        expect(findRanges('a-a-a', 'a', { highlightAll: false })).toEqual([{ start: 0, end: 1 }]);
+    });
+    it('is case-insensitive by default', () => {
+        expect(findRanges('Foo', 'foo')).toEqual([{ start: 0, end: 3 }]);
+    });
+    it('honors caseSensitive', () => {
+        expect(findRanges('Foo foo', 'foo', { caseSensitive: true })).toEqual([{ start: 4, end: 7 }]);
+    });
+    it('escapes regex special chars by default', () => {
+        expect(findRanges('a.b a*b', '.')).toEqual([{ start: 1, end: 2 }]);
+    });
+    it('treats words as regex when autoEscape=false', () => {
+        expect(findRanges('a1b2', '\\d', { autoEscape: false })).toEqual([
+            { start: 1, end: 2 },
+            { start: 3, end: 4 },
+        ]);
+    });
+    it('returns [] for invalid regex source (autoEscape misuse)', () => {
+        expect(findRanges('abc', '(', { autoEscape: false })).toEqual([]);
+    });
+    it('returns [] when no words or empty source', () => {
+        expect(findRanges('', 'a')).toEqual([]);
+        expect(findRanges('abc', [])).toEqual([]);
+        expect(findRanges('abc', ['', ''])).toEqual([]);
+    });
+    it('finds multiple words', () => {
+        expect(findRanges('foo bar baz', ['foo', 'baz'])).toEqual([
+            { start: 0, end: 3 },
+            { start: 8, end: 11 },
+        ]);
+    });
+});
+describe('chunksFromRanges', () => {
+    it('returns single unmatched chunk when no ranges', () => {
+        expect(chunksFromRanges('hello', [])).toEqual([{ text: 'hello', matched: false }]);
+    });
+    it('returns [] for empty source', () => {
+        expect(chunksFromRanges('', [{ start: 0, end: 1 }])).toEqual([]);
+    });
+    it('splits into matched/unmatched and preserves the whole string', () => {
+        const chunks = chunksFromRanges('hello world', [{ start: 6, end: 11 }]);
+        expect(chunks).toEqual([
+            { text: 'hello ', matched: false },
+            { text: 'world', matched: true },
+        ]);
+        expect(chunks.map((c) => c.text).join('')).toBe('hello world');
+    });
+    it('clamps out-of-bound ranges', () => {
+        expect(chunksFromRanges('abc', [{ start: -2, end: 99 }])).toEqual([
+            { text: 'abc', matched: true },
+        ]);
+    });
+});
+describe('highlightChunks (integration: overlap merge)', () => {
+    it('default <mark> behavior unchanged for single word', () => {
+        expect(highlightChunks('hello world', 'world')).toEqual([
+            { text: 'hello ', matched: false },
+            { text: 'world', matched: true },
+        ]);
+    });
+    it('merges overlapping multi-word matches without nesting', () => {
+        // "ab" matches [0,2], "bc" matches [1,3] → merged [0,3] = "abc"
+        const chunks = highlightChunks('abcd', ['ab', 'bc']);
+        expect(chunks).toEqual([
+            { text: 'abc', matched: true },
+            { text: 'd', matched: false },
+        ]);
+        // exactly one matched chunk: no double-wrap
+        expect(chunks.filter((c) => c.matched)).toHaveLength(1);
+    });
+    it('merges a contained word into the larger match', () => {
+        // "ell" inside "hello"
+        const chunks = highlightChunks('hello', ['hello', 'ell']);
+        expect(chunks).toEqual([{ text: 'hello', matched: true }]);
+    });
+    it('coalesces adjacent matches from different words', () => {
+        // "foo" [0,3] + "bar" [3,6] are touching → single matched chunk "foobar"
+        const chunks = highlightChunks('foobar', ['foo', 'bar']);
+        expect(chunks).toEqual([{ text: 'foobar', matched: true }]);
+    });
+    it('keeps disjoint multi-word matches separate', () => {
+        expect(highlightChunks('foo x bar', ['foo', 'bar'])).toEqual([
+            { text: 'foo', matched: true },
+            { text: ' x ', matched: false },
+            { text: 'bar', matched: true },
+        ]);
+    });
+    it('always reproduces the source by concatenation', () => {
+        const src = 'the quick brown fox';
+        const chunks = highlightChunks(src, ['quick', 'ick br', 'fox']);
+        expect(chunks.map((c) => c.text).join('')).toBe(src);
+    });
+});
+//# sourceMappingURL=highlight.test.js.map

package/dist/highlight.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.test.js","sourceRoot":"","sources":["../src/highlight.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,GAEZ,MAAM,gBAAgB,CAAC;AAExB,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CACJ,WAAW,CAAC;YACV,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CACH,CAAC,OAAO,CAAC;YACR,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CACJ,WAAW,CAAC;YACV,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CACJ,WAAW,CAAC;YACV,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CACJ,WAAW,CAAC;YACV,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;YACrB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CACJ,WAAW,CAAC;YACV,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CACH,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,KAAK,GAAqB;YAC9B,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YACvC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC/D,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACxD,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;YACpB,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,MAAM,GAAG,gBAAgB,CAAC,aAAa,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;YAClC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAChE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC5D,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,eAAe,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACtD,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;YAClC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;SACjC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,gEAAgE;QAChE,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;YAC9B,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SAC9B,CAAC,CAAC;QACH,4CAA4C;QAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,uBAAuB;QACvB,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,yEAAyE;QACzE,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3D,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;YAC9B,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;YAC/B,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,qBAAqB,CAAC;QAClC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/id.d.ts

@@ -0,0 +1,4 @@
+export declare function useId(prefix?: string): string;
+/** reset for test determinism */
+export declare function __resetIdCounter(): void;
+//# sourceMappingURL=id.d.ts.map

package/dist/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAMA,wBAAgB,KAAK,CAAC,MAAM,SAAO,GAAG,MAAM,CAG3C;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/id.js

@@ -0,0 +1,14 @@
+/**
+ * useId — stable unique id generation for aria relationships.
+ * Framework-agnostic: no DOM, no framework deps.
+ */
+let counter = 0;
+export function useId(prefix = 'cd') {
+    counter += 1;
+    return `${prefix}-${counter}`;
+}
+/** reset for test determinism */
+export function __resetIdCounter() {
+    counter = 0;
+}
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,MAAM,UAAU,KAAK,CAAC,MAAM,GAAG,IAAI;IACjC,OAAO,IAAI,CAAC,CAAC;IACb,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;AAChC,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,gBAAgB;IAC9B,OAAO,GAAG,CAAC,CAAC;AACd,CAAC"}

package/dist/id.test.d.ts

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

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

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

package/dist/id.test.js

@@ -0,0 +1,13 @@
+import { describe, expect, it, beforeEach } from 'vitest';
+import { useId, __resetIdCounter } from './id.js';
+describe('useId', () => {
+    beforeEach(() => __resetIdCounter());
+    it('generates unique incrementing ids', () => {
+        expect(useId()).toBe('cd-1');
+        expect(useId()).toBe('cd-2');
+    });
+    it('honors a custom prefix', () => {
+        expect(useId('modal')).toBe('modal-1');
+    });
+});
+//# sourceMappingURL=id.test.js.map

package/dist/id.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.test.js","sourceRoot":"","sources":["../src/id.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAElD,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,UAAU,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAErC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @chenzy-design/core — framework-agnostic headless primitives.
+ * ZERO framework dependencies. Render layers (svelte, future vue/react) bind these.
+ * See specs/00-foundation/mvvm-adapter.spec.md.
+ */
+export { useId, __resetIdCounter } from './id.js';
+export { clampWithMode, boundaryHitOf, roundToPrecision, decimalsOf as decimalsOfNumber, addStep as addNumberStep, formatWithLocale, __resetNumberFormatCache, type BoundaryMode, } from './input-number.js';
+export { useFocusTrap, type FocusTrap } from './focus-trap.js';
+export { useLiveAnnouncer, __resetLiveAnnouncer, type LiveAnnouncer, type Politeness, } from './live-announcer.js';
+export { useDismiss, type DismissOptions, type DismissReason } from './dismiss.js';
+export { useScrollLock, __resetScrollLock } from './scroll-lock.js';
+export { useInertBackground, __resetInertBackground, } from './inert-background.js';
+export { createSider, type SiderApi, type SiderOptions, type SiderTrigger, } from './sider.js';
+export { createForm, type FormApi, type FormOptions, type FormState, type FormValues, type FieldConfig, type FieldErrors, type Rule, type MessageDescriptor, type ValidateTrigger, } from './form.js';
+export { findRanges, mergeRanges, chunksFromRanges, highlightChunks, type HighlightRange, type HighlightChunk, type FindRangesOptions, } from './highlight.js';
+export { isSameDay, startOfDay, addMonths, addWeeks, addDays, getMonthGrid, getWeekGrid, getDayHours, weekdayOrder, daysBetween, formatDate, parseDateString, gridFocusMove, type DayCell, type GridFocusKey, } from './date.js';
+export { flattenVisible, findNode, collectExpandable, collectExpandableToDepth, conduct, toggleCheck, normalizeToLeaves, computeFilteredKeys, computeDropPosition, isAncestorOrSelf, collectCheckedByStrategy, siblingKeys, accordionExpand, type CheckedStrategy, type TreeKey, type TreeNodeData, type FlatNode, type CheckState, type DropPosition, } from './tree.js';
+export { flattenCascaderPaths, filterCascaderPaths, resolveColumnWidth, type CascaderKey, type CascaderPathNode, type CascaderFlatPath, type CascaderFilterFn, } from './cascader.js';
+export { nextSortOrder, toggleSort, applySort, paginate, pageCount, selectAllState, toggleSelectAll, toggleRow, flattenTreeRows, conductRows, normalizeRowsToLeaves, toggleRowCheck, type RowKey, type SortOrder, type SortState, type SelectAllState, type FlatRow, } from './table.js';
+export { eventCoversDay, eventsForDay, groupEventsByDays, timelineForDay, dayKey, isPastDay, type CalendarEvent, type CalendarEventKey, type DayEvents, type DayTimeline, } from './calendar.js';
+export { offsetToIndex, indexToOffset, indexOfValue, nextEnabledIndex, firstEnabledIndex, lastEnabledIndex, keyboardTarget, wrapIndex, cyclicVirtualCount, cyclicCenterIndex, cyclicRecenter, momentumStep, projectSettleIndex, type ScrollListValue, type ScrollListItem, type ScrollListKey, type MomentumStep, } from './scroll-list.js';
+export { computeVisibleCount, computeOverflowPartition, applyHysteresis, computeTabOverflow, type OverflowComputeInput, type OverflowComputeResult, type OverflowPartitionInput, type OverflowPartitionResult, type CollapseFrom, type TabOverflowInput, type TabOverflowResult, } from './overflow-list.js';
+export { createSpinController, type SpinController, type SpinOptions, } from './spin.js';
+export { clampPercent, resolveStatus, getCirclePathProps, getRootAriaProps, type ProgressStatus, type ProgressType, type GapPosition, type CirclePathProps, type RootAriaProps, } from './progress.js';
+export { resolveBannerRole, type BannerType, type BannerRoleProps, } from './banner.js';
+export { createToastStore, type ToastStore, type ToastItem, type ToastOptions, type ToastType, type ToastPosition, type ToastTheme, type ToastCloseReason, } from './toast.js';
+export { createNotificationStore, type NotificationStore, type NotificationItem, type NotificationOptions, type NotificationType, type NotificationPlacement, type NotificationCloseReason, type NotificationTheme, type NotificationDirection, } from './notification.js';
+export { easeInOutCubic, isAboveThreshold, scrollPositionAt } from './back-top.js';
+export { mergeConfig, DEFAULT_CONFIG, resolveAppliedTheme, resolveReducedMotion, type ConfigInput, type ResolvedConfig, type ConfigTheme, type AppliedTheme, type ConfigDir, type ConfigSize, type ReducedMotionInput, } from './config-provider.js';
+export { createResizeObserver, normalizeEntry, isResizeObserverSupported, resolveSchedule, createScheduler, advanceResizePhase, endResizePhase, getGlobalResizeObserver, type ResizeBox, type ResizeSchedule, type CDResizeEntry, type ResizeObserverApi, type ResizeObserverOptions, } from './resize-observer.js';
+export { resolveSize, resolveAnimated, shouldAutoplay, resolveSegments, isLottieSrc, resolveRenderer, type LottieTrigger, type LottieSize, type LottieSegments, type LottieRenderer, type LottiePlayerAdapter, type LottiePlayerFactory, } from './lottie-icon.js';
+export { computePosition, parsePlacement, makePlacement, type Placement, type Side, type Align, type Rect, type Viewport, type ComputePositionInput, type ComputePositionResult, } from './floating.js';
+export { BREAKPOINTS, BREAKPOINT_ORDER, resolveActiveBreakpoint, resolveResponsiveValue, type Breakpoint, } from './breakpoints.js';
+export { computeAutosizeHeight, countCharacters, type AutosizeInput, type AutosizeResult, } from './textarea.js';
+export { createCopyable, writeClipboard, type CopyableApi, type CopyableOptions, } from './copyable.js';
+export { createEditable, clampLength, resolveEditableKey, type EditableApi, type EditableOptions, type EditableSnapshot, type EditableTrigger, type EditableKeyEvent, type EditableKeyAction, } from './editable.js';
+export { createEllipsis, isOverflowing, truncateText, type EllipsisApi, type EllipsisOptions, type EllipsisSnapshot, type EllipsisMeasureInput, type EllipsisPos, } from './ellipsis.js';
+export { computeUploadPercent, isUploadOk, createUploadQueue, resolveBeforeUpload, validateFileSize, } from './upload.js';
+export type { UploadTask, UploadQueue, BeforeUploadResult, BeforeUploadDecision, UploadSizeError, } from './upload.js';
+export { fixedRange, buildOffsets, totalFromOffsets, offsetToIndex as virtualOffsetToIndex, dynamicRange, scrollOffsetForIndex, windowScrollTop, type VirtualRange, type ScrollAlign, } from './virtual-list.js';
+export { rovingKeyFromEvent, nextRovingIndex, type RovingKey, } from './roving.js';
+export { toggleSelection, rangeSelection, type ListKey, type SelectionMode, } from './list-selection.js';
+export { pageCount as paginationPageCount, clampPage, isPageInRange, clampPageSize, parseJumpInput, pageRange, type PageCell, } from './pagination.js';
+export { clamp01 as colorClamp01, parseHex, rgbToHex, rgbToHsv, hsvToRgb, hsvToHsl, hslToHsv, rgbToHsl, hslToRgb, hexToHsv, hsvToHex, formatColor, parseColor, type Rgb, type Hsv, type Hsl, type ColorFormat, type RgbToHexOptions, type FormatOptions, } from './color.js';
+export { buildRange as buildTimeRange, to12Hour, meridiemOf, from12Hour, buildHourOptions, buildMinuteOptions, buildSecondOptions, applyHideDisabled, isTimeDisabled, parseFormatSpec, formatTime, parseTimeString, type Meridiem, type TimeOption, type DisabledTime, type TimeParts, type FormatSpec, } from './time.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,45 @@
+/**
+ * @chenzy-design/core — framework-agnostic headless primitives.
+ * ZERO framework dependencies. Render layers (svelte, future vue/react) bind these.
+ * See specs/00-foundation/mvvm-adapter.spec.md.
+ */
+export { useId, __resetIdCounter } from './id.js';
+export { clampWithMode, boundaryHitOf, roundToPrecision, decimalsOf as decimalsOfNumber, addStep as addNumberStep, formatWithLocale, __resetNumberFormatCache, } from './input-number.js';
+export { useFocusTrap } from './focus-trap.js';
+export { useLiveAnnouncer, __resetLiveAnnouncer, } from './live-announcer.js';
+export { useDismiss } from './dismiss.js';
+export { useScrollLock, __resetScrollLock } from './scroll-lock.js';
+export { useInertBackground, __resetInertBackground, } from './inert-background.js';
+export { createSider, } from './sider.js';
+export { createForm, } from './form.js';
+export { findRanges, mergeRanges, chunksFromRanges, highlightChunks, } from './highlight.js';
+export { isSameDay, startOfDay, addMonths, addWeeks, addDays, getMonthGrid, getWeekGrid, getDayHours, weekdayOrder, daysBetween, formatDate, parseDateString, gridFocusMove, } from './date.js';
+export { flattenVisible, findNode, collectExpandable, collectExpandableToDepth, conduct, toggleCheck, normalizeToLeaves, computeFilteredKeys, computeDropPosition, isAncestorOrSelf, collectCheckedByStrategy, siblingKeys, accordionExpand, } from './tree.js';
+export { flattenCascaderPaths, filterCascaderPaths, resolveColumnWidth, } from './cascader.js';
+export { nextSortOrder, toggleSort, applySort, paginate, pageCount, selectAllState, toggleSelectAll, toggleRow, flattenTreeRows, conductRows, normalizeRowsToLeaves, toggleRowCheck, } from './table.js';
+export { eventCoversDay, eventsForDay, groupEventsByDays, timelineForDay, dayKey, isPastDay, } from './calendar.js';
+export { offsetToIndex, indexToOffset, indexOfValue, nextEnabledIndex, firstEnabledIndex, lastEnabledIndex, keyboardTarget, wrapIndex, cyclicVirtualCount, cyclicCenterIndex, cyclicRecenter, momentumStep, projectSettleIndex, } from './scroll-list.js';
+export { computeVisibleCount, computeOverflowPartition, applyHysteresis, computeTabOverflow, } from './overflow-list.js';
+export { createSpinController, } from './spin.js';
+export { clampPercent, resolveStatus, getCirclePathProps, getRootAriaProps, } from './progress.js';
+export { resolveBannerRole, } from './banner.js';
+export { createToastStore, } from './toast.js';
+export { createNotificationStore, } from './notification.js';
+export { easeInOutCubic, isAboveThreshold, scrollPositionAt } from './back-top.js';
+export { mergeConfig, DEFAULT_CONFIG, resolveAppliedTheme, resolveReducedMotion, } from './config-provider.js';
+export { createResizeObserver, normalizeEntry, isResizeObserverSupported, resolveSchedule, createScheduler, advanceResizePhase, endResizePhase, getGlobalResizeObserver, } from './resize-observer.js';
+export { resolveSize, resolveAnimated, shouldAutoplay, resolveSegments, isLottieSrc, resolveRenderer, } from './lottie-icon.js';
+export { computePosition, parsePlacement, makePlacement, } from './floating.js';
+export { BREAKPOINTS, BREAKPOINT_ORDER, resolveActiveBreakpoint, resolveResponsiveValue, } from './breakpoints.js';
+export { computeAutosizeHeight, countCharacters, } from './textarea.js';
+export { createCopyable, writeClipboard, } from './copyable.js';
+export { createEditable, clampLength, resolveEditableKey, } from './editable.js';
+export { createEllipsis, isOverflowing, truncateText, } from './ellipsis.js';
+export { computeUploadPercent, isUploadOk, createUploadQueue, resolveBeforeUpload, validateFileSize, } from './upload.js';
+export { fixedRange, buildOffsets, totalFromOffsets, offsetToIndex as virtualOffsetToIndex, dynamicRange, scrollOffsetForIndex, windowScrollTop, } from './virtual-list.js';
+export { rovingKeyFromEvent, nextRovingIndex, } from './roving.js';
+export { toggleSelection, rangeSelection, } from './list-selection.js';
+export { pageCount as paginationPageCount, clampPage, isPageInRange, clampPageSize, parseJumpInput, pageRange, } from './pagination.js';
+export { clamp01 as colorClamp01, parseHex, rgbToHex, rgbToHsv, hsvToRgb, hsvToHsl, hslToHsv, rgbToHsl, hslToRgb, hexToHsv, hsvToHex, formatColor, parseColor, } from './color.js';
+export { buildRange as buildTimeRange, to12Hour, meridiemOf, from12Hour, buildHourOptions, buildMinuteOptions, buildSecondOptions, applyHideDisabled, isTimeDisabled, parseFormatSpec, formatTime, parseTimeString, } from './time.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inert-background.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+/**
+ * Mark `root`'s siblings inert/aria-hidden. `root` should be the overlay's
+ * portal root element. Returns a release function (idempotent).
+ */
+export declare function useInertBackground(root: HTMLElement): () => void;
+/** test-only reset of internal state */
+export declare function __resetInertBackground(): void;
+//# sourceMappingURL=inert-background.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inert-background.d.ts","sourceRoot":"","sources":["../src/inert-background.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgDH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,IAAI,CAgBhE;AAED,wCAAwC;AACxC,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}