jsonstat-io 0.1.0

package/dist/chunk-VQCS4LVD.cjs

@@ -0,0 +1,166 @@
+'use strict';
+
+var chunkZEDTWRDN_cjs = require('./chunk-ZEDTWRDN.cjs');
+
+// src/core/cubeReader.ts
+var CubeReaderError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CubeReaderError";
+  }
+};
+function resolveCategories(dataset, dimId) {
+  const dim = dataset.dimension[dimId];
+  if (!dim) throw new CubeReaderError(`Missing dimension "${dimId}"`);
+  const cat = dim.category;
+  if (!cat) {
+    return {
+      categories: [dimId],
+      position: /* @__PURE__ */ new Map([[dimId, 0]])
+    };
+  }
+  const idx = cat.index;
+  let categories;
+  if (Array.isArray(idx)) {
+    categories = idx.slice();
+  } else if (idx && typeof idx === "object") {
+    categories = Object.entries(idx).sort((a, b) => a[1] - b[1]).map(([id]) => id);
+  } else {
+    if (cat.label && Object.keys(cat.label).length > 0) {
+      categories = Object.keys(cat.label);
+    } else {
+      categories = [dimId];
+    }
+  }
+  const position = /* @__PURE__ */ new Map();
+  categories.forEach((c, i) => position.set(c, i));
+  return { categories, position };
+}
+function materializeValues(dataset) {
+  const total = chunkZEDTWRDN_cjs.totalCells(dataset.size);
+  const value = dataset.value;
+  if (Array.isArray(value)) {
+    if (value.length !== total) {
+      throw new CubeReaderError(
+        `value array length ${value.length} \u2260 product(size) ${total}`
+      );
+    }
+    return value.slice();
+  }
+  const dense = new Array(total).fill(null);
+  for (const [k, v] of Object.entries(value)) {
+    const pos = Number(k);
+    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {
+      throw new CubeReaderError(`Sparse value key "${k}" is out of range`);
+    }
+    dense[pos] = v;
+  }
+  return dense;
+}
+function normalizeStatus(status, total) {
+  if (status === void 0) return void 0;
+  if (typeof status === "string") {
+    return new Array(total).fill(status);
+  }
+  if (Array.isArray(status)) {
+    if (status.length !== total) {
+      throw new CubeReaderError(
+        `status array length ${status.length} \u2260 product(size) ${total}`
+      );
+    }
+    return status.slice();
+  }
+  const out = new Array(total).fill("");
+  for (const [k, v] of Object.entries(status)) {
+    const pos = Number(k);
+    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {
+      throw new CubeReaderError(`Sparse status key "${k}" is out of range`);
+    }
+    out[pos] = v;
+  }
+  return out;
+}
+function readDataset(dataset, options = {}) {
+  if (dataset.class !== "dataset") {
+    throw new CubeReaderError(`Expected class "dataset", got "${dataset.class}"`);
+  }
+  const dropNulls = options.dropNulls ?? true;
+  const dimIds = dataset.id;
+  const resolvedDims = dimIds.map((id) => ({
+    id,
+    ...resolveCategories(dataset, id)
+  }));
+  const total = chunkZEDTWRDN_cjs.totalCells(dataset.size);
+  const denseValues = materializeValues(dataset);
+  const denseStatus = normalizeStatus(dataset.status, total);
+  const dimValues = dimIds.map(() => []);
+  const measureValues = [];
+  const statusValues = [];
+  for (let pos = 0; pos < total; pos++) {
+    const v = denseValues[pos];
+    if (dropNulls && v === null) continue;
+    const idx = chunkZEDTWRDN_cjs.multiIndex(pos, dataset.size);
+    for (let d = 0; d < dimIds.length; d++) {
+      dimValues[d].push(resolvedDims[d].categories[idx[d]]);
+    }
+    measureValues.push(v);
+    if (denseStatus) statusValues.push(denseStatus[pos]);
+  }
+  const dimensions = {};
+  for (let d = 0; d < dimIds.length; d++) {
+    const id = dimIds[d];
+    const dim = dataset.dimension[id];
+    const cat = dim?.category;
+    dimensions[id] = {
+      id,
+      values: dimValues[d],
+      categoryOrder: resolvedDims[d].categories.slice(),
+      categoryLabels: cat?.label ? { ...cat.label } : void 0,
+      categoryUnits: cat?.unit ? { ...cat.unit } : void 0,
+      categoryCoordinates: cat?.coordinates ? { ...cat.coordinates } : void 0,
+      categoryChild: cat?.child ? { ...cat.child } : void 0,
+      label: dim?.label,
+      href: dim?.href
+    };
+  }
+  const measure = { values: measureValues };
+  let status;
+  if (denseStatus) {
+    status = { values: statusValues };
+  }
+  const obs = {
+    dimensions,
+    measure,
+    status,
+    model: {
+      dimensionIds: dimIds.slice(),
+      roles: dataset.role ? { ...dataset.role } : void 0,
+      meta: {
+        label: dataset.label,
+        source: dataset.source,
+        updated: dataset.updated,
+        extension: dataset.extension ? { ...dataset.extension } : void 0
+      },
+      // Preserve the original value form so a round-trip is byte-stable when
+      // the builder is run with defaults.
+      valueForm: Array.isArray(dataset.value) ? "dense" : "sparse",
+      statusForm: dataset.status ? typeof dataset.status === "string" ? "string" : Array.isArray(dataset.status) ? "array" : "object" : "none"
+    }
+  };
+  return obs;
+}
+function readResponse(response, options) {
+  const ds = response;
+  if (!ds || ds.version !== "2.0" || ds.class !== "dataset") {
+    throw new CubeReaderError(
+      "Input is not a JSON-stat 2.0 dataset response (missing version/class)"
+    );
+  }
+  return readDataset(ds, options);
+}
+
+exports.CubeReaderError = CubeReaderError;
+exports.readDataset = readDataset;
+exports.readResponse = readResponse;
+//# sourceMappingURL=chunk-VQCS4LVD.cjs.map
+//# sourceMappingURL=chunk-VQCS4LVD.cjs.map

package/dist/chunk-VQCS4LVD.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/cubeReader.ts"],"names":["totalCells","multiIndex"],"mappings":"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","file":"chunk-VQCS4LVD.cjs","sourcesContent":["/**\n * CubeReader — the inverse of [`CubeBuilder`](./cubeBuilder.ts): converts a\n * JSON-stat [`Dataset`](../model/jsonstat.ts) back into the\n * [`Observations`](../model/ir.ts) IR (a tidy long table).\n *\n * ## Why this exists now (Phase-1 import project)\n *\n * Although the primary deliverable is *import* (columnar → JSON-stat), the\n * reader is shipped in v0.1 for two reasons:\n *\n *  1. **Round-trip fidelity tests.** The canonical JSON-stat samples\n *     (oecd, canada, galicia, order, hierarchy, us-gsp, us-unr — see\n *     wiki/sample-files.md) are read into the IR, written back through the\n *     builder, and asserted equal. This is the strongest correctness proof we\n *     have that the importer faithfully preserves the JSON-stat model.\n *\n *  2. **The Phase-2 export seam.** Export (JSON-stat → columnar) is\n *     `cubeReader` → IR → [`arrowFromCube`](../arrow/arrowFromCube.ts) →\n *     Arrow/Parquet/DuckDB/Polars/CSV writers. Building the reader now means\n *     the IR is verified bidirectional, and Phase 2 is \"just\" the writers.\n *     See [docs/architecture.md](../../docs/architecture.md) §\"The two seams\".\n *\n * ## Semantics\n *\n * The reader *materializes the dense cube* from `value` (handling both the\n * array form and the sparse object form — see wiki/sparse-cubes.md), then walks\n * every cell in row-major order ([`multiIndex`](./strides.ts)) to emit one\n * observation per cell. Missing cells (`null`) are emitted as rows with a\n * `null` measure, preserving the full Cartesian product of categories — which\n * is what round-trip equality requires.\n *\n * `status` is normalized back to a per-row `StatusColumn` regardless of whether\n * the source used the string, array, or object form.\n */\n\nimport type {\n  DimensionColumn,\n  MeasureColumn,\n  Observations,\n  StatusColumn,\n} from \"../model/ir\";\nimport type {\n  JsonStatDataset,\n  JsonStatStatus,\n  JsonStatValue,\n} from \"../model/jsonstat\";\nimport { multiIndex, totalCells } from \"./strides\";\n\n// ---------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------\n\n/** Thrown when a dataset cannot be read (malformed or unsupported). */\nexport class CubeReaderError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CubeReaderError\";\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Category index resolution\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve a dimension's categories into an ordered array + position map,\n * mirroring [`resolveDimension`](./cubeBuilder.ts) but reading from the\n * JSON-stat `category.index` (array or object form).\n */\nfunction resolveCategories(\n  dataset: JsonStatDataset,\n  dimId: string,\n): { categories: string[]; position: Map<string, number> } {\n  const dim = dataset.dimension[dimId];\n  if (!dim) throw new CubeReaderError(`Missing dimension \"${dimId}\"`);\n  const cat = dim.category;\n  if (!cat) {\n    // A dimension with no category block: treat as a single implicit category.\n    return {\n      categories: [dimId],\n      position: new Map([[dimId, 0]]),\n    };\n  }\n  const idx = cat.index;\n  let categories: string[];\n  if (Array.isArray(idx)) {\n    categories = idx.slice();\n  } else if (idx && typeof idx === \"object\") {\n    // Object form: ID → position. Sort by position ascending.\n    categories = Object.entries(idx)\n      .sort((a, b) => a[1] - b[1])\n      .map(([id]) => id);\n  } else {\n    // No index: if there's a label object, derive categories from its keys;\n    // otherwise it's a constant dimension with a single implicit category.\n    if (cat.label && Object.keys(cat.label).length > 0) {\n      categories = Object.keys(cat.label);\n    } else {\n      categories = [dimId];\n    }\n  }\n  const position = new Map<string, number>();\n  categories.forEach((c, i) => position.set(c, i));\n  return { categories, position };\n}\n\n// ---------------------------------------------------------------------------\n// Value materialization (dense cube from dense or sparse `value`)\n// ---------------------------------------------------------------------------\n\n/**\n * Materialize the full dense value array (length = product of `size`),\n * regardless of whether `value` is the dense array form or the sparse object\n * form. Missing cells become `null`.\n */\nfunction materializeValues(dataset: JsonStatDataset): (number | null)[] {\n  const total = totalCells(dataset.size);\n  const value = dataset.value as JsonStatValue;\n  if (Array.isArray(value)) {\n    if (value.length !== total) {\n      throw new CubeReaderError(\n        `value array length ${value.length} ≠ product(size) ${total}`,\n      );\n    }\n    return value.slice();\n  }\n  // Sparse object form: keys are stringified flat positions.\n  const dense: (number | null)[] = new Array(total).fill(null);\n  for (const [k, v] of Object.entries(value)) {\n    const pos = Number(k);\n    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {\n      throw new CubeReaderError(`Sparse value key \"${k}\" is out of range`);\n    }\n    dense[pos] = v;\n  }\n  return dense;\n}\n\n// ---------------------------------------------------------------------------\n// Status normalization\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize any `status` form (string / array / object) into a per-cell array\n * of length `total`. Empty string means \"no status for this cell\".\n */\nfunction normalizeStatus(\n  status: JsonStatStatus | undefined,\n  total: number,\n): string[] | undefined {\n  if (status === undefined) return undefined;\n  if (typeof status === \"string\") {\n    return new Array(total).fill(status);\n  }\n  if (Array.isArray(status)) {\n    if (status.length !== total) {\n      throw new CubeReaderError(\n        `status array length ${status.length} ≠ product(size) ${total}`,\n      );\n    }\n    return status.slice();\n  }\n  // Object form: position → status. Default \"\" for cells without an entry.\n  const out = new Array<string>(total).fill(\"\");\n  for (const [k, v] of Object.entries(status)) {\n    const pos = Number(k);\n    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {\n      throw new CubeReaderError(`Sparse status key \"${k}\" is out of range`);\n    }\n    out[pos] = v;\n  }\n  return out;\n}\n\n// ---------------------------------------------------------------------------\n// Reader\n// ---------------------------------------------------------------------------\n\nexport interface ReadOptions {\n  /**\n   * When true (default), cells whose measure is `null` are *omitted* from the\n   * emitted long table (a truly sparse/tidy representation). When false, every\n   * cell — including nulls — is emitted as a row (required for exact round-trip\n   * equality against a dense `value` array).\n   */\n  dropNulls?: boolean;\n}\n\n/**\n * Read a JSON-stat [`Dataset`](../model/jsonstat.ts) into the\n * [`Observations`](../model/ir.ts) IR.\n *\n * @throws [`CubeReaderError`](#cubereadererror) on structural problems.\n */\nexport function readDataset(\n  dataset: JsonStatDataset,\n  options: ReadOptions = {},\n): Observations {\n  if (dataset.class !== \"dataset\") {\n    throw new CubeReaderError(`Expected class \"dataset\", got \"${dataset.class}\"`);\n  }\n  const dropNulls = options.dropNulls ?? true;\n\n  const dimIds = dataset.id;\n  const resolvedDims = dimIds.map((id) => ({\n    id,\n    ...resolveCategories(dataset, id),\n  }));\n\n  const total = totalCells(dataset.size);\n  const denseValues = materializeValues(dataset);\n  const denseStatus = normalizeStatus(dataset.status, total);\n\n  // Walk every cell in row-major order, emitting one observation per cell.\n  const dimValues: string[][] = dimIds.map(() => []);\n  const measureValues: (number | null)[] = [];\n  const statusValues: string[] = [];\n\n  for (let pos = 0; pos < total; pos++) {\n    const v = denseValues[pos];\n    if (dropNulls && v === null) continue;\n    const idx = multiIndex(pos, dataset.size);\n    for (let d = 0; d < dimIds.length; d++) {\n      dimValues[d].push(resolvedDims[d].categories[idx[d]]);\n    }\n    measureValues.push(v);\n    if (denseStatus) statusValues.push(denseStatus[pos]);\n  }\n\n  // Build dimension columns from the resolved metadata + the per-row values.\n  const dimensions: Record<string, DimensionColumn> = {};\n  for (let d = 0; d < dimIds.length; d++) {\n    const id = dimIds[d];\n    const dim = dataset.dimension[id];\n    const cat = dim?.category;\n    dimensions[id] = {\n      id,\n      values: dimValues[d],\n      categoryOrder: resolvedDims[d].categories.slice(),\n      categoryLabels: cat?.label ? { ...cat.label } : undefined,\n      categoryUnits: cat?.unit ? { ...cat.unit } : undefined,\n      categoryCoordinates: cat?.coordinates ? { ...cat.coordinates } : undefined,\n      categoryChild: cat?.child ? { ...cat.child } : undefined,\n      label: dim?.label,\n      href: dim?.href,\n    };\n  }\n\n  const measure: MeasureColumn = { values: measureValues };\n\n  let status: StatusColumn | undefined;\n  if (denseStatus) {\n    status = { values: statusValues };\n  }\n\n  // Reconstruct the cube model so the result can be fed straight back to the\n  // builder and round-trip.\n  const obs: Observations = {\n    dimensions,\n    measure,\n    status,\n    model: {\n      dimensionIds: dimIds.slice(),\n      roles: dataset.role ? { ...dataset.role } : undefined,\n      meta: {\n        label: dataset.label,\n        source: dataset.source,\n        updated: dataset.updated,\n        extension: dataset.extension ? { ...dataset.extension } : undefined,\n      },\n      // Preserve the original value form so a round-trip is byte-stable when\n      // the builder is run with defaults.\n      valueForm: Array.isArray(dataset.value) ? \"dense\" : \"sparse\",\n      statusForm: dataset.status\n        ? typeof dataset.status === \"string\"\n          ? \"string\"\n          : Array.isArray(dataset.status)\n            ? \"array\"\n            : \"object\"\n        : \"none\",\n    },\n  };\n\n  return obs;\n}\n\n/** Convenience: read a JSON-stat response, rejecting non-dataset classes. */\nexport function readResponse(\n  response: unknown,\n  options?: ReadOptions,\n): Observations {\n  const ds = response as JsonStatDataset;\n  if (!ds || ds.version !== \"2.0\" || ds.class !== \"dataset\") {\n    throw new CubeReaderError(\n      \"Input is not a JSON-stat 2.0 dataset response (missing version/class)\",\n    );\n  }\n  return readDataset(ds, options);\n}\n"]}

package/dist/chunk-VYS7DPB3.js

@@ -0,0 +1,162 @@
+import { totalCells, multiIndex } from './chunk-L65CRXTV.js';
+
+// src/core/cubeReader.ts
+var CubeReaderError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CubeReaderError";
+  }
+};
+function resolveCategories(dataset, dimId) {
+  const dim = dataset.dimension[dimId];
+  if (!dim) throw new CubeReaderError(`Missing dimension "${dimId}"`);
+  const cat = dim.category;
+  if (!cat) {
+    return {
+      categories: [dimId],
+      position: /* @__PURE__ */ new Map([[dimId, 0]])
+    };
+  }
+  const idx = cat.index;
+  let categories;
+  if (Array.isArray(idx)) {
+    categories = idx.slice();
+  } else if (idx && typeof idx === "object") {
+    categories = Object.entries(idx).sort((a, b) => a[1] - b[1]).map(([id]) => id);
+  } else {
+    if (cat.label && Object.keys(cat.label).length > 0) {
+      categories = Object.keys(cat.label);
+    } else {
+      categories = [dimId];
+    }
+  }
+  const position = /* @__PURE__ */ new Map();
+  categories.forEach((c, i) => position.set(c, i));
+  return { categories, position };
+}
+function materializeValues(dataset) {
+  const total = totalCells(dataset.size);
+  const value = dataset.value;
+  if (Array.isArray(value)) {
+    if (value.length !== total) {
+      throw new CubeReaderError(
+        `value array length ${value.length} \u2260 product(size) ${total}`
+      );
+    }
+    return value.slice();
+  }
+  const dense = new Array(total).fill(null);
+  for (const [k, v] of Object.entries(value)) {
+    const pos = Number(k);
+    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {
+      throw new CubeReaderError(`Sparse value key "${k}" is out of range`);
+    }
+    dense[pos] = v;
+  }
+  return dense;
+}
+function normalizeStatus(status, total) {
+  if (status === void 0) return void 0;
+  if (typeof status === "string") {
+    return new Array(total).fill(status);
+  }
+  if (Array.isArray(status)) {
+    if (status.length !== total) {
+      throw new CubeReaderError(
+        `status array length ${status.length} \u2260 product(size) ${total}`
+      );
+    }
+    return status.slice();
+  }
+  const out = new Array(total).fill("");
+  for (const [k, v] of Object.entries(status)) {
+    const pos = Number(k);
+    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {
+      throw new CubeReaderError(`Sparse status key "${k}" is out of range`);
+    }
+    out[pos] = v;
+  }
+  return out;
+}
+function readDataset(dataset, options = {}) {
+  if (dataset.class !== "dataset") {
+    throw new CubeReaderError(`Expected class "dataset", got "${dataset.class}"`);
+  }
+  const dropNulls = options.dropNulls ?? true;
+  const dimIds = dataset.id;
+  const resolvedDims = dimIds.map((id) => ({
+    id,
+    ...resolveCategories(dataset, id)
+  }));
+  const total = totalCells(dataset.size);
+  const denseValues = materializeValues(dataset);
+  const denseStatus = normalizeStatus(dataset.status, total);
+  const dimValues = dimIds.map(() => []);
+  const measureValues = [];
+  const statusValues = [];
+  for (let pos = 0; pos < total; pos++) {
+    const v = denseValues[pos];
+    if (dropNulls && v === null) continue;
+    const idx = multiIndex(pos, dataset.size);
+    for (let d = 0; d < dimIds.length; d++) {
+      dimValues[d].push(resolvedDims[d].categories[idx[d]]);
+    }
+    measureValues.push(v);
+    if (denseStatus) statusValues.push(denseStatus[pos]);
+  }
+  const dimensions = {};
+  for (let d = 0; d < dimIds.length; d++) {
+    const id = dimIds[d];
+    const dim = dataset.dimension[id];
+    const cat = dim?.category;
+    dimensions[id] = {
+      id,
+      values: dimValues[d],
+      categoryOrder: resolvedDims[d].categories.slice(),
+      categoryLabels: cat?.label ? { ...cat.label } : void 0,
+      categoryUnits: cat?.unit ? { ...cat.unit } : void 0,
+      categoryCoordinates: cat?.coordinates ? { ...cat.coordinates } : void 0,
+      categoryChild: cat?.child ? { ...cat.child } : void 0,
+      label: dim?.label,
+      href: dim?.href
+    };
+  }
+  const measure = { values: measureValues };
+  let status;
+  if (denseStatus) {
+    status = { values: statusValues };
+  }
+  const obs = {
+    dimensions,
+    measure,
+    status,
+    model: {
+      dimensionIds: dimIds.slice(),
+      roles: dataset.role ? { ...dataset.role } : void 0,
+      meta: {
+        label: dataset.label,
+        source: dataset.source,
+        updated: dataset.updated,
+        extension: dataset.extension ? { ...dataset.extension } : void 0
+      },
+      // Preserve the original value form so a round-trip is byte-stable when
+      // the builder is run with defaults.
+      valueForm: Array.isArray(dataset.value) ? "dense" : "sparse",
+      statusForm: dataset.status ? typeof dataset.status === "string" ? "string" : Array.isArray(dataset.status) ? "array" : "object" : "none"
+    }
+  };
+  return obs;
+}
+function readResponse(response, options) {
+  const ds = response;
+  if (!ds || ds.version !== "2.0" || ds.class !== "dataset") {
+    throw new CubeReaderError(
+      "Input is not a JSON-stat 2.0 dataset response (missing version/class)"
+    );
+  }
+  return readDataset(ds, options);
+}
+
+export { CubeReaderError, readDataset, readResponse };
+//# sourceMappingURL=chunk-VYS7DPB3.js.map
+//# sourceMappingURL=chunk-VYS7DPB3.js.map

package/dist/chunk-VYS7DPB3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/cubeReader.ts"],"names":[],"mappings":"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","file":"chunk-VYS7DPB3.js","sourcesContent":["/**\n * CubeReader — the inverse of [`CubeBuilder`](./cubeBuilder.ts): converts a\n * JSON-stat [`Dataset`](../model/jsonstat.ts) back into the\n * [`Observations`](../model/ir.ts) IR (a tidy long table).\n *\n * ## Why this exists now (Phase-1 import project)\n *\n * Although the primary deliverable is *import* (columnar → JSON-stat), the\n * reader is shipped in v0.1 for two reasons:\n *\n *  1. **Round-trip fidelity tests.** The canonical JSON-stat samples\n *     (oecd, canada, galicia, order, hierarchy, us-gsp, us-unr — see\n *     wiki/sample-files.md) are read into the IR, written back through the\n *     builder, and asserted equal. This is the strongest correctness proof we\n *     have that the importer faithfully preserves the JSON-stat model.\n *\n *  2. **The Phase-2 export seam.** Export (JSON-stat → columnar) is\n *     `cubeReader` → IR → [`arrowFromCube`](../arrow/arrowFromCube.ts) →\n *     Arrow/Parquet/DuckDB/Polars/CSV writers. Building the reader now means\n *     the IR is verified bidirectional, and Phase 2 is \"just\" the writers.\n *     See [docs/architecture.md](../../docs/architecture.md) §\"The two seams\".\n *\n * ## Semantics\n *\n * The reader *materializes the dense cube* from `value` (handling both the\n * array form and the sparse object form — see wiki/sparse-cubes.md), then walks\n * every cell in row-major order ([`multiIndex`](./strides.ts)) to emit one\n * observation per cell. Missing cells (`null`) are emitted as rows with a\n * `null` measure, preserving the full Cartesian product of categories — which\n * is what round-trip equality requires.\n *\n * `status` is normalized back to a per-row `StatusColumn` regardless of whether\n * the source used the string, array, or object form.\n */\n\nimport type {\n  DimensionColumn,\n  MeasureColumn,\n  Observations,\n  StatusColumn,\n} from \"../model/ir\";\nimport type {\n  JsonStatDataset,\n  JsonStatStatus,\n  JsonStatValue,\n} from \"../model/jsonstat\";\nimport { multiIndex, totalCells } from \"./strides\";\n\n// ---------------------------------------------------------------------------\n// Errors\n// ---------------------------------------------------------------------------\n\n/** Thrown when a dataset cannot be read (malformed or unsupported). */\nexport class CubeReaderError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CubeReaderError\";\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Category index resolution\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve a dimension's categories into an ordered array + position map,\n * mirroring [`resolveDimension`](./cubeBuilder.ts) but reading from the\n * JSON-stat `category.index` (array or object form).\n */\nfunction resolveCategories(\n  dataset: JsonStatDataset,\n  dimId: string,\n): { categories: string[]; position: Map<string, number> } {\n  const dim = dataset.dimension[dimId];\n  if (!dim) throw new CubeReaderError(`Missing dimension \"${dimId}\"`);\n  const cat = dim.category;\n  if (!cat) {\n    // A dimension with no category block: treat as a single implicit category.\n    return {\n      categories: [dimId],\n      position: new Map([[dimId, 0]]),\n    };\n  }\n  const idx = cat.index;\n  let categories: string[];\n  if (Array.isArray(idx)) {\n    categories = idx.slice();\n  } else if (idx && typeof idx === \"object\") {\n    // Object form: ID → position. Sort by position ascending.\n    categories = Object.entries(idx)\n      .sort((a, b) => a[1] - b[1])\n      .map(([id]) => id);\n  } else {\n    // No index: if there's a label object, derive categories from its keys;\n    // otherwise it's a constant dimension with a single implicit category.\n    if (cat.label && Object.keys(cat.label).length > 0) {\n      categories = Object.keys(cat.label);\n    } else {\n      categories = [dimId];\n    }\n  }\n  const position = new Map<string, number>();\n  categories.forEach((c, i) => position.set(c, i));\n  return { categories, position };\n}\n\n// ---------------------------------------------------------------------------\n// Value materialization (dense cube from dense or sparse `value`)\n// ---------------------------------------------------------------------------\n\n/**\n * Materialize the full dense value array (length = product of `size`),\n * regardless of whether `value` is the dense array form or the sparse object\n * form. Missing cells become `null`.\n */\nfunction materializeValues(dataset: JsonStatDataset): (number | null)[] {\n  const total = totalCells(dataset.size);\n  const value = dataset.value as JsonStatValue;\n  if (Array.isArray(value)) {\n    if (value.length !== total) {\n      throw new CubeReaderError(\n        `value array length ${value.length} ≠ product(size) ${total}`,\n      );\n    }\n    return value.slice();\n  }\n  // Sparse object form: keys are stringified flat positions.\n  const dense: (number | null)[] = new Array(total).fill(null);\n  for (const [k, v] of Object.entries(value)) {\n    const pos = Number(k);\n    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {\n      throw new CubeReaderError(`Sparse value key \"${k}\" is out of range`);\n    }\n    dense[pos] = v;\n  }\n  return dense;\n}\n\n// ---------------------------------------------------------------------------\n// Status normalization\n// ---------------------------------------------------------------------------\n\n/**\n * Normalize any `status` form (string / array / object) into a per-cell array\n * of length `total`. Empty string means \"no status for this cell\".\n */\nfunction normalizeStatus(\n  status: JsonStatStatus | undefined,\n  total: number,\n): string[] | undefined {\n  if (status === undefined) return undefined;\n  if (typeof status === \"string\") {\n    return new Array(total).fill(status);\n  }\n  if (Array.isArray(status)) {\n    if (status.length !== total) {\n      throw new CubeReaderError(\n        `status array length ${status.length} ≠ product(size) ${total}`,\n      );\n    }\n    return status.slice();\n  }\n  // Object form: position → status. Default \"\" for cells without an entry.\n  const out = new Array<string>(total).fill(\"\");\n  for (const [k, v] of Object.entries(status)) {\n    const pos = Number(k);\n    if (!Number.isInteger(pos) || pos < 0 || pos >= total) {\n      throw new CubeReaderError(`Sparse status key \"${k}\" is out of range`);\n    }\n    out[pos] = v;\n  }\n  return out;\n}\n\n// ---------------------------------------------------------------------------\n// Reader\n// ---------------------------------------------------------------------------\n\nexport interface ReadOptions {\n  /**\n   * When true (default), cells whose measure is `null` are *omitted* from the\n   * emitted long table (a truly sparse/tidy representation). When false, every\n   * cell — including nulls — is emitted as a row (required for exact round-trip\n   * equality against a dense `value` array).\n   */\n  dropNulls?: boolean;\n}\n\n/**\n * Read a JSON-stat [`Dataset`](../model/jsonstat.ts) into the\n * [`Observations`](../model/ir.ts) IR.\n *\n * @throws [`CubeReaderError`](#cubereadererror) on structural problems.\n */\nexport function readDataset(\n  dataset: JsonStatDataset,\n  options: ReadOptions = {},\n): Observations {\n  if (dataset.class !== \"dataset\") {\n    throw new CubeReaderError(`Expected class \"dataset\", got \"${dataset.class}\"`);\n  }\n  const dropNulls = options.dropNulls ?? true;\n\n  const dimIds = dataset.id;\n  const resolvedDims = dimIds.map((id) => ({\n    id,\n    ...resolveCategories(dataset, id),\n  }));\n\n  const total = totalCells(dataset.size);\n  const denseValues = materializeValues(dataset);\n  const denseStatus = normalizeStatus(dataset.status, total);\n\n  // Walk every cell in row-major order, emitting one observation per cell.\n  const dimValues: string[][] = dimIds.map(() => []);\n  const measureValues: (number | null)[] = [];\n  const statusValues: string[] = [];\n\n  for (let pos = 0; pos < total; pos++) {\n    const v = denseValues[pos];\n    if (dropNulls && v === null) continue;\n    const idx = multiIndex(pos, dataset.size);\n    for (let d = 0; d < dimIds.length; d++) {\n      dimValues[d].push(resolvedDims[d].categories[idx[d]]);\n    }\n    measureValues.push(v);\n    if (denseStatus) statusValues.push(denseStatus[pos]);\n  }\n\n  // Build dimension columns from the resolved metadata + the per-row values.\n  const dimensions: Record<string, DimensionColumn> = {};\n  for (let d = 0; d < dimIds.length; d++) {\n    const id = dimIds[d];\n    const dim = dataset.dimension[id];\n    const cat = dim?.category;\n    dimensions[id] = {\n      id,\n      values: dimValues[d],\n      categoryOrder: resolvedDims[d].categories.slice(),\n      categoryLabels: cat?.label ? { ...cat.label } : undefined,\n      categoryUnits: cat?.unit ? { ...cat.unit } : undefined,\n      categoryCoordinates: cat?.coordinates ? { ...cat.coordinates } : undefined,\n      categoryChild: cat?.child ? { ...cat.child } : undefined,\n      label: dim?.label,\n      href: dim?.href,\n    };\n  }\n\n  const measure: MeasureColumn = { values: measureValues };\n\n  let status: StatusColumn | undefined;\n  if (denseStatus) {\n    status = { values: statusValues };\n  }\n\n  // Reconstruct the cube model so the result can be fed straight back to the\n  // builder and round-trip.\n  const obs: Observations = {\n    dimensions,\n    measure,\n    status,\n    model: {\n      dimensionIds: dimIds.slice(),\n      roles: dataset.role ? { ...dataset.role } : undefined,\n      meta: {\n        label: dataset.label,\n        source: dataset.source,\n        updated: dataset.updated,\n        extension: dataset.extension ? { ...dataset.extension } : undefined,\n      },\n      // Preserve the original value form so a round-trip is byte-stable when\n      // the builder is run with defaults.\n      valueForm: Array.isArray(dataset.value) ? \"dense\" : \"sparse\",\n      statusForm: dataset.status\n        ? typeof dataset.status === \"string\"\n          ? \"string\"\n          : Array.isArray(dataset.status)\n            ? \"array\"\n            : \"object\"\n        : \"none\",\n    },\n  };\n\n  return obs;\n}\n\n/** Convenience: read a JSON-stat response, rejecting non-dataset classes. */\nexport function readResponse(\n  response: unknown,\n  options?: ReadOptions,\n): Observations {\n  const ds = response as JsonStatDataset;\n  if (!ds || ds.version !== \"2.0\" || ds.class !== \"dataset\") {\n    throw new CubeReaderError(\n      \"Input is not a JSON-stat 2.0 dataset response (missing version/class)\",\n    );\n  }\n  return readDataset(ds, options);\n}\n"]}

package/dist/chunk-ZEDTWRDN.cjs

@@ -0,0 +1,70 @@
+'use strict';
+
+// src/core/strides.ts
+function strides(size) {
+  const out = new Array(size.length);
+  let acc = 1;
+  for (let d = size.length - 1; d >= 0; d--) {
+    out[d] = acc;
+    acc *= size[d];
+  }
+  return out;
+}
+function totalCells(size) {
+  return size.reduce((a, b) => a * b, 1);
+}
+function flatPosition(indices, size) {
+  if (indices.length !== size.length) {
+    throw new Error(
+      `flatPosition: indices length ${indices.length} !== size length ${size.length}`
+    );
+  }
+  const s = strides(size);
+  let pos = 0;
+  for (let d = 0; d < indices.length; d++) {
+    const i = indices[d];
+    if (i < 0 || i >= size[d]) {
+      throw new Error(
+        `flatPosition: index ${i} out of range [0,${size[d]}) for dimension ${d}`
+      );
+    }
+    pos += i * s[d];
+  }
+  return pos;
+}
+function multiIndex(pos, size) {
+  const s = strides(size);
+  const total = totalCells(size);
+  if (pos < 0 || pos >= total) {
+    throw new Error(`multiIndex: position ${pos} out of range [0,${total})`);
+  }
+  const out = new Array(size.length);
+  let rem = pos;
+  for (let d = 0; d < size.length; d++) {
+    out[d] = Math.floor(rem / s[d]);
+    rem = rem % s[d];
+  }
+  return out;
+}
+function enumerateCells(size, visit) {
+  const k = size.length;
+  const total = totalCells(size);
+  if (total === 0) return;
+  const idx = new Array(k).fill(0);
+  for (let pos = 0; pos < total; pos++) {
+    visit(idx.slice(), pos);
+    for (let d = k - 1; d >= 0; d--) {
+      idx[d]++;
+      if (idx[d] < size[d]) break;
+      idx[d] = 0;
+    }
+  }
+}
+
+exports.enumerateCells = enumerateCells;
+exports.flatPosition = flatPosition;
+exports.multiIndex = multiIndex;
+exports.strides = strides;
+exports.totalCells = totalCells;
+//# sourceMappingURL=chunk-ZEDTWRDN.cjs.map
+//# sourceMappingURL=chunk-ZEDTWRDN.cjs.map

package/dist/chunk-ZEDTWRDN.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/strides.ts"],"names":[],"mappings":"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","file":"chunk-ZEDTWRDN.cjs","sourcesContent":["/**\n * Row-major index math — the correctness backbone of the importer.\n *\n * JSON-stat stores cell values in a flat array laid out in **row-major order**,\n * described by the spec as \"what does not change, first\": the *last* dimension\n * in `id` changes fastest (see wiki/format-specification.md and\n * wiki/sparse-cubes.md).\n *\n * Concretely, for dimensions with sizes `s₀, s₁, …, sₖ₋₁`, the flat position of\n * a cell at multi-index `(i₀, i₁, …, iₖ₋₁)` is:\n *\n *     pos = i₀·(s₁·…·sₖ₋₁) + i₁·(s₂·…·sₖ₋₁) + … + iₖ₋₂·sₖ₋₁ + iₖ₋₁\n *\n * i.e. the stride of dimension `d` is the product of the sizes of all\n * dimensions that come *after* it. This module centralizes that arithmetic so\n * every converter and the round-trip tests share one source of truth.\n */\n\n/** Compute row-major strides from a `size` array. strides[d] = ∏ size[d+1..]. */\nexport function strides(size: number[]): number[] {\n  const out = new Array<number>(size.length);\n  let acc = 1;\n  // Walk right-to-left so each stride is the running product of later sizes.\n  for (let d = size.length - 1; d >= 0; d--) {\n    out[d] = acc;\n    acc *= size[d];\n  }\n  return out;\n}\n\n/** Total number of cells = product of all sizes (the dense cell count). */\nexport function totalCells(size: number[]): number {\n  return size.reduce((a, b) => a * b, 1);\n}\n\n/**\n * Convert a multi-index to a flat row-major position.\n *\n * `indices` length must equal `size` length; each `indices[d]` must satisfy\n * `0 ≤ indices[d] < size[d]`.\n */\nexport function flatPosition(indices: number[], size: number[]): number {\n  if (indices.length !== size.length) {\n    throw new Error(\n      `flatPosition: indices length ${indices.length} !== size length ${size.length}`,\n    );\n  }\n  const s = strides(size);\n  let pos = 0;\n  for (let d = 0; d < indices.length; d++) {\n    const i = indices[d];\n    if (i < 0 || i >= size[d]) {\n      throw new Error(\n        `flatPosition: index ${i} out of range [0,${size[d]}) for dimension ${d}`,\n      );\n    }\n    pos += i * s[d];\n  }\n  return pos;\n}\n\n/**\n * Inverse of [`flatPosition`](#flatposition): decompose a flat position back\n * into a multi-index. Used by the cube reader (Phase-2 seam) and by tests.\n */\nexport function multiIndex(pos: number, size: number[]): number[] {\n  const s = strides(size);\n  const total = totalCells(size);\n  if (pos < 0 || pos >= total) {\n    throw new Error(`multiIndex: position ${pos} out of range [0,${total})`);\n  }\n  const out = new Array<number>(size.length);\n  let rem = pos;\n  for (let d = 0; d < size.length; d++) {\n    out[d] = Math.floor(rem / s[d]);\n    rem = rem % s[d];\n  }\n  return out;\n}\n\n/**\n * Enumerate every multi-index in row-major order, yielding flat positions\n * 0..(total-1). Useful for materializing a dense value array from a sparse map.\n *\n * Calls `visit(indices, flatPos)` for each cell. Iterative (no recursion) to\n * avoid stack overflow on large cubes.\n */\nexport function enumerateCells(\n  size: number[],\n  visit: (indices: number[], flatPos: number) => void,\n): void {\n  const k = size.length;\n  const total = totalCells(size);\n  if (total === 0) return;\n  const idx = new Array<number>(k).fill(0);\n  for (let pos = 0; pos < total; pos++) {\n    visit(idx.slice(), pos);\n    // Increment the last dimension first (it changes fastest), carrying over.\n    for (let d = k - 1; d >= 0; d--) {\n      idx[d]++;\n      if (idx[d] < size[d]) break;\n      idx[d] = 0; // carry\n    }\n  }\n}\n"]}