@iyulab/flex-table 0.10.0 → 0.10.2

package/dist/clipboard/clipboard.d.ts

@@ -0,0 +1,12 @@
+import type { CellRange } from '../core/selection.js';
+import type { ColumnDefinition, DataRow } from '../models/types.js';
+/**
+ * Copy selected range to clipboard as TSV.
+ */
+export declare function copyToClipboard(data: DataRow[], columns: ColumnDefinition[], range: CellRange): string;
+/**
+ * Parse TSV/CSV clipboard text into a 2D array of strings.
+ * Handles RFC 4180 quoted fields: double-quote escaping, embedded tabs/newlines.
+ */
+export declare function parseClipboardText(text: string): string[][];
+export declare function parseValueForColumn(raw: string, col: ColumnDefinition): unknown;

package/dist/clipboard/clipboard.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/editing.d.ts

@@ -0,0 +1,15 @@
+import type { CellPosition } from './selection.js';
+export interface EditState {
+    position: CellPosition;
+    originalValue: unknown;
+}
+/**
+ * Manages cell editing state.
+ */
+export declare class EditingState {
+    current: EditState | null;
+    start(position: CellPosition, originalValue: unknown): void;
+    isEditing(row: number, col: number): boolean;
+    cancel(): EditState | null;
+    commit(): EditState | null;
+}

package/dist/core/filtering.d.ts

@@ -0,0 +1,28 @@
+import type { DataRow } from '../models/types.js';
+/**
+ * Filter predicate function.
+ * Receives the cell value and the full row.
+ */
+export type FilterPredicate = (value: unknown, row: DataRow) => boolean;
+/**
+ * A filter applied to a specific column.
+ */
+export interface ColumnFilter {
+    /** Column key this filter applies to */
+    key: string;
+    /** Filter predicate */
+    predicate: FilterPredicate;
+}
+/**
+ * Callback invoked when a filter predicate throws an error.
+ */
+export type FilterErrorCallback = (error: unknown, row: DataRow, filter: ColumnFilter) => void;
+/**
+ * Compute filtered indices.
+ * Returns data indices that pass ALL filters (AND logic).
+ * Original data is never mutated.
+ *
+ * If a filter predicate throws, the row is included (fail-open)
+ * and the optional `onError` callback is invoked.
+ */
+export declare function computeFilteredIndices(data: DataRow[], filters: ColumnFilter[], onError?: FilterErrorCallback): number[];

package/dist/core/filtering.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/row-selection.d.ts

@@ -0,0 +1,23 @@
+import type { SelectionMode } from '../models/types.js';
+/**
+ * Manages row-level selection state (checkbox-based).
+ * Separate from cell-level SelectionState.
+ */
+export declare class RowSelectionState {
+    private _selected;
+    private _mode;
+    private _rowCount;
+    get mode(): SelectionMode;
+    set mode(value: SelectionMode);
+    setRowCount(count: number): void;
+    get selectedIndices(): number[];
+    get selectedCount(): number;
+    get isAllSelected(): boolean;
+    get isSomeSelected(): boolean;
+    isSelected(index: number): boolean;
+    toggle(index: number): void;
+    select(index: number): void;
+    deselect(index: number): void;
+    selectAll(): void;
+    deselectAll(): void;
+}

package/dist/core/selection.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Represents the active cell position.
+ */
+export interface CellPosition {
+    row: number;
+    col: number;
+}
+/**
+ * A rectangular range of cells.
+ */
+export interface CellRange {
+    startRow: number;
+    startCol: number;
+    endRow: number;
+    endCol: number;
+}
+/**
+ * Returns normalized range (start <= end).
+ */
+export declare function normalizeRange(range: CellRange): CellRange;
+/**
+ * Manages active cell state and range selection.
+ */
+export declare class SelectionState {
+    activeCell: CellPosition | null;
+    /** Anchor cell for range selection (Shift+Arrow/Click) */
+    rangeAnchor: CellPosition | null;
+    /** Current range end (the active cell is the range end during Shift selection) */
+    range: CellRange | null;
+    private _rowCount;
+    private _colCount;
+    setDimensions(rowCount: number, colCount: number): void;
+    setActive(row: number, col: number): CellPosition | null;
+    /** Set active cell and extend range from anchor */
+    setActiveWithRange(row: number, col: number): CellPosition | null;
+    /** Check if a cell is within the current selection range */
+    isInRange(row: number, col: number): boolean;
+    /** Get the effective range: either the explicit range or just the active cell */
+    getEffectiveRange(): CellRange | null;
+    clear(): void;
+    moveUp(): CellPosition | null;
+    moveDown(): CellPosition | null;
+    moveLeft(): CellPosition | null;
+    moveRight(): CellPosition | null;
+    moveNext(): CellPosition | null;
+    movePrev(): CellPosition | null;
+    moveToStart(): CellPosition | null;
+    moveToEnd(): CellPosition | null;
+    moveToRowStart(): CellPosition | null;
+    moveToRowEnd(): CellPosition | null;
+    shiftMoveUp(): CellPosition | null;
+    shiftMoveDown(): CellPosition | null;
+    shiftMoveLeft(): CellPosition | null;
+    shiftMoveRight(): CellPosition | null;
+}

package/dist/core/selection.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/sorting.d.ts

@@ -0,0 +1,27 @@
+import type { ColumnDefinition, DataRow } from '../models/types.js';
+/**
+ * Sort direction.
+ */
+export type SortDirection = 'asc' | 'desc';
+/**
+ * A single sort criterion.
+ */
+export interface SortCriteria {
+    /** Column key to sort by */
+    key: string;
+    /** Sort direction */
+    direction: SortDirection;
+}
+/**
+ * Compute sorted index mapping.
+ * Returns an array where result[visualIndex] = dataIndex.
+ * Original data is never mutated.
+ */
+export declare function computeSortedIndices(data: DataRow[], criteria: SortCriteria[], columns: ColumnDefinition[]): number[];
+/**
+ * Toggle sort for a column key in the criteria array.
+ * Cycle: none → asc → desc → none.
+ * If multi is true (Shift+click), add as secondary sort.
+ * If multi is false, replace all criteria with this column.
+ */
+export declare function toggleSort(criteria: SortCriteria[], key: string, multi: boolean): SortCriteria[];

package/dist/core/sorting.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/undo.d.ts

@@ -0,0 +1,45 @@
+/**
+ * A single undoable action.
+ */
+export interface UndoAction {
+    /** Human-readable label for debugging */
+    label: string;
+    /** Revert the action */
+    undo: () => void;
+    /** Re-apply the action */
+    redo: () => void;
+}
+/**
+ * Manages undo/redo history.
+ */
+export declare class UndoStack {
+    private _undoStack;
+    private _redoStack;
+    private _maxSize;
+    /** Get/set the maximum number of undo actions stored. */
+    get maxSize(): number;
+    set maxSize(value: number);
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    get undoCount(): number;
+    get redoCount(): number;
+    /**
+     * Push a new action onto the undo stack.
+     * Clears the redo stack (new action invalidates redo history).
+     */
+    push(action: UndoAction): void;
+    /**
+     * Undo the most recent action.
+     * Returns the action label, or null if nothing to undo.
+     */
+    undo(): string | null;
+    /**
+     * Redo the most recently undone action.
+     * Returns the action label, or null if nothing to redo.
+     */
+    redo(): string | null;
+    /**
+     * Clear all undo/redo history.
+     */
+    clear(): void;
+}

package/dist/core/undo.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/export/export.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnDefinition, DataRow } from '../models/types.js';
+export type ExportFormat = 'csv' | 'tsv' | 'json';
+/**
+ * Export data to the specified format.
+ */
+export declare function exportData(data: DataRow[], columns: ColumnDefinition[], format: ExportFormat): string;
+/**
+ * Trigger a file download in the browser.
+ */
+export declare function downloadFile(content: string, filename: string, mimeType: string): void;
+export declare function getExportMimeType(format: ExportFormat): string;
+export declare function getExportExtension(format: ExportFormat): string;

package/dist/export/export.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/{flex-table-C0CCHc1F.js → flex-table-DNBCgorV.js}

@@ -762,7 +762,7 @@ function it(t) {
   }
   return i;
 }
-function A(t, e) {
+function z(t, e) {
   if (t === "") return null;
   switch (e.type) {
     case "number": {
@@ -775,7 +775,7 @@ function A(t, e) {
       return t;
   }
 }
-function z(t, e, i) {
+function A(t, e, i) {
   switch (i) {
     case "csv":
       return U(t, e, ",");
@@ -837,10 +837,10 @@ var ht = Object.defineProperty, dt = Object.getOwnPropertyDescriptor, v = (t, e,
     (n = t[r]) && (o = (s ? n(e, i, o) : n(o)) || o);
   return s && o && ht(e, i, o), o;
 };
-const S = 120, E = 40, ut = 32, $ = 5;
+const S = 120, E = 40, ut = 32, R = 5;
 let _ = class extends T {
   constructor() {
-    super(...arguments), this.columns = [], this.data = [], this.rowHeight = ut, this.showRowNumbers = !1, this.theme = void 0, this.maxRows = 0, this.editable = !0, this.showFilters = !1, this.selectable = !1, this.dataMode = "client", this.footerData = null, this._scrollTop = 0, this._scrollLeft = 0, this._viewportHeight = 0, this._viewportWidth = 0, this._colLeftOffsets = [], this._totalRowWidth = 0, this._activeCell = null, this._editingCell = null, this._sortCriteria = [], this._selection = new j(), this._editing = new B(), this._rowSelection = new X(), this._undo = new tt(), this._filters = [], this._filteredIndices = [], this._sortedIndices = [], this._openFilterKey = null, this._rowSelectionVersion = 0, this._viewDirty = !0, this._resizing = null, this._resizeCleanup = null, this._columnWidths = /* @__PURE__ */ new Map(), this._invalidCells = /* @__PURE__ */ new Map(), this._textFilterState = /* @__PURE__ */ new Map(), this._numberFilterState = /* @__PURE__ */ new Map(), this._dateFilterState = /* @__PURE__ */ new Map();
+    super(...arguments), this.columns = [], this.data = [], this.rowHeight = ut, this.showRowNumbers = !1, this.theme = void 0, this.maxRows = 0, this.editable = !0, this.showFilters = !1, this.selectable = !1, this.dataMode = "client", this.footerData = null, this._scrollTop = 0, this._scrollLeft = 0, this._viewportHeight = 0, this._viewportWidth = 0, this._colLeftOffsets = [], this._totalRowWidth = 0, this._activeCell = null, this._editingCell = null, this._sortCriteria = [], this._selection = new j(), this._editing = new B(), this._rowSelection = new X(), this._undo = new tt(), this._filters = [], this._filteredIndices = [], this._sortedIndices = [], this._openFilterKey = null, this._rowSelectionVersion = 0, this._viewDirty = !0, this._resizing = null, this._resizeCleanup = null, this._columnWidths = /* @__PURE__ */ new Map(), this._hostResizeObserver = null, this._invalidCells = /* @__PURE__ */ new Map(), this._textFilterState = /* @__PURE__ */ new Map(), this._numberFilterState = /* @__PURE__ */ new Map(), this._dateFilterState = /* @__PURE__ */ new Map();
   }
   set selectionMode(t) {
     this._rowSelection.mode = t, this.requestUpdate();
@@ -1150,10 +1150,10 @@ let _ = class extends T {
       const o = this.visibleColumns.slice(s.startCol, s.endCol + 1), r = [];
       for (let n = s.startRow; n <= s.endRow; n++)
         r.push(this.data[this._toDataIndex(n)]);
-      return z(r, o, t);
+      return A(r, o, t);
     }
     const i = this._sortedIndices.map((s) => this.data[s]);
-    return z(i, this.visibleColumns, t);
+    return A(i, this.visibleColumns, t);
   }
   /**
    * Export table data and trigger file download.
@@ -1191,14 +1191,14 @@ let _ = class extends T {
     return this._visibleRowCount * this.rowHeight;
   }
   get visibleRange() {
-    const t = Math.max(0, this._scrollTop - this.headerHeight), e = Math.max(0, Math.floor(t / this.rowHeight) - $), i = Math.ceil(this._viewportHeight / this.rowHeight), s = Math.min(this._visibleRowCount, Math.floor(t / this.rowHeight) + i + $);
+    const t = Math.max(0, this._scrollTop - this.headerHeight), e = Math.max(0, Math.floor(t / this.rowHeight) - R), i = Math.ceil(this._viewportHeight / this.rowHeight), s = Math.min(this._visibleRowCount, Math.floor(t / this.rowHeight) + i + R);
     return { start: e, end: s };
   }
   connectedCallback() {
-    super.connectedCallback(), this._onScroll = this._onScroll.bind(this), this._onKeyDown = this._onKeyDown.bind(this), this._onDocumentClick = this._onDocumentClick.bind(this), this._onContextMenu = this._onContextMenu.bind(this), this.addEventListener("scroll", this._onScroll, { passive: !0 }), this.addEventListener("keydown", this._onKeyDown), this.addEventListener("contextmenu", this._onContextMenu), this.hasAttribute("tabindex") || this.setAttribute("tabindex", "0"), this.setAttribute("role", "grid");
+    super.connectedCallback(), this._onScroll = this._onScroll.bind(this), this._onKeyDown = this._onKeyDown.bind(this), this._onDocumentClick = this._onDocumentClick.bind(this), this._onContextMenu = this._onContextMenu.bind(this), this.addEventListener("scroll", this._onScroll, { passive: !0 }), this.addEventListener("keydown", this._onKeyDown), this.addEventListener("contextmenu", this._onContextMenu), this.hasAttribute("tabindex") || this.setAttribute("tabindex", "0"), this.setAttribute("role", "grid"), typeof ResizeObserver < "u" && (this._hostResizeObserver = new ResizeObserver(() => this._measureViewport()), this._hostResizeObserver.observe(this));
   }
   disconnectedCallback() {
-    super.disconnectedCallback(), this.removeEventListener("scroll", this._onScroll), this.removeEventListener("keydown", this._onKeyDown), this.removeEventListener("contextmenu", this._onContextMenu), document.removeEventListener("click", this._onDocumentClick), this._resizeCleanup && (this._resizeCleanup(), this._resizeCleanup = null);
+    super.disconnectedCallback(), this.removeEventListener("scroll", this._onScroll), this.removeEventListener("keydown", this._onKeyDown), this.removeEventListener("contextmenu", this._onContextMenu), document.removeEventListener("click", this._onDocumentClick), this._resizeCleanup && (this._resizeCleanup(), this._resizeCleanup = null), this._hostResizeObserver && (this._hostResizeObserver.disconnect(), this._hostResizeObserver = null);
   }
   firstUpdated() {
     this._measureViewport();
@@ -1222,20 +1222,20 @@ let _ = class extends T {
         o = n;
         break;
       }
-    o = Math.max(0, o - $);
+    o = Math.max(0, o - R);
     let r = t.length;
     for (let n = o; n < e.length; n++)
       if (e[n] > s) {
         r = n;
         break;
       }
-    return r = Math.min(t.length, r + $), { start: o, end: r };
+    return r = Math.min(t.length, r + R), { start: o, end: r };
   }
   willUpdate(t) {
     (!(t.size <= 2 && !t.has("data") && !t.has("columns") && !t.has("_openFilterKey") && !t.has("_editingCell") && !t.has("_activeCell") && (t.has("_scrollTop") || t.has("_scrollLeft"))) || this._viewDirty) && (this._recomputeView(), this._viewDirty = !1), this._updateColOffsets(), this._selection.setDimensions(this._visibleRowCount, this.visibleColumns.length), this._rowSelection.setRowCount(this._visibleRowCount);
   }
   updated() {
-    this._measureViewport(), this._focusEditor(), this._adjustFilterDropdown(), this.setAttribute("aria-rowcount", String(this._visibleRowCount)), this.setAttribute("aria-colcount", String(this.visibleColumns.length));
+    this._focusEditor(), this._adjustFilterDropdown(), this.setAttribute("aria-rowcount", String(this._visibleRowCount)), this.setAttribute("aria-colcount", String(this.visibleColumns.length));
   }
   /** Recompute filter → sort pipeline. */
   _recomputeView() {
@@ -1340,7 +1340,7 @@ let _ = class extends T {
     if (!this._editing.current) return;
     const t = (e = this.shadowRoot) == null ? void 0 : e.querySelector(".ft-editor");
     if (t) {
-      const i = this.visibleColumns[this._editing.current.position.col], s = A(t.value, i);
+      const i = this.visibleColumns[this._editing.current.position.col], s = z(t.value, i);
       this._applyEdit(s);
     } else
       this._cancelEdit();
@@ -1546,7 +1546,7 @@ let _ = class extends T {
       for (let l = 0; l < e[o].length; l++) {
         const a = t.col + l;
         if (a >= i.length) break;
-        const d = i[a], f = this.data[n][d.key], h = A(e[o][l], d);
+        const d = i[a], f = this.data[n][d.key], h = z(e[o][l], d);
         this.data[n][d.key] = h, s.push({ row: n, col: a, key: d.key, oldValue: f, newValue: h });
       }
     }
@@ -1967,8 +1967,8 @@ let _ = class extends T {
     `;
   }
   _renderCell(t, e, i, s) {
-    var x, R, D, F;
-    const o = ((x = this._activeCell) == null ? void 0 : x.row) === i && ((R = this._activeCell) == null ? void 0 : R.col) === s, r = ((D = this._editingCell) == null ? void 0 : D.row) === i && ((F = this._editingCell) == null ? void 0 : F.col) === s, n = this._selection.isInRange(i, s), l = e.pinned === "left", a = e.pinned === "right", d = l || a, f = this._getColWidth(e), h = this.rowHeight, g = this._colLeftOffsets[s] ?? 0;
+    var x, $, D, F;
+    const o = ((x = this._activeCell) == null ? void 0 : x.row) === i && (($ = this._activeCell) == null ? void 0 : $.col) === s, r = ((D = this._editingCell) == null ? void 0 : D.row) === i && ((F = this._editingCell) == null ? void 0 : F.col) === s, n = this._selection.isInRange(i, s), l = e.pinned === "left", a = e.pinned === "right", d = l || a, f = this._getColWidth(e), h = this.rowHeight, g = this._colLeftOffsets[s] ?? 0;
     let p;
     l ? p = `position: absolute; top: 0; left: ${this._scrollLeft + this._getPinnedLeft(s)}px; width: ${f}px; height: ${h}px; z-index: 2;` : a ? p = `position: absolute; top: 0; right: ${-this._scrollLeft + this._getPinnedRight(s)}px; width: ${f}px; height: ${h}px; z-index: 2;` : p = `left: ${g}px; width: ${f}px; height: ${h}px;`;
     const c = !this._isCellEditable(e);
@@ -2132,6 +2132,6 @@ export {
   _ as F,
   X as R,
   tt as U,
-  z as e,
+  A as e,
   H as r
 };

package/dist/flex-table.d.ts

@@ -0,0 +1,238 @@
+import { LitElement } from 'lit';
+import type { ExportFormat } from './export/export.js';
+import type { CellPosition } from './core/selection.js';
+import type { SortCriteria } from './core/sorting.js';
+import type { FilterPredicate } from './core/filtering.js';
+import type { ColumnDefinition, DataRow, SelectionMode, DataMode } from './models/types.js';
+import type { TemplateResult } from 'lit';
+export declare class FlexTable extends LitElement {
+    static styles: import("lit").CSSResult;
+    columns: ColumnDefinition[];
+    data: DataRow[];
+    rowHeight: number;
+    showRowNumbers: boolean;
+    theme: 'light' | 'dark' | undefined;
+    maxRows: number;
+    editable: boolean;
+    showFilters: boolean;
+    /** Enable row-level checkbox selection. */
+    selectable: boolean;
+    /** Row selection mode: 'single' or 'multi' (default: 'multi'). */
+    set selectionMode(value: SelectionMode);
+    get selectionMode(): SelectionMode;
+    /** Data processing mode: 'client' (default) or 'server'. */
+    dataMode: DataMode;
+    /** Footer/summary row data. Keys match column keys; values are display strings. */
+    footerData: Record<string, string | TemplateResult> | null;
+    set maxUndoSize(value: number);
+    get maxUndoSize(): number;
+    private _scrollTop;
+    private _scrollLeft;
+    private _viewportHeight;
+    private _viewportWidth;
+    private _colLeftOffsets;
+    private _totalRowWidth;
+    private _activeCell;
+    private _editingCell;
+    private _sortCriteria;
+    private _selection;
+    private _editing;
+    private _rowSelection;
+    private _undo;
+    private _filters;
+    private _filteredIndices;
+    private _sortedIndices;
+    private _openFilterKey;
+    private _rowSelectionVersion;
+    private _viewDirty;
+    private _resizing;
+    private _resizeCleanup;
+    private _columnWidths;
+    private _hostResizeObserver;
+    get visibleColumns(): ColumnDefinition[];
+    private get _prefixWidth();
+    /** Whether an undo operation is available. */
+    get canUndo(): boolean;
+    /** Whether a redo operation is available. */
+    get canRedo(): boolean;
+    get activeCell(): CellPosition | null;
+    get editingCell(): CellPosition | null;
+    get sortCriteria(): SortCriteria[];
+    /** Number of rows after filtering (before pagination). */
+    get filteredRowCount(): number;
+    /** Get data indices of currently selected rows. */
+    getSelectedRows(): {
+        selectedIndices: number[];
+        selectedRows: DataRow[];
+    };
+    /** Select all visible rows (multi mode only). */
+    selectAll(): void;
+    /** Deselect all rows. */
+    deselectAll(): void;
+    private _dispatchRowSelectionEvent;
+    /**
+     * Set a filter for a column. Replaces any existing filter on the same key.
+     */
+    setFilter(key: string, predicate: FilterPredicate): void;
+    /**
+     * Remove the filter for a column.
+     */
+    removeFilter(key: string): void;
+    /**
+     * Remove all filters.
+     */
+    clearFilters(): void;
+    /**
+     * Get current active filter keys.
+     */
+    get filterKeys(): string[];
+    /**
+     * Explicitly request a re-render after external data mutations.
+     * Useful when `data` array contents are mutated in-place without reassignment.
+     */
+    refreshData(): void;
+    private _dispatchUndoStateEvent;
+    private _dispatchFilterEvent;
+    /**
+     * Add a column at the specified index (default: end).
+     * Returns the added column definition.
+     */
+    addColumn(def: ColumnDefinition, index?: number): ColumnDefinition;
+    /**
+     * Delete a column by its key.
+     * Removes related filters, sort criteria, and column width overrides.
+     */
+    deleteColumn(key: string): void;
+    /**
+     * Move a column to a new position.
+     * @param key Column key to move.
+     * @param newIndex Target index in the columns array.
+     */
+    moveColumn(key: string, newIndex: number): void;
+    /**
+     * Add a row at the specified index (default: end).
+     * Returns the new row.
+     */
+    addRow(row?: DataRow, index?: number): DataRow | null;
+    /**
+     * Delete rows at the specified data indices.
+     * If no indices provided, deletes the currently selected rows.
+     */
+    deleteRows(indices?: number[]): void;
+    /**
+     * Apply multiple cell changes as a single undo-able operation.
+     * @param changes Array of { row (data index), key, value } objects.
+     */
+    updateRows(changes: Array<{
+        row: number;
+        key: string;
+        value: unknown;
+    }>): void;
+    private _createEmptyRow;
+    /**
+     * Export table data to string in the specified format.
+     * @param options.selectionOnly - Export only the currently selected range
+     */
+    exportToString(format: ExportFormat, options?: {
+        selectionOnly?: boolean;
+    }): string;
+    /**
+     * Export table data and trigger file download.
+     */
+    exportToFile(format: ExportFormat, filename?: string): void;
+    private _getSelectedDataRows;
+    /**
+     * Get the effective width for a column, checking internal overrides first.
+     */
+    getColumnWidth(key: string): number | undefined;
+    private _getColWidth;
+    private get headerHeight();
+    /** Number of rows visible after filter + sort. */
+    private get _visibleRowCount();
+    private get totalBodyHeight();
+    private get visibleRange();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected firstUpdated(): void;
+    private _updateColOffsets;
+    private get visibleColRange();
+    protected willUpdate(changedProperties: Map<string, unknown>): void;
+    protected updated(): void;
+    /** Recompute filter → sort pipeline. */
+    private _recomputeView;
+    /** Map visual row index to data row index */
+    private _toDataIndex;
+    private _focusEditor;
+    private _measureViewport;
+    private _onScroll;
+    private _onDocumentClick;
+    private _onContextMenu;
+    private _onCellClickEvent;
+    private _onRowNumberClick;
+    private _onCellDblClick;
+    /** Check if a column is editable based on global + per-column settings */
+    private _isCellEditable;
+    private _startEdit;
+    private _commitEdit;
+    private _applyEdit;
+    private _cancelEdit;
+    private _onEditorKeyDown;
+    private _syncActiveCell;
+    private _onKeyDown;
+    private _handleCtrlKey;
+    private _handleAltKey;
+    private _handleNavigation;
+    private _handleCopy;
+    private _handlePaste;
+    private _readClipboardText;
+    private _expandRowsForPaste;
+    private _applyPasteData;
+    private _handleDelete;
+    private _clearRange;
+    private _scrollToActiveCell;
+    private _dispatchSelectionEvent;
+    private _onHeaderClick;
+    private _selectColumn;
+    /** Public API: select an entire column by index. */
+    selectColumn(colIndex: number): void;
+    /** Calculate cumulative left offset for a left-pinned column */
+    private _getPinnedLeft;
+    /** Calculate cumulative right offset for a right-pinned column */
+    private _getPinnedRight;
+    private _renderHeaderCell;
+    private _adjustFilterDropdown;
+    private _onFilterBtnClick;
+    private _renderFilterDropdown;
+    private _renderTextFilter;
+    private _renderNumberFilter;
+    private _invalidCells;
+    private _cellKey;
+    private _markCellInvalid;
+    private _isCellInvalid;
+    private _textFilterState;
+    private _numberFilterState;
+    private _dateFilterState;
+    private _applyNumberFilter;
+    private _renderDateFilter;
+    private _applyDateFilter;
+    private _renderBooleanFilter;
+    private _clearColumnFilter;
+    private _onResizeAutoFit;
+    private _onResizeStart;
+    render(): TemplateResult<1>;
+    private _onSelectAllChange;
+    private _onRowCheckboxChange;
+    private _renderFooter;
+    private _renderRow;
+    private _renderCell;
+    private _renderEditor;
+    /** Convert value to YYYY-MM-DD for date input (local timezone) */
+    private _toDateInputValue;
+    /** Convert value to YYYY-MM-DDTHH:mm for datetime-local input (local timezone) */
+    private _toDateTimeInputValue;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'flex-table': FlexTable;
+    }
+}

package/dist/flex-table.js

@@ -1,4 +1,4 @@
-import { F as t, R as o, U as r, e as l, r as s } from "./flex-table-C0CCHc1F.js";
+import { F as t, R as o, U as r, e as l, r as s } from "./flex-table-DNBCgorV.js";
 export {
   t as FlexTable,
   o as RowSelectionState,

package/dist/flex-table.test.d.ts

@@ -0,0 +1 @@
+import './flex-table.js';

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { FlexTable } from './flex-table.js';
+export type { ColumnDefinition, ColumnType, DataRow, CellRenderer, CellEditor, CellValidator, SelectionMode, DataMode } from './models/types.js';
+export type { CellPosition, CellRange } from './core/selection.js';
+export type { SortCriteria, SortDirection } from './core/sorting.js';
+export type { ColumnFilter, FilterPredicate, FilterErrorCallback } from './core/filtering.js';
+export { RowSelectionState } from './core/row-selection.js';
+export { UndoStack } from './core/undo.js';
+export type { UndoAction } from './core/undo.js';
+export type { ExportFormat } from './export/export.js';
+export { exportData } from './export/export.js';
+export { renderCell } from './renderers/cell-renderer.js';

package/dist/models/types.d.ts

@@ -0,0 +1,65 @@
+import type { TemplateResult } from 'lit';
+/**
+ * Built-in column data types for rendering and editing.
+ * Any string is accepted as a type — unknown types fall back to 'text' behavior.
+ */
+export type ColumnType = 'text' | 'number' | 'boolean' | 'date' | 'datetime' | (string & {});
+/**
+ * Custom cell renderer function.
+ * Receives the cell value, the full row data, and the column definition.
+ * Returns either a Lit TemplateResult or a plain string.
+ */
+export type CellRenderer = (value: unknown, row: DataRow, col: ColumnDefinition) => TemplateResult | string;
+/**
+ * Custom cell editor function.
+ * Receives the cell value, the full row data, and the column definition.
+ * Should return a Lit TemplateResult containing an input element with class "ft-editor".
+ */
+export type CellEditor = (value: unknown, row: DataRow, col: ColumnDefinition) => TemplateResult;
+/**
+ * Cell validator function. Returns null/undefined if valid, or an error message string.
+ */
+export type CellValidator = (value: unknown, row: DataRow, col: ColumnDefinition) => string | null | undefined;
+/**
+ * Row selection mode.
+ */
+export type SelectionMode = 'single' | 'multi';
+/**
+ * Data processing mode.
+ * - 'client': flex-table performs sorting/filtering locally (default).
+ * - 'server': flex-table only dispatches events; consumer provides pre-sorted/filtered data.
+ */
+export type DataMode = 'client' | 'server';
+/**
+ * Definition of a single column in the table.
+ */
+export interface ColumnDefinition {
+    /** Unique key matching data property names */
+    key: string;
+    /** Display header text */
+    header: string;
+    /** Data type for rendering/editing (default: 'text'). Unknown types fall back to 'text'. */
+    type?: ColumnType;
+    /** Column width in pixels (default: auto) */
+    width?: number;
+    /** Minimum column width in pixels (default: 40) */
+    minWidth?: number;
+    /** Whether the column is hidden */
+    hidden?: boolean;
+    /** Whether the column is sortable (default: true) */
+    sortable?: boolean;
+    /** Custom cell renderer — overrides built-in type rendering */
+    renderer?: CellRenderer;
+    /** Whether the column is editable (default: true — follows global editable setting) */
+    editable?: boolean;
+    /** Custom cell editor — overrides built-in type editing */
+    editor?: CellEditor;
+    /** Pin the column to one side during horizontal scroll */
+    pinned?: 'left' | 'right';
+    /** Cell validator — called before committing edits */
+    validator?: CellValidator;
+}
+/**
+ * A single data row — schema-agnostic key-value map.
+ */
+export type DataRow = Record<string, unknown>;

package/dist/odata/index.d.ts

@@ -0,0 +1,2 @@
+export { useODataSource } from './use-odata-source.js';
+export type { UseODataSourceOptions, UseODataSourceResult } from './types.js';

package/dist/odata/index.js

@@ -1,38 +1,38 @@
-import { useState as r, useRef as J, useCallback as y, useEffect as N } from "react";
+import { useState as r, useRef as z, useCallback as m, useEffect as K } from "react";
 import Q from "odata-query";
-function I(i, f = {}) {
-  const { pageSize: a = 20, defaultOrderBy: o, fixedFilter: d } = f, [x, S] = r([]), [B, b] = r(0), [E, C] = r(!1), [O, g] = r(null), [h, p] = r(0), [l, R] = r(() => o ? U(o) : []), [u, T] = r(""), [q, A] = r(0), k = J(null), D = y(() => {
-    A((e) => e + 1);
-  }, []), L = y((e) => {
-    T(e), p(0);
-  }, []), P = y((e) => {
-    var n;
-    const c = (n = e.detail) == null ? void 0 : n.criteria;
-    c && (R(c), p(0));
+function I(c, d = {}) {
+  const { pageSize: a = 20, defaultOrderBy: n, fixedFilter: l } = d, x = l ? JSON.stringify(l) : "", [O, S] = r([]), [B, b] = r(0), [E, C] = r(!1), [R, g] = r(null), [h, p] = r(0), [u, T] = r(() => n ? U(n) : []), [f, q] = r(""), [A, D] = r(0), k = z(null), F = m(() => {
+    D((e) => e + 1);
+  }, []), J = m((e) => {
+    q(e), p(0);
+  }, []), L = m((e) => {
+    var o;
+    const i = (o = e.detail) == null ? void 0 : o.criteria;
+    i && (T(i), p(0));
   }, []);
-  return N(() => {
+  return K(() => {
     var w;
     (w = k.current) == null || w.abort();
     const e = new AbortController();
     k.current = e, C(!0), g(null);
-    const c = l.length > 0 ? l.map((t) => `${t.key} ${t.direction}`).join(", ") : o, n = {
+    const i = u.length > 0 ? u.map((t) => `${t.key} ${t.direction}`).join(", ") : n, o = {
       top: a,
       skip: h * a,
       count: !0
     };
-    c && (n.orderBy = c), d && (n.filter = d), u && (n.search = u);
-    const v = Q(n), z = `${window.location.origin}${i}${v}`;
-    return fetch(z, { signal: e.signal }).then(async (t) => {
+    i && (o.orderBy = i), l && (o.filter = l), f && (o.search = f);
+    const N = Q(o), P = `${window.location.origin}${c}${N}`;
+    return fetch(P, { signal: e.signal }).then(async (t) => {
       var $;
       if (!t.ok) {
-        const F = await t.text().catch(() => "");
-        let m = `요청 실패 (${t.status})`;
+        const v = await t.text().catch(() => "");
+        let y = `요청 실패 (${t.status})`;
         try {
-          const s = JSON.parse(F);
-          m = (($ = s == null ? void 0 : s.error) == null ? void 0 : $.message) ?? (s == null ? void 0 : s.message) ?? m;
+          const s = JSON.parse(v);
+          y = (($ = s == null ? void 0 : s.error) == null ? void 0 : $.message) ?? (s == null ? void 0 : s.message) ?? y;
         } catch {
         }
-        throw new Error(m);
+        throw new Error(y);
       }
       return t.json();
     }).then((t) => {
@@ -42,27 +42,27 @@ function I(i, f = {}) {
     }).finally(() => {
       e.signal.aborted || C(!1);
     }), () => e.abort();
-  }, [i, h, a, l, u, d, o, q]), {
-    data: x,
+  }, [c, h, a, u, f, x, n, A]), {
+    data: O,
     totalCount: B,
     loading: E,
-    error: O,
+    error: R,
     page: h,
     setPage: p,
-    sortCriteria: l,
-    onSortChange: P,
-    search: u,
-    setSearch: L,
-    refresh: D
+    sortCriteria: u,
+    onSortChange: L,
+    search: f,
+    setSearch: J,
+    refresh: F
   };
 }
-function U(i) {
-  return i.split(",").map((f) => {
-    var o;
-    const a = f.trim().split(/\s+/);
+function U(c) {
+  return c.split(",").map((d) => {
+    var n;
+    const a = d.trim().split(/\s+/);
     return {
       key: a[0],
-      direction: ((o = a[1]) == null ? void 0 : o.toLowerCase()) === "desc" ? "desc" : "asc"
+      direction: ((n = a[1]) == null ? void 0 : n.toLowerCase()) === "desc" ? "desc" : "asc"
     };
   });
 }

package/dist/odata/types.d.ts

@@ -0,0 +1,19 @@
+import type { SortCriteria } from '../core/sorting.js';
+export interface UseODataSourceOptions {
+    pageSize?: number;
+    defaultOrderBy?: string;
+    fixedFilter?: Record<string, unknown>;
+}
+export interface UseODataSourceResult<T> {
+    data: T[];
+    totalCount: number;
+    loading: boolean;
+    error: string | null;
+    page: number;
+    setPage: (page: number) => void;
+    sortCriteria: SortCriteria[];
+    onSortChange: (e: CustomEvent) => void;
+    setSearch: (term: string) => void;
+    search: string;
+    refresh: () => void;
+}

package/dist/odata/use-odata-source.d.ts

@@ -0,0 +1,6 @@
+import type { UseODataSourceOptions, UseODataSourceResult } from './types.js';
+/**
+ * OData v4 서버 사이드 데이터소스 React 훅.
+ * flex-table의 dataMode="server"와 함께 사용한다.
+ */
+export declare function useODataSource<T = Record<string, unknown>>(url: string, options?: UseODataSourceOptions): UseODataSourceResult<T>;

package/dist/react.d.ts

@@ -0,0 +1,29 @@
+import { type EventName } from '@lit/react';
+import { FlexTable } from './flex-table.js';
+export declare const FlexTableReact: import("@lit/react").ReactWebComponent<FlexTable, {
+    onCellSelect: EventName<CustomEvent>;
+    onCellEditCommit: EventName<CustomEvent>;
+    onCellEditCancel: EventName<CustomEvent>;
+    onCellEditStart: EventName<CustomEvent>;
+    onSortChange: EventName<CustomEvent>;
+    onFilterChange: EventName<CustomEvent>;
+    onRowAdd: EventName<CustomEvent>;
+    onRowDelete: EventName<CustomEvent>;
+    onColumnResize: EventName<CustomEvent>;
+    onColumnSelect: EventName<CustomEvent>;
+    onColumnAdd: EventName<CustomEvent>;
+    onColumnDelete: EventName<CustomEvent>;
+    onColumnReorder: EventName<CustomEvent>;
+    onSelectionChange: EventName<CustomEvent>;
+    onClipboardCopy: EventName<CustomEvent>;
+    onClipboardCut: EventName<CustomEvent>;
+    onClipboardPaste: EventName<CustomEvent>;
+    onClipboardError: EventName<CustomEvent>;
+    onUndoStateChange: EventName<CustomEvent>;
+    onValidationError: EventName<CustomEvent>;
+    onBatchUpdate: EventName<CustomEvent>;
+    onContextMenu: EventName<CustomEvent>;
+    onFilterError: EventName<CustomEvent>;
+}>;
+export type { FlexTable };
+export type { ColumnDefinition, DataRow, ColumnType, CellRenderer, CellEditor, CellValidator, SelectionMode, DataMode } from './models/types.js';

package/dist/react.js

@@ -1,6 +1,6 @@
 import e from "react";
 import { createComponent as o } from "@lit/react";
-import { F as l } from "./flex-table-C0CCHc1F.js";
+import { F as l } from "./flex-table-DNBCgorV.js";
 const a = o({
   tagName: "flex-table",
   elementClass: l,

package/dist/renderers/cell-renderer.d.ts

@@ -0,0 +1,5 @@
+import type { ColumnDefinition, DataRow } from '../models/types.js';
+/**
+ * Render a cell value using the column's custom renderer or built-in type rendering.
+ */
+export declare function renderCell(value: unknown, row: DataRow, col: ColumnDefinition): unknown;

package/dist/styles/flex-table.styles.d.ts

@@ -0,0 +1 @@
+export declare const flexTableStyles: import("lit").CSSResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/flex-table",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "A minimalist, input-centric data grid web component",
   "type": "module",
   "main": "./dist/flex-table.js",
@@ -25,7 +25,7 @@
   ],
   "scripts": {
     "dev": "vite serve demo",
-    "build": "tsc && vite build",
+    "build": "vite build && tsc --emitDeclarationOnly",
     "build:demo": "vite build --config vite.config.demo.ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",