@affino/datagrid-core 0.3.2 → 0.3.4

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":"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"}

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, invokeDataGridCellInteraction, parseDataGridCellDraftValue, resolveDataGridCellInteraction, resolveDataGridCellClickAction, resolveDataGridCellKeyboardAction, resolveDataGridCellType, toggleDataGridCellValue, type BuildDataGridCellRenderModelOptions, type CreateDataGridCellTypeRegistryOptions, type DataGridCellClickAction, type DataGridCellInteractionContext, type DataGridCellEditorMode, type DataGridCellKeyboardAction, type DataGridCellKeyboardContext, type DataGridCellParserContext, type DataGridCellRenderModel, type DataGridResolvedCellInteraction, type DataGridCellTypeContext, type DataGridCellTypeDefinition, type DataGridCellTypeId, type DataGridCellTypeOption, type DataGridCellTypeRegistry, type InvokeDataGridCellInteractionOptions, type ParseDataGridCellDraftValueOptions, type ResolveDataGridCellInteractionOptions, 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,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,mCAAmC,EACxC,KAAK,qCAAqC,EAC1C,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,oCAAoC,EACzC,KAAK,kCAAkC,EACvC,KAAK,qCAAqC,EAC1C,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, invokeDataGridCellInteraction, parseDataGridCellDraftValue, resolveDataGridCellInteraction, resolveDataGridCellClickAction, resolveDataGridCellKeyboardAction, resolveDataGridCellType, toggleDataGridCellValue, } from "./runtime.js";

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

@@ -0,0 +1,127 @@
+import type { DataGridCellInteractionInvocationTrigger, DataGridCellInteractionKeyboardTrigger, DataGridCellInteractionRole, DataGridColumnCellInteractionContext, DataGridColumnDef } from "../models/columnModel.js";
+export type DataGridCellTypeId = "text" | "number" | "currency" | "checkbox" | "select" | "date" | "datetime" | "formula" | "percent";
+export type DataGridCellKeyboardAction = "none" | "navigate" | "startEdit" | "openSelect" | "invoke" | "toggle";
+export type DataGridCellClickAction = "none" | "invoke" | "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 DataGridCellInteractionContext<TRow = unknown> extends DataGridColumnCellInteractionContext<TRow> {
+}
+export interface DataGridResolvedCellInteraction {
+    role?: DataGridCellInteractionRole;
+    label?: string;
+    disabled: boolean;
+    keyboard: readonly DataGridCellInteractionKeyboardTrigger[];
+    click: boolean;
+    pressed?: "true" | "false" | "mixed";
+    checked?: "true" | "false" | "mixed";
+    invoke: (trigger: DataGridCellInteractionInvocationTrigger) => void;
+}
+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;
+    rowId?: string | number | null | undefined;
+    editable: boolean;
+    key: string;
+    printable?: boolean;
+    registry?: DataGridCellTypeRegistry;
+}
+export interface ResolveDataGridCellClickActionOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    row?: TRow | null | undefined;
+    rowId?: string | number | null | undefined;
+    editable: boolean;
+    registry?: DataGridCellTypeRegistry;
+}
+export interface ResolveDataGridCellInteractionOptions<TRow = unknown> {
+    column: DataGridColumnDef<TRow>;
+    row?: TRow | null | undefined;
+    rowId?: string | number | null | undefined;
+    value?: unknown;
+    editable: boolean;
+}
+export interface InvokeDataGridCellInteractionOptions<TRow = unknown> extends ResolveDataGridCellInteractionOptions<TRow> {
+    trigger: DataGridCellInteractionInvocationTrigger;
+}
+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 resolveDataGridCellInteraction<TRow = unknown>(options: ResolveDataGridCellInteractionOptions<TRow>): DataGridResolvedCellInteraction | null;
+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 invokeDataGridCellInteraction<TRow = unknown>(options: InvokeDataGridCellInteractionOptions<TRow>): boolean;
+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":"AACA,OAAO,KAAK,EACV,wCAAwC,EACxC,sCAAsC,EACtC,2BAA2B,EAE3B,oCAAoC,EACpC,iBAAiB,EAClB,MAAM,0BAA0B,CAAA;AAEjC,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,QAAQ,GACR,UAAU,GACV,UAAU,GACV,QAAQ,GACR,MAAM,GACN,UAAU,GACV,SAAS,GACT,SAAS,CAAA;AAEb,MAAM,MAAM,0BAA0B,GAClC,MAAM,GACN,UAAU,GACV,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,QAAQ,CAAA;AAEZ,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAElE,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;AAErF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,sBAAsB,CAAA;IAClC,WAAW,EAAE,uBAAuB,CAAA;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC9B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,8BAA8B,CAAC,IAAI,GAAG,OAAO,CAC5D,SAAQ,oCAAoC,CAAC,IAAI,CAAC;CAAG;AAEvD,MAAM,WAAW,+BAA+B;IAC9C,IAAI,CAAC,EAAE,2BAA2B,CAAA;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,SAAS,sCAAsC,EAAE,CAAA;IAC3D,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;IACpC,MAAM,EAAE,CAAC,OAAO,EAAE,wCAAwC,KAAK,IAAI,CAAA;CACpE;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC9B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC9B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,uBAAuB,KAAK,MAAM,CAAA;IACxE,gBAAgB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,MAAM,CAAA;IACvF,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAA;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,WAAW,EAAE,0BAA0B,CAAC,CAAC,CAAA;IAC9F,UAAU,CAAC,EAAE,sBAAsB,CAAA;IACnC,WAAW,CAAC,EAAE,uBAAuB,CAAA;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS,CAAA;IACvD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,0BAA0B,GAAG,wBAAwB,CAAA;IAC1E,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAA;CACjE;AAED,MAAM,WAAW,qCAAqC;IACpD,WAAW,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAA;CACpD;AAED,MAAM,WAAW,8BAA8B,CAAC,IAAI,GAAG,OAAO;IAC5D,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,wBAAwB,CAAA;CACpC;AAED,MAAM,WAAW,mCAAmC,CAAC,IAAI,GAAG,OAAO;IACjE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,wBAAwB,CAAA;CACpC;AAED,MAAM,WAAW,kCAAkC,CAAC,IAAI,GAAG,OAAO;IAChE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,wBAAwB,CAAA;CACpC;AAED,MAAM,WAAW,wCAAwC,CAAC,IAAI,GAAG,OAAO;IACtE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1C,QAAQ,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,wBAAwB,CAAA;CACpC;AAED,MAAM,WAAW,qCAAqC,CAAC,IAAI,GAAG,OAAO;IACnE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1C,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,wBAAwB,CAAA;CACpC;AAED,MAAM,WAAW,qCAAqC,CAAC,IAAI,GAAG,OAAO;IACnE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,oCAAoC,CAAC,IAAI,GAAG,OAAO,CAClE,SAAQ,qCAAqC,CAAC,IAAI,CAAC;IACnD,OAAO,EAAE,wCAAwC,CAAA;CAClD;AAED,MAAM,WAAW,8BAA8B,CAAC,IAAI,GAAG,OAAO;IAC5D,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC/B,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AA8TD,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,qCAA0C,GAClD,wBAAwB,CAiC1B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,GAAG,OAAO,EACpD,OAAO,EAAE,8BAA8B,CAAC,IAAI,CAAC,GAC5C,0BAA0B,CAM5B;AAED,wBAAgB,4BAA4B,CAAC,IAAI,GAAG,OAAO,EACzD,OAAO,EAAE,mCAAmC,CAAC,IAAI,CAAC,GACjD,uBAAuB,CAuCzB;AAED,wBAAgB,8BAA8B,CAAC,IAAI,GAAG,OAAO,EAC3D,OAAO,EAAE,qCAAqC,CAAC,IAAI,CAAC,GACnD,+BAA+B,GAAG,IAAI,CAkCxC;AAED,wBAAgB,2BAA2B,CAAC,IAAI,GAAG,OAAO,EACxD,OAAO,EAAE,kCAAkC,CAAC,IAAI,CAAC,GAChD,OAAO,CAaT;AAED,wBAAgB,iCAAiC,CAAC,IAAI,GAAG,OAAO,EAC9D,OAAO,EAAE,wCAAwC,CAAC,IAAI,CAAC,GACtD,0BAA0B,CAwC5B;AAED,wBAAgB,8BAA8B,CAAC,IAAI,GAAG,OAAO,EAC3D,OAAO,EAAE,qCAAqC,CAAC,IAAI,CAAC,GACnD,uBAAuB,CAkBzB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,GAAG,OAAO,EAC1D,OAAO,EAAE,oCAAoC,CAAC,IAAI,CAAC,GAClD,OAAO,CAgBT;AAED,wBAAgB,uBAAuB,CAAC,IAAI,GAAG,OAAO,EACpD,OAAO,EAAE,8BAA8B,CAAC,IAAI,CAAC,GAC5C,OAAO,CAKT"}