persian-data-grid 0.5.0 → 0.7.0

package/dist/headless.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../infrastructure/sync/InMemorySyncHub.ts","../infrastructure/presence/InMemoryPresenceHub.ts","../infrastructure/document/documentGridMapping.ts"],"names":[],"mappings":"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","file":"headless.cjs","sourcesContent":["import type { GridEvent } from '../../domain/types/GridEvent';\r\nimport type { SyncTransport } from '../../application/ports/SyncPort';\r\n\r\ntype ClientInbox = {\r\n  events: GridEvent[];\r\n  delivered: Set<string>;\r\n};\r\n\r\n/**\r\n * Shared in-memory sync hub for tests / demos (PR-138).\r\n * Each client gets a transport bound to a clientId.\r\n */\r\nexport class InMemorySyncHub {\r\n  private log: GridEvent[] = [];\r\n  private readonly clients = new Map<string, ClientInbox>();\r\n\r\n  transportFor(clientId: string): SyncTransport {\r\n    if (!this.clients.has(clientId)) {\r\n      this.clients.set(clientId, { events: [], delivered: new Set() });\r\n    }\r\n    return {\r\n      push: async (events) => this.push(clientId, events),\r\n      pull: async (afterCursor) => this.pull(clientId, afterCursor),\r\n    };\r\n  }\r\n\r\n  private async push(\r\n    clientId: string,\r\n    events: readonly GridEvent[],\r\n  ): Promise<{ acceptedIds: readonly string[] }> {\r\n    const acceptedIds: string[] = [];\r\n    for (const event of events) {\r\n      if (this.log.some((e) => e.eventId === event.eventId)) {\r\n        acceptedIds.push(event.eventId);\r\n        continue;\r\n      }\r\n      this.log.push(event);\r\n      acceptedIds.push(event.eventId);\r\n      for (const [id, inbox] of this.clients) {\r\n        if (id === clientId) continue;\r\n        inbox.events.push(event);\r\n      }\r\n    }\r\n    return { acceptedIds };\r\n  }\r\n\r\n  private async pull(\r\n    clientId: string,\r\n    afterCursor: number,\r\n  ): Promise<{ events: readonly GridEvent[]; cursor: number }> {\r\n    void afterCursor;\r\n    const inbox = this.clients.get(clientId);\r\n    if (!inbox) {\r\n      return { events: [], cursor: this.log.length };\r\n    }\r\n    const fresh = inbox.events.filter((e) => !inbox.delivered.has(e.eventId));\r\n    for (const e of fresh) inbox.delivered.add(e.eventId);\r\n    return { events: fresh, cursor: this.log.length };\r\n  }\r\n\r\n  /** Test helper: all events currently on the hub. */\r\n  getLog(): readonly GridEvent[] {\r\n    return this.log;\r\n  }\r\n}\r\n","import type {\r\n  PresenceMessage,\r\n  PresenceTransport,\r\n} from '../../application/ports/PresencePort';\r\n\r\ntype Client = {\r\n  listener: ((message: PresenceMessage) => void) | null;\r\n};\r\n\r\n/**\r\n * Shared in-memory presence hub for tests / Node (PR-139).\r\n * Mirrors BroadcastChannel semantics without DOM.\r\n */\r\nexport class InMemoryPresenceHub {\r\n  private readonly clients = new Map<string, Client>();\r\n\r\n  transportFor(clientId: string): PresenceTransport {\r\n    if (!this.clients.has(clientId)) {\r\n      this.clients.set(clientId, { listener: null });\r\n    }\r\n    return {\r\n      publish: (message) => {\r\n        for (const [id, client] of this.clients) {\r\n          if (id === clientId) continue;\r\n          client.listener?.(message);\r\n        }\r\n      },\r\n      subscribe: (listener) => {\r\n        const client = this.clients.get(clientId)!;\r\n        client.listener = listener;\r\n        return () => {\r\n          if (client.listener === listener) client.listener = null;\r\n        };\r\n      },\r\n    };\r\n  }\r\n}\r\n","/**\r\n * Document-grid mapping (header + detail lines) — pure, framework-free.\r\n *\r\n * Extracted from the arianERP form host hook so the project keeps ZERO table\r\n * logic: the host only injects I/O (fetch, save, page state) and calls these\r\n * functions. Nothing here knows Redux, Next.js, or any backend URL.\r\n */\r\nimport type { RowInput } from '../../bootstrap/type';\r\nimport type { TableSnapShot } from '../../engine/type';\r\nimport { RowStateEnum } from '../../domain/value-objects';\r\n\r\n/** Columns the grid owns — never sent back as detail data. */\r\nconst GRID_INTERNAL_COLUMNS = new Set(['collection', 'rowType', 'ChangeFields']);\r\n\r\nexport type SnapshotToDetailsOptions = {\r\n  /** Server primary-key field of a detail line (sent for non-new rows when updating). */\r\n  detailFieldKey: string;\r\n  /** True when the document already exists (edit); false for add / copy. */\r\n  isUpdate: boolean;\r\n  /** Body key used when every row belongs to the default collection. Default `Details`. */\r\n  defaultKey?: string;\r\n  /** Name of the default collection. Default `default`. */\r\n  defaultCollection?: string;\r\n  /** Detail field that receives the grid row number (`index` column). Default `RowNum`. */\r\n  rowNumberField?: string;\r\n};\r\n\r\nexport type DetailLine = Record<string, unknown>;\r\n\r\n/**\r\n * Maps a grid snapshot to the server body fragment.\r\n * - Rows with `RowState === 'None'` (unchanged) are skipped.\r\n * - Single default collection → `{ [defaultKey]: DetailLine[] }`.\r\n * - Any custom collection → `{ [collection]: DetailLine[] }` per collection.\r\n */\r\nexport function mapSnapshotToDetails(\r\n  snapshot: TableSnapShot | null | undefined,\r\n  options: SnapshotToDetailsOptions,\r\n): Record<string, DetailLine[]> {\r\n  const {\r\n    detailFieldKey,\r\n    isUpdate,\r\n    defaultKey = 'Details',\r\n    defaultCollection = 'default',\r\n    rowNumberField = 'RowNum',\r\n  } = options;\r\n\r\n  const changed = (snapshot?.rows ?? []).filter(\r\n    (row) => row.rowState !== RowStateEnum.Unchanged,\r\n  );\r\n\r\n  const mapped = changed.map((row) => {\r\n    const detail: DetailLine = {\r\n      RowState: row.rowState,\r\n      ChangeFields: row.changeFields,\r\n    };\r\n\r\n    if (isUpdate && row.rowState !== RowStateEnum.Added) {\r\n      detail[detailFieldKey] = row.id;\r\n    }\r\n    if (row.isSaveDescription) {\r\n      detail.isSaveDescription = row.isSaveDescription;\r\n    }\r\n\r\n    for (const [col, cell] of Object.entries(row.cells ?? {})) {\r\n      if (cell == null) continue;\r\n      if (GRID_INTERNAL_COLUMNS.has(col)) continue;\r\n      if (col === 'index') {\r\n        detail[rowNumberField] = cell;\r\n        continue;\r\n      }\r\n      detail[col] =\r\n        typeof cell === 'object' && 'value' in (cell as object)\r\n          ? (cell as { value: unknown }).value\r\n          : cell;\r\n    }\r\n\r\n    return { detail, collection: row.collection || defaultCollection };\r\n  });\r\n\r\n  const hasCustomCollection = mapped.some(\r\n    (r) => r.collection && r.collection !== defaultCollection,\r\n  );\r\n  if (!hasCustomCollection) {\r\n    return { [defaultKey]: mapped.map((r) => r.detail) };\r\n  }\r\n\r\n  const byCollection: Record<string, DetailLine[]> = {};\r\n  for (const r of mapped) {\r\n    (byCollection[r.collection] ??= []).push(r.detail);\r\n  }\r\n  return byCollection;\r\n}\r\n\r\nexport type DetailsToRowInputsOptions = {\r\n  /** Server primary-key field of a detail line. */\r\n  detailFieldKey: string;\r\n  /** Grid collection the rows belong to. */\r\n  collection: string;\r\n  /** Copy-from-document: clear the PK and mark every row as new. */\r\n  isCopy?: boolean;\r\n  /** Generates a client row id for copied rows. Default: random integer. */\r\n  newRowId?: () => number;\r\n};\r\n\r\n/**\r\n * Maps server detail lines to grid `RowInput`s (initial seed).\r\n * Copy mode strips the primary key and marks lines `Added`.\r\n */\r\nexport function mapDetailsToRowInputs(\r\n  items: readonly DetailLine[],\r\n  options: DetailsToRowInputsOptions,\r\n): RowInput[] {\r\n  const {\r\n    detailFieldKey,\r\n    collection,\r\n    isCopy = false,\r\n    newRowId = () => Math.floor(Math.random() * 100000),\r\n  } = options;\r\n\r\n  return items.map((item) => {\r\n    if (isCopy) {\r\n      const rest = { ...item };\r\n      delete rest[detailFieldKey];\r\n      return {\r\n        id: newRowId(),\r\n        values: {\r\n          ...rest,\r\n          [detailFieldKey]: undefined,\r\n          RowState: RowStateEnum.Added,\r\n          collection,\r\n        },\r\n      };\r\n    }\r\n    return {\r\n      id: item[detailFieldKey] as number,\r\n      values: { ...item, collection },\r\n    };\r\n  });\r\n}\r\n\r\n/** One header (form) field as the host keeps it. */\r\nexport type DocumentHeaderField = {\r\n  name: string;\r\n  value?: unknown;\r\n  originalValue?: unknown;\r\n  type?: string;\r\n  caption?: string;\r\n  [key: string]: unknown;\r\n};\r\n\r\nexport type BuildDocumentPayloadOptions = {\r\n  headerFields: readonly DocumentHeaderField[];\r\n  /** Server primary-key field of the header. */\r\n  headerFieldKey: string;\r\n  /** Existing document id (0 / undefined for a new document). */\r\n  recordId?: number;\r\n  /** Result of {@link mapSnapshotToDetails}. */\r\n  details: Record<string, DetailLine[]>;\r\n  /** Header fields that must be sent as numbers even when typed as text. */\r\n  numericFieldNames?: readonly string[];\r\n};\r\n\r\n/**\r\n * Builds the save body: header values (empty string → null, numeric coercion),\r\n * `ChangeFields` of the header on update, and the detail lines.\r\n */\r\nexport function buildDocumentPayload(\r\n  options: BuildDocumentPayloadOptions,\r\n): Record<string, unknown> {\r\n  const {\r\n    headerFields,\r\n    headerFieldKey,\r\n    recordId = 0,\r\n    details,\r\n    numericFieldNames = [],\r\n  } = options;\r\n  const numeric = new Set<string>([headerFieldKey, ...numericFieldNames]);\r\n\r\n  const formValues = Object.fromEntries(\r\n    headerFields.map((field) => {\r\n      let value = field.value;\r\n      if (value === '') value = null;\r\n      if (value != null && (field.type === 'number' || numeric.has(field.name))) {\r\n        const n = Number(value);\r\n        value = Number.isNaN(n) ? null : n;\r\n      }\r\n      return [field.name, value];\r\n    }),\r\n  );\r\n\r\n  const isUpdate = recordId !== 0 && recordId != null;\r\n  const changeFields = headerFields\r\n    .filter((field) => field.value !== field.originalValue)\r\n    .map((field) => field.name);\r\n\r\n  return {\r\n    ...formValues,\r\n    ChangeFields: isUpdate ? changeFields : undefined,\r\n    ...details,\r\n    [headerFieldKey]: isUpdate ? recordId : undefined,\r\n  };\r\n}\r\n\r\n/**\r\n * Re-seeds header fields from the server record.\r\n * Copy mode clears identity fields (PK + auto-generated numbers).\r\n */\r\nexport function mapServerHeaderToFields(\r\n  fields: readonly DocumentHeaderField[],\r\n  serverRecord: Record<string, unknown> | null | undefined,\r\n  options: {\r\n    headerFieldKey: string;\r\n    recordId: number;\r\n    isCopy?: boolean;\r\n    /** Header fields cleared on copy besides the PK. Default none. */\r\n    copyResetFields?: readonly string[];\r\n    /** Values already edited locally (take precedence over the server). */\r\n    storedFields?: readonly DocumentHeaderField[];\r\n    /** Field caption that marks the primary-key field (`MainIdField`). */\r\n    mainIdCaption?: string;\r\n  },\r\n): DocumentHeaderField[] {\r\n  const {\r\n    headerFieldKey,\r\n    recordId,\r\n    isCopy = false,\r\n    copyResetFields = [],\r\n    storedFields,\r\n    mainIdCaption = 'MainIdField',\r\n  } = options;\r\n  const reset = new Set<string>([headerFieldKey, ...copyResetFields]);\r\n\r\n  const mapped: DocumentHeaderField[] = fields.map((field) => {\r\n    const isIdentity =\r\n      isCopy && (reset.has(field.name) || field.caption === mainIdCaption);\r\n    const stored = storedFields?.find((f) => f.name === field.name)?.value;\r\n    const fromServer = serverRecord\r\n      ? (serverRecord[field.name] ?? undefined)\r\n      : undefined;\r\n    const current = stored !== undefined ? stored : fromServer;\r\n    return {\r\n      ...field,\r\n      value: isIdentity ? null : current,\r\n      originalValue: isIdentity ? null : fromServer,\r\n      isTitleField: field.name === headerFieldKey,\r\n    };\r\n  });\r\n\r\n  mapped.push({\r\n    name: headerFieldKey,\r\n    value: isCopy ? null : recordId,\r\n    originalValue: isCopy ? null : recordId,\r\n    type: 'hidden',\r\n  });\r\n  return mapped;\r\n}\r\n"]}

package/dist/headless.d.cts

@@ -0,0 +1,508 @@
+import { R as RowInput } from './createEngineGridQuery-D-fgO_jg.cjs';
+export { A as AggAccumulator, a as AggregateSnapshot, C as CATALOG_TO_HOST_CALLBACKS, b as CellFocusedEvent, c as CellValueChangedEvent, d as CollectionRowMap, e as ColumnAggIndex, f as ColumnAggSpec, g as ColumnDefinition, H as ColumnSchema, h as ColumnViewBinding, i as ColumnVisibleRange, j as CreateERPTableConfig, k as CreateERPTableResult, l as CreateGridApiInput, m as CreateGridConfig, n as CreateGridResult, D as DEFAULT_EVENT_STORE_PREFIX, o as DEFAULT_GRID_ACTOR, p as DEFAULT_MEMORY_STORE, E as EVENT_CATALOG, q as EventCatalogEntry, r as ExportDataAsExcelOptions, G as GetRowId, s as GridApi, t as GridColumnState, u as GridDatasource, v as GridDatasourceGetRowsParams, w as GridDatasourceGetRowsResult, x as GridRowNode, I as InMemoryEventStore, y as InMemorySnapshotStore, z as IndexedDbEventStore, K as KvDatabase, B as KvStore, L as LEGACY_EVENT_STORE_PREFIX, M as MemoryKvDatabase, N as NoopRemoteApi, P as PluginHost, Q as QuickFilterBlobAccessor, F as QuickFilterIndex, J as ROW_DATA_UPDATED_CATALOG_TYPES, O as RequestExportOptions, S as RequestImportOptions, T as RowDataUpdatedEvent, U as RowValueChangedEvent, V as SelectionChangedEvent, W as SnapshotStore, X as SnapshotStrategy, Y as StartEditingCellParams, Z as ViewportCalculator, _ as accumulateAdd, $ as accumulateRemove, a0 as applyAgg, a1 as applyQuickFilter, a2 as buildCumulativeWidths, a3 as buildQuickFilterBlob, a4 as calculateColumnViewport, a5 as columnDefFieldName, a6 as createAccumulator, a7 as createERPTable, a8 as createEngineGridQuery, a9 as createGrid, aa as createGridApi, ab as createGridTableKey, ac as dispatchCatalogHostEvent, ad as eventStoreDbName, ae as getEventCatalogEntry, af as isAggFuncName, ag as isCustomAggFunc, ah as listUndoableEventTypes, ai as mapColumnDefs, aj as mapColumnSchemas, ak as mapColumnSchemasToDefs, al as normalizeQuickFilterText, am as openIndexedDbDatabase, an as readAccumulator, ao as resolveColumnAggSpecs, ap as resolveCreateGridDefaults, aq as subscribeCatalogHostEvents, ar as toColumnDef, as as toColumnDefinition, at as toColumnSchema, au as toColumnViewBinding, av as toMinorUnits } from './createEngineGridQuery-D-fgO_jg.cjs';
+import { w as CellAddress, d as CellRange, x as FieldType, e as TableEngine, E as EventStore, G as GridEvent, T as TableSnapShot, W as WindowedTableRepository, f as Table, c as CollectionScope, R as Row } from './GridSession-CmQn2RnL.cjs';
+export { A as AggFunc, y as AggFuncName, z as AppendResult, B as AriaSortValue, I as ArrowDirection, J as BooleanColumnFilter, K as BooleanFilterOp, L as BuiltinFilterKind, N as CellRangeBounds, O as CellRangeSelection, l as ColumnDef, P as ColumnDefBridge, Q as ColumnField, S as ColumnFilter, X as ColumnPinned, Y as CombinedColumnFilter, Z as CustomColumnFilter, _ as CustomFilterFn, $ as CycleSortModelOptions, a0 as DateColumnFilter, a1 as DateFilterOp, a2 as FilterAccessor, a3 as FilterDef, a4 as FilterJoin, F as FilterModel, b as GridSession, a5 as HEADER_SORT_CLICK_MAX_MOVE_PX, a6 as INDEX_COL_ID, a7 as ItemType, a8 as NumberColumnFilter, a9 as NumberFilterOp, aa as PersistedRowRecord, ab as RowModelType, ac as RowStateEnum, ad as SetColumnFilter, ae as SetFilterOp, af as SimpleColumnFilter, ag as SortAccessor, ah as SortDirection, ai as SortModel, aj as SortModelItem, ak as SortValueComparator, al as SparseRowIndex, k as TableViewState, am as TextColumnFilter, an as TextFilterOp, V as ValidCell, ao as ViewIntent, ap as Viewport, aq as VisibleRange, ar as applyFilter, as as applyHostRowDataToTable, at as applySort, au as ariaSortForColumn, av as clampColIndex, aw as clampRowIndex, ax as clickCell, ay as colIndex, az as collectUniqueFilterValues, aA as compareSortValues, aB as compareTypedValues, aC as createEmptyCellRangeSelection, aD as ctrlClickCell, aE as cycleSortModel, aF as defaultGetRowId, aG as ensureIndexColumnDef, aH as isBlankSortValue, aI as isCellInRange, aJ as isColumnFilterActive, aK as isHeaderColumnSortable, aL as isServerRowModel, aM as isWindowedRepository, aN as mapRowDataToRowInputs, aO as mergeCellRanges, aP as moveCellAddress, aQ as normalizeCellRange, aR as normalizeDigits, aS as normalizeFilterText, aT as pageWindow, aU as rangeFromAnchorFocus, aV as rangesOverlap, aW as resolveBuiltinFilterKind, aX as selectAllCellRanges, aY as shiftArrowCell, aZ as shiftClickCell, a_ as shouldCommitHeaderSortClick, a$ as sortPriorityForColumn } from './GridSession-CmQn2RnL.cjs';
+export { R as RemoteApi } from './RemoteApi-CCQxiSf1.cjs';
+import { G as GridClipboardRuntimeOptions, j as PasteGridResult, g as SyncPort, O as OfflineStatus, i as SyncTransport, e as SyncConflictPolicy, S as SyncConflict, h as SyncResult, M as ManualResolution, c as PresencePort, d as PresenceTransport, P as PresenceLocalState, b as PresencePeer } from './UITableController-CIwnHIw8.cjs';
+export { C as ClipboardCellSnapshot, k as ClipboardColumnMeta, l as ClipboardCopyBuildOptions, m as ClipboardCopyEvent, n as ClipboardPasteEvent, o as ClipboardPayload, p as ClipboardRowSnapshot, q as GridPasteRuntimeOptions, a as PresenceMessage, r as ProcessCellForClipboardParams, f as SyncConflictSide, U as UITableController, s as buildClipboardPayload, t as copyGridSelectionToClipboard, u as cutGridSelectionToClipboard, v as pasteGridFromClipboard, w as readSystemClipboardText, x as resolveCopyRanges, y as writeSystemClipboard } from './UITableController-CIwnHIw8.cjs';
+export { E as ExportSource, G as GridPlugin, a as GridPluginContext, c as GridQueryPort } from './GridPlugin-DewWufGZ.cjs';
+export { P as PdfRenderer } from './PdfRenderer-B9FJaCo_.cjs';
+export { C as CallbackRemoteApi, R as RemoteApiRequest } from './callbackRemoteApi-Cv26MmSD.cjs';
+import 'react';
+
+type CellRangeEdgeFlags = {
+    inRange: boolean;
+    top: boolean;
+    bottom: boolean;
+    left: boolean;
+    right: boolean;
+};
+/** Which edges of a cell should show range chrome (PR-105). */
+declare function resolveCellRangePresentation(cell: CellAddress, ranges: readonly CellRange[]): CellRangeEdgeFlags;
+declare function cellRangeEdgeAttr(flags: CellRangeEdgeFlags): string | undefined;
+declare function cellRangeClassName(flags: CellRangeEdgeFlags): string;
+
+/** Strip grouping separators and normalize Persian decimal (٫) to `.`. */
+declare function normalizePersianNumberText(text: string): string;
+declare function parseClipboardNumber(text: string): number | null;
+declare function parseClipboardDate(text: string): string;
+type CoercePastedCellResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    reason: string;
+};
+declare function coercePastedCellValue(fieldType: FieldType | undefined, rawText: string): CoercePastedCellResult;
+
+/**
+ * Pure clipboard paste parse + target tiling (PR-107).
+ * No DOM / React.
+ */
+
+type PasteTarget = {
+    rowIndex: number;
+    colId: string;
+    rawText: string;
+};
+type SkippedPasteTarget = PasteTarget & {
+    reason: string;
+};
+type PasteColumnMeta = {
+    id: string;
+    editable?: boolean;
+    /** Skip paste into index chrome columns by default. */
+    fieldType?: string;
+};
+type BuildPastePlanInput = {
+    text: string;
+    ranges: readonly CellRange[];
+    activeCell?: {
+        rowIndex: number;
+        colId: string;
+    } | null;
+    columnOrder: readonly string[];
+    columns: readonly PasteColumnMeta[];
+    pasteAddsRows?: boolean;
+    rowCount: number;
+};
+type PastePlan = {
+    matrix: readonly (readonly string[])[];
+    targets: readonly PasteTarget[];
+    skipped: readonly SkippedPasteTarget[];
+    rowsToAdd: number;
+};
+/**
+ * Parse TSV/CSV including quoted fields and embedded newlines.
+ */
+declare function parseDelimitedClipboardText(text: string, delimiter?: string): string[][];
+declare function buildPastePlan(input: BuildPastePlanInput): PastePlan | null;
+
+/**
+ * Pure fill-handle series + target builder (PR-108).
+ */
+
+type FillSeriesKind = 'number' | 'jalali' | 'copy';
+type FillTarget = {
+    rowIndex: number;
+    colId: string;
+    rawText: string;
+};
+type FillCorner = {
+    rowIndex: number;
+    colId: string;
+    colIndex: number;
+};
+declare function addJalaliMonths(parts: {
+    y: number;
+    m: number;
+    d: number;
+}, months: number): {
+    y: number;
+    m: number;
+    d: number;
+};
+declare function detectFillSeries(values: readonly string[]): {
+    kind: FillSeriesKind;
+    numberStep?: number;
+};
+declare function extendSeriesValue(kind: FillSeriesKind, sourceValues: readonly string[], offset: number, numberStep?: number): string;
+declare function resolveFillCorner(ranges: readonly CellRange[], columnOrder: readonly string[]): FillCorner | null;
+declare function buildFillUpdates(input: {
+    sourceRange: CellRange;
+    extendToRowIndex: number;
+    extendToColIndex: number;
+    columnOrder: readonly string[];
+    getSourceText: (rowIndex: number, colId: string) => string;
+    copyOnly: boolean;
+}): FillTarget[];
+
+declare function applyFillHandleDrag(engine: TableEngine, store: string, tableKey: string, extendTo: {
+    rowIndex: number;
+    colIndex: number;
+}, copyOnly: boolean, options?: GridClipboardRuntimeOptions): Promise<PasteGridResult>;
+
+type GridSyncServiceOptions = {
+    readonly tableId: string;
+    readonly eventStore: EventStore;
+    readonly offlineStatus: OfflineStatus;
+    readonly transport: SyncTransport;
+    /** Apply a winning remote CELL_CHANGED into the local domain. */
+    readonly applyCellValue: (rowId: number, columnId: string, value: unknown) => Promise<void>;
+    /** Initial pull cursor (default 0). */
+    readonly initialCursor?: number;
+    readonly policy?: SyncConflictPolicy;
+};
+/**
+ * SyncPort implementation over EventStore + OfflineStatus + SyncTransport (PR-138).
+ */
+declare class GridSyncService implements SyncPort {
+    private readonly options;
+    private policy;
+    private cursor;
+    private openConflicts;
+    private readonly conflictListeners;
+    /** Remote events waiting on manual resolution (by conflict id). */
+    private readonly deferredRemote;
+    private disposed;
+    constructor(options: GridSyncServiceOptions);
+    getPolicy(): SyncConflictPolicy;
+    setPolicy(policy: SyncConflictPolicy): void;
+    getOpenConflicts(): readonly SyncConflict[];
+    subscribeConflicts(listener: (conflicts: readonly SyncConflict[]) => void): () => void;
+    /** Drop listeners and deferred conflicts; later sync() calls are no-ops. */
+    dispose(): void;
+    private emptyResult;
+    sync(): Promise<SyncResult>;
+    resolveConflict(conflictId: string, choice: ManualResolution): Promise<void>;
+    private applyRemoteCell;
+    private ingestRemote;
+    private emitConflicts;
+}
+
+/**
+ * Shared in-memory sync hub for tests / demos (PR-138).
+ * Each client gets a transport bound to a clientId.
+ */
+declare class InMemorySyncHub {
+    private log;
+    private readonly clients;
+    transportFor(clientId: string): SyncTransport;
+    private push;
+    private pull;
+    /** Test helper: all events currently on the hub. */
+    getLog(): readonly GridEvent[];
+}
+
+type GridPresenceServiceOptions = {
+    readonly tableId: string;
+    readonly actorId: string;
+    readonly label?: string;
+    readonly transport: PresenceTransport;
+    readonly peerId?: string;
+    readonly color?: string;
+    /** Drop peers quieter than this (ms). Default 15s. */
+    readonly staleMs?: number;
+};
+/**
+ * PresencePort: broadcast local cursor/selection; track remote peers (PR-139).
+ * Does not merge cell values — editing different cells stays conflict-free.
+ */
+declare class GridPresenceService implements PresencePort {
+    private readonly options;
+    private readonly local;
+    private peers;
+    private readonly listeners;
+    private unsub;
+    private disposed;
+    private readonly staleMs;
+    constructor(options: GridPresenceServiceOptions);
+    getLocal(): PresenceLocalState;
+    getPeers(): readonly PresencePeer[];
+    setActiveCell(rowId: number | null, columnId: string | null): void;
+    dispose(): void;
+    subscribe(listener: (peers: readonly PresencePeer[]) => void): () => void;
+    private broadcast;
+    private onMessage;
+    private pruneStale;
+    private emit;
+}
+
+/**
+ * Shared in-memory presence hub for tests / Node (PR-139).
+ * Mirrors BroadcastChannel semantics without DOM.
+ */
+declare class InMemoryPresenceHub {
+    private readonly clients;
+    transportFor(clientId: string): PresenceTransport;
+}
+
+/**
+ * Browser BroadcastChannel presence transport (PR-139).
+ * Channel name should be scoped per table: `pdg-presence:{store}:{tableKey}`.
+ */
+declare function createBroadcastChannelPresenceTransport(channelName: string): PresenceTransport;
+
+/**
+ * Document-grid mapping (header + detail lines) — pure, framework-free.
+ *
+ * Extracted from the arianERP form host hook so the project keeps ZERO table
+ * logic: the host only injects I/O (fetch, save, page state) and calls these
+ * functions. Nothing here knows Redux, Next.js, or any backend URL.
+ */
+
+type SnapshotToDetailsOptions = {
+    /** Server primary-key field of a detail line (sent for non-new rows when updating). */
+    detailFieldKey: string;
+    /** True when the document already exists (edit); false for add / copy. */
+    isUpdate: boolean;
+    /** Body key used when every row belongs to the default collection. Default `Details`. */
+    defaultKey?: string;
+    /** Name of the default collection. Default `default`. */
+    defaultCollection?: string;
+    /** Detail field that receives the grid row number (`index` column). Default `RowNum`. */
+    rowNumberField?: string;
+};
+type DetailLine = Record<string, unknown>;
+/**
+ * Maps a grid snapshot to the server body fragment.
+ * - Rows with `RowState === 'None'` (unchanged) are skipped.
+ * - Single default collection → `{ [defaultKey]: DetailLine[] }`.
+ * - Any custom collection → `{ [collection]: DetailLine[] }` per collection.
+ */
+declare function mapSnapshotToDetails(snapshot: TableSnapShot | null | undefined, options: SnapshotToDetailsOptions): Record<string, DetailLine[]>;
+type DetailsToRowInputsOptions = {
+    /** Server primary-key field of a detail line. */
+    detailFieldKey: string;
+    /** Grid collection the rows belong to. */
+    collection: string;
+    /** Copy-from-document: clear the PK and mark every row as new. */
+    isCopy?: boolean;
+    /** Generates a client row id for copied rows. Default: random integer. */
+    newRowId?: () => number;
+};
+/**
+ * Maps server detail lines to grid `RowInput`s (initial seed).
+ * Copy mode strips the primary key and marks lines `Added`.
+ */
+declare function mapDetailsToRowInputs(items: readonly DetailLine[], options: DetailsToRowInputsOptions): RowInput[];
+/** One header (form) field as the host keeps it. */
+type DocumentHeaderField = {
+    name: string;
+    value?: unknown;
+    originalValue?: unknown;
+    type?: string;
+    caption?: string;
+    [key: string]: unknown;
+};
+type BuildDocumentPayloadOptions = {
+    headerFields: readonly DocumentHeaderField[];
+    /** Server primary-key field of the header. */
+    headerFieldKey: string;
+    /** Existing document id (0 / undefined for a new document). */
+    recordId?: number;
+    /** Result of {@link mapSnapshotToDetails}. */
+    details: Record<string, DetailLine[]>;
+    /** Header fields that must be sent as numbers even when typed as text. */
+    numericFieldNames?: readonly string[];
+};
+/**
+ * Builds the save body: header values (empty string → null, numeric coercion),
+ * `ChangeFields` of the header on update, and the detail lines.
+ */
+declare function buildDocumentPayload(options: BuildDocumentPayloadOptions): Record<string, unknown>;
+/**
+ * Re-seeds header fields from the server record.
+ * Copy mode clears identity fields (PK + auto-generated numbers).
+ */
+declare function mapServerHeaderToFields(fields: readonly DocumentHeaderField[], serverRecord: Record<string, unknown> | null | undefined, options: {
+    headerFieldKey: string;
+    recordId: number;
+    isCopy?: boolean;
+    /** Header fields cleared on copy besides the PK. Default none. */
+    copyResetFields?: readonly string[];
+    /** Values already edited locally (take precedence over the server). */
+    storedFields?: readonly DocumentHeaderField[];
+    /** Field caption that marks the primary-key field (`MainIdField`). */
+    mainIdCaption?: string;
+}): DocumentHeaderField[];
+
+/**
+ * RAM = current page window only.
+ * IndexedDB = source of truth for all rows.
+ *
+ * After `clearLocal` (page leave / dispose), all IDB ops for that table are
+ * skipped until the table is opened again via getById/replaceAll.
+ */
+declare class PagedCachedTableRepository implements WindowedTableRepository {
+    private localRepo;
+    private indexedRepo;
+    private persistChain;
+    /** Tables closed by dispose — block further IDB rebuild/load until reopened */
+    private closedKeys;
+    constructor();
+    private queueKey;
+    private isClosed;
+    private reopen;
+    private enqueuePersist;
+    flush(store: string, tableKey: string): Promise<void>;
+    getById(store: string, tableKey: string): Promise<Table>;
+    save(store: string, table: Table): Promise<void>;
+    replaceAll(store: string, table: Table): Promise<void>;
+    loadPage(store: string, tableKey: string, page: number, pageSize?: number): Promise<Table | null>;
+    /**
+     * Collection switch: swap the RAM window with page 1 of the NEW collection
+     * (loaded from IndexedDB) and persist the switch in meta. Rows of other
+     * collections are never touched.
+     */
+    setActiveCollection(store: string, tableKey: string, collection: string): Promise<Table | null>;
+    /** ColumnSchema holds functions — never come back from IndexedDB; keep RAM handlers. */
+    private restoreLiveColumns;
+    getAllRows(store: string, tableKey: string, collectionScope?: CollectionScope): Promise<Row[]>;
+    getAllRowIds(store: string, tableKey: string, collectionScope?: CollectionScope): Promise<number[]>;
+    clearLocal(store: string, tableKey: string): void;
+    delete(store: string, tableKey: string): Promise<void>;
+    resetTable(store: string, tableKey: string): Promise<void>;
+    exists(store: string, tableKey: string): Promise<boolean>;
+    /** Stream row records in batches (never the whole dataset in heap). */
+    iterateRowRecords(store: string, tableKey: string, collectionScope: CollectionScope, onBatch: Parameters<WindowedTableRepository['iterateRowRecords']>[3], batchSize?: number): Promise<void>;
+    removeRows(store: string, tableKey: string, rowIds: number[]): Promise<void>;
+    /**
+     * Bulk delete straight on IndexedDB records (Memory Iron Rule: no full
+     * hydration, no replaceAll). After the persisted delete, the RAM window is
+     * reloaded from IndexedDB so pagination/rows stay consistent.
+     */
+    softDeleteRows(store: string, tableKey: string, rowIds: number[]): Promise<{
+        softDeleted: number;
+        hardRemoved: number;
+        remaining: number;
+    }>;
+}
+
+declare class PagedIndexedDbTableRepository implements WindowedTableRepository {
+    private dbPromise;
+    constructor();
+    private bindDb;
+    /**
+     * Open at the *existing* DB version (no fixed version number).
+     * ensureStores() bumps version only when new object stores are needed.
+     * A fixed open(version) would throw VersionError after lazy upgrades.
+     */
+    private initDb;
+    private getDb;
+    private metaStore;
+    private rowsStore;
+    private ensureStores;
+    private serializeRow;
+    private deserializeRow;
+    private serializeColumn;
+    private buildMetaFromTable;
+    private buildTableFromPage;
+    private readMeta;
+    private isLegacy;
+    private migrateLegacy;
+    private putMeta;
+    private putRows;
+    /** Put already-serialized row records directly (no domain Row round-trip). */
+    private putRowRecords;
+    private deleteAllRowsForTable;
+    /**
+     * Single cursor pass over the byTableCollectionSort index, yielding batches.
+     * The index gives collection-sorted order — no in-memory sort needed.
+     * Falls back to a full scan when the index is missing (legacy stores).
+     * onBatch may return false to stop early.
+     */
+    private iterateRows;
+    /**
+     * Page-window read via cursor + offset on the sorted index.
+     * Only `pageSize` records cross the heap — not the whole collection.
+     */
+    private queryPageRows;
+    private queryAllRowRecords;
+    private ensureMeta;
+    /**
+     * One-time re-key: `table::rowId` → `table::collection::rowId`.
+     * Old-format records may collide (same PK in different collections overwrote
+     * each other); after re-keying, per-collection counts in meta are re-derived
+     * from the actual records so pagination stops being scrambled.
+     */
+    private migrateToCollectionScopedKeys;
+    getById(storeName: string, tableId: string): Promise<Table>;
+    save(storeName: string, table: Table): Promise<void>;
+    replaceAll(storeName: string, table: Table): Promise<void>;
+    loadPage(storeName: string, tableId: string, page: number, pageSize?: number): Promise<Table | null>;
+    /**
+     * Persist the new active collection (page back to 1) and return a RAM window
+     * holding page 1 of that collection only. Rows of other collections stay
+     * untouched in IndexedDB — the returned Table contains no other-collection rows.
+     */
+    setActiveCollection(storeName: string, tableId: string, collection: string): Promise<Table | null>;
+    getAllRows(storeName: string, tableId: string, collectionScope?: CollectionScope): Promise<Row[]>;
+    getAllRowIds(storeName: string, tableId: string, collectionScope?: CollectionScope): Promise<number[]>;
+    clearLocal(_store: string, _tableKey: string): void;
+    flush(_store: string, _tableKey: string): Promise<void>;
+    exists(storeName: string, tableId: string): Promise<boolean>;
+    delete(storeName: string, tableId: string): Promise<void>;
+    resetTable(storeName: string, tableId: string): Promise<void>;
+    /**
+     * Port: stream serialized row records in bounded batches (cursor over the
+     * sorted index). 'active' → index cursor on the active collection;
+     * 'all'/array → full scan filtered in-memory per batch. Heap = one batch.
+     */
+    iterateRowRecords(storeName: string, tableId: string, collectionScope: CollectionScope | undefined, onBatch: (records: {
+        rowId: number;
+        collection: string;
+        sortIndex: number;
+        rowState: string;
+        cells: Record<string, {
+            value: unknown;
+            originalValue: unknown;
+            display: unknown;
+        }>;
+    }[], ordinalBase: number) => Promise<boolean | void>, batchSize?: number): Promise<void>;
+    /**
+     * Bulk soft/hard delete directly on persisted records in ONE readwrite
+     * transaction — cursor over the `byTable` index (no full hydration, heap
+     * stays O(1)). `Added` → hard delete; others → cursor.update to Deleted;
+     * already-Deleted → untouched. Never goes through replaceAll.
+     */
+    softDeleteRows(storeName: string, tableId: string, rowIds: number[]): Promise<{
+        softDeleted: number;
+        hardRemoved: number;
+        remaining: number;
+    }>;
+    removeRows(storeName: string, tableId: string, rowIds: number[]): Promise<void>;
+}
+
+/**
+ * RAM window only — holds at most the current page of rows for each table.
+ * IndexedDB is the source of truth; this never stores the full dataset.
+ */
+declare class PagedLocalTableRepository implements WindowedTableRepository {
+    private tables;
+    exists(_store: string, tableKey: string): Promise<boolean>;
+    getById(_store: string, tableKey: string): Promise<Table>;
+    save(_store: string, table: Table): Promise<void>;
+    replaceAll(_store: string, table: Table): Promise<void>;
+    loadPage(_store: string, tableKey: string, _page: number, _pageSize?: number): Promise<Table | null>;
+    /**
+     * RAM window: a switch replaces the window with the one returned by the
+     * IndexedDB layer, so nothing to persist here — just keep the new table.
+     */
+    setActiveCollection(_store: string, tableKey: string, collection: string): Promise<Table | null>;
+    getAllRows(_store: string, tableKey: string, collectionScope?: CollectionScope): Promise<Row[]>;
+    getAllRowIds(_store: string, tableKey: string, collectionScope?: CollectionScope): Promise<number[]>;
+    clearLocal(_store: string, tableKey: string): void;
+    flush(): Promise<void>;
+    delete(_store: string, tableKey: string): Promise<void>;
+    resetTable(_store: string, tableKey: string): Promise<void>;
+    /**
+     * RAM window only — streams the current page's rows as a single batch.
+     * (The full dataset lives in IndexedDB, not here.)
+     */
+    iterateRowRecords(_store: string, tableKey: string, collectionScope: CollectionScope, onBatch: (records: {
+        rowId: number;
+        collection: string;
+        sortIndex: number;
+        rowState: string;
+        cells: Record<string, {
+            value: unknown;
+            originalValue: unknown;
+            display: unknown;
+        }>;
+    }[], ordinalBase: number) => Promise<boolean | void>): Promise<void>;
+    removeRows(): Promise<void>;
+    /**
+     * RAM-window bulk delete (Memory Iron Rule compliant): only the current
+     * page's rows are mutated — Added hard-removed, others soft-deleted via
+     * domain Row state; already-Deleted untouched. Remaining counts come from
+     * pagination totals minus this operation's effects (no full-dataset scan).
+     */
+    softDeleteRows(_store: string, tableKey: string, rowIds: number[]): Promise<{
+        softDeleted: number;
+        hardRemoved: number;
+        remaining: number;
+    }>;
+}
+
+export { type BuildDocumentPayloadOptions, CellAddress, CellRange, type CellRangeEdgeFlags, type CoercePastedCellResult, type DetailLine, type DetailsToRowInputsOptions, type DocumentHeaderField, EventStore, FieldType, type FillCorner, type FillSeriesKind, type FillTarget, GridClipboardRuntimeOptions, GridPresenceService, GridSyncService, InMemoryPresenceHub, InMemorySyncHub, ManualResolution, PagedCachedTableRepository, PagedIndexedDbTableRepository, PagedLocalTableRepository, type PasteColumnMeta, PasteGridResult, type PastePlan, type PasteTarget, PresenceLocalState, PresencePeer, PresencePort, PresenceTransport, RowInput, type SkippedPasteTarget, type SnapshotToDetailsOptions, SyncConflict, SyncConflictPolicy, SyncPort, SyncResult, SyncTransport, TableEngine, TableSnapShot, WindowedTableRepository, addJalaliMonths, applyFillHandleDrag, buildDocumentPayload, buildFillUpdates, buildPastePlan, cellRangeClassName, cellRangeEdgeAttr, coercePastedCellValue, createBroadcastChannelPresenceTransport, detectFillSeries, extendSeriesValue, mapDetailsToRowInputs, mapServerHeaderToFields, mapSnapshotToDetails, normalizePersianNumberText, parseClipboardDate, parseClipboardNumber, parseDelimitedClipboardText, resolveCellRangePresentation, resolveFillCorner };