@pipelex/mthds-ui 0.13.0 → 0.15.0

package/dist/static-graph/index.d.ts

@@ -1,4 +1,5 @@
-import { C as ConceptInfo, P as PipeBlueprintUnion, G as GraphSpec, V as ValidationIssue } from '../types-Cm4147S5.js';
+import { C as ConceptInfo, P as PipeBlueprintUnion, G as GraphSpec, V as ValidationIssue } from '../types-DFIZ_rx6.js';
+export { P as ParsedPipeRef, m as makePipeRef, p as parsePipeRef } from '../pipeRefs-BQJO5nh5.js';
 
 type DiagnosticSeverity = "error" | "warning";
 type DiagnosticCode = "toml-parse-error" | "missing-domain" | "invalid-bundle-shape" | "invalid-concept-entry" | "invalid-pipe-entry" | "unknown-pipe-type" | "invalid-concept-ref" | "missing-pipe-output" | "invalid-sub-pipe" | "incomplete-batch-spec" | "duplicate-concept" | "duplicate-pipe" | "unresolved-pipe-ref" | "cyclic-pipe-ref" | "missing-main-pipe" | "no-entry-pipe" | "conflicting-input-concept";
@@ -13,6 +14,19 @@ interface Diagnostic {
     message: string;
     /** TOML-style locator for the offending entry, e.g. `pipe.analyze_candidate.output`. */
     path?: string;
+    /**
+     * Domain of the bundle namespace the diagnostic belongs to — the declaring-file
+     * identity a host needs to qualify a `pipe.<code>` locator into a full pipe ref
+     * (`domain_code.pipe_code`). Stamped wherever the owning namespace is known:
+     * per-file diagnostics get their bundle's domain ({@link UNKNOWN_DOMAIN} when
+     * the bundle declares none), merge/walk diagnostics the namespace being
+     * processed, and entry selection stamps the diagnostics it can attribute (a
+     * missing or unresolvable `main_pipe` names its declaring domain). Absent only
+     * when no owning bundle can be resolved: unparseable TOML, or entry selection
+     * with no resolvable owner (no bundles, no pipes anywhere, or a host-supplied
+     * entry ref that matches nothing).
+     */
+    domain_code?: string;
 }
 /**
  * One `.mthds` file, parsed and normalized. Pipes are narrowed to the same
@@ -112,6 +126,9 @@ declare function buildStaticGraphSpecFromToml(tomlTexts: string | string[], opti
  * so a host can feed them straight into `GraphViewer`'s `validationIssues`.
  * The TOML-style `path` becomes the locator chip; `origin: "static"` lets the
  * panel (and the host's issue policy) distinguish them from validator verdicts.
+ * When the path identifies a pipe declaration or a precise invocation, the
+ * targeting fields (`pipeRef` / `nodeId`) are filled so the viewer can
+ * decorate the affected graph nodes.
  */
 declare function staticDiagnosticsToValidationIssues(diagnostics: Diagnostic[]): ValidationIssue[];
 

package/dist/static-graph/index.js

@@ -1,6 +1,8 @@
 import {
-  KNOWN_PIPE_TYPES
-} from "../chunk-IMQ7MVYL.js";
+  KNOWN_PIPE_TYPES,
+  makePipeRef,
+  parsePipeRef
+} from "../chunk-YC7TW3BW.js";
 import {
   __spreadProps,
   __spreadValues
@@ -559,7 +561,7 @@ function emptyBundle() {
   };
 }
 function parseMthdsBundle(tomlText) {
-  var _a;
+  var _a, _b;
   const diagnostics = [];
   let root;
   try {
@@ -613,6 +615,9 @@ function parseMthdsBundle(tomlText) {
       }
     }
   }
+  for (const diagnostic of diagnostics) {
+    (_b = diagnostic.domain_code) != null ? _b : diagnostic.domain_code = domain;
+  }
   return { bundle, diagnostics };
 }
 
@@ -651,7 +656,8 @@ function mergeBundles(bundles) {
           severity: "warning",
           code: "duplicate-concept",
           message: `concept "${domain}.${code}" declared more than once \u2014 keeping the first declaration`,
-          path: `concept.${code}`
+          path: `concept.${code}`,
+          domain_code: domain
         });
         continue;
       }
@@ -663,7 +669,8 @@ function mergeBundles(bundles) {
           severity: "warning",
           code: "duplicate-pipe",
           message: `pipe "${domain}.${code}" declared more than once \u2014 keeping the first declaration`,
-          path: `pipe.${code}`
+          path: `pipe.${code}`,
+          domain_code: domain
         });
         continue;
       }
@@ -806,13 +813,17 @@ function pickEntryPipe(set, explicitRef, diagnostics) {
     diagnostics.push({
       severity: "warning",
       code: "unresolved-pipe-ref",
-      message: `main_pipe "${set.mainPipe}" not found \u2014 falling back to a root heuristic`
+      message: `main_pipe "${set.mainPipe}" not found \u2014 falling back to a root heuristic`,
+      // The owning bundle is known (the namespace that declares this main_pipe),
+      // so stamp it — this is not an ownerless diagnostic.
+      domain_code: fallbackDomain
     });
   } else {
     diagnostics.push({
       severity: "warning",
       code: "missing-main-pipe",
-      message: "no main_pipe declared \u2014 falling back to a root heuristic"
+      message: "no main_pipe declared \u2014 falling back to a root heuristic",
+      domain_code: fallbackDomain
     });
   }
   const domainWithPipes = [fallbackDomain, ...domainsInOrder].find(
@@ -894,7 +905,8 @@ function bindInputs(ctx, blueprint, scope) {
           severity: "warning",
           code: "conflicting-input-concept",
           message: `pipe "${blueprint.code}": dangling input "${name}" is declared as ${conceptKey(spec.concept)} here but was first seen as ${conceptKey(bound.concept)} \u2014 keeping the first`,
-          path: `pipe.${blueprint.code}.inputs.${name}`
+          path: `pipe.${blueprint.code}.inputs.${name}`,
+          domain_code: blueprint.domain_code
         });
       }
     }
@@ -934,7 +946,10 @@ function walkPipe(ctx, ref, currentDomain, nodeId, parentId, scope, inv) {
       severity: "warning",
       code: "unresolved-pipe-ref",
       message: `pipe ref "${ref}" cannot be resolved \u2014 node skipped`,
-      path: nodeId
+      path: nodeId,
+      // The uttering file's domain: a bare ref belongs to the namespace that
+      // wrote it, mirroring the runtime's `_qualify_pipe_ref` inference.
+      domain_code: currentDomain
     });
     return null;
   }
@@ -960,7 +975,8 @@ function walkPipe(ctx, ref, currentDomain, nodeId, parentId, scope, inv) {
       severity: "warning",
       code: "cyclic-pipe-ref",
       message: `pipe "${qualified}" is invoked recursively \u2014 rendered as a leaf`,
-      path: nodeId
+      path: nodeId,
+      domain_code: domain
     });
     return finishLeaf(ctx, node, blueprint, nodeId, inv);
   }
@@ -1256,13 +1272,22 @@ function walkInlineBatch(ctx, sub, domain, nodeId, parentId, scope) {
 }
 
 // src/static-graph/validationIssues.ts
+function targetFromPath(path, domainCode) {
+  if (!path) return {};
+  if (path.includes("/")) return { nodeId: path };
+  if (path.startsWith("pipe.")) {
+    const code = path.split(".")[1];
+    if (code && domainCode) return { pipeRef: makePipeRef(domainCode, code) };
+  }
+  return {};
+}
 function staticDiagnosticsToValidationIssues(diagnostics) {
-  return diagnostics.map((diagnostic) => ({
+  return diagnostics.map((diagnostic) => __spreadValues({
     severity: diagnostic.severity,
     message: diagnostic.message,
     context: diagnostic.path,
     origin: "static"
-  }));
+  }, targetFromPath(diagnostic.path, diagnostic.domain_code)));
 }
 export {
   NATIVE_CONCEPT_CODES,
@@ -1270,9 +1295,11 @@ export {
   UNKNOWN_DOMAIN,
   buildStaticGraphSpec,
   buildStaticGraphSpecFromToml,
+  makePipeRef,
   mergeBundles,
   parseConceptRef,
   parseMthdsBundle,
+  parsePipeRef,
   staticDiagnosticsToValidationIssues
 };
 //# sourceMappingURL=index.js.map