photon-grid-core 0.0.1

package/renderer/footer-renderer.js

@@ -0,0 +1,168 @@
+import { GridEventType } from '../types/event.types';
+import { createDiv } from './dom-utils';
+export class FooterRenderer {
+    constructor(eventBus, iconRenderer, paginationEngine) {
+        this.eventBus = eventBus;
+        this.iconRenderer = iconRenderer;
+        this.paginationEngine = paginationEngine;
+        this.footerEl = null;
+        this.pageInfoEl = null;
+        this.pageInputEl = null;
+    }
+    render(containerEl, options = {}) {
+        this.footerEl = createDiv('pg-footer');
+        const h = options.footerHeight ?? 44;
+        this.footerEl.style.height = `${h}px`;
+        if (options.showPagination) {
+            this.footerEl.appendChild(this.buildPaginationControls());
+        }
+        if (options.showRowCount) {
+            const rowCount = createDiv('pg-footer__row-count');
+            this.pageInfoEl = rowCount;
+            this.footerEl.appendChild(rowCount);
+        }
+        this.updatePaginationState();
+        containerEl.appendChild(this.footerEl);
+        return this.footerEl;
+    }
+    updatePaginationState() {
+        if (!this.footerEl)
+            return;
+        const config = this.getConfig();
+        const totalPages = this.paginationEngine.getTotalPages();
+        const { start, end } = this.paginationEngine.getPageRange();
+        const pageInfo = this.footerEl.querySelector('.pg-pagination__info');
+        if (pageInfo) {
+            pageInfo.textContent = `${start}–${end} of ${config.totalRows ?? 0}`;
+        }
+        if (this.pageInputEl) {
+            this.pageInputEl.value = String(config.page);
+            this.pageInputEl.max = String(totalPages);
+        }
+        const firstBtn = this.footerEl.querySelector('[data-action="first"]');
+        const prevBtn = this.footerEl.querySelector('[data-action="prev"]');
+        const nextBtn = this.footerEl.querySelector('[data-action="next"]');
+        const lastBtn = this.footerEl.querySelector('[data-action="last"]');
+        const isFirst = this.paginationEngine.isFirstPage();
+        const isLast = this.paginationEngine.isLastPage();
+        if (firstBtn)
+            firstBtn.disabled = isFirst;
+        if (prevBtn)
+            prevBtn.disabled = isFirst;
+        if (nextBtn)
+            nextBtn.disabled = isLast;
+        if (lastBtn)
+            lastBtn.disabled = isLast;
+    }
+    destroy() {
+        this.footerEl?.remove();
+        this.footerEl = null;
+        this.pageInfoEl = null;
+        this.pageInputEl = null;
+    }
+    buildPaginationControls() {
+        const pagination = createDiv('pg-pagination');
+        const firstBtn = this.buildNavButton('first', 'pageFirst', 'First page');
+        const prevBtn = this.buildNavButton('prev', 'pagePrev', 'Previous page');
+        const pageInfo = createDiv('pg-pagination__info');
+        pageInfo.textContent = '—';
+        const pageInput = document.createElement('input');
+        pageInput.type = 'number';
+        pageInput.min = '1';
+        pageInput.className = 'pg-pagination__page-input';
+        pageInput.setAttribute('aria-label', 'Page number');
+        this.pageInputEl = pageInput;
+        pageInput.addEventListener('change', () => {
+            const page = parseInt(pageInput.value, 10);
+            if (!isNaN(page)) {
+                this.paginationEngine.goToPage(page);
+                this.updatePaginationState();
+                this.eventBus.emit(GridEventType.PAGE_CHANGED, {
+                    page,
+                    pageSize: this.getConfig().pageSize,
+                    totalRows: this.getConfig().totalRows ?? 0,
+                    totalPages: this.paginationEngine.getTotalPages(),
+                });
+            }
+        });
+        const nextBtn = this.buildNavButton('next', 'pageNext', 'Next page');
+        const lastBtn = this.buildNavButton('last', 'pageLast', 'Last page');
+        const pageSizeSelect = this.buildPageSizeSelect();
+        pagination.appendChild(pageSizeSelect);
+        pagination.appendChild(firstBtn);
+        pagination.appendChild(prevBtn);
+        pagination.appendChild(pageInfo);
+        pagination.appendChild(pageInput);
+        pagination.appendChild(nextBtn);
+        pagination.appendChild(lastBtn);
+        return pagination;
+    }
+    buildNavButton(action, iconName, label) {
+        const btn = document.createElement('button');
+        btn.className = `pg-pagination__btn pg-pagination__btn--${action}`;
+        btn.setAttribute('data-action', action);
+        btn.setAttribute('aria-label', label);
+        btn.setAttribute('type', 'button');
+        btn.appendChild(this.iconRenderer.render(iconName, { size: 16 }));
+        btn.addEventListener('click', () => {
+            switch (action) {
+                case 'first':
+                    this.paginationEngine.goToFirstPage();
+                    break;
+                case 'prev':
+                    this.paginationEngine.goToPreviousPage();
+                    break;
+                case 'next':
+                    this.paginationEngine.goToNextPage();
+                    break;
+                case 'last':
+                    this.paginationEngine.goToLastPage();
+                    break;
+            }
+            this.updatePaginationState();
+            const config = this.getConfig();
+            this.eventBus.emit(GridEventType.PAGE_CHANGED, {
+                page: config.page,
+                pageSize: config.pageSize,
+                totalRows: config.totalRows ?? 0,
+                totalPages: this.paginationEngine.getTotalPages(),
+            });
+        });
+        return btn;
+    }
+    buildPageSizeSelect() {
+        const wrapper = createDiv('pg-pagination__size');
+        const label = document.createElement('span');
+        label.textContent = 'Rows per page:';
+        label.className = 'pg-pagination__size-label';
+        const select = document.createElement('select');
+        select.className = 'pg-pagination__size-select';
+        const config = this.getConfig();
+        for (const size of config.pageSizeOptions) {
+            const opt = document.createElement('option');
+            opt.value = String(size);
+            opt.textContent = String(size);
+            opt.selected = size === config.pageSize;
+            select.appendChild(opt);
+        }
+        select.addEventListener('change', () => {
+            const size = parseInt(select.value, 10);
+            this.paginationEngine.setPageSize(size);
+            this.updatePaginationState();
+        });
+        wrapper.appendChild(label);
+        wrapper.appendChild(select);
+        return wrapper;
+    }
+    getConfig() {
+        return {
+            enabled: true,
+            page: this.paginationEngine.getCurrentPage(),
+            pageSize: this.paginationEngine.getPageSize(),
+            pageSizeOptions: [10, 25, 50, 100, 1000, 10000, 100000],
+            serverSide: false,
+            totalRows: this.paginationEngine.getTotalRows(),
+        };
+    }
+}
+//# sourceMappingURL=footer-renderer.js.map

package/renderer/footer-renderer.js.map

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

package/renderer/grid-renderer.d.ts

@@ -0,0 +1,295 @@
+import type { GridOptions } from '../types/grid.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 { ColumnModel } from '../core/column-model';
+import type { PaginationEngine } from '../engines/pagination/pagination-engine';
+import type { IconRenderer } from '../icons/icon-renderer';
+import type { SortEngine } from '../engines/sort/sort-engine';
+import type { RowSelectionEngine } from '../engines/selection/row-selection-engine';
+import type { GroupingEngine } from '../engines/grouping/grouping-engine';
+import type { FilterEngine } from '../engines/filter/filter-engine';
+import type { ColumnGroupModel } from '../column-groups/column-group-model';
+import type { ColumnGroupHeaderBuilder } from '../column-groups/column-group-header-builder';
+import type { DisplayGroupEngine } from '../column-groups/display-group-engine';
+import { ColumnStyleManager } from './column-style-manager';
+import { CellSelectionEngine } from '../cell-selection/cell-selection-engine';
+import type { MasterDetailEngine } from '../engines/master-detail/master-detail-engine';
+import type { TreeExpansionService } from '../engines/tree/tree-expansion-service';
+import type { ThemeManager } from '../theme/theme-manager';
+import { type NestedGridFactory } from './detail-row-renderer';
+import type { PhotonCommandResult } from '../photon-ai/photon-ai.types';
+export declare class GridRenderer {
+    private containerEl;
+    private store;
+    private eventBus;
+    private columnModel;
+    private paginationEngine;
+    private iconRenderer;
+    private cellSelectionEngine;
+    private sortEngine;
+    private rowSelectionEngine;
+    private groupingEngine;
+    private options;
+    private wrapperEl;
+    private leftHeaderPanelEl;
+    private centerHeaderInnerEl;
+    private rightHeaderPanelEl;
+    private leftBodyPanelEl;
+    private centerBodyEl;
+    private centerBodyContentEl;
+    private rightBodyPanelEl;
+    private leftBodyContentEl;
+    private rightBodyContentEl;
+    private footerContainerEl;
+    private bodyWrapEl;
+    private leftStickyRowEl;
+    private centerStickyRowEl;
+    private rightStickyRowEl;
+    private readonly masterDetailEnabledAtConstruction;
+    private readonly treeDataEnabledAtConstruction;
+    /** `nodeId` of the currently-stuck master row, or `null` when none is sticky. */
+    private stickyNodeId;
+    private readonly stickyRowTracker;
+    private readonly treeStickyRowTracker;
+    /** Exposed for {@link DisplayGroupEngine} construction in `GridCore`. */
+    readonly colStyles: ColumnStyleManager;
+    private rowPositionSheet;
+    private scrollController;
+    private headerRenderer;
+    private bodyRenderer;
+    private footerRenderer;
+    private overlayRenderer;
+    private groupDropZone;
+    private rowDragRenderer;
+    private treeDragConfig;
+    private detailRowRenderer;
+    private masterDetailEngine;
+    private treeExpansionService;
+    private treeToggleColumnId;
+    /** Floating Photon AI command bar — only created when `photonAI.enabled`. */
+    private photonAIPanel;
+    /** Shows a custom floating tooltip for columns with `renderer.tooltip`; a no-op for every other column. */
+    private tooltipController;
+    private rafId;
+    private autoScroller;
+    private unsubscribers;
+    private headerRendered;
+    private lastCenterColStart;
+    private lastCenterColEnd;
+    private rowAnimator;
+    private columnGroupModel;
+    private groupHeaderBuilder;
+    private groupDragHandler;
+    /** New Display Group Engine — takes priority over the legacy ColumnGroupModel when set. */
+    private displayGroupEngine;
+    private filterEngine;
+    private filterRefreshFn;
+    private activeFilterPanel;
+    /** Last `columns` array reference seen — guards column-width recomputation. */
+    private _lastColumnsRef;
+    /** Last `groupedColumnIds` array reference seen — guards grouping recomputation. */
+    private _lastGroupedIdsRef;
+    /** Last `visibleRows` array reference seen — guards total-height recomputation. */
+    private _lastRowsRef;
+    /** Cached total content height in pixels (sum of all visible row heights). */
+    private _cachedTotalHeight;
+    /** Cached center-panel content width in pixels. */
+    private _cachedCenterW;
+    /**
+     * Center-panel `clientWidth` last used to resolve `flex` columns. Flex
+     * widths are normally only re-resolved when the columns array itself
+     * changes (cheap, guards the 60fps scroll path) — but the container can
+     * also resize with the columns reference untouched, e.g. a vertical
+     * scrollbar transiently appearing/disappearing as a Master/Detail row is
+     * inserted. Comparing against this on every render (a single cheap
+     * `clientWidth` read, only paid by grids that actually use `flex` columns)
+     * catches that case so flex columns don't get stuck sized for a stale width.
+     */
+    private _lastFlexResolvedWidth;
+    constructor(containerEl: HTMLElement, store: GridStore, eventBus: EventBus, columnModel: ColumnModel, paginationEngine: PaginationEngine, iconRenderer: IconRenderer, cellSelectionEngine: CellSelectionEngine, sortEngine: SortEngine, rowSelectionEngine: RowSelectionEngine, groupingEngine: GroupingEngine, options: GridOptions);
+    /**
+     * Enables Tree Data drag-to-reparent on the row-drag system. Must be
+     * called before `mount()` (mirrors `setMasterDetailConfig`) — `mount()`
+     * is when `RowDragRenderer` is actually constructed.
+     */
+    setTreeDragConfig(active: boolean, reparentHandler: (draggedId: string, targetId: string, position: 'before' | 'after' | 'inside') => boolean): void;
+    /** Wires Tree Data's expansion state + toggle column into the body renderer, so `data-level` indentation and the expand/collapse toggle render on the configured column. A no-op (undefined `treeData` on every `renderRows` call) until this is called. */
+    setTreeRenderConfig(toggleColumnId: string | undefined, expansionService: TreeExpansionService): void;
+    mount(): void;
+    scheduleRender(): void;
+    forceRender(): void;
+    /**
+     * Clears the body-renderer's row cache so the next render fully rebuilds every
+     * visible row from the data model.  Use this after in-place data mutations
+     * (paste, cut) where the `visibleRows` reference is unchanged but cell values
+     * have been updated — `updatePanelRow` only refreshes row-level classes, not
+     * cell content, so a cache invalidation + re-render is required.
+     */
+    invalidateBodyRows(): void;
+    /**
+     * Evicts only the rows with the given node IDs from the render cache and
+     * schedules a repaint.  All other rows keep their cached DOM elements so
+     * custom cell renderers (images, flags, etc.) are not needlessly re-executed.
+     *
+     * Prefer this over `invalidateBodyRows` whenever the set of mutated rows is
+     * known (fill, cut, paste, undo/redo).
+     *
+     * @param nodeIds - Node IDs of the rows whose cache entries should be evicted.
+     */
+    invalidateBodyRowsByIds(nodeIds: Set<string>): void;
+    /**
+     * Provides the renderer with a `FilterEngine` reference so it can read the
+     * current filter model and write column filters when the user interacts with
+     * the filter panel.  Called from `GridApi` after construction.
+     */
+    setFilterEngine(engine: FilterEngine): void;
+    /**
+     * Registers a callback that runs the full sort/filter pipeline and triggers
+     * a render whenever the filter state changes from within the panel.
+     * Called from `GridApi` after construction.
+     */
+    setFilterRefreshCallback(fn: () => void): void;
+    /**
+     * Wire the column-group model and header builder into the renderer.
+     *
+     * Must be called **before** the first `mount()` so that `renderInPanels`
+     * can insert group header rows above the leaf row.  Called by `GridCore`
+     * when any top-level `ColumnDef` has a `children` array.
+     *
+     * @param model   - The live tree model.
+     * @param builder - The DOM builder instance.
+     */
+    setColumnGroupModel(model: ColumnGroupModel, builder: ColumnGroupHeaderBuilder): void;
+    /**
+     * Wire the new Display Group Engine into the renderer.
+     *
+     * Creates the drag handler, forwards the engine into `HeaderRenderer`, and
+     * subscribes to the events that trigger header rebuilds.  Must be called
+     * before `mount()` when the grid's column definitions contain groups.
+     *
+     * Takes priority over the legacy `setColumnGroupModel` path.
+     *
+     * @param engine - Fully-initialised `DisplayGroupEngine` instance.
+     */
+    setDisplayGroupEngine(engine: DisplayGroupEngine): void;
+    /**
+     * Opens (or replaces) the floating filter panel for the given column.
+     * Called by `HeaderRenderer` when the user clicks a column's filter icon.
+     *
+     * @param colDef   - Column definition the filter applies to.
+     * @param anchorEl - Filter-icon button element — panel positions below this.
+     */
+    openFilterPanel(colDef: ColumnDef, anchorEl: HTMLElement): void;
+    /**
+     * Extracts unique display value/label pairs for set-type (dropdown / array)
+     * filter panels.  For `dropdown` columns the predefined `dropdownOptions`
+     * are used directly; for other types unique values are scanned from `allRows`.
+     */
+    private extractUniqueOptions;
+    /**
+     * Snapshot current row positions so the next render animates the transition.
+     * Call this **before** any pipeline that reorders or hides rows.
+     *
+     * @param rows - Current visible rows before the pipeline runs.
+     * @param type - `'sort'` (default) or `'filter'` — controls duration and entrance style.
+     */
+    captureRowAnimation(rows: ReadonlyArray<{
+        nodeId: string;
+        top: number;
+    }>, type?: import('./row-animator').RowAnimationType): void;
+    /** Wire up the group-bar search input to an external handler (e.g. api.setQuickFilter). */
+    setSearchCallback(fn: (term: string) => void): void;
+    /**
+     * Wires the Master/Detail engine and nested-grid factory into the renderer.
+     * A no-op when `masterDetail.enabled` was falsy at construction (the
+     * `DetailRowRenderer` instance was never created). Called once from
+     * `GridCore.buildContext`, before `mount()`.
+     */
+    setMasterDetailConfig(engine: MasterDetailEngine, nestedGridFactory: NestedGridFactory, iconRenderer: IconRenderer, themeManager: ThemeManager): void;
+    /**
+     * Late-bound once the owning `GridCore`'s `GridApi` exists — passed through
+     * to `masterDetail.detailRendererFn` as `DetailRendererParams.parentApi`.
+     */
+    setParentApiForDetail(api: unknown): void;
+    /** The nested grid's `GridApi` for an expanded master row, or `undefined`. Backs `GridApi.getDetailGridApi`. */
+    getDetailGridApi(parentNodeId: string): unknown;
+    /**
+     * Wires the callback the Photon AI panel's send button/Enter key invokes —
+     * late-bound once the owning `GridCore`'s `GridApi` (and therefore its
+     * `PhotonAIService`) exists. A no-op when `photonAI.enabled` was falsy at
+     * construction (the panel was never created).
+     */
+    setPhotonAISubmitHandler(fn: (text: string) => PhotonCommandResult): void;
+    /** Programmatic entry point mirroring the panel's own UI — backs `GridApi.submitAICommand`. */
+    submitAICommand(text: string): PhotonCommandResult;
+    /**
+     * Starts the shrink/fade-out animation for `parentNodeId`'s detail row.
+     * Must be called synchronously **before** the pipeline re-runs and removes
+     * the row — see `DetailRowRenderer.beginCollapse` for why the timing matters.
+     */
+    beginDetailCollapse(parentNodeId: string): void;
+    scrollToRow(rowIndex: number): void;
+    scrollToTop(): void;
+    /** Whether the body can still scroll further up. Used by a Master/Detail parent to chain wheel scroll into this grid before forwarding it further up itself. */
+    canScrollUp(): boolean;
+    /** Whether the body can still scroll further down. */
+    canScrollDown(): boolean;
+    /**
+     * Scrolls the grid body (vertically and horizontally) so that the cell at
+     * `rowIndex` / `colIndex` is fully visible — mirrors AG Grid's auto-scroll
+     * behaviour on keyboard navigation.
+     *
+     * - For pinned-left/right columns only vertical scrolling is applied.
+     * - For center columns both axes are adjusted when the cell is out of view.
+     *
+     * @param rowIndex - Index into `visibleRows`
+     * @param colIndex - Index in the flat visible-columns array (left + center + right)
+     */
+    scrollToCell(rowIndex: number, colIndex: number): void;
+    getCellRect(rowIndex: number, colIndex: number): DOMRect | null;
+    enterFullScreen(): void;
+    exitFullScreen(): void;
+    destroy(): void;
+    private buildLayout;
+    /**
+     * Builds the top-level sticky-row layer and its three left/center/right
+     * regions, mirroring the pinned-column layout via the same
+     * `--pg-left-panel-width` / `--pg-right-panel-width` CSS vars the real
+     * panels use — so a stuck row lines up pixel-for-pixel with the columns
+     * it belongs to. The center region gets its own horizontal-scroll
+     * transform so a stuck row's center cells track the user's horizontal
+     * scroll exactly like the real (non-sticky) center panel does.
+     */
+    private buildStickyLayer;
+    private performRender;
+    private subscribeToStore;
+    /**
+     * Called when the user clicks a group collapse/expand toggle.
+     *
+     * When **collapsing**: hides all leaf columns except the first one (the "peek"
+     * column) so the group header continues to show meaningful data.
+     * When **expanding**: restores all leaf columns to visible.
+     *
+     * `setColumnVisible` fires `COLUMNS_STATE_CHANGED` → full rebuild.
+     */
+    private handleGroupToggle;
+    /**
+     * Called when the user drags a group resize handle.
+     * Distributes the new width proportionally among all visible leaf columns.
+     */
+    private handleGroupResize;
+    /**
+     * Re-wires column-group references back into `HeaderRenderer` after
+     * `headerRenderer.destroy()` has cleared them.
+     */
+    private rewireGroupModelIntoHeaderRenderer;
+    /**
+     * Full header rebuild — clears inner HTML and resets the rendered flag so
+     * the next `performRender` call re-runs `renderInPanels` with the current
+     * group model state.
+     */
+    private rebuildHeader;
+    private generateId;
+}
+//# sourceMappingURL=grid-renderer.d.ts.map

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

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