photon-grid-core 0.0.1

package/types/filter.types.d.ts

@@ -0,0 +1,42 @@
+export type FilterOperator = 'contains' | 'notContains' | 'equals' | 'notEquals' | 'startsWith' | 'endsWith' | 'lessThan' | 'lessThanOrEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'inRange' | 'blank' | 'notBlank' | 'before' | 'after' | 'in' | 'notIn';
+export type FilterLogic = 'and' | 'or';
+export type FilterDataType = 'string' | 'number' | 'date' | 'boolean' | 'dropdown' | 'array';
+export interface FilterCondition {
+    operator: FilterOperator;
+    value: unknown;
+    valueTo?: unknown;
+}
+export interface ColumnFilter {
+    colId: string;
+    field: string;
+    type: FilterDataType;
+    logic: FilterLogic;
+    conditions: [FilterCondition] | [FilterCondition, FilterCondition];
+    selectedIds?: (string | number)[];
+    searchTerm?: string;
+}
+export interface FilterModel {
+    [colId: string]: ColumnFilter;
+}
+export interface QuickFilterConfig {
+    term: string;
+    caseSensitive?: boolean;
+    fields?: string[];
+}
+export interface FilterResult<T = Record<string, unknown>> {
+    data: T[];
+    filteredCount: number;
+    totalCount: number;
+}
+/**
+ * A value/label pair used to populate a set-filter checkbox list.
+ * For `dropdown` columns the `value` is the raw option value and `label` is the
+ * display label. For all other set-type columns `value === label`.
+ */
+export interface FilterSetOption {
+    /** Raw cell value used when building the {@link ColumnFilter.selectedIds} array. */
+    value: string;
+    /** Human-readable label rendered in the checkbox list. */
+    label: string;
+}
+//# sourceMappingURL=filter.types.d.ts.map

package/types/filter.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.types.d.ts","sourceRoot":"","sources":["../../src/types/filter.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,aAAa,GACb,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,OAAO,GACP,IAAI,GACJ,OAAO,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,CAAC;AACvC,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7F,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;IACnE,WAAW,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf"}

package/types/filter.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filter.types.js.map

package/types/filter.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.types.js","sourceRoot":"","sources":["../../src/types/filter.types.ts"],"names":[],"mappings":""}

package/types/grid.types.d.ts

@@ -0,0 +1,214 @@
+import type { ColumnDef, ColumnState } from './column.types';
+import type { FilterModel, QuickFilterConfig } from './filter.types';
+import type { BuiltInThemeName } from './theme.types';
+import type { MasterDetailConfig } from './master-detail.types';
+import type { PhotonAIConfig } from './photon-ai.types';
+import type { TreeDataConfig } from './tree-data.types';
+export interface SortConfig {
+    colId: string;
+    field: string;
+    order: 'asc' | 'desc';
+}
+export interface PaginationConfig {
+    enabled: boolean;
+    page: number;
+    pageSize: number;
+    pageSizeOptions: number[];
+    serverSide: boolean;
+    totalRows?: number;
+}
+export interface SelectionConfig {
+    mode: 'single' | 'multiple' | 'none';
+    checkboxSelection: boolean;
+    selectAllOnHeaderClick: boolean;
+    headerCheckbox: boolean;
+    suppressRowDeselection: boolean;
+}
+/**
+ * Configuration for in-cell editing behaviour.
+ *
+ * @example
+ * ```ts
+ * editing: {
+ *   mode: 'cell',
+ *   singleClickEdit: true,
+ *   stopEditingWhenCellsLoseFocus: true,
+ * }
+ * ```
+ */
+export interface EditingConfig {
+    /**
+     * Editing mode for the grid.
+     * - `'cell'`  — individual cells are edited one at a time (default).
+     * - `'row'`   — an entire row enters edit mode together.
+     * - `'none'`  — editing is fully disabled.
+     */
+    mode: 'cell' | 'row' | 'none';
+    /**
+     * When `true`, a **single click** activates the cell editor.
+     * When `false` (default), a **double-click** is required — matching AG Grid default behaviour.
+     */
+    singleClickEdit: boolean;
+    /**
+     * When `true` (default), the active editor commits its value and closes when the
+     * grid loses focus.  Set to `false` to keep the editor open until the user
+     * explicitly confirms (Enter) or cancels (Escape).
+     */
+    stopEditingWhenCellsLoseFocus: boolean;
+}
+export interface RowGroupingConfig {
+    enabled: boolean;
+    groupedColumns: string[];
+    showGroupCount: boolean;
+    defaultExpanded: boolean;
+    suppressAutoSize: boolean;
+}
+export interface VirtualScrollConfig {
+    enabled: boolean;
+    rowBuffer: number;
+    rowHeight: number;
+    dynamicRowHeight: boolean;
+}
+export interface ExportConfig {
+    enabled: boolean;
+    fileName: string;
+    formats: ('csv' | 'xlsx')[];
+    includeHiddenColumns: boolean;
+    processCellValue?: (params: {
+        value: unknown;
+        colDef: ColumnDef;
+    }) => string;
+}
+export interface CellRange {
+    startRowIndex: number;
+    endRowIndex: number;
+    startColIndex: number;
+    endColIndex: number;
+}
+/**
+ * Options controlling the column-group header system.
+ *
+ * All properties are optional and layered on top of per-column group defaults
+ * specified in {@link ColumnDef}.
+ */
+export interface ColumnGroupConfig {
+    /**
+     * When `true`, the multi-row grouped header is rendered.
+     * Set this explicitly when column definitions contain `children` arrays.
+     * @default auto-detected (true if any ColumnDef has `children`)
+     */
+    enabled?: boolean;
+    /**
+     * Default resize strategy applied to every group that does not specify its own.
+     * @default ColumnGroupResizeStrategy.PROPORTIONAL
+     */
+    defaultResizeStrategy?: import('./column.types').ColumnDef['groupResizeStrategy'];
+    /**
+     * Default collapsed-state pixel width for groups that do not set `collapsedWidth`.
+     * @default 26
+     */
+    defaultCollapsedWidth?: number;
+    /**
+     * When `true`, column groups open in collapsed state unless `ColumnDef.openByDefault`
+     * explicitly overrides.  Defaults match AG Grid convention (open by default).
+     * @default false
+     */
+    suppressOpenByDefault?: boolean;
+}
+export interface GridOptions {
+    columns: ColumnDef[];
+    data?: Record<string, unknown>[];
+    theme?: BuiltInThemeName | string;
+    rowHeight?: number;
+    rowHeightMode?: 'fixed' | 'auto';
+    headerRowHeight?: number;
+    footerRowHeight?: number;
+    filterRowHeight?: number;
+    showSerialNumber?: boolean;
+    showCheckboxes?: boolean;
+    showTopBar?: boolean;
+    showFooter?: boolean;
+    showSidePanel?: boolean;
+    showFullScreen?: boolean;
+    showColumnMenu?: boolean;
+    showVerticalBorders?: boolean;
+    showHorizontalBorders?: boolean;
+    showFilterRow?: boolean;
+    rowShading?: boolean;
+    selection?: Partial<SelectionConfig>;
+    editing?: Partial<EditingConfig>;
+    pagination?: Partial<PaginationConfig>;
+    grouping?: Partial<RowGroupingConfig>;
+    virtualScroll?: Partial<VirtualScrollConfig>;
+    exportConfig?: Partial<ExportConfig>;
+    sortConfig?: SortConfig[];
+    filterModel?: FilterModel;
+    quickFilter?: QuickFilterConfig;
+    columnState?: ColumnState[];
+    enableCellSelection?: boolean;
+    enableRangeSelection?: boolean;
+    enableClipboard?: boolean;
+    enableRowDrag?: boolean;
+    enableColumnDrag?: boolean;
+    enableCharts?: boolean;
+    enableFullScreen?: boolean;
+    showGroupingBar?: boolean;
+    /** Column-group header configuration. @see {@link ColumnGroupConfig} */
+    columnGroups?: ColumnGroupConfig;
+    /**
+     * Master/Detail configuration — expandable rows whose detail section is a
+     * fully independent nested Photon Grid instance (or custom content).
+     * @see {@link MasterDetailConfig}
+     */
+    masterDetail?: MasterDetailConfig;
+    /**
+     * Photon AI — a floating, deterministic natural-language command bar for
+     * the grid (sort/filter/pin/hide/group/select), with zero external AI
+     * services. @see {@link PhotonAIConfig}
+     */
+    photonAI?: PhotonAIConfig;
+    /**
+     * Tree Data — self-referential row hierarchy (org charts, file trees,
+     * bills of materials) driven by a `parentId`/`id` pair, nested `children`
+     * arrays, a `getDataPath()` callback, or a custom hierarchy provider.
+     * Mutually exclusive with `grouping` — a grid is either tree-structured or
+     * column-value-grouped, never both at once. @see {@link TreeDataConfig}
+     */
+    treeData?: TreeDataConfig;
+    enableStateManagement?: boolean;
+    stateKey?: string;
+    dateFormat?: string;
+    timeZone?: string;
+    currencySymbol?: string;
+    currencyFormat?: string;
+    locale?: string;
+    loadingOverlayText?: string;
+    noRowsOverlayText?: string;
+    noRowsOverlayHtml?: string;
+    rowClassFn?: (row: Record<string, unknown>, index: number) => string;
+    rowHeightFn?: (row: Record<string, unknown>) => number;
+    suppressScrollOnNewData?: boolean;
+    suppressColumnVirtualisation?: boolean;
+    onReady?: (api: unknown) => void;
+}
+export interface GridState {
+    columnStates: ColumnState[];
+    sortConfig: SortConfig[];
+    filterModel: FilterModel;
+    paginationPage: number;
+    paginationPageSize: number;
+    groupedColumns: string[];
+    expandedGroups: string[];
+    expandedTreeNodeIds: string[];
+    selectedRowIds: string[];
+}
+export interface GridDimensions {
+    containerWidth: number;
+    containerHeight: number;
+    headerHeight: number;
+    bodyHeight: number;
+    footerHeight: number;
+    totalContentHeight: number;
+    totalContentWidth: number;
+}
+//# sourceMappingURL=grid.types.d.ts.map

package/types/grid.types.d.ts.map

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

package/types/grid.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=grid.types.js.map

package/types/grid.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.types.js","sourceRoot":"","sources":["../../src/types/grid.types.ts"],"names":[],"mappings":""}

package/types/master-detail.types.d.ts

@@ -0,0 +1,112 @@
+import type { GridOptions } from './grid.types';
+import type { GridEventType } from './event.types';
+/**
+ * Parameters passed to a {@link MasterDetailConfig.detailRendererFn} custom
+ * detail renderer — the escape hatch used when a detail row should show
+ * arbitrary content instead of a nested Photon Grid instance.
+ */
+export interface DetailRendererParams {
+    /** Raw data of the parent (master) row being expanded. */
+    rowData: Record<string, unknown>;
+    /** Stable node id of the parent row's `RowNode`. */
+    nodeId: string;
+    /** Empty container the renderer must populate. Its size drives auto-height measurement. */
+    containerEl: HTMLElement;
+    /**
+     * The parent grid's `GridApi`. Typed `unknown` here (mirrors
+     * `DisplayRendererParams.api`) to avoid a `types -> core` import cycle —
+     * callers cast to `GridApi` themselves.
+     */
+    parentApi: unknown;
+}
+/**
+ * Master/Detail configuration for a grid instance.
+ *
+ * Enabling this turns qualifying rows into expandable "master" rows whose
+ * detail section is, by default, a fully independent nested Photon Grid
+ * instance — complete with its own sorting, filtering, selection, editing,
+ * clipboard, undo/redo, context menu, row drag, fill handle, and overlay
+ * layer. Because {@link detailGrid} is itself a `GridOptions`, nesting is
+ * unlimited: a detail grid may declare its own `masterDetail` config.
+ *
+ * @example
+ * ```ts
+ * masterDetail: {
+ *   enabled: true,
+ *   toggleColumnId: 'name',
+ *   hasDetail: (row) => row.orderCount > 0,
+ *   getDetailData: (row) => fetchOrders(row.id),
+ *   detailGrid: (row) => ({ columns: orderColumns, rowHeight: 36 }),
+ *   detailMaxHeight: 320,
+ * }
+ * ```
+ */
+export interface MasterDetailConfig {
+    /** Master/Detail is otherwise fully inert — every consumer must opt in explicitly. */
+    enabled: boolean;
+    /**
+     * `colId` of the column that renders the expand/collapse toggle.
+     * Defaults to the first visible column when omitted.
+     */
+    toggleColumnId?: string;
+    /**
+     * Determines whether a given row can be expanded. Rows failing this check
+     * render no toggle icon at all. Defaults to "every row has detail".
+     */
+    hasDetail?: (rowData: Record<string, unknown>) => boolean;
+    /**
+     * Fetches the detail dataset for a row, synchronously or asynchronously.
+     * The resolved array becomes the nested grid's `GridOptions.data`.
+     * When omitted, the nested grid is built with no data (useful when
+     * `detailGrid`/`detailRendererFn` supply data themselves).
+     */
+    getDetailData?: (rowData: Record<string, unknown>) => Record<string, unknown>[] | Promise<Record<string, unknown>[]>;
+    /**
+     * Full configuration for the nested Photon Grid instance — a static
+     * object shared by every detail row, or a per-row factory. `theme` is
+     * inherited from the parent's active theme unless set here explicitly.
+     */
+    detailGrid?: GridOptions | ((rowData: Record<string, unknown>) => GridOptions);
+    /**
+     * Escape hatch for non-grid detail content. When supplied, this takes
+     * priority over {@link detailGrid} — no nested `GridCore` is created.
+     */
+    detailRendererFn?: (params: DetailRendererParams) => HTMLElement;
+    /** Whether newly-encountered rows start expanded. Default `false`. */
+    defaultExpanded?: boolean;
+    /** Lower clamp applied to both auto-measured and manually resized height. */
+    detailMinHeight?: number;
+    /** Upper clamp applied to both auto-measured and manually resized height. Overflow scrolls. */
+    detailMaxHeight?: number;
+    /**
+     * When `true` (default), the detail row's height tracks the nested grid's
+     * rendered content via `ResizeObserver`. When `false`, `detailFixedHeight`
+     * (or a `48px` fallback) is used instead.
+     */
+    detailAutoHeight?: boolean;
+    /** Fixed pixel height used when `detailAutoHeight` is `false`. */
+    detailFixedHeight?: number;
+    /** Shows a drag handle on the detail row's bottom edge letting users resize it manually. Default `false`. */
+    detailResizable?: boolean;
+    /**
+     * When `true` (default), the nested grid is not constructed — and
+     * `getDetailData` is not called — until the row is first expanded.
+     */
+    lazy?: boolean;
+    /**
+     * Event types re-emitted on the parent grid's event bus whenever the
+     * nested grid emits them, or `true` to bubble every event. Payloads are
+     * wrapped as `{ sourceNodeId, event: <original payload> }`. Default: none.
+     */
+    bubbleEvents?: GridEventType[] | boolean;
+    /**
+     * How many collapsed detail rows keep their nested grid instance alive
+     * (rather than destroyed) so re-expanding restores its live state —
+     * sort, column order/width, scroll position, selection — instead of
+     * rebuilding from scratch. Least-recently-collapsed instances beyond this
+     * bound are evicted and destroyed to keep memory use constant regardless
+     * of how many rows a user expands over a session. Default `10`.
+     */
+    keepDetailGridsCount?: number;
+}
+//# sourceMappingURL=master-detail.types.d.ts.map

package/types/master-detail.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-detail.types.d.ts","sourceRoot":"","sources":["../../src/types/master-detail.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,WAAW,EAAE,WAAW,CAAC;IACzB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IAE1D;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAEpE;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,WAAW,CAAC,CAAC;IAE/E;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,WAAW,CAAC;IAEjE,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,6GAA6G;IAC7G,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAEzC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/types/master-detail.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=master-detail.types.js.map

package/types/master-detail.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-detail.types.js","sourceRoot":"","sources":["../../src/types/master-detail.types.ts"],"names":[],"mappings":""}

package/types/photon-ai.types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Configuration for Photon AI — a deterministic natural-language command bar
+ * for the grid. Photon AI is **not** an LLM: it is a rule-based interpreter
+ * that normalizes text, matches it against a registry of known intents, and
+ * translates the result into calls against the existing {@link GridApi} — no
+ * network calls, no external AI services.
+ *
+ * @see {@link PhotonAIService} in `src/photon-ai/photon-ai-service.ts` for the
+ * runtime pipeline this config drives.
+ */
+export interface PhotonAIConfig {
+    /** Photon AI is otherwise fully inert — every consumer must opt in explicitly. */
+    enabled: boolean;
+    /** Placeholder text shown in the empty command input. @default "Ask Photon AI..." */
+    placeholder?: string;
+    /** Whether the panel starts open on grid mount. @default false */
+    defaultOpen?: boolean;
+}
+//# sourceMappingURL=photon-ai.types.d.ts.map

package/types/photon-ai.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai.types.d.ts","sourceRoot":"","sources":["../../src/types/photon-ai.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,OAAO,EAAE,OAAO,CAAC;IAEjB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/types/photon-ai.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=photon-ai.types.js.map

package/types/photon-ai.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-ai.types.js","sourceRoot":"","sources":["../../src/types/photon-ai.types.ts"],"names":[],"mappings":""}

package/types/renderer.types.d.ts

@@ -0,0 +1,156 @@
+import type { AggFunc, ColumnDef, ColumnDropdownOption } from './column.types';
+import type { ColumnFilter, FilterSetOption } from './filter.types';
+import type { RowNode } from './row.types';
+/**
+ * Identifies one customizable rendering concern on a column.
+ *
+ * Used internally wherever a slot needs to be looked up generically (e.g.
+ * {@link resolveColumnRenderer}) instead of by a hardcoded property access,
+ * so new slots can be added without touching every call site.
+ */
+export declare enum RendererSlot {
+    Display = "display",
+    Editor = "editor",
+    Option = "option",
+    Filter = "filter",
+    Tooltip = "tooltip",
+    Group = "group",
+    Header = "header",
+    Summary = "summary"
+}
+/**
+ * Anything a renderer slot may return: a ready-made element to append, or an
+ * HTML string to be assigned via `innerHTML` (mirrors how the grid has always
+ * accepted string output from custom renderers).
+ */
+export type RendererOutput = HTMLElement | string;
+/** Params passed to {@link ColumnRendererMap.display} — how a data cell's value is drawn. */
+export interface DisplayRendererParams {
+    value: unknown;
+    rawValue: unknown;
+    row: Record<string, unknown>;
+    colDef: ColumnDef;
+    rowIndex: number;
+    colIndex: number;
+    api: unknown;
+}
+/**
+ * Params passed to {@link ColumnRendererMap.editor} — how a cell's edit widget is built.
+ *
+ * The renderer owns its own input element(s) entirely; it must call
+ * `onValueChange` as the user edits and `onEditStop` to commit and close the
+ * editor (e.g. on blur or Enter). The grid handles validation, undo/redo, and
+ * DOM teardown the same way it does for built-in editors.
+ */
+export interface EditorRendererParams {
+    value: unknown;
+    row: Record<string, unknown>;
+    colDef: ColumnDef;
+    rowIndex: number;
+    onValueChange: (newValue: unknown) => void;
+    onEditStop: () => void;
+}
+/**
+ * Params passed to {@link ColumnRendererMap.option} — one row in a dropdown/select
+ * option list. Used both by the cell editor's option list and by the default
+ * filter panel's set-filter checkbox list, so one `option` renderer covers
+ * both surfaces consistently (e.g. a flag icon next to a country name).
+ */
+export interface OptionRendererParams {
+    option: ColumnDropdownOption;
+    index: number;
+    selected: boolean;
+    highlighted: boolean;
+    colDef: ColumnDef;
+    api: unknown;
+}
+/**
+ * Params passed to {@link ColumnRendererMap.filter} — the full filter panel body for a column.
+ *
+ * A custom filter renderer is responsible for its own apply/clear affordances;
+ * it should call `onFilterChange` whenever the effective filter changes (or
+ * `null` to clear it) and `onClose` when it should be dismissed.
+ */
+export interface FilterRendererParams {
+    colDef: ColumnDef;
+    anchorEl: HTMLElement;
+    currentFilter: ColumnFilter | null;
+    uniqueOptions: FilterSetOption[];
+    onFilterChange: (filter: ColumnFilter | null) => void;
+    onClose: () => void;
+    api: unknown;
+}
+/** Params passed to {@link ColumnRendererMap.tooltip} — content shown when hovering a cell. */
+export interface TooltipRendererParams {
+    value: unknown;
+    rawValue: unknown;
+    row: Record<string, unknown>;
+    colDef: ColumnDef;
+    rowIndex: number;
+    colIndex: number;
+    api: unknown;
+}
+/**
+ * Params passed to {@link ColumnRendererMap.group} — the label content of a
+ * group-header row for the column currently being grouped by.
+ *
+ * Only the label is replaced; the expand/collapse toggle button remains the
+ * grid's default so grouping interaction always keeps working.
+ */
+export interface GroupRendererParams {
+    row: RowNode;
+    colDef: ColumnDef;
+    groupValue: unknown;
+    childCount: number;
+    collapsed: boolean;
+    api: unknown;
+}
+/** Params passed to {@link ColumnRendererMap.header} — a column header cell's content. */
+export interface HeaderRendererParams {
+    colDef: ColumnDef;
+    sortOrder: 'asc' | 'desc' | null;
+    filterActive: boolean;
+    api: unknown;
+}
+/** Params passed to {@link ColumnRendererMap.summary} — an aggregate/summary cell's content. */
+export interface SummaryRendererParams {
+    colDef: ColumnDef;
+    value: unknown;
+    aggregation: AggFunc;
+    label?: string;
+    api: unknown;
+}
+/**
+ * Per-column rendering overrides, grouped by concern.
+ *
+ * Every slot is independently optional — an absent slot falls back to Photon
+ * Grid's built-in rendering for that concern, so columns can override just
+ * one aspect (e.g. only `display`) without having to reimplement the rest.
+ *
+ * Each slot's contract is a plain function returning `HTMLElement | string`,
+ * which keeps the core framework-agnostic: a future React/Angular/Vue wrapper
+ * package can implement any slot by mounting a component/template into a
+ * detached container and returning it, with no changes required here.
+ *
+ * @example
+ * ```ts
+ * const countryColumn: ColumnDef = {
+ *   colId: 'country', field: 'country', header: 'Country', type: 'dropdown',
+ *   renderer: {
+ *     display: ({ value }) => `<span class="flag">${value}</span>`,
+ *     option: ({ option }) => `<span class="flag">${option.label}</span>`,
+ *   },
+ * };
+ * ```
+ */
+export interface ColumnRendererMap {
+    display?: (params: DisplayRendererParams) => RendererOutput;
+    editor?: (params: EditorRendererParams) => HTMLElement;
+    option?: (params: OptionRendererParams) => RendererOutput;
+    filter?: (params: FilterRendererParams) => HTMLElement;
+    tooltip?: (params: TooltipRendererParams) => RendererOutput;
+    group?: (params: GroupRendererParams) => RendererOutput;
+    header?: (params: HeaderRendererParams) => RendererOutput;
+    summary?: (params: SummaryRendererParams) => RendererOutput;
+}
+//# sourceMappingURL=renderer.types.d.ts.map

package/types/renderer.types.d.ts.map

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

package/types/renderer.types.js

@@ -0,0 +1,19 @@
+/**
+ * Identifies one customizable rendering concern on a column.
+ *
+ * Used internally wherever a slot needs to be looked up generically (e.g.
+ * {@link resolveColumnRenderer}) instead of by a hardcoded property access,
+ * so new slots can be added without touching every call site.
+ */
+export var RendererSlot;
+(function (RendererSlot) {
+    RendererSlot["Display"] = "display";
+    RendererSlot["Editor"] = "editor";
+    RendererSlot["Option"] = "option";
+    RendererSlot["Filter"] = "filter";
+    RendererSlot["Tooltip"] = "tooltip";
+    RendererSlot["Group"] = "group";
+    RendererSlot["Header"] = "header";
+    RendererSlot["Summary"] = "summary";
+})(RendererSlot || (RendererSlot = {}));
+//# sourceMappingURL=renderer.types.js.map

package/types/renderer.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.types.js","sourceRoot":"","sources":["../../src/types/renderer.types.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;IACjB,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,+BAAe,CAAA;IACf,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;AACrB,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB"}