libpetri 2.12.1 → 2.13.0

package/dist/{chunk-V3WTQRHC.js → chunk-7VJ5CYUU.js}

@@ -97,6 +97,80 @@ function crossProduct(a, b) {
   return result;
 }
 
+// src/core/transition-action.ts
+function passthrough() {
+  return PASSTHROUGH;
+}
+var PASSTHROUGH = async () => {
+};
+function isPassthrough(action) {
+  return action === PASSTHROUGH;
+}
+function transform(fn) {
+  return async (ctx) => {
+    const result = fn(ctx);
+    for (const outputPlace of ctx.outputPlaces()) {
+      ctx.output(outputPlace, result);
+    }
+  };
+}
+function fork() {
+  return transform((ctx) => {
+    const inputPlaces = ctx.inputPlaces();
+    if (inputPlaces.size !== 1) {
+      throw new Error(`Fork requires exactly 1 input place, found ${inputPlaces.size}`);
+    }
+    const inputPlace = inputPlaces.values().next().value;
+    return ctx.input(inputPlace);
+  });
+}
+function transformFrom(inputPlace, fn) {
+  return transform((ctx) => fn(ctx.input(inputPlace)));
+}
+function transformAsync(fn) {
+  return async (ctx) => {
+    const result = await fn(ctx);
+    for (const outputPlace of ctx.outputPlaces()) {
+      ctx.output(outputPlace, result);
+    }
+  };
+}
+function produce(place, value) {
+  return async (ctx) => {
+    ctx.output(place, value);
+  };
+}
+function withTimeout(action, timeoutMs, timeoutPlace2, timeoutValue) {
+  return (ctx) => {
+    return new Promise((resolve, reject) => {
+      let completed = false;
+      const timer = setTimeout(() => {
+        if (!completed) {
+          completed = true;
+          ctx.output(timeoutPlace2, timeoutValue);
+          resolve();
+        }
+      }, timeoutMs);
+      action(ctx).then(
+        () => {
+          if (!completed) {
+            completed = true;
+            clearTimeout(timer);
+            resolve();
+          }
+        },
+        (err) => {
+          if (!completed) {
+            completed = true;
+            clearTimeout(timer);
+            reject(err);
+          }
+        }
+      );
+    });
+  };
+}
+
 // src/verification/marking-state.ts
 var MARKING_STATE_KEY = /* @__PURE__ */ Symbol("MarkingState.internal");
 var MarkingState = class _MarkingState {
@@ -1400,6 +1474,17 @@ var StateClass = class {
   }
 };
 
+// src/core/internal/output-action-check.ts
+function requireOutputProducingActions(net) {
+  for (const t of net.transitions) {
+    if (t.outputSpec !== null && isPassthrough(t.action)) {
+      throw new Error(
+        `Transition '${t.name}' declares an output spec but carries passthrough(), which produces no tokens. Every firing would fail output validation (IO-015) and the declared output would never arrive. Bind an action that produces it \u2014 fork() moves the input token across \u2014 or drop the output spec if the transition is meant to be a sink.`
+      );
+    }
+  }
+}
+
 // src/verification/analysis/state-class-graph.ts
 var StateClassGraph = class _StateClassGraph {
   net;
@@ -1430,8 +1515,13 @@ var StateClassGraph = class _StateClassGraph {
       }
     }
   }
-  /** 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, initialMarking, maxClasses, environmentPlaces, environmentMode) {
+    requireOutputProducingActions(net);
     const envMode = environmentMode ?? ignore();
     const envPlaces = /* @__PURE__ */ new Set();
     if (environmentPlaces) {
@@ -2775,8 +2865,11 @@ var SmtVerifier = class _SmtVerifier {
   }
   /**
    * Runs the verification pipeline.
+   *
+   * @throws Error if the net violates CORE-043 — verification rejects the same nets execution rejects.
    */
   async verify() {
+    requireOutputProducingActions(this.net);
     const start = performance.now();
     const report = [];
     report.push("=== IC3/PDR SAFETY VERIFICATION ===\n");
@@ -3169,6 +3262,14 @@ export {
   forwardInput,
   allPlaces,
   enumerateBranches,
+  passthrough,
+  isPassthrough,
+  transform,
+  fork,
+  transformFrom,
+  transformAsync,
+  produce,
+  withTimeout,
   MarkingState,
   MarkingStateBuilder,
   deadlockFree,
@@ -3199,10 +3300,11 @@ export {
   encode,
   DBM,
   StateClass,
+  requireOutputProducingActions,
   StateClassGraph,
   decode,
   SmtVerifier,
   isProven,
   isViolated
 };
-//# sourceMappingURL=chunk-V3WTQRHC.js.map
+//# sourceMappingURL=chunk-7VJ5CYUU.js.map