@fuaran-ui/ops 0.6.0 → 0.8.0

package/dist/index.cjs

@@ -430,7 +430,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":
@@ -464,11 +467,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)],
@@ -524,6 +528,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:
@@ -542,6 +553,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);
   }
@@ -637,6 +653,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([
@@ -674,6 +691,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)],
@@ -717,6 +741,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) => {
@@ -833,6 +859,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":
@@ -1140,8 +1168,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))],
@@ -1153,14 +1187,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) => {
@@ -1173,6 +1215,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);
 };
@@ -3091,12 +3140,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;
@@ -3131,13 +3191,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"
       );
   }
 };
@@ -3175,22 +3246,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) => {
@@ -4244,8 +4315,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");
@@ -4296,7 +4394,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 } : {}
       };
@@ -4331,6 +4429,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;
@@ -4595,9 +4749,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": {
@@ -4806,14 +4983,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;
@@ -4920,6 +5101,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;
@@ -5010,6 +5213,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 } : {},
@@ -5019,7 +5226,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) => {
@@ -5251,6 +5460,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;
@@ -5734,7 +5947,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;
@@ -5798,7 +6011,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": {
@@ -5816,13 +6037,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,
@@ -5836,12 +6122,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" },
@@ -5849,9 +6144,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;
@@ -5878,7 +6191,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);
@@ -5913,6 +6235,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) {
@@ -5927,6 +6286,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 } : {}
   });
 };
@@ -5958,6 +6322,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;
@@ -5968,6 +6346,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 } : {}
   });
 };
@@ -6534,6 +6919,7 @@ var decodeNodeKind = (path, j) => {
     case "Callout":
     case "Progress":
     case "Skeleton":
+    case "Icon":
     case "LabelValueRow":
     case "Fact":
     case "Link":
@@ -7044,7 +7430,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",
@@ -7282,6 +7672,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) {
@@ -8089,6 +8510,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 = '"';
@@ -9186,6 +9769,7 @@ exports.PAYLOAD_KEY = PAYLOAD_KEY;
 exports.PROFILE_KEY = PROFILE_KEY;
 exports.REQUIRED_PROFILE_KEY = REQUIRED_PROFILE_KEY;
 exports.apply = apply;
+exports.canPlace = canPlace;
 exports.cellString = cellString;
 exports.coerce = coerce;
 exports.coreV1 = coreV1;
@@ -9198,6 +9782,9 @@ exports.decodeNode = decodeNode;
 exports.decodeNodeTolerant = decodeNodeTolerant;
 exports.decodeOp = decodeOp;
 exports.decodeTolerant = decodeTolerant;
+exports.derivedFreshIds = derivedFreshIds;
+exports.duplicateOp = duplicateOp;
+exports.duplicateOpWith = duplicateOpWith;
 exports.encodeCell = encodeCell;
 exports.encodeColExpr = encodeColExpr;
 exports.encodeDagRecord = encodeDagRecord;
@@ -9215,15 +9802,22 @@ exports.evalPipelineWith = evalPipelineWith;
 exports.evalPipelineWithInEnv = evalPipelineWithInEnv;
 exports.evalSource = evalSource;
 exports.jsonField = field;
+exports.liveValueToTable = liveValueToTable;
 exports.merge3Way = merge3Way;
+exports.moveOp = moveOp;
 exports.negotiate = negotiate;
 exports.negotiateEnvelope = negotiateEnvelope;
 exports.noResolve = noResolve;
+exports.nudgeOp = nudgeOp;
 exports.parse = parse;
+exports.pasteOp = pasteOp;
+exports.pasteOpWith = pasteOpWith;
 exports.pipelineParams = pipelineParams;
+exports.placeOp = placeOp;
 exports.reencodeNode = reencodeNode;
 exports.renderAstCanonical = renderAstCanonical;
 exports.renderProfile = renderProfile;
+exports.sequentialFreshIds = sequentialFreshIds;
 exports.stepParams = stepParams;
 exports.tryParseProfile = tryParseProfile;
 exports.validateAnswer = validateAnswer;