@affino/datagrid-core 0.3.1 → 0.3.3

package/README.md

@@ -2,6 +2,32 @@
 
 Framework-agnostic data grid core.
 
+## Canonical Feature Catalog
+
+Single source of truth for platform capabilities:
+
+- [DataGrid Feature Catalog](https://github.com/affinio/affinio/blob/main/docs/datagrid-feature-catalog.md)
+
+## Formula engine boundary
+
+Base formula APIs now have a dedicated package boundary:
+
+- community: [@affino/datagrid-formula-engine](/Users/anton/Projects/affinio/datagrid/packages/datagrid-formula-engine/README.md)
+- boundary doc: [/Users/anton/Projects/affinio/datagrid/docs/datagrid-formula-engine-community-vs-enterprise.md](/Users/anton/Projects/affinio/datagrid/docs/datagrid-formula-engine-community-vs-enterprise.md)
+
+Keep row-model orchestration and formula integration inside `@affino/datagrid-core`.
+Use `@affino/datagrid-formula-engine` for formula parsing/compile/graph APIs.
+
+## Pivot boundary
+
+Base pivot APIs now also have a dedicated package boundary:
+
+- community: [@affino/datagrid-pivot](/Users/anton/Projects/affinio/datagrid/packages/datagrid-pivot/README.md)
+- boundary doc: [/Users/anton/Projects/affinio/datagrid/docs/datagrid-pivot-community-vs-enterprise.md](/Users/anton/Projects/affinio/datagrid/docs/datagrid-pivot-community-vs-enterprise.md)
+
+Keep row-model orchestration and pivot runtime integration inside `@affino/datagrid-core`.
+Use `@affino/datagrid-pivot` for pivot contracts and pure pivot helper APIs.
+
 ## Layer boundaries (Core vs Orchestration vs Adapter)
 
 - Keep in `@affino/datagrid-core`:
@@ -58,7 +84,7 @@ Core naming is fully canonicalized to `DataGrid*` across stable, advanced, and i
   - keeps legacy behavior: increments row revision and recomputes filter/sort/group projection.
 - `patchRows(updates, options?)`:
   - partial updates by `rowId` (cell-level/streaming updates).
-  - defaults are backward-compatible (`recomputeSort/filter/group = true`).
+  - defaults are Excel-like (`recomputeSort/filter/group = false`) to keep current view stable during edits.
   - can disable projection phases for UX stability:
     - `recomputeSort: false`
     - `recomputeFilter: false`
@@ -75,7 +101,7 @@ When all recompute flags are disabled, cell values update and snapshot revision
 
 Client projection is internally modeled as a stage graph:
 
-- `filter -> sort -> group -> paginate -> visible`
+- `filter -> sort -> group -> pivot -> aggregate -> paginate -> visible`
 
 Stage dirty state is propagated through dependencies, and snapshot includes `projection` diagnostics (`version`, `staleStages`) for devtools/integration debugging.
 `patchRows` uses field-aware invalidation internally: only stages whose dependency fields intersect patched fields are invalidated.
@@ -83,6 +109,40 @@ Projection recompute is dirty-stage driven (not full-pass): blocked stages (`rec
 Projection diagnostics expose cycle vs actual recompute semantics: `version`/`cycleVersion` increase every projection cycle, while `recomputeVersion` increases only when at least one stage actually recomputed.
 For `treeData`, set `dependencyFields` to avoid unnecessary regroup/tree projection on unrelated cell patches.
 
+## Pivot Model (Engine Primitive)
+
+Client row model supports declarative pivot projection via:
+
+- `setPivotModel(pivotSpec | null)`
+- `getPivotModel()`
+
+Minimal V1 pivot spec:
+
+```ts
+{
+  rows: ["team"],
+  columns: ["year"],
+  values: [{ field: "revenue", agg: "sum" }],
+  rowSubtotals: true, // optional
+  grandTotal: true,   // optional
+}
+```
+
+Pivot is executed as a pure projection stage and exposes deterministic runtime pivot columns in snapshot:
+
+- `snapshot.pivotModel`
+- `snapshot.pivotColumns`
+
+Current V1 scope/limitations:
+
+- Pivot is flat (projected rows are leaf-like; no pivot expand/collapse yet).
+- Optional totals are available: `rowSubtotals` (for multi-level row axis) and `grandTotal`.
+- Pivot values are taken from `pivotModel.values` and aggregated inside pivot stage.
+  `aggregationModel` group-aggregate stage is bypassed while pivot is active.
+- Pivot aggregation uses an incremental state path for `sum/count/countNonNull/avg`
+  and falls back to leaf-bucket recompute for other ops (`min/max/first/last/custom`).
+- Pivot invalidation is field-aware, but recompute is full-stage (no incremental pivot recompute yet).
+
 ## Deterministic Integration Snapshot
 
 Viewport integration should read deterministic state from controller snapshot API instead of peeking into internal signals or DOM transforms:

package/dist/src/advanced.d.ts

@@ -7,7 +7,7 @@ export { createDataGridAdapterRuntime, resolveDataGridAdapterEventName, type Dat
 export { createDataGridTransactionService, type DataGridTransactionAffectedRange, type DataGridTransactionCommand, type DataGridTransactionMeta, type DataGridTransactionInput, type DataGridTransactionSnapshot, type DataGridTransactionPendingBatchSnapshot, type DataGridTransactionExecutionContext, type DataGridTransactionDirection, type DataGridTransactionExecutor, type DataGridTransactionService, type DataGridTransactionServiceHooks, type DataGridTransactionAppliedEvent, type DataGridTransactionRolledBackEvent, type DataGridTransactionHistoryEvent, type DataGridTransactionEventEntry, type DataGridTransactionListener, type CreateDataGridTransactionServiceOptions, } from "./core/transactionService.js";
 export { createDataGridA11yStateMachine, type CreateDataGridA11yStateMachineOptions, type DataGridA11yCellAriaState, type DataGridA11yFocusCell, type DataGridA11yGridAriaState, type DataGridA11yKeyboardCommand, type DataGridA11yKeyCommandKey, type DataGridA11ySnapshot, type DataGridA11yStateListener, type DataGridA11yStateMachine, } from "./a11y/index.js";
 export { createDataGridViewportController, type DataGridViewportController, type DataGridViewportControllerOptions, type DataGridViewportImperativeCallbacks, type DataGridViewportRuntimeOverrides, type DataGridVirtualWindowSnapshot, type ViewportMetricsSnapshot as DataGridViewportMetricsSnapshot, type ViewportIntegrationSnapshot as DataGridViewportIntegrationSnapshot, type ViewportSyncTargets as DataGridViewportSyncTargets, type ViewportSyncState as DataGridViewportSyncState, type DataGridViewportState, type RowPoolItem as DataGridRowPoolItem, type ImperativeWindowUpdatePayload as DataGridImperativeWindowUpdatePayload, type ImperativeColumnUpdatePayload as DataGridImperativeColumnUpdatePayload, type ImperativeRowUpdatePayload as DataGridImperativeRowUpdatePayload, type ImperativeScrollSyncPayload as DataGridImperativeScrollSyncPayload, } from "./viewport/dataGridViewportController.js";
-export { createDataSourceBackedRowModel, type CreateDataSourceBackedRowModelOptions, type DataSourceBackedRowModel, type DataGridDataSource, type DataGridDataSourceBackpressureDiagnostics, type DataGridDataSourceInvalidation, type DataGridDataSourcePullPriority, type DataGridDataSourcePullReason, type DataGridDataSourcePullRequest, type DataGridDataSourcePullResult, type DataGridDataSourceTreePullContext, type DataGridDataSourceTreePullOperation, type DataGridDataSourceTreePullScope, type DataGridDataSourcePushEvent, type DataGridDataSourcePushInvalidateEvent, type DataGridDataSourcePushListener, type DataGridDataSourcePushRemoveEvent, type DataGridDataSourcePushUpsertEvent, type DataGridDataSourceRowEntry, } from "./models/index.js";
+export { createDataSourceBackedRowModel, type CreateDataSourceBackedRowModelOptions, type DataSourceBackedRowModel, type DataGridDataSource, type DataGridDataSourceBackpressureDiagnostics, type DataGridDataSourceInvalidation, type DataGridDataSourcePaginationPullContext, type DataGridDataSourcePullPriority, type DataGridDataSourcePivotPullContext, type DataGridDataSourcePullReason, type DataGridDataSourcePullRequest, type DataGridDataSourcePullResult, type DataGridServerPivotRowIdInput, type DataGridServerPivotRowRole, type DataGridDataSourceTreePullContext, type DataGridDataSourceTreePullOperation, type DataGridDataSourceTreePullScope, type DataGridDataSourcePushEvent, type DataGridDataSourcePushInvalidateEvent, type DataGridDataSourcePushListener, type DataGridDataSourcePushRemoveEvent, type DataGridDataSourcePushUpsertEvent, type DataGridDataSourceRowEntry, createDataGridServerPivotRowId, } from "./models/index.js";
 export { applyGroupSelectionPolicy, clampGridSelectionPoint, clampSelectionArea, createGridSelectionContextFromFlattenedRows, createGridSelectionRange, createGridSelectionRangeFromInput, normalizeGridSelectionRange, type GridSelectionFlattenedRow, type GridSelectionContext, type GridSelectionPoint, type GridSelectionPointLike, type GridSelectionRange, type GridSelectionRangeInput, type GridSelectionGroupPolicyOptions, } from "./selection/selectionState.js";
 export { transformDataGridPublicProtocolSource, type DataGridCodemodResult, } from "./protocol/index.js";
 export type { DataGridAdvancedEventMap, DataGridAdvancedEventName, DataGridEventAffectedRange, DataGridEventEnvelope, DataGridEventPhase, DataGridEventSource, DataGridEventTier, DataGridInternalEventMap, DataGridInternalEventName, DataGridStableEventMap, DataGridStableEventName, } from "./protocol/index.js";

package/dist/src/advanced.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../src/advanced.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../src/advanced.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,qBAAqB,EACrB,eAAe,IAAI,uBAAuB,EAC1C,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,iCAAiC,EACtC,KAAK,6BAA6B,EAClC,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,GACtC,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,mCAAmC,EACxC,KAAK,sBAAsB,GAC5B,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EACL,gCAAgC,EAChC,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,uCAAuC,EAC5C,KAAK,mCAAmC,EACxC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,kCAAkC,EACvC,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,uCAAuC,GAC7C,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,8BAA8B,EAC9B,KAAK,qCAAqC,EAC1C,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,gCAAgC,EAChC,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,gCAAgC,EACrC,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,IAAI,+BAA+B,EAC/D,KAAK,2BAA2B,IAAI,mCAAmC,EACvE,KAAK,mBAAmB,IAAI,2BAA2B,EACvD,KAAK,iBAAiB,IAAI,yBAAyB,EACnD,KAAK,qBAAqB,EAC1B,KAAK,WAAW,IAAI,mBAAmB,EACvC,KAAK,6BAA6B,IAAI,qCAAqC,EAC3E,KAAK,6BAA6B,IAAI,qCAAqC,EAC3E,KAAK,0BAA0B,IAAI,kCAAkC,EACrE,KAAK,2BAA2B,IAAI,mCAAmC,GACxE,MAAM,0CAA0C,CAAA;AAEjD,OAAO,EACL,8BAA8B,EAC9B,KAAK,qCAAqC,EAC1C,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,yCAAyC,EAC9C,KAAK,8BAA8B,EACnC,KAAK,uCAAuC,EAC5C,KAAK,8BAA8B,EACnC,KAAK,kCAAkC,EACvC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,qCAAqC,EAC1C,KAAK,8BAA8B,EACnC,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACtC,KAAK,0BAA0B,EAC/B,8BAA8B,GAC/B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,kBAAkB,EAClB,2CAA2C,EAC3C,wBAAwB,EACxB,iCAAiC,EACjC,2BAA2B,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,GACrC,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,qCAAqC,EACrC,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,qBAAqB,CAAA"}

package/dist/src/advanced.js

@@ -7,7 +7,7 @@ export { createDataGridAdapterRuntime, resolveDataGridAdapterEventName, } from "
 export { createDataGridTransactionService, } from "./core/transactionService.js";
 export { createDataGridA11yStateMachine, } from "./a11y/index.js";
 export { createDataGridViewportController, } from "./viewport/dataGridViewportController.js";
-export { createDataSourceBackedRowModel, } from "./models/index.js";
+export { createDataSourceBackedRowModel, createDataGridServerPivotRowId, } from "./models/index.js";
 export { applyGroupSelectionPolicy, clampGridSelectionPoint, clampSelectionArea, createGridSelectionContextFromFlattenedRows, createGridSelectionRange, createGridSelectionRangeFromInput, normalizeGridSelectionRange, } from "./selection/selectionState.js";
 export { transformDataGridPublicProtocolSource, } from "./protocol/index.js";
 export { DATAGRID_EVENT_TIERS, DATAGRID_EVENT_TIER_ENTRYPOINTS, createDataGridEventEnvelope, isDataGridEventTier, } from "./protocol/index.js";

package/dist/src/cells/index.d.ts

@@ -0,0 +1,2 @@
+export { buildDataGridCellRenderModel, createDataGridCellTypeRegistry, parseDataGridCellDraftValue, resolveDataGridCellClickAction, resolveDataGridCellKeyboardAction, resolveDataGridCellType, toggleDataGridCellValue, type BuildDataGridCellRenderModelOptions, type CreateDataGridCellTypeRegistryOptions, type DataGridCellClickAction, type DataGridCellEditorMode, type DataGridCellKeyboardAction, type DataGridCellKeyboardContext, type DataGridCellParserContext, type DataGridCellRenderModel, type DataGridCellTypeContext, type DataGridCellTypeDefinition, type DataGridCellTypeId, type DataGridCellTypeOption, type DataGridCellTypeRegistry, type ParseDataGridCellDraftValueOptions, type ResolveDataGridCellClickActionOptions, type ResolveDataGridCellKeyboardActionOptions, type ResolveDataGridCellTypeOptions, type ToggleDataGridCellValueOptions, } from "./runtime.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/cells/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cells/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAC3B,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,mCAAmC,EACxC,KAAK,qCAAqC,EAC1C,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EACvC,KAAK,qCAAqC,EAC1C,KAAK,wCAAwC,EAC7C,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,GACpC,MAAM,cAAc,CAAA"}

package/dist/src/cells/index.js

@@ -0,0 +1 @@
+export { buildDataGridCellRenderModel, createDataGridCellTypeRegistry, parseDataGridCellDraftValue, resolveDataGridCellClickAction, resolveDataGridCellKeyboardAction, resolveDataGridCellType, toggleDataGridCellValue, } from "./runtime.js";

package/dist/src/cells/runtime.d.ts

@@ -0,0 +1,101 @@
+import type { DataGridColumnDef } from "../models/columnModel.js";
+export type DataGridCellTypeId = "text" | "number" | "currency" | "checkbox" | "select" | "date" | "datetime" | "formula" | "percent";
+export type DataGridCellKeyboardAction = "none" | "navigate" | "startEdit" | "openSelect" | "toggle";
+export type DataGridCellClickAction = "none" | "toggle";
+export type DataGridCellEditorMode = "none" | "text" | "select" | "date" | "datetime";
+export interface DataGridCellTypeOption {
+    label: string;
+    value: unknown;
+}
+export interface DataGridCellRenderModel {
+    value: unknown;
+    formattedValue: string;
+    displayValue: string;
+    cellType: string;
+    editable: boolean;
+    selected: boolean;
+    focused: boolean;
+    editorMode: DataGridCellEditorMode;
+    clickAction: DataGridCellClickAction;
+}
+export interface DataGridCellTypeContext {
+    column: DataGridColumnDef<any>;
+    row?: unknown;
+    value: unknown;
+}
+export interface DataGridCellParserContext {
+    column: DataGridColumnDef<any>;
+    row?: unknown;
+    draft: string;
+}
+export interface DataGridCellKeyboardContext {
+    column: DataGridColumnDef<any>;
+    row?: unknown;
+    editable: boolean;
+    key: string;
+    printable: boolean;
+}
+export interface DataGridCellTypeDefinition {
+    id: string;
+    formatter?: (value: unknown, context: DataGridCellTypeContext) => string;
+    displayFormatter?: (formattedValue: string, context: DataGridCellTypeContext) => string;
+    parser?: (draft: string, context: DataGridCellParserContext) => unknown;
+    keyboard?: Partial<Record<"enter" | "space" | "f2" | "printable", DataGridCellKeyboardAction>>;
+    editorMode?: DataGridCellEditorMode;
+    clickAction?: DataGridCellClickAction;
+}
+export interface DataGridCellTypeRegistry {
+    get(id: string): DataGridCellTypeDefinition | undefined;
+    has(id: string): boolean;
+    register(definition: DataGridCellTypeDefinition): DataGridCellTypeRegistry;
+    snapshot(): Readonly<Record<string, DataGridCellTypeDefinition>>;
+}
+export interface CreateDataGridCellTypeRegistryOptions {
+    definitions?: readonly DataGridCellTypeDefinition[];
+}
+export interface ResolveDataGridCellTypeOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    registry?: DataGridCellTypeRegistry;
+}
+export interface BuildDataGridCellRenderModelOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    row?: TRow | null | undefined;
+    value?: unknown;
+    editable?: boolean;
+    selected?: boolean;
+    focused?: boolean;
+    registry?: DataGridCellTypeRegistry;
+}
+export interface ParseDataGridCellDraftValueOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    row?: TRow | null | undefined;
+    draft: string;
+    registry?: DataGridCellTypeRegistry;
+}
+export interface ResolveDataGridCellKeyboardActionOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    row?: TRow | null | undefined;
+    editable: boolean;
+    key: string;
+    printable?: boolean;
+    registry?: DataGridCellTypeRegistry;
+}
+export interface ResolveDataGridCellClickActionOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    row?: TRow | null | undefined;
+    editable: boolean;
+    registry?: DataGridCellTypeRegistry;
+}
+export interface ToggleDataGridCellValueOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    row?: TRow | null | undefined;
+    value?: unknown;
+}
+export declare function createDataGridCellTypeRegistry(options?: CreateDataGridCellTypeRegistryOptions): DataGridCellTypeRegistry;
+export declare function resolveDataGridCellType<TRow = unknown>(options: ResolveDataGridCellTypeOptions<TRow>): DataGridCellTypeDefinition;
+export declare function buildDataGridCellRenderModel<TRow = unknown>(options: BuildDataGridCellRenderModelOptions<TRow>): DataGridCellRenderModel;
+export declare function parseDataGridCellDraftValue<TRow = unknown>(options: ParseDataGridCellDraftValueOptions<TRow>): unknown;
+export declare function resolveDataGridCellKeyboardAction<TRow = unknown>(options: ResolveDataGridCellKeyboardActionOptions<TRow>): DataGridCellKeyboardAction;
+export declare function resolveDataGridCellClickAction<TRow = unknown>(options: ResolveDataGridCellClickActionOptions<TRow>): DataGridCellClickAction;
+export declare function toggleDataGridCellValue<TRow = unknown>(options: ToggleDataGridCellValueOptions<TRow>): boolean;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/cells/runtime.d.ts.map

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

package/dist/src/cells/runtime.js

@@ -0,0 +1,392 @@
+import { formatDataGridCellValue } from "../columns/formatting.js";
+const DEFAULT_TEXT_CELL_TYPE = {
+    id: "text",
+    formatter: value => value == null ? "" : String(value),
+    parser: draft => draft,
+    editorMode: "text",
+    clickAction: "none",
+    keyboard: {
+        enter: "startEdit",
+        f2: "startEdit",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_NUMBER_CELL_TYPE = {
+    id: "number",
+    formatter: (value, context) => formatDataGridCellValue(value, context.column),
+    parser: draft => parseNumericDraft(draft),
+    editorMode: "text",
+    clickAction: "none",
+    keyboard: {
+        enter: "startEdit",
+        f2: "startEdit",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_CURRENCY_CELL_TYPE = {
+    id: "currency",
+    formatter: (value, context) => formatDataGridCellValue(value, context.column),
+    parser: draft => parseCurrencyDraft(draft),
+    editorMode: "text",
+    clickAction: "none",
+    keyboard: {
+        enter: "startEdit",
+        f2: "startEdit",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_PERCENT_CELL_TYPE = {
+    id: "percent",
+    formatter: (value, context) => formatDataGridCellValue(value, context.column),
+    parser: draft => parsePercentDraft(draft),
+    editorMode: "text",
+    clickAction: "none",
+    keyboard: {
+        enter: "startEdit",
+        f2: "startEdit",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_CHECKBOX_CELL_TYPE = {
+    id: "checkbox",
+    formatter: value => coerceBoolean(value) ? "true" : "false",
+    displayFormatter: (_, context) => coerceBoolean(context.value) ? "☑" : "☐",
+    parser: draft => parseBooleanDraft(draft),
+    editorMode: "none",
+    clickAction: "toggle",
+    keyboard: {
+        enter: "toggle",
+        f2: "none",
+        printable: "none",
+        space: "toggle",
+    },
+};
+const DEFAULT_SELECT_CELL_TYPE = {
+    id: "select",
+    formatter: (value, context) => formatSelectValue(value, context.column, context.row),
+    parser: (draft, context) => parseSelectDraft(draft, context.column, context.row),
+    editorMode: "select",
+    clickAction: "none",
+    keyboard: {
+        enter: "openSelect",
+        f2: "openSelect",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_DATE_CELL_TYPE = {
+    id: "date",
+    formatter: (value, context) => formatDataGridCellValue(value, context.column),
+    parser: draft => parseDateDraft(draft),
+    editorMode: "date",
+    clickAction: "none",
+    keyboard: {
+        enter: "startEdit",
+        f2: "startEdit",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_DATETIME_CELL_TYPE = {
+    id: "datetime",
+    formatter: (value, context) => formatDataGridCellValue(value, context.column),
+    parser: draft => parseDateDraft(draft),
+    editorMode: "datetime",
+    clickAction: "none",
+    keyboard: {
+        enter: "startEdit",
+        f2: "startEdit",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_FORMULA_CELL_TYPE = {
+    id: "formula",
+    formatter: value => value == null ? "" : String(value),
+    parser: draft => draft,
+    editorMode: "text",
+    clickAction: "none",
+    keyboard: {
+        enter: "startEdit",
+        f2: "startEdit",
+        printable: "startEdit",
+        space: "navigate",
+    },
+};
+const DEFAULT_CELL_TYPE_DEFINITIONS = Object.freeze([
+    DEFAULT_TEXT_CELL_TYPE,
+    DEFAULT_NUMBER_CELL_TYPE,
+    DEFAULT_CURRENCY_CELL_TYPE,
+    DEFAULT_PERCENT_CELL_TYPE,
+    DEFAULT_CHECKBOX_CELL_TYPE,
+    DEFAULT_SELECT_CELL_TYPE,
+    DEFAULT_DATE_CELL_TYPE,
+    DEFAULT_DATETIME_CELL_TYPE,
+    DEFAULT_FORMULA_CELL_TYPE,
+]);
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object";
+}
+function readRowValue(row, column) {
+    if (typeof column.accessor === "function" && row != null) {
+        return column.accessor(row);
+    }
+    if (typeof column.valueGetter === "function" && row != null) {
+        return column.valueGetter(row);
+    }
+    if (row == null || !isRecord(row)) {
+        return undefined;
+    }
+    const field = typeof column.field === "string" && column.field.length > 0 ? column.field : column.key;
+    const rowRecord = row;
+    return rowRecord[field];
+}
+function normalizeNumericText(draft) {
+    return draft
+        .trim()
+        .replace(/\s+/g, "")
+        .replace(/,/g, "");
+}
+function parseNumericDraft(draft) {
+    const normalized = normalizeNumericText(draft);
+    if (normalized.length === 0) {
+        return "";
+    }
+    const numeric = Number(normalized);
+    return Number.isFinite(numeric) ? numeric : draft;
+}
+function parseCurrencyDraft(draft) {
+    const normalized = normalizeNumericText(draft).replace(/[^\d.+\-]/g, "");
+    if (normalized.length === 0) {
+        return "";
+    }
+    const numeric = Number(normalized);
+    return Number.isFinite(numeric) ? numeric : draft;
+}
+function parsePercentDraft(draft) {
+    const trimmed = draft.trim();
+    if (trimmed.length === 0) {
+        return "";
+    }
+    const hasPercentSuffix = trimmed.endsWith("%");
+    const normalized = normalizeNumericText(trimmed.replace(/%/g, ""));
+    const numeric = Number(normalized);
+    if (!Number.isFinite(numeric)) {
+        return draft;
+    }
+    return hasPercentSuffix ? numeric / 100 : numeric;
+}
+function parseDateDraft(draft) {
+    const trimmed = draft.trim();
+    if (trimmed.length === 0) {
+        return "";
+    }
+    const timestamp = Date.parse(trimmed);
+    return Number.isFinite(timestamp) ? new Date(timestamp) : draft;
+}
+function coerceBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return value !== 0;
+    }
+    if (typeof value === "string") {
+        const normalized = value.trim().toLowerCase();
+        return normalized === "true"
+            || normalized === "1"
+            || normalized === "yes"
+            || normalized === "y"
+            || normalized === "on";
+    }
+    return false;
+}
+function parseBooleanDraft(draft) {
+    return coerceBoolean(draft);
+}
+function normalizeSelectOption(option) {
+    if (isRecord(option) && typeof option.label === "string") {
+        return {
+            label: option.label,
+            value: "value" in option ? option.value : option.label,
+        };
+    }
+    return {
+        label: String(option !== null && option !== void 0 ? option : ""),
+        value: option,
+    };
+}
+function resolveColumnOptions(column, row) {
+    var _a;
+    const rawOptions = (_a = column.presentation) === null || _a === void 0 ? void 0 : _a.options;
+    const resolved = typeof rawOptions === "function"
+        ? (row != null ? rawOptions(row) : [])
+        : rawOptions;
+    if (isPromiseLike(resolved)) {
+        return [];
+    }
+    return Array.isArray(resolved) ? resolved.map(normalizeSelectOption) : [];
+}
+function formatSelectValue(value, column, row) {
+    const match = resolveColumnOptions(column, row).find(option => Object.is(option.value, value));
+    return match ? match.label : (value == null ? "" : String(value));
+}
+function parseSelectDraft(draft, column, row) {
+    const trimmed = draft.trim();
+    const match = resolveColumnOptions(column, row).find(option => {
+        var _a;
+        return (option.label === trimmed || String((_a = option.value) !== null && _a !== void 0 ? _a : "") === trimmed);
+    });
+    return match ? match.value : draft;
+}
+function isPromiseLike(value) {
+    return typeof value === "object"
+        && value !== null
+        && "then" in value
+        && typeof value.then === "function";
+}
+function normalizeCellTypeId(typeId) {
+    if (typeof typeId !== "string") {
+        return null;
+    }
+    const normalized = typeId.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+const defaultRegistry = createDataGridCellTypeRegistry();
+export function createDataGridCellTypeRegistry(options = {}) {
+    var _a;
+    const definitions = new Map();
+    const registerDefinition = (definition) => {
+        const normalizedId = normalizeCellTypeId(definition.id);
+        if (!normalizedId) {
+            throw new Error("[DataGridCellTypeRegistry] cell type id must be a non-empty string.");
+        }
+        definitions.set(normalizedId, Object.freeze({ ...definition, id: normalizedId }));
+    };
+    for (const definition of DEFAULT_CELL_TYPE_DEFINITIONS) {
+        registerDefinition(definition);
+    }
+    for (const definition of (_a = options.definitions) !== null && _a !== void 0 ? _a : []) {
+        registerDefinition(definition);
+    }
+    return {
+        get(id) {
+            return definitions.get(id);
+        },
+        has(id) {
+            return definitions.has(id);
+        },
+        register(definition) {
+            registerDefinition(definition);
+            return this;
+        },
+        snapshot() {
+            return Object.freeze(Object.fromEntries(definitions.entries()));
+        },
+    };
+}
+export function resolveDataGridCellType(options) {
+    var _a, _b, _c, _d;
+    const registry = (_a = options.registry) !== null && _a !== void 0 ? _a : defaultRegistry;
+    const cellType = normalizeCellTypeId(options.column.cellType);
+    return cellType
+        ? ((_c = (_b = registry.get(cellType)) !== null && _b !== void 0 ? _b : registry.get("text")) !== null && _c !== void 0 ? _c : DEFAULT_TEXT_CELL_TYPE)
+        : ((_d = registry.get("text")) !== null && _d !== void 0 ? _d : DEFAULT_TEXT_CELL_TYPE);
+}
+export function buildDataGridCellRenderModel(options) {
+    var _a, _b;
+    const value = arguments.length > 0 && "value" in options
+        ? options.value
+        : readRowValue(options.row, options.column);
+    const resolvedType = resolveDataGridCellType({
+        column: options.column,
+        registry: options.registry,
+    });
+    const formattedValue = resolvedType.formatter
+        ? resolvedType.formatter(value, {
+            column: options.column,
+            row: options.row,
+            value,
+        })
+        : formatDataGridCellValue(value, options.column);
+    const displayValue = resolvedType.displayFormatter
+        ? resolvedType.displayFormatter(formattedValue, {
+            column: options.column,
+            row: options.row,
+            value,
+        })
+        : formattedValue;
+    return {
+        value,
+        formattedValue,
+        displayValue,
+        cellType: resolvedType.id,
+        editable: options.editable === true,
+        selected: options.selected === true,
+        focused: options.focused === true,
+        editorMode: (_a = resolvedType.editorMode) !== null && _a !== void 0 ? _a : "text",
+        clickAction: (_b = resolvedType.clickAction) !== null && _b !== void 0 ? _b : "none",
+    };
+}
+export function parseDataGridCellDraftValue(options) {
+    const resolvedType = resolveDataGridCellType({
+        column: options.column,
+        registry: options.registry,
+    });
+    if (!resolvedType.parser) {
+        return options.draft;
+    }
+    return resolvedType.parser(options.draft, {
+        column: options.column,
+        row: options.row,
+        draft: options.draft,
+    });
+}
+export function resolveDataGridCellKeyboardAction(options) {
+    var _a, _b, _c, _d, _e;
+    if (!options.editable) {
+        if (options.key === " " || options.key === "Spacebar") {
+            return "navigate";
+        }
+        return "none";
+    }
+    const resolvedType = resolveDataGridCellType({
+        column: options.column,
+        registry: options.registry,
+    });
+    const keyboard = (_a = resolvedType.keyboard) !== null && _a !== void 0 ? _a : {};
+    if (options.key === "Enter") {
+        return (_b = keyboard.enter) !== null && _b !== void 0 ? _b : "startEdit";
+    }
+    if (options.key === " " || options.key === "Spacebar") {
+        return (_c = keyboard.space) !== null && _c !== void 0 ? _c : "navigate";
+    }
+    if (options.key === "F2") {
+        return (_d = keyboard.f2) !== null && _d !== void 0 ? _d : "startEdit";
+    }
+    if (options.printable === true) {
+        return (_e = keyboard.printable) !== null && _e !== void 0 ? _e : "startEdit";
+    }
+    return "none";
+}
+export function resolveDataGridCellClickAction(options) {
+    var _a;
+    if (!options.editable) {
+        return "none";
+    }
+    const resolvedType = resolveDataGridCellType({
+        column: options.column,
+        registry: options.registry,
+    });
+    return (_a = resolvedType.clickAction) !== null && _a !== void 0 ? _a : "none";
+}
+export function toggleDataGridCellValue(options) {
+    const value = arguments.length > 0 && "value" in options
+        ? options.value
+        : readRowValue(options.row, options.column);
+    return !coerceBoolean(value);
+}

package/dist/src/cells.d.ts

@@ -0,0 +1,2 @@
+export * from "./cells/index.js";
+//# sourceMappingURL=cells.d.ts.map

package/dist/src/cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cells.d.ts","sourceRoot":"","sources":["../../src/cells.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA"}

package/dist/src/cells.js

@@ -0,0 +1 @@
+export * from "./cells/index.js";

package/dist/src/columns/formatting.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Compatibility wrapper for historical internal imports.
+ * The shared headless implementation now lives in @affino/datagrid-format.
+ */
+export { formatDataGridCellValue } from "@affino/datagrid-format";
+//# sourceMappingURL=formatting.d.ts.map

package/dist/src/columns/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../../src/columns/formatting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA"}