@rinzai/zen 0.3.2 → 0.4.0

package/dist/toast/index.d.ts

@@ -11,10 +11,18 @@ export interface ToastOptions {
     /** Milliseconds before it goes away; 0 keeps it until dismissed. */
     timeout?: number;
 }
-/** Mount once near the root; `useToast()` works anywhere inside. */
-export default function ToastProvider({ children }: {
+export interface ToastProviderProps {
     children: ReactNode;
-}): import('react').JSX.Element;
+    /**
+     * Gap between the toasts and the bottom of the screen on phones (a CSS
+     * length, default 1rem), e.g. "5.5rem" to clear a bottom tab bar.
+     */
+    offset?: string;
+    /** Classes for the column the toasts stack in (position, width…). */
+    viewportClassName?: string;
+}
+/** Mount once near the root; `useToast()` works anywhere inside. */
+export default function ToastProvider({ children, offset, viewportClassName }: ToastProviderProps): import('react').JSX.Element;
 /** Returns `toast(title, options)`, which shows a toast and returns its id. */
 export declare function useToast(): (title: string, options?: ToastOptions) => number;
 //# sourceMappingURL=index.d.ts.map

package/dist/toast/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/toast/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAwD,MAAM,OAAO,CAAC;AAGvG,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,YAAY;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAChD,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,oEAAoE;AACpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BA4C1E;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,YAlDoB,MAAM,YAAY,YAAY,KAAK,MAAM,CAsDpF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/toast/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAgC,SAAS,EAAwD,MAAM,OAAO,CAAC;AAKtH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErD,MAAM,WAAW,YAAY;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAChD,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,oEAAoE;AACpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,kBAAkB,+BAiDhG;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,YAlEoB,MAAM,YAAY,YAAY,KAAK,MAAM,CAsEpF"}

package/dist/tree/index.d.ts

@@ -0,0 +1,79 @@
+import { TableCellProps } from '../table';
+import { ComponentProps, CSSProperties, ReactNode } from 'react';
+/** One visible row of a tree. */
+export interface TreeRowData<T> {
+    item: T;
+    key: string;
+    /** 0 for top-level rows. */
+    depth: number;
+    parentKey: string | null;
+    hasChildren: boolean;
+    expanded: boolean;
+}
+/**
+ * Headless tree for tables and lists: turns nested items into the rows that
+ * are visible (children of collapsed rows are skipped), and expands/collapses
+ * them. With the Tree* parts, children grow in and shrink away smoothly.
+ */
+export declare function useTree<T>({ items, getKey, getChildren, defaultExpanded, rowHeight }: UseTreeOptions<T>): {
+    rows: TreeRowData<T>[];
+    toggle: (key: string) => void;
+    isExpanded: (key: string) => boolean;
+    expand: (key: string) => void;
+    collapse: (key: string) => void;
+    /** Opens every row that has children. */
+    expandAll: () => void;
+    /** Closes every row. */
+    collapseAll: () => void;
+    rowProps: (row: TreeRowData<T>) => {
+        'aria-level': number;
+        'aria-expanded': boolean | undefined;
+        'data-depth': number;
+        className: string;
+        style: CSSProperties;
+        onAnimationEnd: (e: {
+            animationName: string;
+        }) => void;
+    };
+    toggleProps: (row: TreeRowData<T>) => {
+        expanded: boolean;
+        onToggle: () => void;
+    };
+    rowHeight: number;
+};
+export type Tree<T> = ReturnType<typeof useTree<T>>;
+/** A table row wired to useTree: tree semantics (aria-level, aria-expanded) and the open/close animation. */
+export declare function TreeRow<T>({ row, tree, className, style, ...rest }: TreeRowProps<T>): import('react').JSX.Element;
+/** A cell in a TreeRow: its content sits in a box whose height animates as groups open and close. */
+export declare function TreeCell({ numeric, className, children, ...rest }: TableCellProps): import('react').JSX.Element;
+/** The first column's content: indented by depth, with the row's toggle (or a spacer, so labels line up). */
+export declare function TreeLabel<T>({ row, tree, indent, children, className }: TreeLabelProps<T>): import('react').JSX.Element;
+/** Chevron button that opens and closes a row: points right when closed, down when open. */
+export declare function TreeToggle({ expanded, onToggle, className, ...rest }: TreeToggleProps): import('react').JSX.Element;
+export interface UseTreeOptions<T> {
+    items: readonly T[];
+    getKey: (item: T) => string;
+    /** Children of an item (undefined or empty for a leaf). */
+    getChildren: (item: T) => readonly T[] | undefined;
+    /** Whether rows start open. */
+    defaultExpanded?: boolean;
+    /** Row height in px, for the open/close animation. */
+    rowHeight?: number;
+}
+export interface TreeRowProps<T> extends ComponentProps<'tr'> {
+    row: TreeRowData<T>;
+    tree: Tree<T>;
+}
+export interface TreeLabelProps<T> {
+    row: TreeRowData<T>;
+    tree: Tree<T>;
+    /** Indent per level, in px. */
+    indent?: number;
+    children?: ReactNode;
+    className?: string;
+}
+export interface TreeToggleProps extends Omit<ComponentProps<'button'>, 'onToggle'> {
+    expanded: boolean;
+    onToggle: () => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/tree/index.d.ts.map

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

package/dist/utils/cx.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Joins class names (strings, arrays, { name: condition } objects), skipping
+ * falsy ones. Conflicting Tailwind classes resolve to the last one, so a
+ * className passed in overrides a component's defaults (see mergeClasses).
+ */
 export declare const cx: (...args: ClassValue[]) => string;
 export type ClassValue = ClassArray | ClassDictionary | string | number | null | boolean | undefined;
 export type ClassDictionary = Record<string, unknown>;

package/dist/utils/cx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cx.d.ts","sourceRoot":"","sources":["../../packages/utils/cx.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,UAAU,EAAE,KAAG,MAmB1C,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;AACrG,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtD,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC"}
+{"version":3,"file":"cx.d.ts","sourceRoot":"","sources":["../../packages/utils/cx.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,UAAU,EAAE,KAAG,MAAkC,CAAC;AAsB9E,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;AACrG,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtD,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC"}

package/dist/utils/field-chevron.d.ts

@@ -0,0 +1,6 @@
+/** Chevron for popup fields (select, month picker): turns over while the popup is open. */
+export declare function FieldChevron({ open, className }: {
+    open?: boolean;
+    className?: string;
+}): import('react').JSX.Element;
+//# sourceMappingURL=field-chevron.d.ts.map

package/dist/utils/field-chevron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-chevron.d.ts","sourceRoot":"","sources":["../../packages/utils/field-chevron.tsx"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAmBvF"}

package/dist/utils/graphics.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Graphics mode: with hardware acceleration off, the browser draws on the CPU,
+ * where live blurs, full-screen masks and constant animation turn every frame
+ * into a stall. Zen then switches to "lite": solid tints instead of blur, a
+ * still backdrop, no pointer light (see the html[data-zen-graphics='lite'] rules
+ * in index.css). Set data-zen-graphics on <html> yourself to force a mode.
+ */
+export type GraphicsMode = 'full' | 'lite';
+/** Whether the GPU is doing the drawing, checked once (a throwaway WebGL context). */
+export declare function detectGraphicsMode(): GraphicsMode;
+/**
+ * Marks <html> with the graphics mode, unless the app already set one. Called by
+ * the components with costly effects; cheap after the first call.
+ */
+export declare function applyGraphicsMode(): GraphicsMode;
+/** For tests: forget the cached detection. */
+export declare function resetGraphicsMode(): void;
+/** Applies the graphics mode after mount (in components whose effects are costly without a GPU). */
+export declare function useGraphicsMode(): void;
+//# sourceMappingURL=graphics.d.ts.map

package/dist/utils/graphics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphics.d.ts","sourceRoot":"","sources":["../../packages/utils/graphics.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAS3C,sFAAsF;AACtF,wBAAgB,kBAAkB,IAAI,YAAY,CAuBjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,CAQhD;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,SAEhC;AAED,oGAAoG;AACpG,wBAAgB,eAAe,SAI9B"}

package/dist/utils/merge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves Tailwind class conflicts: when two classes set the same property
+ * (under the same variants), the later one wins and the earlier one is
+ * dropped, so `cx('w-full px-3', className)` with className "w-40 p-1" gives
+ * "w-40 p-1". A class that covers several others (p over px, rounded over
+ * rounded-t, border over border-t) removes them when it comes later.
+ *
+ * It knows the core utilities, not every one: classes it doesn't recognise
+ * (your own, plugins, zen__ hooks) are always kept, in order.
+ */
+export declare function mergeClasses(classes: string): string;
+//# sourceMappingURL=merge.d.ts.map

package/dist/utils/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../packages/utils/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BpD"}

package/dist/utils/money.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Money as an integer number of minor units (paise, cents). Never do arithmetic
+ * on floats; only formatting converts to a decimal for display.
+ */
+export type Money = number;
+/** Decimal places the currency uses: 2 for USD and INR, 0 for JPY. */
+export declare function minorDigits(currency: string): number;
+/** With symbol: en-IN gives lakh/crore grouping (₹1,52,000.00); en-US gives $152,000.00. */
+export declare function formatMoney(amount: Money, currency: string, locale: string, { showDecimals }?: {
+    showDecimals?: boolean;
+}): string;
+/** Number without symbol, e.g. "1,52,000" or "32,740.50". Decimals only when non-zero. */
+export declare function formatAmount(amount: Money, currency: string, locale: string): string;
+/** The currency's symbol in a locale: "₹", "$", "US$", "€". */
+export declare function currencySymbol(currency: string, locale: string): string;
+export declare class MoneyParseError extends Error {
+    constructor(input: string);
+}
+/**
+ * Parses user input to minor units using string arithmetic (no float rounding).
+ * Accepts grouping separators (commas, spaces, underscores), a leading sign or
+ * currency symbol, and at most the currency's number of decimals.
+ */
+export declare function parseMoney(input: string, currency: string): Money;
+/**
+ * Like parseMoney, plus shorthand: "1.5L" (lakh), "2cr" (crore), "10k",
+ * "1.2m". Scaling is done by shifting the decimal string, so it stays exact.
+ */
+export declare function parseMoneyInput(input: string, currency: string): Money;
+//# sourceMappingURL=money.d.ts.map

package/dist/utils/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../../packages/utils/money.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CACvB,MAAM,EAAE,KAAK,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,YAAmB,EAAE,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,MAAM,CAQR;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOpF;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC1B,KAAK,EAAE,MAAM;CAI5B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAajE;AAiBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAiBtE"}

package/dist/utils/month.d.ts

@@ -0,0 +1,16 @@
+/** Calendar month as "YYYY-MM". Compares correctly as a string. */
+export type Month = string;
+export declare function isMonth(value: unknown): value is Month;
+/** Months since year 0; lets month arithmetic be plain integer maths. */
+export declare function monthIndex(month: Month): number;
+export declare function fromMonthIndex(index: number): Month;
+export declare function addMonths(month: Month, n: number): Month;
+/** Every month from `from` to `to`, inclusive. Empty if `to` is before `from`. */
+export declare function monthRange(from: Month, to: Month): Month[];
+export declare function monthsBetween(from: Month, to: Month): number;
+export declare function currentMonth(now?: Date): Month;
+/** "Sep 2026" (or the locale's equivalent); "September 2026" with style "long". */
+export declare function formatMonth(month: Month, locale: string, style?: 'short' | 'long'): string;
+/** Short month names for a locale, January first. */
+export declare function monthNames(locale: string): string[];
+//# sourceMappingURL=month.d.ts.map

package/dist/utils/month.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"month.d.ts","sourceRoot":"","sources":["../../packages/utils/month.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAI3B,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAI/C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAGnD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAExD;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,KAAK,EAAE,CAI1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,MAAM,CAE5D;AAED,wBAAgB,YAAY,CAAC,GAAG,GAAE,IAAiB,GAAG,KAAK,CAE1D;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,OAAO,GAAG,MAAgB,GAAG,MAAM,CAKnG;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAGnD"}

package/dist/utils/status-icons.d.ts

@@ -0,0 +1,11 @@
+/** Small 16px status icons in the current text colour (toasts, field errors). */
+export declare function CheckIcon({ className }: {
+    className?: string;
+}): import('react').JSX.Element;
+export declare function AlertIcon({ className }: {
+    className?: string;
+}): import('react').JSX.Element;
+export declare function InfoIcon({ className }: {
+    className?: string;
+}): import('react').JSX.Element;
+//# sourceMappingURL=status-icons.d.ts.map

package/dist/utils/status-icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-icons.d.ts","sourceRoot":"","sources":["../../packages/utils/status-icons.tsx"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAe9D;AAED,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAgB9D;AAED,wBAAgB,QAAQ,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,+BAe7D"}

package/dist/utils/styles.d.ts

@@ -12,4 +12,10 @@ export declare const PILL_TRACK = "relative flex w-fit items-center gap-1 rounde
 export declare const PILL_INDICATOR = "absolute top-1 bottom-1 left-0 rounded-full bg-primary/15 shadow-[inset_0_0_0_1px_oklch(var(--glow)/0.35),0_0_24px_-4px_oklch(var(--glow)/0.6)] transition-[translate,width] duration-500 ease-[cubic-bezier(0.2,0.8,0.2,1)]";
 /** …and items that sit above it. */
 export declare const PILL_ITEM = "relative z-10 rounded-full px-3.5 py-1.5 text-sm whitespace-nowrap outline-hidden transition-colors duration-300 select-none focus-visible:ring-2 focus-visible:ring-ring/40";
+/**
+ * For a wrapper whose child input takes focus (InputGroup): FIELD, lit by
+ * focus-within. Written out in full rather than derived from FIELD, because
+ * Tailwind only generates classes that appear literally in the source.
+ */
+export declare const FIELD_WITHIN: string;
 //# sourceMappingURL=styles.d.ts.map

package/dist/utils/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../packages/utils/styles.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,KAAK,QAKmC,CAAC;AAEtD,sDAAsD;AACtD,eAAO,MAAM,YAAY,mGAC2E,CAAC;AAErG,0EAA0E;AAC1E,eAAO,MAAM,OAAO,QAAgF,CAAC;AAErG,oEAAoE;AACpE,eAAO,MAAM,KAAK,kIACiH,CAAC;AAEpI,2EAA2E;AAC3E,eAAO,MAAM,UAAU,gGAAgG,CAAC;AAExH,sDAAsD;AACtD,eAAO,MAAM,cAAc,iOACuM,CAAC;AAEnO,oCAAoC;AACpC,eAAO,MAAM,SAAS,iLAC4J,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../packages/utils/styles.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,eAAO,MAAM,KAAK,QAKmC,CAAC;AAEtD,sDAAsD;AACtD,eAAO,MAAM,YAAY,mGAC2E,CAAC;AAErG,0EAA0E;AAC1E,eAAO,MAAM,OAAO,QAAgF,CAAC;AAErG,oEAAoE;AACpE,eAAO,MAAM,KAAK,kIACiH,CAAC;AAEpI,2EAA2E;AAC3E,eAAO,MAAM,UAAU,gGAAgG,CAAC;AAExH,sDAAsD;AACtD,eAAO,MAAM,cAAc,iOACuM,CAAC;AAEnO,oCAAoC;AACpC,eAAO,MAAM,SAAS,iLAC4J,CAAC;AAEnL;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAK4B,CAAC"}

package/dist/utils/theme.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Theme generation: a few inputs → every colour token, in OKLCH. Lightness is
+ * fixed per UI role and the inputs only move hue and chroma, so contrast holds
+ * for any colour (the tests sweep every hue and check WCAG). Roles run from the
+ * app background through surfaces and borders to solid colour and text. Colour
+ * is used sparingly: neutrals carry the UI, the accent marks what matters.
+ */
+export declare const INTENSITIES: readonly ["mono", "muted", "balanced", "vivid"];
+export type Intensity = (typeof INTENSITIES)[number];
+export type Appearance = 'dark' | 'light';
+export interface ThemeSettings {
+    preset: PresetId | 'custom';
+    /** OKLCH hue angle, 0–359. */
+    hue: number;
+    intensity: Intensity;
+    /** Neutral greys, or greys faintly tinted with the accent hue. */
+    tint: 'neutral' | 'tinted';
+    contrast: 'standard' | 'high';
+    glow: 'off' | 'soft' | 'bright';
+    /** Strength of the Backdrop's pattern (contours or dots). */
+    topography: 'off' | 'subtle' | 'visible';
+}
+export declare const PRESETS: readonly [{
+    readonly id: "violet";
+    readonly label: "Violet";
+    readonly hue: 295;
+    readonly intensity: "balanced";
+    readonly tint: "tinted";
+}, {
+    readonly id: "ocean";
+    readonly label: "Ocean";
+    readonly hue: 250;
+    readonly intensity: "balanced";
+    readonly tint: "tinted";
+}, {
+    readonly id: "teal";
+    readonly label: "Teal";
+    readonly hue: 195;
+    readonly intensity: "balanced";
+    readonly tint: "tinted";
+}, {
+    readonly id: "forest";
+    readonly label: "Forest";
+    readonly hue: 150;
+    readonly intensity: "muted";
+    readonly tint: "tinted";
+}, {
+    readonly id: "amber";
+    readonly label: "Amber";
+    readonly hue: 75;
+    readonly intensity: "balanced";
+    readonly tint: "neutral";
+}, {
+    readonly id: "rose";
+    readonly label: "Rose";
+    readonly hue: 15;
+    readonly intensity: "muted";
+    readonly tint: "neutral";
+}, {
+    readonly id: "graphite";
+    readonly label: "Graphite";
+    readonly hue: 270;
+    readonly intensity: "mono";
+    readonly tint: "neutral";
+}];
+export type PresetId = (typeof PRESETS)[number]['id'];
+/** Zen's default: violet, balanced, tinted greys, soft glow. */
+export declare const DEFAULT_THEME: ThemeSettings;
+/** A preset's colour inputs, keeping the other settings. */
+export declare function applyPreset(theme: ThemeSettings, id: PresetId): ThemeSettings;
+/** Any edit to the colour inputs makes it a custom theme. */
+export declare function customize(theme: ThemeSettings, patch: Partial<Pick<ThemeSettings, 'hue' | 'intensity' | 'tint'>>): ThemeSettings;
+/** The CSS custom properties (without the leading --) for a theme, dark or light. */
+export declare function themeVars(theme: ThemeSettings, appearance?: Appearance): Record<string, string>;
+/**
+ * Applies a theme's tokens to an element (default <html>) as inline custom
+ * properties, overriding the stylesheet's defaults below it. Pass the
+ * appearance that element shows (dark unless it or an ancestor is .light).
+ */
+export declare function applyTheme(theme: ThemeSettings, { appearance, target }?: {
+    appearance?: Appearance;
+    target?: HTMLElement;
+}): void;
+/** Removes an applied theme, back to the stylesheet's defaults. */
+export declare function resetTheme(target?: HTMLElement): void;
+/** Coerces stored (possibly older or edited) data into a valid theme. */
+export declare function normalizeTheme(raw: unknown): ThemeSettings;
+/** OKLCH triplet → linear sRGB (clamped to gamut). */
+export declare function oklchToLinearRgb(triplet: string): [number, number, number];
+/** WCAG 2 contrast ratio between two OKLCH triplets. */
+export declare function contrastRatio(a: string, b: string): number;
+//# sourceMappingURL=theme.d.ts.map

package/dist/utils/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../packages/utils/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,WAAW,iDAAkD,CAAC;AAC3E,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;IACrB,kEAAkE;IAClE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,QAAQ,EAAE,UAAU,GAAG,MAAM,CAAC;IAC9B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChC,6DAA6D;IAC7D,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC5C;AAED,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcjB,CAAC;AACJ,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAEtD,gEAAgE;AAChE,eAAO,MAAM,aAAa,EAAE,aAQ3B,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,GAAG,aAAa,CAG7E;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CACrB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC,CAAC,GAClE,aAAa,CAEf;AAQD,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,GAAE,UAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmEvG;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACtB,KAAK,EAAE,aAAa,EACpB,EAAE,UAAmB,EAAE,MAAM,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACxF,IAAI,CAGN;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAGrD;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAkB1D;AAID,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAa1E;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO1D"}

package/dist/utils/useAnchoredPopup.d.ts

@@ -0,0 +1,36 @@
+import { CSSProperties } from 'react';
+/**
+ * A popup anchored to a trigger, on the native Popover API: opens below the
+ * trigger (flipping above if there's no room), closes on outside click and
+ * Escape, and returns focus to the trigger. Spread `triggerProps` on the
+ * trigger button and `popupProps` on the popup element.
+ */
+export declare function useAnchoredPopup<T extends HTMLElement = HTMLDivElement>({ align, offset, matchWidth, onOpenChange, }?: AnchoredPopupOptions): {
+    id: string;
+    open: boolean;
+    setOpen: (next: boolean) => void;
+    triggerProps: {
+        popoverTarget: string;
+        'aria-expanded': boolean;
+        'aria-controls': string;
+        'data-popup-open': true | undefined;
+        style: CSSProperties;
+    };
+    popupProps: {
+        ref: import('react').RefObject<T | null>;
+        id: string;
+        popover: "auto";
+        style: CSSProperties;
+    };
+    popupRef: import('react').RefObject<T | null>;
+};
+export interface AnchoredPopupOptions {
+    /** Line the popup up with the trigger's start (default) or end edge. */
+    align?: 'start' | 'end';
+    /** Gap below the trigger, in px. */
+    offset?: number;
+    /** At least as wide as the trigger (e.g. a select's list). */
+    matchWidth?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+//# sourceMappingURL=useAnchoredPopup.d.ts.map

package/dist/utils/useAnchoredPopup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnchoredPopup.d.ts","sourceRoot":"","sources":["../../packages/utils/useAnchoredPopup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAmD,MAAM,OAAO,CAAC;AAEvF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,cAAc,EAAE,EACrE,KAAe,EACf,MAAU,EACV,UAAkB,EAClB,YAAY,GACf,GAAE,oBAAyB;;;oBAgBb,OAAO;;;;;;eA4BsB,aAAa;;;;;;eAe5C,aAAa;;;EAIzB;AAED,MAAM,WAAW,oBAAoB;IACjC,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C"}

package/dist/utils/useHydrated.d.ts

@@ -0,0 +1,3 @@
+/** False during server rendering and the hydration render, true afterwards: for client-only UI. */
+export declare function useHydrated(): boolean;
+//# sourceMappingURL=useHydrated.d.ts.map

package/dist/utils/useHydrated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHydrated.d.ts","sourceRoot":"","sources":["../../packages/utils/useHydrated.ts"],"names":[],"mappings":"AAIA,mGAAmG;AACnG,wBAAgB,WAAW,IAAI,OAAO,CAMrC"}

package/dist/utils/useVirtualList.d.ts

@@ -13,6 +13,10 @@ export interface VirtualItem {
 export declare function useVirtualList({ count, itemHeight, scrollRef, overscan }: VirtualListOptions): {
     items: VirtualItem[];
     totalSize: number;
+    /** Space above the rendered rows (for a table: a TableSpacerRow of this height). */
+    paddingTop: number;
+    /** Space below the rendered rows. */
+    paddingBottom: number;
 };
 export interface VirtualListOptions {
     count: number;

package/dist/utils/useVirtualList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVirtualList.d.ts","sourceRoot":"","sources":["../../packages/utils/useVirtualList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA6B,MAAM,OAAO,CAAC;AAE7D,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAY,EAAE,EAAE,kBAAkB;;;EA6BhG;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACzC,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"useVirtualList.d.ts","sourceRoot":"","sources":["../../packages/utils/useVirtualList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA6B,MAAM,OAAO,CAAC;AAE7D,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAY,EAAE,EAAE,kBAAkB;;;IAyCzF,oFAAoF;;IAEpF,qCAAqC;;EAG5C;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACzC,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/variables.css

@@ -0,0 +1,90 @@
+/*
+ * Colour tokens are OKLCH "L C H" triplets, used as oklch(var(--x)) or
+ * oklch(var(--x) / alpha). Lightness is fixed per role, so contrast holds
+ * whatever hue a theme picks; only hue and chroma carry the brand.
+ *
+ * Dark glass is the default. Add `light` (or data-theme="light") to an
+ * element for the light palette, and `dark` to switch back inside it.
+ */
+:root,
+:is(.dark, [data-theme='dark']) {
+    color-scheme: dark;
+    --radius: 0.625rem;
+
+    --background: 0.155 0.014 295;
+    --foreground: 0.97 0.004 295;
+    --card: 0.195 0.014 295;
+    --card-foreground: 0.97 0.004 295;
+    --popover: 0.21 0.014 295;
+    --popover-foreground: 0.97 0.004 295;
+
+    --primary: 0.72 0.13 295; /* violet */
+    --primary-foreground: 0.17 0.03 295;
+    --secondary: 0.25 0.014 295;
+    --secondary-foreground: 0.97 0.004 295;
+    --muted: 0.235 0.014 295;
+    --muted-foreground: 0.72 0.021 295;
+    --accent: 0.3 0.046 295;
+    --accent-foreground: 0.88 0.065 295;
+    --destructive: 0.64 0.2 25;
+    --destructive-foreground: 0.985 0 0;
+
+    --border: 0.28 0.021 295;
+    --input: 0.28 0.021 295;
+    --ring: 0.72 0.13 295;
+
+    /* Light that surfaces pick up: focus halos, primary buttons, lit edges. */
+    --glow: 0.7 0.13 295;
+    --glow-2: 0.72 0.098 325; /* analogous, a little further round the wheel */
+    --glow-strength: 0.55; /* 0 turns every glow off */
+
+    /*
+     * Ink for translucent overlays (hairlines, glass fills, hover tints), used as
+     * oklch(var(--tint) / alpha): white on dark, deep violet-grey on light.
+     */
+    --tint: 1 0 0;
+    --glass-shadow: 0 10px 40px -12px hsl(0 0% 0% / 0.6);
+    --popup-shadow: 0 20px 60px -20px hsl(0 0% 0% / 0.8);
+    --toast-shadow: 0 18px 50px -20px oklch(0 0 0 / 0.8);
+    --backdrop-scrim: oklch(0 0 0 / 0.5);
+    --topo-strength: 0.55;
+    --mx: -9999px; /* pointer position, set by <Backdrop> */
+    --my: -9999px;
+}
+
+:is(.light, [data-theme='light']) {
+    color-scheme: light;
+
+    --background: 0.985 0.006 295;
+    --foreground: 0.21 0.02 295;
+    --card: 1 0 0;
+    --card-foreground: 0.21 0.02 295;
+    --popover: 1 0 0;
+    --popover-foreground: 0.21 0.02 295;
+
+    --primary: 0.48 0.195 295;
+    --primary-foreground: 0.985 0 0;
+    --secondary: 0.955 0.008 295;
+    --secondary-foreground: 0.21 0.02 295;
+    --muted: 0.96 0.007 295;
+    --muted-foreground: 0.5 0.021 295;
+    --accent: 0.95 0.033 295;
+    --accent-foreground: 0.42 0.117 295;
+    --destructive: 0.55 0.22 25;
+    --destructive-foreground: 0.985 0 0;
+
+    --border: 0.91 0.011 295;
+    --input: 0.91 0.011 295;
+    --ring: 0.48 0.195 295;
+
+    --glow: 0.62 0.182 295;
+    --glow-2: 0.65 0.137 325;
+    --glow-strength: 0.4;
+
+    --tint: 0.21 0.02 295;
+    --glass-shadow: 0 10px 30px -14px oklch(0.3 0.05 295 / 0.25);
+    --popup-shadow: 0 20px 50px -20px oklch(0.3 0.05 295 / 0.35);
+    --toast-shadow: 0 18px 50px -20px oklch(0.3 0.05 295 / 0.35);
+    --backdrop-scrim: oklch(0.21 0.02 295 / 0.3);
+    --topo-strength: 0.55;
+}