photon-grid-core 0.0.1

package/engines/clipboard/clipboard-engine.js

@@ -0,0 +1,323 @@
+// ── Fast clipboard formatter ──────────────────────────────────────────────────
+/**
+ * Converts a cell value to a plain string suitable for tab-separated clipboard
+ * text.  Deliberately avoids `toLocaleString` with options — each call to
+ * `toLocaleString({ … })` creates a temporary `Intl.NumberFormat` internally,
+ * which is ~50–100× slower than `String(n)` for a clipboard dump.
+ *
+ * Numbers/dates land correctly in spreadsheets as plain strings.
+ */
+function fmt(val, desc) {
+    if (val == null)
+        return '';
+    switch (desc.type) {
+        case 'number':
+        case 'currency':
+        case 'percentage':
+            return String(val);
+        case 'boolean':
+            return val ? 'Yes' : 'No';
+        case 'array':
+            return Array.isArray(val) ? val.join(', ') : String(val);
+        case 'dropdown': {
+            const label = desc.dropdownMap?.get(String(val));
+            return label != null ? label : String(val);
+        }
+        default:
+            return String(val);
+    }
+}
+// ── Field resolver ────────────────────────────────────────────────────────────
+function resolve(data, desc) {
+    if (!desc.nested)
+        return data[desc.field];
+    let cur = data;
+    for (const part of desc.parts) {
+        if (cur == null)
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+// ── ClipboardEngine ───────────────────────────────────────────────────────────
+export class ClipboardEngine {
+    constructor() {
+        /** Internal fallback buffer used when clipboard-read permission is denied. */
+        this.clipboardBuffer = [];
+    }
+    /**
+     * Copies the first cell range to the system clipboard as tab-separated text.
+     * Also populates the internal buffer so paste works even when the browser
+     * clipboard-read permission is denied.
+     *
+     * @param ranges          - Active cell ranges (only the first is used for copy)
+     * @param rows            - All visible rows
+     * @param columns         - All visible column definitions
+     * @param withHeaders     - Include a header row in the copied text
+     * @param leafGroupField  - Field name of the deepest grouping column; when
+     *                          provided, leaf data rows include their group-field
+     *                          value in the first (auto-group label) clipboard column
+     */
+    copyRangesToClipboard(ranges, rows, columns, withHeaders = false, leafGroupField) {
+        const { text, buffer } = this.buildRangeData(ranges, rows, columns, withHeaders, leafGroupField);
+        this.clipboardBuffer = buffer;
+        return this.writeToClipboard(text);
+    }
+    /**
+     * Reads text from the system clipboard and returns it as a 2D string array.
+     * Falls back to the internal buffer when clipboard-read is denied.
+     */
+    async pasteFromClipboard() {
+        try {
+            const text = await navigator.clipboard.readText();
+            return this.parseClipboardText(text);
+        }
+        catch {
+            return this.clipboardBuffer;
+        }
+    }
+    /**
+     * Copies selected rows (with headers) to the clipboard.
+     * Used by row-selection mode rather than cell-range mode.
+     *
+     * @param selectedRows - Rows to copy
+     * @param columns      - Column definitions
+     */
+    copyRowsToClipboard(selectedRows, columns) {
+        const descs = this.buildDescriptors(columns, 0, columns.length - 1);
+        const lines = [columns.map((c) => c.header).join('\t')];
+        for (const row of selectedRows) {
+            const cells = new Array(descs.length);
+            for (let i = 0; i < descs.length; i++) {
+                cells[i] = fmt(resolve(row.data, descs[i]), descs[i]);
+            }
+            lines.push(cells.join('\t'));
+        }
+        return this.writeToClipboard(lines.join('\n'));
+    }
+    /**
+     * Copies a single cell value to the clipboard.
+     *
+     * @param value - Cell value
+     * @param col   - Column definition for type-aware formatting
+     */
+    copyCellValue(value, col) {
+        const desc = this.buildDescriptors([col], 0, 0)[0];
+        return this.writeToClipboard(fmt(value, desc));
+    }
+    // ── Core build ──────────────────────────────────────────────────────────────
+    /**
+     * Builds the tab-separated clipboard text and the raw 2D string buffer in a
+     * **single pass** over the row/column range.
+     *
+     * ### Performance strategy
+     * - **Pre-compiled descriptors** — `ColDesc[]` is built once before the loop;
+     *   each descriptor caches the split field path, column type, and a
+     *   `Map<value→label>` for dropdown columns.  No `field.split('.')` or
+     *   option-list `.find()` inside the hot cell loop.
+     * - **Single pass** — text and 2D buffer are produced together, eliminating
+     *   the previous approach of building text then calling `parseClipboardText`
+     *   to re-split it back.
+     * - **Fast formatter** — `String(n)` instead of `n.toLocaleString({…})`;
+     *   the latter creates a temporary `Intl.NumberFormat` on every call.
+     *
+     * @param ranges      - Cell selection ranges
+     * @param rows        - Visible rows
+     * @param columns     - Visible column definitions
+     * @param withHeaders - Include a header row
+     */
+    buildRangeData(ranges, rows, columns, withHeaders, leafGroupField) {
+        if (ranges.length === 0)
+            return { text: '', buffer: [] };
+        // Multi-range (Ctrl+Click): bounding box with per-cell membership check.
+        // Only rows that have at least one selected cell are emitted; cells inside
+        // the bounding box but outside every range get an empty string.
+        if (ranges.length > 1) {
+            return this.buildMultiRangeData(ranges, rows, columns, withHeaders);
+        }
+        const range = ranges[0];
+        const startRow = Math.min(range.startRowIndex, range.endRowIndex);
+        const endRow = Math.max(range.startRowIndex, range.endRowIndex);
+        const startCol = Math.min(range.startColIndex, range.endColIndex);
+        const endCol = Math.max(range.startColIndex, range.endColIndex);
+        // colIndex −1 is the virtual auto-group label column.  When the selection
+        // includes it, the group label text is placed in the first clipboard column
+        // and regular column data is offset by one.
+        const hasGroupLabel = startCol < 0;
+        const dataStartCol = hasGroupLabel ? 0 : startCol;
+        // When selection is the group label cell only (endCol = −1) descs will be
+        // empty; colCount = 1 gives a single-column clipboard row for the label.
+        const descs = endCol >= 0 ? this.buildDescriptors(columns, dataStartCol, endCol) : [];
+        const dataCols = descs.length;
+        const colCount = hasGroupLabel ? dataCols + 1 : dataCols;
+        const lines = [];
+        const buffer = [];
+        if (withHeaders && colCount > 0) {
+            const hdr = new Array(colCount);
+            const hdrOffset = hasGroupLabel ? 1 : 0;
+            if (hasGroupLabel)
+                hdr[0] = 'Group';
+            for (let i = 0; i < dataCols; i++) {
+                hdr[i + hdrOffset] = columns[dataStartCol + i]?.header ?? '';
+            }
+            lines.push(hdr.join('\t'));
+        }
+        for (let r = startRow; r <= endRow; r++) {
+            const row = rows[r];
+            if (!row)
+                continue;
+            // Skip group/footer rows with no agg values when the group-label column
+            // is not selected (data-only range — these rows carry no useful data).
+            const isGroupLike = row.type === 'group' || row.type === 'group-footer';
+            if (isGroupLike && !hasGroupLabel && !row.aggregatedValues)
+                continue;
+            if (!isGroupLike && row.type !== 'data')
+                continue;
+            const cells = new Array(colCount).fill('');
+            const offset = hasGroupLabel ? 1 : 0;
+            // First column: group/footer label text for group-like rows; leaf group
+            // field value for data rows (shown in the auto-group cell they display).
+            if (hasGroupLabel) {
+                if (isGroupLike) {
+                    cells[0] = String(row.groupValue ?? '');
+                }
+                else if (row.type === 'data' && leafGroupField) {
+                    const v = row.data[leafGroupField];
+                    cells[0] = v != null ? String(v) : '';
+                }
+            }
+            if (row.type === 'data') {
+                const data = row.data;
+                for (let i = 0; i < dataCols; i++) {
+                    cells[i + offset] = fmt(resolve(data, descs[i]), descs[i]);
+                }
+            }
+            else if (isGroupLike && row.aggregatedValues) {
+                const aggVals = row.aggregatedValues;
+                for (let i = 0; i < dataCols; i++) {
+                    const col = columns[dataStartCol + i];
+                    if (col && (col.type === 'currency' || col.type === 'number') && col.aggFunc != null) {
+                        const v = aggVals[col.field];
+                        cells[i + offset] = v != null ? String(v) : '';
+                    }
+                    // Non-agg columns already initialised to '' by .fill('') above.
+                }
+            }
+            // Group/footer with no aggValues: cells stay '' except for the label.
+            lines.push(cells.join('\t'));
+            buffer.push(cells);
+        }
+        return { text: lines.join('\n'), buffer };
+    }
+    /**
+     * Builds clipboard data for Ctrl+Click multi-range selections.
+     *
+     * The output spans the bounding box of all ranges; cells that fall inside
+     * the bounding box but belong to no range get an empty string.  Rows that
+     * have no selected cell in any range are skipped entirely so the clipboard
+     * stays compact.
+     *
+     * @param ranges      - Two or more cell ranges (Ctrl+Click selections).
+     * @param rows        - Visible rows.
+     * @param columns     - Visible column definitions.
+     * @param withHeaders - Include a header row.
+     */
+    buildMultiRangeData(ranges, rows, columns, withHeaders) {
+        // Normalise all ranges and compute the bounding box (skip group-label cols < 0).
+        const norms = ranges.map((r) => ({
+            startRowIndex: Math.min(r.startRowIndex, r.endRowIndex),
+            endRowIndex: Math.max(r.startRowIndex, r.endRowIndex),
+            startColIndex: Math.max(0, Math.min(r.startColIndex, r.endColIndex)),
+            endColIndex: Math.max(r.startColIndex, r.endColIndex),
+        }));
+        const startRow = Math.min(...norms.map((n) => n.startRowIndex));
+        const endRow = Math.max(...norms.map((n) => n.endRowIndex));
+        const startCol = Math.max(0, Math.min(...norms.map((n) => n.startColIndex)));
+        const endCol = Math.max(...norms.map((n) => n.endColIndex));
+        if (endCol < 0)
+            return { text: '', buffer: [] };
+        const descs = this.buildDescriptors(columns, startCol, endCol);
+        const colCount = descs.length;
+        const lines = [];
+        const buffer = [];
+        if (withHeaders && colCount > 0) {
+            lines.push(descs.map((_, i) => columns[startCol + i]?.header ?? '').join('\t'));
+        }
+        for (let r = startRow; r <= endRow; r++) {
+            const row = rows[r];
+            if (!row || row.type !== 'data')
+                continue;
+            // Skip rows where no range has a selected cell.
+            const rowSelected = norms.some((n) => r >= n.startRowIndex && r <= n.endRowIndex);
+            if (!rowSelected)
+                continue;
+            const cells = new Array(colCount).fill('');
+            for (let ci = 0; ci < colCount; ci++) {
+                const c = startCol + ci;
+                const inRange = norms.some((n) => r >= n.startRowIndex && r <= n.endRowIndex &&
+                    c >= n.startColIndex && c <= n.endColIndex);
+                if (inRange)
+                    cells[ci] = fmt(resolve(row.data, descs[ci]), descs[ci]);
+            }
+            lines.push(cells.join('\t'));
+            buffer.push(cells);
+        }
+        return { text: lines.join('\n'), buffer };
+    }
+    // ── Descriptor builder ─────────────────────────────────────────────────────
+    /**
+     * Compiles `ColDesc` objects for columns `[startCol, endCol]` inclusive.
+     * Called once per copy operation — never inside the row loop.
+     */
+    buildDescriptors(columns, startCol, endCol) {
+        const descs = [];
+        for (let c = startCol; c <= endCol; c++) {
+            const col = columns[c];
+            if (!col)
+                continue;
+            let dropdownMap = null;
+            if (col.type === 'dropdown' && col.dropdownOptions?.length) {
+                dropdownMap = new Map(col.dropdownOptions.map((o) => [String(o.value), o.label]));
+            }
+            descs.push({
+                field: col.field,
+                parts: col.field.split('.'),
+                nested: col.field.includes('.'),
+                type: col.type ?? 'string',
+                dropdownMap,
+            });
+        }
+        return descs;
+    }
+    // ── Paste helper ───────────────────────────────────────────────────────────
+    /**
+     * Splits tab-separated clipboard text into a 2D string array.
+     * Used only on paste (not on copy — the buffer is built directly).
+     */
+    parseClipboardText(text) {
+        return text
+            .split('\n')
+            .map((line) => line.split('\t').map((cell) => cell.trim()));
+    }
+    // ── Write ───────────────────────────────────────────────────────────────────
+    writeToClipboard(text) {
+        if (navigator.clipboard?.writeText) {
+            return navigator.clipboard.writeText(text).catch(() => this.execCommandCopy(text));
+        }
+        return Promise.resolve(this.execCommandCopy(text));
+    }
+    execCommandCopy(text) {
+        const ta = document.createElement('textarea');
+        ta.value = text;
+        ta.style.cssText = 'position:fixed;opacity:0;top:0;left:0;';
+        document.body.appendChild(ta);
+        ta.focus();
+        ta.select();
+        try {
+            document.execCommand('copy');
+        }
+        catch { /* ignore */ }
+        document.body.removeChild(ta);
+    }
+}
+//# sourceMappingURL=clipboard-engine.js.map

package/engines/clipboard/clipboard-engine.js.map

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

package/engines/editing/cell-editor-engine.d.ts

@@ -0,0 +1,62 @@
+import type { RowNode } from '../../types/row.types';
+import type { ColumnDef } from '../../types/column.types';
+import type { EditingConfig } from '../../types/grid.types';
+import type { GridStore } from '../../core/grid-store';
+import type { EventBus } from '../../event-bus/event-bus';
+export interface EditSession {
+    rowNode: RowNode;
+    colDef: ColumnDef;
+    originalValue: unknown;
+    currentValue: unknown;
+    editorEl: HTMLElement | null;
+    cellEl: HTMLElement | null;
+}
+export declare class CellEditorEngine {
+    private store;
+    private eventBus;
+    private activeSession;
+    private config;
+    /**
+     * Optional callback invoked when Tab is pressed while a native editor is
+     * active.  Receives `shiftKey` so the caller can navigate forwards or
+     * backwards.  Registered by `wireEditing` in `GridCore`.
+     */
+    private tabHandler;
+    /** Register a callback to be called when Tab is pressed inside a native editor. */
+    setTabHandler(fn: (shiftKey: boolean) => void): void;
+    constructor(store: GridStore, eventBus: EventBus);
+    configure(config: Partial<EditingConfig>): void;
+    startEditing(rowNode: RowNode, colDef: ColumnDef, cellEl: HTMLElement): boolean;
+    updateValue(value: unknown): void;
+    stopEditing(cancel?: boolean): void;
+    isEditing(): boolean;
+    getActiveSession(): EditSession | null;
+    isCellEditing(rowNodeId: string, colId: string): boolean;
+    /**
+     * Builds and mounts the appropriate native editor widget into `container` based
+     * on `colDef.type`.  Returns the root editor element.
+     *
+     * Editor types:
+     * - `boolean`            → styled checkbox
+     * - `dropdown` / `object`→ single-select `<select>` from `dropdownOptions`
+     * - `array`              → custom multi-select panel with checkboxes
+     * - `number` / `currency`/ `percentage` → number `<input>`
+     * - `date`               → date `<input>`
+     * - `time`               → time `<input>`
+     * - default              → text `<input>`
+     */
+    buildNativeEditor(colDef: ColumnDef, value: unknown, container: HTMLElement): HTMLElement;
+    /**
+     * Builds a custom multi-select dropdown panel for `array` column type.
+     * The stored value is always `string[]` of selected option values.
+     */
+    private buildMultiSelectEditor;
+    /**
+     * Resolves the key used to match a cell value against `dropdownOptions`
+     * for `object` type columns.  Supports primitive values and plain objects.
+     */
+    private resolveObjectKey;
+    /** Returns the active `EditingConfig` (read-only). */
+    getConfig(): Readonly<EditingConfig>;
+}
+//# sourceMappingURL=cell-editor-engine.d.ts.map

package/engines/editing/cell-editor-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-editor-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/editing/cell-editor-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAI1D,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B;AAED,qBAAa,gBAAgB;IAoBzB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IApBlB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,MAAM,CAIZ;IACF;;;;OAIG;IACH,OAAO,CAAC,UAAU,CAA8C;IAEhE,mFAAmF;IACnF,aAAa,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;gBAK1C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ;IAG5B,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAI/C,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO;IAoC/E,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAKjC,WAAW,CAAC,MAAM,UAAQ,GAAG,IAAI;IAwDjC,SAAS,IAAI,OAAO;IAIpB,gBAAgB,IAAI,WAAW,GAAG,IAAI;IAItC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAKxD;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,WAAW;IA6GzF;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAqG9B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAQxB,sDAAsD;IACtD,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;CAGrC"}