cursedbelt 0.0.0

package/dist/react/search/SearchResults.d.ts

@@ -0,0 +1,45 @@
+import type { ElementType, ReactNode } from 'react';
+import { type StyleableProps } from '../styling';
+/** One result row. `href` is given to `linkComponent` as `to` (router) or `href` (`<a>`). */
+export interface SearchResultRow {
+    /** Stable React key + identity. */
+    id: string;
+    href: string;
+    title: string;
+    /** Why it matched — shown under the title (build with `cwip/search` snippets). */
+    snippet?: string;
+    /** Secondary right-aligned meta (a date, a parent name). */
+    sub?: string;
+    /** A trailing tag node (e.g. a kind / archived badge). */
+    badge?: ReactNode;
+    /** Leading icon node. */
+    icon?: ReactNode;
+}
+/** A titled group of rows (one per searched entity type). */
+export interface SearchResultGroup {
+    /** Stable key for this group. */
+    key: string;
+    label: string;
+    icon?: ReactNode;
+    items: SearchResultRow[];
+}
+export type SearchResultsSlot = 'root' | 'group' | 'groupHeader' | 'count' | 'list' | 'item' | 'itemBody' | 'itemTitleRow' | 'itemTitle' | 'snippet' | 'sub';
+export interface SearchResultsProps extends StyleableProps<SearchResultsSlot> {
+    /** Grouped results; empty groups are skipped. */
+    groups: SearchResultGroup[];
+    /** Element/component for each result link (default `<a>`; pass a router `Link`). */
+    linkComponent?: ElementType;
+    /** Called when a result is clicked (e.g. close a dropdown / a mobile drawer). */
+    onNavigate?: () => void;
+    /** Rendered when there are no results at all. Omit to render nothing. */
+    emptyContent?: ReactNode;
+}
+/**
+ * A routing-agnostic, themeable renderer for grouped content-search results — the
+ * shared presentation behind each app's universal search (a full-page list, or a
+ * header dropdown). The app does the searching (server + `cwip/search` helpers) and
+ * maps hits to {@link SearchResultGroup}s; this draws them. Bring routing via
+ * `linkComponent` and restyle any slot via `classNames`/`styles`/`unstyled`.
+ */
+export declare const SearchResults: ({ groups, linkComponent: Link, onNavigate, emptyContent, classNames, unstyled, }: SearchResultsProps) => string | number | bigint | true | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null;
+//# sourceMappingURL=SearchResults.d.ts.map

package/dist/react/search/SearchResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchResults.d.ts","sourceRoot":"","sources":["../../../src/react/search/SearchResults.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,yBAAyB;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,OAAO,GACP,aAAa,GACb,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,cAAc,GACd,WAAW,GACX,SAAS,GACT,KAAK,CAAC;AAEV,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,iBAAiB,CAAC;IAC3E,iDAAiD;IACjD,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,oFAAoF;IACpF,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,yEAAyE;IACzE,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AAYD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,kFAO3B,kBAAkB,iTA8DpB,CAAC"}

package/dist/react/search/SearchResults.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { resolveClass } from '../styling';
+const GROUP_HEADER = 'mb-2 flex items-center gap-2 text-sm font-semibold text-gray-700 dark:text-gray-300';
+const COUNT = 'rounded-full bg-gray-100 px-1.5 py-0.5 text-xs font-medium text-gray-500 dark:bg-gray-800 dark:text-gray-400';
+const ITEM = 'flex items-center justify-between gap-3 rounded-lg border border-gray-200 px-3 py-2 transition hover:bg-gray-50 dark:border-gray-800 dark:hover:bg-gray-800/50';
+const ITEM_TITLE = 'truncate text-sm text-gray-900 dark:text-gray-100';
+const SNIPPET = 'truncate text-xs text-gray-500 dark:text-gray-400';
+const SUB = 'shrink-0 truncate text-xs text-gray-400';
+/**
+ * A routing-agnostic, themeable renderer for grouped content-search results — the
+ * shared presentation behind each app's universal search (a full-page list, or a
+ * header dropdown). The app does the searching (server + `cwip/search` helpers) and
+ * maps hits to {@link SearchResultGroup}s; this draws them. Bring routing via
+ * `linkComponent` and restyle any slot via `classNames`/`styles`/`unstyled`.
+ */
+export const SearchResults = ({ groups, linkComponent: Link = 'a', onNavigate, emptyContent, classNames, unstyled, }) => {
+    const nonEmpty = groups.filter((g) => g.items.length > 0);
+    if (nonEmpty.length === 0)
+        return emptyContent ? emptyContent : null;
+    return (_jsx("div", { className: resolveClass('flex flex-col gap-6', classNames?.root, unstyled), children: nonEmpty.map((group) => (_jsxs("div", { className: resolveClass('', classNames?.group, unstyled), children: [_jsxs("div", { className: resolveClass(GROUP_HEADER, classNames?.groupHeader, unstyled), children: [group.icon, group.label, _jsx("span", { className: resolveClass(COUNT, classNames?.count, unstyled), children: group.items.length })] }), _jsx("div", { className: resolveClass('flex flex-col gap-1.5', classNames?.list, unstyled), children: group.items.map((item) => {
+                        const targetProps = Link === 'a' ? { href: item.href } : { to: item.href };
+                        return (_jsxs(Link, { ...targetProps, onClick: onNavigate, className: resolveClass(ITEM, classNames?.item, unstyled), children: [_jsxs("span", { className: resolveClass('flex min-w-0 flex-col gap-0.5', classNames?.itemBody, unstyled), children: [_jsxs("span", { className: resolveClass('flex min-w-0 items-center gap-2', classNames?.itemTitleRow, unstyled), children: [item.icon, _jsx("span", { className: resolveClass(ITEM_TITLE, classNames?.itemTitle, unstyled), children: item.title }), item.badge] }), item.snippet && (_jsx("span", { className: resolveClass(SNIPPET, classNames?.snippet, unstyled), children: item.snippet }))] }), item.sub && (_jsx("span", { className: resolveClass(SUB, classNames?.sub, unstyled), children: item.sub }))] }, item.id));
+                    }) })] }, group.key))) }));
+};
+//# sourceMappingURL=SearchResults.js.map

package/dist/react/search/SearchResults.js.map

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

package/dist/react/search/index.d.ts

@@ -0,0 +1,3 @@
+export * from './HeaderSearch';
+export * from './SearchResults';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/search/index.ts"],"names":[],"mappings":"AAKA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/react/search/index.js

@@ -0,0 +1,8 @@
+// cwip/react search — the shared UI for a "universal search": a responsive
+// header/top-nav search box ({@link HeaderSearch}) that collapses to an icon on
+// narrow screens, plus a routing-agnostic grouped-results renderer
+// ({@link SearchResults}) for its dropdown. The matching itself is pure and lives
+// in `cwip/search`; these just draw the hits an app produces.
+export * from './HeaderSearch';
+export * from './SearchResults';
+//# sourceMappingURL=index.js.map

package/dist/react/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/search/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,gFAAgF;AAChF,mEAAmE;AACnE,kFAAkF;AAClF,8DAA8D;AAC9D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/react/spreadsheet/GridCopyPaste.d.ts

@@ -0,0 +1,28 @@
+import type { GridCell, GridSelection, Item } from '@glideapps/glide-data-grid';
+/** The display text for any cell kind — what a copy should carry for that cell. */
+declare function cellToText(cell: GridCell): string;
+/**
+ * Build a TSV string for the current rectangular cell selection (the shape Sheets /
+ * Excel paste). Returns '' when there is no cell range selected.
+ */
+declare function selectionToTSV(selection: GridSelection, getCellContent: (cell: Item) => GridCell): string;
+/**
+ * Parse a pasted clipboard string (TSV — tab-separated columns, newline-separated rows)
+ * into a row-major `string[][]` matrix, matching the value shape glide's `onPaste` gives.
+ * A single trailing newline is ignored; an empty string yields `[]`.
+ */
+declare function parseTSV(text: string): string[][];
+/**
+ * Write the selection's TSV to the system clipboard. Resolves `true` when written,
+ * `false` when there's nothing selected or the Clipboard API is unavailable.
+ */
+declare function copySelection(selection: GridSelection, getCellContent: (cell: Item) => GridCell): Promise<boolean>;
+/** Clipboard (TSV) helpers for the spreadsheet grid. */
+export declare const GridCopyPaste: {
+    readonly cellToText: typeof cellToText;
+    readonly selectionToTSV: typeof selectionToTSV;
+    readonly parseTSV: typeof parseTSV;
+    readonly copySelection: typeof copySelection;
+};
+export {};
+//# sourceMappingURL=GridCopyPaste.d.ts.map

package/dist/react/spreadsheet/GridCopyPaste.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridCopyPaste.d.ts","sourceRoot":"","sources":["../../../src/react/spreadsheet/GridCopyPaste.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AAWhF,mFAAmF;AACnF,iBAAS,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAuB1C;AAED;;;GAGG;AACH,iBAAS,cAAc,CACrB,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,GACvC,MAAM,CAYR;AAED;;;;GAIG;AACH,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAK1C;AAED;;;GAGG;AACH,iBAAe,aAAa,CAC1B,SAAS,EAAE,aAAa,EACxB,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,GACvC,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wDAAwD;AACxD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC"}

package/dist/react/spreadsheet/GridCopyPaste.js

@@ -0,0 +1,84 @@
+import { GridCellKind } from '@glideapps/glide-data-grid';
+// Clipboard helpers for the spreadsheet grid. glide handles native Cmd-C when the grid
+// is given `getCellsForSelection` (SpreadsheetGrid sets this), but apps still need to:
+//   - build a TSV string from an arbitrary selection for a "Copy" button, and
+//   - parse a pasted clipboard string into the `string[][]` matrix an `onPaste`
+//     handler maps back onto its data model.
+// These are pure (no React, no canvas), so they're unit-testable and reusable. The cell
+// types stay glide's; the app owns what the matrix MEANS.
+/** The display text for any cell kind — what a copy should carry for that cell. */
+function cellToText(cell) {
+    switch (cell.kind) {
+        case GridCellKind.Text:
+            return cell.displayData || cell.data;
+        case GridCellKind.Number:
+            return cell.displayData;
+        case GridCellKind.Uri:
+            return cell.displayData ?? cell.data;
+        case GridCellKind.Markdown:
+            return cell.data;
+        case GridCellKind.Boolean:
+            return cell.data === true ? 'TRUE' : cell.data === false ? 'FALSE' : '';
+        case GridCellKind.Bubble:
+        case GridCellKind.Image:
+            return cell.data.join(', ');
+        case GridCellKind.Drilldown:
+            return cell.data.map((d) => d.text).join(', ');
+        case GridCellKind.Custom:
+            return cell.copyData;
+        default:
+            // RowID / Loading / Protected / inner-only kinds have no copyable value.
+            return '';
+    }
+}
+/**
+ * Build a TSV string for the current rectangular cell selection (the shape Sheets /
+ * Excel paste). Returns '' when there is no cell range selected.
+ */
+function selectionToTSV(selection, getCellContent) {
+    const range = selection.current?.range;
+    if (!range || range.width <= 0 || range.height <= 0)
+        return '';
+    const lines = [];
+    for (let row = range.y; row < range.y + range.height; row++) {
+        const cols = [];
+        for (let col = range.x; col < range.x + range.width; col++) {
+            cols.push(cellToText(getCellContent([col, row])));
+        }
+        lines.push(cols.join('\t'));
+    }
+    return lines.join('\n');
+}
+/**
+ * Parse a pasted clipboard string (TSV — tab-separated columns, newline-separated rows)
+ * into a row-major `string[][]` matrix, matching the value shape glide's `onPaste` gives.
+ * A single trailing newline is ignored; an empty string yields `[]`.
+ */
+function parseTSV(text) {
+    const normalized = text.replace(/\r\n?/g, '\n');
+    const body = normalized.endsWith('\n') ? normalized.slice(0, -1) : normalized;
+    if (body === '')
+        return [];
+    return body.split('\n').map((line) => line.split('\t'));
+}
+/**
+ * Write the selection's TSV to the system clipboard. Resolves `true` when written,
+ * `false` when there's nothing selected or the Clipboard API is unavailable.
+ */
+async function copySelection(selection, getCellContent) {
+    const tsv = selectionToTSV(selection, getCellContent);
+    if (tsv === '')
+        return false;
+    if (typeof navigator === 'undefined' || !navigator.clipboard?.writeText)
+        return false;
+    await navigator.clipboard.writeText(tsv);
+    return true;
+}
+/** Clipboard (TSV) helpers for the spreadsheet grid. */
+export const GridCopyPaste = {
+    cellToText,
+    selectionToTSV,
+    parseTSV,
+    copySelection,
+};
+//# sourceMappingURL=GridCopyPaste.js.map

package/dist/react/spreadsheet/GridCopyPaste.js.map

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

package/dist/react/spreadsheet/SpreadsheetGrid.d.ts

@@ -0,0 +1,61 @@
+import '@glideapps/glide-data-grid/dist/index.css';
+import type { CustomRenderer, EditableGridCell, GridCell, GridColumn, GridSelection, HeaderClickedEventArgs, Item, Rectangle } from '@glideapps/glide-data-grid';
+import { type GlideTheme } from './useGlideTheme';
+/**
+ * A thin, generic wrapper over glide-data-grid: it owns the parts every grid needs the
+ * same way (token theming, pixel sizing, scroll, copy) and stays out of the way of the
+ * parts an app owns (its columns, its cell data, its custom cell renderers). Generic over
+ * the app's cell-type union `C`, so `getCellContent` is typed to exactly the cells a given
+ * grid produces. The host injects business logic via props; cursedbelt injects no Excel /
+ * column semantics of its own.
+ */
+export interface SpreadsheetGridProps<C extends GridCell = GridCell> {
+    /** glide-data-grid column specs (title / width / icon / group …). */
+    columns: readonly GridColumn[];
+    /** Total row count. The grid virtualises — only the visible window is drawn. */
+    rows: number;
+    /** Return the cell at `[col, row]`. Injected by the app (its business data). */
+    getCellContent: (cell: Item) => C;
+    /** Commit a cell edit. Omit for a read-only grid. */
+    onCellEdited?: (cell: Item, newValue: EditableGridCell) => void;
+    /** Called when the user activates the trailing "append row" affordance. */
+    onRowAppended?: () => void;
+    /** Persist a user column resize. */
+    onColumnResize?: (column: GridColumn, newSize: number, colIndex: number) => void;
+    /** Forwarded header click — wire app-side column sorting / header menus here. */
+    onHeaderClicked?: (colIndex: number, event: HeaderClickedEventArgs) => void;
+    /**
+     * Handle a clipboard paste; `values` is a row-major matrix of strings. Return `true`
+     * to accept. Omit to use glide's default (split on tab/newline → `onCellEdited` each).
+     */
+    onPaste?: (target: Item, values: readonly (readonly string[])[]) => boolean;
+    /** Number of leading columns to freeze horizontally. */
+    freezeColumns?: number;
+    /** Row-marker gutter style. Default `'none'`. */
+    rowMarkers?: 'none' | 'number' | 'checkbox' | 'both';
+    smoothScrollX?: boolean;
+    smoothScrollY?: boolean;
+    /** Controlled selection — pair with {@link useGridSelection}. */
+    gridSelection?: GridSelection;
+    onGridSelectionChange?: (selection: GridSelection) => void;
+    /** Forwarded for app-side infinite-load / windowing logic. */
+    onVisibleRegionChanged?: (range: Rectangle, tx: number, ty: number) => void;
+    /**
+     * App-injected custom cell renderers (formula, currency, date, …). Passed through to
+     * glide untouched — the cell types and their business logic stay in the app.
+     */
+    customRenderers?: readonly CustomRenderer<any>[];
+    /** Per-row height in px. Default `34`. */
+    rowHeight?: number;
+    /** Header row height in px. Default `36`. */
+    headerHeight?: number;
+    /** Container height. A number is px; a string is any CSS length. Default `'100%'`. */
+    height?: number | string;
+    /** Extra classes for the sizing container. */
+    className?: string;
+    /** Per-instance theme overrides, layered on top of the token-derived theme. */
+    theme?: Partial<GlideTheme>;
+}
+export declare function SpreadsheetGrid<C extends GridCell = GridCell>({ columns, rows, getCellContent, onCellEdited, onRowAppended, onColumnResize, onPaste, onHeaderClicked, freezeColumns, rowMarkers, smoothScrollX, smoothScrollY, gridSelection, onGridSelectionChange, onVisibleRegionChanged, customRenderers, rowHeight, headerHeight, height, className, theme, }: SpreadsheetGridProps<C>): import("react").JSX.Element;
+export default SpreadsheetGrid;
+//# sourceMappingURL=SpreadsheetGrid.d.ts.map

package/dist/react/spreadsheet/SpreadsheetGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpreadsheetGrid.d.ts","sourceRoot":"","sources":["../../../src/react/spreadsheet/SpreadsheetGrid.tsx"],"names":[],"mappings":"AACA,OAAO,2CAA2C,CAAC;AACnD,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,IAAI,EACJ,SAAS,EACV,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IACjE,qEAAqE;IACrE,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC;IAClC,qDAAqD;IACrD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChE,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,oCAAoC;IACpC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACjF,iFAAiF;IACjF,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC5E;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC;IAC5E,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,qBAAqB,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3D,8DAA8D;IAC9D,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;IACjD,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7B;AAmBD,wBAAgB,eAAe,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAAE,EAC7D,OAAO,EACP,IAAI,EACJ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,cAAc,EACd,OAAO,EACP,eAAe,EACf,aAAa,EACb,UAAmB,EACnB,aAAa,EACb,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,SAAc,EACd,YAAiB,EACjB,MAAe,EACf,SAAS,EACT,KAAK,GACN,EAAE,oBAAoB,CAAC,CAAC,CAAC,+BAuCzB;AAED,eAAe,eAAe,CAAC"}

package/dist/react/spreadsheet/SpreadsheetGrid.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DataEditor } from '@glideapps/glide-data-grid';
+import '@glideapps/glide-data-grid/dist/index.css';
+import { useLayoutEffect, useRef, useState } from 'react';
+import { cn } from '../lib/cn';
+import { useGlideTheme } from './useGlideTheme';
+// glide's canvas needs an explicit pixel width/height ('100%' as a CSS string is not
+// valid for it), so the wrapper measures its own content box with a ResizeObserver and
+// feeds DataEditor concrete pixels — reflowing on container resize with no overflow.
+function useElementSize(ref) {
+    const [size, setSize] = useState({ width: 0, height: 0 });
+    useLayoutEffect(() => {
+        const el = ref.current;
+        if (!el)
+            return;
+        const measure = () => setSize({ width: el.clientWidth, height: el.clientHeight });
+        measure();
+        const observer = new ResizeObserver(measure);
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [ref]);
+    return size;
+}
+export function SpreadsheetGrid({ columns, rows, getCellContent, onCellEdited, onRowAppended, onColumnResize, onPaste, onHeaderClicked, freezeColumns, rowMarkers = 'none', smoothScrollX, smoothScrollY, gridSelection, onGridSelectionChange, onVisibleRegionChanged, customRenderers, rowHeight = 34, headerHeight = 36, height = '100%', className, theme, }) {
+    const containerRef = useRef(null);
+    const { width, height: measuredHeight } = useElementSize(containerRef);
+    const glideTheme = useGlideTheme(containerRef, theme);
+    return (_jsx("div", { ref: containerRef, className: cn('cb-spreadsheet-grid relative w-full overflow-hidden', className), style: { height }, children: width > 0 && measuredHeight > 0 ? (_jsx(DataEditor, { theme: glideTheme, width: width, height: measuredHeight, columns: columns, rows: rows, getCellContent: getCellContent, onCellEdited: onCellEdited, onRowAppended: onRowAppended, onColumnResize: onColumnResize, onHeaderClicked: onHeaderClicked, onPaste: onPaste, freezeColumns: freezeColumns, rowMarkers: rowMarkers, smoothScrollX: smoothScrollX, smoothScrollY: smoothScrollY, gridSelection: gridSelection, onGridSelectionChange: onGridSelectionChange, onVisibleRegionChanged: onVisibleRegionChanged, getCellsForSelection: true, customRenderers: customRenderers, rowHeight: rowHeight, headerHeight: headerHeight })) : null }));
+}
+export default SpreadsheetGrid;
+//# sourceMappingURL=SpreadsheetGrid.js.map

package/dist/react/spreadsheet/SpreadsheetGrid.js.map

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

package/dist/react/spreadsheet/index.d.ts

@@ -0,0 +1,6 @@
+export { type CustomRenderer, type EditableGridCell, type GridCell, GridCellKind, type GridColumn, type GridSelection, type Item, } from '@glideapps/glide-data-grid';
+export { GridCopyPaste } from './GridCopyPaste';
+export { SpreadsheetGrid, type SpreadsheetGridProps } from './SpreadsheetGrid';
+export { type GlideTheme, useGlideTheme } from './useGlideTheme';
+export { type UseGridSelectionOptions, type UseGridSelectionResult, useGridSelection, } from './useGridSelection';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/spreadsheet/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/spreadsheet/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,IAAI,GACV,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,KAAK,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/react/spreadsheet/index.js

@@ -0,0 +1,17 @@
+// cursedbelt/react/spreadsheet — a themed, generic wrapper over glide-data-grid.
+//
+// Optional peer dep: @glideapps/glide-data-grid (only needed when you import this module,
+// which is why it lives on its own subpath and is NOT re-exported from `cursedbelt/react`).
+// In a consuming app, dedupe it in vite (`resolve.dedupe`) + tsconfig `paths` — see this
+// task's gotchas — so a bun-linked cursedbelt resolves a single instance of the lib.
+//
+// Import: import { SpreadsheetGrid, useGridSelection } from 'cursedbelt/react/spreadsheet';
+// Re-export the glide-data-grid types/enums a consumer reaches for most, so an app can
+// type its columns / cells / renderers without importing from the lib directly.
+// `GridCellKind` is a runtime enum (used to construct cells), the rest are types.
+export { GridCellKind, } from '@glideapps/glide-data-grid';
+export { GridCopyPaste } from './GridCopyPaste';
+export { SpreadsheetGrid } from './SpreadsheetGrid';
+export { useGlideTheme } from './useGlideTheme';
+export { useGridSelection, } from './useGridSelection';
+//# sourceMappingURL=index.js.map

package/dist/react/spreadsheet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/spreadsheet/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,0FAA0F;AAC1F,4FAA4F;AAC5F,yFAAyF;AACzF,qFAAqF;AACrF,EAAE;AACF,4FAA4F;AAE5F,uFAAuF;AACvF,gFAAgF;AAChF,kFAAkF;AAClF,OAAO,EAIL,YAAY,GAIb,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAA6B,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAmB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAGL,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/react/spreadsheet/types.d.ts

@@ -0,0 +1,42 @@
+export type CellScalar = string | number | boolean | null;
+export interface SheetMeta {
+    id: string;
+    name: string;
+    rowCount: number;
+    colCount: number;
+}
+export interface RevisionView {
+    revisionId: string;
+    sheets: SheetMeta[];
+    activeSheet: string;
+    columns: {
+        key: string;
+        title: string;
+    }[];
+    rows: CellScalar[][];
+    formulas?: Record<string, string>;
+    hiddenRows?: number[];
+    hiddenCols?: number[];
+}
+export type CellEdit = {
+    row: number;
+    col: number;
+    value: CellScalar;
+};
+export type SpreadsheetGridProps = {
+    view: RevisionView;
+    /** Active sheet is controlled by the parent so it can refetch the sheet's data. */
+    onSheetChange: (sheet: string) => void;
+    readOnly: boolean;
+    /** Fired on a committed cell edit (Enter / overlay close), only when editable. */
+    onCellEdit?: (edit: CellEdit) => void;
+    className?: string;
+    /**
+     * Tailwind class(es) applied to the ACTIVE sheet tab text + bg. Defaults to
+     * `text-accent` (maps to each app's brand accent). Override for app-specific
+     * emerald / blue / etc. active-tab styling.
+     * e.g. "text-emerald-700 dark:text-emerald-400"
+     */
+    activeTabClassName?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/react/spreadsheet/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/spreadsheet/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,mFAAmF;IACnF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC"}

package/dist/react/spreadsheet/types.js

@@ -0,0 +1,5 @@
+// Structural copies of cwip/excel-engine types so cursedbelt stays dependency-free.
+// These must stay structurally compatible with cwip's CellScalar / RevisionView /
+// SheetMeta — both apps import the real types from cwip and pass them as props.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/spreadsheet/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/react/spreadsheet/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,kFAAkF;AAClF,gFAAgF"}

package/dist/react/spreadsheet/useGlideTheme.d.ts

@@ -0,0 +1,14 @@
+import { type Theme as GlideTheme } from '@glideapps/glide-data-grid';
+import { type RefObject } from 'react';
+export type { GlideTheme };
+/**
+ * Map cursedbelt's design tokens to a glide-data-grid `Theme`, tracking light/dark and
+ * accent rebrands at render time.
+ *
+ * @param targetRef the grid's container element — tokens are read resolved at this node,
+ *   so a grid nested in a `.dark` / rebranded subtree gets the right values (the cascade).
+ *   Falls back to `:root` until the ref is attached.
+ * @param overrides per-instance theme tweaks, layered on top of the token-derived theme.
+ */
+export declare function useGlideTheme(targetRef: RefObject<HTMLElement | null>, overrides?: Partial<GlideTheme>): Partial<GlideTheme>;
+//# sourceMappingURL=useGlideTheme.d.ts.map

package/dist/react/spreadsheet/useGlideTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlideTheme.d.ts","sourceRoot":"","sources":["../../../src/react/spreadsheet/useGlideTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,IAAI,UAAU,EAIzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,OAAO,CAAC;AAErE,YAAY,EAAE,UAAU,EAAE,CAAC;AA4F3B;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACxC,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAC9B,OAAO,CAAC,UAAU,CAAC,CAiBrB"}

package/dist/react/spreadsheet/useGlideTheme.js

@@ -0,0 +1,113 @@
+import { getLuminance, interpolateColors, withAlpha, } from '@glideapps/glide-data-grid';
+import { useEffect, useMemo, useState } from 'react';
+// The token bridge: glide-data-grid renders on a canvas and wants a concrete `Theme`
+// object of resolved color/font strings (it can't read CSS custom properties itself).
+// `useGlideTheme` reads cursedbelt's semantic design tokens (task 02) off the live DOM
+// — cascade-aware, so a grid inside a `.dark` (or rebranded) subtree themes correctly —
+// and maps them onto glide's Theme. A MutationObserver on the root re-reads on a theme
+// or accent change, so light/dark and rebrands track with zero per-instance config.
+const SYSTEM_SANS = 'ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif';
+// Pick a legible foreground for text sitting ON the accent fill (selected header,
+// row-marker check) from the accent's luminance — works whether the app's accent is a
+// light mode-following green or a saturated violet.
+function contrastOn(color) {
+    try {
+        return getLuminance(color) > 0.6 ? '#111827' : '#ffffff';
+    }
+    catch {
+        return '#ffffff';
+    }
+}
+// glide draws text with `ctx.font`, which only honors absolute lengths — a `rem` token
+// is silently ignored on canvas. Resolve whatever length a token carries down to px.
+function cssLengthToPx(value, rootPx, fallback) {
+    const t = value.trim();
+    const n = Number.parseFloat(t);
+    if (!Number.isFinite(n))
+        return fallback;
+    if (t.endsWith('rem') || t.endsWith('em'))
+        return n * rootPx;
+    return n; // 'px' or a bare number
+}
+// Read the cursedbelt tokens resolved at `el` (or :root) and map them to glide's Theme.
+// Returns a partial — glide merges it over its own defaults, so we only set the keys the
+// design system owns. SSR / no-DOM yields `{}` (glide uses its built-in light theme).
+function readGlideTheme(el) {
+    if (typeof window === 'undefined' || typeof document === 'undefined')
+        return {};
+    const target = el ?? document.documentElement;
+    const s = getComputedStyle(target);
+    const v = (name, fallback) => {
+        const got = s.getPropertyValue(name).trim();
+        return got || fallback;
+    };
+    const background = v('--background', '#ffffff');
+    const muted = v('--muted', '#f3f4f6');
+    const foreground = v('--foreground', '#111827');
+    const mutedForeground = v('--muted-foreground', '#6b7280');
+    const accent = v('--accent', '#059669');
+    const border = v('--border', '#e5e7eb');
+    const warning = v('--warning', '#d97706');
+    const rootPx = Number.parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;
+    const fontFamily = v('--font-sans', SYSTEM_SANS);
+    const fontPx = cssLengthToPx(v('--text-sm', '13px'), rootPx, 13);
+    const onAccent = contrastOn(accent);
+    return {
+        accentColor: accent,
+        accentFg: onAccent,
+        accentLight: withAlpha(accent, 0.16),
+        textDark: foreground,
+        textMedium: mutedForeground,
+        textLight: interpolateColors(mutedForeground, background, 0.5),
+        textBubble: foreground,
+        textHeader: foreground,
+        textGroupHeader: withAlpha(foreground, 0.73),
+        textHeaderSelected: onAccent,
+        bgIconHeader: mutedForeground,
+        fgIconHeader: background,
+        bgCell: background,
+        bgCellMedium: interpolateColors(background, muted, 0.5),
+        bgHeader: muted,
+        bgHeaderHovered: interpolateColors(muted, foreground, 0.06),
+        bgHeaderHasFocus: interpolateColors(muted, foreground, 0.12),
+        bgBubble: muted,
+        bgBubbleSelected: background,
+        bgSearchResult: withAlpha(warning, 0.25),
+        borderColor: border,
+        horizontalBorderColor: border,
+        drilldownBorder: border,
+        linkColor: accent,
+        fontFamily,
+        baseFontStyle: `${fontPx}px`,
+        editorFontSize: `${fontPx}px`,
+        headerFontStyle: `600 ${fontPx}px`,
+        markerFontStyle: `${Math.max(9, Math.round(fontPx * 0.7))}px`,
+        lineHeight: 1.4,
+    };
+}
+/**
+ * Map cursedbelt's design tokens to a glide-data-grid `Theme`, tracking light/dark and
+ * accent rebrands at render time.
+ *
+ * @param targetRef the grid's container element — tokens are read resolved at this node,
+ *   so a grid nested in a `.dark` / rebranded subtree gets the right values (the cascade).
+ *   Falls back to `:root` until the ref is attached.
+ * @param overrides per-instance theme tweaks, layered on top of the token-derived theme.
+ */
+export function useGlideTheme(targetRef, overrides) {
+    // Read :root synchronously so the first client paint is already themed; the effect
+    // immediately re-reads from the mounted container (cascade-correct) and on theme change.
+    const [tokens, setTokens] = useState(() => readGlideTheme(null));
+    useEffect(() => {
+        const reread = () => setTokens(readGlideTheme(targetRef.current));
+        reread();
+        const observer = new MutationObserver(reread);
+        observer.observe(document.documentElement, {
+            attributes: true,
+            attributeFilter: ['class', 'style'],
+        });
+        return () => observer.disconnect();
+    }, [targetRef]);
+    return useMemo(() => ({ ...tokens, ...overrides }), [tokens, overrides]);
+}
+//# sourceMappingURL=useGlideTheme.js.map

package/dist/react/spreadsheet/useGlideTheme.js.map

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

package/dist/react/spreadsheet/useGridSelection.d.ts

@@ -0,0 +1,18 @@
+import { type GridSelection } from '@glideapps/glide-data-grid';
+export interface UseGridSelectionOptions {
+    /** Allow multi-row / multi-column range selection. Default `true`. */
+    multiSelect?: boolean;
+}
+export interface UseGridSelectionResult {
+    /** Pass to `<SpreadsheetGrid gridSelection={…} />`. */
+    gridSelection: GridSelection;
+    /** Pass to `<SpreadsheetGrid onGridSelectionChange={…} />`. */
+    onGridSelectionChange: (selection: GridSelection) => void;
+    /** Reset to no selection. */
+    clearSelection: () => void;
+    /** Imperatively set the selection (e.g. to programmatically focus a cell). */
+    setSelection: (selection: GridSelection) => void;
+}
+/** Manage glide-data-grid selection state (cells + rows + columns). */
+export declare function useGridSelection(opts?: UseGridSelectionOptions): UseGridSelectionResult;
+//# sourceMappingURL=useGridSelection.d.ts.map

package/dist/react/spreadsheet/useGridSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGridSelection.d.ts","sourceRoot":"","sources":["../../../src/react/spreadsheet/useGridSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAalF,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,aAAa,EAAE,aAAa,CAAC;IAC7B,+DAA+D;IAC/D,qBAAqB,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1D,6BAA6B;IAC7B,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,8EAA8E;IAC9E,YAAY,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;CAClD;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,uBAAuB,GAAG,sBAAsB,CA2BvF"}