@graphrefly/graphrefly 0.31.0 → 0.32.0

package/dist/{index-CwhcFzTA.d.ts → index-gXTVbSax.d.ts}

@@ -1,7 +1,7 @@
 import { a as Node } from './node-BVV7G1bq.js';
 import { R as ReactiveMapBundle } from './reactive-map-CtRaCddO.js';
-import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-CWeI0aHd.js';
-import { w as watchTopologyTree } from './topology-tree-CkjojcB6.js';
+import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-BOhEGJ6E.js';
+import { w as watchTopologyTree } from './topology-tree-DAbCV2Yw.js';
 
 /** Aggregate topology stats emitted by {@link LensGraph.stats}. */
 interface TopologyStats {

package/dist/{index-D-kHVedZ.d.cts → index-j33Lfb1G.d.cts}

@@ -1,5 +1,5 @@
 import { a as Node } from './node-BVV7G1bq.cjs';
-import { G as Graph } from './graph-C4Uxwv0T.cjs';
+import { G as Graph } from './graph-CdJeX7O7.cjs';
 import { L as LLMAdapter } from './types-BgMqbc7N.cjs';
 
 /**
@@ -163,6 +163,14 @@ declare function validateSpecAgainstCatalog(spec: GraphSpec, catalog: GraphSpecC
 type GraphSpecValidation = {
     valid: boolean;
     errors: string[];
+    /**
+     * Non-fatal advisories. Currently includes feedback edges whose `from`
+     * refers to an `effect` node (effects produce no DATA — the feedback
+     * counter will never advance). Always present (empty array when nothing
+     * is flagged) — symmetry with `errors` so callers can read
+     * `result.warnings.length` without a null check.
+     */
+    warnings: string[];
 };
 /**
  * Validate a GraphSpec JSON object.
@@ -175,6 +183,19 @@ declare function validateSpec(spec: unknown): GraphSpecValidation;
 type CompileSpecOptions = {
     /** Fn/source catalog for resolving named factories. */
     catalog?: GraphSpecCatalog;
+    /**
+     * How to handle nodes whose `fn` / `source` is missing from the catalog.
+     * - `"placeholder"` (default): silently substitute identity passthroughs
+     *   (`producer(() => {})` / `derived(deps, vals => vals[0])`). Backward-
+     *   compatible — preserves the historical "soft compile" behavior.
+     * - `"warn"`: substitute placeholders AND log each missing entry via
+     *   `console.warn`, or via the `onWarn` callback if supplied.
+     * - `"error"`: collect every missing entry across the whole spec, then
+     *   throw an `Error` listing them all (no partial graph returned).
+     */
+    onMissing?: "error" | "warn" | "placeholder";
+    /** Custom warning sink. Used only when `onMissing === "warn"`. Defaults to `console.warn`. */
+    onWarn?: (message: string) => void;
 };
 /**
  * Instantiate a Graph from a GraphSpec.

package/dist/{index-BEpRsvhg.d.ts → index-lpGUhTBn.d.ts}

@@ -1,7 +1,7 @@
 import { P as PolicyRuleData, a as Node, A as Actor } from './node-BVV7G1bq.js';
-import { G as Graph, a as GraphOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, D as DescribeFilter } from './graph-CWeI0aHd.js';
-import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-BBINVimG.js';
-import { T as TopicGraph } from './index-CvS9IuTG.js';
+import { G as Graph, a as GraphOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, D as DescribeFilter } from './graph-BOhEGJ6E.js';
+import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-BUZPTPSQ.js';
+import { T as TopicGraph } from './index-Dbmj0iYR.js';
 
 /**
  * Composable safety layer (roadmap §9.0b).

package/dist/{index-CcS0t-l2.d.ts → index-zMQIQuDu.d.ts}

@@ -1,5 +1,5 @@
 import { a as Node } from './node-BVV7G1bq.js';
-import { G as Graph } from './graph-CWeI0aHd.js';
+import { G as Graph } from './graph-BOhEGJ6E.js';
 import { L as LLMAdapter } from './types-CdfO2QTt.js';
 
 /**
@@ -163,6 +163,14 @@ declare function validateSpecAgainstCatalog(spec: GraphSpec, catalog: GraphSpecC
 type GraphSpecValidation = {
     valid: boolean;
     errors: string[];
+    /**
+     * Non-fatal advisories. Currently includes feedback edges whose `from`
+     * refers to an `effect` node (effects produce no DATA — the feedback
+     * counter will never advance). Always present (empty array when nothing
+     * is flagged) — symmetry with `errors` so callers can read
+     * `result.warnings.length` without a null check.
+     */
+    warnings: string[];
 };
 /**
  * Validate a GraphSpec JSON object.
@@ -175,6 +183,19 @@ declare function validateSpec(spec: unknown): GraphSpecValidation;
 type CompileSpecOptions = {
     /** Fn/source catalog for resolving named factories. */
     catalog?: GraphSpecCatalog;
+    /**
+     * How to handle nodes whose `fn` / `source` is missing from the catalog.
+     * - `"placeholder"` (default): silently substitute identity passthroughs
+     *   (`producer(() => {})` / `derived(deps, vals => vals[0])`). Backward-
+     *   compatible — preserves the historical "soft compile" behavior.
+     * - `"warn"`: substitute placeholders AND log each missing entry via
+     *   `console.warn`, or via the `onWarn` callback if supplied.
+     * - `"error"`: collect every missing entry across the whole spec, then
+     *   throw an `Error` listing them all (no partial graph returned).
+     */
+    onMissing?: "error" | "warn" | "placeholder";
+    /** Custom warning sink. Used only when `onMissing === "warn"`. Defaults to `console.warn`. */
+    onWarn?: (message: string) => void;
 };
 /**
  * Instantiate a Graph from a GraphSpec.