@loaders.gl/excel 4.4.2 → 5.0.0-alpha.1

package/dist/excel-format.d.ts

@@ -5,6 +5,8 @@ export declare const ExcelFormat: {
     readonly name: "Excel";
     readonly id: "excel";
     readonly module: "excel";
+    readonly encoding: "zip";
+    readonly format: "excel";
     readonly extensions: ["xls", "xlsb", "xlsm", "xlsx"];
     readonly mimeTypes: ["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel"];
     readonly category: "table";

package/dist/excel-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"excel-format.d.ts","sourceRoot":"","sources":["../src/excel-format.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;CAWG,CAAC"}
+{"version":3,"file":"excel-format.d.ts","sourceRoot":"","sources":["../src/excel-format.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;CAaG,CAAC"}

package/dist/excel-format.js

@@ -8,6 +8,8 @@ export const ExcelFormat = {
     name: 'Excel',
     id: 'excel',
     module: 'excel',
+    encoding: 'zip',
+    format: 'excel',
     extensions: ['xls', 'xlsb', 'xlsm', 'xlsx'],
     mimeTypes: [
         'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',

package/dist/excel-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"excel-format.js","sourceRoot":"","sources":["../src/excel-format.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,OAAO;IACb,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,OAAO;IACf,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3C,SAAS,EAAE;QACT,mEAAmE;QACnE,0BAA0B;KAC3B;IACD,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,IAAI;CACa,CAAC"}
+{"version":3,"file":"excel-format.js","sourceRoot":"","sources":["../src/excel-format.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,OAAO;IACb,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,OAAO;IACf,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAC3C,SAAS,EAAE;QACT,mEAAmE;QACnE,0BAA0B;KAC3B;IACD,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,IAAI;CACa,CAAC"}

package/dist/excel-loader-with-parser.d.ts

@@ -0,0 +1,60 @@
+import type { LoaderOptions } from '@loaders.gl/loader-utils';
+import type { ArrowTable, ObjectRowTable } from '@loaders.gl/schema';
+/** Options for parsing Excel worksheets. */
+export type ExcelLoaderOptions = LoaderOptions & {
+    /** Options for ExcelLoaderWithParser */
+    excel?: {
+        /** Selects row-table output or Apache Arrow output. */
+        shape?: /* 'array-row-table' | */ 'object-row-table' | 'arrow-table';
+        /** Specify which sheet to load, if omitted loads default sheet. */
+        sheet?: string;
+        /** Override the URL to the worker bundle (by default loads from unpkg.com). */
+        workerUrl?: string;
+    };
+};
+/** Worker loader for Excel files. */
+export declare const ExcelWorkerLoaderWithParser: {
+    readonly dataType: ObjectRowTable | ArrowTable;
+    readonly batchType: never;
+    readonly version: any;
+    readonly worker: true;
+    readonly options: {
+        readonly excel: {
+            readonly shape: "object-row-table";
+            readonly sheet: undefined;
+        };
+    };
+    readonly name: "Excel";
+    readonly id: "excel";
+    readonly module: "excel";
+    readonly encoding: "zip";
+    readonly format: "excel";
+    readonly extensions: ["xls", "xlsb", "xlsm", "xlsx"];
+    readonly mimeTypes: ["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel"];
+    readonly category: "table";
+    readonly binary: true;
+};
+/** Loader for Excel files. */
+export declare const ExcelLoaderWithParser: {
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: ExcelLoaderOptions) => Promise<ObjectRowTable | ArrowTable>;
+    readonly dataType: ObjectRowTable | ArrowTable;
+    readonly batchType: never;
+    readonly version: any;
+    readonly worker: true;
+    readonly options: {
+        readonly excel: {
+            readonly shape: "object-row-table";
+            readonly sheet: undefined;
+        };
+    };
+    readonly name: "Excel";
+    readonly id: "excel";
+    readonly module: "excel";
+    readonly encoding: "zip";
+    readonly format: "excel";
+    readonly extensions: ["xls", "xlsb", "xlsm", "xlsx"];
+    readonly mimeTypes: ["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel"];
+    readonly category: "table";
+    readonly binary: true;
+};
+//# sourceMappingURL=excel-loader-with-parser.d.ts.map

package/dist/excel-loader-with-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-loader-with-parser.d.ts","sourceRoot":"","sources":["../src/excel-loader-with-parser.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,aAAa,EAAC,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAC,UAAU,EAAE,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAUnE,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,wCAAwC;IACxC,KAAK,CAAC,EAAE;QACN,uDAAuD;QACvD,KAAK,CAAC,EAA4B,AAA1B,yBAAyB,CAAC,kBAAkB,GAAG,aAAa,CAAC;QACrE,mEAAmE;QACnE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,+EAA+E;QAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;CAE2C,CAAC;AAEpF,8BAA8B;AAC9B,eAAO,MAAM,qBAAqB;kCAGjB,WAAW,YACd,kBAAkB,KAC3B,OAAO,CAAC,cAAc,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;CAWoD,CAAC"}

package/dist/excel-loader-with-parser.js

@@ -0,0 +1,29 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { parseExcel } from "./lib/parse-excel.js";
+import { convertExcelRowsToArrowTable } from "./lib/convert-excel-rows-to-arrow.js";
+import { ExcelWorkerLoader as ExcelWorkerLoaderMetadata } from "./excel-loader.js";
+import { ExcelLoader as ExcelLoaderMetadata } from "./excel-loader.js";
+const { preload: _ExcelWorkerLoaderPreload, ...ExcelWorkerLoaderMetadataWithoutPreload } = ExcelWorkerLoaderMetadata;
+const { preload: _ExcelLoaderPreload, ...ExcelLoaderMetadataWithoutPreload } = ExcelLoaderMetadata;
+/** Worker loader for Excel files. */
+export const ExcelWorkerLoaderWithParser = {
+    ...ExcelWorkerLoaderMetadataWithoutPreload
+};
+/** Loader for Excel files. */
+export const ExcelLoaderWithParser = {
+    ...ExcelLoaderMetadataWithoutPreload,
+    async parse(arrayBuffer, options) {
+        const excelOptions = {
+            ...options,
+            excel: { ...ExcelLoaderWithParser.options.excel, ...options?.excel }
+        };
+        const rows = parseExcel(arrayBuffer, excelOptions);
+        if (excelOptions.excel?.shape === 'arrow-table') {
+            return convertExcelRowsToArrowTable(rows);
+        }
+        return { shape: 'object-row-table', data: rows };
+    }
+};
+//# sourceMappingURL=excel-loader-with-parser.js.map

package/dist/excel-loader-with-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-loader-with-parser.js","sourceRoot":"","sources":["../src/excel-loader-with-parser.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EAAC,UAAU,EAAC,6BAA0B;AAC7C,OAAO,EAAC,4BAA4B,EAAC,6CAA0C;AAC/E,OAAO,EAAC,iBAAiB,IAAI,yBAAyB,EAAC,0BAAuB;AAC9E,OAAO,EAAC,WAAW,IAAI,mBAAmB,EAAC,0BAAuB;AAElE,MAAM,EAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,uCAAuC,EAAC,GACpF,yBAAyB,CAAC;AAC5B,MAAM,EAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,iCAAiC,EAAC,GAAG,mBAAmB,CAAC;AAejG,qCAAqC;AACrC,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,GAAG,uCAAuC;CACuC,CAAC;AAEpF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,iCAAiC;IACpC,KAAK,CAAC,KAAK,CACT,WAAwB,EACxB,OAA4B;QAE5B,MAAM,YAAY,GAAG;YACnB,GAAG,OAAO;YACV,KAAK,EAAE,EAAC,GAAG,qBAAqB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,EAAE,KAAK,EAAC;SAC7C,CAAC;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACnD,IAAI,YAAY,CAAC,KAAK,EAAE,KAAK,KAAK,aAAa,EAAE,CAAC;YAChD,OAAO,4BAA4B,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,EAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC;IACjD,CAAC;CAC0F,CAAC"}

package/dist/excel-loader.d.ts

@@ -1,21 +1,43 @@
 import type { LoaderOptions } from '@loaders.gl/loader-utils';
-import type { ObjectRowTable } from '@loaders.gl/schema';
+import type { ArrowTable, ObjectRowTable } from '@loaders.gl/schema';
+/** Options for parsing Excel worksheets. */
 export type ExcelLoaderOptions = LoaderOptions & {
     /** Options for ExcelLoader */
     excel?: {
-        /** Format of returned data */
-        shape?: 'object-row-table';
-        /** Specify which sheet to load, if omitted loads default sheet */
+        /** Selects row-table output or Apache Arrow output. */
+        shape?: /* 'array-row-table' | */ 'object-row-table' | 'arrow-table';
+        /** Specify which sheet to load, if omitted loads default sheet. */
         sheet?: string;
-        /** Override the URL to the worker bundle (by default loads from unpkg.com) */
+        /** Override the URL to the worker bundle (by default loads from unpkg.com). */
         workerUrl?: string;
     };
 };
-/**
- * Worker Loader for Excel files
- */
+/** Preloads the parser-bearing Excel loader implementation. */
+declare function preload(): Promise<{
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: import("./excel-loader-with-parser").ExcelLoaderOptions) => Promise<ObjectRowTable | ArrowTable>;
+    readonly dataType: ObjectRowTable | ArrowTable;
+    readonly batchType: never;
+    readonly version: any;
+    readonly worker: true;
+    readonly options: {
+        readonly excel: {
+            readonly shape: "object-row-table";
+            readonly sheet: undefined;
+        };
+    };
+    readonly name: "Excel";
+    readonly id: "excel";
+    readonly module: "excel";
+    readonly encoding: "zip";
+    readonly format: "excel";
+    readonly extensions: ["xls", "xlsb", "xlsm", "xlsx"];
+    readonly mimeTypes: ["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel"];
+    readonly category: "table";
+    readonly binary: true;
+}>;
+/** Metadata-only worker loader for Excel files. */
 export declare const ExcelWorkerLoader: {
-    readonly dataType: ObjectRowTable;
+    readonly dataType: ObjectRowTable | ArrowTable;
     readonly batchType: never;
     readonly version: any;
     readonly worker: true;
@@ -25,20 +47,21 @@ export declare const ExcelWorkerLoader: {
             readonly sheet: undefined;
         };
     };
+    readonly preload: typeof preload;
     readonly name: "Excel";
     readonly id: "excel";
     readonly module: "excel";
+    readonly encoding: "zip";
+    readonly format: "excel";
     readonly extensions: ["xls", "xlsb", "xlsm", "xlsx"];
     readonly mimeTypes: ["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel"];
     readonly category: "table";
     readonly binary: true;
 };
-/**
- * Loader for Excel files
- */
+/** Metadata-only loader for Excel files. */
 export declare const ExcelLoader: {
-    readonly parse: (arrayBuffer: ArrayBuffer, options?: ExcelLoaderOptions) => Promise<ObjectRowTable>;
-    readonly dataType: ObjectRowTable;
+    readonly preload: typeof preload;
+    readonly dataType: ObjectRowTable | ArrowTable;
     readonly batchType: never;
     readonly version: any;
     readonly worker: true;
@@ -51,9 +74,12 @@ export declare const ExcelLoader: {
     readonly name: "Excel";
     readonly id: "excel";
     readonly module: "excel";
+    readonly encoding: "zip";
+    readonly format: "excel";
     readonly extensions: ["xls", "xlsb", "xlsm", "xlsx"];
     readonly mimeTypes: ["application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-excel"];
     readonly category: "table";
     readonly binary: true;
 };
+export {};
 //# sourceMappingURL=excel-loader.d.ts.map

package/dist/excel-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"excel-loader.d.ts","sourceRoot":"","sources":["../src/excel-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,aAAa,EAAC,MAAM,0BAA0B,CAAC;AACtF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAQvD,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,8BAA8B;IAC9B,KAAK,CAAC,EAAE;QACN,8BAA8B;QAC9B,KAAK,CAAC,EAA4B,kBAAkB,CAAC;QACrD,kEAAkE;QAClE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,8EAA8E;QAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB;uBAEC,cAAc;wBACxB,KAAK;;;;;;;;;;;;;;;;CAS4C,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,WAAW;kCAEG,WAAW,YAAY,kBAAkB,KAAG,OAAO,CAAC,cAAc,CAAC;uBAjB/D,cAAc;wBACxB,KAAK;;;;;;;;;;;;;;;;CAoBsD,CAAC"}
+{"version":3,"file":"excel-loader.d.ts","sourceRoot":"","sources":["../src/excel-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAS,aAAa,EAAC,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAC,UAAU,EAAE,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAOnE,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,8BAA8B;IAC9B,KAAK,CAAC,EAAE;QACN,uDAAuD;QACvD,KAAK,CAAC,EAA4B,AAA1B,yBAAyB,CAAC,kBAAkB,GAAG,aAAa,CAAC;QACrE,mEAAmE;QACnE,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,+EAA+E;QAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAEF,+DAA+D;AAC/D,iBAAe,OAAO;;uBAQS,cAAc,GAAG,UAAU;wBACrC,KAAK;;;;;;;;;;;;;;;;;;GANzB;AAED,mDAAmD;AACnD,eAAO,MAAM,iBAAiB;uBAEC,cAAc,GAAG,UAAU;wBACrC,KAAK;;;;;;;;;;;;;;;;;;;CAUyD,CAAC;AAEpF,4CAA4C;AAC5C,eAAO,MAAM,WAAW;;uBAdO,cAAc,GAAG,UAAU;wBACrC,KAAK;;;;;;;;;;;;;;;;;;CAgByD,CAAC"}

package/dist/excel-loader.js

@@ -1,14 +1,16 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-import { parseExcel } from "./lib/parse-excel.js";
 import { ExcelFormat } from "./excel-format.js";
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
-const VERSION = typeof "4.4.2" !== 'undefined' ? "4.4.2" : 'latest';
-/**
- * Worker Loader for Excel files
- */
+const VERSION = typeof "5.0.0-alpha.1" !== 'undefined' ? "5.0.0-alpha.1" : 'latest';
+/** Preloads the parser-bearing Excel loader implementation. */
+async function preload() {
+    const { ExcelLoaderWithParser } = await import("./excel-loader-with-parser.js");
+    return ExcelLoaderWithParser;
+}
+/** Metadata-only worker loader for Excel files. */
 export const ExcelWorkerLoader = {
     ...ExcelFormat,
     dataType: null,
@@ -20,16 +22,12 @@ export const ExcelWorkerLoader = {
             shape: 'object-row-table',
             sheet: undefined // Load default Sheet
         }
-    }
+    },
+    preload
 };
-/**
- * Loader for Excel files
- */
+/** Metadata-only loader for Excel files. */
 export const ExcelLoader = {
     ...ExcelWorkerLoader,
-    async parse(arrayBuffer, options) {
-        const data = parseExcel(arrayBuffer, options);
-        return { shape: 'object-row-table', data };
-    }
+    preload
 };
 //# sourceMappingURL=excel-loader.js.map

package/dist/excel-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"excel-loader.js","sourceRoot":"","sources":["../src/excel-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EAAC,UAAU,EAAC,6BAA0B;AAC7C,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAE3C,yDAAyD;AACzD,qDAAqD;AACrD,MAAM,OAAO,GAAG,cAAkB,KAAK,WAAW,CAAC,CAAC,SAAa,CAAC,CAAC,QAAQ,CAAC;AAc5E;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,WAAW;IACd,QAAQ,EAAE,IAAiC;IAC3C,SAAS,EAAE,IAAa;IACxB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE;QACP,KAAK,EAAE;YACL,KAAK,EAAE,kBAAkB;YACzB,KAAK,EAAE,SAAS,CAAC,qBAAqB;SACvC;KACF;CACmE,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,iBAAiB;IACpB,KAAK,CAAC,KAAK,CAAC,WAAwB,EAAE,OAA4B;QAChE,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,EAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAC,CAAC;IAC3C,CAAC;CAC6E,CAAC"}
+{"version":3,"file":"excel-loader.js","sourceRoot":"","sources":["../src/excel-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAE3C,yDAAyD;AACzD,qDAAqD;AACrD,MAAM,OAAO,GAAG,sBAAkB,KAAK,WAAW,CAAC,CAAC,iBAAa,CAAC,CAAC,QAAQ,CAAC;AAe5E,+DAA+D;AAC/D,KAAK,UAAU,OAAO;IACpB,MAAM,EAAC,qBAAqB,EAAC,GAAG,MAAM,MAAM,iCAA8B,CAAC;IAC3E,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,WAAW;IACd,QAAQ,EAAE,IAA8C;IACxD,SAAS,EAAE,IAAa;IACxB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE;QACP,KAAK,EAAE;YACL,KAAK,EAAE,kBAAkB;YACzB,KAAK,EAAE,SAAS,CAAC,qBAAqB;SACvC;KACF;IACD,OAAO;CAC0E,CAAC;AAEpF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,iBAAiB;IACpB,OAAO;CAC0E,CAAC"}