photon-grid-core 0.0.1

package/drag-drop/drag-drop-engine.js

@@ -0,0 +1,179 @@
+import { GridEventType } from '../types/event.types';
+import { DragPreview } from './drag-preview';
+import { DragAutoscroll } from './drag-autoscroll';
+const DRAG_THRESHOLD = 4;
+const DRAG_DELAY = 0;
+export class DragDropEngine {
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+        this.dropTargets = new Map();
+        this.currentSession = null;
+        this.preview = new DragPreview();
+        this.autoscroll = new DragAutoscroll();
+        this.previewOptions = {};
+        this.boundMouseMove = this.onMouseMove.bind(this);
+        this.boundMouseUp = this.onMouseUp.bind(this);
+    }
+    registerDropTarget(target) {
+        this.dropTargets.set(target.id, target);
+        return () => this.dropTargets.delete(target.id);
+    }
+    makeDraggable(el, item, scrollContainer, previewOpts) {
+        if (previewOpts)
+            this.previewOptions = previewOpts;
+        const onMouseDown = (e) => {
+            if (e.button !== 0)
+                return;
+            e.preventDefault();
+            this.currentSession = {
+                item,
+                sourceEl: el,
+                currentTarget: null,
+                position: null,
+                startX: e.clientX,
+                startY: e.clientY,
+                currentX: e.clientX,
+                currentY: e.clientY,
+                isDragging: false,
+                startTime: Date.now(),
+            };
+            if (scrollContainer)
+                this.autoscroll.attach(scrollContainer);
+            document.addEventListener('mousemove', this.boundMouseMove);
+            document.addEventListener('mouseup', this.boundMouseUp);
+        };
+        el.addEventListener('mousedown', onMouseDown);
+        el.style.cursor = 'grab';
+        el.setAttribute('data-draggable', item.type);
+        return () => {
+            el.removeEventListener('mousedown', onMouseDown);
+            el.style.cursor = '';
+            el.removeAttribute('data-draggable');
+        };
+    }
+    setScrollContainer(el) {
+        this.autoscroll.attach(el);
+    }
+    cancelDrag() {
+        if (this.currentSession) {
+            this.cleanupDrag(true);
+        }
+    }
+    destroy() {
+        this.cancelDrag();
+        this.autoscroll.detach();
+        document.removeEventListener('mousemove', this.boundMouseMove);
+        document.removeEventListener('mouseup', this.boundMouseUp);
+    }
+    onMouseMove(e) {
+        if (!this.currentSession)
+            return;
+        const session = this.currentSession;
+        session.currentX = e.clientX;
+        session.currentY = e.clientY;
+        if (!session.isDragging) {
+            const dx = Math.abs(e.clientX - session.startX);
+            const dy = Math.abs(e.clientY - session.startY);
+            if (dx < DRAG_THRESHOLD && dy < DRAG_THRESHOLD)
+                return;
+            session.isDragging = true;
+            session.sourceEl.classList.add('pg-dragging');
+            this.preview.create(this.previewOptions);
+            this.autoscroll.start();
+            this.eventBus.emit(GridEventType.DRAG_STARTED, { item: session.item });
+        }
+        this.preview.moveTo(e.clientX, e.clientY);
+        this.autoscroll.onMouseMove(e.clientX, e.clientY);
+        const hitTarget = this.findDropTarget(e.clientX, e.clientY, session.item);
+        if (hitTarget !== session.currentTarget) {
+            if (session.currentTarget) {
+                session.currentTarget.el.classList.remove('pg-drop-over');
+                session.currentTarget.onDragLeave?.(session.item);
+            }
+            session.currentTarget = hitTarget;
+            if (hitTarget) {
+                hitTarget.el.classList.add('pg-drop-over');
+                hitTarget.onDragEnter?.(session.item);
+            }
+        }
+        if (hitTarget) {
+            session.position = this.calcDropPosition(e.clientY, hitTarget.el);
+            this.updateDropIndicator(hitTarget.el, session.position);
+        }
+        this.eventBus.emit(GridEventType.DRAG_OVER, {
+            item: session.item,
+            targetId: hitTarget?.id ?? null,
+            position: session.position,
+        });
+    }
+    onMouseUp(e) {
+        if (!this.currentSession)
+            return;
+        const session = this.currentSession;
+        if (session.isDragging && session.currentTarget && session.position) {
+            session.currentTarget.onDrop?.(session.item, session.position);
+            this.eventBus.emit(GridEventType.DRAG_STOPPED, {
+                item: session.item,
+                targetId: session.currentTarget.id,
+                position: session.position,
+                accepted: true,
+            });
+        }
+        else {
+            this.eventBus.emit(GridEventType.DRAG_STOPPED, {
+                item: session.item,
+                targetId: null,
+                position: null,
+                accepted: false,
+            });
+        }
+        this.cleanupDrag(false);
+    }
+    cleanupDrag(cancelled) {
+        if (!this.currentSession)
+            return;
+        const session = this.currentSession;
+        session.sourceEl.classList.remove('pg-dragging');
+        if (session.currentTarget) {
+            session.currentTarget.el.classList.remove('pg-drop-over');
+            this.clearDropIndicator(session.currentTarget.el);
+        }
+        this.preview.destroy();
+        this.autoscroll.stop();
+        document.removeEventListener('mousemove', this.boundMouseMove);
+        document.removeEventListener('mouseup', this.boundMouseUp);
+        this.currentSession = null;
+    }
+    findDropTarget(x, y, dragItem) {
+        let best = null;
+        for (const target of this.dropTargets.values()) {
+            if (!target.acceptsTypes.includes(dragItem.type))
+                continue;
+            if (target.id === dragItem.id)
+                continue;
+            const rect = target.el.getBoundingClientRect();
+            if (x >= rect.left && x <= rect.right && y >= rect.top && y <= rect.bottom) {
+                best = target;
+            }
+        }
+        return best;
+    }
+    calcDropPosition(mouseY, el) {
+        const rect = el.getBoundingClientRect();
+        const relY = mouseY - rect.top;
+        const ratio = relY / rect.height;
+        if (ratio < 0.25)
+            return 'before';
+        if (ratio > 0.75)
+            return 'after';
+        return 'inside';
+    }
+    updateDropIndicator(el, position) {
+        el.classList.remove('pg-drop-before', 'pg-drop-after', 'pg-drop-inside');
+        el.classList.add(`pg-drop-${position}`);
+    }
+    clearDropIndicator(el) {
+        el.classList.remove('pg-drop-before', 'pg-drop-after', 'pg-drop-inside');
+    }
+}
+//# sourceMappingURL=drag-drop-engine.js.map

package/drag-drop/drag-drop-engine.js.map

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

package/drag-drop/drag-preview.d.ts

@@ -0,0 +1,32 @@
+export interface DragPreviewOptions {
+    label?: string;
+    icon?: string;
+    count?: number;
+    avatarUrl?: string;
+    shape?: 'circle' | 'square';
+}
+export declare class DragPreview {
+    private el;
+    private offsetX;
+    private offsetY;
+    /**
+     * Create a theme-styled floating drag preview.
+     *
+     * Visual styling belongs to `.pg-drag-preview` CSS rules; this method only
+     * builds semantic children and data-driven classes.
+     *
+     * @param options - Label, icon, count badge, and optional avatar metadata.
+     */
+    create(options?: DragPreviewOptions): HTMLElement;
+    moveTo(x: number, y: number): void;
+    /**
+     * Set the cursor-relative offset used by {@link moveTo}.
+     *
+     * @param x - Horizontal offset in CSS pixels.
+     * @param y - Vertical offset in CSS pixels.
+     */
+    setOffset(x: number, y: number): void;
+    /** Remove the current preview element from the DOM. */
+    destroy(): void;
+}
+//# sourceMappingURL=drag-preview.d.ts.map

package/drag-drop/drag-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag-preview.d.ts","sourceRoot":"","sources":["../../src/drag-drop/drag-preview.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAAM;IAErB;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW;IA2CrD,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKlC;;;;;OAKG;IACH,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrC,uDAAuD;IACvD,OAAO,IAAI,IAAI;CAMhB"}

package/drag-drop/drag-preview.js

@@ -0,0 +1,74 @@
+export class DragPreview {
+    constructor() {
+        this.el = null;
+        this.offsetX = 12;
+        this.offsetY = 12;
+    }
+    /**
+     * Create a theme-styled floating drag preview.
+     *
+     * Visual styling belongs to `.pg-drag-preview` CSS rules; this method only
+     * builds semantic children and data-driven classes.
+     *
+     * @param options - Label, icon, count badge, and optional avatar metadata.
+     */
+    create(options = {}) {
+        this.destroy();
+        const preview = document.createElement('div');
+        preview.className = 'pg-drag-preview';
+        if (options.avatarUrl || options.shape) {
+            const avatar = document.createElement('div');
+            const shape = options.shape ?? 'circle';
+            avatar.className = `pg-drag-preview__avatar pg-drag-preview__avatar--${shape}`;
+            if (options.avatarUrl) {
+                const img = document.createElement('img');
+                img.className = 'pg-drag-preview__avatar-img';
+                img.src = options.avatarUrl;
+                avatar.appendChild(img);
+            }
+            preview.appendChild(avatar);
+        }
+        if (options.icon) {
+            const iconSpan = document.createElement('span');
+            iconSpan.className = 'pg-drag-preview__icon';
+            iconSpan.innerHTML = options.icon;
+            preview.appendChild(iconSpan);
+        }
+        const labelSpan = document.createElement('span');
+        labelSpan.className = 'pg-drag-preview__label';
+        labelSpan.textContent = options.label ?? 'Dragging';
+        preview.appendChild(labelSpan);
+        if (options.count && options.count > 1) {
+            const badge = document.createElement('span');
+            badge.className = 'pg-drag-preview__badge';
+            badge.textContent = String(options.count);
+            preview.appendChild(badge);
+        }
+        document.body.appendChild(preview);
+        this.el = preview;
+        return preview;
+    }
+    moveTo(x, y) {
+        if (!this.el)
+            return;
+        this.el.style.transform = `translate(${x + this.offsetX}px, ${y + this.offsetY}px)`;
+    }
+    /**
+     * Set the cursor-relative offset used by {@link moveTo}.
+     *
+     * @param x - Horizontal offset in CSS pixels.
+     * @param y - Vertical offset in CSS pixels.
+     */
+    setOffset(x, y) {
+        this.offsetX = x;
+        this.offsetY = y;
+    }
+    /** Remove the current preview element from the DOM. */
+    destroy() {
+        if (this.el) {
+            this.el.remove();
+            this.el = null;
+        }
+    }
+}
+//# sourceMappingURL=drag-preview.js.map

package/drag-drop/drag-preview.js.map

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

package/engines/aggregation/aggregation-engine.d.ts

@@ -0,0 +1,66 @@
+import type { ColumnDef } from '../../types/column.types';
+import type { GroupTree } from '../grouping/group-node';
+/**
+ * Stateless service that computes group-level aggregations in a bottom-up pass
+ * over a {@link GroupTree} produced by {@link GroupingEngine}.
+ *
+ * ### Eligibility
+ * Only columns whose {@link ColumnDef.type} is `'currency'` or `'number'` **and** that have
+ * {@link ColumnDef.aggFunc} set are processed.  All other columns are skipped,
+ * keeping the total work proportional to `(leaf rows) × (agg-eligible columns)`.
+ *
+ * ### Supported functions
+ * | `aggFunc` | Description |
+ * |-----------|-------------|
+ * | `sum`     | Sum of all leaf values |
+ * | `avg`     | True weighted average across all leaf rows |
+ * | `min`     | Minimum leaf value |
+ * | `max`     | Maximum leaf value |
+ * | `count`   | Count of leaf rows with a finite value |
+ *
+ * ### Usage
+ * ```ts
+ * const engine = new AggregationEngine();
+ * // Called once per pipeline run, before flattenGroupTree:
+ * engine.compute(groupTree, allColumns);
+ * // Every GroupTree node now has aggregatedValues populated.
+ * ```
+ */
+export declare class AggregationEngine {
+    /**
+     * Walk the entire group tree bottom-up and write `aggregatedValues` onto
+     * every node.
+     *
+     * - **Leaf groups** aggregate directly from their raw {@link RowNode} data.
+     * - **Interior groups** combine the pre-computed child accumulators, so
+     *   averages are correctly weighted and leaf rows are never double-counted.
+     *
+     * @param tree    - Top-level nodes from `GroupingEngine.buildGroupTree`.
+     * @param columns - Full column set; filtered internally to agg-eligible cols.
+     */
+    compute(tree: GroupTree[], columns: ColumnDef[]): void;
+    /**
+     * Recursively process `group` and return its raw {@link AggAccumulator}s so
+     * the parent can combine them without re-scanning leaf rows.
+     */
+    private walkGroup;
+    /**
+     * Scan a flat array of leaf {@link RowNode}s and build one
+     * {@link AggAccumulator} per agg-eligible column.
+     *
+     * Non-numeric values and `NaN`/`Infinity` are silently skipped; they do
+     * not increment `count`, ensuring averages remain correct.
+     */
+    private buildAccumulatorsFromRows;
+    /**
+     * Combine child {@link AggAccumulator}s into a single accumulator for the
+     * parent group.  Children with zero count are skipped.
+     */
+    private mergeAccumulators;
+    /**
+     * Convert raw {@link AggAccumulator}s into the final display values keyed by
+     * `colDef.field`.  Groups with `count === 0` get `null` for that field.
+     */
+    private deriveDisplayValues;
+}
+//# sourceMappingURL=aggregation-engine.d.ts.map

package/engines/aggregation/aggregation-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/aggregation/aggregation-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAyBxD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI;IActD;;;OAGG;IACH,OAAO,CAAC,SAAS;IAiBjB;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAqBjC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA+B5B"}

package/engines/aggregation/aggregation-engine.js

@@ -0,0 +1,149 @@
+import { resolveField } from '../grouping/group-node';
+// ─── AggregationEngine ───────────────────────────────────────────────────────
+/**
+ * Stateless service that computes group-level aggregations in a bottom-up pass
+ * over a {@link GroupTree} produced by {@link GroupingEngine}.
+ *
+ * ### Eligibility
+ * Only columns whose {@link ColumnDef.type} is `'currency'` or `'number'` **and** that have
+ * {@link ColumnDef.aggFunc} set are processed.  All other columns are skipped,
+ * keeping the total work proportional to `(leaf rows) × (agg-eligible columns)`.
+ *
+ * ### Supported functions
+ * | `aggFunc` | Description |
+ * |-----------|-------------|
+ * | `sum`     | Sum of all leaf values |
+ * | `avg`     | True weighted average across all leaf rows |
+ * | `min`     | Minimum leaf value |
+ * | `max`     | Maximum leaf value |
+ * | `count`   | Count of leaf rows with a finite value |
+ *
+ * ### Usage
+ * ```ts
+ * const engine = new AggregationEngine();
+ * // Called once per pipeline run, before flattenGroupTree:
+ * engine.compute(groupTree, allColumns);
+ * // Every GroupTree node now has aggregatedValues populated.
+ * ```
+ */
+export class AggregationEngine {
+    /**
+     * Walk the entire group tree bottom-up and write `aggregatedValues` onto
+     * every node.
+     *
+     * - **Leaf groups** aggregate directly from their raw {@link RowNode} data.
+     * - **Interior groups** combine the pre-computed child accumulators, so
+     *   averages are correctly weighted and leaf rows are never double-counted.
+     *
+     * @param tree    - Top-level nodes from `GroupingEngine.buildGroupTree`.
+     * @param columns - Full column set; filtered internally to agg-eligible cols.
+     */
+    compute(tree, columns) {
+        const aggCols = columns.filter((c) => (c.type === 'currency' || c.type === 'number') && c.aggFunc != null);
+        if (aggCols.length === 0)
+            return;
+        for (const group of tree) {
+            this.walkGroup(group, aggCols);
+        }
+    }
+    // ─── Private ──────────────────────────────────────────────────────────────
+    /**
+     * Recursively process `group` and return its raw {@link AggAccumulator}s so
+     * the parent can combine them without re-scanning leaf rows.
+     */
+    walkGroup(group, aggCols) {
+        let accs;
+        if (group.children.length > 0) {
+            const childAccs = group.children.map((child) => this.walkGroup(child, aggCols));
+            accs = this.mergeAccumulators(childAccs, aggCols);
+        }
+        else {
+            accs = this.buildAccumulatorsFromRows(group.rows, aggCols);
+        }
+        group.aggregatedValues = this.deriveDisplayValues(accs, aggCols);
+        return accs;
+    }
+    /**
+     * Scan a flat array of leaf {@link RowNode}s and build one
+     * {@link AggAccumulator} per agg-eligible column.
+     *
+     * Non-numeric values and `NaN`/`Infinity` are silently skipped; they do
+     * not increment `count`, ensuring averages remain correct.
+     */
+    buildAccumulatorsFromRows(rows, aggCols) {
+        const result = {};
+        for (const col of aggCols) {
+            const acc = { sum: 0, count: 0, min: Infinity, max: -Infinity };
+            for (const row of rows) {
+                const raw = resolveField(row.data, col.field);
+                const n = typeof raw === 'number' ? raw : parseFloat(String(raw ?? ''));
+                if (!isFinite(n))
+                    continue;
+                acc.sum += n;
+                acc.count++;
+                if (n < acc.min)
+                    acc.min = n;
+                if (n > acc.max)
+                    acc.max = n;
+            }
+            result[col.field] = acc;
+        }
+        return result;
+    }
+    /**
+     * Combine child {@link AggAccumulator}s into a single accumulator for the
+     * parent group.  Children with zero count are skipped.
+     */
+    mergeAccumulators(childAccs, aggCols) {
+        const result = {};
+        for (const col of aggCols) {
+            const acc = { sum: 0, count: 0, min: Infinity, max: -Infinity };
+            for (const child of childAccs) {
+                const c = child[col.field];
+                if (!c || c.count === 0)
+                    continue;
+                acc.sum += c.sum;
+                acc.count += c.count;
+                if (c.min < acc.min)
+                    acc.min = c.min;
+                if (c.max > acc.max)
+                    acc.max = c.max;
+            }
+            result[col.field] = acc;
+        }
+        return result;
+    }
+    /**
+     * Convert raw {@link AggAccumulator}s into the final display values keyed by
+     * `colDef.field`.  Groups with `count === 0` get `null` for that field.
+     */
+    deriveDisplayValues(accs, aggCols) {
+        const result = {};
+        for (const col of aggCols) {
+            const acc = accs[col.field];
+            if (!acc || acc.count === 0) {
+                result[col.field] = null;
+                continue;
+            }
+            switch (col.aggFunc) {
+                case 'sum':
+                    result[col.field] = acc.sum;
+                    break;
+                case 'avg':
+                    result[col.field] = acc.sum / acc.count;
+                    break;
+                case 'min':
+                    result[col.field] = isFinite(acc.min) ? acc.min : null;
+                    break;
+                case 'max':
+                    result[col.field] = isFinite(acc.max) ? acc.max : null;
+                    break;
+                case 'count':
+                    result[col.field] = acc.count;
+                    break;
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=aggregation-engine.js.map

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

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

package/engines/clipboard/clipboard-engine.d.ts

@@ -0,0 +1,89 @@
+import type { CellRange } from '../../types/grid.types';
+import type { RowNode } from '../../types/row.types';
+import type { ColumnDef } from '../../types/column.types';
+export declare class ClipboardEngine {
+    /** Internal fallback buffer used when clipboard-read permission is denied. */
+    private 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: CellRange[], rows: RowNode[], columns: ColumnDef[], withHeaders?: boolean, leafGroupField?: string): Promise<void>;
+    /**
+     * 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.
+     */
+    pasteFromClipboard(): Promise<string[][]>;
+    /**
+     * 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: RowNode[], columns: ColumnDef[]): Promise<void>;
+    /**
+     * Copies a single cell value to the clipboard.
+     *
+     * @param value - Cell value
+     * @param col   - Column definition for type-aware formatting
+     */
+    copyCellValue(value: unknown, col: ColumnDef): Promise<void>;
+    /**
+     * 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
+     */
+    private buildRangeData;
+    /**
+     * 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.
+     */
+    private buildMultiRangeData;
+    /**
+     * Compiles `ColDesc` objects for columns `[startCol, endCol]` inclusive.
+     * Called once per copy operation — never inside the row loop.
+     */
+    private buildDescriptors;
+    /**
+     * Splits tab-separated clipboard text into a 2D string array.
+     * Used only on paste (not on copy — the buffer is built directly).
+     */
+    private parseClipboardText;
+    private writeToClipboard;
+    private execCommandCopy;
+}
+//# sourceMappingURL=clipboard-engine.d.ts.map

package/engines/clipboard/clipboard-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-engine.d.ts","sourceRoot":"","sources":["../../../src/engines/clipboard/clipboard-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAqE1D,qBAAa,eAAe;IAC1B,8EAA8E;IAC9E,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;;;;;;;;;;OAYG;IACH,qBAAqB,CACnB,MAAM,EAAE,SAAS,EAAE,EACnB,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,EAAE,SAAS,EAAE,EACpB,WAAW,UAAQ,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAS/C;;;;;;OAMG;IACH,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAajF;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,cAAc;IA+FtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,mBAAmB;IAyD3B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;CAUxB"}