libpetri 2.12.0 → 2.13.0

package/dist/{petri-net-B4wQwsUj.d.ts → petri-net-C3LSY-vm.d.ts}

@@ -405,10 +405,22 @@ interface OutputEntry {
  */
 declare class TokenOutput {
     private readonly _entries;
+    /**
+     * Once true, further writes are dropped instead of appended. Set by the executor
+     * (via {@link import('./transition-context.js').TransitionContext.detachForTimeout})
+     * when a firing times out, so the action it has stopped waiting for can no longer
+     * reach the marking. Irreversible.
+     */
+    private detached;
     /** Add a value to an output place (creates token with current timestamp). */
     add<T>(place: Place<T>, value: T): this;
     /** Add a pre-existing token to an output place. */
     addToken<T>(place: Place<T>, token: Token<T>): this;
+    /**
+     * @internal Severs this collector: subsequent {@link add}/{@link addToken} calls are
+     * dropped. Executor machinery invoked when a firing times out — never call from an action.
+     */
+    detach(): void;
     /** Returns all collected outputs. */
     entries(): readonly OutputEntry[];
     /** Check if any outputs were produced. */
@@ -432,7 +444,17 @@ type LogFn = (level: string, message: string, error?: Error) => void;
  */
 declare class TransitionContext {
     private readonly rawInput;
-    private readonly _rawOutput;
+    /**
+     * What the executor harvests. Identical to {@link writeTarget} until
+     * {@link detachForTimeout} replaces it with a fresh collector the action cannot reach.
+     */
+    private _rawOutput;
+    /**
+     * What the action writes to. Never reassigned, so an action already inside
+     * `output(...)` cannot be redirected mid-write; severance happens by detaching this
+     * collector, not by swapping it.
+     */
+    private readonly writeTarget;
     private readonly allowedInputs;
     private readonly allowedReads;
     private readonly allowedOutputs;
@@ -496,6 +518,30 @@ declare class TransitionContext {
     /** Returns declared output places. */
     outputPlaces(): ReadonlySet<Place<any>>;
     private requireOutput;
+    /**
+     * Severs the action's output from the marking, for use when a firing times out.
+     *
+     * After this call the action's `output(...)` writes are dropped, and the executor
+     * harvests a fresh collector the action holds no reference to. Anything the action
+     * wrote *before* the timeout is discarded with it: a partial result merged with the
+     * timeout branch would violate the transition's own output spec.
+     *
+     * This is the only isolation available — libpetri does not own the promise the action
+     * runs on, so it cannot stop the work, only stop the result from landing.
+     *
+     * @internal Executor machinery — must be called by the executor, never by an action.
+     */
+    detachForTimeout(): void;
+    /**
+     * Produces into the executor's harvest collector rather than the action's write target.
+     *
+     * Identical to {@link output} before {@link detachForTimeout}; after it, this is the
+     * only route that still reaches the marking. Used by the executor to deposit the
+     * timeout branch.
+     *
+     * @internal Executor machinery — must be called by the executor, never by an action.
+     */
+    outputToHarvest<T>(place: Place<T>, value: T): this;
     /**
      * @internal Installs the ν-name minter. Wired by the executor at firing time
      * so names minted by {@link freshName} are monotonic across the run and
@@ -531,15 +577,19 @@ declare class TransitionContext {
 type TransitionAction = (ctx: TransitionContext) => Promise<void>;
 /**
  * Identity action: produces no outputs.
+ * For transitions that only consume tokens without producing any.
  *
- * Returns a stable singleton reference (cached on first call). Reference
- * stability is relied on by {@link import('./internal/subnet-rewriter.js')
- * .composeActions} during channel composition (MOD-021) to short-circuit a
- * passthrough-on-both-sides merge to passthrough — saving a microtask hop
- * and matching the Java implementation's behaviour where both transitions'
- * default actions collapse to the builder's own passthrough default.
+ * Returns a stable singleton reference (CORE-051), so {@link isPassthrough}
+ * can recognise it.
  */
 declare function passthrough(): TransitionAction;
+/**
+ * Whether `action` is the built-in {@link passthrough} — i.e. provably produces
+ * no output tokens. Identity-based, so a hand-written no-op is not claimed.
+ *
+ * @param action the action to test; `null` / `undefined` is not passthrough
+ */
+declare function isPassthrough(action: TransitionAction | null | undefined): boolean;
 /**
  * Transform action: applies function to context, copies result to ALL output places.
  *
@@ -1493,8 +1543,12 @@ declare class PetriNet {
     bindActions(actionBindings: Map<string, TransitionAction> | Record<string, TransitionAction>): PetriNet;
     /**
      * Creates a new PetriNet with actions bound via a resolver function.
+     *
+     * The resolver is called once per transition with its name. Returning `null`
+     * defers that transition — it keeps whatever action it already carries — which
+     * is what makes staged binding (**MOD-024** AC7) work.
      */
-    bindActionsWithResolver(actionResolver: (name: string) => TransitionAction): PetriNet;
+    bindActionsWithResolver(actionResolver: (name: string) => TransitionAction | null): PetriNet;
     static builder(name: string): PetriNetBuilder;
 }
 declare class PetriNetBuilder {
@@ -1728,4 +1782,4 @@ declare class PetriNetBuilder {
     private buildWithFusion;
 }
 
-export { type VerificationHarness as $, type Arc as A, type Port as B, type Channel as C, type PortDirection as D, type EnvironmentPlace as E, FusionSet as F, SubnetDefBuilder as G, type SubnetInstance as H, type In as I, type Timing as J, type KeyFn as K, type LogFn as L, MAX_DURATION_MS as M, type NameId as N, type Out as O, PetriNet as P, type TimingDeadline as Q, type TimingDelayed as R, SubnetDef as S, type Token as T, type TimingExact as U, type TimingImmediate as V, type TimingWindow as W, TokenInput as X, TokenOutput as Y, type TransitionAction as Z, TransitionBuilder as _, type Place as a, type TokenSupplier as a$, type VerificationResult as a0, all as a1, allPlaces as a2, and as a3, andPlaces as a4, arcPlace as a5, atLeast as a6, consumptionCount as a7, deadline as a8, delayed as a9, readArc as aA, requiredCount as aB, resetArc as aC, timeout as aD, timeoutPlace as aE, tokenAt as aF, tokenOf as aG, transform as aH, transformAsync as aI, transformFrom as aJ, unitToken as aK, window as aL, withTimeout as aM, xor as aN, xorPlaces as aO, MarkingState as aP, type PInvariant as aQ, MarkingStateBuilder as aR, type SmtProperty as aS, type SmtVerificationResult as aT, type BranchPlaceBound as aU, type DeadlockFree as aV, type JoinedOrDeadLettered as aW, type MutualExclusion as aX, type PlaceBound as aY, type Proven as aZ, type SmtStatistics as a_, earliest as aa, enumerateBranches as ab, environmentPlace as ac, exact as ad, exactly as ae, fork as af, forwardInput as ag, hasDeadline as ah, hasGuard as ai, immediate as aj, inhibitorArc as ak, inputArc as al, isUnit as am, keyForPlace as an, latest as ao, matchCorrelates as ap, matchKey as aq, matchSpec as ar, matchesGuard as as, nameId as at, one as au, outPlace as av, outputArc as aw, passthrough as ax, place as ay, produce as az, Transition as b, type Unknown as b0, type Unreachable as b1, type Verdict as b2, type Violated as b3, branchPlaceBound as b4, deadlockFree as b5, isProven as b6, isViolated as b7, joinedOrDeadLettered as b8, mutualExclusion as b9, pInvariant as ba, pInvariantToString as bb, placeBound as bc, propertyDescription as bd, unreachable as be, TransitionContext as c, type ArcInhibitor as d, type ArcInput as e, type ArcOutput as f, type ArcRead as g, type ArcReset as h, ComposeBindings as i, FusionSetBuilder as j, type InAll as k, type InAtLeast as l, type InExactly as m, type InOne as n, Instance as o, Interface as p, InterfaceBuilder as q, type MatchKey as r, type MatchSpec as s, type OutAnd as t, type OutForwardInput as u, type OutPlace as v, type OutTimeout as w, type OutXor as x, type OutputEntry as y, PetriNetBuilder as z };
+export { type VerificationHarness as $, type Arc as A, type Port as B, type Channel as C, type PortDirection as D, type EnvironmentPlace as E, FusionSet as F, SubnetDefBuilder as G, type SubnetInstance as H, type In as I, type Timing as J, type KeyFn as K, type LogFn as L, MAX_DURATION_MS as M, type NameId as N, type Out as O, PetriNet as P, type TimingDeadline as Q, type TimingDelayed as R, SubnetDef as S, type Token as T, type TimingExact as U, type TimingImmediate as V, type TimingWindow as W, TokenInput as X, TokenOutput as Y, type TransitionAction as Z, TransitionBuilder as _, type Place as a, type SmtStatistics as a$, type VerificationResult as a0, all as a1, allPlaces as a2, and as a3, andPlaces as a4, arcPlace as a5, atLeast as a6, consumptionCount as a7, deadline as a8, delayed as a9, produce as aA, readArc as aB, requiredCount as aC, resetArc as aD, timeout as aE, timeoutPlace as aF, tokenAt as aG, tokenOf as aH, transform as aI, transformAsync as aJ, transformFrom as aK, unitToken as aL, window as aM, withTimeout as aN, xor as aO, xorPlaces as aP, MarkingState as aQ, type PInvariant as aR, MarkingStateBuilder as aS, type SmtProperty as aT, type SmtVerificationResult as aU, type BranchPlaceBound as aV, type DeadlockFree as aW, type JoinedOrDeadLettered as aX, type MutualExclusion as aY, type PlaceBound as aZ, type Proven as a_, earliest as aa, enumerateBranches as ab, environmentPlace as ac, exact as ad, exactly as ae, fork as af, forwardInput as ag, hasDeadline as ah, hasGuard as ai, immediate as aj, inhibitorArc as ak, inputArc as al, isPassthrough as am, isUnit as an, keyForPlace as ao, latest as ap, matchCorrelates as aq, matchKey as ar, matchSpec as as, matchesGuard as at, nameId as au, one as av, outPlace as aw, outputArc as ax, passthrough as ay, place as az, Transition as b, type TokenSupplier as b0, type Unknown as b1, type Unreachable as b2, type Verdict as b3, type Violated as b4, branchPlaceBound as b5, deadlockFree as b6, isProven as b7, isViolated as b8, joinedOrDeadLettered as b9, mutualExclusion as ba, pInvariant as bb, pInvariantToString as bc, placeBound as bd, propertyDescription as be, unreachable as bf, TransitionContext as c, type ArcInhibitor as d, type ArcInput as e, type ArcOutput as f, type ArcRead as g, type ArcReset as h, ComposeBindings as i, FusionSetBuilder as j, type InAll as k, type InAtLeast as l, type InExactly as m, type InOne as n, Instance as o, Interface as p, InterfaceBuilder as q, type MatchKey as r, type MatchSpec as s, type OutAnd as t, type OutForwardInput as u, type OutPlace as v, type OutTimeout as w, type OutXor as x, type OutputEntry as y, PetriNetBuilder as z };

package/dist/verification/index.d.ts

@@ -1,5 +1,5 @@
-import { b as Transition, a as Place, P as PetriNet, E as EnvironmentPlace, aP as MarkingState, aQ as PInvariant, aR as MarkingStateBuilder, aS as SmtProperty, aT as SmtVerificationResult } from '../petri-net-B4wQwsUj.js';
-export { aU as BranchPlaceBound, aV as DeadlockFree, aW as JoinedOrDeadLettered, aX as MutualExclusion, aY as PlaceBound, aZ as Proven, a_ as SmtStatistics, a$ as TokenSupplier, b0 as Unknown, b1 as Unreachable, b2 as Verdict, $ as VerificationHarness, a0 as VerificationResult, b3 as Violated, b4 as branchPlaceBound, b5 as deadlockFree, b6 as isProven, b7 as isViolated, b8 as joinedOrDeadLettered, b9 as mutualExclusion, ba as pInvariant, bb as pInvariantToString, bc as placeBound, bd as propertyDescription, be as unreachable } from '../petri-net-B4wQwsUj.js';
+import { b as Transition, a as Place, P as PetriNet, E as EnvironmentPlace, aQ as MarkingState, aR as PInvariant, aS as MarkingStateBuilder, aT as SmtProperty, aU as SmtVerificationResult } from '../petri-net-C3LSY-vm.js';
+export { aV as BranchPlaceBound, aW as DeadlockFree, aX as JoinedOrDeadLettered, aY as MutualExclusion, aZ as PlaceBound, a_ as Proven, a$ as SmtStatistics, b0 as TokenSupplier, b1 as Unknown, b2 as Unreachable, b3 as Verdict, $ as VerificationHarness, a0 as VerificationResult, b4 as Violated, b5 as branchPlaceBound, b6 as deadlockFree, b7 as isProven, b8 as isViolated, b9 as joinedOrDeadLettered, ba as mutualExclusion, bb as pInvariant, bc as pInvariantToString, bd as placeBound, be as propertyDescription, bf as unreachable } from '../petri-net-C3LSY-vm.js';
 import { Expr, init, Bool, FuncDecl } from 'z3-solver';
 
 /**
@@ -426,6 +426,8 @@ declare class SmtVerifier {
     prioritySemantics(semantics: PrioritySemantics): this;
     /**
      * Runs the verification pipeline.
+     *
+     * @throws Error if the net violates CORE-043 — verification rejects the same nets execution rejects.
      */
     verify(): Promise<SmtVerificationResult>;
     /**
@@ -646,7 +648,11 @@ declare class StateClassGraph {
     private readonly _predecessors;
     private readonly _complete;
     private constructor();
-    /** Builds the state class graph for a Time Petri Net. */
+    /**
+     * Builds the state class graph for a Time Petri Net.
+     *
+     * @throws Error if the net violates CORE-043 — analysis rejects the same nets execution rejects.
+     */
     static build(net: PetriNet, initialMarking: MarkingState, maxClasses: number, environmentPlaces?: Set<EnvironmentPlace<any>>, environmentMode?: EnvironmentAnalysisMode): StateClassGraph;
     stateClasses(): readonly StateClass[];
     size(): number;

package/dist/verification/index.js

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

package/package.json

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