quantum-forge 2.5.2 → 2.6.0

package/dist/lib/quantum.d.ts

@@ -56,7 +56,13 @@ declare function phase_rotate(predicates: Predicate[], angle: number): void;
 declare function measure_properties(props: QuantumProperty[]): number[];
 declare function forced_measure_properties(props: QuantumProperty[], forcedValues: number[]): number[];
 declare function measure_predicate(predicates: Predicate[]): number;
+/** Force a predicate measurement to a specific outcome.
+ *  If the forced value is impossible (zero probability), falls back to
+ *  stochastic measurement and returns the actual outcome instead of throwing. */
 declare function forced_measure_predicate(predicates: Predicate[], forcedValue: number): number;
+/** Get the probability that all predicates are simultaneously satisfied.
+ *  Read-only — does not collapse or modify quantum state. */
+declare function predicate_probability(predicates: Predicate[]): number;
 declare function probabilities(props: QuantumProperty[]): Array<{
     probability: number;
     qudit_values: number[];
@@ -200,6 +206,7 @@ declare const __quantum_forge_api_mjs_inverse_hadamard: typeof inverse_hadamard;
 declare const __quantum_forge_api_mjs_measure_predicate: typeof measure_predicate;
 declare const __quantum_forge_api_mjs_measure_properties: typeof measure_properties;
 declare const __quantum_forge_api_mjs_phase_rotate: typeof phase_rotate;
+declare const __quantum_forge_api_mjs_predicate_probability: typeof predicate_probability;
 declare const __quantum_forge_api_mjs_probabilities: typeof probabilities;
 declare const __quantum_forge_api_mjs_reduced_density_matrix: typeof reduced_density_matrix;
 declare const __quantum_forge_api_mjs_reset: typeof reset;
@@ -209,7 +216,7 @@ declare const __quantum_forge_api_mjs_x: typeof x;
 declare const __quantum_forge_api_mjs_y: typeof y;
 declare const __quantum_forge_api_mjs_z: typeof z;
 declare namespace __quantum_forge_api_mjs {
-  export { type __quantum_forge_api_mjs_BatchOp as BatchOp, type __quantum_forge_api_mjs_BatchResult as BatchResult, OP$1 as OP, type __quantum_forge_api_mjs_OpCode as OpCode, type __quantum_forge_api_mjs_OpNum as OpNum, __quantum_forge_api_mjs_Predicate as Predicate, __quantum_forge_api_mjs_QuantumForge as QuantumForge, __quantum_forge_api_mjs_QuantumProperty as QuantumProperty, __quantum_forge_api_mjs_QuantumSimulation as QuantumSimulation, __quantum_forge_api_mjs_clock as clock, __quantum_forge_api_mjs_cycle as cycle, __quantum_forge_api_mjs_executeBatch as executeBatch, __quantum_forge_api_mjs_executeBatchTape as executeBatchTape, __quantum_forge_api_mjs_forced_measure_predicate as forced_measure_predicate, __quantum_forge_api_mjs_forced_measure_properties as forced_measure_properties, __quantum_forge_api_mjs_hadamard as hadamard, __quantum_forge_api_mjs_i_swap as i_swap, __quantum_forge_api_mjs_inverse_hadamard as inverse_hadamard, __quantum_forge_api_mjs_measure_predicate as measure_predicate, __quantum_forge_api_mjs_measure_properties as measure_properties, __quantum_forge_api_mjs_phase_rotate as phase_rotate, __quantum_forge_api_mjs_probabilities as probabilities, __quantum_forge_api_mjs_reduced_density_matrix as reduced_density_matrix, __quantum_forge_api_mjs_reset as reset, __quantum_forge_api_mjs_shift as shift, __quantum_forge_api_mjs_swap as swap, __quantum_forge_api_mjs_x as x, __quantum_forge_api_mjs_y as y, __quantum_forge_api_mjs_z as z };
+  export { type __quantum_forge_api_mjs_BatchOp as BatchOp, type __quantum_forge_api_mjs_BatchResult as BatchResult, OP$1 as OP, type __quantum_forge_api_mjs_OpCode as OpCode, type __quantum_forge_api_mjs_OpNum as OpNum, __quantum_forge_api_mjs_Predicate as Predicate, __quantum_forge_api_mjs_QuantumForge as QuantumForge, __quantum_forge_api_mjs_QuantumProperty as QuantumProperty, __quantum_forge_api_mjs_QuantumSimulation as QuantumSimulation, __quantum_forge_api_mjs_clock as clock, __quantum_forge_api_mjs_cycle as cycle, __quantum_forge_api_mjs_executeBatch as executeBatch, __quantum_forge_api_mjs_executeBatchTape as executeBatchTape, __quantum_forge_api_mjs_forced_measure_predicate as forced_measure_predicate, __quantum_forge_api_mjs_forced_measure_properties as forced_measure_properties, __quantum_forge_api_mjs_hadamard as hadamard, __quantum_forge_api_mjs_i_swap as i_swap, __quantum_forge_api_mjs_inverse_hadamard as inverse_hadamard, __quantum_forge_api_mjs_measure_predicate as measure_predicate, __quantum_forge_api_mjs_measure_properties as measure_properties, __quantum_forge_api_mjs_phase_rotate as phase_rotate, __quantum_forge_api_mjs_predicate_probability as predicate_probability, __quantum_forge_api_mjs_probabilities as probabilities, __quantum_forge_api_mjs_reduced_density_matrix as reduced_density_matrix, __quantum_forge_api_mjs_reset as reset, __quantum_forge_api_mjs_shift as shift, __quantum_forge_api_mjs_swap as swap, __quantum_forge_api_mjs_x as x, __quantum_forge_api_mjs_y as y, __quantum_forge_api_mjs_z as z };
 }
 
 /**

package/dist/quantum-forge-qubit/quantum-forge-web-api.d.mts

@@ -54,7 +54,13 @@ declare function phase_rotate(predicates: Predicate[], angle: number): void;
 declare function measure_properties(props: QuantumProperty[]): number[];
 declare function forced_measure_properties(props: QuantumProperty[], forcedValues: number[]): number[];
 declare function measure_predicate(predicates: Predicate[]): number;
+/** Force a predicate measurement to a specific outcome.
+ *  If the forced value is impossible (zero probability), falls back to
+ *  stochastic measurement and returns the actual outcome instead of throwing. */
 declare function forced_measure_predicate(predicates: Predicate[], forcedValue: number): number;
+/** Get the probability that all predicates are simultaneously satisfied.
+ *  Read-only — does not collapse or modify quantum state. */
+declare function predicate_probability(predicates: Predicate[]): number;
 declare function probabilities(props: QuantumProperty[]): Array<{
     probability: number;
     qudit_values: number[];
@@ -174,4 +180,4 @@ declare class QuantumForge {
     static getMaxStateSize(): number;
 }
 
-export { type BatchOp, type BatchResult, OP, type OpCode, type OpNum, Predicate, QuantumForge, QuantumProperty, QuantumSimulation, clock, cycle, executeBatch, executeBatchTape, forced_measure_predicate, forced_measure_properties, hadamard, i_swap, inverse_hadamard, measure_predicate, measure_properties, phase_rotate, probabilities, reduced_density_matrix, reset, shift, swap, x, y, z };
+export { type BatchOp, type BatchResult, OP, type OpCode, type OpNum, Predicate, QuantumForge, QuantumProperty, QuantumSimulation, clock, cycle, executeBatch, executeBatchTape, forced_measure_predicate, forced_measure_properties, hadamard, i_swap, inverse_hadamard, measure_predicate, measure_properties, phase_rotate, predicate_probability, probabilities, reduced_density_matrix, reset, shift, swap, x, y, z };

package/dist/quantum-forge-qubit/quantum-forge-web-api.mjs

@@ -177,6 +177,11 @@ function forced_measure_predicate(predicates, forcedValue) {
   const cppPredicates = predicates.map((pred) => pred.getCppInstance());
   return wasmModule.forced_measure_predicate(cppPredicates, forcedValue);
 }
+function predicate_probability(predicates) {
+  if (!wasmModule) throw new Error("QuantumForge not initialized. Call QuantumForge.initialize() first.");
+  const cppPredicates = predicates.map((pred) => pred.getCppInstance());
+  return wasmModule.predicate_probability(cppPredicates);
+}
 function probabilities(props) {
   if (!wasmModule) throw new Error("QuantumForge not initialized. Call QuantumForge.initialize() first.");
   const cppProps = props.map((prop) => prop.getCppInstance());
@@ -292,6 +297,7 @@ export {
   measure_predicate,
   measure_properties,
   phase_rotate,
+  predicate_probability,
   probabilities,
   reduced_density_matrix,
   reset,

package/dist/quantum-forge-web-api.d.mts

@@ -54,7 +54,13 @@ declare function phase_rotate(predicates: Predicate[], angle: number): void;
 declare function measure_properties(props: QuantumProperty[]): number[];
 declare function forced_measure_properties(props: QuantumProperty[], forcedValues: number[]): number[];
 declare function measure_predicate(predicates: Predicate[]): number;
+/** Force a predicate measurement to a specific outcome.
+ *  If the forced value is impossible (zero probability), falls back to
+ *  stochastic measurement and returns the actual outcome instead of throwing. */
 declare function forced_measure_predicate(predicates: Predicate[], forcedValue: number): number;
+/** Get the probability that all predicates are simultaneously satisfied.
+ *  Read-only — does not collapse or modify quantum state. */
+declare function predicate_probability(predicates: Predicate[]): number;
 declare function probabilities(props: QuantumProperty[]): Array<{
     probability: number;
     qudit_values: number[];
@@ -174,4 +180,4 @@ declare class QuantumForge {
     static getMaxStateSize(): number;
 }
 
-export { type BatchOp, type BatchResult, OP, type OpCode, type OpNum, Predicate, QuantumForge, QuantumProperty, QuantumSimulation, clock, cycle, executeBatch, executeBatchTape, forced_measure_predicate, forced_measure_properties, hadamard, i_swap, inverse_hadamard, measure_predicate, measure_properties, phase_rotate, probabilities, reduced_density_matrix, reset, shift, swap, x, y, z };
+export { type BatchOp, type BatchResult, OP, type OpCode, type OpNum, Predicate, QuantumForge, QuantumProperty, QuantumSimulation, clock, cycle, executeBatch, executeBatchTape, forced_measure_predicate, forced_measure_properties, hadamard, i_swap, inverse_hadamard, measure_predicate, measure_properties, phase_rotate, predicate_probability, probabilities, reduced_density_matrix, reset, shift, swap, x, y, z };

package/dist/quantum-forge-web-api.mjs

@@ -177,6 +177,11 @@ function forced_measure_predicate(predicates, forcedValue) {
   const cppPredicates = predicates.map((pred) => pred.getCppInstance());
   return wasmModule.forced_measure_predicate(cppPredicates, forcedValue);
 }
+function predicate_probability(predicates) {
+  if (!wasmModule) throw new Error("QuantumForge not initialized. Call QuantumForge.initialize() first.");
+  const cppPredicates = predicates.map((pred) => pred.getCppInstance());
+  return wasmModule.predicate_probability(cppPredicates);
+}
 function probabilities(props) {
   if (!wasmModule) throw new Error("QuantumForge not initialized. Call QuantumForge.initialize() first.");
   const cppProps = props.map((prop) => prop.getCppInstance());
@@ -292,6 +297,7 @@ export {
   measure_predicate,
   measure_properties,
   phase_rotate,
+  predicate_probability,
   probabilities,
   reduced_density_matrix,
   reset,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quantum-forge",
-  "version": "2.5.2",
+  "version": "2.6.0",
   "description": "Quantum Forge WASM loader, property manager, and Vite plugin for quantum game development (Qutrit Edition d3n12 + Qubit Edition d2n20).",
   "type": "module",
   "exports": {