@flanksource/clicky-ui 0.3.34 → 0.3.36

package/dist/expressions/lang/completion.js

@@ -0,0 +1,164 @@
+import { functionDocumentation, macroDocumentation } from "./hover.js";
+import { pathFlavour, resolvePath, childEntries, pathExpression } from "./environment.js";
+import { environmentPrefixAt } from "./prefix.js";
+function registerCompletion(monaco, languageId, options) {
+  return monaco.languages.registerCompletionItemProvider(
+    languageId,
+    completionProvider(monaco, languageId, options)
+  );
+}
+function completionProvider(monaco, languageId, { spec, environment }) {
+  const items = catalogueItems(monaco, languageId, spec);
+  return {
+    // A dot must retrigger, or `k8s.` offers nothing until another key is hit.
+    triggerCharacters: ["."],
+    provideCompletionItems(model, position) {
+      const suggestions = environmentItems(
+        monaco,
+        model,
+        position,
+        languageId,
+        environment
+      );
+      const range = wordRange(model, position);
+      for (const item of items) suggestions.push({ ...item, range });
+      return { suggestions };
+    }
+  };
+}
+function catalogueItems(monaco, languageId, spec) {
+  switch (pathFlavour(languageId)) {
+    case "cel":
+      return celCompletionItems(monaco, spec);
+    case "gotemplate":
+      return goTemplateCompletionItems(monaco, spec);
+    default:
+      return [];
+  }
+}
+function environmentItems(monaco, model, position, languageId, environment) {
+  if (!environment) return [];
+  const document = environment();
+  if (document === void 0 || document === null) return [];
+  const prefix = environmentPrefixAt(model, position, languageId);
+  if (!prefix) return [];
+  const parent = resolvePath(document, prefix.segments);
+  if (parent === void 0) return [];
+  const kinds = monaco.languages.CompletionItemKind;
+  const range = {
+    startLineNumber: position.lineNumber,
+    endLineNumber: position.lineNumber,
+    startColumn: prefix.startColumn,
+    endColumn: prefix.endColumn
+  };
+  const typedHead = prefix.typed.slice(0, prefix.typed.length - prefix.leaf.length);
+  const items = [];
+  for (const entry of childEntries(parent)) {
+    const insertText = pathExpression(languageId, [...prefix.segments, entry.segment]);
+    if (insertText === null) continue;
+    items.push({
+      label: entry.key,
+      kind: entry.container ? kinds.Folder : kinds.Field,
+      insertText,
+      filterText: `${typedHead}${entry.key}`,
+      detail: `${entry.kind} · ${entry.summary}`,
+      // A key of the document being evaluated beats any catalogue entry: it is
+      // what the author came to the editor to write.
+      sortText: `0${entry.key}`,
+      range
+    });
+  }
+  return items;
+}
+function celCompletionItems(monaco, spec) {
+  const kinds = monaco.languages.CompletionItemKind;
+  const items = [];
+  for (const fn of spec.cel.functions) {
+    items.push(buildFunctionItem(monaco, fn, celInsertText(fn), kinds.Function));
+  }
+  for (const macro of spec.cel.macros) {
+    items.push(buildMacroItem(monaco, macro));
+  }
+  for (const keyword of spec.cel.keywords) {
+    items.push({
+      label: keyword,
+      kind: kinds.Keyword,
+      insertText: keyword,
+      detail: "CEL keyword"
+    });
+  }
+  for (const type of spec.cel.types) {
+    items.push({ label: type, kind: kinds.TypeParameter, insertText: type, detail: "CEL type" });
+  }
+  return items;
+}
+function goTemplateCompletionItems(monaco, spec) {
+  const kinds = monaco.languages.CompletionItemKind;
+  const items = [];
+  for (const fn of spec.gotemplate.functions) {
+    items.push(buildFunctionItem(monaco, fn, fn.name, kinds.Function));
+  }
+  for (const builtin of spec.gotemplate.builtins) {
+    items.push({
+      label: builtin,
+      kind: kinds.Function,
+      insertText: builtin,
+      detail: "text/template builtin"
+    });
+  }
+  for (const keyword of spec.gotemplate.keywords) {
+    items.push({
+      label: keyword,
+      kind: kinds.Keyword,
+      insertText: keyword,
+      detail: "template keyword"
+    });
+  }
+  return items;
+}
+function buildFunctionItem(monaco, fn, insertText, kind) {
+  var _a, _b;
+  const detail = fn.signature ?? ((_b = (_a = fn.overloads) == null ? void 0 : _a[0]) == null ? void 0 : _b.result);
+  return {
+    label: fn.name,
+    kind: fn.memberOnly ? monaco.languages.CompletionItemKind.Method : kind,
+    insertText,
+    ...detail === void 0 ? {} : { detail },
+    documentation: { value: functionDocumentation(fn) },
+    filterText: fn.name,
+    // Un-namespaced names first: they are the short, common ones, and a
+    // namespace is easy to reach by typing its prefix.
+    sortText: fn.namespace ? `2${fn.name}` : `1${fn.name}`
+  };
+}
+function buildMacroItem(monaco, macro) {
+  return {
+    label: macro.name,
+    kind: monaco.languages.CompletionItemKind.Keyword,
+    insertText: macro.name,
+    detail: `macro (${macro.argCount === 0 ? "variadic" : `${macro.argCount} args`})`,
+    documentation: { value: macroDocumentation(macro) },
+    filterText: macro.name,
+    sortText: `1${macro.name}`
+  };
+}
+function celInsertText(fn) {
+  var _a, _b, _c, _d;
+  const arity = ((_b = (_a = fn.overloads) == null ? void 0 : _a[0]) == null ? void 0 : _b.args.length) ?? 0;
+  const receiver = ((_d = (_c = fn.overloads) == null ? void 0 : _c[0]) == null ? void 0 : _d.member) ? 1 : 0;
+  return arity - receiver === 0 ? `${fn.name}()` : `${fn.name}(`;
+}
+function wordRange(model, position) {
+  const word = model.getWordUntilPosition(position);
+  return {
+    startLineNumber: position.lineNumber,
+    endLineNumber: position.lineNumber,
+    startColumn: word.startColumn,
+    endColumn: word.endColumn
+  };
+}
+export {
+  completionProvider,
+  registerCompletion
+};
+//# sourceMappingURL=completion.js.map

package/dist/expressions/lang/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sources":["../../../src/expressions/lang/completion.ts"],"sourcesContent":["import type * as monaco from \"monaco-editor\";\nimport type { GomplateSpec, Monaco, SpecFunction, SpecMacro } from \"./types\";\nimport { functionDocumentation, macroDocumentation } from \"./hover\";\nimport { childEntries, pathExpression, pathFlavour, resolvePath } from \"./environment\";\nimport { environmentPrefixAt } from \"./prefix\";\n\n/** Supplies the document expressions are evaluated against, on every request. */\nexport type EnvironmentSource = () => unknown;\n\nexport interface CompletionOptions {\n  /** The catalogue to complete from — gomplate's, or a host's merged over it. */\n  spec: GomplateSpec;\n  environment?: EnvironmentSource | undefined;\n}\n\n/**\n * Registers completion for one language.\n *\n * The catalogue half is built once per registration, so a host that supplies\n * its own spec re-registers rather than mutating in place. The document half is\n * rebuilt per request, because the document is being edited alongside the\n * expression.\n */\nexport function registerCompletion(\n  monaco: Monaco,\n  languageId: string,\n  options: CompletionOptions,\n) {\n  return monaco.languages.registerCompletionItemProvider(\n    languageId,\n    completionProvider(monaco, languageId, options),\n  );\n}\n\n/**\n * The provider `registerCompletion` installs, exposed so it can be driven\n * directly by a test over a real model rather than through Monaco's registry.\n */\nexport function completionProvider(\n  monaco: Monaco,\n  languageId: string,\n  { spec, environment }: CompletionOptions,\n) {\n  const items = catalogueItems(monaco, languageId, spec);\n  return {\n    // A dot must retrigger, or `k8s.` offers nothing until another key is hit.\n    triggerCharacters: [\".\"],\n    provideCompletionItems(model: monaco.editor.ITextModel, position: monaco.Position) {\n      const suggestions: monaco.languages.CompletionItem[] = environmentItems(\n        monaco,\n        model,\n        position,\n        languageId,\n        environment,\n      );\n      const range = wordRange(model, position);\n      for (const item of items) suggestions.push({ ...item, range });\n      return { suggestions };\n    },\n  };\n}\n\n/**\n * A completion item without its range. The range depends on the cursor, so it\n * is attached per request while the rest of the item is built once.\n */\ntype Item = Omit<monaco.languages.CompletionItem, \"range\">;\n\nfunction catalogueItems(monaco: Monaco, languageId: string, spec: GomplateSpec): Item[] {\n  switch (pathFlavour(languageId)) {\n    case \"cel\":\n      return celCompletionItems(monaco, spec);\n    case \"gotemplate\":\n      return goTemplateCompletionItems(monaco, spec);\n    default:\n      // JSONPath's dialect has no catalogue to generate from; its completions\n      // come entirely from the document.\n      return [];\n  }\n}\n\n/**\n * The keys reachable from the cursor's position in the document.\n *\n * Each item replaces the whole path typed so far with a freshly rendered one,\n * rather than appending to it, so what lands in the editor is always valid in\n * that language — quoting an awkward key, or dropping the suggestion entirely\n * where the language cannot express the path.\n */\nfunction environmentItems(\n  monaco: Monaco,\n  model: monaco.editor.ITextModel,\n  position: monaco.Position,\n  languageId: string,\n  environment: EnvironmentSource | undefined,\n): monaco.languages.CompletionItem[] {\n  if (!environment) return [];\n  const document = environment();\n  if (document === undefined || document === null) return [];\n\n  const prefix = environmentPrefixAt(model, position, languageId);\n  if (!prefix) return [];\n\n  const parent = resolvePath(document, prefix.segments);\n  if (parent === undefined) return [];\n\n  const kinds = monaco.languages.CompletionItemKind;\n  const range = {\n    startLineNumber: position.lineNumber,\n    endLineNumber: position.lineNumber,\n    startColumn: prefix.startColumn,\n    endColumn: prefix.endColumn,\n  };\n\n  // Monaco filters a candidate against the model text from the range start to\n  // the cursor, so `filterText` has to continue what was typed rather than\n  // repeat the rendered path: `pod.items[0]` does not match `pod.items.`, and\n  // the subscripted keys would be filtered straight back out.\n  const typedHead = prefix.typed.slice(0, prefix.typed.length - prefix.leaf.length);\n\n  const items: monaco.languages.CompletionItem[] = [];\n  for (const entry of childEntries(parent)) {\n    const insertText = pathExpression(languageId, [...prefix.segments, entry.segment]);\n    if (insertText === null) continue;\n    items.push({\n      label: entry.key,\n      kind: entry.container ? kinds.Folder : kinds.Field,\n      insertText,\n      filterText: `${typedHead}${entry.key}`,\n      detail: `${entry.kind} · ${entry.summary}`,\n      // A key of the document being evaluated beats any catalogue entry: it is\n      // what the author came to the editor to write.\n      sortText: `0${entry.key}`,\n      range,\n    });\n  }\n  return items;\n}\n\nfunction celCompletionItems(monaco: Monaco, spec: GomplateSpec) {\n  const kinds = monaco.languages.CompletionItemKind;\n  const items: Item[] = [];\n\n  for (const fn of spec.cel.functions) {\n    items.push(buildFunctionItem(monaco, fn, celInsertText(fn), kinds.Function));\n  }\n  for (const macro of spec.cel.macros) {\n    items.push(buildMacroItem(monaco, macro));\n  }\n  for (const keyword of spec.cel.keywords) {\n    items.push({\n      label: keyword,\n      kind: kinds.Keyword,\n      insertText: keyword,\n      detail: \"CEL keyword\",\n    });\n  }\n  for (const type of spec.cel.types) {\n    items.push({ label: type, kind: kinds.TypeParameter, insertText: type, detail: \"CEL type\" });\n  }\n  return items;\n}\n\nfunction goTemplateCompletionItems(monaco: Monaco, spec: GomplateSpec) {\n  const kinds = monaco.languages.CompletionItemKind;\n  const items: Item[] = [];\n\n  for (const fn of spec.gotemplate.functions) {\n    items.push(buildFunctionItem(monaco, fn, fn.name, kinds.Function));\n  }\n  for (const builtin of spec.gotemplate.builtins) {\n    items.push({\n      label: builtin,\n      kind: kinds.Function,\n      insertText: builtin,\n      detail: \"text/template builtin\",\n    });\n  }\n  for (const keyword of spec.gotemplate.keywords) {\n    items.push({\n      label: keyword,\n      kind: kinds.Keyword,\n      insertText: keyword,\n      detail: \"template keyword\",\n    });\n  }\n  return items;\n}\n\nfunction buildFunctionItem(\n  monaco: Monaco,\n  fn: SpecFunction,\n  insertText: string,\n  kind: monaco.languages.CompletionItemKind,\n): Item {\n  // A function with neither a Go signature nor an overload has no detail to\n  // show; the key has to be absent rather than explicitly undefined.\n  const detail = fn.signature ?? fn.overloads?.[0]?.result;\n  return {\n    label: fn.name,\n    kind: fn.memberOnly ? monaco.languages.CompletionItemKind.Method : kind,\n    insertText,\n    ...(detail === undefined ? {} : { detail }),\n    documentation: { value: functionDocumentation(fn) },\n    filterText: fn.name,\n    // Un-namespaced names first: they are the short, common ones, and a\n    // namespace is easy to reach by typing its prefix.\n    sortText: fn.namespace ? `2${fn.name}` : `1${fn.name}`,\n  };\n}\n\nfunction buildMacroItem(monaco: Monaco, macro: SpecMacro): Item {\n  return {\n    label: macro.name,\n    kind: monaco.languages.CompletionItemKind.Keyword,\n    insertText: macro.name,\n    detail: `macro (${macro.argCount === 0 ? \"variadic\" : `${macro.argCount} args`})`,\n    documentation: { value: macroDocumentation(macro) },\n    filterText: macro.name,\n    sortText: `1${macro.name}`,\n  };\n}\n\n/**\n * CEL functions take parentheses; a member-only function is offered without a\n * leading dot because the dot is already typed when completion fires.\n */\nfunction celInsertText(fn: SpecFunction) {\n  const arity = fn.overloads?.[0]?.args.length ?? 0;\n  const receiver = fn.overloads?.[0]?.member ? 1 : 0;\n  return arity - receiver === 0 ? `${fn.name}()` : `${fn.name}(`;\n}\n\nfunction wordRange(\n  model: {\n    getWordUntilPosition(p: { lineNumber: number; column: number }): {\n      startColumn: number;\n      endColumn: number;\n    };\n  },\n  position: { lineNumber: number; column: number },\n) {\n  const word = model.getWordUntilPosition(position);\n  return {\n    startLineNumber: position.lineNumber,\n    endLineNumber: position.lineNumber,\n    startColumn: word.startColumn,\n    endColumn: word.endColumn,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/expressions/lang/environment.cjs

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function isIdentifier(key) {
+  return IDENTIFIER.test(key);
+}
+function kindOf(value) {
+  if (value === null || value === void 0) return "null";
+  if (Array.isArray(value)) return "array";
+  switch (typeof value) {
+    case "string":
+      return "string";
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    default:
+      return "object";
+  }
+}
+const SUMMARY_LIMIT = 32;
+function summarize(value) {
+  switch (kindOf(value)) {
+    case "null":
+      return "null";
+    case "array":
+      return plural(value.length, "item");
+    case "object":
+      return plural(Object.keys(value).length, "key");
+    case "string": {
+      const text = value;
+      return text.length > SUMMARY_LIMIT ? `${JSON.stringify(text.slice(0, SUMMARY_LIMIT))}…` : JSON.stringify(text);
+    }
+    default:
+      return String(value);
+  }
+}
+function plural(count, noun) {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function resolvePath(environment, segments) {
+  let current = environment;
+  for (const segment of segments) {
+    if (typeof segment === "number") {
+      if (!Array.isArray(current)) return void 0;
+      current = current[segment];
+      continue;
+    }
+    if (!isRecord(current)) return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+function childEntries(value) {
+  if (Array.isArray(value)) {
+    return value.map((element, index) => ({
+      key: String(index),
+      segment: index,
+      kind: kindOf(element),
+      summary: summarize(element),
+      container: isContainer(element)
+    }));
+  }
+  if (!isRecord(value)) return [];
+  return Object.entries(value).map(([key, child]) => ({
+    key,
+    segment: key,
+    kind: kindOf(child),
+    summary: summarize(child),
+    container: isContainer(child)
+  }));
+}
+function isContainer(value) {
+  const kind = kindOf(value);
+  return kind === "object" || kind === "array";
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pathExpression(languageId, segments) {
+  const flavour = pathFlavour(languageId);
+  if (!flavour) return null;
+  if (flavour === "gotemplate") {
+    if (segments.some((segment) => typeof segment === "number" || !isIdentifier(segment))) {
+      return null;
+    }
+    return segments.length === 0 ? "." : segments.map((segment) => `.${String(segment)}`).join("");
+  }
+  const root = flavour === "jsonpath" ? "$" : "";
+  let out = root;
+  for (const segment of segments) {
+    if (typeof segment === "number") {
+      out += `[${segment}]`;
+    } else if (isIdentifier(segment)) {
+      out += out === "" ? segment : `.${segment}`;
+    } else {
+      out += `[${JSON.stringify(segment)}]`;
+    }
+  }
+  return out;
+}
+function pathFlavour(languageId) {
+  if (languageId === "cel") return "cel";
+  if (languageId === "jsonpath") return "jsonpath";
+  if (languageId === "gomplate" || languageId.endsWith("-gomplate")) return "gotemplate";
+  return null;
+}
+exports.childEntries = childEntries;
+exports.isIdentifier = isIdentifier;
+exports.kindOf = kindOf;
+exports.pathExpression = pathExpression;
+exports.pathFlavour = pathFlavour;
+exports.resolvePath = resolvePath;
+exports.summarize = summarize;
+//# sourceMappingURL=environment.cjs.map

package/dist/expressions/lang/environment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.cjs","sources":["../../../src/expressions/lang/environment.ts"],"sourcesContent":["/**\n * Introspection of the document an expression is evaluated against.\n *\n * Deliberately free of Monaco and of any UI dependency: the same functions back\n * editor completion and any caller that needs to render a document's shape.\n */\n\n/** One step of a path. A number indexes a list, a string keys a map. */\nexport type PathSegment = string | number;\n\n/** The JSON shape of a value, as a name a reader recognises. */\nexport type ValueKind = \"string\" | \"number\" | \"boolean\" | \"null\" | \"object\" | \"array\";\n\n/** One child of a container, as completion and shape views need it. */\nexport interface EnvironmentEntry {\n  /** The key or index, as typed. */\n  key: string;\n  segment: PathSegment;\n  kind: ValueKind;\n  /** A short rendering of the value, for a detail column. */\n  summary: string;\n  /** Whether the value has children of its own. */\n  container: boolean;\n}\n\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Whether `key` can be written as a bare `.key` rather than a subscript. */\nexport function isIdentifier(key: string): boolean {\n  return IDENTIFIER.test(key);\n}\n\nexport function kindOf(value: unknown): ValueKind {\n  if (value === null || value === undefined) return \"null\";\n  if (Array.isArray(value)) return \"array\";\n  switch (typeof value) {\n    case \"string\":\n      return \"string\";\n    case \"number\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    default:\n      return \"object\";\n  }\n}\n\nconst SUMMARY_LIMIT = 32;\n\n/** A one-line rendering of a value: the sample a completion detail shows. */\nexport function summarize(value: unknown): string {\n  switch (kindOf(value)) {\n    case \"null\":\n      return \"null\";\n    case \"array\":\n      return plural((value as unknown[]).length, \"item\");\n    case \"object\":\n      return plural(Object.keys(value as Record<string, unknown>).length, \"key\");\n    case \"string\": {\n      const text = value as string;\n      return text.length > SUMMARY_LIMIT ? `${JSON.stringify(text.slice(0, SUMMARY_LIMIT))}…` : JSON.stringify(text);\n    }\n    default:\n      return String(value);\n  }\n}\n\nfunction plural(count: number, noun: string): string {\n  return `${count} ${noun}${count === 1 ? \"\" : \"s\"}`;\n}\n\n/**\n * Walks `segments` from the root.\n *\n * A numeric segment indexes a list and nothing else; a string segment keys a\n * map. Returns undefined as soon as a step does not apply, so a half-typed path\n * simply yields no completions rather than throwing.\n */\nexport function resolvePath(environment: unknown, segments: readonly PathSegment[]): unknown {\n  let current = environment;\n  for (const segment of segments) {\n    if (typeof segment === \"number\") {\n      if (!Array.isArray(current)) return undefined;\n      current = current[segment];\n      continue;\n    }\n    if (!isRecord(current)) return undefined;\n    current = current[segment];\n  }\n  return current;\n}\n\n/**\n * The children of a container, in document order.\n *\n * A list yields its indices rather than the keys of its first element: no\n * language here lets a field follow a list without an index, so offering\n * `containers.name` would complete an expression that cannot evaluate.\n */\nexport function childEntries(value: unknown): EnvironmentEntry[] {\n  if (Array.isArray(value)) {\n    return value.map((element, index) => ({\n      key: String(index),\n      segment: index,\n      kind: kindOf(element),\n      summary: summarize(element),\n      container: isContainer(element),\n    }));\n  }\n  if (!isRecord(value)) return [];\n  return Object.entries(value).map(([key, child]) => ({\n    key,\n    segment: key,\n    kind: kindOf(child),\n    summary: summarize(child),\n    container: isContainer(child),\n  }));\n}\n\nfunction isContainer(value: unknown): boolean {\n  const kind = kindOf(value);\n  return kind === \"object\" || kind === \"array\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Renders a path in one language's syntax.\n *\n * The single place path syntax is spelled out, so completion and click-to-insert\n * cannot drift apart. Returns null when the path has no expression in that\n * language — a go-template reaches a list element or an awkward key through\n * `index`, which is a call rather than a path.\n */\nexport function pathExpression(languageId: string, segments: readonly PathSegment[]): string | null {\n  const flavour = pathFlavour(languageId);\n  if (!flavour) return null;\n  if (flavour === \"gotemplate\") {\n    if (segments.some((segment) => typeof segment === \"number\" || !isIdentifier(segment))) {\n      return null;\n    }\n    return segments.length === 0 ? \".\" : segments.map((segment) => `.${String(segment)}`).join(\"\");\n  }\n\n  const root = flavour === \"jsonpath\" ? \"$\" : \"\";\n  let out = root;\n  for (const segment of segments) {\n    if (typeof segment === \"number\") {\n      out += `[${segment}]`;\n    } else if (isIdentifier(segment)) {\n      out += out === \"\" ? segment : `.${segment}`;\n    } else {\n      out += `[${JSON.stringify(segment)}]`;\n    }\n  }\n  return out;\n}\n\n/** Which path syntax a language id uses. */\nexport function pathFlavour(languageId: string): \"cel\" | \"gotemplate\" | \"jsonpath\" | null {\n  if (languageId === \"cel\") return \"cel\";\n  if (languageId === \"jsonpath\") return \"jsonpath\";\n  if (languageId === \"gomplate\" || languageId.endsWith(\"-gomplate\")) return \"gotemplate\";\n  return null;\n}\n"],"names":[],"mappings":"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"}

package/dist/expressions/lang/environment.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Introspection of the document an expression is evaluated against.
+ *
+ * Deliberately free of Monaco and of any UI dependency: the same functions back
+ * editor completion and any caller that needs to render a document's shape.
+ */
+/** One step of a path. A number indexes a list, a string keys a map. */
+export type PathSegment = string | number;
+/** The JSON shape of a value, as a name a reader recognises. */
+export type ValueKind = "string" | "number" | "boolean" | "null" | "object" | "array";
+/** One child of a container, as completion and shape views need it. */
+export interface EnvironmentEntry {
+    /** The key or index, as typed. */
+    key: string;
+    segment: PathSegment;
+    kind: ValueKind;
+    /** A short rendering of the value, for a detail column. */
+    summary: string;
+    /** Whether the value has children of its own. */
+    container: boolean;
+}
+/** Whether `key` can be written as a bare `.key` rather than a subscript. */
+export declare function isIdentifier(key: string): boolean;
+export declare function kindOf(value: unknown): ValueKind;
+/** A one-line rendering of a value: the sample a completion detail shows. */
+export declare function summarize(value: unknown): string;
+/**
+ * Walks `segments` from the root.
+ *
+ * A numeric segment indexes a list and nothing else; a string segment keys a
+ * map. Returns undefined as soon as a step does not apply, so a half-typed path
+ * simply yields no completions rather than throwing.
+ */
+export declare function resolvePath(environment: unknown, segments: readonly PathSegment[]): unknown;
+/**
+ * The children of a container, in document order.
+ *
+ * A list yields its indices rather than the keys of its first element: no
+ * language here lets a field follow a list without an index, so offering
+ * `containers.name` would complete an expression that cannot evaluate.
+ */
+export declare function childEntries(value: unknown): EnvironmentEntry[];
+/**
+ * Renders a path in one language's syntax.
+ *
+ * The single place path syntax is spelled out, so completion and click-to-insert
+ * cannot drift apart. Returns null when the path has no expression in that
+ * language — a go-template reaches a list element or an awkward key through
+ * `index`, which is a call rather than a path.
+ */
+export declare function pathExpression(languageId: string, segments: readonly PathSegment[]): string | null;
+/** Which path syntax a language id uses. */
+export declare function pathFlavour(languageId: string): "cel" | "gotemplate" | "jsonpath" | null;
+//# sourceMappingURL=environment.d.ts.map

package/dist/expressions/lang/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/expressions/lang/environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1C,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEtF,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAahD;AAID,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAehD;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAY3F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAkB/D;AAWD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAsBlG;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,UAAU,GAAG,IAAI,CAKxF"}

package/dist/expressions/lang/environment.js

@@ -0,0 +1,115 @@
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function isIdentifier(key) {
+  return IDENTIFIER.test(key);
+}
+function kindOf(value) {
+  if (value === null || value === void 0) return "null";
+  if (Array.isArray(value)) return "array";
+  switch (typeof value) {
+    case "string":
+      return "string";
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    default:
+      return "object";
+  }
+}
+const SUMMARY_LIMIT = 32;
+function summarize(value) {
+  switch (kindOf(value)) {
+    case "null":
+      return "null";
+    case "array":
+      return plural(value.length, "item");
+    case "object":
+      return plural(Object.keys(value).length, "key");
+    case "string": {
+      const text = value;
+      return text.length > SUMMARY_LIMIT ? `${JSON.stringify(text.slice(0, SUMMARY_LIMIT))}…` : JSON.stringify(text);
+    }
+    default:
+      return String(value);
+  }
+}
+function plural(count, noun) {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function resolvePath(environment, segments) {
+  let current = environment;
+  for (const segment of segments) {
+    if (typeof segment === "number") {
+      if (!Array.isArray(current)) return void 0;
+      current = current[segment];
+      continue;
+    }
+    if (!isRecord(current)) return void 0;
+    current = current[segment];
+  }
+  return current;
+}
+function childEntries(value) {
+  if (Array.isArray(value)) {
+    return value.map((element, index) => ({
+      key: String(index),
+      segment: index,
+      kind: kindOf(element),
+      summary: summarize(element),
+      container: isContainer(element)
+    }));
+  }
+  if (!isRecord(value)) return [];
+  return Object.entries(value).map(([key, child]) => ({
+    key,
+    segment: key,
+    kind: kindOf(child),
+    summary: summarize(child),
+    container: isContainer(child)
+  }));
+}
+function isContainer(value) {
+  const kind = kindOf(value);
+  return kind === "object" || kind === "array";
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function pathExpression(languageId, segments) {
+  const flavour = pathFlavour(languageId);
+  if (!flavour) return null;
+  if (flavour === "gotemplate") {
+    if (segments.some((segment) => typeof segment === "number" || !isIdentifier(segment))) {
+      return null;
+    }
+    return segments.length === 0 ? "." : segments.map((segment) => `.${String(segment)}`).join("");
+  }
+  const root = flavour === "jsonpath" ? "$" : "";
+  let out = root;
+  for (const segment of segments) {
+    if (typeof segment === "number") {
+      out += `[${segment}]`;
+    } else if (isIdentifier(segment)) {
+      out += out === "" ? segment : `.${segment}`;
+    } else {
+      out += `[${JSON.stringify(segment)}]`;
+    }
+  }
+  return out;
+}
+function pathFlavour(languageId) {
+  if (languageId === "cel") return "cel";
+  if (languageId === "jsonpath") return "jsonpath";
+  if (languageId === "gomplate" || languageId.endsWith("-gomplate")) return "gotemplate";
+  return null;
+}
+export {
+  childEntries,
+  isIdentifier,
+  kindOf,
+  pathExpression,
+  pathFlavour,
+  resolvePath,
+  summarize
+};
+//# sourceMappingURL=environment.js.map

package/dist/expressions/lang/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sources":["../../../src/expressions/lang/environment.ts"],"sourcesContent":["/**\n * Introspection of the document an expression is evaluated against.\n *\n * Deliberately free of Monaco and of any UI dependency: the same functions back\n * editor completion and any caller that needs to render a document's shape.\n */\n\n/** One step of a path. A number indexes a list, a string keys a map. */\nexport type PathSegment = string | number;\n\n/** The JSON shape of a value, as a name a reader recognises. */\nexport type ValueKind = \"string\" | \"number\" | \"boolean\" | \"null\" | \"object\" | \"array\";\n\n/** One child of a container, as completion and shape views need it. */\nexport interface EnvironmentEntry {\n  /** The key or index, as typed. */\n  key: string;\n  segment: PathSegment;\n  kind: ValueKind;\n  /** A short rendering of the value, for a detail column. */\n  summary: string;\n  /** Whether the value has children of its own. */\n  container: boolean;\n}\n\nconst IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/** Whether `key` can be written as a bare `.key` rather than a subscript. */\nexport function isIdentifier(key: string): boolean {\n  return IDENTIFIER.test(key);\n}\n\nexport function kindOf(value: unknown): ValueKind {\n  if (value === null || value === undefined) return \"null\";\n  if (Array.isArray(value)) return \"array\";\n  switch (typeof value) {\n    case \"string\":\n      return \"string\";\n    case \"number\":\n      return \"number\";\n    case \"boolean\":\n      return \"boolean\";\n    default:\n      return \"object\";\n  }\n}\n\nconst SUMMARY_LIMIT = 32;\n\n/** A one-line rendering of a value: the sample a completion detail shows. */\nexport function summarize(value: unknown): string {\n  switch (kindOf(value)) {\n    case \"null\":\n      return \"null\";\n    case \"array\":\n      return plural((value as unknown[]).length, \"item\");\n    case \"object\":\n      return plural(Object.keys(value as Record<string, unknown>).length, \"key\");\n    case \"string\": {\n      const text = value as string;\n      return text.length > SUMMARY_LIMIT ? `${JSON.stringify(text.slice(0, SUMMARY_LIMIT))}…` : JSON.stringify(text);\n    }\n    default:\n      return String(value);\n  }\n}\n\nfunction plural(count: number, noun: string): string {\n  return `${count} ${noun}${count === 1 ? \"\" : \"s\"}`;\n}\n\n/**\n * Walks `segments` from the root.\n *\n * A numeric segment indexes a list and nothing else; a string segment keys a\n * map. Returns undefined as soon as a step does not apply, so a half-typed path\n * simply yields no completions rather than throwing.\n */\nexport function resolvePath(environment: unknown, segments: readonly PathSegment[]): unknown {\n  let current = environment;\n  for (const segment of segments) {\n    if (typeof segment === \"number\") {\n      if (!Array.isArray(current)) return undefined;\n      current = current[segment];\n      continue;\n    }\n    if (!isRecord(current)) return undefined;\n    current = current[segment];\n  }\n  return current;\n}\n\n/**\n * The children of a container, in document order.\n *\n * A list yields its indices rather than the keys of its first element: no\n * language here lets a field follow a list without an index, so offering\n * `containers.name` would complete an expression that cannot evaluate.\n */\nexport function childEntries(value: unknown): EnvironmentEntry[] {\n  if (Array.isArray(value)) {\n    return value.map((element, index) => ({\n      key: String(index),\n      segment: index,\n      kind: kindOf(element),\n      summary: summarize(element),\n      container: isContainer(element),\n    }));\n  }\n  if (!isRecord(value)) return [];\n  return Object.entries(value).map(([key, child]) => ({\n    key,\n    segment: key,\n    kind: kindOf(child),\n    summary: summarize(child),\n    container: isContainer(child),\n  }));\n}\n\nfunction isContainer(value: unknown): boolean {\n  const kind = kindOf(value);\n  return kind === \"object\" || kind === \"array\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Renders a path in one language's syntax.\n *\n * The single place path syntax is spelled out, so completion and click-to-insert\n * cannot drift apart. Returns null when the path has no expression in that\n * language — a go-template reaches a list element or an awkward key through\n * `index`, which is a call rather than a path.\n */\nexport function pathExpression(languageId: string, segments: readonly PathSegment[]): string | null {\n  const flavour = pathFlavour(languageId);\n  if (!flavour) return null;\n  if (flavour === \"gotemplate\") {\n    if (segments.some((segment) => typeof segment === \"number\" || !isIdentifier(segment))) {\n      return null;\n    }\n    return segments.length === 0 ? \".\" : segments.map((segment) => `.${String(segment)}`).join(\"\");\n  }\n\n  const root = flavour === \"jsonpath\" ? \"$\" : \"\";\n  let out = root;\n  for (const segment of segments) {\n    if (typeof segment === \"number\") {\n      out += `[${segment}]`;\n    } else if (isIdentifier(segment)) {\n      out += out === \"\" ? segment : `.${segment}`;\n    } else {\n      out += `[${JSON.stringify(segment)}]`;\n    }\n  }\n  return out;\n}\n\n/** Which path syntax a language id uses. */\nexport function pathFlavour(languageId: string): \"cel\" | \"gotemplate\" | \"jsonpath\" | null {\n  if (languageId === \"cel\") return \"cel\";\n  if (languageId === \"jsonpath\") return \"jsonpath\";\n  if (languageId === \"gomplate\" || languageId.endsWith(\"-gomplate\")) return \"gotemplate\";\n  return null;\n}\n"],"names":[],"mappings":"AAyBA,MAAM,aAAa;AAGZ,SAAS,aAAa,KAAsB;AACjD,SAAO,WAAW,KAAK,GAAG;AAC5B;AAEO,SAAS,OAAO,OAA2B;AAChD,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,UAAQ,OAAO,OAAA;AAAA,IACb,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;AAEA,MAAM,gBAAgB;AAGf,SAAS,UAAU,OAAwB;AAChD,UAAQ,OAAO,KAAK,GAAA;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,OAAQ,MAAoB,QAAQ,MAAM;AAAA,IACnD,KAAK;AACH,aAAO,OAAO,OAAO,KAAK,KAAgC,EAAE,QAAQ,KAAK;AAAA,IAC3E,KAAK,UAAU;AACb,YAAM,OAAO;AACb,aAAO,KAAK,SAAS,gBAAgB,GAAG,KAAK,UAAU,KAAK,MAAM,GAAG,aAAa,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI;AAAA,IAC/G;AAAA,IACA;AACE,aAAO,OAAO,KAAK;AAAA,EAAA;AAEzB;AAEA,SAAS,OAAO,OAAe,MAAsB;AACnD,SAAO,GAAG,KAAK,IAAI,IAAI,GAAG,UAAU,IAAI,KAAK,GAAG;AAClD;AASO,SAAS,YAAY,aAAsB,UAA2C;AAC3F,MAAI,UAAU;AACd,aAAW,WAAW,UAAU;AAC9B,QAAI,OAAO,YAAY,UAAU;AAC/B,UAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO;AACpC,gBAAU,QAAQ,OAAO;AACzB;AAAA,IACF;AACA,QAAI,CAAC,SAAS,OAAO,EAAG,QAAO;AAC/B,cAAU,QAAQ,OAAO;AAAA,EAC3B;AACA,SAAO;AACT;AASO,SAAS,aAAa,OAAoC;AAC/D,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,SAAS,WAAW;AAAA,MACpC,KAAK,OAAO,KAAK;AAAA,MACjB,SAAS;AAAA,MACT,MAAM,OAAO,OAAO;AAAA,MACpB,SAAS,UAAU,OAAO;AAAA,MAC1B,WAAW,YAAY,OAAO;AAAA,IAAA,EAC9B;AAAA,EACJ;AACA,MAAI,CAAC,SAAS,KAAK,UAAU,CAAA;AAC7B,SAAO,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO;AAAA,IAClD;AAAA,IACA,SAAS;AAAA,IACT,MAAM,OAAO,KAAK;AAAA,IAClB,SAAS,UAAU,KAAK;AAAA,IACxB,WAAW,YAAY,KAAK;AAAA,EAAA,EAC5B;AACJ;AAEA,SAAS,YAAY,OAAyB;AAC5C,QAAM,OAAO,OAAO,KAAK;AACzB,SAAO,SAAS,YAAY,SAAS;AACvC;AAEA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAUO,SAAS,eAAe,YAAoB,UAAiD;AAClG,QAAM,UAAU,YAAY,UAAU;AACtC,MAAI,CAAC,QAAS,QAAO;AACrB,MAAI,YAAY,cAAc;AAC5B,QAAI,SAAS,KAAK,CAAC,YAAY,OAAO,YAAY,YAAY,CAAC,aAAa,OAAO,CAAC,GAAG;AACrF,aAAO;AAAA,IACT;AACA,WAAO,SAAS,WAAW,IAAI,MAAM,SAAS,IAAI,CAAC,YAAY,IAAI,OAAO,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE;AAAA,EAC/F;AAEA,QAAM,OAAO,YAAY,aAAa,MAAM;AAC5C,MAAI,MAAM;AACV,aAAW,WAAW,UAAU;AAC9B,QAAI,OAAO,YAAY,UAAU;AAC/B,aAAO,IAAI,OAAO;AAAA,IACpB,WAAW,aAAa,OAAO,GAAG;AAChC,aAAO,QAAQ,KAAK,UAAU,IAAI,OAAO;AAAA,IAC3C,OAAO;AACL,aAAO,IAAI,KAAK,UAAU,OAAO,CAAC;AAAA,IACpC;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,YAAY,YAA8D;AACxF,MAAI,eAAe,MAAO,QAAO;AACjC,MAAI,eAAe,WAAY,QAAO;AACtC,MAAI,eAAe,cAAc,WAAW,SAAS,WAAW,EAAG,QAAO;AAC1E,SAAO;AACT;"}