libpetri 2.6.0 → 2.7.0

package/dist/{petri-net-C3asscb4.d.ts → petri-net-D73-PO6d.d.ts}

@@ -363,7 +363,18 @@ declare class TransitionContext {
     private readonly _transitionName;
     private readonly executionCtx;
     private readonly _logFn?;
-    constructor(transitionName: string, rawInput: TokenInput, rawOutput: TokenOutput, inputPlaces: ReadonlySet<Place<any>>, readPlaces: ReadonlySet<Place<any>>, outputPlaces: ReadonlySet<Place<any>>, executionContext?: Map<string, unknown>, logFn?: LogFn);
+    private readonly placeAlias;
+    constructor(transitionName: string, rawInput: TokenInput, rawOutput: TokenOutput, inputPlaces: ReadonlySet<Place<any>>, readPlaces: ReadonlySet<Place<any>>, outputPlaces: ReadonlySet<Place<any>>, executionContext?: Map<string, unknown>, logFn?: LogFn, placeAlias?: ReadonlyMap<string, Place<any>>);
+    /**
+     * Resolves a place key through the transition's declared→actual place
+     * correspondence (per **MOD-031**). For a hand-written or directly-composed
+     * transition the correspondence is the identity, so this returns `place`
+     * unchanged; after instancing / port binding it maps a *declared* place
+     * constant the action hardcodes to the *actual* composed place. The result
+     * feeds both the declared-set check and the token-store access (both keyed by
+     * `place.name`), so `inputPlaces()`/`outputPlaces()` discovery is unaffected.
+     */
+    private resolve;
     /** Get single consumed input value. Throws if place not declared or multiple tokens. */
     input<T>(place: Place<T>): T;
     /** Get all consumed input values for a place. */
@@ -492,11 +503,23 @@ declare class Transition {
     readonly actionTimeout: OutTimeout | null;
     readonly action: TransitionAction;
     readonly priority: number;
+    /**
+     * Per-transition **declared → actual** place correspondence (per
+     * **MOD-031**), keyed by the author-original declared place **name** →
+     * actual composed place. Empty for a hand-written or directly-composed
+     * ([MOD-025]) transition (identity). Populated by the subnet rewriter after
+     * instantiation ([MOD-010]) / port binding ([MOD-020]) so an action that
+     * hardcodes a declared place constant resolves to the composed place via
+     * {@link import('./transition-context.js').TransitionContext}. Consumed only
+     * by the action-facing context I/O — never by enablement, firing, the
+     * verifier, the exporter, or events (so [MOD-023] is unaffected).
+     */
+    readonly placeAlias: ReadonlyMap<string, Place<any>>;
     private readonly _inputPlaces;
     private readonly _readPlaces;
     private readonly _outputPlaces;
     /** @internal Use {@link Transition.builder} to create instances. */
-    constructor(key: symbol, name: string, inputSpecs: readonly In[], outputSpec: Out | null, inhibitors: readonly ArcInhibitor[], reads: readonly ArcRead[], resets: readonly ArcReset[], timing: Timing, action: TransitionAction, priority: number);
+    constructor(key: symbol, name: string, inputSpecs: readonly In[], outputSpec: Out | null, inhibitors: readonly ArcInhibitor[], reads: readonly ArcRead[], resets: readonly ArcReset[], timing: Timing, action: TransitionAction, priority: number, placeAlias?: ReadonlyMap<string, Place<any>>);
     /** Returns set of input places — consumed tokens. */
     inputPlaces(): ReadonlySet<Place<any>>;
     /** Returns set of read places — context tokens, not consumed. */
@@ -518,6 +541,7 @@ declare class TransitionBuilder {
     private _timing;
     private _action;
     private _priority;
+    private _placeAlias;
     constructor(name: string);
     /** Add input specifications with cardinality. */
     inputs(...specs: In[]): this;
@@ -541,6 +565,13 @@ declare class TransitionBuilder {
     action(action: TransitionAction): this;
     /** Set the priority (higher fires first). */
     priority(priority: number): this;
+    /**
+     * Sets the per-transition declared→actual place correspondence (per
+     * **MOD-031**). Populated by the subnet rewriter during the compose-time
+     * rewrite; not normally called by hand-written nets, whose correspondence is
+     * the identity (empty map).
+     */
+    placeAlias(alias: ReadonlyMap<string, Place<any>>): this;
     build(): Transition;
 }
 

package/dist/verification/index.d.ts

@@ -1,5 +1,5 @@
-import { b as Transition, a as Place, P as PetriNet, E as EnvironmentPlace, aG as MarkingState, aH as PInvariant, aI as MarkingStateBuilder, aJ as SmtProperty, aK as SmtVerificationResult } from '../petri-net-C3asscb4.js';
-export { aL as DeadlockFree, aM as MutualExclusion, aN as PlaceBound, aO as Proven, aP as SmtStatistics, aQ as TokenSupplier, aR as Unknown, aS as Unreachable, aT as Verdict, X as VerificationHarness, Y as VerificationResult, aU as Violated, aV as deadlockFree, aW as isProven, aX as isViolated, aY as mutualExclusion, aZ as pInvariant, a_ as pInvariantToString, a$ as placeBound, b0 as propertyDescription, b1 as unreachable } from '../petri-net-C3asscb4.js';
+import { b as Transition, a as Place, P as PetriNet, E as EnvironmentPlace, aG as MarkingState, aH as PInvariant, aI as MarkingStateBuilder, aJ as SmtProperty, aK as SmtVerificationResult } from '../petri-net-D73-PO6d.js';
+export { aL as DeadlockFree, aM as MutualExclusion, aN as PlaceBound, aO as Proven, aP as SmtStatistics, aQ as TokenSupplier, aR as Unknown, aS as Unreachable, aT as Verdict, X as VerificationHarness, Y as VerificationResult, aU as Violated, aV as deadlockFree, aW as isProven, aX as isViolated, aY as mutualExclusion, aZ as pInvariant, a_ as pInvariantToString, a$ as placeBound, b0 as propertyDescription, b1 as unreachable } from '../petri-net-D73-PO6d.js';
 import { Expr, init, Bool, FuncDecl } from 'z3-solver';
 
 /**

package/package.json

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