@pithyjs/ui-kit 0.1.0-beta.0

package/dist/shared/reconcile-list.d.ts

@@ -0,0 +1,37 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.reconcile-list",
+  "title": "Imperative Keyed List Reconciler",
+  "category": "runtime"
+}
+*/
+import { type Reactive } from './clickable';
+/** A reconciled row: its element, an in-place patcher, and a disposer. */
+/** @codexApi {"parent":"pithy.ui-kit.reconcile-list","name":"ListRow","stability":"stable","signature":"interface ListRow<T>"} */
+export interface ListRow<T> {
+    el: HTMLElement;
+    /** Patch the row's content to reflect a new item with the same key. */
+    update: (item: T, index: number) => void;
+    destroy: () => void;
+}
+/** @codexApi {"parent":"pithy.ui-kit.reconcile-list","name":"ReconcileListOptions","stability":"stable","signature":"interface ReconcileListOptions<T>"} */
+export interface ReconcileListOptions<T> {
+    /** Container the rows live in. Rows are appended/reordered as direct children. */
+    parent: HTMLElement;
+    /** Static array or `() => T[]` accessor (editor wraps reactive props as accessors). */
+    list: Reactive<T[]>;
+    /** Stable key per item. Falls back to index when omitted. */
+    keyOf?: (item: T, index: number) => string;
+    /** Build a row's DOM + patcher + disposer for a never-before-seen key. */
+    renderRow: (item: T, index: number) => ListRow<T>;
+}
+/**
+ * Reconcile `parent`'s children against `list`, reusing rows by key.
+ *
+ * When `list` is an accessor, the reconcile runs inside an `effect` so editor
+ * signal writes live-patch. Returns a disposer that stops the effect and
+ * destroys all live rows.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.reconcile-list","name":"reconcileList","stability":"stable","signature":"<T>(options: ReconcileListOptions<T>) => () => void"} */
+export declare function reconcileList<T>({ parent, list, keyOf, renderRow, }: ReconcileListOptions<T>): () => void;
+//# sourceMappingURL=reconcile-list.d.ts.map

package/dist/shared/reconcile-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile-list.d.ts","sourceRoot":"","sources":["../../src/shared/reconcile-list.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAWF,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,aAAa,CAAC;AAE1D,0EAA0E;AAC1E,kIAAkI;AAClI,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,EAAE,EAAE,WAAW,CAAC;IAChB,uEAAuE;IACvE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,4JAA4J;AAC5J,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,kFAAkF;IAClF,MAAM,EAAE,WAAW,CAAC;IACpB,uFAAuF;IACvF,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IACpB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,0EAA0E;IAC1E,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACnD;AAED;;;;;;GAMG;AACH,uKAAuK;AACvK,wBAAgB,aAAa,CAAC,CAAC,EAAE,EAC/B,MAAM,EACN,IAAI,EACJ,KAAK,EACL,SAAS,GACV,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAyEtC"}

package/dist/shared/reconcile-list.js

@@ -0,0 +1,95 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.reconcile-list",
+  "title": "Imperative Keyed List Reconciler",
+  "category": "runtime"
+}
+*/
+/**
+ * Keyed, imperative list reconciler for section components.
+ *
+ * The framework's <For> / createLoopManager render from a compiled AST, which
+ * imperatively-built section rows (document.createElement) can't drive — hence
+ * this parallel primitive.
+ */
+import { effect } from '@pithyjs/signals';
+import { readReactive } from './clickable';
+/**
+ * Reconcile `parent`'s children against `list`, reusing rows by key.
+ *
+ * When `list` is an accessor, the reconcile runs inside an `effect` so editor
+ * signal writes live-patch. Returns a disposer that stops the effect and
+ * destroys all live rows.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.reconcile-list","name":"reconcileList","stability":"stable","signature":"<T>(options: ReconcileListOptions<T>) => () => void"} */
+export function reconcileList({ parent, list, keyOf, renderRow, }) {
+    const keyFn = keyOf ?? ((_item, index) => String(index));
+    const rows = new Map();
+    const globalScope = globalThis;
+    function run() {
+        const wasRendering = globalScope.__pithyRenderingComponent;
+        globalScope.__pithyRenderingComponent = true;
+        try {
+            reconcile();
+        }
+        finally {
+            globalScope.__pithyRenderingComponent = wasRendering;
+        }
+    }
+    function reconcile() {
+        const raw = readReactive(list);
+        const collection = Array.isArray(raw) ? raw : [];
+        const newKeys = [];
+        const newKeySet = new Set();
+        for (let i = 0; i < collection.length; i++) {
+            const k = keyFn(collection[i], i);
+            newKeys.push(k);
+            if (import.meta.env?.DEV && newKeySet.has(k)) {
+                console.warn(`[reconcileList] duplicate key detected: ${k}`);
+            }
+            newKeySet.add(k);
+        }
+        for (const [key, row] of rows) {
+            if (!newKeySet.has(key)) {
+                row.destroy();
+                row.el.remove();
+                rows.delete(key);
+            }
+        }
+        // Build / patch rows in target order, then place each before a moving cursor
+        // walking backwards so a row only moves when it is genuinely out of order.
+        let cursor = null;
+        for (let i = collection.length - 1; i >= 0; i--) {
+            const key = newKeys[i];
+            const item = collection[i];
+            let row = rows.get(key);
+            if (row) {
+                row.update(item, i);
+            }
+            else {
+                row = renderRow(item, i);
+                rows.set(key, row);
+            }
+            if (row.el.nextSibling !== cursor || row.el.parentNode !== parent) {
+                parent.insertBefore(row.el, cursor);
+            }
+            cursor = row.el;
+        }
+    }
+    if (typeof list === 'function') {
+        const stop = effect(run);
+        return () => {
+            stop();
+            for (const row of rows.values())
+                row.destroy();
+            rows.clear();
+        };
+    }
+    run();
+    return () => {
+        for (const row of rows.values())
+            row.destroy();
+        rows.clear();
+    };
+}
+//# sourceMappingURL=reconcile-list.js.map

package/dist/shared/reconcile-list.js.map

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

package/dist/shared/section.d.ts

@@ -0,0 +1,23 @@
+/** @codex { "id": "pithy.ui-kit.shared-section", "title": "Shared Section Template Types", "category": "types" } */
+/**
+ * Shared types and validation for section template components.
+ */
+import type { SpacingSize } from '@pithyjs/design-system';
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"generateSectionHeadingId","stability":"internal","signature":"(sectionName: string, explicitId?: string) => string"} */
+export declare function generateSectionHeadingId(sectionName: string, explicitId?: string): string;
+/**
+ * Resets the internal section heading ID counter to 0.
+ * Call this between SSR requests to ensure deterministic IDs,
+ * or in test `beforeEach` to avoid cross-test ordering dependencies.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"resetSectionIdCounter","stability":"stable","signature":"() => void"} */
+export declare function resetSectionIdCounter(): void;
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"clampHeadingLevel","stability":"internal","signature":"(level: number) => number"} */
+export declare function clampHeadingLevel(level: number): number;
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"validateSpacing","stability":"internal","signature":"(componentName: string, rawSpacing: SpacingSize, fallback?: SpacingSize) => SpacingSize"} */
+export declare function validateSpacing(componentName: string, rawSpacing: SpacingSize, fallback?: SpacingSize): SpacingSize;
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"validateEnum","stability":"internal","signature":"<T extends string>(component: string, prop: string, value: unknown, allowed: readonly T[], fallback: T) => T"} */
+export declare function validateEnum<T extends string>(component: string, prop: string, value: unknown, allowed: readonly T[], fallback: T): T;
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"applyContainment","stability":"internal","signature":"(el: HTMLElement) => void"} */
+export declare function applyContainment(el: HTMLElement): void;
+//# sourceMappingURL=section.d.ts.map

package/dist/shared/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../src/shared/section.ts"],"names":[],"mappings":"AAAA,oHAAoH;AAEpH;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D,qLAAqL;AACrL,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAGR;AAED;;;;GAIG;AACH,sIAAsI;AACtI,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAID,mJAAmJ;AACnJ,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAID,+MAA+M;AAC/M,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,WAAW,EACvB,QAAQ,GAAE,WAAkB,GAC3B,WAAW,CAYb;AAED,iOAAiO;AACjO,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,QAAQ,EAAE,CAAC,GACV,CAAC,CAsBH;AAID,kJAAkJ;AAClJ,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAEtD"}

package/dist/shared/section.js

@@ -0,0 +1,65 @@
+/** @codex { "id": "pithy.ui-kit.shared-section", "title": "Shared Section Template Types", "category": "types" } */
+import { PY_CLASS } from './common';
+// -- Deterministic section heading IDs ----------------------------------------
+let sectionIdCounter = 0;
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"generateSectionHeadingId","stability":"internal","signature":"(sectionName: string, explicitId?: string) => string"} */
+export function generateSectionHeadingId(sectionName, explicitId) {
+    if (explicitId)
+        return `${explicitId}-heading`;
+    return `ui-${sectionName}-heading-${++sectionIdCounter}`;
+}
+/**
+ * Resets the internal section heading ID counter to 0.
+ * Call this between SSR requests to ensure deterministic IDs,
+ * or in test `beforeEach` to avoid cross-test ordering dependencies.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"resetSectionIdCounter","stability":"stable","signature":"() => void"} */
+export function resetSectionIdCounter() {
+    sectionIdCounter = 0;
+}
+// -- Heading level clamping ---------------------------------------------------
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"clampHeadingLevel","stability":"internal","signature":"(level: number) => number"} */
+export function clampHeadingLevel(level) {
+    if (!Number.isFinite(level))
+        return 2;
+    return Math.max(1, Math.min(6, Math.round(level)));
+}
+// -- Shared section validation ------------------------------------------------
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"validateSpacing","stability":"internal","signature":"(componentName: string, rawSpacing: SpacingSize, fallback?: SpacingSize) => SpacingSize"} */
+export function validateSpacing(componentName, rawSpacing, fallback = 'lg') {
+    const hasOwn = Object.prototype.hasOwnProperty;
+    const valid = hasOwn.call(PY_CLASS, rawSpacing);
+    if (import.meta.env?.DEV && !valid) {
+        const validValues = Object.keys(PY_CLASS).join(', ');
+        console.warn(`[<${componentName}>] Invalid spacing value: "${rawSpacing}". Expected one of: ${validValues}. Falling back to "${fallback}".`);
+    }
+    return valid ? rawSpacing : fallback;
+}
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"validateEnum","stability":"internal","signature":"<T extends string>(component: string, prop: string, value: unknown, allowed: readonly T[], fallback: T) => T"} */
+export function validateEnum(component, prop, value, allowed, fallback) {
+    if (typeof value === 'string' &&
+        allowed.includes(value)) {
+        return value;
+    }
+    if (import.meta.env?.DEV) {
+        let formatted;
+        try {
+            formatted = JSON.stringify(value);
+            if (formatted === undefined)
+                formatted = String(value);
+        }
+        catch {
+            formatted = String(value);
+        }
+        console.warn(`[<${component}>] Invalid ${prop}: ${formatted}. Expected one of: ${allowed
+            .map(v => `"${v}"`)
+            .join(', ')}. Falling back to "${fallback}".`);
+    }
+    return fallback;
+}
+// -- Containment styles (reused by all sections with contained layout) --------
+/** @codexApi {"parent":"pithy.ui-kit.shared-section","name":"applyContainment","stability":"internal","signature":"(el: HTMLElement) => void"} */
+export function applyContainment(el) {
+    el.classList.add('ui-section-container');
+}
+//# sourceMappingURL=section.js.map

package/dist/shared/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","sourceRoot":"","sources":["../../src/shared/section.ts"],"names":[],"mappings":"AAAA,oHAAoH;AAOpH,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,gFAAgF;AAEhF,IAAI,gBAAgB,GAAG,CAAC,CAAC;AAEzB,qLAAqL;AACrL,MAAM,UAAU,wBAAwB,CACtC,WAAmB,EACnB,UAAmB;IAEnB,IAAI,UAAU;QAAE,OAAO,GAAG,UAAU,UAAU,CAAC;IAC/C,OAAO,MAAM,WAAW,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,sIAAsI;AACtI,MAAM,UAAU,qBAAqB;IACnC,gBAAgB,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,gFAAgF;AAEhF,mJAAmJ;AACnJ,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,gFAAgF;AAEhF,+MAA+M;AAC/M,MAAM,UAAU,eAAe,CAC7B,aAAqB,EACrB,UAAuB,EACvB,WAAwB,IAAI;IAE5B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAEhD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CACV,KAAK,aAAa,8BAA8B,UAAU,uBAAuB,WAAW,sBAAsB,QAAQ,IAAI,CAC/H,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvC,CAAC;AAED,iOAAiO;AACjO,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,IAAY,EACZ,KAAc,EACd,OAAqB,EACrB,QAAW;IAEX,IACE,OAAO,KAAK,KAAK,QAAQ;QACxB,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC9C,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACzB,IAAI,SAAiB,CAAC;QACtB,IAAI,CAAC;YACH,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,SAAS,KAAK,SAAS;gBAAE,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,IAAI,CACV,KAAK,SAAS,cAAc,IAAI,KAAK,SAAS,sBAAsB,OAAO;aACxE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;aAClB,IAAI,CAAC,IAAI,CAAC,sBAAsB,QAAQ,IAAI,CAChD,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAEhF,kJAAkJ;AAClJ,MAAM,UAAU,gBAAgB,CAAC,EAAe;IAC9C,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAC3C,CAAC"}

package/dist/shared/segmented.d.ts

@@ -0,0 +1,17 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.segmented",
+  "title": "Segmented Keyboard Helpers",
+  "category": "types"
+}
+*/
+/**
+ * Shared keyboard plumbing for single-select segmented controls
+ * (SegmentedControl, IconGroup). Implements WAI-ARIA radiogroup
+ * navigation: focus moves activate, arrow keys wrap, Home/End jump.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.segmented","name":"bindSegmentedKeyboard","stability":"stable","signature":"(buttons: HTMLButtonElement[], onActivate: (index: number) => void) => () => void"} */
+export declare function bindSegmentedKeyboard(buttons: HTMLButtonElement[], onActivate: (index: number) => void): () => void;
+/** @codexApi {"parent":"pithy.ui-kit.segmented","name":"applyRovingTabindex","stability":"stable","signature":"(buttons: HTMLButtonElement[], activeIndex: number) => void"} */
+export declare function applyRovingTabindex(buttons: HTMLButtonElement[], activeIndex: number): void;
+//# sourceMappingURL=segmented.d.ts.map

package/dist/shared/segmented.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmented.d.ts","sourceRoot":"","sources":["../../src/shared/segmented.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;;;GAIG;AAEH,wMAAwM;AACxM,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAClC,MAAM,IAAI,CA8BZ;AAED,gLAAgL;AAChL,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,WAAW,EAAE,MAAM,GAClB,IAAI,CAMN"}

package/dist/shared/segmented.js

@@ -0,0 +1,53 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.segmented",
+  "title": "Segmented Keyboard Helpers",
+  "category": "types"
+}
+*/
+/**
+ * Shared keyboard plumbing for single-select segmented controls
+ * (SegmentedControl, IconGroup). Implements WAI-ARIA radiogroup
+ * navigation: focus moves activate, arrow keys wrap, Home/End jump.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.segmented","name":"bindSegmentedKeyboard","stability":"stable","signature":"(buttons: HTMLButtonElement[], onActivate: (index: number) => void) => () => void"} */
+export function bindSegmentedKeyboard(buttons, onActivate) {
+    const handlers = [];
+    buttons.forEach((btn, i) => {
+        const handler = (e) => {
+            let next;
+            if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') {
+                next = (i - 1 + buttons.length) % buttons.length;
+            }
+            else if (e.key === 'ArrowRight' || e.key === 'ArrowDown') {
+                next = (i + 1) % buttons.length;
+            }
+            else if (e.key === 'Home') {
+                next = 0;
+            }
+            else if (e.key === 'End') {
+                next = buttons.length - 1;
+            }
+            if (next != null) {
+                e.preventDefault();
+                onActivate(next);
+                buttons[next].focus();
+            }
+        };
+        btn.addEventListener('keydown', handler);
+        handlers.push(handler);
+    });
+    return () => {
+        buttons.forEach((btn, i) => {
+            btn.removeEventListener('keydown', handlers[i]);
+        });
+    };
+}
+/** @codexApi {"parent":"pithy.ui-kit.segmented","name":"applyRovingTabindex","stability":"stable","signature":"(buttons: HTMLButtonElement[], activeIndex: number) => void"} */
+export function applyRovingTabindex(buttons, activeIndex) {
+    const safeIndex = activeIndex >= 0 && activeIndex < buttons.length ? activeIndex : 0;
+    buttons.forEach((btn, i) => {
+        btn.tabIndex = i === safeIndex ? 0 : -1;
+    });
+}
+//# sourceMappingURL=segmented.js.map

package/dist/shared/segmented.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmented.js","sourceRoot":"","sources":["../../src/shared/segmented.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;;;GAIG;AAEH,wMAAwM;AACxM,MAAM,UAAU,qBAAqB,CACnC,OAA4B,EAC5B,UAAmC;IAEnC,MAAM,QAAQ,GAAsC,EAAE,CAAC;IAEvD,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,OAAO,GAAG,CAAC,CAAgB,EAAE,EAAE;YACnC,IAAI,IAAwB,CAAC;YAC7B,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBACjD,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YACnD,CAAC;iBAAM,IAAI,CAAC,CAAC,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;gBAC3D,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAClC,CAAC;iBAAM,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC;gBAC5B,IAAI,GAAG,CAAC,CAAC;YACX,CAAC;iBAAM,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;gBAC3B,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBACjB,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,UAAU,CAAC,IAAI,CAAC,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QACF,GAAG,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACzB,GAAG,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,gLAAgL;AAChL,MAAM,UAAU,mBAAmB,CACjC,OAA4B,EAC5B,WAAmB;IAEnB,MAAM,SAAS,GACb,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACzB,GAAG,CAAC,QAAQ,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/select.d.ts

@@ -0,0 +1,18 @@
+/** @codex { "id": "pithy.ui-kit.shared-select", "title": "Shared Select Constants", "category": "types" } */
+/**
+ * Shared constants for form Select component.
+ * Single source of truth for select option types and ID generation.
+ */
+export interface SelectOption {
+    /** Option value — used as the selected value. Must be non-empty; empty string is reserved as the "no selection" sentinel. */
+    value: string;
+    /** Display label — shown in the dropdown and trigger */
+    label: string;
+    /** Whether this option is disabled */
+    disabled?: boolean;
+}
+/** @codexApi {"parent":"pithy.ui-kit.shared-select","name":"generateSelectId","stability":"stable","signature":"() => string"} */
+export declare function generateSelectId(): string;
+/** @codexApi {"parent":"pithy.ui-kit.shared-select","name":"resetSelectIdCounter","stability":"stable","signature":"() => void"} */
+export declare function resetSelectIdCounter(): void;
+//# sourceMappingURL=select.d.ts.map

package/dist/shared/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/shared/select.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G;;;GAGG;AAMH,MAAM,WAAW,YAAY;IAC3B,6HAA6H;IAC7H,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAQD,kIAAkI;AAClI,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,oIAAoI;AACpI,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/shared/select.js

@@ -0,0 +1,14 @@
+/** @codex { "id": "pithy.ui-kit.shared-select", "title": "Shared Select Constants", "category": "types" } */
+// ---------------------------------------------------------------------------
+// Auto-generated IDs — stable Select instance IDs for component wiring/a11y
+// ---------------------------------------------------------------------------
+let selectIdCounter = 0;
+/** @codexApi {"parent":"pithy.ui-kit.shared-select","name":"generateSelectId","stability":"stable","signature":"() => string"} */
+export function generateSelectId() {
+    return `ui-select-${++selectIdCounter}`;
+}
+/** @codexApi {"parent":"pithy.ui-kit.shared-select","name":"resetSelectIdCounter","stability":"stable","signature":"() => void"} */
+export function resetSelectIdCounter() {
+    selectIdCounter = 0;
+}
+//# sourceMappingURL=select.js.map

package/dist/shared/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../src/shared/select.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAoB7G,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAE9E,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB,kIAAkI;AAClI,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,EAAE,eAAe,EAAE,CAAC;AAC1C,CAAC;AAED,oIAAoI;AACpI,MAAM,UAAU,oBAAoB;IAClC,eAAe,GAAG,CAAC,CAAC;AACtB,CAAC"}

package/dist/shared/slots.d.ts

@@ -0,0 +1,11 @@
+/** @codex { "id": "pithy.ui-kit.shared-slots", "title": "Named-Slot Utilities", "category": "runtime" } */
+/**
+ * Extracts nodes flagged with `data-slot="<name>"` out of the projected
+ * children fragment, returning them as a single fragment (or null when no
+ * matching nodes exist). Matching nodes are moved, not cloned.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.shared-slots","name":"extractSlot","stability":"internal","signature":"(source: DocumentFragment, name: string) => DocumentFragment | null"} */
+export declare function extractSlot(source: DocumentFragment, name: string): DocumentFragment | null;
+/** @codexApi {"parent":"pithy.ui-kit.shared-slots","name":"captureSlot","stability":"internal","signature":"<T extends HTMLElement>(el: T, name: string) => T"} */
+export declare function captureSlot<T extends HTMLElement>(el: T, name: string): T;
+//# sourceMappingURL=slots.d.ts.map

package/dist/shared/slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/shared/slots.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAE3G;;;;GAIG;AACH,qLAAqL;AACrL,wBAAgB,WAAW,CACzB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,IAAI,CAkBzB;AAED,mKAAmK;AACnK,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAGzE"}

package/dist/shared/slots.js

@@ -0,0 +1,33 @@
+/** @codex { "id": "pithy.ui-kit.shared-slots", "title": "Named-Slot Utilities", "category": "runtime" } */
+/**
+ * Extracts nodes flagged with `data-slot="<name>"` out of the projected
+ * children fragment, returning them as a single fragment (or null when no
+ * matching nodes exist). Matching nodes are moved, not cloned.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.shared-slots","name":"extractSlot","stability":"internal","signature":"(source: DocumentFragment, name: string) => DocumentFragment | null"} */
+export function extractSlot(source, name) {
+    const out = document.createDocumentFragment();
+    let found = false;
+    for (const node of Array.from(source.childNodes)) {
+        if (node.nodeType !== Node.ELEMENT_NODE)
+            continue;
+        const el = node;
+        if (el.tagName === 'TEMPLATE' && el.dataset.slot === name) {
+            out.appendChild(el.content);
+            el.remove();
+            found = true;
+            continue;
+        }
+        if (el.dataset.slot === name) {
+            out.appendChild(el);
+            found = true;
+        }
+    }
+    return found ? out : null;
+}
+/** @codexApi {"parent":"pithy.ui-kit.shared-slots","name":"captureSlot","stability":"internal","signature":"<T extends HTMLElement>(el: T, name: string) => T"} */
+export function captureSlot(el, name) {
+    el.setAttribute('data-slot', name);
+    return el;
+}
+//# sourceMappingURL=slots.js.map

package/dist/shared/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../src/shared/slots.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAE3G;;;;GAIG;AACH,qLAAqL;AACrL,MAAM,UAAU,WAAW,CACzB,MAAwB,EACxB,IAAY;IAEZ,MAAM,GAAG,GAAG,QAAQ,CAAC,sBAAsB,EAAE,CAAC;IAC9C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY;YAAE,SAAS;QAClD,MAAM,EAAE,GAAG,IAAmB,CAAC;QAC/B,IAAI,EAAE,CAAC,OAAO,KAAK,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1D,GAAG,CAAC,WAAW,CAAE,EAA0B,CAAC,OAAO,CAAC,CAAC;YACrD,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,KAAK,GAAG,IAAI,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC7B,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YACpB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5B,CAAC;AAED,mKAAmK;AACnK,MAAM,UAAU,WAAW,CAAwB,EAAK,EAAE,IAAY;IACpE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACnC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/shared/smart-container.d.ts

@@ -0,0 +1,19 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.shared.smart-container",
+  "title": "SmartContainer Constants & Types",
+  "category": "types"
+}
+*/
+/**
+ * SmartContainer-specific constants and types.
+ *
+ * Separated from grid.ts because these are only used by SmartContainer,
+ * not by Grid/GridItem.
+ */
+export declare const RECIPE_ITEMS: readonly ["auto-grid", "stack-to-row", "row-wrap", "sidebar", "equal-cards"];
+export type Recipe = (typeof RECIPE_ITEMS)[number];
+export declare const DENSITY_ITEMS: readonly ["compact", "normal", "relaxed"];
+export type Density = (typeof DENSITY_ITEMS)[number];
+export declare const DENSITY_RATIO: Record<Density, number>;
+//# sourceMappingURL=smart-container.d.ts.map

package/dist/shared/smart-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-container.d.ts","sourceRoot":"","sources":["../../src/shared/smart-container.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;;;;GAKG;AAIH,eAAO,MAAM,YAAY,8EAMf,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAInD,eAAO,MAAM,aAAa,2CAA4C,CAAC;AACvE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAIjD,CAAC"}

package/dist/shared/smart-container.js

@@ -0,0 +1,29 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.shared.smart-container",
+  "title": "SmartContainer Constants & Types",
+  "category": "types"
+}
+*/
+/**
+ * SmartContainer-specific constants and types.
+ *
+ * Separated from grid.ts because these are only used by SmartContainer,
+ * not by Grid/GridItem.
+ */
+// -- Recipe types ------------------------------------------------------------
+export const RECIPE_ITEMS = [
+    'auto-grid',
+    'stack-to-row',
+    'row-wrap',
+    'sidebar',
+    'equal-cards',
+];
+// -- Density types -----------------------------------------------------------
+export const DENSITY_ITEMS = ['compact', 'normal', 'relaxed'];
+export const DENSITY_RATIO = {
+    compact: 0.9,
+    normal: 1,
+    relaxed: 1.25,
+};
+//# sourceMappingURL=smart-container.js.map

package/dist/shared/smart-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-container.js","sourceRoot":"","sources":["../../src/shared/smart-container.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;;;;GAKG;AAEH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW;IACX,cAAc;IACd,UAAU;IACV,SAAS;IACT,aAAa;CACL,CAAC;AAGX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAGvE,MAAM,CAAC,MAAM,aAAa,GAA4B;IACpD,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,IAAI;CACd,CAAC"}

package/dist/shared/text.d.ts

@@ -0,0 +1,29 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.text-constants",
+  "title": "Content Shared Constants",
+  "category": "types"
+}
+*/
+/**
+ * Shared constants for content components (Text, Heading, etc.).
+ *
+ * Sizes, weights, and colors derive from @pithyjs/design-system (single source of truth).
+ * Alignment and tags are ui-kit concerns defined here.
+ */
+import { type FontSize } from '@pithyjs/design-system/typography';
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"SIZE_CLASS","stability":"stable","signature":"Record<FontSize, string>"} */
+export declare const SIZE_CLASS: Record<FontSize, string>;
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TEXT_COLORS","stability":"stable","signature":"readonly [\"text\", \"text-muted\", \"text-inverse\", \"primary\", \"secondary\", \"tertiary\", \"success\", \"info\", \"warning\", \"danger\"]"} */
+export declare const TEXT_COLORS: readonly ["text", "text-muted", "text-inverse", "primary", "secondary", "tertiary", "success", "info", "warning", "danger"];
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TextColor","stability":"stable","signature":"type TextColor = \"text\" | \"text-muted\" | \"text-inverse\" | \"primary\" | \"secondary\" | \"tertiary\" | \"success\" | \"info\" | \"warning\" | \"danger\""} */
+export type TextColor = (typeof TEXT_COLORS)[number];
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TEXT_ALIGNS","stability":"stable","signature":"readonly [\"start\", \"center\", \"end\", \"justify\"]"} */
+export declare const TEXT_ALIGNS: readonly ["start", "center", "end", "justify"];
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TextAlign","stability":"stable","signature":"type TextAlign = \"start\" | \"center\" | \"end\" | \"justify\""} */
+export type TextAlign = (typeof TEXT_ALIGNS)[number];
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TEXT_TAGS","stability":"stable","signature":"readonly [\"p\", \"span\", \"div\", \"small\", \"strong\", \"em\", \"s\", \"abbr\", \"time\", \"blockquote\", \"figcaption\", \"cite\", \"q\", \"mark\", \"code\", \"pre\", \"kbd\", \"samp\"]"} */
+export declare const TEXT_TAGS: readonly ["p", "span", "div", "small", "strong", "em", "s", "abbr", "time", "blockquote", "figcaption", "cite", "q", "mark", "code", "pre", "kbd", "samp"];
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TextTag","stability":"stable","signature":"type TextTag = \"p\" | \"span\" | \"div\" | \"small\" | \"strong\" | \"em\" | \"s\" | \"abbr\" | \"time\" | \"blockquote\" | \"figcaption\" | \"cite\" | \"q\" | \"mark\" | \"code\" | \"pre\" | \"kbd\" | \"samp\""} */
+export type TextTag = (typeof TEXT_TAGS)[number];
+//# sourceMappingURL=text.d.ts.map

package/dist/shared/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/shared/text.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAQ9E,yIAAyI;AACzI,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAS/C,CAAC;AAgBF,iQAAiQ;AACjQ,eAAO,MAAM,WAAW,6HAId,CAAC;AACX,8QAA8Q;AAC9Q,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAIrD,wKAAwK;AACxK,eAAO,MAAM,WAAW,gDAAiD,CAAC;AAC1E,+KAA+K;AAC/K,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAIrD,8SAA8S;AAC9S,eAAO,MAAM,SAAS,4JAmBZ,CAAC;AACX,iUAAiU;AACjU,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/shared/text.js

@@ -0,0 +1,72 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.text-constants",
+  "title": "Content Shared Constants",
+  "category": "types"
+}
+*/
+/**
+ * Shared constants for content components (Text, Heading, etc.).
+ *
+ * Sizes, weights, and colors derive from @pithyjs/design-system (single source of truth).
+ * Alignment and tags are ui-kit concerns defined here.
+ */
+import { FONT_SIZES } from '@pithyjs/design-system/typography';
+import { COLOR_TOKENS } from '@pithyjs/design-system/colors';
+// -- Size → class mapping (u-text-* typography utilities) ---------------------
+// Literal entries (not Object.fromEntries) so the design-system Vite plugin's
+// static scanner can detect each `u-text-*` class. The DEV-time guard below
+// warns at module load if @pithyjs/design-system adds or removes a font size.
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"SIZE_CLASS","stability":"stable","signature":"Record<FontSize, string>"} */
+export const SIZE_CLASS = {
+    xs: 'u-text-xs',
+    sm: 'u-text-sm',
+    base: 'u-text-base',
+    lg: 'u-text-lg',
+    xl: 'u-text-xl',
+    '2xl': 'u-text-2xl',
+    '3xl': 'u-text-3xl',
+    '4xl': 'u-text-4xl',
+};
+if (import.meta.env?.DEV) {
+    const declared = Object.keys(SIZE_CLASS).sort().join(',');
+    const expected = [...FONT_SIZES].sort().join(',');
+    if (declared !== expected) {
+        console.warn(`[ui-kit/text] SIZE_CLASS is out of sync with @pithyjs/design-system FONT_SIZES.\n` +
+            `  SIZE_CLASS: ${declared}\n  FONT_SIZES: ${expected}`);
+    }
+}
+// -- Colors (semantic color tokens for text) ----------------------------------
+// Derived from design system COLOR_TOKENS — single source of truth.
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TEXT_COLORS","stability":"stable","signature":"readonly [\"text\", \"text-muted\", \"text-inverse\", \"primary\", \"secondary\", \"tertiary\", \"success\", \"info\", \"warning\", \"danger\"]"} */
+export const TEXT_COLORS = [
+    ...COLOR_TOKENS.text,
+    ...COLOR_TOKENS.brand,
+    ...COLOR_TOKENS.status,
+];
+// -- Alignment (logical values for RTL support) -------------------------------
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TEXT_ALIGNS","stability":"stable","signature":"readonly [\"start\", \"center\", \"end\", \"justify\"]"} */
+export const TEXT_ALIGNS = ['start', 'center', 'end', 'justify'];
+// -- HTML tags ----------------------------------------------------------------
+/** @codexApi {"parent":"pithy.ui-kit.text-constants","name":"TEXT_TAGS","stability":"stable","signature":"readonly [\"p\", \"span\", \"div\", \"small\", \"strong\", \"em\", \"s\", \"abbr\", \"time\", \"blockquote\", \"figcaption\", \"cite\", \"q\", \"mark\", \"code\", \"pre\", \"kbd\", \"samp\"]"} */
+export const TEXT_TAGS = [
+    'p',
+    'span',
+    'div',
+    'small',
+    'strong',
+    'em',
+    's',
+    'abbr',
+    'time',
+    'blockquote',
+    'figcaption',
+    'cite',
+    'q',
+    'mark',
+    'code',
+    'pre',
+    'kbd',
+    'samp',
+];
+//# sourceMappingURL=text.js.map

package/dist/shared/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/shared/text.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,gFAAgF;AAChF,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAE9E,yIAAyI;AACzI,MAAM,CAAC,MAAM,UAAU,GAA6B;IAClD,EAAE,EAAE,WAAW;IACf,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,WAAW;IACf,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CACV,mFAAmF;YACjF,iBAAiB,QAAQ,mBAAmB,QAAQ,EAAE,CACzD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,oEAAoE;AAEpE,iQAAiQ;AACjQ,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,YAAY,CAAC,IAAI;IACpB,GAAG,YAAY,CAAC,KAAK;IACrB,GAAG,YAAY,CAAC,MAAM;CACd,CAAC;AAIX,gFAAgF;AAEhF,wKAAwK;AACxK,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAU,CAAC;AAI1E,gFAAgF;AAEhF,8SAA8S;AAC9S,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,GAAG;IACH,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,IAAI;IACJ,GAAG;IACH,MAAM;IACN,MAAM;IACN,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,GAAG;IACH,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;CACE,CAAC"}

package/dist/shared/textarea.d.ts

@@ -0,0 +1,6 @@
+/** @codex { "id": "pithy.ui-kit.shared-textarea", "title": "Shared Textarea Constants", "category": "types" } */
+/** @codexApi {"parent":"pithy.ui-kit.shared-textarea","name":"generateTextareaId","stability":"stable","signature":"() => string"} */
+export declare function generateTextareaId(): string;
+/** @codexApi {"parent":"pithy.ui-kit.shared-textarea","name":"resetTextareaIdCounter","stability":"stable","signature":"() => void"} */
+export declare function resetTextareaIdCounter(): void;
+//# sourceMappingURL=textarea.d.ts.map

package/dist/shared/textarea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../src/shared/textarea.ts"],"names":[],"mappings":"AAAA,iHAAiH;AAajH,sIAAsI;AACtI,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wIAAwI;AACxI,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}