@quantumplayed/quantum-game-engine 1.0.3 → 1.2.1

package/dist/Operations.js

@@ -152,6 +152,92 @@ export const Operations = {
                 return cleanAmplitudes(newAmps);
             }
         };
+    },
+    // High-level helper: split a state into equal superposition of target states (1/√N)
+    Split(from, targets) {
+        if (!targets || targets.length === 0) {
+            throw new Error("Split requires at least one target state.");
+        }
+        const ampVal = 1 / Math.sqrt(targets.length);
+        const transitions = targets.map(to => ({
+            from,
+            to,
+            amplitude: { re: ampVal, im: 0 }
+        }));
+        return Operations.SparseTransition(transitions);
+    },
+    // High-level helper: branch a state into weighted probabilities
+    Branch(from, branches) {
+        if (!branches || branches.length === 0) {
+            throw new Error("Branch requires at least one target branch.");
+        }
+        const totalWeight = branches.reduce((acc, b) => acc + b.weight, 0);
+        if (totalWeight <= 0) {
+            throw new Error("Total branch weight must be positive.");
+        }
+        const transitions = branches.map(b => ({
+            from,
+            to: b.to,
+            amplitude: { re: Math.sqrt(b.weight / totalWeight), im: 0 }
+        }));
+        return Operations.SparseTransition(transitions);
+    },
+    // High-level helper: apply phase rotation in degrees
+    PhaseDegrees(degrees) {
+        return {
+            name: "PhaseDegrees",
+            params: { degrees },
+            apply(amplitudes, dimension) {
+                const newAmps = {};
+                const rad = (degrees * Math.PI) / 180;
+                for (const key in amplitudes) {
+                    const k = parseInt(key);
+                    const amp = amplitudes[key];
+                    const angle = rad * k;
+                    const phase = ComplexMath.phase(angle);
+                    newAmps[k] = ComplexMath.multiply(amp, phase);
+                }
+                return cleanAmplitudes(newAmps);
+            }
+        };
+    },
+    // Continuous 2-level unitary rotation (Givens / Ry-style rotation) between two basis states:
+    // |stateA⟩ ->  cos(theta)|stateA⟩ + sin(theta)|stateB⟩
+    // |stateB⟩ -> -sin(theta)|stateA⟩ + cos(theta)|stateB⟩
+    // Composable, reversible, and accounts for constructive/destructive interference.
+    Rotate(stateA, stateB, theta) {
+        if (stateA === stateB) {
+            throw new Error("Rotate requires two distinct basis states.");
+        }
+        return {
+            name: "Rotate",
+            params: { stateA, stateB, theta },
+            apply(amplitudes, _dimension) {
+                const cosT = Math.cos(theta);
+                const sinT = Math.sin(theta);
+                const newAmps = {};
+                for (const key in amplitudes) {
+                    const k = parseInt(key);
+                    const amp = amplitudes[key];
+                    if (k === stateA) {
+                        const termA = ComplexMath.scale(amp, cosT);
+                        const termB = ComplexMath.scale(amp, sinT);
+                        newAmps[stateA] = ComplexMath.add(newAmps[stateA] ?? { re: 0, im: 0 }, termA);
+                        newAmps[stateB] = ComplexMath.add(newAmps[stateB] ?? { re: 0, im: 0 }, termB);
+                    }
+                    else if (k === stateB) {
+                        const termA = ComplexMath.scale(amp, -sinT);
+                        const termB = ComplexMath.scale(amp, cosT);
+                        newAmps[stateA] = ComplexMath.add(newAmps[stateA] ?? { re: 0, im: 0 }, termA);
+                        newAmps[stateB] = ComplexMath.add(newAmps[stateB] ?? { re: 0, im: 0 }, termB);
+                    }
+                    else {
+                        newAmps[k] = ComplexMath.add(newAmps[k] ?? { re: 0, im: 0 }, amp);
+                    }
+                }
+                return cleanAmplitudes(newAmps);
+            }
+        };
     }
 };
 //# sourceMappingURL=Operations.js.map

package/dist/Operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"Operations.js","sourceRoot":"","sources":["../src/Operations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Operations.js","sourceRoot":"","sources":["../src/Operations.ts"],"names":[],"mappings":"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"}

package/dist/QuantumEntity.d.ts

@@ -1,27 +1,43 @@
-import { type QuantumOperation, type SparseAmplitudes } from './Operations.js';
-import { type Complex } from './Complex.js';
-import { type JointQuantumSystem } from './EntanglementEngine.js';
-export interface Predicate {
-    entity: QuantumEntity;
-    state: number;
-}
+import { QuantumSystem, type Predicate, type TargetOperation } from "./QuantumSystem.js";
+import { type QuantumOperation } from "./Operations.js";
+import { type Complex } from "./Complex.js";
+export { type Predicate, type TargetOperation, QuantumSystem };
 export declare class QuantumEntity {
     private static _nextId;
     readonly id: number;
     dimension: number;
-    amplitudes: SparseAmplitudes;
-    entangledSystem?: JointQuantumSystem;
+    system: QuantumSystem;
     constructor(options: {
         dimension: number;
         initialState: number;
     });
     /** Reset the auto-increment counter (useful in tests). */
     static resetIdCounter(): void;
+    /**
+     * Always returns the current amplitudes for this entity.
+     * When entangled, returns the marginal branch amplitudes.
+     */
+    get amplitudes(): Record<number, Complex>;
+    set amplitudes(amps: Record<number, Complex>);
+    /**
+     * Set the amplitudes for this entity in-place.
+     * If the entity was previously entangled with other entities, it detaches into a standalone 1-entity system.
+     * By default, normalizes the amplitude vector so total probability equals 1.0.
+     */
+    setAmplitudes(amplitudes: Record<number, Complex>, options?: {
+        normalize?: boolean;
+    }): void;
+    /**
+     * Backwards-compatible handle to the entangled system.
+     * Returns the joint system if entangled with other entities, otherwise undefined.
+     */
+    get entangledSystem(): QuantumSystem | undefined;
     is(state: number): Predicate;
-    apply(operation: QuantumOperation, controls?: Predicate[]): void;
+    apply(operation: QuantumOperation, controls?: Predicate[]): QuantumSystem | undefined;
     measure(forcedOutcome?: number): number;
     getProbabilities(): Record<number, number>;
+    getProbabilityOf(state: number): number;
+    getProbabilityArray(): number[];
     getAmplitudes(): Record<number, Complex>;
     getReducedDensityMatrix(): Record<number, Record<number, Complex>>;
-    setState(amplitudes: SparseAmplitudes): void;
 }

package/dist/QuantumEntity.js

@@ -1,22 +1,48 @@
-import { ComplexMath } from './Complex.js';
-import { EntanglementEngine } from './EntanglementEngine.js';
-import { CircuitLogger } from './CircuitLog.js';
+import { QuantumSystem } from "./QuantumSystem.js";
+import { CircuitLogger } from "./CircuitLog.js";
+export { QuantumSystem };
 export class QuantumEntity {
     static _nextId = 0;
     id;
     dimension;
-    amplitudes;
-    entangledSystem;
+    system;
     constructor(options) {
         this.id = QuantumEntity._nextId++;
         this.dimension = options.dimension;
-        this.amplitudes = {};
-        this.amplitudes[options.initialState] = { re: 1.0, im: 0.0 };
+        this.system = new QuantumSystem([this], options.initialState);
     }
     /** Reset the auto-increment counter (useful in tests). */
     static resetIdCounter() {
         QuantumEntity._nextId = 0;
     }
+    /**
+     * Always returns the current amplitudes for this entity.
+     * When entangled, returns the marginal branch amplitudes.
+     */
+    get amplitudes() {
+        return this.getAmplitudes();
+    }
+    set amplitudes(amps) {
+        this.setAmplitudes(amps, { normalize: false });
+    }
+    /**
+     * Set the amplitudes for this entity in-place.
+     * If the entity was previously entangled with other entities, it detaches into a standalone 1-entity system.
+     * By default, normalizes the amplitude vector so total probability equals 1.0.
+     */
+    setAmplitudes(amplitudes, options) {
+        if (this.system.entities.length > 1) {
+            this.system = new QuantumSystem([this], 0);
+        }
+        this.system.setAmplitudes(amplitudes, options);
+    }
+    /**
+     * Backwards-compatible handle to the entangled system.
+     * Returns the joint system if entangled with other entities, otherwise undefined.
+     */
+    get entangledSystem() {
+        return this.system.entities.length > 1 ? this.system : undefined;
+    }
     // Return a Predicate for conditional interactions
     is(state) {
         return { entity: this, state };
@@ -24,119 +50,53 @@ export class QuantumEntity {
     // Apply an operation directly to this entity, optionally conditionally
     apply(operation, controls) {
         if (controls && controls.length > 0) {
-            // conditionalInteract will handle its own logging
-            EntanglementEngine.conditionalInteract({
-                controls: controls,
+            return QuantumSystem.conditionalInteract({
+                controls,
                 targets: [{ entity: this, operation }]
             });
-            return;
         }
-        if (this.entangledSystem) {
-            const index = this.entangledSystem.entities.indexOf(this);
-            this.entangledSystem.applyLocal(index, operation);
+        if (this.system.entities.length > 1) {
+            this.system.applyToSubspace([this], operation);
+            return this.system;
         }
         else {
-            this.amplitudes = operation.apply(this.amplitudes, this.dimension);
-        }
-        // Log single-entity gate (non-conditional path)
-        if (CircuitLogger.isRecording()) {
-            CircuitLogger.addGate(operation.name, [this.id], [this.dimension], operation.params);
+            this.system.applyLocal(0, operation);
+            if (CircuitLogger.isRecording()) {
+                CircuitLogger.addGate(operation.name, [this.id], [this.dimension], operation.params);
+            }
+            return undefined;
         }
     }
     // Measure the entity, collapsing its state.
     // If forcedOutcome is provided (0..dimension-1), collapse directly to that state.
     measure(forcedOutcome) {
-        if (this.entangledSystem) {
-            // measureTarget handles its own logging
-            return this.entangledSystem.measureTarget(this, forcedOutcome);
-        }
-        // Forced outcome — collapse directly
-        if (forcedOutcome !== undefined) {
-            this.amplitudes = { [forcedOutcome]: { re: 1.0, im: 0.0 } };
-            if (CircuitLogger.isRecording()) {
-                CircuitLogger.addMeasurement(this.id, this.dimension, forcedOutcome);
-            }
-            return forcedOutcome;
-        }
-        const rand = Math.random();
-        let cumulativeProb = 0;
-        for (const key in this.amplitudes) {
-            const k = parseInt(key);
-            const amp = this.amplitudes[k];
-            const prob = amp.re * amp.re + amp.im * amp.im;
-            cumulativeProb += prob;
-            if (rand <= cumulativeProb) {
-                // Collapse!
-                this.amplitudes = { [k]: { re: 1.0, im: 0.0 } };
-                if (CircuitLogger.isRecording()) {
-                    CircuitLogger.addMeasurement(this.id, this.dimension, k);
-                }
-                return k;
-            }
-        }
-        // Fallback for floating point error
-        const keys = Object.keys(this.amplitudes);
-        if (keys.length === 0) {
-            throw new Error("Cannot measure an entity with 0 probability mass (Decoherence error)");
-        }
-        const k = parseInt(keys[keys.length - 1]);
-        this.amplitudes = { [k]: { re: 1.0, im: 0.0 } };
-        if (CircuitLogger.isRecording()) {
-            CircuitLogger.addMeasurement(this.id, this.dimension, k);
-        }
-        return k;
+        return this.system.measureEntity(this, forcedOutcome);
     }
     // Extract the raw probability map for UIs
     getProbabilities() {
-        if (this.entangledSystem) {
-            return this.entangledSystem.getTargetProbabilities(this);
-        }
-        const probs = {};
-        for (const key in this.amplitudes) {
-            const k = parseInt(key);
-            const amp = this.amplitudes[k];
-            probs[k] = amp.re * amp.re + amp.im * amp.im;
-        }
-        return probs;
+        return this.system.getEntityProbabilities(this);
     }
-    // Extract raw complex amplitudes (Useful for phase interference logic in games)
+    // Get probability of a specific state
+    getProbabilityOf(state) {
+        return this.getProbabilities()[state] ?? 0;
+    }
+    // Extract fixed-length probability array [P(0), P(1), ..., P(D-1)]
+    getProbabilityArray() {
+        const probs = this.getProbabilities();
+        const arr = new Array(this.dimension).fill(0);
+        for (const [k, p] of Object.entries(probs)) {
+            arr[parseInt(k)] = p;
+        }
+        return arr;
+    }
+    // Extract raw complex amplitudes
     getAmplitudes() {
-        if (this.entangledSystem) {
-            return this.entangledSystem.getTargetAmplitudes(this);
-        }
-        const amps = {};
-        for (const key in this.amplitudes) {
-            const k = parseInt(key);
-            amps[k] = { ...this.amplitudes[k] };
-        }
-        return amps;
+        return this.system.getEntityAmplitudes(this);
     }
     // Get the One-Body Reduced Density Matrix
     // Diagonal elements = classical probability. Off-diagonal elements = coherence.
     getReducedDensityMatrix() {
-        if (this.entangledSystem) {
-            return this.entangledSystem.getReducedDensityMatrix(this);
-        }
-        // Pure state density matrix: rho_{j,k} = c_j * c_k^*
-        const rho = {};
-        for (const [jStr, ampJ] of Object.entries(this.amplitudes)) {
-            const j = parseInt(jStr);
-            if (!rho[j])
-                rho[j] = {};
-            for (const [kStr, ampK] of Object.entries(this.amplitudes)) {
-                const k = parseInt(kStr);
-                const ampKStar = ComplexMath.conjugate(ampK);
-                rho[j][k] = ComplexMath.multiply(ampJ, ampKStar);
-            }
-        }
-        return rho;
-    }
-    // Manually set the state (Use with caution, primarily for state restoration/cloning)
-    setState(amplitudes) {
-        if (this.entangledSystem) {
-            throw new Error("Cannot manually set state of an entangled entity. Set the state on the JointQuantumSystem instead.");
-        }
-        this.amplitudes = { ...amplitudes };
+        return this.system.getEntityReducedDensityMatrix(this);
     }
 }
 //# sourceMappingURL=QuantumEntity.js.map

package/dist/QuantumEntity.js.map

@@ -1 +1 @@
-{"version":3,"file":"QuantumEntity.js","sourceRoot":"","sources":["../src/QuantumEntity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"QuantumEntity.js","sourceRoot":"","sources":["../src/QuantumEntity.ts"],"names":[],"mappings":"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"}

package/dist/QuantumSystem.d.ts

@@ -0,0 +1,71 @@
+import { type Complex } from "./Complex.js";
+import { type QuantumOperation, type SparseAmplitudes } from "./Operations.js";
+import type { QuantumEntity } from "./QuantumEntity.js";
+export interface Predicate {
+    entity: QuantumEntity;
+    state: number;
+}
+export interface TargetOperation {
+    entity: QuantumEntity;
+    operation: QuantumOperation;
+}
+export declare class QuantumSystem {
+    private static _nextId;
+    static maxDimensionLimit: number;
+    static setMaxDimensionLimit(limit: number): void;
+    static resetIdCounter(): void;
+    readonly id: number;
+    entities: QuantumEntity[];
+    dimensions: number[];
+    dimension: number;
+    amplitudes: SparseAmplitudes;
+    get totalDimension(): number;
+    get jointAmplitudes(): SparseAmplitudes;
+    set jointAmplitudes(val: SparseAmplitudes);
+    constructor(entities: QuantumEntity[], initialStateOrAmplitudes?: number | SparseAmplitudes);
+    is(state: number): Predicate;
+    decomposeState(jointState: number): number[];
+    composeState(states: number[]): number;
+    getProbabilities(): Record<number, number>;
+    getProbabilityOf(state: number): number;
+    getProbabilityArray(): number[];
+    getAmplitudes(): Record<number, Complex>;
+    /**
+     * Set the amplitudes of this system in-place.
+     * By default, normalizes the amplitude vector so total probability equals 1.0.
+     */
+    setAmplitudes(amplitudes: SparseAmplitudes, options?: {
+        normalize?: boolean;
+    }): void;
+    getEntityProbabilities(targetEntity: QuantumEntity): Record<number, number>;
+    getTargetProbabilities(targetEntity: QuantumEntity): Record<number, number>;
+    getEntityAmplitudes(targetEntity: QuantumEntity): Record<number, Complex>;
+    getTargetAmplitudes(targetEntity: QuantumEntity): Record<number, Complex>;
+    getEntityReducedDensityMatrix(targetEntity: QuantumEntity): Record<number, Record<number, Complex>>;
+    getReducedDensityMatrix(targetEntity: QuantumEntity): Record<number, Record<number, Complex>>;
+    applyLocal(entityIndex: number, operation: QuantumOperation): void;
+    applyToSubspace(targetEntities: QuantumEntity[], operation: QuantumOperation): void;
+    measure(forcedOutcome?: number): number;
+    measureEntity(targetEntity: QuantumEntity, forcedOutcome?: number): number;
+    measureTarget(targetEntity: QuantumEntity, forcedOutcome?: number): number;
+    getProjectedAmplitudes(conditions: {
+        entity: QuantumEntity;
+        state: number;
+    }[]): SparseAmplitudes;
+    getJointProbability(conditions: {
+        entity: QuantumEntity;
+        state: number;
+    }[]): number;
+    areMutuallyExclusive(conditions: {
+        entity: QuantumEntity;
+        state: number;
+    }[]): boolean;
+    static create(entities: QuantumEntity[]): QuantumSystem;
+    static inject(entities: QuantumEntity[], jointAmplitudes: SparseAmplitudes): QuantumSystem;
+    static merge(involvedEntities: QuantumEntity[]): QuantumSystem;
+    static interact(entities: QuantumEntity[], operation: QuantumOperation): void;
+    static conditionalInteract(args: {
+        controls: Predicate[];
+        targets: TargetOperation[];
+    }): QuantumSystem;
+}