@ricsam/formula-engine 0.0.20 → 0.0.22

package/dist/cjs/core/api/api-builder.cjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/api-builder.ts"],
-  "sourcesContent": [
-    "/**\n * API Builder - Constructs the working API from declarations\n *\n * This module is responsible for creating the actual working API\n * from the schema declarations when attached to a FormulaEngine.\n */\n\nimport type { FormulaEngine } from \"../engine.cjs\";\nimport type { Declaration, TableApi, CellApi, Api } from \"./api.cjs\";\nimport { TableOrm } from \"./table-orm.cjs\";\nimport { CellOrm } from \"./cell-orm.cjs\";\nimport type { ApiSchemaManager } from \"../managers/api-schema-manager.cjs\";\n\n/**\n * Build the working API surface from declarations\n *\n * This creates TableOrm and CellOrm instances for each declared schema\n * and binds the custom methods to them.\n */\nexport function buildApiFromDeclaration(\n  engine: FormulaEngine<any, any>,\n  declaration: Declaration,\n  schemaManager: ApiSchemaManager\n): Api {\n  const api: Api = {};\n\n  for (const [namespace, def] of Object.entries(declaration)) {\n    if (def.type === \"table\") {\n      api[namespace] = buildTableApi(engine, namespace, def, schemaManager);\n    } else if (def.type === \"cell\") {\n      api[namespace] = buildCellApi(engine, namespace, def, schemaManager);\n    }\n  }\n\n  return api;\n}\n\n/**\n * Build API methods for a table schema\n */\nfunction buildTableApi(\n  engine: FormulaEngine<any, any>,\n  namespace: string,\n  def: TableApi,\n  schemaManager: ApiSchemaManager\n): Record<string, (...args: any[]) => any> {\n  // Register the schema with the schema manager\n  schemaManager.registerTableSchema(\n    namespace,\n    def.workbookName,\n    def.tableName,\n    def.headers\n  );\n\n  // Create the ORM instance\n  const orm = new TableOrm(\n    engine,\n    def.workbookName,\n    def.tableName,\n    def.headers,\n    namespace\n  );\n\n  // Bind all custom methods to the ORM instance\n  const boundMethods: Record<string, (...args: any[]) => any> = {};\n\n  for (const [methodName, methodFn] of Object.entries(def.methods)) {\n    boundMethods[methodName] = methodFn.bind(orm);\n  }\n\n  return boundMethods;\n}\n\n/**\n * Build API methods for a cell schema\n */\nfunction buildCellApi(\n  engine: FormulaEngine<any, any>,\n  namespace: string,\n  def: CellApi,\n  schemaManager: ApiSchemaManager\n): Record<string, (...args: any[]) => any> {\n  // Register the schema with the schema manager\n  schemaManager.registerCellSchema(namespace, def.cellAddress, def.parse);\n\n  // Create the ORM instance\n  const orm = new CellOrm(engine, def.cellAddress, def.parse, namespace);\n\n  // Bind all custom methods to the ORM instance\n  const boundMethods: Record<string, (...args: any[]) => any> = {};\n\n  for (const [methodName, methodFn] of Object.entries(def.methods)) {\n    boundMethods[methodName] = methodFn.bind(orm);\n  }\n\n  return boundMethods;\n}\n\n"
-  ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASyB,IAAzB;AACwB,IAAxB;AASO,SAAS,uBAAuB,CACrC,QACA,aACA,eACK;AAAA,EACL,MAAM,MAAW,CAAC;AAAA,EAElB,YAAY,WAAW,QAAQ,OAAO,QAAQ,WAAW,GAAG;AAAA,IAC1D,IAAI,IAAI,SAAS,SAAS;AAAA,MACxB,IAAI,aAAa,cAAc,QAAQ,WAAW,KAAK,aAAa;AAAA,IACtE,EAAO,SAAI,IAAI,SAAS,QAAQ;AAAA,MAC9B,IAAI,aAAa,aAAa,QAAQ,WAAW,KAAK,aAAa;AAAA,IACrE;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAMT,SAAS,aAAa,CACpB,QACA,WACA,KACA,eACyC;AAAA,EAEzC,cAAc,oBACZ,WACA,IAAI,cACJ,IAAI,WACJ,IAAI,OACN;AAAA,EAGA,MAAM,MAAM,IAAI,0BACd,QACA,IAAI,cACJ,IAAI,WACJ,IAAI,SACJ,SACF;AAAA,EAGA,MAAM,eAAwD,CAAC;AAAA,EAE/D,YAAY,YAAY,aAAa,OAAO,QAAQ,IAAI,OAAO,GAAG;AAAA,IAChE,aAAa,cAAc,SAAS,KAAK,GAAG;AAAA,EAC9C;AAAA,EAEA,OAAO;AAAA;AAMT,SAAS,YAAY,CACnB,QACA,WACA,KACA,eACyC;AAAA,EAEzC,cAAc,mBAAmB,WAAW,IAAI,aAAa,IAAI,KAAK;AAAA,EAGtE,MAAM,MAAM,IAAI,wBAAQ,QAAQ,IAAI,aAAa,IAAI,OAAO,SAAS;AAAA,EAGrE,MAAM,eAAwD,CAAC;AAAA,EAE/D,YAAY,YAAY,aAAa,OAAO,QAAQ,IAAI,OAAO,GAAG;AAAA,IAChE,aAAa,cAAc,SAAS,KAAK,GAAG;AAAA,EAC9C;AAAA,EAEA,OAAO;AAAA;",
-  "debugId": "1A339C89282699D664756E2164756E21",
-  "names": []
-}

package/dist/cjs/core/api/api-helpers.cjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/api-helpers.ts"],
-  "sourcesContent": [
-    "/**\n * API Helper utilities for row/object conversion and filtering\n */\n\nimport type { CellAddress, SerializedCellValue, TableDefinition } from \"../types.cjs\";\nimport type { FormulaEngine } from \"../engine.cjs\";\n\nexport type ParseFunction<TCellMetadata = unknown> = (\n  value: unknown,\n  metadata: TCellMetadata\n) => unknown;\n\nexport type TableSchemaHeaders<TCellMetadata = unknown> = Record<\n  string,\n  {\n    parse: ParseFunction<TCellMetadata>;\n    index: number;\n  }\n>;\n\n/**\n * Convert a spreadsheet row to a typed object using header parsers\n */\nexport function rowToObject<TItem extends Record<string, unknown>>(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition,\n  rowIndex: number,\n  headers: TableSchemaHeaders,\n  getCellMetadata?: (cell: CellAddress) => unknown\n): TItem {\n  const result: Record<string, unknown> = {};\n\n  for (const [columnName, header] of Object.entries(headers)) {\n    const cellAddress: CellAddress = {\n      workbookName: table.workbookName,\n      sheetName: table.sheetName,\n      colIndex: table.start.colIndex + header.index,\n      rowIndex,\n    };\n\n    const value = engine.getCellValue(cellAddress);\n    const metadata = getCellMetadata ? getCellMetadata(cellAddress) : undefined;\n\n    // Parse the value using the column's parse function\n    result[columnName] = header.parse(value, metadata);\n  }\n\n  return result as TItem;\n}\n\n/**\n * Convert a typed object to cell values based on headers\n */\nexport function objectToRowValues<TItem extends Record<string, unknown>>(\n  obj: TItem,\n  headers: TableSchemaHeaders\n): Map<number, SerializedCellValue> {\n  const values = new Map<number, SerializedCellValue>();\n\n  for (const [columnName, header] of Object.entries(headers)) {\n    if (columnName in obj) {\n      const value = obj[columnName];\n      // Convert to serializable value\n      if (\n        typeof value === \"string\" ||\n        typeof value === \"number\" ||\n        typeof value === \"boolean\"\n      ) {\n        values.set(header.index, value);\n      } else if (value === null || value === undefined) {\n        values.set(header.index, undefined);\n      } else {\n        // For complex types, convert to string\n        values.set(header.index, String(value));\n      }\n    }\n  }\n\n  return values;\n}\n\n/**\n * Check if an object matches a filter predicate\n */\nexport function matchesFilter<TItem extends Record<string, unknown>>(\n  item: TItem,\n  filter: Partial<TItem>\n): boolean {\n  for (const [key, value] of Object.entries(filter)) {\n    if (item[key] !== value) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Get the number of data rows in a table (excluding header)\n */\nexport function getTableRowCount(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition\n): number {\n  if (table.endRow.type === \"infinity\") {\n    // For infinite tables, count non-empty rows\n    // Start from data row (after header)\n    let count = 0;\n    let emptyRowStreak = 0;\n    const maxEmptyRows = 10; // Stop after 10 consecutive empty rows\n\n    for (let row = table.start.rowIndex + 1; emptyRowStreak < maxEmptyRows; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      if (hasContent) {\n        count++;\n        emptyRowStreak = 0;\n      } else {\n        emptyRowStreak++;\n      }\n    }\n\n    return count;\n  } else {\n    // For finite tables, calculate from endRow\n    return table.endRow.value - table.start.rowIndex;\n  }\n}\n\n/**\n * Get the next empty row index for appending data\n */\nexport function getNextEmptyRow(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition\n): number {\n  const dataStartRow = table.start.rowIndex + 1;\n\n  if (table.endRow.type === \"infinity\") {\n    // Find first empty row\n    let emptyRowStreak = 0;\n    const maxEmptyRows = 10;\n\n    for (let row = dataStartRow; ; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      if (!hasContent) {\n        return row;\n      }\n\n      emptyRowStreak = hasContent ? 0 : emptyRowStreak + 1;\n      if (emptyRowStreak >= maxEmptyRows) {\n        return row - maxEmptyRows + 1;\n      }\n    }\n  } else {\n    // For finite tables, return the row after the last data row\n    return table.endRow.value + 1;\n  }\n}\n\n/**\n * Iterate over all data rows in a table\n */\nexport function* iterateTableRows(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition\n): Generator<{ rowIndex: number; isEmpty: boolean }> {\n  const dataStartRow = table.start.rowIndex + 1;\n\n  if (table.endRow.type === \"infinity\") {\n    let emptyRowStreak = 0;\n    const maxEmptyRows = 10;\n\n    for (let row = dataStartRow; emptyRowStreak < maxEmptyRows; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      if (hasContent) {\n        emptyRowStreak = 0;\n        yield { rowIndex: row, isEmpty: false };\n      } else {\n        emptyRowStreak++;\n        // Don't yield empty rows at the end\n      }\n    }\n  } else {\n    for (let row = dataStartRow; row <= table.endRow.value; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      yield { rowIndex: row, isEmpty: !hasContent };\n    }\n  }\n}\n\n"
-  ],
-  "mappings": "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",
-  "debugId": "3AEF0EFABA7782E064756E2164756E21",
-  "names": []
-}

package/dist/cjs/core/api/api.cjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/api.ts"],
-  "sourcesContent": [
-    "import type { CellAddress } from \"../types.cjs\";\nimport type { CellOrm } from \"./cell-orm.cjs\";\nimport type { TableOrm } from \"./table-orm.cjs\";\n\n/**\n * Define an API schema for the FormulaEngine.\n *\n * The returned object contains:\n * - `declaration`: The schema definitions for tables and cells\n * - `api`: A type-only placeholder (undefined at runtime) for TypeScript inference\n *\n * The actual working API is only available through `engine.api` after\n * attaching the definition to a FormulaEngine instance.\n *\n * @example\n * ```typescript\n * const myApi = defineApi<CellMetadata>()\n *   .addTableApi(\"users\", { workbookName: \"wb1\", tableName: \"users\" }, headers, methods)\n *   .addCellApi(\"config\", cellAddress, parse, methods);\n *\n * const engine = new FormulaEngine(myApi);\n * engine.api.users.get(1); // Works!\n * myApi.api.users.get(1);  // Error: api is undefined at runtime\n * ```\n */\nexport function defineApi<\n  TCellMetadata = unknown,\n  TCurrentApi extends Record<\n    string,\n    Record<string, (...args: any[]) => any>\n  > = Record<string, Record<string, (...args: any[]) => any>>,\n  TCurrentDeclaration extends Record<string, TableApi | CellApi> = Record<\n    string,\n    TableApi | CellApi\n  >\n>(): CreateApi<TCellMetadata, TCurrentApi, TCurrentDeclaration> {\n  const declaration: Record<string, TableApi | CellApi> = {};\n\n  const builder: CreateApi<TCellMetadata, TCurrentApi, TCurrentDeclaration> = {\n    addTableApi(namespace, address, headers, methods) {\n      declaration[namespace] = {\n        type: \"table\",\n        tableName: address.tableName,\n        workbookName: address.workbookName,\n        headers: headers as any,\n        methods: methods as any,\n      };\n      return builder as any;\n    },\n\n    addCellApi(namespace, cellAddress, parse, methods) {\n      declaration[namespace] = {\n        type: \"cell\",\n        cellAddress,\n        parse: parse as any,\n        methods: methods as any,\n      };\n      return builder as any;\n    },\n\n    // api is undefined at runtime - it only exists for TypeScript type inference\n    // The actual working API is built by the FormulaEngine constructor\n    api: undefined as any as TCurrentApi,\n\n    declaration: declaration as TCurrentDeclaration,\n  };\n\n  return builder;\n}\n\n// Keep createApi as an alias for backwards compatibility\nexport const createApi = defineApi;\n\ntype ParseFunction<TCellMetadata> = (\n  value: unknown,\n  metadata: TCellMetadata\n) => unknown;\n\nexport interface TableApi {\n  type: \"table\";\n  headers: Headers<unknown>;\n  tableName: string;\n  workbookName: string;\n  methods: TableMethods<Record<string, unknown>>;\n}\n\nexport interface CellApi {\n  type: \"cell\";\n  cellAddress: CellAddress;\n  parse: (value: unknown, metadata: unknown) => unknown;\n  methods: CellMethods<unknown>;\n}\n\ntype Headers<TCellMetadata> = Record<\n  string,\n  {\n    parse: ParseFunction<TCellMetadata>;\n    index: number;\n  }\n>;\n\ntype TableMethods<TItem extends Record<string, unknown>> = Record<\n  string,\n  (this: TableOrm<TItem>, ...args: any[]) => any\n>;\n\ntype CellMethods<TValue> = Record<\n  string,\n  (this: CellOrm<TValue>, ...args: any[]) => any\n>;\n\nexport type Declaration = Record<string, TableApi | CellApi>;\nexport type Api = Record<string, Record<string, (...args: any[]) => any>>;\n\nexport type CreateApi<\n  TCellMetadata,\n  TCurrentApi extends Api,\n  TCurrentDeclaration extends Declaration\n> = {\n  addTableApi<\n    T extends string,\n    THeaders extends Headers<TCellMetadata>,\n    TMethods extends TableMethods<{\n      [K in keyof THeaders]: ReturnType<THeaders[K][\"parse\"]>;\n    }>\n  >(\n    namespace: T,\n    address: { workbookName: string; tableName: string },\n    headers: THeaders,\n    methods: TMethods\n  ): CreateApi<\n    TCellMetadata,\n    TCurrentApi & {\n      [K in T]: {\n        [M in keyof TMethods]: (\n          ...args: Parameters<TMethods[M]>\n        ) => ReturnType<TMethods[M]>;\n      };\n    },\n    TCurrentDeclaration & {\n      [K in T]: {\n        type: \"table\";\n        tableName: string;\n        workbookName: string;\n        headers: THeaders;\n        methods: TMethods;\n      };\n    }\n  >;\n  addCellApi<T extends string, TValue, TMethods extends CellMethods<TValue>>(\n    namespace: T,\n    cellAddress: CellAddress,\n    parse: (value: unknown, metadata: TCellMetadata) => TValue,\n    methods: TMethods\n  ): CreateApi<\n    TCellMetadata,\n    TCurrentApi & {\n      [K in T]: {\n        [M in keyof TMethods]: (\n          ...args: Parameters<TMethods[M]>\n        ) => ReturnType<TMethods[M]>;\n      };\n    },\n    TCurrentDeclaration & {\n      [K in T]: {\n        type: \"cell\";\n        cellAddress: CellAddress;\n        parse: (value: unknown, metadata: unknown) => unknown;\n        methods: TMethods;\n      };\n    }\n  >;\n  api: TCurrentApi;\n  declaration: TCurrentDeclaration;\n};\n"
-  ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBO,SAAS,SAUf,GAA+D;AAAA,EAC9D,MAAM,cAAkD,CAAC;AAAA,EAEzD,MAAM,UAAsE;AAAA,IAC1E,WAAW,CAAC,WAAW,SAAS,SAAS,SAAS;AAAA,MAChD,YAAY,aAAa;AAAA,QACvB,MAAM;AAAA,QACN,WAAW,QAAQ;AAAA,QACnB,cAAc,QAAQ;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAAA,MACA,OAAO;AAAA;AAAA,IAGT,UAAU,CAAC,WAAW,aAAa,OAAO,SAAS;AAAA,MACjD,YAAY,aAAa;AAAA,QACvB,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,OAAO;AAAA;AAAA,IAKT,KAAK;AAAA,IAEL;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAIF,IAAM,YAAY;",
-  "debugId": "00202A4557ACD94664756E2164756E21",
-  "names": []
-}

package/dist/cjs/core/api/table-orm.cjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/table-orm.ts"],
-  "sourcesContent": [
-    "/**\n * TableOrm - Object-Relational Mapping for table data\n *\n * Provides CRUD operations for table data with type-safe access.\n * Used as the `this` context for custom table API methods.\n */\n\nimport type { CellAddress, SerializedCellValue, TableDefinition } from \"../types.cjs\";\nimport type { FormulaEngine } from \"../engine.cjs\";\nimport {\n  rowToObject,\n  objectToRowValues,\n  matchesFilter,\n  getTableRowCount,\n  getNextEmptyRow,\n  iterateTableRows,\n  type TableSchemaHeaders,\n} from \"./api-helpers.cjs\";\n\nexport class TableOrm<TItem extends Record<string, unknown>> {\n  constructor(\n    private engine: FormulaEngine<any, any>,\n    private workbookName: string,\n    private tableName: string,\n    private headers: TableSchemaHeaders,\n    private namespace: string\n  ) {}\n\n  /**\n   * Get the table definition from the engine\n   */\n  private getTable(): TableDefinition {\n    const table = this.engine._tableManager.getTable({\n      workbookName: this.workbookName,\n      name: this.tableName,\n    });\n\n    if (!table) {\n      throw new Error(\n        `Table \"${this.tableName}\" not found in workbook \"${this.workbookName}\"`\n      );\n    }\n\n    return table;\n  }\n\n  /**\n   * Find the first row matching the filter\n   */\n  findWhere(filter: Partial<TItem>): TItem | undefined {\n    const table = this.getTable();\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          return item;\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Find all rows matching the filter\n   */\n  findAllWhere(filter: Partial<TItem>): TItem[] {\n    const table = this.getTable();\n    const results: TItem[] = [];\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          results.push(item);\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Append a new row to the table\n   */\n  append(item: TItem): TItem {\n    const table = this.getTable();\n    const nextRow = getNextEmptyRow(this.engine, table);\n    const values = objectToRowValues(item, this.headers);\n\n    // Write each cell value\n    for (const [colOffset, value] of values) {\n      const cellAddress: CellAddress = {\n        workbookName: table.workbookName,\n        sheetName: table.sheetName,\n        colIndex: table.start.colIndex + colOffset,\n        rowIndex: nextRow,\n      };\n\n      this.engine.setCellContent(cellAddress, value);\n    }\n\n    return item;\n  }\n\n  /**\n   * Update all rows matching the filter\n   * Returns the number of rows updated\n   */\n  updateWhere(filter: Partial<TItem>, update: Partial<TItem>): number {\n    const table = this.getTable();\n    let updatedCount = 0;\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          // Apply updates\n          const values = objectToRowValues(update as TItem, this.headers);\n\n          for (const [colOffset, value] of values) {\n            const cellAddress: CellAddress = {\n              workbookName: table.workbookName,\n              sheetName: table.sheetName,\n              colIndex: table.start.colIndex + colOffset,\n              rowIndex,\n            };\n\n            this.engine.setCellContent(cellAddress, value);\n          }\n\n          updatedCount++;\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return updatedCount;\n  }\n\n  /**\n   * Remove all rows matching the filter\n   * Returns the number of rows removed\n   */\n  removeWhere(filter: Partial<TItem>): number {\n    const table = this.getTable();\n    let removedCount = 0;\n\n    // Collect rows to remove (in reverse order to avoid index shifting issues)\n    const rowsToRemove: number[] = [];\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          rowsToRemove.push(rowIndex);\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    // Remove rows in reverse order\n    for (const rowIndex of rowsToRemove.reverse()) {\n      // Clear all cells in the row\n      for (const header of Object.values(this.headers)) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + header.index,\n          rowIndex,\n        };\n\n        this.engine.setCellContent(cellAddress, undefined);\n      }\n\n      removedCount++;\n    }\n\n    return removedCount;\n  }\n\n  /**\n   * Get the count of data rows in the table\n   */\n  count(): number {\n    const table = this.getTable();\n    return getTableRowCount(this.engine, table);\n  }\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "EAD2C30DE3B432C664756E2164756E21",
-  "names": []
-}

package/dist/cjs/core/managers/api-schema-manager.cjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/managers/api-schema-manager.ts"],
-  "sourcesContent": [
-    "/**\n * ApiSchemaManager - Manages API schema definitions and validation\n *\n * Tracks registered schemas and provides validation for cell writes,\n * spill operations, and copy/paste operations.\n */\n\nimport type {\n  CellAddress,\n  SerializedCellValue,\n  SpreadsheetRange,\n  TableDefinition,\n} from \"../types.cjs\";\nimport { cellAddressToKey, isCellInRange } from \"../utils.cjs\";\nimport type { TableManager } from \"./table-manager.cjs\";\n\nexport type ParseFunction<TCellMetadata = unknown> = (\n  value: unknown,\n  metadata: TCellMetadata\n) => unknown;\n\nexport type TableSchemaHeaders<TCellMetadata = unknown> = Record<\n  string,\n  {\n    parse: ParseFunction<TCellMetadata>;\n    index: number;\n  }\n>;\n\nexport interface RegisteredTableSchema {\n  type: \"table\";\n  namespace: string;\n  workbookName: string;\n  tableName: string;\n  headers: TableSchemaHeaders;\n}\n\nexport interface RegisteredCellSchema {\n  type: \"cell\";\n  namespace: string;\n  cellAddress: CellAddress;\n  parse: ParseFunction;\n}\n\nexport type RegisteredSchema = RegisteredTableSchema | RegisteredCellSchema;\n\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n  originalError?: Error;\n}\n\nexport class SchemaValidationError extends Error {\n  constructor(\n    message: string,\n    public cellAddress?: CellAddress,\n    public originalError?: Error\n  ) {\n    super(message);\n    this.name = \"SchemaValidationError\";\n  }\n}\n\nexport class ApiSchemaManager {\n  private schemas: Map<string, RegisteredSchema> = new Map();\n\n  constructor(private tableManager: TableManager) {}\n\n  /**\n   * Register a table schema\n   */\n  registerTableSchema(\n    namespace: string,\n    workbookName: string,\n    tableName: string,\n    headers: TableSchemaHeaders\n  ): void {\n    this.schemas.set(namespace, {\n      type: \"table\",\n      namespace,\n      workbookName,\n      tableName,\n      headers,\n    });\n  }\n\n  /**\n   * Register a cell schema\n   */\n  registerCellSchema(\n    namespace: string,\n    cellAddress: CellAddress,\n    parse: ParseFunction\n  ): void {\n    this.schemas.set(namespace, {\n      type: \"cell\",\n      namespace,\n      cellAddress,\n      parse,\n    });\n  }\n\n  /**\n   * Get a schema by namespace\n   */\n  getSchema(namespace: string): RegisteredSchema | undefined {\n    return this.schemas.get(namespace);\n  }\n\n  /**\n   * Remove a schema\n   */\n  removeSchema(namespace: string): boolean {\n    return this.schemas.delete(namespace);\n  }\n\n  /**\n   * Check if a cell is protected by a schema\n   * Returns the schema info if protected, null otherwise\n   */\n  isCellProtected(\n    cell: CellAddress\n  ): { schema: RegisteredSchema; columnName?: string } | null {\n    for (const schema of this.schemas.values()) {\n      if (schema.type === \"cell\") {\n        if (\n          schema.cellAddress.workbookName === cell.workbookName &&\n          schema.cellAddress.sheetName === cell.sheetName &&\n          schema.cellAddress.colIndex === cell.colIndex &&\n          schema.cellAddress.rowIndex === cell.rowIndex\n        ) {\n          return { schema };\n        }\n      } else if (schema.type === \"table\") {\n        const table = this.tableManager.getTable({\n          workbookName: schema.workbookName,\n          name: schema.tableName,\n        });\n\n        if (!table) continue;\n\n        // Check if cell is in table's data range (excluding header row)\n        if (\n          cell.workbookName === table.workbookName &&\n          cell.sheetName === table.sheetName\n        ) {\n          const isInDataRange = this.isCellInTableDataRange(cell, table);\n          if (isInDataRange) {\n            // Find which column this cell is in\n            const colOffset = cell.colIndex - table.start.colIndex;\n            const columnName = this.getColumnNameByIndex(\n              schema.headers,\n              colOffset\n            );\n            return { schema, columnName };\n          }\n        }\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Check if a cell is within a table's data range (excluding header row)\n   */\n  private isCellInTableDataRange(\n    cell: CellAddress,\n    table: TableDefinition\n  ): boolean {\n    const { start, endRow, headers } = table;\n\n    // Data starts one row below header\n    const dataStartRow = start.rowIndex + 1;\n\n    // Check row bounds (data rows only, not header)\n    const isInRowRange =\n      endRow.type === \"infinity\"\n        ? cell.rowIndex >= dataStartRow\n        : cell.rowIndex >= dataStartRow && cell.rowIndex <= endRow.value;\n\n    // Check column bounds\n    const endColIndex = start.colIndex + headers.size - 1;\n    const isInColRange =\n      cell.colIndex >= start.colIndex && cell.colIndex <= endColIndex;\n\n    return isInRowRange && isInColRange;\n  }\n\n  /**\n   * Get column name by index from headers\n   */\n  private getColumnNameByIndex(\n    headers: TableSchemaHeaders,\n    index: number\n  ): string | undefined {\n    for (const [name, header] of Object.entries(headers)) {\n      if (header.index === index) {\n        return name;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Validate a cell write against schemas\n   */\n  validateCellWrite(\n    cell: CellAddress,\n    value: SerializedCellValue,\n    metadata?: unknown\n  ): ValidationResult {\n    // Allow clearing cells (undefined or empty string)\n    if (value === undefined || value === \"\") {\n      return { valid: true };\n    }\n\n    const protection = this.isCellProtected(cell);\n\n    if (!protection) {\n      return { valid: true };\n    }\n\n    const { schema, columnName } = protection;\n\n    try {\n      if (schema.type === \"cell\") {\n        schema.parse(value, metadata);\n      } else if (schema.type === \"table\" && columnName) {\n        const header = schema.headers[columnName];\n        if (header) {\n          header.parse(value, metadata);\n        }\n      }\n      return { valid: true };\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      return {\n        valid: false,\n        error: `Schema validation failed for ${schema.namespace}${\n          columnName ? `.${columnName}` : \"\"\n        }: ${error.message}`,\n        originalError: error,\n      };\n    }\n  }\n\n  /**\n   * Validate a spill area against schemas\n   * Returns validation result - if invalid, spill should produce #SPILL! error\n   */\n  validateSpillArea(\n    origin: CellAddress,\n    spillArea: SpreadsheetRange,\n    getSpillValue: (row: number, col: number) => SerializedCellValue,\n    getMetadata?: (cell: CellAddress) => unknown\n  ): ValidationResult {\n    // Get the bounds of the spill area\n    const startRow = spillArea.start.row;\n    const startCol = spillArea.start.col;\n    const endRow =\n      spillArea.end.row.type === \"number\"\n        ? spillArea.end.row.value\n        : startRow + 100; // Limit for infinite ranges\n    const endCol =\n      spillArea.end.col.type === \"number\"\n        ? spillArea.end.col.value\n        : startCol + 100; // Limit for infinite ranges\n\n    for (let row = startRow; row <= endRow; row++) {\n      for (let col = startCol; col <= endCol; col++) {\n        const cell: CellAddress = {\n          workbookName: origin.workbookName,\n          sheetName: origin.sheetName,\n          rowIndex: row,\n          colIndex: col,\n        };\n\n        const protection = this.isCellProtected(cell);\n        if (protection) {\n          const value = getSpillValue(row - startRow, col - startCol);\n          const metadata = getMetadata ? getMetadata(cell) : undefined;\n          const validation = this.validateCellWrite(cell, value, metadata);\n\n          if (!validation.valid) {\n            return {\n              valid: false,\n              error: `Spill blocked by schema at ${cellAddressToKey(cell)}: ${\n                validation.error\n              }`,\n              originalError: validation.originalError,\n            };\n          }\n        }\n      }\n    }\n\n    return { valid: true };\n  }\n\n  /**\n   * Update schemas when a table is renamed\n   */\n  updateForTableRename(\n    workbookName: string,\n    oldTableName: string,\n    newTableName: string\n  ): void {\n    for (const schema of this.schemas.values()) {\n      if (\n        schema.type === \"table\" &&\n        schema.workbookName === workbookName &&\n        schema.tableName === oldTableName\n      ) {\n        schema.tableName = newTableName;\n      }\n    }\n  }\n\n  /**\n   * Update schemas when a sheet is renamed\n   */\n  updateForSheetRename(\n    workbookName: string,\n    oldSheetName: string,\n    newSheetName: string\n  ): void {\n    for (const schema of this.schemas.values()) {\n      if (schema.type === \"cell\") {\n        if (\n          schema.cellAddress.workbookName === workbookName &&\n          schema.cellAddress.sheetName === oldSheetName\n        ) {\n          schema.cellAddress.sheetName = newSheetName;\n        }\n      }\n      // Table schemas don't store sheetName directly - they get it from TableManager\n    }\n  }\n\n  /**\n   * Update schemas when a workbook is renamed\n   */\n  updateForWorkbookRename(\n    oldWorkbookName: string,\n    newWorkbookName: string\n  ): void {\n    for (const schema of this.schemas.values()) {\n      if (schema.type === \"cell\") {\n        if (schema.cellAddress.workbookName === oldWorkbookName) {\n          schema.cellAddress.workbookName = newWorkbookName;\n        }\n      } else if (schema.type === \"table\") {\n        if (schema.workbookName === oldWorkbookName) {\n          schema.workbookName = newWorkbookName;\n        }\n      }\n    }\n  }\n\n  /**\n   * Get all schemas (for debugging/testing)\n   */\n  getAllSchemas(): Map<string, RegisteredSchema> {\n    return new Map(this.schemas);\n  }\n\n  /**\n   * Validate all schema constraints using evaluated cell values.\n   *\n   * This is the key method for schema validation with rollback:\n   * - It validates EVALUATED values, not raw content\n   * - A cell with \"=123+123\" validates as number (246), not string\n   * - Called after re-evaluation to check all schema-constrained cells\n   *\n   * @param getCellValue - Function to get the evaluated value of a cell\n   * @param getCellMetadata - Optional function to get cell metadata\n   * @returns Validation result with all errors found\n   */\n  validateAllSchemaConstraints(\n    getCellValue: (cell: CellAddress) => SerializedCellValue,\n    getCellMetadata?: (cell: CellAddress) => unknown,\n    getTableDataCells?: (table: TableDefinition) => CellAddress[]\n  ): {\n    valid: boolean;\n    errors: Array<{\n      message: string;\n      cellAddress?: CellAddress;\n      schemaNamespace?: string;\n      columnName?: string;\n      originalError?: Error;\n    }>;\n  } {\n    const errors: Array<{\n      message: string;\n      cellAddress?: CellAddress;\n      schemaNamespace?: string;\n      columnName?: string;\n      originalError?: Error;\n    }> = [];\n\n    for (const [namespace, schema] of this.schemas) {\n      if (schema.type === \"cell\") {\n        // Validate single cell using evaluated value\n        let value: SerializedCellValue;\n        try {\n          value = getCellValue(schema.cellAddress);\n        } catch {\n          // Sheet/cell doesn't exist yet, skip validation\n          continue;\n        }\n\n        const metadata = getCellMetadata\n          ? getCellMetadata(schema.cellAddress)\n          : undefined;\n\n        // Skip empty cells\n        if (value === undefined || value === \"\") {\n          continue;\n        }\n\n        try {\n          schema.parse(value, metadata);\n        } catch (err) {\n          const error = err instanceof Error ? err : new Error(String(err));\n          errors.push({\n            message: `Schema validation failed for ${namespace}: ${error.message}`,\n            cellAddress: schema.cellAddress,\n            schemaNamespace: namespace,\n            originalError: error,\n          });\n        }\n      } else if (schema.type === \"table\") {\n        // Get the table definition\n        const table = this.tableManager.getTable({\n          workbookName: schema.workbookName,\n          name: schema.tableName,\n        });\n\n        if (!table) continue;\n\n        const { start, headers } = table;\n\n        // Get cells to validate - use callback if provided (handles infinite ranges efficiently)\n        // Otherwise fall back to simple iteration for finite tables\n        let cellsToValidate: CellAddress[];\n        if (getTableDataCells) {\n          cellsToValidate = getTableDataCells(table);\n        } else {\n          // Fallback for finite tables when no callback provided\n          const { endRow } = table;\n          if (endRow.type === \"infinity\") {\n            // Skip validation for infinite tables without a cell iterator\n            continue;\n          }\n          cellsToValidate = [];\n          const dataStartRow = start.rowIndex + 1;\n          const endColIndex = start.colIndex + headers.size - 1;\n          for (let row = dataStartRow; row <= endRow.value; row++) {\n            for (let col = start.colIndex; col <= endColIndex; col++) {\n              cellsToValidate.push({\n                workbookName: table.workbookName,\n                sheetName: table.sheetName,\n                rowIndex: row,\n                colIndex: col,\n              });\n            }\n          }\n        }\n\n        for (const cell of cellsToValidate) {\n          // Skip header row\n          if (cell.rowIndex <= start.rowIndex) continue;\n\n          let value: SerializedCellValue;\n          try {\n            value = getCellValue(cell);\n          } catch {\n            // Sheet/cell doesn't exist yet, skip validation\n            continue;\n          }\n\n          // Skip empty cells\n          if (value === undefined || value === \"\") {\n            continue;\n          }\n\n          // Find the column name\n          const colOffset = cell.colIndex - start.colIndex;\n          const columnName = this.getColumnNameByIndex(\n            schema.headers,\n            colOffset\n          );\n\n          if (columnName && schema.headers[columnName]) {\n            const header = schema.headers[columnName];\n            const metadata = getCellMetadata\n              ? getCellMetadata(cell)\n              : undefined;\n\n            try {\n              header.parse(value, metadata);\n            } catch (err) {\n              const error =\n                err instanceof Error ? err : new Error(String(err));\n              errors.push({\n                message: `Schema validation failed for ${namespace}.${columnName}: ${error.message}`,\n                cellAddress: cell,\n                schemaNamespace: namespace,\n                columnName,\n                originalError: error,\n              });\n            }\n          }\n        }\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  }\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "0A401D0913B21D2A64756E2164756E21",
-  "names": []
-}

package/dist/mjs/core/api/api-builder.mjs

@@ -1,37 +0,0 @@
-// src/core/api/api-builder.ts
-import { TableOrm } from "./table-orm.mjs";
-import { CellOrm } from "./cell-orm.mjs";
-function buildApiFromDeclaration(engine, declaration, schemaManager) {
-  const api = {};
-  for (const [namespace, def] of Object.entries(declaration)) {
-    if (def.type === "table") {
-      api[namespace] = buildTableApi(engine, namespace, def, schemaManager);
-    } else if (def.type === "cell") {
-      api[namespace] = buildCellApi(engine, namespace, def, schemaManager);
-    }
-  }
-  return api;
-}
-function buildTableApi(engine, namespace, def, schemaManager) {
-  schemaManager.registerTableSchema(namespace, def.workbookName, def.tableName, def.headers);
-  const orm = new TableOrm(engine, def.workbookName, def.tableName, def.headers, namespace);
-  const boundMethods = {};
-  for (const [methodName, methodFn] of Object.entries(def.methods)) {
-    boundMethods[methodName] = methodFn.bind(orm);
-  }
-  return boundMethods;
-}
-function buildCellApi(engine, namespace, def, schemaManager) {
-  schemaManager.registerCellSchema(namespace, def.cellAddress, def.parse);
-  const orm = new CellOrm(engine, def.cellAddress, def.parse, namespace);
-  const boundMethods = {};
-  for (const [methodName, methodFn] of Object.entries(def.methods)) {
-    boundMethods[methodName] = methodFn.bind(orm);
-  }
-  return boundMethods;
-}
-export {
-  buildApiFromDeclaration
-};
-
-//# debugId=D8642EAD6BFC352164756E2164756E21

package/dist/mjs/core/api/api-builder.mjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/api-builder.ts"],
-  "sourcesContent": [
-    "/**\n * API Builder - Constructs the working API from declarations\n *\n * This module is responsible for creating the actual working API\n * from the schema declarations when attached to a FormulaEngine.\n */\n\nimport type { FormulaEngine } from \"../engine.mjs\";\nimport type { Declaration, TableApi, CellApi, Api } from \"./api.mjs\";\nimport { TableOrm } from \"./table-orm.mjs\";\nimport { CellOrm } from \"./cell-orm.mjs\";\nimport type { ApiSchemaManager } from \"../managers/api-schema-manager.mjs\";\n\n/**\n * Build the working API surface from declarations\n *\n * This creates TableOrm and CellOrm instances for each declared schema\n * and binds the custom methods to them.\n */\nexport function buildApiFromDeclaration(\n  engine: FormulaEngine<any, any>,\n  declaration: Declaration,\n  schemaManager: ApiSchemaManager\n): Api {\n  const api: Api = {};\n\n  for (const [namespace, def] of Object.entries(declaration)) {\n    if (def.type === \"table\") {\n      api[namespace] = buildTableApi(engine, namespace, def, schemaManager);\n    } else if (def.type === \"cell\") {\n      api[namespace] = buildCellApi(engine, namespace, def, schemaManager);\n    }\n  }\n\n  return api;\n}\n\n/**\n * Build API methods for a table schema\n */\nfunction buildTableApi(\n  engine: FormulaEngine<any, any>,\n  namespace: string,\n  def: TableApi,\n  schemaManager: ApiSchemaManager\n): Record<string, (...args: any[]) => any> {\n  // Register the schema with the schema manager\n  schemaManager.registerTableSchema(\n    namespace,\n    def.workbookName,\n    def.tableName,\n    def.headers\n  );\n\n  // Create the ORM instance\n  const orm = new TableOrm(\n    engine,\n    def.workbookName,\n    def.tableName,\n    def.headers,\n    namespace\n  );\n\n  // Bind all custom methods to the ORM instance\n  const boundMethods: Record<string, (...args: any[]) => any> = {};\n\n  for (const [methodName, methodFn] of Object.entries(def.methods)) {\n    boundMethods[methodName] = methodFn.bind(orm);\n  }\n\n  return boundMethods;\n}\n\n/**\n * Build API methods for a cell schema\n */\nfunction buildCellApi(\n  engine: FormulaEngine<any, any>,\n  namespace: string,\n  def: CellApi,\n  schemaManager: ApiSchemaManager\n): Record<string, (...args: any[]) => any> {\n  // Register the schema with the schema manager\n  schemaManager.registerCellSchema(namespace, def.cellAddress, def.parse);\n\n  // Create the ORM instance\n  const orm = new CellOrm(engine, def.cellAddress, def.parse, namespace);\n\n  // Bind all custom methods to the ORM instance\n  const boundMethods: Record<string, (...args: any[]) => any> = {};\n\n  for (const [methodName, methodFn] of Object.entries(def.methods)) {\n    boundMethods[methodName] = methodFn.bind(orm);\n  }\n\n  return boundMethods;\n}\n\n"
-  ],
-  "mappings": ";AASA;AACA;AASO,SAAS,uBAAuB,CACrC,QACA,aACA,eACK;AAAA,EACL,MAAM,MAAW,CAAC;AAAA,EAElB,YAAY,WAAW,QAAQ,OAAO,QAAQ,WAAW,GAAG;AAAA,IAC1D,IAAI,IAAI,SAAS,SAAS;AAAA,MACxB,IAAI,aAAa,cAAc,QAAQ,WAAW,KAAK,aAAa;AAAA,IACtE,EAAO,SAAI,IAAI,SAAS,QAAQ;AAAA,MAC9B,IAAI,aAAa,aAAa,QAAQ,WAAW,KAAK,aAAa;AAAA,IACrE;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAMT,SAAS,aAAa,CACpB,QACA,WACA,KACA,eACyC;AAAA,EAEzC,cAAc,oBACZ,WACA,IAAI,cACJ,IAAI,WACJ,IAAI,OACN;AAAA,EAGA,MAAM,MAAM,IAAI,SACd,QACA,IAAI,cACJ,IAAI,WACJ,IAAI,SACJ,SACF;AAAA,EAGA,MAAM,eAAwD,CAAC;AAAA,EAE/D,YAAY,YAAY,aAAa,OAAO,QAAQ,IAAI,OAAO,GAAG;AAAA,IAChE,aAAa,cAAc,SAAS,KAAK,GAAG;AAAA,EAC9C;AAAA,EAEA,OAAO;AAAA;AAMT,SAAS,YAAY,CACnB,QACA,WACA,KACA,eACyC;AAAA,EAEzC,cAAc,mBAAmB,WAAW,IAAI,aAAa,IAAI,KAAK;AAAA,EAGtE,MAAM,MAAM,IAAI,QAAQ,QAAQ,IAAI,aAAa,IAAI,OAAO,SAAS;AAAA,EAGrE,MAAM,eAAwD,CAAC;AAAA,EAE/D,YAAY,YAAY,aAAa,OAAO,QAAQ,IAAI,OAAO,GAAG;AAAA,IAChE,aAAa,cAAc,SAAS,KAAK,GAAG;AAAA,EAC9C;AAAA,EAEA,OAAO;AAAA;",
-  "debugId": "D8642EAD6BFC352164756E2164756E21",
-  "names": []
-}

package/dist/mjs/core/api/api-helpers.mjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/api-helpers.ts"],
-  "sourcesContent": [
-    "/**\n * API Helper utilities for row/object conversion and filtering\n */\n\nimport type { CellAddress, SerializedCellValue, TableDefinition } from \"../types.mjs\";\nimport type { FormulaEngine } from \"../engine.mjs\";\n\nexport type ParseFunction<TCellMetadata = unknown> = (\n  value: unknown,\n  metadata: TCellMetadata\n) => unknown;\n\nexport type TableSchemaHeaders<TCellMetadata = unknown> = Record<\n  string,\n  {\n    parse: ParseFunction<TCellMetadata>;\n    index: number;\n  }\n>;\n\n/**\n * Convert a spreadsheet row to a typed object using header parsers\n */\nexport function rowToObject<TItem extends Record<string, unknown>>(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition,\n  rowIndex: number,\n  headers: TableSchemaHeaders,\n  getCellMetadata?: (cell: CellAddress) => unknown\n): TItem {\n  const result: Record<string, unknown> = {};\n\n  for (const [columnName, header] of Object.entries(headers)) {\n    const cellAddress: CellAddress = {\n      workbookName: table.workbookName,\n      sheetName: table.sheetName,\n      colIndex: table.start.colIndex + header.index,\n      rowIndex,\n    };\n\n    const value = engine.getCellValue(cellAddress);\n    const metadata = getCellMetadata ? getCellMetadata(cellAddress) : undefined;\n\n    // Parse the value using the column's parse function\n    result[columnName] = header.parse(value, metadata);\n  }\n\n  return result as TItem;\n}\n\n/**\n * Convert a typed object to cell values based on headers\n */\nexport function objectToRowValues<TItem extends Record<string, unknown>>(\n  obj: TItem,\n  headers: TableSchemaHeaders\n): Map<number, SerializedCellValue> {\n  const values = new Map<number, SerializedCellValue>();\n\n  for (const [columnName, header] of Object.entries(headers)) {\n    if (columnName in obj) {\n      const value = obj[columnName];\n      // Convert to serializable value\n      if (\n        typeof value === \"string\" ||\n        typeof value === \"number\" ||\n        typeof value === \"boolean\"\n      ) {\n        values.set(header.index, value);\n      } else if (value === null || value === undefined) {\n        values.set(header.index, undefined);\n      } else {\n        // For complex types, convert to string\n        values.set(header.index, String(value));\n      }\n    }\n  }\n\n  return values;\n}\n\n/**\n * Check if an object matches a filter predicate\n */\nexport function matchesFilter<TItem extends Record<string, unknown>>(\n  item: TItem,\n  filter: Partial<TItem>\n): boolean {\n  for (const [key, value] of Object.entries(filter)) {\n    if (item[key] !== value) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Get the number of data rows in a table (excluding header)\n */\nexport function getTableRowCount(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition\n): number {\n  if (table.endRow.type === \"infinity\") {\n    // For infinite tables, count non-empty rows\n    // Start from data row (after header)\n    let count = 0;\n    let emptyRowStreak = 0;\n    const maxEmptyRows = 10; // Stop after 10 consecutive empty rows\n\n    for (let row = table.start.rowIndex + 1; emptyRowStreak < maxEmptyRows; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      if (hasContent) {\n        count++;\n        emptyRowStreak = 0;\n      } else {\n        emptyRowStreak++;\n      }\n    }\n\n    return count;\n  } else {\n    // For finite tables, calculate from endRow\n    return table.endRow.value - table.start.rowIndex;\n  }\n}\n\n/**\n * Get the next empty row index for appending data\n */\nexport function getNextEmptyRow(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition\n): number {\n  const dataStartRow = table.start.rowIndex + 1;\n\n  if (table.endRow.type === \"infinity\") {\n    // Find first empty row\n    let emptyRowStreak = 0;\n    const maxEmptyRows = 10;\n\n    for (let row = dataStartRow; ; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      if (!hasContent) {\n        return row;\n      }\n\n      emptyRowStreak = hasContent ? 0 : emptyRowStreak + 1;\n      if (emptyRowStreak >= maxEmptyRows) {\n        return row - maxEmptyRows + 1;\n      }\n    }\n  } else {\n    // For finite tables, return the row after the last data row\n    return table.endRow.value + 1;\n  }\n}\n\n/**\n * Iterate over all data rows in a table\n */\nexport function* iterateTableRows(\n  engine: FormulaEngine<any, any>,\n  table: TableDefinition\n): Generator<{ rowIndex: number; isEmpty: boolean }> {\n  const dataStartRow = table.start.rowIndex + 1;\n\n  if (table.endRow.type === \"infinity\") {\n    let emptyRowStreak = 0;\n    const maxEmptyRows = 10;\n\n    for (let row = dataStartRow; emptyRowStreak < maxEmptyRows; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      if (hasContent) {\n        emptyRowStreak = 0;\n        yield { rowIndex: row, isEmpty: false };\n      } else {\n        emptyRowStreak++;\n        // Don't yield empty rows at the end\n      }\n    }\n  } else {\n    for (let row = dataStartRow; row <= table.endRow.value; row++) {\n      let hasContent = false;\n\n      for (let col = 0; col < table.headers.size; col++) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + col,\n          rowIndex: row,\n        };\n\n        const value = engine.getCellValue(cellAddress);\n        if (value !== \"\" && value !== undefined) {\n          hasContent = true;\n          break;\n        }\n      }\n\n      yield { rowIndex: row, isEmpty: !hasContent };\n    }\n  }\n}\n\n"
-  ],
-  "mappings": "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",
-  "debugId": "0AEE3F3D29B7684464756E2164756E21",
-  "names": []
-}

package/dist/mjs/core/api/api.mjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/api.ts"],
-  "sourcesContent": [
-    "import type { CellAddress } from \"../types.mjs\";\nimport type { CellOrm } from \"./cell-orm.mjs\";\nimport type { TableOrm } from \"./table-orm.mjs\";\n\n/**\n * Define an API schema for the FormulaEngine.\n *\n * The returned object contains:\n * - `declaration`: The schema definitions for tables and cells\n * - `api`: A type-only placeholder (undefined at runtime) for TypeScript inference\n *\n * The actual working API is only available through `engine.api` after\n * attaching the definition to a FormulaEngine instance.\n *\n * @example\n * ```typescript\n * const myApi = defineApi<CellMetadata>()\n *   .addTableApi(\"users\", { workbookName: \"wb1\", tableName: \"users\" }, headers, methods)\n *   .addCellApi(\"config\", cellAddress, parse, methods);\n *\n * const engine = new FormulaEngine(myApi);\n * engine.api.users.get(1); // Works!\n * myApi.api.users.get(1);  // Error: api is undefined at runtime\n * ```\n */\nexport function defineApi<\n  TCellMetadata = unknown,\n  TCurrentApi extends Record<\n    string,\n    Record<string, (...args: any[]) => any>\n  > = Record<string, Record<string, (...args: any[]) => any>>,\n  TCurrentDeclaration extends Record<string, TableApi | CellApi> = Record<\n    string,\n    TableApi | CellApi\n  >\n>(): CreateApi<TCellMetadata, TCurrentApi, TCurrentDeclaration> {\n  const declaration: Record<string, TableApi | CellApi> = {};\n\n  const builder: CreateApi<TCellMetadata, TCurrentApi, TCurrentDeclaration> = {\n    addTableApi(namespace, address, headers, methods) {\n      declaration[namespace] = {\n        type: \"table\",\n        tableName: address.tableName,\n        workbookName: address.workbookName,\n        headers: headers as any,\n        methods: methods as any,\n      };\n      return builder as any;\n    },\n\n    addCellApi(namespace, cellAddress, parse, methods) {\n      declaration[namespace] = {\n        type: \"cell\",\n        cellAddress,\n        parse: parse as any,\n        methods: methods as any,\n      };\n      return builder as any;\n    },\n\n    // api is undefined at runtime - it only exists for TypeScript type inference\n    // The actual working API is built by the FormulaEngine constructor\n    api: undefined as any as TCurrentApi,\n\n    declaration: declaration as TCurrentDeclaration,\n  };\n\n  return builder;\n}\n\n// Keep createApi as an alias for backwards compatibility\nexport const createApi = defineApi;\n\ntype ParseFunction<TCellMetadata> = (\n  value: unknown,\n  metadata: TCellMetadata\n) => unknown;\n\nexport interface TableApi {\n  type: \"table\";\n  headers: Headers<unknown>;\n  tableName: string;\n  workbookName: string;\n  methods: TableMethods<Record<string, unknown>>;\n}\n\nexport interface CellApi {\n  type: \"cell\";\n  cellAddress: CellAddress;\n  parse: (value: unknown, metadata: unknown) => unknown;\n  methods: CellMethods<unknown>;\n}\n\ntype Headers<TCellMetadata> = Record<\n  string,\n  {\n    parse: ParseFunction<TCellMetadata>;\n    index: number;\n  }\n>;\n\ntype TableMethods<TItem extends Record<string, unknown>> = Record<\n  string,\n  (this: TableOrm<TItem>, ...args: any[]) => any\n>;\n\ntype CellMethods<TValue> = Record<\n  string,\n  (this: CellOrm<TValue>, ...args: any[]) => any\n>;\n\nexport type Declaration = Record<string, TableApi | CellApi>;\nexport type Api = Record<string, Record<string, (...args: any[]) => any>>;\n\nexport type CreateApi<\n  TCellMetadata,\n  TCurrentApi extends Api,\n  TCurrentDeclaration extends Declaration\n> = {\n  addTableApi<\n    T extends string,\n    THeaders extends Headers<TCellMetadata>,\n    TMethods extends TableMethods<{\n      [K in keyof THeaders]: ReturnType<THeaders[K][\"parse\"]>;\n    }>\n  >(\n    namespace: T,\n    address: { workbookName: string; tableName: string },\n    headers: THeaders,\n    methods: TMethods\n  ): CreateApi<\n    TCellMetadata,\n    TCurrentApi & {\n      [K in T]: {\n        [M in keyof TMethods]: (\n          ...args: Parameters<TMethods[M]>\n        ) => ReturnType<TMethods[M]>;\n      };\n    },\n    TCurrentDeclaration & {\n      [K in T]: {\n        type: \"table\";\n        tableName: string;\n        workbookName: string;\n        headers: THeaders;\n        methods: TMethods;\n      };\n    }\n  >;\n  addCellApi<T extends string, TValue, TMethods extends CellMethods<TValue>>(\n    namespace: T,\n    cellAddress: CellAddress,\n    parse: (value: unknown, metadata: TCellMetadata) => TValue,\n    methods: TMethods\n  ): CreateApi<\n    TCellMetadata,\n    TCurrentApi & {\n      [K in T]: {\n        [M in keyof TMethods]: (\n          ...args: Parameters<TMethods[M]>\n        ) => ReturnType<TMethods[M]>;\n      };\n    },\n    TCurrentDeclaration & {\n      [K in T]: {\n        type: \"cell\";\n        cellAddress: CellAddress;\n        parse: (value: unknown, metadata: unknown) => unknown;\n        methods: TMethods;\n      };\n    }\n  >;\n  api: TCurrentApi;\n  declaration: TCurrentDeclaration;\n};\n"
-  ],
-  "mappings": ";AAyBO,SAAS,SAUf,GAA+D;AAAA,EAC9D,MAAM,cAAkD,CAAC;AAAA,EAEzD,MAAM,UAAsE;AAAA,IAC1E,WAAW,CAAC,WAAW,SAAS,SAAS,SAAS;AAAA,MAChD,YAAY,aAAa;AAAA,QACvB,MAAM;AAAA,QACN,WAAW,QAAQ;AAAA,QACnB,cAAc,QAAQ;AAAA,QACtB;AAAA,QACA;AAAA,MACF;AAAA,MACA,OAAO;AAAA;AAAA,IAGT,UAAU,CAAC,WAAW,aAAa,OAAO,SAAS;AAAA,MACjD,YAAY,aAAa;AAAA,QACvB,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,OAAO;AAAA;AAAA,IAKT,KAAK;AAAA,IAEL;AAAA,EACF;AAAA,EAEA,OAAO;AAAA;AAIF,IAAM,YAAY;",
-  "debugId": "9CD7AE5B7F689F5D64756E2164756E21",
-  "names": []
-}

package/dist/mjs/core/api/table-orm.mjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/api/table-orm.ts"],
-  "sourcesContent": [
-    "/**\n * TableOrm - Object-Relational Mapping for table data\n *\n * Provides CRUD operations for table data with type-safe access.\n * Used as the `this` context for custom table API methods.\n */\n\nimport type { CellAddress, SerializedCellValue, TableDefinition } from \"../types.mjs\";\nimport type { FormulaEngine } from \"../engine.mjs\";\nimport {\n  rowToObject,\n  objectToRowValues,\n  matchesFilter,\n  getTableRowCount,\n  getNextEmptyRow,\n  iterateTableRows,\n  type TableSchemaHeaders,\n} from \"./api-helpers.mjs\";\n\nexport class TableOrm<TItem extends Record<string, unknown>> {\n  constructor(\n    private engine: FormulaEngine<any, any>,\n    private workbookName: string,\n    private tableName: string,\n    private headers: TableSchemaHeaders,\n    private namespace: string\n  ) {}\n\n  /**\n   * Get the table definition from the engine\n   */\n  private getTable(): TableDefinition {\n    const table = this.engine._tableManager.getTable({\n      workbookName: this.workbookName,\n      name: this.tableName,\n    });\n\n    if (!table) {\n      throw new Error(\n        `Table \"${this.tableName}\" not found in workbook \"${this.workbookName}\"`\n      );\n    }\n\n    return table;\n  }\n\n  /**\n   * Find the first row matching the filter\n   */\n  findWhere(filter: Partial<TItem>): TItem | undefined {\n    const table = this.getTable();\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          return item;\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Find all rows matching the filter\n   */\n  findAllWhere(filter: Partial<TItem>): TItem[] {\n    const table = this.getTable();\n    const results: TItem[] = [];\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          results.push(item);\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Append a new row to the table\n   */\n  append(item: TItem): TItem {\n    const table = this.getTable();\n    const nextRow = getNextEmptyRow(this.engine, table);\n    const values = objectToRowValues(item, this.headers);\n\n    // Write each cell value\n    for (const [colOffset, value] of values) {\n      const cellAddress: CellAddress = {\n        workbookName: table.workbookName,\n        sheetName: table.sheetName,\n        colIndex: table.start.colIndex + colOffset,\n        rowIndex: nextRow,\n      };\n\n      this.engine.setCellContent(cellAddress, value);\n    }\n\n    return item;\n  }\n\n  /**\n   * Update all rows matching the filter\n   * Returns the number of rows updated\n   */\n  updateWhere(filter: Partial<TItem>, update: Partial<TItem>): number {\n    const table = this.getTable();\n    let updatedCount = 0;\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          // Apply updates\n          const values = objectToRowValues(update as TItem, this.headers);\n\n          for (const [colOffset, value] of values) {\n            const cellAddress: CellAddress = {\n              workbookName: table.workbookName,\n              sheetName: table.sheetName,\n              colIndex: table.start.colIndex + colOffset,\n              rowIndex,\n            };\n\n            this.engine.setCellContent(cellAddress, value);\n          }\n\n          updatedCount++;\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    return updatedCount;\n  }\n\n  /**\n   * Remove all rows matching the filter\n   * Returns the number of rows removed\n   */\n  removeWhere(filter: Partial<TItem>): number {\n    const table = this.getTable();\n    let removedCount = 0;\n\n    // Collect rows to remove (in reverse order to avoid index shifting issues)\n    const rowsToRemove: number[] = [];\n\n    for (const { rowIndex, isEmpty } of iterateTableRows(this.engine, table)) {\n      if (isEmpty) continue;\n\n      try {\n        const item = rowToObject<TItem>(\n          this.engine,\n          table,\n          rowIndex,\n          this.headers,\n          (cell) => this.engine.getCellMetadata(cell)\n        );\n\n        if (matchesFilter(item, filter)) {\n          rowsToRemove.push(rowIndex);\n        }\n      } catch {\n        // Skip rows that fail parsing\n        continue;\n      }\n    }\n\n    // Remove rows in reverse order\n    for (const rowIndex of rowsToRemove.reverse()) {\n      // Clear all cells in the row\n      for (const header of Object.values(this.headers)) {\n        const cellAddress: CellAddress = {\n          workbookName: table.workbookName,\n          sheetName: table.sheetName,\n          colIndex: table.start.colIndex + header.index,\n          rowIndex,\n        };\n\n        this.engine.setCellContent(cellAddress, undefined);\n      }\n\n      removedCount++;\n    }\n\n    return removedCount;\n  }\n\n  /**\n   * Get the count of data rows in the table\n   */\n  count(): number {\n    const table = this.getTable();\n    return getTableRowCount(this.engine, table);\n  }\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "745B273574CD6E8C64756E2164756E21",
-  "names": []
-}

package/dist/mjs/core/managers/api-schema-manager.mjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/core/managers/api-schema-manager.ts"],
-  "sourcesContent": [
-    "/**\n * ApiSchemaManager - Manages API schema definitions and validation\n *\n * Tracks registered schemas and provides validation for cell writes,\n * spill operations, and copy/paste operations.\n */\n\nimport type {\n  CellAddress,\n  SerializedCellValue,\n  SpreadsheetRange,\n  TableDefinition,\n} from \"../types.mjs\";\nimport { cellAddressToKey, isCellInRange } from \"../utils.mjs\";\nimport type { TableManager } from \"./table-manager.mjs\";\n\nexport type ParseFunction<TCellMetadata = unknown> = (\n  value: unknown,\n  metadata: TCellMetadata\n) => unknown;\n\nexport type TableSchemaHeaders<TCellMetadata = unknown> = Record<\n  string,\n  {\n    parse: ParseFunction<TCellMetadata>;\n    index: number;\n  }\n>;\n\nexport interface RegisteredTableSchema {\n  type: \"table\";\n  namespace: string;\n  workbookName: string;\n  tableName: string;\n  headers: TableSchemaHeaders;\n}\n\nexport interface RegisteredCellSchema {\n  type: \"cell\";\n  namespace: string;\n  cellAddress: CellAddress;\n  parse: ParseFunction;\n}\n\nexport type RegisteredSchema = RegisteredTableSchema | RegisteredCellSchema;\n\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n  originalError?: Error;\n}\n\nexport class SchemaValidationError extends Error {\n  constructor(\n    message: string,\n    public cellAddress?: CellAddress,\n    public originalError?: Error\n  ) {\n    super(message);\n    this.name = \"SchemaValidationError\";\n  }\n}\n\nexport class ApiSchemaManager {\n  private schemas: Map<string, RegisteredSchema> = new Map();\n\n  constructor(private tableManager: TableManager) {}\n\n  /**\n   * Register a table schema\n   */\n  registerTableSchema(\n    namespace: string,\n    workbookName: string,\n    tableName: string,\n    headers: TableSchemaHeaders\n  ): void {\n    this.schemas.set(namespace, {\n      type: \"table\",\n      namespace,\n      workbookName,\n      tableName,\n      headers,\n    });\n  }\n\n  /**\n   * Register a cell schema\n   */\n  registerCellSchema(\n    namespace: string,\n    cellAddress: CellAddress,\n    parse: ParseFunction\n  ): void {\n    this.schemas.set(namespace, {\n      type: \"cell\",\n      namespace,\n      cellAddress,\n      parse,\n    });\n  }\n\n  /**\n   * Get a schema by namespace\n   */\n  getSchema(namespace: string): RegisteredSchema | undefined {\n    return this.schemas.get(namespace);\n  }\n\n  /**\n   * Remove a schema\n   */\n  removeSchema(namespace: string): boolean {\n    return this.schemas.delete(namespace);\n  }\n\n  /**\n   * Check if a cell is protected by a schema\n   * Returns the schema info if protected, null otherwise\n   */\n  isCellProtected(\n    cell: CellAddress\n  ): { schema: RegisteredSchema; columnName?: string } | null {\n    for (const schema of this.schemas.values()) {\n      if (schema.type === \"cell\") {\n        if (\n          schema.cellAddress.workbookName === cell.workbookName &&\n          schema.cellAddress.sheetName === cell.sheetName &&\n          schema.cellAddress.colIndex === cell.colIndex &&\n          schema.cellAddress.rowIndex === cell.rowIndex\n        ) {\n          return { schema };\n        }\n      } else if (schema.type === \"table\") {\n        const table = this.tableManager.getTable({\n          workbookName: schema.workbookName,\n          name: schema.tableName,\n        });\n\n        if (!table) continue;\n\n        // Check if cell is in table's data range (excluding header row)\n        if (\n          cell.workbookName === table.workbookName &&\n          cell.sheetName === table.sheetName\n        ) {\n          const isInDataRange = this.isCellInTableDataRange(cell, table);\n          if (isInDataRange) {\n            // Find which column this cell is in\n            const colOffset = cell.colIndex - table.start.colIndex;\n            const columnName = this.getColumnNameByIndex(\n              schema.headers,\n              colOffset\n            );\n            return { schema, columnName };\n          }\n        }\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Check if a cell is within a table's data range (excluding header row)\n   */\n  private isCellInTableDataRange(\n    cell: CellAddress,\n    table: TableDefinition\n  ): boolean {\n    const { start, endRow, headers } = table;\n\n    // Data starts one row below header\n    const dataStartRow = start.rowIndex + 1;\n\n    // Check row bounds (data rows only, not header)\n    const isInRowRange =\n      endRow.type === \"infinity\"\n        ? cell.rowIndex >= dataStartRow\n        : cell.rowIndex >= dataStartRow && cell.rowIndex <= endRow.value;\n\n    // Check column bounds\n    const endColIndex = start.colIndex + headers.size - 1;\n    const isInColRange =\n      cell.colIndex >= start.colIndex && cell.colIndex <= endColIndex;\n\n    return isInRowRange && isInColRange;\n  }\n\n  /**\n   * Get column name by index from headers\n   */\n  private getColumnNameByIndex(\n    headers: TableSchemaHeaders,\n    index: number\n  ): string | undefined {\n    for (const [name, header] of Object.entries(headers)) {\n      if (header.index === index) {\n        return name;\n      }\n    }\n    return undefined;\n  }\n\n  /**\n   * Validate a cell write against schemas\n   */\n  validateCellWrite(\n    cell: CellAddress,\n    value: SerializedCellValue,\n    metadata?: unknown\n  ): ValidationResult {\n    // Allow clearing cells (undefined or empty string)\n    if (value === undefined || value === \"\") {\n      return { valid: true };\n    }\n\n    const protection = this.isCellProtected(cell);\n\n    if (!protection) {\n      return { valid: true };\n    }\n\n    const { schema, columnName } = protection;\n\n    try {\n      if (schema.type === \"cell\") {\n        schema.parse(value, metadata);\n      } else if (schema.type === \"table\" && columnName) {\n        const header = schema.headers[columnName];\n        if (header) {\n          header.parse(value, metadata);\n        }\n      }\n      return { valid: true };\n    } catch (err) {\n      const error = err instanceof Error ? err : new Error(String(err));\n      return {\n        valid: false,\n        error: `Schema validation failed for ${schema.namespace}${\n          columnName ? `.${columnName}` : \"\"\n        }: ${error.message}`,\n        originalError: error,\n      };\n    }\n  }\n\n  /**\n   * Validate a spill area against schemas\n   * Returns validation result - if invalid, spill should produce #SPILL! error\n   */\n  validateSpillArea(\n    origin: CellAddress,\n    spillArea: SpreadsheetRange,\n    getSpillValue: (row: number, col: number) => SerializedCellValue,\n    getMetadata?: (cell: CellAddress) => unknown\n  ): ValidationResult {\n    // Get the bounds of the spill area\n    const startRow = spillArea.start.row;\n    const startCol = spillArea.start.col;\n    const endRow =\n      spillArea.end.row.type === \"number\"\n        ? spillArea.end.row.value\n        : startRow + 100; // Limit for infinite ranges\n    const endCol =\n      spillArea.end.col.type === \"number\"\n        ? spillArea.end.col.value\n        : startCol + 100; // Limit for infinite ranges\n\n    for (let row = startRow; row <= endRow; row++) {\n      for (let col = startCol; col <= endCol; col++) {\n        const cell: CellAddress = {\n          workbookName: origin.workbookName,\n          sheetName: origin.sheetName,\n          rowIndex: row,\n          colIndex: col,\n        };\n\n        const protection = this.isCellProtected(cell);\n        if (protection) {\n          const value = getSpillValue(row - startRow, col - startCol);\n          const metadata = getMetadata ? getMetadata(cell) : undefined;\n          const validation = this.validateCellWrite(cell, value, metadata);\n\n          if (!validation.valid) {\n            return {\n              valid: false,\n              error: `Spill blocked by schema at ${cellAddressToKey(cell)}: ${\n                validation.error\n              }`,\n              originalError: validation.originalError,\n            };\n          }\n        }\n      }\n    }\n\n    return { valid: true };\n  }\n\n  /**\n   * Update schemas when a table is renamed\n   */\n  updateForTableRename(\n    workbookName: string,\n    oldTableName: string,\n    newTableName: string\n  ): void {\n    for (const schema of this.schemas.values()) {\n      if (\n        schema.type === \"table\" &&\n        schema.workbookName === workbookName &&\n        schema.tableName === oldTableName\n      ) {\n        schema.tableName = newTableName;\n      }\n    }\n  }\n\n  /**\n   * Update schemas when a sheet is renamed\n   */\n  updateForSheetRename(\n    workbookName: string,\n    oldSheetName: string,\n    newSheetName: string\n  ): void {\n    for (const schema of this.schemas.values()) {\n      if (schema.type === \"cell\") {\n        if (\n          schema.cellAddress.workbookName === workbookName &&\n          schema.cellAddress.sheetName === oldSheetName\n        ) {\n          schema.cellAddress.sheetName = newSheetName;\n        }\n      }\n      // Table schemas don't store sheetName directly - they get it from TableManager\n    }\n  }\n\n  /**\n   * Update schemas when a workbook is renamed\n   */\n  updateForWorkbookRename(\n    oldWorkbookName: string,\n    newWorkbookName: string\n  ): void {\n    for (const schema of this.schemas.values()) {\n      if (schema.type === \"cell\") {\n        if (schema.cellAddress.workbookName === oldWorkbookName) {\n          schema.cellAddress.workbookName = newWorkbookName;\n        }\n      } else if (schema.type === \"table\") {\n        if (schema.workbookName === oldWorkbookName) {\n          schema.workbookName = newWorkbookName;\n        }\n      }\n    }\n  }\n\n  /**\n   * Get all schemas (for debugging/testing)\n   */\n  getAllSchemas(): Map<string, RegisteredSchema> {\n    return new Map(this.schemas);\n  }\n\n  /**\n   * Validate all schema constraints using evaluated cell values.\n   *\n   * This is the key method for schema validation with rollback:\n   * - It validates EVALUATED values, not raw content\n   * - A cell with \"=123+123\" validates as number (246), not string\n   * - Called after re-evaluation to check all schema-constrained cells\n   *\n   * @param getCellValue - Function to get the evaluated value of a cell\n   * @param getCellMetadata - Optional function to get cell metadata\n   * @returns Validation result with all errors found\n   */\n  validateAllSchemaConstraints(\n    getCellValue: (cell: CellAddress) => SerializedCellValue,\n    getCellMetadata?: (cell: CellAddress) => unknown,\n    getTableDataCells?: (table: TableDefinition) => CellAddress[]\n  ): {\n    valid: boolean;\n    errors: Array<{\n      message: string;\n      cellAddress?: CellAddress;\n      schemaNamespace?: string;\n      columnName?: string;\n      originalError?: Error;\n    }>;\n  } {\n    const errors: Array<{\n      message: string;\n      cellAddress?: CellAddress;\n      schemaNamespace?: string;\n      columnName?: string;\n      originalError?: Error;\n    }> = [];\n\n    for (const [namespace, schema] of this.schemas) {\n      if (schema.type === \"cell\") {\n        // Validate single cell using evaluated value\n        let value: SerializedCellValue;\n        try {\n          value = getCellValue(schema.cellAddress);\n        } catch {\n          // Sheet/cell doesn't exist yet, skip validation\n          continue;\n        }\n\n        const metadata = getCellMetadata\n          ? getCellMetadata(schema.cellAddress)\n          : undefined;\n\n        // Skip empty cells\n        if (value === undefined || value === \"\") {\n          continue;\n        }\n\n        try {\n          schema.parse(value, metadata);\n        } catch (err) {\n          const error = err instanceof Error ? err : new Error(String(err));\n          errors.push({\n            message: `Schema validation failed for ${namespace}: ${error.message}`,\n            cellAddress: schema.cellAddress,\n            schemaNamespace: namespace,\n            originalError: error,\n          });\n        }\n      } else if (schema.type === \"table\") {\n        // Get the table definition\n        const table = this.tableManager.getTable({\n          workbookName: schema.workbookName,\n          name: schema.tableName,\n        });\n\n        if (!table) continue;\n\n        const { start, headers } = table;\n\n        // Get cells to validate - use callback if provided (handles infinite ranges efficiently)\n        // Otherwise fall back to simple iteration for finite tables\n        let cellsToValidate: CellAddress[];\n        if (getTableDataCells) {\n          cellsToValidate = getTableDataCells(table);\n        } else {\n          // Fallback for finite tables when no callback provided\n          const { endRow } = table;\n          if (endRow.type === \"infinity\") {\n            // Skip validation for infinite tables without a cell iterator\n            continue;\n          }\n          cellsToValidate = [];\n          const dataStartRow = start.rowIndex + 1;\n          const endColIndex = start.colIndex + headers.size - 1;\n          for (let row = dataStartRow; row <= endRow.value; row++) {\n            for (let col = start.colIndex; col <= endColIndex; col++) {\n              cellsToValidate.push({\n                workbookName: table.workbookName,\n                sheetName: table.sheetName,\n                rowIndex: row,\n                colIndex: col,\n              });\n            }\n          }\n        }\n\n        for (const cell of cellsToValidate) {\n          // Skip header row\n          if (cell.rowIndex <= start.rowIndex) continue;\n\n          let value: SerializedCellValue;\n          try {\n            value = getCellValue(cell);\n          } catch {\n            // Sheet/cell doesn't exist yet, skip validation\n            continue;\n          }\n\n          // Skip empty cells\n          if (value === undefined || value === \"\") {\n            continue;\n          }\n\n          // Find the column name\n          const colOffset = cell.colIndex - start.colIndex;\n          const columnName = this.getColumnNameByIndex(\n            schema.headers,\n            colOffset\n          );\n\n          if (columnName && schema.headers[columnName]) {\n            const header = schema.headers[columnName];\n            const metadata = getCellMetadata\n              ? getCellMetadata(cell)\n              : undefined;\n\n            try {\n              header.parse(value, metadata);\n            } catch (err) {\n              const error =\n                err instanceof Error ? err : new Error(String(err));\n              errors.push({\n                message: `Schema validation failed for ${namespace}.${columnName}: ${error.message}`,\n                cellAddress: cell,\n                schemaNamespace: namespace,\n                columnName,\n                originalError: error,\n              });\n            }\n          }\n        }\n      }\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  }\n}\n"
-  ],
-  "mappings": "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",
-  "debugId": "14FAED76B9C0A2D664756E2164756E21",
-  "names": []
-}

package/dist/types/core/api/api-builder.d.ts

@@ -1,16 +0,0 @@
-/**
- * API Builder - Constructs the working API from declarations
- *
- * This module is responsible for creating the actual working API
- * from the schema declarations when attached to a FormulaEngine.
- */
-import type { FormulaEngine } from "../engine";
-import type { Declaration, Api } from "./api";
-import type { ApiSchemaManager } from "../managers/api-schema-manager";
-/**
- * Build the working API surface from declarations
- *
- * This creates TableOrm and CellOrm instances for each declared schema
- * and binds the custom methods to them.
- */
-export declare function buildApiFromDeclaration(engine: FormulaEngine<any, any>, declaration: Declaration, schemaManager: ApiSchemaManager): Api;

package/dist/types/core/api/api.d.ts

@@ -1,83 +0,0 @@
-import type { CellAddress } from "../types";
-import type { CellOrm } from "./cell-orm";
-import type { TableOrm } from "./table-orm";
-/**
- * Define an API schema for the FormulaEngine.
- *
- * The returned object contains:
- * - `declaration`: The schema definitions for tables and cells
- * - `api`: A type-only placeholder (undefined at runtime) for TypeScript inference
- *
- * The actual working API is only available through `engine.api` after
- * attaching the definition to a FormulaEngine instance.
- *
- * @example
- * ```typescript
- * const myApi = defineApi<CellMetadata>()
- *   .addTableApi("users", { workbookName: "wb1", tableName: "users" }, headers, methods)
- *   .addCellApi("config", cellAddress, parse, methods);
- *
- * const engine = new FormulaEngine(myApi);
- * engine.api.users.get(1); // Works!
- * myApi.api.users.get(1);  // Error: api is undefined at runtime
- * ```
- */
-export declare function defineApi<TCellMetadata = unknown, TCurrentApi extends Record<string, Record<string, (...args: any[]) => any>> = Record<string, Record<string, (...args: any[]) => any>>, TCurrentDeclaration extends Record<string, TableApi | CellApi> = Record<string, TableApi | CellApi>>(): CreateApi<TCellMetadata, TCurrentApi, TCurrentDeclaration>;
-export declare const createApi: typeof defineApi;
-type ParseFunction<TCellMetadata> = (value: unknown, metadata: TCellMetadata) => unknown;
-export interface TableApi {
-    type: "table";
-    headers: Headers<unknown>;
-    tableName: string;
-    workbookName: string;
-    methods: TableMethods<Record<string, unknown>>;
-}
-export interface CellApi {
-    type: "cell";
-    cellAddress: CellAddress;
-    parse: (value: unknown, metadata: unknown) => unknown;
-    methods: CellMethods<unknown>;
-}
-type Headers<TCellMetadata> = Record<string, {
-    parse: ParseFunction<TCellMetadata>;
-    index: number;
-}>;
-type TableMethods<TItem extends Record<string, unknown>> = Record<string, (this: TableOrm<TItem>, ...args: any[]) => any>;
-type CellMethods<TValue> = Record<string, (this: CellOrm<TValue>, ...args: any[]) => any>;
-export type Declaration = Record<string, TableApi | CellApi>;
-export type Api = Record<string, Record<string, (...args: any[]) => any>>;
-export type CreateApi<TCellMetadata, TCurrentApi extends Api, TCurrentDeclaration extends Declaration> = {
-    addTableApi<T extends string, THeaders extends Headers<TCellMetadata>, TMethods extends TableMethods<{
-        [K in keyof THeaders]: ReturnType<THeaders[K]["parse"]>;
-    }>>(namespace: T, address: {
-        workbookName: string;
-        tableName: string;
-    }, headers: THeaders, methods: TMethods): CreateApi<TCellMetadata, TCurrentApi & {
-        [K in T]: {
-            [M in keyof TMethods]: (...args: Parameters<TMethods[M]>) => ReturnType<TMethods[M]>;
-        };
-    }, TCurrentDeclaration & {
-        [K in T]: {
-            type: "table";
-            tableName: string;
-            workbookName: string;
-            headers: THeaders;
-            methods: TMethods;
-        };
-    }>;
-    addCellApi<T extends string, TValue, TMethods extends CellMethods<TValue>>(namespace: T, cellAddress: CellAddress, parse: (value: unknown, metadata: TCellMetadata) => TValue, methods: TMethods): CreateApi<TCellMetadata, TCurrentApi & {
-        [K in T]: {
-            [M in keyof TMethods]: (...args: Parameters<TMethods[M]>) => ReturnType<TMethods[M]>;
-        };
-    }, TCurrentDeclaration & {
-        [K in T]: {
-            type: "cell";
-            cellAddress: CellAddress;
-            parse: (value: unknown, metadata: unknown) => unknown;
-            methods: TMethods;
-        };
-    }>;
-    api: TCurrentApi;
-    declaration: TCurrentDeclaration;
-};
-export {};