libpetri 5.0.0 → 5.1.0

package/dist/{event-store-hlH3-bzJ.d.ts → event-store-CUyHiIH7.d.ts}

@@ -1,4 +1,4 @@
-import { T as Token } from './petri-net-CH7UvjOW.js';
+import { T as Token } from './petri-net-6G5r1Wwb.js';
 
 /**
  * Events emitted during Petri Net execution.

package/dist/export/index.d.ts

@@ -1,4 +1,4 @@
-import { P as PetriNet } from '../petri-net-CH7UvjOW.js';
+import { P as PetriNet } from '../petri-net-6G5r1Wwb.js';
 
 /**
  * Format-agnostic typed graph model.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { P as PetriNet, S as SubnetDef, a as Place, T as Token, b as Transition, E as EnvironmentPlace, c as TransitionContext, O as Out } from './petri-net-CH7UvjOW.js';
-export { A as Arc, d as ArcInhibitor, e as ArcInput, f as ArcOutput, g as ArcRead, h as ArcReset, C as Channel, i as ComposeBindings, F as FusionSet, j as FusionSetBuilder, I as In, k as InAll, l as InAtLeast, m as InExactly, n as InOne, o as Instance, p as Interface, q as InterfaceBuilder, K as KeyFn, L as LogFn, M as MAX_DURATION_MS, r as MatchKey, s as MatchSpec, N as NameId, t as OutAnd, u as OutForwardInput, v as OutPlace, w as OutTimeout, x as OutXor, y as OutputEntry, z as PetriNetBuilder, B as Port, D as PortDirection, G as SubnetDefBuilder, H as SubnetInstance, J as Timing, Q as TimingDeadline, R as TimingDelayed, U as TimingExact, V as TimingImmediate, W as TimingWindow, X as TokenInput, Y as TokenOutput, Z as TransitionAction, _ as TransitionBuilder, $ as VerificationHarness, a0 as VerificationResult, a1 as all, a2 as allPlaces, a3 as and, a4 as andPlaces, a5 as arcPlace, a6 as atLeast, a7 as consumptionCount, a8 as deadline, a9 as delayed, aa as earliest, ab as enumerateBranches, ac as environmentPlace, ad as exact, ae as exactly, af as fork, ag as forwardInput, ah as hasDeadline, ai as immediate, aj as inhibitorArc, ak as inputArc, al as isPassthrough, am as isUnit, an as keyForPlace, ao as latest, ap as matchCorrelates, aq as matchKey, ar as matchSpec, as as nameId, at as one, au as outPlace, av as outputArc, aw as passthrough, ax as place, ay as produce, az as readArc, aA as requiredCount, aB as resetArc, aC as timeout, aD as timeoutPlace, aE as tokenAt, aF as tokenOf, aG as transform, aH as transformAsync, aI as transformFrom, aJ as unitToken, aK as window, aL as withTimeout, aM as xor, aN as xorPlaces } from './petri-net-CH7UvjOW.js';
-import { E as EventStore } from './event-store-hlH3-bzJ.js';
-export { A as ActionTimedOut, a as ExecutionCompleted, b as ExecutionStarted, I as InMemoryEventStore, L as LogMessage, M as MarkingSnapshot, N as NetEvent, T as TokenAdded, c as TokenRemoved, d as TransitionClockRestarted, e as TransitionCompleted, f as TransitionEnabled, g as TransitionFailed, h as TransitionStarted, i as TransitionTimedOut, j as eventTransitionName, k as eventsOfType, l as failures, m as filterEvents, n as inMemoryEventStore, o as isFailureEvent, p as noopEventStore, t as transitionEvents } from './event-store-hlH3-bzJ.js';
+import { P as PetriNet, S as SubnetDef, a as Place, T as Token, b as Transition, E as EnvironmentPlace, c as TransitionContext, O as Out } from './petri-net-6G5r1Wwb.js';
+export { A as Arc, d as ArcInhibitor, e as ArcInput, f as ArcOutput, g as ArcRead, h as ArcReset, C as Channel, i as ComposeBindings, F as FusionSet, j as FusionSetBuilder, I as In, k as InAll, l as InAtLeast, m as InExactly, n as InOne, o as Instance, p as Interface, q as InterfaceBuilder, K as KeyFn, L as LogFn, M as MAX_DURATION_MS, r as MatchKey, s as MatchSpec, N as NameId, t as OutAnd, u as OutForwardInput, v as OutPlace, w as OutTimeout, x as OutXor, y as OutputEntry, z as PetriNetBuilder, B as Port, D as PortDirection, G as SubnetDefBuilder, H as SubnetInstance, J as Timing, Q as TimingDeadline, R as TimingDelayed, U as TimingExact, V as TimingImmediate, W as TimingWindow, X as TokenInput, Y as TokenOutput, Z as TransitionAction, _ as TransitionBuilder, $ as VerificationHarness, a0 as VerificationResult, a1 as all, a2 as allPlaces, a3 as and, a4 as andPlaces, a5 as arcPlace, a6 as atLeast, a7 as consumptionCount, a8 as deadline, a9 as delayed, aa as earliest, ab as enumerateBranches, ac as environmentPlace, ad as exact, ae as exactly, af as fork, ag as forwardInput, ah as hasDeadline, ai as immediate, aj as inhibitorArc, ak as inputArc, al as isPassthrough, am as isUnit, an as keyForPlace, ao as latest, ap as matchCorrelates, aq as matchKey, ar as matchSpec, as as nameId, at as one, au as outPlace, av as outputArc, aw as passthrough, ax as place, ay as produce, az as readArc, aA as requiredCount, aB as resetArc, aC as timeout, aD as timeoutPlace, aE as tokenAt, aF as tokenOf, aG as transform, aH as transformAsync, aI as transformFrom, aJ as unitToken, aK as window, aL as withTimeout, aM as xor, aN as xorPlaces } from './petri-net-6G5r1Wwb.js';
+import { E as EventStore } from './event-store-CUyHiIH7.js';
+export { A as ActionTimedOut, a as ExecutionCompleted, b as ExecutionStarted, I as InMemoryEventStore, L as LogMessage, M as MarkingSnapshot, N as NetEvent, T as TokenAdded, c as TokenRemoved, d as TransitionClockRestarted, e as TransitionCompleted, f as TransitionEnabled, g as TransitionFailed, h as TransitionStarted, i as TransitionTimedOut, j as eventTransitionName, k as eventsOfType, l as failures, m as filterEvents, n as inMemoryEventStore, o as isFailureEvent, p as noopEventStore, t as transitionEvents } from './event-store-CUyHiIH7.js';
 
 /**
  * Discriminated sum-type abstraction over Petri nets, distinguishing **closed**
@@ -331,6 +331,8 @@ declare class BitmapNetExecutor implements PetriNetExecutor {
      * Place identity is name-based — so a hot loop warns once, not per token.
      */
     private readonly warnedUnknownPlaces;
+    /** Transitions already warned for writing several tokens to a place their spec names once (IO-016 AC4). */
+    private readonly warnedMultiplicity;
     private readonly transitionInputPlaceNames;
     private running;
     private draining;
@@ -436,6 +438,13 @@ declare class BitmapNetExecutor implements PetriNetExecutor {
      * initial-marking and injection seams. Retention never depends on this.
      */
     private warnUnknownPlace;
+    /**
+     * Reports, once per transition, a firing that wrote more than one token to a place
+     * its output spec names once (IO-016 AC4), as the EVT-013 log-message event. The
+     * tokens are deposited regardless: the diagnostic makes the under-approximation
+     * every branch-enumerating analysis makes of this transition visible.
+     */
+    private warnMultiplicity;
     private emitEvent;
 }
 
@@ -598,6 +607,8 @@ declare class PrecompiledNetExecutor implements PetriNetExecutor {
      * materializing a Marking has one to hand.
      */
     private readonly unknownPlaceTokens;
+    /** Transitions already warned for writing several tokens to a place their spec names once (IO-016 AC4). */
+    private readonly warnedMultiplicity;
     /** Monotonic source for ν-name minting (ctx.freshName(), NU-010). */
     private freshNameCounter;
     /**
@@ -745,6 +756,14 @@ declare class PrecompiledNetExecutor implements PetriNetExecutor {
     executionId(): string;
     drain(): void;
     close(): void;
+    /**
+     * Reports, once per transition, a firing that wrote more than one token to a place
+     * its output spec names once (IO-016 AC4), as the EVT-013 log-message event. The
+     * tokens are deposited regardless: the diagnostic makes the under-approximation
+     * every branch-enumerating analysis makes of this transition visible. Mirrors the
+     * bitmap executor word for word.
+     */
+    private warnMultiplicity;
     private emitEvent;
 }
 

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   withTimeout,
   xor,
   xorPlaces
-} from "./chunk-75KEJQGC.js";
+} from "./chunk-EL4E6LVO.js";
 import {
   eventTransitionName,
   isFailureEvent
@@ -3253,6 +3253,8 @@ var BitmapNetExecutor = class {
    * Place identity is name-based — so a hot loop warns once, not per token.
    */
   warnedUnknownPlaces = /* @__PURE__ */ new Set();
+  /** Transitions already warned for writing several tokens to a place their spec names once (IO-016 AC4). */
+  warnedMultiplicity = /* @__PURE__ */ new Set();
   transitionInputPlaceNames;
   running = false;
   draining = false;
@@ -3913,7 +3915,9 @@ var BitmapNetExecutor = class {
       try {
         const outputs = flight.context.rawOutput();
         if (t.outputSpec !== null) {
-          validateOutSpec(t.name, t.outputSpec, outputs.placesWithTokens());
+          const produced2 = outputs.placesWithTokens();
+          const claim = validateOutSpec(t.name, t.outputSpec, produced2);
+          if (outputs.entries().length > produced2.size) this.warnMultiplicity(t.name, outputs, claim);
         }
         const produced = [];
         for (const entry of outputs.entries()) {
@@ -4124,6 +4128,33 @@ var BitmapNetExecutor = class {
       errorMessage: null
     });
   }
+  /**
+   * Reports, once per transition, a firing that wrote more than one token to a place
+   * its output spec names once (IO-016 AC4), as the EVT-013 log-message event. The
+   * tokens are deposited regardless: the diagnostic makes the under-approximation
+   * every branch-enumerating analysis makes of this transition visible.
+   */
+  warnMultiplicity(transitionName, outputs, claim) {
+    if (this.warnedMultiplicity.has(transitionName)) return;
+    const counts = /* @__PURE__ */ new Map();
+    for (const entry of outputs.entries()) {
+      if (claim.has(entry.place.name)) counts.set(entry.place.name, (counts.get(entry.place.name) ?? 0) + 1);
+    }
+    const repeated = [];
+    for (const [name, n] of counts) if (n > 1) repeated.push(`${name}: ${n}`);
+    if (repeated.length === 0) return;
+    this.warnedMultiplicity.add(transitionName);
+    this.emitEvent({
+      type: "log-message",
+      timestamp: Date.now(),
+      transitionName,
+      logger: "libpetri.runtime",
+      level: "WARN",
+      message: `'${transitionName}': wrote more than one token to a place its output spec names once (${repeated.join(", ")}); branch-enumerating analyses model one token per named place, so this firing exceeds what they explore (IO-016)`,
+      error: null,
+      errorMessage: null
+    });
+  }
   emitEvent(event) {
     if (this.eventStoreEnabled) {
       try {
@@ -4517,6 +4548,8 @@ var PrecompiledNetExecutor = class {
    * materializing a Marking has one to hand.
    */
   unknownPlaceTokens = /* @__PURE__ */ new Map();
+  /** Transitions already warned for writing several tokens to a place their spec names once (IO-016 AC4). */
+  warnedMultiplicity = /* @__PURE__ */ new Set();
   /** Monotonic source for ν-name minting (ctx.freshName(), NU-010). */
   freshNameCounter = 0;
   /**
@@ -5393,13 +5426,17 @@ var PrecompiledNetExecutor = class {
           const simplePid = prog.simpleOutputPlaceId[tid];
           if (simplePid >= 0) {
             const produced2 = outputs.placesWithTokens();
-            if (!produced2.has(prog.places[simplePid].name)) {
+            const named = prog.places[simplePid].name;
+            if (!produced2.has(named)) {
               throw new OutViolationError(
                 `'${t.name}': output does not match the declared spec - produced {}, which no single branch of the spec claims exactly`
               );
             }
+            if (outputs.entries().length > produced2.size) this.warnMultiplicity(t.name, outputs, /* @__PURE__ */ new Set([named]));
           } else if (simplePid === -1) {
-            validateOutSpec(t.name, t.outputSpec, outputs.placesWithTokens());
+            const produced2 = outputs.placesWithTokens();
+            const claim = validateOutSpec(t.name, t.outputSpec, produced2);
+            if (outputs.entries().length > produced2.size) this.warnMultiplicity(t.name, outputs, claim);
           }
         }
         const produced = [];
@@ -5619,6 +5656,34 @@ var PrecompiledNetExecutor = class {
     this.wakeUp();
   }
   // ======================== Event Emission ========================
+  /**
+   * Reports, once per transition, a firing that wrote more than one token to a place
+   * its output spec names once (IO-016 AC4), as the EVT-013 log-message event. The
+   * tokens are deposited regardless: the diagnostic makes the under-approximation
+   * every branch-enumerating analysis makes of this transition visible. Mirrors the
+   * bitmap executor word for word.
+   */
+  warnMultiplicity(transitionName, outputs, claim) {
+    if (this.warnedMultiplicity.has(transitionName)) return;
+    const counts = /* @__PURE__ */ new Map();
+    for (const entry of outputs.entries()) {
+      if (claim.has(entry.place.name)) counts.set(entry.place.name, (counts.get(entry.place.name) ?? 0) + 1);
+    }
+    const repeated = [];
+    for (const [name, n] of counts) if (n > 1) repeated.push(`${name}: ${n}`);
+    if (repeated.length === 0) return;
+    this.warnedMultiplicity.add(transitionName);
+    this.emitEvent({
+      type: "log-message",
+      timestamp: Date.now(),
+      transitionName,
+      logger: "libpetri.runtime",
+      level: "WARN",
+      message: `'${transitionName}': wrote more than one token to a place its output spec names once (${repeated.join(", ")}); branch-enumerating analyses model one token per named place, so this firing exceeds what they explore (IO-016)`,
+      error: null,
+      errorMessage: null
+    });
+  }
   emitEvent(event) {
     if (this.eventStoreEnabled) {
       try {