gridmd 1.0.0

package/dist/bin/gridmd-lint.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import {
+  lint
+} from "./chunk-jz0c1a5d.js";
+
+// bin/gridmd-lint.ts
+import { readFileSync } from "node:fs";
+var argv = process.argv.slice(2);
+var lenient = argv.includes("--lenient");
+var files = argv.filter((a) => !a.startsWith("--"));
+if (files.length === 0) {
+  console.error("usage: gridmd-lint [--lenient] <file.gmd> …");
+  process.exit(2);
+}
+var failed = false;
+for (const file of files) {
+  let source;
+  try {
+    source = readFileSync(file, "utf8");
+  } catch (e) {
+    console.error(`${file}: ${e instanceof Error ? e.message : String(e)}`);
+    failed = true;
+    continue;
+  }
+  const res = lint(source, { mode: lenient ? "lenient" : "strict" });
+  for (const w of res.warnings)
+    console.log(`${file}:${w.line}: warning: ${w.msg}`);
+  for (const e of res.errors)
+    console.log(`${file}:${e.line}: error: ${e.msg}`);
+  console.log(`${file}: ${res.errors.length} error(s), ${res.warnings.length} warning(s) — ` + `${res.sheets} sheet(s), ${res.cells} defined cell(s), ${res.blocks} block(s)`);
+  if (res.errors.length)
+    failed = true;
+}
+process.exit(failed ? 1 : 0);

package/dist/bin/gridmd2xlsx.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import {
+  buildWorkbookModel,
+  lint,
+  writeXlsx
+} from "./chunk-jz0c1a5d.js";
+
+// bin/gridmd2xlsx.ts
+import { readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+var argv = process.argv.slice(2);
+var strict = argv.includes("--strict");
+var files = argv.filter((a) => !a.startsWith("-"));
+var oIdx = argv.indexOf("-o");
+var outArg = oIdx !== -1 ? argv[oIdx + 1] : null;
+var input = files.filter((f) => f !== outArg)[0];
+if (!input) {
+  console.error("usage: gridmd2xlsx <file.gmd> [-o out.xlsx] [--strict]");
+  process.exit(2);
+}
+var source = readFileSync(input, "utf8");
+var res = lint(source, { mode: "strict" });
+if (res.errors.length) {
+  for (const e of res.errors)
+    console.error(`${input}:${e.line}: error: ${e.msg}`);
+  console.error(`${input}: ${res.errors.length} error(s) — fix the document before converting`);
+  process.exit(1);
+}
+var model = buildWorkbookModel(res.doc, { baseDir: dirname(input) });
+var { buffer, report } = writeXlsx(model);
+var out = outArg ?? input.replace(/\.gmd$/, "") + ".xlsx";
+writeFileSync(out, buffer);
+var notEmitted = report.filter((r) => r.action === "not-emitted");
+var carried = report.filter((r) => r.action === "carried");
+var partial = report.filter((r) => r.action === "partial");
+for (const r of report) {
+  console.log(`${input}:${r.line}: ${r.action}: ${r.feature}${r.note ? ` (${r.note})` : ""}`);
+}
+console.log(`${out}: written (${buffer.length} bytes) — ${carried.length} carried, ${partial.length} partial, ${notEmitted.length} not emitted`);
+if (notEmitted.length) {
+  console.log("fidelity: the features above are NOT in the .xlsx — v0 emits the worksheet core only (see INTEROP.md §2)");
+}
+process.exit(strict && notEmitted.length ? 1 : 0);

package/dist/bin/xlsx2gridmd.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import {
+  lint,
+  xlsxToGridmd
+} from "./chunk-jz0c1a5d.js";
+
+// bin/xlsx2gridmd.ts
+import { readFileSync, writeFileSync } from "node:fs";
+var argv = process.argv.slice(2);
+var files = argv.filter((a) => !a.startsWith("-"));
+var oIdx = argv.indexOf("-o");
+var outArg = oIdx !== -1 ? argv[oIdx + 1] : null;
+var input = files.filter((f) => f !== outArg)[0];
+if (!input) {
+  console.error("usage: xlsx2gridmd <file.xlsx> [-o out.gmd]");
+  process.exit(2);
+}
+var { gmd, report } = xlsxToGridmd(readFileSync(input));
+for (const r of report)
+  console.log(`${input}: ${r.action}: ${r.feature}${r.note ? ` (${r.note})` : ""}`);
+var res = lint(gmd, { mode: "strict" });
+for (const e of res.errors)
+  console.error(`self-check:${e.line}: error: ${e.msg}`);
+var out = outArg ?? input.replace(/\.(xlsx|xlsm)$/, "") + ".gmd";
+writeFileSync(out, gmd);
+console.log(`${out}: written — ${res.sheets} sheet(s), ${res.cells} defined cell(s); self-check ${res.errors.length === 0 ? "clean" : `FAILED (${res.errors.length} error(s))`}`);
+process.exit(res.errors.length ? 1 : 0);

package/dist/calc.d.ts

@@ -0,0 +1,41 @@
+import type { WorkbookModel } from './types';
+export declare class Unsupported extends Error {
+}
+declare const BLANK: unique symbol;
+type Blank = typeof BLANK;
+interface ErrVal {
+    err: string;
+}
+type Value = number | string | boolean | ErrVal | Blank | Value[];
+interface Ctx {
+    sheet: string;
+    col?: number;
+    row?: number;
+    env?: Map<string, Value>;
+}
+export interface Evaluator {
+    evaluateCell: (sheetName: string, ref: string) => Value;
+    evaluateFormula: (formula: string, ctx: Ctx) => Value;
+    BLANK: Blank;
+}
+export declare function createEvaluator(model: WorkbookModel): Evaluator;
+export interface Mismatch {
+    where: string;
+    formula: string;
+    cached: Value | null;
+    computed: Value;
+}
+export interface UnsupportedItem {
+    where: string;
+    formula: string;
+    reason: string;
+}
+export interface VerifyResult {
+    checked: number;
+    mismatches: Mismatch[];
+    unsupported: UnsupportedItem[];
+}
+export declare function verifyCachedValues(model: WorkbookModel, { tolerance }?: {
+    tolerance?: number;
+}): VerifyResult;
+export {};

package/dist/dump.d.ts

@@ -0,0 +1,2 @@
+import type { WorkbookModel } from './types';
+export declare function dumpModel(model: WorkbookModel): string;

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import type { LintResult } from './types';
+export { parseDocument } from './parser';
+export { validateDocument, isValidPartPath } from './validate';
+export { parseScalar, splitCached, ERROR_VALUES } from './scalar';
+export { parseTarget, parseCell, colToNum, numToCol, MAX_COL, MAX_ROW } from './refs';
+export { findPropsSplit, tryProps, splitPipeRow, parseInfoArgs, parseYaml, RESERVED_KINDS } from './parser';
+export { buildWorkbookModel, translateFormula } from './xlsx/model';
+export { writeXlsx } from './xlsx/write';
+export { xlsxToGridmd } from './xlsx/read';
+export { dumpModel } from './dump';
+export { verifyCachedValues, createEvaluator, Unsupported } from './calc';
+export { zipRead, zipWrite, crc32 } from './xlsx/zip';
+export type * from './types';
+export declare function lint(source: string, opts?: {
+    mode?: string;
+}): LintResult;