@chenzy-design/core 0.1.0

package/dist/date.test.js

@@ -0,0 +1,171 @@
+import { describe, expect, it } from 'vitest';
+import { isSameDay, startOfDay, addMonths, addWeeks, addDays, getMonthGrid, getWeekGrid, getDayHours, weekdayOrder, daysBetween, formatDate, parseDateString, gridFocusMove, } from './date.js';
+describe('date utils', () => {
+    it('isSameDay compares calendar day only', () => {
+        expect(isSameDay(new Date(2024, 0, 1, 9), new Date(2024, 0, 1, 23))).toBe(true);
+        expect(isSameDay(new Date(2024, 0, 1), new Date(2024, 0, 2))).toBe(false);
+        expect(isSameDay(null, new Date())).toBe(false);
+    });
+    it('startOfDay zeroes the time', () => {
+        const r = startOfDay(new Date(2024, 5, 15, 13, 30, 45));
+        expect(r.getHours()).toBe(0);
+        expect(r.getMinutes()).toBe(0);
+        expect(r.getDate()).toBe(15);
+    });
+    it('addMonths handles year boundary and clamps day', () => {
+        expect(addMonths(new Date(2024, 11, 10), 1).getMonth()).toBe(0); // Dec → Jan
+        expect(addMonths(new Date(2024, 11, 10), 1).getFullYear()).toBe(2025);
+        // Jan 31 + 1 month → Feb (clamped, never spills to March)
+        expect(addMonths(new Date(2024, 0, 31), 1).getMonth()).toBe(1);
+    });
+    it('getMonthGrid yields 42 cells with correct in-month flags', () => {
+        const cells = getMonthGrid(new Date(2024, 0, 15)); // Jan 2024, Sunday-start
+        expect(cells).toHaveLength(42);
+        const inMonth = cells.filter((c) => c.inMonth);
+        expect(inMonth).toHaveLength(31); // January has 31 days
+        expect(inMonth[0]?.date.getDate()).toBe(1);
+    });
+    it('getMonthGrid Monday-start shifts the lead', () => {
+        // Jan 2024: 1st is a Monday → Monday-start grid begins exactly on the 1st
+        const cells = getMonthGrid(new Date(2024, 0, 1), 1);
+        expect(cells[0]?.date.getDate()).toBe(1);
+        expect(cells[0]?.inMonth).toBe(true);
+    });
+    it('weekdayOrder rotates by week start', () => {
+        expect(weekdayOrder(0)).toEqual([0, 1, 2, 3, 4, 5, 6]);
+        expect(weekdayOrder(1)).toEqual([1, 2, 3, 4, 5, 6, 0]);
+    });
+    it('addWeeks steps by 7 days and crosses months', () => {
+        expect(addWeeks(new Date(2024, 0, 1), 1).getDate()).toBe(8);
+        expect(addWeeks(new Date(2024, 0, 8), -1).getDate()).toBe(1);
+        // Jan 29 + 1 week → Feb 5 (crosses month boundary)
+        const r = addWeeks(new Date(2024, 0, 29), 1);
+        expect(r.getMonth()).toBe(1);
+        expect(r.getDate()).toBe(5);
+    });
+    it('getWeekGrid yields 7 cells starting on the week start', () => {
+        // 2024-01-15 is a Monday; Sunday-start week begins 2024-01-14
+        const sun = getWeekGrid(new Date(2024, 0, 15), 0);
+        expect(sun).toHaveLength(7);
+        expect(sun[0]?.date.getDate()).toBe(14);
+        expect(sun[0]?.date.getDay()).toBe(0);
+        expect(sun[6]?.date.getDate()).toBe(20);
+        // Monday-start week containing the 15th begins on the 15th
+        const mon = getWeekGrid(new Date(2024, 0, 15), 1);
+        expect(mon[0]?.date.getDate()).toBe(15);
+        expect(mon[0]?.date.getDay()).toBe(1);
+    });
+    it('getWeekGrid flags inMonth relative to cursor month', () => {
+        // 2024-02-01 is a Thursday; Sunday-start week spills into late January
+        const cells = getWeekGrid(new Date(2024, 1, 1), 0);
+        expect(cells[0]?.date.getMonth()).toBe(0); // Jan 28
+        expect(cells[0]?.inMonth).toBe(false);
+        expect(cells.some((c) => c.inMonth)).toBe(true);
+    });
+    it('addDays steps by 1 day and crosses month boundaries', () => {
+        expect(addDays(new Date(2024, 0, 1), 1).getDate()).toBe(2);
+        expect(addDays(new Date(2024, 0, 1), -1).getMonth()).toBe(11); // Dec 31, 2023
+        expect(addDays(new Date(2024, 0, 1), -1).getFullYear()).toBe(2023);
+        // preserves time-of-day
+        const t = addDays(new Date(2024, 0, 1, 13, 30), 1);
+        expect(t.getHours()).toBe(13);
+        expect(t.getMinutes()).toBe(30);
+    });
+    it('getDayHours yields one slot per hour in range on the cursor day', () => {
+        const slots = getDayHours(new Date(2024, 5, 15, 8, 30));
+        expect(slots).toHaveLength(24);
+        expect(slots[0]?.hour).toBe(0);
+        expect(slots[0]?.date.getHours()).toBe(0);
+        expect(slots[0]?.date.getDate()).toBe(15);
+        expect(slots[23]?.hour).toBe(23);
+    });
+    it('getDayHours honours and clamps a custom from/to range', () => {
+        const slots = getDayHours(new Date(2024, 5, 15), 9, 11);
+        expect(slots.map((s) => s.hour)).toEqual([9, 10, 11]);
+        // out-of-bounds clamps into 0..23
+        expect(getDayHours(new Date(2024, 5, 15), -5, 30)).toHaveLength(24);
+    });
+    it('daysBetween counts whole days ignoring time-of-day', () => {
+        expect(daysBetween(new Date(2024, 0, 1, 23), new Date(2024, 0, 2, 1))).toBe(1);
+        expect(daysBetween(new Date(2024, 0, 1), new Date(2024, 0, 1, 23))).toBe(0);
+        expect(daysBetween(new Date(2024, 0, 10), new Date(2024, 0, 1))).toBe(-9);
+        // crosses month boundary
+        expect(daysBetween(new Date(2024, 0, 31), new Date(2024, 1, 2))).toBe(2);
+    });
+});
+describe('formatDate', () => {
+    it('formats common patterns with zero-padding', () => {
+        const d = new Date(2024, 2, 7, 9, 5, 3);
+        expect(formatDate(d, 'YYYY-MM-DD')).toBe('2024-03-07');
+        expect(formatDate(d, 'YYYY/MM/DD HH:mm')).toBe('2024/03/07 09:05');
+        expect(formatDate(d, 'YYYY-MM-DD HH:mm:ss')).toBe('2024-03-07 09:05:03');
+    });
+    it('emits non-token characters verbatim', () => {
+        const d = new Date(2024, 11, 25);
+        expect(formatDate(d, 'YYYY 年 MM 月 DD 日')).toBe('2024 年 12 月 25 日');
+    });
+});
+describe('parseDateString', () => {
+    it('round-trips with formatDate', () => {
+        const d = new Date(2024, 2, 7, 9, 5, 0);
+        const s = formatDate(d, 'YYYY-MM-DD HH:mm');
+        const back = parseDateString(s, 'YYYY-MM-DD HH:mm');
+        expect(back?.getTime()).toBe(d.getTime());
+    });
+    it('parses date-only patterns to start of day', () => {
+        const r = parseDateString('2024/03/07', 'YYYY/MM/DD');
+        expect(r?.getFullYear()).toBe(2024);
+        expect(r?.getMonth()).toBe(2);
+        expect(r?.getDate()).toBe(7);
+        expect(r?.getHours()).toBe(0);
+    });
+    it('accepts single-digit fields where the pattern allows', () => {
+        const r = parseDateString('2024-3-7', 'YYYY-MM-DD');
+        expect(r?.getMonth()).toBe(2);
+        expect(r?.getDate()).toBe(7);
+    });
+    it('rejects non-matching input and out-of-range fields', () => {
+        expect(parseDateString('', 'YYYY-MM-DD')).toBeNull();
+        expect(parseDateString('not a date', 'YYYY-MM-DD')).toBeNull();
+        expect(parseDateString('2024-13-01', 'YYYY-MM-DD')).toBeNull();
+        expect(parseDateString('2024-02-30', 'YYYY-MM-DD')).toBeNull(); // overflow rejected
+        expect(parseDateString('2024-03-07 25:00', 'YYYY-MM-DD HH:mm')).toBeNull();
+        expect(parseDateString('2024/03/07', 'YYYY-MM-DD')).toBeNull(); // wrong separators
+    });
+});
+describe('gridFocusMove (roving focus navigation)', () => {
+    const base = new Date(2026, 5, 15); // 2026-06-15 (Mon)
+    it('arrow left/right step ±1 day', () => {
+        expect(isSameDay(gridFocusMove(base, 'ArrowLeft'), new Date(2026, 5, 14))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'ArrowRight'), new Date(2026, 5, 16))).toBe(true);
+    });
+    it('arrow up/down step ±1 week in month mode', () => {
+        expect(isSameDay(gridFocusMove(base, 'ArrowUp', 'month'), new Date(2026, 5, 8))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'ArrowDown', 'month'), new Date(2026, 5, 22))).toBe(true);
+    });
+    it('arrow up/down degrade to ±1 day in week mode (single row)', () => {
+        expect(isSameDay(gridFocusMove(base, 'ArrowUp', 'week'), new Date(2026, 5, 14))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'ArrowDown', 'week'), new Date(2026, 5, 16))).toBe(true);
+    });
+    it('page up/down step ±1 month in month mode, ±1 week in week mode', () => {
+        expect(isSameDay(gridFocusMove(base, 'PageUp', 'month'), new Date(2026, 4, 15))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'PageDown', 'month'), new Date(2026, 6, 15))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'PageUp', 'week'), new Date(2026, 5, 8))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'PageDown', 'week'), new Date(2026, 5, 22))).toBe(true);
+    });
+    it('Home/End go to first/last day of the visible week (week start aware)', () => {
+        // Sunday-start: week of 2026-06-15 (Mon) is Sun 14 .. Sat 20
+        expect(isSameDay(gridFocusMove(base, 'Home', 'month', 0), new Date(2026, 5, 14))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'End', 'month', 0), new Date(2026, 5, 20))).toBe(true);
+        // Monday-start: week is Mon 15 .. Sun 21
+        expect(isSameDay(gridFocusMove(base, 'Home', 'month', 1), new Date(2026, 5, 15))).toBe(true);
+        expect(isSameDay(gridFocusMove(base, 'End', 'month', 1), new Date(2026, 5, 21))).toBe(true);
+    });
+    it('crosses month boundary purely (caller re-derives the grid)', () => {
+        const firstOfMonth = new Date(2026, 5, 1); // Mon Jun 1
+        expect(isSameDay(gridFocusMove(firstOfMonth, 'ArrowLeft'), new Date(2026, 4, 31))).toBe(true);
+        const lastOfMonth = new Date(2026, 5, 30);
+        expect(isSameDay(gridFocusMove(lastOfMonth, 'ArrowRight'), new Date(2026, 6, 1))).toBe(true);
+    });
+});
+//# sourceMappingURL=date.test.js.map

package/dist/date.test.js.map

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

package/dist/dismiss.d.ts

@@ -0,0 +1,28 @@
+/**
+ * useDismiss — close-on-outside-click and close-on-Escape for overlays.
+ */
+/** 关闭来源：Esc 键 / 外部点击 */
+export type DismissReason = 'esc' | 'outsideClick';
+export interface DismissOptions {
+    /** 关闭回调，附带来源 reason（'esc' | 'outsideClick'） */
+    onDismiss: (reason: DismissReason) => void;
+    /** close when Escape pressed (default true) */
+    escape?: boolean;
+    /** close when clicking outside the element (default true) */
+    outsideClick?: boolean;
+    /**
+     * extra elements that also count as "inside" for outsideClick. Use this when
+     * a popup is portaled out of `element`'s subtree (e.g. floating to body) so a
+     * click inside the portaled popup is not treated as an outside click.
+     */
+    extraTargets?: Array<HTMLElement | null | undefined>;
+    /**
+     * Fired when an outside pointerdown is detected, *before* `onDismiss`. Receives
+     * the original PointerEvent. Return `false` (or call `preventDefault()`) to keep
+     * the overlay open — the dismiss is then skipped. Useful for an interceptable
+     * "clickOutside" hook distinct from the actual close.
+     */
+    onOutsidePointer?: (event: PointerEvent) => boolean | void;
+}
+export declare function useDismiss(element: HTMLElement, options: DismissOptions): () => void;
+//# sourceMappingURL=dismiss.d.ts.map

package/dist/dismiss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss.d.ts","sourceRoot":"","sources":["../src/dismiss.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAwB;AACxB,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,cAAc,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACrD;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,GAAG,IAAI,CAAC;CAC5D;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,cAAc,GACtB,MAAM,IAAI,CAoCZ"}

package/dist/dismiss.js

@@ -0,0 +1,42 @@
+/**
+ * useDismiss — close-on-outside-click and close-on-Escape for overlays.
+ */
+export function useDismiss(element, options) {
+    const { onDismiss, escape = true, outsideClick = true, extraTargets, onOutsidePointer } = options;
+    function isInside(target) {
+        if (element.contains(target))
+            return true;
+        if (extraTargets) {
+            for (const el of extraTargets) {
+                if (el && el.contains(target))
+                    return true;
+            }
+        }
+        return false;
+    }
+    function onKeydown(e) {
+        if (escape && e.key === 'Escape')
+            onDismiss('esc');
+    }
+    function onPointer(e) {
+        if (!outsideClick)
+            return;
+        if (isInside(e.target))
+            return;
+        // Interceptable hook: fire before the dismiss decision. Returning false or
+        // calling preventDefault() keeps the overlay open.
+        if (onOutsidePointer) {
+            const keep = onOutsidePointer(e) === false || e.defaultPrevented;
+            if (keep)
+                return;
+        }
+        onDismiss('outsideClick');
+    }
+    document.addEventListener('keydown', onKeydown);
+    document.addEventListener('pointerdown', onPointer, true);
+    return () => {
+        document.removeEventListener('keydown', onKeydown);
+        document.removeEventListener('pointerdown', onPointer, true);
+    };
+}
+//# sourceMappingURL=dismiss.js.map

package/dist/dismiss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss.js","sourceRoot":"","sources":["../src/dismiss.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2BH,MAAM,UAAU,UAAU,CACxB,OAAoB,EACpB,OAAuB;IAEvB,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,YAAY,EAAE,gBAAgB,EAAE,GACrF,OAAO,CAAC;IAEV,SAAS,QAAQ,CAAC,MAAmB;QACnC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;gBAC9B,IAAI,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,SAAS,CAAC,CAAgB;QACjC,IAAI,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ;YAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IACD,SAAS,SAAS,CAAC,CAAe;QAChC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAc,CAAC;YAAE,OAAO;QACvC,2EAA2E;QAC3E,mDAAmD;QACnD,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,gBAAgB,CAAC;YACjE,IAAI,IAAI;gBAAE,OAAO;QACnB,CAAC;QACD,SAAS,CAAC,cAAc,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAE1D,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACnD,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/editable.d.ts

@@ -0,0 +1,59 @@
+/**
+ * createEditable — framework-agnostic inline-edit state machine for Typography.
+ *
+ * State: idle | editing. Manages a draft value, commit/cancel transitions and
+ * the keyboard contract (Enter commits, Shift+Enter inserts a newline, Esc
+ * cancels). Pure logic + small imperative key/value helpers — no DOM, no
+ * framework reactivity. The render layer owns the <textarea>, focus moves and
+ * the controlled `value` (red line #1: editable does NOT write back; it only
+ * surfaces the draft via onChange on commit).
+ *
+ * See specs/components/basic/Typography.spec.md §3, §4.3, §11.
+ */
+/** clamp a draft to maxLength (in code units); undefined/0-or-less = no limit. */
+export declare function clampLength(value: string, maxLength?: number): string;
+export type EditableTrigger = 'click' | 'dblclick' | 'icon';
+export interface EditableKeyEvent {
+    key: string;
+    shiftKey?: boolean;
+}
+/** What a keydown should do while editing. */
+export type EditableKeyAction = 'confirm' | 'cancel' | 'newline' | 'none';
+/** Pure: map a keydown (while editing) to its semantic action. */
+export declare function resolveEditableKey(e: EditableKeyEvent): EditableKeyAction;
+export interface EditableOptions {
+    /** initial / source value (controlled by the render layer) */
+    value?: string;
+    /** character cap applied to the draft */
+    maxLength?: number;
+    /** how editing is entered (informational; render layer wires the trigger) */
+    trigger?: EditableTrigger;
+    /** re-render hook fired whenever editing/draft changes */
+    onChange?: (state: EditableSnapshot) => void;
+    /** fired on commit with the final (clamped) draft value */
+    onCommit?: (value: string) => void;
+    /** fired when entering edit mode */
+    onStart?: () => void;
+    /** fired when editing is cancelled */
+    onCancel?: () => void;
+}
+export interface EditableSnapshot {
+    editing: boolean;
+    draft: string;
+}
+export interface EditableApi {
+    readonly editing: boolean;
+    readonly draft: string;
+    /** enter edit mode, seeding the draft from `source` (or the configured value) */
+    start(source?: string): void;
+    /** update the draft (auto-clamped to maxLength) */
+    setDraft(next: string): void;
+    /** commit the current draft: leave edit mode + fire onCommit when changed */
+    confirm(): void;
+    /** discard the draft, leave edit mode, fire onCancel */
+    cancel(): void;
+    /** handle a keydown while editing; returns the action taken */
+    handleKey(e: EditableKeyEvent): EditableKeyAction;
+}
+export declare function createEditable(options?: EditableOptions): EditableApi;
+//# sourceMappingURL=editable.d.ts.map

package/dist/editable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable.d.ts","sourceRoot":"","sources":["../src/editable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1E,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAIzE;AAED,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC7C,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;IAChB,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;CACnD;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,WAAW,CAqDzE"}

package/dist/editable.js

@@ -0,0 +1,85 @@
+/**
+ * createEditable — framework-agnostic inline-edit state machine for Typography.
+ *
+ * State: idle | editing. Manages a draft value, commit/cancel transitions and
+ * the keyboard contract (Enter commits, Shift+Enter inserts a newline, Esc
+ * cancels). Pure logic + small imperative key/value helpers — no DOM, no
+ * framework reactivity. The render layer owns the <textarea>, focus moves and
+ * the controlled `value` (red line #1: editable does NOT write back; it only
+ * surfaces the draft via onChange on commit).
+ *
+ * See specs/components/basic/Typography.spec.md §3, §4.3, §11.
+ */
+/** clamp a draft to maxLength (in code units); undefined/0-or-less = no limit. */
+export function clampLength(value, maxLength) {
+    if (maxLength === undefined || maxLength <= 0)
+        return value;
+    return value.length > maxLength ? value.slice(0, maxLength) : value;
+}
+/** Pure: map a keydown (while editing) to its semantic action. */
+export function resolveEditableKey(e) {
+    if (e.key === 'Escape')
+        return 'cancel';
+    if (e.key === 'Enter')
+        return e.shiftKey ? 'newline' : 'confirm';
+    return 'none';
+}
+export function createEditable(options = {}) {
+    let editing = false;
+    let draft = options.value ?? '';
+    function emit() {
+        options.onChange?.({ editing, draft });
+    }
+    return {
+        get editing() {
+            return editing;
+        },
+        get draft() {
+            return draft;
+        },
+        start(source) {
+            if (editing)
+                return;
+            editing = true;
+            draft = clampLength(source ?? options.value ?? '', options.maxLength);
+            options.onStart?.();
+            emit();
+        },
+        setDraft(next) {
+            const clamped = clampLength(next, options.maxLength);
+            if (clamped === draft)
+                return;
+            draft = clamped;
+            emit();
+        },
+        confirm() {
+            if (!editing)
+                return;
+            editing = false;
+            const committed = draft;
+            // red line #1: surface via callback only; never self-mutate `value`.
+            if (committed !== (options.value ?? '')) {
+                options.onCommit?.(committed);
+            }
+            emit();
+        },
+        cancel() {
+            if (!editing)
+                return;
+            editing = false;
+            draft = options.value ?? '';
+            options.onCancel?.();
+            emit();
+        },
+        handleKey(e) {
+            const action = resolveEditableKey(e);
+            if (action === 'confirm')
+                this.confirm();
+            else if (action === 'cancel')
+                this.cancel();
+            // 'newline' / 'none' are left to the textarea's native behavior
+            return action;
+        },
+    };
+}
+//# sourceMappingURL=editable.js.map

package/dist/editable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable.js","sourceRoot":"","sources":["../src/editable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,SAAkB;IAC3D,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,OAAO,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtE,CAAC;AAYD,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,CAAmB;IACpD,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC;AAuCD,MAAM,UAAU,cAAc,CAAC,UAA2B,EAAE;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAEhC,SAAS,IAAI;QACX,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACL,IAAI,OAAO;YACT,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,MAAM;YACV,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,GAAG,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YACtE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,IAAI,EAAE,CAAC;QACT,CAAC;QACD,QAAQ,CAAC,IAAI;YACX,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,OAAO,KAAK,KAAK;gBAAE,OAAO;YAC9B,KAAK,GAAG,OAAO,CAAC;YAChB,IAAI,EAAE,CAAC;QACT,CAAC;QACD,OAAO;YACL,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,GAAG,KAAK,CAAC;YAChB,MAAM,SAAS,GAAG,KAAK,CAAC;YACxB,qEAAqE;YACrE,IAAI,SAAS,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC;YAChC,CAAC;YACD,IAAI,EAAE,CAAC;QACT,CAAC;QACD,MAAM;YACJ,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,GAAG,KAAK,CAAC;YAChB,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrB,IAAI,EAAE,CAAC;QACT,CAAC;QACD,SAAS,CAAC,CAAC;YACT,MAAM,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,EAAE,CAAC;iBACpC,IAAI,MAAM,KAAK,QAAQ;gBAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,gEAAgE;YAChE,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/editable.test.d.ts

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

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

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

package/dist/editable.test.js

@@ -0,0 +1,111 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createEditable, clampLength, resolveEditableKey } from './editable.js';
+describe('clampLength', () => {
+    it('returns value unchanged when no maxLength', () => {
+        expect(clampLength('hello')).toBe('hello');
+    });
+    it('truncates to maxLength', () => {
+        expect(clampLength('hello', 3)).toBe('hel');
+    });
+    it('ignores maxLength <= 0', () => {
+        expect(clampLength('hello', 0)).toBe('hello');
+    });
+});
+describe('resolveEditableKey', () => {
+    it('Enter → confirm', () => {
+        expect(resolveEditableKey({ key: 'Enter' })).toBe('confirm');
+    });
+    it('Shift+Enter → newline', () => {
+        expect(resolveEditableKey({ key: 'Enter', shiftKey: true })).toBe('newline');
+    });
+    it('Escape → cancel', () => {
+        expect(resolveEditableKey({ key: 'Escape' })).toBe('cancel');
+    });
+    it('other → none', () => {
+        expect(resolveEditableKey({ key: 'a' })).toBe('none');
+    });
+});
+describe('createEditable', () => {
+    it('start enters editing and seeds draft from value', () => {
+        const e = createEditable({ value: 'orig' });
+        e.start();
+        expect(e.editing).toBe(true);
+        expect(e.draft).toBe('orig');
+    });
+    it('start(source) seeds from explicit source', () => {
+        const e = createEditable({ value: 'orig' });
+        e.start('other');
+        expect(e.draft).toBe('other');
+    });
+    it('setDraft clamps to maxLength', () => {
+        const e = createEditable({ value: '', maxLength: 3 });
+        e.start();
+        e.setDraft('abcdef');
+        expect(e.draft).toBe('abc');
+    });
+    it('confirm fires onCommit only when changed and exits editing', () => {
+        const onCommit = vi.fn();
+        const e = createEditable({ value: 'a', onCommit });
+        e.start();
+        e.setDraft('b');
+        e.confirm();
+        expect(e.editing).toBe(false);
+        expect(onCommit).toHaveBeenCalledWith('b');
+    });
+    it('confirm does not fire onCommit when unchanged', () => {
+        const onCommit = vi.fn();
+        const e = createEditable({ value: 'a', onCommit });
+        e.start();
+        e.confirm();
+        expect(onCommit).not.toHaveBeenCalled();
+    });
+    it('cancel restores value and fires onCancel', () => {
+        const onCancel = vi.fn();
+        const onCommit = vi.fn();
+        const e = createEditable({ value: 'a', onCancel, onCommit });
+        e.start();
+        e.setDraft('changed');
+        e.cancel();
+        expect(e.editing).toBe(false);
+        expect(e.draft).toBe('a');
+        expect(onCancel).toHaveBeenCalled();
+        expect(onCommit).not.toHaveBeenCalled();
+    });
+    it('handleKey Enter confirms', () => {
+        const onCommit = vi.fn();
+        const e = createEditable({ value: 'a', onCommit });
+        e.start();
+        e.setDraft('b');
+        const action = e.handleKey({ key: 'Enter' });
+        expect(action).toBe('confirm');
+        expect(onCommit).toHaveBeenCalledWith('b');
+    });
+    it('handleKey Esc cancels', () => {
+        const e = createEditable({ value: 'a' });
+        e.start();
+        e.setDraft('b');
+        const action = e.handleKey({ key: 'Escape' });
+        expect(action).toBe('cancel');
+        expect(e.editing).toBe(false);
+        expect(e.draft).toBe('a');
+    });
+    it('handleKey Shift+Enter is newline (no confirm)', () => {
+        const onCommit = vi.fn();
+        const e = createEditable({ value: 'a', onCommit });
+        e.start();
+        const action = e.handleKey({ key: 'Enter', shiftKey: true });
+        expect(action).toBe('newline');
+        expect(e.editing).toBe(true);
+        expect(onCommit).not.toHaveBeenCalled();
+    });
+    it('does not write back value (red line #1)', () => {
+        const opts = { value: 'a', onCommit: vi.fn() };
+        const e = createEditable(opts);
+        e.start();
+        e.setDraft('b');
+        e.confirm();
+        // options.value untouched; only callback surfaced the new value
+        expect(opts.value).toBe('a');
+    });
+});
+//# sourceMappingURL=editable.test.js.map

package/dist/editable.test.js.map

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

package/dist/ellipsis.d.ts

@@ -0,0 +1,76 @@
+/**
+ * createEllipsis — framework-agnostic truncation/expand logic for Typography.
+ *
+ * Two paths (per spec §9):
+ *  - CSS clamp (default): no measurement at all — the render layer applies
+ *    `-webkit-line-clamp`/`text-overflow`. This module only tracks `expanded`
+ *    and the expand/collapse toggle; `truncated` stays unknown (CSS handles it).
+ *  - Measurement path (expandable / suffix / showTooltip): the render layer
+ *    feeds measured box metrics into `measure()`, which decides whether the
+ *    content overflows (`truncated`). Pure decision — no DOM here; the svelte
+ *    layer owns the ResizeObserver + rAF-throttled measurement (red line #3).
+ *
+ * Pure helpers (overflow decision, middle-truncation slicing) are independently
+ * unit-tested. No framework deps, no DOM.
+ * See specs/components/basic/Typography.spec.md §3, §4.3, §11.
+ */
+export type EllipsisPos = 'start' | 'middle' | 'end';
+export interface EllipsisMeasureInput {
+    /** rendered scroll height of the content (px) */
+    scrollHeight: number;
+    /** visible client height of the clamp box (px) */
+    clientHeight: number;
+    /** rendered scroll width (px) — used for single-row overflow detection */
+    scrollWidth?: number;
+    /** visible client width (px) */
+    clientWidth?: number;
+    /** number of clamp rows (1 = single line) */
+    rows: number;
+}
+/**
+ * Pure: decide whether content overflows its clamp box. For multi-row we compare
+ * heights; for a single row we additionally allow a width comparison. A 1px
+ * tolerance absorbs sub-pixel rounding so equal content is not flagged.
+ */
+export declare function isOverflowing(input: EllipsisMeasureInput): boolean;
+/**
+ * Pure: build a middle/start/end truncated string given a budget of visible
+ * characters. Used only on the single-line precise path (pos: middle/start);
+ * end truncation is normally left to CSS. Always inserts the ellipsis char.
+ */
+export declare function truncateText(text: string, maxChars: number, pos: EllipsisPos, ellipsis?: string): string;
+export interface EllipsisOptions {
+    /** clamp rows (default 1) */
+    rows?: number;
+    /** whether an expand toggle is offered */
+    expandable?: boolean;
+    /** whether a collapse toggle is offered after expansion (Semi `collapsible`) */
+    collapsible?: boolean;
+    /** truncation position (single-line precise path); default 'end' */
+    pos?: EllipsisPos;
+    /** initial expanded state */
+    defaultExpanded?: boolean;
+    /** re-render hook fired when expanded/truncated changes */
+    onChange?: (state: EllipsisSnapshot) => void;
+    /** fired on expand/collapse toggle */
+    onExpand?: (expanded: boolean) => void;
+}
+export interface EllipsisSnapshot {
+    rows: number;
+    expanded: boolean;
+    /** null = unknown (CSS clamp path, not measured) */
+    truncated: boolean | null;
+}
+export interface EllipsisApi {
+    readonly rows: number;
+    readonly expanded: boolean;
+    readonly truncated: boolean | null;
+    /** toggle expanded (no-op when not expandable) */
+    toggle(): void;
+    /** explicitly set expanded */
+    setExpanded(next: boolean): void;
+    /** feed measured metrics (measurement path) → updates `truncated` */
+    measure(input: EllipsisMeasureInput): boolean;
+}
+export declare function createEllipsis(options?: EllipsisOptions): EllipsisApi;
+//# sourceMappingURL=ellipsis.d.ts.map