react-semaphor 0.1.472 → 0.1.473

package/dist/chunks/{index-oVXvCLH-.js → index-DsvIlrI-.js}

@@ -1,16 +1,16 @@
 var Je = Object.defineProperty;
 var Qe = (e, r, t) => r in e ? Je(e, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[r] = t;
 var _ = (e, r, t) => Qe(e, typeof r != "symbol" ? r + "" : r, t);
-import { F as Xe, D as et, q as tt, E as rt, A as J, u as q, o as nt, M as ot, w as at, R as it, i as Ce, b as ct, m as lt, P as U } from "./pivot-result-lifecycle-O_roVguV.js";
+import { F as Xe, D as et, q as tt, E as rt, A as J, u as q, o as nt, M as ot, w as at, R as it, i as Ce, b as ct, m as lt, P as U } from "./pivot-result-lifecycle-PxmbJWkm.js";
 import { DEFAULT_RESOLVED_VALUE_FORMAT_PREFERENCES as de } from "../value-format-preferences/index.js";
-import { E as Te, l as dt, q as ae } from "./validators-B5t1s8oh.js";
-import "./analyze-result-contract-B3agc2XU.js";
-import { h as $e, r as ke, a as Ee, v as st, i as mt } from "./saved-temporal-bucket-format-CygnBDO2.js";
-import { r as z, b as ut, d as ft, P as pt } from "./pivot-result-identity-5v4hRVbc.js";
-import { v as yt, a as ht } from "./temporal-bucket-contract-Cno9TlYr.js";
-import { h as gt, T as vt, k as xe, i as bt } from "./temporal-bucket-CUKJktCl.js";
-import { r as Se, s as It, i as wt } from "./temporal-bucket-authoring-CZoJV2L6.js";
-import { v as _e } from "./raw-temporal-contract-BEMf3avg.js";
+import { F as Te, m as dt, r as ae } from "./validators-D-T-2HOR.js";
+import "./analyze-result-contract-C8s8EUL5.js";
+import { h as $e, r as ke, a as Ee, v as st, i as mt } from "./saved-temporal-bucket-format-CHsXUPJI.js";
+import { r as z, b as ut, d as ft, P as pt } from "./pivot-result-identity-CIZXsI53.js";
+import { v as yt, a as ht } from "./temporal-bucket-contract-CZl5D7FZ.js";
+import { h as gt, T as vt, k as xe, i as bt } from "./temporal-bucket-CtP7hKLa.js";
+import { r as Se, s as It, i as wt } from "./temporal-bucket-authoring-DJ9kK2wD.js";
+import { v as _e } from "./raw-temporal-contract-U8J9RlEH.js";
 import { r as Ct, a as Tt, b as $t } from "./canonical-result-keys-CEQefvdO.js";
 const kt = `import pandas as pd
 df = pd.DataFrame(data)  # 'data' contains the query result

package/dist/chunks/matrix-result-contract-Bhg60NtS.cjs

@@ -0,0 +1 @@
+"use strict";var _=Object.defineProperty;var B=(e,t,a)=>t in e?_(e,t,{enumerable:!0,configurable:!0,writable:!0,value:a}):e[t]=a;var p=(e,t,a)=>B(e,typeof t!="symbol"?t+"":t,a);const S=require("./temporal-bucket-9Wz9Ds6H.cjs"),T=require("./validators-DcshgK7w.cjs"),k=require("./temporal-bucket-contract-BD862TAa.cjs");class w extends Error{constructor(a){super(a.message);p(this,"code");p(this,"path");this.name="MatrixResultContractError",this.code=a.code,this.path=a.path}}function R(e){var u,m,x;const t=H(e);if(t!==2)throw new w({code:"unsupported_matrix_result_version",message:`Canonical Matrix results require schemaVersion 2; received ${String(t)}.`,path:"schemaVersion"});const a=T.semaphorMatrixResultSchema.safeParse(e);if(!a.success){const d=a.error.issues[0];throw o((d==null?void 0:d.message)||"Canonical Matrix result has an invalid shape.",d==null?void 0:d.path.join("."))}const r=a.data,s={row:$(r.axes.rows.levels,"axes.rows.levels"),column:$(r.axes.columns.levels,"axes.columns.levels")};G(r),b(r,"row"),b(r,"column");const i=new Set([...r.axes.rows.nodeIds,...r.axes.columns.nodeIds]),n=new Set;for(const[d,l]of Object.entries(r.nodesById)){if(l.id!==d)throw o("Matrix node directory key must equal node.id.",`nodesById.${d}.id`);if(!i.has(d))throw o("Matrix node directory cannot contain nodes omitted from both axes.",`nodesById.${d}`);q(l,s[l.axis],`nodesById.${d}`);const f=JSON.stringify([l.axis,l.path,l.isSubtotal===!0,l.isGrandTotal===!0]);if(n.has(f))throw o("Matrix nodes must have unique canonical path and total-role identity.",`nodesById.${d}`);n.add(f),O(r,l,`nodesById.${d}`)}const c=new Set;for(const[d,l]of r.cells.entries()){if(!((u=r.nodesById[l.rowId])!=null&&u.axis)||((m=r.nodesById[l.rowId])==null?void 0:m.axis)!=="row")throw o("Matrix cell rowId must reference a row node.",`cells.${d}.rowId`);if(l.columnId&&((x=r.nodesById[l.columnId])==null?void 0:x.axis)!=="column")throw o("Matrix cell columnId must reference a column node.",`cells.${d}.columnId`);if(!r.measuresById[l.measureId])throw o("Matrix cell measureId must reference a measure.",`cells.${d}.measureId`);const f=K(r.nodesById[l.rowId],l.columnId?r.nodesById[l.columnId]:void 0);if(l.role!==f)throw o("Matrix cell role must match its referenced row and column total roles.",`cells.${d}.role`);const I=JSON.stringify([l.rowId,l.columnId??null,l.measureId]);if(c.has(I))throw o("Matrix result cannot contain duplicate physical cell addresses.",`cells.${d}`);c.add(I)}return C(r,s),r}function $(e,t){var r;const a=new Map;for(const[s,i]of e.entries()){const n=`${t}.${s}`;if(a.has(i.instanceId))throw o("Matrix axis level ids must be unique.",`${n}.instanceId`);a.set(i.instanceId,i);const c=i.field.role==="date"||i.field.dataType==="date"||i.field.dataType==="datetime",u=i.field.dataType==="string"||i.field.dataType==="number"||i.field.dataType==="boolean";if(c&&!i.grain)throw o("Temporal Matrix axis level is missing its explicit grain.",`${n}.grain`);if(u&&i.grain)throw o("Non-temporal Matrix axis level cannot carry a grain.",`${n}.grain`);if(i.grain){if(!i.temporalBucket)throw o("Temporal Matrix axis level is missing governed bucket metadata.",`${n}.temporalBucket`);const m=k.validateTemporalBucketMetadata(i.temporalBucket);if(!m.ok||((r=m.value)==null?void 0:r.granularity)!==i.grain)throw o("Matrix axis grain and temporal metadata must agree.",`${n}.temporalBucket`)}else if(i.temporalBucket)throw o("Non-temporal Matrix axis levels cannot carry temporal bucket metadata.",n)}return a}function b(e,t){var s;const a=t==="row"?e.axes.rows:e.axes.columns,r=new Set;for(const[i,n]of a.nodeIds.entries()){if(r.has(n))throw o("Matrix axis node ids must be unique.",`axes.${t==="row"?"rows":"columns"}.nodeIds.${i}`);if(r.add(n),((s=e.nodesById[n])==null?void 0:s.axis)!==t)throw o("Matrix axis node id references the wrong axis.",`axes.${t==="row"?"rows":"columns"}.nodeIds.${i}`)}}function q(e,t,a){if(e.isGrandTotal){if(e.isSubtotal)throw o("Matrix nodes cannot be both subtotal and grand total.",a);if(e.path.length!==0)throw o("Matrix grand-total nodes must have an empty member path.",`${a}.path`);return}if(!e.path.length||e.level!==e.path.length-1)throw o("Ordinary and subtotal Matrix nodes require a level-aligned non-empty path.",a);const r=[...t.values()];if(e.path.length>r.length)throw o("Matrix node path exceeds its authored axis depth.",`${a}.path`);if(e.isSubtotal&&e.path.length>=r.length)throw o("Matrix subtotal nodes must identify a proper authored-axis prefix.",`${a}.path`);e.path.forEach((c,u)=>{const m=r[u];if(c.instanceId==="__matrix_remaining__"&&c.fieldKey==="__matrix_remaining__"&&c.value==="__matrix_remaining__"){if(u!==e.path.length-1)throw o("Matrix remaining-member identity must be the terminal path segment.",`${a}.path.${u}`);if(typeof c.label!="string")throw o("Matrix remaining-member paths require their explicit display label.",`${a}.path.${u}.label`);return}if(!m||c.instanceId!==m.instanceId||c.fieldKey!==m.fieldKey)throw o("Matrix member path must follow authored axis order and identity.",`${a}.path.${u}`);g(c,m,`${a}.path.${u}`)});const s=e.path[e.path.length-1],i=s.instanceId==="__matrix_remaining__"&&s.fieldKey==="__matrix_remaining__"&&s.value==="__matrix_remaining__";if(!y(e.value,s.value))throw o("Matrix node value must equal its final canonical path member.",`${a}.value`);const n=r[e.path.length-1];if(n!=null&&n.temporalBucket&&!e.isSubtotal&&!i&&e.label!==void 0)throw o("Temporal Matrix nodes cannot transport display labels.",`${a}.label`);if((!(n!=null&&n.temporalBucket)||i)&&typeof e.label!="string")throw o("Non-temporal Matrix nodes require a display label.",`${a}.label`)}function K(e,t){return e.isGrandTotal&&(t!=null&&t.isGrandTotal)?"matrixGrandTotal":e.isGrandTotal?"rowGrandTotal":t!=null&&t.isGrandTotal?"columnGrandTotal":e.isSubtotal&&(t!=null&&t.isSubtotal)?"subtotalIntersection":e.isSubtotal?"rowSubtotal":t!=null&&t.isSubtotal?"columnSubtotal":"value"}function g(e,t,a){if(t.temporalBucket){if(e.label!==void 0)throw o("Temporal Matrix path members cannot transport display labels.",`${a}.label`);if(e.value!==null&&typeof e.value!="string")throw o("Temporal Matrix member values must be canonical strings or null.",`${a}.value`);const r=S.parseTemporalBucketValue(e.value,t.temporalBucket);if(!r.ok)throw o(r.error.message,`${a}.value`)}else if(typeof e.label!="string")throw o("Non-temporal Matrix path members require a display label.",`${a}.label`)}function C(e,t){const a=[...t.row.values()];if(e.layout.rowHeaderLevels.length!==a.length)throw o("Matrix row-header layout must describe every row-axis level exactly once.","layout.rowHeaderLevels");e.layout.rowHeaderLevels.forEach((s,i)=>{var n;if(s.fieldInstanceId!==((n=a[i])==null?void 0:n.instanceId))throw o("Matrix row-header layout must follow authored row-axis order.",`layout.rowHeaderLevels.${i}.fieldInstanceId`)});for(const[s,i]of e.layout.columnHeaderRows.entries())for(const[n,c]of i.cells.entries()){if(v(c.columnPath,t.column,`layout.columnHeaderRows.${s}.cells.${n}.columnPath`),c.measureInstanceId&&!e.measuresById[c.measureInstanceId])throw o("Matrix header measureInstanceId must reference a measure.",`layout.columnHeaderRows.${s}.cells.${n}.measureInstanceId`);if(c.role==="columnHeader"&&c.label!==void 0)throw o("Matrix member headers cannot transport composed display labels.",`layout.columnHeaderRows.${s}.cells.${n}.label`)}const r=new Set;for(const[s,i]of e.layout.columns.entries()){if(r.has(i.id))throw o("Matrix layout column ids must be unique.",`layout.columns.${s}.id`);if(r.add(i.id),v(i.columnPath,t.column,`layout.columns.${s}.columnPath`),i.role==="value"&&i.columnPath.length>0&&i.label!==void 0)throw o("Matrix value columns with member paths cannot transport composed display labels.",`layout.columns.${s}.label`);if(!e.measuresById[i.measureInstanceId])throw o("Matrix layout column measureInstanceId must reference a measure.",`layout.columns.${s}.measureInstanceId`);if(i.columnNodeId){const n=e.nodesById[i.columnNodeId];if((n==null?void 0:n.axis)!=="column"||!y(n.path,i.columnPath))throw o("Matrix layout column must match its referenced column node path.",`layout.columns.${s}.columnNodeId`)}else if(t.column.size>0)throw o("Matrix columns with an authored column axis require a columnNodeId.",`layout.columns.${s}.columnNodeId`)}}function v(e,t,a){const r=[...t.values()];if(e.length>r.length)throw o("Matrix layout path exceeds its authored axis depth.",a);e.forEach((s,i)=>{const n=r[i];if(!n||s.instanceId!==n.instanceId||s.fieldKey!==n.fieldKey)throw o("Matrix layout path must follow authored axis order and identity.",`${a}.${i}`);g(s,n,`${a}.${i}`)})}function O(e,t,a){if(!t.parentId)return;const r=e.nodesById[t.parentId];if(!r)throw o("Matrix parentId must reference an existing node.",`${a}.parentId`);if(r.axis!==t.axis||r.path.length!==t.path.length-1||!y(r.path,t.path.slice(0,-1)))throw o("Matrix parentId must reference the immediate same-axis path prefix.",`${a}.parentId`)}function G(e){for(const[t,a]of[["rows",e.axes.rows],["columns",e.axes.columns]]){const r=t==="rows"?"row":"column";a.levels.forEach((s,i)=>{const n=e.fieldsById[s.instanceId];if(!n||n.instanceId!==s.instanceId||n.fieldKey!==s.fieldKey||n.role!==r||!M(n.field,s.field))throw o("Matrix axis level must have one matching role-scoped field descriptor.",`axes.${t}.levels.${i}`)})}for(const[t,a]of Object.entries(e.measuresById)){if(a.instanceId!==t)throw o("Matrix measure directory key must equal measure.instanceId.",`measuresById.${t}.instanceId`);const r=e.fieldsById[t];if(!r||r.instanceId!==t||r.fieldKey!==a.fieldKey||r.role!=="measure"||!M(r.field,a.field))throw o("Matrix measure must have one matching field descriptor.",`measuresById.${t}`)}}function H(e){return e&&typeof e=="object"?e.schemaVersion:void 0}function y(e,t){return JSON.stringify(e)===JSON.stringify(t)}function M(e,t){return h(e)===h(t)}function h(e){if(Array.isArray(e))return`[${e.map(h).join(",")}]`;if(e&&typeof e=="object"){const t=e;return`{${Object.keys(t).filter(a=>t[a]!==void 0).sort().map(a=>`${JSON.stringify(a)}:${h(t[a])}`).join(",")}}`}return e===void 0?"undefined":JSON.stringify(e)}function o(e,t){return new w({code:"invalid_matrix_result_contract",message:e,path:t})}exports.MatrixResultContractError=w;exports.parseCanonicalMatrixResult=R;

package/dist/chunks/matrix-result-contract-BpzhImar.js

@@ -0,0 +1,421 @@
+var _ = Object.defineProperty;
+var B = (e, t, a) => t in e ? _(e, t, { enumerable: !0, configurable: !0, writable: !0, value: a }) : e[t] = a;
+var x = (e, t, a) => B(e, typeof t != "symbol" ? t + "" : t, a);
+import { p as S } from "./temporal-bucket-CtP7hKLa.js";
+import { d as T } from "./validators-D-T-2HOR.js";
+import { v as k } from "./temporal-bucket-contract-CZl5D7FZ.js";
+class g extends Error {
+  constructor(a) {
+    super(a.message);
+    x(this, "code");
+    x(this, "path");
+    this.name = "MatrixResultContractError", this.code = a.code, this.path = a.path;
+  }
+}
+function V(e) {
+  var u, m, p;
+  const t = G(e);
+  if (t !== 2)
+    throw new g({
+      code: "unsupported_matrix_result_version",
+      message: `Canonical Matrix results require schemaVersion 2; received ${String(t)}.`,
+      path: "schemaVersion"
+    });
+  const a = T.safeParse(e);
+  if (!a.success) {
+    const d = a.error.issues[0];
+    throw o(
+      (d == null ? void 0 : d.message) || "Canonical Matrix result has an invalid shape.",
+      d == null ? void 0 : d.path.join(".")
+    );
+  }
+  const r = a.data, s = {
+    row: I(r.axes.rows.levels, "axes.rows.levels"),
+    column: I(
+      r.axes.columns.levels,
+      "axes.columns.levels"
+    )
+  };
+  C(r), $(r, "row"), $(r, "column");
+  const i = /* @__PURE__ */ new Set([
+    ...r.axes.rows.nodeIds,
+    ...r.axes.columns.nodeIds
+  ]), n = /* @__PURE__ */ new Set();
+  for (const [d, l] of Object.entries(r.nodesById)) {
+    if (l.id !== d)
+      throw o(
+        "Matrix node directory key must equal node.id.",
+        `nodesById.${d}.id`
+      );
+    if (!i.has(d))
+      throw o(
+        "Matrix node directory cannot contain nodes omitted from both axes.",
+        `nodesById.${d}`
+      );
+    R(l, s[l.axis], `nodesById.${d}`);
+    const f = JSON.stringify([
+      l.axis,
+      l.path,
+      l.isSubtotal === !0,
+      l.isGrandTotal === !0
+    ]);
+    if (n.has(f))
+      throw o(
+        "Matrix nodes must have unique canonical path and total-role identity.",
+        `nodesById.${d}`
+      );
+    n.add(f), O(r, l, `nodesById.${d}`);
+  }
+  const c = /* @__PURE__ */ new Set();
+  for (const [d, l] of r.cells.entries()) {
+    if (!((u = r.nodesById[l.rowId]) != null && u.axis) || ((m = r.nodesById[l.rowId]) == null ? void 0 : m.axis) !== "row")
+      throw o(
+        "Matrix cell rowId must reference a row node.",
+        `cells.${d}.rowId`
+      );
+    if (l.columnId && ((p = r.nodesById[l.columnId]) == null ? void 0 : p.axis) !== "column")
+      throw o(
+        "Matrix cell columnId must reference a column node.",
+        `cells.${d}.columnId`
+      );
+    if (!r.measuresById[l.measureId])
+      throw o(
+        "Matrix cell measureId must reference a measure.",
+        `cells.${d}.measureId`
+      );
+    const f = K(
+      r.nodesById[l.rowId],
+      l.columnId ? r.nodesById[l.columnId] : void 0
+    );
+    if (l.role !== f)
+      throw o(
+        "Matrix cell role must match its referenced row and column total roles.",
+        `cells.${d}.role`
+      );
+    const y = JSON.stringify([
+      l.rowId,
+      l.columnId ?? null,
+      l.measureId
+    ]);
+    if (c.has(y))
+      throw o(
+        "Matrix result cannot contain duplicate physical cell addresses.",
+        `cells.${d}`
+      );
+    c.add(y);
+  }
+  return q(r, s), r;
+}
+function I(e, t) {
+  var r;
+  const a = /* @__PURE__ */ new Map();
+  for (const [s, i] of e.entries()) {
+    const n = `${t}.${s}`;
+    if (a.has(i.instanceId))
+      throw o(
+        "Matrix axis level ids must be unique.",
+        `${n}.instanceId`
+      );
+    a.set(i.instanceId, i);
+    const c = i.field.role === "date" || i.field.dataType === "date" || i.field.dataType === "datetime", u = i.field.dataType === "string" || i.field.dataType === "number" || i.field.dataType === "boolean";
+    if (c && !i.grain)
+      throw o(
+        "Temporal Matrix axis level is missing its explicit grain.",
+        `${n}.grain`
+      );
+    if (u && i.grain)
+      throw o(
+        "Non-temporal Matrix axis level cannot carry a grain.",
+        `${n}.grain`
+      );
+    if (i.grain) {
+      if (!i.temporalBucket)
+        throw o(
+          "Temporal Matrix axis level is missing governed bucket metadata.",
+          `${n}.temporalBucket`
+        );
+      const m = k(i.temporalBucket);
+      if (!m.ok || ((r = m.value) == null ? void 0 : r.granularity) !== i.grain)
+        throw o(
+          "Matrix axis grain and temporal metadata must agree.",
+          `${n}.temporalBucket`
+        );
+    } else if (i.temporalBucket)
+      throw o(
+        "Non-temporal Matrix axis levels cannot carry temporal bucket metadata.",
+        n
+      );
+  }
+  return a;
+}
+function $(e, t) {
+  var s;
+  const a = t === "row" ? e.axes.rows : e.axes.columns, r = /* @__PURE__ */ new Set();
+  for (const [i, n] of a.nodeIds.entries()) {
+    if (r.has(n))
+      throw o(
+        "Matrix axis node ids must be unique.",
+        `axes.${t === "row" ? "rows" : "columns"}.nodeIds.${i}`
+      );
+    if (r.add(n), ((s = e.nodesById[n]) == null ? void 0 : s.axis) !== t)
+      throw o(
+        "Matrix axis node id references the wrong axis.",
+        `axes.${t === "row" ? "rows" : "columns"}.nodeIds.${i}`
+      );
+  }
+}
+function R(e, t, a) {
+  if (e.isGrandTotal) {
+    if (e.isSubtotal)
+      throw o(
+        "Matrix nodes cannot be both subtotal and grand total.",
+        a
+      );
+    if (e.path.length !== 0)
+      throw o(
+        "Matrix grand-total nodes must have an empty member path.",
+        `${a}.path`
+      );
+    return;
+  }
+  if (!e.path.length || e.level !== e.path.length - 1)
+    throw o(
+      "Ordinary and subtotal Matrix nodes require a level-aligned non-empty path.",
+      a
+    );
+  const r = [...t.values()];
+  if (e.path.length > r.length)
+    throw o(
+      "Matrix node path exceeds its authored axis depth.",
+      `${a}.path`
+    );
+  if (e.isSubtotal && e.path.length >= r.length)
+    throw o(
+      "Matrix subtotal nodes must identify a proper authored-axis prefix.",
+      `${a}.path`
+    );
+  e.path.forEach((c, u) => {
+    const m = r[u];
+    if (c.instanceId === "__matrix_remaining__" && c.fieldKey === "__matrix_remaining__" && c.value === "__matrix_remaining__") {
+      if (u !== e.path.length - 1)
+        throw o(
+          "Matrix remaining-member identity must be the terminal path segment.",
+          `${a}.path.${u}`
+        );
+      if (typeof c.label != "string")
+        throw o(
+          "Matrix remaining-member paths require their explicit display label.",
+          `${a}.path.${u}.label`
+        );
+      return;
+    }
+    if (!m || c.instanceId !== m.instanceId || c.fieldKey !== m.fieldKey)
+      throw o(
+        "Matrix member path must follow authored axis order and identity.",
+        `${a}.path.${u}`
+      );
+    M(c, m, `${a}.path.${u}`);
+  });
+  const s = e.path[e.path.length - 1], i = s.instanceId === "__matrix_remaining__" && s.fieldKey === "__matrix_remaining__" && s.value === "__matrix_remaining__";
+  if (!w(e.value, s.value))
+    throw o(
+      "Matrix node value must equal its final canonical path member.",
+      `${a}.value`
+    );
+  const n = r[e.path.length - 1];
+  if (n != null && n.temporalBucket && !e.isSubtotal && !i && e.label !== void 0)
+    throw o(
+      "Temporal Matrix nodes cannot transport display labels.",
+      `${a}.label`
+    );
+  if ((!(n != null && n.temporalBucket) || i) && typeof e.label != "string")
+    throw o(
+      "Non-temporal Matrix nodes require a display label.",
+      `${a}.label`
+    );
+}
+function K(e, t) {
+  return e.isGrandTotal && (t != null && t.isGrandTotal) ? "matrixGrandTotal" : e.isGrandTotal ? "rowGrandTotal" : t != null && t.isGrandTotal ? "columnGrandTotal" : e.isSubtotal && (t != null && t.isSubtotal) ? "subtotalIntersection" : e.isSubtotal ? "rowSubtotal" : t != null && t.isSubtotal ? "columnSubtotal" : "value";
+}
+function M(e, t, a) {
+  if (t.temporalBucket) {
+    if (e.label !== void 0)
+      throw o(
+        "Temporal Matrix path members cannot transport display labels.",
+        `${a}.label`
+      );
+    if (e.value !== null && typeof e.value != "string")
+      throw o(
+        "Temporal Matrix member values must be canonical strings or null.",
+        `${a}.value`
+      );
+    const r = S(
+      e.value,
+      t.temporalBucket
+    );
+    if (!r.ok)
+      throw o(r.error.message, `${a}.value`);
+  } else if (typeof e.label != "string")
+    throw o(
+      "Non-temporal Matrix path members require a display label.",
+      `${a}.label`
+    );
+}
+function q(e, t) {
+  const a = [...t.row.values()];
+  if (e.layout.rowHeaderLevels.length !== a.length)
+    throw o(
+      "Matrix row-header layout must describe every row-axis level exactly once.",
+      "layout.rowHeaderLevels"
+    );
+  e.layout.rowHeaderLevels.forEach((s, i) => {
+    var n;
+    if (s.fieldInstanceId !== ((n = a[i]) == null ? void 0 : n.instanceId))
+      throw o(
+        "Matrix row-header layout must follow authored row-axis order.",
+        `layout.rowHeaderLevels.${i}.fieldInstanceId`
+      );
+  });
+  for (const [s, i] of e.layout.columnHeaderRows.entries())
+    for (const [n, c] of i.cells.entries()) {
+      if (b(
+        c.columnPath,
+        t.column,
+        `layout.columnHeaderRows.${s}.cells.${n}.columnPath`
+      ), c.measureInstanceId && !e.measuresById[c.measureInstanceId])
+        throw o(
+          "Matrix header measureInstanceId must reference a measure.",
+          `layout.columnHeaderRows.${s}.cells.${n}.measureInstanceId`
+        );
+      if (c.role === "columnHeader" && c.label !== void 0)
+        throw o(
+          "Matrix member headers cannot transport composed display labels.",
+          `layout.columnHeaderRows.${s}.cells.${n}.label`
+        );
+    }
+  const r = /* @__PURE__ */ new Set();
+  for (const [s, i] of e.layout.columns.entries()) {
+    if (r.has(i.id))
+      throw o(
+        "Matrix layout column ids must be unique.",
+        `layout.columns.${s}.id`
+      );
+    if (r.add(i.id), b(
+      i.columnPath,
+      t.column,
+      `layout.columns.${s}.columnPath`
+    ), i.role === "value" && i.columnPath.length > 0 && i.label !== void 0)
+      throw o(
+        "Matrix value columns with member paths cannot transport composed display labels.",
+        `layout.columns.${s}.label`
+      );
+    if (!e.measuresById[i.measureInstanceId])
+      throw o(
+        "Matrix layout column measureInstanceId must reference a measure.",
+        `layout.columns.${s}.measureInstanceId`
+      );
+    if (i.columnNodeId) {
+      const n = e.nodesById[i.columnNodeId];
+      if ((n == null ? void 0 : n.axis) !== "column" || !w(n.path, i.columnPath))
+        throw o(
+          "Matrix layout column must match its referenced column node path.",
+          `layout.columns.${s}.columnNodeId`
+        );
+    } else if (t.column.size > 0)
+      throw o(
+        "Matrix columns with an authored column axis require a columnNodeId.",
+        `layout.columns.${s}.columnNodeId`
+      );
+  }
+}
+function b(e, t, a) {
+  const r = [...t.values()];
+  if (e.length > r.length)
+    throw o(
+      "Matrix layout path exceeds its authored axis depth.",
+      a
+    );
+  e.forEach((s, i) => {
+    const n = r[i];
+    if (!n || s.instanceId !== n.instanceId || s.fieldKey !== n.fieldKey)
+      throw o(
+        "Matrix layout path must follow authored axis order and identity.",
+        `${a}.${i}`
+      );
+    M(s, n, `${a}.${i}`);
+  });
+}
+function O(e, t, a) {
+  if (!t.parentId) return;
+  const r = e.nodesById[t.parentId];
+  if (!r)
+    throw o(
+      "Matrix parentId must reference an existing node.",
+      `${a}.parentId`
+    );
+  if (r.axis !== t.axis || r.path.length !== t.path.length - 1 || !w(r.path, t.path.slice(0, -1)))
+    throw o(
+      "Matrix parentId must reference the immediate same-axis path prefix.",
+      `${a}.parentId`
+    );
+}
+function C(e) {
+  for (const [t, a] of [
+    ["rows", e.axes.rows],
+    ["columns", e.axes.columns]
+  ]) {
+    const r = t === "rows" ? "row" : "column";
+    a.levels.forEach((s, i) => {
+      const n = e.fieldsById[s.instanceId];
+      if (!n || n.instanceId !== s.instanceId || n.fieldKey !== s.fieldKey || n.role !== r || !v(n.field, s.field))
+        throw o(
+          "Matrix axis level must have one matching role-scoped field descriptor.",
+          `axes.${t}.levels.${i}`
+        );
+    });
+  }
+  for (const [t, a] of Object.entries(e.measuresById)) {
+    if (a.instanceId !== t)
+      throw o(
+        "Matrix measure directory key must equal measure.instanceId.",
+        `measuresById.${t}.instanceId`
+      );
+    const r = e.fieldsById[t];
+    if (!r || r.instanceId !== t || r.fieldKey !== a.fieldKey || r.role !== "measure" || !v(r.field, a.field))
+      throw o(
+        "Matrix measure must have one matching field descriptor.",
+        `measuresById.${t}`
+      );
+  }
+}
+function G(e) {
+  return e && typeof e == "object" ? e.schemaVersion : void 0;
+}
+function w(e, t) {
+  return JSON.stringify(e) === JSON.stringify(t);
+}
+function v(e, t) {
+  return h(e) === h(t);
+}
+function h(e) {
+  if (Array.isArray(e))
+    return `[${e.map(h).join(",")}]`;
+  if (e && typeof e == "object") {
+    const t = e;
+    return `{${Object.keys(t).filter((a) => t[a] !== void 0).sort().map(
+      (a) => `${JSON.stringify(a)}:${h(t[a])}`
+    ).join(",")}}`;
+  }
+  return e === void 0 ? "undefined" : JSON.stringify(e);
+}
+function o(e, t) {
+  return new g({
+    code: "invalid_matrix_result_contract",
+    message: e,
+    path: t
+  });
+}
+export {
+  g as M,
+  V as p
+};

package/dist/chunks/{pivot-header-presentation-7XrwJYDm.js → pivot-header-presentation-Be3FyR0N.js}

@@ -2,9 +2,9 @@ var F = Object.defineProperty;
 var R = (e, t, n) => t in e ? F(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
 var A = (e, t, n) => R(e, typeof t != "symbol" ? t + "" : t, n);
 import { t as f, c as U, g as O, e as P, a as T, m as S, b as M, i as Z, f as k, d as X } from "./format-types-CFHQoIuk.js";
-import { b as y } from "./pivot-result-lifecycle-O_roVguV.js";
+import { b as y } from "./pivot-result-lifecycle-PxmbJWkm.js";
 import { f as B } from "./index-CACdoqu3.js";
-import { h as j } from "./temporal-bucket-CUKJktCl.js";
+import { h as j } from "./temporal-bucket-CtP7hKLa.js";
 function b(e, t) {
   const n = f(e), o = f(t), r = n.getTime() - o.getTime();
   return r < 0 ? -1 : r > 0 ? 1 : r;

package/dist/chunks/{pivot-result-identity-5v4hRVbc.js → pivot-result-identity-CIZXsI53.js}

@@ -1,7 +1,7 @@
 var y = Object.defineProperty;
 var c = (t, e, r) => e in t ? y(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r;
 var u = (t, e, r) => c(t, typeof e != "symbol" ? e + "" : e, r);
-import { v as d } from "./temporal-bucket-contract-Cno9TlYr.js";
+import { v as d } from "./temporal-bucket-contract-CZl5D7FZ.js";
 function f(t) {
   return !!(t != null && t.isSubtotal && t.subtotalScope === "pivot-value");
 }

package/dist/chunks/{pivot-result-lifecycle-O_roVguV.js → pivot-result-lifecycle-PxmbJWkm.js}

@@ -1,15 +1,15 @@
 var ee = Object.defineProperty;
 var te = (e, t, r) => t in e ? ee(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
 var g = (e, t, r) => te(e, typeof t != "symbol" ? t + "" : t, r);
-import { b as k, ao as G, q as re } from "./validators-B5t1s8oh.js";
-import { p as ae } from "./raw-temporal-contract-BEMf3avg.js";
+import { b as k, ao as G, r as re } from "./validators-D-T-2HOR.js";
+import { p as ae } from "./raw-temporal-contract-U8J9RlEH.js";
 import { canonicalizeSupportedLocale as E, canonicalizeSupportedCurrencyCode as $ } from "../value-format-preferences/index.js";
-import { l as h, j as ne, a as ie } from "./temporal-bucket-CUKJktCl.js";
+import { l as h, j as ne, a as ie } from "./temporal-bucket-CtP7hKLa.js";
 import { f as oe } from "./index-CACdoqu3.js";
-import { b as se } from "./report-runtime-context-DnNbpkGo.js";
-import "./analyze-result-contract-B3agc2XU.js";
-import { a as ce } from "./temporal-bucket-contract-Cno9TlYr.js";
-import { d as me, P as le } from "./pivot-result-identity-5v4hRVbc.js";
+import { b as se } from "./report-runtime-context-DNbgCsko.js";
+import "./analyze-result-contract-C8s8EUL5.js";
+import { a as ce } from "./temporal-bucket-contract-CZl5D7FZ.js";
+import { d as me, P as le } from "./pivot-result-identity-CIZXsI53.js";
 function N(e) {
   if (!e) return !1;
   const t = e.toLowerCase().replace("_", "-");
@@ -1094,7 +1094,7 @@ function K(e, t) {
   const r = I(e), a = I(t);
   return r.length === a.length && r.every((n, i) => n === a[i]);
 }
-function qe(e) {
+function Le(e) {
   if (!Array.isArray(e))
     throw new Error("resolvedFormats must be an array");
   const t = /* @__PURE__ */ new Set();
@@ -1159,7 +1159,7 @@ function qe(e) {
     return t.add(s), o;
   });
 }
-function Le(e) {
+function qe(e) {
   try {
     if (!h(e))
       throw new Error("presentation execution snapshot must be an object");
@@ -1179,7 +1179,7 @@ function Le(e) {
     return {
       version: 1,
       reportContext: t.value,
-      resolvedFormats: qe(e.resolvedFormats)
+      resolvedFormats: Le(e.resolvedFormats)
     };
   } catch (t) {
     throw t instanceof j ? t : new j(
@@ -1188,7 +1188,7 @@ function Le(e) {
   }
 }
 function vt(e) {
-  return Le({
+  return qe({
     version: 1,
     reportContext: e.reportContext,
     resolvedFormats: [...e.resolvedFormats]
@@ -1364,7 +1364,7 @@ function Be(e) {
   }
   return e;
 }
-function q(e, t) {
+function L(e, t) {
   if (!Array.isArray(e) || e.some((r) => typeof r != "string" || !r) || new Set(e).size !== e.length)
     throw new u(
       `Canonical pivot contract ${t} must be an array of unique field identities.`
@@ -1389,12 +1389,12 @@ function Ue(e, t) {
       "detail"
     ].map((f) => [
       f,
-      q(
+      L(
         a[f],
         `expectedRoleFieldIds.${f}`
       )
     ])
-  ), o = q(
+  ), o = L(
     r.expectedMetricAliases,
     "expectedMetricAliases"
   ), s = r.columnKinds;
@@ -1432,7 +1432,7 @@ function Ue(e, t) {
     columnClassifications: y
   };
 }
-function L(e, t) {
+function q(e, t) {
   const r = [
     "groupby",
     "metric",
@@ -1516,7 +1516,7 @@ function Xe(e) {
       );
     V(a, r);
     const s = O(e.columnKeyMap);
-    return L(s, a), {
+    return q(s, a), {
       pivotResultState: "loaded_empty",
       records: [],
       columns: r,
@@ -1533,7 +1533,7 @@ function Xe(e) {
       "A loaded_valid pivot result must carry at least one record."
     );
   const i = O(e.columnKeyMap);
-  L(i, a), Ye(i, r, a), V(a, r);
+  q(i, a), Ye(i, r, a), V(a, r);
   const o = r.filter(
     (s) => a.columnKinds[s.key] === "pivot_metric"
   );
@@ -1625,8 +1625,8 @@ export {
   he as i,
   lt as j,
   Ne as k,
-  qe as l,
-  Le as m,
+  Le as l,
+  qe as m,
   vt as n,
   pt as o,
   ye as p,

package/dist/chunks/{raw-temporal-contract-BEMf3avg.js → raw-temporal-contract-U8J9RlEH.js}

@@ -1,7 +1,7 @@
 var d = Object.defineProperty;
 var i = (a, e, t) => e in a ? d(a, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[e] = t;
 var n = (a, e, t) => i(a, typeof e != "symbol" ? e + "" : e, t);
-import { R as l } from "./validators-B5t1s8oh.js";
+import { R as l } from "./validators-D-T-2HOR.js";
 class r extends Error {
   constructor(t) {
     super(t);

package/dist/chunks/{report-preferences-dialog-Dxt9XMpd.js → report-preferences-dialog-C9mJffNQ.js}

@@ -1,12 +1,12 @@
 import { jsxs as o, Fragment as j, jsx as t } from "react/jsx-runtime";
 import oe, { useState as S, useRef as X, useEffect as U, useCallback as E, useMemo as _ } from "react";
-import { az as ee, aA as ce, aB as B, aC as $, aD as de, h as ue, i as me, j as fe, k as he, l as M, m as H, aE as ve, aF as V, aG as z, b as ye, aH as pe, aI as ge, aJ as Se, aK as be, aL as Te } from "./index-0fmECZL2.js";
-import { u as ae, c as F, O as W, P as we, a as Ce, B as L, b as ke, d as q, L as te, T as xe, F as Ne, G, I as K } from "./switch-n2yUNY8i.js";
-import { a as Pe } from "./report-runtime-context-DnNbpkGo.js";
+import { az as ee, aA as ce, aB as B, aC as $, aD as de, h as ue, i as me, j as fe, k as he, l as M, m as H, aE as ve, aF as V, aG as z, b as ye, aH as pe, aI as ge, aJ as Se, aK as be, aL as Te } from "./index-DalKzjEZ.js";
+import { u as ae, c as F, O as W, P as we, a as Ce, B as L, b as ke, d as q, L as te, T as xe, F as Ne, G, I as K } from "./switch-D20CIzj6.js";
+import { a as Pe } from "./report-runtime-context-DNbgCsko.js";
 import "./x-CXDkqdur.js";
-import "./saved-temporal-bucket-format-CygnBDO2.js";
-import "./validators-B5t1s8oh.js";
-import "./analyze-result-contract-B3agc2XU.js";
+import "./saved-temporal-bucket-format-CHsXUPJI.js";
+import "./validators-D-T-2HOR.js";
+import "./analyze-result-contract-C8s8EUL5.js";
 import { parseValueFormatPreferencesResponse as Ae, canonicalizeSupportedLocale as Ee, canonicalizeSupportedCurrencyCode as ze } from "../value-format-preferences/index.js";
 function Le(e = {}) {
   const { authToken: i, tokenProps: a } = ee(), d = ae(