@graphrefly/graphrefly 0.30.0 → 0.32.0

package/dist/{index-ClB7TCfL.d.cts → index-DlGaEBW5.d.cts}

@@ -1,5 +1,5 @@
-import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-B8Aj_z8S.cjs';
-import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-C4Uxwv0T.cjs';
+import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-j33Lfb1G.cjs';
+import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-CdJeX7O7.cjs';
 import { StorageTier } from './extra/storage-core.cjs';
 
 /**

package/dist/{index-CotRMjtJ.d.ts → index-Dp_pS7Bw.d.ts}

@@ -1,5 +1,5 @@
 import { a as Node, N as NodeOptions } from './node-BVV7G1bq.js';
-import { a as GraphOptions, G as Graph } from './graph-CWeI0aHd.js';
+import { a as GraphOptions, G as Graph } from './graph-BOhEGJ6E.js';
 
 /**
  * Reduction primitives (roadmap §8.1).

package/dist/{index-Cc8VQIgL.d.ts → index-Dxk-pUQI.d.ts}

@@ -1,5 +1,5 @@
-import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-BXbQUn4n.js';
-import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-CWeI0aHd.js';
+import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-zMQIQuDu.js';
+import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-BOhEGJ6E.js';
 import { StorageTier } from './extra/storage-core.js';
 
 /**

package/dist/{index-DBQUKh59.d.cts → index-EGjF6iSY.d.cts}

@@ -1,7 +1,7 @@
 import { P as PolicyRuleData, a as Node, A as Actor } from './node-BVV7G1bq.cjs';
-import { G as Graph, a as GraphOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, D as DescribeFilter } from './graph-C4Uxwv0T.cjs';
-import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-iBp74eGU.cjs';
-import { T as TopicGraph } from './index-B-z8WaSd.cjs';
+import { G as Graph, a as GraphOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, D as DescribeFilter } from './graph-CdJeX7O7.cjs';
+import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-BJDXj9Wf.cjs';
+import { T as TopicGraph } from './index-BDLy6CQ9.cjs';
 
 /**
  * Composable safety layer (roadmap §9.0b).

package/dist/{index-D9HrBx2J.d.ts → index-LGzAYqdR.d.ts}

@@ -1,5 +1,5 @@
 import { a as Node } from './node-BVV7G1bq.js';
-import { a as GraphOptions, G as Graph } from './graph-CWeI0aHd.js';
+import { a as GraphOptions, G as Graph } from './graph-BOhEGJ6E.js';
 
 /**
  * Domain templates (roadmap §8.2).

package/dist/{index-DR3gf_DG.d.cts → index-LzCJ0kMT.d.cts}

@@ -1,12 +1,12 @@
 import { i as index$2 } from './index-BydMDMf7.cjs';
 import { i as index$3 } from './index-CIXaiYDE.cjs';
-import { i as index$4 } from './index-yIdWFo2b.cjs';
+import { i as index$4 } from './index-C4QTaDli.cjs';
 import { i as index$5 } from './index-D7XxY1Ff.cjs';
 import { a as Node } from './node-BVV7G1bq.cjs';
 import { i as index$6 } from './index-FBqTfL_S.cjs';
 import { i as index$7 } from './index-CDK5RsV5.cjs';
 import { i as index$8 } from './index-DDo-eqQ4.cjs';
-import { i as index$9 } from './index-CRAkoq-y.cjs';
+import { i as index$9 } from './index-DY2QbdoP.cjs';
 
 /**
  * Options for creating signals.

package/dist/{index-RQg6lTrN.d.ts → index-MV2yGIAq.d.ts}

@@ -1,12 +1,12 @@
 import { i as index$2 } from './index-ByPnK85n.js';
 import { i as index$3 } from './index-wIx1Jisk.js';
-import { i as index$4 } from './index-DGb1awva.js';
+import { i as index$4 } from './index-CZUzi6Dy.js';
 import { i as index$5 } from './index-D0C_USMR.js';
 import { a as Node } from './node-BVV7G1bq.js';
 import { i as index$6 } from './index-CrC7urhX.js';
 import { i as index$7 } from './index-BX22kvjh.js';
 import { i as index$8 } from './index-Ip3q9T9x.js';
-import { i as index$9 } from './index-Bvi5uJxX.js';
+import { i as index$9 } from './index-CmSjld-4.js';
 
 /**
  * Options for creating signals.

package/dist/{index-Bs3-LC83.d.cts → index-_BXz9K7b.d.cts}

@@ -1,6 +1,6 @@
 import { a as Node } from './node-BVV7G1bq.cjs';
 import { S as StatusValue, C as CircuitState, R as RateLimiterOptions, a as CircuitBreakerOptions, b as RetryOptions, F as FallbackInput, N as NS_PER_MS, c as NS_PER_SEC } from './resilience-Q6Bt_7y0.cjs';
-import { B as BudgetConstraint } from './index-Cy7eFeIX.cjs';
+import { B as BudgetConstraint } from './index-BwdPDWI4.cjs';
 
 /**
  * Resilience composition with correct nesting order (roadmap §9.0b).

package/dist/{index-SSGqF8mI.d.cts → index-aBqZUx3B.d.cts}

@@ -1,5 +1,5 @@
 import { a as Node } from './node-BVV7G1bq.cjs';
-import { a as GraphOptions, G as Graph } from './graph-C4Uxwv0T.cjs';
+import { a as GraphOptions, G as Graph } from './graph-CdJeX7O7.cjs';
 
 /**
  * CQRS patterns (roadmap §4.5).

package/dist/{index-CFW32Dy1.d.ts → index-eYHRkoK-.d.ts}

@@ -1,6 +1,6 @@
 import { a as Node, N as NodeOptions, c as NodeActions } from './node-BVV7G1bq.js';
 import { D as DerivedFn } from './sugar-BHbAACDG.js';
-import { G as Graph, a as GraphOptions } from './graph-CWeI0aHd.js';
+import { G as Graph, a as GraphOptions } from './graph-BOhEGJ6E.js';
 
 /**
  * Orchestration patterns (roadmap §4.1).

package/dist/{index-B2HBxvMb.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-BvDrRuwt.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 { R as ReactiveMapBundle } from './reactive-map-CtRaCddO.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-B8Aj_z8S.d.cts → index-j33Lfb1G.d.cts}

@@ -1,6 +1,6 @@
 import { a as Node } from './node-BVV7G1bq.cjs';
-import { G as Graph } from './graph-C4Uxwv0T.cjs';
-import { L as LLMAdapter } from './types-O3GzJY2U.cjs';
+import { G as Graph } from './graph-CdJeX7O7.cjs';
+import { L as LLMAdapter } from './types-BgMqbc7N.cjs';
 
 /**
  * LLM graph composition (roadmap §8.3).
@@ -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-BXbQUn4n.d.ts → index-zMQIQuDu.d.ts}

@@ -1,6 +1,6 @@
 import { a as Node } from './node-BVV7G1bq.js';
-import { G as Graph } from './graph-CWeI0aHd.js';
-import { L as LLMAdapter } from './types-u64Ose53.js';
+import { G as Graph } from './graph-BOhEGJ6E.js';
+import { L as LLMAdapter } from './types-CdfO2QTt.js';
 
 /**
  * LLM graph composition (roadmap §8.3).
@@ -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.