@quantumplayed/quantum-game-engine 1.0.0

package/dist/EntanglementEngine.js

@@ -0,0 +1,456 @@
+import { cleanAmplitudes } from './Operations';
+import { ComplexMath } from './Complex';
+import { CircuitLogger } from './CircuitLog';
+export class JointQuantumSystem {
+    entities;
+    dimensions;
+    totalDimension;
+    jointAmplitudes;
+    // Internal constructor used by merge
+    constructor(entities, initializeAmplitudes = true) {
+        this.entities = entities;
+        this.dimensions = entities.map(e => e.dimension);
+        this.totalDimension = this.dimensions.reduce((acc, dim) => acc * dim, 1);
+        if (this.totalDimension > 10000000) {
+            throw new Error(`QuantumLimitExceeded: Attempted to entangle a system of dimension ${this.totalDimension}. Maximum allowed is 10M.`);
+        }
+        if (initializeAmplitudes) {
+            this.jointAmplitudes = this._calculateTensorProduct(entities);
+            for (const entity of entities) {
+                // Point that entity to this system
+                entity.entangledSystem = this;
+                // This entity no longer has its own amplitudes
+                entity.amplitudes = {};
+            }
+        }
+        else {
+            this.jointAmplitudes = {};
+        }
+    }
+    static create(entities) {
+        return new JointQuantumSystem(entities, true);
+    }
+    static merge(involvedEntities) {
+        const uniqueSystems = new Set();
+        const standaloneEntities = [];
+        for (const entity of involvedEntities) {
+            if (entity.entangledSystem) {
+                uniqueSystems.add(entity.entangledSystem);
+            }
+            else {
+                standaloneEntities.push(entity);
+            }
+        }
+        if (uniqueSystems.size === 0) {
+            return JointQuantumSystem.create(involvedEntities);
+        }
+        if (uniqueSystems.size === 1 && standaloneEntities.length === 0) {
+            return Array.from(uniqueSystems)[0];
+        }
+        const mergedEntities = [];
+        const systemsArray = Array.from(uniqueSystems);
+        for (const sys of systemsArray) {
+            mergedEntities.push(...sys.entities);
+        }
+        mergedEntities.push(...standaloneEntities);
+        const newSystem = new JointQuantumSystem(mergedEntities, false);
+        let currentAmplitudes = { 0: { re: 1.0, im: 0.0 } };
+        let currentTotalDim = 1;
+        for (const sys of systemsArray) {
+            const nextAmps = {};
+            const nextDim = sys.totalDimension;
+            for (const [k1Str, amp1] of Object.entries(currentAmplitudes)) {
+                for (const [k2Str, amp2] of Object.entries(sys.jointAmplitudes)) {
+                    const jointK = (parseInt(k1Str) * nextDim) + parseInt(k2Str);
+                    nextAmps[jointK] = ComplexMath.multiply(amp1, amp2);
+                }
+            }
+            currentAmplitudes = cleanAmplitudes(nextAmps);
+            currentTotalDim *= nextDim;
+        }
+        for (const entity of standaloneEntities) {
+            const nextAmps = {};
+            const nextDim = entity.dimension;
+            for (const [k1Str, amp1] of Object.entries(currentAmplitudes)) {
+                for (const [k2Str, amp2] of Object.entries(entity.amplitudes)) {
+                    const jointK = (parseInt(k1Str) * nextDim) + parseInt(k2Str);
+                    nextAmps[jointK] = ComplexMath.multiply(amp1, amp2);
+                }
+            }
+            currentAmplitudes = cleanAmplitudes(nextAmps);
+            currentTotalDim *= nextDim;
+        }
+        newSystem.jointAmplitudes = currentAmplitudes;
+        for (const entity of mergedEntities) {
+            entity.entangledSystem = newSystem;
+            entity.amplitudes = {};
+        }
+        return newSystem;
+    }
+    _calculateTensorProduct(entities) {
+        let currentAmplitudes = { 0: { re: 1.0, im: 0.0 } };
+        let currentTotalDim = 1;
+        for (const entity of entities) {
+            const nextAmps = {};
+            const nextDim = entity.dimension;
+            for (const [k1Str, amp1] of Object.entries(currentAmplitudes)) {
+                for (const [k2Str, amp2] of Object.entries(entity.amplitudes)) {
+                    const k1 = parseInt(k1Str);
+                    const k2 = parseInt(k2Str);
+                    // The new basis integer: shift the left side by the new dimension size
+                    // E.g., if A is in state 2 (dim 4) and B is in state 1 (dim 4)
+                    // Joint state = (2 * 4) + 1 = 9
+                    const jointK = (k1 * nextDim) + k2;
+                    const jointAmp = ComplexMath.multiply(amp1, amp2);
+                    nextAmps[jointK] = jointAmp;
+                }
+            }
+            currentAmplitudes = nextAmps;
+            currentTotalDim *= nextDim;
+        }
+        return currentAmplitudes;
+    }
+    // Helper to decompose a joint basis integer back into individual state indices
+    decomposeState(jointState) {
+        const states = new Array(this.dimensions.length);
+        let remainder = jointState;
+        for (let i = this.dimensions.length - 1; i >= 0; i--) {
+            const dim = this.dimensions[i];
+            states[i] = remainder % dim;
+            remainder = Math.floor(remainder / dim);
+        }
+        return states;
+    }
+    // Helper to compose individual state indices into a joint basis integer
+    composeState(states) {
+        let jointState = 0;
+        for (let i = 0; i < states.length; i++) {
+            jointState = (jointState * this.dimensions[i]) + states[i];
+        }
+        return jointState;
+    }
+    applyLocal(entityIndex, operation) {
+        this.applyToSubspace([this.entities[entityIndex]], operation);
+    }
+    applyToSubspace(targetEntities, operation) {
+        const targetIndices = targetEntities.map(e => this.entities.indexOf(e));
+        if (targetIndices.some(i => i === -1)) {
+            throw new Error("Target entities not in joint system");
+        }
+        const targetDimensions = targetIndices.map(i => this.dimensions[i]);
+        const targetTotalDim = targetDimensions.reduce((a, b) => a * b, 1);
+        const newAmps = {};
+        const spectatorIndices = [];
+        for (let i = 0; i < this.entities.length; i++) {
+            if (!targetIndices.includes(i))
+                spectatorIndices.push(i);
+        }
+        const composeSubspace = (states, indices, dims) => {
+            let k = 0;
+            for (let i = 0; i < indices.length; i++) {
+                k = (k * dims[i]) + states[indices[i]];
+            }
+            return k;
+        };
+        const bMap = {};
+        for (const [jointKStr, amp] of Object.entries(this.jointAmplitudes)) {
+            const jointK = parseInt(jointKStr);
+            const states = this.decomposeState(jointK);
+            let specKey = "";
+            for (const idx of spectatorIndices) {
+                specKey += states[idx] + ",";
+            }
+            if (!bMap[specKey])
+                bMap[specKey] = {};
+            const targetK = composeSubspace(states, targetIndices, targetDimensions);
+            bMap[specKey][targetK] = amp;
+        }
+        for (const specKey in bMap) {
+            const subspaceAmps = bMap[specKey];
+            const resultAmps = operation.apply(subspaceAmps, targetTotalDim);
+            const spectatorStates = specKey === "" ? [] : specKey.split(",").slice(0, -1).map(Number);
+            for (const [newTargetKStr, newAmp] of Object.entries(resultAmps)) {
+                const newTargetK = parseInt(newTargetKStr);
+                const newTargetStates = new Array(targetIndices.length);
+                let remainder = newTargetK;
+                for (let i = targetIndices.length - 1; i >= 0; i--) {
+                    newTargetStates[i] = remainder % targetDimensions[i];
+                    remainder = Math.floor(remainder / targetDimensions[i]);
+                }
+                const newFullStates = new Array(this.entities.length);
+                let specI = 0;
+                for (let i = 0; i < this.entities.length; i++) {
+                    const tIndex = targetIndices.indexOf(i);
+                    if (tIndex !== -1) {
+                        newFullStates[i] = newTargetStates[tIndex];
+                    }
+                    else {
+                        newFullStates[i] = spectatorStates[specI++];
+                    }
+                }
+                const newJointK = this.composeState(newFullStates);
+                if (!newAmps[newJointK])
+                    newAmps[newJointK] = { re: 0, im: 0 };
+                newAmps[newJointK] = ComplexMath.add(newAmps[newJointK], newAmp);
+            }
+        }
+        this.jointAmplitudes = cleanAmplitudes(newAmps);
+    }
+    getTargetProbabilities(targetEntity) {
+        const targetIndex = this.entities.indexOf(targetEntity);
+        if (targetIndex === -1)
+            throw new Error("Entity is not in this joint system");
+        const probs = {};
+        for (const [jointKStr, amp] of Object.entries(this.jointAmplitudes)) {
+            const jointK = parseInt(jointKStr);
+            const states = this.decomposeState(jointK);
+            const targetState = states[targetIndex];
+            const prob = ComplexMath.magnitudeSquared(amp);
+            probs[targetState] = (probs[targetState] || 0) + prob;
+        }
+        return probs;
+    }
+    getTargetAmplitudes(targetEntity) {
+        const targetIndex = this.entities.indexOf(targetEntity);
+        if (targetIndex === -1)
+            throw new Error("Entity is not in this joint system");
+        const amps = {};
+        for (const [jointKStr, amp] of Object.entries(this.jointAmplitudes)) {
+            const jointK = parseInt(jointKStr);
+            const states = this.decomposeState(jointK);
+            const targetState = states[targetIndex];
+            // If a system strictly has 1 entity, this is identical to pure amplitudes.
+            // For entangled systems, this simply sums the complex amplitudes across orthogonal bases
+            // which serves as an operational branch-phase for game logic purposes in this prototype.
+            if (!amps[targetState]) {
+                amps[targetState] = { re: 0, im: 0 };
+            }
+            amps[targetState] = ComplexMath.add(amps[targetState], amp);
+        }
+        return amps;
+    }
+    measureTarget(targetEntity, forcedOutcome) {
+        const targetIndex = this.entities.indexOf(targetEntity);
+        if (targetIndex === -1)
+            throw new Error("Entity is not in this joint system");
+        const marginalProbs = this.getTargetProbabilities(targetEntity);
+        let selectedState;
+        if (forcedOutcome !== undefined) {
+            // Forced outcome — skip random selection
+            selectedState = forcedOutcome;
+        }
+        else {
+            const rand = Math.random();
+            let cumulativeProb = 0;
+            selectedState = -1;
+            for (const [stateStr, prob] of Object.entries(marginalProbs)) {
+                const state = parseInt(stateStr);
+                cumulativeProb += prob;
+                if (rand <= cumulativeProb) {
+                    selectedState = state;
+                    break;
+                }
+            }
+            if (selectedState === -1) {
+                const keys = Object.keys(marginalProbs);
+                selectedState = parseInt(keys[keys.length - 1]);
+            }
+        }
+        // Now we must COLLAPSE the joint system.
+        // We throw away any joint states where the targetEntity != selectedState
+        // and we normalize the remaining amplitudes.
+        const collapsedAmps = {};
+        const prob = marginalProbs[selectedState] ?? 0;
+        const normalizationFactor = prob > 0 ? 1.0 / Math.sqrt(prob) : 1.0;
+        for (const [jointKStr, amp] of Object.entries(this.jointAmplitudes)) {
+            const jointK = parseInt(jointKStr);
+            const states = this.decomposeState(jointK);
+            if (states[targetIndex] === selectedState) {
+                // Keep this branch, but scale it to ensure total probability remains 1.0
+                collapsedAmps[jointK] = ComplexMath.scale(amp, normalizationFactor);
+            }
+        }
+        this.jointAmplitudes = cleanAmplitudes(collapsedAmps);
+        if (CircuitLogger.isRecording()) {
+            CircuitLogger.addMeasurement(targetEntity.id, targetEntity.dimension, selectedState);
+        }
+        return selectedState;
+    }
+    getProjectedAmplitudes(conditions) {
+        const mappedConditions = conditions.map(c => {
+            const index = this.entities.indexOf(c.entity);
+            if (index === -1)
+                throw new Error("Entity in condition is not in this joint system");
+            return { index, requiredState: c.state };
+        });
+        const projectedAmps = {};
+        for (const [jointKStr, amp] of Object.entries(this.jointAmplitudes)) {
+            const jointK = parseInt(jointKStr);
+            const states = this.decomposeState(jointK);
+            let allMatch = true;
+            for (const cond of mappedConditions) {
+                if (states[cond.index] !== cond.requiredState) {
+                    allMatch = false;
+                    break;
+                }
+            }
+            if (allMatch) {
+                projectedAmps[jointK] = amp;
+            }
+        }
+        return projectedAmps;
+    }
+    getJointProbability(conditions) {
+        const projectedAmps = this.getProjectedAmplitudes(conditions);
+        let prob = 0;
+        for (const [_, amp] of Object.entries(projectedAmps)) {
+            prob += ComplexMath.magnitudeSquared(amp);
+        }
+        return prob;
+    }
+    areMutuallyExclusive(conditions) {
+        return this.getJointProbability(conditions) < 1e-10;
+    }
+    // Calculates the reduced density matrix by taking the partial trace over all other entities
+    getReducedDensityMatrix(targetEntity) {
+        const targetIndex = this.entities.indexOf(targetEntity);
+        if (targetIndex === -1)
+            throw new Error("Entity is not in this joint system");
+        const rho = {};
+        // We want to calculate rho_{a, a'} = sum_b C_{a,b} C_{a',b}^*
+        // To do this efficiently with sparse joint amplitudes, we group amplitudes by 'b'
+        // 'b' is the combined state of all OUTSIDE entities.
+        const bMap = {};
+        for (const [jointKStr, amp] of Object.entries(this.jointAmplitudes)) {
+            const jointK = parseInt(jointKStr);
+            const states = this.decomposeState(jointK);
+            const a = states[targetIndex];
+            // create string key for all outside states
+            let bKey = "";
+            for (let i = 0; i < states.length; i++) {
+                if (i !== targetIndex)
+                    bKey += states[i] + ",";
+            }
+            if (!bMap[bKey])
+                bMap[bKey] = [];
+            bMap[bKey].push({ a, amp });
+        }
+        // Now calculate the inner product for each 'b'
+        for (const bKey in bMap) {
+            const terms = bMap[bKey];
+            for (let i = 0; i < terms.length; i++) {
+                const a = terms[i].a;
+                const ampA = terms[i].amp;
+                if (!rho[a])
+                    rho[a] = {};
+                for (let j = 0; j < terms.length; j++) {
+                    const aPrime = terms[j].a;
+                    const ampAPrimeStar = ComplexMath.conjugate(terms[j].amp);
+                    const product = ComplexMath.multiply(ampA, ampAPrimeStar);
+                    if (!rho[a][aPrime])
+                        rho[a][aPrime] = { re: 0, im: 0 };
+                    rho[a][aPrime] = ComplexMath.add(rho[a][aPrime], product);
+                }
+            }
+        }
+        // Note: we could filter out zero entries to maintain sparsity, 
+        // but density matrices for small entities are generally dense anyway.
+        return rho;
+    }
+    /**
+     * Create a joint system from existing amplitudes and entities (Bit-Perfect Restoration/Cloning).
+     */
+    static inject(entities, jointAmplitudes) {
+        const sys = new JointQuantumSystem(entities, false); // Don't auto-calculate tensor product
+        sys.jointAmplitudes = { ...jointAmplitudes };
+        for (const entity of entities) {
+            entity.entangledSystem = sys;
+            entity.amplitudes = {}; // Standalone state is now absorbed into the joint system
+        }
+        return sys;
+    }
+}
+export const EntanglementEngine = {
+    interactMany(entities, operation) {
+        if (entities.length === 0)
+            return;
+        const system = JointQuantumSystem.merge(entities);
+        system.applyToSubspace(entities, operation);
+        if (CircuitLogger.isRecording()) {
+            CircuitLogger.addGate('InteractMany', entities.map(e => e.id), entities.map(e => e.dimension));
+        }
+    },
+    conditionalInteract(args) {
+        // Collect all entities involved
+        const allEntities = [
+            ...args.controls.map(c => c.entity),
+            ...args.targets.map(t => t.entity)
+        ];
+        // Remove duplicates
+        const uniqueEntities = Array.from(new Set(allEntities));
+        // Form a new joint system
+        const system = JointQuantumSystem.merge(uniqueEntities);
+        const newAmps = {};
+        for (const [jointKStr, amp] of Object.entries(system.jointAmplitudes)) {
+            const jointK = parseInt(jointKStr);
+            let states = system.decomposeState(jointK);
+            // Check condition: do all control entities match their required state?
+            let conditionMet = true;
+            for (const control of args.controls) {
+                const entityIndex = system.entities.indexOf(control.entity);
+                if (states[entityIndex] !== control.state) {
+                    conditionMet = false;
+                    break;
+                }
+            }
+            if (conditionMet) {
+                // We need to apply all target operations to this branch.
+                // This is mathematically tricky because an operation could split a branch!
+                // For this MVP, we assume target operations for conditional interacts are simple Shifts (permutations).
+                // We simulate sequential application on this single branch
+                let currentBranchAmps = { [jointK]: amp };
+                for (const target of args.targets) {
+                    const targetEntityIndex = system.entities.indexOf(target.entity);
+                    const targetDim = system.dimensions[targetEntityIndex];
+                    const nextBranchAmps = {};
+                    for (const [bJointKStr, bAmp] of Object.entries(currentBranchAmps)) {
+                        const bJointK = parseInt(bJointKStr);
+                        const bStates = system.decomposeState(bJointK);
+                        const targetState = bStates[targetEntityIndex];
+                        // Apply operation locally
+                        const localRes = target.operation.apply({ [targetState]: bAmp }, targetDim);
+                        // Re-integrate
+                        for (const [newTargetStateStr, newAmp] of Object.entries(localRes)) {
+                            const newStates = [...bStates];
+                            newStates[targetEntityIndex] = parseInt(newTargetStateStr);
+                            const newJointK = system.composeState(newStates);
+                            if (!nextBranchAmps[newJointK])
+                                nextBranchAmps[newJointK] = { re: 0, im: 0 };
+                            nextBranchAmps[newJointK] = ComplexMath.add(nextBranchAmps[newJointK], newAmp);
+                        }
+                    }
+                    currentBranchAmps = nextBranchAmps;
+                }
+                // Add the result of the branch to newAmps
+                for (const [resKStr, resAmp] of Object.entries(currentBranchAmps)) {
+                    const resK = parseInt(resKStr);
+                    // Add this resulting state back to the new sparse tree
+                    if (!newAmps[resK])
+                        newAmps[resK] = { re: 0, im: 0 };
+                    newAmps[resK] = ComplexMath.add(newAmps[resK], resAmp);
+                }
+            }
+            else {
+                // Condition not met, branch applies unchanged
+                if (!newAmps[jointK])
+                    newAmps[jointK] = { re: 0, im: 0 };
+                newAmps[jointK] = ComplexMath.add(newAmps[jointK], amp);
+            }
+        }
+        system.jointAmplitudes = cleanAmplitudes(newAmps);
+        if (CircuitLogger.isRecording()) {
+            CircuitLogger.addGate('ConditionalInteract', args.targets.map(t => t.entity.id), args.targets.map(t => t.entity.dimension), undefined, args.controls.map(c => ({ entityId: c.entity.id, state: c.state })));
+        }
+    }
+};
+//# sourceMappingURL=EntanglementEngine.js.map

package/dist/EntanglementEngine.js.map

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

package/dist/Operations.d.ts

@@ -0,0 +1,18 @@
+import { Complex } from './Complex';
+export type SparseAmplitudes = {
+    [state: number]: Complex;
+};
+export interface QuantumOperation {
+    apply(amplitudes: SparseAmplitudes, dimension: number): SparseAmplitudes;
+}
+export declare function cleanAmplitudes(amplitudes: SparseAmplitudes, epsilon?: number): SparseAmplitudes;
+export declare const Operations: {
+    Shift(amount?: number): QuantumOperation;
+    Phase(multiplier?: number): QuantumOperation;
+    Hadamard(): QuantumOperation;
+    SparseTransition(transitions: {
+        from: number;
+        to: number;
+        amplitude: Complex;
+    }[]): QuantumOperation;
+};

package/dist/Operations.js

@@ -0,0 +1,107 @@
+import { ComplexMath } from './Complex';
+// Clean up very small amplitudes to maintain sparsity
+export function cleanAmplitudes(amplitudes, epsilon = 1e-10) {
+    const cleaned = {};
+    for (const key in amplitudes) {
+        const k = parseInt(key);
+        const amp = amplitudes[k];
+        if (Math.abs(amp.re) >= epsilon || Math.abs(amp.im) >= epsilon) {
+            cleaned[k] = amp;
+        }
+    }
+    return cleaned;
+}
+export const Operations = {
+    // Generalized Pauli X (Shift/Clock)
+    Shift(amount = 1) {
+        return {
+            apply(amplitudes, dimension) {
+                const newAmps = {};
+                for (const key in amplitudes) {
+                    const k = parseInt(key);
+                    const newK = (k + amount) % dimension;
+                    // Handle negative shifts correctly
+                    const positiveNewK = newK < 0 ? newK + dimension : newK;
+                    newAmps[positiveNewK] = amplitudes[key];
+                }
+                return newAmps;
+            }
+        };
+    },
+    // Generalized Pauli Z (Phase/Clock)
+    Phase(multiplier = 1) {
+        return {
+            apply(amplitudes, dimension) {
+                const newAmps = {};
+                const omegaAngle = (2 * Math.PI) / dimension;
+                for (const key in amplitudes) {
+                    const k = parseInt(key);
+                    const amp = amplitudes[key];
+                    const angle = omegaAngle * k * multiplier;
+                    const phase = ComplexMath.phase(angle);
+                    newAmps[k] = ComplexMath.multiply(amp, phase);
+                }
+                return cleanAmplitudes(newAmps);
+            }
+        };
+    },
+    // Generalized Hadamard (Discrete Quantum Fourier Transform)
+    Hadamard() {
+        return {
+            apply(amplitudes, dimension) {
+                const newAmps = {};
+                const factor = 1.0 / Math.sqrt(dimension);
+                const omegaAngle = (2 * Math.PI) / dimension;
+                for (const jStr in amplitudes) {
+                    const j = parseInt(jStr);
+                    const amp = amplitudes[jStr];
+                    for (let k = 0; k < dimension; k++) {
+                        const angle = omegaAngle * j * k;
+                        const phase = ComplexMath.scale(ComplexMath.phase(angle), factor);
+                        const term = ComplexMath.multiply(amp, phase);
+                        if (!newAmps[k]) {
+                            newAmps[k] = { re: 0, im: 0 };
+                        }
+                        newAmps[k] = ComplexMath.add(newAmps[k], term);
+                    }
+                }
+                return cleanAmplitudes(newAmps);
+            }
+        };
+    },
+    // Custom sparse transition defined by explicit complex amplitudes
+    // For things like Quantum Chess Split over 3 squares
+    SparseTransition(transitions) {
+        return {
+            apply(amplitudes, dimension) {
+                const newAmps = {};
+                // For states not found in the transition map, we assume they remain unchanged
+                const mappedStates = new Set(transitions.map(t => t.from));
+                for (const key in amplitudes) {
+                    const k = parseInt(key);
+                    const amp = amplitudes[key];
+                    if (mappedStates.has(k)) {
+                        // Apply all transitions starting from k
+                        const relevantTransitions = transitions.filter(t => t.from === k);
+                        for (const trans of relevantTransitions) {
+                            const term = ComplexMath.multiply(amp, trans.amplitude);
+                            if (!newAmps[trans.to]) {
+                                newAmps[trans.to] = { re: 0, im: 0 };
+                            }
+                            newAmps[trans.to] = ComplexMath.add(newAmps[trans.to], term);
+                        }
+                    }
+                    else {
+                        // Unchanged state
+                        if (!newAmps[k]) {
+                            newAmps[k] = { re: 0, im: 0 };
+                        }
+                        newAmps[k] = ComplexMath.add(newAmps[k], amp);
+                    }
+                }
+                return cleanAmplitudes(newAmps);
+            }
+        };
+    }
+};
+//# sourceMappingURL=Operations.js.map

package/dist/Operations.js.map

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

package/dist/QuantumEntity.d.ts

@@ -0,0 +1,26 @@
+import { type QuantumOperation, type SparseAmplitudes } from './Operations';
+import { type Complex } from './Complex';
+export interface Predicate {
+    entity: QuantumEntity;
+    state: number;
+}
+export declare class QuantumEntity {
+    private static _nextId;
+    readonly id: number;
+    dimension: number;
+    amplitudes: SparseAmplitudes;
+    entangledSystem?: any;
+    constructor(options: {
+        dimension: number;
+        initialState: number;
+    });
+    /** Reset the auto-increment counter (useful in tests). */
+    static resetIdCounter(): void;
+    is(state: number): Predicate;
+    apply(operation: QuantumOperation, controls?: Predicate[]): void;
+    measure(forcedOutcome?: number): number;
+    getProbabilities(): Record<number, number>;
+    getAmplitudes(): Record<number, Complex>;
+    getReducedDensityMatrix(): Record<number, Record<number, Complex>>;
+    setState(amplitudes: SparseAmplitudes): void;
+}