photon-grid-core 0.0.1

package/renderer/auto-scroller.d.ts

@@ -0,0 +1,78 @@
+/**
+ * RAF-based edge auto-scroller for drag interactions.
+ *
+ * When the cursor is within `threshold` pixels of the viewport edges, a scroll
+ * delta proportional to proximity is applied every animation frame via the
+ * `scrollY` / `scrollX` delta callbacks.  After each scrolled frame the
+ * optional `onScrolled` callback is invoked with the current cursor coordinates
+ * so the caller can re-evaluate which cell lies under the cursor.
+ *
+ * ### Usage
+ * 1. Call `updateMouse(x, y)` on every drag `mousemove` event.
+ * 2. Call `stop()` on `mouseup` or when the drag interaction ends.
+ * 3. Wire `onScrolled` to re-extend the selection or re-process the fill
+ *    position after the grid has scrolled.
+ *
+ * ### Performance
+ * The RAF loop only executes when at least one edge is within threshold range.
+ * No timers or intervals are created; a single `requestAnimationFrame` chain
+ * drives the loop and `cancelAnimationFrame` terminates it instantly.
+ */
+export declare class AutoScroller {
+    private readonly getRect;
+    private readonly scrollY;
+    private readonly scrollX;
+    private readonly onScrolled?;
+    private readonly threshold;
+    private readonly maxSpeed;
+    private rafId;
+    private lastTs;
+    private clientX;
+    private clientY;
+    private running;
+    /**
+     * @param getRect    - Returns the bounding rect of the scrollable viewport
+     *                     element, or `null` when the grid is unmounted.
+     * @param scrollY    - Called with a **signed pixel delta** to scroll
+     *                     vertically.  Positive = down, negative = up.
+     * @param scrollX    - Called with a **signed pixel delta** to scroll
+     *                     horizontally.  Positive = right, negative = left.
+     * @param onScrolled - Optional callback invoked after any frame that
+     *                     actually scrolled.  Receives the most-recent client
+     *                     coordinates so the caller can re-evaluate the drag
+     *                     target under the (now-scrolled) grid.
+     * @param threshold  - Distance from the viewport edge (px) at which
+     *                     scrolling starts.  Defaults to `60`.
+     * @param maxSpeed   - Maximum scroll speed in px/s reached at the edge
+     *                     (dist = 0).  Defaults to `500`.
+     */
+    constructor(getRect: () => DOMRect | null, scrollY: (delta: number) => void, scrollX: (delta: number) => void, onScrolled?: ((clientX: number, clientY: number) => void) | undefined, threshold?: number, maxSpeed?: number);
+    /**
+     * Updates the tracked cursor position and starts the RAF loop if it is not
+     * already running.  Safe to call on every `mousemove` — has no overhead
+     * when the cursor is away from the edges.
+     *
+     * @param x - `MouseEvent.clientX`
+     * @param y - `MouseEvent.clientY`
+     */
+    updateMouse(x: number, y: number): void;
+    /**
+     * Stops the RAF loop immediately.  Call on `mouseup` or when the drag
+     * interaction ends to prevent ghost scrolling after the pointer is released.
+     */
+    stop(): void;
+    /**
+     * RAF tick — computes scroll deltas from edge proximity and fires callbacks.
+     * Bound as an arrow field so it can be passed directly to `requestAnimationFrame`
+     * without a wrapper.
+     */
+    private readonly tick;
+    /**
+     * Computes scroll speed (px/s) as a linear ramp:
+     * `maxSpeed` at the edge (dist = 0), `0` at `threshold` distance.
+     *
+     * @param distFromEdge - Distance from the viewport edge in pixels.
+     */
+    private speedAt;
+}
+//# sourceMappingURL=auto-scroller.d.ts.map

package/renderer/auto-scroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-scroller.d.ts","sourceRoot":"","sources":["../../src/renderer/auto-scroller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IAwBrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IA5B3B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;;;;;;;;;;OAeG;gBAEgB,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,EAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAChC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAChC,UAAU,CAAC,GAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,aAAA,EACvD,SAAS,SAAK,EACd,QAAQ,SAAM;IAGjC;;;;;;;OAOG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAUvC;;;OAGG;IACH,IAAI,IAAI,IAAI;IAQZ;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAkDnB;IAEF;;;;;OAKG;IACH,OAAO,CAAC,OAAO;CAGhB"}

package/renderer/auto-scroller.js

@@ -0,0 +1,141 @@
+/**
+ * RAF-based edge auto-scroller for drag interactions.
+ *
+ * When the cursor is within `threshold` pixels of the viewport edges, a scroll
+ * delta proportional to proximity is applied every animation frame via the
+ * `scrollY` / `scrollX` delta callbacks.  After each scrolled frame the
+ * optional `onScrolled` callback is invoked with the current cursor coordinates
+ * so the caller can re-evaluate which cell lies under the cursor.
+ *
+ * ### Usage
+ * 1. Call `updateMouse(x, y)` on every drag `mousemove` event.
+ * 2. Call `stop()` on `mouseup` or when the drag interaction ends.
+ * 3. Wire `onScrolled` to re-extend the selection or re-process the fill
+ *    position after the grid has scrolled.
+ *
+ * ### Performance
+ * The RAF loop only executes when at least one edge is within threshold range.
+ * No timers or intervals are created; a single `requestAnimationFrame` chain
+ * drives the loop and `cancelAnimationFrame` terminates it instantly.
+ */
+export class AutoScroller {
+    /**
+     * @param getRect    - Returns the bounding rect of the scrollable viewport
+     *                     element, or `null` when the grid is unmounted.
+     * @param scrollY    - Called with a **signed pixel delta** to scroll
+     *                     vertically.  Positive = down, negative = up.
+     * @param scrollX    - Called with a **signed pixel delta** to scroll
+     *                     horizontally.  Positive = right, negative = left.
+     * @param onScrolled - Optional callback invoked after any frame that
+     *                     actually scrolled.  Receives the most-recent client
+     *                     coordinates so the caller can re-evaluate the drag
+     *                     target under the (now-scrolled) grid.
+     * @param threshold  - Distance from the viewport edge (px) at which
+     *                     scrolling starts.  Defaults to `60`.
+     * @param maxSpeed   - Maximum scroll speed in px/s reached at the edge
+     *                     (dist = 0).  Defaults to `500`.
+     */
+    constructor(getRect, scrollY, scrollX, onScrolled, threshold = 60, maxSpeed = 500) {
+        this.getRect = getRect;
+        this.scrollY = scrollY;
+        this.scrollX = scrollX;
+        this.onScrolled = onScrolled;
+        this.threshold = threshold;
+        this.maxSpeed = maxSpeed;
+        this.rafId = null;
+        this.lastTs = 0;
+        this.clientX = 0;
+        this.clientY = 0;
+        this.running = false;
+        /**
+         * RAF tick — computes scroll deltas from edge proximity and fires callbacks.
+         * Bound as an arrow field so it can be passed directly to `requestAnimationFrame`
+         * without a wrapper.
+         */
+        this.tick = (ts) => {
+            if (!this.running)
+                return;
+            const rect = this.getRect();
+            if (!rect) {
+                this.stop();
+                return;
+            }
+            // `dt` = elapsed seconds since last frame; clamped to avoid large jumps
+            // after a tab switch or visibility change.
+            const dt = this.lastTs === 0 ? 0 : Math.min((ts - this.lastTs) / 1000, 0.1);
+            this.lastTs = ts;
+            let scrolled = false;
+            if (dt > 0) {
+                const { clientX: x, clientY: y } = this;
+                // ── Vertical ────────────────────────────────────────────────────────────
+                // `dist` can be negative when the cursor has moved past the viewport
+                // boundary (common during fill-handle drag).  Clamp to 0 so being
+                // outside the edge triggers max-speed scrolling rather than no scroll.
+                const distTop = y - rect.top;
+                const distBottom = rect.bottom - y;
+                if (distTop < this.threshold) {
+                    this.scrollY(-this.speedAt(Math.max(0, distTop)) * dt);
+                    scrolled = true;
+                }
+                else if (distBottom < this.threshold) {
+                    this.scrollY(this.speedAt(Math.max(0, distBottom)) * dt);
+                    scrolled = true;
+                }
+                // ── Horizontal ──────────────────────────────────────────────────────────
+                const distLeft = x - rect.left;
+                const distRight = rect.right - x;
+                if (distLeft < this.threshold) {
+                    this.scrollX(-this.speedAt(Math.max(0, distLeft)) * dt);
+                    scrolled = true;
+                }
+                else if (distRight < this.threshold) {
+                    this.scrollX(this.speedAt(Math.max(0, distRight)) * dt);
+                    scrolled = true;
+                }
+            }
+            if (scrolled) {
+                this.onScrolled?.(this.clientX, this.clientY);
+            }
+            // Keep the loop alive as long as `running` is true — stop() terminates it.
+            this.rafId = requestAnimationFrame(this.tick);
+        };
+    }
+    /**
+     * Updates the tracked cursor position and starts the RAF loop if it is not
+     * already running.  Safe to call on every `mousemove` — has no overhead
+     * when the cursor is away from the edges.
+     *
+     * @param x - `MouseEvent.clientX`
+     * @param y - `MouseEvent.clientY`
+     */
+    updateMouse(x, y) {
+        this.clientX = x;
+        this.clientY = y;
+        if (!this.running) {
+            this.running = true;
+            this.lastTs = 0;
+            this.rafId = requestAnimationFrame(this.tick);
+        }
+    }
+    /**
+     * Stops the RAF loop immediately.  Call on `mouseup` or when the drag
+     * interaction ends to prevent ghost scrolling after the pointer is released.
+     */
+    stop() {
+        this.running = false;
+        if (this.rafId !== null) {
+            cancelAnimationFrame(this.rafId);
+            this.rafId = null;
+        }
+    }
+    /**
+     * Computes scroll speed (px/s) as a linear ramp:
+     * `maxSpeed` at the edge (dist = 0), `0` at `threshold` distance.
+     *
+     * @param distFromEdge - Distance from the viewport edge in pixels.
+     */
+    speedAt(distFromEdge) {
+        return this.maxSpeed * (1 - distFromEdge / this.threshold);
+    }
+}
+//# sourceMappingURL=auto-scroller.js.map

package/renderer/auto-scroller.js.map

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

package/renderer/body-renderer.d.ts

@@ -0,0 +1,191 @@
+import type { RowNode } from '../types/row.types';
+import type { ColumnDef } from '../types/column.types';
+import type { GridStore } from '../core/grid-store';
+import type { EventBus } from '../event-bus/event-bus';
+import type { IconRenderer } from '../icons/icon-renderer';
+import type { RowSelectionEngine } from '../engines/selection/row-selection-engine';
+import { type TreeToggleRenderConfig } from './tree-cell-renderer';
+export interface BodyRendererOptions {
+    showCheckboxes?: boolean;
+    showSerialNumber?: boolean;
+    showVerticalBorders?: boolean;
+    rowShading?: boolean;
+    rowHeight?: number;
+    api?: unknown;
+    dateFormat?: string;
+    timeZone?: string;
+    currencySymbol?: string;
+    locale?: string;
+    showGroupsColumn?: boolean;
+    autoGroupColWidth?: number;
+    /**
+     * `ColumnDef` for the innermost (deepest) grouping field.
+     *
+     * When provided, leaf data rows render an interactive cell in the auto-group
+     * column showing the row's value for this field — selectable, editable, and
+     * copyable exactly like any normal data cell.
+     *
+     * `null` (or omitted) when no grouping is active; a plain spacer is rendered
+     * instead to maintain column alignment.
+     */
+    leafGroupColDef?: ColumnDef | null;
+    /**
+     * Full, unfiltered column list — includes columns hidden by horizontal
+     * virtualization AND columns hidden because they're the active group-by
+     * field. Used to resolve a group row's `groupField` to its `ColumnDef` so a
+     * custom `renderer.group` can be looked up even though that column itself
+     * renders no cell of its own while grouped.
+     */
+    allLeafColumns?: ColumnDef[];
+    centerColStart?: number;
+    centerLeftSpacerW?: number;
+    centerRightSpacerW?: number;
+    totalCenterCols?: number;
+    /**
+     * When Master/Detail is enabled, drives the expand/collapse toggle icon
+     * rendered on `'data'` rows for the configured toggle column.
+     */
+    masterDetail?: {
+        toggleColumnId: string;
+        isExpandedFn: (nodeId: string) => boolean;
+        hasDetailFn: (rowData: Record<string, unknown>) => boolean;
+    };
+    /**
+     * When Tree Data is enabled, drives indentation (`data-level` on the row
+     * element) and the expand/collapse toggle rendered on `'data'` rows with
+     * children, in the configured toggle column.
+     */
+    treeData?: TreeToggleRenderConfig;
+}
+export declare class BodyRenderer {
+    private store;
+    private eventBus;
+    private iconRenderer;
+    private rowSelectionEngine;
+    private cellRenderer;
+    private renderedRowMap;
+    private leftContent;
+    private centerContent;
+    private rightContent;
+    private lastCenterStart;
+    private lastCenterEnd;
+    private leftSticky;
+    private centerSticky;
+    private rightSticky;
+    /** `nodeId`s of the rows currently parked in the sticky containers — a single Master/Detail master row, or a stack of Tree Data ancestor rows. */
+    private stuckNodeIds;
+    constructor(store: GridStore, eventBus: EventBus, iconRenderer: IconRenderer, rowSelectionEngine: RowSelectionEngine);
+    setPanels(leftContent: HTMLElement | null, centerContent: HTMLElement, rightContent: HTMLElement | null): void;
+    /** Wires the per-panel sticky-row overlay containers. Called once from `GridRenderer` when `masterDetail.enabled`. */
+    setStickyContainers(left: HTMLElement | null, center: HTMLElement | null, right: HTMLElement | null): void;
+    /**
+     * Parks each entry's row in the sticky overlay (pinned at the panel's own
+     * top, ignoring the scroll transform, stacked in array order) — releasing
+     * whatever was previously stuck but isn't in `entries` back into normal
+     * scrolled flow. A single entry reproduces the old Master/Detail behavior;
+     * multiple entries stack Tree Data's ancestor-row chain, each at its own
+     * `top` (see `TreeStickyRowTracker`).
+     *
+     * Moves the *actual* cached DOM nodes (not clones) so every existing
+     * listener, selection class, and edit-in-progress state carries over
+     * untouched — this only ever runs on already-rendered rows.
+     */
+    setStickyRows(entries: ReadonlyArray<{
+        nodeId: string;
+        top: number;
+    }>): void;
+    renderRows(rows: RowNode[], leftCols: ColumnDef[], centerCols: ColumnDef[], // visible slice only
+    rightCols: ColumnDef[], options?: BodyRendererOptions): void;
+    updateRowSelection(nodeId: string, selected: boolean): void;
+    /**
+     * Advances the tracked virtual-column range without touching any DOM.
+     *
+     * Call this when the column range has logically changed but the body rows must
+     * NOT be rebuilt — specifically during an active column resize where CSS rules
+     * already handle width changes via `ColumnStyleManager`. Keeping the tracked
+     * range current prevents the next normal `renderRows` call (on `mouseup`) from
+     * seeing a false "range changed" signal and wiping all center panels.
+     *
+     * @param cStart - New first visible center-column index.
+     * @param cEnd   - New last visible center-column index (exclusive).
+     */
+    syncCenterRange(cStart: number, cEnd: number): void;
+    clear(): void;
+    /**
+     * Evicts only the specified rows from the render cache so they are fully
+     * rebuilt on the next paint cycle.  Rows whose `nodeId` is not in the set
+     * are untouched — their DOM is reused as-is, so custom cell renderers
+     * (images, flags, progress bars, etc.) are NOT re-executed for them.
+     *
+     * Use this instead of `clear()` after in-place data mutations (fill, cut,
+     * paste, undo/redo) where only a known subset of rows changed.
+     *
+     * @param nodeIds - Set of row node IDs whose cache entries should be evicted.
+     */
+    invalidateRowsByNodeId(nodeIds: Set<string>): void;
+    destroy(): void;
+    private buildPanelRow;
+    private buildSingleRow;
+    /**
+     * Renders the auto-group column cell for a **leaf data row**.
+     *
+     * When `options.leafGroupColDef` is set (i.e. grouping is active), this cell
+     * shows the row's actual value for the deepest grouping field and participates
+     * fully in cell selection (colIndex −1), keyboard navigation, editing, and
+     * copy/cut/paste — behaving exactly like any normal data cell.
+     *
+     * When `leafGroupColDef` is absent (no grouping active) a non-interactive
+     * spacer cell is rendered to maintain column alignment with group header rows.
+     *
+     * @param el      - Row container element to append the cell into.
+     * @param row     - Leaf data `RowNode` being rendered.
+     * @param options - Renderer options; `autoGroupColWidth` controls cell width.
+     */
+    private buildLeafGroupCell;
+    private buildGroupRowContent;
+    /**
+     * Builds the label cell for a group **footer** row.
+     *
+     * Unlike the header, there is no expand/collapse toggle — the cell shows
+     * a Σ-prefixed group value to signal "total for this group".
+     * The cell participates in cell selection (colIndex −1) identically to the
+     * group header's label cell.
+     */
+    private buildGroupFooterContent;
+    /**
+     * Append one `pg-cell` per column to `el` for a group row.
+     *
+     * - Columns with `type === 'currency'` **and** `aggFunc` set receive a
+     *   `pg-cell--agg` cell showing the formatted aggregate value.
+     * - All other columns receive an empty `pg-cell` to maintain column
+     *   alignment with data rows.
+     *
+     * Column widths are automatically applied by the {@link ColumnStyleManager}
+     * via the `[data-col-id]` CSS rules — no inline width needed here.
+     */
+    private buildGroupAggregateCells;
+    /**
+     * Format a computed aggregate value for display.
+     *
+     * - For `count` the value is emitted as a plain integer string.
+     * - For all other functions the value is routed through {@link formatValue}
+     *   so the column's currency symbol, locale, and precision are applied.
+     *
+     * @param value   - Raw numeric aggregate result.
+     * @param col     - Column definition (used for type and formatting options).
+     * @param options - Renderer options (locale, currency symbol, etc.).
+     */
+    private formatAggValue;
+    private updatePanelRow;
+    /**
+     * Inserts the Master/Detail expand/collapse toggle as a sibling of
+     * `.pg-cell__inner` (never inside it) — `.pg-cell__inner` is wiped and
+     * rebuilt wholesale by cell-edit start/stop (`GridCore.startCellEdit` /
+     * `renderCellValue`), which would silently destroy a toggle placed inside it
+     * the first time this column is edited.
+     */
+    private applyMasterDetailToggle;
+    private attachRowListeners;
+    private getRowClass;
+}
+//# sourceMappingURL=body-renderer.d.ts.map

package/renderer/body-renderer.d.ts.map

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