cursedbelt 0.0.0

package/dist/react/compat.js

@@ -0,0 +1,31 @@
+/**
+ * Deprecation tombstones for primitives whose ROLE was removed in the from-scratch
+ * rebuild but whose imports still exist in the apps until the Stage-F page migration
+ * adopts the replacement.
+ *
+ * `PageBottom` / `usePageBottomSpace` reserved bottom space + guessed the keyboard
+ * height via `vh`/`md:` breakpoints. That job now belongs to the single keyboard-safe
+ * `ScrollArea` (task 03), which tracks the real `visualViewport` keyboard inset and
+ * applies `scroll-padding-bottom`. So these render/do nothing and warn once.
+ *
+ * REMOVE this file (and its re-exports from `index.ts`) in task 39, once no app
+ * imports `PageBottom`/`usePageBottomSpace` anymore.
+ */
+let warned = false;
+function warnOnce() {
+    if (warned)
+        return;
+    warned = true;
+    console.warn('[cursedbelt] PageBottom/usePageBottomSpace are deprecated no-ops — bottom spacing + ' +
+        'keyboard inset are now handled by ScrollArea (task 03). Remove these imports (task 39).');
+}
+/** @deprecated No-op. Renders only its children; the spacer is gone (ScrollArea owns it). */
+export function PageBottom({ children } = {}) {
+    warnOnce();
+    return children ?? null;
+}
+/** @deprecated No-op. ScrollArea's `space` prop replaces per-page bottom-space overrides. */
+export function usePageBottomSpace() {
+    warnOnce();
+}
+//# sourceMappingURL=compat.js.map

package/dist/react/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","sourceRoot":"","sources":["../../src/react/compat.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,IAAI,MAAM,GAAG,KAAK,CAAC;AACnB,SAAS,QAAQ;IACf,IAAI,MAAM;QAAE,OAAO;IACnB,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,CAAC,IAAI,CACV,sFAAsF;QACpF,yFAAyF,CAC5F,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,EAAE,QAAQ,KAA+B,EAAE;IACpE,QAAQ,EAAE,CAAC;IACX,OAAO,QAAQ,IAAI,IAAI,CAAC;AAC1B,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB;IAChC,QAAQ,EAAE,CAAC;AACb,CAAC"}

package/dist/react/components/ActionBar.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from 'react';
+export interface ActionBarProps {
+    /** The single "likely next action" — solid primary. Full-width on mobile (largest
+     *  thumb target), bottom-right on desktop (where the eye exits a form). */
+    primary?: ReactNode;
+    /** Cancel / Back. */
+    secondary?: ReactNode;
+    /** An irreversible action (Delete) — left-anchored, never next to `primary`. */
+    destructive?: ReactNode;
+    /** Misc toolbar items (a {@link SplitButton}, view toggles, …). */
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * The one action bar that retires every per-page `border-t … justify-end` footer.
+ * Two genuinely different trees per breakpoint (not a squeezed row):
+ *
+ * - **Mobile**: a docked bottom sheet — full-width stacked primary/secondary for the
+ *   shortest thumb travel, riding above the keyboard via `--keyboard-inset` and above
+ *   the home indicator via safe-area padding.
+ * - **Desktop**: a sticky row — destructive + misc left, secondary + primary right.
+ *
+ * Sticky (`bottom-0`) rather than fixed, so it docks to the bottom of whatever scroll
+ * container it lives in — a modal, a panel, or the page — never the raw viewport edge.
+ */
+export declare function ActionBar({ primary, secondary, destructive, children, className, }: ActionBarProps): import("react").JSX.Element;
+//# sourceMappingURL=ActionBar.d.ts.map

package/dist/react/components/ActionBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionBar.d.ts","sourceRoot":"","sources":["../../../src/react/components/ActionBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,cAAc;IAC7B;+EAC2E;IAC3E,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,qBAAqB;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gFAAgF;IAChF,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,EACxB,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,GACV,EAAE,cAAc,+BA+ChB"}

package/dist/react/components/ActionBar.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMediaQuery } from '../hooks/useMediaQuery';
+import { cn } from '../lib/cn';
+const MOBILE_QUERY = '(max-width: 639px)';
+/**
+ * The one action bar that retires every per-page `border-t … justify-end` footer.
+ * Two genuinely different trees per breakpoint (not a squeezed row):
+ *
+ * - **Mobile**: a docked bottom sheet — full-width stacked primary/secondary for the
+ *   shortest thumb travel, riding above the keyboard via `--keyboard-inset` and above
+ *   the home indicator via safe-area padding.
+ * - **Desktop**: a sticky row — destructive + misc left, secondary + primary right.
+ *
+ * Sticky (`bottom-0`) rather than fixed, so it docks to the bottom of whatever scroll
+ * container it lives in — a modal, a panel, or the page — never the raw viewport edge.
+ */
+export function ActionBar({ primary, secondary, destructive, children, className, }) {
+    const isMobile = useMediaQuery(MOBILE_QUERY);
+    if (isMobile) {
+        return (_jsxs("div", { "data-cb-action-bar": 'mobile', className: cn('sticky bottom-0 z-40 flex flex-col gap-2 border-t border-border bg-background/95 px-4 pt-3 backdrop-blur', 
+            // Home-indicator clearance (fixed CSS expression, needs the env() literal).
+            'pb-[max(env(safe-area-inset-bottom,0px),0.75rem)]', className), 
+            // Rides above the soft keyboard. Inline because it's a live custom-property value
+            // (a class can't read --keyboard-inset into margin); the pb- above stays a class.
+            style: { marginBottom: 'var(--keyboard-inset, 0px)' }, children: [(destructive || children) && (_jsxs("div", { className: 'flex items-center justify-between gap-2', children: [destructive, _jsx("div", { className: 'flex items-center gap-2', children: children })] })), primary && _jsx("div", { className: '[&>button]:w-full', children: primary }), secondary && _jsx("div", { className: '[&>button]:w-full', children: secondary })] }));
+    }
+    return (_jsxs("div", { "data-cb-action-bar": 'desktop', className: cn('sticky bottom-0 z-40 flex items-center justify-between gap-2 border-t border-border bg-background px-5 py-3', className), children: [_jsxs("div", { className: 'flex items-center gap-2', children: [destructive, children] }), _jsxs("div", { className: 'flex items-center gap-2', children: [secondary, primary] })] }));
+}
+//# sourceMappingURL=ActionBar.js.map

package/dist/react/components/ActionBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionBar.js","sourceRoot":"","sources":["../../../src/react/components/ActionBar.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAe/B,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,GACM;IACf,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CACL,qCACqB,QAAQ,EAC3B,SAAS,EAAE,EAAE,CACX,0GAA0G;YAC1G,4EAA4E;YAC5E,mDAAmD,EACnD,SAAS,CACV;YACD,kFAAkF;YAClF,kFAAkF;YAClF,KAAK,EAAE,EAAE,YAAY,EAAE,4BAA4B,EAAE,aAEpD,CAAC,WAAW,IAAI,QAAQ,CAAC,IAAI,CAC5B,eAAK,SAAS,EAAC,yCAAyC,aACrD,WAAW,EACZ,cAAK,SAAS,EAAC,yBAAyB,YAAE,QAAQ,GAAO,IACrD,CACP,EACA,OAAO,IAAI,cAAK,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAO,EAC7D,SAAS,IAAI,cAAK,SAAS,EAAC,mBAAmB,YAAE,SAAS,GAAO,IAC9D,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,qCACqB,SAAS,EAC5B,SAAS,EAAE,EAAE,CACX,6GAA6G,EAC7G,SAAS,CACV,aAED,eAAK,SAAS,EAAC,yBAAyB,aACrC,WAAW,EACX,QAAQ,IACL,EACN,eAAK,SAAS,EAAC,yBAAyB,aACrC,SAAS,EACT,OAAO,IACJ,IACF,CACP,CAAC;AACJ,CAAC"}

package/dist/react/components/AddItemsMenu.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode } from 'react';
+import { type ButtonSize, type ButtonVariant } from './Button';
+export interface AddItemsGroup<T> {
+    /** Section heading; omit for an ungrouped flat list. */
+    label?: string;
+    items: T[];
+}
+export interface AddItemsMenuProps<T> {
+    /** Flat list of addable items. Use `groups` for sectioned lists. */
+    items?: T[];
+    /** Sectioned addable items; takes precedence over `items`. */
+    groups?: AddItemsGroup<T>[];
+    onAdd: (item: T) => void;
+    itemKey: (item: T) => string;
+    itemLabel: (item: T) => ReactNode;
+    itemDescription?: (item: T) => ReactNode;
+    /** Trigger text (default "Add"). */
+    label?: string;
+    /** Append the available-count to the label. */
+    showCount?: boolean;
+    /** Leading glyph on the trigger (default "+"). */
+    icon?: ReactNode;
+    buttonVariant?: ButtonVariant;
+    buttonSize?: ButtonSize;
+    /** Horizontal alignment of the popover (default "right"). */
+    align?: 'left' | 'right';
+    /** Vertical direction (default opens down, flips when cramped). */
+    direction?: 'up' | 'down';
+    emptyLabel?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/**
+ * A "+ Add" trigger that opens a popover of grouped, addable items. Built on the
+ * portal-based {@link Popover}, so it is never clipped by an `overflow` ancestor and
+ * auto-flips + shifts to stay on-screen; the panel caps its own height to the room
+ * Radix reports (`--radix-popover-content-available-height`) and scrolls a long list
+ * in place. Public API unchanged from the previous absolute-positioned version.
+ */
+export declare function AddItemsMenu<T>({ items, groups, onAdd, itemKey, itemLabel, itemDescription, label, showCount, icon, buttonVariant, buttonSize, align, direction, emptyLabel, disabled, className, }: AddItemsMenuProps<T>): import("react").JSX.Element;
+//# sourceMappingURL=AddItemsMenu.d.ts.map

package/dist/react/components/AddItemsMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddItemsMenu.d.ts","sourceRoot":"","sources":["../../../src/react/components/AddItemsMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAGvE,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,8DAA8D;IAC9D,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC7B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;IACzC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAC9B,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,KAAa,EACb,SAAiB,EACjB,IAAU,EACV,aAA2B,EAC3B,UAAiB,EACjB,KAAe,EACf,SAAS,EACT,UAA6B,EAC7B,QAAQ,EACR,SAAS,GACV,EAAE,iBAAiB,CAAC,CAAC,CAAC,+BAkEtB"}

package/dist/react/components/AddItemsMenu.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { cn } from '../lib/cn';
+import { Button } from './Button';
+import { Popover } from './Popover';
+/**
+ * A "+ Add" trigger that opens a popover of grouped, addable items. Built on the
+ * portal-based {@link Popover}, so it is never clipped by an `overflow` ancestor and
+ * auto-flips + shifts to stay on-screen; the panel caps its own height to the room
+ * Radix reports (`--radix-popover-content-available-height`) and scrolls a long list
+ * in place. Public API unchanged from the previous absolute-positioned version.
+ */
+export function AddItemsMenu({ items, groups, onAdd, itemKey, itemLabel, itemDescription, label = 'Add', showCount = false, icon = '+', buttonVariant = 'secondary', buttonSize = 'sm', align = 'right', direction, emptyLabel = 'Nothing to add', disabled, className, }) {
+    const [open, setOpen] = useState(false);
+    const resolvedGroups = groups ?? (items ? [{ items }] : []);
+    const count = resolvedGroups.reduce((n, g) => n + g.items.length, 0);
+    return (_jsx(Popover, { open: open, onOpenChange: setOpen, align: align === 'left' ? 'start' : 'end', side: direction === 'up' ? 'top' : 'bottom', sideOffset: 6, arrow: false, 
+        // Inside a floating panel, a raw overflow-y-auto is the correct mechanism (the
+        // panel is outside the page's ScrollArea and has no keyboard-inset concern); the
+        // height cap comes from Radix's reported available height.
+        className: cn('max-h-[var(--radix-popover-content-available-height)] w-64 max-w-[90vw] overflow-y-auto p-0'), trigger: _jsx(Button, { variant: buttonVariant, size: buttonSize, leftIcon: icon, disabled: disabled, className: cn('inline-flex', className), children: showCount ? `${label} (${count})` : label }), children: _jsx("div", { className: 'py-1 text-sm', children: count === 0 ? (_jsx("p", { className: 'px-3 py-2 text-muted-foreground', children: emptyLabel })) : (resolvedGroups.map((group, gi) => (_jsxs("div", { children: [group.label ? (_jsx("p", { className: 'px-3 pt-2 pb-1 text-xs font-semibold uppercase tracking-wide text-muted-foreground', children: group.label })) : null, group.items.map((item) => (_jsxs("button", { type: 'button', onClick: () => {
+                            onAdd(item);
+                            setOpen(false);
+                        }, className: 'block w-full px-3 py-2 text-left hover:bg-muted', children: [_jsx("span", { className: 'block truncate text-popover-foreground', children: itemLabel(item) }), itemDescription ? (_jsx("span", { className: 'block truncate text-xs text-muted-foreground', children: itemDescription(item) })) : null] }, itemKey(item))))] }, group.label ?? `group-${gi}`)))) }) }));
+}
+//# sourceMappingURL=AddItemsMenu.js.map

package/dist/react/components/AddItemsMenu.js.map

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

package/dist/react/components/Alert.d.ts

@@ -0,0 +1,28 @@
+import type { ReactNode } from 'react';
+declare const TONE: {
+    readonly info: "border-accent/40 bg-accent/5 [&_.alert-icon]:text-accent";
+    readonly success: "border-success/40 bg-success/5 [&_.alert-icon]:text-success";
+    readonly warning: "border-warning/40 bg-warning/5 [&_.alert-icon]:text-warning";
+    readonly error: "border-destructive/40 bg-destructive/5 [&_.alert-icon]:text-destructive";
+    readonly muted: "border-border bg-muted [&_.alert-icon]:text-muted-foreground";
+};
+export type AlertTone = keyof typeof TONE;
+export interface AlertProps {
+    /** Semantic tone — drives the border/tint + the default icon. Defaults to `info`. */
+    tone?: AlertTone;
+    /** Optional bold heading above the body. */
+    title?: ReactNode;
+    /** Leading icon. Omit for the tone's default; pass `false` for no icon. */
+    icon?: ReactNode | false;
+    /** Trailing-row action nodes (buttons/links) shown under the body. */
+    actions?: ReactNode;
+    /** Show a ✕ that calls this on click. */
+    onDismiss?: () => void;
+    /** Accessible name for the dismiss ✕ (default "Dismiss"). */
+    dismissLabel?: string;
+    className?: string;
+    children?: ReactNode;
+}
+export declare function Alert({ tone, title, icon, actions, onDismiss, dismissLabel, className, children, }: AlertProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Alert.d.ts.map

package/dist/react/components/Alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../src/react/components/Alert.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,QAAA,MAAM,IAAI;;;;;;CAMA,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,IAAI,CAAC;AAU1C,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IACzB,sEAAsE;IACtE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAa,EACb,KAAK,EACL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,YAAwB,EACxB,SAAS,EACT,QAAQ,GACT,EAAE,UAAU,+BA6BZ"}

package/dist/react/components/Alert.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { AlertTriangle, CheckCircle, Info, X, XCircle } from 'lucide-react';
+import { cn } from '../lib/cn';
+/*
+ * Alert — a tonal status banner / callout. Color + an icon + text (never color
+ * alone). Every tone reads a semantic token, so `info` follows the app's accent
+ * and the rest follow success/warning/destructive — light/dark + rebrand for free.
+ * The `.alert-icon` hook colors both the leading icon and the dismiss ✕ per tone.
+ */
+const TONE = {
+    info: 'border-accent/40 bg-accent/5 [&_.alert-icon]:text-accent',
+    success: 'border-success/40 bg-success/5 [&_.alert-icon]:text-success',
+    warning: 'border-warning/40 bg-warning/5 [&_.alert-icon]:text-warning',
+    error: 'border-destructive/40 bg-destructive/5 [&_.alert-icon]:text-destructive',
+    muted: 'border-border bg-muted [&_.alert-icon]:text-muted-foreground',
+};
+const DEFAULT_ICON = {
+    info: _jsx(Info, {}),
+    success: _jsx(CheckCircle, {}),
+    warning: _jsx(AlertTriangle, {}),
+    error: _jsx(XCircle, {}),
+    muted: _jsx(Info, {}),
+};
+export function Alert({ tone = 'info', title, icon, actions, onDismiss, dismissLabel = 'Dismiss', className, children, }) {
+    return (_jsxs("div", { 
+        // Errors are assertive (`alert`); the rest are polite live regions (`status`).
+        role: tone === 'error' ? 'alert' : 'status', className: cn('flex gap-3 rounded-lg border p-4', TONE[tone], className), children: [icon !== false && (_jsx("span", { className: 'alert-icon mt-0.5 shrink-0 [&_svg]:size-4', children: icon ?? DEFAULT_ICON[tone] })), _jsxs("div", { className: 'flex min-w-0 flex-1 flex-col gap-1', children: [title && _jsx("p", { className: 'text-sm font-medium text-foreground', children: title }), children && _jsx("div", { className: 'text-sm text-muted-foreground', children: children }), actions && _jsx("div", { className: 'mt-2 flex flex-wrap gap-2', children: actions })] }), onDismiss && (_jsx("button", { type: 'button', onClick: onDismiss, "aria-label": dismissLabel, className: 'alert-icon shrink-0 rounded transition-opacity hover:opacity-70 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring', children: _jsx(X, { className: 'size-4' }) }))] }));
+}
+//# sourceMappingURL=Alert.js.map

package/dist/react/components/Alert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alert.js","sourceRoot":"","sources":["../../../src/react/components/Alert.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,0DAA0D;IAChE,OAAO,EAAE,6DAA6D;IACtE,OAAO,EAAE,6DAA6D;IACtE,KAAK,EAAE,yEAAyE;IAChF,KAAK,EAAE,8DAA8D;CAC7D,CAAC;AAIX,MAAM,YAAY,GAAiC;IACjD,IAAI,EAAE,KAAC,IAAI,KAAG;IACd,OAAO,EAAE,KAAC,WAAW,KAAG;IACxB,OAAO,EAAE,KAAC,aAAa,KAAG;IAC1B,KAAK,EAAE,KAAC,OAAO,KAAG;IAClB,KAAK,EAAE,KAAC,IAAI,KAAG;CAChB,CAAC;AAmBF,MAAM,UAAU,KAAK,CAAC,EACpB,IAAI,GAAG,MAAM,EACb,KAAK,EACL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,YAAY,GAAG,SAAS,EACxB,SAAS,EACT,QAAQ,GACG;IACX,OAAO,CACL;QACE,+EAA+E;QAC/E,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAC3C,SAAS,EAAE,EAAE,CAAC,kCAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,aAEvE,IAAI,KAAK,KAAK,IAAI,CACjB,eAAM,SAAS,EAAC,2CAA2C,YACxD,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,GACtB,CACR,EACD,eAAK,SAAS,EAAC,oCAAoC,aAChD,KAAK,IAAI,YAAG,SAAS,EAAC,qCAAqC,YAAE,KAAK,GAAK,EACvE,QAAQ,IAAI,cAAK,SAAS,EAAC,+BAA+B,YAAE,QAAQ,GAAO,EAC3E,OAAO,IAAI,cAAK,SAAS,EAAC,2BAA2B,YAAE,OAAO,GAAO,IAClE,EACL,SAAS,IAAI,CACZ,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,SAAS,gBACN,YAAY,EACxB,SAAS,EAAC,yIAAyI,YAEnJ,KAAC,CAAC,IAAC,SAAS,EAAC,QAAQ,GAAG,GACjB,CACV,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/react/components/AppShell.d.ts

@@ -0,0 +1,118 @@
+import type { ElementType, ReactNode, Ref } from 'react';
+import type { GateFn, NavigationModel, NavPreferences } from '../../core/navigation';
+import type { IconResolver } from '../nav/navShared';
+import { type ScrollAreaSpace } from './ScrollArea';
+export interface AppShellProps {
+    /** Routed page content. Scrolls inside the single keyboard-safe `ScrollArea`. */
+    children: ReactNode;
+    /**
+     * The navigation model — the single `navigationModel` registry generalized to the
+     * UX north-star's **small fixed place-set** (Today/Library/People/Calendar/Play +
+     * a role-gated Operate). The shell renders it as the slim desktop **place rail**
+     * (`SideNav`, md+) and the mobile capture-forward **`PlaceBar`** (below md) — never
+     * a 256px hub list and never a hamburger drawer. Omit for chromeless pages.
+     */
+    nav?: NavigationModel;
+    /** Visibility gate (auth/role/ctgr) applied to the nav model. Default: allow all. */
+    navGate?: GateFn;
+    /** Current route — the active place lights up. */
+    activeHref?: string;
+    /** Navigate callback (router-less hosts) — nav rows/tabs call it on click. */
+    onNavigate?: (path: string) => void;
+    /** SPA link component (e.g. react-router `Link`) for the nav rows/tabs. */
+    navLinkComponent?: ElementType;
+    /** Resolve model icon *names* to nodes for the nav rows/tabs. */
+    resolveIcon?: IconResolver;
+    /** Per-user place customization (order/hide/color) for the desktop rail. */
+    navPrefs?: NavPreferences;
+    onNavPrefsChange?: (next: NavPreferences) => void;
+    /** Dynamic per-place badge (unread counts), keyed by domain id. */
+    navBadges?: Record<string, number | string>;
+    /** Brand slot — top-left of the command spine (logo / app name). */
+    navHeader?: ReactNode;
+    /** Slot at the bottom of the desktop place rail (theme toggle, secondary links). */
+    navFooter?: ReactNode;
+    /**
+     * Universal capture (UX north-star §8.2) — wired to the command spine's capture
+     * hero (desktop) and the `PlaceBar`'s raised centre FAB (mobile). Capture is a
+     * first-class verb, present on every surface; omit only for chromeless shells.
+     */
+    onCapture?: () => void;
+    /** Capture affordance label. Default `'Capture'`. */
+    captureLabel?: string;
+    /**
+     * Open the command palette — the typed second-equal way to move (§7). Wire to
+     * `useCommandPalette().toggle`; the shell renders the visible ⌘K spine trigger from
+     * it (the palette itself goes in `palette`). Omit to hide the command field.
+     */
+    onOpenCommand?: () => void;
+    /** Command/search field placeholder. Default `'Search or run a command…'`. */
+    commandLabel?: string;
+    /** Keyboard hint on the command field. Default `'⌘K'`. */
+    commandHint?: ReactNode;
+    /** App slot at the trailing edge of the command spine (e.g. presence dots). */
+    commandBarExtra?: ReactNode;
+    /** Account chrome behind the avatar (profile/settings/sign-out) — NOT a nav door
+     *  (§6). Rendered at the trailing edge of the top spine. */
+    account?: ReactNode;
+    /**
+     * Bottom dock slot (e.g. ShortcutDock, ActionBar), rendered ABOVE the mobile
+     * `PlaceBar`. The shell owns the bottom safe-area inset here — nothing else adds
+     * bottom safe-area padding (dock/PlaceBar render their content only).
+     */
+    bottomDock?: ReactNode;
+    /**
+     * Render slot for the one `CommandPalette` instance (task 14). Pair it with
+     * `useCommandPalette()` and pass `toggle` as `onOpenCommand` so the visible spine
+     * trigger and Cmd/Ctrl-K both open it. It portals its own Dialog, so its position
+     * in the tree is immaterial.
+     */
+    palette?: ReactNode;
+    /** Max places in the mobile `PlaceBar` thumb zone (rest reachable via command). Default 5. */
+    placeBarMax?: number;
+    /** ScrollArea comfort-space preset for the main content region. Default: `default`. */
+    scrollSpace?: ScrollAreaSpace;
+    /** Expose the main scroll container's ref for programmatic scroll. */
+    scrollRef?: Ref<HTMLDivElement>;
+    className?: string;
+}
+/**
+ * THE single application shell. One per app — reconciled to the UX north-star
+ * (`cursedalchemy/UX_NORTH_STAR.md`, §§6–7, 10; reconciliation #311 + `SHELL.md`).
+ *
+ * **What changed, and why** (the old form was kept by inertia and failed the §12
+ * anti-anchoring gate, not preserved as optimal):
+ * - The fixed **256px hub-list sidebar** → a slim, quiet **place rail** (the small
+ *   fixed place-set is a defended spatial anchor; the *hub-list form* is not).
+ * - The **hamburger → `translate-x` drawer** → the capture-forward **`PlaceBar`**: the
+ *   place-set in the thumb zone around a raised centre capture FAB (mobile is
+ *   capture-forward, not tab-forward — §7).
+ * - The buried, invisible ⌘K palette + no capture → the first-class **`CommandBar`
+ *   spine**: a visible command/search field (the co-equal second way to move) + a
+ *   capture hero (universal capture, §8.2).
+ * - The avatar-in-nav → **account chrome** behind the avatar in the spine (not a door).
+ *
+ * What is *kept* (proven optimal, §11): the single `navigationModel` registry + its
+ * coverage test (anti-drift substrate), per-user place prefs, badges, and the
+ * keyboard-safe single `ScrollArea`. Capabilities preserved; form reimagined.
+ *
+ * Layout model:
+ * ```
+ *   <div h-dvh flex flex-col overflow-hidden>     ← dvh excludes the mobile URL bar
+ *     <header />                                    ← brand + CommandBar spine + account
+ *     <div flex min-h-0 grow>                       ← rail + content row
+ *       <aside hidden md:flex w-60>                 ← slim place rail (SideNav, md+ only)
+ *       <main><ScrollArea>{children}</ScrollArea></main>  ← THE ONLY page scroll container
+ *     </div>
+ *     <div pb-[safe-area]>                          ← bottomDock + mobile PlaceBar
+ *       {bottomDock}
+ *       <PlaceBar md:hidden />                       ← capture-forward bottom bar
+ *     </div>
+ *   </div>
+ * ```
+ *
+ * Keyboard model: `useKeyboardInset` (installed exactly once, here) writes
+ * `--keyboard-inset` onto `<html>`; `ScrollArea` reads it via CSS `calc()`.
+ */
+export declare function AppShell({ children, nav, navGate, activeHref, onNavigate, navLinkComponent, resolveIcon, navPrefs, onNavPrefsChange, navBadges, navHeader, navFooter, onCapture, captureLabel, onOpenCommand, commandLabel, commandHint, commandBarExtra, account, bottomDock, palette, placeBarMax, scrollSpace, scrollRef, className, }: AppShellProps): import("react").JSX.Element;
+//# sourceMappingURL=AppShell.d.ts.map

package/dist/react/components/AppShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/react/components/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,eAAe,CAAC;IAEtB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAE/B,iEAAiE;IACjE,WAAW,CAAC,EAAE,YAAY,CAAC;IAE3B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAElD,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAE5C,oEAAoE;IACpE,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,oFAAoF;IACpF,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,SAAS,CAAC;IAE5B;gEAC4D;IAC5D,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uFAAuF;IACvF,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,sEAAsE;IACtE,SAAS,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,GAAG,EACH,OAAO,EACP,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,OAAO,EACP,UAAU,EACV,OAAO,EACP,WAAe,EACf,WAAuB,EACvB,SAAS,EACT,SAAS,GACV,EAAE,aAAa,+BAiGf"}

package/dist/react/components/AppShell.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useKeyboardInset } from '../hooks/useKeyboardInset';
+import { cn } from '../lib/cn';
+import { CommandBar } from '../nav/CommandBar';
+import { PlaceBar } from '../nav/PlaceBar';
+import { SideNav } from '../nav/SideNav';
+import { ScrollArea } from './ScrollArea';
+// The desktop place rail is a *small spatial floor* (a handful of places), not the old
+// 256px hub list — slimmer + quiet, with the command spine carrying the second way to move.
+const RAIL_WIDTH = 'w-60'; // 240px
+/**
+ * THE single application shell. One per app — reconciled to the UX north-star
+ * (`cursedalchemy/UX_NORTH_STAR.md`, §§6–7, 10; reconciliation #311 + `SHELL.md`).
+ *
+ * **What changed, and why** (the old form was kept by inertia and failed the §12
+ * anti-anchoring gate, not preserved as optimal):
+ * - The fixed **256px hub-list sidebar** → a slim, quiet **place rail** (the small
+ *   fixed place-set is a defended spatial anchor; the *hub-list form* is not).
+ * - The **hamburger → `translate-x` drawer** → the capture-forward **`PlaceBar`**: the
+ *   place-set in the thumb zone around a raised centre capture FAB (mobile is
+ *   capture-forward, not tab-forward — §7).
+ * - The buried, invisible ⌘K palette + no capture → the first-class **`CommandBar`
+ *   spine**: a visible command/search field (the co-equal second way to move) + a
+ *   capture hero (universal capture, §8.2).
+ * - The avatar-in-nav → **account chrome** behind the avatar in the spine (not a door).
+ *
+ * What is *kept* (proven optimal, §11): the single `navigationModel` registry + its
+ * coverage test (anti-drift substrate), per-user place prefs, badges, and the
+ * keyboard-safe single `ScrollArea`. Capabilities preserved; form reimagined.
+ *
+ * Layout model:
+ * ```
+ *   <div h-dvh flex flex-col overflow-hidden>     ← dvh excludes the mobile URL bar
+ *     <header />                                    ← brand + CommandBar spine + account
+ *     <div flex min-h-0 grow>                       ← rail + content row
+ *       <aside hidden md:flex w-60>                 ← slim place rail (SideNav, md+ only)
+ *       <main><ScrollArea>{children}</ScrollArea></main>  ← THE ONLY page scroll container
+ *     </div>
+ *     <div pb-[safe-area]>                          ← bottomDock + mobile PlaceBar
+ *       {bottomDock}
+ *       <PlaceBar md:hidden />                       ← capture-forward bottom bar
+ *     </div>
+ *   </div>
+ * ```
+ *
+ * Keyboard model: `useKeyboardInset` (installed exactly once, here) writes
+ * `--keyboard-inset` onto `<html>`; `ScrollArea` reads it via CSS `calc()`.
+ */
+export function AppShell({ children, nav, navGate, activeHref, onNavigate, navLinkComponent, resolveIcon, navPrefs, onNavPrefsChange, navBadges, navHeader, navFooter, onCapture, captureLabel, onOpenCommand, commandLabel, commandHint, commandBarExtra, account, bottomDock, palette, placeBarMax = 5, scrollSpace = 'default', scrollRef, className, }) {
+    useKeyboardInset();
+    const showSpine = Boolean(navHeader || account || onOpenCommand || onCapture || commandBarExtra);
+    const showBottom = Boolean(bottomDock || nav);
+    return (_jsxs("div", { "data-cb-appshell": '', className: cn('flex h-dvh flex-col overflow-hidden bg-background text-foreground', className), children: [showSpine && (_jsxs("header", { "data-cb-appheader": '', className: 'relative z-30 flex shrink-0 items-center gap-3 border-b border-border px-3 py-2', children: [navHeader && _jsx("div", { className: 'shrink-0', children: navHeader }), _jsx(CommandBar, { className: 'min-w-0 flex-1', onCapture: onCapture, captureLabel: captureLabel, 
+                        // On mobile the PlaceBar FAB owns capture — don't duplicate it in the spine.
+                        captureDesktopOnly: Boolean(nav), onOpenCommand: onOpenCommand, commandPlaceholder: commandLabel, commandHint: commandHint, extra: commandBarExtra }), account && (_jsx("div", { "data-cb-account": '', className: 'shrink-0', children: account }))] })), _jsxs("div", { className: 'relative flex min-h-0 grow overflow-hidden', children: [nav && (_jsx("aside", { "data-cb-nav-rail": '', className: cn('hidden border-r border-border bg-background md:flex md:shrink-0 md:flex-col', RAIL_WIDTH), children: _jsx(SideNav, { model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, prefs: navPrefs, onPrefsChange: onNavPrefsChange, badges: navBadges, footer: navFooter }) })), _jsx("main", { className: 'flex min-h-0 grow flex-col', children: _jsx(ScrollArea, { space: scrollSpace, scrollRef: scrollRef, children: children }) })] }), showBottom && (_jsxs("div", { className: 'shrink-0 pb-[env(safe-area-inset-bottom,0px)]', children: [bottomDock && _jsx("div", { className: 'border-t border-border', children: bottomDock }), nav && (_jsx(PlaceBar, { className: 'border-t border-border md:hidden', model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, badges: navBadges, onCapture: onCapture, captureLabel: captureLabel, max: placeBarMax }))] })), palette] }));
+}
+//# sourceMappingURL=AppShell.js.map

package/dist/react/components/AppShell.js.map

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

package/dist/react/components/AutoGrowTextarea.d.ts

@@ -0,0 +1,31 @@
+import { type ComponentPropsWithRef } from 'react';
+export interface AutoGrowTextareaProps extends ComponentPropsWithRef<'textarea'> {
+    /** Cap growth at this many px; past the cap the textarea scrolls internally. */
+    maxHeight?: number;
+}
+/**
+ * A textarea that grows with its content instead of scrolling internally, so it
+ * never traps the page scroll on mobile (a fixed-height textarea steals the drag —
+ * dragging over it scrolls IT, not the page). The registry's `longtext` control and
+ * the drop-in for a raw prose/message/notes `<textarea>` — forwards all props/refs.
+ *
+ * Carries the field-style tokens ({@link FIELD_CLASS}) + a `min-h-20` floor by
+ * default, so it matches Input/Select out of the box; pass `className` to extend or
+ * override (e.g. a taller floor, monospace). For fixed-height code/JSON editors keep
+ * a raw `<textarea>`; this is for fields that should shrink-wrap their content.
+ *
+ * The companion to {@link ScrollArea}: while typing into a tall, growing field it
+ * keeps the caret line visible above the on-screen keyboard — the same
+ * `scrollIntoView` ScrollArea fires on focus, re-fired here as the field grows.
+ *
+ * Growth is capped by `maxHeight` (px) when given, else by the element's own CSS
+ * `max-height` (a `max-h-*` class — `getComputedStyle` resolves vh/rem to px); past
+ * the cap it scrolls internally. When `maxHeight` is given it is ALSO written as a
+ * CSS `max-height`, so the cap holds before/without JS (first paint, SSR) — both the
+ * JS height-setting and the CSS fallback are needed.
+ *
+ * Defaults to maxLength=10_000 — enough for messages/notes/comments. Override
+ * explicitly for long-form editors (e.g. maxLength={200_000} for Markdown).
+ */
+export declare function AutoGrowTextarea({ maxHeight, ref, value, className, maxLength, ...props }: AutoGrowTextareaProps): import("react").JSX.Element;
+//# sourceMappingURL=AutoGrowTextarea.d.ts.map

package/dist/react/components/AutoGrowTextarea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoGrowTextarea.d.ts","sourceRoot":"","sources":["../../../src/react/components/AutoGrowTextarea.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAA2B,MAAM,OAAO,CAAC;AAI5E,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB,CAAC,UAAU,CAAC;IAC9E,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,SAAkB,EAClB,GAAG,KAAK,EACT,EAAE,qBAAqB,+BAsDvB"}

package/dist/react/components/AutoGrowTextarea.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useLayoutEffect, useRef } from 'react';
+import { cn } from '../lib/cn';
+import { FIELD_CLASS } from '../lib/field';
+/**
+ * A textarea that grows with its content instead of scrolling internally, so it
+ * never traps the page scroll on mobile (a fixed-height textarea steals the drag —
+ * dragging over it scrolls IT, not the page). The registry's `longtext` control and
+ * the drop-in for a raw prose/message/notes `<textarea>` — forwards all props/refs.
+ *
+ * Carries the field-style tokens ({@link FIELD_CLASS}) + a `min-h-20` floor by
+ * default, so it matches Input/Select out of the box; pass `className` to extend or
+ * override (e.g. a taller floor, monospace). For fixed-height code/JSON editors keep
+ * a raw `<textarea>`; this is for fields that should shrink-wrap their content.
+ *
+ * The companion to {@link ScrollArea}: while typing into a tall, growing field it
+ * keeps the caret line visible above the on-screen keyboard — the same
+ * `scrollIntoView` ScrollArea fires on focus, re-fired here as the field grows.
+ *
+ * Growth is capped by `maxHeight` (px) when given, else by the element's own CSS
+ * `max-height` (a `max-h-*` class — `getComputedStyle` resolves vh/rem to px); past
+ * the cap it scrolls internally. When `maxHeight` is given it is ALSO written as a
+ * CSS `max-height`, so the cap holds before/without JS (first paint, SSR) — both the
+ * JS height-setting and the CSS fallback are needed.
+ *
+ * Defaults to maxLength=10_000 — enough for messages/notes/comments. Override
+ * explicitly for long-form editors (e.g. maxLength={200_000} for Markdown).
+ */
+export function AutoGrowTextarea({ maxHeight, ref, value, className, maxLength = 10_000, ...props }) {
+    const innerRef = useRef(null);
+    // useLayoutEffect (not useEffect) so the measured height is applied before paint —
+    // no one-frame flash of a wrong-height textarea. Keyed on `value` so a programmatic
+    // value change (loading a different note) re-fits; the native `input` listener
+    // grows an UNCONTROLLED textarea while typing; `resize` re-wraps vw/% widths on
+    // rotate. (`innerRef` is a stable useRef — not a dep.)
+    useLayoutEffect(() => {
+        const el = innerRef.current;
+        if (!el)
+            return;
+        // Enforce the prop cap as CSS too, so it holds before/without JS.
+        if (maxHeight != null)
+            el.style.maxHeight = `${maxHeight}px`;
+        const resize = () => {
+            // Collapse first so scrollHeight reflects content, not the current height.
+            el.style.height = 'auto';
+            // Cap: explicit prop wins, else the element's CSS max-height (max-h-*);
+            // 'none' → NaN → no cap.
+            const cssMax = Number.parseFloat(getComputedStyle(el).maxHeight);
+            const cap = maxHeight ?? (Number.isFinite(cssMax) ? cssMax : Number.POSITIVE_INFINITY);
+            el.style.height = `${Math.min(el.scrollHeight, cap)}px`;
+            el.style.overflowY = el.scrollHeight > cap ? 'auto' : 'hidden';
+            // Caret tracking: while focused, keep the caret line visible above the
+            // keyboard as the field grows. `block:'nearest'` is a no-op when already in
+            // view; ScrollArea's scroll-padding-bottom parks it clear of the keyboard.
+            if (document.activeElement === el)
+                el.scrollIntoView({ block: 'nearest' });
+        };
+        resize();
+        el.addEventListener('input', resize);
+        window.addEventListener('resize', resize);
+        return () => {
+            el.removeEventListener('input', resize);
+            window.removeEventListener('resize', resize);
+        };
+    }, [value, maxHeight]);
+    const setRef = (node) => {
+        innerRef.current = node;
+        if (typeof ref === 'function')
+            ref(node);
+        else if (ref)
+            ref.current = node;
+    };
+    return (_jsx("textarea", { ref: setRef, value: value, maxLength: maxLength, className: cn(FIELD_CLASS, 'min-h-20 resize-none', className), ...props }));
+}
+//# sourceMappingURL=AutoGrowTextarea.js.map

package/dist/react/components/AutoGrowTextarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoGrowTextarea.js","sourceRoot":"","sources":["../../../src/react/components/AutoGrowTextarea.tsx"],"names":[],"mappings":";AAAA,OAAO,EAA8B,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAO3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,SAAS,EACT,GAAG,EACH,KAAK,EACL,SAAS,EACT,SAAS,GAAG,MAAM,EAClB,GAAG,KAAK,EACc;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAC;IAEnD,mFAAmF;IACnF,oFAAoF;IACpF,+EAA+E;IAC/E,gFAAgF;IAChF,uDAAuD;IACvD,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,kEAAkE;QAClE,IAAI,SAAS,IAAI,IAAI;YAAE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,SAAS,IAAI,CAAC;QAE7D,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,2EAA2E;YAC3E,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YACzB,wEAAwE;YACxE,yBAAyB;YACzB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YACjE,MAAM,GAAG,GAAG,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACvF,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC;YACxD,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/D,uEAAuE;YACvE,4EAA4E;YAC5E,2EAA2E;YAC3E,IAAI,QAAQ,CAAC,aAAa,KAAK,EAAE;gBAAE,EAAE,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7E,CAAC,CAAC;QAEF,MAAM,EAAE,CAAC;QACT,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACV,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAEvB,MAAM,MAAM,GAAG,CAAC,IAAgC,EAAE,EAAE;QAClD,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,UAAU;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC;aACpC,IAAI,GAAG;YAAG,GAA+C,CAAC,OAAO,GAAG,IAAI,CAAC;IAChF,CAAC,CAAC;IAEF,OAAO,CACL,mBACE,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,EAAE,CAAC,WAAW,EAAE,sBAAsB,EAAE,SAAS,CAAC,KACzD,KAAK,GACT,CACH,CAAC;AACJ,CAAC"}

package/dist/react/components/Badge.d.ts

@@ -0,0 +1,27 @@
+import type { HTMLAttributes } from 'react';
+declare const BADGE_TONE: {
+    readonly default: "bg-muted text-muted-foreground";
+    readonly neutral: "bg-muted text-muted-foreground";
+    readonly primary: "bg-accent-solid text-white";
+    readonly accent: "bg-accent/10 text-accent";
+    readonly success: "bg-success/15 text-success border border-success/30";
+    readonly warning: "bg-warning/15 text-warning border border-warning/30";
+    readonly error: "bg-destructive/15 text-destructive border border-destructive/30";
+    readonly destructive: "bg-destructive/15 text-destructive border border-destructive/30";
+    readonly outline: "border border-border text-foreground bg-transparent";
+    readonly emerald: "bg-emerald-100 text-emerald-700 dark:bg-emerald-900/40 dark:text-emerald-300";
+    readonly sky: "bg-sky-100 text-sky-700 dark:bg-sky-900/40 dark:text-sky-300";
+    readonly cyan: "bg-cyan-100 text-cyan-700 dark:bg-cyan-900/40 dark:text-cyan-300";
+    readonly amber: "bg-amber-100 text-amber-800 dark:bg-amber-900/40 dark:text-amber-300";
+    readonly purple: "bg-purple-100 text-purple-700 dark:bg-purple-900/40 dark:text-purple-300";
+    readonly rose: "bg-rose-100 text-rose-700 dark:bg-rose-900/40 dark:text-rose-300";
+    readonly slate: "bg-slate-200 text-slate-800 dark:bg-slate-800 dark:text-slate-200";
+};
+export type BadgeTone = keyof typeof BADGE_TONE;
+export interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
+    /** Semantic or categorical tone (default `default`). */
+    tone?: BadgeTone;
+}
+export declare function Badge({ tone, className, ...props }: BadgeProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Badge.d.ts.map

package/dist/react/components/Badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../src/react/components/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAkB5C,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;CAmBN,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,UAAU,CAAC;AAEhD,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAC,eAAe,CAAC;IACjE,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,wBAAgB,KAAK,CAAC,EAAE,IAAgB,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,UAAU,+BAW1E"}