@flanksource/clicky-ui 0.3.34 → 0.3.36

package/dist/expressions/playground/VerticalSplit.js

@@ -0,0 +1,109 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useRef, useState, useEffect, useCallback } from "react";
+import { EDITOR_LINE_HEIGHT, rowsToPaneHeight } from "./verticalSplitModel.js";
+function VerticalSplit({
+  top,
+  bottom,
+  defaultTopHeight,
+  minTop = rowsToPaneHeight(2),
+  minBottom = 96,
+  storageKey
+}) {
+  const container = useRef(null);
+  const [topHeight, setTopHeight] = useState(
+    () => readStored(storageKey) ?? defaultTopHeight
+  );
+  const [dragging, setDragging] = useState(false);
+  const hasStoredSize = useRef(readStored(storageKey) !== null);
+  useEffect(() => {
+    if (!hasStoredSize.current) setTopHeight(defaultTopHeight);
+  }, [defaultTopHeight]);
+  const clamp = useCallback(
+    (height) => {
+      var _a;
+      const available = ((_a = container.current) == null ? void 0 : _a.getBoundingClientRect().height) ?? 0;
+      const upperBound = Math.max(minTop, available - minBottom);
+      return Math.round(Math.max(minTop, Math.min(upperBound, height)));
+    },
+    [minTop, minBottom]
+  );
+  const commit = useCallback(
+    (height) => {
+      const next = clamp(height);
+      setTopHeight(next);
+      hasStoredSize.current = true;
+      if (storageKey) window.localStorage.setItem(storageKey, String(next));
+    },
+    [clamp, storageKey]
+  );
+  const onPointerDown = useCallback(
+    (event) => {
+      var _a;
+      event.preventDefault();
+      const rect = (_a = container.current) == null ? void 0 : _a.getBoundingClientRect();
+      if (!rect) return;
+      setDragging(true);
+      const onMove = (moveEvent) => commit(moveEvent.clientY - rect.top);
+      const onUp = () => {
+        setDragging(false);
+        document.removeEventListener("pointermove", onMove);
+        document.removeEventListener("pointerup", onUp);
+      };
+      document.addEventListener("pointermove", onMove);
+      document.addEventListener("pointerup", onUp);
+    },
+    [commit]
+  );
+  const onKeyDown = useCallback(
+    (event) => {
+      const step = event.shiftKey ? EDITOR_LINE_HEIGHT * 5 : EDITOR_LINE_HEIGHT;
+      if (event.key === "ArrowUp") {
+        event.preventDefault();
+        commit(topHeight - step);
+      } else if (event.key === "ArrowDown") {
+        event.preventDefault();
+        commit(topHeight + step);
+      } else if (event.key === "Home") {
+        event.preventDefault();
+        commit(minTop);
+      }
+    },
+    [commit, topHeight, minTop]
+  );
+  return /* @__PURE__ */ jsxs("div", { ref: container, className: "flex h-full min-h-0 flex-col", children: [
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: "min-h-0 shrink-0 overflow-hidden",
+        style: { height: topHeight },
+        children: top
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        role: "separator",
+        "aria-orientation": "horizontal",
+        "aria-label": "Resize the expression editor",
+        "aria-valuenow": topHeight,
+        tabIndex: 0,
+        onPointerDown,
+        onKeyDown,
+        className: `group relative h-1.5 shrink-0 cursor-row-resize bg-border transition-colors hover:bg-primary/40 focus-visible:bg-primary/60 focus-visible:outline-none ${dragging ? "bg-primary/60" : ""}`,
+        children: /* @__PURE__ */ jsx("span", { className: "absolute inset-x-0 -top-1 -bottom-1" })
+      }
+    ),
+    /* @__PURE__ */ jsx("div", { className: "min-h-0 flex-1 overflow-hidden", children: bottom })
+  ] });
+}
+function readStored(key) {
+  if (!key || typeof window === "undefined") return null;
+  const raw = window.localStorage.getItem(key);
+  if (raw === null) return null;
+  const parsed = Number.parseInt(raw, 10);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+export {
+  VerticalSplit
+};
+//# sourceMappingURL=VerticalSplit.js.map

package/dist/expressions/playground/VerticalSplit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VerticalSplit.js","sources":["../../../src/expressions/playground/VerticalSplit.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  type KeyboardEvent as ReactKeyboardEvent,\n  type ReactNode,\n} from \"react\";\nimport { EDITOR_LINE_HEIGHT, rowsToPaneHeight } from \"./verticalSplitModel\";\n\nexport interface VerticalSplitProps {\n  top: ReactNode;\n  bottom: ReactNode;\n  /** Top-pane height in pixels, used until the reader drags the divider. */\n  defaultTopHeight: number;\n  /** Smallest the top pane may be dragged. Defaults to two rows. */\n  minTop?: number;\n  /** Smallest the bottom pane may be dragged. */\n  minBottom?: number;\n  /** localStorage key persisting the dragged height. */\n  storageKey?: string;\n}\n\n/**\n * A vertically stacked, resizable pair of panes.\n *\n * clicky-ui's SplitPane only splits horizontally, and the two editors stack, so\n * the divider here is its own component. Sizing is in pixels rather than a\n * percentage because the useful size of the expression editor is a number of\n * rows, which a percentage of a varying viewport does not express.\n */\nexport function VerticalSplit({\n  top,\n  bottom,\n  defaultTopHeight,\n  minTop = rowsToPaneHeight(2),\n  minBottom = 96,\n  storageKey,\n}: VerticalSplitProps) {\n  const container = useRef<HTMLDivElement>(null);\n  const [topHeight, setTopHeight] = useState(\n    () => readStored(storageKey) ?? defaultTopHeight,\n  );\n  const [dragging, setDragging] = useState(false);\n\n  // Only follow the language's default while the reader has not chosen a size:\n  // a dragged divider is a decision, and switching language should not undo it.\n  const hasStoredSize = useRef(readStored(storageKey) !== null);\n  useEffect(() => {\n    if (!hasStoredSize.current) setTopHeight(defaultTopHeight);\n  }, [defaultTopHeight]);\n\n  const clamp = useCallback(\n    (height: number) => {\n      const available = container.current?.getBoundingClientRect().height ?? 0;\n      const upperBound = Math.max(minTop, available - minBottom);\n      return Math.round(Math.max(minTop, Math.min(upperBound, height)));\n    },\n    [minTop, minBottom],\n  );\n\n  const commit = useCallback(\n    (height: number) => {\n      const next = clamp(height);\n      setTopHeight(next);\n      hasStoredSize.current = true;\n      if (storageKey) window.localStorage.setItem(storageKey, String(next));\n    },\n    [clamp, storageKey],\n  );\n\n  const onPointerDown = useCallback(\n    (event: React.PointerEvent<HTMLDivElement>) => {\n      event.preventDefault();\n      const rect = container.current?.getBoundingClientRect();\n      if (!rect) return;\n\n      setDragging(true);\n      const onMove = (moveEvent: PointerEvent) =>\n        commit(moveEvent.clientY - rect.top);\n      const onUp = () => {\n        setDragging(false);\n        document.removeEventListener(\"pointermove\", onMove);\n        document.removeEventListener(\"pointerup\", onUp);\n      };\n      document.addEventListener(\"pointermove\", onMove);\n      document.addEventListener(\"pointerup\", onUp);\n    },\n    [commit],\n  );\n\n  // A separator that can only be dragged is unusable without a mouse, and this\n  // one gates access to the input editor.\n  const onKeyDown = useCallback(\n    (event: ReactKeyboardEvent<HTMLDivElement>) => {\n      const step = event.shiftKey ? EDITOR_LINE_HEIGHT * 5 : EDITOR_LINE_HEIGHT;\n      if (event.key === \"ArrowUp\") {\n        event.preventDefault();\n        commit(topHeight - step);\n      } else if (event.key === \"ArrowDown\") {\n        event.preventDefault();\n        commit(topHeight + step);\n      } else if (event.key === \"Home\") {\n        event.preventDefault();\n        commit(minTop);\n      }\n    },\n    [commit, topHeight, minTop],\n  );\n\n  return (\n    <div ref={container} className=\"flex h-full min-h-0 flex-col\">\n      <div\n        className=\"min-h-0 shrink-0 overflow-hidden\"\n        style={{ height: topHeight }}\n      >\n        {top}\n      </div>\n\n      <div\n        role=\"separator\"\n        aria-orientation=\"horizontal\"\n        aria-label=\"Resize the expression editor\"\n        aria-valuenow={topHeight}\n        tabIndex={0}\n        onPointerDown={onPointerDown}\n        onKeyDown={onKeyDown}\n        className={`group relative h-1.5 shrink-0 cursor-row-resize bg-border transition-colors hover:bg-primary/40 focus-visible:bg-primary/60 focus-visible:outline-none ${\n          dragging ? \"bg-primary/60\" : \"\"\n        }`}\n      >\n        {/* A 6px strip is a small target; widen the grab area without moving\n            anything by overflowing an invisible band above and below it. */}\n        <span className=\"absolute inset-x-0 -top-1 -bottom-1\" />\n      </div>\n\n      <div className=\"min-h-0 flex-1 overflow-hidden\">{bottom}</div>\n    </div>\n  );\n}\n\nfunction readStored(key: string | undefined): number | null {\n  if (!key || typeof window === \"undefined\") return null;\n  const raw = window.localStorage.getItem(key);\n  if (raw === null) return null;\n  const parsed = Number.parseInt(raw, 10);\n  return Number.isFinite(parsed) ? parsed : null;\n}\n"],"names":[],"mappings":"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"}

package/dist/expressions/playground/api.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const DEFAULT_API_BASE = "/api";
+async function evaluate(apiBase, request, signal) {
+  let response;
+  try {
+    response = await fetch(`${apiBase}/eval`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(request),
+      ...signal ? { signal } : {}
+    });
+  } catch (cause) {
+    if (signal == null ? void 0 : signal.aborted) throw cause;
+    return {
+      result: "",
+      durationMs: 0,
+      error: { message: `could not reach the evaluation server: ${String(cause)}` }
+    };
+  }
+  if (!response.ok && response.status !== 400) {
+    return {
+      result: "",
+      durationMs: 0,
+      error: { message: `evaluation server returned ${response.status} ${response.statusText}` }
+    };
+  }
+  return await response.json();
+}
+async function fetchSpec(apiBase, signal) {
+  return fetchJSON(`${apiBase}/spec`, signal);
+}
+async function fetchExamples(apiBase, signal) {
+  return fetchJSON(`${apiBase}/examples`, signal);
+}
+async function fetchJSON(url, signal) {
+  try {
+    const response = await fetch(url, signal ? { signal } : {});
+    if (!response.ok) return void 0;
+    return await response.json();
+  } catch {
+    return void 0;
+  }
+}
+exports.DEFAULT_API_BASE = DEFAULT_API_BASE;
+exports.evaluate = evaluate;
+exports.fetchExamples = fetchExamples;
+exports.fetchSpec = fetchSpec;
+//# sourceMappingURL=api.cjs.map

package/dist/expressions/playground/api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.cjs","sources":["../../../src/expressions/playground/api.ts"],"sourcesContent":["import type { GomplateSpec } from \"../lang/index.ts\";\nimport type { EvalLanguage } from \"./languages.ts\";\n\nexport interface EvalRequest {\n  language: EvalLanguage;\n  source: string;\n  input?: string;\n  leftDelim?: string;\n  rightDelim?: string;\n}\n\nexport interface EvalError {\n  message: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface EvalResponse {\n  result: string;\n  value?: unknown;\n  type?: string;\n  error?: EvalError;\n  durationMs: number;\n}\n\n/** One sample an author can load, as `GET /api/examples` returns it. */\nexport interface Example {\n  name: string;\n  language: EvalLanguage;\n  source: string;\n  input: string;\n}\n\n/**\n * Where the host mounted the playground API.\n *\n * A host serves it under its own prefix -- mission-control behind an\n * authenticated route group -- so nothing here may assume `/api`.\n */\nexport const DEFAULT_API_BASE = \"/api\";\n\n/**\n * Evaluates against the host's Go server.\n *\n * A transport failure is surfaced as an error result rather than thrown: the\n * usual cause is the server not running yet, and the playground should say so\n * rather than blank out.\n */\nexport async function evaluate(\n  apiBase: string,\n  request: EvalRequest,\n  signal?: AbortSignal,\n): Promise<EvalResponse> {\n  let response: Response;\n  try {\n    response = await fetch(`${apiBase}/eval`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(request),\n      ...(signal ? { signal } : {}),\n    });\n  } catch (cause) {\n    if (signal?.aborted) throw cause;\n    return {\n      result: \"\",\n      durationMs: 0,\n      error: { message: `could not reach the evaluation server: ${String(cause)}` },\n    };\n  }\n\n  if (!response.ok && response.status !== 400) {\n    return {\n      result: \"\",\n      durationMs: 0,\n      error: { message: `evaluation server returned ${response.status} ${response.statusText}` },\n    };\n  }\n  return (await response.json()) as EvalResponse;\n}\n\n/**\n * The catalogue the running server can actually evaluate.\n *\n * Wider than the one this package ships whenever the host registers functions\n * of its own. Undefined on any failure, which leaves the packaged catalogue in\n * place -- right when the server is simply not up yet.\n */\nexport async function fetchSpec(\n  apiBase: string,\n  signal?: AbortSignal,\n): Promise<GomplateSpec | undefined> {\n  return fetchJSON<GomplateSpec>(`${apiBase}/spec`, signal);\n}\n\nexport async function fetchExamples(\n  apiBase: string,\n  signal?: AbortSignal,\n): Promise<Example[] | undefined> {\n  return fetchJSON<Example[]>(`${apiBase}/examples`, signal);\n}\n\nasync function fetchJSON<T>(url: string, signal?: AbortSignal): Promise<T | undefined> {\n  try {\n    const response = await fetch(url, signal ? { signal } : {});\n    if (!response.ok) return undefined;\n    return (await response.json()) as T;\n  } catch {\n    return undefined;\n  }\n}\n"],"names":[],"mappings":";;AAuCO,MAAM,mBAAmB;AAShC,eAAsB,SACpB,SACA,SACA,QACuB;AACvB,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,MAAM,GAAG,OAAO,SAAS;AAAA,MACxC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAA;AAAA,MAC3B,MAAM,KAAK,UAAU,OAAO;AAAA,MAC5B,GAAI,SAAS,EAAE,WAAW,CAAA;AAAA,IAAC,CAC5B;AAAA,EACH,SAAS,OAAO;AACd,QAAI,iCAAQ,QAAS,OAAM;AAC3B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,OAAO,EAAE,SAAS,0CAA0C,OAAO,KAAK,CAAC,GAAA;AAAA,IAAG;AAAA,EAEhF;AAEA,MAAI,CAAC,SAAS,MAAM,SAAS,WAAW,KAAK;AAC3C,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,OAAO,EAAE,SAAS,8BAA8B,SAAS,MAAM,IAAI,SAAS,UAAU,GAAA;AAAA,IAAG;AAAA,EAE7F;AACA,SAAQ,MAAM,SAAS,KAAA;AACzB;AASA,eAAsB,UACpB,SACA,QACmC;AACnC,SAAO,UAAwB,GAAG,OAAO,SAAS,MAAM;AAC1D;AAEA,eAAsB,cACpB,SACA,QACgC;AAChC,SAAO,UAAqB,GAAG,OAAO,aAAa,MAAM;AAC3D;AAEA,eAAe,UAAa,KAAa,QAA8C;AACrF,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,KAAK,SAAS,EAAE,OAAA,IAAW,EAAE;AAC1D,QAAI,CAAC,SAAS,GAAI,QAAO;AACzB,WAAQ,MAAM,SAAS,KAAA;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;;;;;"}

package/dist/expressions/playground/api.d.ts

@@ -0,0 +1,53 @@
+import { GomplateSpec } from '../lang/index.ts';
+import { EvalLanguage } from './languages.ts';
+export interface EvalRequest {
+    language: EvalLanguage;
+    source: string;
+    input?: string;
+    leftDelim?: string;
+    rightDelim?: string;
+}
+export interface EvalError {
+    message: string;
+    line?: number;
+    column?: number;
+}
+export interface EvalResponse {
+    result: string;
+    value?: unknown;
+    type?: string;
+    error?: EvalError;
+    durationMs: number;
+}
+/** One sample an author can load, as `GET /api/examples` returns it. */
+export interface Example {
+    name: string;
+    language: EvalLanguage;
+    source: string;
+    input: string;
+}
+/**
+ * Where the host mounted the playground API.
+ *
+ * A host serves it under its own prefix -- mission-control behind an
+ * authenticated route group -- so nothing here may assume `/api`.
+ */
+export declare const DEFAULT_API_BASE = "/api";
+/**
+ * Evaluates against the host's Go server.
+ *
+ * A transport failure is surfaced as an error result rather than thrown: the
+ * usual cause is the server not running yet, and the playground should say so
+ * rather than blank out.
+ */
+export declare function evaluate(apiBase: string, request: EvalRequest, signal?: AbortSignal): Promise<EvalResponse>;
+/**
+ * The catalogue the running server can actually evaluate.
+ *
+ * Wider than the one this package ships whenever the host registers functions
+ * of its own. Undefined on any failure, which leaves the packaged catalogue in
+ * place -- right when the server is simply not up yet.
+ */
+export declare function fetchSpec(apiBase: string, signal?: AbortSignal): Promise<GomplateSpec | undefined>;
+export declare function fetchExamples(apiBase: string, signal?: AbortSignal): Promise<Example[] | undefined>;
+//# sourceMappingURL=api.d.ts.map

package/dist/expressions/playground/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/expressions/playground/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CA0BvB;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAEnC;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAEhC"}

package/dist/expressions/playground/api.js

@@ -0,0 +1,49 @@
+const DEFAULT_API_BASE = "/api";
+async function evaluate(apiBase, request, signal) {
+  let response;
+  try {
+    response = await fetch(`${apiBase}/eval`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(request),
+      ...signal ? { signal } : {}
+    });
+  } catch (cause) {
+    if (signal == null ? void 0 : signal.aborted) throw cause;
+    return {
+      result: "",
+      durationMs: 0,
+      error: { message: `could not reach the evaluation server: ${String(cause)}` }
+    };
+  }
+  if (!response.ok && response.status !== 400) {
+    return {
+      result: "",
+      durationMs: 0,
+      error: { message: `evaluation server returned ${response.status} ${response.statusText}` }
+    };
+  }
+  return await response.json();
+}
+async function fetchSpec(apiBase, signal) {
+  return fetchJSON(`${apiBase}/spec`, signal);
+}
+async function fetchExamples(apiBase, signal) {
+  return fetchJSON(`${apiBase}/examples`, signal);
+}
+async function fetchJSON(url, signal) {
+  try {
+    const response = await fetch(url, signal ? { signal } : {});
+    if (!response.ok) return void 0;
+    return await response.json();
+  } catch {
+    return void 0;
+  }
+}
+export {
+  DEFAULT_API_BASE,
+  evaluate,
+  fetchExamples,
+  fetchSpec
+};
+//# sourceMappingURL=api.js.map

package/dist/expressions/playground/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sources":["../../../src/expressions/playground/api.ts"],"sourcesContent":["import type { GomplateSpec } from \"../lang/index.ts\";\nimport type { EvalLanguage } from \"./languages.ts\";\n\nexport interface EvalRequest {\n  language: EvalLanguage;\n  source: string;\n  input?: string;\n  leftDelim?: string;\n  rightDelim?: string;\n}\n\nexport interface EvalError {\n  message: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface EvalResponse {\n  result: string;\n  value?: unknown;\n  type?: string;\n  error?: EvalError;\n  durationMs: number;\n}\n\n/** One sample an author can load, as `GET /api/examples` returns it. */\nexport interface Example {\n  name: string;\n  language: EvalLanguage;\n  source: string;\n  input: string;\n}\n\n/**\n * Where the host mounted the playground API.\n *\n * A host serves it under its own prefix -- mission-control behind an\n * authenticated route group -- so nothing here may assume `/api`.\n */\nexport const DEFAULT_API_BASE = \"/api\";\n\n/**\n * Evaluates against the host's Go server.\n *\n * A transport failure is surfaced as an error result rather than thrown: the\n * usual cause is the server not running yet, and the playground should say so\n * rather than blank out.\n */\nexport async function evaluate(\n  apiBase: string,\n  request: EvalRequest,\n  signal?: AbortSignal,\n): Promise<EvalResponse> {\n  let response: Response;\n  try {\n    response = await fetch(`${apiBase}/eval`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(request),\n      ...(signal ? { signal } : {}),\n    });\n  } catch (cause) {\n    if (signal?.aborted) throw cause;\n    return {\n      result: \"\",\n      durationMs: 0,\n      error: { message: `could not reach the evaluation server: ${String(cause)}` },\n    };\n  }\n\n  if (!response.ok && response.status !== 400) {\n    return {\n      result: \"\",\n      durationMs: 0,\n      error: { message: `evaluation server returned ${response.status} ${response.statusText}` },\n    };\n  }\n  return (await response.json()) as EvalResponse;\n}\n\n/**\n * The catalogue the running server can actually evaluate.\n *\n * Wider than the one this package ships whenever the host registers functions\n * of its own. Undefined on any failure, which leaves the packaged catalogue in\n * place -- right when the server is simply not up yet.\n */\nexport async function fetchSpec(\n  apiBase: string,\n  signal?: AbortSignal,\n): Promise<GomplateSpec | undefined> {\n  return fetchJSON<GomplateSpec>(`${apiBase}/spec`, signal);\n}\n\nexport async function fetchExamples(\n  apiBase: string,\n  signal?: AbortSignal,\n): Promise<Example[] | undefined> {\n  return fetchJSON<Example[]>(`${apiBase}/examples`, signal);\n}\n\nasync function fetchJSON<T>(url: string, signal?: AbortSignal): Promise<T | undefined> {\n  try {\n    const response = await fetch(url, signal ? { signal } : {});\n    if (!response.ok) return undefined;\n    return (await response.json()) as T;\n  } catch {\n    return undefined;\n  }\n}\n"],"names":[],"mappings":"AAuCO,MAAM,mBAAmB;AAShC,eAAsB,SACpB,SACA,SACA,QACuB;AACvB,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,MAAM,GAAG,OAAO,SAAS;AAAA,MACxC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAA;AAAA,MAC3B,MAAM,KAAK,UAAU,OAAO;AAAA,MAC5B,GAAI,SAAS,EAAE,WAAW,CAAA;AAAA,IAAC,CAC5B;AAAA,EACH,SAAS,OAAO;AACd,QAAI,iCAAQ,QAAS,OAAM;AAC3B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,OAAO,EAAE,SAAS,0CAA0C,OAAO,KAAK,CAAC,GAAA;AAAA,IAAG;AAAA,EAEhF;AAEA,MAAI,CAAC,SAAS,MAAM,SAAS,WAAW,KAAK;AAC3C,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,MACZ,OAAO,EAAE,SAAS,8BAA8B,SAAS,MAAM,IAAI,SAAS,UAAU,GAAA;AAAA,IAAG;AAAA,EAE7F;AACA,SAAQ,MAAM,SAAS,KAAA;AACzB;AASA,eAAsB,UACpB,SACA,QACmC;AACnC,SAAO,UAAwB,GAAG,OAAO,SAAS,MAAM;AAC1D;AAEA,eAAsB,cACpB,SACA,QACgC;AAChC,SAAO,UAAqB,GAAG,OAAO,aAAa,MAAM;AAC3D;AAEA,eAAe,UAAa,KAAa,QAA8C;AACrF,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,KAAK,SAAS,EAAE,OAAA,IAAW,EAAE;AAC1D,QAAI,CAAC,SAAS,GAAI,QAAO;AACzB,WAAQ,MAAM,SAAS,KAAA;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;"}

package/dist/expressions/playground/languages.cjs

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const UiFunction = require("../../icons/components/UiFunction.cjs");
+const UiBraces = require("../../icons/components/UiBraces.cjs");
+const UiCode2 = require("../../icons/components/UiCode2.cjs");
+const UiFileCode = require("../../icons/components/UiFileCode.cjs");
+const UiFileText = require("../../icons/components/UiFileText.cjs");
+const UiFileJson = require("../../icons/components/UiFileJson.cjs");
+const EXPRESSION_ROWS = 5;
+const TEMPLATE_ROWS = 14;
+const LANGUAGES = [
+  {
+    id: "cel",
+    label: "CEL",
+    icon: UiFunction.UiFunction,
+    section: "Expressions",
+    editorLanguage: "cel",
+    evalLanguage: "cel",
+    catalogue: "cel",
+    description: "Common Expression Language, with gomplate's k8s, aws and math helpers",
+    editorRows: EXPRESSION_ROWS
+  },
+  {
+    id: "jsonpath",
+    label: "JSONPath",
+    icon: UiBraces.UiBraces,
+    section: "Expressions",
+    editorLanguage: "jsonpath",
+    evalLanguage: "jsonpath",
+    description: "JSONPath, as evaluated by ojg",
+    editorRows: EXPRESSION_ROWS
+  },
+  {
+    id: "javascript",
+    label: "JavaScript",
+    icon: UiCode2.UiCode2,
+    section: "Expressions",
+    editorLanguage: "javascript",
+    evalLanguage: "javascript",
+    description: "JavaScript, as evaluated by otto",
+    editorRows: EXPRESSION_ROWS
+  },
+  {
+    id: "gomplate",
+    label: "Go template",
+    icon: UiFileCode.UiFileCode,
+    section: "Templates",
+    editorLanguage: "gomplate",
+    evalLanguage: "gotemplate",
+    catalogue: "gotemplate",
+    description: "Go text/template with gomplate's function library",
+    editorRows: TEMPLATE_ROWS
+  },
+  {
+    id: "yaml-gomplate",
+    label: "YAML + template",
+    icon: UiFileText.UiFileText,
+    section: "Templates",
+    editorLanguage: "yaml-gomplate",
+    evalLanguage: "gotemplate",
+    catalogue: "gotemplate",
+    description: "YAML with templates embedded in it, as real configuration is written",
+    editorRows: TEMPLATE_ROWS
+  },
+  {
+    id: "json-gomplate",
+    label: "JSON + template",
+    icon: UiFileJson.UiFileJson,
+    section: "Templates",
+    editorLanguage: "json-gomplate",
+    evalLanguage: "gotemplate",
+    catalogue: "gotemplate",
+    description: "JSON with templates embedded in it",
+    editorRows: TEMPLATE_ROWS
+  }
+];
+const SECTIONS = ["Expressions", "Templates"];
+function languageById(id, offered = LANGUAGES) {
+  const found = offered.find((language) => language.id === id);
+  if (found) return found;
+  const [first] = offered;
+  if (!first) throw new Error("no playground languages were offered");
+  return first;
+}
+exports.LANGUAGES = LANGUAGES;
+exports.SECTIONS = SECTIONS;
+exports.languageById = languageById;
+//# sourceMappingURL=languages.cjs.map

package/dist/expressions/playground/languages.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.cjs","sources":["../../../src/expressions/playground/languages.ts"],"sourcesContent":["import type { LanguageId } from \"../lang/index.ts\";\nimport {\n  UiBraces,\n  UiCode2,\n  UiFileCode,\n  UiFileJson,\n  UiFileText,\n  UiFunction,\n} from \"../../icons\";\nimport type { StaticIconComponent } from \"../../data/Icon\";\n\n/** An evaluator on the Go side. */\nexport type EvalLanguage = \"cel\" | \"gotemplate\" | \"jsonpath\" | \"javascript\";\n\n/** One entry in the playground's language rail. */\nexport interface PlaygroundLanguage {\n  id: string;\n  label: string;\n  icon: StaticIconComponent;\n  /** Rail section this language belongs to. */\n  section: \"Expressions\" | \"Templates\";\n  /** Monaco language for the source editor. */\n  editorLanguage: LanguageId | \"javascript\";\n  /** Which evaluator the Go server should run. */\n  evalLanguage: EvalLanguage;\n  description: string;\n  /**\n   * Which half of the catalogue the Functions tab browses, if either. JSONPath\n   * and JavaScript have no generated catalogue, so they get no tab rather than\n   * an empty one.\n   */\n  catalogue?: \"cel\" | \"gotemplate\";\n  /**\n   * Rows the expression editor opens at, before the reader drags the divider.\n   *\n   * An expression is a line or two, so five rows leaves the input document the\n   * rest of the pane. A template is a whole document, and starting it at five\n   * rows would hide most of what is being written.\n   */\n  editorRows: number;\n}\n\n/** Default rows for a language whose source is an expression. */\nconst EXPRESSION_ROWS = 5;\n\n/** Default rows for a language whose source is a document. */\nconst TEMPLATE_ROWS = 14;\n\nexport const LANGUAGES: PlaygroundLanguage[] = [\n  {\n    id: \"cel\",\n    label: \"CEL\",\n    icon: UiFunction,\n    section: \"Expressions\",\n    editorLanguage: \"cel\",\n    evalLanguage: \"cel\",\n    catalogue: \"cel\",\n    description:\n      \"Common Expression Language, with gomplate's k8s, aws and math helpers\",\n    editorRows: EXPRESSION_ROWS,\n  },\n  {\n    id: \"jsonpath\",\n    label: \"JSONPath\",\n    icon: UiBraces,\n    section: \"Expressions\",\n    editorLanguage: \"jsonpath\",\n    evalLanguage: \"jsonpath\",\n    description: \"JSONPath, as evaluated by ojg\",\n    editorRows: EXPRESSION_ROWS,\n  },\n  {\n    id: \"javascript\",\n    label: \"JavaScript\",\n    icon: UiCode2,\n    section: \"Expressions\",\n    editorLanguage: \"javascript\",\n    evalLanguage: \"javascript\",\n    description: \"JavaScript, as evaluated by otto\",\n    editorRows: EXPRESSION_ROWS,\n  },\n  {\n    id: \"gomplate\",\n    label: \"Go template\",\n    icon: UiFileCode,\n    section: \"Templates\",\n    editorLanguage: \"gomplate\",\n    evalLanguage: \"gotemplate\",\n    catalogue: \"gotemplate\",\n    description: \"Go text/template with gomplate's function library\",\n    editorRows: TEMPLATE_ROWS,\n  },\n  {\n    id: \"yaml-gomplate\",\n    label: \"YAML + template\",\n    icon: UiFileText,\n    section: \"Templates\",\n    editorLanguage: \"yaml-gomplate\",\n    evalLanguage: \"gotemplate\",\n    catalogue: \"gotemplate\",\n    description:\n      \"YAML with templates embedded in it, as real configuration is written\",\n    editorRows: TEMPLATE_ROWS,\n  },\n  {\n    id: \"json-gomplate\",\n    label: \"JSON + template\",\n    icon: UiFileJson,\n    section: \"Templates\",\n    editorLanguage: \"json-gomplate\",\n    evalLanguage: \"gotemplate\",\n    catalogue: \"gotemplate\",\n    description: \"JSON with templates embedded in it\",\n    editorRows: TEMPLATE_ROWS,\n  },\n];\n\n/** Rail section order. */\nexport const SECTIONS = [\"Expressions\", \"Templates\"] as const;\n\n/**\n * Resolves a language id against the offered list.\n *\n * Falls back to the first offered language rather than throwing: the id can\n * come from a URL an author edited or a bookmark from before a host narrowed\n * the list, and losing the page to an exception is the worse outcome.\n */\nexport function languageById(\n  id: string,\n  offered: PlaygroundLanguage[] = LANGUAGES,\n): PlaygroundLanguage {\n  const found = offered.find((language) => language.id === id);\n  if (found) return found;\n\n  const [first] = offered;\n  if (!first) throw new Error(\"no playground languages were offered\");\n  return first;\n}\n"],"names":["UiFunction","UiBraces","UiCode2","UiFileCode","UiFileText","UiFileJson"],"mappings":";;;;;;;;AA2CA,MAAM,kBAAkB;AAGxB,MAAM,gBAAgB;AAEf,MAAM,YAAkC;AAAA,EAC7C;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAMA,WAAAA;AAAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aACE;AAAA,IACF,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAMC,SAAAA;AAAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAMC,QAAAA;AAAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAMC,WAAAA;AAAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAMC,WAAAA;AAAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aACE;AAAA,IACF,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAMC,WAAAA;AAAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAEhB;AAGO,MAAM,WAAW,CAAC,eAAe,WAAW;AAS5C,SAAS,aACd,IACA,UAAgC,WACZ;AACpB,QAAM,QAAQ,QAAQ,KAAK,CAAC,aAAa,SAAS,OAAO,EAAE;AAC3D,MAAI,MAAO,QAAO;AAElB,QAAM,CAAC,KAAK,IAAI;AAChB,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,sCAAsC;AAClE,SAAO;AACT;;;;"}

package/dist/expressions/playground/languages.d.ts

@@ -0,0 +1,43 @@
+import { LanguageId } from '../lang/index.ts';
+import { StaticIconComponent } from '../../data/Icon';
+/** An evaluator on the Go side. */
+export type EvalLanguage = "cel" | "gotemplate" | "jsonpath" | "javascript";
+/** One entry in the playground's language rail. */
+export interface PlaygroundLanguage {
+    id: string;
+    label: string;
+    icon: StaticIconComponent;
+    /** Rail section this language belongs to. */
+    section: "Expressions" | "Templates";
+    /** Monaco language for the source editor. */
+    editorLanguage: LanguageId | "javascript";
+    /** Which evaluator the Go server should run. */
+    evalLanguage: EvalLanguage;
+    description: string;
+    /**
+     * Which half of the catalogue the Functions tab browses, if either. JSONPath
+     * and JavaScript have no generated catalogue, so they get no tab rather than
+     * an empty one.
+     */
+    catalogue?: "cel" | "gotemplate";
+    /**
+     * Rows the expression editor opens at, before the reader drags the divider.
+     *
+     * An expression is a line or two, so five rows leaves the input document the
+     * rest of the pane. A template is a whole document, and starting it at five
+     * rows would hide most of what is being written.
+     */
+    editorRows: number;
+}
+export declare const LANGUAGES: PlaygroundLanguage[];
+/** Rail section order. */
+export declare const SECTIONS: readonly ["Expressions", "Templates"];
+/**
+ * Resolves a language id against the offered list.
+ *
+ * Falls back to the first offered language rather than throwing: the id can
+ * come from a URL an author edited or a bookmark from before a host narrowed
+ * the list, and losing the page to an exception is the worse outcome.
+ */
+export declare function languageById(id: string, offered?: PlaygroundLanguage[]): PlaygroundLanguage;
+//# sourceMappingURL=languages.d.ts.map

package/dist/expressions/playground/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../src/expressions/playground/languages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;AAE5E,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,mBAAmB,CAAC;IAC1B,6CAA6C;IAC7C,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC;IACrC,6CAA6C;IAC7C,cAAc,EAAE,UAAU,GAAG,YAAY,CAAC;IAC1C,gDAAgD;IAChD,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC;IACjC;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD,eAAO,MAAM,SAAS,EAAE,kBAAkB,EAmEzC,CAAC;AAEF,0BAA0B;AAC1B,eAAO,MAAM,QAAQ,uCAAwC,CAAC;AAE9D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,kBAAkB,EAAc,GACxC,kBAAkB,CAOpB"}

package/dist/expressions/playground/languages.js

@@ -0,0 +1,88 @@
+import { UiFunction } from "../../icons/components/UiFunction.js";
+import { UiBraces } from "../../icons/components/UiBraces.js";
+import { UiCode2 } from "../../icons/components/UiCode2.js";
+import { UiFileCode } from "../../icons/components/UiFileCode.js";
+import { UiFileText } from "../../icons/components/UiFileText.js";
+import { UiFileJson } from "../../icons/components/UiFileJson.js";
+const EXPRESSION_ROWS = 5;
+const TEMPLATE_ROWS = 14;
+const LANGUAGES = [
+  {
+    id: "cel",
+    label: "CEL",
+    icon: UiFunction,
+    section: "Expressions",
+    editorLanguage: "cel",
+    evalLanguage: "cel",
+    catalogue: "cel",
+    description: "Common Expression Language, with gomplate's k8s, aws and math helpers",
+    editorRows: EXPRESSION_ROWS
+  },
+  {
+    id: "jsonpath",
+    label: "JSONPath",
+    icon: UiBraces,
+    section: "Expressions",
+    editorLanguage: "jsonpath",
+    evalLanguage: "jsonpath",
+    description: "JSONPath, as evaluated by ojg",
+    editorRows: EXPRESSION_ROWS
+  },
+  {
+    id: "javascript",
+    label: "JavaScript",
+    icon: UiCode2,
+    section: "Expressions",
+    editorLanguage: "javascript",
+    evalLanguage: "javascript",
+    description: "JavaScript, as evaluated by otto",
+    editorRows: EXPRESSION_ROWS
+  },
+  {
+    id: "gomplate",
+    label: "Go template",
+    icon: UiFileCode,
+    section: "Templates",
+    editorLanguage: "gomplate",
+    evalLanguage: "gotemplate",
+    catalogue: "gotemplate",
+    description: "Go text/template with gomplate's function library",
+    editorRows: TEMPLATE_ROWS
+  },
+  {
+    id: "yaml-gomplate",
+    label: "YAML + template",
+    icon: UiFileText,
+    section: "Templates",
+    editorLanguage: "yaml-gomplate",
+    evalLanguage: "gotemplate",
+    catalogue: "gotemplate",
+    description: "YAML with templates embedded in it, as real configuration is written",
+    editorRows: TEMPLATE_ROWS
+  },
+  {
+    id: "json-gomplate",
+    label: "JSON + template",
+    icon: UiFileJson,
+    section: "Templates",
+    editorLanguage: "json-gomplate",
+    evalLanguage: "gotemplate",
+    catalogue: "gotemplate",
+    description: "JSON with templates embedded in it",
+    editorRows: TEMPLATE_ROWS
+  }
+];
+const SECTIONS = ["Expressions", "Templates"];
+function languageById(id, offered = LANGUAGES) {
+  const found = offered.find((language) => language.id === id);
+  if (found) return found;
+  const [first] = offered;
+  if (!first) throw new Error("no playground languages were offered");
+  return first;
+}
+export {
+  LANGUAGES,
+  SECTIONS,
+  languageById
+};
+//# sourceMappingURL=languages.js.map

package/dist/expressions/playground/languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.js","sources":["../../../src/expressions/playground/languages.ts"],"sourcesContent":["import type { LanguageId } from \"../lang/index.ts\";\nimport {\n  UiBraces,\n  UiCode2,\n  UiFileCode,\n  UiFileJson,\n  UiFileText,\n  UiFunction,\n} from \"../../icons\";\nimport type { StaticIconComponent } from \"../../data/Icon\";\n\n/** An evaluator on the Go side. */\nexport type EvalLanguage = \"cel\" | \"gotemplate\" | \"jsonpath\" | \"javascript\";\n\n/** One entry in the playground's language rail. */\nexport interface PlaygroundLanguage {\n  id: string;\n  label: string;\n  icon: StaticIconComponent;\n  /** Rail section this language belongs to. */\n  section: \"Expressions\" | \"Templates\";\n  /** Monaco language for the source editor. */\n  editorLanguage: LanguageId | \"javascript\";\n  /** Which evaluator the Go server should run. */\n  evalLanguage: EvalLanguage;\n  description: string;\n  /**\n   * Which half of the catalogue the Functions tab browses, if either. JSONPath\n   * and JavaScript have no generated catalogue, so they get no tab rather than\n   * an empty one.\n   */\n  catalogue?: \"cel\" | \"gotemplate\";\n  /**\n   * Rows the expression editor opens at, before the reader drags the divider.\n   *\n   * An expression is a line or two, so five rows leaves the input document the\n   * rest of the pane. A template is a whole document, and starting it at five\n   * rows would hide most of what is being written.\n   */\n  editorRows: number;\n}\n\n/** Default rows for a language whose source is an expression. */\nconst EXPRESSION_ROWS = 5;\n\n/** Default rows for a language whose source is a document. */\nconst TEMPLATE_ROWS = 14;\n\nexport const LANGUAGES: PlaygroundLanguage[] = [\n  {\n    id: \"cel\",\n    label: \"CEL\",\n    icon: UiFunction,\n    section: \"Expressions\",\n    editorLanguage: \"cel\",\n    evalLanguage: \"cel\",\n    catalogue: \"cel\",\n    description:\n      \"Common Expression Language, with gomplate's k8s, aws and math helpers\",\n    editorRows: EXPRESSION_ROWS,\n  },\n  {\n    id: \"jsonpath\",\n    label: \"JSONPath\",\n    icon: UiBraces,\n    section: \"Expressions\",\n    editorLanguage: \"jsonpath\",\n    evalLanguage: \"jsonpath\",\n    description: \"JSONPath, as evaluated by ojg\",\n    editorRows: EXPRESSION_ROWS,\n  },\n  {\n    id: \"javascript\",\n    label: \"JavaScript\",\n    icon: UiCode2,\n    section: \"Expressions\",\n    editorLanguage: \"javascript\",\n    evalLanguage: \"javascript\",\n    description: \"JavaScript, as evaluated by otto\",\n    editorRows: EXPRESSION_ROWS,\n  },\n  {\n    id: \"gomplate\",\n    label: \"Go template\",\n    icon: UiFileCode,\n    section: \"Templates\",\n    editorLanguage: \"gomplate\",\n    evalLanguage: \"gotemplate\",\n    catalogue: \"gotemplate\",\n    description: \"Go text/template with gomplate's function library\",\n    editorRows: TEMPLATE_ROWS,\n  },\n  {\n    id: \"yaml-gomplate\",\n    label: \"YAML + template\",\n    icon: UiFileText,\n    section: \"Templates\",\n    editorLanguage: \"yaml-gomplate\",\n    evalLanguage: \"gotemplate\",\n    catalogue: \"gotemplate\",\n    description:\n      \"YAML with templates embedded in it, as real configuration is written\",\n    editorRows: TEMPLATE_ROWS,\n  },\n  {\n    id: \"json-gomplate\",\n    label: \"JSON + template\",\n    icon: UiFileJson,\n    section: \"Templates\",\n    editorLanguage: \"json-gomplate\",\n    evalLanguage: \"gotemplate\",\n    catalogue: \"gotemplate\",\n    description: \"JSON with templates embedded in it\",\n    editorRows: TEMPLATE_ROWS,\n  },\n];\n\n/** Rail section order. */\nexport const SECTIONS = [\"Expressions\", \"Templates\"] as const;\n\n/**\n * Resolves a language id against the offered list.\n *\n * Falls back to the first offered language rather than throwing: the id can\n * come from a URL an author edited or a bookmark from before a host narrowed\n * the list, and losing the page to an exception is the worse outcome.\n */\nexport function languageById(\n  id: string,\n  offered: PlaygroundLanguage[] = LANGUAGES,\n): PlaygroundLanguage {\n  const found = offered.find((language) => language.id === id);\n  if (found) return found;\n\n  const [first] = offered;\n  if (!first) throw new Error(\"no playground languages were offered\");\n  return first;\n}\n"],"names":[],"mappings":";;;;;;AA2CA,MAAM,kBAAkB;AAGxB,MAAM,gBAAgB;AAEf,MAAM,YAAkC;AAAA,EAC7C;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aACE;AAAA,IACF,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aACE;AAAA,IACF,YAAY;AAAA,EAAA;AAAA,EAEd;AAAA,IACE,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,MAAM;AAAA,IACN,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,WAAW;AAAA,IACX,aAAa;AAAA,IACb,YAAY;AAAA,EAAA;AAEhB;AAGO,MAAM,WAAW,CAAC,eAAe,WAAW;AAS5C,SAAS,aACd,IACA,UAAgC,WACZ;AACpB,QAAM,QAAQ,QAAQ,KAAK,CAAC,aAAa,SAAS,OAAO,EAAE;AAC3D,MAAI,MAAO,QAAO;AAElB,QAAM,CAAC,KAAK,IAAI;AAChB,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,sCAAsC;AAClE,SAAO;AACT;"}

package/dist/expressions/playground/panels/GraphPanel.cjs

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const jsonPathTree = require("../../../components/jsonPathTree.cjs");
+const ObjectGraph = require("../../../data/ObjectGraph.cjs");
+const graphNodes = require("./graphNodes.cjs");
+const environment = require("../../lang/environment.cjs");
+function GraphPanel({
+  document,
+  languageId,
+  onInsert
+}) {
+  const [selectedId, setSelectedId] = react.useState();
+  const [note, setNote] = react.useState();
+  const tree = react.useMemo(
+    () => document === void 0 || document === null ? null : jsonPathTree.createLazyJSONPathTree(document, { keyPrefix: "input" }),
+    [document]
+  );
+  const roots = react.useMemo(
+    () => tree ? tree.roots.map(graphNodes.toGraphNode) : [],
+    [tree]
+  );
+  if (!tree) {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex h-full items-center justify-center p-6 text-center text-sm text-muted-foreground", children: "Nothing to show yet — write a YAML or JSON document in the input pane and its shape appears here." });
+  }
+  const select = (node) => {
+    setSelectedId(node.id);
+    const segments = node.path ? jsonPathTree.literalSegments(node.path) : void 0;
+    if (!segments) {
+      setNote("That row has no addressable path.");
+      return;
+    }
+    const expression = environment.pathExpression(languageId, segments);
+    if (expression === null) {
+      setNote(
+        "A go template reaches a list element or a non-identifier key through `index`, which is a call rather than a path — so there is nothing to insert."
+      );
+      return;
+    }
+    if (expression === "") {
+      setNote(
+        "The whole document has no name in this language — pick a key under it."
+      );
+      return;
+    }
+    setNote(void 0);
+    onInsert(expression);
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex h-full min-h-0 flex-col", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "min-h-0 flex-1 overflow-auto p-2", children: /* @__PURE__ */ jsxRuntime.jsx(
+      ObjectGraph.ObjectGraph,
+      {
+        roots,
+        showControls: true,
+        defaultOpenDepth: 2,
+        ...selectedId ? { selectedId } : {},
+        onNodeSelect: select,
+        loadChildren: async (node) => {
+          var _a;
+          const source = (_a = node.metadata) == null ? void 0 : _a.node;
+          if (!source) return [];
+          return (await tree.loadChildren(source)).map(graphNodes.toGraphNode);
+        },
+        empty: "The document is empty."
+      }
+    ) }),
+    /* @__PURE__ */ jsxRuntime.jsx("footer", { className: "shrink-0 border-t border-border px-4 py-2 text-xs text-muted-foreground", children: note ?? "Click a key to insert its path at the cursor." })
+  ] });
+}
+exports.GraphPanel = GraphPanel;
+//# sourceMappingURL=GraphPanel.cjs.map

package/dist/expressions/playground/panels/GraphPanel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphPanel.cjs","sources":["../../../../src/expressions/playground/panels/GraphPanel.tsx"],"sourcesContent":["import { useMemo, useState } from \"react\";\nimport {\n  createLazyJSONPathTree,\n  literalSegments,\n  type JSONPathNode,\n  type LazyJSONPathTree,\n} from \"../../../components/jsonPathTree\";\nimport { ObjectGraph } from \"../../../data/ObjectGraph\";\nimport { pathExpression } from \"../../lang/index.ts\";\nimport { toGraphNode } from \"./graphNodes.ts\";\nimport type { GraphNode } from \"./graphNodes.ts\";\n\ninterface GraphPanelProps {\n  /** The parsed input document, or undefined when there is nothing to show. */\n  document: unknown;\n  /** Monaco language id, which decides the syntax a click inserts. */\n  languageId: string;\n  /** Writes an expression at the source editor's cursor. */\n  onInsert: (expression: string) => void;\n}\n\n/**\n * The shape of the document being evaluated against.\n *\n * The input pane shows the document as text; this shows it as paths. Clicking a\n * row writes that path into the expression, in the syntax of the language being\n * written, which is the step that otherwise means reading YAML and retyping it\n * by hand.\n */\nexport function GraphPanel({\n  document,\n  languageId,\n  onInsert,\n}: GraphPanelProps) {\n  const [selectedId, setSelectedId] = useState<string>();\n  const [note, setNote] = useState<string>();\n\n  const tree = useMemo<LazyJSONPathTree | null>(\n    () =>\n      document === undefined || document === null\n        ? null\n        : createLazyJSONPathTree(document, { keyPrefix: \"input\" }),\n    [document],\n  );\n\n  const roots = useMemo(\n    () => (tree ? tree.roots.map(toGraphNode) : []),\n    [tree],\n  );\n\n  if (!tree) {\n    return (\n      <div className=\"flex h-full items-center justify-center p-6 text-center text-sm text-muted-foreground\">\n        Nothing to show yet — write a YAML or JSON document in the input pane\n        and its shape appears here.\n      </div>\n    );\n  }\n\n  const select = (node: GraphNode) => {\n    setSelectedId(node.id);\n    const segments = node.path ? literalSegments(node.path) : undefined;\n    if (!segments) {\n      setNote(\"That row has no addressable path.\");\n      return;\n    }\n    const expression = pathExpression(languageId, segments);\n    if (expression === null) {\n      setNote(\n        \"A go template reaches a list element or a non-identifier key through `index`, \" +\n          \"which is a call rather than a path — so there is nothing to insert.\",\n      );\n      return;\n    }\n    if (expression === \"\") {\n      setNote(\n        \"The whole document has no name in this language — pick a key under it.\",\n      );\n      return;\n    }\n    setNote(undefined);\n    onInsert(expression);\n  };\n\n  return (\n    <div className=\"flex h-full min-h-0 flex-col\">\n      <div className=\"min-h-0 flex-1 overflow-auto p-2\">\n        <ObjectGraph\n          roots={roots}\n          showControls\n          defaultOpenDepth={2}\n          {...(selectedId ? { selectedId } : {})}\n          onNodeSelect={select}\n          loadChildren={async (node) => {\n            const source = node.metadata?.node as JSONPathNode | undefined;\n            if (!source) return [];\n            return (await tree.loadChildren(source)).map(toGraphNode);\n          }}\n          empty=\"The document is empty.\"\n        />\n      </div>\n      <footer className=\"shrink-0 border-t border-border px-4 py-2 text-xs text-muted-foreground\">\n        {note ?? \"Click a key to insert its path at the cursor.\"}\n      </footer>\n    </div>\n  );\n}\n"],"names":["useState","useMemo","createLazyJSONPathTree","toGraphNode","jsx","literalSegments","pathExpression","jsxs","ObjectGraph"],"mappings":";;;;;;;;AA6BO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AACF,GAAoB;AAClB,QAAM,CAAC,YAAY,aAAa,IAAIA,eAAA;AACpC,QAAM,CAAC,MAAM,OAAO,IAAIA,eAAA;AAExB,QAAM,OAAOC,MAAAA;AAAAA,IACX,MACE,aAAa,UAAa,aAAa,OACnC,OACAC,aAAAA,uBAAuB,UAAU,EAAE,WAAW,SAAS;AAAA,IAC7D,CAAC,QAAQ;AAAA,EAAA;AAGX,QAAM,QAAQD,MAAAA;AAAAA,IACZ,MAAO,OAAO,KAAK,MAAM,IAAIE,WAAAA,WAAW,IAAI,CAAA;AAAA,IAC5C,CAAC,IAAI;AAAA,EAAA;AAGP,MAAI,CAAC,MAAM;AACT,WACEC,2BAAAA,IAAC,OAAA,EAAI,WAAU,yFAAwF,UAAA,qGAGvG;AAAA,EAEJ;AAEA,QAAM,SAAS,CAAC,SAAoB;AAClC,kBAAc,KAAK,EAAE;AACrB,UAAM,WAAW,KAAK,OAAOC,aAAAA,gBAAgB,KAAK,IAAI,IAAI;AAC1D,QAAI,CAAC,UAAU;AACb,cAAQ,mCAAmC;AAC3C;AAAA,IACF;AACA,UAAM,aAAaC,YAAAA,eAAe,YAAY,QAAQ;AACtD,QAAI,eAAe,MAAM;AACvB;AAAA,QACE;AAAA,MAAA;AAGF;AAAA,IACF;AACA,QAAI,eAAe,IAAI;AACrB;AAAA,QACE;AAAA,MAAA;AAEF;AAAA,IACF;AACA,YAAQ,MAAS;AACjB,aAAS,UAAU;AAAA,EACrB;AAEA,SACEC,2BAAAA,KAAC,OAAA,EAAI,WAAU,gCACb,UAAA;AAAA,IAAAH,2BAAAA,IAAC,OAAA,EAAI,WAAU,oCACb,UAAAA,2BAAAA;AAAAA,MAACI,YAAAA;AAAAA,MAAA;AAAA,QACC;AAAA,QACA,cAAY;AAAA,QACZ,kBAAkB;AAAA,QACjB,GAAI,aAAa,EAAE,WAAA,IAAe,CAAA;AAAA,QACnC,cAAc;AAAA,QACd,cAAc,OAAO,SAAS;;AAC5B,gBAAM,UAAS,UAAK,aAAL,mBAAe;AAC9B,cAAI,CAAC,OAAQ,QAAO,CAAA;AACpB,kBAAQ,MAAM,KAAK,aAAa,MAAM,GAAG,IAAIL,sBAAW;AAAA,QAC1D;AAAA,QACA,OAAM;AAAA,MAAA;AAAA,IAAA,GAEV;AAAA,IACAC,2BAAAA,IAAC,UAAA,EAAO,WAAU,2EACf,kBAAQ,gDAAA,CACX;AAAA,EAAA,GACF;AAEJ;;"}