photon-grid-core 0.0.1

package/renderer/scroll-controller.js

@@ -0,0 +1,200 @@
+export class ScrollController {
+    constructor() {
+        this.scrollTop = 0;
+        this.scrollLeft = 0;
+        this.totalHeight = 0;
+        this.totalCenterWidth = 0;
+        this.viewportHeight = 0;
+        this.centerViewportWidth = 0;
+        this.gridEl = null;
+        this.sbVNativeEl = null;
+        this.sbVSpacerEl = null;
+        this.sbHNativeEl = null;
+        this.sbHSpacerEl = null;
+        this.sbHRowEl = null;
+        this.abortCtrl = null;
+        this.resizeObs = null;
+        this.scrollYCb = null;
+        this.scrollXCb = null;
+        /**
+         * When `true`, the vertical scrollbar column is never collapsed to 0 width
+         * — it stays reserved (a "stable gutter") even while `totalHeight <=
+         * viewportHeight`. Set for Master/Detail grids: expanding/collapsing a
+         * detail row changes total content height, which can tip whether a
+         * scrollbar is needed at all — if the column collapsed and reappeared with
+         * it, every flex column would jump to fill/re-cede that space on every
+         * toggle. Reserving it unconditionally makes that a non-event.
+         */
+        this.reserveVerticalGutter = false;
+        this.onVNativeScroll = () => {
+            const st = this.sbVNativeEl.scrollTop;
+            if (Math.abs(st - this.scrollTop) < 0.5)
+                return;
+            this.scrollTop = st;
+            this.syncCSSVars();
+            this.scrollYCb?.(st);
+        };
+        this.onHNativeScroll = () => {
+            const sl = this.sbHNativeEl.scrollLeft;
+            if (Math.abs(sl - this.scrollLeft) < 0.5)
+                return;
+            this.scrollLeft = sl;
+            this.syncCSSVars();
+            this.scrollXCb?.();
+        };
+        this.onWheel = (e) => {
+            if (e.ctrlKey)
+                return;
+            // The Photon AI panel floats as a sibling overlay inside this same
+            // `.pg-grid__body` (see `GridRenderer.buildLayout`/`PhotonAIPanel.mount`),
+            // so a wheel event over its own scrollable chat log still bubbles up to
+            // this listener. Left unchecked, `preventDefault` below blocks the
+            // panel's native scroll entirely and redirects the gesture into scrolling
+            // the grid underneath it instead — bail out here so the panel scrolls itself.
+            if (e.target?.closest('.pg-ai-panel'))
+                return;
+            e.preventDefault();
+            // A nested Master/Detail grid's body sits inside the parent grid's own
+            // `.pg-grid__body` (a sibling of the pinned panels, not a descendant of
+            // them — see DetailRowRenderer). Without stopping propagation here, a
+            // wheel event this grid already handled keeps bubbling and also reaches
+            // the parent grid's own wheel listener on that shared ancestor, scrolling
+            // both grids from a single gesture (most visible on horizontal-dominant
+            // scrolls, and intermittently on trackpads whose "vertical" gestures emit
+            // a small stray deltaX).
+            e.stopPropagation();
+            let dx = e.deltaX;
+            let dy = e.deltaY;
+            if (e.deltaMode === 1 /* DOM_DELTA_LINE */) {
+                dx *= 32;
+                dy *= 32;
+            }
+            else if (e.deltaMode === 2 /* DOM_DELTA_PAGE */) {
+                dx *= this.centerViewportWidth;
+                dy *= this.viewportHeight;
+            }
+            if (e.shiftKey || Math.abs(dx) > Math.abs(dy)) {
+                this.scrollToX(this.scrollLeft + (e.deltaX !== 0 ? dx : dy));
+            }
+            else {
+                this.scrollToY(this.scrollTop + dy);
+            }
+        };
+    }
+    onScrollY(cb) { this.scrollYCb = cb; }
+    onScrollX(cb) { this.scrollXCb = cb; }
+    setReserveVerticalGutter(reserve) {
+        this.reserveVerticalGutter = reserve;
+    }
+    mount(gridEl, bodyEl, centerBodyEl, sbVNativeEl, sbVSpacerEl, sbHNativeEl, sbHSpacerEl, sbHRowEl) {
+        this.gridEl = gridEl;
+        this.sbVNativeEl = sbVNativeEl;
+        this.sbVSpacerEl = sbVSpacerEl;
+        this.sbHNativeEl = sbHNativeEl;
+        this.sbHSpacerEl = sbHSpacerEl;
+        this.sbHRowEl = sbHRowEl ?? sbHNativeEl;
+        const ac = new AbortController();
+        this.abortCtrl = ac;
+        const sig = ac.signal;
+        bodyEl.addEventListener('wheel', this.onWheel, { passive: false, signal: sig });
+        const headerEl = gridEl.querySelector('.pg-grid__header');
+        headerEl?.addEventListener('wheel', this.onWheel, { passive: false, signal: sig });
+        sbVNativeEl.addEventListener('scroll', this.onVNativeScroll, { signal: sig });
+        sbHNativeEl.addEventListener('scroll', this.onHNativeScroll, { signal: sig });
+        this.resizeObs = new ResizeObserver(() => {
+            this.viewportHeight = bodyEl.clientHeight;
+            this.centerViewportWidth = centerBodyEl.clientWidth;
+            this.clampScroll();
+            this.syncCSSVars();
+            this.syncScrollbars();
+            this.scrollXCb?.();
+        });
+        this.resizeObs.observe(bodyEl);
+        this.resizeObs.observe(centerBodyEl);
+        this.viewportHeight = bodyEl.clientHeight;
+        this.centerViewportWidth = centerBodyEl.clientWidth;
+    }
+    updateSizes(totalHeight, totalCenterWidth) {
+        this.totalHeight = totalHeight;
+        this.totalCenterWidth = totalCenterWidth;
+        if (this.sbVSpacerEl)
+            this.sbVSpacerEl.style.height = `${totalHeight}px`;
+        if (this.sbHSpacerEl)
+            this.sbHSpacerEl.style.width = `${totalCenterWidth}px`;
+        this.clampScroll();
+        this.syncCSSVars();
+        this.syncScrollbars();
+    }
+    getScrollTop() { return this.scrollTop; }
+    getScrollLeft() { return this.scrollLeft; }
+    /** Returns the current visible height of the body viewport in pixels. */
+    getViewportHeight() { return this.viewportHeight; }
+    /** Returns the current visible width of the center body viewport in pixels. */
+    getCenterViewportWidth() { return this.centerViewportWidth; }
+    canScrollLeft() { return this.scrollLeft > 0; }
+    canScrollRight() { return this.scrollLeft < Math.max(0, this.totalCenterWidth - this.centerViewportWidth); }
+    canScrollUp() { return this.scrollTop > 0; }
+    canScrollDown() { return this.scrollTop < Math.max(0, this.totalHeight - this.viewportHeight); }
+    scrollToY(y) {
+        const max = Math.max(0, this.totalHeight - this.viewportHeight);
+        const next = Math.max(0, Math.min(y, max));
+        if (next === this.scrollTop)
+            return;
+        this.scrollTop = next;
+        this.syncCSSVars();
+        this.syncScrollbars();
+        if (this.sbVNativeEl)
+            this.sbVNativeEl.scrollTop = next;
+        this.scrollYCb?.(this.scrollTop);
+    }
+    scrollToX(x) {
+        const max = Math.max(0, this.totalCenterWidth - this.centerViewportWidth);
+        const next = Math.max(0, Math.min(x, max));
+        if (next === this.scrollLeft)
+            return;
+        this.scrollLeft = next;
+        this.syncCSSVars();
+        this.syncScrollbars();
+        if (this.sbHNativeEl)
+            this.sbHNativeEl.scrollLeft = next;
+        this.scrollXCb?.();
+    }
+    scrollToRow(rowIndex, rows) {
+        if (rowIndex >= 0 && rowIndex < rows.length)
+            this.scrollToY(rows[rowIndex].top);
+    }
+    scrollToTop() { this.scrollToY(0); }
+    destroy() {
+        this.abortCtrl?.abort();
+        this.abortCtrl = null;
+        this.resizeObs?.disconnect();
+        this.resizeObs = null;
+    }
+    clampScroll() {
+        this.scrollTop = Math.max(0, Math.min(this.scrollTop, Math.max(0, this.totalHeight - this.viewportHeight)));
+        this.scrollLeft = Math.max(0, Math.min(this.scrollLeft, Math.max(0, this.totalCenterWidth - this.centerViewportWidth)));
+    }
+    syncCSSVars() {
+        if (!this.gridEl)
+            return;
+        this.gridEl.style.setProperty('--pg-scroll-x', `-${this.scrollLeft}px`);
+        this.gridEl.style.setProperty('--pg-scroll-y', `-${this.scrollTop}px`);
+    }
+    syncScrollbars() {
+        if (this.sbVNativeEl) {
+            const vHidden = !this.reserveVerticalGutter && this.totalHeight <= this.viewportHeight;
+            this.sbVNativeEl.classList.toggle('pg-scrollbar--hidden', vHidden);
+            // Master/Detail's full-width overlay layer spans the entire body
+            // (including the vertical scrollbar's flex-allocated column) so its
+            // rows can be positioned with simple `top` offsets. This live var lets
+            // it carve out exactly the scrollbar's *current* width — 0 when hidden,
+            // matching the real column layout — so it never visually paints over
+            // the native scrollbar when one is showing.
+            this.gridEl?.style.setProperty('--pg-scrollbar-v-live-width', vHidden ? '0px' : 'var(--pg-scrollbar-v-width, 17px)');
+        }
+        if (this.sbHRowEl) {
+            this.sbHRowEl.classList.toggle('pg-scrollbar--hidden', this.totalCenterWidth <= this.centerViewportWidth);
+        }
+    }
+}
+//# sourceMappingURL=scroll-controller.js.map

package/renderer/scroll-controller.js.map

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

package/renderer/sticky-row-tracker.d.ts

@@ -0,0 +1,40 @@
+import type { RowNode } from '../types/row.types';
+/** Result of a single `StickyRowTracker.compute` call. */
+export interface StickyRowResult {
+    /** `nodeId` of the master row that should render pinned at the panel's top, or `null` when nothing is sticky. */
+    nodeId: string | null;
+    /** Pixel offset (always `<= 0`) to apply as the sticky row's `top` — `0` while fully pinned, negative while being pushed off-screen by the next block taking over. */
+    offsetPx: number;
+    /** The virtualization window's `start` index, widened if needed so the sticky row's cells stay rendered even though it has scrolled past its natural position. */
+    minStart: number;
+}
+/**
+ * Computes Master/Detail sticky-row state for one grid instance's current
+ * scroll position — the sole responsibility of this class, kept separate
+ * from `GridRenderer` so the sticky math is independently readable/testable
+ * and easy to extend (e.g. sticky group headers could reuse the same shape).
+ *
+ * A row R (`type: 'data'`, expanded, with an immediately-following `'detail'`
+ * row D) defines a "block" spanning `[R.top, D.top + D.height)`. Whenever the
+ * current `scrollTop` falls inside that range — including while merely
+ * scrolling through R's own height, before D even starts — R should render
+ * pinned at the viewport's top instead of scrolling normally.
+ *
+ * The returned `offsetPx` implements the classic "push-off" handoff used by
+ * native `position: sticky` with sequential sticky siblings: it stays `0`
+ * (fully pinned) until the block's end approaches, then slides negative so R
+ * appears to be covered/pushed away by the next row arriving from below,
+ * reaching exactly `-R.height` right as the block ends and control passes to
+ * whatever comes next — rather than R abruptly vanishing.
+ */
+export declare class StickyRowTracker {
+    compute(rows: RowNode[], scrollTop: number, rowHeight: number, windowStart: number): StickyRowResult;
+    /**
+     * Given the row whose span contains `scrollTop`, resolves the index of the
+     * "master" row that should be sticky — itself if it's an expanded master
+     * still within its own height, or its parent if it's the detail row.
+     * Returns -1 when the row at `idx` isn't part of a master/detail block.
+     */
+    private resolveMasterIndex;
+}
+//# sourceMappingURL=sticky-row-tracker.d.ts.map

package/renderer/sticky-row-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticky-row-tracker.d.ts","sourceRoot":"","sources":["../../src/renderer/sticky-row-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,iHAAiH;IACjH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sKAAsK;IACtK,QAAQ,EAAE,MAAM,CAAC;IACjB,kKAAkK;IAClK,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe;IAyBpG;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAW3B"}

package/renderer/sticky-row-tracker.js

@@ -0,0 +1,63 @@
+import { findRowAtOffset } from './row-offset-search';
+/**
+ * Computes Master/Detail sticky-row state for one grid instance's current
+ * scroll position — the sole responsibility of this class, kept separate
+ * from `GridRenderer` so the sticky math is independently readable/testable
+ * and easy to extend (e.g. sticky group headers could reuse the same shape).
+ *
+ * A row R (`type: 'data'`, expanded, with an immediately-following `'detail'`
+ * row D) defines a "block" spanning `[R.top, D.top + D.height)`. Whenever the
+ * current `scrollTop` falls inside that range — including while merely
+ * scrolling through R's own height, before D even starts — R should render
+ * pinned at the viewport's top instead of scrolling normally.
+ *
+ * The returned `offsetPx` implements the classic "push-off" handoff used by
+ * native `position: sticky` with sequential sticky siblings: it stays `0`
+ * (fully pinned) until the block's end approaches, then slides negative so R
+ * appears to be covered/pushed away by the next row arriving from below,
+ * reaching exactly `-R.height` right as the block ends and control passes to
+ * whatever comes next — rather than R abruptly vanishing.
+ */
+export class StickyRowTracker {
+    compute(rows, scrollTop, rowHeight, windowStart) {
+        const none = { nodeId: null, offsetPx: 0, minStart: windowStart };
+        if (rows.length === 0)
+            return none;
+        const idx = findRowAtOffset(rows, scrollTop, rowHeight);
+        if (idx < 0)
+            return none;
+        const masterIdx = this.resolveMasterIndex(rows, idx);
+        if (masterIdx < 0)
+            return none;
+        const master = rows[masterIdx];
+        const detail = rows[masterIdx + 1];
+        if (!detail || detail.type !== 'detail')
+            return none;
+        const masterHeight = master.height ?? rowHeight;
+        const blockBottom = detail.top + (detail.height ?? rowHeight);
+        const offsetPx = Math.min(0, blockBottom - scrollTop - masterHeight);
+        return {
+            nodeId: master.nodeId,
+            offsetPx,
+            minStart: Math.min(windowStart, masterIdx),
+        };
+    }
+    /**
+     * Given the row whose span contains `scrollTop`, resolves the index of the
+     * "master" row that should be sticky — itself if it's an expanded master
+     * still within its own height, or its parent if it's the detail row.
+     * Returns -1 when the row at `idx` isn't part of a master/detail block.
+     */
+    resolveMasterIndex(rows, idx) {
+        const row = rows[idx];
+        if (row.type === 'detail') {
+            const parentIdx = idx - 1;
+            return rows[parentIdx]?.type === 'data' ? parentIdx : -1;
+        }
+        if (row.type === 'data' && rows[idx + 1]?.type === 'detail' && rows[idx + 1].parentNodeId === row.nodeId) {
+            return idx;
+        }
+        return -1;
+    }
+}
+//# sourceMappingURL=sticky-row-tracker.js.map

package/renderer/sticky-row-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticky-row-tracker.js","sourceRoot":"","sources":["../../src/renderer/sticky-row-tracker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAYtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IAC3B,OAAO,CAAC,IAAe,EAAE,SAAiB,EAAE,SAAiB,EAAE,WAAmB;QAChF,MAAM,IAAI,GAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QACnF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEnC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACxD,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrD,IAAI,SAAS,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAE/B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAErD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC;QAErE,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ;YACR,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,kBAAkB,CAAC,IAAe,EAAE,GAAW;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;YACzG,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;CACF"}

package/renderer/tooltip-renderer.d.ts

@@ -0,0 +1,36 @@
+import type { ColumnModel } from '../core/column-model';
+import type { GridStore } from '../core/grid-store';
+/**
+ * Shows a floating, theme-styled tooltip for cells whose column defines
+ * `renderer.tooltip`. Columns without one keep using the grid's existing,
+ * essentially free native `title` attribute — this controller does nothing
+ * for them, so it adds zero cost to the common case.
+ *
+ * Uses a single delegated `mouseover`/`mouseout` listener pair on the grid
+ * body (not one listener per cell or per row), matching the cost profile of
+ * the grid's existing delegated click handling.
+ */
+export declare class TooltipController {
+    private readonly store;
+    private readonly columnModel;
+    private readonly api;
+    private hostEl;
+    private tooltipEl;
+    private showTimer;
+    private hoveredCellEl;
+    private readonly boundMouseOver;
+    private readonly boundMouseOut;
+    constructor(store: GridStore, columnModel: ColumnModel, api: unknown);
+    /** Attaches the delegated hover listeners to the grid body wrapper. */
+    mount(bodyWrapEl: HTMLElement): void;
+    /** Detaches listeners, clears any pending timer, and removes the tooltip element. */
+    destroy(): void;
+    private handleMouseOver;
+    private handleMouseOut;
+    private show;
+    private hide;
+    /** Positions the tooltip above the anchor cell, clamped to stay within the grid body. */
+    private position;
+    private clearShowTimer;
+}
+//# sourceMappingURL=tooltip-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip-renderer.d.ts","sourceRoot":"","sources":["../../src/renderer/tooltip-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQpD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAU1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG;IAXtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,aAAa,CAA4B;IAEjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;gBAGrC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,OAAO;IAM/B,uEAAuE;IACvE,KAAK,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAMpC,qFAAqF;IACrF,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,eAAe;IAsCvB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,IAAI;IAmBZ,OAAO,CAAC,IAAI;IAIZ,yFAAyF;IACzF,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,cAAc;CAMvB"}

package/renderer/tooltip-renderer.js

@@ -0,0 +1,133 @@
+import { resolveColumnRenderer } from './renderer-resolver';
+/** Delay, in milliseconds, between hovering a cell and the custom tooltip appearing. */
+const SHOW_DELAY_MS = 400;
+/**
+ * Shows a floating, theme-styled tooltip for cells whose column defines
+ * `renderer.tooltip`. Columns without one keep using the grid's existing,
+ * essentially free native `title` attribute — this controller does nothing
+ * for them, so it adds zero cost to the common case.
+ *
+ * Uses a single delegated `mouseover`/`mouseout` listener pair on the grid
+ * body (not one listener per cell or per row), matching the cost profile of
+ * the grid's existing delegated click handling.
+ */
+export class TooltipController {
+    constructor(store, columnModel, api) {
+        this.store = store;
+        this.columnModel = columnModel;
+        this.api = api;
+        this.hostEl = null;
+        this.tooltipEl = null;
+        this.showTimer = null;
+        this.hoveredCellEl = null;
+        this.boundMouseOver = this.handleMouseOver.bind(this);
+        this.boundMouseOut = this.handleMouseOut.bind(this);
+    }
+    /** Attaches the delegated hover listeners to the grid body wrapper. */
+    mount(bodyWrapEl) {
+        this.hostEl = bodyWrapEl;
+        bodyWrapEl.addEventListener('mouseover', this.boundMouseOver);
+        bodyWrapEl.addEventListener('mouseout', this.boundMouseOut);
+    }
+    /** Detaches listeners, clears any pending timer, and removes the tooltip element. */
+    destroy() {
+        this.hostEl?.removeEventListener('mouseover', this.boundMouseOver);
+        this.hostEl?.removeEventListener('mouseout', this.boundMouseOut);
+        this.clearShowTimer();
+        this.tooltipEl?.remove();
+        this.tooltipEl = null;
+        this.hostEl = null;
+        this.hoveredCellEl = null;
+    }
+    handleMouseOver(e) {
+        const cellEl = e.target.closest('.pg-cell[data-col-id]');
+        if (!cellEl || cellEl === this.hoveredCellEl)
+            return;
+        this.hoveredCellEl = cellEl;
+        this.clearShowTimer();
+        this.hide();
+        const colId = cellEl.getAttribute('data-col-id');
+        const nodeId = cellEl.closest('[data-node-id]')?.getAttribute('data-node-id');
+        if (!colId || !nodeId)
+            return;
+        const columns = this.columnModel.getVisibleColumns();
+        const colIndex = columns.findIndex((c) => c.colId === colId);
+        const colDef = columns[colIndex];
+        if (!colDef)
+            return;
+        const tooltipFn = resolveColumnRenderer(colDef, 'tooltip');
+        if (!tooltipFn)
+            return;
+        const rows = this.store.get('visibleRows') ?? [];
+        const row = rows.find((r) => r.nodeId === nodeId);
+        if (!row || row.type !== 'data')
+            return;
+        this.showTimer = setTimeout(() => {
+            const rawValue = row.data[colDef.field];
+            const params = {
+                value: rawValue,
+                rawValue,
+                row: row.data,
+                colDef,
+                rowIndex: row.rowIndex,
+                colIndex,
+                api: this.api,
+            };
+            this.show(cellEl, tooltipFn(params));
+        }, SHOW_DELAY_MS);
+    }
+    handleMouseOut(e) {
+        const related = e.relatedTarget;
+        if (this.hoveredCellEl && related && this.hoveredCellEl.contains(related))
+            return;
+        this.hoveredCellEl = null;
+        this.clearShowTimer();
+        this.hide();
+    }
+    show(anchorEl, content) {
+        if (!this.hostEl)
+            return;
+        if (!this.tooltipEl) {
+            this.tooltipEl = document.createElement('div');
+            this.tooltipEl.className = 'pg-tooltip';
+            this.hostEl.appendChild(this.tooltipEl);
+        }
+        if (typeof content === 'string') {
+            this.tooltipEl.innerHTML = content;
+        }
+        else {
+            this.tooltipEl.innerHTML = '';
+            this.tooltipEl.appendChild(content);
+        }
+        this.position(anchorEl);
+        this.tooltipEl.classList.add('pg-tooltip--visible');
+    }
+    hide() {
+        this.tooltipEl?.classList.remove('pg-tooltip--visible');
+    }
+    /** Positions the tooltip above the anchor cell, clamped to stay within the grid body. */
+    position(anchorEl) {
+        if (!this.tooltipEl || !this.hostEl)
+            return;
+        const hostRect = this.hostEl.getBoundingClientRect();
+        const anchorRect = anchorEl.getBoundingClientRect();
+        const tooltipRect = this.tooltipEl.getBoundingClientRect();
+        let top = anchorRect.top - hostRect.top - tooltipRect.height - 8;
+        if (top < 0)
+            top = anchorRect.bottom - hostRect.top + 8;
+        let left = anchorRect.left - hostRect.left;
+        const maxLeft = hostRect.width - tooltipRect.width - 4;
+        if (left > maxLeft)
+            left = Math.max(4, maxLeft);
+        if (left < 4)
+            left = 4;
+        this.tooltipEl.style.transform = `translate(${left}px, ${top}px)`;
+    }
+    clearShowTimer() {
+        if (this.showTimer !== null) {
+            clearTimeout(this.showTimer);
+            this.showTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=tooltip-renderer.js.map

package/renderer/tooltip-renderer.js.map

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

package/renderer/tree-cell-renderer.d.ts

@@ -0,0 +1,37 @@
+import type { RowNode } from '../types/row.types';
+import type { ColumnDef } from '../types/column.types';
+import type { EventBus } from '../event-bus/event-bus';
+import type { IconRenderer } from '../icons/icon-renderer';
+/** The subset of `TreeDataConfig` `BodyRenderer` needs — passed as plain data so this module never imports the tree engine types (rendering never builds hierarchy, per the feature's own design contract). */
+export interface TreeToggleRenderConfig {
+    toggleColumnId: string;
+    isExpandedFn: (nodeId: string) => boolean;
+}
+/**
+ * Inserts Tree Data's expand/collapse toggle as a sibling of `.pg-cell__inner`
+ * (never inside it — same reasoning as `BodyRenderer.applyMasterDetailToggle`:
+ * `.pg-cell__inner` is wiped and rebuilt wholesale when a cell starts/stops
+ * editing, which would silently destroy a toggle placed inside it).
+ *
+ * A pure function, not a method on `BodyRenderer` — kept in its own module so
+ * Tree Data's rendering concern stays a separate, focused unit even though it
+ * executes inline in `BodyRenderer`'s existing per-cell build loop for
+ * performance (no parallel DOM pass, no extra pooling).
+ *
+ * No-ops for anything but a `'data'` row in the configured toggle column.
+ * A leaf row (no children) still reserves the toggle's own width as an
+ * invisible spacer rather than omitting it — without that, a leaf's content
+ * starts right at the level's base indent while its parent's content is
+ * pushed further right by the real toggle button + gap, so children render
+ * *less* indented than the parent they belong to. Reserving the same slot
+ * on every row keeps each level's content start strictly increasing.
+ */
+export declare function applyTreeToggle(cellEl: HTMLElement, row: RowNode, colDef: ColumnDef, treeData: TreeToggleRenderConfig | undefined, iconRenderer: IconRenderer, eventBus: EventBus): void;
+/**
+ * Re-applies the toggle icon/label after expansion state changes without a
+ * full row rebuild — mirrors `BodyRenderer.updatePanelRow`'s master-detail
+ * sync block. A no-op when the row has no toggle button (leaf rows, or
+ * Tree Data not enabled).
+ */
+export declare function syncTreeToggle(rowEl: HTMLElement, row: RowNode, treeData: TreeToggleRenderConfig | undefined, iconRenderer: IconRenderer): void;
+//# sourceMappingURL=tree-cell-renderer.d.ts.map

package/renderer/tree-cell-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-cell-renderer.d.ts","sourceRoot":"","sources":["../../src/renderer/tree-cell-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D,+MAA+M;AAC/M,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,sBAAsB,GAAG,SAAS,EAC5C,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAoCN;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,sBAAsB,GAAG,SAAS,EAC5C,YAAY,EAAE,YAAY,GACzB,IAAI,CASN"}

package/renderer/tree-cell-renderer.js

@@ -0,0 +1,75 @@
+import { GridEventType } from '../types/event.types';
+import { createDiv } from './dom-utils';
+/**
+ * Inserts Tree Data's expand/collapse toggle as a sibling of `.pg-cell__inner`
+ * (never inside it — same reasoning as `BodyRenderer.applyMasterDetailToggle`:
+ * `.pg-cell__inner` is wiped and rebuilt wholesale when a cell starts/stops
+ * editing, which would silently destroy a toggle placed inside it).
+ *
+ * A pure function, not a method on `BodyRenderer` — kept in its own module so
+ * Tree Data's rendering concern stays a separate, focused unit even though it
+ * executes inline in `BodyRenderer`'s existing per-cell build loop for
+ * performance (no parallel DOM pass, no extra pooling).
+ *
+ * No-ops for anything but a `'data'` row in the configured toggle column.
+ * A leaf row (no children) still reserves the toggle's own width as an
+ * invisible spacer rather than omitting it — without that, a leaf's content
+ * starts right at the level's base indent while its parent's content is
+ * pushed further right by the real toggle button + gap, so children render
+ * *less* indented than the parent they belong to. Reserving the same slot
+ * on every row keeps each level's content start strictly increasing.
+ */
+export function applyTreeToggle(cellEl, row, colDef, treeData, iconRenderer, eventBus) {
+    if (!treeData || row.type !== 'data' || colDef.colId !== treeData.toggleColumnId)
+        return;
+    // Marks the toggle column's cell for level-based indentation (see the
+    // `.pg-row--tree[data-level="N"] .pg-cell--tree-toggle-col` rules in
+    // base-styles.ts) — applied to every row in this column, leaves included,
+    // since a leaf still needs to sit indented under its parent even with no
+    // chevron of its own.
+    cellEl.classList.add('pg-cell--tree-toggle-col');
+    const inner = cellEl.querySelector('.pg-cell__inner');
+    if (!row.hasChildren) {
+        const spacer = createDiv('pg-tree-toggle-spacer');
+        if (inner)
+            cellEl.insertBefore(spacer, inner);
+        else
+            cellEl.insertBefore(spacer, cellEl.firstChild);
+        return;
+    }
+    const isExpanded = treeData.isExpandedFn(row.nodeId);
+    const toggleBtn = createDiv('pg-tree-toggle');
+    toggleBtn.setAttribute('role', 'button');
+    toggleBtn.setAttribute('data-tree-toggle', '');
+    toggleBtn.setAttribute('aria-label', isExpanded ? 'Collapse' : 'Expand');
+    toggleBtn.appendChild(iconRenderer.render(isExpanded ? 'chevronDown' : 'chevronRight', { size: 16 }));
+    if (inner) {
+        cellEl.insertBefore(toggleBtn, inner);
+    }
+    else {
+        cellEl.insertBefore(toggleBtn, cellEl.firstChild);
+    }
+    toggleBtn.addEventListener('click', (e) => {
+        e.stopPropagation();
+        eventBus.emit(GridEventType.TREE_NODE_TOGGLE_CLICKED, { row, colDef });
+    });
+}
+/**
+ * Re-applies the toggle icon/label after expansion state changes without a
+ * full row rebuild — mirrors `BodyRenderer.updatePanelRow`'s master-detail
+ * sync block. A no-op when the row has no toggle button (leaf rows, or
+ * Tree Data not enabled).
+ */
+export function syncTreeToggle(rowEl, row, treeData, iconRenderer) {
+    if (!treeData || row.type !== 'data')
+        return;
+    const toggleBtn = rowEl.querySelector('.pg-tree-toggle');
+    if (!toggleBtn)
+        return;
+    const isExpanded = treeData.isExpandedFn(row.nodeId);
+    const iconEl = toggleBtn.querySelector('.pg-icon');
+    if (iconEl)
+        iconRenderer.updateIcon(iconEl, isExpanded ? 'chevronDown' : 'chevronRight');
+    toggleBtn.setAttribute('aria-label', isExpanded ? 'Collapse' : 'Expand');
+}
+//# sourceMappingURL=tree-cell-renderer.js.map

package/renderer/tree-cell-renderer.js.map

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