@quantumplayed/quantum-game-engine 1.0.3 → 1.2.0

package/dist/EntanglementEngine.d.ts

@@ -1,50 +1,14 @@
-import { QuantumEntity, type Predicate } from './QuantumEntity.js';
-import { type QuantumOperation, type SparseAmplitudes } from './Operations.js';
-import { type Complex } from './Complex.js';
-export declare class JointQuantumSystem {
-    static maxDimensionLimit: number;
-    static setMaxDimensionLimit(limit: number): void;
-    entities: QuantumEntity[];
-    dimensions: number[];
-    totalDimension: number;
-    jointAmplitudes: SparseAmplitudes;
-    private constructor();
-    static create(entities: QuantumEntity[]): JointQuantumSystem;
-    static merge(involvedEntities: QuantumEntity[]): JointQuantumSystem;
-    private _calculateTensorProduct;
-    decomposeState(jointState: number): number[];
-    composeState(states: number[]): number;
-    applyLocal(entityIndex: number, operation: QuantumOperation): void;
-    applyToSubspace(targetEntities: QuantumEntity[], operation: QuantumOperation): void;
-    getTargetProbabilities(targetEntity: QuantumEntity): Record<number, number>;
-    getTargetAmplitudes(targetEntity: QuantumEntity): Record<number, Complex>;
-    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;
-    getReducedDensityMatrix(targetEntity: QuantumEntity): Record<number, Record<number, Complex>>;
-    /**
-     * Create a joint system from existing amplitudes and entities (Bit-Perfect Restoration/Cloning).
-     */
-    static inject(entities: QuantumEntity[], jointAmplitudes: SparseAmplitudes): JointQuantumSystem;
-}
-export interface TargetOperation {
-    entity: QuantumEntity;
-    operation: QuantumOperation;
-}
+import { QuantumEntity } from './QuantumEntity.js';
+import { QuantumSystem, type Predicate, type TargetOperation } from './QuantumSystem.js';
+import { type QuantumOperation } from './Operations.js';
+export { QuantumSystem as JointQuantumSystem, type TargetOperation, type Predicate };
+/**
+ * @deprecated Use QuantumSystem.interact or QuantumSystem.conditionalInteract directly.
+ */
 export declare const EntanglementEngine: {
     interactMany(entities: QuantumEntity[], operation: QuantumOperation): void;
     conditionalInteract(args: {
         controls: Predicate[];
         targets: TargetOperation[];
-    }): void;
+    }): QuantumSystem;
 };

package/dist/EntanglementEngine.js

@@ -1,494 +1,14 @@
-import { cleanAmplitudes } from './Operations.js';
-import { ComplexMath } from './Complex.js';
-import { CircuitLogger } from './CircuitLog.js';
-export class JointQuantumSystem {
-    static maxDimensionLimit = 32768;
-    static setMaxDimensionLimit(limit) {
-        JointQuantumSystem.maxDimensionLimit = limit;
-    }
-    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 > JointQuantumSystem.maxDimensionLimit) {
-            throw new Error(`QuantumLimitExceeded: Attempted to entangle a system of dimension ${this.totalDimension}. Maximum allowed is ${JointQuantumSystem.maxDimensionLimit}. If you need a larger state space, you can increase this limit using 'JointQuantumSystem.setMaxDimensionLimit(newLimit)'. Note that larger dimensions can cause performance issues or crash the thread.`);
-        }
-        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.
-        let collapsedAmps = {};
-        const prob = marginalProbs[selectedState] ?? 0;
-        if (prob > 1e-12) {
-            const normalizationFactor = 1.0 / Math.sqrt(prob);
-            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);
-                }
-            }
-        }
-        else {
-            // Edge case: Forced measurement to a state with zero probability.
-            // We overwrite the target entity's state in the most probable joint state configuration.
-            let maxProb = -1;
-            let maxJointK = -1;
-            for (const [jointKStr, amp] of Object.entries(this.jointAmplitudes)) {
-                const jointK = parseInt(jointKStr);
-                const magnitude = amp.re * amp.re + amp.im * amp.im;
-                if (magnitude > maxProb) {
-                    maxProb = magnitude;
-                    maxJointK = jointK;
-                }
-            }
-            if (maxJointK !== -1) {
-                const states = this.decomposeState(maxJointK);
-                states[targetIndex] = selectedState;
-                const newJointK = this.composeState(states);
-                collapsedAmps = { [newJointK]: { re: 1.0, im: 0.0 } };
-            }
-            else {
-                const states = new Array(this.entities.length).fill(0);
-                states[targetIndex] = selectedState;
-                const newJointK = this.composeState(states);
-                collapsedAmps = { [newJointK]: { re: 1.0, im: 0.0 } };
-            }
-        }
-        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;
-    }
-}
+import { QuantumSystem } from './QuantumSystem.js';
+export { QuantumSystem as JointQuantumSystem };
+/**
+ * @deprecated Use QuantumSystem.interact or QuantumSystem.conditionalInteract directly.
+ */
 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(operation.name, entities.map(e => e.id), entities.map(e => e.dimension), operation.params);
-        }
+        QuantumSystem.interact(entities, operation);
     },
     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), {
-                targets: args.targets.map(t => ({
-                    entityId: t.entity.id,
-                    operation: t.operation.name,
-                    params: t.operation.params
-                }))
-            }, args.controls.map(c => ({ entityId: c.entity.id, state: c.state })));
-        }
+        return QuantumSystem.conditionalInteract(args);
     }
 };
 //# sourceMappingURL=EntanglementEngine.js.map

package/dist/EntanglementEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntanglementEngine.js","sourceRoot":"","sources":["../src/EntanglementEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"EntanglementEngine.js","sourceRoot":"","sources":["../src/EntanglementEngine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAwC,MAAM,oBAAoB,CAAC;AAGzF,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAwC,CAAC;AAErF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAC9B,YAAY,CAAC,QAAyB,EAAE,SAA2B;QAC/D,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,mBAAmB,CAAC,IAGnB;QACG,OAAO,aAAa,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;CACJ,CAAC"}

package/dist/Operations.d.ts

@@ -18,4 +18,10 @@ export declare const Operations: {
         amplitude: Complex;
     }[]): QuantumOperation;
     SqrtSwap(): QuantumOperation;
+    Split(from: number, targets: number[]): QuantumOperation;
+    Branch(from: number, branches: {
+        to: number;
+        weight: number;
+    }[]): QuantumOperation;
+    PhaseDegrees(degrees: number): QuantumOperation;
 };

package/dist/Operations.js

@@ -152,6 +152,54 @@ 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);
+            }
+        };
     }
 };
 //# sourceMappingURL=Operations.js.map