@fluixi-ui/bulk-editor 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fluixi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fluixi/assets/main/logos/128x128.png" alt="Fluixi" width="120" height="120" />
+</p>
+
+# @fluixi-ui/bulk-editor
+
+**Spreadsheet-style bulk data editor grid — Excel / Smartsheet interactions for the web.**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-22c55e.svg)](../../LICENSE)
+![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white)
+![Registry](https://img.shields.io/badge/registry-GitHub%20Packages-181717?logo=github)
+![Framework](https://img.shields.io/badge/framework-Fluixi%20%F0%9F%AB%96-ff6b35)
+
+---
+
+A keyboard- and mouse-driven grid for editing many records at once. Range
+selection, type-to-edit, fill-down, and TSV copy/paste — backed by a headless
+engine you can drive on its own.
+
+```tsx
+import { BulkEditor } from '@fluixi-ui/bulk-editor';
+import type { BulkEditorColumn, BulkEditorRow } from '@fluixi-ui/bulk-editor';
+
+const columns: BulkEditorColumn[] = [
+  { key: 'sku', header: 'SKU', align: 'left' },
+  { key: 'price', header: 'Price', type: 'number' },
+  { key: 'active', header: 'Active', type: 'checkbox' },
+];
+
+const rows: BulkEditorRow[] = [
+  { id: 'g', isGroup: true, label: 'T-Shirt' },
+  { id: 'r1', label: 'Small / Black', data: { sku: 'TS-S-BLK', price: '19.00', active: '1' } },
+];
+
+<BulkEditor
+  columns={() => columns}
+  rows={() => rows}
+  onCellChange={(rowId, colKey, value) => save(rowId, colKey, value)}
+/>
+```
+
+## Interactions
+
+- **Select** — click a cell, shift-click / shift-arrow to extend, drag to sweep a
+  range, click a column header or row label for the whole column/row, corner cell
+  or `Ctrl+A` for all.
+- **Edit** — double-click, `Enter`, `F2`, or just start typing; `Tab` / `Enter`
+  commit and move, `Escape` cancels. Committing with a range selected fills it.
+- **Bulk** — `Delete` clears, `Ctrl+D` (or the fill handle) fills down,
+  `Ctrl+C` / `Ctrl+V` copy and paste TSV.
+
+## Columns & rows
+
+- Column `type`: `text` | `number` | `checkbox`; plus `width`, `align`,
+  `readOnly`, `placeholder`, `headerExtra`, and a per-cell `disable`.
+- Rows carry `data` (keyed by column key). `isGroup` rows are non-editable
+  section headers with an optional `groupData` map and `subLabel` / `thumbnail`.
+  `rowActions` renders a trailing actions cell.
+
+## Headless engine
+
+The grid is a thin layer over `createBulkEditorState`, which owns the selection,
+edit buffer, and bulk operations with no DOM:
+
+```tsx
+import { createBulkEditorState } from '@fluixi-ui/bulk-editor';
+
+const grid = createBulkEditorState({ columns, rows, onCellChange });
+grid.selectAll();
+grid.fillDown();
+const tsv = grid.getSelectionTSV();
+```
+
+### Formula-ready
+
+Every cell has a **raw** value (what was typed) and a **computed** value shown in
+the grid. Pass an `evaluate` hook to compute it — the entry point for formatting,
+computed columns, or a formula engine. A1 addressing (`colToLabel`, `parseAddress`,
+`cellAddress`) is built in.
+
+```tsx
+createBulkEditorState({
+  columns,
+  rows,
+  evaluate: ({ raw, get }) =>
+    raw.startsWith('=') ? String(Number(get('A1')) + Number(get('A2'))) : raw,
+});
+```
+
+---
+
+Part of the [Fluixi UI](../../README.md) component library. Made with ☕ by the Fluixi team.

package/dist/bulk-editor.d.ts

@@ -0,0 +1,10 @@
+import type { JSX } from '@fluixi/jsx';
+import type { BulkEditorProps } from './types.js';
+/**
+ * A spreadsheet-style bulk editor grid. Wraps {@link createBulkEditorState} with
+ * a keyboard/mouse-driven `role="grid"` surface: click / shift-click / drag to
+ * select, type or double-click to edit, arrows to navigate, drag the fill handle
+ * or Ctrl+D to fill down, and Ctrl+C/V to copy-paste.
+ */
+export declare function BulkEditor(props: BulkEditorProps): JSX.Element;
+//# sourceMappingURL=bulk-editor.d.ts.map

package/dist/bulk-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-editor.d.ts","sourceRoot":"","sources":["../src/bulk-editor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,KAAK,EAAoB,eAAe,EAAqC,MAAM,YAAY,CAAC;AAyBvG;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,CAAC,OAAO,CAklB9D"}