wandertable 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wilson Glasser
+
+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,505 @@
+# WanderTable
+
+[![CI](https://github.com/wilsonglasser/wandertable/actions/workflows/ci.yml/badge.svg)](https://github.com/wilsonglasser/wandertable/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/wandertable)](https://www.npmjs.com/package/wandertable)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Ko-fi](https://img.shields.io/badge/Ko--fi-wilsonglasser-ff5e5b?logo=ko-fi&logoColor=white)](https://ko-fi.com/wilsonglasser)
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-wilsonglasser-ffdd00?logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/wilsonglasser)
+
+High-performance grid/spreadsheet library for the web. Zero dependencies, TypeScript, DOM-virtualized.
+
+## Features
+
+- **Two modes**: Spreadsheet (independent cells) and Table (column-driven rows)
+- **Two layouts**: `scroll` (fixed height, internal scroll, virtualized) and `auto` (grows with content, page scroll)
+- **DOM virtualized**: Only visible cells exist in the DOM (~750 nodes max). Recycled on scroll.
+- **Rich cell content**: Each cell is a real `<div>` - any HTML, CSS, hover effects, transitions
+- **Renderers**: text, number, checkbox, badge, progress, blank - or register your own
+- **Editors**: text, dropdown (async, searchable, multi-select), blank - or register your own
+- **Cell-level types**: Each cell can have its own renderer/editor independent of the column
+- **Selection**: Single, range (Shift), multi-range (Ctrl), full row/column, select all
+- **Keyboard navigation**: Arrows, Tab, Enter, Escape, Home/End, Ctrl+arrows, typing to edit
+- **Clipboard**: Copy/paste/cut as TSV (compatible with Excel/Sheets). Single-cell paste fills selection.
+- **Undo/Redo**: Command pattern with configurable stack limit
+- **Sorting**: Per-column, asc/desc, custom comparator, external callback for server-side
+- **Filtering**: Per-column, custom filter functions, external callback for server-side
+- **Merge cells**: Merge/unmerge arbitrary ranges
+- **Frozen panes**: Sticky rows and columns that stay visible on scroll
+- **Grouped headers**: Multi-level column headers (e.g. "Months / Jan Feb Mar")
+- **Pagination**: Built-in pagination bar with page size, total rows, navigation
+- **Context menu**: Dynamic items with `visible`/`disabled` as callbacks, per-target (cell/column/row header)
+- **Resize**: Column and row resize by dragging header edges (individually toggleable)
+- **Auto-fit**: Columns and rows auto-size to content
+- **Auto row height**: Rows automatically grow to fit cell content
+- **Export**: CSV and JSON with download, configurable columns/headers
+- **Themes**: Light, Dark, Minimal presets - or define your own via CSS variables
+- **Loading overlay**: Show/hide spinner overlay for async operations
+- **Events**: Typed event system for cell changes, selection, scroll, commands, editor lifecycle
+- **Command events**: `command:execute`, `command:undo`, `command:redo` for syncing with external databases
+- **Fill handle**: Drag to fill cells in any direction (including diagonal), with custom callback
+- **Column reorder**: Drag headers to reorder columns
+- **Row grouping**: Expand/collapse groups of rows
+- **Infinite mode**: Grid auto-expands on navigate/scroll beyond bounds
+- **Lazy loading**: `onLoadMore` callback when scroll reaches the edge
+- **Sparse data model**: Map-based, only cells with data consume memory. Patches for partial updates.
+
+## Install
+
+```bash
+npm install wandertable
+```
+
+## Quick Start
+
+### Spreadsheet Mode
+
+```typescript
+import { WanderTable } from 'wandertable';
+import 'wandertable/style.css';
+
+const table = new WanderTable(document.getElementById('grid'), {
+  mode: 'spreadsheet',
+  rowCount: 1000,
+  colCount: 26,
+  showRowHeaders: true,
+  showColHeaders: true,
+});
+
+// Set individual cells
+table.setCellValue(0, 0, 'Hello');
+table.setCellValue(0, 1, 42);
+
+// Bulk load
+table.applyPatch([
+  { row: 1, col: 0, data: { value: 'World', style: { fontWeight: 'bold' } } },
+  { row: 1, col: 1, data: { value: true, type: 'checkbox' } },
+  { row: 2, col: 0, data: { value: 75, type: 'progress' } },
+  { row: 2, col: 1, data: { value: 'active', type: 'badge' } },
+]);
+```
+
+### Table Mode
+
+```typescript
+const table = new WanderTable(document.getElementById('grid'), {
+  mode: 'table',
+  layout: 'auto', // grows with content, scroll on page
+  autoRowHeight: true,
+  columns: [
+    { key: 'name', label: 'Name', width: 180 },
+    { key: 'email', label: 'Email', width: 200 },
+    { key: 'status', label: 'Status', type: 'badge', width: 100 },
+    { key: 'active', label: 'Active', type: 'checkbox', width: 70 },
+  ],
+  tableData: [
+    { name: 'Alice', email: 'alice@test.com', status: 'active', active: true },
+    { name: 'Bob', email: 'bob@test.com', status: 'pending', active: false },
+  ],
+});
+```
+
+### Grouped Column Headers
+
+```typescript
+const table = new WanderTable(el, {
+  mode: 'table',
+  columns: [
+    { key: 'name', label: 'Name', width: 180 },
+    {
+      label: 'Q4 Sales',
+      children: [
+        { key: 'oct', label: 'Oct', type: 'number', width: 80 },
+        { key: 'nov', label: 'Nov', type: 'number', width: 80 },
+        { key: 'dec', label: 'Dec', type: 'number', width: 80 },
+      ],
+    },
+    {
+      label: 'Metrics',
+      children: [
+        { key: 'score', label: 'Score', type: 'progress', width: 120 },
+        { key: 'active', label: 'Active', type: 'checkbox', width: 70 },
+      ],
+    },
+  ],
+  tableData: [...],
+});
+```
+
+## Options
+
+```typescript
+new WanderTable(container, {
+  // ── Mode & Layout ──
+  mode: 'spreadsheet' | 'table',       // default: 'spreadsheet'
+  layout: 'scroll' | 'auto',           // default: 'scroll'
+
+  // ── Data ──
+  data: CellPatch[],                    // initial cell patches (spreadsheet mode)
+  tableData: Record<string, unknown>[], // initial row objects (table mode)
+  columns: ColumnConfig[],              // column definitions
+  rowCount: number,                     // default: 100
+  colCount: number,                     // default: 26
+
+  // ── Dimensions ──
+  defaultRowHeight: number,             // default: 28
+  defaultColWidth: number,              // default: 100
+  autoRowHeight: boolean,               // auto-fit row height to content. default: false
+
+  // ── Display ──
+  showRowHeaders: boolean,              // show row numbers. default: true
+  showColHeaders: boolean,              // show column letters/labels. default: true
+  showGridLines: boolean,               // show cell borders. default: true
+  showBorder: boolean,                  // show outer border. default: true
+  loading: boolean,                     // show loading overlay. default: false
+
+  // ── Frozen Panes ──
+  frozenRows: number,                   // sticky rows at top. default: 0
+  frozenCols: number,                   // sticky columns at left. default: 0
+
+  // ── Permissions ──
+  readOnly: boolean,                    // no editing at all. default: false
+  allowEditing: boolean,                // allow cell editing. default: true
+  allowSelection: boolean,              // allow cell selection. default: true
+  allowRangeSelection: boolean,         // allow multi-cell selection. default: true
+  allowColResize: boolean,              // column resize by drag. default: true
+  allowRowResize: boolean,              // row resize by drag. default: true
+  allowClipboard: boolean,              // copy/paste/cut. default: true
+  allowContextMenu: boolean,            // right-click menu. default: true
+  allowKeyboardNav: boolean,            // keyboard navigation. default: true
+  allowUndoRedo: boolean,               // undo/redo. default: true
+
+  // ── Cell Defaults ──
+  defaultCellType: string,              // renderer for cells without type. default: 'text'
+  undoLimit: number,                    // max undo stack size. default: 100
+
+  // ── Merge & Sort & Filter ──
+  merges: MergeRange[],                 // initial merged ranges
+  sort: { col, direction },             // initial sort
+  filters: Record<number, FilterFn>,    // initial filters
+  pagination: PaginationConfig,         // pagination settings
+
+  // ── Theme ──
+  theme: Partial<ThemeConfig>,          // or use THEME_DARK, THEME_MINIMAL
+
+  // ── Callbacks ──
+  onCellChange: (row, col, oldValue, newValue) => void,
+  onSelectionChange: (ranges) => void,
+  onScroll: (viewport) => void,
+  onContextMenu: (row, col, event) => void,
+  onSort: (col, direction, key?) => boolean | void,    // return true for external sort
+  onFilter: (col, key, active) => boolean | void,      // return true for external filter
+  onPageChange: (page, pageSize) => void,
+});
+```
+
+## API
+
+### Data
+
+```typescript
+table.setCell(row, col, cellData)      // set full cell data
+table.getCell(row, col)                // get cell data
+table.setCellValue(row, col, value)    // set just the value (with undo)
+table.deleteCell(row, col)             // remove cell
+table.applyPatch(patches)             // bulk update (with undo)
+table.transaction(() => { ... })       // batch changes, single re-render
+table.setTableData(rows)              // replace all data (table mode)
+```
+
+### Selection
+
+```typescript
+table.getSelection()                   // get selected ranges
+table.getSelectionInfo()               // rich info: focus, bounds, cellCount, isFullRow, etc.
+table.setSelection(ranges)             // set selection programmatically
+table.scrollTo(row, col)               // scroll to make cell visible
+```
+
+### Undo / Redo
+
+```typescript
+table.undo()
+table.redo()
+table.commands.canUndo                 // boolean
+table.commands.canRedo                 // boolean
+table.commands.clear()                 // clear history
+```
+
+### Sort & Filter
+
+```typescript
+table.sort(col, 'asc' | 'desc' | null, compareFn?)
+table.clearSort()
+table.getSortState()
+
+table.setFilter(col, (row, data) => boolean)
+table.removeFilter(col)
+table.clearFilters()
+table.getActiveFilters()               // column indices with active filters
+```
+
+### Merge
+
+```typescript
+table.mergeCells(row, col, rowSpan, colSpan)
+table.unmergeCells(row, col)
+table.getMerge(row, col)               // get merge at cell
+table.clearMerges()
+```
+
+### Layout
+
+```typescript
+table.setColumnWidth(col, width)
+table.setRowHeight(row, height)
+table.autoFitColumn(col)               // auto-size to content
+table.autoFitRow(row)                  // auto-size to content
+table.insertRow(at)
+table.insertColumn(at)
+table.refresh()                        // force re-render
+```
+
+### Export
+
+```typescript
+table.exportCSV(options?)              // returns CSV string
+table.exportJSON(options?)             // returns object[]
+table.downloadCSV('file.csv', options?)
+table.downloadJSON('file.json', options?)
+```
+
+Options: `{ visibleOnly, columns, includeHeaders, headers }`
+
+### Pagination
+
+```typescript
+table.setPage(page)                    // 0-based
+table.setPageSize(size)
+table.getPaginationState()             // { page, pageSize, totalRows, totalPages, startRow, endRow }
+table.pagination.nextPage()
+table.pagination.prevPage()
+table.pagination.firstPage()
+table.pagination.lastPage()
+```
+
+### Loading
+
+```typescript
+table.setLoading(true)                 // show spinner overlay
+table.setLoading(false)                // hide
+table.isLoading                        // boolean
+```
+
+### Renderers & Editors
+
+```typescript
+// Register custom renderer
+table.registerRenderer('my-type', {
+  render(cell: HTMLElement, data: CellData | undefined, state: CellState) {
+    cell.innerHTML = `<div class="custom">${data?.value ?? ''}</div>`;
+  }
+});
+
+// Register custom editor
+table.registerEditor('my-editor', () => ({
+  createElement(container) { ... },
+  open(value, bounds, cellData) { ... },
+  getValue() { ... },
+  close() { ... },
+}));
+
+// Use per cell
+table.setCell(0, 0, { value: 'hello', type: 'my-type' });
+
+// Or per column
+columns: [{ key: 'status', type: 'my-type', editor: 'my-editor' }]
+```
+
+Built-in renderers: `text`, `number`, `checkbox`, `badge`, `progress`, `blank`
+
+### Context Menu
+
+```typescript
+// Override menu items
+table.contextMenuItems = [
+  {
+    label: 'My Action',
+    shortcut: 'Ctrl+M',
+    visible: (ctx) => ctx.target === 'cell',        // show only for cells
+    disabled: (ctx) => ctx.readOnly,                 // disable when readOnly
+    action: (ctx) => console.log(ctx.row, ctx.col),
+  },
+  { label: '', separator: true },
+  {
+    label: 'Column Action',
+    visible: (ctx) => ctx.target === 'column-header',
+    action: (ctx) => console.log('col', ctx.col),
+  },
+];
+```
+
+`MenuContext` fields: `target`, `row`, `col`, `selectedCount`, `isMultiSelect`, `isFullRow`, `isFullCol`, `readOnly`, `canUndo`, `canRedo`
+
+### Events
+
+```typescript
+table.on('cell:change', ({ row, col, oldValue, newValue }) => { ... })
+table.on('cell:click', ({ row, col, event }) => { ... })
+table.on('cell:dblclick', ({ row, col, event }) => { ... })
+table.on('cell:contextmenu', ({ row, col, event }) => { ... })
+table.on('selection:change', ({ ranges }) => { ... })
+table.on('editor:open', ({ row, col }) => { ... })
+table.on('editor:close', ({ row, col, value, cancelled }) => { ... })
+table.on('scroll', ({ viewport }) => { ... })
+table.on('column:resize', ({ col, width }) => { ... })
+table.on('row:resize', ({ row, height }) => { ... })
+table.on('data:patch', ({ patches }) => { ... })
+table.on('command:execute', ({ changes }) => { ... })  // sync with DB
+table.on('command:undo', ({ changes }) => { ... })
+table.on('command:redo', ({ changes }) => { ... })
+
+// Unsubscribe
+const unsub = table.on('cell:change', handler);
+unsub();
+```
+
+### Themes
+
+```typescript
+import { THEME_LIGHT, THEME_DARK, THEME_MINIMAL } from 'wandertable';
+
+new WanderTable(el, { theme: THEME_DARK });
+```
+
+Or define your own via CSS variables:
+
+```css
+.wt-root {
+  --wt-bg: #0f172a;
+  --wt-cell-bg: #1e293b;
+  --wt-cell-text: #e2e8f0;
+  --wt-header-bg: #0f172a;
+  --wt-header-text: #94a3b8;
+  --wt-grid-line: #334155;
+  --wt-sel-bg: rgba(59, 130, 246, 0.15);
+  --wt-sel-border: #3b82f6;
+  --wt-focus-border: #60a5fa;
+  --wt-font: 'Inter', sans-serif;
+  --wt-font-size: 13px;
+  --wt-header-font-size: 12px;
+  --wt-cell-padding: 8px;
+  --wt-header-height: 28px;
+  --wt-row-header-width: 50px;
+}
+```
+
+### Fill Handle
+
+Drag the small square at the bottom-right corner of a selection to fill cells.
+
+```typescript
+new WanderTable(el, {
+  allowFillHandle: true, // default: true
+
+  // Optional: override default fill behavior
+  onFill: (source, fill, direction) => {
+    // direction: 'down' | 'up' | 'right' | 'left' | 'diagonal'
+
+    // Return CellPatch[] for custom values
+    // Return true to cancel fill
+    // Return void to use default (repeat pattern)
+  },
+});
+```
+
+### Column Reorder
+
+```typescript
+new WanderTable(el, {
+  allowColReorder: true, // drag column headers to reorder
+});
+
+table.reorderColumn(fromCol, toCol); // programmatic
+```
+
+### Row Grouping
+
+```typescript
+new WanderTable(el, {
+  rowGroups: [
+    { startRow: 0, count: 5, label: 'Group 1', expanded: true },
+    { startRow: 6, count: 3, label: 'Group 2', expanded: false },
+  ],
+});
+
+table.addRowGroup(startRow, count, label);
+table.toggleRowGroup(startRow);
+table.expandAllGroups();
+table.collapseAllGroups();
+```
+
+### Lazy Loading
+
+```typescript
+new WanderTable(el, {
+  onLoadMore: (direction) => {
+    // direction: 'down' | 'right'
+    fetchMoreData().then(rows => {
+      table.applyPatch(rows);
+    });
+  },
+});
+```
+
+### Infinite Mode
+
+```typescript
+new WanderTable(el, {
+  infinite: true,  // grid expands as you navigate/scroll beyond bounds
+  rowCount: 50,    // initial size
+  colCount: 26,
+});
+```
+
+### Utilities
+
+```typescript
+import { columnLabel } from 'wandertable';
+
+columnLabel(0)   // 'A'
+columnLabel(25)  // 'Z'
+columnLabel(26)  // 'AA'
+columnLabel(701) // 'ZZ'
+columnLabel(702) // 'AAA'
+```
+
+## Build Output
+
+| File | Size | Description |
+|------|------|-------------|
+| `dist/wandertable.js` | ~112 KB | ESM module |
+| `dist/wandertable.cjs` | ~85 KB | CommonJS module |
+| `dist/wandertable.umd.js` | ~85 KB | UMD module |
+| `dist/wandertable.global.js` | ~85 KB | IIFE standalone (`window.WanderTable`) |
+| `dist/style.css` | ~8 KB | Styles |
+| `dist/types/` | | TypeScript declarations |
+
+## Development
+
+```bash
+npm install
+npm run dev          # dev server at http://localhost:5173
+npm run build        # build library (ESM + CJS + types + CSS)
+npm run typecheck    # type check
+npm run test         # run 47 unit tests
+npm run test:watch   # tests in watch mode
+```
+
+## CI/CD
+
+- **CI** (`.github/workflows/ci.yml`): Runs on push/PR to main. Typecheck + tests + build on Node 20 and 22.
+- **Publish** (`.github/workflows/publish.yml`): Publishes to npm on GitHub release. Requires `NPM_TOKEN` secret.
+
+## License
+
+MIT

package/dist/style.css

@@ -0,0 +1 @@
+.wt-root{position:relative;overflow:hidden;background:var(--wt-bg, #ffffff);font-family:var(--wt-font, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif);font-size:var(--wt-font-size, 13px);color:var(--wt-cell-text, #1e293b);outline:none;border:1px solid var(--wt-grid-line, #e2e8f0);box-sizing:border-box;user-select:none;-webkit-user-select:none}.wt-root--no-border{border:none}.wt-root--no-gridlines .wt-cell{border-right:none;border-bottom:none}.wt-root--no-gridlines .wt-header-cell,.wt-root--no-gridlines .wt-corner{border-right:none;border-bottom:1px solid var(--wt-grid-line, #e2e8f0)}.wt-root--auto{overflow:visible;height:auto!important}.wt-root *,.wt-root *:before,.wt-root *:after{box-sizing:border-box}.wt-scroll-container{position:absolute;overflow:auto;will-change:scroll-position}.wt-scroll-sentinel{position:absolute;top:0;left:0;pointer-events:none;visibility:hidden}.wt-viewport{position:absolute;top:0;left:0;width:100%;pointer-events:auto}.wt-row{position:absolute;top:0;left:0;width:100%;contain:layout style}.wt-cell{position:absolute;top:0;overflow:hidden;contain:layout style paint;display:flex;align-items:center;padding:0 var(--wt-cell-padding, 8px);background:var(--wt-cell-bg, #ffffff);border-right:1px solid var(--wt-grid-line, #e2e8f0);border-bottom:1px solid var(--wt-grid-line, #e2e8f0);white-space:nowrap;text-overflow:ellipsis;line-height:1.4;cursor:default}.wt-cell--selected{background:var(--wt-sel-bg, rgba(59, 130, 246, .08))}.wt-cell--focused{box-shadow:inset 0 0 0 2px var(--wt-focus-border, #3b82f6);z-index:1}.wt-corner{position:absolute;top:0;left:0;z-index:3;background:var(--wt-header-bg, #f8fafc);border-right:1px solid var(--wt-grid-line, #e2e8f0);border-bottom:1px solid var(--wt-grid-line, #e2e8f0);cursor:pointer}.wt-corner:hover{background:#e2e8f0}.wt-col-headers{position:absolute;top:0;overflow:hidden;z-index:2}.wt-col-headers-inner{position:relative;height:100%}.wt-row-headers{position:absolute;left:0;overflow:hidden;z-index:2}.wt-row-headers-inner{position:relative;width:100%}.wt-header-cell{position:absolute;display:flex;align-items:center;justify-content:center;font-size:var(--wt-header-font-size, 12px);font-weight:500;color:var(--wt-header-text, #475569);background:var(--wt-header-bg, #f8fafc);border-right:1px solid var(--wt-grid-line, #e2e8f0);border-bottom:1px solid var(--wt-grid-line, #e2e8f0);-webkit-user-select:none;user-select:none;cursor:pointer}.wt-header-cell:hover{background:#e2e8f0}.wt-col-header-cell{top:0;cursor:pointer}.wt-col-header-cell:after{content:"";position:absolute;right:0;top:0;width:5px;height:100%;cursor:col-resize}.wt-row-header-cell{left:0}.wt-editor-overlay{position:absolute;z-index:10;pointer-events:auto}.wt-editor-input{width:100%;height:100%;border:2px solid var(--wt-focus-border, #3b82f6);outline:none;font-family:inherit;font-size:inherit;padding:0 var(--wt-cell-padding, 8px);box-sizing:border-box;background:#fff}.wt-dropdown{position:absolute;top:100%;left:0;min-width:100%;max-height:240px;background:#fff;border:1px solid var(--wt-grid-line, #e2e8f0);border-radius:6px;box-shadow:0 4px 16px #0000001f;overflow:hidden;z-index:20}.wt-dropdown-search{width:100%;padding:8px 12px;border:none;border-bottom:1px solid var(--wt-grid-line, #e2e8f0);outline:none;font-family:inherit;font-size:inherit}.wt-dropdown-list{max-height:200px;overflow-y:auto}.wt-dropdown-item{padding:6px 12px;cursor:pointer;display:flex;align-items:center;gap:8px}.wt-dropdown-item:hover,.wt-dropdown-item--highlight{background:var(--wt-sel-bg, rgba(59, 130, 246, .08))}.wt-dropdown-item--selected{background:#3b82f61f;font-weight:500}.wt-dropdown-item--disabled{opacity:.5;cursor:not-allowed}.wt-dropdown-icon{flex-shrink:0}.wt-scroll-container::-webkit-scrollbar{width:8px;height:8px}.wt-scroll-container::-webkit-scrollbar-track{background:transparent}.wt-scroll-container::-webkit-scrollbar-thumb{background:#cbd5e1;border-radius:4px}.wt-scroll-container::-webkit-scrollbar-thumb:hover{background:#94a3b8}.wt-scroll-container::-webkit-scrollbar-corner{background:transparent}.wt-checkbox{display:flex;align-items:center;justify-content:center;width:100%;cursor:pointer}.wt-checkbox-box{width:16px;height:16px;border:1.5px solid #94a3b8;border-radius:3px;display:flex;align-items:center;justify-content:center;transition:all .15s}.wt-checkbox-box--checked{background:#3b82f6;border-color:#3b82f6;color:#fff}.wt-badge{display:inline-block;padding:2px 8px;border-radius:9999px;font-size:11px;font-weight:500;line-height:1.4;white-space:nowrap}.wt-progress{display:flex;align-items:center;gap:8px;width:100%;position:relative}.wt-progress-bar{height:6px;border-radius:3px;flex:1;overflow:hidden;background:#e2e8f0}.wt-progress-label{font-size:11px;color:#64748b;min-width:32px;text-align:right}.wt-context-menu{position:fixed;z-index:50;min-width:180px;background:#fff;border:1px solid #e2e8f0;border-radius:8px;box-shadow:0 4px 24px #00000026;padding:4px 0;font-size:13px}.wt-context-menu-item{display:flex;align-items:center;gap:8px;padding:6px 12px;cursor:pointer;color:#334155}.wt-context-menu-item:hover{background:#f1f5f9}.wt-context-menu-item--disabled{opacity:.4;cursor:not-allowed}.wt-context-menu-item--disabled:hover{background:none}.wt-context-menu-shortcut{margin-left:auto;font-size:11px;color:#94a3b8}.wt-context-menu-separator{height:1px;background:#e2e8f0;margin:4px 0}.wt-fill-handle{position:absolute;width:8px;height:8px;background:var(--wt-focus-border, #3b82f6);border:1px solid #fff;border-radius:1px;cursor:crosshair;z-index:5;pointer-events:auto}.wt-fill-handle:hover{transform:scale(1.3)}.wt-fill-shadow{position:absolute;border:2px dashed var(--wt-focus-border, #3b82f6);background:#3b82f60f;pointer-events:none;z-index:4}.wt-reorder-ghost{position:fixed;padding:4px 12px;background:var(--wt-header-bg, #f8fafc);border:1px solid var(--wt-grid-line, #e2e8f0);border-radius:4px;box-shadow:0 4px 12px #00000026;font-size:var(--wt-header-font-size, 12px);font-weight:500;color:var(--wt-header-text, #475569);pointer-events:none;z-index:100;transform:translate(-50%);opacity:.9}.wt-reorder-indicator{position:absolute;top:0;width:2px;height:100%;background:var(--wt-focus-border, #3b82f6);z-index:10;pointer-events:none}.wt-group-toggle{display:inline-flex;align-items:center;justify-content:center;width:16px;height:16px;border:1px solid #cbd5e1;border-radius:3px;background:#fff;cursor:pointer;font-size:10px;color:#64748b;margin-right:4px;flex-shrink:0}.wt-group-toggle:hover{background:#f1f5f9;border-color:#94a3b8}.wt-row-header-cell:after{content:"";position:absolute;bottom:0;left:0;width:100%;height:4px;cursor:row-resize}.wt-col-header-group{position:absolute;display:flex;align-items:center;justify-content:center;font-size:var(--wt-header-font-size, 12px);font-weight:600;color:var(--wt-header-text, #475569);background:var(--wt-header-bg, #f8fafc);border-right:1px solid var(--wt-grid-line, #e2e8f0);border-bottom:1px solid var(--wt-grid-line, #e2e8f0);-webkit-user-select:none;user-select:none}.wt-pagination{display:flex;align-items:center;gap:8px;padding:6px 12px;background:var(--wt-header-bg, #f8fafc);border-top:1px solid var(--wt-grid-line, #e2e8f0);font-size:12px;color:var(--wt-header-text, #475569);-webkit-user-select:none;user-select:none}.wt-pagination-info{margin-right:auto}.wt-pagination-btn{width:28px;height:28px;display:flex;align-items:center;justify-content:center;border:1px solid var(--wt-grid-line, #e2e8f0);border-radius:4px;background:var(--wt-cell-bg, #fff);color:var(--wt-cell-text, #1e293b);font-size:14px;cursor:pointer;padding:0}.wt-pagination-btn:hover:not(:disabled){background:#e2e8f0}.wt-pagination-btn:disabled{opacity:.3;cursor:not-allowed}.wt-pagination-input{width:48px;height:28px;text-align:center;border:1px solid var(--wt-grid-line, #e2e8f0);border-radius:4px;font-size:12px;outline:none;-moz-appearance:textfield}.wt-pagination-input::-webkit-inner-spin-button,.wt-pagination-input::-webkit-outer-spin-button{-webkit-appearance:none}.wt-loading-overlay{position:absolute;top:0;right:0;bottom:0;left:0;z-index:50;background:#ffffffb3;display:flex;align-items:center;justify-content:center;pointer-events:all}.wt-loading-spinner{width:32px;height:32px;border:3px solid #e2e8f0;border-top-color:#3b82f6;border-radius:50%;animation:wt-spin .6s linear infinite}@keyframes wt-spin{to{transform:rotate(360deg)}}

package/dist/types/WanderTable.d.ts

@@ -0,0 +1,112 @@
+import type { CellData, CellEditor, CellPatch, CellRenderer, SelectionRange, Viewport, WanderTableEvents, WanderTableOptions } from './types/index.js';
+import { DataModel } from './core/DataModel.js';
+import { EventEmitter } from './core/EventEmitter.js';
+import { SelectionModel } from './core/SelectionModel.js';
+import { CommandBus } from './core/CommandBus.js';
+import { ColumnModel } from './columns/ColumnModel.js';
+import { RowModel } from './rows/RowModel.js';
+import { type MenuItemConfig } from './plugins/ContextMenu.js';
+import { RowGroupModel } from './core/RowGroupModel.js';
+import { ViewMapping, type SortDirection, type FilterFn } from './core/ViewMapping.js';
+import { MergeModel, type MergeRange } from './core/MergeModel.js';
+import { PaginationModel } from './core/PaginationModel.js';
+import { type ExportOptions } from './plugins/Export.js';
+export declare class WanderTable extends EventEmitter<WanderTableEvents> {
+    readonly data: DataModel;
+    readonly selection: SelectionModel;
+    readonly columns: ColumnModel;
+    readonly rows: RowModel;
+    readonly commands: CommandBus;
+    readonly viewMapping: ViewMapping;
+    readonly merges: MergeModel;
+    readonly pagination: PaginationModel;
+    readonly rowGroups: RowGroupModel;
+    private renderer;
+    private rendererRegistry;
+    private editorManager;
+    private keyboard;
+    private clipboard;
+    private columnResize;
+    private rowResize;
+    private contextMenu;
+    private autoFit;
+    private paginationBar;
+    private loadingOverlay;
+    private fillHandle;
+    private columnReorder;
+    private headerRows;
+    private theme;
+    private options;
+    private isDragging;
+    private _infiniteScrollHandler;
+    private _lazyLoadHandler;
+    private _keydownHandler;
+    constructor(container: HTMLElement, options?: WanderTableOptions);
+    private wireCallbacks;
+    /** Override this to customize context menu items */
+    contextMenuItems: MenuItemConfig[];
+    private buildMenuContext;
+    private openContextMenu;
+    setCell(row: number, col: number, data: CellData): void;
+    getCell(row: number, col: number): CellData | undefined;
+    setCellValue(row: number, col: number, value: unknown): void;
+    deleteCell(row: number, col: number): void;
+    applyPatch(patches: CellPatch[]): void;
+    transaction(fn: () => void): void;
+    undo(): void;
+    redo(): void;
+    getSelection(): SelectionRange[];
+    getSelectionInfo(): import("./index.js").SelectionInfo;
+    setSelection(ranges: SelectionRange[]): void;
+    scrollTo(row: number, col: number): void;
+    registerRenderer(name: string, renderer: CellRenderer): void;
+    registerEditor(name: string, factory: () => CellEditor): void;
+    setColumnWidth(col: number, width: number): void;
+    setRowHeight(row: number, height: number): void;
+    autoFitColumn(col: number): void;
+    autoFitRow(row: number): void;
+    insertRow(at: number): void;
+    insertColumn(at: number): void;
+    sort(col: number, direction: SortDirection, compareFn?: (a: unknown, b: unknown) => number): void;
+    clearSort(): void;
+    getSortState(): import("./index.js").SortState | null;
+    setFilter(col: number, fn: FilterFn): void;
+    removeFilter(col: number): void;
+    clearFilters(): void;
+    getActiveFilters(): number[];
+    mergeCells(row: number, col: number, rowSpan: number, colSpan: number): void;
+    unmergeCells(row: number, col: number): void;
+    getMerge(row: number, col: number): MergeRange | null;
+    clearMerges(): void;
+    addRowGroup(startRow: number, count: number, label?: string, expanded?: boolean): void;
+    removeRowGroup(startRow: number): void;
+    toggleRowGroup(startRow: number): void;
+    expandAllGroups(): void;
+    collapseAllGroups(): void;
+    exportCSV(options?: ExportOptions): string;
+    exportJSON(options?: ExportOptions): object[];
+    downloadCSV(filename?: string, options?: ExportOptions): void;
+    downloadJSON(filename?: string, options?: ExportOptions): void;
+    getViewport(): Viewport;
+    refresh(): void;
+    destroy(): void;
+    private startEditing;
+    private deleteSelected;
+    private pasteWithUndo;
+    private cutWithUndo;
+    private execCommand;
+    /** Move a column from one index to another, shifting data */
+    reorderColumn(fromCol: number, toCol: number): void;
+    private expandIfNeeded;
+    private isFullRowOrColSelected;
+    /** Load row objects into the sparse DataModel using column keys */
+    private loadTableData;
+    /** Replace all table data (table mode) */
+    setTableData(rows: Record<string, unknown>[]): void;
+    setLoading(loading: boolean): void;
+    get isLoading(): boolean;
+    setPage(page: number): void;
+    setPageSize(size: number): void;
+    getPaginationState(): import("./index.js").PaginationState;
+}
+//# sourceMappingURL=WanderTable.d.ts.map

package/dist/types/WanderTable.d.ts.map

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

package/dist/types/__tests__/ColumnModel.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ColumnModel.test.d.ts.map

package/dist/types/__tests__/ColumnModel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColumnModel.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/ColumnModel.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/CommandBus.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CommandBus.test.d.ts.map

package/dist/types/__tests__/CommandBus.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandBus.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/CommandBus.test.ts"],"names":[],"mappings":""}