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

package/dist/index.cjs

@@ -1,8 +1,13 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -15,34 +20,39 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// dist/index.js
-var dist_exports = {};
-__export(dist_exports, {
-  ExcelFormat: () => ExcelFormat,
-  ExcelLoader: () => ExcelLoader,
-  ExcelWorkerLoader: () => ExcelWorkerLoader
-});
-module.exports = __toCommonJS(dist_exports);
-
 // dist/excel-format.js
-var ExcelFormat = {
-  name: "Excel",
-  id: "excel",
-  module: "excel",
-  extensions: ["xls", "xlsb", "xlsm", "xlsx"],
-  mimeTypes: [
-    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-    "application/vnd.ms-excel"
-  ],
-  category: "table",
-  binary: true
-};
+var ExcelFormat;
+var init_excel_format = __esm({
+  "dist/excel-format.js"() {
+    "use strict";
+    ExcelFormat = {
+      name: "Excel",
+      id: "excel",
+      module: "excel",
+      encoding: "zip",
+      format: "excel",
+      extensions: ["xls", "xlsb", "xlsm", "xlsx"],
+      mimeTypes: [
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        "application/vnd.ms-excel"
+      ],
+      category: "table",
+      binary: true
+    };
+  }
+});
 
 // dist/lib/parse-excel.js
-var import_xlsx = require("xlsx");
-var dataTableNamesMap = {};
 function parseExcel(arrayBuffer, options) {
   var _a, _b, _c;
   const dataUrl = "dummy";
@@ -65,28 +75,150 @@ function parseExcel(arrayBuffer, options) {
   }
   return dataRows;
 }
+var import_xlsx, dataTableNamesMap;
+var init_parse_excel = __esm({
+  "dist/lib/parse-excel.js"() {
+    "use strict";
+    import_xlsx = require("xlsx");
+    dataTableNamesMap = {};
+  }
+});
 
-// dist/excel-loader.js
-var VERSION = true ? "4.4.2" : "latest";
-var ExcelWorkerLoader = {
-  ...ExcelFormat,
-  dataType: null,
-  batchType: null,
-  version: VERSION,
-  worker: true,
-  options: {
-    excel: {
-      shape: "object-row-table",
-      sheet: void 0
-      // Load default Sheet
+// dist/lib/convert-excel-rows-to-arrow.js
+function convertExcelRowsToArrowTable(rows) {
+  const table = rows.length > 0 ? (0, import_schema_utils.makeTableFromData)(rows) : { shape: "object-row-table", schema: { fields: [], metadata: {} }, data: rows };
+  const schema = deducePrimitiveAwareSchema(table);
+  if (table.data.length === 0 || schema.fields.length === 0) {
+    return {
+      shape: "arrow-table",
+      schema,
+      data: new arrow.Table(new arrow.Schema([]))
+    };
+  }
+  const arrowTableBuilder = new import_schema_utils.ArrowTableBuilder(schema);
+  for (const row of table.data) {
+    arrowTableBuilder.addObjectRow(row);
+  }
+  return arrowTableBuilder.finishTable();
+}
+function deducePrimitiveAwareSchema(table) {
+  const fields = table.schema.fields.map((field) => {
+    if (field.type === "float32") {
+      return { ...field, type: "float64" };
+    }
+    if (field.type !== "null") {
+      return field;
+    }
+    for (const row of table.data) {
+      const type = getDataTypeFromPrimitive(row[field.name]);
+      if (type !== "null") {
+        return { ...field, type };
+      }
     }
+    return field;
+  });
+  return { ...table.schema, fields };
+}
+function getDataTypeFromPrimitive(value) {
+  switch (typeof value) {
+    case "number":
+      return "float64";
+    case "boolean":
+      return "bool";
+    case "string":
+      return "utf8";
+    default:
+      return value instanceof Date ? "date-millisecond" : "null";
   }
-};
-var ExcelLoader = {
-  ...ExcelWorkerLoader,
-  async parse(arrayBuffer, options) {
-    const data = parseExcel(arrayBuffer, options);
-    return { shape: "object-row-table", data };
+}
+var import_schema_utils, arrow;
+var init_convert_excel_rows_to_arrow = __esm({
+  "dist/lib/convert-excel-rows-to-arrow.js"() {
+    "use strict";
+    import_schema_utils = require("@loaders.gl/schema-utils");
+    arrow = __toESM(require("apache-arrow"), 1);
   }
-};
+});
+
+// dist/excel-loader-with-parser.js
+var excel_loader_with_parser_exports = {};
+__export(excel_loader_with_parser_exports, {
+  ExcelLoaderWithParser: () => ExcelLoaderWithParser,
+  ExcelWorkerLoaderWithParser: () => ExcelWorkerLoaderWithParser
+});
+var _ExcelWorkerLoaderPreload, ExcelWorkerLoaderMetadataWithoutPreload, _ExcelLoaderPreload, ExcelLoaderMetadataWithoutPreload, ExcelWorkerLoaderWithParser, ExcelLoaderWithParser;
+var init_excel_loader_with_parser = __esm({
+  "dist/excel-loader-with-parser.js"() {
+    "use strict";
+    init_parse_excel();
+    init_convert_excel_rows_to_arrow();
+    init_excel_loader();
+    init_excel_loader();
+    ({ preload: _ExcelWorkerLoaderPreload, ...ExcelWorkerLoaderMetadataWithoutPreload } = ExcelWorkerLoader);
+    ({ preload: _ExcelLoaderPreload, ...ExcelLoaderMetadataWithoutPreload } = ExcelLoader);
+    ExcelWorkerLoaderWithParser = {
+      ...ExcelWorkerLoaderMetadataWithoutPreload
+    };
+    ExcelLoaderWithParser = {
+      ...ExcelLoaderMetadataWithoutPreload,
+      async parse(arrayBuffer, options) {
+        var _a;
+        const excelOptions = {
+          ...options,
+          excel: { ...ExcelLoaderWithParser.options.excel, ...options == null ? void 0 : options.excel }
+        };
+        const rows = parseExcel(arrayBuffer, excelOptions);
+        if (((_a = excelOptions.excel) == null ? void 0 : _a.shape) === "arrow-table") {
+          return convertExcelRowsToArrowTable(rows);
+        }
+        return { shape: "object-row-table", data: rows };
+      }
+    };
+  }
+});
+
+// dist/excel-loader.js
+async function preload() {
+  const { ExcelLoaderWithParser: ExcelLoaderWithParser2 } = await Promise.resolve().then(() => (init_excel_loader_with_parser(), excel_loader_with_parser_exports));
+  return ExcelLoaderWithParser2;
+}
+var VERSION, ExcelWorkerLoader, ExcelLoader;
+var init_excel_loader = __esm({
+  "dist/excel-loader.js"() {
+    "use strict";
+    init_excel_format();
+    VERSION = true ? "5.0.0-alpha.1" : "latest";
+    ExcelWorkerLoader = {
+      ...ExcelFormat,
+      dataType: null,
+      batchType: null,
+      version: VERSION,
+      worker: true,
+      options: {
+        excel: {
+          shape: "object-row-table",
+          sheet: void 0
+          // Load default Sheet
+        }
+      },
+      preload
+    };
+    ExcelLoader = {
+      ...ExcelWorkerLoader,
+      preload
+    };
+  }
+});
+
+// dist/index.js
+var dist_exports = {};
+__export(dist_exports, {
+  ExcelFormat: () => ExcelFormat,
+  ExcelLoader: () => ExcelLoader,
+  ExcelWorkerLoader: () => ExcelWorkerLoader
+});
+module.exports = __toCommonJS(dist_exports);
+init_excel_format();
+init_excel_loader();
+init_excel_loader();
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/index.ts", "../src/excel-format.ts", "../src/lib/parse-excel.ts", "../src/excel-loader.ts"],
-  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n// Excel Loader\n\nexport {ExcelFormat} from './excel-format';\nexport type {ExcelLoaderOptions} from './excel-loader';\nexport {ExcelLoader, ExcelWorkerLoader} from './excel-loader';\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {Format} from '@loaders.gl/loader-utils';\n\n/**\n * Excel files\n */\nexport const ExcelFormat = {\n  name: 'Excel',\n  id: 'excel',\n  module: 'excel',\n  extensions: ['xls', 'xlsb', 'xlsm', 'xlsx'],\n  mimeTypes: [\n    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    'application/vnd.ms-excel'\n  ],\n  category: 'table',\n  binary: true\n} as const satisfies Format;\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {ExcelLoaderOptions} from '../excel-loader';\nimport {utils, read} from 'xlsx';\n// import {convertToArrayRow} from '@loaders.gl/schema';\n\n// local table names cache with dataUrl/tableNames array key/values\nconst dataTableNamesMap = {};\n\n/**\n * Gets local or remote Excel file data.\n * @param arrayBuffer Loaded data\n * @param options Data parse options.\n */\nexport function parseExcel(\n  arrayBuffer: ArrayBuffer,\n  options?: ExcelLoaderOptions\n): {[key: string]: unknown}[] {\n  const dataUrl = 'dummy';\n  // const dataFileType: string = dataUrl.substr(dataUrl.lastIndexOf('.')); // file extension\n\n  // create Excel 'workbook'\n  const workbook = read(arrayBuffer, {\n    type: 'array'\n    // cellDates: true\n  });\n\n  // load data sheets\n  let dataRows: {[key: string]: unknown}[] = [];\n  dataTableNamesMap[dataUrl] = [];\n  if (workbook.SheetNames.length > 0) {\n    if (workbook.SheetNames.length > 1) {\n      // cache sheet names\n      dataTableNamesMap[dataUrl] = workbook.SheetNames;\n      // eslint-ignore-next-line\n      // console.debug(`getData(): file:  sheetNames:`, workbook.SheetNames);\n    }\n\n    // determine spreadsheet to load\n    let sheetName = workbook.SheetNames[0];\n    if (options?.excel?.sheet && workbook.SheetNames.indexOf(options?.excel?.sheet) >= 0) {\n      // reset to requested table name\n      sheetName = options?.excel?.sheet;\n    }\n\n    // get worksheet data row objects array\n    const worksheet = workbook.Sheets[sheetName];\n    dataRows = utils.sheet_to_json(worksheet);\n\n    // const headers = dataRows.length ? Object.keys(dataRows[0]) : [];\n    // if (options?.excel?.type === 'array-row-table') {\n    //   dataRows = dataRows.map(row => convertToArrayRow(row, headers))\n    // }\n  }\n\n  return dataRows;\n}\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {Loader, LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';\nimport type {ObjectRowTable} from '@loaders.gl/schema';\nimport {parseExcel} from './lib/parse-excel';\nimport {ExcelFormat} from './excel-format';\n\n// __VERSION__ is injected by babel-plugin-version-inline\n// @ts-ignore TS2304: Cannot find name '__VERSION__'.\nconst VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';\n\nexport type ExcelLoaderOptions = LoaderOptions & {\n  /** Options for ExcelLoader */\n  excel?: {\n    /** Format of returned data */\n    shape?: /* 'array-row-table' | */ 'object-row-table';\n    /** Specify which sheet to load, if omitted loads default sheet */\n    sheet?: string;\n    /** Override the URL to the worker bundle (by default loads from unpkg.com) */\n    workerUrl?: string;\n  };\n};\n\n/**\n * Worker Loader for Excel files\n */\nexport const ExcelWorkerLoader = {\n  ...ExcelFormat,\n  dataType: null as unknown as ObjectRowTable,\n  batchType: null as never,\n  version: VERSION,\n  worker: true,\n  options: {\n    excel: {\n      shape: 'object-row-table',\n      sheet: undefined // Load default Sheet\n    }\n  }\n} as const satisfies Loader<ObjectRowTable, never, ExcelLoaderOptions>;\n\n/**\n * Loader for Excel files\n */\nexport const ExcelLoader = {\n  ...ExcelWorkerLoader,\n  async parse(arrayBuffer: ArrayBuffer, options?: ExcelLoaderOptions): Promise<ObjectRowTable> {\n    const data = parseExcel(arrayBuffer, options);\n    return {shape: 'object-row-table', data};\n  }\n} as const satisfies LoaderWithParser<ObjectRowTable, never, ExcelLoaderOptions>;\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;ACSO,IAAM,cAAc;EACzB,MAAM;EACN,IAAI;EACJ,QAAQ;EACR,YAAY,CAAC,OAAO,QAAQ,QAAQ,MAAM;EAC1C,WAAW;IACT;IACA;;EAEF,UAAU;EACV,QAAQ;;;;ACdV,kBAA0B;AAI1B,IAAM,oBAAoB,CAAA;AAOpB,SAAU,WACd,aACA,SAA4B;AAlB9B;AAoBE,QAAM,UAAU;AAIhB,QAAM,eAAW,kBAAK,aAAa;IACjC,MAAM;;GAEP;AAGD,MAAI,WAAuC,CAAA;AAC3C,oBAAkB,OAAO,IAAI,CAAA;AAC7B,MAAI,SAAS,WAAW,SAAS,GAAG;AAClC,QAAI,SAAS,WAAW,SAAS,GAAG;AAElC,wBAAkB,OAAO,IAAI,SAAS;IAGxC;AAGA,QAAI,YAAY,SAAS,WAAW,CAAC;AACrC,UAAI,wCAAS,UAAT,mBAAgB,UAAS,SAAS,WAAW,SAAQ,wCAAS,UAAT,mBAAgB,KAAK,KAAK,GAAG;AAEpF,mBAAY,wCAAS,UAAT,mBAAgB;IAC9B;AAGA,UAAM,YAAY,SAAS,OAAO,SAAS;AAC3C,eAAW,kBAAM,cAAc,SAAS;EAM1C;AAEA,SAAO;AACT;;;AC/CA,IAAM,UAAU,OAAoC,UAAe;AAiB5D,IAAM,oBAAoB;EAC/B,GAAG;EACH,UAAU;EACV,WAAW;EACX,SAAS;EACT,QAAQ;EACR,SAAS;IACP,OAAO;MACL,OAAO;MACP,OAAO;;;;;AAQN,IAAM,cAAc;EACzB,GAAG;EACH,MAAM,MAAM,aAA0B,SAA4B;AAChE,UAAM,OAAO,WAAW,aAAa,OAAO;AAC5C,WAAO,EAAC,OAAO,oBAAoB,KAAI;EACzC;;",
-  "names": []
+  "sources": ["../src/excel-format.ts", "../src/lib/parse-excel.ts", "../src/lib/convert-excel-rows-to-arrow.ts", "../src/excel-loader-with-parser.ts", "../src/excel-loader.ts", "../src/index.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {Format} from '@loaders.gl/loader-utils';\n\n/**\n * Excel files\n */\nexport const ExcelFormat = {\n  name: 'Excel',\n  id: 'excel',\n  module: 'excel',\n  encoding: 'zip',\n  format: 'excel',\n  extensions: ['xls', 'xlsb', 'xlsm', 'xlsx'],\n  mimeTypes: [\n    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    'application/vnd.ms-excel'\n  ],\n  category: 'table',\n  binary: true\n} as const satisfies Format;\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {ExcelLoaderOptions} from '../excel-loader';\nimport {utils, read} from 'xlsx';\n// import {convertToArrayRow} from '@loaders.gl/schema';\n\n// local table names cache with dataUrl/tableNames array key/values\nconst dataTableNamesMap = {};\n\n/**\n * Gets local or remote Excel file data.\n * @param arrayBuffer Loaded data\n * @param options Data parse options.\n */\nexport function parseExcel(\n  arrayBuffer: ArrayBuffer,\n  options?: ExcelLoaderOptions\n): {[key: string]: unknown}[] {\n  const dataUrl = 'dummy';\n  // const dataFileType: string = dataUrl.substr(dataUrl.lastIndexOf('.')); // file extension\n\n  // create Excel 'workbook'\n  const workbook = read(arrayBuffer, {\n    type: 'array'\n    // cellDates: true\n  });\n\n  // load data sheets\n  let dataRows: {[key: string]: unknown}[] = [];\n  dataTableNamesMap[dataUrl] = [];\n  if (workbook.SheetNames.length > 0) {\n    if (workbook.SheetNames.length > 1) {\n      // cache sheet names\n      dataTableNamesMap[dataUrl] = workbook.SheetNames;\n      // eslint-ignore-next-line\n      // console.debug(`getData(): file:  sheetNames:`, workbook.SheetNames);\n    }\n\n    // determine spreadsheet to load\n    let sheetName = workbook.SheetNames[0];\n    if (options?.excel?.sheet && workbook.SheetNames.indexOf(options?.excel?.sheet) >= 0) {\n      // reset to requested table name\n      sheetName = options?.excel?.sheet;\n    }\n\n    // get worksheet data row objects array\n    const worksheet = workbook.Sheets[sheetName];\n    dataRows = utils.sheet_to_json(worksheet);\n\n    // const headers = dataRows.length ? Object.keys(dataRows[0]) : [];\n    // if (options?.excel?.type === 'array-row-table') {\n    //   dataRows = dataRows.map(row => convertToArrayRow(row, headers))\n    // }\n  }\n\n  return dataRows;\n}\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {ArrowTable, DataType, Field, ObjectRowTable, Schema} from '@loaders.gl/schema';\nimport {ArrowTableBuilder, makeTableFromData} from '@loaders.gl/schema-utils';\nimport * as arrow from 'apache-arrow';\n\n/**\n * Converts parsed Excel rows to an Arrow table, including empty sheets.\n *\n * @param rows - Parsed Excel rows keyed by worksheet column name.\n * @returns A loaders.gl Arrow table with one Apache Arrow column per row property.\n */\nexport function convertExcelRowsToArrowTable(rows: {[key: string]: unknown}[]): ArrowTable {\n  const table: ObjectRowTable =\n    rows.length > 0\n      ? makeTableFromData(rows)\n      : {shape: 'object-row-table', schema: {fields: [], metadata: {}}, data: rows};\n  const schema = deducePrimitiveAwareSchema(table);\n\n  if (table.data.length === 0 || schema.fields.length === 0) {\n    return {\n      shape: 'arrow-table',\n      schema,\n      data: new arrow.Table(new arrow.Schema([]))\n    };\n  }\n\n  const arrowTableBuilder = new ArrowTableBuilder(schema);\n  for (const row of table.data) {\n    arrowTableBuilder.addObjectRow(row);\n  }\n  return arrowTableBuilder.finishTable();\n}\n\n/**\n * Deduces a schema that handles primitive numbers and booleans in Excel rows.\n *\n * @param table - Object-row table produced from parsed Excel rows.\n * @returns A schema with primitive values promoted from `null` to Arrow-compatible types.\n */\nfunction deducePrimitiveAwareSchema(table: ObjectRowTable): Schema {\n  const fields = table.schema!.fields.map((field): Field => {\n    if (field.type === 'float32') {\n      return {...field, type: 'float64'};\n    }\n\n    if (field.type !== 'null') {\n      return field;\n    }\n\n    for (const row of table.data) {\n      const type = getDataTypeFromPrimitive(row[field.name]);\n      if (type !== 'null') {\n        return {...field, type};\n      }\n    }\n\n    return field;\n  });\n\n  return {...table.schema!, fields};\n}\n\n/**\n * Deduces a loaders.gl data type from primitive spreadsheet cell values.\n *\n * @param value - Spreadsheet cell value.\n * @returns The matching loaders.gl data type, or `null` for unsupported values.\n */\nfunction getDataTypeFromPrimitive(value: unknown): DataType {\n  switch (typeof value) {\n    case 'number':\n      return 'float64';\n    case 'boolean':\n      return 'bool';\n    case 'string':\n      return 'utf8';\n    default:\n      return value instanceof Date ? 'date-millisecond' : 'null';\n  }\n}\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {Loader, LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';\nimport type {ArrowTable, ObjectRowTable} from '@loaders.gl/schema';\nimport {parseExcel} from './lib/parse-excel';\nimport {convertExcelRowsToArrowTable} from './lib/convert-excel-rows-to-arrow';\nimport {ExcelWorkerLoader as ExcelWorkerLoaderMetadata} from './excel-loader';\nimport {ExcelLoader as ExcelLoaderMetadata} from './excel-loader';\n\nconst {preload: _ExcelWorkerLoaderPreload, ...ExcelWorkerLoaderMetadataWithoutPreload} =\n  ExcelWorkerLoaderMetadata;\nconst {preload: _ExcelLoaderPreload, ...ExcelLoaderMetadataWithoutPreload} = ExcelLoaderMetadata;\n\n/** Options for parsing Excel worksheets. */\nexport type ExcelLoaderOptions = LoaderOptions & {\n  /** Options for ExcelLoaderWithParser */\n  excel?: {\n    /** Selects row-table output or Apache Arrow output. */\n    shape?: /* 'array-row-table' | */ 'object-row-table' | 'arrow-table';\n    /** Specify which sheet to load, if omitted loads default sheet. */\n    sheet?: string;\n    /** Override the URL to the worker bundle (by default loads from unpkg.com). */\n    workerUrl?: string;\n  };\n};\n\n/** Worker loader for Excel files. */\nexport const ExcelWorkerLoaderWithParser = {\n  ...ExcelWorkerLoaderMetadataWithoutPreload\n} as const satisfies Loader<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;\n\n/** Loader for Excel files. */\nexport const ExcelLoaderWithParser = {\n  ...ExcelLoaderMetadataWithoutPreload,\n  async parse(\n    arrayBuffer: ArrayBuffer,\n    options?: ExcelLoaderOptions\n  ): Promise<ObjectRowTable | ArrowTable> {\n    const excelOptions = {\n      ...options,\n      excel: {...ExcelLoaderWithParser.options.excel, ...options?.excel}\n    } as ExcelLoaderOptions;\n    const rows = parseExcel(arrayBuffer, excelOptions);\n    if (excelOptions.excel?.shape === 'arrow-table') {\n      return convertExcelRowsToArrowTable(rows);\n    }\n    return {shape: 'object-row-table', data: rows};\n  }\n} as const satisfies LoaderWithParser<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {Loader, LoaderOptions} from '@loaders.gl/loader-utils';\nimport type {ArrowTable, ObjectRowTable} from '@loaders.gl/schema';\nimport {ExcelFormat} from './excel-format';\n\n// __VERSION__ is injected by babel-plugin-version-inline\n// @ts-ignore TS2304: Cannot find name '__VERSION__'.\nconst VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';\n\n/** Options for parsing Excel worksheets. */\nexport type ExcelLoaderOptions = LoaderOptions & {\n  /** Options for ExcelLoader */\n  excel?: {\n    /** Selects row-table output or Apache Arrow output. */\n    shape?: /* 'array-row-table' | */ 'object-row-table' | 'arrow-table';\n    /** Specify which sheet to load, if omitted loads default sheet. */\n    sheet?: string;\n    /** Override the URL to the worker bundle (by default loads from unpkg.com). */\n    workerUrl?: string;\n  };\n};\n\n/** Preloads the parser-bearing Excel loader implementation. */\nasync function preload() {\n  const {ExcelLoaderWithParser} = await import('./excel-loader-with-parser');\n  return ExcelLoaderWithParser;\n}\n\n/** Metadata-only worker loader for Excel files. */\nexport const ExcelWorkerLoader = {\n  ...ExcelFormat,\n  dataType: null as unknown as ObjectRowTable | ArrowTable,\n  batchType: null as never,\n  version: VERSION,\n  worker: true,\n  options: {\n    excel: {\n      shape: 'object-row-table',\n      sheet: undefined // Load default Sheet\n    }\n  },\n  preload\n} as const satisfies Loader<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;\n\n/** Metadata-only loader for Excel files. */\nexport const ExcelLoader = {\n  ...ExcelWorkerLoader,\n  preload\n} as const satisfies Loader<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;\n", "// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n// Excel Loader\n\nexport {ExcelFormat} from './excel-format';\nexport type {ExcelLoaderOptions} from './excel-loader';\nexport {ExcelLoader} from './excel-loader';\n\n// DEPRECATED EXPORTS\n/** @deprecated Use ExcelLoader. */\nexport {ExcelWorkerLoader} from './excel-loader';\n"],
+  "mappings": "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",
+  "names": ["ExcelLoaderWithParser"]
 }

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { ExcelFormat } from "./excel-format.js";
 export type { ExcelLoaderOptions } from "./excel-loader.js";
-export { ExcelLoader, ExcelWorkerLoader } from "./excel-loader.js";
+export { ExcelLoader } from "./excel-loader.js";
+/** @deprecated Use ExcelLoader. */
+export { ExcelWorkerLoader } from "./excel-loader.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAC3C,YAAY,EAAC,kBAAkB,EAAC,0BAAuB;AACvD,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAC,0BAAuB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAC3C,YAAY,EAAC,kBAAkB,EAAC,0BAAuB;AACvD,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAG3C,mCAAmC;AACnC,OAAO,EAAC,iBAAiB,EAAC,0BAAuB"}

package/dist/index.js

@@ -3,5 +3,8 @@
 // Copyright (c) vis.gl contributors
 // Excel Loader
 export { ExcelFormat } from "./excel-format.js";
-export { ExcelLoader, ExcelWorkerLoader } from "./excel-loader.js";
+export { ExcelLoader } from "./excel-loader.js";
+// DEPRECATED EXPORTS
+/** @deprecated Use ExcelLoader. */
+export { ExcelWorkerLoader } from "./excel-loader.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,eAAe;AAEf,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAE3C,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAC,0BAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,eAAe;AAEf,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAE3C,OAAO,EAAC,WAAW,EAAC,0BAAuB;AAE3C,qBAAqB;AACrB,mCAAmC;AACnC,OAAO,EAAC,iBAAiB,EAAC,0BAAuB"}

package/dist/lib/convert-excel-rows-to-arrow.d.ts

@@ -0,0 +1,11 @@
+import type { ArrowTable } from '@loaders.gl/schema';
+/**
+ * Converts parsed Excel rows to an Arrow table, including empty sheets.
+ *
+ * @param rows - Parsed Excel rows keyed by worksheet column name.
+ * @returns A loaders.gl Arrow table with one Apache Arrow column per row property.
+ */
+export declare function convertExcelRowsToArrowTable(rows: {
+    [key: string]: unknown;
+}[]): ArrowTable;
+//# sourceMappingURL=convert-excel-rows-to-arrow.d.ts.map

package/dist/lib/convert-excel-rows-to-arrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-excel-rows-to-arrow.d.ts","sourceRoot":"","sources":["../../src/lib/convert-excel-rows-to-arrow.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAA0C,MAAM,oBAAoB,CAAC;AAI5F;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAC,EAAE,GAAG,UAAU,CAoBzF"}

package/dist/lib/convert-excel-rows-to-arrow.js

@@ -0,0 +1,72 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ArrowTableBuilder, makeTableFromData } from '@loaders.gl/schema-utils';
+import * as arrow from 'apache-arrow';
+/**
+ * Converts parsed Excel rows to an Arrow table, including empty sheets.
+ *
+ * @param rows - Parsed Excel rows keyed by worksheet column name.
+ * @returns A loaders.gl Arrow table with one Apache Arrow column per row property.
+ */
+export function convertExcelRowsToArrowTable(rows) {
+    const table = rows.length > 0
+        ? makeTableFromData(rows)
+        : { shape: 'object-row-table', schema: { fields: [], metadata: {} }, data: rows };
+    const schema = deducePrimitiveAwareSchema(table);
+    if (table.data.length === 0 || schema.fields.length === 0) {
+        return {
+            shape: 'arrow-table',
+            schema,
+            data: new arrow.Table(new arrow.Schema([]))
+        };
+    }
+    const arrowTableBuilder = new ArrowTableBuilder(schema);
+    for (const row of table.data) {
+        arrowTableBuilder.addObjectRow(row);
+    }
+    return arrowTableBuilder.finishTable();
+}
+/**
+ * Deduces a schema that handles primitive numbers and booleans in Excel rows.
+ *
+ * @param table - Object-row table produced from parsed Excel rows.
+ * @returns A schema with primitive values promoted from `null` to Arrow-compatible types.
+ */
+function deducePrimitiveAwareSchema(table) {
+    const fields = table.schema.fields.map((field) => {
+        if (field.type === 'float32') {
+            return { ...field, type: 'float64' };
+        }
+        if (field.type !== 'null') {
+            return field;
+        }
+        for (const row of table.data) {
+            const type = getDataTypeFromPrimitive(row[field.name]);
+            if (type !== 'null') {
+                return { ...field, type };
+            }
+        }
+        return field;
+    });
+    return { ...table.schema, fields };
+}
+/**
+ * Deduces a loaders.gl data type from primitive spreadsheet cell values.
+ *
+ * @param value - Spreadsheet cell value.
+ * @returns The matching loaders.gl data type, or `null` for unsupported values.
+ */
+function getDataTypeFromPrimitive(value) {
+    switch (typeof value) {
+        case 'number':
+            return 'float64';
+        case 'boolean':
+            return 'bool';
+        case 'string':
+            return 'utf8';
+        default:
+            return value instanceof Date ? 'date-millisecond' : 'null';
+    }
+}
+//# sourceMappingURL=convert-excel-rows-to-arrow.js.map

package/dist/lib/convert-excel-rows-to-arrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-excel-rows-to-arrow.js","sourceRoot":"","sources":["../../src/lib/convert-excel-rows-to-arrow.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAgC;IAC3E,MAAM,KAAK,GACT,IAAI,CAAC,MAAM,GAAG,CAAC;QACb,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,EAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,EAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAC,EAAE,IAAI,EAAE,IAAI,EAAC,CAAC;IAClF,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAEjD,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,MAAM;YACN,IAAI,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC5C,CAAC;IACJ,CAAC;IAED,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,iBAAiB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,iBAAiB,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,SAAS,0BAA0B,CAAC,KAAqB;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAS,EAAE;QACvD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,EAAC,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,EAAC,CAAC;QACrC,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACvD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,EAAC,GAAG,KAAK,EAAE,IAAI,EAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,OAAO,EAAC,GAAG,KAAK,CAAC,MAAO,EAAE,MAAM,EAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,SAAS,wBAAwB,CAAC,KAAc;IAC9C,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/unbundled.d.ts

@@ -0,0 +1,3 @@
+export type { ExcelLoaderOptions } from "./excel-loader.js";
+export { ExcelLoader, ExcelWorkerLoader } from "./excel-loader.js";
+//# sourceMappingURL=unbundled.d.ts.map

package/dist/unbundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unbundled.d.ts","sourceRoot":"","sources":["../src/unbundled.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,kBAAkB,EAAC,0BAAuB;AACvD,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAC,0BAAuB"}

package/dist/unbundled.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export { ExcelLoader, ExcelWorkerLoader } from "./excel-loader.js";
+//# sourceMappingURL=unbundled.js.map

package/dist/unbundled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unbundled.js","sourceRoot":"","sources":["../src/unbundled.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,WAAW,EAAE,iBAAiB,EAAC,0BAAuB"}

package/dist/workers/excel-worker.js

@@ -1,4 +1,4 @@
 import { createLoaderWorker } from '@loaders.gl/loader-utils';
-import { ExcelLoader } from "../index.js";
-createLoaderWorker(ExcelLoader);
+import { ExcelLoaderWithParser } from "../excel-loader-with-parser.js";
+createLoaderWorker(ExcelLoaderWithParser);
 //# sourceMappingURL=excel-worker.js.map

package/dist/workers/excel-worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"excel-worker.js","sourceRoot":"","sources":["../../src/workers/excel-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAC,WAAW,EAAC,oBAAiB;AAErC,kBAAkB,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"excel-worker.js","sourceRoot":"","sources":["../../src/workers/excel-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAC,qBAAqB,EAAC,uCAAoC;AAElE,kBAAkB,CAAC,qBAAqB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/excel",
-  "version": "4.4.2",
+  "version": "5.0.0-alpha.1",
   "description": "Framework-independent loader for Excel files",
   "license": "MIT",
   "type": "module",
@@ -30,6 +30,14 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./unbundled": {
+      "types": "./dist/unbundled.d.ts",
+      "import": "./dist/unbundled.js"
+    },
+    "./bundled": {
+      "types": "./dist/bundled.d.ts",
+      "import": "./dist/bundled.js"
+    },
     "./excel-worker.js": {
       "import": "./dist/excel-worker.js"
     }
@@ -47,12 +55,14 @@
     "build-worker": "esbuild src/workers/excel-worker.ts --bundle --outfile=dist/excel-worker.js --define:__VERSION__=\\\"$npm_package_version\\\""
   },
   "dependencies": {
-    "@loaders.gl/loader-utils": "4.4.2",
-    "@loaders.gl/schema": "4.4.2",
+    "@loaders.gl/loader-utils": "5.0.0-alpha.1",
+    "@loaders.gl/schema": "5.0.0-alpha.1",
+    "@loaders.gl/schema-utils": "5.0.0-alpha.1",
+    "apache-arrow": ">= 17.0.0",
     "xlsx": "^0.18.5"
   },
   "peerDependencies": {
-    "@loaders.gl/core": "~4.4.0"
+    "@loaders.gl/core": "~5.0.0-alpha.0"
   },
-  "gitHead": "1c9649781db0403dbf7c3f1224bbeec77bd812eb"
+  "gitHead": "77a55028e8204e09df1258f10cb61ed35353b258"
 }

package/src/bundled.ts

@@ -0,0 +1,9 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export type {ExcelLoaderOptions} from './excel-loader-with-parser';
+export {
+  ExcelLoaderWithParser as ExcelLoader,
+  ExcelWorkerLoaderWithParser as ExcelWorkerLoader
+} from './excel-loader-with-parser';

package/src/excel-format.ts

@@ -11,6 +11,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/src/excel-loader-with-parser.ts

@@ -0,0 +1,51 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Loader, LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';
+import type {ArrowTable, ObjectRowTable} from '@loaders.gl/schema';
+import {parseExcel} from './lib/parse-excel';
+import {convertExcelRowsToArrowTable} from './lib/convert-excel-rows-to-arrow';
+import {ExcelWorkerLoader as ExcelWorkerLoaderMetadata} from './excel-loader';
+import {ExcelLoader as ExcelLoaderMetadata} from './excel-loader';
+
+const {preload: _ExcelWorkerLoaderPreload, ...ExcelWorkerLoaderMetadataWithoutPreload} =
+  ExcelWorkerLoaderMetadata;
+const {preload: _ExcelLoaderPreload, ...ExcelLoaderMetadataWithoutPreload} = ExcelLoaderMetadata;
+
+/** 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 const ExcelWorkerLoaderWithParser = {
+  ...ExcelWorkerLoaderMetadataWithoutPreload
+} as const satisfies Loader<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;
+
+/** Loader for Excel files. */
+export const ExcelLoaderWithParser = {
+  ...ExcelLoaderMetadataWithoutPreload,
+  async parse(
+    arrayBuffer: ArrayBuffer,
+    options?: ExcelLoaderOptions
+  ): Promise<ObjectRowTable | ArrowTable> {
+    const excelOptions = {
+      ...options,
+      excel: {...ExcelLoaderWithParser.options.excel, ...options?.excel}
+    } as ExcelLoaderOptions;
+    const rows = parseExcel(arrayBuffer, excelOptions);
+    if (excelOptions.excel?.shape === 'arrow-table') {
+      return convertExcelRowsToArrowTable(rows);
+    }
+    return {shape: 'object-row-table', data: rows};
+  }
+} as const satisfies LoaderWithParser<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;

package/src/excel-loader.ts

@@ -2,33 +2,37 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import type {Loader, LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';
-import type {ObjectRowTable} from '@loaders.gl/schema';
-import {parseExcel} from './lib/parse-excel';
+import type {Loader, LoaderOptions} from '@loaders.gl/loader-utils';
+import type {ArrowTable, ObjectRowTable} from '@loaders.gl/schema';
 import {ExcelFormat} from './excel-format';
 
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
 const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
 
+/** Options for parsing Excel worksheets. */
 export type ExcelLoaderOptions = LoaderOptions & {
   /** Options for ExcelLoader */
   excel?: {
-    /** Format of returned data */
-    shape?: /* 'array-row-table' | */ '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. */
+async function preload() {
+  const {ExcelLoaderWithParser} = await import('./excel-loader-with-parser');
+  return ExcelLoaderWithParser;
+}
+
+/** Metadata-only worker loader for Excel files. */
 export const ExcelWorkerLoader = {
   ...ExcelFormat,
-  dataType: null as unknown as ObjectRowTable,
+  dataType: null as unknown as ObjectRowTable | ArrowTable,
   batchType: null as never,
   version: VERSION,
   worker: true,
@@ -37,16 +41,12 @@ export const ExcelWorkerLoader = {
       shape: 'object-row-table',
       sheet: undefined // Load default Sheet
     }
-  }
-} as const satisfies Loader<ObjectRowTable, never, ExcelLoaderOptions>;
+  },
+  preload
+} as const satisfies Loader<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;
 
-/**
- * Loader for Excel files
- */
+/** Metadata-only loader for Excel files. */
 export const ExcelLoader = {
   ...ExcelWorkerLoader,
-  async parse(arrayBuffer: ArrayBuffer, options?: ExcelLoaderOptions): Promise<ObjectRowTable> {
-    const data = parseExcel(arrayBuffer, options);
-    return {shape: 'object-row-table', data};
-  }
-} as const satisfies LoaderWithParser<ObjectRowTable, never, ExcelLoaderOptions>;
+  preload
+} as const satisfies Loader<ObjectRowTable | ArrowTable, never, ExcelLoaderOptions>;