persian-data-grid 0.6.0 → 0.7.0

package/dist/{GridSession-B-9lLcoB.d.cts → GridSession-CmQn2RnL.d.cts}

@@ -507,12 +507,18 @@ type ColumnVisibilityRule = {
     kind: 'whenTableType';
     tableType: string;
 };
+/**
+ * Remote flag/response resolution. The response callbacks use METHOD syntax
+ * (bivariant) so a host-typed config (`TResponse` = the host's query response)
+ * stays assignable to the default `ResolveOnConfig<K>` (`TResponse` = `unknown`)
+ * used inside the engine.
+ */
 interface ResolveOnConfig<K = unknown, TResponse = unknown> {
     endpoint: string;
     fieldName: string;
     buildParams: (row: Record<string, unknown>) => Record<string, unknown>;
-    getResponse?: (response: TResponse, row: Row) => unknown;
-    mapFlags?: (response: TResponse) => Record<string, boolean>;
+    getResponse?(response: TResponse, row: Row): unknown;
+    mapFlags?(response: TResponse): Record<string, boolean>;
 }
 type ColumnAccessControl = {
     allowRoles?: string[];
@@ -529,7 +535,8 @@ interface IDependOn {
 }
 type DefaultOptionType = {
     value?: string | number;
-    label?: string;
+    /** Renderable label; the UI-aware public type narrows it to `ReactNode`. */
+    label?: unknown;
     title?: string;
     [key: string]: unknown;
 };
@@ -578,13 +585,19 @@ interface ColumnSchema<T = unknown, K = unknown> {
         label: string;
         value: string | number;
     }[];
-    indexOptions?: (...args: unknown[]) => unknown[];
-    onChange?: (...args: unknown[]) => void;
+    /**
+     * Engine-side (loose) callback shapes. Declared with METHOD syntax
+     * (bivariant) so the precise host-facing signatures of the public
+     * `ColumnSchema` (UIRow, UITableController, ItemType, ...) stay assignable.
+     */
+    indexOptions?(...args: unknown[]): unknown[];
+    onChange?(...args: unknown[]): void;
     displayFormat?: (value: unknown) => unknown;
     minWidth?: number;
-    style?: Record<string, string | number>;
+    /** Inline style object (the public type narrows it to `CSSProperties`). */
+    style?: object;
     popUpWidth?: number;
-    dynamicSelectFilterOption?: (inputValue: string, option: unknown) => boolean;
+    dynamicSelectFilterOption?(inputValue: string, option: unknown): boolean;
     labelValue?: 'selectDisplay' | 'selectValue';
     /**
      * ColumnDef-only fields restored by `toColumnDef` (PR-81).
@@ -892,6 +905,27 @@ declare function pageWindow(page: number, pageSize: number): {
  * Typing updates drafts; Commit writes; Cancel discards.
  */
 type CellEditType = 'cell' | 'fullRow';
+/**
+ * When typed values become durable.
+ * - `immediate`: every editor change is written to the table at once (the
+ *   draft only mirrors it for a stable input). Host reads — `getRowView`,
+ *   snapshots, totals, `computed` / `resolveOn` — always see what the user
+ *   typed. `Esc` ends editing and keeps the value. Default for
+ *   `persistence: 'paged-idb'` (the arianERP document-grid contract).
+ * - `deferred`: typing only updates a session draft; the value is written when
+ *   the edit is committed (move / Enter / Tab / focus leaves the grid / a
+ *   durable read such as `getFullSnapShot`). `Esc` discards the draft.
+ *   Default for the event-sourced mode (no EventStore write per keystroke).
+ */
+type CellEditCommit = 'immediate' | 'deferred';
+/**
+ * What `Enter` does on an active cell.
+ * - `nextCell`: like `Tab` — next editable cell of the row, then the first
+ *   cell of the next row; past the last row a new empty row is added.
+ *   `Shift+Enter` goes back. (Default; the data-entry behaviour.)
+ * - `down`: commit and move to the cell below (spreadsheet style).
+ */
+type EnterNavigation = 'nextCell' | 'down';
 type CellEditValue = {
     value: unknown;
     display: unknown;
@@ -901,10 +935,15 @@ type CellEditSession = {
     /** Focused column while editing. */
     columnId: string;
     editType: CellEditType;
-    /** Values at edit start — restored on cancel. */
+    /**
+     * Values at edit start — restored on cancel. Moves forward when the draft
+     * is written without ending the session (immediate commit / flush).
+     */
     baseline: Readonly<Record<string, CellEditValue>>;
     /** Working copies. */
     drafts: Record<string, CellEditValue>;
+    /** Writes of one session share it, so undo reverts the whole edit at once. */
+    correlationId: string;
 };
 type CellEditOptions = {
     /** Default true — activate cell starts edit. False ⇒ need Enter / double-click / api.startEditingCell. */
@@ -913,6 +952,10 @@ type CellEditOptions = {
     stopEditingWhenCellsLoseFocus: boolean;
     /** Default `cell`. `fullRow` edits every editable column on the row. */
     editType: CellEditType;
+    /** Default `deferred` (createGrid picks `immediate` for `paged-idb`). */
+    commit: CellEditCommit;
+    /** Default `nextCell`. */
+    enterNavigation: EnterNavigation;
 };
 
 /**
@@ -925,6 +968,38 @@ type IRequestConfig = {
     method?: 'GET' | 'POST';
     [key: string]: unknown;
 };
+/**
+ * Envelope returned by arianERP query endpoints. Structural twin of the host's
+ * `IBaseQueryResponse<T>`: it is the response type handed to
+ * `ColumnSchema.resolveOn.getResponse` / `mapFlags`.
+ */
+interface IBaseQueryResponse<T = unknown> {
+    Result: string;
+    Error?: string;
+    ErrorCode?: string;
+    InnerException?: string;
+    AdditionalInfo?: unknown;
+    Data: T;
+    TotalCount: number;
+    ReturnCount: number;
+    ReadFromCache: boolean;
+    ExportFile?: string;
+    ExportString?: string;
+    YearPlanId?: number;
+    Url?: string;
+}
+/**
+ * `RemoteApi` as seen by host `computed` callbacks: `request()` resolves to the
+ * ERP envelope by default. The payload is `unknown`; hosts name its shape
+ * through the type argument (`request<IBaseQueryResponse<Row[]>>(…)`).
+ */
+interface HostRemoteApi {
+    request<TResponse = IBaseQueryResponse<unknown>>(input: {
+        endpoint: string;
+        params?: Record<string, unknown>;
+        method?: 'GET' | 'POST';
+    }): Promise<TResponse>;
+}
 
 interface UIRow {
     id: number;
@@ -2038,8 +2113,14 @@ declare class SparseRowIndex<T> {
     private orderedIds;
     /** id → position in `orderedIds` (PR-99). */
     private readonly posById;
+    private revisionCount;
     constructor(entries?: Iterable<readonly [number, T]>);
     get size(): number;
+    /**
+     * Bumped by every change of ids, order or values. O(1) change detection for
+     * subscribers (a sort keeps `size` but changes the order).
+     */
+    get revision(): number;
     getOrderedIds(): readonly number[];
     getById(id: number): T | undefined;
     /** O(1) position of `id`, or `-1`. */
@@ -2109,6 +2190,15 @@ declare class TableEngine {
     /** Durable command store id (for CHANGE_CELL_* on edit commit). */
     private commandStore?;
     private cellEditOptions;
+    /**
+     * Cell writes coming from editors / host input, executed one at a time in
+     * arrival order. Consecutive values for the same cell coalesce (latest
+     * wins). Until a write landed, the queued value is what the cell shows.
+     */
+    private readonly cellWrites;
+    private cellWriteChain;
+    /** > 0 while a queued write executes (re-entrant settle must not wait on itself). */
+    private cellWriteDepth;
     readonly errors: Map<string, CellError>;
     readonly searchResult: Map<string, CellError>;
     private readonly asyncCellCache;
@@ -2234,7 +2324,45 @@ declare class TableEngine {
     setCellEditOptions(partial: Partial<CellEditOptions>): void;
     getCellEditOptions(): CellEditOptions;
     getCellEdit(): CellEditSession | null;
+    /**
+     * What the cell editor shows: the session draft, else a value that was
+     * typed but whose write has not reached the table yet (no flicker back to
+     * the old value while it is in flight). `null` = show the table value.
+     */
     getEditDraft(rowId: number, columnId: string): CellEditValue | null;
+    /** Editor / host value for a cell (`UI_CELL_CHANGE`). Resolves once it is durable. */
+    inputCellValue(rowId: number, columnId: string, value: unknown): Promise<void>;
+    /** Editor / host display label for a cell (`UI_CELL_CHANGE_DISPLAY`). */
+    inputCellDisplay(rowId: number, columnId: string, display: unknown): Promise<void>;
+    private inputCell;
+    private enqueueCellWrite;
+    private runCellWrite;
+    /**
+     * Resolves when every queued cell write reached the table. Called from inside
+     * a write (re-entrant) it returns at once instead of waiting on itself.
+     */
+    settleCellWrites(): Promise<void>;
+    /** Queues CHANGE_CELL_* for `columnIds` of `session`; returns the value writes. */
+    private queueDraftWrites;
+    /**
+     * Make what the user typed durable WITHOUT ending the edit: dirty drafts are
+     * written and become the session baseline, then all queued writes settle.
+     * Every durable read (snapshot, row stream, export) calls this first, so a
+     * save never misses the value still in the editor.
+     */
+    flushCellEdit(): Promise<void>;
+    /**
+     * Focus / pointer moved outside the grid. Deferred commit ends the edit per
+     * `stopEditingWhenCellsLoseFocus`; immediate commit has nothing pending and
+     * keeps the editor (legacy table behaviour).
+     */
+    leaveGridFocus(): Promise<void>;
+    /**
+     * Before dispose / unmount: commit (or drop, when
+     * `stopEditingWhenCellsLoseFocus` is false) the open edit and wait until
+     * every queued write is durable.
+     */
+    settleEditsForTeardown(): Promise<void>;
     isEditingCell(rowId: number, columnId: string): boolean;
     /**
      * Begin a session-only draft for the cell (or full row). Does not touch EventStore.
@@ -2271,6 +2399,7 @@ declare class TableEngine {
     private validateCellFull;
     private finishValidation;
     private collectValidationJobs;
+    /** Replaces the error map; true when the set of errors / messages changed. */
     private applyValidationErrors;
     private runValidationSync;
     private runValidationAsync;
@@ -2325,6 +2454,8 @@ declare class ChangelogProjection {
     private subscribers;
     private seenEventIds;
     private started;
+    /** Incremented by start() and stop(); invalidates an in-flight catch-up. */
+    private run;
     constructor(eventStore: EventStore);
     /**
      * Catch up via readAll, then subscribe for live events.
@@ -2332,6 +2463,8 @@ declare class ChangelogProjection {
      */
     start(): Promise<void>;
     stop(): void;
+    /** Stop and drop all subscribers (grid teardown). Entries stay readable. */
+    dispose(): void;
     query(filter?: ChangelogQuery): ChangelogEntry[];
     count(filter?: ChangelogQuery): number;
     subscribe(notify: (entries: ChangelogEntry[]) => void, filter?: ChangelogQuery): Unsubscribe;
@@ -2489,4 +2622,4 @@ interface GridSession {
     subscribeViewport(listener: () => void): () => void;
 }
 
-export { type CycleSortModelOptions as $, type AggFunc as A, type AriaSortValue as B, type ColumnSchema as C, type DefaultOptionType as D, type EventStore as E, type FilterModel as F, type GridEvent as G, HistoryPanelViewModel as H, type ArrowDirection as I, type BooleanColumnFilter as J, type BooleanFilterOp as K, type BuiltinFilterKind as L, type MobileTableViewState as M, type CellRangeBounds as N, type CellRangeSelection as O, type ColumnDefBridge as P, type ColumnField as Q, Row as R, type ColumnFilter as S, type TableSnapShot as T, type UIRow as U, type ValidCell as V, type WindowedTableRepository as W, type ColumnPinned as X, type CombinedColumnFilter as Y, type CustomColumnFilter as Z, type CustomFilterFn as _, type Unsubscribe as a, sortPriorityForColumn as a$, type DateColumnFilter as a0, type DateFilterOp as a1, type FilterAccessor as a2, type FilterDef as a3, type FilterJoin as a4, HEADER_SORT_CLICK_MAX_MOVE_PX as a5, INDEX_COL_ID as a6, type ItemType as a7, type NumberColumnFilter as a8, type NumberFilterOp as a9, compareSortValues as aA, compareTypedValues as aB, createEmptyCellRangeSelection as aC, ctrlClickCell as aD, cycleSortModel as aE, defaultGetRowId as aF, ensureIndexColumnDef as aG, isBlankSortValue as aH, isCellInRange as aI, isColumnFilterActive as aJ, isHeaderColumnSortable as aK, isServerRowModel as aL, isWindowedRepository as aM, mapRowDataToRowInputs as aN, mergeCellRanges as aO, moveCellAddress as aP, normalizeCellRange as aQ, normalizeDigits as aR, normalizeFilterText as aS, pageWindow as aT, rangeFromAnchorFocus as aU, rangesOverlap as aV, resolveBuiltinFilterKind as aW, selectAllCellRanges as aX, shiftArrowCell as aY, shiftClickCell as aZ, shouldCommitHeaderSortClick as a_, type PersistedRowRecord as aa, type RowModelType as ab, RowStateEnum as ac, type SetColumnFilter as ad, type SetFilterOp as ae, type SimpleColumnFilter as af, type SortAccessor as ag, type SortDirection as ah, type SortModel as ai, type SortModelItem as aj, type SortValueComparator as ak, SparseRowIndex as al, type TextColumnFilter as am, type TextFilterOp as an, type ViewIntent as ao, Viewport as ap, type VisibleRange as aq, applyFilter as ar, applyHostRowDataToTable as as, applySort as at, ariaSortForColumn as au, clampColIndex as av, clampRowIndex as aw, clickCell as ax, colIndex as ay, collectUniqueFilterValues as az, type GridSession as b, type ExportRequestedPayload as b0, type ImportRequestedPayload as b1, type IRule as b2, type ColumnVisibilityRule as b3, type IDependOn as b4, type Actor$1 as b5, type ColDefOrGroup as b6, type TableRepository as b7, type PermissionPolicy as b8, type CellEditType as b9, type IMultiSelectConfig as ba, type ColumnGroupDef as bb, type ColumnGroupMeta as bc, type ColumnGroupPathEntry as bd, isColumnGroupDef as be, type CollectionScope as c, type CellRange as d, TableEngine as e, Table as f, type TableActions as g, type GridSearchState as h, ChangelogProjection as i, CellUndoStack as j, type TableViewState as k, type ColumnDef as l, type GetRowId as m, Cell as n, type ChangelogQuery as o, type ChangelogEntry as p, type HistoryQuery as q, type HistoryItem as r, type ActiveCell as s, type CellEditValue as t, type MobileEditorState as u, type ValidationCallbackResult as v, type CellAddress as w, type FieldType as x, type AggFuncName as y, type AppendResult as z };
+export { type CycleSortModelOptions as $, type AggFunc as A, type AriaSortValue as B, type ColumnSchema as C, type DefaultOptionType as D, type EventStore as E, type FilterModel as F, type GridEvent as G, HistoryPanelViewModel as H, type ArrowDirection as I, type BooleanColumnFilter as J, type BooleanFilterOp as K, type BuiltinFilterKind as L, type MobileTableViewState as M, type CellRangeBounds as N, type CellRangeSelection as O, type ColumnDefBridge as P, type ColumnField as Q, Row as R, type ColumnFilter as S, type TableSnapShot as T, type UIRow as U, type ValidCell as V, type WindowedTableRepository as W, type ColumnPinned as X, type CombinedColumnFilter as Y, type CustomColumnFilter as Z, type CustomFilterFn as _, type Unsubscribe as a, sortPriorityForColumn as a$, type DateColumnFilter as a0, type DateFilterOp as a1, type FilterAccessor as a2, type FilterDef as a3, type FilterJoin as a4, HEADER_SORT_CLICK_MAX_MOVE_PX as a5, INDEX_COL_ID as a6, type ItemType as a7, type NumberColumnFilter as a8, type NumberFilterOp as a9, compareSortValues as aA, compareTypedValues as aB, createEmptyCellRangeSelection as aC, ctrlClickCell as aD, cycleSortModel as aE, defaultGetRowId as aF, ensureIndexColumnDef as aG, isBlankSortValue as aH, isCellInRange as aI, isColumnFilterActive as aJ, isHeaderColumnSortable as aK, isServerRowModel as aL, isWindowedRepository as aM, mapRowDataToRowInputs as aN, mergeCellRanges as aO, moveCellAddress as aP, normalizeCellRange as aQ, normalizeDigits as aR, normalizeFilterText as aS, pageWindow as aT, rangeFromAnchorFocus as aU, rangesOverlap as aV, resolveBuiltinFilterKind as aW, selectAllCellRanges as aX, shiftArrowCell as aY, shiftClickCell as aZ, shouldCommitHeaderSortClick as a_, type PersistedRowRecord as aa, type RowModelType as ab, RowStateEnum as ac, type SetColumnFilter as ad, type SetFilterOp as ae, type SimpleColumnFilter as af, type SortAccessor as ag, type SortDirection as ah, type SortModel as ai, type SortModelItem as aj, type SortValueComparator as ak, SparseRowIndex as al, type TextColumnFilter as am, type TextFilterOp as an, type ViewIntent as ao, Viewport as ap, type VisibleRange as aq, applyFilter as ar, applyHostRowDataToTable as as, applySort as at, ariaSortForColumn as au, clampColIndex as av, clampRowIndex as aw, clickCell as ax, colIndex as ay, collectUniqueFilterValues as az, type GridSession as b, type ExportRequestedPayload as b0, type ImportRequestedPayload as b1, type IRule as b2, type ColumnVisibilityRule as b3, type IDependOn as b4, type ResolveOnConfig as b5, type IBaseQueryResponse as b6, type HostRemoteApi as b7, type Actor$1 as b8, type ColDefOrGroup as b9, type TableRepository as ba, type PermissionPolicy as bb, type CellEditType as bc, type CellEditCommit as bd, type EnterNavigation as be, type IMultiSelectConfig as bf, type ColumnGroupDef as bg, type ColumnGroupMeta as bh, type ColumnGroupPathEntry as bi, isColumnGroupDef as bj, type CollectionScope as c, type CellRange as d, TableEngine as e, Table as f, type TableActions as g, type GridSearchState as h, ChangelogProjection as i, CellUndoStack as j, type TableViewState as k, type ColumnDef as l, type GetRowId as m, Cell as n, type ChangelogQuery as o, type ChangelogEntry as p, type HistoryQuery as q, type HistoryItem as r, type ActiveCell as s, type CellEditValue as t, type MobileEditorState as u, type ValidationCallbackResult as v, type CellAddress as w, type FieldType as x, type AggFuncName as y, type AppendResult as z };

package/dist/GridSyncService-3JQLEY65.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkLY27YAXE_cjs = require('./chunk-LY27YAXE.cjs');
+
+
+
+Object.defineProperty(exports, "GridSyncService", {
+  enumerable: true,
+  get: function () { return chunkLY27YAXE_cjs.GridSyncService; }
+});
+//# sourceMappingURL=GridSyncService-3JQLEY65.cjs.map
+//# sourceMappingURL=GridSyncService-3JQLEY65.cjs.map

package/dist/{GridSyncService-TAPAHABV.cjs.map → GridSyncService-3JQLEY65.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"GridSyncService-TAPAHABV.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"GridSyncService-3JQLEY65.cjs"}

package/dist/GridSyncService-GECXGEKL.js

@@ -0,0 +1,3 @@
+export { GridSyncService } from './chunk-KCNTKYUY.js';
+//# sourceMappingURL=GridSyncService-GECXGEKL.js.map
+//# sourceMappingURL=GridSyncService-GECXGEKL.js.map

package/dist/{GridSyncService-KTLB4KP3.js.map → GridSyncService-GECXGEKL.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"GridSyncService-KTLB4KP3.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"GridSyncService-GECXGEKL.js"}

package/dist/{PdfRenderer-CBg7hWNS.d.cts → PdfRenderer-B9FJaCo_.d.cts}

@@ -1,4 +1,4 @@
-import { E as ExportSource } from './GridPlugin-oxhq8AsM.cjs';
+import { E as ExportSource } from './GridPlugin-DewWufGZ.cjs';
 
 /**
  * Port so PDF libraries stay out of Core.

package/dist/{PdfRenderer-1HFh6UeR.d.ts → PdfRenderer-bN7ca_Aj.d.ts}

@@ -1,4 +1,4 @@
-import { E as ExportSource } from './GridPlugin-CJCaYnlw.js';
+import { E as ExportSource } from './GridPlugin-Bewn0X51.js';
 
 /**
  * Port so PDF libraries stay out of Core.

package/dist/{UITableController-DU8RopUM.d.ts → UITableController-C71LXBiX.d.ts}

@@ -1,4 +1,4 @@
-import { d as CellRange, e as TableEngine, G as GridEvent, a as Unsubscribe, E as EventStore, f as Table, g as TableActions, h as GridSearchState, F as FilterModel, i as ChangelogProjection, H as HistoryPanelViewModel, j as CellUndoStack, b as GridSession, k as TableViewState, l as ColumnDef, m as GetRowId, M as MobileTableViewState, U as UIRow, R as Row, A as AggFunc, c as CollectionScope, T as TableSnapShot, n as Cell, o as ChangelogQuery, p as ChangelogEntry, q as HistoryQuery, r as HistoryItem, s as ActiveCell, t as CellEditValue, u as MobileEditorState, v as ValidationCallbackResult, V as ValidCell } from './GridSession-Bc7UIawO.js';
+import { d as CellRange, e as TableEngine, G as GridEvent, a as Unsubscribe, E as EventStore, f as Table, g as TableActions, h as GridSearchState, F as FilterModel, i as ChangelogProjection, H as HistoryPanelViewModel, j as CellUndoStack, b as GridSession, k as TableViewState, l as ColumnDef, m as GetRowId, M as MobileTableViewState, U as UIRow, R as Row, A as AggFunc, c as CollectionScope, T as TableSnapShot, n as Cell, o as ChangelogQuery, p as ChangelogEntry, q as HistoryQuery, r as HistoryItem, s as ActiveCell, t as CellEditValue, u as MobileEditorState, v as ValidationCallbackResult, V as ValidCell } from './GridSession-CeIfVFck.js';
 import { A as AuditLogger, R as RemoteApi } from './RemoteApi-CCQxiSf1.js';
 
 /**
@@ -140,6 +140,12 @@ type SyncPort = {
      */
     resolveConflict(conflictId: string, choice: ManualResolution): Promise<void>;
     subscribeConflicts(listener: (conflicts: readonly SyncConflict[]) => void): () => void;
+    /**
+     * Release listeners / deferred state when the grid is torn down. After
+     * this, `sync()` is a no-op that returns an empty result. Optional so
+     * custom SyncPort implementations keep compiling.
+     */
+    dispose?(): void;
 };
 
 /** Peer presence snapshot (PR-139). */
@@ -217,10 +223,14 @@ declare class OfflineStatus {
     private syncedIds;
     private connectivityUnsub;
     private storeUnsub;
+    /** Incremented by every stop(); invalidates an in-flight start(). */
+    private lifecycle;
     private readonly connectivityListeners;
     private readonly pendingListeners;
     constructor(options: OfflineStatusOptions);
     start(eventStore: EventStore): Promise<void>;
+    /** Stop listening and drop all listeners. The instance is inert afterwards. */
+    dispose(): void;
     stop(): void;
     getConnectivity(): Connectivity;
     getPendingChanges(): readonly PendingChange[];
@@ -441,6 +451,9 @@ declare class UITableController {
     private clipboardOptions;
     private syncPort?;
     private presencePort?;
+    /** Set by releaseResources(); the first call's promise is reused (idempotent). */
+    private releasePromise?;
+    private resourceTeardown?;
     constructor(engine: TableEngine, store: string, tableKey: string, audit: AuditLogger, changelogProjection?: ChangelogProjection | undefined, historyPanelViewModel?: HistoryPanelViewModel | undefined, cellUndoStack?: CellUndoStack | undefined, session?: GridSession | undefined, remoteApi?: RemoteApi | undefined, offlineStatus?: OfflineStatus | undefined);
     getRemoteApi(): RemoteApi | undefined;
     getOfflineStatus(): OfflineStatus | undefined;
@@ -448,6 +461,14 @@ declare class UITableController {
     setSyncPort(port: SyncPort | undefined): void;
     getPresencePort(): PresencePort | undefined;
     setPresencePort(port: PresencePort | undefined): void;
+    /**
+     * Composition root hook: the callback that releases every resource the grid
+     * created (subscriptions, projections, plugins, owned event store).
+     * Run once by {@link releaseResources}.
+     */
+    setResourceTeardown(teardown: (() => void | Promise<void>) | undefined): void;
+    /** True once resources were released (via releaseResources or dispose). */
+    isReleased(): boolean;
     getPresencePeers(): readonly PresencePeer[];
     subscribePresencePeers(cb: (peers: readonly PresencePeer[]) => void): () => void;
     /** Broadcast local active cell to peers (no-op without presence). */
@@ -475,6 +496,7 @@ declare class UITableController {
     private safe;
     private changePageSize;
     private changePage;
+    /** Editor of this cell → session draft (written per `cellEditCommit`); otherwise write-through. */
     private onCellChange;
     private onDescriptionSave;
     private onCellDisplayChange;
@@ -583,6 +605,16 @@ declare class UITableController {
     startCellEdit(rowId: number, columnId: string): void;
     cancelCellEdit(): void;
     commitCellEdit(): Promise<number>;
+    /**
+     * Write what is still in the cell editor (the edit stays open) and wait
+     * until every pending cell write is durable. `getFullSnapShot` /
+     * `iterateRowsFromDb` / exports already do this; call it before reading
+     * synchronous APIs (`getRowView`, `getSnapShot`) for a save.
+     */
+    flushCellEdit(): Promise<void>;
+    /** DataGrid: focus / pointer left the grid (see `stopEditingWhenCellsLoseFocus`). */
+    leaveGridFocus(): Promise<void>;
+    private settleEditsForTeardown;
     getEditDraft(rowId: number, columnId: string): CellEditValue | null;
     isEditingCell(rowId: number, columnId: string): boolean;
     getMobileEditor(): MobileEditorState | undefined;
@@ -624,7 +656,21 @@ declare class UITableController {
     onRowSelect(rowId: number): void;
     getCellRanges(): readonly CellRange[];
     addCellRange(range: CellRange): void;
-    dispose(): void;
+    /**
+     * Full dispose: `TABLE_DISPOSED` (windowed repo: drop the RAM page window,
+     * other repos: `repo.delete` — unchanged data semantics) followed by
+     * {@link releaseResources}. Idempotent; the promise settles once teardown
+     * finished and never rejects.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Resource-only teardown: stops subscriptions, projections, sync, presence,
+     * plugins, server row model and closes an event store the grid opened.
+     * Does NOT dispatch `TABLE_DISPOSED` — persisted table data is untouched.
+     * Idempotent (same promise on every call); never rejects.
+     */
+    releaseResources(): Promise<void>;
+    private runResourceTeardown;
     dispatch(command: UITableCommand): Promise<void>;
     private dispatchInternal;
 }

package/dist/{UITableController-Cuwq481K.d.cts → UITableController-CIwnHIw8.d.cts}

@@ -1,4 +1,4 @@
-import { d as CellRange, e as TableEngine, G as GridEvent, a as Unsubscribe, E as EventStore, f as Table, g as TableActions, h as GridSearchState, F as FilterModel, i as ChangelogProjection, H as HistoryPanelViewModel, j as CellUndoStack, b as GridSession, k as TableViewState, l as ColumnDef, m as GetRowId, M as MobileTableViewState, U as UIRow, R as Row, A as AggFunc, c as CollectionScope, T as TableSnapShot, n as Cell, o as ChangelogQuery, p as ChangelogEntry, q as HistoryQuery, r as HistoryItem, s as ActiveCell, t as CellEditValue, u as MobileEditorState, v as ValidationCallbackResult, V as ValidCell } from './GridSession-B-9lLcoB.cjs';
+import { d as CellRange, e as TableEngine, G as GridEvent, a as Unsubscribe, E as EventStore, f as Table, g as TableActions, h as GridSearchState, F as FilterModel, i as ChangelogProjection, H as HistoryPanelViewModel, j as CellUndoStack, b as GridSession, k as TableViewState, l as ColumnDef, m as GetRowId, M as MobileTableViewState, U as UIRow, R as Row, A as AggFunc, c as CollectionScope, T as TableSnapShot, n as Cell, o as ChangelogQuery, p as ChangelogEntry, q as HistoryQuery, r as HistoryItem, s as ActiveCell, t as CellEditValue, u as MobileEditorState, v as ValidationCallbackResult, V as ValidCell } from './GridSession-CmQn2RnL.cjs';
 import { A as AuditLogger, R as RemoteApi } from './RemoteApi-CCQxiSf1.cjs';
 
 /**
@@ -140,6 +140,12 @@ type SyncPort = {
      */
     resolveConflict(conflictId: string, choice: ManualResolution): Promise<void>;
     subscribeConflicts(listener: (conflicts: readonly SyncConflict[]) => void): () => void;
+    /**
+     * Release listeners / deferred state when the grid is torn down. After
+     * this, `sync()` is a no-op that returns an empty result. Optional so
+     * custom SyncPort implementations keep compiling.
+     */
+    dispose?(): void;
 };
 
 /** Peer presence snapshot (PR-139). */
@@ -217,10 +223,14 @@ declare class OfflineStatus {
     private syncedIds;
     private connectivityUnsub;
     private storeUnsub;
+    /** Incremented by every stop(); invalidates an in-flight start(). */
+    private lifecycle;
     private readonly connectivityListeners;
     private readonly pendingListeners;
     constructor(options: OfflineStatusOptions);
     start(eventStore: EventStore): Promise<void>;
+    /** Stop listening and drop all listeners. The instance is inert afterwards. */
+    dispose(): void;
     stop(): void;
     getConnectivity(): Connectivity;
     getPendingChanges(): readonly PendingChange[];
@@ -441,6 +451,9 @@ declare class UITableController {
     private clipboardOptions;
     private syncPort?;
     private presencePort?;
+    /** Set by releaseResources(); the first call's promise is reused (idempotent). */
+    private releasePromise?;
+    private resourceTeardown?;
     constructor(engine: TableEngine, store: string, tableKey: string, audit: AuditLogger, changelogProjection?: ChangelogProjection | undefined, historyPanelViewModel?: HistoryPanelViewModel | undefined, cellUndoStack?: CellUndoStack | undefined, session?: GridSession | undefined, remoteApi?: RemoteApi | undefined, offlineStatus?: OfflineStatus | undefined);
     getRemoteApi(): RemoteApi | undefined;
     getOfflineStatus(): OfflineStatus | undefined;
@@ -448,6 +461,14 @@ declare class UITableController {
     setSyncPort(port: SyncPort | undefined): void;
     getPresencePort(): PresencePort | undefined;
     setPresencePort(port: PresencePort | undefined): void;
+    /**
+     * Composition root hook: the callback that releases every resource the grid
+     * created (subscriptions, projections, plugins, owned event store).
+     * Run once by {@link releaseResources}.
+     */
+    setResourceTeardown(teardown: (() => void | Promise<void>) | undefined): void;
+    /** True once resources were released (via releaseResources or dispose). */
+    isReleased(): boolean;
     getPresencePeers(): readonly PresencePeer[];
     subscribePresencePeers(cb: (peers: readonly PresencePeer[]) => void): () => void;
     /** Broadcast local active cell to peers (no-op without presence). */
@@ -475,6 +496,7 @@ declare class UITableController {
     private safe;
     private changePageSize;
     private changePage;
+    /** Editor of this cell → session draft (written per `cellEditCommit`); otherwise write-through. */
     private onCellChange;
     private onDescriptionSave;
     private onCellDisplayChange;
@@ -583,6 +605,16 @@ declare class UITableController {
     startCellEdit(rowId: number, columnId: string): void;
     cancelCellEdit(): void;
     commitCellEdit(): Promise<number>;
+    /**
+     * Write what is still in the cell editor (the edit stays open) and wait
+     * until every pending cell write is durable. `getFullSnapShot` /
+     * `iterateRowsFromDb` / exports already do this; call it before reading
+     * synchronous APIs (`getRowView`, `getSnapShot`) for a save.
+     */
+    flushCellEdit(): Promise<void>;
+    /** DataGrid: focus / pointer left the grid (see `stopEditingWhenCellsLoseFocus`). */
+    leaveGridFocus(): Promise<void>;
+    private settleEditsForTeardown;
     getEditDraft(rowId: number, columnId: string): CellEditValue | null;
     isEditingCell(rowId: number, columnId: string): boolean;
     getMobileEditor(): MobileEditorState | undefined;
@@ -624,7 +656,21 @@ declare class UITableController {
     onRowSelect(rowId: number): void;
     getCellRanges(): readonly CellRange[];
     addCellRange(range: CellRange): void;
-    dispose(): void;
+    /**
+     * Full dispose: `TABLE_DISPOSED` (windowed repo: drop the RAM page window,
+     * other repos: `repo.delete` — unchanged data semantics) followed by
+     * {@link releaseResources}. Idempotent; the promise settles once teardown
+     * finished and never rejects.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Resource-only teardown: stops subscriptions, projections, sync, presence,
+     * plugins, server row model and closes an event store the grid opened.
+     * Does NOT dispatch `TABLE_DISPOSED` — persisted table data is untouched.
+     * Idempotent (same promise on every call); never rejects.
+     */
+    releaseResources(): Promise<void>;
+    private runResourceTeardown;
     dispatch(command: UITableCommand): Promise<void>;
     private dispatchInternal;
 }

package/dist/{VazirmatnPdfRenderer-BCMpC1zy.d.cts → VazirmatnPdfRenderer-CpCqA-Wh.d.cts}

@@ -1,5 +1,5 @@
-import { G as GridPlugin, a as GridPluginContext, E as ExportSource } from './GridPlugin-oxhq8AsM.cjs';
-import { P as PdfRenderer, a as PdfRenderOptions } from './PdfRenderer-CBg7hWNS.cjs';
+import { G as GridPlugin, a as GridPluginContext, E as ExportSource } from './GridPlugin-DewWufGZ.cjs';
+import { P as PdfRenderer, a as PdfRenderOptions } from './PdfRenderer-B9FJaCo_.cjs';
 
 /**
  * Document PDF template options (PR-141).

package/dist/{VazirmatnPdfRenderer-Dz_G-m3c.d.ts → VazirmatnPdfRenderer-D46smncn.d.ts}

@@ -1,5 +1,5 @@
-import { G as GridPlugin, a as GridPluginContext, E as ExportSource } from './GridPlugin-CJCaYnlw.js';
-import { P as PdfRenderer, a as PdfRenderOptions } from './PdfRenderer-1HFh6UeR.js';
+import { G as GridPlugin, a as GridPluginContext, E as ExportSource } from './GridPlugin-Bewn0X51.js';
+import { P as PdfRenderer, a as PdfRenderOptions } from './PdfRenderer-bN7ca_Aj.js';
 
 /**
  * Document PDF template options (PR-141).

package/dist/adapters/arian-erp.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkASPTRYRD_cjs = require('../chunk-ASPTRYRD.cjs');
+var chunkE2J533UH_cjs = require('../chunk-E2J533UH.cjs');
 
 // infrastructure/Repositories/fetchRemoteApi.ts
 function readCookie(name) {
@@ -58,9 +58,17 @@ var FetchRemoteApi = class {
         body: payload ? JSON.stringify(payload) : void 0
       });
       if (!res.ok) {
-        this.err?.handle(`RemoteApi request failed: ${res.status}`, "FetchRemoteApi.request");
+        throw new Error(
+          `RemoteApi request failed: HTTP ${res.status} ${input.endpoint}`
+        );
+      }
+      try {
+        return await res.json();
+      } catch {
+        throw new Error(
+          `RemoteApi response is not valid JSON: HTTP ${res.status} ${input.endpoint}`
+        );
       }
-      return await res.json();
     } catch (error) {
       this.err?.handle(error, "FetchRemoteApi.request");
       throw error;
@@ -70,7 +78,11 @@ var FetchRemoteApi = class {
 
 Object.defineProperty(exports, "CallbackRemoteApi", {
   enumerable: true,
-  get: function () { return chunkASPTRYRD_cjs.CallbackRemoteApi; }
+  get: function () { return chunkE2J533UH_cjs.CallbackRemoteApi; }
+});
+Object.defineProperty(exports, "createBaseQueryRemoteApi", {
+  enumerable: true,
+  get: function () { return chunkE2J533UH_cjs.createBaseQueryRemoteApi; }
 });
 exports.FetchRemoteApi = FetchRemoteApi;
 //# sourceMappingURL=arian-erp.cjs.map

package/dist/adapters/arian-erp.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../infrastructure/Repositories/fetchRemoteApi.ts"],"names":[],"mappings":"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","file":"arian-erp.cjs","sourcesContent":["import { EngineErrorHandler } from '../../engine/EngineErrorHandler';\r\nimport { RemoteApi } from '../../application/ports/RemoteApi';\r\n\r\nexport type ErpDefaults = {\r\n  PlaceId?: { id?: number };\r\n  YearId?: { id?: number };\r\n  LanguageId?: { id?: number };\r\n  CashierId?: { id?: number };\r\n  CurrencyId?: { id?: number };\r\n};\r\n\r\nfunction readCookie(name: string): string {\r\n  if (typeof document === 'undefined') return '';\r\n  const cookies = document.cookie.split(';');\r\n  const cookie = cookies.find((item) => item.trim().startsWith(`${name}=`));\r\n  if (!cookie) return '';\r\n  return cookie.trim().slice(name.length + 1);\r\n}\r\n\r\nfunction readErpDefaults(): ErpDefaults {\r\n  if (typeof window === 'undefined') return {};\r\n  try {\r\n    const storage = localStorage.getItem('persist:arianERP');\r\n    const parsedStorage = JSON.parse(storage ?? '{}');\r\n    const parsedConfig = JSON.parse(parsedStorage.config ?? '{}');\r\n    return parsedConfig.defaultConfigs ?? {};\r\n  } catch {\r\n    return {};\r\n  }\r\n}\r\n\r\nfunction joinUrl(baseUrl: string, endpoint: string): string {\r\n  if (/^https?:\\/\\//i.test(endpoint)) return endpoint;\r\n  const base = baseUrl.replace(/\\/$/, '');\r\n  const path = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;\r\n  return `${base}${path}`;\r\n}\r\n\r\n/**\r\n * Host-injected RemoteApi for arianERP.\r\n * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.\r\n * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON\r\n * (relative URLs work on the ERP host).\r\n * See `examples/host-arian-erp/host-arian-erp.md`.\r\n */\r\nexport type FetchRemoteApiOptions = {\r\n  baseUrl?: string;\r\n  /** Inject the bearer token (e.g. from the host's auth store). Default: cookie `_auth`. */\r\n  getToken?: () => string | undefined | null;\r\n  /** Inject ERP defaults (e.g. from Redux). Default: localStorage `persist:arianERP`. */\r\n  getDefaults?: () => ErpDefaults;\r\n  /** Custom fetch (tests, interceptors, token refresh). Default: global `fetch`. */\r\n  fetcher?: typeof fetch;\r\n};\r\n\r\nexport class FetchRemoteApi implements RemoteApi {\r\n  constructor(\r\n    private readonly err?: EngineErrorHandler,\r\n    private readonly options: FetchRemoteApiOptions = {},\r\n  ) {}\r\n\r\n  async request<TResponse = unknown>(input: {\r\n    endpoint: string;\r\n    params?: Record<string, unknown>;\r\n    method?: 'GET' | 'POST';\r\n  }): Promise<TResponse> {\r\n    try {\r\n      const defaults = this.options.getDefaults?.() ?? readErpDefaults();\r\n      const token = this.options.getToken\r\n        ? (this.options.getToken() ?? '')\r\n        : readCookie('_auth');\r\n      const method = input.method ?? 'POST';\r\n      const url = joinUrl(this.options.baseUrl ?? '', input.endpoint);\r\n      const payload =\r\n        method === 'GET'\r\n          ? undefined\r\n          : {\r\n              ...(input.params ?? {}),\r\n              Defaults: {\r\n                CurrencyId: defaults.CurrencyId?.id,\r\n                CashierId: defaults.CashierId?.id,\r\n                PlaceId: defaults.PlaceId?.id,\r\n                YearId: defaults.YearId?.id,\r\n                LangId: defaults.LanguageId?.id,\r\n              },\r\n            };\r\n\r\n      const headers: Record<string, string> = {\r\n        'Content-Type': 'application/json',\r\n      };\r\n      if (token) headers.Authorization = `Bearer ${token}`;\r\n\r\n      const res = await (this.options.fetcher ?? fetch)(url, {\r\n        method,\r\n        headers,\r\n        body: payload ? JSON.stringify(payload) : undefined,\r\n      });\r\n      if (!res.ok) {\r\n        this.err?.handle(`RemoteApi request failed: ${res.status}`, 'FetchRemoteApi.request');\r\n      }\r\n      return (await res.json()) as TResponse;\r\n    } catch (error) {\r\n      this.err?.handle(error, 'FetchRemoteApi.request');\r\n      throw error;\r\n    }\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../../infrastructure/Repositories/fetchRemoteApi.ts"],"names":[],"mappings":"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","file":"arian-erp.cjs","sourcesContent":["import { EngineErrorHandler } from '../../engine/EngineErrorHandler';\nimport { RemoteApi } from '../../application/ports/RemoteApi';\n\nexport type ErpDefaults = {\n  PlaceId?: { id?: number };\n  YearId?: { id?: number };\n  LanguageId?: { id?: number };\n  CashierId?: { id?: number };\n  CurrencyId?: { id?: number };\n};\n\nfunction readCookie(name: string): string {\n  if (typeof document === 'undefined') return '';\n  const cookies = document.cookie.split(';');\n  const cookie = cookies.find((item) => item.trim().startsWith(`${name}=`));\n  if (!cookie) return '';\n  return cookie.trim().slice(name.length + 1);\n}\n\nfunction readErpDefaults(): ErpDefaults {\n  if (typeof window === 'undefined') return {};\n  try {\n    const storage = localStorage.getItem('persist:arianERP');\n    const parsedStorage = JSON.parse(storage ?? '{}');\n    const parsedConfig = JSON.parse(parsedStorage.config ?? '{}');\n    return parsedConfig.defaultConfigs ?? {};\n  } catch {\n    return {};\n  }\n}\n\nfunction joinUrl(baseUrl: string, endpoint: string): string {\n  if (/^https?:\\/\\//i.test(endpoint)) return endpoint;\n  const base = baseUrl.replace(/\\/$/, '');\n  const path = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;\n  return `${base}${path}`;\n}\n\n/**\n * Host-injected RemoteApi for arianERP.\n * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.\n * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON\n * (relative URLs work on the ERP host).\n * Non-2xx responses and non-JSON bodies reject with an `Error` naming the HTTP\n * status and endpoint (also reported through the optional error handler).\n * See `examples/host-arian-erp/host-arian-erp.md`.\n */\nexport type FetchRemoteApiOptions = {\n  baseUrl?: string;\n  /** Inject the bearer token (e.g. from the host's auth store). Default: cookie `_auth`. */\n  getToken?: () => string | undefined | null;\n  /** Inject ERP defaults (e.g. from Redux). Default: localStorage `persist:arianERP`. */\n  getDefaults?: () => ErpDefaults;\n  /** Custom fetch (tests, interceptors, token refresh). Default: global `fetch`. */\n  fetcher?: typeof fetch;\n};\n\nexport class FetchRemoteApi implements RemoteApi {\n  constructor(\n    private readonly err?: EngineErrorHandler,\n    private readonly options: FetchRemoteApiOptions = {},\n  ) {}\n\n  async request<TResponse = unknown>(input: {\n    endpoint: string;\n    params?: Record<string, unknown>;\n    method?: 'GET' | 'POST';\n  }): Promise<TResponse> {\n    try {\n      const defaults = this.options.getDefaults?.() ?? readErpDefaults();\n      const token = this.options.getToken\n        ? (this.options.getToken() ?? '')\n        : readCookie('_auth');\n      const method = input.method ?? 'POST';\n      const url = joinUrl(this.options.baseUrl ?? '', input.endpoint);\n      const payload =\n        method === 'GET'\n          ? undefined\n          : {\n              ...(input.params ?? {}),\n              Defaults: {\n                CurrencyId: defaults.CurrencyId?.id,\n                CashierId: defaults.CashierId?.id,\n                PlaceId: defaults.PlaceId?.id,\n                YearId: defaults.YearId?.id,\n                LangId: defaults.LanguageId?.id,\n              },\n            };\n\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n      };\n      if (token) headers.Authorization = `Bearer ${token}`;\n\n      const res = await (this.options.fetcher ?? fetch)(url, {\n        method,\n        headers,\n        body: payload ? JSON.stringify(payload) : undefined,\n      });\n      if (!res.ok) {\n        // Never hand an error body to callers as if it were data.\n        throw new Error(\n          `RemoteApi request failed: HTTP ${res.status} ${input.endpoint}`,\n        );\n      }\n      try {\n        return (await res.json()) as TResponse;\n      } catch {\n        throw new Error(\n          `RemoteApi response is not valid JSON: HTTP ${res.status} ${input.endpoint}`,\n        );\n      }\n    } catch (error) {\n      this.err?.handle(error, 'FetchRemoteApi.request');\n      throw error;\n    }\n  }\n}\n"]}

package/dist/adapters/arian-erp.d.cts

@@ -1,5 +1,5 @@
 import { C as ConsoleAuditLogger, R as RemoteApi } from '../RemoteApi-CCQxiSf1.cjs';
-export { C as CallbackRemoteApi, R as RemoteApiRequest } from '../callbackRemoteApi-DgnXH-i0.cjs';
+export { B as BaseQueryResult, C as CallbackRemoteApi, R as RemoteApiRequest, c as createBaseQueryRemoteApi } from '../callbackRemoteApi-Cv26MmSD.cjs';
 
 declare class EngineErrorHandler {
     private readonly audit;
@@ -35,6 +35,8 @@ type ErpDefaults = {
  * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.
  * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON
  * (relative URLs work on the ERP host).
+ * Non-2xx responses and non-JSON bodies reject with an `Error` naming the HTTP
+ * status and endpoint (also reported through the optional error handler).
  * See `examples/host-arian-erp/host-arian-erp.md`.
  */
 type FetchRemoteApiOptions = {

package/dist/adapters/arian-erp.d.ts

@@ -1,5 +1,5 @@
 import { C as ConsoleAuditLogger, R as RemoteApi } from '../RemoteApi-CCQxiSf1.js';
-export { C as CallbackRemoteApi, R as RemoteApiRequest } from '../callbackRemoteApi-BlXO5NJz.js';
+export { B as BaseQueryResult, C as CallbackRemoteApi, R as RemoteApiRequest, c as createBaseQueryRemoteApi } from '../callbackRemoteApi-BYLjmSI6.js';
 
 declare class EngineErrorHandler {
     private readonly audit;
@@ -35,6 +35,8 @@ type ErpDefaults = {
  * Not the package default — pass `remoteApi={new FetchRemoteApi()}` from the ERP host.
  * Reads auth cookie `_auth` and redux-persist `persist:arianERP`, then POSTs JSON
  * (relative URLs work on the ERP host).
+ * Non-2xx responses and non-JSON bodies reject with an `Error` naming the HTTP
+ * status and endpoint (also reported through the optional error handler).
  * See `examples/host-arian-erp/host-arian-erp.md`.
  */
 type FetchRemoteApiOptions = {