@affino/datagrid-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 affino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# @affino/datagrid-core
+
+Framework-agnostic data grid core.
+
+## API Tiers
+
+### Tier 1: Stable (`@affino/datagrid-core`)
+
+Semver-safe surface for application integrations.
+
+```ts
+import {
+  createDataGridApi,
+  createDataGridCore,
+  createClientRowModel,
+  createServerBackedRowModel,
+} from "@affino/datagrid-core"
+```
+
+### Tier 2: Advanced (`@affino/datagrid-core/advanced`)
+
+Power-user APIs (supported, but can evolve faster):
+
+```ts
+import {
+  createDataGridViewportController,
+  createDataGridA11yStateMachine,
+  createDataGridTransactionService,
+  createDataGridAdapterRuntime,
+} from "@affino/datagrid-core/advanced"
+```
+
+### Tier 3: Internal (`@affino/datagrid-core/internal`)
+
+Unsafe, no semver guarantees. Use only for local tooling and migrations.
+
+## Naming
+
+Core naming is fully canonicalized to `DataGrid*` across stable, advanced, and internal entrypoints.
+
+## Deterministic Integration Snapshot
+
+Viewport integration should read deterministic state from controller snapshot API instead of peeking into internal signals or DOM transforms:
+
+```ts
+import { createDataGridViewportController } from "@affino/datagrid-core/advanced"
+
+const viewport = createDataGridViewportController({ resolvePinMode })
+const snapshot = viewport.getIntegrationSnapshot()
+
+// stable integration fields:
+snapshot.virtualWindow
+snapshot.visibleRowRange
+snapshot.visibleColumnRange
+snapshot.pinnedWidth
+snapshot.overlaySync
+```
+
+`visibleRowRange` / `visibleColumnRange` are legacy mirrors of `virtualWindow` for compatibility.
+
+For imperative adapters, `DataGridViewportImperativeCallbacks` also exposes `onWindow(payload)` with the same `virtualWindow` snapshot.
+
+`getViewportSyncState()` is also available when only sync transform state is needed.
+
+## Pinning Contract (Canonical)
+
+Runtime now treats only one pin state as canonical:
+- `column.pin = "left" | "right" | "none"`
+- `column.isSystem = true` is always resolved as left-pinned.
+
+Legacy pin fields are not part of the supported contract.
+
+### Migration Guide
+
+Replace legacy fields in column definitions:
+- `sticky: "left"` -> `pin: "left"`
+- `sticky: "right"` -> `pin: "right"`
+- `stickyLeft: true|number` -> `pin: "left"`
+- `stickyRight: true|number` -> `pin: "right"`
+- `pinned: true|"left"` -> `pin: "left"`
+- `pinned: "right"` -> `pin: "right"`
+- `lock: "left"|"right"` / `locked: true` -> `pin: "left"|"right"`
+
+## Selection Geometry Spaces
+
+Selection runtime uses one coordinate contract:
+- `table/world` space: content coordinates before scroll transform.
+- `viewport` space: visible coordinates after applying scroll.
+- `client` space: DOM client coordinates (requires viewport origin for conversion).
+
+Core helpers in `src/selection/coordinateSpace.ts` are the canonical conversion path used by overlay/fill/selection adapters.
+
+## Horizontal Virtualization Contract
+
+Horizontal virtualization now uses a deterministic clamp/update path:
+- clamp calculation is centralized in `src/viewport/dataGridViewportHorizontalClamp.ts`
+- prepare phase is pure (no mutation of input meta)
+- stress coverage includes `100k` rows and `500+` columns with pinned left/right mix
+
+## Build/Type Check
+
+- `npm run build` - compile public contract to `dist`
+- `npm run type-check` - check only public contract surface
+
+## Roadmap
+
+Execution and quality hardening are tracked in:
+`/Users/anton/Projects/affinio/docs/datagrid-ag-architecture-9.5-pipeline-checklist.md`.

package/dist/plugins/eventBus.d.ts

@@ -0,0 +1,9 @@
+import type { DataGridEventArgs, DataGridEventMap, DataGridEventName, DataGridPluginEventHandler } from "./types";
+export declare class DataGridPluginEventBus<TEventMap extends DataGridEventMap = DataGridEventMap> {
+    private listeners;
+    on<TEvent extends DataGridEventName<TEventMap>>(event: TEvent, handler: DataGridPluginEventHandler<DataGridEventArgs<TEventMap, TEvent>>): void;
+    off<TEvent extends DataGridEventName<TEventMap>>(event: TEvent, handler: DataGridPluginEventHandler<DataGridEventArgs<TEventMap, TEvent>>): void;
+    emit<TEvent extends DataGridEventName<TEventMap>>(event: TEvent, ...args: DataGridEventArgs<TEventMap, TEvent>): void;
+    clear(): void;
+}
+//# sourceMappingURL=eventBus.d.ts.map

package/dist/plugins/eventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.d.ts","sourceRoot":"","sources":["../../plugins/eventBus.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,SAAS,CAAA;AAIhB,qBAAa,sBAAsB,CAAC,SAAS,SAAS,gBAAgB,GAAG,gBAAgB;IACvF,OAAO,CAAC,SAAS,CAAyC;IAE1D,EAAE,CAAC,MAAM,SAAS,iBAAiB,CAAC,SAAS,CAAC,EAC5C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAQ3E,GAAG,CAAC,MAAM,SAAS,iBAAiB,CAAC,SAAS,CAAC,EAC7C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAU3E,IAAI,CAAC,MAAM,SAAS,iBAAiB,CAAC,SAAS,CAAC,EAC9C,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC;IAe/C,KAAK;CAGN"}

package/dist/plugins/eventBus.js

@@ -0,0 +1,46 @@
+// src/datagrid/plugins/eventBus.ts
+// Lightweight event bus used by the DataGrid plugin manager.
+export class DataGridPluginEventBus {
+    constructor() {
+        Object.defineProperty(this, "listeners", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+    }
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+    }
+    off(event, handler) {
+        const handlers = this.listeners.get(event);
+        if (!handlers)
+            return;
+        handlers.delete(handler);
+        if (!handlers.size) {
+            this.listeners.delete(event);
+        }
+    }
+    emit(event, ...args) {
+        const handlers = this.listeners.get(event);
+        if (!(handlers === null || handlers === void 0 ? void 0 : handlers.size))
+            return;
+        for (const handler of [...handlers]) {
+            try {
+                ;
+                handler(...args);
+            }
+            catch (error) {
+                if (typeof console !== "undefined" && console.error) {
+                    console.error(`[DataGridPluginEventBus] handler for "${event}" threw`, error);
+                }
+            }
+        }
+    }
+    clear() {
+        this.listeners.clear();
+    }
+}

package/dist/plugins/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./manager";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../plugins/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA"}

package/dist/plugins/index.js

@@ -0,0 +1,3 @@
+// src/datagrid/plugins/index.ts
+export * from "./types";
+export * from "./manager";

package/dist/plugins/manager.d.ts

@@ -0,0 +1,24 @@
+import type { DataGridEventArgs, DataGridEventMap, DataGridEventName, DataGridPluginCapabilityMap, DataGridPluginDefinition } from "./types";
+type HostEmit = (event: string, ...args: readonly unknown[]) => void;
+interface ManagerOptions<TCapabilities extends DataGridPluginCapabilityMap> {
+    getTableId: () => string;
+    getRootElement: () => HTMLElement | null;
+    getCapabilityMap: () => TCapabilities;
+    onCapabilityDenied?: (pluginId: string, capability: string, reason: "not-declared" | "not-provided") => void;
+    emitHostEvent: HostEmit;
+}
+export declare class DataGridPluginManager<THostEvents extends DataGridEventMap = DataGridEventMap, TPluginEvents extends DataGridEventMap = DataGridEventMap, TCapabilities extends DataGridPluginCapabilityMap = DataGridPluginCapabilityMap> {
+    private readonly bus;
+    private readonly instances;
+    private readonly options;
+    constructor(options: ManagerOptions<TCapabilities>);
+    setPlugins(definitions: Array<DataGridPluginDefinition<THostEvents, TPluginEvents, TCapabilities> | null | undefined>): void;
+    on<TEvent extends DataGridEventName<TPluginEvents>>(event: TEvent, handler: (...args: DataGridEventArgs<TPluginEvents, TEvent>) => void): () => void;
+    notify<TEvent extends DataGridEventName<TPluginEvents>>(event: TEvent, ...args: DataGridEventArgs<TPluginEvents, TEvent>): void;
+    emit<TEvent extends DataGridEventName<TPluginEvents>>(event: TEvent, ...args: DataGridEventArgs<TPluginEvents, TEvent>): void;
+    destroy(): void;
+    private installPlugin;
+    private disposePlugin;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/plugins/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../plugins/manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAE3B,wBAAwB,EAEzB,MAAM,SAAS,CAAA;AAEhB,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,KAAK,IAAI,CAAA;AAIpE,UAAU,cAAc,CAAC,aAAa,SAAS,2BAA2B;IACxE,UAAU,EAAE,MAAM,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;IACxC,gBAAgB,EAAE,MAAM,aAAa,CAAA;IACrC,kBAAkB,CAAC,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GAAG,cAAc,KACpC,IAAI,CAAA;IACT,aAAa,EAAE,QAAQ,CAAA;CACxB;AAyDD,qBAAa,qBAAqB,CAChC,WAAW,SAAS,gBAAgB,GAAG,gBAAgB,EACvD,aAAa,SAAS,gBAAgB,GAAG,gBAAgB,EACzD,aAAa,SAAS,2BAA2B,GAAG,2BAA2B;IAE/E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6E;IACvG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;gBAE3C,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC;IAIlD,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,wBAAwB,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IA8BrH,EAAE,CAAC,MAAM,SAAS,iBAAiB,CAAC,aAAa,CAAC,EAChD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CACP,GAAG,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC,KAC9C,IAAI,GACR,MAAM,IAAI;IAKb,MAAM,CAAC,MAAM,SAAS,iBAAiB,CAAC,aAAa,CAAC,EACpD,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC;IAKnD,IAAI,CAAC,MAAM,SAAS,iBAAiB,CAAC,aAAa,CAAC,EAClD,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC;IAKnD,OAAO;IAOP,OAAO,CAAC,aAAa;IAyFrB,OAAO,CAAC,aAAa;CAStB"}

package/dist/plugins/manager.js

@@ -0,0 +1,195 @@
+// src/datagrid/plugins/manager.ts
+// Runtime manager responsible for installing, updating, and disposing DataGrid plugins.
+import { DataGridPluginEventBus } from "./eventBus";
+function isDataGridPlugin(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const plugin = value;
+    return typeof plugin.id === "string" && plugin.id.trim().length > 0 && typeof plugin.setup === "function";
+}
+function normalizeDefinition(definition) {
+    if (!definition)
+        return null;
+    let candidate = null;
+    if (typeof definition === "function") {
+        try {
+            candidate = definition();
+        }
+        catch (error) {
+            if (typeof console !== "undefined" && console.error) {
+                console.error("[DataGridPluginManager] Failed to instantiate plugin factory", error);
+            }
+            return null;
+        }
+    }
+    else {
+        candidate = definition;
+    }
+    if (!isDataGridPlugin(candidate)) {
+        if (typeof console !== "undefined" && console.warn) {
+            console.warn("[DataGridPluginManager] Ignoring invalid plugin definition", definition);
+        }
+        return null;
+    }
+    return candidate;
+}
+export class DataGridPluginManager {
+    constructor(options) {
+        Object.defineProperty(this, "bus", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new DataGridPluginEventBus()
+        });
+        Object.defineProperty(this, "instances", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.options = options;
+    }
+    setPlugins(definitions) {
+        const normalized = new Map();
+        for (const definition of definitions !== null && definitions !== void 0 ? definitions : []) {
+            const plugin = normalizeDefinition(definition);
+            if (!plugin)
+                continue;
+            if (normalized.has(plugin.id)) {
+                if (typeof console !== "undefined" && console.warn) {
+                    console.warn(`[DataGridPluginManager] Duplicate plugin id "${plugin.id}" ignored`);
+                }
+                continue;
+            }
+            normalized.set(plugin.id, plugin);
+        }
+        for (const [id, active] of [...this.instances]) {
+            const next = normalized.get(id);
+            if (!next || next !== active.plugin) {
+                this.disposePlugin(id);
+            }
+        }
+        for (const plugin of normalized.values()) {
+            const existing = this.instances.get(plugin.id);
+            if (existing && existing.plugin === plugin) {
+                continue;
+            }
+            this.installPlugin(plugin);
+        }
+    }
+    on(event, handler) {
+        this.bus.on(event, handler);
+        return () => this.bus.off(event, handler);
+    }
+    notify(event, ...args) {
+        this.bus.emit(event, ...args);
+    }
+    emit(event, ...args) {
+        this.bus.emit(event, ...args);
+    }
+    destroy() {
+        for (const [id] of [...this.instances]) {
+            this.disposePlugin(id);
+        }
+        this.bus.clear();
+    }
+    installPlugin(plugin) {
+        var _a;
+        const cleanupFns = [];
+        const declaredCapabilities = new Set((_a = plugin.capabilities) !== null && _a !== void 0 ? _a : []);
+        const registerCleanup = (cleanup) => {
+            if (typeof cleanup !== "function")
+                return;
+            cleanupFns.push(cleanup);
+        };
+        const resolveCapability = (capability, reportDenied) => {
+            var _a, _b, _c, _d;
+            if (!declaredCapabilities.has(capability)) {
+                if (reportDenied) {
+                    (_b = (_a = this.options).onCapabilityDenied) === null || _b === void 0 ? void 0 : _b.call(_a, plugin.id, capability, "not-declared");
+                }
+                return null;
+            }
+            const capabilityMap = this.options.getCapabilityMap();
+            const candidate = capabilityMap[capability];
+            if (typeof candidate !== "function") {
+                if (reportDenied) {
+                    (_d = (_c = this.options).onCapabilityDenied) === null || _d === void 0 ? void 0 : _d.call(_c, plugin.id, capability, "not-provided");
+                }
+                return null;
+            }
+            return candidate;
+        };
+        const context = {
+            tableId: this.options.getTableId(),
+            getRootElement: this.options.getRootElement,
+            hasCapability: capability => resolveCapability(capability, false) !== null,
+            requestCapability: capability => {
+                return resolveCapability(capability, true);
+            },
+            invokeCapability: (capability, ...args) => {
+                const handler = resolveCapability(capability, true);
+                if (!handler) {
+                    throw new Error(`[DataGridPluginManager] Plugin "${plugin.id}" attempted forbidden capability "${String(capability)}"`);
+                }
+                return handler(...args);
+            },
+            emitHostEvent: (event, ...args) => {
+                this.options.emitHostEvent(event, ...args);
+            },
+            on: (event, handler) => {
+                this.bus.on(event, handler);
+                const off = () => this.bus.off(event, handler);
+                registerCleanup(off);
+                return off;
+            },
+            emit: (event, ...args) => {
+                this.bus.emit(event, ...args);
+            },
+            registerCleanup,
+        };
+        try {
+            const teardown = plugin.setup(context);
+            if (typeof teardown === "function") {
+                registerCleanup(teardown);
+            }
+        }
+        catch (error) {
+            if (typeof console !== "undefined" && console.error) {
+                console.error(`[DataGridPluginManager] Plugin "${plugin.id}" setup failed`, error);
+            }
+        }
+        const cleanup = () => {
+            while (cleanupFns.length) {
+                const fn = cleanupFns.pop();
+                try {
+                    fn === null || fn === void 0 ? void 0 : fn();
+                }
+                catch (error) {
+                    if (typeof console !== "undefined" && console.error) {
+                        console.error(`[DataGridPluginManager] Plugin "${plugin.id}" cleanup failed`, error);
+                    }
+                }
+            }
+        };
+        this.instances.set(plugin.id, { plugin, cleanup });
+    }
+    disposePlugin(id) {
+        const active = this.instances.get(id);
+        if (!active)
+            return;
+        try {
+            active.cleanup();
+        }
+        finally {
+            this.instances.delete(id);
+        }
+    }
+}

package/dist/plugins/types.d.ts

@@ -0,0 +1,40 @@
+export type DataGridEventMap = Record<string, readonly unknown[]>;
+export type DataGridPluginCapability = (...args: readonly unknown[]) => unknown;
+export type DataGridPluginCapabilityMap = Record<string, DataGridPluginCapability>;
+export type DataGridEventName<TEventMap extends DataGridEventMap> = Extract<keyof TEventMap, string>;
+export type DataGridPluginCapabilityName<TCapabilities extends DataGridPluginCapabilityMap> = Extract<keyof TCapabilities, string>;
+export type DataGridEventArgs<TEventMap extends DataGridEventMap, TEvent extends DataGridEventName<TEventMap>> = TEventMap[TEvent] extends readonly unknown[] ? TEventMap[TEvent] : readonly unknown[];
+export type DataGridPluginEventHandler<TArgs extends readonly unknown[] = readonly unknown[]> = (...args: TArgs) => void;
+export interface DataGridPluginSetupContext<THostEvents extends DataGridEventMap = DataGridEventMap, TPluginEvents extends DataGridEventMap = DataGridEventMap, TCapabilities extends DataGridPluginCapabilityMap = DataGridPluginCapabilityMap> {
+    /** Unique identifier of the table instance installing the plugin. */
+    tableId: string;
+    /** Returns the nearest theme/root element for DOM-based integrations. */
+    getRootElement: () => HTMLElement | null;
+    /**
+     * Returns `true` if capability is both declared by plugin and provided by host.
+     * Plugins must never access host internals directly.
+     */
+    hasCapability: <TCapability extends DataGridPluginCapabilityName<TCapabilities>>(capability: TCapability) => boolean;
+    /** Returns capability function if allowed/provided; otherwise `null`. */
+    requestCapability: <TCapability extends DataGridPluginCapabilityName<TCapabilities>>(capability: TCapability) => TCapabilities[TCapability] | null;
+    /**
+     * Invokes allowed capability or throws on denied/missing access.
+     * Use for fail-fast plugin contracts.
+     */
+    invokeCapability: <TCapability extends DataGridPluginCapabilityName<TCapabilities>>(capability: TCapability, ...args: Parameters<TCapabilities[TCapability]>) => ReturnType<TCapabilities[TCapability]>;
+    /** Emits a host (component-level) event, mirroring `emit` + config handlers. */
+    emitHostEvent: <TEvent extends DataGridEventName<THostEvents>>(event: TEvent, ...args: DataGridEventArgs<THostEvents, TEvent>) => void;
+    /** Subscribes to plugin/local events. Returns an unsubscribe function. */
+    on: <TEvent extends DataGridEventName<TPluginEvents>>(event: TEvent, handler: DataGridPluginEventHandler<DataGridEventArgs<TPluginEvents, TEvent>>) => () => void;
+    /** Emits a plugin/local event to other subscribers. */
+    emit: <TEvent extends DataGridEventName<TPluginEvents>>(event: TEvent, ...args: DataGridEventArgs<TPluginEvents, TEvent>) => void;
+    /** Registers a cleanup hook that runs when the plugin is disposed. */
+    registerCleanup: (cleanup: () => void) => void;
+}
+export interface DataGridPlugin<THostEvents extends DataGridEventMap = DataGridEventMap, TPluginEvents extends DataGridEventMap = DataGridEventMap, TCapabilities extends DataGridPluginCapabilityMap = DataGridPluginCapabilityMap> {
+    id: string;
+    capabilities?: readonly DataGridPluginCapabilityName<TCapabilities>[];
+    setup(context: DataGridPluginSetupContext<THostEvents, TPluginEvents, TCapabilities>): void | (() => void);
+}
+export type DataGridPluginDefinition<THostEvents extends DataGridEventMap = DataGridEventMap, TPluginEvents extends DataGridEventMap = DataGridEventMap, TCapabilities extends DataGridPluginCapabilityMap = DataGridPluginCapabilityMap> = DataGridPlugin<THostEvents, TPluginEvents, TCapabilities> | (() => DataGridPlugin<THostEvents, TPluginEvents, TCapabilities>);
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

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

package/dist/plugins/types.js

@@ -0,0 +1,3 @@
+// src/datagrid/plugins/types.ts
+// Shared plugin interfaces for DataGrid/DataGrid with typed event maps.
+export {};

package/dist/src/a11y/headlessA11yStateMachine.d.ts

@@ -0,0 +1,60 @@
+import type { DataGridRowId } from "../models/rowModel";
+export type DataGridA11yKeyCommandKey = "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Tab" | "Enter" | "Escape";
+export interface DataGridA11yKeyboardCommand {
+    key: DataGridA11yKeyCommandKey;
+    shiftKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+    pageSize?: number;
+}
+export interface DataGridA11yFocusCell {
+    rowIndex: number;
+    colIndex: number;
+    rowId?: DataGridRowId;
+    columnKey?: string;
+}
+export interface DataGridA11ySnapshot {
+    rowCount: number;
+    colCount: number;
+    gridFocused: boolean;
+    focusCell: DataGridA11yFocusCell | null;
+    activeDescendantId: string | null;
+}
+export interface DataGridA11yGridAriaState {
+    role: "grid";
+    tabIndex: number;
+    ariaRowCount: number;
+    ariaColCount: number;
+    ariaActiveDescendant: string | null;
+    ariaMultiselectable: boolean;
+}
+export interface DataGridA11yCellAriaState {
+    id: string;
+    role: "gridcell";
+    tabIndex: number;
+    ariaRowIndex: number;
+    ariaColIndex: number;
+    ariaSelected: boolean;
+}
+export type DataGridA11yStateListener = (snapshot: DataGridA11ySnapshot) => void;
+export interface CreateDataGridA11yStateMachineOptions {
+    rowCount: number;
+    colCount: number;
+    idPrefix?: string;
+    initialGridFocused?: boolean;
+    initialFocusCell?: DataGridA11yFocusCell | null;
+    resolveCellId?: (cell: DataGridA11yFocusCell) => string;
+}
+export interface DataGridA11yStateMachine {
+    snapshot(): DataGridA11ySnapshot;
+    setDimensions(rowCount: number, colCount: number): DataGridA11ySnapshot;
+    setFocusCell(cell: DataGridA11yFocusCell | null): DataGridA11ySnapshot;
+    focusGrid(focused: boolean): DataGridA11ySnapshot;
+    dispatchKeyboard(command: DataGridA11yKeyboardCommand): DataGridA11ySnapshot;
+    getGridAria(): DataGridA11yGridAriaState;
+    getCellAria(cell: DataGridA11yFocusCell): DataGridA11yCellAriaState;
+    subscribe(listener: DataGridA11yStateListener): () => void;
+}
+export declare function createDataGridA11yStateMachine(options: CreateDataGridA11yStateMachineOptions): DataGridA11yStateMachine;
+//# sourceMappingURL=headlessA11yStateMachine.d.ts.map

package/dist/src/a11y/headlessA11yStateMachine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headlessA11yStateMachine.d.ts","sourceRoot":"","sources":["../../../src/a11y/headlessA11yStateMachine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,MAAM,yBAAyB,GACjC,SAAS,GACT,WAAW,GACX,WAAW,GACX,YAAY,GACZ,MAAM,GACN,KAAK,GACL,QAAQ,GACR,UAAU,GACV,KAAK,GACL,OAAO,GACP,QAAQ,CAAA;AAEZ,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,yBAAyB,CAAA;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACvC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,mBAAmB,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAA;AAEhF,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAA;IAC/C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,MAAM,CAAA;CACxD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,IAAI,oBAAoB,CAAA;IAChC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAAA;IACvE,YAAY,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,GAAG,oBAAoB,CAAA;IACtE,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAAA;IACjD,gBAAgB,CAAC,OAAO,EAAE,2BAA2B,GAAG,oBAAoB,CAAA;IAC5E,WAAW,IAAI,yBAAyB,CAAA;IACxC,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,yBAAyB,CAAA;IACnE,SAAS,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI,CAAA;CAC3D;AAkFD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,wBAAwB,CA4M1B"}