@quantumplayed/quantum-game-engine 1.0.2 → 1.2.0

package/dist/QuantumEntity.d.ts

@@ -1,27 +1,34 @@
-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>;
+    /**
+     * 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,34 @@
-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();
+    }
+    /**
+     * 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 +36,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,64 @@
+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>;
+    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;
+}