persian-data-grid 0.5.0 → 0.6.0

package/dist/applyImportedRows-BO6yxoAN.d.cts

@@ -0,0 +1,135 @@
+import { G as GridPlugin, a as GridPluginContext, E as ExportSource, b as ExportColumnDef } from './GridPlugin-oxhq8AsM.cjs';
+import { U as UITableController } from './UITableController-Cuwq481K.cjs';
+import { b as GridSession } from './GridSession-B-9lLcoB.cjs';
+
+type ExcelExportPluginOptions = {
+    /** Skip browser download (useful in tests / Node). */
+    download?: boolean;
+    onBlob?: (blob: Blob, meta: {
+        fileName: string;
+        rowCount: number;
+        columnCount: number;
+    }) => void;
+};
+/**
+ * Subscribes to EXPORT_REQUESTED (format=xlsx); never mutates Domain.
+ */
+declare class ExcelExportPlugin implements GridPlugin {
+    private readonly options;
+    readonly name = "excel-export";
+    private unsub;
+    constructor(options?: ExcelExportPluginOptions);
+    register(ctx: GridPluginContext): void;
+    dispose(): void;
+    private onEvent;
+}
+
+type ExcelImportPluginOptions = {
+    onImported?: (meta: {
+        rowCount: number;
+        columnCount: number;
+    }) => void;
+};
+/**
+ * Subscribes to IMPORT_REQUESTED (format=xlsx); mutates domain only via
+ * session/engine commands (never touches Entity directly).
+ */
+declare class ExcelImportPlugin implements GridPlugin {
+    private readonly options;
+    readonly name = "excel-import";
+    private unsub;
+    constructor(options?: ExcelImportPluginOptions);
+    register(ctx: GridPluginContext): void;
+    dispose(): void;
+    private onEvent;
+}
+
+type ExportActiveCollectionResult = {
+    rowCount: number;
+    columnCount: number;
+};
+type ExportActiveCollectionOptions = {
+    fileName?: string;
+    sheetName?: string;
+    direction?: 'rtl' | 'ltr';
+    rowHeaderLabel?: string;
+    /** When false, skip browser download (tests). */
+    download?: boolean;
+};
+/**
+ * Imperative facade used by ERP toolbar buttons.
+ * Prefer PluginHost.requestExport + ExcelExportPlugin for event-driven hosts.
+ */
+declare function exportActiveCollectionToExcel(controller: UITableController, options?: ExportActiveCollectionOptions): Promise<ExportActiveCollectionResult>;
+
+type ExportTable = {
+    columns: Array<{
+        fieldName: string;
+        caption: string;
+    }>;
+    /** Parallel to columns; already stringified cell text */
+    rows: string[][];
+    /** Parallel to rows (PR-122). Absent ⇒ all leaf. */
+    rowKinds?: Array<'group' | 'leaf' | 'total'>;
+    /** Excel outlineLevel per data row (PR-122). */
+    outlineLevels?: number[];
+};
+/**
+ * Builds a dense string matrix from ExportSource (plugin query port).
+ */
+declare function buildExportTable(source: ExportSource): ExportTable;
+
+type BuildXlsxOptions = {
+    sheetName?: string;
+    direction?: 'rtl' | 'ltr';
+    rowHeaderLabel?: string;
+};
+declare function buildXlsxBlob(table: ExportTable, options?: BuildXlsxOptions): Blob;
+declare function downloadBlob(blob: Blob, fileName: string): void;
+
+type ParsedXlsxSheet = {
+    /** First row cells (header captions / field names). */
+    headers: string[];
+    /** Body rows; each row length matches headers (padded with ''). */
+    rows: string[][];
+};
+/**
+ * Parses a minimal OOXML .xlsx (store or deflate) into a string matrix.
+ * Supports shared strings and inlineStr (as produced by buildXlsxBlob).
+ */
+declare function parseXlsxBlob(data: Blob | ArrayBuffer | Uint8Array, options?: {
+    sheetName?: string;
+}): Promise<ParsedXlsxSheet>;
+
+type ImportCellKv = {
+    key: string;
+    value: unknown;
+    display: unknown;
+};
+type MappedImportRows = {
+    columns: Array<{
+        fieldName: string;
+        fieldType?: string;
+    }>;
+    /** One KeyValue[] per data row (no index column). */
+    rows: ImportCellKv[][];
+};
+/**
+ * Maps sheet headers to export/query columns by caption or fieldName.
+ * Skips index/static columns.
+ */
+declare function mapImportedSheet(sheet: ParsedXlsxSheet, columns: readonly ExportColumnDef[]): MappedImportRows;
+
+type ApplyImportedRowsResult = {
+    rowCount: number;
+};
+/**
+ * Applies imported cell matrices through the engine (ADD_NEW_ROWS) so
+ * CachedTableRepository / IndexedDB persistence stays on the normal path.
+ *
+ * Uses a synthetic unique `index` token only for dedupe in Table.addNewRows;
+ * addNewRow still auto-assigns the real index cell.
+ */
+declare function applyImportedRows(session: GridSession, rows: ImportCellKv[][]): Promise<ApplyImportedRowsResult>;
+
+export { ExcelExportPlugin as E, type ParsedXlsxSheet as P, type ExcelExportPluginOptions as a, ExcelImportPlugin as b, type ExcelImportPluginOptions as c, type ExportActiveCollectionOptions as d, type ExportActiveCollectionResult as e, type ExportTable as f, applyImportedRows as g, buildExportTable as h, buildXlsxBlob as i, downloadBlob as j, exportActiveCollectionToExcel as k, mapImportedSheet as m, parseXlsxBlob as p };

package/dist/applyImportedRows-D4zVY8uD.d.ts

@@ -0,0 +1,135 @@
+import { G as GridPlugin, a as GridPluginContext, E as ExportSource, b as ExportColumnDef } from './GridPlugin-CJCaYnlw.js';
+import { U as UITableController } from './UITableController-DU8RopUM.js';
+import { b as GridSession } from './GridSession-Bc7UIawO.js';
+
+type ExcelExportPluginOptions = {
+    /** Skip browser download (useful in tests / Node). */
+    download?: boolean;
+    onBlob?: (blob: Blob, meta: {
+        fileName: string;
+        rowCount: number;
+        columnCount: number;
+    }) => void;
+};
+/**
+ * Subscribes to EXPORT_REQUESTED (format=xlsx); never mutates Domain.
+ */
+declare class ExcelExportPlugin implements GridPlugin {
+    private readonly options;
+    readonly name = "excel-export";
+    private unsub;
+    constructor(options?: ExcelExportPluginOptions);
+    register(ctx: GridPluginContext): void;
+    dispose(): void;
+    private onEvent;
+}
+
+type ExcelImportPluginOptions = {
+    onImported?: (meta: {
+        rowCount: number;
+        columnCount: number;
+    }) => void;
+};
+/**
+ * Subscribes to IMPORT_REQUESTED (format=xlsx); mutates domain only via
+ * session/engine commands (never touches Entity directly).
+ */
+declare class ExcelImportPlugin implements GridPlugin {
+    private readonly options;
+    readonly name = "excel-import";
+    private unsub;
+    constructor(options?: ExcelImportPluginOptions);
+    register(ctx: GridPluginContext): void;
+    dispose(): void;
+    private onEvent;
+}
+
+type ExportActiveCollectionResult = {
+    rowCount: number;
+    columnCount: number;
+};
+type ExportActiveCollectionOptions = {
+    fileName?: string;
+    sheetName?: string;
+    direction?: 'rtl' | 'ltr';
+    rowHeaderLabel?: string;
+    /** When false, skip browser download (tests). */
+    download?: boolean;
+};
+/**
+ * Imperative facade used by ERP toolbar buttons.
+ * Prefer PluginHost.requestExport + ExcelExportPlugin for event-driven hosts.
+ */
+declare function exportActiveCollectionToExcel(controller: UITableController, options?: ExportActiveCollectionOptions): Promise<ExportActiveCollectionResult>;
+
+type ExportTable = {
+    columns: Array<{
+        fieldName: string;
+        caption: string;
+    }>;
+    /** Parallel to columns; already stringified cell text */
+    rows: string[][];
+    /** Parallel to rows (PR-122). Absent ⇒ all leaf. */
+    rowKinds?: Array<'group' | 'leaf' | 'total'>;
+    /** Excel outlineLevel per data row (PR-122). */
+    outlineLevels?: number[];
+};
+/**
+ * Builds a dense string matrix from ExportSource (plugin query port).
+ */
+declare function buildExportTable(source: ExportSource): ExportTable;
+
+type BuildXlsxOptions = {
+    sheetName?: string;
+    direction?: 'rtl' | 'ltr';
+    rowHeaderLabel?: string;
+};
+declare function buildXlsxBlob(table: ExportTable, options?: BuildXlsxOptions): Blob;
+declare function downloadBlob(blob: Blob, fileName: string): void;
+
+type ParsedXlsxSheet = {
+    /** First row cells (header captions / field names). */
+    headers: string[];
+    /** Body rows; each row length matches headers (padded with ''). */
+    rows: string[][];
+};
+/**
+ * Parses a minimal OOXML .xlsx (store or deflate) into a string matrix.
+ * Supports shared strings and inlineStr (as produced by buildXlsxBlob).
+ */
+declare function parseXlsxBlob(data: Blob | ArrayBuffer | Uint8Array, options?: {
+    sheetName?: string;
+}): Promise<ParsedXlsxSheet>;
+
+type ImportCellKv = {
+    key: string;
+    value: unknown;
+    display: unknown;
+};
+type MappedImportRows = {
+    columns: Array<{
+        fieldName: string;
+        fieldType?: string;
+    }>;
+    /** One KeyValue[] per data row (no index column). */
+    rows: ImportCellKv[][];
+};
+/**
+ * Maps sheet headers to export/query columns by caption or fieldName.
+ * Skips index/static columns.
+ */
+declare function mapImportedSheet(sheet: ParsedXlsxSheet, columns: readonly ExportColumnDef[]): MappedImportRows;
+
+type ApplyImportedRowsResult = {
+    rowCount: number;
+};
+/**
+ * Applies imported cell matrices through the engine (ADD_NEW_ROWS) so
+ * CachedTableRepository / IndexedDB persistence stays on the normal path.
+ *
+ * Uses a synthetic unique `index` token only for dedupe in Table.addNewRows;
+ * addNewRow still auto-assigns the real index cell.
+ */
+declare function applyImportedRows(session: GridSession, rows: ImportCellKv[][]): Promise<ApplyImportedRowsResult>;
+
+export { ExcelExportPlugin as E, type ParsedXlsxSheet as P, type ExcelExportPluginOptions as a, ExcelImportPlugin as b, type ExcelImportPluginOptions as c, type ExportActiveCollectionOptions as d, type ExportActiveCollectionResult as e, type ExportTable as f, applyImportedRows as g, buildExportTable as h, buildXlsxBlob as i, downloadBlob as j, exportActiveCollectionToExcel as k, mapImportedSheet as m, parseXlsxBlob as p };

package/dist/applyRowVisibilityHandler-KS6TMCBN.js

@@ -0,0 +1,83 @@
+import { logError, applyRemoteVisibilityRules } from './chunk-RM6ZWNT3.js';
+import { DomainError } from './chunk-KHMG6EI2.js';
+import { ColumnId, RowId } from './chunk-XLRE2J25.js';
+
+// application/handlers/applyRowVisibilityHandler.ts
+var ApplyRowVisibilityHandler = class {
+  constructor(repo, audit, permissionPolicy, dynamic) {
+    this.repo = repo;
+    this.audit = audit;
+    this.permissionPolicy = permissionPolicy;
+    this.dynamic = dynamic;
+    /**
+     * Dedupe guard: آخرین امضای (row + کالکشن + مقادیر ستون‌های resolveOn) که
+     * برایش سر ریموت صدا زده شد. بدون این، دو مسیر مستقل (کلیک سطر →
+     * setActiveRow و کلیک سلول → setActiveCell) و رفرش‌های متوالی، همان API را
+     * چند بار صدا می‌زدند. وقتی مقادیر عوض شود امضای جدید است و API دوباره
+     * صدا زده می‌شود.
+     */
+    this.lastSignature = null;
+  }
+  async execute(command, actor) {
+    const { store, tableKey, rowId } = command;
+    const table = await this.repo.getById(store, tableKey);
+    try {
+      if (!this.dynamic) return [];
+      const row = table.getRow(rowId);
+      if (!row) {
+        throw new DomainError("ROW_NOT_FOUND", `Row ${rowId} not found`, { rowId });
+      }
+      const previousVisibility = { ...row.getVisibilityCondition() ?? {} };
+      const activeCollection = table.getActiveCollectionName() ?? "default";
+      const resolveOnColumns = Array.from(this.dynamic.columnMeta.values()).filter(
+        (colCfg) => colCfg.resolveOn != null
+      ).filter(
+        (colCfg) => (colCfg.fieldCollection ?? "default") === activeCollection
+      );
+      if (resolveOnColumns.length === 0) return [];
+      const signatureParts = resolveOnColumns.map(
+        (colCfg) => String(row.getCell(colCfg.resolveOn.fieldName)?.getValue() ?? "")
+      );
+      const signature = `${store}:${tableKey}:${rowId}:${activeCollection}:${signatureParts.join("|")}`;
+      if (signature === this.lastSignature) {
+        return [];
+      }
+      this.lastSignature = signature;
+      for (const colCfg of resolveOnColumns) {
+        const cell = row.getCell(colCfg.resolveOn.fieldName);
+        if (!cell) continue;
+        const value = cell.getValue();
+        if (value == null || value === "") continue;
+        await this.applyRemoteVisibilityRules({
+          table,
+          rowId: new RowId(rowId),
+          changedColumnId: new ColumnId(colCfg.resolveOn.fieldName),
+          newValue: value,
+          clearDependents: false
+        });
+      }
+      await this.repo.save(store, table);
+      const out = {
+        type: "CELL_CHANGED",
+        tableId: tableKey,
+        rowId,
+        columnId: "visibilityCondition",
+        previousValue: previousVisibility,
+        newValue: row.getVisibilityCondition()
+      };
+      this.audit.log({ type: "INFORMATION", message: "ROW_VISIBILITY_APPLIED", payload: out });
+      return [out];
+    } catch (e) {
+      logError(this.audit, e, `ApplyRowVisibilityHandler[${tableKey}:${rowId}]`);
+      return [];
+    }
+  }
+  /* ── identical to ChangeCellValueHandler helper ───────────────────── */
+  applyRemoteVisibilityRules(input) {
+    return applyRemoteVisibilityRules(this.dynamic, input);
+  }
+};
+
+export { ApplyRowVisibilityHandler };
+//# sourceMappingURL=applyRowVisibilityHandler-KS6TMCBN.js.map
+//# sourceMappingURL=applyRowVisibilityHandler-KS6TMCBN.js.map

package/dist/applyRowVisibilityHandler-KS6TMCBN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../application/handlers/applyRowVisibilityHandler.ts"],"names":[],"mappings":"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","file":"applyRowVisibilityHandler-KS6TMCBN.js","sourcesContent":["// application/handlers/applyRowVisibilityHandler.ts — lazy module (loaded the\r\n// first time a row with `resolveOn` columns becomes active).\r\nimport { ColumnSchema } from '../../bootstrap/type';\r\nimport { DomainError } from '../../domain/errors/DomainError';\r\nimport { Actor, PermissionPolicy } from '../../domain/policies';\r\nimport { ColumnId, RowId } from '../../domain/value-objects';\r\nimport { ApplyRowVisibilityCommand } from '../commands';\r\nimport { TableEvent } from '../events';\r\nimport { AuditLogger } from '../ports/AuditLogger';\r\nimport { TableRepository } from '../ports/TableRepository';\r\nimport {\r\n  applyRemoteVisibilityRules,\r\n  DynamicConfig,\r\n  logError,\r\n} from './cellCommandsHandler';\r\n\r\n/* ======================================================\r\n   ApplyRowVisibilityHandler\r\n   ====================================================== */\r\n\r\n/**\r\n * هنگام فعال‌شدن (active) شدن یک سطر اجرا می‌شود:\r\n * برای هر ستون دارای resolveOn که سلولش مقدار دارد، applyRemoteVisibilityRules\r\n * را (بدون پاک‌کردن سلول‌های وابسته) صدا می‌زند تا visibilityCondition سطر فعال\r\n * از سرویس ریموت به‌روز شود. مقدار RowState سطر را تغییر نمی‌دهد.\r\n */\r\nexport class ApplyRowVisibilityHandler {\r\n  /**\r\n   * Dedupe guard: آخرین امضای (row + کالکشن + مقادیر ستون‌های resolveOn) که\r\n   * برایش سر ریموت صدا زده شد. بدون این، دو مسیر مستقل (کلیک سطر →\r\n   * setActiveRow و کلیک سلول → setActiveCell) و رفرش‌های متوالی، همان API را\r\n   * چند بار صدا می‌زدند. وقتی مقادیر عوض شود امضای جدید است و API دوباره\r\n   * صدا زده می‌شود.\r\n   */\r\n  private lastSignature: string | null = null;\r\n\r\n  constructor(\r\n    private readonly repo: TableRepository,\r\n    private readonly audit: AuditLogger,\r\n    private readonly permissionPolicy: PermissionPolicy,\r\n    private readonly dynamic?: DynamicConfig,\r\n  ) { }\r\n\r\n  async execute(\r\n    command: ApplyRowVisibilityCommand,\r\n    actor: Actor,\r\n  ): Promise<TableEvent[]> {\r\n    const { store, tableKey, rowId } = command;\r\n    const table = await this.repo.getById(store, tableKey);\r\n\r\n    try {\r\n      if (!this.dynamic) return [];\r\n\r\n      const row = table.getRow(rowId);\r\n      if (!row) {\r\n        throw new DomainError('ROW_NOT_FOUND', `Row ${rowId} not found`, { rowId });\r\n      }\r\n\r\n      const previousVisibility = { ...(row.getVisibilityCondition() ?? {}) };\r\n      const activeCollection = table.getActiveCollectionName() ?? 'default';\r\n\r\n      // گارد کالکشن: هر کالکشن فقط resolveOnِ خودش را اجرا کند. بدون این،\r\n      // دوقلوهای RpWayId سایر کالکشن‌ها هم حلقه را طی می‌کردند و API به ازای\r\n      // هر کالکشن (۴ بار) صدا زده می‌شد.\r\n      const resolveOnColumns = Array.from(this.dynamic.columnMeta.values())\r\n        .filter(\r\n          (colCfg): colCfg is ColumnSchema & { resolveOn: NonNullable<ColumnSchema['resolveOn']> } =>\r\n            colCfg.resolveOn != null,\r\n        )\r\n        .filter(\r\n          colCfg => (colCfg.fieldCollection ?? 'default') === activeCollection,\r\n        );\r\n\r\n      if (resolveOnColumns.length === 0) return [];\r\n\r\n      // امضای dedupe: مقادیر فعلی سلول‌های resolveOn این سطر.\r\n      const signatureParts = resolveOnColumns.map(colCfg =>\r\n        String(row.getCell(colCfg.resolveOn.fieldName)?.getValue() ?? ''),\r\n      );\r\n      const signature =\r\n        `${store}:${tableKey}:${rowId}:${activeCollection}:${signatureParts.join('|')}`;\r\n      if (signature === this.lastSignature) {\r\n        // همان سطر با همان مقادیر — فلگ‌ها عوض نشده‌اند؛ API و save لازم نیست.\r\n        return [];\r\n      }\r\n\r\n      // ثبت امضا «قبل» از فراخوانی ریموت: دو مسیر dispatch (کلیک سطر و\r\n      // کلیک سلول) تقریباً همزمان اجرا می‌شوند و اگر امضا بعد از await ثبت\r\n      // می‌شد، هر دو از فیلتر رد می‌شدند و API دوبار صدا زده می‌شد.\r\n      this.lastSignature = signature;\r\n\r\n      for (const colCfg of resolveOnColumns) {\r\n        const cell = row.getCell(colCfg.resolveOn.fieldName);\r\n        if (!cell) continue;\r\n        const value = cell.getValue();\r\n        if (value == null || value === '') continue;\r\n\r\n        await this.applyRemoteVisibilityRules({\r\n          table,\r\n          rowId: new RowId(rowId),\r\n          changedColumnId: new ColumnId(colCfg.resolveOn.fieldName),\r\n          newValue: value,\r\n          clearDependents: false,\r\n        });\r\n      }\r\n\r\n      await this.repo.save(store, table);\r\n\r\n      const out: TableEvent = {\r\n        type: 'CELL_CHANGED',\r\n        tableId: tableKey,\r\n        rowId,\r\n        columnId: 'visibilityCondition',\r\n        previousValue: previousVisibility,\r\n        newValue: row.getVisibilityCondition(),\r\n      };\r\n      this.audit.log({ type: 'INFORMATION', message: 'ROW_VISIBILITY_APPLIED', payload: out });\r\n      return [out];\r\n\r\n    } catch (e) {\r\n      logError(this.audit, e, `ApplyRowVisibilityHandler[${tableKey}:${rowId}]`);\r\n      return [];\r\n    }\r\n  }\r\n\r\n  /* ── identical to ChangeCellValueHandler helper ───────────────────── */\r\n\r\n  private applyRemoteVisibilityRules(input: Parameters<typeof applyRemoteVisibilityRules>[1]): Promise<void> {\r\n    return applyRemoteVisibilityRules(this.dynamic, input);\r\n  }\r\n}"]}

package/dist/applyRowVisibilityHandler-LXCOGESZ.cjs

@@ -0,0 +1,85 @@
+'use strict';
+
+var chunkDXRCYW42_cjs = require('./chunk-DXRCYW42.cjs');
+var chunkKMRURD5J_cjs = require('./chunk-KMRURD5J.cjs');
+var chunkNTV2UUAJ_cjs = require('./chunk-NTV2UUAJ.cjs');
+
+// application/handlers/applyRowVisibilityHandler.ts
+var ApplyRowVisibilityHandler = class {
+  constructor(repo, audit, permissionPolicy, dynamic) {
+    this.repo = repo;
+    this.audit = audit;
+    this.permissionPolicy = permissionPolicy;
+    this.dynamic = dynamic;
+    /**
+     * Dedupe guard: آخرین امضای (row + کالکشن + مقادیر ستون‌های resolveOn) که
+     * برایش سر ریموت صدا زده شد. بدون این، دو مسیر مستقل (کلیک سطر →
+     * setActiveRow و کلیک سلول → setActiveCell) و رفرش‌های متوالی، همان API را
+     * چند بار صدا می‌زدند. وقتی مقادیر عوض شود امضای جدید است و API دوباره
+     * صدا زده می‌شود.
+     */
+    this.lastSignature = null;
+  }
+  async execute(command, actor) {
+    const { store, tableKey, rowId } = command;
+    const table = await this.repo.getById(store, tableKey);
+    try {
+      if (!this.dynamic) return [];
+      const row = table.getRow(rowId);
+      if (!row) {
+        throw new chunkKMRURD5J_cjs.DomainError("ROW_NOT_FOUND", `Row ${rowId} not found`, { rowId });
+      }
+      const previousVisibility = { ...row.getVisibilityCondition() ?? {} };
+      const activeCollection = table.getActiveCollectionName() ?? "default";
+      const resolveOnColumns = Array.from(this.dynamic.columnMeta.values()).filter(
+        (colCfg) => colCfg.resolveOn != null
+      ).filter(
+        (colCfg) => (colCfg.fieldCollection ?? "default") === activeCollection
+      );
+      if (resolveOnColumns.length === 0) return [];
+      const signatureParts = resolveOnColumns.map(
+        (colCfg) => String(row.getCell(colCfg.resolveOn.fieldName)?.getValue() ?? "")
+      );
+      const signature = `${store}:${tableKey}:${rowId}:${activeCollection}:${signatureParts.join("|")}`;
+      if (signature === this.lastSignature) {
+        return [];
+      }
+      this.lastSignature = signature;
+      for (const colCfg of resolveOnColumns) {
+        const cell = row.getCell(colCfg.resolveOn.fieldName);
+        if (!cell) continue;
+        const value = cell.getValue();
+        if (value == null || value === "") continue;
+        await this.applyRemoteVisibilityRules({
+          table,
+          rowId: new chunkNTV2UUAJ_cjs.RowId(rowId),
+          changedColumnId: new chunkNTV2UUAJ_cjs.ColumnId(colCfg.resolveOn.fieldName),
+          newValue: value,
+          clearDependents: false
+        });
+      }
+      await this.repo.save(store, table);
+      const out = {
+        type: "CELL_CHANGED",
+        tableId: tableKey,
+        rowId,
+        columnId: "visibilityCondition",
+        previousValue: previousVisibility,
+        newValue: row.getVisibilityCondition()
+      };
+      this.audit.log({ type: "INFORMATION", message: "ROW_VISIBILITY_APPLIED", payload: out });
+      return [out];
+    } catch (e) {
+      chunkDXRCYW42_cjs.logError(this.audit, e, `ApplyRowVisibilityHandler[${tableKey}:${rowId}]`);
+      return [];
+    }
+  }
+  /* ── identical to ChangeCellValueHandler helper ───────────────────── */
+  applyRemoteVisibilityRules(input) {
+    return chunkDXRCYW42_cjs.applyRemoteVisibilityRules(this.dynamic, input);
+  }
+};
+
+exports.ApplyRowVisibilityHandler = ApplyRowVisibilityHandler;
+//# sourceMappingURL=applyRowVisibilityHandler-LXCOGESZ.cjs.map
+//# sourceMappingURL=applyRowVisibilityHandler-LXCOGESZ.cjs.map

package/dist/applyRowVisibilityHandler-LXCOGESZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../application/handlers/applyRowVisibilityHandler.ts"],"names":["DomainError","RowId","ColumnId","logError","applyRemoteVisibilityRules"],"mappings":"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","file":"applyRowVisibilityHandler-LXCOGESZ.cjs","sourcesContent":["// application/handlers/applyRowVisibilityHandler.ts — lazy module (loaded the\r\n// first time a row with `resolveOn` columns becomes active).\r\nimport { ColumnSchema } from '../../bootstrap/type';\r\nimport { DomainError } from '../../domain/errors/DomainError';\r\nimport { Actor, PermissionPolicy } from '../../domain/policies';\r\nimport { ColumnId, RowId } from '../../domain/value-objects';\r\nimport { ApplyRowVisibilityCommand } from '../commands';\r\nimport { TableEvent } from '../events';\r\nimport { AuditLogger } from '../ports/AuditLogger';\r\nimport { TableRepository } from '../ports/TableRepository';\r\nimport {\r\n  applyRemoteVisibilityRules,\r\n  DynamicConfig,\r\n  logError,\r\n} from './cellCommandsHandler';\r\n\r\n/* ======================================================\r\n   ApplyRowVisibilityHandler\r\n   ====================================================== */\r\n\r\n/**\r\n * هنگام فعال‌شدن (active) شدن یک سطر اجرا می‌شود:\r\n * برای هر ستون دارای resolveOn که سلولش مقدار دارد، applyRemoteVisibilityRules\r\n * را (بدون پاک‌کردن سلول‌های وابسته) صدا می‌زند تا visibilityCondition سطر فعال\r\n * از سرویس ریموت به‌روز شود. مقدار RowState سطر را تغییر نمی‌دهد.\r\n */\r\nexport class ApplyRowVisibilityHandler {\r\n  /**\r\n   * Dedupe guard: آخرین امضای (row + کالکشن + مقادیر ستون‌های resolveOn) که\r\n   * برایش سر ریموت صدا زده شد. بدون این، دو مسیر مستقل (کلیک سطر →\r\n   * setActiveRow و کلیک سلول → setActiveCell) و رفرش‌های متوالی، همان API را\r\n   * چند بار صدا می‌زدند. وقتی مقادیر عوض شود امضای جدید است و API دوباره\r\n   * صدا زده می‌شود.\r\n   */\r\n  private lastSignature: string | null = null;\r\n\r\n  constructor(\r\n    private readonly repo: TableRepository,\r\n    private readonly audit: AuditLogger,\r\n    private readonly permissionPolicy: PermissionPolicy,\r\n    private readonly dynamic?: DynamicConfig,\r\n  ) { }\r\n\r\n  async execute(\r\n    command: ApplyRowVisibilityCommand,\r\n    actor: Actor,\r\n  ): Promise<TableEvent[]> {\r\n    const { store, tableKey, rowId } = command;\r\n    const table = await this.repo.getById(store, tableKey);\r\n\r\n    try {\r\n      if (!this.dynamic) return [];\r\n\r\n      const row = table.getRow(rowId);\r\n      if (!row) {\r\n        throw new DomainError('ROW_NOT_FOUND', `Row ${rowId} not found`, { rowId });\r\n      }\r\n\r\n      const previousVisibility = { ...(row.getVisibilityCondition() ?? {}) };\r\n      const activeCollection = table.getActiveCollectionName() ?? 'default';\r\n\r\n      // گارد کالکشن: هر کالکشن فقط resolveOnِ خودش را اجرا کند. بدون این،\r\n      // دوقلوهای RpWayId سایر کالکشن‌ها هم حلقه را طی می‌کردند و API به ازای\r\n      // هر کالکشن (۴ بار) صدا زده می‌شد.\r\n      const resolveOnColumns = Array.from(this.dynamic.columnMeta.values())\r\n        .filter(\r\n          (colCfg): colCfg is ColumnSchema & { resolveOn: NonNullable<ColumnSchema['resolveOn']> } =>\r\n            colCfg.resolveOn != null,\r\n        )\r\n        .filter(\r\n          colCfg => (colCfg.fieldCollection ?? 'default') === activeCollection,\r\n        );\r\n\r\n      if (resolveOnColumns.length === 0) return [];\r\n\r\n      // امضای dedupe: مقادیر فعلی سلول‌های resolveOn این سطر.\r\n      const signatureParts = resolveOnColumns.map(colCfg =>\r\n        String(row.getCell(colCfg.resolveOn.fieldName)?.getValue() ?? ''),\r\n      );\r\n      const signature =\r\n        `${store}:${tableKey}:${rowId}:${activeCollection}:${signatureParts.join('|')}`;\r\n      if (signature === this.lastSignature) {\r\n        // همان سطر با همان مقادیر — فلگ‌ها عوض نشده‌اند؛ API و save لازم نیست.\r\n        return [];\r\n      }\r\n\r\n      // ثبت امضا «قبل» از فراخوانی ریموت: دو مسیر dispatch (کلیک سطر و\r\n      // کلیک سلول) تقریباً همزمان اجرا می‌شوند و اگر امضا بعد از await ثبت\r\n      // می‌شد، هر دو از فیلتر رد می‌شدند و API دوبار صدا زده می‌شد.\r\n      this.lastSignature = signature;\r\n\r\n      for (const colCfg of resolveOnColumns) {\r\n        const cell = row.getCell(colCfg.resolveOn.fieldName);\r\n        if (!cell) continue;\r\n        const value = cell.getValue();\r\n        if (value == null || value === '') continue;\r\n\r\n        await this.applyRemoteVisibilityRules({\r\n          table,\r\n          rowId: new RowId(rowId),\r\n          changedColumnId: new ColumnId(colCfg.resolveOn.fieldName),\r\n          newValue: value,\r\n          clearDependents: false,\r\n        });\r\n      }\r\n\r\n      await this.repo.save(store, table);\r\n\r\n      const out: TableEvent = {\r\n        type: 'CELL_CHANGED',\r\n        tableId: tableKey,\r\n        rowId,\r\n        columnId: 'visibilityCondition',\r\n        previousValue: previousVisibility,\r\n        newValue: row.getVisibilityCondition(),\r\n      };\r\n      this.audit.log({ type: 'INFORMATION', message: 'ROW_VISIBILITY_APPLIED', payload: out });\r\n      return [out];\r\n\r\n    } catch (e) {\r\n      logError(this.audit, e, `ApplyRowVisibilityHandler[${tableKey}:${rowId}]`);\r\n      return [];\r\n    }\r\n  }\r\n\r\n  /* ── identical to ChangeCellValueHandler helper ───────────────────── */\r\n\r\n  private applyRemoteVisibilityRules(input: Parameters<typeof applyRemoteVisibilityRules>[1]): Promise<void> {\r\n    return applyRemoteVisibilityRules(this.dynamic, input);\r\n  }\r\n}"]}

package/dist/broadcastChannelTransport-FHUMV76O.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkEBV6HGZB_cjs = require('./chunk-EBV6HGZB.cjs');
+
+
+
+Object.defineProperty(exports, "createBroadcastChannelPresenceTransport", {
+  enumerable: true,
+  get: function () { return chunkEBV6HGZB_cjs.createBroadcastChannelPresenceTransport; }
+});
+//# sourceMappingURL=broadcastChannelTransport-FHUMV76O.cjs.map
+//# sourceMappingURL=broadcastChannelTransport-FHUMV76O.cjs.map

package/dist/broadcastChannelTransport-FHUMV76O.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"broadcastChannelTransport-FHUMV76O.cjs"}

package/dist/broadcastChannelTransport-MIH53VNZ.js

@@ -0,0 +1,3 @@
+export { createBroadcastChannelPresenceTransport } from './chunk-PJQWHF6T.js';
+//# sourceMappingURL=broadcastChannelTransport-MIH53VNZ.js.map
+//# sourceMappingURL=broadcastChannelTransport-MIH53VNZ.js.map

package/dist/broadcastChannelTransport-MIH53VNZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"broadcastChannelTransport-MIH53VNZ.js"}

package/dist/callbackRemoteApi-BlXO5NJz.d.ts

@@ -0,0 +1,30 @@
+import { R as RemoteApi } from './RemoteApi-CCQxiSf1.js';
+
+type RemoteApiRequest = {
+    endpoint: string;
+    params?: Record<string, unknown>;
+    method?: 'GET' | 'POST';
+};
+/**
+ * Wraps ANY host transport as a `RemoteApi` port — the grid never learns how
+ * requests are authenticated or where defaults come from.
+ *
+ * arianERP example (RTK Query base query with token refresh + Redux defaults):
+ *
+ *   const remoteApi = new CallbackRemoteApi(async ({ endpoint, params, method }) => {
+ *     const res = await baseQueryByToken(
+ *       { url: endpoint, method: method ?? 'POST', body: params ?? {} },
+ *       { getState: () => store.getState(), dispatch: store.dispatch } as never,
+ *       {},
+ *     );
+ *     return res.data;
+ *   });
+ */
+declare class CallbackRemoteApi implements RemoteApi {
+    private readonly send;
+    private readonly onError?;
+    constructor(send: (request: RemoteApiRequest) => Promise<unknown>, onError?: ((error: unknown) => void) | undefined);
+    request<TResponse = unknown>(input: RemoteApiRequest): Promise<TResponse>;
+}
+
+export { CallbackRemoteApi as C, type RemoteApiRequest as R };

package/dist/callbackRemoteApi-DgnXH-i0.d.cts

@@ -0,0 +1,30 @@
+import { R as RemoteApi } from './RemoteApi-CCQxiSf1.cjs';
+
+type RemoteApiRequest = {
+    endpoint: string;
+    params?: Record<string, unknown>;
+    method?: 'GET' | 'POST';
+};
+/**
+ * Wraps ANY host transport as a `RemoteApi` port — the grid never learns how
+ * requests are authenticated or where defaults come from.
+ *
+ * arianERP example (RTK Query base query with token refresh + Redux defaults):
+ *
+ *   const remoteApi = new CallbackRemoteApi(async ({ endpoint, params, method }) => {
+ *     const res = await baseQueryByToken(
+ *       { url: endpoint, method: method ?? 'POST', body: params ?? {} },
+ *       { getState: () => store.getState(), dispatch: store.dispatch } as never,
+ *       {},
+ *     );
+ *     return res.data;
+ *   });
+ */
+declare class CallbackRemoteApi implements RemoteApi {
+    private readonly send;
+    private readonly onError?;
+    constructor(send: (request: RemoteApiRequest) => Promise<unknown>, onError?: ((error: unknown) => void) | undefined);
+    request<TResponse = unknown>(input: RemoteApiRequest): Promise<TResponse>;
+}
+
+export { CallbackRemoteApi as C, type RemoteApiRequest as R };

package/dist/cellRenderContext-DB7V_mlu.d.ts

@@ -0,0 +1,42 @@
+import { ReactNode } from 'react';
+import { U as UIRow, C as ColumnSchema, V as ValidCell, D as DefaultOptionType } from './GridSession-Bc7UIawO.js';
+import { U as UITableController } from './UITableController-DU8RopUM.js';
+
+/**
+ * Argument passed to `ColumnSchema.render` / `ColumnViewBinding.render`.
+ * Built-in FieldType editors are skipped when `render` is set.
+ */
+interface CellRenderContext {
+    tableKey: string;
+    row: UIRow;
+    columnId: string;
+    meta: ColumnSchema;
+    controller: UITableController;
+    value: unknown;
+    display: unknown;
+    isActive: boolean;
+    isDeleted: boolean;
+    isEditable: boolean;
+    mode: 'view' | 'cell' | 'form';
+    tabIndex: number;
+    validation: ValidCell;
+    dispatchChangeValue: (newValue: unknown, option?: DefaultOptionType) => void;
+    dispatchChangeDisplay: (label: string | null) => void;
+    activeCell: () => void;
+    /** Current grid-search query when this cell is the active hit (PR-71). */
+    searchQuery?: string;
+    isCurrentSearchMatch?: boolean;
+}
+type CustomCellResolveResult = {
+    hit: false;
+} | {
+    hit: true;
+    node: ReactNode;
+};
+/**
+ * PR-54: custom `render` wins over the FieldType switch.
+ * `returnDisplayValue` is not a renderer — it stays the engine display formatter.
+ */
+declare function resolveCustomCellNode(meta: Pick<ColumnSchema, 'render'> | undefined, ctx: CellRenderContext): CustomCellResolveResult;
+
+export { type CellRenderContext as C, type CustomCellResolveResult as a, resolveCustomCellNode as r };

package/dist/cellRenderContext-DG5BOlxK.d.cts

@@ -0,0 +1,42 @@
+import { ReactNode } from 'react';
+import { U as UIRow, C as ColumnSchema, V as ValidCell, D as DefaultOptionType } from './GridSession-B-9lLcoB.cjs';
+import { U as UITableController } from './UITableController-Cuwq481K.cjs';
+
+/**
+ * Argument passed to `ColumnSchema.render` / `ColumnViewBinding.render`.
+ * Built-in FieldType editors are skipped when `render` is set.
+ */
+interface CellRenderContext {
+    tableKey: string;
+    row: UIRow;
+    columnId: string;
+    meta: ColumnSchema;
+    controller: UITableController;
+    value: unknown;
+    display: unknown;
+    isActive: boolean;
+    isDeleted: boolean;
+    isEditable: boolean;
+    mode: 'view' | 'cell' | 'form';
+    tabIndex: number;
+    validation: ValidCell;
+    dispatchChangeValue: (newValue: unknown, option?: DefaultOptionType) => void;
+    dispatchChangeDisplay: (label: string | null) => void;
+    activeCell: () => void;
+    /** Current grid-search query when this cell is the active hit (PR-71). */
+    searchQuery?: string;
+    isCurrentSearchMatch?: boolean;
+}
+type CustomCellResolveResult = {
+    hit: false;
+} | {
+    hit: true;
+    node: ReactNode;
+};
+/**
+ * PR-54: custom `render` wins over the FieldType switch.
+ * `returnDisplayValue` is not a renderer — it stays the engine display formatter.
+ */
+declare function resolveCustomCellNode(meta: Pick<ColumnSchema, 'render'> | undefined, ctx: CellRenderContext): CustomCellResolveResult;
+
+export { type CellRenderContext as C, type CustomCellResolveResult as a, resolveCustomCellNode as r };