@fluixi-ui/bulk-editor 0.2.1

package/dist/formula.d.ts

@@ -0,0 +1,16 @@
+import { type FormulaFn } from '@fluixi-ui/formula';
+import type { CellEvaluator } from './types.js';
+export interface FormulaEvaluatorOptions {
+    /** Extra functions merged over (and overriding) the built-ins, matched case-insensitively. */
+    functions?: Record<string, FormulaFn>;
+}
+/**
+ * A drop-in `evaluate` hook that turns `=`-prefixed cell values into spreadsheet
+ * formulas (arithmetic, A1 refs, ranges, SUM/IF/…). Non-formula values pass
+ * through unchanged. Wire it up with `<BulkEditor evaluate={formulaEvaluator()} />`.
+ *
+ * The editor's `get` already resolves A1 addresses against the original row
+ * order with a cycle guard, so cross-cell references and ranges work as-is.
+ */
+export declare function formulaEvaluator(options?: FormulaEvaluatorOptions): CellEvaluator;
+//# sourceMappingURL=formula.d.ts.map

package/dist/formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula.d.ts","sourceRoot":"","sources":["../src/formula.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACtC,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACvC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,aAAa,CAEjF"}

package/dist/formula.js

@@ -0,0 +1,13 @@
+import { evaluateFormula } from "@fluixi-ui/formula";
+function formulaEvaluator(options) {
+  return ({
+    raw,
+    get
+  }) => evaluateFormula(raw, {
+    resolve: get,
+    functions: options?.functions
+  });
+}
+export {
+  formulaEvaluator
+};

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import '@fluixi-ui/tokens/css/base.css';
+import '@fluixi-ui/tokens/css/parts/motion.css';
+import '@fluixi-ui/tokens/css/bulk-editor.css';
+import '@fluixi-ui/tokens/css/parts/menu.css';
+export * from './types.js';
+export { BulkEditor } from './bulk-editor.js';
+export { formulaEvaluator, type FormulaEvaluatorOptions } from './formula.js';
+export { createBulkEditorState, colToLabel, labelToCol, parseAddress, matchesFilter, type BulkEditorState, } from './state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,gCAAgC,CAAC;AACxC,OAAO,wCAAwC,CAAC;AAChD,OAAO,uCAAuC,CAAC;AAC/C,OAAO,sCAAsC,CAAC;AAE9C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EACL,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+import "@fluixi-ui/tokens/css/base.css";
+import "@fluixi-ui/tokens/css/parts/motion.css";
+import "@fluixi-ui/tokens/css/bulk-editor.css";
+import "@fluixi-ui/tokens/css/parts/menu.css";
+import { BulkEditor } from "./bulk-editor.js";
+import { formulaEvaluator } from "./formula.js";
+import { colToLabel, createBulkEditorState, labelToCol, matchesFilter, parseAddress } from "./state.js";
+export {
+  BulkEditor,
+  colToLabel,
+  createBulkEditorState,
+  formulaEvaluator,
+  labelToCol,
+  matchesFilter,
+  parseAddress
+};

package/dist/state.d.ts

@@ -0,0 +1,105 @@
+import { type Accessor } from '@fluixi/reactive/signal';
+import type { BulkEditorColumn, BulkEditorRow, BulkEditorStateOptions, CellPosition, CellRange, Selection } from './types.js';
+/**
+ * Match a cell value against a filter term. Numeric terms may use comparison
+ * operators (`>20`, `<=5`, `!=0`) or modulo (`%3`, `%3=1`); anything else is a
+ * case-insensitive substring match.
+ */
+export declare function matchesFilter(value: string, filter: string): boolean;
+export declare function colToLabel(col: number): string;
+export declare function labelToCol(label: string): number;
+/** `"B3"` → `{ row: 2, col: 1 }`, or `null` if not a valid A1 address. */
+export declare function parseAddress(address: string): CellPosition | null;
+export interface BulkEditorState {
+    readonly columns: Accessor<BulkEditorColumn[]>;
+    readonly dataRows: Accessor<BulkEditorRow[]>;
+    /** Rows to render — original (groups included) or the flat sorted/filtered view. */
+    readonly viewRows: Accessor<BulkEditorRow[]>;
+    readonly rowCount: Accessor<number>;
+    readonly colCount: Accessor<number>;
+    sort: Accessor<{
+        colKey: string;
+        dir: 'asc' | 'desc';
+    } | null>;
+    sortBy: (colKey: string) => void;
+    setSort: (next: {
+        colKey: string;
+        dir: 'asc' | 'desc';
+    } | null) => void;
+    columnWidths: Accessor<Map<string, number>>;
+    setColumnWidth: (colKey: string, width: number) => void;
+    resetColumnWidth: (colKey: string) => void;
+    columnOrder: Accessor<string[] | null>;
+    setColumnOrder: (keys: string[] | null) => void;
+    /** Move `fromKey` so it lands at `toKey`'s position. */
+    moveColumn: (fromKey: string, toKey: string) => void;
+    /** The footer value for a column (built-in or custom `aggregate`), or `''`. */
+    getColumnAggregate: (colKey: string) => string;
+    columnFilters: Accessor<Map<string, string>>;
+    getColumnFilter: (colKey: string) => string;
+    setColumnFilter: (colKey: string, text: string) => void;
+    clearFilters: () => void;
+    rowAt: (r: number) => BulkEditorRow | undefined;
+    colAt: (c: number) => BulkEditorColumn | undefined;
+    cellAddress: (r: number, c: number) => string;
+    getRaw: (rowId: string, colKey: string) => string;
+    getComputed: (rowId: string, colKey: string) => string;
+    getDisplay: (rowId: string, colKey: string) => string;
+    getRawAt: (r: number, c: number) => string;
+    getComputedAt: (r: number, c: number) => string;
+    getDisplayAt: (r: number, c: number) => string;
+    setCellAt: (r: number, c: number, value: string) => void;
+    isColumnReadOnly: (col: BulkEditorColumn) => boolean;
+    lockedCells: Accessor<Set<string>>;
+    isCellLocked: (rowId: string, colKey: string) => boolean;
+    isCellLockedAt: (r: number, c: number) => boolean;
+    setCellLocked: (rowId: string, colKey: string, locked: boolean) => void;
+    toggleCellLock: (rowId: string, colKey: string) => void;
+    /** A row's lock state derived from its editable cells. */
+    getRowLockState: (rowId: string) => 'all' | 'some' | 'none';
+    toggleRowLock: (rowId: string) => void;
+    getColumnLockState: (colKey: string) => 'all' | 'some' | 'none';
+    toggleColumnLock: (colKey: string) => void;
+    lockSelection: (locked: boolean) => void;
+    errors: Accessor<Map<string, string>>;
+    getError: (rowId: string, colKey: string) => string | undefined;
+    getErrorAt: (r: number, c: number) => string | undefined;
+    hasErrors: Accessor<boolean>;
+    selection: Accessor<Selection | null>;
+    selectionRange: Accessor<CellRange | null>;
+    hasSelection: Accessor<boolean>;
+    isSelected: (r: number, c: number) => boolean;
+    isAnchor: (r: number, c: number) => boolean;
+    selectCell: (r: number, c: number, extend?: boolean) => void;
+    move: (dr: number, dc: number, extend?: boolean) => void;
+    selectRow: (r: number) => void;
+    selectColumn: (c: number) => void;
+    selectAll: () => void;
+    clearSelection: () => void;
+    editing: Accessor<CellPosition | null>;
+    editBuffer: Accessor<string>;
+    setEditBuffer: (value: string) => void;
+    isEditing: (r: number, c: number) => boolean;
+    startEdit: (r: number, c: number, initChar?: string) => boolean;
+    commitEdit: () => void;
+    cancelEdit: () => void;
+    clearRange: () => void;
+    fillDown: () => void;
+    toggleCheckbox: (r: number, c: number) => void;
+    getColumnCheckedState: (colKey: string) => 'all' | 'some' | 'none';
+    toggleColumnChecked: (colKey: string) => void;
+    getSelectionTSV: () => string;
+    pasteTSV: (text: string) => void;
+    undo: () => void;
+    redo: () => void;
+    canUndo: Accessor<boolean>;
+    canRedo: Accessor<boolean>;
+}
+/**
+ * The headless spreadsheet engine: dimensions, a per-cell raw-value store synced
+ * from `rows().data`, a 2D range-selection model, an edit buffer, and the bulk
+ * operations (fill, clear, TSV copy/paste). No DOM, no JSX — the component wires
+ * events to these actions and reads the accessors to render.
+ */
+export declare function createBulkEditorState(options: BulkEditorStateOptions): BulkEditorState;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

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