photon-grid-angular 0.0.1

package/fesm2022/photon-grid-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-grid-angular.mjs","sources":["../../src/library/angular-renderer.types.ts","../../src/library/angular-renderer.adapter.ts","../../src/library/photon-grid.component.ts","../../src/library/photon-grid.module.ts","../../src/public-api.ts","../../src/photon-grid-angular.ts"],"sourcesContent":["import type { TemplateRef, Type } from '@angular/core';\r\n\r\nimport type {\r\n    ColumnDef as coreColumnDef,\r\n    DisplayRendererParams,\r\n    EditorRendererParams,\r\n    FilterRendererParams,\r\n    GroupRendererParams,\r\n    HeaderRendererParams,\r\n    OptionRendererParams,\r\n    RendererOutput,\r\n    SummaryRendererParams,\r\n    TooltipRendererParams,\r\n} from 'photon-grid-core';\r\n \r\n/**\r\n * Renders `params` through a `@Component`.\r\n *\r\n * A **new** component instance is created every time the core invokes the\r\n * renderer (it has no concept of \"update\", only \"produce output for these\r\n * params\"). `inputs` is re-evaluated on every mount and applied via\r\n * `ComponentRef.setInput` before the first change-detection pass, so the\r\n * component sees the current params as its initial `@Input()`s.\r\n */\r\nexport interface ComponentRendererSpec<TParams, TComponent = unknown> {\r\n    readonly kind: 'component';\r\n    readonly component: Type<TComponent>;\r\n    /** Maps renderer params to the component's `@Input()` bag. */\r\n    readonly inputs?: (params: TParams) => Partial<TComponent> & Record<string, unknown>;\r\n}\r\n\r\n/** Context handed to an `<ng-template>` used as a renderer. */\r\nexport interface RendererContext<TParams> {\r\n    /** Enables `let-x` / implicit `let-params` template syntax. */\r\n    $implicit: TParams;\r\n    params: TParams;\r\n    [key: string]: unknown;\r\n}\r\n\r\n/**\r\n * Renders `params` through an `<ng-template>` (obtained via `@ViewChild`).\r\n *\r\n * Prefer a single root element in the template for `editor` / `filter`\r\n * slots: the core treats the returned `HTMLElement` as the interactive\r\n * control itself (e.g. it may call `.focus()` on it), and a multi-root\r\n * template gets wrapped in a synthetic `<div>` host that breaks that\r\n * assumption.\r\n */\r\nexport interface TemplateRendererSpec<TParams> {\r\n    readonly kind: 'template';\r\n    readonly template: TemplateRef<RendererContext<TParams>>;\r\n    readonly context?: (params: TParams) => Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * A renderer slot accepts either:\r\n * - a declarative spec (`{ kind: 'component' | 'template', ... }`), or\r\n * - a plain function, for consumers who want to keep producing raw\r\n *   `HTMLElement`/`string` output (identical to the framework-agnostic core API).\r\n */\r\nexport type CellRenderer<TParams, TOutput> =\r\n    | ComponentRendererSpec<TParams>\r\n    | TemplateRendererSpec<TParams>\r\n    | Type<unknown>\r\n    | TemplateRef<RendererContext<TParams>>\r\n    | ((params: TParams) => TOutput);\r\n\r\nexport interface ColumnRendererMap {\r\n    display?: CellRenderer<DisplayRendererParams, RendererOutput>;\r\n    editor?: CellRenderer<EditorRendererParams, HTMLElement>;\r\n    option?: Type<any> | TemplateRef<any> | ((params: OptionRendererParams) => HTMLElement);\r\n    filter?: CellRenderer<FilterRendererParams, HTMLElement>;\r\n    tooltip?: CellRenderer<TooltipRendererParams, RendererOutput>;\r\n    group?: CellRenderer<GroupRendererParams, RendererOutput>;\r\n    header?: CellRenderer<HeaderRendererParams, RendererOutput>;\r\n    summary?: CellRenderer<SummaryRendererParams, RendererOutput>;\r\n}\r\n\r\n/**\r\n * Drop-in replacement for `ColumnDef`: identical shape, except `renderer`\r\n * (and `renderer` on any nested `children`) accepts the declarative\r\n * component/template specs above in addition to plain functions.\r\n */\r\nexport type ColumnDef = Omit<coreColumnDef, 'renderer' | 'children'> & {\r\n    renderer?: ColumnRendererMap;\r\n    children?: ColumnDef[];\r\n};\r\n\r\n/** Narrowing helpers used by the adapter (and usable by consumers/tests). */\r\nexport function isComponentRendererSpec(\r\n    value: unknown,\r\n): value is ComponentRendererSpec<unknown> {\r\n    return !!value && typeof value === 'object' && (value as { kind?: unknown }).kind === 'component';\r\n}\r\n\r\nexport function isTemplateRendererSpec(\r\n    value: unknown,\r\n): value is TemplateRendererSpec<unknown> {\r\n    return !!value && typeof value === 'object' && (value as { kind?: unknown }).kind === 'template';\r\n}","import {\r\n    ApplicationRef,\r\n    ComponentRef,\r\n    EmbeddedViewRef,\r\n    EnvironmentInjector,\r\n    Injector,\r\n    TemplateRef,\r\n    createComponent,\r\n} from '@angular/core';\r\n\r\nimport type { ColumnDef, RendererOutput } from 'photon-grid-core';\r\n\r\nimport {\r\n    CellRenderer,\r\n    ColumnRendererMap,\r\n    ColumnDef as GridColumnDef,\r\n    RendererContext,\r\n    isComponentRendererSpec,\r\n    isTemplateRendererSpec,\r\n} from './angular-renderer.types';\r\n\r\ntype RendererMount =\r\n    | { readonly kind: 'component'; readonly ref: ComponentRef<unknown> }\r\n    | { readonly kind: 'template'; readonly ref: EmbeddedViewRef<unknown> };\r\n\r\ntype GridLifecycleMethod = 'pgGridInit' | 'pgGridRefresh' | 'pgGridDestroy';\r\n\r\n/**\r\n * Bridges the framework-agnostic `ColumnRendererMap` (plain functions\r\n * returning `HTMLElement | string`) to Angular components and templates.\r\n *\r\n * One instance is owned per `<photon-grid>` and lives for the component's\r\n * lifetime: {@link adaptColumns} is called whenever columns are (re)supplied,\r\n * and {@link dispose} is called once, in `ngOnDestroy`, to guarantee nothing\r\n * outlives the host component.\r\n *\r\n * ### Why a MutationObserver\r\n * The core owns cell/row virtualization and recycling; it has no lifecycle\r\n * hook that tells us \"this cell's DOM node is gone, destroy whatever you\r\n * mounted into it\". Since every renderer invocation mounts a *fresh*\r\n * component/embedded view (the core's contract is \"produce output for these\r\n * params\", not \"patch existing output\"), the only reliable place to catch\r\n * disposal is watching the DOM itself: when the core removes/replaces a\r\n * mounted host element, a MutationObserver on the grid root sees it and we\r\n * destroy the corresponding Angular view right then. This is what keeps\r\n * scrolling/virtualized grids from leaking components.\r\n */\r\nexport class RendererAdapter {\r\n    /** Host element -> live Angular view mounted into it. */\r\n    private readonly mounts = new Map<HTMLElement, RendererMount>();\r\n\r\n    private observer?: MutationObserver;\r\n\r\n    constructor(\r\n        private readonly appRef: ApplicationRef,\r\n        private readonly environmentInjector: EnvironmentInjector,\r\n        private readonly elementInjector: Injector,\r\n    ) {}\r\n\r\n    /**\r\n     * Starts watching `root` for node removals so mounted views can be torn\r\n     * down as soon as the core discards their host element. Safe to call\r\n     * repeatedly (e.g. across grid recreation) — any previous observer is\r\n     * disconnected first, but existing mounts are left untouched.\r\n     */\r\n    observe(root: HTMLElement): void {\r\n        this.observer?.disconnect();\r\n\r\n        this.observer = new MutationObserver((mutations) => {\r\n            // Bounded by the number of *currently mounted* renderer views\r\n            // (i.e. visible custom cells), not by row/data-set size, because\r\n            // virtualization keeps that number small regardless of grid size.\r\n            if (this.mounts.size === 0) {\r\n                return;\r\n            }\r\n            for (const mutation of mutations) {\r\n                mutation.removedNodes.forEach((node) => this.cleanupRemovedNode(node));\r\n            }\r\n        });\r\n\r\n        this.observer.observe(root, { childList: true, subtree: true });\r\n    }\r\n\r\n    /** Recursively converts `GridColumnDef[]` into plain `ColumnDef[]`. */\r\n    adaptColumns(columns: readonly GridColumnDef[]): ColumnDef[] {\r\n        return columns.map((column) => this.adaptColumn(column));\r\n    }\r\n\r\n    /**\r\n     * Destroys every currently-mounted component/embedded view and stops\r\n     * observing. Call exactly once, when the owning grid is torn down.\r\n     * Deliberately unconditional (does not wait on the MutationObserver):\r\n     * `disconnect()` drops any in-flight mutation records, so relying on it\r\n     * for final teardown would risk leaking whatever hadn't been flushed yet.\r\n     */\r\n    dispose(): void {\r\n        this.observer?.disconnect();\r\n        this.observer = undefined;\r\n\r\n        for (const [element, mount] of this.mounts) {\r\n            this.destroyMount(mount);\r\n            this.mounts.delete(element);\r\n        }\r\n    }\r\n\r\n    private adaptColumn(column: GridColumnDef): ColumnDef {\r\n        const { renderer, children, ...rest } = column;\r\n        const adapted = { ...rest } as ColumnDef;\r\n\r\n        if (renderer) {\r\n            // Adapted per-slot (rather than via a generic loop over the\r\n            // slot names) so each call keeps its own TParams/TOutput pair —\r\n            // looping over a union of keys would force `adaptRenderer` to\r\n            // accept the union of every slot's renderer type at once, which\r\n            // doesn't type-check (an EditorRendererParams renderer isn't\r\n            // assignable where a TooltipRendererParams renderer is expected).\r\n            const adaptedRenderer: Partial<ColumnRendererMap> = {\r\n                display: this.adaptRenderer(renderer.display),\r\n                editor: this.adaptRenderer(renderer.editor),\r\n                option: this.adaptRenderer(renderer.option),\r\n                filter: this.adaptRenderer(renderer.filter),\r\n                tooltip: this.adaptRenderer(renderer.tooltip),\r\n                group: this.adaptRenderer(renderer.group),\r\n                header: this.adaptRenderer(renderer.header),\r\n                summary: this.adaptRenderer(renderer.summary),\r\n            };\r\n            adapted.renderer = adaptedRenderer as any;\r\n        }\r\n\r\n        if (children) {\r\n            adapted.children = children.map((child) => this.adaptColumn(child));\r\n        }\r\n\r\n        return adapted;\r\n    }\r\n\r\n    private adaptRenderer<TParams, TOutput extends RendererOutput | HTMLElement>(\r\n        renderer: CellRenderer<TParams, TOutput> | undefined,\r\n    ): ((params: TParams) => TOutput) | undefined {\r\n        if (!renderer) {\r\n            return undefined;\r\n        }\r\n\r\n        if (isComponentRendererSpec(renderer)) {\r\n            return (params: TParams) => this.mountComponent(renderer, params) as unknown as TOutput;\r\n        }\r\n\r\n        if (isTemplateRendererSpec(renderer)) {\r\n            return (params: TParams) => this.mountTemplate(renderer, params) as unknown as TOutput;\r\n        }\r\n\r\n        if (renderer instanceof TemplateRef) {\r\n            return (params: TParams) => this.mountTemplate({ template: renderer }, params) as unknown as TOutput;\r\n        }\r\n\r\n        if (this.isComponentType(renderer)) {\r\n            return (params: TParams) => this.mountComponent({ component: renderer }, params) as unknown as TOutput;\r\n        }\r\n\r\n        if (typeof renderer === 'function') {\r\n            return renderer;\r\n        }\r\n\r\n        return undefined;\r\n    }\r\n\r\n    private isComponentType(value: unknown): value is import('@angular/core').Type<unknown> {\r\n        return typeof value === 'function' && !!(value as { readonly ɵcmp?: unknown }).ɵcmp;\r\n    }\r\n\r\n    private mountComponent<TParams>(\r\n        spec: { component: import('@angular/core').Type<unknown>; inputs?: (params: TParams) => Record<string, unknown> },\r\n        params: TParams,\r\n    ): HTMLElement {\r\n        const componentRef = createComponent(spec.component, {\r\n            environmentInjector: this.environmentInjector,\r\n            elementInjector: this.elementInjector,\r\n        });\r\n\r\n        const normalizedParams = this.normalizeRendererParams(params);\r\n        const inputs = spec.inputs ? spec.inputs(normalizedParams) : this.inferInputs(componentRef, normalizedParams);\r\n        for (const [key, value] of Object.entries(inputs)) {\r\n            this.setComponentInput(componentRef, key, value);\r\n        }\r\n\r\n        this.setComponentInput(componentRef, 'params', normalizedParams);\r\n\r\n        // Attaching to ApplicationRef is what makes this component\r\n        // participate in normal change detection (zone triggers, async\r\n        // pipe, etc.) for as long as it stays mounted — required for any\r\n        // interactivity inside the component itself (clicks, forms, ...).\r\n        this.appRef.attachView(componentRef.hostView);\r\n        componentRef.changeDetectorRef.detectChanges();\r\n\r\n        this.invokeLifecycle(componentRef.instance, 'pgGridInit', normalizedParams);\r\n        this.invokeLifecycle(componentRef.instance, 'pgGridRefresh', normalizedParams);\r\n\r\n        const element = componentRef.location.nativeElement as HTMLElement;\r\n        this.mounts.set(element, { kind: 'component', ref: componentRef });\r\n        return element;\r\n    }\r\n\r\n    private setComponentInput<TComponent>(\r\n        componentRef: ComponentRef<TComponent>,\r\n        key: string,\r\n        value: unknown,\r\n    ): void {\r\n        try {\r\n            componentRef.setInput(key, value);\r\n            return;\r\n        } catch {\r\n            const instance = componentRef.instance as Record<string, unknown>;\r\n            instance[key] = value;\r\n        }\r\n    }\r\n\r\n    private normalizeRendererParams<TParams>(params: TParams): TParams & { value?: unknown; rawValue?: unknown } {\r\n        const normalized = { ...(params as Record<string, unknown>) };\r\n        const option = normalized['option'];\r\n\r\n        if (normalized['value'] === undefined && option && typeof option === 'object') {\r\n            const optionValue = (option as { value?: unknown }).value;\r\n            normalized['value'] = optionValue;\r\n            normalized['rawValue'] = optionValue;\r\n        }\r\n\r\n        return normalized as TParams & { value?: unknown; rawValue?: unknown };\r\n    }\r\n\r\n    private inferInputs<TComponent, TParams>(\r\n        componentRef: ComponentRef<TComponent>,\r\n        params: TParams,\r\n    ): Record<string, unknown> {\r\n        const instance = componentRef.instance as Record<string, unknown>;\r\n        const inputs: Record<string, unknown> = {};\r\n        const paramBag = params as Record<string, unknown>;\r\n        const row = paramBag['row'] && typeof paramBag['row'] === 'object'\r\n            ? paramBag['row'] as Record<string, unknown>\r\n            : undefined;\r\n\r\n        for (const key of Object.keys(instance)) {\r\n            if (key === '__ngContext__' || key === 'constructor') {\r\n                continue;\r\n            }\r\n\r\n            if (paramBag[key] !== undefined) {\r\n                inputs[key] = paramBag[key];\r\n                continue;\r\n            }\r\n\r\n            if (row && row[key] !== undefined) {\r\n                inputs[key] = row[key];\r\n                continue;\r\n            }\r\n\r\n            if (key === 'seed' && row && row['id'] !== undefined) {\r\n                inputs[key] = row['id'];\r\n                continue;\r\n            }\r\n\r\n            if (key === 'value' && paramBag['value'] !== undefined) {\r\n                inputs[key] = paramBag['value'];\r\n            }\r\n        }\r\n\r\n        return inputs;\r\n    }\r\n\r\n    private invokeLifecycle<TParams>(\r\n        instance: unknown,\r\n        lifecycle: GridLifecycleMethod,\r\n        params: TParams,\r\n    ): void {\r\n        const candidate = (instance as Record<string, unknown> | null)?.[lifecycle];\r\n        if (typeof candidate === 'function') {\r\n            (candidate as (params: TParams) => void).call(instance, params);\r\n        }\r\n    }\r\n\r\n    private mountTemplate<TParams>(\r\n        spec: {\r\n            template: import('@angular/core').TemplateRef<RendererContext<TParams>>;\r\n            context?: (params: TParams) => Record<string, unknown>;\r\n        },\r\n        params: TParams,\r\n    ): HTMLElement {\r\n        const normalizedParams = this.normalizeRendererParams(params);\r\n        const context = {\r\n            $implicit: normalizedParams,\r\n            params: normalizedParams,\r\n            ...(spec.context ? spec.context(normalizedParams) : {}),\r\n        };\r\n\r\n        const viewRef = spec.template.createEmbeddedView(context);\r\n        this.appRef.attachView(viewRef);\r\n        viewRef.detectChanges();\r\n\r\n        const host = this.resolveTemplateHost(viewRef);\r\n        this.mounts.set(host, { kind: 'template', ref: viewRef });\r\n        return host;\r\n    }\r\n\r\n    /**\r\n     * Uses the template's single root element directly when possible (so\r\n     * `editor`/`filter` slots that expect the returned element to *be* the\r\n     * control keep working); falls back to a wrapper `<div>` for templates\r\n     * with multiple root nodes or text-only content.\r\n     */\r\n    private resolveTemplateHost(viewRef: EmbeddedViewRef<unknown>): HTMLElement {\r\n        const [singleRoot] = viewRef.rootNodes;\r\n        if (viewRef.rootNodes.length === 1 && singleRoot instanceof HTMLElement) {\r\n            return singleRoot;\r\n        }\r\n\r\n        const host = document.createElement('div');\r\n        host.classList.add('photon-grid__template-host');\r\n        host.append(...viewRef.rootNodes);\r\n        return host;\r\n    }\r\n\r\n    private cleanupRemovedNode(node: Node): void {\r\n        if (!(node instanceof HTMLElement)) {\r\n            return;\r\n        }\r\n\r\n        const directMount = this.mounts.get(node);\r\n        if (directMount) {\r\n            this.mounts.delete(node);\r\n            this.destroyMount(directMount);\r\n        }\r\n\r\n        // The core may remove an ancestor (e.g. an entire recycled row)\r\n        // rather than the mounted element itself; sweep for any tracked\r\n        // host contained in the removed subtree.\r\n        if (node.childElementCount === 0) {\r\n            return;\r\n        }\r\n        for (const [element, mount] of this.mounts) {\r\n            if (node.contains(element)) {\r\n                this.mounts.delete(element);\r\n                this.destroyMount(mount);\r\n            }\r\n        }\r\n    }\r\n\r\n    private destroyMount(mount: RendererMount): void {\r\n        if (mount.kind === 'component') {\r\n            this.invokeLifecycle(mount.ref.instance, 'pgGridDestroy', undefined);\r\n            const viewRef = mount.ref.hostView;\r\n            this.appRef.detachView(viewRef);\r\n            mount.ref.destroy();\r\n            return;\r\n        }\r\n\r\n        const viewRef = mount.ref;\r\n        this.appRef.detachView(viewRef);\r\n        mount.ref.destroy();\r\n    }\r\n}","import {\n    AfterViewInit,\n    ApplicationRef,\n    ChangeDetectionStrategy,\n    Component,\n    ElementRef,\n    EnvironmentInjector,\n    EventEmitter,\n    Injector,\n    Input,\n    OnChanges,\n    OnDestroy,\n    Output,\n    SimpleChanges,\n    ViewChild,\n} from '@angular/core';\n\nimport { GridCore, GridEventType } from 'photon-grid-core';\n\nimport type {\n    CellClickedEvent,\n    CellSelectionChangedEvent,\n    CellValueChangedEvent,\n    ColumnMovedEvent,\n    ColumnResizedEvent,\n    ColumnsStateChangedEvent,\n    ColumnSortedEvent,\n    DataChangedEvent,\n    ExportEvent,\n    FilterChangedEvent,\n    GridApi,\n    GridEventMap,\n    GridOptions,\n    PageChangedEvent,\n    RowClickPayload,\n    RowSelectedEvent,\n    ThemeChangedEvent,\n} from 'photon-grid-core';\n\nimport { RendererAdapter } from './angular-renderer.adapter';\nimport type {ColumnDef as GridColumnDef } from './angular-renderer.types';\n\n/**\n * Angular wrapper around the framework-agnostic Photon Grid core.\n *\n * The component owns a single {@link GridCore} instance, keeps it in sync\n * with the `columns`, `dataSet` and `options` inputs, and re-emits the\n * grid's internal events as strongly-typed Angular `@Output`s.\n *\n * Cell/header/editor/etc. renderers may be plain functions (raw\n * `HTMLElement`/`string`, identical to the core's own API), or declarative\n * Angular specs — `{ kind: 'component', component: MyBadge }` or\n * `{ kind: 'template', template: myTemplateRef }` — via {@link GridColumnDef}.\n * An internal {@link RendererAdapter} mounts/unmounts those for every\n * renderer invocation and disposes them as soon as the core discards their\n * host element, so virtualization/recycling never leaks components.\n *\n * @example\n * ```html\n * <photon-grid\n *   [columns]=\"columns\"\n *   [dataSet]=\"rows\"\n *   [options]=\"{ theme: 'light', showCheckboxes: true }\"\n *   (gridReady)=\"onReady($event)\"\n *   (rowClicked)=\"onRowClicked($event)\">\n * </photon-grid>\n * ```\n *\n * @example Component-based cell renderer\n * ```ts\n * columns: GridColumnDef[] = [{\n *   colId: 'status', field: 'status', header: 'Status', type: 'string',\n *   renderer: {\n *     display: {\n *       kind: 'component',\n *       component: StatusBadgeComponent,\n *       inputs: (params) => ({ value: params.value }),\n *     },\n *   },\n * }];\n * ```\n *\n * @example Template-based cell renderer\n * ```html\n * <ng-template #statusTpl let-params>\n *   <span class=\"badge\">{{ params.value }}</span>\n * </ng-template>\n * ```\n * ```ts\n * @ViewChild('statusTpl') statusTpl!: TemplateRef<RendererContext<DisplayRendererParams>>;\n * columns: GridColumnDef[] = [{\n *   colId: 'status', field: 'status', header: 'Status', type: 'string',\n *   renderer: { display: { kind: 'template', template: this.statusTpl } },\n * }];\n * ```\n */\n@Component({\n    selector: 'photon-grid',\n    standalone: true,\n    template: `<div #gridHost class=\"photon-grid__host\"></div>`,\n    styleUrl: './photon-grid.component.scss',\n    changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class PhotonGridComponent implements AfterViewInit, OnChanges, OnDestroy {\n\n    /** Container the grid renders into. */\n    @ViewChild('gridHost', { static: true, read: ElementRef })\n    private readonly gridHost!: ElementRef<HTMLDivElement>;\n\n    /**\n     * Column definitions. Bound to {@link GridApi.setColumns} on change.\n     * Provided as a dedicated input rather than through `options.columns`.\n     * Renderer slots accept Angular components/templates in addition to\n     * plain functions — see {@link GridColumnDef}.\n     */\n    @Input()\n    columns: GridColumnDef[] = [];\n\n    /**\n     * Row data. Bound to {@link GridApi.setData} on change. Provided as a\n     * dedicated input rather than through `options.data`.\n     */\n    @Input()\n    dataSet: Record<string, unknown>[] = [];\n\n    /**\n     * Remaining grid options (theme, selection, editing, pagination, …).\n     * `columns` and `data` are supplied by the dedicated inputs above and are\n     * merged in automatically. The core has no runtime options setter, so a\n     * change to this input transparently recreates the grid.\n     */\n    @Input()\n    options: Partial<GridOptions> = {};\n\n    /** Emitted once the grid is constructed, carrying its {@link GridApi}. */\n    @Output() readonly gridReady = new EventEmitter<GridApi>();\n\n    /** Row data changed (count delta). */\n    @Output() readonly dataChanged = new EventEmitter<DataChangedEvent>();\n\n    /** A row was clicked. */\n    @Output() readonly rowClicked = new EventEmitter<RowClickPayload>();\n\n    /** A row was double-clicked. */\n    @Output() readonly rowDoubleClicked = new EventEmitter<RowClickPayload>();\n\n    /** Row selection changed. */\n    @Output() readonly rowSelected = new EventEmitter<RowSelectedEvent>();\n\n    /** A cell was clicked. */\n    @Output() readonly cellClicked = new EventEmitter<CellClickedEvent>();\n\n    /** A cell was double-clicked. */\n    @Output() readonly cellDoubleClicked = new EventEmitter<CellClickedEvent>();\n\n    /** A cell value was committed. */\n    @Output() readonly cellValueChanged = new EventEmitter<CellValueChangedEvent>();\n\n    /** Range/cell selection changed. */\n    @Output() readonly cellSelectionChanged = new EventEmitter<CellSelectionChangedEvent>();\n\n    /** A column was resized. */\n    @Output() readonly columnResized = new EventEmitter<ColumnResizedEvent>();\n\n    /** A column was reordered. */\n    @Output() readonly columnMoved = new EventEmitter<ColumnMovedEvent>();\n\n    /** Sort state changed. */\n    @Output() readonly sortChanged = new EventEmitter<ColumnSortedEvent>();\n\n    /** Filter model changed. */\n    @Output() readonly filterChanged = new EventEmitter<FilterChangedEvent>();\n\n    /** Pagination page or size changed. */\n    @Output() readonly pageChanged = new EventEmitter<PageChangedEvent>();\n\n    /** Column state (width/visibility/pin/order) changed. */\n    @Output() readonly columnsStateChanged = new EventEmitter<ColumnsStateChangedEvent>();\n\n    /** Active theme changed. */\n    @Output() readonly themeChanged = new EventEmitter<ThemeChangedEvent>();\n\n    /** An export finished. */\n    @Output() readonly exportComplete = new EventEmitter<ExportEvent>();\n\n    /** The live core instance, created in {@link ngAfterViewInit}. */\n    private grid?: GridCore;\n\n    /** Unsubscribe callbacks for every wired core event; drained on teardown. */\n    private readonly disposers: Array<() => void> = [];\n\n    /**\n     * Bridges Angular component/template renderer specs to the core's\n     * plain-function `ColumnRendererMap`. Owned for the lifetime of this\n     * component (not DI-provided) so its mounted-view tracking is scoped\n     * to this grid instance alone.\n     *\n     * Built explicitly in the constructor body (rather than as a field\n     * initializer referencing constructor-parameter properties) so it isn't\n     * subject to field-initializer-vs-parameter-property ordering: at this\n     * point `appRef`/`environmentInjector`/`elementInjector` are plain local\n     * constructor arguments, guaranteed to already be set.\n     */\n    private readonly rendererAdapter: RendererAdapter;\n\n    constructor(\n        appRef: ApplicationRef,\n        environmentInjector: EnvironmentInjector,\n        elementInjector: Injector,\n    ) {\n        this.rendererAdapter = new RendererAdapter(appRef, environmentInjector, elementInjector);\n    }\n\n    ngAfterViewInit(): void {\n        this.createGrid();\n    }\n\n    ngOnChanges(changes: SimpleChanges): void {\n        // Initial inputs are consumed by createGrid() in ngAfterViewInit.\n        if (!this.grid) {\n            return;\n        }\n\n        // An options change cannot be applied incrementally (no core setter),\n        // so recreate; this already re-seeds columns and data.\n        if (changes['options'] && !changes['options'].firstChange) {\n            this.recreateGrid();\n            return;\n        }\n\n        if (changes['columns'] && !changes['columns'].firstChange) {\n            this.grid.api.setColumns(this.rendererAdapter.adaptColumns(this.columns));\n        }\n\n        if (changes['dataSet'] && !changes['dataSet'].firstChange) {\n            this.grid.api.setData(this.dataSet);\n        }\n    }\n\n    ngOnDestroy(): void {\n        this.teardownGrid();\n    }\n\n    /** Builds the core from the current inputs and wires its events. */\n    private createGrid(): void {\n        // Must be observing *before* the core mounts anything, so every\n        // renderer-produced element is tracked for cleanup from the start.\n        this.rendererAdapter.observe(this.gridHost.nativeElement);\n\n        const mergedOptions: GridOptions = {\n            ...this.options,\n            columns: this.rendererAdapter.adaptColumns(this.columns),\n            data: this.dataSet,\n        };\n\n        const grid = new GridCore(this.gridHost.nativeElement, mergedOptions);\n        this.grid = grid;\n\n        this.wireEvents(grid.api);\n\n        // GridCore emits READY synchronously during construction (before we can\n        // attach a listener), so surface the ready signal explicitly here.\n        this.gridReady.emit(grid.api);\n    }\n\n    /** Destroys the current core, drops it, and builds a fresh one. */\n    private recreateGrid(): void {\n        this.teardownGrid();\n        this.createGrid();\n    }\n\n    /**\n     * Disposes event subscriptions, the renderer adapter (stopping its\n     * observer and destroying every mounted component/embedded view), and\n     * the core instance itself, if any.\n     *\n     * Order matters: the adapter is disposed *after* `grid.destroy()` so\n     * any teardown-time DOM removal is irrelevant (dispose() unconditionally\n     * destroys all remaining mounts rather than depending on the\n     * MutationObserver having flushed).\n     */\n    private teardownGrid(): void {\n        for (const dispose of this.disposers) {\n            dispose();\n        }\n        this.disposers.length = 0;\n\n        this.grid?.destroy();\n        this.grid = undefined;\n\n        this.rendererAdapter.dispose();\n    }\n\n    /** Subscribes every core event to its corresponding `@Output` emitter. */\n    private wireEvents(api: GridApi): void {\n        this.subscribe(api, GridEventType.DATA_CHANGED, this.dataChanged);\n        this.subscribe(api, GridEventType.ROW_CLICKED, this.rowClicked);\n        this.subscribe(api, GridEventType.ROW_DOUBLE_CLICKED, this.rowDoubleClicked);\n        this.subscribe(api, GridEventType.ROW_SELECTED, this.rowSelected);\n        this.subscribe(api, GridEventType.CELL_CLICKED, this.cellClicked);\n        this.subscribe(api, GridEventType.CELL_DOUBLE_CLICKED, this.cellDoubleClicked);\n        this.subscribe(api, GridEventType.CELL_VALUE_CHANGED, this.cellValueChanged);\n        this.subscribe(api, GridEventType.CELL_SELECTION_CHANGED, this.cellSelectionChanged);\n        this.subscribe(api, GridEventType.COLUMN_RESIZED, this.columnResized);\n        this.subscribe(api, GridEventType.COLUMN_MOVED, this.columnMoved);\n        this.subscribe(api, GridEventType.SORT_CHANGED, this.sortChanged);\n        this.subscribe(api, GridEventType.FILTER_CHANGED, this.filterChanged);\n        this.subscribe(api, GridEventType.PAGE_CHANGED, this.pageChanged);\n        this.subscribe(api, GridEventType.COLUMNS_STATE_CHANGED, this.columnsStateChanged);\n        this.subscribe(api, GridEventType.THEME_CHANGED, this.themeChanged);\n        this.subscribe(api, GridEventType.EXPORT_COMPLETE, this.exportComplete);\n    }\n\n    /**\n     * Forwards a single strongly-typed core event to an Angular emitter and\n     * records its unsubscribe callback. The generic constraint guarantees the\n     * emitter's payload type matches the event's payload in {@link GridEventMap}.\n     */\n    private subscribe<E extends keyof GridEventMap>(\n        api: GridApi,\n        event: E,\n        emitter: EventEmitter<GridEventMap[E]>,\n    ): void {\n        const dispose = api.on<GridEventMap[E]>(event, (payload) => emitter.emit(payload));\n        this.disposers.push(dispose);\n    }\n}","import { NgModule } from '@angular/core';\n\nimport { PhotonGridComponent } from './photon-grid.component';\n\n/**\n * Convenience NgModule for consumers that are not yet on standalone APIs.\n * {@link PhotonGridComponent} is itself standalone; this module simply\n * imports and re-exports it so it can be dropped into an NgModule's\n * `imports`/`exports` and used in that module's templates.\n */\n@NgModule({\n    imports: [PhotonGridComponent],\n    exports: [PhotonGridComponent],\n})\nexport class PhotonGridModule {}\n","/*\n * Public API surface of photon-grid-angular.\n */\n\nexport * from './library/photon-grid.component';\nexport * from './library/photon-grid.module';\nexport * from './library/angular-renderer.types';\n\n// Re-export the most commonly needed core types so consumers can bind the\n// wrapper without importing photon-grid-core directly.\nexport type {\n    GridApi,\n    GridOptions,\n} from 'photon-grid-core';\nexport { GridEventType } from 'photon-grid-core';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generated bundle index. Do not edit.
+ */
+/// <amd-module name="photon-grid-angular" />
+export * from './public-api';
+//# sourceMappingURL=photon-grid-angular.d.ts.map

package/library/angular-renderer.adapter.d.ts

@@ -0,0 +1,68 @@
+import { ApplicationRef, EnvironmentInjector, Injector } from '@angular/core';
+import type { ColumnDef } from 'photon-grid-core';
+import { ColumnDef as GridColumnDef } from './angular-renderer.types';
+/**
+ * Bridges the framework-agnostic `ColumnRendererMap` (plain functions
+ * returning `HTMLElement | string`) to Angular components and templates.
+ *
+ * One instance is owned per `<photon-grid>` and lives for the component's
+ * lifetime: {@link adaptColumns} is called whenever columns are (re)supplied,
+ * and {@link dispose} is called once, in `ngOnDestroy`, to guarantee nothing
+ * outlives the host component.
+ *
+ * ### Why a MutationObserver
+ * The core owns cell/row virtualization and recycling; it has no lifecycle
+ * hook that tells us "this cell's DOM node is gone, destroy whatever you
+ * mounted into it". Since every renderer invocation mounts a *fresh*
+ * component/embedded view (the core's contract is "produce output for these
+ * params", not "patch existing output"), the only reliable place to catch
+ * disposal is watching the DOM itself: when the core removes/replaces a
+ * mounted host element, a MutationObserver on the grid root sees it and we
+ * destroy the corresponding Angular view right then. This is what keeps
+ * scrolling/virtualized grids from leaking components.
+ */
+export declare class RendererAdapter {
+    private readonly appRef;
+    private readonly environmentInjector;
+    private readonly elementInjector;
+    /** Host element -> live Angular view mounted into it. */
+    private readonly mounts;
+    private observer?;
+    constructor(appRef: ApplicationRef, environmentInjector: EnvironmentInjector, elementInjector: Injector);
+    /**
+     * Starts watching `root` for node removals so mounted views can be torn
+     * down as soon as the core discards their host element. Safe to call
+     * repeatedly (e.g. across grid recreation) — any previous observer is
+     * disconnected first, but existing mounts are left untouched.
+     */
+    observe(root: HTMLElement): void;
+    /** Recursively converts `GridColumnDef[]` into plain `ColumnDef[]`. */
+    adaptColumns(columns: readonly GridColumnDef[]): ColumnDef[];
+    /**
+     * Destroys every currently-mounted component/embedded view and stops
+     * observing. Call exactly once, when the owning grid is torn down.
+     * Deliberately unconditional (does not wait on the MutationObserver):
+     * `disconnect()` drops any in-flight mutation records, so relying on it
+     * for final teardown would risk leaking whatever hadn't been flushed yet.
+     */
+    dispose(): void;
+    private adaptColumn;
+    private adaptRenderer;
+    private isComponentType;
+    private mountComponent;
+    private setComponentInput;
+    private normalizeRendererParams;
+    private inferInputs;
+    private invokeLifecycle;
+    private mountTemplate;
+    /**
+     * Uses the template's single root element directly when possible (so
+     * `editor`/`filter` slots that expect the returned element to *be* the
+     * control keep working); falls back to a wrapper `<div>` for templates
+     * with multiple root nodes or text-only content.
+     */
+    private resolveTemplateHost;
+    private cleanupRemovedNode;
+    private destroyMount;
+}
+//# sourceMappingURL=angular-renderer.adapter.d.ts.map

package/library/angular-renderer.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-renderer.adapter.d.ts","sourceRoot":"","sources":["../../src/library/angular-renderer.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EAGd,mBAAmB,EACnB,QAAQ,EAGX,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAGH,SAAS,IAAI,aAAa,EAI7B,MAAM,0BAA0B,CAAC;AAQlC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAOpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe;IARpC,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAEhE,OAAO,CAAC,QAAQ,CAAC,CAAmB;gBAGf,MAAM,EAAE,cAAc,EACtB,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,QAAQ;IAG9C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAkBhC,uEAAuE;IACvE,YAAY,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,EAAE;IAI5D;;;;;;OAMG;IACH,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,WAAW;IA+BnB,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,WAAW;IAuCnB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,aAAa;IAuBrB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,YAAY;CAavB"}

package/library/angular-renderer.types.d.ts

@@ -0,0 +1,68 @@
+import type { TemplateRef, Type } from '@angular/core';
+import type { ColumnDef as coreColumnDef, DisplayRendererParams, EditorRendererParams, FilterRendererParams, GroupRendererParams, HeaderRendererParams, OptionRendererParams, RendererOutput, SummaryRendererParams, TooltipRendererParams } from 'photon-grid-core';
+/**
+ * Renders `params` through a `@Component`.
+ *
+ * A **new** component instance is created every time the core invokes the
+ * renderer (it has no concept of "update", only "produce output for these
+ * params"). `inputs` is re-evaluated on every mount and applied via
+ * `ComponentRef.setInput` before the first change-detection pass, so the
+ * component sees the current params as its initial `@Input()`s.
+ */
+export interface ComponentRendererSpec<TParams, TComponent = unknown> {
+    readonly kind: 'component';
+    readonly component: Type<TComponent>;
+    /** Maps renderer params to the component's `@Input()` bag. */
+    readonly inputs?: (params: TParams) => Partial<TComponent> & Record<string, unknown>;
+}
+/** Context handed to an `<ng-template>` used as a renderer. */
+export interface RendererContext<TParams> {
+    /** Enables `let-x` / implicit `let-params` template syntax. */
+    $implicit: TParams;
+    params: TParams;
+    [key: string]: unknown;
+}
+/**
+ * Renders `params` through an `<ng-template>` (obtained via `@ViewChild`).
+ *
+ * Prefer a single root element in the template for `editor` / `filter`
+ * slots: the core treats the returned `HTMLElement` as the interactive
+ * control itself (e.g. it may call `.focus()` on it), and a multi-root
+ * template gets wrapped in a synthetic `<div>` host that breaks that
+ * assumption.
+ */
+export interface TemplateRendererSpec<TParams> {
+    readonly kind: 'template';
+    readonly template: TemplateRef<RendererContext<TParams>>;
+    readonly context?: (params: TParams) => Record<string, unknown>;
+}
+/**
+ * A renderer slot accepts either:
+ * - a declarative spec (`{ kind: 'component' | 'template', ... }`), or
+ * - a plain function, for consumers who want to keep producing raw
+ *   `HTMLElement`/`string` output (identical to the framework-agnostic core API).
+ */
+export type CellRenderer<TParams, TOutput> = ComponentRendererSpec<TParams> | TemplateRendererSpec<TParams> | Type<unknown> | TemplateRef<RendererContext<TParams>> | ((params: TParams) => TOutput);
+export interface ColumnRendererMap {
+    display?: CellRenderer<DisplayRendererParams, RendererOutput>;
+    editor?: CellRenderer<EditorRendererParams, HTMLElement>;
+    option?: Type<any> | TemplateRef<any> | ((params: OptionRendererParams) => HTMLElement);
+    filter?: CellRenderer<FilterRendererParams, HTMLElement>;
+    tooltip?: CellRenderer<TooltipRendererParams, RendererOutput>;
+    group?: CellRenderer<GroupRendererParams, RendererOutput>;
+    header?: CellRenderer<HeaderRendererParams, RendererOutput>;
+    summary?: CellRenderer<SummaryRendererParams, RendererOutput>;
+}
+/**
+ * Drop-in replacement for `ColumnDef`: identical shape, except `renderer`
+ * (and `renderer` on any nested `children`) accepts the declarative
+ * component/template specs above in addition to plain functions.
+ */
+export type ColumnDef = Omit<coreColumnDef, 'renderer' | 'children'> & {
+    renderer?: ColumnRendererMap;
+    children?: ColumnDef[];
+};
+/** Narrowing helpers used by the adapter (and usable by consumers/tests). */
+export declare function isComponentRendererSpec(value: unknown): value is ComponentRendererSpec<unknown>;
+export declare function isTemplateRendererSpec(value: unknown): value is TemplateRendererSpec<unknown>;
+//# sourceMappingURL=angular-renderer.types.d.ts.map

package/library/angular-renderer.types.d.ts.map

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

package/library/photon-grid.component.d.ts

@@ -0,0 +1,162 @@
+import { AfterViewInit, ApplicationRef, EnvironmentInjector, EventEmitter, Injector, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import type { CellClickedEvent, CellSelectionChangedEvent, CellValueChangedEvent, ColumnMovedEvent, ColumnResizedEvent, ColumnsStateChangedEvent, ColumnSortedEvent, DataChangedEvent, ExportEvent, FilterChangedEvent, GridApi, GridOptions, PageChangedEvent, RowClickPayload, RowSelectedEvent, ThemeChangedEvent } from 'photon-grid-core';
+import type { ColumnDef as GridColumnDef } from './angular-renderer.types';
+import * as i0 from "@angular/core";
+/**
+ * Angular wrapper around the framework-agnostic Photon Grid core.
+ *
+ * The component owns a single {@link GridCore} instance, keeps it in sync
+ * with the `columns`, `dataSet` and `options` inputs, and re-emits the
+ * grid's internal events as strongly-typed Angular `@Output`s.
+ *
+ * Cell/header/editor/etc. renderers may be plain functions (raw
+ * `HTMLElement`/`string`, identical to the core's own API), or declarative
+ * Angular specs — `{ kind: 'component', component: MyBadge }` or
+ * `{ kind: 'template', template: myTemplateRef }` — via {@link GridColumnDef}.
+ * An internal {@link RendererAdapter} mounts/unmounts those for every
+ * renderer invocation and disposes them as soon as the core discards their
+ * host element, so virtualization/recycling never leaks components.
+ *
+ * @example
+ * ```html
+ * <photon-grid
+ *   [columns]="columns"
+ *   [dataSet]="rows"
+ *   [options]="{ theme: 'light', showCheckboxes: true }"
+ *   (gridReady)="onReady($event)"
+ *   (rowClicked)="onRowClicked($event)">
+ * </photon-grid>
+ * ```
+ *
+ * @example Component-based cell renderer
+ * ```ts
+ * columns: GridColumnDef[] = [{
+ *   colId: 'status', field: 'status', header: 'Status', type: 'string',
+ *   renderer: {
+ *     display: {
+ *       kind: 'component',
+ *       component: StatusBadgeComponent,
+ *       inputs: (params) => ({ value: params.value }),
+ *     },
+ *   },
+ * }];
+ * ```
+ *
+ * @example Template-based cell renderer
+ * ```html
+ * <ng-template #statusTpl let-params>
+ *   <span class="badge">{{ params.value }}</span>
+ * </ng-template>
+ * ```
+ * ```ts
+ * @ViewChild('statusTpl') statusTpl!: TemplateRef<RendererContext<DisplayRendererParams>>;
+ * columns: GridColumnDef[] = [{
+ *   colId: 'status', field: 'status', header: 'Status', type: 'string',
+ *   renderer: { display: { kind: 'template', template: this.statusTpl } },
+ * }];
+ * ```
+ */
+export declare class PhotonGridComponent implements AfterViewInit, OnChanges, OnDestroy {
+    /** Container the grid renders into. */
+    private readonly gridHost;
+    /**
+     * Column definitions. Bound to {@link GridApi.setColumns} on change.
+     * Provided as a dedicated input rather than through `options.columns`.
+     * Renderer slots accept Angular components/templates in addition to
+     * plain functions — see {@link GridColumnDef}.
+     */
+    columns: GridColumnDef[];
+    /**
+     * Row data. Bound to {@link GridApi.setData} on change. Provided as a
+     * dedicated input rather than through `options.data`.
+     */
+    dataSet: Record<string, unknown>[];
+    /**
+     * Remaining grid options (theme, selection, editing, pagination, …).
+     * `columns` and `data` are supplied by the dedicated inputs above and are
+     * merged in automatically. The core has no runtime options setter, so a
+     * change to this input transparently recreates the grid.
+     */
+    options: Partial<GridOptions>;
+    /** Emitted once the grid is constructed, carrying its {@link GridApi}. */
+    readonly gridReady: EventEmitter<GridApi>;
+    /** Row data changed (count delta). */
+    readonly dataChanged: EventEmitter<DataChangedEvent>;
+    /** A row was clicked. */
+    readonly rowClicked: EventEmitter<RowClickPayload>;
+    /** A row was double-clicked. */
+    readonly rowDoubleClicked: EventEmitter<RowClickPayload>;
+    /** Row selection changed. */
+    readonly rowSelected: EventEmitter<RowSelectedEvent>;
+    /** A cell was clicked. */
+    readonly cellClicked: EventEmitter<CellClickedEvent>;
+    /** A cell was double-clicked. */
+    readonly cellDoubleClicked: EventEmitter<CellClickedEvent>;
+    /** A cell value was committed. */
+    readonly cellValueChanged: EventEmitter<CellValueChangedEvent>;
+    /** Range/cell selection changed. */
+    readonly cellSelectionChanged: EventEmitter<CellSelectionChangedEvent>;
+    /** A column was resized. */
+    readonly columnResized: EventEmitter<ColumnResizedEvent>;
+    /** A column was reordered. */
+    readonly columnMoved: EventEmitter<ColumnMovedEvent>;
+    /** Sort state changed. */
+    readonly sortChanged: EventEmitter<ColumnSortedEvent>;
+    /** Filter model changed. */
+    readonly filterChanged: EventEmitter<FilterChangedEvent>;
+    /** Pagination page or size changed. */
+    readonly pageChanged: EventEmitter<PageChangedEvent>;
+    /** Column state (width/visibility/pin/order) changed. */
+    readonly columnsStateChanged: EventEmitter<ColumnsStateChangedEvent>;
+    /** Active theme changed. */
+    readonly themeChanged: EventEmitter<ThemeChangedEvent>;
+    /** An export finished. */
+    readonly exportComplete: EventEmitter<ExportEvent>;
+    /** The live core instance, created in {@link ngAfterViewInit}. */
+    private grid?;
+    /** Unsubscribe callbacks for every wired core event; drained on teardown. */
+    private readonly disposers;
+    /**
+     * Bridges Angular component/template renderer specs to the core's
+     * plain-function `ColumnRendererMap`. Owned for the lifetime of this
+     * component (not DI-provided) so its mounted-view tracking is scoped
+     * to this grid instance alone.
+     *
+     * Built explicitly in the constructor body (rather than as a field
+     * initializer referencing constructor-parameter properties) so it isn't
+     * subject to field-initializer-vs-parameter-property ordering: at this
+     * point `appRef`/`environmentInjector`/`elementInjector` are plain local
+     * constructor arguments, guaranteed to already be set.
+     */
+    private readonly rendererAdapter;
+    constructor(appRef: ApplicationRef, environmentInjector: EnvironmentInjector, elementInjector: Injector);
+    ngAfterViewInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** Builds the core from the current inputs and wires its events. */
+    private createGrid;
+    /** Destroys the current core, drops it, and builds a fresh one. */
+    private recreateGrid;
+    /**
+     * Disposes event subscriptions, the renderer adapter (stopping its
+     * observer and destroying every mounted component/embedded view), and
+     * the core instance itself, if any.
+     *
+     * Order matters: the adapter is disposed *after* `grid.destroy()` so
+     * any teardown-time DOM removal is irrelevant (dispose() unconditionally
+     * destroys all remaining mounts rather than depending on the
+     * MutationObserver having flushed).
+     */
+    private teardownGrid;
+    /** Subscribes every core event to its corresponding `@Output` emitter. */
+    private wireEvents;
+    /**
+     * Forwards a single strongly-typed core event to an Angular emitter and
+     * records its unsubscribe callback. The generic constraint guarantees the
+     * emitter's payload type matches the event's payload in {@link GridEventMap}.
+     */
+    private subscribe;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PhotonGridComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PhotonGridComponent, "photon-grid", never, { "columns": { "alias": "columns"; "required": false; }; "dataSet": { "alias": "dataSet"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, { "gridReady": "gridReady"; "dataChanged": "dataChanged"; "rowClicked": "rowClicked"; "rowDoubleClicked": "rowDoubleClicked"; "rowSelected": "rowSelected"; "cellClicked": "cellClicked"; "cellDoubleClicked": "cellDoubleClicked"; "cellValueChanged": "cellValueChanged"; "cellSelectionChanged": "cellSelectionChanged"; "columnResized": "columnResized"; "columnMoved": "columnMoved"; "sortChanged": "sortChanged"; "filterChanged": "filterChanged"; "pageChanged": "pageChanged"; "columnsStateChanged": "columnsStateChanged"; "themeChanged": "themeChanged"; "exportComplete": "exportComplete"; }, never, never, true, never>;
+}
+//# sourceMappingURL=photon-grid.component.d.ts.map

package/library/photon-grid.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-grid.component.d.ts","sourceRoot":"","sources":["../../src/library/photon-grid.component.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,aAAa,EACb,cAAc,EAId,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EAER,SAAS,EACT,SAAS,EAET,aAAa,EAEhB,MAAM,eAAe,CAAC;AAIvB,OAAO,KAAK,EACR,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,OAAO,EAEP,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAC,SAAS,IAAI,aAAa,EAAE,MAAM,0BAA0B,CAAC;;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,qBAOa,mBAAoB,YAAW,aAAa,EAAE,SAAS,EAAE,SAAS;IAE3E,uCAAuC;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAEvD;;;;;OAKG;IAEH,OAAO,EAAE,aAAa,EAAE,CAAM;IAE9B;;;OAGG;IAEH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAM;IAExC;;;;;OAKG;IAEH,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAM;IAEnC,0EAA0E;IAChE,QAAQ,CAAC,SAAS,wBAA+B;IAE3D,sCAAsC;IAC5B,QAAQ,CAAC,WAAW,iCAAwC;IAEtE,yBAAyB;IACf,QAAQ,CAAC,UAAU,gCAAuC;IAEpE,gCAAgC;IACtB,QAAQ,CAAC,gBAAgB,gCAAuC;IAE1E,6BAA6B;IACnB,QAAQ,CAAC,WAAW,iCAAwC;IAEtE,0BAA0B;IAChB,QAAQ,CAAC,WAAW,iCAAwC;IAEtE,iCAAiC;IACvB,QAAQ,CAAC,iBAAiB,iCAAwC;IAE5E,kCAAkC;IACxB,QAAQ,CAAC,gBAAgB,sCAA6C;IAEhF,oCAAoC;IAC1B,QAAQ,CAAC,oBAAoB,0CAAiD;IAExF,4BAA4B;IAClB,QAAQ,CAAC,aAAa,mCAA0C;IAE1E,8BAA8B;IACpB,QAAQ,CAAC,WAAW,iCAAwC;IAEtE,0BAA0B;IAChB,QAAQ,CAAC,WAAW,kCAAyC;IAEvE,4BAA4B;IAClB,QAAQ,CAAC,aAAa,mCAA0C;IAE1E,uCAAuC;IAC7B,QAAQ,CAAC,WAAW,iCAAwC;IAEtE,yDAAyD;IAC/C,QAAQ,CAAC,mBAAmB,yCAAgD;IAEtF,4BAA4B;IAClB,QAAQ,CAAC,YAAY,kCAAyC;IAExE,0BAA0B;IAChB,QAAQ,CAAC,cAAc,4BAAmC;IAEpE,kEAAkE;IAClE,OAAO,CAAC,IAAI,CAAC,CAAW;IAExB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IAEnD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAG9C,MAAM,EAAE,cAAc,EACtB,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,QAAQ;IAK7B,eAAe,IAAI,IAAI;IAIvB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAsBzC,WAAW,IAAI,IAAI;IAInB,oEAAoE;IACpE,OAAO,CAAC,UAAU;IAqBlB,mEAAmE;IACnE,OAAO,CAAC,YAAY;IAKpB;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IAYpB,0EAA0E;IAC1E,OAAO,CAAC,UAAU;IAmBlB;;;;OAIG;IACH,OAAO,CAAC,SAAS;yCAvNR,mBAAmB;2CAAnB,mBAAmB;CA+N/B"}

package/library/photon-grid.module.d.ts

@@ -0,0 +1,14 @@
+import * as i0 from "@angular/core";
+import * as i1 from "./photon-grid.component";
+/**
+ * Convenience NgModule for consumers that are not yet on standalone APIs.
+ * {@link PhotonGridComponent} is itself standalone; this module simply
+ * imports and re-exports it so it can be dropped into an NgModule's
+ * `imports`/`exports` and used in that module's templates.
+ */
+export declare class PhotonGridModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<PhotonGridModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PhotonGridModule, never, [typeof i1.PhotonGridComponent], [typeof i1.PhotonGridComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<PhotonGridModule>;
+}
+//# sourceMappingURL=photon-grid.module.d.ts.map

package/library/photon-grid.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-grid.module.d.ts","sourceRoot":"","sources":["../../src/library/photon-grid.module.ts"],"names":[],"mappings":";;AAIA;;;;;GAKG;AACH,qBAIa,gBAAgB;yCAAhB,gBAAgB;0CAAhB,gBAAgB;0CAAhB,gBAAgB;CAAG"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "photon-grid-angular",
+  "version": "0.0.1",
+  "description": "Angular wrapper for Photon Grid — an enterprise-grade, framework-agnostic TypeScript data grid.",
+  "author": "Abdul Wahid",
+  "license": "MIT",
+  "peerDependencies": {
+    "@angular/common": "^18.2.0",
+    "@angular/core": "^18.2.0",
+    "photon-grid-core": "*"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "keywords": [
+    "angular",
+    "grid",
+    "data-grid",
+    "datatable",
+    "table",
+    "photon-grid",
+    "enterprise-grid",
+    "typescript"
+  ],
+  "sideEffects": false,
+  "module": "fesm2022/photon-grid-angular.mjs",
+  "typings": "index.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./index.d.ts",
+      "esm2022": "./esm2022/photon-grid-angular.mjs",
+      "esm": "./esm2022/photon-grid-angular.mjs",
+      "default": "./fesm2022/photon-grid-angular.mjs"
+    }
+  }
+}

package/photon-grid-angular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photon-grid-angular.d.ts","sourceRoot":"","sources":["../src/photon-grid-angular.ts"],"names":[],"mappings":"AAAA;;GAEG;;AAEH,cAAc,cAAc,CAAC"}

package/public-api.d.ts

@@ -0,0 +1,6 @@
+export * from './library/photon-grid.component';
+export * from './library/photon-grid.module';
+export * from './library/angular-renderer.types';
+export type { GridApi, GridOptions, } from 'photon-grid-core';
+export { GridEventType } from 'photon-grid-core';
+//# sourceMappingURL=public-api.d.ts.map

package/public-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AAIjD,YAAY,EACR,OAAO,EACP,WAAW,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}