@quantumplayed/quantum-game-engine 1.0.0

package/dist/QuantumEntity.js

@@ -0,0 +1,142 @@
+import { ComplexMath } from './Complex';
+import { EntanglementEngine } from './EntanglementEngine';
+import { CircuitLogger } from './CircuitLog';
+export class QuantumEntity {
+    static _nextId = 0;
+    id;
+    dimension;
+    amplitudes;
+    entangledSystem; // Will be typed properly, using any to avoid circular deps for now
+    constructor(options) {
+        this.id = QuantumEntity._nextId++;
+        this.dimension = options.dimension;
+        this.amplitudes = {};
+        this.amplitudes[options.initialState] = { re: 1.0, im: 0.0 };
+    }
+    /** Reset the auto-increment counter (useful in tests). */
+    static resetIdCounter() {
+        QuantumEntity._nextId = 0;
+    }
+    // Return a Predicate for conditional interactions
+    is(state) {
+        return { entity: this, state };
+    }
+    // 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,
+                targets: [{ entity: this, operation }]
+            });
+            return;
+        }
+        if (this.entangledSystem) {
+            const index = this.entangledSystem.entities.indexOf(this);
+            this.entangledSystem.applyLocal(index, operation);
+        }
+        else {
+            this.amplitudes = operation.apply(this.amplitudes, this.dimension);
+        }
+        // Log single-entity gate (non-conditional path)
+        if (CircuitLogger.isRecording()) {
+            CircuitLogger.addGate(operation.constructor?.name ?? 'UnknownOp', [this.id], [this.dimension]);
+        }
+    }
+    // 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;
+    }
+    // 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;
+    }
+    // Extract raw complex amplitudes (Useful for phase interference logic in games)
+    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;
+    }
+    // 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 };
+    }
+}
+//# sourceMappingURL=QuantumEntity.js.map

package/dist/QuantumEntity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { type Complex, ComplexMath } from './Complex';
+export { QuantumEntity } from './QuantumEntity';
+export { Operations, type QuantumOperation, type SparseAmplitudes, cleanAmplitudes } from './Operations';
+export { EntanglementEngine, JointQuantumSystem } from './EntanglementEngine';
+export { CircuitLogger, type CircuitEntry, type GateEntry, type MeasurementEntry } from './CircuitLog';

package/dist/index.js

@@ -0,0 +1,6 @@
+export { ComplexMath } from './Complex';
+export { QuantumEntity } from './QuantumEntity';
+export { Operations, cleanAmplitudes } from './Operations';
+export { EntanglementEngine, JointQuantumSystem } from './EntanglementEngine';
+export { CircuitLogger } from './CircuitLog';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,WAAW,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAgD,eAAe,EAAE,MAAM,cAAc,CAAC;AACzG,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAA4D,MAAM,cAAc,CAAC"}

package/dist/src/CircuitLog.d.ts

@@ -0,0 +1,54 @@
+/**
+ * CircuitLog — toggleable, append-only log of quantum operations.
+ *
+ * When recording is active, every state-mutating call (gate or measurement)
+ * appends an entry. The log is designed for future incremental OpenQASM export:
+ * each new entry maps to one circuit instruction, so the export never rebuilds.
+ */
+export interface GateEntry {
+    type: 'gate';
+    name: string;
+    entityIds: number[];
+    dimensions: number[];
+    controls?: {
+        entityId: number;
+        state: number;
+    }[];
+    params?: Record<string, any>;
+    timestamp: number;
+}
+export interface MeasurementEntry {
+    type: 'measurement';
+    entityId: number;
+    dimension: number;
+    outcome: number;
+    timestamp: number;
+}
+export type CircuitEntry = GateEntry | MeasurementEntry;
+declare class CircuitLoggerImpl {
+    private _recording;
+    private _log;
+    private _counter;
+    /** Begin recording. Resets the existing log. */
+    startRecording(): void;
+    /** Stop recording and return the captured log. */
+    stopRecording(): CircuitEntry[];
+    /** Fast guard — check before constructing entry objects on the hot path. */
+    isRecording(): boolean;
+    /** Append an entry (auto-assigns timestamp). */
+    addGate(name: string, entityIds: number[], dimensions: number[], params?: Record<string, any>, controls?: {
+        entityId: number;
+        state: number;
+    }[]): void;
+    /** Append a measurement entry. */
+    addMeasurement(entityId: number, dimension: number, outcome: number): void;
+    /** Get a copy of the current log. */
+    getLog(): CircuitEntry[];
+    /** Filter log to entries involving any of the given entity IDs. */
+    getLogForEntities(entityIds: number[]): CircuitEntry[];
+    /** Clear the log and reset the counter. */
+    reset(): void;
+}
+/** Global singleton circuit logger. */
+export declare const CircuitLogger: CircuitLoggerImpl;
+export {};

package/dist/src/CircuitLog.js

@@ -0,0 +1,80 @@
+/**
+ * CircuitLog — toggleable, append-only log of quantum operations.
+ *
+ * When recording is active, every state-mutating call (gate or measurement)
+ * appends an entry. The log is designed for future incremental OpenQASM export:
+ * each new entry maps to one circuit instruction, so the export never rebuilds.
+ */
+// ── Logger ───────────────────────────────────────────────────────────
+class CircuitLoggerImpl {
+    _recording = false;
+    _log = [];
+    _counter = 0;
+    /** Begin recording. Resets the existing log. */
+    startRecording() {
+        this._recording = true;
+        this._log = [];
+        this._counter = 0;
+    }
+    /** Stop recording and return the captured log. */
+    stopRecording() {
+        this._recording = false;
+        return [...this._log];
+    }
+    /** Fast guard — check before constructing entry objects on the hot path. */
+    isRecording() {
+        return this._recording;
+    }
+    /** Append an entry (auto-assigns timestamp). */
+    addGate(name, entityIds, dimensions, params, controls) {
+        const entry = {
+            type: 'gate',
+            name,
+            entityIds,
+            dimensions,
+            timestamp: this._counter++,
+        };
+        if (params)
+            entry.params = params;
+        if (controls)
+            entry.controls = controls;
+        this._log.push(entry);
+    }
+    /** Append a measurement entry. */
+    addMeasurement(entityId, dimension, outcome) {
+        this._log.push({
+            type: 'measurement',
+            entityId,
+            dimension,
+            outcome,
+            timestamp: this._counter++,
+        });
+    }
+    /** Get a copy of the current log. */
+    getLog() {
+        return [...this._log];
+    }
+    /** Filter log to entries involving any of the given entity IDs. */
+    getLogForEntities(entityIds) {
+        const idSet = new Set(entityIds);
+        return this._log.filter(entry => {
+            if (entry.type === 'measurement') {
+                return idSet.has(entry.entityId);
+            }
+            // Gate — check targets and controls
+            if (entry.entityIds.some(id => idSet.has(id)))
+                return true;
+            if (entry.controls?.some(c => idSet.has(c.entityId)))
+                return true;
+            return false;
+        });
+    }
+    /** Clear the log and reset the counter. */
+    reset() {
+        this._log = [];
+        this._counter = 0;
+    }
+}
+/** Global singleton circuit logger. */
+export const CircuitLogger = new CircuitLoggerImpl();
+//# sourceMappingURL=CircuitLog.js.map

package/dist/src/CircuitLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircuitLog.js","sourceRoot":"","sources":["../../src/CircuitLog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,wEAAwE;AAExE,MAAM,iBAAiB;IACX,UAAU,GAAG,KAAK,CAAC;IACnB,IAAI,GAAmB,EAAE,CAAC;IAC1B,QAAQ,GAAG,CAAC,CAAC;IAErB,gDAAgD;IAChD,cAAc;QACV,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,kDAAkD;IAClD,aAAa;QACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAC5E,WAAW;QACP,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,gDAAgD;IAChD,OAAO,CACH,IAAY,EACZ,SAAmB,EACnB,UAAoB,EACpB,MAA4B,EAC5B,QAAgD;QAEhD,MAAM,KAAK,GAAc;YACrB,IAAI,EAAE,MAAM;YACZ,IAAI;YACJ,SAAS;YACT,UAAU;YACV,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE;SAC7B,CAAC;QACF,IAAI,MAAM;YAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QAClC,IAAI,QAAQ;YAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,kCAAkC;IAClC,cAAc,CAAC,QAAgB,EAAE,SAAiB,EAAE,OAAe;QAC/D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,aAAa;YACnB,QAAQ;YACR,SAAS;YACT,OAAO;YACP,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE;SAC7B,CAAC,CAAC;IACP,CAAC;IAED,qCAAqC;IACrC,MAAM;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,mEAAmE;IACnE,iBAAiB,CAAC,SAAmB;QACjC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC/B,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;YACD,oCAAoC;YACpC,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC3D,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClE,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;IACP,CAAC;IAED,2CAA2C;IAC3C,KAAK;QACD,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACtB,CAAC;CACJ;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/src/Complex.d.ts

@@ -0,0 +1,13 @@
+export interface Complex {
+    re: number;
+    im: number;
+}
+export declare const ComplexMath: {
+    add(a: Complex, b: Complex): Complex;
+    subtract(a: Complex, b: Complex): Complex;
+    multiply(a: Complex, b: Complex): Complex;
+    conjugate(a: Complex): Complex;
+    scale(a: Complex, scalar: number): Complex;
+    magnitudeSquared(a: Complex): number;
+    phase(angle: number): Complex;
+};

package/dist/src/Complex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Complex.d.ts","sourceRoot":"","sources":["../../src/Complex.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,WAAW;WAEb,OAAO,KAAK,OAAO,GAAG,OAAO;gBAQxB,OAAO,KAAK,OAAO,GAAG,OAAO;gBAQ7B,OAAO,KAAK,OAAO,GAAG,OAAO;iBAQ5B,OAAO,GAAG,OAAO;aAQrB,OAAO,UAAU,MAAM,GAAG,OAAO;wBAQtB,OAAO,GAAG,MAAM;iBAKvB,MAAM,GAAG,OAAO;CAMhC,CAAC"}

package/dist/src/Complex.js

@@ -0,0 +1,49 @@
+export const ComplexMath = {
+    // Add two complex numbers
+    add(a, b) {
+        return {
+            re: a.re + b.re,
+            im: a.im + b.im
+        };
+    },
+    // Subtract b from a
+    subtract(a, b) {
+        return {
+            re: a.re - b.re,
+            im: a.im - b.im
+        };
+    },
+    // Multiply two complex numbers
+    multiply(a, b) {
+        return {
+            re: a.re * b.re - a.im * b.im,
+            im: a.im * b.re + a.re * b.im
+        };
+    },
+    // Complex conjugate
+    conjugate(a) {
+        return {
+            re: a.re,
+            im: -a.im
+        };
+    },
+    // Multiply a complex number by a scalar
+    scale(a, scalar) {
+        return {
+            re: a.re * scalar,
+            im: a.im * scalar
+        };
+    },
+    // Calculate magnitude squared (probability)
+    magnitudeSquared(a) {
+        return a.re * a.re + a.im * a.im;
+    },
+    // Calculate the complex phase e^(i * angle)
+    phase(angle) {
+        return {
+            re: Math.cos(angle),
+            im: Math.sin(angle)
+        };
+    }
+};
+//# sourceMappingURL=Complex.js.map

package/dist/src/Complex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Complex.js","sourceRoot":"","sources":["../../src/Complex.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,0BAA0B;IAC1B,GAAG,CAAC,CAAU,EAAE,CAAU;QACtB,OAAO;YACH,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE;YACf,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE;SAClB,CAAC;IACN,CAAC;IAED,oBAAoB;IACpB,QAAQ,CAAC,CAAU,EAAE,CAAU;QAC3B,OAAO;YACH,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE;YACf,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE;SAClB,CAAC;IACN,CAAC;IAED,+BAA+B;IAC/B,QAAQ,CAAC,CAAU,EAAE,CAAU;QAC3B,OAAO;YACH,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE;YAC7B,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE;SAChC,CAAC;IACN,CAAC;IAED,oBAAoB;IACpB,SAAS,CAAC,CAAU;QAChB,OAAO;YACH,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;SACZ,CAAC;IACN,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,CAAU,EAAE,MAAc;QAC5B,OAAO;YACH,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM;YACjB,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM;SACpB,CAAC;IACN,CAAC;IAED,4CAA4C;IAC5C,gBAAgB,CAAC,CAAU;QACvB,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IACrC,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,KAAa;QACf,OAAO;YACH,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YACnB,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;SACtB,CAAC;IACN,CAAC;CACJ,CAAC"}

package/dist/src/EntanglementEngine.d.ts

@@ -0,0 +1,48 @@
+import { QuantumEntity, type Predicate } from './QuantumEntity';
+import { type QuantumOperation, type SparseAmplitudes } from './Operations';
+import { type Complex } from './Complex';
+export declare class JointQuantumSystem {
+    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;
+}
+export declare const EntanglementEngine: {
+    interactMany(entities: QuantumEntity[], operation: QuantumOperation): void;
+    conditionalInteract(args: {
+        controls: Predicate[];
+        targets: TargetOperation[];
+    }): void;
+};

package/dist/src/EntanglementEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntanglementEngine.d.ts","sourceRoot":"","sources":["../../src/EntanglementEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,KAAK,OAAO,EAAe,MAAM,WAAW,CAAC;AAEtD,qBAAa,kBAAkB;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,gBAAgB,CAAC;gBAE7B,QAAQ,EAAE,aAAa,EAAE;IAoBrC,OAAO,CAAC,uBAAuB;IA8BxB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAa5C,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;IAStC,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB;IAqC3D,sBAAsB,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAgB3E,aAAa,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM;IA6ClD,uBAAuB,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAqDvG;AAED,eAAO,MAAM,kBAAkB;iCAGE,aAAa,EAAE,GAAG,kBAAkB;2BAgD1C,aAAa,EAAE,aAAa,gBAAgB;8BAUzC;QACtB,eAAe,EAAE;YAAE,MAAM,EAAE,aAAa,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC5D,OAAO,EAAE;YAAE,MAAM,EAAE,aAAa,CAAC;YAAC,SAAS,EAAE,gBAAgB,CAAA;SAAE,EAAE,CAAA;KACpE;CA+EJ,CAAC"}