libpetri 2.12.0 → 2.12.1

package/dist/{petri-net-B4wQwsUj.d.ts → petri-net-Byc3gSgJ.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

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, aP as MarkingState, aQ as PInvariant, aR as MarkingStateBuilder, aS as SmtProperty, aT as SmtVerificationResult } from '../petri-net-Byc3gSgJ.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-Byc3gSgJ.js';
 import { Expr, init, Bool, FuncDecl } from 'z3-solver';
 
 /**

package/package.json

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