@origints/xlsx 0.2.0 → 0.4.0

package/dist/xlsx-spec.d.ts

@@ -72,6 +72,15 @@ export type XlsxStep = {
     readonly kind: 'rowWhere';
     readonly headerRef: Spec;
     readonly predicate: CellPredicateSpec;
+} | {
+    readonly kind: 'fromRef';
+    readonly ref: string;
+    readonly path?: readonly (string | number)[];
+} | {
+    readonly kind: 'colAtRef';
+    readonly ref: string;
+    readonly path?: readonly (string | number)[];
+    readonly component: 'col' | 'row';
 } | {
     readonly kind: 'range';
     readonly ref: string;
@@ -103,6 +112,32 @@ export interface EachSliceExtract {
     readonly kind: 'eachSlice';
     readonly direction: Direction;
     readonly while: RowPredicateSpec;
+    readonly groupSize?: number;
+}
+/**
+ * Position of a cell in a workbook, used as a variable-bound value
+ * from findAll for dynamic navigation.
+ */
+export interface CellPosition {
+    readonly row: number;
+    readonly col: number;
+    readonly sheetName?: string;
+}
+/**
+ * Specification for finding all cells matching a predicate.
+ * Returns CellPosition[] at runtime.
+ */
+export interface FindAllExtract {
+    readonly kind: 'findAll';
+    readonly predicate: CellPredicateSpec;
+    readonly constraints?: {
+        readonly inRow?: number;
+        readonly inCol?: number;
+        readonly startRow?: number;
+        readonly endRow?: number;
+        readonly startCol?: number;
+        readonly endCol?: number;
+    };
 }
 /**
  * The terminal extraction type for an XLSX value.
@@ -111,7 +146,7 @@ export interface EachSliceExtract {
  * - Range-level (produce arrays): 'rows', 'cells'
  * - Cell-level (produce arrays): EachCellExtract, EachSliceExtract
  */
-export type XlsxExtract = 'string' | 'number' | 'boolean' | 'date' | 'value' | 'formula' | 'rows' | 'cells' | EachCellExtract | EachSliceExtract;
+export type XlsxExtract = 'string' | 'number' | 'boolean' | 'date' | 'value' | 'formula' | 'rows' | 'cells' | EachCellExtract | EachSliceExtract | FindAllExtract;
 /**
  * A complete XLSX extraction spec.
  *

package/dist/xlsx-workbook.d.ts

@@ -1,5 +1,4 @@
 import { TYPE_LABEL } from '@origints/core';
-import { Workbook } from 'exceljs';
 import { XlsxSheet } from './xlsx-sheet';
 import { XlsxResult, XlsxPath } from './xlsx-result';
 /**
@@ -18,22 +17,23 @@ export interface WorkbookProperties {
     readonly modified?: Date;
 }
 /**
- * A wrapper around ExcelJS Workbook with navigation and query capabilities.
+ * A wrapper around workbook data with navigation and query capabilities.
  *
  * XlsxWorkbook provides access to sheets, workbook properties, and
  * supports predicate-based queries for finding sheets.
  */
 export declare class XlsxWorkbook {
-    private readonly workbook;
     private readonly _path;
     get [TYPE_LABEL](): string;
-    private readonly sheetsCache;
+    private readonly _sheets;
+    private readonly _sheetsByName;
+    private readonly _props;
     private constructor();
     /**
-     * Creates an XlsxWorkbook from an ExcelJS workbook.
+     * Creates an XlsxWorkbook from internal data.
      * @internal
      */
-    static fromExcelJS(workbook: Workbook, file?: string): XlsxWorkbook;
+    static create(sheets: XlsxSheet[], props: WorkbookProperties, file?: string): XlsxWorkbook;
     /**
      * Returns the path for lineage tracking.
      */
@@ -122,9 +122,4 @@ export declare class XlsxWorkbook {
      * Map over all sheets.
      */
     map<T>(fn: (sheet: XlsxSheet, index: number) => T): T[];
-    /**
-     * Get the underlying ExcelJS workbook.
-     * @internal
-     */
-    getWorkbook(): Workbook;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@origints/xlsx",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "XLSX parsing for Origins with full traceability to sheets, ranges, and cells.",
   "type": "module",
   "license": "MIT",
@@ -20,6 +20,13 @@
   "publishConfig": {
     "access": "public"
   },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint \"{src,tests}/**/*.{ts,tsx}\" --max-warnings 0",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/fponticelli/origints.git",
@@ -40,26 +47,20 @@
     "node": ">=18"
   },
   "dependencies": {
-    "exceljs": "^4.4.0"
+    "xlsx": "^0.18.5"
   },
   "peerDependencies": {
-    "@origints/core": "^0.2.0"
+    "@origints/core": "^0.4.0"
   },
   "devDependencies": {
+    "@origints/core": "workspace:*",
+    "exceljs": "^4.4.0",
     "@types/node": "25.0.6",
     "@vitest/coverage-v8": "^4.0.16",
     "eslint": "9.39.2",
     "typescript": "5.9.3",
     "vite": "7.3.1",
     "vite-plugin-dts": "4.5.4",
-    "vitest": "4.0.16",
-    "@origints/core": "0.2.0"
-  },
-  "scripts": {
-    "build": "vite build",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint \"{src,tests}/**/*.{ts,tsx}\" --max-warnings 0",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "vitest": "4.0.16"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Franco Ponticelli
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.