@fuaran-ui/ops 0.6.0 → 0.7.0

package/dist/index.js

@@ -428,7 +428,10 @@ var binding = (b, staticEnc = objValue) => {
       return caseObj("Transform", [
         ...paramFields,
         ["pipeline", jArray(b.pipeline.map(transformStep))],
-        ["source", dataSource(b.source)]
+        [
+          "source",
+          b.source.kind === "Data" ? dataSource(b.source.source) : binding(b.source.binding, jsonValue)
+        ]
       ]);
     }
     case "Invoke":
@@ -462,11 +465,12 @@ var action = (a) => {
       ]);
     case "Navigate":
       return caseObj("Navigate", [["route", str(a.route)]]);
-    case "SetState":
-      return caseObj("SetState", [
-        ["key", str(a.key)],
-        ["value", jsonValue(a.value)]
-      ]);
+    case "SetState": {
+      const fields = [["key", str(a.key)]];
+      if (a.value !== void 0) fields.push(["value", jsonValue(a.value)]);
+      if (a.valueFrom !== void 0) fields.push(["valueFrom", binding(a.valueFrom, jsonValue)]);
+      return caseObj("SetState", fields);
+    }
     case "AiTool":
       return caseObj("AiTool", [
         ["args", jsonValue(a.args)],
@@ -522,6 +526,13 @@ var cellFormat = (f) => {
       return caseObj("SignificantDigits", [["digits", num(f.digits)]]);
     case "Date":
       return caseObj("Date", [["format", str(f.format)]]);
+    case "Duration":
+      return caseObj("Duration", [
+        ["style", str(f.style)],
+        ["unit", str(f.unit)]
+      ]);
+    case "RelativeTime":
+      return caseObj("RelativeTime", [["unit", str(f.unit)]]);
     case "Custom":
       return caseObj("Custom", [["fn", CLOSURE]]);
     default:
@@ -540,6 +551,11 @@ var formatIntent = (f) => {
       return caseObj("Date", [["dateStyle", str(f.dateStyle)]]);
     case "RelativeTime":
       return caseObj("RelativeTime", [["unit", str(f.unit)]]);
+    case "Duration":
+      return caseObj("Duration", [
+        ["style", str(f.style)],
+        ["unit", str(f.unit)]
+      ]);
     default:
       return assertNever(f);
   }
@@ -635,6 +651,7 @@ var linkSpec = (s) => {
   ];
   if (s.rel !== void 0) fields.push(["rel", str(s.rel)]);
   if (s.target !== void 0) fields.push(["target", str(s.target)]);
+  if (s.protection !== void 0) fields.push(["protection", str(s.protection)]);
   return jObject(fields);
 };
 var imageSpec = (s) => jObject([
@@ -672,6 +689,13 @@ var mathSpec = (s) => jObject([
 ]);
 var sparklineSpec = (s) => jObject([["source", binding(s.source, staticFloatSeq)]]);
 var skeletonSpec = (s) => jObject([["rows", num(s.rows)]]);
+var iconSpec = (s) => {
+  const fields = [["icon", str(s.icon)]];
+  if (s.label !== void 0) fields.push(["label", str(s.label)]);
+  if (s.size !== "Medium") fields.push(["size", str(s.size)]);
+  pushToneOptional(fields, s.tone);
+  return jObject(fields);
+};
 var calloutSpec = (s) => {
   const fields = [
     ["body", textSource(s.body)],
@@ -715,6 +739,8 @@ var drawStyle = (s) => {
   if (s.emphasis !== void 0) fields.push(["emphasis", str(s.emphasis)]);
   if (s.fontFamily !== void 0) fields.push(["fontFamily", str(s.fontFamily)]);
   if (s.markId !== void 0) fields.push(["markId", str(s.markId)]);
+  if (s.rotation !== void 0) fields.push(["rotation", num(s.rotation)]);
+  if (s.tip !== void 0) fields.push(["tip", textSource(s.tip)]);
   return jObject(fields);
 };
 var curveCommand = (c) => {
@@ -831,6 +857,8 @@ var displayKind = (d) => {
       return hoistSpec("Progress", progressSpec(d.spec));
     case "Skeleton":
       return hoistSpec("Skeleton", skeletonSpec(d.spec));
+    case "Icon":
+      return hoistSpec("Icon", iconSpec(d.spec));
     case "LabelValueRow":
       return hoistSpec("LabelValueRow", labelValueRowSpec(d.spec));
     case "Fact":
@@ -1138,8 +1166,14 @@ var columnErased = (c) => {
   pushColumnWidthOptional(fields, "width", c.width);
   if (c.value !== void 0) fields.push(["value", CLOSURE]);
   if (c.field !== void 0) fields.push(["field", str(c.field)]);
+  if (c.sortable !== void 0) fields.push(["sortable", bool(c.sortable)]);
+  if (c.editable !== void 0) fields.push(["editable", bool(c.editable)]);
   return jObject(fields);
 };
+var defaultSortJson = (d) => jObject([
+  ["column", intLit(d.column)],
+  ["direction", str(d.direction)]
+]);
 var gridSpec = (s) => {
   const fields = [
     ["columns", jArray(s.columns.map(columnErased))],
@@ -1151,14 +1185,22 @@ var gridSpec = (s) => {
   if (s.onRowClick !== void 0) fields.push(["onRowClick", CLOSURE]);
   if (s.rowKey !== void 0) fields.push(["rowKey", CLOSURE]);
   if (s.rowKeyField !== void 0) fields.push(["rowKeyField", str(s.rowKeyField)]);
-  if (s.staticRows !== void 0)
-    fields.push([
-      "staticRows",
-      jObject([
-        ["headers", jArray(s.staticRows.headers.map(textSource))],
-        ["rows", jArray(s.staticRows.rows.map((row) => jArray(row.map(textSource))))]
-      ])
-    ]);
+  if (s.sortStateKey !== void 0) fields.push(["sortStateKey", str(s.sortStateKey)]);
+  if (s.pageSize !== void 0) fields.push(["pageSize", num(s.pageSize)]);
+  if (s.pageStateKey !== void 0) fields.push(["pageStateKey", str(s.pageStateKey)]);
+  if (s.defaultSort !== void 0) fields.push(["defaultSort", defaultSortJson(s.defaultSort)]);
+  if (s.editStateKey !== void 0) fields.push(["editStateKey", str(s.editStateKey)]);
+  if (s.staticRows !== void 0) {
+    const sr = s.staticRows;
+    const srFields = [
+      ["headers", jArray(sr.headers.map(textSource))],
+      ["rows", jArray(sr.rows.map((row) => jArray(row.map(textSource))))]
+    ];
+    if (sr.sortable !== void 0) srFields.push(["sortable", bool(sr.sortable)]);
+    if (sr.defaultSort !== void 0)
+      srFields.push(["defaultSort", defaultSortJson(sr.defaultSort)]);
+    fields.push(["staticRows", jObject(srFields)]);
+  }
   return jObject(fields);
 };
 var chartSpec = (s) => {
@@ -1171,6 +1213,13 @@ var chartSpec = (s) => {
     ["yFields", jArray(s.yFields.map(str))]
   ];
   if (s.title !== void 0) fields.push(["title", textSource(s.title)]);
+  if (s.valueFormat !== void 0) fields.push(["valueFormat", formatIntent(s.valueFormat)]);
+  if (s.xTitle !== void 0) fields.push(["xTitle", textSource(s.xTitle)]);
+  if (s.yTitle !== void 0) fields.push(["yTitle", textSource(s.yTitle)]);
+  if (s.subtitle !== void 0) fields.push(["subtitle", textSource(s.subtitle)]);
+  if (s.legendPosition !== void 0) fields.push(["legendPosition", str(s.legendPosition)]);
+  if (s.dataLabels !== void 0) fields.push(["dataLabels", str(s.dataLabels)]);
+  if (s.xScale !== void 0) fields.push(["xScale", str(s.xScale)]);
   if (s.onPointClick !== void 0) fields.push(["onPointClick", CLOSURE]);
   return jObject(fields);
 };
@@ -3089,12 +3138,23 @@ var decodeTextAnchor = (p, j) => bareEnum(p, j, ["Start", "Middle", "End"], "Tex
 var decodeStyleRole = (p, j) => bareEnum(p, j, ["None", "Eyebrow", "Data", "Lede", "Caption"], "StyleRole");
 var decodeFontVoice = (p, j) => bareEnum(p, j, ["Default", "Display", "Structural"], "FontVoice");
 var decodeChartKind = (p, j) => bareEnum(p, j, ["Line", "Bar", "Area", "Pie", "Scatter", "Heatmap"], "ChartKind");
+var decodeChartLegendPosition = (p, j) => bareEnum(p, j, ["Top", "Right", "Bottom", "None"], "ChartLegendPosition");
+var decodeChartDataLabels = (p, j) => bareEnum(p, j, ["Off", "Ends"], "ChartDataLabels");
+var decodeChartXScale = (p, j) => bareEnum(p, j, ["Category", "Temporal"], "ChartXScale");
 var decodeFileReadEncoding = (p, j) => bareEnum(p, j, ["Text", "Base64", "DataUrl"], "FileReadEncoding");
 var decodeAriaRole = (p, j) => {
   if (j.kind !== "JString") return wrongType(p, "JSON string (ARIA role)");
   return ok(j.value);
 };
 var decodeLiveRegion = (p, j) => bareEnum(p, j, ["polite", "assertive", "off"], "LiveRegionKind");
+var decodeDurationUnit = (p, j) => bareEnum(p, j, ["Seconds", "Minutes", "Hours"], "DurationUnit");
+var decodeDurationStyle = (p, j) => bareEnum(p, j, ["Compact", "Clock", "Long"], "DurationStyle");
+var decodeRelativeTimeUnit = (p, j) => bareEnum(
+  p,
+  j,
+  ["Second", "Minute", "Hour", "Day", "Week", "Month", "Year"],
+  "RelativeTimeUnit"
+);
 var decodeCellFormat = (path, j) => {
   const fo = requireObject(path, j);
   if (!fo.ok) return fo;
@@ -3129,13 +3189,24 @@ var decodeCellFormat = (path, j) => {
       const r = reqField(path, f, "format", "format string", requireString);
       return r.ok ? ok({ kind: "Date", format: r.value }) : r;
     }
+    case "Duration": {
+      const unit = reqField(path, f, "unit", "DurationUnit string", decodeDurationUnit);
+      if (!unit.ok) return unit;
+      const style = reqField(path, f, "style", "DurationStyle string", decodeDurationStyle);
+      if (!style.ok) return style;
+      return ok({ kind: "Duration", unit: unit.value, style: style.value });
+    }
+    case "RelativeTime": {
+      const r = reqField(path, f, "unit", "RelativeTimeUnit string", decodeRelativeTimeUnit);
+      return r.ok ? ok({ kind: "RelativeTime", unit: r.value }) : r;
+    }
     case "Custom":
       return ok({ kind: "Custom", format: () => CLOSURE2 });
     default:
       return unknownDuCase(
         path,
         d.value,
-        "None | Number | Currency | Percent | SignificantDigits | Date | Custom"
+        "None | Number | Currency | Percent | SignificantDigits | Date | Duration | RelativeTime | Custom"
       );
   }
 };
@@ -3173,22 +3244,22 @@ var decodeFormat = (path, j) => {
       return r.ok ? ok({ kind: "Date", dateStyle: r.value }) : r;
     }
     case "RelativeTime": {
-      const r = reqField(
-        path,
-        f,
-        "unit",
-        "RelativeTimeUnit string",
-        (p, v) => bareEnum(
-          p,
-          v,
-          ["Second", "Minute", "Hour", "Day", "Week", "Month", "Year"],
-          "RelativeTimeUnit"
-        )
-      );
+      const r = reqField(path, f, "unit", "RelativeTimeUnit string", decodeRelativeTimeUnit);
       return r.ok ? ok({ kind: "RelativeTime", unit: r.value }) : r;
     }
+    case "Duration": {
+      const unit = reqField(path, f, "unit", "DurationUnit string", decodeDurationUnit);
+      if (!unit.ok) return unit;
+      const style = reqField(path, f, "style", "DurationStyle string", decodeDurationStyle);
+      if (!style.ok) return style;
+      return ok({ kind: "Duration", unit: unit.value, style: style.value });
+    }
     default:
-      return unknownDuCase(path, d.value, "Number | Currency | Percent | Date | RelativeTime");
+      return unknownDuCase(
+        path,
+        d.value,
+        "Number | Currency | Percent | Date | RelativeTime | Duration"
+      );
   }
 };
 var decodeLocaleSource = (path, j) => {
@@ -4242,8 +4313,35 @@ var decodeBinding = (path, j, parseStatic = (_p, v) => ok(decodeAstValue(v)), pl
       if (!srcJ.ok) return srcJ;
       const pipeJ = requireField(path, f, "pipeline", "Transform pipeline array");
       if (!pipeJ.ok) return pipeJ;
-      const src = decodeDataSource(srcJ.value);
-      if (!src.ok) return makeError("WRONG_TYPE", `${path}.source`, src.error);
+      const liveTagAst = srcJ.value.kind === "JObject" ? srcJ.value.fields.get("$type") : void 0;
+      const liveTag = liveTagAst !== void 0 && liveTagAst.kind === "JString" && (liveTagAst.value === "State" || liveTagAst.value === "Selection" || liveTagAst.value === "Query") ? liveTagAst.value : void 0;
+      const hasCarried = srcJ.value.kind === "JObject" && srcJ.value.fields.has("defaultValue");
+      let source;
+      if (liveTag === void 0 || liveTag === "State" && !hasCarried) {
+        const src = decodeDataSource(normaliseTransformSource(srcJ.value));
+        if (!src.ok) return makeError("WRONG_TYPE", `${path}.source`, src.error);
+        source = { kind: "Data", source: src.value };
+      } else {
+        const b2 = decodeBinding(`${path}.source`, srcJ.value, decodeJVal, void 0);
+        if (!b2.ok) return b2;
+        if (liveTag === "State") {
+          const snap = decodeDataSource(normaliseTransformSource(srcJ.value));
+          if (!snap.ok) return makeError("WRONG_TYPE", `${path}.source`, snap.error);
+          source = {
+            kind: "Live",
+            binding: b2.value,
+            initial: snap.value
+          };
+        } else {
+          const dv = srcJ.value.kind === "JObject" ? srcJ.value.fields.get("defaultValue") : void 0;
+          const snap = dv !== void 0 ? decodeDataSource(normaliseTransformSource(dv)) : void 0;
+          source = {
+            kind: "Live",
+            binding: b2.value,
+            initial: snap !== void 0 && snap.ok ? snap.value : { kind: "Embedded", table: { schema: [], columns: [] } }
+          };
+        }
+      }
       const pipe = decodePipelineCore(pipeJ.value);
       if (!pipe.ok) return makeError("WRONG_TYPE", `${path}.pipeline`, pipe.error);
       const paramsField = tryField(f, "params");
@@ -4294,7 +4392,7 @@ var decodeBinding = (path, j, parseStatic = (_p, v) => ok(decodeAstValue(v)), pl
       }
       const b = {
         kind: "Transform",
-        source: src.value,
+        source,
         pipeline: pipe.value,
         ...params !== void 0 ? { params } : {}
       };
@@ -4329,6 +4427,62 @@ var decodeBinding = (path, j, parseStatic = (_p, v) => ok(decodeAstValue(v)), pl
       );
   }
 };
+var normaliseTransformSource = (j) => {
+  let unwrapped = j;
+  if (j.kind === "JObject") {
+    const t = j.fields.get("$type");
+    if (t !== void 0 && t.kind === "JString" && (t.value === "State" || t.value === "Static" || t.value === "Bound")) {
+      const inner = j.fields.get("defaultValue") ?? j.fields.get("value");
+      if (inner !== void 0) unwrapped = inner;
+    }
+  }
+  if (unwrapped.kind === "JArray" && unwrapped.items.length > 0 && unwrapped.items[0].kind === "JObject") {
+    const rows = unwrapped.items;
+    const first = unwrapped.items[0];
+    const keys = [...first.fields.keys()].sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+    const cols = /* @__PURE__ */ new Map();
+    for (const k of keys) {
+      const cells = rows.map((row) => {
+        if (row.kind !== "JObject") return { kind: "JNull" };
+        return row.fields.get(k) ?? { kind: "JNull" };
+      });
+      cols.set(k, { kind: "JArray", items: cells });
+    }
+    return {
+      kind: "JObject",
+      fields: /* @__PURE__ */ new Map([["columns", { kind: "JObject", fields: cols }]])
+    };
+  }
+  return unwrapped;
+};
+var liveValueToTable = (v) => {
+  if (v === void 0) return { ok: false, error: "Transform live source resolved to no value" };
+  let text;
+  try {
+    text = JSON.stringify(v);
+  } catch {
+    return {
+      ok: false,
+      error: "Transform live source resolved to a value with no JSON representation"
+    };
+  }
+  if (text === void 0) {
+    return { ok: false, error: "Transform live source resolved to no value" };
+  }
+  const parsed = parse(text);
+  if (!parsed.ok) {
+    return { ok: false, error: "Transform live source resolved to unreadable data" };
+  }
+  const src = decodeDataSource(normaliseTransformSource(parsed.value));
+  if (!src.ok) return { ok: false, error: src.error };
+  if (src.value.kind !== "Embedded") {
+    return {
+      ok: false,
+      error: `Transform live source resolved to a 'ref' source ('${src.value.name}'), which is not host-resolved`
+    };
+  }
+  return { ok: true, value: src.value.table };
+};
 var decodeBindingArgs = (path, j) => {
   const fo = requireObject(path, j);
   if (!fo.ok) return fo;
@@ -4593,9 +4747,32 @@ var decodeAction = (path, j) => {
     case "SetState": {
       const key = reqField(path, f, "key", "state key string", requireString);
       if (!key.ok) return key;
-      const valueJ = requireField(path, f, "value", "JsonValue value");
-      if (!valueJ.ok) return valueJ;
-      const value = decodeJVal(`${path}.value`, valueJ.value);
+      const valueJ = tryField(f, "value");
+      const fromJ = tryField(f, "valueFrom");
+      if (valueJ !== void 0 && fromJ !== void 0) {
+        return makeError(
+          "WRONG_TYPE",
+          `${path}.valueFrom`,
+          "SetState carries both 'value' and 'valueFrom' \u2014 exactly one is allowed: 'value' is a literal JSON value written verbatim; 'valueFrom' derives the written value from a Binding at dispatch time; remove one"
+        );
+      }
+      if (valueJ === void 0 && fromJ === void 0) {
+        return makeError(
+          "MISSING_FIELD",
+          `${path}.value`,
+          "missing required field 'value' \u2014 provide 'value' (a literal JSON value) or 'valueFrom' (a Binding evaluated at dispatch time)"
+        );
+      }
+      if (fromJ !== void 0) {
+        const from = decodeBinding(`${path}.valueFrom`, fromJ, decodeJVal, void 0);
+        if (!from.ok) return from;
+        return ok({
+          kind: "SetState",
+          key: key.value,
+          valueFrom: from.value
+        });
+      }
+      const value = decodeJVal(`${path}.value`, valueJ);
       return value.ok ? ok({ kind: "SetState", key: key.value, value: value.value }) : value;
     }
     case "AiTool": {
@@ -4804,14 +4981,18 @@ var decodeLinkSpec = (path, j) => {
   if (!rel.ok) return rel;
   const target = optField(path, f, "target", requireString);
   if (!target.ok) return target;
+  const protection = optField(path, f, "protection", decodeLinkProtection);
+  if (!protection.ok) return protection;
   return ok({
     href: href.value,
     label: label.value,
     download: download.value,
     ...rel.value !== void 0 ? { rel: rel.value } : {},
-    ...target.value !== void 0 ? { target: target.value } : {}
+    ...target.value !== void 0 ? { target: target.value } : {},
+    ...protection.value !== void 0 ? { protection: protection.value } : {}
   });
 };
+var decodeLinkProtection = (p, j) => bareEnum(p, j, ["email"], "LinkProtection");
 var decodeImageSpec = (path, j) => {
   const fo = requireObject(path, j);
   if (!fo.ok) return fo;
@@ -4918,6 +5099,28 @@ var decodeSkeletonSpec = (path, j) => {
   const rows = reqField(path, fo.value, "rows", "skeleton row count integer", requireInt);
   return rows.ok ? ok({ rows: rows.value }) : rows;
 };
+var decodeIconSize = (p, j) => bareEnum(p, j, ["Small", "Medium", "Large"], "IconSize");
+var decodeIconSpec = (path, j) => {
+  const fo = requireObject(path, j);
+  if (!fo.ok) return fo;
+  const f = fo.value;
+  const icon = reqField(path, f, "icon", "icon name string", requireString);
+  if (!icon.ok) return icon;
+  const sizeJ = tryField(f, "size");
+  const size = sizeJ === void 0 ? ok("Medium") : decodeIconSize(`${path}.size`, sizeJ);
+  if (!size.ok) return size;
+  const toneJ = tryField(f, "tone");
+  const tone = toneJ === void 0 ? ok("Default") : decodeTone(`${path}.tone`, toneJ);
+  if (!tone.ok) return tone;
+  const label = optField(path, f, "label", requireString);
+  if (!label.ok) return label;
+  return ok({
+    icon: icon.value,
+    size: size.value,
+    tone: tone.value,
+    ...label.value !== void 0 ? { label: label.value } : {}
+  });
+};
 var decodeCalloutSpec = (path, j) => {
   const fo = requireObject(path, j);
   if (!fo.ok) return fo;
@@ -5008,6 +5211,10 @@ var decodeDrawStyle = (path, j) => {
   if (!fontFamily.ok) return fontFamily;
   const markId = optField(path, f, "markId", requireString);
   if (!markId.ok) return markId;
+  const rotation = optField(path, f, "rotation", requireFloat);
+  if (!rotation.ok) return rotation;
+  const tip = optField(path, f, "tip", decodeTextSource);
+  if (!tip.ok) return tip;
   return ok({
     ...fill.value !== void 0 ? { fill: fill.value } : {},
     ...stroke.value !== void 0 ? { stroke: stroke.value } : {},
@@ -5017,7 +5224,9 @@ var decodeDrawStyle = (path, j) => {
     ...fontSize.value !== void 0 ? { fontSize: fontSize.value } : {},
     ...emphasis.value !== void 0 ? { emphasis: emphasis.value } : {},
     ...fontFamily.value !== void 0 ? { fontFamily: fontFamily.value } : {},
-    ...markId.value !== void 0 ? { markId: markId.value } : {}
+    ...markId.value !== void 0 ? { markId: markId.value } : {},
+    ...rotation.value !== void 0 ? { rotation: rotation.value } : {},
+    ...tip.value !== void 0 ? { tip: tip.value } : {}
   });
 };
 var decodeCurveCommand = (path, j) => {
@@ -5249,6 +5458,10 @@ var decodeDisplayKind = (path, j) => {
       const r = decodeSkeletonSpec(path, j);
       return r.ok ? ok({ kind: "Skeleton", spec: r.value }) : r;
     }
+    case "Icon": {
+      const r = decodeIconSpec(path, j);
+      return r.ok ? ok({ kind: "Icon", spec: r.value }) : r;
+    }
     case "LabelValueRow": {
       const r = decodeLabelValueRowSpec(path, j);
       return r.ok ? ok({ kind: "LabelValueRow", spec: r.value }) : r;
@@ -5732,7 +5945,7 @@ var decodeTonedPill = (path, f) => {
   };
   return ok(k);
 };
-var decodeCellKindErased = (path, j) => {
+var decodeCellKindErased = (path, j, columnField) => {
   const fo = requireObject(path, j);
   if (!fo.ok) return fo;
   const f = fo.value;
@@ -5796,7 +6009,15 @@ var decodeCellKindErased = (path, j) => {
     case "TonedPill":
       return decodeTonedPill(path, f);
     case "Progress": {
-      const k = { kind: "Progress", fraction: () => 0 };
+      const field2 = columnField;
+      const k = {
+        kind: "Progress",
+        fraction: field2 === void 0 ? () => 0 : (row) => {
+          const v = row !== null && typeof row === "object" ? row[field2] : void 0;
+          const n = typeof v === "number" && Number.isFinite(v) ? v : 0;
+          return Math.max(0, Math.min(1, n));
+        }
+      };
       return ok(k);
     }
     case "Custom": {
@@ -5814,13 +6035,78 @@ var decodeCellKindErased = (path, j) => {
       );
   }
 };
+var nearMiss = (path, found, canonical) => makeError(
+  "WRONG_TYPE",
+  `${path}.${found}`,
+  `'${found}' is not part of the grid vocabulary \u2014 it would be ignored, not honoured`,
+  canonical
+);
+var checkNearMisses = (path, f, candidates) => {
+  for (const [name, canonical] of candidates) {
+    if (tryField(f, name) !== void 0) return nearMiss(path, name, canonical);
+  }
+  return ok(void 0);
+};
+var COLUMN_NEAR_MISSES = [
+  // Named by the census row itself. Deliberately NOT aliased to
+  // `editable: false`: an inverting alias that guesses wrong makes a read-only
+  // column editable.
+  ["readOnly", "editable: false \u2014 the column flag NARROWS the grid's editable capability"]
+];
+var GRID_NEAR_MISSES = [
+  // The sharpest of them: a LITERAL page number is not expressible at all,
+  // because the position lives in State so a control can move it. Ignoring it
+  // is what produced the ×11 fake-affordance cluster.
+  [
+    "currentPage",
+    'pageStateKey \u2014 the page POSITION lives in State as {"page": N} so the pager can move it; a literal page number is not expressible'
+  ],
+  [
+    "page",
+    'pageStateKey \u2014 the page POSITION lives in State as {"page": N} so the pager can move it; a literal page number is not expressible'
+  ],
+  [
+    "pageIndex",
+    'pageStateKey \u2014 the page POSITION lives in State as {"page": N}, 1-based (not a zero-based index)'
+  ],
+  [
+    "sortable",
+    "sortStateKey on the grid + sortable on each COLUMN \u2014 grid-wide sortable is the staticRows spelling; a data-bound grid narrows per column"
+  ],
+  [
+    "onEdit",
+    "editStateKey \u2014 the edit DESTINATION is a State key on the grid; onEdit is a per-cell host closure and carries no destination across the wire"
+  ],
+  [
+    "behaviour",
+    "sibling fields on the grid (sortStateKey / pageStateKey / pageSize / editStateKey / defaultSort) \u2014 grid behaviour is not a nested record"
+  ],
+  [
+    "behavior",
+    "sibling fields on the grid (sortStateKey / pageStateKey / pageSize / editStateKey / defaultSort) \u2014 grid behaviour is not a nested record"
+  ]
+];
 var decodeColumnErased = (path, j) => {
   const fo = requireObject(path, j);
   if (!fo.ok) return fo;
   const f = fo.value;
   const format = optField(path, f, "format", decodeCellFormat);
   if (!format.ok) return format;
-  const kind = reqFieldAliased(path, f, "kind", ["type"], "CellKindErased", decodeCellKindErased);
+  const fieldJ = tryField(f, "field");
+  let field2;
+  if (fieldJ !== void 0) {
+    const fr = requireString(`${path}.field`, fieldJ);
+    if (!fr.ok) return fr;
+    field2 = fr.value;
+  }
+  const kind = reqFieldAliased(
+    path,
+    f,
+    "kind",
+    ["type"],
+    "CellKindErased",
+    (p, v) => decodeCellKindErased(p, v, field2)
+  );
   if (!kind.ok) return kind;
   const label = reqFieldAliased(
     path,
@@ -5834,12 +6120,21 @@ var decodeColumnErased = (path, j) => {
   const width = optField(path, f, "width", decodeColumnWidth);
   if (!width.ok) return width;
   const hasValue = tryField(f, "value") !== void 0;
-  const fieldJ = tryField(f, "field");
-  let field2;
-  if (fieldJ !== void 0) {
-    const fr = requireString(`${path}.field`, fieldJ);
-    if (!fr.ok) return fr;
-    field2 = fr.value;
+  const colNearMiss = checkNearMisses(path, f, COLUMN_NEAR_MISSES);
+  if (!colNearMiss.ok) return colNearMiss;
+  const colEditableJ = tryField(f, "editable");
+  let colEditable;
+  if (colEditableJ !== void 0) {
+    const er = requireBool(`${path}.editable`, colEditableJ);
+    if (!er.ok) return er;
+    colEditable = er.value;
+  }
+  const sortableJ = tryField(f, "sortable");
+  let sortable;
+  if (sortableJ !== void 0) {
+    const sr = requireBool(`${path}.sortable`, sortableJ);
+    if (!sr.ok) return sr;
+    sortable = sr.value;
   }
   return ok({
     format: format.value ?? { kind: "None" },
@@ -5847,9 +6142,27 @@ var decodeColumnErased = (path, j) => {
     label: label.value,
     width: width.value ?? { kind: "Auto" },
     ...hasValue ? { value: () => ({ kind: "Empty" }) } : {},
-    ...field2 !== void 0 ? { field: field2 } : {}
+    ...field2 !== void 0 ? { field: field2 } : {},
+    ...sortable !== void 0 ? { sortable } : {},
+    ...colEditable !== void 0 ? { editable: colEditable } : {}
   });
 };
+var decodeSortDirection = (p, j) => bareEnum(p, j, ["asc", "desc"], "SortDirection");
+var decodeDefaultSort = (path, j) => {
+  const fo = requireObject(path, j);
+  if (!fo.ok) return fo;
+  const f = fo.value;
+  const columnJ = requireField(path, f, "column", "non-negative header index");
+  if (!columnJ.ok) return columnJ;
+  const cv = columnJ.value;
+  if (cv.kind !== "JNumber" || cv.value < 0 || !Number.isInteger(cv.value))
+    return wrongType(`${path}.column`, "JSON number (non-negative integer header index)");
+  const directionJ = requireField(path, f, "direction", "asc | desc");
+  if (!directionJ.ok) return directionJ;
+  const direction = decodeSortDirection(`${path}.direction`, directionJ.value);
+  if (!direction.ok) return direction;
+  return ok({ column: cv.value, direction: direction.value });
+};
 var decodeStaticRows = (path, j) => {
   const fo = requireObject(path, j);
   if (!fo.ok) return fo;
@@ -5876,7 +6189,16 @@ var decodeStaticRows = (path, j) => {
     );
   });
   if (!rows.ok) return rows;
-  return ok({ headers: headers.value, rows: rows.value });
+  const sortable = optField(path, f, "sortable", requireBool);
+  if (!sortable.ok) return sortable;
+  const defaultSort = optField(path, f, "defaultSort", decodeDefaultSort);
+  if (!defaultSort.ok) return defaultSort;
+  return ok({
+    headers: headers.value,
+    rows: rows.value,
+    ...sortable.value !== void 0 ? { sortable: sortable.value } : {},
+    ...defaultSort.value !== void 0 ? { defaultSort: defaultSort.value } : {}
+  });
 };
 var decodeGridSpec = (path, j) => {
   const fo = requireObject(path, j);
@@ -5911,6 +6233,43 @@ var decodeGridSpec = (path, j) => {
     if (!rk.ok) return rk;
     rowKeyField = rk.value;
   }
+  const sortStateKeyJ = tryField(f, "sortStateKey");
+  let sortStateKey;
+  if (sortStateKeyJ !== void 0) {
+    const sk = requireString(`${path}.sortStateKey`, sortStateKeyJ);
+    if (!sk.ok) return sk;
+    sortStateKey = sk.value;
+  }
+  const pageSizeJ = tryField(f, "pageSize");
+  let pageSize;
+  if (pageSizeJ !== void 0) {
+    if (pageSizeJ.kind !== "JNumber" || pageSizeJ.value < 1 || !Number.isInteger(pageSizeJ.value))
+      return wrongType(`${path}.pageSize`, "JSON number (integer page size of 1 or more)");
+    pageSize = pageSizeJ.value;
+  }
+  const defaultSortJ = tryField(f, "defaultSort");
+  let defaultSort;
+  if (defaultSortJ !== void 0) {
+    const ds = decodeDefaultSort(`${path}.defaultSort`, defaultSortJ);
+    if (!ds.ok) return ds;
+    defaultSort = ds.value;
+  }
+  const gridNearMiss = checkNearMisses(path, f, GRID_NEAR_MISSES);
+  if (!gridNearMiss.ok) return gridNearMiss;
+  const editStateKeyJ = tryField(f, "editStateKey");
+  let editStateKey;
+  if (editStateKeyJ !== void 0) {
+    const ek = requireString(`${path}.editStateKey`, editStateKeyJ);
+    if (!ek.ok) return ek;
+    editStateKey = ek.value;
+  }
+  const pageStateKeyJ = tryField(f, "pageStateKey");
+  let pageStateKey;
+  if (pageStateKeyJ !== void 0) {
+    const pk = requireString(`${path}.pageStateKey`, pageStateKeyJ);
+    if (!pk.ok) return pk;
+    pageStateKey = pk.value;
+  }
   const staticRowsJ = tryField(f, "staticRows");
   let staticRows;
   if (staticRowsJ !== void 0) {
@@ -5925,6 +6284,11 @@ var decodeGridSpec = (path, j) => {
     ...hasRowClick ? { onRowClick: () => placeholderAction } : {},
     ...hasRowKey ? { rowKey: () => CLOSURE2 } : {},
     ...rowKeyField !== void 0 ? { rowKeyField } : {},
+    ...sortStateKey !== void 0 ? { sortStateKey } : {},
+    ...pageSize !== void 0 ? { pageSize } : {},
+    ...pageStateKey !== void 0 ? { pageStateKey } : {},
+    ...defaultSort !== void 0 ? { defaultSort } : {},
+    ...editStateKey !== void 0 ? { editStateKey } : {},
     ...staticRows !== void 0 ? { staticRows } : {}
   });
 };
@@ -5956,6 +6320,20 @@ var decodeChartSpec = (path, j) => {
   if (!yFields.ok) return yFields;
   const title = optField(path, f, "title", decodeTextSource);
   if (!title.ok) return title;
+  const valueFormat = optField(path, f, "valueFormat", decodeFormat);
+  if (!valueFormat.ok) return valueFormat;
+  const xTitle = optField(path, f, "xTitle", decodeTextSource);
+  if (!xTitle.ok) return xTitle;
+  const yTitle = optField(path, f, "yTitle", decodeTextSource);
+  if (!yTitle.ok) return yTitle;
+  const subtitle = optField(path, f, "subtitle", decodeTextSource);
+  if (!subtitle.ok) return subtitle;
+  const legendPosition = optField(path, f, "legendPosition", decodeChartLegendPosition);
+  if (!legendPosition.ok) return legendPosition;
+  const dataLabels = optField(path, f, "dataLabels", decodeChartDataLabels);
+  if (!dataLabels.ok) return dataLabels;
+  const xScale = optField(path, f, "xScale", decodeChartXScale);
+  if (!xScale.ok) return xScale;
   const hasPointClick = tryField(f, "onPointClick") !== void 0;
   const stacked = optField(path, f, "stacked", requireBool);
   if (!stacked.ok) return stacked;
@@ -5966,6 +6344,13 @@ var decodeChartSpec = (path, j) => {
     yFields: yFields.value,
     stacked: stacked.value ?? false,
     ...title.value !== void 0 ? { title: title.value } : {},
+    ...valueFormat.value !== void 0 ? { valueFormat: valueFormat.value } : {},
+    ...xTitle.value !== void 0 ? { xTitle: xTitle.value } : {},
+    ...yTitle.value !== void 0 ? { yTitle: yTitle.value } : {},
+    ...subtitle.value !== void 0 ? { subtitle: subtitle.value } : {},
+    ...legendPosition.value !== void 0 ? { legendPosition: legendPosition.value } : {},
+    ...dataLabels.value !== void 0 ? { dataLabels: dataLabels.value } : {},
+    ...xScale.value !== void 0 ? { xScale: xScale.value } : {},
     ...hasPointClick ? { onPointClick: () => placeholderAction } : {}
   });
 };
@@ -6532,6 +6917,7 @@ var decodeNodeKind = (path, j) => {
     case "Callout":
     case "Progress":
     case "Skeleton":
+    case "Icon":
     case "LabelValueRow":
     case "Fact":
     case "Link":
@@ -7042,7 +7428,11 @@ var coerce = {
   emphasisFlag: (v) => viaAst(v, decodeEmphasisFlag),
   headingVariant: (v) => viaAst(v, decodeHeadingVariant),
   badgeVariant: (v) => viaAst(v, decodeBadgeVariant),
-  iconSource: (v) => viaAst(v, decodeIconSource)
+  iconSource: (v) => viaAst(v, decodeIconSource),
+  /** `Icon.Size : IconSize` (Phase 821) — the UpdateProp twin of `decodeIconSize`,
+   * added with the standalone Icon display kind. */
+  iconSize: (v) => viaAst(v, decodeIconSize),
+  stringOption: (v) => viaAst(v, parseStaticStringOpt)
 };
 var invalidJson = (parseMessage) => makeError(
   "INVALID_JSON",
@@ -7280,6 +7670,37 @@ var updateField = (field2, value, kind) => {
       }
       case "Skeleton":
         return field2 === "Rows" ? patch(coerce.int(value), (x) => disp({ kind: "Skeleton", spec: { rows: x } })) : { tag: "unknownField" };
+      case "Icon": {
+        const s = d.spec;
+        switch (field2) {
+          case "Icon":
+            return patch(
+              coerce.string(value),
+              (x) => disp({ kind: "Icon", spec: { ...s, icon: x } })
+            );
+          case "Size":
+            return patch(
+              coerce.iconSize(value),
+              (x) => disp({ kind: "Icon", spec: { ...s, size: x } })
+            );
+          case "Tone":
+            return patch(
+              coerce.tone(value),
+              (x) => disp({ kind: "Icon", spec: { ...s, tone: x } })
+            );
+          case "Label": {
+            return patch(coerce.stringOption(value), (x) => {
+              const { label: _label, ...rest } = s;
+              return disp({
+                kind: "Icon",
+                spec: { ...rest, ...x !== void 0 ? { label: x } : {} }
+              });
+            });
+          }
+          default:
+            return { tag: "unknownField" };
+        }
+      }
       case "Callout": {
         const s = d.spec;
         switch (field2) {
@@ -8087,6 +8508,168 @@ var apply = (tree, op) => {
   return { ok: true, value: { newTree: r.value, emittedTelemetry: telem } };
 };
 
+// src/placement.ts
+var derivedFreshIds = (oldId, taken) => {
+  for (let n = 1; ; n += 1) {
+    const candidate = n === 1 ? `${oldId}-copy` : `${oldId}-copy-${n}`;
+    if (!taken(candidate)) return candidate;
+  }
+};
+var sequentialFreshIds = (prefix) => {
+  let counter = 0;
+  return (_oldId, taken) => {
+    for (; ; ) {
+      counter += 1;
+      const candidate = `${prefix}-${counter}`;
+      if (!taken(candidate)) return candidate;
+    }
+  };
+};
+var ok3 = (value) => ({ ok: true, value });
+var err = (error) => ({ ok: false, error });
+var idOf2 = (n) => n.id;
+var sameOrder = (a, b) => a.length === b.length && a.every((id, i) => id === b[i]);
+var containerChildren = (root, parentId) => {
+  const parent = findNode(parentId, root);
+  if (parent === void 0) return err({ kind: "ParentNotFound", parentId });
+  const children = layoutChildren(parent);
+  if (children === void 0) return err({ kind: "ChildlessKind", parentId });
+  return ok3(children.map(idOf2));
+};
+var reposition = (order, moved, placement) => {
+  const rest = order.filter((id) => id !== moved);
+  const anchored = (anchor, offset) => {
+    const i = rest.findIndex((id) => id === anchor);
+    if (i < 0) return err({ kind: "UnknownAnchor", anchor });
+    const at = i + offset;
+    return ok3([...rest.slice(0, at), moved, ...rest.slice(at)]);
+  };
+  switch (placement.kind) {
+    case "Last":
+      return ok3([...rest, moved]);
+    case "First":
+      return ok3([moved, ...rest]);
+    case "Before":
+      return anchored(placement.anchor, 0);
+    case "After":
+      return anchored(placement.anchor, 1);
+  }
+};
+var structurallyPresent = (nodeId, root) => idOf2(root) === nodeId || findLayoutParent(nodeId, root) !== void 0;
+var firstSharedId = (root, incoming) => {
+  const existing = new Set(allNodeIds(root));
+  return allNodeIds(incoming).find((id) => existing.has(id));
+};
+var canPlace = (root, moved, target) => {
+  const r = root;
+  if (!structurallyPresent(moved, r)) return err({ kind: "NodeNotFound", nodeId: moved });
+  if (target.parentId === moved) return err({ kind: "MoveIntoSelf", nodeId: moved });
+  if (isAncestor(moved, target.parentId, r))
+    return err({ kind: "MoveIntoDescendant", nodeId: moved, parentId: target.parentId });
+  const siblings = containerChildren(r, target.parentId);
+  if (!siblings.ok) return siblings;
+  const membership = [...siblings.value.filter((id) => id !== moved), moved];
+  const placed = reposition(membership, moved, target.placement);
+  return placed.ok ? ok3(void 0) : placed;
+};
+var placeOp = (root, child, target) => {
+  const r = root;
+  const siblings = containerChildren(r, target.parentId);
+  if (!siblings.ok) return siblings;
+  const dup = firstSharedId(r, child);
+  if (dup !== void 0) return err({ kind: "DuplicateId", nodeId: dup });
+  const childId = idOf2(child);
+  const appended = [...siblings.value, childId];
+  const wanted = reposition(appended, childId, target.placement);
+  if (!wanted.ok) return wanted;
+  const insert = { kind: "InsertChild", parentId: target.parentId, child };
+  return ok3(
+    sameOrder(wanted.value, appended) ? insert : {
+      kind: "Batch",
+      ops: [
+        insert,
+        { kind: "ReorderChildren", parentId: target.parentId, newOrder: wanted.value }
+      ]
+    }
+  );
+};
+var moveOp = (root, moved, target) => {
+  const legal = canPlace(root, moved, target);
+  if (!legal.ok) return legal;
+  const siblings = containerChildren(root, target.parentId);
+  if (!siblings.ok) return siblings;
+  const appended = [...siblings.value.filter((id) => id !== moved), moved];
+  const wanted = reposition(appended, moved, target.placement);
+  if (!wanted.ok) return wanted;
+  const move = { kind: "MoveNode", target: moved, newParentId: target.parentId };
+  return ok3(
+    sameOrder(wanted.value, appended) ? move : {
+      kind: "Batch",
+      ops: [
+        move,
+        { kind: "ReorderChildren", parentId: target.parentId, newOrder: wanted.value }
+      ]
+    }
+  );
+};
+var nudgeOp = (root, nodeId, delta) => {
+  const r = root;
+  if (idOf2(r) === nodeId) return err({ kind: "CannotNudgeRoot", nodeId });
+  const parent = findLayoutParent(nodeId, r);
+  if (parent === void 0) return err({ kind: "NodeNotFound", nodeId });
+  const ids = (layoutChildren(parent) ?? []).map(idOf2);
+  const index = ids.findIndex((id) => id === nodeId);
+  const swapWith = index + delta;
+  if (swapWith < 0 || swapWith >= ids.length)
+    return err({ kind: "NudgeOutOfRange", nodeId, delta });
+  const reordered = ids.map(
+    (id, i) => i === index ? ids[swapWith] : i === swapWith ? ids[index] : id
+  );
+  return ok3({ kind: "ReorderChildren", parentId: idOf2(parent), newOrder: reordered });
+};
+var mapImmediate = (n, f) => {
+  let cur = n;
+  const count = childSlots(n).length;
+  for (let i = 0; i < count; i += 1) {
+    const slot = childSlots(cur)[i];
+    const mapped = f(slot.child);
+    if (mapped !== slot.child) cur = slot.rebuild(mapped);
+  }
+  return cur;
+};
+var remapForInsert = (freshIds, targetRoot, incoming) => {
+  const existing = new Set(allNodeIds(targetRoot));
+  const taken = /* @__PURE__ */ new Set([...existing, ...allNodeIds(incoming)]);
+  const rename = /* @__PURE__ */ new Map();
+  for (const oldId of allNodeIds(incoming)) {
+    if (existing.has(oldId)) {
+      const fresh = freshIds(oldId, (candidate) => taken.has(candidate));
+      taken.add(fresh);
+      rename.set(oldId, fresh);
+    }
+  }
+  if (rename.size === 0) return incoming;
+  const rewrite = (node2) => {
+    const withChildren = mapImmediate(node2, rewrite);
+    const fresh = rename.get(withChildren.id);
+    return fresh === void 0 ? withChildren : { ...withChildren, id: fresh };
+  };
+  return rewrite(incoming);
+};
+var duplicateOpWith = (freshIds, root, source, target) => {
+  const r = root;
+  const sub = findNode(source, r);
+  if (sub === void 0) return err({ kind: "NodeNotFound", nodeId: source });
+  return placeOp(root, remapForInsert(freshIds, r, sub), target);
+};
+var duplicateOp = (root, source, target) => duplicateOpWith(derivedFreshIds, root, source, target);
+var pasteOpWith = (freshIds, targetRoot, incoming, target) => placeOp(
+  targetRoot,
+  remapForInsert(freshIds, targetRoot, incoming),
+  target
+);
+var pasteOp = (targetRoot, incoming, target) => pasteOpWith(derivedFreshIds, targetRoot, incoming, target);
+
 // src/dag.ts
 var str2 = (s) => {
   let out = '"';
@@ -9178,6 +9761,6 @@ var validateAnswerDocument = (json) => {
   return validateAnswerAt("$.answer", contract.value, answer.value);
 };
 
-export { ELICITATION_KEY, ELICITATION_VERSION, PAYLOAD_KEY, PROFILE_KEY, REQUIRED_PROFILE_KEY, apply, cellString, coerce, coreV1, decodeDagRecord, decodeElicitation, decodeElicitationOutcome, decodeEnvelope, decodeEnvelopeAst, decodeNode, decodeNodeTolerant, decodeOp, decodeTolerant, encodeCell, encodeColExpr, encodeDagRecord, encodeDataSource, encodeElicitation, encodeElicitationOutcome, encodeEnvelope2 as encodeEnvelope, encodeNode, encodeOp, encodePipeline, evalErrorString, evalPipeline, evalPipelineInEnv, evalPipelineWith, evalPipelineWithInEnv, evalSource, field as jsonField, merge3Way, negotiate, negotiateEnvelope, noResolve, parse, pipelineParams, reencodeNode, renderAstCanonical, renderProfile, stepParams, tryParseProfile, validateAnswer, validateAnswerAt, validateAnswerDocument };
+export { ELICITATION_KEY, ELICITATION_VERSION, PAYLOAD_KEY, PROFILE_KEY, REQUIRED_PROFILE_KEY, apply, canPlace, cellString, coerce, coreV1, decodeDagRecord, decodeElicitation, decodeElicitationOutcome, decodeEnvelope, decodeEnvelopeAst, decodeNode, decodeNodeTolerant, decodeOp, decodeTolerant, derivedFreshIds, duplicateOp, duplicateOpWith, encodeCell, encodeColExpr, encodeDagRecord, encodeDataSource, encodeElicitation, encodeElicitationOutcome, encodeEnvelope2 as encodeEnvelope, encodeNode, encodeOp, encodePipeline, evalErrorString, evalPipeline, evalPipelineInEnv, evalPipelineWith, evalPipelineWithInEnv, evalSource, field as jsonField, liveValueToTable, merge3Way, moveOp, negotiate, negotiateEnvelope, noResolve, nudgeOp, parse, pasteOp, pasteOpWith, pipelineParams, placeOp, reencodeNode, renderAstCanonical, renderProfile, sequentialFreshIds, stepParams, tryParseProfile, validateAnswer, validateAnswerAt, validateAnswerDocument };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map