@elaraai/east-node-io 0.0.1-beta.0 → 0.0.1-beta.2

package/dist/format/types.js

@@ -0,0 +1,122 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * XLSX type definitions for East Node IO.
+ *
+ * Provides East type definitions for reading and writing Excel (XLSX) files,
+ * representing spreadsheets as 2D arrays of literal values.
+ *
+ * @packageDocumentation
+ */
+import { StructType, OptionType, ArrayType, DictType, StringType, IntegerType, } from "@elaraai/east";
+import { LiteralValueType } from "@elaraai/east/internal";
+/**
+ * A single cell value in a spreadsheet.
+ *
+ * Can be a string, number, boolean, or null. Matches the LiteralValueType
+ * which supports all primitive JavaScript values that can appear in Excel cells.
+ */
+export const XlsxCellType = LiteralValueType;
+/**
+ * A row of cells in a spreadsheet.
+ *
+ * Represents a single row as an array of cell values.
+ */
+export const XlsxRowType = ArrayType(XlsxCellType);
+/**
+ * A 2D array representing a complete worksheet.
+ *
+ * Array of rows, where each row is an array of cell values.
+ * This is the main data structure for reading/writing XLSX files.
+ */
+export const XlsxSheetType = ArrayType(XlsxRowType);
+/**
+ * XLSX read options configuration.
+ *
+ * Controls how Excel files are parsed when reading.
+ */
+export const XlsxReadOptionsType = StructType({
+    /**
+     * Name of the sheet to read.
+     * If not specified, reads the first sheet.
+     */
+    sheetName: OptionType(StringType),
+});
+/**
+ * XLSX write options configuration.
+ *
+ * Controls how data is written to Excel files.
+ */
+export const XlsxWriteOptionsType = StructType({
+    /**
+     * Name of the sheet to create.
+     * Defaults to "Sheet1" if not specified.
+     */
+    sheetName: OptionType(StringType),
+});
+/**
+ * Information about sheets in an XLSX file.
+ */
+export const XlsxSheetInfoType = StructType({
+    /** Sheet name */
+    name: StringType,
+    /** Number of rows (approximate) */
+    rowCount: IntegerType,
+    /** Number of columns (approximate) */
+    columnCount: IntegerType,
+});
+/**
+ * XLSX file metadata and sheet listing.
+ */
+export const XlsxInfoType = StructType({
+    /** List of sheets in the workbook */
+    sheets: ArrayType(XlsxSheetInfoType),
+});
+/**
+ * A single cell value in a CSV file.
+ *
+ * Can be a string, number, boolean, or null. Matches the LiteralValueType
+ * which supports all primitive JavaScript values that can appear in CSV cells.
+ */
+export const CsvCellType = LiteralValueType;
+/**
+ * A row of cells in a CSV file represented as a dictionary.
+ *
+ * Maps column names (from the header row) to cell values.
+ * This allows accessing cells by name rather than index.
+ */
+export const CsvRowType = DictType(StringType, CsvCellType);
+/**
+ * CSV data as an array of rows.
+ *
+ * Each row is a dictionary mapping column names to values.
+ * The first row of the CSV file is used as column headers.
+ */
+export const CsvDataType = ArrayType(CsvRowType);
+/**
+ * CSV read options configuration.
+ *
+ * Controls how CSV files are parsed when reading.
+ */
+export const CsvReadOptionsType = StructType({
+    /**
+     * Delimiter character.
+     * Defaults to "," if not specified.
+     */
+    delimiter: OptionType(StringType),
+});
+/**
+ * CSV write options configuration.
+ *
+ * Controls how data is written to CSV files.
+ */
+export const CsvWriteOptionsType = StructType({
+    /**
+     * Delimiter character.
+     * Defaults to "," if not specified.
+     */
+    delimiter: OptionType(StringType),
+});
+//# sourceMappingURL=types.js.map

package/dist/format/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/format/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EACH,UAAU,EACV,UAAU,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,WAAW,GACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC1C;;;OAGG;IACH,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC3C;;;OAGG;IACH,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IACxC,iBAAiB;IACjB,IAAI,EAAE,UAAU;IAEhB,mCAAmC;IACnC,QAAQ,EAAE,WAAW;IAErB,sCAAsC;IACtC,WAAW,EAAE,WAAW;CAC3B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;IACnC,qCAAqC;IACrC,MAAM,EAAE,SAAS,CAAC,iBAAiB,CAAC;CACvC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IACzC;;;OAGG;IACH,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC1C;;;OAGG;IACH,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC"}

package/dist/format/xlsx.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * XLSX (Excel) file format platform functions for East Node IO.
+ *
+ * Provides functions for reading and writing Excel files (.xlsx) as 2D arrays
+ * of literal values.
+ *
+ * @packageDocumentation
+ */
+import { BlobType } from "@elaraai/east";
+import type { PlatformFunction } from "@elaraai/east/internal";
+/**
+ * Reads an XLSX file and returns a 2D array of cell values.
+ *
+ * Parses an Excel file from a blob and extracts data as a 2D array where
+ * each row is an array of cell values. Cell values are represented as
+ * LiteralValueType (string, number, boolean, or null).
+ *
+ * This is a platform function for the East language, enabling Excel file
+ * operations in East programs running on Node.js.
+ *
+ * @param data - XLSX file content as a blob
+ * @param options - Read options (sheet name)
+ * @returns 2D array of cell values (ArrayType<ArrayType<LiteralValueType>>)
+ *
+ * @throws {EastError} When reading fails due to:
+ * - Invalid XLSX file format (location: "xlsx_read")
+ * - Sheet not found (location: "xlsx_read")
+ * - Corrupted file data (location: "xlsx_read")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, IntegerType, variant } from "@elaraai/east";
+ * import { Format } from "@elaraai/east-node-io";
+ *
+ * const countRows = East.function([BlobType], IntegerType, ($, xlsxBlob) => {
+ *     const options = $.let({
+ *         sheetName: variant('some', "Sheet1"),
+ *     });
+ *
+ *     const sheet = $.let(Format.XLSX.read(xlsxBlob, options));
+ *
+ *     // Skip header row in East code
+ *     const dataRows = $.let(sheet.slice(East.value(1n), sheet.size()));
+ *
+ *     return $.return(dataRows.size());
+ * });
+ *
+ * const compiled = East.compile(countRows.toIR(), Format.XLSX.Implementation);
+ * const xlsxBlob = new Uint8Array([]);
+ * compiled(xlsxBlob);  // 99n (row count after skipping header)
+ * ```
+ *
+ * @remarks
+ * - All read operations are synchronous (use East.compile)
+ * - Empty cells are represented as null
+ * - Numbers are converted to JavaScript numbers (not bigint)
+ * - Dates are converted to ISO 8601 strings
+ * - Formulas are evaluated and their results are returned
+ */
+export declare const xlsx_read: import("@elaraai/east").PlatformDefinition<[BlobType, import("@elaraai/east").StructType<{
+    sheetName: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+}>], import("@elaraai/east").ArrayType<import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+    Null: import("@elaraai/east").NullType;
+    Boolean: import("@elaraai/east").BooleanType;
+    Integer: import("@elaraai/east").IntegerType;
+    Float: import("@elaraai/east").FloatType;
+    String: import("@elaraai/east").StringType;
+    DateTime: import("@elaraai/east").DateTimeType;
+    Blob: BlobType;
+}>>>>;
+/**
+ * Writes a 2D array of cell values to an XLSX file.
+ *
+ * Creates an Excel file from a 2D array of literal values. Each nested array
+ * represents a row, and each value in the row represents a cell.
+ *
+ * This is a platform function for the East language, enabling Excel file
+ * creation in East programs running on Node.js.
+ *
+ * @param data - 2D array of cell values to write
+ * @param options - Write options (sheet name)
+ * @returns XLSX file content as a blob
+ *
+ * @throws {EastError} When writing fails due to:
+ * - Invalid data structure (location: "xlsx_write")
+ * - Unsupported cell value type (location: "xlsx_write")
+ * - Memory allocation failure for large files (location: "xlsx_write")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, variant } from "@elaraai/east";
+ * import { Format } from "@elaraai/east-node-io";
+ *
+ * const createExcel = East.function([], BlobType, $ => {
+ *     const data = $.let([
+ *         [variant('String', "Name"), variant('String', "Age"), variant('String', "City")],
+ *         [variant('String', "Alice"), variant('Float', 30), variant('String', "New York")],
+ *         [variant('String', "Bob"), variant('Float', 25), variant('String', "London")],
+ *     ]);
+ *
+ *     const options = $.let({
+ *         sheetName: variant('some', "Employees"),
+ *     });
+ *
+ *     return $.return(Format.XLSX.write(data, options));
+ * });
+ *
+ * const compiled = East.compile(createExcel.toIR(), Format.XLSX.Implementation);
+ * const xlsxBlob = compiled();
+ * ```
+ *
+ * @remarks
+ * - All write operations are synchronous (use East.compile)
+ * - null values create empty cells
+ * - Numbers are written as numeric cells
+ * - Strings are written as text cells
+ * - Booleans are written as boolean cells
+ * - All rows should ideally have the same number of columns
+ */
+export declare const xlsx_write: import("@elaraai/east").PlatformDefinition<[import("@elaraai/east").ArrayType<import("@elaraai/east").ArrayType<import("@elaraai/east").VariantType<{
+    Null: import("@elaraai/east").NullType;
+    Boolean: import("@elaraai/east").BooleanType;
+    Integer: import("@elaraai/east").IntegerType;
+    Float: import("@elaraai/east").FloatType;
+    String: import("@elaraai/east").StringType;
+    DateTime: import("@elaraai/east").DateTimeType;
+    Blob: BlobType;
+}>>>, import("@elaraai/east").StructType<{
+    sheetName: import("@elaraai/east").OptionType<import("@elaraai/east").StringType>;
+}>], BlobType>;
+/**
+ * Gets metadata about an XLSX file without reading all data.
+ *
+ * Returns information about sheets in the workbook including names and
+ * approximate row/column counts. Useful for inspecting files before reading.
+ *
+ * @param data - XLSX file content as a blob
+ * @returns Metadata with sheet names and sizes
+ *
+ * @throws {EastError} When reading fails due to:
+ * - Invalid XLSX file format (location: "xlsx_info")
+ * - Corrupted file data (location: "xlsx_info")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, StringType } from "@elaraai/east";
+ * import { Format } from "@elaraai/east-node-io";
+ *
+ * const getFirstSheetName = East.function([BlobType], StringType, ($, xlsxBlob) => {
+ *     const info = $.let(Format.XLSX.info(xlsxBlob));
+ *     const firstSheet = $.let(info.sheets.at(East.value(0n)));
+ *     return $.return(firstSheet.name);
+ * });
+ *
+ * const compiled = East.compile(getFirstSheetName.toIR(), Format.XLSX.Implementation);
+ * const xlsxBlob = new Uint8Array([]);
+ * compiled(xlsxBlob);  // "Sheet1"
+ * ```
+ */
+export declare const xlsx_info: import("@elaraai/east").PlatformDefinition<[BlobType], import("@elaraai/east").StructType<{
+    sheets: import("@elaraai/east").ArrayType<import("@elaraai/east").StructType<{
+        name: import("@elaraai/east").StringType;
+        rowCount: import("@elaraai/east").IntegerType;
+        columnCount: import("@elaraai/east").IntegerType;
+    }>>;
+}>>;
+/**
+ * Node.js platform implementation for XLSX operations.
+ *
+ * Provides the runtime implementations for XLSX read/write operations.
+ * Pass this to East.compile() to enable XLSX functionality.
+ */
+export declare const XlsxImpl: PlatformFunction[];
+//# sourceMappingURL=xlsx.d.ts.map

package/dist/format/xlsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.d.ts","sourceRoot":"","sources":["../../src/format/xlsx.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAQ,QAAQ,EAAkB,MAAM,eAAe,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAU/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;KAA6E,CAAC;AACpG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;cAA+E,CAAC;AAEvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,SAAS;;;;;;GAAuD,CAAC;AAqB9E;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,gBAAgB,EAqKtC,CAAC"}

package/dist/format/xlsx.js

@@ -0,0 +1,313 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * XLSX (Excel) file format platform functions for East Node IO.
+ *
+ * Provides functions for reading and writing Excel files (.xlsx) as 2D arrays
+ * of literal values.
+ *
+ * @packageDocumentation
+ */
+import { East, BlobType, variant, match } from "@elaraai/east";
+import { EastError, LiteralValueType } from "@elaraai/east/internal";
+import * as XLSX from 'xlsx';
+import { XlsxSheetType, XlsxReadOptionsType, XlsxWriteOptionsType, XlsxInfoType, } from "./types.js";
+/**
+ * Reads an XLSX file and returns a 2D array of cell values.
+ *
+ * Parses an Excel file from a blob and extracts data as a 2D array where
+ * each row is an array of cell values. Cell values are represented as
+ * LiteralValueType (string, number, boolean, or null).
+ *
+ * This is a platform function for the East language, enabling Excel file
+ * operations in East programs running on Node.js.
+ *
+ * @param data - XLSX file content as a blob
+ * @param options - Read options (sheet name)
+ * @returns 2D array of cell values (ArrayType<ArrayType<LiteralValueType>>)
+ *
+ * @throws {EastError} When reading fails due to:
+ * - Invalid XLSX file format (location: "xlsx_read")
+ * - Sheet not found (location: "xlsx_read")
+ * - Corrupted file data (location: "xlsx_read")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, IntegerType, variant } from "@elaraai/east";
+ * import { Format } from "@elaraai/east-node-io";
+ *
+ * const countRows = East.function([BlobType], IntegerType, ($, xlsxBlob) => {
+ *     const options = $.let({
+ *         sheetName: variant('some', "Sheet1"),
+ *     });
+ *
+ *     const sheet = $.let(Format.XLSX.read(xlsxBlob, options));
+ *
+ *     // Skip header row in East code
+ *     const dataRows = $.let(sheet.slice(East.value(1n), sheet.size()));
+ *
+ *     return $.return(dataRows.size());
+ * });
+ *
+ * const compiled = East.compile(countRows.toIR(), Format.XLSX.Implementation);
+ * const xlsxBlob = new Uint8Array([]);
+ * compiled(xlsxBlob);  // 99n (row count after skipping header)
+ * ```
+ *
+ * @remarks
+ * - All read operations are synchronous (use East.compile)
+ * - Empty cells are represented as null
+ * - Numbers are converted to JavaScript numbers (not bigint)
+ * - Dates are converted to ISO 8601 strings
+ * - Formulas are evaluated and their results are returned
+ */
+export const xlsx_read = East.platform("xlsx_read", [BlobType, XlsxReadOptionsType], XlsxSheetType);
+/**
+ * Writes a 2D array of cell values to an XLSX file.
+ *
+ * Creates an Excel file from a 2D array of literal values. Each nested array
+ * represents a row, and each value in the row represents a cell.
+ *
+ * This is a platform function for the East language, enabling Excel file
+ * creation in East programs running on Node.js.
+ *
+ * @param data - 2D array of cell values to write
+ * @param options - Write options (sheet name)
+ * @returns XLSX file content as a blob
+ *
+ * @throws {EastError} When writing fails due to:
+ * - Invalid data structure (location: "xlsx_write")
+ * - Unsupported cell value type (location: "xlsx_write")
+ * - Memory allocation failure for large files (location: "xlsx_write")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, variant } from "@elaraai/east";
+ * import { Format } from "@elaraai/east-node-io";
+ *
+ * const createExcel = East.function([], BlobType, $ => {
+ *     const data = $.let([
+ *         [variant('String', "Name"), variant('String', "Age"), variant('String', "City")],
+ *         [variant('String', "Alice"), variant('Float', 30), variant('String', "New York")],
+ *         [variant('String', "Bob"), variant('Float', 25), variant('String', "London")],
+ *     ]);
+ *
+ *     const options = $.let({
+ *         sheetName: variant('some', "Employees"),
+ *     });
+ *
+ *     return $.return(Format.XLSX.write(data, options));
+ * });
+ *
+ * const compiled = East.compile(createExcel.toIR(), Format.XLSX.Implementation);
+ * const xlsxBlob = compiled();
+ * ```
+ *
+ * @remarks
+ * - All write operations are synchronous (use East.compile)
+ * - null values create empty cells
+ * - Numbers are written as numeric cells
+ * - Strings are written as text cells
+ * - Booleans are written as boolean cells
+ * - All rows should ideally have the same number of columns
+ */
+export const xlsx_write = East.platform("xlsx_write", [XlsxSheetType, XlsxWriteOptionsType], BlobType);
+/**
+ * Gets metadata about an XLSX file without reading all data.
+ *
+ * Returns information about sheets in the workbook including names and
+ * approximate row/column counts. Useful for inspecting files before reading.
+ *
+ * @param data - XLSX file content as a blob
+ * @returns Metadata with sheet names and sizes
+ *
+ * @throws {EastError} When reading fails due to:
+ * - Invalid XLSX file format (location: "xlsx_info")
+ * - Corrupted file data (location: "xlsx_info")
+ *
+ * @example
+ * ```ts
+ * import { East, BlobType, StringType } from "@elaraai/east";
+ * import { Format } from "@elaraai/east-node-io";
+ *
+ * const getFirstSheetName = East.function([BlobType], StringType, ($, xlsxBlob) => {
+ *     const info = $.let(Format.XLSX.info(xlsxBlob));
+ *     const firstSheet = $.let(info.sheets.at(East.value(0n)));
+ *     return $.return(firstSheet.name);
+ * });
+ *
+ * const compiled = East.compile(getFirstSheetName.toIR(), Format.XLSX.Implementation);
+ * const xlsxBlob = new Uint8Array([]);
+ * compiled(xlsxBlob);  // "Sheet1"
+ * ```
+ */
+export const xlsx_info = East.platform("xlsx_info", [BlobType], XlsxInfoType);
+/**
+ * Converts East LiteralValueType to native JavaScript value for XLSX.
+ *
+ * @param value - East LiteralValueType value
+ * @returns Native JavaScript value
+ * @internal
+ */
+function convertLiteralToCell(value) {
+    return match(value, {
+        Null: () => null,
+        String: (v) => v,
+        Integer: (v) => Number(v), // Convert BigInt to Number for Excel
+        Float: (v) => v,
+        Boolean: (v) => v,
+        DateTime: (v) => v, // Keep as Date object
+        Blob: (v) => v.toString(), // Convert Blob to string representation
+    });
+}
+/**
+ * Node.js platform implementation for XLSX operations.
+ *
+ * Provides the runtime implementations for XLSX read/write operations.
+ * Pass this to East.compile() to enable XLSX functionality.
+ */
+export const XlsxImpl = [
+    xlsx_read.implement((data, options) => {
+        try {
+            // Convert Uint8Array blob to Buffer
+            const buffer = Buffer.from(data);
+            // Parse the workbook with cellDates option to parse dates as Date objects
+            const workbook = XLSX.read(buffer, { type: 'buffer', cellDates: true });
+            // Determine which sheet to read
+            let sheetName;
+            if (options.sheetName?.type === 'some') {
+                sheetName = options.sheetName.value;
+                if (!workbook.Sheets[sheetName]) {
+                    throw new EastError(`Sheet "${sheetName}" not found in workbook`, {
+                        location: { filename: "xlsx_read", line: 0n, column: 0n }
+                    });
+                }
+            }
+            else {
+                // Use first sheet if no name specified
+                const firstSheetName = workbook.SheetNames[0];
+                if (!firstSheetName) {
+                    throw new EastError('Workbook contains no sheets', {
+                        location: { filename: "xlsx_read", line: 0n, column: 0n }
+                    });
+                }
+                sheetName = firstSheetName;
+            }
+            const worksheet = workbook.Sheets[sheetName];
+            if (!worksheet) {
+                throw new EastError(`Sheet "${sheetName}" not found in workbook`, {
+                    location: { filename: "xlsx_read", line: 0n, column: 0n }
+                });
+            }
+            // Get the range of the worksheet
+            const range = XLSX.utils.decode_range(worksheet['!ref'] || 'A1');
+            // Convert worksheet to 2D array using cell metadata
+            const eastData = [];
+            for (let R = range.s.r; R <= range.e.r; R++) {
+                const row = [];
+                for (let C = range.s.c; C <= range.e.c; C++) {
+                    const cellAddress = XLSX.utils.encode_cell({ r: R, c: C });
+                    const cell = worksheet[cellAddress];
+                    if (!cell) {
+                        // Empty cell
+                        row.push(variant('Null', null));
+                    }
+                    else {
+                        // Use cell type metadata to determine the correct variant
+                        switch (cell.t) {
+                            case 'b': // Boolean
+                                row.push(variant('Boolean', cell.v));
+                                break;
+                            case 'n': // Number
+                                row.push(variant('Float', cell.v));
+                                break;
+                            case 's': // String
+                                row.push(variant('String', cell.v));
+                                break;
+                            case 'd': // Date
+                                row.push(variant('DateTime', cell.v));
+                                break;
+                            case 'z': // Stub (blank)
+                            case 'e': // Error
+                            default:
+                                row.push(variant('Null', null));
+                                break;
+                        }
+                    }
+                }
+                eastData.push(row);
+            }
+            return eastData;
+        }
+        catch (err) {
+            if (err instanceof EastError) {
+                throw err;
+            }
+            throw new EastError(`Failed to read XLSX file: ${err.message}`, {
+                location: { filename: "xlsx_read", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    xlsx_write.implement((data, options) => {
+        try {
+            // Convert East 2D array to native JavaScript array
+            const nativeData = data.map(row => row.map(convertLiteralToCell));
+            // Create a new workbook and worksheet
+            const workbook = XLSX.utils.book_new();
+            const worksheet = XLSX.utils.aoa_to_sheet(nativeData);
+            // Determine sheet name
+            const sheetName = options.sheetName?.type === 'some' ? options.sheetName.value : 'Sheet1';
+            // Add worksheet to workbook
+            XLSX.utils.book_append_sheet(workbook, worksheet, sheetName);
+            // Write workbook to buffer
+            const buffer = XLSX.write(workbook, {
+                type: 'buffer',
+                bookType: 'xlsx',
+            });
+            // Convert Buffer to Uint8Array
+            return new Uint8Array(buffer);
+        }
+        catch (err) {
+            throw new EastError(`Failed to write XLSX file: ${err.message}`, {
+                location: { filename: "xlsx_write", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+    xlsx_info.implement((data) => {
+        try {
+            // Convert Uint8Array blob to Buffer
+            const buffer = Buffer.from(data);
+            // Parse the workbook (but don't read all data)
+            const workbook = XLSX.read(buffer, { type: 'buffer', bookVBA: false });
+            // Extract sheet information
+            const sheets = workbook.SheetNames.map(name => {
+                const worksheet = workbook.Sheets[name];
+                if (!worksheet) {
+                    return {
+                        name,
+                        rowCount: 0n,
+                        columnCount: 0n,
+                    };
+                }
+                const range = XLSX.utils.decode_range(worksheet['!ref'] || 'A1');
+                return {
+                    name,
+                    rowCount: BigInt(range.e.r - range.s.r + 1),
+                    columnCount: BigInt(range.e.c - range.s.c + 1),
+                };
+            });
+            return { sheets };
+        }
+        catch (err) {
+            throw new EastError(`Failed to read XLSX file info: ${err.message}`, {
+                location: { filename: "xlsx_info", line: 0n, column: 0n },
+                cause: err
+            });
+        }
+    }),
+];
+//# sourceMappingURL=xlsx.js.map

package/dist/format/xlsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.js","sourceRoot":"","sources":["../../src/format/xlsx.ts"],"names":[],"mappings":"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"}