@flanksource/clicky-ui 0.3.44 → 0.3.45

package/dist/data/call-graph/call-graph-vocabulary.d.ts

@@ -0,0 +1,72 @@
+import { IconComponent } from '../../icons.js';
+import { CallGraph, CallGraphNode } from './types.js';
+export interface CallGraphGlyph {
+    id: string;
+    /** The legend's name for it. */
+    name: string;
+    icon: IconComponent;
+    /** Drawn instead of `icon` in the dark theme, for coloured artwork. */
+    darkIcon?: IconComponent;
+}
+export interface CallGraphVocabulary {
+    /** Every glyph the vocabulary draws, in legend order. */
+    glyphs: readonly CallGraphGlyph[];
+    /** The id of the one glyph a node shows. */
+    glyphOf(graph: CallGraph, node: CallGraphNode): string;
+    /** What the node is, in words: `method`, `external function`, `copybook`. */
+    kindOf(graph: CallGraph, node: CallGraphNode): string;
+    /** The node has a body the source walks: it can be expanded and opened. */
+    hasSource(node: CallGraphNode): boolean;
+    /** The graph can be drawn around the node: Focus is offered for it, with or without a source. */
+    canRoot(node: CallGraphNode): boolean;
+    /** A table, column, procedure, entity or field: its details count readers and writers. */
+    isData(node: CallGraphNode): boolean;
+    /** Drawn dimmed: the node leads nowhere further. */
+    muted(node: CallGraphNode): boolean;
+    /** The node's status line in its details. */
+    status(node: CallGraphNode): string;
+    /** The node a data node stands for, such as the column behind a field, offered as a Focus link. */
+    backing?(node: CallGraphNode): {
+        id: string;
+        label: string;
+    } | undefined;
+    /** What a group is, and the icon its box caption shows. */
+    group: {
+        noun: string;
+        plural: string;
+        icon: IconComponent;
+        patternHint: string;
+    };
+}
+/** The glyph with that id, failing on one the vocabulary does not list. */
+export declare function requireGlyph(vocabulary: CallGraphVocabulary, id: string): CallGraphGlyph;
+/** The glyphs the graph's nodes use, once each, in legend order. */
+export declare function usedGlyphs(graph: CallGraph, vocabulary: CallGraphVocabulary): CallGraphGlyph[];
+/** The node's tooltip: its kind, its label and its group's full label. */
+export declare function nodeTitle(graph: CallGraph, node: CallGraphNode, vocabulary: CallGraphVocabulary): string;
+export declare function callsItself(graph: CallGraph, node: CallGraphNode): boolean;
+export declare function siteKey(site: {
+    path?: string;
+    line?: number;
+    column?: number;
+}): string;
+export declare const DATA_KIND_WORDS: Readonly<Record<string, string>>;
+export declare const CALL_GRAPH_DATA_GLYPHS: readonly CallGraphGlyph[];
+export declare function isDataNode(node: CallGraphNode): boolean;
+export declare function dataNodeStatus(node: CallGraphNode): string;
+/** The column behind a field, by its `column` property. */
+export declare function dataNodeBacking(node: CallGraphNode): {
+    id: string;
+    label: string;
+} | undefined;
+export declare function isBuiltin(node: CallGraphNode): boolean;
+/** A symbol declared outside the indexed snapshots: it has no source, so it cannot be opened or expanded. */
+export declare function isExternal(node: CallGraphNode): boolean;
+/**
+ * The index has no kind for an interface method: it is a `method`. It shows in the graph as the target
+ * of a call whose site also carries a dispatch edge from the same caller, because the source adds that
+ * dispatch edge to each implementation of the interface method called there.
+ */
+export declare function interfaceMethods(graph: CallGraph): Set<string>;
+export declare const UIR_CALL_GRAPH_VOCABULARY: CallGraphVocabulary;
+//# sourceMappingURL=call-graph-vocabulary.d.ts.map

package/dist/data/call-graph/call-graph-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph-vocabulary.d.ts","sourceRoot":"","sources":["../../../src/data/call-graph/call-graph-vocabulary.ts"],"names":[],"mappings":"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"}

package/dist/data/call-graph/call-graph-vocabulary.js

@@ -0,0 +1,177 @@
+import { UiSqlTable } from "../../icons/components/UiSqlTable.js";
+import { UiSqlColumn } from "../../icons/components/UiSqlColumn.js";
+import { UiSqlStoredProc } from "../../icons/components/UiSqlStoredProc.js";
+import { UiTableProperties } from "../../icons/components/UiTableProperties.js";
+import { UiField } from "../../icons/components/UiField.js";
+import { UiPackage } from "../../icons/components/UiPackage.js";
+import { UiFunction } from "../../icons/components/UiFunction.js";
+import { UiMethod } from "../../icons/components/UiMethod.js";
+import { UiInterface } from "../../icons/components/UiInterface.js";
+import { UiMethod11Dark, UiMethod11 } from "../../icons/components/UiMethod11.js";
+import { UiFunction1Dark, UiFunction1 } from "../../icons/components/UiFunction1.js";
+import { UiFunctionSquare } from "../../icons/components/UiFunctionSquare.js";
+import { UiTypeParameter } from "../../icons/components/UiTypeParameter.js";
+import { UiVariable } from "../../icons/components/UiVariable.js";
+import { UiConstant } from "../../icons/components/UiConstant.js";
+import { UiUnknown } from "../../icons/components/UiUnknown.js";
+import { UiSymbolDark, UiSymbol } from "../../icons/components/UiSymbol.js";
+function requireGlyph(vocabulary, id) {
+  const glyph = vocabulary.glyphs.find((candidate) => candidate.id === id);
+  if (!glyph) throw new Error(`call graph: the vocabulary has no glyph "${id}"`);
+  return glyph;
+}
+function usedGlyphs(graph, vocabulary) {
+  const used = new Set(graph.nodes.map((node) => vocabulary.glyphOf(graph, node)));
+  return vocabulary.glyphs.filter((glyph) => used.has(glyph.id));
+}
+function nodeTitle(graph, node, vocabulary) {
+  var _a, _b;
+  const group = ((_b = (_a = graph.groups) == null ? void 0 : _a.find((candidate) => candidate.id === node.group)) == null ? void 0 : _b.label) ?? node.group;
+  return `${vocabulary.kindOf(graph, node)} ${node.label}${group ? ` in ${group}` : ""}`;
+}
+function callsItself(graph, node) {
+  return graph.edges.some((edge) => edge.from === node.id && edge.to === node.id);
+}
+function siteKey(site) {
+  return `${site.path}:${site.line}:${site.column}`;
+}
+const UIR_KINDS = /* @__PURE__ */ new Map([
+  ["func", { glyph: "func", words: "function" }],
+  ["method", { glyph: "method", words: "method" }],
+  ["builtin", { glyph: "builtin", words: "builtin" }],
+  ["type", { glyph: "type", words: "type" }],
+  ["field", { glyph: "field", words: "field" }],
+  ["var", { glyph: "var", words: "variable" }],
+  ["const", { glyph: "const", words: "constant" }],
+  ["package", { glyph: "package", words: "package scope" }]
+]);
+const DATA_KIND_WORDS = {
+  table: "table",
+  column: "column",
+  procedure: "stored procedure",
+  entity: "entity",
+  field: "field"
+};
+const CALL_GRAPH_DATA_GLYPHS = [
+  { id: "table", name: "table", icon: UiSqlTable },
+  { id: "column", name: "column", icon: UiSqlColumn },
+  { id: "procedure", name: "stored procedure", icon: UiSqlStoredProc },
+  { id: "entity", name: "entity", icon: UiTableProperties },
+  { id: "field", name: "field", icon: UiField }
+];
+function isDataNode(node) {
+  return Object.hasOwn(DATA_KIND_WORDS, node.kind);
+}
+function dataName(node) {
+  const prefix = `${node.kind}:`;
+  return node.id.startsWith(prefix) ? node.id.slice(prefix.length) : node.label;
+}
+function dataNodeStatus(node) {
+  const name = dataName(node);
+  switch (node.kind) {
+    case "table":
+      return `Table ${name}`;
+    case "column":
+      return `Column ${name}`;
+    case "procedure":
+      return `Stored procedure ${name}`;
+    case "entity":
+      return `${name} fields`;
+  }
+  const entity = name.includes(".") ? name.slice(0, name.indexOf(".")) : node.group ?? "";
+  const { column, storage } = node.properties ?? {};
+  if (column) return `${entity} field → ${column}`;
+  if (storage) return `${entity} field, dynamic, stored in ${storage}`;
+  return `${entity} field`;
+}
+function dataNodeBacking(node) {
+  var _a;
+  const column = node.kind === "field" ? (_a = node.properties) == null ? void 0 : _a.column : void 0;
+  return column ? { id: `column:${column}`, label: column } : void 0;
+}
+function isBuiltin(node) {
+  return node.kind === "builtin";
+}
+function isPackageScope(node) {
+  return node.kind === "package";
+}
+function isExternal(node) {
+  return !node.location && !node.unresolved && !isBuiltin(node) && !isPackageScope(node) && !isDataNode(node);
+}
+function interfaceMethods(graph) {
+  const dispatched = new Set(
+    graph.edges.filter((edge) => edge.type === "dispatch").flatMap((edge) => edge.sites.map((site) => `${edge.from} ${siteKey(site)}`))
+  );
+  return new Set(
+    graph.edges.filter((edge) => edge.type === "call" && edge.sites.some((site) => dispatched.has(`${edge.from} ${siteKey(site)}`))).map((edge) => edge.to)
+  );
+}
+function uirGlyph(graph, node) {
+  var _a;
+  if (node.unresolved) return "unresolved";
+  if (isBuiltin(node)) return "builtin";
+  if (isPackageScope(node)) return "package";
+  if (isDataNode(node)) return node.kind;
+  if (callsItself(graph, node)) return "recursive";
+  if (isExternal(node) && node.kind === "func") return "external_func";
+  if (interfaceMethods(graph).has(node.id)) return "interface_method";
+  return ((_a = UIR_KINDS.get(node.kind)) == null ? void 0 : _a.glyph) ?? "symbol";
+}
+function uirKind(graph, node) {
+  var _a;
+  if (node.unresolved) return "unresolved call";
+  const kind = interfaceMethods(graph).has(node.id) ? "interface method" : ((_a = UIR_KINDS.get(node.kind)) == null ? void 0 : _a.words) ?? DATA_KIND_WORDS[node.kind] ?? node.kind.replaceAll("_", " ");
+  return [isExternal(node) ? "external" : "", callsItself(graph, node) ? "recursive" : "", kind].filter(Boolean).join(" ");
+}
+function uirStatus(node) {
+  if (node.unresolved) return "Unresolved: the index has no target for this call";
+  if (isBuiltin(node)) return "Builtin: no source";
+  if (isExternal(node)) return "External: declared outside the indexed snapshots";
+  if (node.location) return "Indexed";
+  return isDataNode(node) ? dataNodeStatus(node) : "Package scope: calls made outside any declaration";
+}
+const UIR_CALL_GRAPH_VOCABULARY = {
+  glyphs: [
+    { id: "func", name: "function", icon: UiFunction },
+    { id: "method", name: "method", icon: UiMethod },
+    { id: "interface_method", name: "interface method", icon: UiInterface },
+    { id: "recursive", name: "calls itself", icon: UiMethod11, darkIcon: UiMethod11Dark },
+    { id: "external_func", name: "external function", icon: UiFunction1, darkIcon: UiFunction1Dark },
+    { id: "builtin", name: "builtin", icon: UiFunctionSquare },
+    { id: "type", name: "type", icon: UiTypeParameter },
+    { id: "field", name: "field", icon: UiField },
+    { id: "var", name: "variable", icon: UiVariable },
+    { id: "const", name: "constant", icon: UiConstant },
+    { id: "package", name: "package scope", icon: UiPackage },
+    // uir's `field` is already a glyph of its own: a struct field is data too.
+    ...CALL_GRAPH_DATA_GLYPHS.filter((glyph) => glyph.id !== "field"),
+    { id: "unresolved", name: "unresolved call", icon: UiUnknown },
+    { id: "symbol", name: "other symbol", icon: UiSymbol, darkIcon: UiSymbolDark }
+  ],
+  glyphOf: uirGlyph,
+  kindOf: uirKind,
+  hasSource: (node) => Boolean(node.location),
+  canRoot: (node) => Boolean(node.location) || isDataNode(node),
+  isData: isDataNode,
+  muted: (node) => Boolean(node.unresolved) || isBuiltin(node) || isExternal(node),
+  status: uirStatus,
+  backing: dataNodeBacking,
+  group: { noun: "package", plural: "packages", icon: UiPackage, patternHint: "example.com/module/..." }
+};
+export {
+  CALL_GRAPH_DATA_GLYPHS,
+  DATA_KIND_WORDS,
+  UIR_CALL_GRAPH_VOCABULARY,
+  callsItself,
+  dataNodeBacking,
+  dataNodeStatus,
+  interfaceMethods,
+  isBuiltin,
+  isDataNode,
+  isExternal,
+  nodeTitle,
+  requireGlyph,
+  siteKey,
+  usedGlyphs
+};
+//# sourceMappingURL=call-graph-vocabulary.js.map

package/dist/data/call-graph/call-graph-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph-vocabulary.js","sources":["../../../src/data/call-graph/call-graph-vocabulary.ts"],"sourcesContent":["// What a node kind means and how it is drawn. A host whose source names its own kinds (OIPA's\n// transactions, copybooks and functions) passes its own vocabulary; the default is the one uir's\n// `graph.Build` reports without a Theme: uir node types, a builtin, a package scope and an index\n// location for every node with a source.\nimport {\n  UiConstant,\n  UiField,\n  UiFunction,\n  UiFunction1,\n  UiFunction1Dark,\n  UiFunctionSquare,\n  UiInterface,\n  UiMethod,\n  UiMethod11,\n  UiMethod11Dark,\n  UiPackage,\n  UiSqlColumn,\n  UiSqlStoredProc,\n  UiSqlTable,\n  UiSymbol,\n  UiSymbolDark,\n  UiTableProperties,\n  UiTypeParameter,\n  UiUnknown,\n  UiVariable,\n  type IconComponent,\n} from \"../../icons\";\nimport type { CallGraph, CallGraphNode } from \"./types\";\n\nexport interface CallGraphGlyph {\n  id: string;\n  /** The legend's name for it. */\n  name: string;\n  icon: IconComponent;\n  /** Drawn instead of `icon` in the dark theme, for coloured artwork. */\n  darkIcon?: IconComponent;\n}\n\nexport interface CallGraphVocabulary {\n  /** Every glyph the vocabulary draws, in legend order. */\n  glyphs: readonly CallGraphGlyph[];\n  /** The id of the one glyph a node shows. */\n  glyphOf(graph: CallGraph, node: CallGraphNode): string;\n  /** What the node is, in words: `method`, `external function`, `copybook`. */\n  kindOf(graph: CallGraph, node: CallGraphNode): string;\n  /** The node has a body the source walks: it can be expanded and opened. */\n  hasSource(node: CallGraphNode): boolean;\n  /** The graph can be drawn around the node: Focus is offered for it, with or without a source. */\n  canRoot(node: CallGraphNode): boolean;\n  /** A table, column, procedure, entity or field: its details count readers and writers. */\n  isData(node: CallGraphNode): boolean;\n  /** Drawn dimmed: the node leads nowhere further. */\n  muted(node: CallGraphNode): boolean;\n  /** The node's status line in its details. */\n  status(node: CallGraphNode): string;\n  /** The node a data node stands for, such as the column behind a field, offered as a Focus link. */\n  backing?(node: CallGraphNode): { id: string; label: string } | undefined;\n  /** What a group is, and the icon its box caption shows. */\n  group: { noun: string; plural: string; icon: IconComponent; patternHint: string };\n}\n\n/** The glyph with that id, failing on one the vocabulary does not list. */\nexport function requireGlyph(vocabulary: CallGraphVocabulary, id: string): CallGraphGlyph {\n  const glyph = vocabulary.glyphs.find((candidate) => candidate.id === id);\n  if (!glyph) throw new Error(`call graph: the vocabulary has no glyph \"${id}\"`);\n  return glyph;\n}\n\n/** The glyphs the graph's nodes use, once each, in legend order. */\nexport function usedGlyphs(graph: CallGraph, vocabulary: CallGraphVocabulary): CallGraphGlyph[] {\n  const used = new Set(graph.nodes.map((node) => vocabulary.glyphOf(graph, node)));\n  return vocabulary.glyphs.filter((glyph) => used.has(glyph.id));\n}\n\n/** The node's tooltip: its kind, its label and its group's full label. */\nexport function nodeTitle(graph: CallGraph, node: CallGraphNode, vocabulary: CallGraphVocabulary): string {\n  const group = graph.groups?.find((candidate) => candidate.id === node.group)?.label ?? node.group;\n  return `${vocabulary.kindOf(graph, node)} ${node.label}${group ? ` in ${group}` : \"\"}`;\n}\n\nexport function callsItself(graph: CallGraph, node: CallGraphNode): boolean {\n  return graph.edges.some((edge) => edge.from === node.id && edge.to === node.id);\n}\n\nexport function siteKey(site: { path?: string; line?: number; column?: number }): string {\n  return `${site.path}:${site.line}:${site.column}`;\n}\n\n// uir node types that have a glyph of their own, and the words for each.\nconst UIR_KINDS = new Map<string, { glyph: string; words: string }>([\n  [\"func\", { glyph: \"func\", words: \"function\" }],\n  [\"method\", { glyph: \"method\", words: \"method\" }],\n  [\"builtin\", { glyph: \"builtin\", words: \"builtin\" }],\n  [\"type\", { glyph: \"type\", words: \"type\" }],\n  [\"field\", { glyph: \"field\", words: \"field\" }],\n  [\"var\", { glyph: \"var\", words: \"variable\" }],\n  [\"const\", { glyph: \"const\", words: \"constant\" }],\n  [\"package\", { glyph: \"package\", words: \"package scope\" }],\n]);\n\n// Data access, as the graph's data model names it: `table:AsPolicy`, `column:AsPolicy.STATUSCODE`,\n// `procedure:Update_ClassGroup`, `entity:Policy` and `field:Policy.StatusCode`, a field carrying\n// `column` (its `x-oipa-column`) or `storage` (the table a dynamic field is kept in).\n\nexport const DATA_KIND_WORDS: Readonly<Record<string, string>> = {\n  table: \"table\",\n  column: \"column\",\n  procedure: \"stored procedure\",\n  entity: \"entity\",\n  field: \"field\",\n};\n\nexport const CALL_GRAPH_DATA_GLYPHS: readonly CallGraphGlyph[] = [\n  { id: \"table\", name: \"table\", icon: UiSqlTable },\n  { id: \"column\", name: \"column\", icon: UiSqlColumn },\n  { id: \"procedure\", name: \"stored procedure\", icon: UiSqlStoredProc },\n  { id: \"entity\", name: \"entity\", icon: UiTableProperties },\n  { id: \"field\", name: \"field\", icon: UiField },\n];\n\nexport function isDataNode(node: CallGraphNode): boolean {\n  return Object.hasOwn(DATA_KIND_WORDS, node.kind);\n}\n\n/** The data node's name: its id after `<kind>:`, else its label. */\nfunction dataName(node: CallGraphNode): string {\n  const prefix = `${node.kind}:`;\n  return node.id.startsWith(prefix) ? node.id.slice(prefix.length) : node.label;\n}\n\nexport function dataNodeStatus(node: CallGraphNode): string {\n  const name = dataName(node);\n  switch (node.kind) {\n    case \"table\": return `Table ${name}`;\n    case \"column\": return `Column ${name}`;\n    case \"procedure\": return `Stored procedure ${name}`;\n    case \"entity\": return `${name} fields`;\n  }\n  const entity = name.includes(\".\") ? name.slice(0, name.indexOf(\".\")) : (node.group ?? \"\");\n  const { column, storage } = node.properties ?? {};\n  if (column) return `${entity} field → ${column}`;\n  if (storage) return `${entity} field, dynamic, stored in ${storage}`;\n  return `${entity} field`;\n}\n\n/** The column behind a field, by its `column` property. */\nexport function dataNodeBacking(node: CallGraphNode): { id: string; label: string } | undefined {\n  const column = node.kind === \"field\" ? node.properties?.column : undefined;\n  return column ? { id: `column:${column}`, label: column } : undefined;\n}\n\nexport function isBuiltin(node: CallGraphNode): boolean {\n  return node.kind === \"builtin\";\n}\n\n/** The node standing for the calls a package makes outside any declaration. */\nfunction isPackageScope(node: CallGraphNode): boolean {\n  return node.kind === \"package\";\n}\n\n/** A symbol declared outside the indexed snapshots: it has no source, so it cannot be opened or expanded. */\nexport function isExternal(node: CallGraphNode): boolean {\n  return !node.location && !node.unresolved && !isBuiltin(node) && !isPackageScope(node) && !isDataNode(node);\n}\n\n/**\n * The index has no kind for an interface method: it is a `method`. It shows in the graph as the target\n * of a call whose site also carries a dispatch edge from the same caller, because the source adds that\n * dispatch edge to each implementation of the interface method called there.\n */\nexport function interfaceMethods(graph: CallGraph): Set<string> {\n  const dispatched = new Set(\n    graph.edges.filter((edge) => edge.type === \"dispatch\").flatMap((edge) => edge.sites.map((site) => `${edge.from} ${siteKey(site)}`)),\n  );\n  return new Set(\n    graph.edges\n      .filter((edge) => edge.type === \"call\" && edge.sites.some((site) => dispatched.has(`${edge.from} ${siteKey(site)}`)))\n      .map((edge) => edge.to),\n  );\n}\n\n/**\n * The one glyph a node shows. An unresolved call, a builtin and a package scope are what they are;\n * after those, a symbol that calls itself, an external function and an interface method outrank the\n * plain kind. An external method keeps the method glyph: its dimmed box already says it has no source.\n */\nfunction uirGlyph(graph: CallGraph, node: CallGraphNode): string {\n  if (node.unresolved) return \"unresolved\";\n  if (isBuiltin(node)) return \"builtin\";\n  if (isPackageScope(node)) return \"package\";\n  if (isDataNode(node)) return node.kind;\n  if (callsItself(graph, node)) return \"recursive\";\n  if (isExternal(node) && node.kind === \"func\") return \"external_func\";\n  if (interfaceMethods(graph).has(node.id)) return \"interface_method\";\n  return UIR_KINDS.get(node.kind)?.glyph ?? \"symbol\";\n}\n\nfunction uirKind(graph: CallGraph, node: CallGraphNode): string {\n  if (node.unresolved) return \"unresolved call\";\n  const kind = interfaceMethods(graph).has(node.id) ? \"interface method\" : (UIR_KINDS.get(node.kind)?.words ?? DATA_KIND_WORDS[node.kind] ?? node.kind.replaceAll(\"_\", \" \"));\n  return [isExternal(node) ? \"external\" : \"\", callsItself(graph, node) ? \"recursive\" : \"\", kind].filter(Boolean).join(\" \");\n}\n\nfunction uirStatus(node: CallGraphNode): string {\n  if (node.unresolved) return \"Unresolved: the index has no target for this call\";\n  if (isBuiltin(node)) return \"Builtin: no source\";\n  if (isExternal(node)) return \"External: declared outside the indexed snapshots\";\n  if (node.location) return \"Indexed\";\n  return isDataNode(node) ? dataNodeStatus(node) : \"Package scope: calls made outside any declaration\";\n}\n\nexport const UIR_CALL_GRAPH_VOCABULARY: CallGraphVocabulary = {\n  glyphs: [\n    { id: \"func\", name: \"function\", icon: UiFunction },\n    { id: \"method\", name: \"method\", icon: UiMethod },\n    { id: \"interface_method\", name: \"interface method\", icon: UiInterface },\n    { id: \"recursive\", name: \"calls itself\", icon: UiMethod11, darkIcon: UiMethod11Dark },\n    { id: \"external_func\", name: \"external function\", icon: UiFunction1, darkIcon: UiFunction1Dark },\n    { id: \"builtin\", name: \"builtin\", icon: UiFunctionSquare },\n    { id: \"type\", name: \"type\", icon: UiTypeParameter },\n    { id: \"field\", name: \"field\", icon: UiField },\n    { id: \"var\", name: \"variable\", icon: UiVariable },\n    { id: \"const\", name: \"constant\", icon: UiConstant },\n    { id: \"package\", name: \"package scope\", icon: UiPackage },\n    // uir's `field` is already a glyph of its own: a struct field is data too.\n    ...CALL_GRAPH_DATA_GLYPHS.filter((glyph) => glyph.id !== \"field\"),\n    { id: \"unresolved\", name: \"unresolved call\", icon: UiUnknown },\n    { id: \"symbol\", name: \"other symbol\", icon: UiSymbol, darkIcon: UiSymbolDark },\n  ],\n  glyphOf: uirGlyph,\n  kindOf: uirKind,\n  hasSource: (node) => Boolean(node.location),\n  canRoot: (node) => Boolean(node.location) || isDataNode(node),\n  isData: isDataNode,\n  muted: (node) => Boolean(node.unresolved) || isBuiltin(node) || isExternal(node),\n  status: uirStatus,\n  backing: dataNodeBacking,\n  group: { noun: \"package\", plural: \"packages\", icon: UiPackage, patternHint: \"example.com/module/...\" },\n};\n"],"names":[],"mappings":"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"}

package/dist/data/call-graph/call-graph.fixtures.d.ts

@@ -0,0 +1,63 @@
+import { CallGraphVocabulary } from './call-graph-vocabulary.js';
+import { CallGraph, CallGraphAccess, CallGraphGroupFact, CallGraphSite } from './types.js';
+/** A uir response: the graph plus the package facts and effective exclusions it reports. */
+export type GoGraph = CallGraph & {
+    exclude: string[];
+    packages: CallGraphGroupFact[];
+};
+export declare const GO_DEFAULT_EXCLUDE: string[];
+export declare const GO_ROOT: string;
+export declare const GO_EXPANDABLE: {
+    id: string;
+    type: string;
+    method: string;
+    path: string;
+    line: number;
+    depth: number;
+    in: number;
+    out: number;
+};
+export declare function goGraph(exclude?: string[]): GoGraph;
+/** One hop of callees around moduleScopes: rooted at it, so its depths count from it. */
+export declare function goModuleScopesExpansion(exclude?: string[]): GoGraph;
+export declare const OIPA_IDS: {
+    readonly transaction: "transaction:6A1F0C52-0000-4000-8000-000000000001";
+    readonly packet: "business-rule:6A1F0C52-0000-4000-8000-000000000002";
+    readonly premium: "business-rule:6A1F0C52-0000-4000-8000-000000000003";
+    readonly planCopybook: "business-rule:6A1F0C52-0000-4000-8000-000000000004";
+    readonly productCopybook: "business-rule:6A1F0C52-0000-4000-8000-000000000005";
+    readonly unresolved: "unresolved:function:LegacyRates";
+    readonly formatAmount: "business-rule:6A1F0C52-0000-4000-8000-000000000006";
+    readonly lookupRate: "business-rule:6A1F0C52-0000-4000-8000-000000000007";
+};
+/** A graph as oipa-cli serves it without guards: those are fetched for the selected edge only. */
+export declare function oipaGraph(): CallGraph;
+/** One hop of callees around the plan copybook. */
+export declare function oipaPlanCopybookExpansion(): CallGraph;
+/** How a host names OIPA's kinds: every resolved node has a body to walk, located or not. */
+export declare const OIPA_VOCABULARY: CallGraphVocabulary;
+export declare const DATA_IDS: {
+    readonly install: "transaction:6A1F0C52-0000-4000-8000-000000000001";
+    readonly packet: "business-rule:6A1F0C52-0000-4000-8000-000000000002";
+    readonly proc: "procedure:Update_ClassGroup";
+    readonly policyStatus: "field:Policy.PolicyStatus";
+    readonly planGuid: "column:AsPolicy.PLANGUID";
+    readonly statusCode: "column:AsPolicy.STATUSCODE";
+    readonly classGroupStatus: "column:AsClassGroup.STATUSCODE";
+    readonly schemeNumber: "field:Policy.SchemeNumber";
+    readonly activity: "table:AsActivity";
+    readonly client: "table:AsClient";
+};
+/** The AsClient columns one SQL math variable reads: more than an edge shows as chips at first. */
+export declare const DATA_CLIENT_COLUMNS: string[];
+/**
+ * SchemeInstall's data access as a host serves it: collapsed into tables and entities unless `columns`,
+ * and only the edge types `access` asks for. The totals count the edges the filter keeps.
+ */
+export declare function oipaDataGraph({ access, columns }: {
+    access: readonly CallGraphAccess[];
+    columns: boolean;
+}): CallGraph;
+/** The guards oipa-cli computes on request, per edge: one site is guarded by its packet `Rule IF=`. */
+export declare const OIPA_GUARDS: Record<string, CallGraphSite[]>;
+//# sourceMappingURL=call-graph.fixtures.d.ts.map

package/dist/data/call-graph/call-graph.fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph.fixtures.d.ts","sourceRoot":"","sources":["../../../src/data/call-graph/call-graph.fixtures.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAiB,kBAAkB,EAAiB,aAAa,EAAE,MAAM,SAAS,CAAC;AAqC3H,4FAA4F;AAC5F,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC;AAExF,eAAO,MAAM,kBAAkB,UAAoC,CAAC;AACpE,eAAO,MAAM,OAAO,QAAyB,CAAC;AAC9C,eAAO,MAAM,aAAa;;;;;;;;;CAA2B,CAAC;AAEtD,wBAAgB,OAAO,CAAC,OAAO,GAAE,MAAM,EAAuB,GAAG,OAAO,CAwBvE;AAED,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,MAAM,EAAuB,GAAG,OAAO,CAgBvF;AAiBD,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAKX,kGAAkG;AAClG,wBAAgB,SAAS,IAAI,SAAS,CAqBrC;AAED,mDAAmD;AACnD,wBAAgB,yBAAyB,IAAI,SAAS,CAerD;AAUD,6FAA6F;AAC7F,eAAO,MAAM,eAAe,EAAE,mBA0B7B,CAAC;AAIF,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWX,CAAC;AAEX,mGAAmG;AACnG,eAAO,MAAM,mBAAmB,UAAoI,CAAC;AA0CrK;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;IAAE,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAuBtH;AAED,uGAAuG;AACvG,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAEvD,CAAC"}

package/dist/data/call-graph/index.d.ts

@@ -0,0 +1,7 @@
+export { CallGraph, type CallGraphProps } from './CallGraph.js';
+export { CALL_GRAPH_ACCESS } from './types.js';
+export type { CallGraph as CallGraphData, CallGraphAccess, CallGraphDirection, CallGraphEdge, CallGraphEdgeLabels, CallGraphEdgeType, CallGraphFetchParams, CallGraphGroup, CallGraphGroupFact, CallGraphIdentifier, CallGraphLocation, CallGraphNode, CallGraphOmitted, CallGraphSelection, CallGraphSite, } from './types.js';
+export { CALL_GRAPH_DATA_GLYPHS, callsItself, DATA_KIND_WORDS as CALL_GRAPH_DATA_KIND_WORDS, dataNodeBacking, dataNodeStatus, interfaceMethods, isDataNode, UIR_CALL_GRAPH_VOCABULARY, type CallGraphGlyph, type CallGraphVocabulary, } from './call-graph-vocabulary.js';
+export { callGraphGroupFacts, EXCLUDE_EXTERNAL as CALL_GRAPH_EXCLUDE_EXTERNAL, formatExclude as formatCallGraphExclude, matchesExclude as matchesCallGraphExclude, parseExclude as parseCallGraphExclude, type ExcludeMatcher as CallGraphExcludeMatcher, } from './call-graph-exclude.js';
+export { CALL_GRAPH_DEFAULT_DEPTH, CALL_GRAPH_MAX_DEPTH, mergeGraph as mergeCallGraph, toggleAccess as toggleCallGraphAccess, } from './call-graph-model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/data/call-graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/call-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EACV,SAAS,IAAI,aAAa,EAC1B,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,eAAe,IAAI,0BAA0B,EAC7C,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,IAAI,2BAA2B,EAC/C,aAAa,IAAI,sBAAsB,EACvC,cAAc,IAAI,uBAAuB,EACzC,YAAY,IAAI,qBAAqB,EACrC,KAAK,cAAc,IAAI,uBAAuB,GAC/C,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,UAAU,IAAI,cAAc,EAC5B,YAAY,IAAI,qBAAqB,GACtC,MAAM,oBAAoB,CAAC"}

package/dist/data/call-graph/types.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const CALL_GRAPH_ACCESS = ["call", "read", "write"];
+exports.CALL_GRAPH_ACCESS = CALL_GRAPH_ACCESS;
+//# sourceMappingURL=types.cjs.map

package/dist/data/call-graph/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sources":["../../../src/data/call-graph/types.ts"],"sourcesContent":["// The call graph as uir's `graph.Graph` serialises it (github.com/flanksource/uir/graph, model.go). The\n// field names are its JSON tags, so a host hands a response straight in. Nothing here is specific to a\n// language: what a node kind means and how it is drawn comes from a CallGraphVocabulary.\n\n/** Which side of the root a graph walks. */\nexport type CallGraphDirection = \"callees\" | \"callers\" | \"both\";\n\n/** A call site behind an edge. `guards` are the conditions that must hold to reach it, outermost first. */\nexport interface CallGraphSite {\n  path?: string;\n  line?: number;\n  column?: number;\n  /** The call as written. */\n  text?: string;\n  guards?: string[];\n}\n\n/** uir.Identifier: where a node sits in a module, package, type and method. */\nexport interface CallGraphIdentifier {\n  id?: string;\n  module?: string;\n  package?: string;\n  type?: string;\n  method?: string;\n  field?: string;\n  signature?: string;\n  node_type?: string;\n}\n\n/** Where a node is declared, in the terms an index addresses it by. */\nexport interface CallGraphLocation {\n  root_key?: string;\n  checkout_path?: string;\n  snapshot_id?: string;\n  source_id?: string;\n  path?: string;\n  identity_key?: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface CallGraphNode {\n  id: string;\n  identifier: CallGraphIdentifier;\n  kind: string;\n  label: string;\n  /** A `CallGraphGroup` id. */\n  group?: string;\n  /** 0 for a root, negative for its callers and positive for its callees. */\n  depth: number;\n  /** Incoming edges: a total on the side the walk asked about, else the edges drawn. */\n  in: number;\n  /** Outgoing edges: a total on the side the walk asked about, else the edges drawn. */\n  out: number;\n  /** A target the source could not place; drawn as a leaf. */\n  unresolved?: boolean;\n  location?: CallGraphLocation;\n  tone?: string;\n  icon?: string;\n  properties?: Record<string, string>;\n}\n\n/** A call, a call one of several targets is chosen for at run time, or a read or write of data. */\nexport type CallGraphEdgeType = \"call\" | \"dispatch\" | \"read\" | \"write\";\n\n/** What `fetchGraph` asks the graph to follow: `call` covers dispatch too. */\nexport type CallGraphAccess = \"call\" | \"read\" | \"write\";\n\nexport const CALL_GRAPH_ACCESS: readonly CallGraphAccess[] = [\"call\", \"read\", \"write\"];\n\nexport interface CallGraphEdge {\n  /** `from|to|type`. */\n  id: string;\n  from: string;\n  to: string;\n  type: CallGraphEdgeType;\n  /** The construct behind the edge, such as `copybook`, `attached`, `sql` or `copyto`. */\n  kind?: string;\n  sites: CallGraphSite[];\n  /**\n   * Facts about the edge, such as the plans that select a dispatch target, or `columns`/`fields`: the\n   * members a read or write of a collapsed table or entity touches, comma separated.\n   */\n  properties?: Record<string, string>;\n}\n\nexport interface CallGraphGroup {\n  id: string;\n  label: string;\n  parent?: string;\n}\n\n/** What the graph leaves out. */\nexport interface CallGraphOmitted {\n  node_limit?: boolean;\n  beyond_depth?: number;\n  unresolved?: number;\n  unreadable_source?: string[];\n  /** Distinct nodes the exclusions left out, per group. */\n  excluded?: Record<string, number>;\n}\n\nexport interface CallGraph {\n  roots: string[];\n  nodes: CallGraphNode[];\n  edges: CallGraphEdge[];\n  groups?: CallGraphGroup[];\n  omitted: CallGraphOmitted;\n}\n\n/** What `fetchGraph` is asked for. `exclude` undefined takes the host's defaults; `[]` excludes nothing. */\nexport interface CallGraphFetchParams {\n  root: string;\n  direction: CallGraphDirection;\n  depth: number;\n  exclude: string[] | undefined;\n  /** The edge types to follow, never empty. Filtered by the host, so the `+N` counts agree. */\n  access: CallGraphAccess[];\n  /** Columns and fields as nodes of their own, rather than collapsed into their table or entity. */\n  columns: boolean;\n  /** `load` draws the graph around `root`; `expand` loads one more hop around a drawn node, to merge in. */\n  purpose: \"load\" | \"expand\";\n  signal: AbortSignal;\n}\n\n/** A group the graph reached, drawn or excluded; `nodes` counts both. */\nexport interface CallGraphGroupFact {\n  name: string;\n  /** Shown instead of `name`. */\n  label?: string;\n  /** Outside the indexed scope: \"Hide all external\" covers it. */\n  external?: boolean;\n  nodes: number;\n  excluded: boolean;\n}\n\nexport interface CallGraphSelection {\n  kind: \"node\" | \"edge\";\n  id: string;\n}\n\n/** The guards fetched for a selected edge whose response came without them. */\nexport type SiteGuardsState = { status: \"loading\" } | { status: \"loaded\"; sites: CallGraphSite[] } | { status: \"failed\"; error: string };\n\n/** The words an edge's type is drawn with: its pill's accessible name, its tooltip and its legend entry. */\nexport type CallGraphEdgeLabels = Record<CallGraphEdgeType, string>;\n"],"names":[],"mappings":";;AAoEO,MAAM,oBAAgD,CAAC,QAAQ,QAAQ,OAAO;;"}

package/dist/data/call-graph/types.d.ts

@@ -0,0 +1,135 @@
+/** Which side of the root a graph walks. */
+export type CallGraphDirection = "callees" | "callers" | "both";
+/** A call site behind an edge. `guards` are the conditions that must hold to reach it, outermost first. */
+export interface CallGraphSite {
+    path?: string;
+    line?: number;
+    column?: number;
+    /** The call as written. */
+    text?: string;
+    guards?: string[];
+}
+/** uir.Identifier: where a node sits in a module, package, type and method. */
+export interface CallGraphIdentifier {
+    id?: string;
+    module?: string;
+    package?: string;
+    type?: string;
+    method?: string;
+    field?: string;
+    signature?: string;
+    node_type?: string;
+}
+/** Where a node is declared, in the terms an index addresses it by. */
+export interface CallGraphLocation {
+    root_key?: string;
+    checkout_path?: string;
+    snapshot_id?: string;
+    source_id?: string;
+    path?: string;
+    identity_key?: string;
+    line?: number;
+    column?: number;
+}
+export interface CallGraphNode {
+    id: string;
+    identifier: CallGraphIdentifier;
+    kind: string;
+    label: string;
+    /** A `CallGraphGroup` id. */
+    group?: string;
+    /** 0 for a root, negative for its callers and positive for its callees. */
+    depth: number;
+    /** Incoming edges: a total on the side the walk asked about, else the edges drawn. */
+    in: number;
+    /** Outgoing edges: a total on the side the walk asked about, else the edges drawn. */
+    out: number;
+    /** A target the source could not place; drawn as a leaf. */
+    unresolved?: boolean;
+    location?: CallGraphLocation;
+    tone?: string;
+    icon?: string;
+    properties?: Record<string, string>;
+}
+/** A call, a call one of several targets is chosen for at run time, or a read or write of data. */
+export type CallGraphEdgeType = "call" | "dispatch" | "read" | "write";
+/** What `fetchGraph` asks the graph to follow: `call` covers dispatch too. */
+export type CallGraphAccess = "call" | "read" | "write";
+export declare const CALL_GRAPH_ACCESS: readonly CallGraphAccess[];
+export interface CallGraphEdge {
+    /** `from|to|type`. */
+    id: string;
+    from: string;
+    to: string;
+    type: CallGraphEdgeType;
+    /** The construct behind the edge, such as `copybook`, `attached`, `sql` or `copyto`. */
+    kind?: string;
+    sites: CallGraphSite[];
+    /**
+     * Facts about the edge, such as the plans that select a dispatch target, or `columns`/`fields`: the
+     * members a read or write of a collapsed table or entity touches, comma separated.
+     */
+    properties?: Record<string, string>;
+}
+export interface CallGraphGroup {
+    id: string;
+    label: string;
+    parent?: string;
+}
+/** What the graph leaves out. */
+export interface CallGraphOmitted {
+    node_limit?: boolean;
+    beyond_depth?: number;
+    unresolved?: number;
+    unreadable_source?: string[];
+    /** Distinct nodes the exclusions left out, per group. */
+    excluded?: Record<string, number>;
+}
+export interface CallGraph {
+    roots: string[];
+    nodes: CallGraphNode[];
+    edges: CallGraphEdge[];
+    groups?: CallGraphGroup[];
+    omitted: CallGraphOmitted;
+}
+/** What `fetchGraph` is asked for. `exclude` undefined takes the host's defaults; `[]` excludes nothing. */
+export interface CallGraphFetchParams {
+    root: string;
+    direction: CallGraphDirection;
+    depth: number;
+    exclude: string[] | undefined;
+    /** The edge types to follow, never empty. Filtered by the host, so the `+N` counts agree. */
+    access: CallGraphAccess[];
+    /** Columns and fields as nodes of their own, rather than collapsed into their table or entity. */
+    columns: boolean;
+    /** `load` draws the graph around `root`; `expand` loads one more hop around a drawn node, to merge in. */
+    purpose: "load" | "expand";
+    signal: AbortSignal;
+}
+/** A group the graph reached, drawn or excluded; `nodes` counts both. */
+export interface CallGraphGroupFact {
+    name: string;
+    /** Shown instead of `name`. */
+    label?: string;
+    /** Outside the indexed scope: "Hide all external" covers it. */
+    external?: boolean;
+    nodes: number;
+    excluded: boolean;
+}
+export interface CallGraphSelection {
+    kind: "node" | "edge";
+    id: string;
+}
+/** The guards fetched for a selected edge whose response came without them. */
+export type SiteGuardsState = {
+    status: "loading";
+} | {
+    status: "loaded";
+    sites: CallGraphSite[];
+} | {
+    status: "failed";
+    error: string;
+};
+/** The words an edge's type is drawn with: its pill's accessible name, its tooltip and its legend entry. */
+export type CallGraphEdgeLabels = Record<CallGraphEdgeType, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/data/call-graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/data/call-graph/types.ts"],"names":[],"mappings":"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"}

package/dist/data/call-graph/types.js

@@ -0,0 +1,5 @@
+const CALL_GRAPH_ACCESS = ["call", "read", "write"];
+export {
+  CALL_GRAPH_ACCESS
+};
+//# sourceMappingURL=types.js.map

package/dist/data/call-graph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../src/data/call-graph/types.ts"],"sourcesContent":["// The call graph as uir's `graph.Graph` serialises it (github.com/flanksource/uir/graph, model.go). The\n// field names are its JSON tags, so a host hands a response straight in. Nothing here is specific to a\n// language: what a node kind means and how it is drawn comes from a CallGraphVocabulary.\n\n/** Which side of the root a graph walks. */\nexport type CallGraphDirection = \"callees\" | \"callers\" | \"both\";\n\n/** A call site behind an edge. `guards` are the conditions that must hold to reach it, outermost first. */\nexport interface CallGraphSite {\n  path?: string;\n  line?: number;\n  column?: number;\n  /** The call as written. */\n  text?: string;\n  guards?: string[];\n}\n\n/** uir.Identifier: where a node sits in a module, package, type and method. */\nexport interface CallGraphIdentifier {\n  id?: string;\n  module?: string;\n  package?: string;\n  type?: string;\n  method?: string;\n  field?: string;\n  signature?: string;\n  node_type?: string;\n}\n\n/** Where a node is declared, in the terms an index addresses it by. */\nexport interface CallGraphLocation {\n  root_key?: string;\n  checkout_path?: string;\n  snapshot_id?: string;\n  source_id?: string;\n  path?: string;\n  identity_key?: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface CallGraphNode {\n  id: string;\n  identifier: CallGraphIdentifier;\n  kind: string;\n  label: string;\n  /** A `CallGraphGroup` id. */\n  group?: string;\n  /** 0 for a root, negative for its callers and positive for its callees. */\n  depth: number;\n  /** Incoming edges: a total on the side the walk asked about, else the edges drawn. */\n  in: number;\n  /** Outgoing edges: a total on the side the walk asked about, else the edges drawn. */\n  out: number;\n  /** A target the source could not place; drawn as a leaf. */\n  unresolved?: boolean;\n  location?: CallGraphLocation;\n  tone?: string;\n  icon?: string;\n  properties?: Record<string, string>;\n}\n\n/** A call, a call one of several targets is chosen for at run time, or a read or write of data. */\nexport type CallGraphEdgeType = \"call\" | \"dispatch\" | \"read\" | \"write\";\n\n/** What `fetchGraph` asks the graph to follow: `call` covers dispatch too. */\nexport type CallGraphAccess = \"call\" | \"read\" | \"write\";\n\nexport const CALL_GRAPH_ACCESS: readonly CallGraphAccess[] = [\"call\", \"read\", \"write\"];\n\nexport interface CallGraphEdge {\n  /** `from|to|type`. */\n  id: string;\n  from: string;\n  to: string;\n  type: CallGraphEdgeType;\n  /** The construct behind the edge, such as `copybook`, `attached`, `sql` or `copyto`. */\n  kind?: string;\n  sites: CallGraphSite[];\n  /**\n   * Facts about the edge, such as the plans that select a dispatch target, or `columns`/`fields`: the\n   * members a read or write of a collapsed table or entity touches, comma separated.\n   */\n  properties?: Record<string, string>;\n}\n\nexport interface CallGraphGroup {\n  id: string;\n  label: string;\n  parent?: string;\n}\n\n/** What the graph leaves out. */\nexport interface CallGraphOmitted {\n  node_limit?: boolean;\n  beyond_depth?: number;\n  unresolved?: number;\n  unreadable_source?: string[];\n  /** Distinct nodes the exclusions left out, per group. */\n  excluded?: Record<string, number>;\n}\n\nexport interface CallGraph {\n  roots: string[];\n  nodes: CallGraphNode[];\n  edges: CallGraphEdge[];\n  groups?: CallGraphGroup[];\n  omitted: CallGraphOmitted;\n}\n\n/** What `fetchGraph` is asked for. `exclude` undefined takes the host's defaults; `[]` excludes nothing. */\nexport interface CallGraphFetchParams {\n  root: string;\n  direction: CallGraphDirection;\n  depth: number;\n  exclude: string[] | undefined;\n  /** The edge types to follow, never empty. Filtered by the host, so the `+N` counts agree. */\n  access: CallGraphAccess[];\n  /** Columns and fields as nodes of their own, rather than collapsed into their table or entity. */\n  columns: boolean;\n  /** `load` draws the graph around `root`; `expand` loads one more hop around a drawn node, to merge in. */\n  purpose: \"load\" | \"expand\";\n  signal: AbortSignal;\n}\n\n/** A group the graph reached, drawn or excluded; `nodes` counts both. */\nexport interface CallGraphGroupFact {\n  name: string;\n  /** Shown instead of `name`. */\n  label?: string;\n  /** Outside the indexed scope: \"Hide all external\" covers it. */\n  external?: boolean;\n  nodes: number;\n  excluded: boolean;\n}\n\nexport interface CallGraphSelection {\n  kind: \"node\" | \"edge\";\n  id: string;\n}\n\n/** The guards fetched for a selected edge whose response came without them. */\nexport type SiteGuardsState = { status: \"loading\" } | { status: \"loaded\"; sites: CallGraphSite[] } | { status: \"failed\"; error: string };\n\n/** The words an edge's type is drawn with: its pill's accessible name, its tooltip and its legend entry. */\nexport type CallGraphEdgeLabels = Record<CallGraphEdgeType, string>;\n"],"names":[],"mappings":"AAoEO,MAAM,oBAAgD,CAAC,QAAQ,QAAQ,OAAO;"}