@flanksource/clicky-ui 0.3.35 → 0.3.37

package/dist/expressions/playground/panels/SamplesPanel.js

@@ -0,0 +1,165 @@
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import { useState, useRef, useEffect } from "react";
+import { Button } from "../../../components/button.js";
+import { Badge } from "../../../data/Badge.js";
+import { RUN_SHORTCUT_LABEL } from "../runShortcut.js";
+import { classifySample, tallySamples, resultTypes, nextFailure } from "../sampleOutcome.js";
+import { ExpectationStrip } from "./ExpectationStrip.js";
+import { StaleButton, ResultError, ResultValue } from "./ResultPanel.js";
+import { UiArrowRight } from "../../../icons/components/UiArrowRight.js";
+import { UiWarningTriangle } from "../../../icons/components/UiWarningTriangle.js";
+const DOT = {
+  valid: "bg-green-500",
+  empty: "bg-muted-foreground/40",
+  invalid: "bg-amber-500",
+  failed: "bg-destructive"
+};
+function SamplesPanel({ samples, runs, expectation, onUseInput }) {
+  const [focused, setFocused] = useState(0);
+  const classified = samples.map((sample) => {
+    var _a;
+    const response = (_a = runs.results.find((entry) => entry.sample.id === sample.id)) == null ? void 0 : _a.response;
+    return { sample, response, ...response ? classifySample(response, expectation == null ? void 0 : expectation.validate) : {} };
+  });
+  const outcomes = classified.map((entry) => entry.outcome);
+  const ran = classified.flatMap((entry) => entry.outcome ? [entry.outcome] : []);
+  const tally = tallySamples(ran);
+  const types = resultTypes(runs.results.map((entry) => entry.response));
+  const jump = nextFailure(outcomes, focused);
+  const current = classified[Math.min(focused, classified.length - 1)];
+  const outdated = runs.stale && runs.results.length > 0;
+  const outcomesRef = useRef(outcomes);
+  outcomesRef.current = outcomes;
+  useEffect(() => {
+    if (runs.pending || runs.results.length === 0) return;
+    const first = nextFailure(outcomesRef.current, -1);
+    if (first !== void 0) setFocused(first);
+  }, [runs.pending, runs.results.length]);
+  return /* @__PURE__ */ jsxs("div", { className: "flex h-full flex-col", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-1.5 border-b border-border px-4 py-2 text-xs", children: [
+      runs.progress ? /* @__PURE__ */ jsxs(Badge, { tone: "info", variant: "soft", size: "sm", children: [
+        "Running ",
+        runs.progress.done,
+        "/",
+        runs.progress.total
+      ] }) : null,
+      ran.length > 0 ? /* @__PURE__ */ jsx(Tally, { tally }) : null,
+      types.length > 1 ? /* @__PURE__ */ jsxs(Badge, { tone: "warning", variant: "soft", size: "sm", children: [
+        "returns ",
+        types.join(" | ")
+      ] }) : null,
+      jump !== void 0 ? /* @__PURE__ */ jsxs(Button, { size: "sm", variant: "outline", className: "h-6 gap-1 px-2 text-xs", onClick: () => setFocused(jump), children: [
+        /* @__PURE__ */ jsx(UiArrowRight, { className: "size-3", "aria-hidden": "true" }),
+        "Next failure"
+      ] }) : null,
+      outdated && !runs.pending ? /* @__PURE__ */ jsx(StaleButton, { onRun: () => void runs.run() }) : null
+    ] }),
+    /* @__PURE__ */ jsx(
+      "ul",
+      {
+        "aria-label": "Samples",
+        className: `max-h-[40%] shrink-0 overflow-auto border-b border-border py-1 ${outdated ? "opacity-60" : ""}`,
+        children: classified.map((entry, index) => {
+          var _a;
+          return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              "aria-current": index === focused,
+              onClick: () => setFocused(index),
+              className: `flex w-full items-center gap-2 px-4 py-1 text-left text-xs hover:bg-muted ${index === focused ? "bg-primary/[0.06]" : ""}`,
+              children: [
+                /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    "aria-hidden": "true",
+                    className: `size-2 shrink-0 rounded-full ${entry.outcome ? DOT[entry.outcome] : "border border-border"}`
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { className: "w-20 shrink-0 truncate font-medium", children: entry.sample.label }),
+                /* @__PURE__ */ jsx("code", { className: "min-w-0 flex-1 truncate font-mono text-muted-foreground", children: entry.response ? preview(entry.response) : runs.pending ? "…" : "not run" }),
+                ((_a = entry.issues) == null ? void 0 : _a[0]) ? /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    className: `min-w-0 max-w-[45%] truncate ${entry.outcome === "failed" ? "text-destructive" : "text-amber-700 dark:text-amber-400"}`,
+                    title: entry.issues.join("\n"),
+                    children: entry.issues[0]
+                  }
+                ) : null
+              ]
+            }
+          ) }, entry.sample.id);
+        })
+      }
+    ),
+    runs.results.length === 0 && !runs.pending ? /* @__PURE__ */ jsxs("div", { className: "p-4", children: [
+      /* @__PURE__ */ jsxs("p", { className: "text-sm text-muted-foreground", children: [
+        "Run the expression against all ",
+        samples.length,
+        " samples to see which ones it holds for."
+      ] }),
+      /* @__PURE__ */ jsxs(Button, { onClick: () => void runs.run(), size: "sm", className: "mt-3", children: [
+        "Run all samples (",
+        RUN_SHORTCUT_LABEL,
+        ")"
+      ] })
+    ] }) : current ? /* @__PURE__ */ jsx(
+      FocusedSample,
+      {
+        label: current.sample.label,
+        response: current.response,
+        expectation,
+        stale: outdated,
+        onUseInput: () => onUseInput(current.sample.input)
+      }
+    ) : null
+  ] });
+}
+function Tally({ tally }) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs(Badge, { tone: "success", variant: "soft", size: "sm", children: [
+      tally.valid,
+      " valid"
+    ] }),
+    tally.empty > 0 ? /* @__PURE__ */ jsxs(Badge, { tone: "neutral", variant: "soft", size: "sm", children: [
+      tally.empty,
+      " empty"
+    ] }) : null,
+    tally.invalid > 0 ? /* @__PURE__ */ jsxs(Badge, { tone: "warning", variant: "soft", size: "sm", icon: UiWarningTriangle, children: [
+      tally.invalid,
+      " invalid"
+    ] }) : null,
+    tally.failed > 0 ? /* @__PURE__ */ jsxs(Badge, { tone: "danger", variant: "soft", size: "sm", icon: UiWarningTriangle, children: [
+      tally.failed,
+      " failed"
+    ] }) : null
+  ] });
+}
+function FocusedSample({
+  label,
+  response,
+  expectation,
+  stale,
+  onUseInput
+}) {
+  return /* @__PURE__ */ jsxs("section", { "aria-label": `${label} result`, className: "flex min-h-0 flex-1 flex-col", children: [
+    /* @__PURE__ */ jsxs("header", { className: "flex items-center gap-2 px-4 py-2 text-xs", children: [
+      /* @__PURE__ */ jsx("span", { className: "font-medium", children: label }),
+      response && !response.error ? /* @__PURE__ */ jsxs(Badge, { variant: "outline", size: "sm", children: [
+        response.durationMs.toFixed(2),
+        " ms"
+      ] }) : null,
+      /* @__PURE__ */ jsx(Button, { size: "sm", variant: "ghost", className: "ml-auto h-6 px-2 text-xs", onClick: onUseInput, children: "Use as input" })
+    ] }),
+    expectation ? /* @__PURE__ */ jsx(ExpectationStrip, { expectation, response: response ?? null, stale }) : null,
+    /* @__PURE__ */ jsx("div", { className: `min-h-0 flex-1 overflow-auto p-4 ${stale ? "opacity-50" : ""}`, children: !response ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Evaluating…" }) : response.error ? /* @__PURE__ */ jsx(ResultError, { error: response.error }) : /* @__PURE__ */ jsx(ResultValue, { response }) })
+  ] });
+}
+function preview(response) {
+  if (response.error) return "error";
+  return response.result === "" ? '""' : response.result.replace(/\s+/g, " ");
+}
+export {
+  SamplesPanel
+};
+//# sourceMappingURL=SamplesPanel.js.map

package/dist/expressions/playground/panels/SamplesPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SamplesPanel.js","sources":["../../../../src/expressions/playground/panels/SamplesPanel.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { Button } from \"../../../components/button\";\nimport { Badge } from \"../../../data/Badge\";\nimport { UiArrowRight, UiWarningTriangle } from \"../../../icons\";\nimport type { EvalResponse, PlaygroundSample, ResultExpectation } from \"../api.ts\";\nimport { RUN_SHORTCUT_LABEL } from \"../runShortcut\";\nimport { classifySample, nextFailure, resultTypes, tallySamples, type SampleOutcome } from \"../sampleOutcome.ts\";\nimport type { SampleRuns } from \"../useSampleRuns.ts\";\nimport { ExpectationStrip } from \"./ExpectationStrip.tsx\";\nimport { ResultError, ResultValue, StaleButton } from \"./ResultPanel.tsx\";\n\ninterface SamplesPanelProps {\n  samples: PlaygroundSample[];\n  runs: SampleRuns;\n  expectation?: ResultExpectation | undefined;\n  /** Loads a sample into the Input editor. */\n  onUseInput: (input: string) => void;\n}\n\nconst DOT: Record<SampleOutcome, string> = {\n  valid: \"bg-green-500\",\n  empty: \"bg-muted-foreground/40\",\n  invalid: \"bg-amber-500\",\n  failed: \"bg-destructive\",\n};\n\n/**\n * The current expression against every sample.\n *\n * The author writes against the input in front of them; the samples that break\n * the expression are, by definition, the ones they have not looked at. So every\n * sample is listed with its outcome, and \"Next failure\" walks the broken ones.\n */\nexport function SamplesPanel({ samples, runs, expectation, onUseInput }: SamplesPanelProps) {\n  const [focused, setFocused] = useState(0);\n  const classified = samples.map((sample) => {\n    const response = runs.results.find((entry) => entry.sample.id === sample.id)?.response;\n    return { sample, response, ...(response ? classifySample(response, expectation?.validate) : {}) };\n  });\n  const outcomes = classified.map((entry) => entry.outcome);\n  const ran = classified.flatMap((entry) => (entry.outcome ? [entry.outcome] : []));\n  const tally = tallySamples(ran);\n  const types = resultTypes(runs.results.map((entry) => entry.response));\n  const jump = nextFailure(outcomes, focused);\n  const current = classified[Math.min(focused, classified.length - 1)];\n  // Nothing has run yet is not the same as out of date: only dim results.\n  const outdated = runs.stale && runs.results.length > 0;\n\n  // Land on the first broken sample once a run completes, not on whatever row\n  // happened to be focused before it.\n  const outcomesRef = useRef(outcomes);\n  outcomesRef.current = outcomes;\n  useEffect(() => {\n    if (runs.pending || runs.results.length === 0) return;\n    const first = nextFailure(outcomesRef.current, -1);\n    if (first !== undefined) setFocused(first);\n  }, [runs.pending, runs.results.length]);\n\n  return (\n    <div className=\"flex h-full flex-col\">\n      <div className=\"flex flex-wrap items-center gap-1.5 border-b border-border px-4 py-2 text-xs\">\n        {runs.progress ? (\n          <Badge tone=\"info\" variant=\"soft\" size=\"sm\">\n            Running {runs.progress.done}/{runs.progress.total}\n          </Badge>\n        ) : null}\n        {ran.length > 0 ? <Tally tally={tally} /> : null}\n        {types.length > 1 ? (\n          <Badge tone=\"warning\" variant=\"soft\" size=\"sm\">\n            returns {types.join(\" | \")}\n          </Badge>\n        ) : null}\n        {jump !== undefined ? (\n          <Button size=\"sm\" variant=\"outline\" className=\"h-6 gap-1 px-2 text-xs\" onClick={() => setFocused(jump)}>\n            <UiArrowRight className=\"size-3\" aria-hidden=\"true\" />\n            Next failure\n          </Button>\n        ) : null}\n        {outdated && !runs.pending ? <StaleButton onRun={() => void runs.run()} /> : null}\n      </div>\n\n      <ul\n        aria-label=\"Samples\"\n        className={`max-h-[40%] shrink-0 overflow-auto border-b border-border py-1 ${outdated ? \"opacity-60\" : \"\"}`}\n      >\n        {classified.map((entry, index) => (\n          <li key={entry.sample.id}>\n            <button\n              type=\"button\"\n              aria-current={index === focused}\n              onClick={() => setFocused(index)}\n              className={`flex w-full items-center gap-2 px-4 py-1 text-left text-xs hover:bg-muted ${\n                index === focused ? \"bg-primary/[0.06]\" : \"\"\n              }`}\n            >\n              <span\n                aria-hidden=\"true\"\n                className={`size-2 shrink-0 rounded-full ${entry.outcome ? DOT[entry.outcome] : \"border border-border\"}`}\n              />\n              <span className=\"w-20 shrink-0 truncate font-medium\">{entry.sample.label}</span>\n              <code className=\"min-w-0 flex-1 truncate font-mono text-muted-foreground\">\n                {entry.response ? preview(entry.response) : runs.pending ? \"…\" : \"not run\"}\n              </code>\n              {entry.issues?.[0] ? (\n                <span\n                  className={`min-w-0 max-w-[45%] truncate ${entry.outcome === \"failed\" ? \"text-destructive\" : \"text-amber-700 dark:text-amber-400\"}`}\n                  title={entry.issues.join(\"\\n\")}\n                >\n                  {entry.issues[0]}\n                </span>\n              ) : null}\n            </button>\n          </li>\n        ))}\n      </ul>\n\n      {runs.results.length === 0 && !runs.pending ? (\n        <div className=\"p-4\">\n          <p className=\"text-sm text-muted-foreground\">\n            Run the expression against all {samples.length} samples to see which ones it holds for.\n          </p>\n          <Button onClick={() => void runs.run()} size=\"sm\" className=\"mt-3\">\n            Run all samples ({RUN_SHORTCUT_LABEL})\n          </Button>\n        </div>\n      ) : current ? (\n        <FocusedSample\n          label={current.sample.label}\n          response={current.response}\n          expectation={expectation}\n          stale={outdated}\n          onUseInput={() => onUseInput(current.sample.input)}\n        />\n      ) : null}\n    </div>\n  );\n}\n\nfunction Tally({ tally }: { tally: Record<SampleOutcome, number> }) {\n  return (\n    <>\n      <Badge tone=\"success\" variant=\"soft\" size=\"sm\">\n        {tally.valid} valid\n      </Badge>\n      {tally.empty > 0 ? (\n        <Badge tone=\"neutral\" variant=\"soft\" size=\"sm\">\n          {tally.empty} empty\n        </Badge>\n      ) : null}\n      {tally.invalid > 0 ? (\n        <Badge tone=\"warning\" variant=\"soft\" size=\"sm\" icon={UiWarningTriangle}>\n          {tally.invalid} invalid\n        </Badge>\n      ) : null}\n      {tally.failed > 0 ? (\n        <Badge tone=\"danger\" variant=\"soft\" size=\"sm\" icon={UiWarningTriangle}>\n          {tally.failed} failed\n        </Badge>\n      ) : null}\n    </>\n  );\n}\n\nfunction FocusedSample({\n  label,\n  response,\n  expectation,\n  stale,\n  onUseInput,\n}: {\n  label: string;\n  response: EvalResponse | undefined;\n  expectation: ResultExpectation | undefined;\n  stale: boolean;\n  onUseInput: () => void;\n}) {\n  return (\n    <section aria-label={`${label} result`} className=\"flex min-h-0 flex-1 flex-col\">\n      <header className=\"flex items-center gap-2 px-4 py-2 text-xs\">\n        <span className=\"font-medium\">{label}</span>\n        {response && !response.error ? (\n          <Badge variant=\"outline\" size=\"sm\">\n            {response.durationMs.toFixed(2)} ms\n          </Badge>\n        ) : null}\n        <Button size=\"sm\" variant=\"ghost\" className=\"ml-auto h-6 px-2 text-xs\" onClick={onUseInput}>\n          Use as input\n        </Button>\n      </header>\n      {expectation ? <ExpectationStrip expectation={expectation} response={response ?? null} stale={stale} /> : null}\n      <div className={`min-h-0 flex-1 overflow-auto p-4 ${stale ? \"opacity-50\" : \"\"}`}>\n        {!response ? (\n          <p className=\"text-sm text-muted-foreground\">Evaluating…</p>\n        ) : response.error ? (\n          <ResultError error={response.error} />\n        ) : (\n          <ResultValue response={response} />\n        )}\n      </div>\n    </section>\n  );\n}\n\nfunction preview(response: EvalResponse): string {\n  if (response.error) return \"error\";\n  return response.result === \"\" ? '\"\"' : response.result.replace(/\\s+/g, \" \");\n}\n"],"names":[],"mappings":"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"}

package/dist/expressions/playground/sampleOutcome.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function classifySample(response, validate) {
+  if (response.error) return { outcome: "failed", issues: [response.error.message] };
+  const issues = (validate == null ? void 0 : validate(response)) ?? [];
+  if (issues.length > 0) return { outcome: "invalid", issues };
+  if (response.result.trim() === "") return { outcome: "empty", issues: [] };
+  return { outcome: "valid", issues: [] };
+}
+function tallySamples(outcomes) {
+  const tally = { valid: 0, invalid: 0, empty: 0, failed: 0 };
+  for (const outcome of outcomes) tally[outcome] += 1;
+  return tally;
+}
+function nextFailure(outcomes, from) {
+  const failing = outcomes.flatMap(
+    (outcome, index) => outcome === "failed" || outcome === "invalid" ? [index] : []
+  );
+  const next = failing.find((index) => index > from) ?? failing[0];
+  return next === from ? void 0 : next;
+}
+function resultTypes(responses) {
+  return [...new Set(responses.flatMap((response) => !response.error && response.type ? [response.type] : []))].sort();
+}
+exports.classifySample = classifySample;
+exports.nextFailure = nextFailure;
+exports.resultTypes = resultTypes;
+exports.tallySamples = tallySamples;
+//# sourceMappingURL=sampleOutcome.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sampleOutcome.cjs","sources":["../../../src/expressions/playground/sampleOutcome.ts"],"sourcesContent":["import type { EvalResponse } from \"./api.ts\";\n\n/**\n * How one sample fared. `invalid` outranks `empty`: a blank result is only\n * harmless when the expectation accepts it, and a validator that requires a\n * value says so.\n */\nexport type SampleOutcome = \"valid\" | \"invalid\" | \"empty\" | \"failed\";\n\nexport function classifySample(\n  response: EvalResponse,\n  validate?: (response: EvalResponse) => string[],\n): { outcome: SampleOutcome; issues: string[] } {\n  if (response.error) return { outcome: \"failed\", issues: [response.error.message] };\n  const issues = validate?.(response) ?? [];\n  if (issues.length > 0) return { outcome: \"invalid\", issues };\n  if (response.result.trim() === \"\") return { outcome: \"empty\", issues: [] };\n  return { outcome: \"valid\", issues: [] };\n}\n\nexport function tallySamples(outcomes: SampleOutcome[]): Record<SampleOutcome, number> {\n  const tally: Record<SampleOutcome, number> = { valid: 0, invalid: 0, empty: 0, failed: 0 };\n  for (const outcome of outcomes) tally[outcome] += 1;\n  return tally;\n}\n\n/**\n * The next failed or invalid sample after `from`, wrapping. Undefined when the\n * focused sample is the only one left to look at.\n */\nexport function nextFailure(outcomes: Array<SampleOutcome | undefined>, from: number): number | undefined {\n  const failing = outcomes.flatMap((outcome, index) =>\n    outcome === \"failed\" || outcome === \"invalid\" ? [index] : [],\n  );\n  const next = failing.find((index) => index > from) ?? failing[0];\n  return next === from ? undefined : next;\n}\n\n/** Distinct result types, so an expression that sometimes returns a string shows. */\nexport function resultTypes(responses: EvalResponse[]): string[] {\n  return [...new Set(responses.flatMap((response) => (!response.error && response.type ? [response.type] : [])))].sort();\n}\n"],"names":[],"mappings":";;AASO,SAAS,eACd,UACA,UAC8C;AAC9C,MAAI,SAAS,MAAO,QAAO,EAAE,SAAS,UAAU,QAAQ,CAAC,SAAS,MAAM,OAAO,EAAA;AAC/E,QAAM,UAAS,qCAAW,cAAa,CAAA;AACvC,MAAI,OAAO,SAAS,UAAU,EAAE,SAAS,WAAW,OAAA;AACpD,MAAI,SAAS,OAAO,WAAW,GAAI,QAAO,EAAE,SAAS,SAAS,QAAQ,GAAC;AACvE,SAAO,EAAE,SAAS,SAAS,QAAQ,CAAA,EAAC;AACtC;AAEO,SAAS,aAAa,UAA0D;AACrF,QAAM,QAAuC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,EAAA;AACvF,aAAW,WAAW,SAAU,OAAM,OAAO,KAAK;AAClD,SAAO;AACT;AAMO,SAAS,YAAY,UAA4C,MAAkC;AACxG,QAAM,UAAU,SAAS;AAAA,IAAQ,CAAC,SAAS,UACzC,YAAY,YAAY,YAAY,YAAY,CAAC,KAAK,IAAI,CAAA;AAAA,EAAC;AAE7D,QAAM,OAAO,QAAQ,KAAK,CAAC,UAAU,QAAQ,IAAI,KAAK,QAAQ,CAAC;AAC/D,SAAO,SAAS,OAAO,SAAY;AACrC;AAGO,SAAS,YAAY,WAAqC;AAC/D,SAAO,CAAC,GAAG,IAAI,IAAI,UAAU,QAAQ,CAAC,aAAc,CAAC,SAAS,SAAS,SAAS,OAAO,CAAC,SAAS,IAAI,IAAI,EAAG,CAAC,CAAC,EAAE,KAAA;AAClH;;;;;"}

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

@@ -0,0 +1,20 @@
+import { EvalResponse } from './api.ts';
+/**
+ * How one sample fared. `invalid` outranks `empty`: a blank result is only
+ * harmless when the expectation accepts it, and a validator that requires a
+ * value says so.
+ */
+export type SampleOutcome = "valid" | "invalid" | "empty" | "failed";
+export declare function classifySample(response: EvalResponse, validate?: (response: EvalResponse) => string[]): {
+    outcome: SampleOutcome;
+    issues: string[];
+};
+export declare function tallySamples(outcomes: SampleOutcome[]): Record<SampleOutcome, number>;
+/**
+ * The next failed or invalid sample after `from`, wrapping. Undefined when the
+ * focused sample is the only one left to look at.
+ */
+export declare function nextFailure(outcomes: Array<SampleOutcome | undefined>, from: number): number | undefined;
+/** Distinct result types, so an expression that sometimes returns a string shows. */
+export declare function resultTypes(responses: EvalResponse[]): string[];
+//# sourceMappingURL=sampleOutcome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sampleOutcome.d.ts","sourceRoot":"","sources":["../../../src/expressions/playground/sampleOutcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,MAAM,EAAE,GAC9C;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAM9C;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAIrF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxG;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAE/D"}

package/dist/expressions/playground/sampleOutcome.js

@@ -0,0 +1,29 @@
+function classifySample(response, validate) {
+  if (response.error) return { outcome: "failed", issues: [response.error.message] };
+  const issues = (validate == null ? void 0 : validate(response)) ?? [];
+  if (issues.length > 0) return { outcome: "invalid", issues };
+  if (response.result.trim() === "") return { outcome: "empty", issues: [] };
+  return { outcome: "valid", issues: [] };
+}
+function tallySamples(outcomes) {
+  const tally = { valid: 0, invalid: 0, empty: 0, failed: 0 };
+  for (const outcome of outcomes) tally[outcome] += 1;
+  return tally;
+}
+function nextFailure(outcomes, from) {
+  const failing = outcomes.flatMap(
+    (outcome, index) => outcome === "failed" || outcome === "invalid" ? [index] : []
+  );
+  const next = failing.find((index) => index > from) ?? failing[0];
+  return next === from ? void 0 : next;
+}
+function resultTypes(responses) {
+  return [...new Set(responses.flatMap((response) => !response.error && response.type ? [response.type] : []))].sort();
+}
+export {
+  classifySample,
+  nextFailure,
+  resultTypes,
+  tallySamples
+};
+//# sourceMappingURL=sampleOutcome.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sampleOutcome.js","sources":["../../../src/expressions/playground/sampleOutcome.ts"],"sourcesContent":["import type { EvalResponse } from \"./api.ts\";\n\n/**\n * How one sample fared. `invalid` outranks `empty`: a blank result is only\n * harmless when the expectation accepts it, and a validator that requires a\n * value says so.\n */\nexport type SampleOutcome = \"valid\" | \"invalid\" | \"empty\" | \"failed\";\n\nexport function classifySample(\n  response: EvalResponse,\n  validate?: (response: EvalResponse) => string[],\n): { outcome: SampleOutcome; issues: string[] } {\n  if (response.error) return { outcome: \"failed\", issues: [response.error.message] };\n  const issues = validate?.(response) ?? [];\n  if (issues.length > 0) return { outcome: \"invalid\", issues };\n  if (response.result.trim() === \"\") return { outcome: \"empty\", issues: [] };\n  return { outcome: \"valid\", issues: [] };\n}\n\nexport function tallySamples(outcomes: SampleOutcome[]): Record<SampleOutcome, number> {\n  const tally: Record<SampleOutcome, number> = { valid: 0, invalid: 0, empty: 0, failed: 0 };\n  for (const outcome of outcomes) tally[outcome] += 1;\n  return tally;\n}\n\n/**\n * The next failed or invalid sample after `from`, wrapping. Undefined when the\n * focused sample is the only one left to look at.\n */\nexport function nextFailure(outcomes: Array<SampleOutcome | undefined>, from: number): number | undefined {\n  const failing = outcomes.flatMap((outcome, index) =>\n    outcome === \"failed\" || outcome === \"invalid\" ? [index] : [],\n  );\n  const next = failing.find((index) => index > from) ?? failing[0];\n  return next === from ? undefined : next;\n}\n\n/** Distinct result types, so an expression that sometimes returns a string shows. */\nexport function resultTypes(responses: EvalResponse[]): string[] {\n  return [...new Set(responses.flatMap((response) => (!response.error && response.type ? [response.type] : [])))].sort();\n}\n"],"names":[],"mappings":"AASO,SAAS,eACd,UACA,UAC8C;AAC9C,MAAI,SAAS,MAAO,QAAO,EAAE,SAAS,UAAU,QAAQ,CAAC,SAAS,MAAM,OAAO,EAAA;AAC/E,QAAM,UAAS,qCAAW,cAAa,CAAA;AACvC,MAAI,OAAO,SAAS,UAAU,EAAE,SAAS,WAAW,OAAA;AACpD,MAAI,SAAS,OAAO,WAAW,GAAI,QAAO,EAAE,SAAS,SAAS,QAAQ,GAAC;AACvE,SAAO,EAAE,SAAS,SAAS,QAAQ,CAAA,EAAC;AACtC;AAEO,SAAS,aAAa,UAA0D;AACrF,QAAM,QAAuC,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,EAAA;AACvF,aAAW,WAAW,SAAU,OAAM,OAAO,KAAK;AAClD,SAAO;AACT;AAMO,SAAS,YAAY,UAA4C,MAAkC;AACxG,QAAM,UAAU,SAAS;AAAA,IAAQ,CAAC,SAAS,UACzC,YAAY,YAAY,YAAY,YAAY,CAAC,KAAK,IAAI,CAAA;AAAA,EAAC;AAE7D,QAAM,OAAO,QAAQ,KAAK,CAAC,UAAU,QAAQ,IAAI,KAAK,QAAQ,CAAC;AAC/D,SAAO,SAAS,OAAO,SAAY;AACrC;AAGO,SAAS,YAAY,WAAqC;AAC/D,SAAO,CAAC,GAAG,IAAI,IAAI,UAAU,QAAQ,CAAC,aAAc,CAAC,SAAS,SAAS,SAAS,OAAO,CAAC,SAAS,IAAI,IAAI,EAAG,CAAC,CAAC,EAAE,KAAA;AAClH;"}

package/dist/expressions/playground/useEvaluator.cjs

@@ -4,40 +4,60 @@ const react = require("react");
 const api = require("./api.cjs");
 const AUTO_RUN_STORAGE_KEY = "expressions:auto-run";
 const DEBOUNCE_MS = 250;
-function useEvaluator(apiBase, payload) {
+function useEvaluator(apiBase, payload, options = {}) {
+  const explicit = options.mode === "explicit";
   const [response, setResponse] = react.useState(null);
   const [pending, setPending] = react.useState(false);
   const [autoRun, setAutoRunState] = react.useState(readAutoRun);
   const [evaluated, setEvaluated] = react.useState(null);
   const abortRef = react.useRef(void 0);
+  const runningRef = react.useRef(false);
+  const optionsRef = react.useRef(options);
+  optionsRef.current = options;
   const payloadRef = react.useRef(payload);
   payloadRef.current = payload;
-  const evaluateNow = react.useCallback(() => {
+  const evaluateNow = react.useCallback(async () => {
     var _a, _b;
     const current = payloadRef.current;
+    if (explicit && runningRef.current) return;
     if (!current.source.trim()) {
-      (_a = abortRef.current) == null ? void 0 : _a.abort();
+      if (!explicit) (_a = abortRef.current) == null ? void 0 : _a.abort();
       setResponse(null);
       setEvaluated(current);
       setPending(false);
       return;
     }
-    (_b = abortRef.current) == null ? void 0 : _b.abort();
+    if (!explicit) (_b = abortRef.current) == null ? void 0 : _b.abort();
     const controller = new AbortController();
     abortRef.current = controller;
-    setPending(true);
-    api.evaluate(apiBase, current, controller.signal).then((next) => {
-      setResponse(next);
-      setEvaluated(current);
-      setPending(false);
-    }).catch(() => {
-    });
-  }, [apiBase]);
+    if (explicit) runningRef.current = true;
+    try {
+      if (optionsRef.current.beforeRun && !await optionsRef.current.beforeRun([current])) return;
+      setPending(true);
+      const next = await (optionsRef.current.evaluate ?? ((request, signal) => api.evaluate(apiBase, request, signal)))(current, controller.signal);
+      if (!controller.signal.aborted) {
+        setResponse(next);
+        setEvaluated(current);
+      }
+    } catch (cause) {
+      if (!controller.signal.aborted) {
+        setResponse({ result: "", durationMs: 0, error: { message: String(cause) } });
+        setEvaluated(current);
+      }
+    } finally {
+      if (abortRef.current === controller) {
+        runningRef.current = false;
+        setPending(false);
+      }
+    }
+  }, [apiBase, explicit]);
   react.useEffect(() => {
-    if (!autoRun) return;
-    const timer = setTimeout(evaluateNow, DEBOUNCE_MS);
+    if (explicit || !autoRun) return;
+    const timer = setTimeout(() => {
+      void evaluateNow();
+    }, DEBOUNCE_MS);
     return () => clearTimeout(timer);
-  }, [payload.language, payload.source, payload.input, autoRun, evaluateNow]);
+  }, [payload.language, payload.source, payload.input, autoRun, explicit, evaluateNow]);
   react.useEffect(() => {
     setResponse(null);
     setEvaluated(null);
@@ -46,15 +66,16 @@ function useEvaluator(apiBase, payload) {
     (next) => {
       setAutoRunState(next);
       window.localStorage.setItem(AUTO_RUN_STORAGE_KEY, String(next));
-      if (next) evaluateNow();
+      if (next && !explicit) void evaluateNow();
     },
-    [evaluateNow]
+    [evaluateNow, explicit]
   );
   return {
     response,
     pending,
     stale: isStale(evaluated, payload),
-    autoRun,
+    autoRun: explicit ? false : autoRun,
+    explicit,
     setAutoRun,
     run: evaluateNow
   };

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

@@ -1 +1 @@
-{"version":3,"file":"useEvaluator.cjs","sources":["../../../src/expressions/playground/useEvaluator.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { evaluate, type EvalRequest, type EvalResponse } from \"./api.ts\";\n\nconst AUTO_RUN_STORAGE_KEY = \"expressions:auto-run\";\n\n/** How long typing settles before an automatic run fires. */\nconst DEBOUNCE_MS = 250;\n\nexport interface Evaluator {\n  response: EvalResponse | null;\n  /** A request is in flight or a debounce is pending. */\n  pending: boolean;\n  /** The source or input has changed since the shown result was produced. */\n  stale: boolean;\n  autoRun: boolean;\n  setAutoRun: (next: boolean) => void;\n  /** Evaluates now, skipping the debounce. */\n  run: () => void;\n}\n\ntype Payload = Pick<EvalRequest, \"language\" | \"source\" | \"input\">;\n\n/**\n * Runs an expression against the Go evaluator.\n *\n * Automatic evaluation is convenient for a one-line expression and a nuisance\n * for anything longer: a debounce fires mid-keystroke and reports errors for\n * half-written input. So it is a toggle, and an explicit run is always\n * available -- which is also the only way to re-run an expression whose value\n * changes on its own (`time.Now()`, `uuid.V4()`, `random.*`).\n */\nexport function useEvaluator(apiBase: string, payload: Payload): Evaluator {\n  const [response, setResponse] = useState<EvalResponse | null>(null);\n  const [pending, setPending] = useState(false);\n  const [autoRun, setAutoRunState] = useState(readAutoRun);\n  const [evaluated, setEvaluated] = useState<Payload | null>(null);\n\n  const abortRef = useRef<AbortController | undefined>(undefined);\n  // The current payload, so `run` stays referentially stable: it is wired into\n  // a Monaco action registered once at mount, which would otherwise capture the\n  // payload from the first render forever.\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n\n  const evaluateNow = useCallback(() => {\n    const current = payloadRef.current;\n    if (!current.source.trim()) {\n      abortRef.current?.abort();\n      setResponse(null);\n      setEvaluated(current);\n      setPending(false);\n      return;\n    }\n\n    abortRef.current?.abort();\n    const controller = new AbortController();\n    abortRef.current = controller;\n\n    setPending(true);\n    evaluate(apiBase, current, controller.signal)\n      .then((next) => {\n        setResponse(next);\n        setEvaluated(current);\n        setPending(false);\n      })\n      .catch(() => {\n        // Superseded by a newer run; that one owns the state.\n      });\n  }, [apiBase]);\n\n  useEffect(() => {\n    if (!autoRun) return;\n    const timer = setTimeout(evaluateNow, DEBOUNCE_MS);\n    return () => clearTimeout(timer);\n  }, [payload.language, payload.source, payload.input, autoRun, evaluateNow]);\n\n  // Switching language changes what the source even means, so show nothing\n  // rather than the previous language's result.\n  useEffect(() => {\n    setResponse(null);\n    setEvaluated(null);\n  }, [payload.language]);\n\n  const setAutoRun = useCallback(\n    (next: boolean) => {\n      setAutoRunState(next);\n      window.localStorage.setItem(AUTO_RUN_STORAGE_KEY, String(next));\n      if (next) evaluateNow();\n    },\n    [evaluateNow],\n  );\n\n  return {\n    response,\n    pending,\n    stale: isStale(evaluated, payload),\n    autoRun,\n    setAutoRun,\n    run: evaluateNow,\n  };\n}\n\nfunction isStale(evaluated: Payload | null, current: Payload): boolean {\n  if (!current.source.trim()) return false;\n  if (!evaluated) return true;\n  return (\n    evaluated.source !== current.source ||\n    evaluated.input !== current.input ||\n    evaluated.language !== current.language\n  );\n}\n\nfunction readAutoRun(): boolean {\n  if (typeof window === \"undefined\") return true;\n  // Default on: the playground should evaluate as soon as it opens.\n  return window.localStorage.getItem(AUTO_RUN_STORAGE_KEY) !== \"false\";\n}\n"],"names":["useState","useRef","useCallback","evaluate","useEffect"],"mappings":";;;;AAGA,MAAM,uBAAuB;AAG7B,MAAM,cAAc;AAyBb,SAAS,aAAa,SAAiB,SAA6B;AACzE,QAAM,CAAC,UAAU,WAAW,IAAIA,MAAAA,SAA8B,IAAI;AAClE,QAAM,CAAC,SAAS,UAAU,IAAIA,MAAAA,SAAS,KAAK;AAC5C,QAAM,CAAC,SAAS,eAAe,IAAIA,MAAAA,SAAS,WAAW;AACvD,QAAM,CAAC,WAAW,YAAY,IAAIA,MAAAA,SAAyB,IAAI;AAE/D,QAAM,WAAWC,MAAAA,OAAoC,MAAS;AAI9D,QAAM,aAAaA,MAAAA,OAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,cAAcC,MAAAA,YAAY,MAAM;;AACpC,UAAM,UAAU,WAAW;AAC3B,QAAI,CAAC,QAAQ,OAAO,QAAQ;AAC1B,qBAAS,YAAT,mBAAkB;AAClB,kBAAY,IAAI;AAChB,mBAAa,OAAO;AACpB,iBAAW,KAAK;AAChB;AAAA,IACF;AAEA,mBAAS,YAAT,mBAAkB;AAClB,UAAM,aAAa,IAAI,gBAAA;AACvB,aAAS,UAAU;AAEnB,eAAW,IAAI;AACfC,QAAAA,SAAS,SAAS,SAAS,WAAW,MAAM,EACzC,KAAK,CAAC,SAAS;AACd,kBAAY,IAAI;AAChB,mBAAa,OAAO;AACpB,iBAAW,KAAK;AAAA,IAClB,CAAC,EACA,MAAM,MAAM;AAAA,IAEb,CAAC;AAAA,EACL,GAAG,CAAC,OAAO,CAAC;AAEZC,QAAAA,UAAU,MAAM;AACd,QAAI,CAAC,QAAS;AACd,UAAM,QAAQ,WAAW,aAAa,WAAW;AACjD,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC,GAAG,CAAC,QAAQ,UAAU,QAAQ,QAAQ,QAAQ,OAAO,SAAS,WAAW,CAAC;AAI1EA,QAAAA,UAAU,MAAM;AACd,gBAAY,IAAI;AAChB,iBAAa,IAAI;AAAA,EACnB,GAAG,CAAC,QAAQ,QAAQ,CAAC;AAErB,QAAM,aAAaF,MAAAA;AAAAA,IACjB,CAAC,SAAkB;AACjB,sBAAgB,IAAI;AACpB,aAAO,aAAa,QAAQ,sBAAsB,OAAO,IAAI,CAAC;AAC9D,UAAI,KAAM,aAAA;AAAA,IACZ;AAAA,IACA,CAAC,WAAW;AAAA,EAAA;AAGd,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,QAAQ,WAAW,OAAO;AAAA,IACjC;AAAA,IACA;AAAA,IACA,KAAK;AAAA,EAAA;AAET;AAEA,SAAS,QAAQ,WAA2B,SAA2B;AACrE,MAAI,CAAC,QAAQ,OAAO,KAAA,EAAQ,QAAO;AACnC,MAAI,CAAC,UAAW,QAAO;AACvB,SACE,UAAU,WAAW,QAAQ,UAC7B,UAAU,UAAU,QAAQ,SAC5B,UAAU,aAAa,QAAQ;AAEnC;AAEA,SAAS,cAAuB;AAC9B,MAAI,OAAO,WAAW,YAAa,QAAO;AAE1C,SAAO,OAAO,aAAa,QAAQ,oBAAoB,MAAM;AAC/D;;"}
+{"version":3,"file":"useEvaluator.cjs","sources":["../../../src/expressions/playground/useEvaluator.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { evaluate, type EvalRequest, type EvalResponse } from \"./api.ts\";\n\nconst AUTO_RUN_STORAGE_KEY = \"expressions:auto-run\";\n\n/** How long typing settles before an automatic run fires. */\nconst DEBOUNCE_MS = 250;\n\nexport interface Evaluator {\n  response: EvalResponse | null;\n  /** A request is in flight or a debounce is pending. */\n  pending: boolean;\n  /** The source or input has changed since the shown result was produced. */\n  stale: boolean;\n  autoRun: boolean;\n  explicit: boolean;\n  setAutoRun: (next: boolean) => void;\n  /** Evaluates now, skipping the debounce. */\n  run: () => Promise<void>;\n}\n\ntype Payload = Pick<EvalRequest, \"language\" | \"source\" | \"input\">;\n\nexport interface EvaluatorOptions {\n  mode?: \"automatic\" | \"explicit\";\n  evaluate?: (request: EvalRequest, signal: AbortSignal) => Promise<EvalResponse>;\n  /** Every evaluation a run is about to make; one call covers a whole batch. */\n  beforeRun?: (requests: EvalRequest[]) => boolean | Promise<boolean>;\n}\n\n/**\n * Runs an expression against the Go evaluator.\n *\n * Automatic evaluation is convenient for a one-line expression and a nuisance\n * for anything longer: a debounce fires mid-keystroke and reports errors for\n * half-written input. So it is a toggle, and an explicit run is always\n * available -- which is also the only way to re-run an expression whose value\n * changes on its own (`time.Now()`, `uuid.V4()`, `random.*`).\n */\nexport function useEvaluator(apiBase: string, payload: Payload, options: EvaluatorOptions = {}): Evaluator {\n  const explicit = options.mode === \"explicit\";\n  const [response, setResponse] = useState<EvalResponse | null>(null);\n  const [pending, setPending] = useState(false);\n  const [autoRun, setAutoRunState] = useState(readAutoRun);\n  const [evaluated, setEvaluated] = useState<Payload | null>(null);\n\n  const abortRef = useRef<AbortController | undefined>(undefined);\n  const runningRef = useRef(false);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  // The current payload, so `run` stays referentially stable: it is wired into\n  // a Monaco action registered once at mount, which would otherwise capture the\n  // payload from the first render forever.\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n\n  const evaluateNow = useCallback(async () => {\n    const current = payloadRef.current;\n    if (explicit && runningRef.current) return;\n    if (!current.source.trim()) {\n      if (!explicit) abortRef.current?.abort();\n      setResponse(null);\n      setEvaluated(current);\n      setPending(false);\n      return;\n    }\n\n    if (!explicit) abortRef.current?.abort();\n    const controller = new AbortController();\n    abortRef.current = controller;\n    if (explicit) runningRef.current = true;\n    try {\n      // Pending starts once the run is confirmed: while a confirmation is on\n      // screen nothing is evaluating, and the result panel must not say so.\n      if (optionsRef.current.beforeRun && !(await optionsRef.current.beforeRun([current]))) return;\n      setPending(true);\n      const next = await (optionsRef.current.evaluate ?? ((request, signal) => evaluate(apiBase, request, signal)))(current, controller.signal);\n      if (!controller.signal.aborted) {\n        setResponse(next);\n        setEvaluated(current);\n      }\n    } catch (cause) {\n      if (!controller.signal.aborted) {\n        setResponse({ result: \"\", durationMs: 0, error: { message: String(cause) } });\n        setEvaluated(current);\n      }\n    } finally {\n      if (abortRef.current === controller) {\n        runningRef.current = false;\n        setPending(false);\n      }\n    }\n  }, [apiBase, explicit]);\n\n  useEffect(() => {\n    if (explicit || !autoRun) return;\n    const timer = setTimeout(() => { void evaluateNow(); }, DEBOUNCE_MS);\n    return () => clearTimeout(timer);\n  }, [payload.language, payload.source, payload.input, autoRun, explicit, evaluateNow]);\n\n  // Switching language changes what the source even means, so show nothing\n  // rather than the previous language's result.\n  useEffect(() => {\n    setResponse(null);\n    setEvaluated(null);\n  }, [payload.language]);\n\n  const setAutoRun = useCallback(\n    (next: boolean) => {\n      setAutoRunState(next);\n      window.localStorage.setItem(AUTO_RUN_STORAGE_KEY, String(next));\n      if (next && !explicit) void evaluateNow();\n    },\n    [evaluateNow, explicit],\n  );\n\n  return {\n    response,\n    pending,\n    stale: isStale(evaluated, payload),\n    autoRun: explicit ? false : autoRun,\n    explicit,\n    setAutoRun,\n    run: evaluateNow,\n  };\n}\n\nfunction isStale(evaluated: Payload | null, current: Payload): boolean {\n  if (!current.source.trim()) return false;\n  if (!evaluated) return true;\n  return (\n    evaluated.source !== current.source ||\n    evaluated.input !== current.input ||\n    evaluated.language !== current.language\n  );\n}\n\nfunction readAutoRun(): boolean {\n  if (typeof window === \"undefined\") return true;\n  // Default on: the playground should evaluate as soon as it opens.\n  return window.localStorage.getItem(AUTO_RUN_STORAGE_KEY) !== \"false\";\n}\n"],"names":["useState","useRef","useCallback","evaluate","useEffect"],"mappings":";;;;AAGA,MAAM,uBAAuB;AAG7B,MAAM,cAAc;AAiCb,SAAS,aAAa,SAAiB,SAAkB,UAA4B,CAAA,GAAe;AACzG,QAAM,WAAW,QAAQ,SAAS;AAClC,QAAM,CAAC,UAAU,WAAW,IAAIA,MAAAA,SAA8B,IAAI;AAClE,QAAM,CAAC,SAAS,UAAU,IAAIA,MAAAA,SAAS,KAAK;AAC5C,QAAM,CAAC,SAAS,eAAe,IAAIA,MAAAA,SAAS,WAAW;AACvD,QAAM,CAAC,WAAW,YAAY,IAAIA,MAAAA,SAAyB,IAAI;AAE/D,QAAM,WAAWC,MAAAA,OAAoC,MAAS;AAC9D,QAAM,aAAaA,MAAAA,OAAO,KAAK;AAC/B,QAAM,aAAaA,MAAAA,OAAO,OAAO;AACjC,aAAW,UAAU;AAIrB,QAAM,aAAaA,MAAAA,OAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,cAAcC,MAAAA,YAAY,YAAY;;AAC1C,UAAM,UAAU,WAAW;AAC3B,QAAI,YAAY,WAAW,QAAS;AACpC,QAAI,CAAC,QAAQ,OAAO,QAAQ;AAC1B,UAAI,CAAC,SAAU,gBAAS,YAAT,mBAAkB;AACjC,kBAAY,IAAI;AAChB,mBAAa,OAAO;AACpB,iBAAW,KAAK;AAChB;AAAA,IACF;AAEA,QAAI,CAAC,SAAU,gBAAS,YAAT,mBAAkB;AACjC,UAAM,aAAa,IAAI,gBAAA;AACvB,aAAS,UAAU;AACnB,QAAI,qBAAqB,UAAU;AACnC,QAAI;AAGF,UAAI,WAAW,QAAQ,aAAa,CAAE,MAAM,WAAW,QAAQ,UAAU,CAAC,OAAO,CAAC,EAAI;AACtF,iBAAW,IAAI;AACf,YAAM,OAAO,OAAO,WAAW,QAAQ,aAAa,CAAC,SAAS,WAAWC,IAAAA,SAAS,SAAS,SAAS,MAAM,IAAI,SAAS,WAAW,MAAM;AACxI,UAAI,CAAC,WAAW,OAAO,SAAS;AAC9B,oBAAY,IAAI;AAChB,qBAAa,OAAO;AAAA,MACtB;AAAA,IACF,SAAS,OAAO;AACd,UAAI,CAAC,WAAW,OAAO,SAAS;AAC9B,oBAAY,EAAE,QAAQ,IAAI,YAAY,GAAG,OAAO,EAAE,SAAS,OAAO,KAAK,EAAA,EAAE,CAAG;AAC5E,qBAAa,OAAO;AAAA,MACtB;AAAA,IACF,UAAA;AACE,UAAI,SAAS,YAAY,YAAY;AACnC,mBAAW,UAAU;AACrB,mBAAW,KAAK;AAAA,MAClB;AAAA,IACF;AAAA,EACF,GAAG,CAAC,SAAS,QAAQ,CAAC;AAEtBC,QAAAA,UAAU,MAAM;AACd,QAAI,YAAY,CAAC,QAAS;AAC1B,UAAM,QAAQ,WAAW,MAAM;AAAE,WAAK,YAAA;AAAA,IAAe,GAAG,WAAW;AACnE,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC,GAAG,CAAC,QAAQ,UAAU,QAAQ,QAAQ,QAAQ,OAAO,SAAS,UAAU,WAAW,CAAC;AAIpFA,QAAAA,UAAU,MAAM;AACd,gBAAY,IAAI;AAChB,iBAAa,IAAI;AAAA,EACnB,GAAG,CAAC,QAAQ,QAAQ,CAAC;AAErB,QAAM,aAAaF,MAAAA;AAAAA,IACjB,CAAC,SAAkB;AACjB,sBAAgB,IAAI;AACpB,aAAO,aAAa,QAAQ,sBAAsB,OAAO,IAAI,CAAC;AAC9D,UAAI,QAAQ,CAAC,SAAU,MAAK,YAAA;AAAA,IAC9B;AAAA,IACA,CAAC,aAAa,QAAQ;AAAA,EAAA;AAGxB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,QAAQ,WAAW,OAAO;AAAA,IACjC,SAAS,WAAW,QAAQ;AAAA,IAC5B;AAAA,IACA;AAAA,IACA,KAAK;AAAA,EAAA;AAET;AAEA,SAAS,QAAQ,WAA2B,SAA2B;AACrE,MAAI,CAAC,QAAQ,OAAO,KAAA,EAAQ,QAAO;AACnC,MAAI,CAAC,UAAW,QAAO;AACvB,SACE,UAAU,WAAW,QAAQ,UAC7B,UAAU,UAAU,QAAQ,SAC5B,UAAU,aAAa,QAAQ;AAEnC;AAEA,SAAS,cAAuB;AAC9B,MAAI,OAAO,WAAW,YAAa,QAAO;AAE1C,SAAO,OAAO,aAAa,QAAQ,oBAAoB,MAAM;AAC/D;;"}

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

@@ -6,11 +6,18 @@ export interface Evaluator {
     /** The source or input has changed since the shown result was produced. */
     stale: boolean;
     autoRun: boolean;
+    explicit: boolean;
     setAutoRun: (next: boolean) => void;
     /** Evaluates now, skipping the debounce. */
-    run: () => void;
+    run: () => Promise<void>;
 }
 type Payload = Pick<EvalRequest, "language" | "source" | "input">;
+export interface EvaluatorOptions {
+    mode?: "automatic" | "explicit";
+    evaluate?: (request: EvalRequest, signal: AbortSignal) => Promise<EvalResponse>;
+    /** Every evaluation a run is about to make; one call covers a whole batch. */
+    beforeRun?: (requests: EvalRequest[]) => boolean | Promise<boolean>;
+}
 /**
  * Runs an expression against the Go evaluator.
  *
@@ -20,6 +27,6 @@ type Payload = Pick<EvalRequest, "language" | "source" | "input">;
  * available -- which is also the only way to re-run an expression whose value
  * changes on its own (`time.Now()`, `uuid.V4()`, `random.*`).
  */
-export declare function useEvaluator(apiBase: string, payload: Payload): Evaluator;
+export declare function useEvaluator(apiBase: string, payload: Payload, options?: EvaluatorOptions): Evaluator;
 export {};
 //# sourceMappingURL=useEvaluator.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useEvaluator.d.ts","sourceRoot":"","sources":["../../../src/expressions/playground/useEvaluator.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAOzE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,4CAA4C;IAC5C,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAED,KAAK,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC;AAElE;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,CAqEzE"}
+{"version":3,"file":"useEvaluator.d.ts","sourceRoot":"","sources":["../../../src/expressions/playground/useEvaluator.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAOzE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,4CAA4C;IAC5C,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,KAAK,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAsFzG"}

package/dist/expressions/playground/useEvaluator.js

@@ -2,40 +2,60 @@ import { useState, useRef, useCallback, useEffect } from "react";
 import { evaluate } from "./api.js";
 const AUTO_RUN_STORAGE_KEY = "expressions:auto-run";
 const DEBOUNCE_MS = 250;
-function useEvaluator(apiBase, payload) {
+function useEvaluator(apiBase, payload, options = {}) {
+  const explicit = options.mode === "explicit";
   const [response, setResponse] = useState(null);
   const [pending, setPending] = useState(false);
   const [autoRun, setAutoRunState] = useState(readAutoRun);
   const [evaluated, setEvaluated] = useState(null);
   const abortRef = useRef(void 0);
+  const runningRef = useRef(false);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
   const payloadRef = useRef(payload);
   payloadRef.current = payload;
-  const evaluateNow = useCallback(() => {
+  const evaluateNow = useCallback(async () => {
     var _a, _b;
     const current = payloadRef.current;
+    if (explicit && runningRef.current) return;
     if (!current.source.trim()) {
-      (_a = abortRef.current) == null ? void 0 : _a.abort();
+      if (!explicit) (_a = abortRef.current) == null ? void 0 : _a.abort();
       setResponse(null);
       setEvaluated(current);
       setPending(false);
       return;
     }
-    (_b = abortRef.current) == null ? void 0 : _b.abort();
+    if (!explicit) (_b = abortRef.current) == null ? void 0 : _b.abort();
     const controller = new AbortController();
     abortRef.current = controller;
-    setPending(true);
-    evaluate(apiBase, current, controller.signal).then((next) => {
-      setResponse(next);
-      setEvaluated(current);
-      setPending(false);
-    }).catch(() => {
-    });
-  }, [apiBase]);
+    if (explicit) runningRef.current = true;
+    try {
+      if (optionsRef.current.beforeRun && !await optionsRef.current.beforeRun([current])) return;
+      setPending(true);
+      const next = await (optionsRef.current.evaluate ?? ((request, signal) => evaluate(apiBase, request, signal)))(current, controller.signal);
+      if (!controller.signal.aborted) {
+        setResponse(next);
+        setEvaluated(current);
+      }
+    } catch (cause) {
+      if (!controller.signal.aborted) {
+        setResponse({ result: "", durationMs: 0, error: { message: String(cause) } });
+        setEvaluated(current);
+      }
+    } finally {
+      if (abortRef.current === controller) {
+        runningRef.current = false;
+        setPending(false);
+      }
+    }
+  }, [apiBase, explicit]);
   useEffect(() => {
-    if (!autoRun) return;
-    const timer = setTimeout(evaluateNow, DEBOUNCE_MS);
+    if (explicit || !autoRun) return;
+    const timer = setTimeout(() => {
+      void evaluateNow();
+    }, DEBOUNCE_MS);
     return () => clearTimeout(timer);
-  }, [payload.language, payload.source, payload.input, autoRun, evaluateNow]);
+  }, [payload.language, payload.source, payload.input, autoRun, explicit, evaluateNow]);
   useEffect(() => {
     setResponse(null);
     setEvaluated(null);
@@ -44,15 +64,16 @@ function useEvaluator(apiBase, payload) {
     (next) => {
       setAutoRunState(next);
       window.localStorage.setItem(AUTO_RUN_STORAGE_KEY, String(next));
-      if (next) evaluateNow();
+      if (next && !explicit) void evaluateNow();
     },
-    [evaluateNow]
+    [evaluateNow, explicit]
   );
   return {
     response,
     pending,
     stale: isStale(evaluated, payload),
-    autoRun,
+    autoRun: explicit ? false : autoRun,
+    explicit,
     setAutoRun,
     run: evaluateNow
   };

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

@@ -1 +1 @@
-{"version":3,"file":"useEvaluator.js","sources":["../../../src/expressions/playground/useEvaluator.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { evaluate, type EvalRequest, type EvalResponse } from \"./api.ts\";\n\nconst AUTO_RUN_STORAGE_KEY = \"expressions:auto-run\";\n\n/** How long typing settles before an automatic run fires. */\nconst DEBOUNCE_MS = 250;\n\nexport interface Evaluator {\n  response: EvalResponse | null;\n  /** A request is in flight or a debounce is pending. */\n  pending: boolean;\n  /** The source or input has changed since the shown result was produced. */\n  stale: boolean;\n  autoRun: boolean;\n  setAutoRun: (next: boolean) => void;\n  /** Evaluates now, skipping the debounce. */\n  run: () => void;\n}\n\ntype Payload = Pick<EvalRequest, \"language\" | \"source\" | \"input\">;\n\n/**\n * Runs an expression against the Go evaluator.\n *\n * Automatic evaluation is convenient for a one-line expression and a nuisance\n * for anything longer: a debounce fires mid-keystroke and reports errors for\n * half-written input. So it is a toggle, and an explicit run is always\n * available -- which is also the only way to re-run an expression whose value\n * changes on its own (`time.Now()`, `uuid.V4()`, `random.*`).\n */\nexport function useEvaluator(apiBase: string, payload: Payload): Evaluator {\n  const [response, setResponse] = useState<EvalResponse | null>(null);\n  const [pending, setPending] = useState(false);\n  const [autoRun, setAutoRunState] = useState(readAutoRun);\n  const [evaluated, setEvaluated] = useState<Payload | null>(null);\n\n  const abortRef = useRef<AbortController | undefined>(undefined);\n  // The current payload, so `run` stays referentially stable: it is wired into\n  // a Monaco action registered once at mount, which would otherwise capture the\n  // payload from the first render forever.\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n\n  const evaluateNow = useCallback(() => {\n    const current = payloadRef.current;\n    if (!current.source.trim()) {\n      abortRef.current?.abort();\n      setResponse(null);\n      setEvaluated(current);\n      setPending(false);\n      return;\n    }\n\n    abortRef.current?.abort();\n    const controller = new AbortController();\n    abortRef.current = controller;\n\n    setPending(true);\n    evaluate(apiBase, current, controller.signal)\n      .then((next) => {\n        setResponse(next);\n        setEvaluated(current);\n        setPending(false);\n      })\n      .catch(() => {\n        // Superseded by a newer run; that one owns the state.\n      });\n  }, [apiBase]);\n\n  useEffect(() => {\n    if (!autoRun) return;\n    const timer = setTimeout(evaluateNow, DEBOUNCE_MS);\n    return () => clearTimeout(timer);\n  }, [payload.language, payload.source, payload.input, autoRun, evaluateNow]);\n\n  // Switching language changes what the source even means, so show nothing\n  // rather than the previous language's result.\n  useEffect(() => {\n    setResponse(null);\n    setEvaluated(null);\n  }, [payload.language]);\n\n  const setAutoRun = useCallback(\n    (next: boolean) => {\n      setAutoRunState(next);\n      window.localStorage.setItem(AUTO_RUN_STORAGE_KEY, String(next));\n      if (next) evaluateNow();\n    },\n    [evaluateNow],\n  );\n\n  return {\n    response,\n    pending,\n    stale: isStale(evaluated, payload),\n    autoRun,\n    setAutoRun,\n    run: evaluateNow,\n  };\n}\n\nfunction isStale(evaluated: Payload | null, current: Payload): boolean {\n  if (!current.source.trim()) return false;\n  if (!evaluated) return true;\n  return (\n    evaluated.source !== current.source ||\n    evaluated.input !== current.input ||\n    evaluated.language !== current.language\n  );\n}\n\nfunction readAutoRun(): boolean {\n  if (typeof window === \"undefined\") return true;\n  // Default on: the playground should evaluate as soon as it opens.\n  return window.localStorage.getItem(AUTO_RUN_STORAGE_KEY) !== \"false\";\n}\n"],"names":[],"mappings":";;AAGA,MAAM,uBAAuB;AAG7B,MAAM,cAAc;AAyBb,SAAS,aAAa,SAAiB,SAA6B;AACzE,QAAM,CAAC,UAAU,WAAW,IAAI,SAA8B,IAAI;AAClE,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAC5C,QAAM,CAAC,SAAS,eAAe,IAAI,SAAS,WAAW;AACvD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAyB,IAAI;AAE/D,QAAM,WAAW,OAAoC,MAAS;AAI9D,QAAM,aAAa,OAAO,OAAO;AACjC,aAAW,UAAU;AAErB,QAAM,cAAc,YAAY,MAAM;;AACpC,UAAM,UAAU,WAAW;AAC3B,QAAI,CAAC,QAAQ,OAAO,QAAQ;AAC1B,qBAAS,YAAT,mBAAkB;AAClB,kBAAY,IAAI;AAChB,mBAAa,OAAO;AACpB,iBAAW,KAAK;AAChB;AAAA,IACF;AAEA,mBAAS,YAAT,mBAAkB;AAClB,UAAM,aAAa,IAAI,gBAAA;AACvB,aAAS,UAAU;AAEnB,eAAW,IAAI;AACf,aAAS,SAAS,SAAS,WAAW,MAAM,EACzC,KAAK,CAAC,SAAS;AACd,kBAAY,IAAI;AAChB,mBAAa,OAAO;AACpB,iBAAW,KAAK;AAAA,IAClB,CAAC,EACA,MAAM,MAAM;AAAA,IAEb,CAAC;AAAA,EACL,GAAG,CAAC,OAAO,CAAC;AAEZ,YAAU,MAAM;AACd,QAAI,CAAC,QAAS;AACd,UAAM,QAAQ,WAAW,aAAa,WAAW;AACjD,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC,GAAG,CAAC,QAAQ,UAAU,QAAQ,QAAQ,QAAQ,OAAO,SAAS,WAAW,CAAC;AAI1E,YAAU,MAAM;AACd,gBAAY,IAAI;AAChB,iBAAa,IAAI;AAAA,EACnB,GAAG,CAAC,QAAQ,QAAQ,CAAC;AAErB,QAAM,aAAa;AAAA,IACjB,CAAC,SAAkB;AACjB,sBAAgB,IAAI;AACpB,aAAO,aAAa,QAAQ,sBAAsB,OAAO,IAAI,CAAC;AAC9D,UAAI,KAAM,aAAA;AAAA,IACZ;AAAA,IACA,CAAC,WAAW;AAAA,EAAA;AAGd,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO,QAAQ,WAAW,OAAO;AAAA,IACjC;AAAA,IACA;AAAA,IACA,KAAK;AAAA,EAAA;AAET;AAEA,SAAS,QAAQ,WAA2B,SAA2B;AACrE,MAAI,CAAC,QAAQ,OAAO,KAAA,EAAQ,QAAO;AACnC,MAAI,CAAC,UAAW,QAAO;AACvB,SACE,UAAU,WAAW,QAAQ,UAC7B,UAAU,UAAU,QAAQ,SAC5B,UAAU,aAAa,QAAQ;AAEnC;AAEA,SAAS,cAAuB;AAC9B,MAAI,OAAO,WAAW,YAAa,QAAO;AAE1C,SAAO,OAAO,aAAa,QAAQ,oBAAoB,MAAM;AAC/D;"}
+{"version":3,"file":"useEvaluator.js","sources":["../../../src/expressions/playground/useEvaluator.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { evaluate, type EvalRequest, type EvalResponse } from \"./api.ts\";\n\nconst AUTO_RUN_STORAGE_KEY = \"expressions:auto-run\";\n\n/** How long typing settles before an automatic run fires. */\nconst DEBOUNCE_MS = 250;\n\nexport interface Evaluator {\n  response: EvalResponse | null;\n  /** A request is in flight or a debounce is pending. */\n  pending: boolean;\n  /** The source or input has changed since the shown result was produced. */\n  stale: boolean;\n  autoRun: boolean;\n  explicit: boolean;\n  setAutoRun: (next: boolean) => void;\n  /** Evaluates now, skipping the debounce. */\n  run: () => Promise<void>;\n}\n\ntype Payload = Pick<EvalRequest, \"language\" | \"source\" | \"input\">;\n\nexport interface EvaluatorOptions {\n  mode?: \"automatic\" | \"explicit\";\n  evaluate?: (request: EvalRequest, signal: AbortSignal) => Promise<EvalResponse>;\n  /** Every evaluation a run is about to make; one call covers a whole batch. */\n  beforeRun?: (requests: EvalRequest[]) => boolean | Promise<boolean>;\n}\n\n/**\n * Runs an expression against the Go evaluator.\n *\n * Automatic evaluation is convenient for a one-line expression and a nuisance\n * for anything longer: a debounce fires mid-keystroke and reports errors for\n * half-written input. So it is a toggle, and an explicit run is always\n * available -- which is also the only way to re-run an expression whose value\n * changes on its own (`time.Now()`, `uuid.V4()`, `random.*`).\n */\nexport function useEvaluator(apiBase: string, payload: Payload, options: EvaluatorOptions = {}): Evaluator {\n  const explicit = options.mode === \"explicit\";\n  const [response, setResponse] = useState<EvalResponse | null>(null);\n  const [pending, setPending] = useState(false);\n  const [autoRun, setAutoRunState] = useState(readAutoRun);\n  const [evaluated, setEvaluated] = useState<Payload | null>(null);\n\n  const abortRef = useRef<AbortController | undefined>(undefined);\n  const runningRef = useRef(false);\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  // The current payload, so `run` stays referentially stable: it is wired into\n  // a Monaco action registered once at mount, which would otherwise capture the\n  // payload from the first render forever.\n  const payloadRef = useRef(payload);\n  payloadRef.current = payload;\n\n  const evaluateNow = useCallback(async () => {\n    const current = payloadRef.current;\n    if (explicit && runningRef.current) return;\n    if (!current.source.trim()) {\n      if (!explicit) abortRef.current?.abort();\n      setResponse(null);\n      setEvaluated(current);\n      setPending(false);\n      return;\n    }\n\n    if (!explicit) abortRef.current?.abort();\n    const controller = new AbortController();\n    abortRef.current = controller;\n    if (explicit) runningRef.current = true;\n    try {\n      // Pending starts once the run is confirmed: while a confirmation is on\n      // screen nothing is evaluating, and the result panel must not say so.\n      if (optionsRef.current.beforeRun && !(await optionsRef.current.beforeRun([current]))) return;\n      setPending(true);\n      const next = await (optionsRef.current.evaluate ?? ((request, signal) => evaluate(apiBase, request, signal)))(current, controller.signal);\n      if (!controller.signal.aborted) {\n        setResponse(next);\n        setEvaluated(current);\n      }\n    } catch (cause) {\n      if (!controller.signal.aborted) {\n        setResponse({ result: \"\", durationMs: 0, error: { message: String(cause) } });\n        setEvaluated(current);\n      }\n    } finally {\n      if (abortRef.current === controller) {\n        runningRef.current = false;\n        setPending(false);\n      }\n    }\n  }, [apiBase, explicit]);\n\n  useEffect(() => {\n    if (explicit || !autoRun) return;\n    const timer = setTimeout(() => { void evaluateNow(); }, DEBOUNCE_MS);\n    return () => clearTimeout(timer);\n  }, [payload.language, payload.source, payload.input, autoRun, explicit, evaluateNow]);\n\n  // Switching language changes what the source even means, so show nothing\n  // rather than the previous language's result.\n  useEffect(() => {\n    setResponse(null);\n    setEvaluated(null);\n  }, [payload.language]);\n\n  const setAutoRun = useCallback(\n    (next: boolean) => {\n      setAutoRunState(next);\n      window.localStorage.setItem(AUTO_RUN_STORAGE_KEY, String(next));\n      if (next && !explicit) void evaluateNow();\n    },\n    [evaluateNow, explicit],\n  );\n\n  return {\n    response,\n    pending,\n    stale: isStale(evaluated, payload),\n    autoRun: explicit ? false : autoRun,\n    explicit,\n    setAutoRun,\n    run: evaluateNow,\n  };\n}\n\nfunction isStale(evaluated: Payload | null, current: Payload): boolean {\n  if (!current.source.trim()) return false;\n  if (!evaluated) return true;\n  return (\n    evaluated.source !== current.source ||\n    evaluated.input !== current.input ||\n    evaluated.language !== current.language\n  );\n}\n\nfunction readAutoRun(): boolean {\n  if (typeof window === \"undefined\") return true;\n  // Default on: the playground should evaluate as soon as it opens.\n  return window.localStorage.getItem(AUTO_RUN_STORAGE_KEY) !== \"false\";\n}\n"],"names":[],"mappings":"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"}