@flanksource/clicky-ui 0.3.35 → 0.3.37

package/dist/profiles/cel/celEditorResults.js

@@ -0,0 +1,133 @@
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import { Badge } from "../../data/Badge.js";
+import { Button } from "../../components/button.js";
+import { Icon } from "../../data/Icon.js";
+import { cn } from "../../lib/utils.js";
+import { explainCelError } from "./celExpression.js";
+import { UiSparkles } from "../../icons/components/UiSparkles.js";
+import { UiArrowRight } from "../../icons/components/UiArrowRight.js";
+import { UiWarningTriangle } from "../../icons/components/UiWarningTriangle.js";
+function Tally({
+  found,
+  results,
+  predicate
+}) {
+  const matched = results.filter((result) => result.value === true).length;
+  const missed = results.filter((result) => result.value === false).length;
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-1.5", children: [
+    predicate ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsxs(Badge, { tone: "success", variant: "soft", size: "md", children: [
+        matched,
+        " true"
+      ] }),
+      /* @__PURE__ */ jsxs(Badge, { tone: "neutral", variant: "soft", size: "md", children: [
+        missed,
+        " false"
+      ] })
+    ] }) : /* @__PURE__ */ jsxs(Badge, { tone: "success", variant: "soft", size: "md", children: [
+      found.ok,
+      " evaluated"
+    ] }),
+    found.empty > 0 && /* @__PURE__ */ jsxs(Badge, { tone: "warning", variant: "soft", size: "md", children: [
+      found.empty,
+      " empty"
+    ] }),
+    found.failed > 0 && /* @__PURE__ */ jsxs(Badge, { tone: "danger", variant: "soft", size: "md", icon: UiWarningTriangle, children: [
+      found.failed,
+      " failed"
+    ] })
+  ] });
+}
+function preview(value) {
+  if (value === null || value === void 0) return "null";
+  if (typeof value === "object") return JSON.stringify(value);
+  return String(value);
+}
+function ResultStrip({
+  result,
+  label,
+  pending,
+  draft,
+  onFix
+}) {
+  if (result == null ? void 0 : result.error) {
+    const failure = explainCelError(result.error, draft);
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-1 rounded border border-destructive/40 bg-destructive/[0.06] p-2", children: [
+      /* @__PURE__ */ jsxs("div", { className: "text-[11px] font-medium text-destructive", children: [
+        label,
+        " — evaluation failed"
+      ] }),
+      /* @__PURE__ */ jsx("p", { className: "text-[11px] text-destructive", children: failure.message }),
+      failure.fix && /* @__PURE__ */ jsxs(Button, { size: "sm", variant: "outline", className: "gap-1.5", onClick: () => onFix(failure.fix), children: [
+        /* @__PURE__ */ jsx(Icon, { icon: UiSparkles, className: "text-[12px]" }),
+        "Fix it"
+      ] }),
+      /* @__PURE__ */ jsx(
+        "code",
+        {
+          className: "block break-all font-mono text-[10px] text-muted-foreground",
+          title: result.error,
+          children: failure.raw
+        }
+      )
+    ] });
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "flex items-baseline gap-2 rounded border border-border bg-muted/40 p-2", children: [
+    /* @__PURE__ */ jsx("span", { className: "text-[11px] font-medium", children: label }),
+    /* @__PURE__ */ jsx(Icon, { icon: UiArrowRight, className: "text-[11px] text-muted-foreground" }),
+    /* @__PURE__ */ jsx(
+      "code",
+      {
+        className: cn(
+          "min-w-0 flex-1 truncate font-mono text-[11px]",
+          (result == null ? void 0 : result.value) === null || (result == null ? void 0 : result.value) === void 0 ? "text-muted-foreground" : ""
+        ),
+        children: pending ? "…" : preview(result == null ? void 0 : result.value)
+      }
+    ),
+    (result == null ? void 0 : result.type) && /* @__PURE__ */ jsx("span", { className: "rounded bg-muted px-1 text-[10px] text-muted-foreground", children: result.type })
+  ] });
+}
+function Coverage({
+  results,
+  rowCount,
+  focused,
+  onFocus,
+  rowLabel,
+  predicate
+}) {
+  if (rowCount === 0) return null;
+  const byIndex = new Map(results.map((result) => [result.index, result]));
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-1", children: [
+    /* @__PURE__ */ jsx("span", { className: "text-[11px] text-muted-foreground", children: predicate ? "Matches" : "Sample coverage" }),
+    /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-0.5", children: Array.from({ length: rowCount }, (_, index) => {
+      const result = byIndex.get(index);
+      const failed = Boolean(result == null ? void 0 : result.error);
+      const empty = !failed && ((result == null ? void 0 : result.value) === null || (result == null ? void 0 : result.value) === void 0);
+      const unselected = predicate && (result == null ? void 0 : result.value) === false;
+      const label = rowLabel == null ? void 0 : rowLabel(index);
+      return /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          "aria-label": label ?? `Row ${index + 1}`,
+          title: label,
+          onClick: () => onFocus(index),
+          className: cn(
+            "h-5 w-5 rounded-sm border text-[9px] tabular-nums",
+            failed ? "border-destructive/50 bg-destructive/20 text-destructive" : empty ? "border-border bg-muted text-muted-foreground" : unselected ? "border-border bg-background text-muted-foreground" : "border-green-600/40 bg-green-500/20 text-green-800 [[data-theme=dark]_&]:text-green-300",
+            index === focused && "ring-2 ring-primary ring-offset-1"
+          ),
+          children: index + 1
+        },
+        index
+      );
+    }) })
+  ] });
+}
+export {
+  Coverage,
+  ResultStrip,
+  Tally
+};
+//# sourceMappingURL=celEditorResults.js.map

package/dist/profiles/cel/celEditorResults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celEditorResults.js","sources":["../../../src/profiles/cel/celEditorResults.tsx"],"sourcesContent":["import { Badge } from \"../../data/Badge\";\nimport { Button } from \"../../components/button\";\nimport { Icon } from \"../../data/Icon\";\nimport { cn } from \"../../lib/utils\";\nimport { UiArrowRight, UiSparkles, UiWarningTriangle } from \"../../icons\";\nimport { explainCelError, type CelCoverage, type CelResult } from \"./celExpression\";\n\n/**\n * What the expression made of the rows, in badges.\n *\n * A predicate's true and false are both values, so the coverage count would\n * call every row \"evaluated\" — which says nothing about which rows it selects.\n */\nexport function Tally({\n  found,\n  results,\n  predicate,\n}: {\n  found: CelCoverage;\n  results: CelResult[];\n  predicate?: boolean | undefined;\n}) {\n  const matched = results.filter((result) => result.value === true).length;\n  const missed = results.filter((result) => result.value === false).length;\n  return (\n    <div className=\"flex flex-wrap items-center gap-1.5\">\n      {predicate ? (\n        <>\n          <Badge tone=\"success\" variant=\"soft\" size=\"md\">\n            {matched} true\n          </Badge>\n          <Badge tone=\"neutral\" variant=\"soft\" size=\"md\">\n            {missed} false\n          </Badge>\n        </>\n      ) : (\n        <Badge tone=\"success\" variant=\"soft\" size=\"md\">\n          {found.ok} evaluated\n        </Badge>\n      )}\n      {found.empty > 0 && (\n        <Badge tone=\"warning\" variant=\"soft\" size=\"md\">\n          {found.empty} empty\n        </Badge>\n      )}\n      {found.failed > 0 && (\n        <Badge tone=\"danger\" variant=\"soft\" size=\"md\" icon={UiWarningTriangle}>\n          {found.failed} failed\n        </Badge>\n      )}\n    </div>\n  );\n}\n\n/**\n * One row's result, in one line.\n *\n * `String()` on a list of objects is a row of `[object Object]`, which is the\n * same non-answer the scope panel used to give — an expression that returns\n * structure has to show its structure to be judged at all.\n */\nfunction preview(value: unknown): string {\n  if (value === null || value === undefined) return \"null\";\n  if (typeof value === \"object\") return JSON.stringify(value);\n  return String(value);\n}\n\nexport function ResultStrip({\n  result,\n  label,\n  pending,\n  draft,\n  onFix,\n}: {\n  result: { value?: unknown; type?: string; error?: string } | undefined;\n  label: string;\n  pending: boolean;\n  draft: string;\n  onFix: (next: string) => void;\n}) {\n  if (result?.error) {\n    // The engine reports in the vocabulary of the Go library underneath it and\n    // interpolates the whole offending value, so what it says is translated\n    // and what it quotes is trimmed.\n    const failure = explainCelError(result.error, draft);\n    return (\n      <div className=\"space-y-1 rounded border border-destructive/40 bg-destructive/[0.06] p-2\">\n        <div className=\"text-[11px] font-medium text-destructive\">{label} — evaluation failed</div>\n        <p className=\"text-[11px] text-destructive\">{failure.message}</p>\n        {failure.fix && (\n          <Button size=\"sm\" variant=\"outline\" className=\"gap-1.5\" onClick={() => onFix(failure.fix!)}>\n            <Icon icon={UiSparkles} className=\"text-[12px]\" />\n            Fix it\n          </Button>\n        )}\n        <code\n          className=\"block break-all font-mono text-[10px] text-muted-foreground\"\n          title={result.error}\n        >\n          {failure.raw}\n        </code>\n      </div>\n    );\n  }\n  return (\n    <div className=\"flex items-baseline gap-2 rounded border border-border bg-muted/40 p-2\">\n      <span className=\"text-[11px] font-medium\">{label}</span>\n      <Icon icon={UiArrowRight} className=\"text-[11px] text-muted-foreground\" />\n      <code\n        className={cn(\n          \"min-w-0 flex-1 truncate font-mono text-[11px]\",\n          result?.value === null || result?.value === undefined ? \"text-muted-foreground\" : \"\",\n        )}\n      >\n        {pending ? \"…\" : preview(result?.value)}\n      </code>\n      {result?.type && <span className=\"rounded bg-muted px-1 text-[10px] text-muted-foreground\">{result.type}</span>}\n    </div>\n  );\n}\n\n/**\n * Every row as one cell, coloured by what the expression made of it. A\n * predicate's `false` is drawn apart from `true`: both evaluated, but only one\n * selected the row.\n */\nexport function Coverage({\n  results,\n  rowCount,\n  focused,\n  onFocus,\n  rowLabel,\n  predicate,\n}: {\n  results: CelResult[];\n  rowCount: number;\n  focused: number;\n  onFocus: (index: number) => void;\n  rowLabel?: ((index: number) => string) | undefined;\n  predicate?: boolean | undefined;\n}) {\n  if (rowCount === 0) return null;\n  const byIndex = new Map(results.map((result) => [result.index, result]));\n\n  return (\n    <div className=\"space-y-1\">\n      <span className=\"text-[11px] text-muted-foreground\">{predicate ? \"Matches\" : \"Sample coverage\"}</span>\n      <div className=\"flex flex-wrap gap-0.5\">\n        {Array.from({ length: rowCount }, (_, index) => {\n          const result = byIndex.get(index);\n          const failed = Boolean(result?.error);\n          const empty = !failed && (result?.value === null || result?.value === undefined);\n          const unselected = predicate && result?.value === false;\n          const label = rowLabel?.(index);\n          return (\n            <button\n              key={index}\n              type=\"button\"\n              aria-label={label ?? `Row ${index + 1}`}\n              title={label}\n              onClick={() => onFocus(index)}\n              className={cn(\n                \"h-5 w-5 rounded-sm border text-[9px] tabular-nums\",\n                failed\n                  ? \"border-destructive/50 bg-destructive/20 text-destructive\"\n                  : empty\n                    ? \"border-border bg-muted text-muted-foreground\"\n                    : unselected\n                      ? \"border-border bg-background text-muted-foreground\"\n                      : \"border-green-600/40 bg-green-500/20 text-green-800 [[data-theme=dark]_&]:text-green-300\",\n                index === focused && \"ring-2 ring-primary ring-offset-1\",\n              )}\n            >\n              {index + 1}\n            </button>\n          );\n        })}\n      </div>\n    </div>\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/profiles/cel/celExamples.cjs

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const celExpression = require("./celExpression.cjs");
+function isKeyValueList(value) {
+  return Array.isArray(value) && value.length > 0 && value.every(
+    (entry) => entry !== null && typeof entry === "object" && "key" in entry && "value" in entry
+  );
+}
+function decoded(value) {
+  if (typeof value !== "string") return value;
+  const text = value.trim();
+  if (!text.startsWith("{") && !text.startsWith("[")) return value;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return value;
+  }
+}
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function member(base, key) {
+  return celExpression.isIdentifier(key) ? `${base}.${key}` : `${base}[${JSON.stringify(key)}]`;
+}
+function presence(base, key) {
+  return celExpression.isIdentifier(key) ? `has(${base}.${key})` : `${JSON.stringify(key)} in ${base}`;
+}
+function foldedMap(accessor) {
+  return `dyn(${accessor}).fold(e, acc, merge(acc, {e.key: e.value}))`;
+}
+function celExamplesFor(accessor, value, { predicate = false } = {}) {
+  const inner = decoded(value);
+  return predicate ? predicateExamples(accessor, inner) : valueExamples(accessor, inner);
+}
+function valueExamples(accessor, inner) {
+  var _a;
+  const range = `dyn(${accessor})`;
+  if (isKeyValueList(inner)) {
+    const sample = String(((_a = inner[0]) == null ? void 0 : _a["key"]) ?? "key");
+    const asMap = foldedMap(accessor);
+    return [
+      { label: `Read ${sample}`, expression: `${asMap}[${JSON.stringify(sample)}]` },
+      // The map itself has to be encoded to leave the engine: a CEL map is a
+      // map[ref.Val]ref.Val, which the response cannot serialize. Indexing one
+      // yields a scalar and needs no such call, which is why only this example
+      // carries it.
+      { label: "Fold every entry into a map", expression: `${asMap}.toJSON()` },
+      { label: "List the keys", expression: `${range}.map(e, e.key)` },
+      { label: "Keep the whole list", expression: accessor }
+    ];
+  }
+  if (Array.isArray(inner)) {
+    const field = isObject(inner[0]) ? Object.keys(inner[0])[0] : void 0;
+    return [
+      { label: "Take the first entry", expression: `${accessor}[0]` },
+      { label: "Count the entries", expression: `size(${accessor})` },
+      ...field ? [{ label: `Pull ${field} from each`, expression: `${range}.map(e, ${member("e", field)})` }] : [],
+      { label: "Keep the whole list", expression: accessor }
+    ];
+  }
+  if (isObject(inner)) {
+    const field = Object.keys(inner)[0];
+    return [
+      ...field ? [
+        { label: `Read ${field}`, expression: member(accessor, field) },
+        {
+          label: `Default ${field} when missing`,
+          expression: `${presence(accessor, field)} ? ${member(accessor, field)} : ""`
+        }
+      ] : [],
+      { label: "List the keys", expression: `${accessor}.keys()` },
+      { label: "Keep the whole object", expression: accessor }
+    ];
+  }
+  return [
+    { label: "Read it", expression: accessor },
+    { label: "Convert to text", expression: `string(${accessor})` },
+    ...typeof inner === "number" ? [{ label: "Scale by 1,000", expression: `${accessor} / 1000.0` }] : []
+  ];
+}
+function firstEntryTest(accessor, first) {
+  if (first === void 0) return [];
+  if (!isObject(first)) {
+    return [{ label: `Contains ${String(first)}`, expression: `${JSON.stringify(first)} in ${accessor}` }];
+  }
+  const field = Object.keys(first)[0];
+  if (!field) return [];
+  return [
+    {
+      label: `Any entry with ${field} ${String(first[field])}`,
+      expression: `dyn(${accessor}).exists(e, ${member("e", field)} == ${JSON.stringify(first[field])})`
+    }
+  ];
+}
+function predicateExamples(accessor, inner) {
+  var _a, _b;
+  if (isKeyValueList(inner)) {
+    const key = String(((_a = inner[0]) == null ? void 0 : _a["key"]) ?? "key");
+    const value = (_b = inner[0]) == null ? void 0 : _b["value"];
+    return [
+      {
+        label: `${key} is ${String(value)}`,
+        expression: `${foldedMap(accessor)}[${JSON.stringify(key)}] == ${JSON.stringify(value)}`
+      }
+    ];
+  }
+  if (Array.isArray(inner)) {
+    return [
+      ...firstEntryTest(accessor, inner[0]),
+      { label: "Is not empty", expression: `size(${accessor}) > 0` },
+      { label: "Is empty", expression: `size(${accessor}) == 0` }
+    ];
+  }
+  if (isObject(inner)) {
+    const field = Object.keys(inner)[0];
+    return [
+      ...field ? [{ label: `Has ${field}`, expression: presence(accessor, field) }] : [],
+      { label: "Is not empty", expression: `size(${accessor}) > 0` }
+    ];
+  }
+  if (typeof inner === "boolean") {
+    return [
+      { label: "Is true", expression: accessor },
+      { label: "Is false", expression: `!${accessor}` }
+    ];
+  }
+  const literal = JSON.stringify(inner ?? null);
+  return [
+    { label: `Is ${String(inner)}`, expression: `${accessor} == ${literal}` },
+    { label: `Is not ${String(inner)}`, expression: `${accessor} != ${literal}` }
+  ];
+}
+exports.celExamplesFor = celExamplesFor;
+//# sourceMappingURL=celExamples.cjs.map

package/dist/profiles/cel/celExamples.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"celExamples.cjs","sources":["../../../src/profiles/cel/celExamples.ts"],"sourcesContent":["import { isIdentifier } from \"./celExpression\";\n\n/** An example expression the author can drop into the draft. */\nexport type CelExample = { label: string; expression: string };\n\n/** Whether a list looks like OpenTelemetry's `[{key, type, value}]` tag shape. */\nfunction isKeyValueList(value: unknown): value is Array<Record<string, unknown>> {\n  return (\n    Array.isArray(value) &&\n    value.length > 0 &&\n    value.every(\n      (entry) =>\n        entry !== null && typeof entry === \"object\" && \"key\" in entry && \"value\" in entry,\n    )\n  );\n}\n\n/** The value behind an accessor, decoded when the column holds JSON as text. */\nfunction decoded(value: unknown): unknown {\n  if (typeof value !== \"string\") return value;\n  const text = value.trim();\n  if (!text.startsWith(\"{\") && !text.startsWith(\"[\")) return value;\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    return value;\n  }\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** A key read off `base`: dotted when CEL can name it, indexed when it cannot. */\nfunction member(base: string, key: string): string {\n  return isIdentifier(key) ? `${base}.${key}` : `${base}[${JSON.stringify(key)}]`;\n}\n\n/** Whether `base` has `key`: `has()` takes only a dotted selection. */\nfunction presence(base: string, key: string): string {\n  return isIdentifier(key) ? `has(${base}.${key})` : `${JSON.stringify(key)} in ${base}`;\n}\n\n/** A key/value list folded into a map, so a missing key reads as absent. */\nfunction foldedMap(accessor: string): string {\n  return `dyn(${accessor}).fold(e, acc, merge(acc, {e.key: e.value}))`;\n}\n\nexport type CelExampleOptions = {\n  /**\n   * The expression selects rows rather than computing a value — a filter, an\n   * authorization matcher — so every example has to be a test: the engine\n   * refuses a predicate that returns anything but a bool.\n   */\n  predicate?: boolean | undefined;\n};\n\n/**\n * Examples that fit the value in front of the author.\n *\n * A fixed list is wrong wherever it matters most: on a JSON column every\n * suggestion built from the field name alone reads the encoded string rather\n * than what is in it. These are derived from the sampled value, so the decoder\n * they carry is the one that value actually needs — which is the same mistake\n * the editor exists to stop the author making.\n *\n * The syntax is gomplate's own, verified against its CEL reference: the\n * comprehension macros (map/filter/exists), and `fold` with the `merge` helper\n * for folding a key/value list into a map. Ranges are wrapped in `dyn(...)`\n * because the engine declares every binding as `any` and a comprehension needs\n * a concrete list to walk.\n */\nexport function celExamplesFor(\n  accessor: string,\n  value: unknown,\n  { predicate = false }: CelExampleOptions = {},\n): CelExample[] {\n  const inner = decoded(value);\n  return predicate ? predicateExamples(accessor, inner) : valueExamples(accessor, inner);\n}\n\nfunction valueExamples(accessor: string, inner: unknown): CelExample[] {\n  const range = `dyn(${accessor})`;\n\n  if (isKeyValueList(inner)) {\n    const sample = String(inner[0]?.[\"key\"] ?? \"key\");\n    const asMap = foldedMap(accessor);\n    return [\n      { label: `Read ${sample}`, expression: `${asMap}[${JSON.stringify(sample)}]` },\n      // The map itself has to be encoded to leave the engine: a CEL map is a\n      // map[ref.Val]ref.Val, which the response cannot serialize. Indexing one\n      // yields a scalar and needs no such call, which is why only this example\n      // carries it.\n      { label: \"Fold every entry into a map\", expression: `${asMap}.toJSON()` },\n      { label: \"List the keys\", expression: `${range}.map(e, e.key)` },\n      { label: \"Keep the whole list\", expression: accessor },\n    ];\n  }\n\n  if (Array.isArray(inner)) {\n    // Only an object has fields to pull: the keys of a string are its indices.\n    const field = isObject(inner[0]) ? Object.keys(inner[0])[0] : undefined;\n    return [\n      { label: \"Take the first entry\", expression: `${accessor}[0]` },\n      { label: \"Count the entries\", expression: `size(${accessor})` },\n      ...(field\n        ? [{ label: `Pull ${field} from each`, expression: `${range}.map(e, ${member(\"e\", field)})` }]\n        : []),\n      { label: \"Keep the whole list\", expression: accessor },\n    ];\n  }\n\n  if (isObject(inner)) {\n    const field = Object.keys(inner)[0];\n    return [\n      ...(field\n        ? [\n            { label: `Read ${field}`, expression: member(accessor, field) },\n            {\n              label: `Default ${field} when missing`,\n              expression: `${presence(accessor, field)} ? ${member(accessor, field)} : \"\"`,\n            },\n          ]\n        : []),\n      { label: \"List the keys\", expression: `${accessor}.keys()` },\n      { label: \"Keep the whole object\", expression: accessor },\n    ];\n  }\n\n  return [\n    { label: \"Read it\", expression: accessor },\n    { label: \"Convert to text\", expression: `string(${accessor})` },\n    ...(typeof inner === \"number\"\n      ? [{ label: \"Scale by 1,000\", expression: `${accessor} / 1000.0` }]\n      : []),\n  ];\n}\n\n/** A test that the sampled list's first entry passes: membership, or a field match. */\nfunction firstEntryTest(accessor: string, first: unknown): CelExample[] {\n  if (first === undefined) return [];\n  if (!isObject(first)) {\n    return [{ label: `Contains ${String(first)}`, expression: `${JSON.stringify(first)} in ${accessor}` }];\n  }\n  const field = Object.keys(first)[0];\n  if (!field) return [];\n  return [\n    {\n      label: `Any entry with ${field} ${String(first[field])}`,\n      expression: `dyn(${accessor}).exists(e, ${member(\"e\", field)} == ${JSON.stringify(first[field])})`,\n    },\n  ];\n}\n\nfunction predicateExamples(accessor: string, inner: unknown): CelExample[] {\n  if (isKeyValueList(inner)) {\n    const key = String(inner[0]?.[\"key\"] ?? \"key\");\n    const value = inner[0]?.[\"value\"];\n    return [\n      {\n        label: `${key} is ${String(value)}`,\n        expression: `${foldedMap(accessor)}[${JSON.stringify(key)}] == ${JSON.stringify(value)}`,\n      },\n    ];\n  }\n\n  if (Array.isArray(inner)) {\n    return [\n      ...firstEntryTest(accessor, inner[0]),\n      { label: \"Is not empty\", expression: `size(${accessor}) > 0` },\n      { label: \"Is empty\", expression: `size(${accessor}) == 0` },\n    ];\n  }\n\n  if (isObject(inner)) {\n    const field = Object.keys(inner)[0];\n    return [\n      ...(field ? [{ label: `Has ${field}`, expression: presence(accessor, field) }] : []),\n      { label: \"Is not empty\", expression: `size(${accessor}) > 0` },\n    ];\n  }\n\n  if (typeof inner === \"boolean\") {\n    return [\n      { label: \"Is true\", expression: accessor },\n      { label: \"Is false\", expression: `!${accessor}` },\n    ];\n  }\n\n  const literal = JSON.stringify(inner ?? null);\n  return [\n    { label: `Is ${String(inner)}`, expression: `${accessor} == ${literal}` },\n    { label: `Is not ${String(inner)}`, expression: `${accessor} != ${literal}` },\n  ];\n}\n"],"names":["isIdentifier"],"mappings":"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"}

package/dist/profiles/cel/celExamples.d.ts

@@ -0,0 +1,30 @@
+/** An example expression the author can drop into the draft. */
+export type CelExample = {
+    label: string;
+    expression: string;
+};
+export type CelExampleOptions = {
+    /**
+     * The expression selects rows rather than computing a value — a filter, an
+     * authorization matcher — so every example has to be a test: the engine
+     * refuses a predicate that returns anything but a bool.
+     */
+    predicate?: boolean | undefined;
+};
+/**
+ * Examples that fit the value in front of the author.
+ *
+ * A fixed list is wrong wherever it matters most: on a JSON column every
+ * suggestion built from the field name alone reads the encoded string rather
+ * than what is in it. These are derived from the sampled value, so the decoder
+ * they carry is the one that value actually needs — which is the same mistake
+ * the editor exists to stop the author making.
+ *
+ * The syntax is gomplate's own, verified against its CEL reference: the
+ * comprehension macros (map/filter/exists), and `fold` with the `merge` helper
+ * for folding a key/value list into a map. Ranges are wrapped in `dyn(...)`
+ * because the engine declares every binding as `any` and a comprehension needs
+ * a concrete list to walk.
+ */
+export declare function celExamplesFor(accessor: string, value: unknown, { predicate }?: CelExampleOptions): CelExample[];
+//# sourceMappingURL=celExamples.d.ts.map

package/dist/profiles/cel/celExamples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"celExamples.d.ts","sourceRoot":"","sources":["../../../src/profiles/cel/celExamples.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AA6C/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,EAAE,SAAiB,EAAE,GAAE,iBAAsB,GAC5C,UAAU,EAAE,CAGd"}

package/dist/profiles/cel/celExamples.js

@@ -0,0 +1,134 @@
+import { isIdentifier } from "./celExpression.js";
+function isKeyValueList(value) {
+  return Array.isArray(value) && value.length > 0 && value.every(
+    (entry) => entry !== null && typeof entry === "object" && "key" in entry && "value" in entry
+  );
+}
+function decoded(value) {
+  if (typeof value !== "string") return value;
+  const text = value.trim();
+  if (!text.startsWith("{") && !text.startsWith("[")) return value;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return value;
+  }
+}
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function member(base, key) {
+  return isIdentifier(key) ? `${base}.${key}` : `${base}[${JSON.stringify(key)}]`;
+}
+function presence(base, key) {
+  return isIdentifier(key) ? `has(${base}.${key})` : `${JSON.stringify(key)} in ${base}`;
+}
+function foldedMap(accessor) {
+  return `dyn(${accessor}).fold(e, acc, merge(acc, {e.key: e.value}))`;
+}
+function celExamplesFor(accessor, value, { predicate = false } = {}) {
+  const inner = decoded(value);
+  return predicate ? predicateExamples(accessor, inner) : valueExamples(accessor, inner);
+}
+function valueExamples(accessor, inner) {
+  var _a;
+  const range = `dyn(${accessor})`;
+  if (isKeyValueList(inner)) {
+    const sample = String(((_a = inner[0]) == null ? void 0 : _a["key"]) ?? "key");
+    const asMap = foldedMap(accessor);
+    return [
+      { label: `Read ${sample}`, expression: `${asMap}[${JSON.stringify(sample)}]` },
+      // The map itself has to be encoded to leave the engine: a CEL map is a
+      // map[ref.Val]ref.Val, which the response cannot serialize. Indexing one
+      // yields a scalar and needs no such call, which is why only this example
+      // carries it.
+      { label: "Fold every entry into a map", expression: `${asMap}.toJSON()` },
+      { label: "List the keys", expression: `${range}.map(e, e.key)` },
+      { label: "Keep the whole list", expression: accessor }
+    ];
+  }
+  if (Array.isArray(inner)) {
+    const field = isObject(inner[0]) ? Object.keys(inner[0])[0] : void 0;
+    return [
+      { label: "Take the first entry", expression: `${accessor}[0]` },
+      { label: "Count the entries", expression: `size(${accessor})` },
+      ...field ? [{ label: `Pull ${field} from each`, expression: `${range}.map(e, ${member("e", field)})` }] : [],
+      { label: "Keep the whole list", expression: accessor }
+    ];
+  }
+  if (isObject(inner)) {
+    const field = Object.keys(inner)[0];
+    return [
+      ...field ? [
+        { label: `Read ${field}`, expression: member(accessor, field) },
+        {
+          label: `Default ${field} when missing`,
+          expression: `${presence(accessor, field)} ? ${member(accessor, field)} : ""`
+        }
+      ] : [],
+      { label: "List the keys", expression: `${accessor}.keys()` },
+      { label: "Keep the whole object", expression: accessor }
+    ];
+  }
+  return [
+    { label: "Read it", expression: accessor },
+    { label: "Convert to text", expression: `string(${accessor})` },
+    ...typeof inner === "number" ? [{ label: "Scale by 1,000", expression: `${accessor} / 1000.0` }] : []
+  ];
+}
+function firstEntryTest(accessor, first) {
+  if (first === void 0) return [];
+  if (!isObject(first)) {
+    return [{ label: `Contains ${String(first)}`, expression: `${JSON.stringify(first)} in ${accessor}` }];
+  }
+  const field = Object.keys(first)[0];
+  if (!field) return [];
+  return [
+    {
+      label: `Any entry with ${field} ${String(first[field])}`,
+      expression: `dyn(${accessor}).exists(e, ${member("e", field)} == ${JSON.stringify(first[field])})`
+    }
+  ];
+}
+function predicateExamples(accessor, inner) {
+  var _a, _b;
+  if (isKeyValueList(inner)) {
+    const key = String(((_a = inner[0]) == null ? void 0 : _a["key"]) ?? "key");
+    const value = (_b = inner[0]) == null ? void 0 : _b["value"];
+    return [
+      {
+        label: `${key} is ${String(value)}`,
+        expression: `${foldedMap(accessor)}[${JSON.stringify(key)}] == ${JSON.stringify(value)}`
+      }
+    ];
+  }
+  if (Array.isArray(inner)) {
+    return [
+      ...firstEntryTest(accessor, inner[0]),
+      { label: "Is not empty", expression: `size(${accessor}) > 0` },
+      { label: "Is empty", expression: `size(${accessor}) == 0` }
+    ];
+  }
+  if (isObject(inner)) {
+    const field = Object.keys(inner)[0];
+    return [
+      ...field ? [{ label: `Has ${field}`, expression: presence(accessor, field) }] : [],
+      { label: "Is not empty", expression: `size(${accessor}) > 0` }
+    ];
+  }
+  if (typeof inner === "boolean") {
+    return [
+      { label: "Is true", expression: accessor },
+      { label: "Is false", expression: `!${accessor}` }
+    ];
+  }
+  const literal = JSON.stringify(inner ?? null);
+  return [
+    { label: `Is ${String(inner)}`, expression: `${accessor} == ${literal}` },
+    { label: `Is not ${String(inner)}`, expression: `${accessor} != ${literal}` }
+  ];
+}
+export {
+  celExamplesFor
+};
+//# sourceMappingURL=celExamples.js.map

package/dist/profiles/cel/celExamples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celExamples.js","sources":["../../../src/profiles/cel/celExamples.ts"],"sourcesContent":["import { isIdentifier } from \"./celExpression\";\n\n/** An example expression the author can drop into the draft. */\nexport type CelExample = { label: string; expression: string };\n\n/** Whether a list looks like OpenTelemetry's `[{key, type, value}]` tag shape. */\nfunction isKeyValueList(value: unknown): value is Array<Record<string, unknown>> {\n  return (\n    Array.isArray(value) &&\n    value.length > 0 &&\n    value.every(\n      (entry) =>\n        entry !== null && typeof entry === \"object\" && \"key\" in entry && \"value\" in entry,\n    )\n  );\n}\n\n/** The value behind an accessor, decoded when the column holds JSON as text. */\nfunction decoded(value: unknown): unknown {\n  if (typeof value !== \"string\") return value;\n  const text = value.trim();\n  if (!text.startsWith(\"{\") && !text.startsWith(\"[\")) return value;\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    return value;\n  }\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** A key read off `base`: dotted when CEL can name it, indexed when it cannot. */\nfunction member(base: string, key: string): string {\n  return isIdentifier(key) ? `${base}.${key}` : `${base}[${JSON.stringify(key)}]`;\n}\n\n/** Whether `base` has `key`: `has()` takes only a dotted selection. */\nfunction presence(base: string, key: string): string {\n  return isIdentifier(key) ? `has(${base}.${key})` : `${JSON.stringify(key)} in ${base}`;\n}\n\n/** A key/value list folded into a map, so a missing key reads as absent. */\nfunction foldedMap(accessor: string): string {\n  return `dyn(${accessor}).fold(e, acc, merge(acc, {e.key: e.value}))`;\n}\n\nexport type CelExampleOptions = {\n  /**\n   * The expression selects rows rather than computing a value — a filter, an\n   * authorization matcher — so every example has to be a test: the engine\n   * refuses a predicate that returns anything but a bool.\n   */\n  predicate?: boolean | undefined;\n};\n\n/**\n * Examples that fit the value in front of the author.\n *\n * A fixed list is wrong wherever it matters most: on a JSON column every\n * suggestion built from the field name alone reads the encoded string rather\n * than what is in it. These are derived from the sampled value, so the decoder\n * they carry is the one that value actually needs — which is the same mistake\n * the editor exists to stop the author making.\n *\n * The syntax is gomplate's own, verified against its CEL reference: the\n * comprehension macros (map/filter/exists), and `fold` with the `merge` helper\n * for folding a key/value list into a map. Ranges are wrapped in `dyn(...)`\n * because the engine declares every binding as `any` and a comprehension needs\n * a concrete list to walk.\n */\nexport function celExamplesFor(\n  accessor: string,\n  value: unknown,\n  { predicate = false }: CelExampleOptions = {},\n): CelExample[] {\n  const inner = decoded(value);\n  return predicate ? predicateExamples(accessor, inner) : valueExamples(accessor, inner);\n}\n\nfunction valueExamples(accessor: string, inner: unknown): CelExample[] {\n  const range = `dyn(${accessor})`;\n\n  if (isKeyValueList(inner)) {\n    const sample = String(inner[0]?.[\"key\"] ?? \"key\");\n    const asMap = foldedMap(accessor);\n    return [\n      { label: `Read ${sample}`, expression: `${asMap}[${JSON.stringify(sample)}]` },\n      // The map itself has to be encoded to leave the engine: a CEL map is a\n      // map[ref.Val]ref.Val, which the response cannot serialize. Indexing one\n      // yields a scalar and needs no such call, which is why only this example\n      // carries it.\n      { label: \"Fold every entry into a map\", expression: `${asMap}.toJSON()` },\n      { label: \"List the keys\", expression: `${range}.map(e, e.key)` },\n      { label: \"Keep the whole list\", expression: accessor },\n    ];\n  }\n\n  if (Array.isArray(inner)) {\n    // Only an object has fields to pull: the keys of a string are its indices.\n    const field = isObject(inner[0]) ? Object.keys(inner[0])[0] : undefined;\n    return [\n      { label: \"Take the first entry\", expression: `${accessor}[0]` },\n      { label: \"Count the entries\", expression: `size(${accessor})` },\n      ...(field\n        ? [{ label: `Pull ${field} from each`, expression: `${range}.map(e, ${member(\"e\", field)})` }]\n        : []),\n      { label: \"Keep the whole list\", expression: accessor },\n    ];\n  }\n\n  if (isObject(inner)) {\n    const field = Object.keys(inner)[0];\n    return [\n      ...(field\n        ? [\n            { label: `Read ${field}`, expression: member(accessor, field) },\n            {\n              label: `Default ${field} when missing`,\n              expression: `${presence(accessor, field)} ? ${member(accessor, field)} : \"\"`,\n            },\n          ]\n        : []),\n      { label: \"List the keys\", expression: `${accessor}.keys()` },\n      { label: \"Keep the whole object\", expression: accessor },\n    ];\n  }\n\n  return [\n    { label: \"Read it\", expression: accessor },\n    { label: \"Convert to text\", expression: `string(${accessor})` },\n    ...(typeof inner === \"number\"\n      ? [{ label: \"Scale by 1,000\", expression: `${accessor} / 1000.0` }]\n      : []),\n  ];\n}\n\n/** A test that the sampled list's first entry passes: membership, or a field match. */\nfunction firstEntryTest(accessor: string, first: unknown): CelExample[] {\n  if (first === undefined) return [];\n  if (!isObject(first)) {\n    return [{ label: `Contains ${String(first)}`, expression: `${JSON.stringify(first)} in ${accessor}` }];\n  }\n  const field = Object.keys(first)[0];\n  if (!field) return [];\n  return [\n    {\n      label: `Any entry with ${field} ${String(first[field])}`,\n      expression: `dyn(${accessor}).exists(e, ${member(\"e\", field)} == ${JSON.stringify(first[field])})`,\n    },\n  ];\n}\n\nfunction predicateExamples(accessor: string, inner: unknown): CelExample[] {\n  if (isKeyValueList(inner)) {\n    const key = String(inner[0]?.[\"key\"] ?? \"key\");\n    const value = inner[0]?.[\"value\"];\n    return [\n      {\n        label: `${key} is ${String(value)}`,\n        expression: `${foldedMap(accessor)}[${JSON.stringify(key)}] == ${JSON.stringify(value)}`,\n      },\n    ];\n  }\n\n  if (Array.isArray(inner)) {\n    return [\n      ...firstEntryTest(accessor, inner[0]),\n      { label: \"Is not empty\", expression: `size(${accessor}) > 0` },\n      { label: \"Is empty\", expression: `size(${accessor}) == 0` },\n    ];\n  }\n\n  if (isObject(inner)) {\n    const field = Object.keys(inner)[0];\n    return [\n      ...(field ? [{ label: `Has ${field}`, expression: presence(accessor, field) }] : []),\n      { label: \"Is not empty\", expression: `size(${accessor}) > 0` },\n    ];\n  }\n\n  if (typeof inner === \"boolean\") {\n    return [\n      { label: \"Is true\", expression: accessor },\n      { label: \"Is false\", expression: `!${accessor}` },\n    ];\n  }\n\n  const literal = JSON.stringify(inner ?? null);\n  return [\n    { label: `Is ${String(inner)}`, expression: `${accessor} == ${literal}` },\n    { label: `Is not ${String(inner)}`, expression: `${accessor} != ${literal}` },\n  ];\n}\n"],"names":[],"mappings":"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"}

package/dist/profiles/cel/celExpression.cjs

@@ -71,6 +71,21 @@ function bindingsFor(scope, row) {
 function unreachableKeys(row) {
   return Object.keys(row ?? {}).filter((key) => !isIdentifier(key));
 }
+const SCOPE_LABEL = {
+  row: "Row",
+  batch: "Batch",
+  boundary: "Boundary"
+};
+function profileCelEnvironment(scope) {
+  return {
+    id: scope,
+    label: `${SCOPE_LABEL[scope]} scope`,
+    rowName: "row",
+    bindings: (row) => bindingsFor(scope, row),
+    evaluate: (cel, rows) => evaluateCel({ cel, scope, rows }),
+    ...scope === "row" ? {} : { unreachable: unreachableKeys }
+  };
+}
 const RAW_ERROR_LIMIT = 240;
 function elide(text, limit = RAW_ERROR_LIMIT) {
   if (text.length <= limit) return text;
@@ -99,76 +114,14 @@ function explainCelError(error, draft) {
   }
   return { message: raw, raw };
 }
-function isKeyValueList(value) {
-  return Array.isArray(value) && value.length > 0 && value.every(
-    (entry) => entry !== null && typeof entry === "object" && "key" in entry && "value" in entry
-  );
-}
-function decoded(value) {
-  if (typeof value !== "string") return value;
-  const text = value.trim();
-  if (!text.startsWith("{") && !text.startsWith("[")) return value;
-  try {
-    return JSON.parse(text);
-  } catch {
-    return value;
-  }
-}
-function celExamplesFor(accessor, value) {
-  var _a;
-  const inner = decoded(value);
-  const range = `dyn(${accessor})`;
-  if (isKeyValueList(inner)) {
-    const sample = String(((_a = inner[0]) == null ? void 0 : _a["key"]) ?? "key");
-    const asMap = `${range}.fold(e, acc, merge(acc, {e.key: e.value}))`;
-    return [
-      { label: `Read ${sample}`, expression: `${asMap}[${JSON.stringify(sample)}]` },
-      // The map itself has to be encoded to leave the engine: a CEL map is a
-      // map[ref.Val]ref.Val, which the response cannot serialize. Indexing one
-      // yields a scalar and needs no such call, which is why only this example
-      // carries it.
-      { label: "Fold every entry into a map", expression: `${asMap}.toJSON()` },
-      { label: "List the keys", expression: `${range}.map(e, e.key)` },
-      { label: "Keep the whole list", expression: accessor }
-    ];
-  }
-  if (Array.isArray(inner)) {
-    const field = Object.keys(inner[0] ?? {})[0];
-    return [
-      { label: "Take the first entry", expression: `${accessor}[0]` },
-      { label: "Count the entries", expression: `size(${accessor})` },
-      ...field ? [{ label: `Pull ${field} from each`, expression: `${range}.map(e, e.${field})` }] : [],
-      { label: "Keep the whole list", expression: accessor }
-    ];
-  }
-  if (inner !== null && typeof inner === "object") {
-    const field = Object.keys(inner)[0];
-    return [
-      ...field ? [
-        { label: `Read ${field}`, expression: `${accessor}.${field}` },
-        {
-          label: `Default ${field} when missing`,
-          expression: `has(${accessor}.${field}) ? ${accessor}.${field} : ""`
-        }
-      ] : [],
-      { label: "List the keys", expression: `${accessor}.keys()` },
-      { label: "Keep the whole object", expression: accessor }
-    ];
-  }
-  return [
-    { label: "Read it", expression: accessor },
-    { label: "Convert to text", expression: `string(${accessor})` },
-    ...typeof inner === "number" ? [{ label: "Scale by 1,000", expression: `${accessor} / 1000.0` }] : []
-  ];
-}
 exports.CEL_EDITOR_WIDGET = CEL_EDITOR_WIDGET;
 exports.bindingsFor = bindingsFor;
-exports.celExamplesFor = celExamplesFor;
 exports.coverage = coverage;
 exports.evaluateCel = evaluateCel;
 exports.explainCelError = explainCelError;
 exports.isClean = isClean;
 exports.isIdentifier = isIdentifier;
 exports.nextBarren = nextBarren;
+exports.profileCelEnvironment = profileCelEnvironment;
 exports.unreachableKeys = unreachableKeys;
 //# sourceMappingURL=celExpression.cjs.map