libpetri 2.10.5 → 2.11.0

package/dist/verification/index.d.ts

@@ -247,6 +247,32 @@ declare function findMinimalSiphons(flatNet: FlatNet): ReadonlySet<number>[];
  */
 declare function findMaximalTrapIn(flatNet: FlatNet, places: ReadonlySet<number>): ReadonlySet<number>;
 
+/**
+ * Name-correlation fragment classifier for the ν-aware state class graph
+ * (NU-050, Route B). See the Rust/Java equivalents for the full contract.
+ *
+ * Identifies the coloured places (the correlated inputs of ν-joins) and the role
+ * of each transition in the supported fragment. Returns `null` when the net is
+ * not a ν-net or falls outside the admitted fragment (the caller falls back to
+ * the SMT / Route A path).
+ *
+ * {@link FragmentMode.base} (default) admits the shipped mint → matched-join
+ * fragment only: a non-match transition consuming a coloured place, or a join
+ * re-minting into one, rejects the net. {@link FragmentMode.extended} (opt-in,
+ * NU-051) additionally admits the coloured-consumer role ({@link Role} `consume`,
+ * drain/relay) and unions user-declared *carrier* places into the coloured set
+ * (fork-threaded co-mint). The one deliberate tightening shared by both modes is
+ * the reset/read/inhibitor-on-coloured guard below.
+ */
+
+/**
+ * Selects which coloured-place fragment {@link classify} admits. `base` (default)
+ * reproduces the shipped mint → matched-join fragment exactly; `extended`
+ * additionally admits the coloured-consumer (drain/relay) role and carrier
+ * places (NU-051).
+ */
+type FragmentMode = 'base' | 'extended';
+
 /**
  * IC3/PDR-based safety verifier for Petri nets using Z3's Spacer engine.
  *
@@ -279,6 +305,8 @@ declare class SmtVerifier {
     private _environmentMode;
     private _timeoutMs;
     private _nuMaxClasses;
+    private _fragmentMode;
+    private readonly _carrierPlaces;
     private constructor();
     static forNet(net: PetriNet): SmtVerifier;
     initialMarking(marking: MarkingState): this;
@@ -308,6 +336,27 @@ declare class SmtVerifier {
      * structurally bounded). Default 100_000.
      */
     nuMaxClasses(max: number): this;
+    /**
+     * Selects the ν-net coloured-place fragment for Route B (NU-051). `base`
+     * (default) admits the shipped mint → matched-join fragment only; `extended`
+     * additionally admits the opt-in coloured-consumer (drain/relay) role and the
+     * declared {@link carrierPlaces}. When `extended` is requested but the net
+     * falls outside the coloured-consumer fragment, Route B declines and a short
+     * note is appended to the report before falling back to the sound
+     * over-approximation.
+     */
+    fragmentMode(mode: FragmentMode): this;
+    /**
+     * Declares ν-net *carrier* places (NU-051, EXTENDED only): intermediate places
+     * that carry a fresh name from the minting fork onward to a ν-join input. Under
+     * {@link fragmentMode} `extended` they are unioned into the coloured set so the
+     * existing mint co-mints one fresh name into all of them; under `base` they are
+     * ignored. Accumulating. Throws if a declared place is not in the net — a
+     * mistyped carrier name would let two fork branches mint independent names, so
+     * the join never becomes name-enabled and the verifier would otherwise report a
+     * confident false deadlock; it must surface, never silently proceed.
+     */
+    carrierPlaces(...places: Place<any>[]): this;
     /**
      * Runs the verification pipeline.
      */

package/dist/verification/index.js

@@ -34,7 +34,7 @@ import {
   propertyDescription,
   structuralCheck,
   unreachable
-} from "../chunk-M3KT7BFO.js";
+} from "../chunk-YKJQ7IKZ.js";
 import "../chunk-ATT7U5H5.js";
 
 // src/verification/analysis/scc-analyzer.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libpetri",
-  "version": "2.10.5",
+  "version": "2.11.0",
   "description": "Coloured Time Petri Net engine — TypeScript port",
   "homepage": "https://libpetri.org",
   "repository": {