@lotics/cli 0.88.0 → 0.89.1

package/dist/starter_template.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/starter_template.test.js

@@ -1,115 +0,0 @@
-import { describe, expect, test } from "vitest";
-import { buildStarterTemplate, STARTER_FALLBACK_SDK_VERSION, STARTER_FALLBACK_UI_VERSION, STARTER_REACT_NATIVE_VERSION, } from "./starter_template.js";
-function fileNamed(files, path) {
-    const f = files.find((f) => f.path === path);
-    if (!f)
-        throw new Error(`Starter template missing file: ${path}`);
-    return f.content;
-}
-describe("buildStarterTemplate", () => {
-    const baseArgs = { app_name: "Demo", app_id: "app_test", workspace_id: "wsp_test" };
-    test("vite.config.ts pre-bundles RN deps with __DEV__ + .web.js for the dev server", () => {
-        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
-        // The optimizer runs a SEPARATE esbuild pass that ignores `resolve.extensions`
-        // and the top-level `define`, so `__DEV__` + `.web.js` must be repeated here —
-        // else a pre-bundled RN dep (e.g. react-native-svg, which @lotics/ui charts
-        // use) resolves to its native build and `__DEV__` is undefined.
-        expect(config).toMatch(/optimizeDeps:\s*\{/);
-        expect(config).toContain('__DEV__: "false"');
-        expect(config).toContain('".web.js"');
-    });
-    test("vite.config.ts force-prebundles react-native-web (else a DatePicker/Picker blanks the dev iframe)", () => {
-        // RN-Web does `import normalizeColor from "@react-native/normalize-colors"`
-        // (nested CJS). Un-prebundled, the dev server serves it as ESM with no
-        // default → "does not provide an export named 'default'" + blank iframe the
-        // moment a colour-touching component mounts. Prebundling interops it.
-        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
-        expect(config).toMatch(/include:\s*\[[^\]]*"react-native-web"/);
-    });
-    test("vite.config.ts defines the RN __DEV__ global (else the bundle throws at load → blank iframe)", () => {
-        // `__DEV__` is a Metro-injected global that RN-ecosystem deps reference at
-        // module-eval time (e.g. @react-native-picker's UnimplementedView, pulled in
-        // via @lotics/ui's DatePicker). Vite doesn't define it; undefined ⇒ a runtime
-        // ReferenceError that no typecheck/lint/build catches. Pin it so it can't
-        // silently regress and re-blank every app that imports such a dep.
-        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
-        // Top-level define (covers the prod build + most dev modules)...
-        expect(config).toMatch(/define:\s*\{\s*__DEV__:\s*"false"/);
-        // ...and the dep-optimizer's separate esbuild pass (covers pre-bundled
-        // deps under `lotics app dev`).
-        expect(config).toMatch(/esbuildOptions:\s*\{\s*define:\s*\{\s*__DEV__:\s*"false"/);
-    });
-    test("vite.config.ts enables the vitest web optimizer with .web.js resolution (else tests rendering a Picker/DatePicker fail on Flow)", () => {
-        // Vitest pre-bundles deps with its OWN esbuild optimizer, which is OFF by
-        // default and ignores the top-level `optimizeDeps.resolveExtensions`. Without
-        // it enabled + given `.web.js` first, it grabs react-native's native `.js` /
-        // src Flow files (`import typeof`) that esbuild can't parse — so any test that
-        // renders a tree pulling a Picker/DatePicker dies with "Unexpected token 'typeof'".
-        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
-        expect(config).toMatch(/test:\s*\{[\s\S]*environment:\s*"jsdom"/);
-        expect(config).toMatch(/optimizer:\s*\{\s*web:\s*\{\s*enabled:\s*true/);
-        // The web optimizer carries the same `.web.js`-first resolution as the build.
-        expect(config).toMatch(/web:\s*\{[\s\S]*resolveExtensions:[\s\S]*"\.web\.js"/);
-    });
-    test("vite.config.ts maps the RN `global` to globalThis (else rn-web Animated throws when a spring is torn down)", () => {
-        // react-native-web's Animated reads `global.cancelAnimationFrame` (free var)
-        // when a spring animation is interrupted — e.g. toggling @lotics/ui's Switch.
-        // Undefined in a web bundle ⇒ "global is not defined". The rollup build hits
-        // it; the dev esbuild path masks it, so it only surfaces in the deployed app
-        // and no typecheck/lint/build catches it. Pin both define sites.
-        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
-        expect(config).toMatch(/define:\s*\{\s*__DEV__:\s*"false",\s*global:\s*"globalThis"/);
-        expect(config).toMatch(/esbuildOptions:\s*\{\s*define:\s*\{\s*__DEV__:\s*"false",\s*global:\s*"globalThis"/);
-    });
-    test("package.json pins react-native to the monorepo version (so apps typecheck @lotics/ui against the same RN types)", () => {
-        const pkg = JSON.parse(fileNamed(buildStarterTemplate(baseArgs), "package.json"));
-        expect(pkg.dependencies["react-native"]).toBe(STARTER_REACT_NATIVE_VERSION);
-    });
-    test("package.json uses caller-supplied versions for @lotics/ui and @lotics/app-sdk", () => {
-        const pkg = JSON.parse(fileNamed(buildStarterTemplate({ ...baseArgs, ui_version: "^9.9.9", sdk_version: "^2.2.2" }), "package.json"));
-        expect(pkg.dependencies["@lotics/ui"]).toBe("^9.9.9");
-        expect(pkg.dependencies["@lotics/app-sdk"]).toBe("^2.2.2");
-    });
-    test("package.json falls back to the static pins when versions are omitted", () => {
-        // Used when `lotics app create` cannot reach the npm registry to resolve
-        // `latest`. Keeps `app create` working offline at the cost of a stale pin.
-        const pkg = JSON.parse(fileNamed(buildStarterTemplate(baseArgs), "package.json"));
-        expect(pkg.dependencies["@lotics/ui"]).toBe(`^${STARTER_FALLBACK_UI_VERSION}`);
-        expect(pkg.dependencies["@lotics/app-sdk"]).toBe(`^${STARTER_FALLBACK_SDK_VERSION}`);
-    });
-    test("package.json includes react-router-dom for the in-app router example", () => {
-        const pkg = JSON.parse(fileNamed(buildStarterTemplate(baseArgs), "package.json"));
-        expect(pkg.dependencies["react-router-dom"]).toBeDefined();
-    });
-    test("App.tsx routes via the SDK's AppRouter (real addressable URLs, both modes)", () => {
-        // The scaffold demonstrates the recommended shape: the app uses react-router
-        // through `AppRouter`, which makes screens addressable URLs in both modes.
-        // Guards against the wiring being dropped back to a single screen.
-        const app = fileNamed(buildStarterTemplate(baseArgs), "src/App.tsx");
-        expect(app).toContain('from "react-router-dom"');
-        expect(app).toContain('from "@lotics/app-sdk/router"');
-        expect(app).toContain("<AppRouter routes={routes}");
-    });
-    test("vite.config.ts pins react-router-dom into the vitest web optimizer (else the routed App test splits the react instance)", () => {
-        // react-router-dom ships compiled dist JS; un-pinned, its hooks load a second
-        // react instance under vitest and the scaffold's App.test fails with "Invalid
-        // hook call" the moment it renders RouterProvider.
-        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
-        expect(config).toMatch(/include:\s*\[[\s\S]*"react-router-dom"/);
-    });
-    test("main tsconfig excludes BOTH the workflow bodies and their per-alias globals (GAP-59 fix)", () => {
-        // npm run typecheck must skip src/workflows (DOM-lib skew) AND .lotics/workflows
-        // (the per-alias ambient `trigger` declarations collide across aliases and
-        // report false errors). Bodies are checked by `lotics app workflow check`.
-        const cfg = JSON.parse(fileNamed(buildStarterTemplate(baseArgs), "tsconfig.json"));
-        expect(cfg.exclude).toContain("src/workflows");
-        expect(cfg.exclude).toContain(".lotics/workflows");
-    });
-    test("no longer ships the all-in-one tsconfig.workflows.json (it collided per-alias globals)", () => {
-        // The dedicated config compiled every alias's globals into ONE program, so the
-        // ambient `trigger` declarations collided. `lotics app workflow check` replaces
-        // it with one isolated program per alias.
-        const files = buildStarterTemplate(baseArgs);
-        expect(files.find((f) => f.path === "tsconfig.workflows.json")).toBeUndefined();
-    });
-});

package/dist/version.d.ts

@@ -1 +0,0 @@
-export declare const VERSION: string;

package/dist/version.js

@@ -1,6 +0,0 @@
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import path from "node:path";
-const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json");
-const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-export const VERSION = pkg.version;

package/dist/xlsx.d.ts

@@ -1,2 +0,0 @@
-export declare function printXlsxHelp(): void;
-export declare function runXlsxCommand(subcommand: string | undefined, toolArgs: string | undefined, restArgs: string[]): Promise<void>;

package/dist/xlsx.js

@@ -1,489 +0,0 @@
-import fs from "node:fs";
-import { fail, writeFileAtomic } from "./file_command_io.js";
-import { parseExcelBuffer } from "@lotics/xlsx/excel_parser";
-import { unzipXlsx } from "@lotics/xlsx/ooxml_zip";
-import { exportWorkbook } from "@lotics/xlsx/xlsx_writer";
-import { loadWorkbookFromSnapshot, WorkbookModel, SheetModel, StyleRegistry } from "@lotics/xlsx/workbook_model";
-import { FormulaEngine } from "@lotics/xlsx/formula_engine";
-import { refToRowCol, rowColToRef } from "@lotics/xlsx/excel_utils";
-import { setCellValueCommand, clearRangeCommand, mergeCellsCommand, unmergeCellsCommand, addSheetCommand, deleteSheetCommand, renameSheetCommand, insertRowsCommand, deleteRowsCommand, insertColsCommand, deleteColsCommand, setRangeStyleCommand, } from "@lotics/xlsx/spreadsheet_commands";
-function loadFile(filePath) {
-    if (!fs.existsSync(filePath))
-        fail(`File not found: ${filePath}`);
-    const buffer = fs.readFileSync(filePath);
-    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-    const originalZip = unzipXlsx(arrayBuffer);
-    const parsed = parseExcelBuffer(arrayBuffer);
-    const workbook = loadWorkbookFromSnapshot(parsed);
-    return { workbook, originalZip };
-}
-function exportAndWrite(loaded, filePath) {
-    const bytes = exportWorkbook(loaded.workbook, loaded.originalZip);
-    writeFileAtomic(filePath, bytes);
-}
-function resolveSheetIndex(workbook, sheetName) {
-    const index = workbook.sheets.findIndex((s) => s.name === sheetName);
-    if (index < 0) {
-        const names = workbook.sheets.map((s) => `"${s.name}"`).join(", ");
-        fail(`Sheet not found: "${sheetName}". Available: ${names}`);
-    }
-    return index;
-}
-function parseRange(range) {
-    const [start, end] = range.includes(":") ? range.split(":") : [range, range];
-    const s = refToRowCol(start.toUpperCase());
-    const e = refToRowCol(end.toUpperCase());
-    if (!s || !e)
-        fail(`Invalid range: ${range}`);
-    return {
-        startRow: Math.min(s.row, e.row),
-        startCol: Math.min(s.col, e.col),
-        endRow: Math.max(s.row, e.row),
-        endCol: Math.max(s.col, e.col),
-    };
-}
-function parseInt10(s, name) {
-    if (s === undefined)
-        fail(`Missing ${name}`);
-    const n = parseInt(s, 10);
-    if (!Number.isFinite(n))
-        fail(`Invalid ${name}: ${s}`);
-    return n;
-}
-function lazyEngine(workbook) {
-    let engine;
-    return {
-        get() {
-            if (!engine) {
-                engine = new FormulaEngine(workbook);
-                engine.buildGraph();
-            }
-            return engine;
-        },
-    };
-}
-// =============================================================================
-// JSON shape: ParsedSpreadsheet (read) and SimpleWorkbook (write)
-// =============================================================================
-function readToJson(filePath) {
-    const buffer = fs.readFileSync(filePath);
-    const arrayBuffer = buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
-    const parsed = parseExcelBuffer(arrayBuffer);
-    return {
-        activeSheetIndex: parsed.activeSheetIndex,
-        sheets: parsed.sheets.map((s) => ({
-            name: s.name,
-            totalRowCount: s.totalRowCount,
-            truncated: s.truncated,
-            cells: cellsFromParsedRows(s.rows),
-            merges: s.mergedCells.map((m) => `${rowColToRef(m.startRow, m.startCol)}:${rowColToRef(m.endRow, m.endCol)}`),
-            freeze: s.freezePane ? { row: s.freezePane.frozenRows, col: s.freezePane.frozenCols } : undefined,
-        })),
-    };
-}
-function cellsFromParsedRows(rows) {
-    const out = {};
-    for (const row of rows) {
-        for (const cell of row.cells) {
-            const ref = rowColToRef(row.index, cell.column);
-            const value = cell.typedValue ?? cell.value;
-            const entry = { value };
-            if (cell.formula)
-                entry.formula = cell.formula;
-            out[ref] = entry;
-        }
-    }
-    return out;
-}
-function buildWorkbookFromJson(input) {
-    if (!input || !Array.isArray(input.sheets) || input.sheets.length === 0) {
-        fail("Workbook JSON must include a non-empty `sheets` array");
-    }
-    for (let i = 0; i < input.sheets.length; i++)
-        validateSimpleSheet(input.sheets[i], i);
-    const styles = new StyleRegistry();
-    const sheets = input.sheets.map((s) => new SheetModel(s.name, styles));
-    const workbook = new WorkbookModel({ sheets, activeSheetIndex: 0, styles });
-    for (let i = 0; i < input.sheets.length; i++) {
-        applySheetCells(workbook, i, input.sheets[i]);
-    }
-    return workbook;
-}
-function validateSimpleSheet(s, index) {
-    if (!s || typeof s !== "object")
-        fail(`sheets[${index}] must be an object`);
-    if (typeof s.name !== "string" || s.name === "")
-        fail(`sheets[${index}].name must be a non-empty string`);
-    if (s.cells !== undefined && (typeof s.cells !== "object" || s.cells === null || Array.isArray(s.cells))) {
-        fail(`sheets[${index}].cells must be an object keyed by cell ref (e.g. {"A1": "value"})`);
-    }
-    if (s.merges !== undefined && !Array.isArray(s.merges)) {
-        fail(`sheets[${index}].merges must be an array of ranges (e.g. ["A1:B2"])`);
-    }
-    if (s.freeze !== undefined) {
-        if (typeof s.freeze !== "object" || s.freeze === null)
-            fail(`sheets[${index}].freeze must be {row, col}`);
-        if (typeof s.freeze.row !== "number" || typeof s.freeze.col !== "number") {
-            fail(`sheets[${index}].freeze.row and .col must be numbers`);
-        }
-    }
-}
-function applySheetCells(workbook, sheetIndex, def) {
-    const sheet = workbook.sheets[sheetIndex];
-    if (def.cells) {
-        for (const [ref, raw] of Object.entries(def.cells)) {
-            const cell = normalizeSimpleCell(raw);
-            const coord = refToRowCol(ref.toUpperCase());
-            if (!coord)
-                fail(`Invalid cell ref in sheet "${def.name}": ${ref}`);
-            const stringValue = cell.formula ? `=${cell.formula}` : valueToInput(cell.value);
-            const cmd = setCellValueCommand(workbook, undefined, sheetIndex, coord.row, coord.col, stringValue);
-            cmd.execute();
-        }
-    }
-    if (def.merges) {
-        for (const range of def.merges) {
-            const r = parseRange(range);
-            const cmd = mergeCellsCommand(workbook, sheetIndex, r.startRow, r.startCol, r.endRow, r.endCol);
-            cmd.execute();
-        }
-    }
-    if (def.freeze) {
-        sheet.freeze = { row: def.freeze.row, col: def.freeze.col };
-    }
-}
-function normalizeSimpleCell(raw) {
-    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
-        return raw;
-    }
-    return { value: raw };
-}
-function valueToInput(value) {
-    if (value === null || value === undefined)
-        return "";
-    return String(value);
-}
-// =============================================================================
-// Subcommand handlers
-// =============================================================================
-function xlsxRead(filePath) {
-    if (!filePath)
-        fail("Usage: lotics xlsx read <file>");
-    const data = readToJson(filePath);
-    console.log(JSON.stringify(data, null, 2));
-}
-function xlsxWrite(filePath, json) {
-    if (!filePath || !json)
-        fail("Usage: lotics xlsx write <file> '<json>'");
-    let parsed;
-    try {
-        parsed = JSON.parse(json);
-    }
-    catch (e) {
-        fail(`Invalid JSON: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    const workbook = buildWorkbookFromJson(parsed);
-    const bytes = exportWorkbook(workbook);
-    writeFileAtomic(filePath, bytes);
-}
-function parseSheetRef(spec) {
-    const idx = spec.indexOf("!");
-    if (idx < 0)
-        fail(`Expected <sheet>!<ref>, got: ${spec}`);
-    return { sheet: spec.slice(0, idx), ref: spec.slice(idx + 1) };
-}
-function xlsxSetCell(filePath, rest) {
-    const [sheetRef, value] = rest;
-    if (!filePath || !sheetRef || value === undefined) {
-        fail("Usage: lotics xlsx set-cell <file> <sheet>!<ref> '<value>'");
-    }
-    const { sheet, ref } = parseSheetRef(sheetRef);
-    const coord = refToRowCol(ref.toUpperCase());
-    if (!coord)
-        fail(`Invalid cell ref: ${ref}`);
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheet);
-    const engine = lazyEngine(loaded.workbook);
-    const cmd = setCellValueCommand(loaded.workbook, engine.get(), sheetIndex, coord.row, coord.col, value);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxClearRange(filePath, rest) {
-    const [sheetRef] = rest;
-    if (!filePath || !sheetRef)
-        fail("Usage: lotics xlsx clear-range <file> <sheet>!<range>");
-    const { sheet, ref } = parseSheetRef(sheetRef);
-    const r = parseRange(ref);
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheet);
-    const engine = lazyEngine(loaded.workbook);
-    const cmd = clearRangeCommand(loaded.workbook, engine.get(), sheetIndex, r.startRow, r.startCol, r.endRow, r.endCol);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxMerge(filePath, rest) {
-    const [sheetRef] = rest;
-    if (!filePath || !sheetRef)
-        fail("Usage: lotics xlsx merge <file> <sheet>!<range>");
-    const { sheet, ref } = parseSheetRef(sheetRef);
-    const r = parseRange(ref);
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheet);
-    const cmd = mergeCellsCommand(loaded.workbook, sheetIndex, r.startRow, r.startCol, r.endRow, r.endCol);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxUnmerge(filePath, rest) {
-    const [sheetRef] = rest;
-    if (!filePath || !sheetRef)
-        fail("Usage: lotics xlsx unmerge <file> <sheet>!<range>");
-    const { sheet, ref } = parseSheetRef(sheetRef);
-    const r = parseRange(ref);
-    const mergeRef = `${rowColToRef(r.startRow, r.startCol)}:${rowColToRef(r.endRow, r.endCol)}`;
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheet);
-    const cmd = unmergeCellsCommand(loaded.workbook, sheetIndex, mergeRef);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxAddSheet(filePath, rest) {
-    const [name] = rest;
-    if (!filePath || !name)
-        fail("Usage: lotics xlsx add-sheet <file> <name>");
-    const loaded = loadFile(filePath);
-    const cmd = addSheetCommand(loaded.workbook, name);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxDeleteSheet(filePath, rest) {
-    const [name] = rest;
-    if (!filePath || !name)
-        fail("Usage: lotics xlsx delete-sheet <file> <name>");
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, name);
-    const cmd = deleteSheetCommand(loaded.workbook, sheetIndex);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxRenameSheet(filePath, rest) {
-    const [oldName, newName] = rest;
-    if (!filePath || !oldName || !newName)
-        fail("Usage: lotics xlsx rename-sheet <file> <old> <new>");
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, oldName);
-    const cmd = renameSheetCommand(loaded.workbook, sheetIndex, newName);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxInsertRows(filePath, rest) {
-    const [sheetName, atStr, countStr] = rest;
-    if (!filePath || !sheetName)
-        fail("Usage: lotics xlsx insert-rows <file> <sheet> <at> <count>");
-    const at = parseInt10(atStr, "at");
-    const count = parseInt10(countStr, "count");
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheetName);
-    const cmd = insertRowsCommand(loaded.workbook, sheetIndex, at, count);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxDeleteRows(filePath, rest) {
-    const [sheetName, atStr, countStr] = rest;
-    if (!filePath || !sheetName)
-        fail("Usage: lotics xlsx delete-rows <file> <sheet> <at> <count>");
-    const at = parseInt10(atStr, "at");
-    const count = parseInt10(countStr, "count");
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheetName);
-    const cmd = deleteRowsCommand(loaded.workbook, sheetIndex, at, count);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxInsertCols(filePath, rest) {
-    const [sheetName, atStr, countStr] = rest;
-    if (!filePath || !sheetName)
-        fail("Usage: lotics xlsx insert-cols <file> <sheet> <at> <count>");
-    const at = parseInt10(atStr, "at");
-    const count = parseInt10(countStr, "count");
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheetName);
-    const cmd = insertColsCommand(loaded.workbook, sheetIndex, at, count);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxDeleteCols(filePath, rest) {
-    const [sheetName, atStr, countStr] = rest;
-    if (!filePath || !sheetName)
-        fail("Usage: lotics xlsx delete-cols <file> <sheet> <at> <count>");
-    const at = parseInt10(atStr, "at");
-    const count = parseInt10(countStr, "count");
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheetName);
-    const cmd = deleteColsCommand(loaded.workbook, sheetIndex, at, count);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxSetStyle(filePath, rest) {
-    const [sheetRef, styleJson] = rest;
-    if (!filePath || !sheetRef || !styleJson) {
-        fail("Usage: lotics xlsx set-style <file> <sheet>!<range> '<style-json>'");
-    }
-    const { sheet, ref } = parseSheetRef(sheetRef);
-    const r = parseRange(ref);
-    let style;
-    try {
-        style = JSON.parse(styleJson);
-    }
-    catch (e) {
-        fail(`Invalid style JSON: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    const loaded = loadFile(filePath);
-    const sheetIndex = resolveSheetIndex(loaded.workbook, sheet);
-    const cmd = setRangeStyleCommand(loaded.workbook, sheetIndex, r.startRow, r.startCol, r.endRow, r.endCol, style);
-    cmd.execute();
-    exportAndWrite(loaded, filePath);
-}
-function xlsxBatch(filePath, json) {
-    if (!filePath || !json)
-        fail("Usage: lotics xlsx batch <file> '<json-array-of-ops>'");
-    let ops;
-    try {
-        ops = JSON.parse(json);
-    }
-    catch (e) {
-        fail(`Invalid batch JSON: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    if (!Array.isArray(ops))
-        fail("Batch must be a JSON array of ops");
-    for (let i = 0; i < ops.length; i++) {
-        const op = ops[i];
-        if (!op || typeof op !== "object" || typeof op.op !== "string") {
-            fail(`[op ${i}] each op must be an object with an "op" string field`);
-        }
-    }
-    const loaded = loadFile(filePath);
-    const engine = lazyEngine(loaded.workbook);
-    for (let i = 0; i < ops.length; i++) {
-        const op = ops[i];
-        const cmd = buildBatchCommand(loaded.workbook, engine, op, i);
-        cmd.execute();
-    }
-    exportAndWrite(loaded, filePath);
-}
-function buildBatchCommand(workbook, engine, op, index) {
-    switch (op.op) {
-        case "set-cell": {
-            const sheetIndex = resolveSheetIndex(workbook, op.sheet);
-            const coord = refToRowCol(op.ref.toUpperCase());
-            if (!coord)
-                fail(`[op ${index}] Invalid cell ref: ${op.ref}`);
-            return setCellValueCommand(workbook, engine.get(), sheetIndex, coord.row, coord.col, op.value);
-        }
-        case "clear-range": {
-            const sheetIndex = resolveSheetIndex(workbook, op.sheet);
-            const r = parseRange(op.range);
-            return clearRangeCommand(workbook, engine.get(), sheetIndex, r.startRow, r.startCol, r.endRow, r.endCol);
-        }
-        case "merge": {
-            const sheetIndex = resolveSheetIndex(workbook, op.sheet);
-            const r = parseRange(op.range);
-            return mergeCellsCommand(workbook, sheetIndex, r.startRow, r.startCol, r.endRow, r.endCol);
-        }
-        case "unmerge": {
-            const sheetIndex = resolveSheetIndex(workbook, op.sheet);
-            const r = parseRange(op.range);
-            const mergeRef = `${rowColToRef(r.startRow, r.startCol)}:${rowColToRef(r.endRow, r.endCol)}`;
-            return unmergeCellsCommand(workbook, sheetIndex, mergeRef);
-        }
-        case "add-sheet":
-            return addSheetCommand(workbook, op.name);
-        case "delete-sheet":
-            return deleteSheetCommand(workbook, resolveSheetIndex(workbook, op.name));
-        case "rename-sheet":
-            return renameSheetCommand(workbook, resolveSheetIndex(workbook, op.old), op.new);
-        case "insert-rows":
-            return insertRowsCommand(workbook, resolveSheetIndex(workbook, op.sheet), op.at, op.count);
-        case "delete-rows":
-            return deleteRowsCommand(workbook, resolveSheetIndex(workbook, op.sheet), op.at, op.count);
-        case "insert-cols":
-            return insertColsCommand(workbook, resolveSheetIndex(workbook, op.sheet), op.at, op.count);
-        case "delete-cols":
-            return deleteColsCommand(workbook, resolveSheetIndex(workbook, op.sheet), op.at, op.count);
-        case "set-style": {
-            const sheetIndex = resolveSheetIndex(workbook, op.sheet);
-            const r = parseRange(op.range);
-            return setRangeStyleCommand(workbook, sheetIndex, r.startRow, r.startCol, r.endRow, r.endCol, op.style);
-        }
-        default: {
-            const exhaustive = op;
-            void exhaustive;
-            fail(`[op ${index}] Unknown op: ${JSON.stringify(op)}`);
-        }
-    }
-}
-// =============================================================================
-// Dispatch + help
-// =============================================================================
-export function printXlsxHelp() {
-    console.error(`Lotics xlsx commands — manipulate .xlsx files in place.
-Uses Lotics' own xlsx engine; round-trips faithfully with the Lotics editor and templates.
-
-  lotics xlsx read <file>                          Dump file as JSON (sheets, cells, merges, freeze)
-  lotics xlsx write <file> '<json>'                Create .xlsx from {"sheets":[{"name","cells":{"A1":...}}]}
-  lotics xlsx set-cell <file> <sheet>!<ref> '<v>'  Set cell value (prefix '=' for formula)
-  lotics xlsx clear-range <file> <sheet>!<range>   Clear all cells in a range
-  lotics xlsx merge <file> <sheet>!<range>         Merge a range into one cell
-  lotics xlsx unmerge <file> <sheet>!<range>       Unmerge a previously merged range
-  lotics xlsx add-sheet <file> <name>              Append a new sheet
-  lotics xlsx delete-sheet <file> <name>           Remove a sheet
-  lotics xlsx rename-sheet <file> <old> <new>      Rename a sheet
-  lotics xlsx insert-rows <file> <sheet> <at> <n>  Insert <n> rows at 1-based position
-  lotics xlsx delete-rows <file> <sheet> <at> <n>  Delete <n> rows starting at <at>
-  lotics xlsx insert-cols <file> <sheet> <at> <n>  Insert <n> columns at 1-based position
-  lotics xlsx delete-cols <file> <sheet> <at> <n>  Delete <n> columns starting at <at>
-  lotics xlsx set-style <file> <sheet>!<range> '<style-json>'
-                                                   Apply partial CellStyle to range (fontBold, backgroundColor, ...)
-  lotics xlsx batch <file> '<json-array-of-ops>'   Apply many ops in one parse/export cycle
-
-Edit ops mutate the file atomically (temp file + rename).`);
-}
-export async function runXlsxCommand(subcommand, toolArgs, restArgs) {
-    switch (subcommand) {
-        case "read":
-            return xlsxRead(toolArgs);
-        case "write":
-            return xlsxWrite(toolArgs, restArgs[0]);
-        case "set-cell":
-            return xlsxSetCell(toolArgs, restArgs);
-        case "clear-range":
-            return xlsxClearRange(toolArgs, restArgs);
-        case "merge":
-            return xlsxMerge(toolArgs, restArgs);
-        case "unmerge":
-            return xlsxUnmerge(toolArgs, restArgs);
-        case "add-sheet":
-            return xlsxAddSheet(toolArgs, restArgs);
-        case "delete-sheet":
-            return xlsxDeleteSheet(toolArgs, restArgs);
-        case "rename-sheet":
-            return xlsxRenameSheet(toolArgs, restArgs);
-        case "insert-rows":
-            return xlsxInsertRows(toolArgs, restArgs);
-        case "delete-rows":
-            return xlsxDeleteRows(toolArgs, restArgs);
-        case "insert-cols":
-            return xlsxInsertCols(toolArgs, restArgs);
-        case "delete-cols":
-            return xlsxDeleteCols(toolArgs, restArgs);
-        case "set-style":
-            return xlsxSetStyle(toolArgs, restArgs);
-        case "batch":
-            return xlsxBatch(toolArgs, restArgs[0]);
-        default: {
-            if (subcommand)
-                console.error(`Unknown xlsx subcommand: ${subcommand}\n`);
-            printXlsxHelp();
-            process.exit(subcommand ? 1 : 0);
-        }
-    }
-}

package/dist/xlsx.test.d.ts

@@ -1 +0,0 @@
-export {};