@mulanjs/mulanjs 1.0.1-dev.20260219183505 → 1.0.1-dev.20260220104511

package/README.md

@@ -32,7 +32,7 @@ npm install @mulanjs/mulanjs@dev
 ## ⚡ Core Features
 
 *   **Signal Reactivity Engine** ⚡: Fine-grained reactivity that tracks exact dependencies, eliminating the need for a Virtual DOM.
-*   **ASTR-Q+ Engine** 🌌: Simulated quantum registers for probabilistic state management and complex logic branching.
+*   **ASTR-Q+ Engine** 🌌: Simulated quantum registers with **Quantum Loops** (`muParallel`, `muSwitch`) for complex probabilistic branching.
 *   **Iron Fortress Security** 🛡️: Built-in "Iron Fortress" security module that auto-sanitizes inputs and generates CSP headers.
 *   **Mulan Cycle** 🔄: A redefined component lifecycle (Init, Mount, Destroy) for predictable state management.
 *   **TypeScript First** 🟦: Built from the ground up with TypeScript for world-class type safety.
@@ -56,6 +56,9 @@ State that survives refreshes using `muVault`. Your data, secured in the Iron Fo
 ### Mulan Router (Time Travel) 🧭
 Zero-config hash routing with `<mu-link>` for instant, single-page navigation.
 
+### Mulan Surge (High Performance) 🚀
+Adaptive non-blocking loops (`muBurst`) and true multicore parallelism (`muSurge`) to handle billions of records at 60fps.
+
 ### Native SCSS Support 🎨
 Built-in support for `<style lang="scss">`. No config required. Just design.
 ## 🚀 Quick Start Example

package/dist/core/quantum.js

@@ -1,4 +1,11 @@
 import { muState } from './hooks';
+/**
+ * Mulan Quantum (ASTR-Q+) Core
+ * Advanced Simulation Engine for multi-qubit registers and entanglement.
+ */
+// -- GLOBAL CONTEXT FOR QUANTUM CONTROL --
+// Defined at top to ensure visibility for muGate
+export let activeControls = [];
 /**
  * Creates a quantum register of size n.
  * State vector will have 2^n amplitudes.
@@ -54,14 +61,14 @@ export function muGate(reg, type, target = 0, control) {
     const n = state.size;
     const amplitudes = state.amplitudes;
     const newAmps = amplitudes.map(a => (Object.assign({}, a)));
+    // Prepare Effective Control (Explicit Arguments + Global Context)
+    const effectiveControl = [...(control === undefined ? [] : (Array.isArray(control) ? control : [control])), ...activeControls];
     // Helper: Check if all control bits are 1
     const checkControl = (index, ctrl) => {
-        if (ctrl === undefined)
+        if (ctrl === undefined || (Array.isArray(ctrl) && ctrl.length === 0))
             return true;
-        if (typeof ctrl === 'number') {
-            return ((index >> ctrl) & 1) === 1;
-        }
-        return ctrl.every(c => ((index >> c) & 1) === 1);
+        const ctrls = Array.isArray(ctrl) ? ctrl : [ctrl];
+        return ctrls.every(c => ((index >> c) & 1) === 1);
     };
     // SWAP Gate (Unique case: affects 2 targets)
     if (type === 'SWAP') {
@@ -69,6 +76,9 @@ export function muGate(reg, type, target = 0, control) {
         const t2 = control; // SWAP uses control arg as second target 
         // Iterate only half to avoid double swapping
         for (let i = 0; i < amplitudes.length; i++) {
+            // Check active controls for SWAP too
+            if (activeControls.length > 0 && !checkControl(i, activeControls))
+                continue;
             const bit1 = (i >> t1) & 1;
             const bit2 = (i >> t2) & 1;
             if (bit1 !== bit2) {
@@ -93,7 +103,7 @@ export function muGate(reg, type, target = 0, control) {
             if (processed.has(i))
                 continue;
             // Check Controls first
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));
@@ -114,7 +124,7 @@ export function muGate(reg, type, target = 0, control) {
     else if (type === 'X' || type === 'CNOT') {
         // CNOT is just Controlled-X
         for (let i = 0; i < amplitudes.length; i++) {
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));
@@ -128,7 +138,7 @@ export function muGate(reg, type, target = 0, control) {
     else if (type === 'Z' || type === 'CZ') {
         // Z and CZ are Phase Flips
         for (let i = 0; i < amplitudes.length; i++) {
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             // Z Gate acts on |1>
@@ -140,7 +150,7 @@ export function muGate(reg, type, target = 0, control) {
     else if (type === 'Y') {
         // Y: |0> -> i|1>, |1> -> -i|0>
         for (let i = 0; i < amplitudes.length; i++) {
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));
@@ -282,3 +292,58 @@ export function muMeasure(reg, target = 0) {
     updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));
     return result;
 }
+/**
+ * Quantum Loop: Parallel Execution
+ * Applies a gate to multiple qubits "simultaneously" (in simulation steps).
+ * Ideal for initialization (Hadamard Transform) or global operations.
+ * @param reg Quantum Register
+ * @param qubits Array of qubit indices
+ * @param gate Gate type to apply (e.g. 'H', 'X')
+ */
+export function muParallel(reg, qubits, gate) {
+    if (gate === 'SWAP') {
+        throw new Error("SWAP cannot be applied in parallel (requires pairs).");
+    }
+    // In a real quantum computer, these happen at t=0.
+    // Here, we loop, but logical time is constant.
+    qubits.forEach(q => muGate(reg, gate, q));
+}
+/**
+ * Applies a block of operations controlled by specific qubits.
+ * Enables "Quantum If/Else".
+ */
+export function muControl(reg, controlQubit, inverse, block) {
+    // 1. Setup Context
+    if (inverse) {
+        muGate(reg, 'X', controlQubit); // Flip 0 to 1 to activate
+    }
+    activeControls.push(controlQubit);
+    try {
+        block();
+    }
+    finally {
+        activeControls.pop();
+        // Uncompute (Restore 0)
+        if (inverse) {
+            muGate(reg, 'X', controlQubit);
+        }
+    }
+}
+/**
+ * Quantum Switch: conditional Logic on Superposition
+ * Executes different logic branches based on the state of control qubits.
+ * Because the register can be in a superposition of states (e.g. |0> + |1>),
+ * MULTIPLE branches can execute effectively simultaneously on different subspaces.
+ *
+ * @param reg Quantum Register
+ * @param controlQubit The qubit controlling the switch (Single control for v1)
+ * @param cases Object mapping state (0 or 1) to a function executing quantum operations
+ */
+export function muSwitch(reg, controlQubit, cases) {
+    if (cases[0]) {
+        muControl(reg, controlQubit, true, cases[0]);
+    }
+    if (cases[1]) {
+        muControl(reg, controlQubit, false, cases[1]);
+    }
+}

package/dist/core/query.js

@@ -35,7 +35,12 @@ export function useQuery(queryFn, options = { enabled: true }) {
             execute();
         });
     }
-    return Object.assign(Object.assign({}, state), { refetch: execute });
+    return {
+        get data() { return state.data; },
+        get isLoading() { return state.isLoading; },
+        get error() { return state.error; },
+        refetch: execute
+    };
 }
 export function useMutation(mutationFn) {
     const state = reactive({
@@ -59,5 +64,10 @@ export function useMutation(mutationFn) {
             state.isLoading = false;
         }
     });
-    return Object.assign(Object.assign({}, state), { mutate });
+    return {
+        get data() { return state.data; },
+        get isLoading() { return state.isLoading; },
+        get error() { return state.error; },
+        mutate
+    };
 }

package/dist/core/surge.js

@@ -0,0 +1,88 @@
+/**
+ * muBurst - Adaptive Non-blocking Iterator
+ * Processes large arrays in batches within a frame budget (typically 8-16ms)
+ * to keep the UI responsive while executing at near-native loop speeds.
+ */
+export function muBurst(array, callback, options = {}) {
+    const { chunkSize = 1000, timeout = 8, onProgress } = options;
+    return new Promise((resolve) => {
+        let index = 0;
+        const total = array.length;
+        function process() {
+            const start = performance.now();
+            // Tight loop for high-speed processing
+            while (index < total && (performance.now() - start) < timeout) {
+                // Process in smaller bursts to allow more frequent time checks if needed
+                const endBurst = Math.min(index + chunkSize, total);
+                for (; index < endBurst; index++) {
+                    callback(array[index], index);
+                }
+            }
+            if (onProgress) {
+                onProgress((index / total) * 100);
+            }
+            if (index < total) {
+                requestAnimationFrame(process);
+            }
+            else {
+                resolve();
+            }
+        }
+        process();
+    });
+}
+/**
+ * muSurge - Truly Parallel Execution
+ * Distributes work across CPU cores using Web Workers.
+ * Logic must be serializable.
+ */
+export function muSurge(array, taskFn, onProgress) {
+    const n = navigator.hardwareConcurrency || 4;
+    const chunkSize = Math.ceil(array.length / n);
+    const results = new Array(array.length);
+    let completedChunks = 0;
+    let completedItems = 0;
+    // Convert function to string if it isn't already
+    const fnStr = typeof taskFn === 'function' ? taskFn.toString() : taskFn;
+    const workerCode = `
+        self.onmessage = function(e) {
+            const { chunk, startIndex, fnStr } = e.data;
+            const fn = new Function('item', 'return (' + fnStr + ')(item)');
+            const results = chunk.map(fn);
+            self.postMessage({ results, startIndex });
+        };
+    `;
+    const blob = new Blob([workerCode], { type: 'application/javascript' });
+    const workerUrl = URL.createObjectURL(blob);
+    return new Promise((resolve) => {
+        if (array.length === 0)
+            return resolve([]);
+        for (let i = 0; i < n; i++) {
+            const start = i * chunkSize;
+            const end = Math.min(start + chunkSize, array.length);
+            if (start >= end) {
+                completedChunks++;
+                continue;
+            }
+            const chunk = array.slice(start, end);
+            const worker = new Worker(workerUrl);
+            worker.onmessage = (e) => {
+                const { results: chunkResults, startIndex } = e.data;
+                // Merge results back into main array
+                for (let j = 0; j < chunkResults.length; j++) {
+                    results[startIndex + j] = chunkResults[j];
+                }
+                completedChunks++;
+                completedItems += chunkResults.length;
+                if (onProgress)
+                    onProgress((completedItems / array.length) * 100);
+                worker.terminate();
+                if (completedChunks === n) {
+                    URL.revokeObjectURL(workerUrl);
+                    resolve(results);
+                }
+            };
+            worker.postMessage({ chunk, startIndex: start, fnStr });
+        }
+    });
+}

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './core/hooks';
 export * from './core/query';
 export * from './core/vault';
 export * from './core/quantum';
+export * from './core/surge';
 export * from './components/bloch-sphere';
 export * from './components/infinity-list';
 // Global Mulan Object for non-module usage
@@ -20,9 +21,10 @@ import * as Hooks from './core/hooks';
 import * as Query from './core/query';
 import { render } from './core/renderer';
 import * as Quantum from './core/quantum';
+import * as Surge from './core/surge';
 import * as InfinityList from './components/infinity-list';
-const Mulan = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ reactive,
-    effect, Component: MuComponent, defineComponent, Router: MuRouter, createRouter, Store: MuStore, Security: Security }, Hooks), Query), Quantum), InfinityList), { render, 
+const Mulan = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ reactive,
+    effect, Component: MuComponent, defineComponent, Router: MuRouter, createRouter, Store: MuStore, Security: Security }, Hooks), Query), Quantum), Surge), InfinityList), { render, 
     // MULAN INSIGHT: Branded Logging
     log: (msg, ...args) => {
         console.log(`%c[MulanJS]%c ${msg}`, "color: #ff3e00; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;", "", ...args);

package/dist/mulan.esm.js

@@ -821,16 +821,27 @@ function muVault(key, initial, options = {}) {
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   activeControls: () => (/* binding */ activeControls),
+/* harmony export */   muControl: () => (/* binding */ muControl),
 /* harmony export */   muEntangle: () => (/* binding */ muEntangle),
 /* harmony export */   muGate: () => (/* binding */ muGate),
 /* harmony export */   muMeasure: () => (/* binding */ muMeasure),
+/* harmony export */   muParallel: () => (/* binding */ muParallel),
 /* harmony export */   muQubit: () => (/* binding */ muQubit),
 /* harmony export */   muRegister: () => (/* binding */ muRegister),
 /* harmony export */   muSearch: () => (/* binding */ muSearch),
+/* harmony export */   muSwitch: () => (/* binding */ muSwitch),
 /* harmony export */   muTeleport: () => (/* binding */ muTeleport)
 /* harmony export */ });
 /* harmony import */ var _hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./hooks */ "./src/core/hooks.ts");
 
+/**
+ * Mulan Quantum (ASTR-Q+) Core
+ * Advanced Simulation Engine for multi-qubit registers and entanglement.
+ */
+// -- GLOBAL CONTEXT FOR QUANTUM CONTROL --
+// Defined at top to ensure visibility for muGate
+let activeControls = [];
 /**
  * Creates a quantum register of size n.
  * State vector will have 2^n amplitudes.
@@ -886,14 +897,14 @@ function muGate(reg, type, target = 0, control) {
     const n = state.size;
     const amplitudes = state.amplitudes;
     const newAmps = amplitudes.map(a => (Object.assign({}, a)));
+    // Prepare Effective Control (Explicit Arguments + Global Context)
+    const effectiveControl = [...(control === undefined ? [] : (Array.isArray(control) ? control : [control])), ...activeControls];
     // Helper: Check if all control bits are 1
     const checkControl = (index, ctrl) => {
-        if (ctrl === undefined)
+        if (ctrl === undefined || (Array.isArray(ctrl) && ctrl.length === 0))
             return true;
-        if (typeof ctrl === 'number') {
-            return ((index >> ctrl) & 1) === 1;
-        }
-        return ctrl.every(c => ((index >> c) & 1) === 1);
+        const ctrls = Array.isArray(ctrl) ? ctrl : [ctrl];
+        return ctrls.every(c => ((index >> c) & 1) === 1);
     };
     // SWAP Gate (Unique case: affects 2 targets)
     if (type === 'SWAP') {
@@ -901,6 +912,9 @@ function muGate(reg, type, target = 0, control) {
         const t2 = control; // SWAP uses control arg as second target 
         // Iterate only half to avoid double swapping
         for (let i = 0; i < amplitudes.length; i++) {
+            // Check active controls for SWAP too
+            if (activeControls.length > 0 && !checkControl(i, activeControls))
+                continue;
             const bit1 = (i >> t1) & 1;
             const bit2 = (i >> t2) & 1;
             if (bit1 !== bit2) {
@@ -925,7 +939,7 @@ function muGate(reg, type, target = 0, control) {
             if (processed.has(i))
                 continue;
             // Check Controls first
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));
@@ -946,7 +960,7 @@ function muGate(reg, type, target = 0, control) {
     else if (type === 'X' || type === 'CNOT') {
         // CNOT is just Controlled-X
         for (let i = 0; i < amplitudes.length; i++) {
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));
@@ -960,7 +974,7 @@ function muGate(reg, type, target = 0, control) {
     else if (type === 'Z' || type === 'CZ') {
         // Z and CZ are Phase Flips
         for (let i = 0; i < amplitudes.length; i++) {
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             // Z Gate acts on |1>
@@ -972,7 +986,7 @@ function muGate(reg, type, target = 0, control) {
     else if (type === 'Y') {
         // Y: |0> -> i|1>, |1> -> -i|0>
         for (let i = 0; i < amplitudes.length; i++) {
-            if (!checkControl(i, control))
+            if (!checkControl(i, effectiveControl))
                 continue;
             const targetBit = (i >> target) & 1;
             const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));
@@ -1114,6 +1128,61 @@ function muMeasure(reg, target = 0) {
     updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));
     return result;
 }
+/**
+ * Quantum Loop: Parallel Execution
+ * Applies a gate to multiple qubits "simultaneously" (in simulation steps).
+ * Ideal for initialization (Hadamard Transform) or global operations.
+ * @param reg Quantum Register
+ * @param qubits Array of qubit indices
+ * @param gate Gate type to apply (e.g. 'H', 'X')
+ */
+function muParallel(reg, qubits, gate) {
+    if (gate === 'SWAP') {
+        throw new Error("SWAP cannot be applied in parallel (requires pairs).");
+    }
+    // In a real quantum computer, these happen at t=0.
+    // Here, we loop, but logical time is constant.
+    qubits.forEach(q => muGate(reg, gate, q));
+}
+/**
+ * Applies a block of operations controlled by specific qubits.
+ * Enables "Quantum If/Else".
+ */
+function muControl(reg, controlQubit, inverse, block) {
+    // 1. Setup Context
+    if (inverse) {
+        muGate(reg, 'X', controlQubit); // Flip 0 to 1 to activate
+    }
+    activeControls.push(controlQubit);
+    try {
+        block();
+    }
+    finally {
+        activeControls.pop();
+        // Uncompute (Restore 0)
+        if (inverse) {
+            muGate(reg, 'X', controlQubit);
+        }
+    }
+}
+/**
+ * Quantum Switch: conditional Logic on Superposition
+ * Executes different logic branches based on the state of control qubits.
+ * Because the register can be in a superposition of states (e.g. |0> + |1>),
+ * MULTIPLE branches can execute effectively simultaneously on different subspaces.
+ *
+ * @param reg Quantum Register
+ * @param controlQubit The qubit controlling the switch (Single control for v1)
+ * @param cases Object mapping state (0 or 1) to a function executing quantum operations
+ */
+function muSwitch(reg, controlQubit, cases) {
+    if (cases[0]) {
+        muControl(reg, controlQubit, true, cases[0]);
+    }
+    if (cases[1]) {
+        muControl(reg, controlQubit, false, cases[1]);
+    }
+}
 
 
 /***/ },
@@ -1167,7 +1236,12 @@ function useQuery(queryFn, options = { enabled: true }) {
             execute();
         });
     }
-    return Object.assign(Object.assign({}, state), { refetch: execute });
+    return {
+        get data() { return state.data; },
+        get isLoading() { return state.isLoading; },
+        get error() { return state.error; },
+        refetch: execute
+    };
 }
 function useMutation(mutationFn) {
     const state = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)({
@@ -1191,7 +1265,12 @@ function useMutation(mutationFn) {
             state.isLoading = false;
         }
     });
-    return Object.assign(Object.assign({}, state), { mutate });
+    return {
+        get data() { return state.data; },
+        get isLoading() { return state.isLoading; },
+        get error() { return state.error; },
+        mutate
+    };
 }
 
 
@@ -1443,6 +1522,109 @@ function sanitize(str) {
 }
 
 
+/***/ },
+
+/***/ "./src/core/surge.ts"
+/*!***************************!*\
+  !*** ./src/core/surge.ts ***!
+  \***************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   muBurst: () => (/* binding */ muBurst),
+/* harmony export */   muSurge: () => (/* binding */ muSurge)
+/* harmony export */ });
+/**
+ * muBurst - Adaptive Non-blocking Iterator
+ * Processes large arrays in batches within a frame budget (typically 8-16ms)
+ * to keep the UI responsive while executing at near-native loop speeds.
+ */
+function muBurst(array, callback, options = {}) {
+    const { chunkSize = 1000, timeout = 8, onProgress } = options;
+    return new Promise((resolve) => {
+        let index = 0;
+        const total = array.length;
+        function process() {
+            const start = performance.now();
+            // Tight loop for high-speed processing
+            while (index < total && (performance.now() - start) < timeout) {
+                // Process in smaller bursts to allow more frequent time checks if needed
+                const endBurst = Math.min(index + chunkSize, total);
+                for (; index < endBurst; index++) {
+                    callback(array[index], index);
+                }
+            }
+            if (onProgress) {
+                onProgress((index / total) * 100);
+            }
+            if (index < total) {
+                requestAnimationFrame(process);
+            }
+            else {
+                resolve();
+            }
+        }
+        process();
+    });
+}
+/**
+ * muSurge - Truly Parallel Execution
+ * Distributes work across CPU cores using Web Workers.
+ * Logic must be serializable.
+ */
+function muSurge(array, taskFn, onProgress) {
+    const n = navigator.hardwareConcurrency || 4;
+    const chunkSize = Math.ceil(array.length / n);
+    const results = new Array(array.length);
+    let completedChunks = 0;
+    let completedItems = 0;
+    // Convert function to string if it isn't already
+    const fnStr = typeof taskFn === 'function' ? taskFn.toString() : taskFn;
+    const workerCode = `
+        self.onmessage = function(e) {
+            const { chunk, startIndex, fnStr } = e.data;
+            const fn = new Function('item', 'return (' + fnStr + ')(item)');
+            const results = chunk.map(fn);
+            self.postMessage({ results, startIndex });
+        };
+    `;
+    const blob = new Blob([workerCode], { type: 'application/javascript' });
+    const workerUrl = URL.createObjectURL(blob);
+    return new Promise((resolve) => {
+        if (array.length === 0)
+            return resolve([]);
+        for (let i = 0; i < n; i++) {
+            const start = i * chunkSize;
+            const end = Math.min(start + chunkSize, array.length);
+            if (start >= end) {
+                completedChunks++;
+                continue;
+            }
+            const chunk = array.slice(start, end);
+            const worker = new Worker(workerUrl);
+            worker.onmessage = (e) => {
+                const { results: chunkResults, startIndex } = e.data;
+                // Merge results back into main array
+                for (let j = 0; j < chunkResults.length; j++) {
+                    results[startIndex + j] = chunkResults[j];
+                }
+                completedChunks++;
+                completedItems += chunkResults.length;
+                if (onProgress)
+                    onProgress((completedItems / array.length) * 100);
+                worker.terminate();
+                if (completedChunks === n) {
+                    URL.revokeObjectURL(workerUrl);
+                    resolve(results);
+                }
+            };
+            worker.postMessage({ chunk, startIndex: start, fnStr });
+        }
+    });
+}
+
+
 /***/ },
 
 /***/ "./src/core/vault.ts"
@@ -2015,30 +2197,36 @@ var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   Component: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent),
-/* harmony export */   MuBlochSphereElement: () => (/* reexport safe */ _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_10__.MuBlochSphereElement),
+/* harmony export */   MuBlochSphereElement: () => (/* reexport safe */ _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_11__.MuBlochSphereElement),
 /* harmony export */   MuComponent: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent),
-/* harmony export */   MuInfinity: () => (/* reexport safe */ _components_infinity_list__WEBPACK_IMPORTED_MODULE_11__.MuInfinity),
+/* harmony export */   MuInfinity: () => (/* reexport safe */ _components_infinity_list__WEBPACK_IMPORTED_MODULE_12__.MuInfinity),
 /* harmony export */   MuRouter: () => (/* reexport safe */ _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter),
 /* harmony export */   MuStore: () => (/* reexport safe */ _store_index__WEBPACK_IMPORTED_MODULE_4__.MuStore),
 /* harmony export */   Router: () => (/* reexport safe */ _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter),
 /* harmony export */   Security: () => (/* reexport safe */ _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__.Security),
 /* harmony export */   Signal: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.Signal),
+/* harmony export */   activeControls: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.activeControls),
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__),
 /* harmony export */   defineComponent: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.defineComponent),
 /* harmony export */   effect: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect),
 /* harmony export */   getCurrentInstance: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.getCurrentInstance),
 /* harmony export */   hydrate: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.hydrate),
+/* harmony export */   muBurst: () => (/* reexport safe */ _core_surge__WEBPACK_IMPORTED_MODULE_10__.muBurst),
+/* harmony export */   muControl: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muControl),
 /* harmony export */   muEffect: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muEffect),
 /* harmony export */   muEntangle: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muEntangle),
 /* harmony export */   muGate: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muGate),
 /* harmony export */   muGeom: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muGeom),
 /* harmony export */   muMeasure: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muMeasure),
 /* harmony export */   muMemo: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muMemo),
+/* harmony export */   muParallel: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muParallel),
 /* harmony export */   muPulse: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muPulse),
 /* harmony export */   muQubit: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muQubit),
 /* harmony export */   muRegister: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muRegister),
 /* harmony export */   muSearch: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muSearch),
 /* harmony export */   muState: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muState),
+/* harmony export */   muSurge: () => (/* reexport safe */ _core_surge__WEBPACK_IMPORTED_MODULE_10__.muSurge),
+/* harmony export */   muSwitch: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muSwitch),
 /* harmony export */   muTeleport: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muTeleport),
 /* harmony export */   muVault: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muVault),
 /* harmony export */   onMuDestroy: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuDestroy),
@@ -2068,8 +2256,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _core_query__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./core/query */ "./src/core/query.ts");
 /* harmony import */ var _core_vault__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./core/vault */ "./src/core/vault.ts");
 /* harmony import */ var _core_quantum__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./core/quantum */ "./src/core/quantum.ts");
-/* harmony import */ var _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./components/bloch-sphere */ "./src/components/bloch-sphere.ts");
-/* harmony import */ var _components_infinity_list__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ./components/infinity-list */ "./src/components/infinity-list.ts");
+/* harmony import */ var _core_surge__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./core/surge */ "./src/core/surge.ts");
+/* harmony import */ var _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ./components/bloch-sphere */ "./src/components/bloch-sphere.ts");
+/* harmony import */ var _components_infinity_list__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./components/infinity-list */ "./src/components/infinity-list.ts");
+
 
 
 
@@ -2093,8 +2283,9 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
-const Mulan = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ reactive: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive,
-    effect: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect, Component: _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent, defineComponent: _core_component__WEBPACK_IMPORTED_MODULE_1__.defineComponent, Router: _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter, createRouter: _router_index__WEBPACK_IMPORTED_MODULE_3__.createRouter, Store: _store_index__WEBPACK_IMPORTED_MODULE_4__.MuStore, Security: _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__.Security }, _core_hooks__WEBPACK_IMPORTED_MODULE_6__), _core_query__WEBPACK_IMPORTED_MODULE_7__), _core_quantum__WEBPACK_IMPORTED_MODULE_9__), _components_infinity_list__WEBPACK_IMPORTED_MODULE_11__), { render: _core_renderer__WEBPACK_IMPORTED_MODULE_2__.render, 
+
+const Mulan = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ reactive: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive,
+    effect: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect, Component: _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent, defineComponent: _core_component__WEBPACK_IMPORTED_MODULE_1__.defineComponent, Router: _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter, createRouter: _router_index__WEBPACK_IMPORTED_MODULE_3__.createRouter, Store: _store_index__WEBPACK_IMPORTED_MODULE_4__.MuStore, Security: _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__.Security }, _core_hooks__WEBPACK_IMPORTED_MODULE_6__), _core_query__WEBPACK_IMPORTED_MODULE_7__), _core_quantum__WEBPACK_IMPORTED_MODULE_9__), _core_surge__WEBPACK_IMPORTED_MODULE_10__), _components_infinity_list__WEBPACK_IMPORTED_MODULE_12__), { render: _core_renderer__WEBPACK_IMPORTED_MODULE_2__.render, 
     // MULAN INSIGHT: Branded Logging
     log: (msg, ...args) => {
         console.log(`%c[MulanJS]%c ${msg}`, "color: #ff3e00; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;", "", ...args);
@@ -2139,22 +2330,28 @@ const __webpack_exports__MuStore = __webpack_exports__.MuStore;
 const __webpack_exports__Router = __webpack_exports__.Router;
 const __webpack_exports__Security = __webpack_exports__.Security;
 const __webpack_exports__Signal = __webpack_exports__.Signal;
+const __webpack_exports__activeControls = __webpack_exports__.activeControls;
 const __webpack_exports__default = __webpack_exports__["default"];
 const __webpack_exports__defineComponent = __webpack_exports__.defineComponent;
 const __webpack_exports__effect = __webpack_exports__.effect;
 const __webpack_exports__getCurrentInstance = __webpack_exports__.getCurrentInstance;
 const __webpack_exports__hydrate = __webpack_exports__.hydrate;
+const __webpack_exports__muBurst = __webpack_exports__.muBurst;
+const __webpack_exports__muControl = __webpack_exports__.muControl;
 const __webpack_exports__muEffect = __webpack_exports__.muEffect;
 const __webpack_exports__muEntangle = __webpack_exports__.muEntangle;
 const __webpack_exports__muGate = __webpack_exports__.muGate;
 const __webpack_exports__muGeom = __webpack_exports__.muGeom;
 const __webpack_exports__muMeasure = __webpack_exports__.muMeasure;
 const __webpack_exports__muMemo = __webpack_exports__.muMemo;
+const __webpack_exports__muParallel = __webpack_exports__.muParallel;
 const __webpack_exports__muPulse = __webpack_exports__.muPulse;
 const __webpack_exports__muQubit = __webpack_exports__.muQubit;
 const __webpack_exports__muRegister = __webpack_exports__.muRegister;
 const __webpack_exports__muSearch = __webpack_exports__.muSearch;
 const __webpack_exports__muState = __webpack_exports__.muState;
+const __webpack_exports__muSurge = __webpack_exports__.muSurge;
+const __webpack_exports__muSwitch = __webpack_exports__.muSwitch;
 const __webpack_exports__muTeleport = __webpack_exports__.muTeleport;
 const __webpack_exports__muVault = __webpack_exports__.muVault;
 const __webpack_exports__onMuDestroy = __webpack_exports__.onMuDestroy;
@@ -2173,4 +2370,4 @@ const __webpack_exports__sanitize = __webpack_exports__.sanitize;
 const __webpack_exports__setCurrentInstance = __webpack_exports__.setCurrentInstance;
 const __webpack_exports__useMutation = __webpack_exports__.useMutation;
 const __webpack_exports__useQuery = __webpack_exports__.useQuery;
-export { __webpack_exports__Component as Component, __webpack_exports__MuBlochSphereElement as MuBlochSphereElement, __webpack_exports__MuComponent as MuComponent, __webpack_exports__MuInfinity as MuInfinity, __webpack_exports__MuRouter as MuRouter, __webpack_exports__MuStore as MuStore, __webpack_exports__Router as Router, __webpack_exports__Security as Security, __webpack_exports__Signal as Signal, __webpack_exports__default as default, __webpack_exports__defineComponent as defineComponent, __webpack_exports__effect as effect, __webpack_exports__getCurrentInstance as getCurrentInstance, __webpack_exports__hydrate as hydrate, __webpack_exports__muEffect as muEffect, __webpack_exports__muEntangle as muEntangle, __webpack_exports__muGate as muGate, __webpack_exports__muGeom as muGeom, __webpack_exports__muMeasure as muMeasure, __webpack_exports__muMemo as muMemo, __webpack_exports__muPulse as muPulse, __webpack_exports__muQubit as muQubit, __webpack_exports__muRegister as muRegister, __webpack_exports__muSearch as muSearch, __webpack_exports__muState as muState, __webpack_exports__muTeleport as muTeleport, __webpack_exports__muVault as muVault, __webpack_exports__onMuDestroy as onMuDestroy, __webpack_exports__onMuIdle as onMuIdle, __webpack_exports__onMuInit as onMuInit, __webpack_exports__onMuMount as onMuMount, __webpack_exports__onMuResume as onMuResume, __webpack_exports__onMuShake as onMuShake, __webpack_exports__onMuVoice as onMuVoice, __webpack_exports__persistent as persistent, __webpack_exports__reactive as reactive, __webpack_exports__ref as ref, __webpack_exports__render as render, __webpack_exports__renderToString as renderToString, __webpack_exports__sanitize as sanitize, __webpack_exports__setCurrentInstance as setCurrentInstance, __webpack_exports__useMutation as useMutation, __webpack_exports__useQuery as useQuery };
+export { __webpack_exports__Component as Component, __webpack_exports__MuBlochSphereElement as MuBlochSphereElement, __webpack_exports__MuComponent as MuComponent, __webpack_exports__MuInfinity as MuInfinity, __webpack_exports__MuRouter as MuRouter, __webpack_exports__MuStore as MuStore, __webpack_exports__Router as Router, __webpack_exports__Security as Security, __webpack_exports__Signal as Signal, __webpack_exports__activeControls as activeControls, __webpack_exports__default as default, __webpack_exports__defineComponent as defineComponent, __webpack_exports__effect as effect, __webpack_exports__getCurrentInstance as getCurrentInstance, __webpack_exports__hydrate as hydrate, __webpack_exports__muBurst as muBurst, __webpack_exports__muControl as muControl, __webpack_exports__muEffect as muEffect, __webpack_exports__muEntangle as muEntangle, __webpack_exports__muGate as muGate, __webpack_exports__muGeom as muGeom, __webpack_exports__muMeasure as muMeasure, __webpack_exports__muMemo as muMemo, __webpack_exports__muParallel as muParallel, __webpack_exports__muPulse as muPulse, __webpack_exports__muQubit as muQubit, __webpack_exports__muRegister as muRegister, __webpack_exports__muSearch as muSearch, __webpack_exports__muState as muState, __webpack_exports__muSurge as muSurge, __webpack_exports__muSwitch as muSwitch, __webpack_exports__muTeleport as muTeleport, __webpack_exports__muVault as muVault, __webpack_exports__onMuDestroy as onMuDestroy, __webpack_exports__onMuIdle as onMuIdle, __webpack_exports__onMuInit as onMuInit, __webpack_exports__onMuMount as onMuMount, __webpack_exports__onMuResume as onMuResume, __webpack_exports__onMuShake as onMuShake, __webpack_exports__onMuVoice as onMuVoice, __webpack_exports__persistent as persistent, __webpack_exports__reactive as reactive, __webpack_exports__ref as ref, __webpack_exports__render as render, __webpack_exports__renderToString as renderToString, __webpack_exports__sanitize as sanitize, __webpack_exports__setCurrentInstance as setCurrentInstance, __webpack_exports__useMutation as useMutation, __webpack_exports__useQuery as useQuery };

package/dist/mulan.js

@@ -66,7 +66,7 @@ eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpa
   \*****************************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
-eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   muEntangle: () => (/* binding */ muEntangle),\n/* harmony export */   muGate: () => (/* binding */ muGate),\n/* harmony export */   muMeasure: () => (/* binding */ muMeasure),\n/* harmony export */   muQubit: () => (/* binding */ muQubit),\n/* harmony export */   muRegister: () => (/* binding */ muRegister),\n/* harmony export */   muSearch: () => (/* binding */ muSearch),\n/* harmony export */   muTeleport: () => (/* binding */ muTeleport)\n/* harmony export */ });\n/* harmony import */ var _hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./hooks */ \"./src/core/hooks.ts\");\n\n/**\n * Creates a quantum register of size n.\n * State vector will have 2^n amplitudes.\n */\nfunction muRegister(n) {\n    const numStates = Math.pow(2, n);\n    const amplitudes = new Array(numStates).fill(0).map((_, i) => ({\n        re: i === 0 ? 1 : 0,\n        im: 0\n    }));\n    return (0,_hooks__WEBPACK_IMPORTED_MODULE_0__.muState)({\n        value: {\n            size: n,\n            amplitudes\n        }\n    });\n}\n/**\n * Backward compatible muQubit (Single Qubit Register)\n */\nfunction muQubit(initial = 0) {\n    const q = muRegister(1);\n    if (initial === 1) {\n        muGate(q, 'X', 0);\n    }\n    // Add compatibility properties for Phase 1 components\n    // These properties are getters that dynamically access the amplitudes array\n    Object.defineProperty(q.value, 'alpha', { get: () => q.value.amplitudes[0] });\n    Object.defineProperty(q.value, 'beta', { get: () => q.value.amplitudes[1] });\n    return q;\n}\n/**\n * Internal helper to update register state while maintaining compatibility\n */\nfunction updateState(reg, newState) {\n    if (newState.size === 1) {\n        // Re-inject compatibility getters for muQubit users\n        Object.defineProperty(newState, 'alpha', {\n            get: () => newState.amplitudes[0],\n            configurable: true,\n            enumerable: true\n        });\n        Object.defineProperty(newState, 'beta', {\n            get: () => newState.amplitudes[1],\n            configurable: true,\n            enumerable: true\n        });\n    }\n    reg.value = newState;\n}\nfunction muGate(reg, type, target = 0, control) {\n    const state = reg.value;\n    const n = state.size;\n    const amplitudes = state.amplitudes;\n    const newAmps = amplitudes.map(a => (Object.assign({}, a)));\n    // Helper: Check if all control bits are 1\n    const checkControl = (index, ctrl) => {\n        if (ctrl === undefined)\n            return true;\n        if (typeof ctrl === 'number') {\n            return ((index >> ctrl) & 1) === 1;\n        }\n        return ctrl.every(c => ((index >> c) & 1) === 1);\n    };\n    // SWAP Gate (Unique case: affects 2 targets)\n    if (type === 'SWAP') {\n        const t1 = target;\n        const t2 = control; // SWAP uses control arg as second target \n        // Iterate only half to avoid double swapping\n        for (let i = 0; i < amplitudes.length; i++) {\n            const bit1 = (i >> t1) & 1;\n            const bit2 = (i >> t2) & 1;\n            if (bit1 !== bit2) {\n                // Determine the swap partner index\n                // If i has (0,1), partner has (1,0) at those positions\n                const partner = i ^ (1 << t1) ^ (1 << t2);\n                if (i < partner) {\n                    const temp = newAmps[i];\n                    newAmps[i] = newAmps[partner];\n                    newAmps[partner] = temp;\n                }\n            }\n        }\n        updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));\n        return;\n    }\n    // Standard Single-Qubit & Controlled Gates\n    if (type === 'H') {\n        const s = 1 / Math.sqrt(2);\n        const processed = new Set();\n        for (let i = 0; i < state.amplitudes.length; i++) {\n            if (processed.has(i))\n                continue;\n            // Check Controls first\n            if (!checkControl(i, control))\n                continue;\n            const targetBit = (i >> target) & 1;\n            const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));\n            const a = state.amplitudes[i];\n            const b = state.amplitudes[pairedIndex];\n            if (targetBit === 0) {\n                newAmps[i] = { re: s * (a.re + b.re), im: s * (a.im + b.im) };\n                newAmps[pairedIndex] = { re: s * (a.re - b.re), im: s * (a.im - b.im) };\n            }\n            else {\n                newAmps[pairedIndex] = { re: s * (b.re + a.re), im: s * (b.im + a.im) };\n                newAmps[i] = { re: s * (b.re - a.re), im: s * (b.im - a.im) };\n            }\n            processed.add(i);\n            processed.add(pairedIndex);\n        }\n    }\n    else if (type === 'X' || type === 'CNOT') {\n        // CNOT is just Controlled-X\n        for (let i = 0; i < amplitudes.length; i++) {\n            if (!checkControl(i, control))\n                continue;\n            const targetBit = (i >> target) & 1;\n            const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));\n            if (i < pairedIndex) {\n                const temp = newAmps[i];\n                newAmps[i] = newAmps[pairedIndex];\n                newAmps[pairedIndex] = temp;\n            }\n        }\n    }\n    else if (type === 'Z' || type === 'CZ') {\n        // Z and CZ are Phase Flips\n        for (let i = 0; i < amplitudes.length; i++) {\n            if (!checkControl(i, control))\n                continue;\n            const targetBit = (i >> target) & 1;\n            // Z Gate acts on |1>\n            if (targetBit === 1) {\n                newAmps[i] = { re: -amplitudes[i].re, im: -amplitudes[i].im };\n            }\n        }\n    }\n    else if (type === 'Y') {\n        // Y: |0> -> i|1>, |1> -> -i|0>\n        for (let i = 0; i < amplitudes.length; i++) {\n            if (!checkControl(i, control))\n                continue;\n            const targetBit = (i >> target) & 1;\n            const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));\n            if (i < pairedIndex) {\n                // We process pairs (i, pairedIndex) where i has 0 at target, paired has 1\n                const a = newAmps[i]; // Coeff of |0>\n                const b = newAmps[pairedIndex]; // Coeff of |1>\n                // New |0> = -i * Old |1>\n                newAmps[i] = { re: b.im, im: -b.re };\n                // New |1> = i * Old |0>\n                newAmps[pairedIndex] = { re: -a.im, im: a.re };\n            }\n        }\n    }\n    updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));\n}\n/**\n * Mulan Search Logic (Grover's Operator)\n * Automatically constructs a multi-controlled Phase Flip (Z) for a specific target state.\n * This is the core of the \"Quantum Switch\" or \"Quantum Search\" capability.\n * @param reg Quantum Register\n * @param targetState The integer state to \"search\" and mark (e.g. 2 for |10>)\n */\nfunction muSearch(reg, targetState) {\n    const n = reg.value.size;\n    const controls = [];\n    // 1. Identify which bits are 0 and need wrapping with X gates\n    // Logic: To mark |010>, we want C-C-Z to trigger on 111.\n    // So we apply X to bits that are 0, then C-C-Z, then X again.\n    // We treat the last bit as the 'target' for the Z gate, rest as controls\n    const targetQubit = n - 1;\n    for (let i = 0; i < n; i++) {\n        const bit = (targetState >> i) & 1;\n        if (i === targetQubit) {\n            // If target bit logic requires 0, we flip it to 1 for the Z gate to work\n            if (bit === 0)\n                muGate(reg, 'X', i);\n        }\n        else {\n            controls.push(i);\n            if (bit === 0)\n                muGate(reg, 'X', i);\n        }\n    }\n    // 2. Apply Multi-Controlled Z\n    muGate(reg, 'Z', targetQubit, controls);\n    // 3. Uncompute (Restore 0s)\n    for (let i = 0; i < n; i++) {\n        const bit = (targetState >> i) & 1;\n        if (bit === 0)\n            muGate(reg, 'X', i);\n    }\n    // --- GROVER DIFFUSER (Amplification) ---\n    // This flips the probability amplitudes around the mean, boosting the target state.\n    // 1. Apply H to all\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'H', i);\n    // 2. Apply X to all\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'X', i);\n    // 3. Multi-Controlled Z (Reflection about |0...0>)\n    // We want to flip phase of |11...1> state after X transformation (which corresponds to |00...0> original)\n    // Target is last qubit, controls are 0 to n-2\n    const diffControls = [];\n    for (let i = 0; i < n - 1; i++)\n        diffControls.push(i);\n    muGate(reg, 'Z', n - 1, diffControls);\n    // 4. Uncompute X\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'X', i);\n    // 5. Uncompute H\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'H', i);\n}\nfunction muEntangle(reg, i, j) {\n    muGate(reg, 'H', i);\n    muGate(reg, 'CNOT', j, i);\n}\n/**\n * Quantum Teleportation Protocol\n * Transfers the state of `msgIdx` to `targetIdx` using `ancillaIdx` as a resource.\n * @param reg Register\n * @param msgIdx The qubit containing the state to teleport (Alice)\n * @param ancillaIdx The helper qubit (Alice's half of entanglement)\n * @param targetIdx The destination qubit (Bob)\n */\nfunction muTeleport(reg, msgIdx, ancillaIdx, targetIdx) {\n    // 1. Create Bell Pair (Entanglement) between Ancilla and Target\n    // Represents the shared link between Alice and Bob\n    muEntangle(reg, ancillaIdx, targetIdx);\n    // 2. Bell Measurement on Message + Ancilla (Alice's side)\n    muGate(reg, 'CNOT', ancillaIdx, msgIdx); // Control: msg, Target: ancilla\n    muGate(reg, 'H', msgIdx);\n    // 3. Measure Alice's qubits (This collapses them)\n    const m1 = muMeasure(reg, msgIdx); // Measures \"Z\" component\n    const m2 = muMeasure(reg, ancillaIdx); // Measures \"X\" component\n    // 4. Classical Communication & Correction (Bob's side)\n    // Apply corrections to Target based on measurements\n    if (m2 === 1)\n        muGate(reg, 'X', targetIdx);\n    if (m1 === 1)\n        muGate(reg, 'Z', targetIdx);\n}\n/**\n * Measures a specific qubit in the register, collapsing the superposition.\n * @param reg Quantum Register\n * @param target Index of qubit to measure\n * @returns 0 or 1\n */\nfunction muMeasure(reg, target = 0) {\n    const state = reg.value;\n    const amplitudes = state.amplitudes;\n    let prob0 = 0;\n    // 1. Calculate Probability of |0>\n    for (let i = 0; i < amplitudes.length; i++) {\n        if (((i >> target) & 1) === 0) {\n            const a = amplitudes[i];\n            prob0 += (a.re * a.re) + (a.im * a.im);\n        }\n    }\n    // 2. Determine Outcome\n    const result = Math.random() < prob0 ? 0 : 1;\n    const resultProb = result === 0 ? prob0 : (1 - prob0);\n    const normFactor = resultProb > 0 ? (1 / Math.sqrt(resultProb)) : 0;\n    // 3. Collapse the State (Wavefunction Collapse)\n    const newAmps = amplitudes.map((a, i) => {\n        const bit = (i >> target) & 1;\n        if (bit !== result) {\n            return { re: 0, im: 0 };\n        }\n        else {\n            return { re: a.re * normFactor, im: a.im * normFactor };\n        }\n    });\n    // We need to call updateState to ensure reactivity if specialized getters exist\n    // But since this file has updateState internal, we can just call it.\n    // However, the internal updateState function needs to be in scope. \n    // It is defined at line 60. So we are good.\n    updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));\n    return result;\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/quantum.ts?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   activeControls: () => (/* binding */ activeControls),\n/* harmony export */   muControl: () => (/* binding */ muControl),\n/* harmony export */   muEntangle: () => (/* binding */ muEntangle),\n/* harmony export */   muGate: () => (/* binding */ muGate),\n/* harmony export */   muMeasure: () => (/* binding */ muMeasure),\n/* harmony export */   muParallel: () => (/* binding */ muParallel),\n/* harmony export */   muQubit: () => (/* binding */ muQubit),\n/* harmony export */   muRegister: () => (/* binding */ muRegister),\n/* harmony export */   muSearch: () => (/* binding */ muSearch),\n/* harmony export */   muSwitch: () => (/* binding */ muSwitch),\n/* harmony export */   muTeleport: () => (/* binding */ muTeleport)\n/* harmony export */ });\n/* harmony import */ var _hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./hooks */ \"./src/core/hooks.ts\");\n\n/**\n * Mulan Quantum (ASTR-Q+) Core\n * Advanced Simulation Engine for multi-qubit registers and entanglement.\n */\n// -- GLOBAL CONTEXT FOR QUANTUM CONTROL --\n// Defined at top to ensure visibility for muGate\nlet activeControls = [];\n/**\n * Creates a quantum register of size n.\n * State vector will have 2^n amplitudes.\n */\nfunction muRegister(n) {\n    const numStates = Math.pow(2, n);\n    const amplitudes = new Array(numStates).fill(0).map((_, i) => ({\n        re: i === 0 ? 1 : 0,\n        im: 0\n    }));\n    return (0,_hooks__WEBPACK_IMPORTED_MODULE_0__.muState)({\n        value: {\n            size: n,\n            amplitudes\n        }\n    });\n}\n/**\n * Backward compatible muQubit (Single Qubit Register)\n */\nfunction muQubit(initial = 0) {\n    const q = muRegister(1);\n    if (initial === 1) {\n        muGate(q, 'X', 0);\n    }\n    // Add compatibility properties for Phase 1 components\n    // These properties are getters that dynamically access the amplitudes array\n    Object.defineProperty(q.value, 'alpha', { get: () => q.value.amplitudes[0] });\n    Object.defineProperty(q.value, 'beta', { get: () => q.value.amplitudes[1] });\n    return q;\n}\n/**\n * Internal helper to update register state while maintaining compatibility\n */\nfunction updateState(reg, newState) {\n    if (newState.size === 1) {\n        // Re-inject compatibility getters for muQubit users\n        Object.defineProperty(newState, 'alpha', {\n            get: () => newState.amplitudes[0],\n            configurable: true,\n            enumerable: true\n        });\n        Object.defineProperty(newState, 'beta', {\n            get: () => newState.amplitudes[1],\n            configurable: true,\n            enumerable: true\n        });\n    }\n    reg.value = newState;\n}\nfunction muGate(reg, type, target = 0, control) {\n    const state = reg.value;\n    const n = state.size;\n    const amplitudes = state.amplitudes;\n    const newAmps = amplitudes.map(a => (Object.assign({}, a)));\n    // Prepare Effective Control (Explicit Arguments + Global Context)\n    const effectiveControl = [...(control === undefined ? [] : (Array.isArray(control) ? control : [control])), ...activeControls];\n    // Helper: Check if all control bits are 1\n    const checkControl = (index, ctrl) => {\n        if (ctrl === undefined || (Array.isArray(ctrl) && ctrl.length === 0))\n            return true;\n        const ctrls = Array.isArray(ctrl) ? ctrl : [ctrl];\n        return ctrls.every(c => ((index >> c) & 1) === 1);\n    };\n    // SWAP Gate (Unique case: affects 2 targets)\n    if (type === 'SWAP') {\n        const t1 = target;\n        const t2 = control; // SWAP uses control arg as second target \n        // Iterate only half to avoid double swapping\n        for (let i = 0; i < amplitudes.length; i++) {\n            // Check active controls for SWAP too\n            if (activeControls.length > 0 && !checkControl(i, activeControls))\n                continue;\n            const bit1 = (i >> t1) & 1;\n            const bit2 = (i >> t2) & 1;\n            if (bit1 !== bit2) {\n                // Determine the swap partner index\n                // If i has (0,1), partner has (1,0) at those positions\n                const partner = i ^ (1 << t1) ^ (1 << t2);\n                if (i < partner) {\n                    const temp = newAmps[i];\n                    newAmps[i] = newAmps[partner];\n                    newAmps[partner] = temp;\n                }\n            }\n        }\n        updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));\n        return;\n    }\n    // Standard Single-Qubit & Controlled Gates\n    if (type === 'H') {\n        const s = 1 / Math.sqrt(2);\n        const processed = new Set();\n        for (let i = 0; i < state.amplitudes.length; i++) {\n            if (processed.has(i))\n                continue;\n            // Check Controls first\n            if (!checkControl(i, effectiveControl))\n                continue;\n            const targetBit = (i >> target) & 1;\n            const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));\n            const a = state.amplitudes[i];\n            const b = state.amplitudes[pairedIndex];\n            if (targetBit === 0) {\n                newAmps[i] = { re: s * (a.re + b.re), im: s * (a.im + b.im) };\n                newAmps[pairedIndex] = { re: s * (a.re - b.re), im: s * (a.im - b.im) };\n            }\n            else {\n                newAmps[pairedIndex] = { re: s * (b.re + a.re), im: s * (b.im + a.im) };\n                newAmps[i] = { re: s * (b.re - a.re), im: s * (b.im - a.im) };\n            }\n            processed.add(i);\n            processed.add(pairedIndex);\n        }\n    }\n    else if (type === 'X' || type === 'CNOT') {\n        // CNOT is just Controlled-X\n        for (let i = 0; i < amplitudes.length; i++) {\n            if (!checkControl(i, effectiveControl))\n                continue;\n            const targetBit = (i >> target) & 1;\n            const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));\n            if (i < pairedIndex) {\n                const temp = newAmps[i];\n                newAmps[i] = newAmps[pairedIndex];\n                newAmps[pairedIndex] = temp;\n            }\n        }\n    }\n    else if (type === 'Z' || type === 'CZ') {\n        // Z and CZ are Phase Flips\n        for (let i = 0; i < amplitudes.length; i++) {\n            if (!checkControl(i, effectiveControl))\n                continue;\n            const targetBit = (i >> target) & 1;\n            // Z Gate acts on |1>\n            if (targetBit === 1) {\n                newAmps[i] = { re: -amplitudes[i].re, im: -amplitudes[i].im };\n            }\n        }\n    }\n    else if (type === 'Y') {\n        // Y: |0> -> i|1>, |1> -> -i|0>\n        for (let i = 0; i < amplitudes.length; i++) {\n            if (!checkControl(i, effectiveControl))\n                continue;\n            const targetBit = (i >> target) & 1;\n            const pairedIndex = targetBit ? (i & ~(1 << target)) : (i | (1 << target));\n            if (i < pairedIndex) {\n                // We process pairs (i, pairedIndex) where i has 0 at target, paired has 1\n                const a = newAmps[i]; // Coeff of |0>\n                const b = newAmps[pairedIndex]; // Coeff of |1>\n                // New |0> = -i * Old |1>\n                newAmps[i] = { re: b.im, im: -b.re };\n                // New |1> = i * Old |0>\n                newAmps[pairedIndex] = { re: -a.im, im: a.re };\n            }\n        }\n    }\n    updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));\n}\n/**\n * Mulan Search Logic (Grover's Operator)\n * Automatically constructs a multi-controlled Phase Flip (Z) for a specific target state.\n * This is the core of the \"Quantum Switch\" or \"Quantum Search\" capability.\n * @param reg Quantum Register\n * @param targetState The integer state to \"search\" and mark (e.g. 2 for |10>)\n */\nfunction muSearch(reg, targetState) {\n    const n = reg.value.size;\n    const controls = [];\n    // 1. Identify which bits are 0 and need wrapping with X gates\n    // Logic: To mark |010>, we want C-C-Z to trigger on 111.\n    // So we apply X to bits that are 0, then C-C-Z, then X again.\n    // We treat the last bit as the 'target' for the Z gate, rest as controls\n    const targetQubit = n - 1;\n    for (let i = 0; i < n; i++) {\n        const bit = (targetState >> i) & 1;\n        if (i === targetQubit) {\n            // If target bit logic requires 0, we flip it to 1 for the Z gate to work\n            if (bit === 0)\n                muGate(reg, 'X', i);\n        }\n        else {\n            controls.push(i);\n            if (bit === 0)\n                muGate(reg, 'X', i);\n        }\n    }\n    // 2. Apply Multi-Controlled Z\n    muGate(reg, 'Z', targetQubit, controls);\n    // 3. Uncompute (Restore 0s)\n    for (let i = 0; i < n; i++) {\n        const bit = (targetState >> i) & 1;\n        if (bit === 0)\n            muGate(reg, 'X', i);\n    }\n    // --- GROVER DIFFUSER (Amplification) ---\n    // This flips the probability amplitudes around the mean, boosting the target state.\n    // 1. Apply H to all\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'H', i);\n    // 2. Apply X to all\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'X', i);\n    // 3. Multi-Controlled Z (Reflection about |0...0>)\n    // We want to flip phase of |11...1> state after X transformation (which corresponds to |00...0> original)\n    // Target is last qubit, controls are 0 to n-2\n    const diffControls = [];\n    for (let i = 0; i < n - 1; i++)\n        diffControls.push(i);\n    muGate(reg, 'Z', n - 1, diffControls);\n    // 4. Uncompute X\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'X', i);\n    // 5. Uncompute H\n    for (let i = 0; i < n; i++)\n        muGate(reg, 'H', i);\n}\nfunction muEntangle(reg, i, j) {\n    muGate(reg, 'H', i);\n    muGate(reg, 'CNOT', j, i);\n}\n/**\n * Quantum Teleportation Protocol\n * Transfers the state of `msgIdx` to `targetIdx` using `ancillaIdx` as a resource.\n * @param reg Register\n * @param msgIdx The qubit containing the state to teleport (Alice)\n * @param ancillaIdx The helper qubit (Alice's half of entanglement)\n * @param targetIdx The destination qubit (Bob)\n */\nfunction muTeleport(reg, msgIdx, ancillaIdx, targetIdx) {\n    // 1. Create Bell Pair (Entanglement) between Ancilla and Target\n    // Represents the shared link between Alice and Bob\n    muEntangle(reg, ancillaIdx, targetIdx);\n    // 2. Bell Measurement on Message + Ancilla (Alice's side)\n    muGate(reg, 'CNOT', ancillaIdx, msgIdx); // Control: msg, Target: ancilla\n    muGate(reg, 'H', msgIdx);\n    // 3. Measure Alice's qubits (This collapses them)\n    const m1 = muMeasure(reg, msgIdx); // Measures \"Z\" component\n    const m2 = muMeasure(reg, ancillaIdx); // Measures \"X\" component\n    // 4. Classical Communication & Correction (Bob's side)\n    // Apply corrections to Target based on measurements\n    if (m2 === 1)\n        muGate(reg, 'X', targetIdx);\n    if (m1 === 1)\n        muGate(reg, 'Z', targetIdx);\n}\n/**\n * Measures a specific qubit in the register, collapsing the superposition.\n * @param reg Quantum Register\n * @param target Index of qubit to measure\n * @returns 0 or 1\n */\nfunction muMeasure(reg, target = 0) {\n    const state = reg.value;\n    const amplitudes = state.amplitudes;\n    let prob0 = 0;\n    // 1. Calculate Probability of |0>\n    for (let i = 0; i < amplitudes.length; i++) {\n        if (((i >> target) & 1) === 0) {\n            const a = amplitudes[i];\n            prob0 += (a.re * a.re) + (a.im * a.im);\n        }\n    }\n    // 2. Determine Outcome\n    const result = Math.random() < prob0 ? 0 : 1;\n    const resultProb = result === 0 ? prob0 : (1 - prob0);\n    const normFactor = resultProb > 0 ? (1 / Math.sqrt(resultProb)) : 0;\n    // 3. Collapse the State (Wavefunction Collapse)\n    const newAmps = amplitudes.map((a, i) => {\n        const bit = (i >> target) & 1;\n        if (bit !== result) {\n            return { re: 0, im: 0 };\n        }\n        else {\n            return { re: a.re * normFactor, im: a.im * normFactor };\n        }\n    });\n    // We need to call updateState to ensure reactivity if specialized getters exist\n    // But since this file has updateState internal, we can just call it.\n    // However, the internal updateState function needs to be in scope. \n    // It is defined at line 60. So we are good.\n    updateState(reg, Object.assign(Object.assign({}, state), { amplitudes: newAmps }));\n    return result;\n}\n/**\n * Quantum Loop: Parallel Execution\n * Applies a gate to multiple qubits \"simultaneously\" (in simulation steps).\n * Ideal for initialization (Hadamard Transform) or global operations.\n * @param reg Quantum Register\n * @param qubits Array of qubit indices\n * @param gate Gate type to apply (e.g. 'H', 'X')\n */\nfunction muParallel(reg, qubits, gate) {\n    if (gate === 'SWAP') {\n        throw new Error(\"SWAP cannot be applied in parallel (requires pairs).\");\n    }\n    // In a real quantum computer, these happen at t=0.\n    // Here, we loop, but logical time is constant.\n    qubits.forEach(q => muGate(reg, gate, q));\n}\n/**\n * Applies a block of operations controlled by specific qubits.\n * Enables \"Quantum If/Else\".\n */\nfunction muControl(reg, controlQubit, inverse, block) {\n    // 1. Setup Context\n    if (inverse) {\n        muGate(reg, 'X', controlQubit); // Flip 0 to 1 to activate\n    }\n    activeControls.push(controlQubit);\n    try {\n        block();\n    }\n    finally {\n        activeControls.pop();\n        // Uncompute (Restore 0)\n        if (inverse) {\n            muGate(reg, 'X', controlQubit);\n        }\n    }\n}\n/**\n * Quantum Switch: conditional Logic on Superposition\n * Executes different logic branches based on the state of control qubits.\n * Because the register can be in a superposition of states (e.g. |0> + |1>),\n * MULTIPLE branches can execute effectively simultaneously on different subspaces.\n *\n * @param reg Quantum Register\n * @param controlQubit The qubit controlling the switch (Single control for v1)\n * @param cases Object mapping state (0 or 1) to a function executing quantum operations\n */\nfunction muSwitch(reg, controlQubit, cases) {\n    if (cases[0]) {\n        muControl(reg, controlQubit, true, cases[0]);\n    }\n    if (cases[1]) {\n        muControl(reg, controlQubit, false, cases[1]);\n    }\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/quantum.ts?\n}");
 
 /***/ },
 
@@ -76,7 +76,7 @@ eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpa
   \***************************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
-eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   useMutation: () => (/* binding */ useMutation),\n/* harmony export */   useQuery: () => (/* binding */ useQuery)\n/* harmony export */ });\n/* harmony import */ var _reactive__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./reactive */ \"./src/core/reactive.ts\");\nvar __awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\n    return new (P || (P = Promise))(function (resolve, reject) {\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\n    });\n};\n\nfunction useQuery(queryFn, options = { enabled: true }) {\n    const state = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)({\n        data: null,\n        isLoading: false,\n        error: null\n    });\n    const execute = () => __awaiter(this, void 0, void 0, function* () {\n        state.isLoading = true;\n        state.error = null;\n        try {\n            const result = yield queryFn();\n            state.data = result;\n        }\n        catch (err) {\n            state.error = err;\n        }\n        finally {\n            state.isLoading = false;\n        }\n    });\n    if (options.enabled) {\n        // Run automatically\n        (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.effect)(() => {\n            // Basic effect wrapper to allow reactivity if queryFn relies on signals\n            execute();\n        });\n    }\n    return Object.assign(Object.assign({}, state), { refetch: execute });\n}\nfunction useMutation(mutationFn) {\n    const state = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)({\n        data: null,\n        isLoading: false,\n        error: null\n    });\n    const mutate = (args) => __awaiter(this, void 0, void 0, function* () {\n        state.isLoading = true;\n        state.error = null;\n        try {\n            const result = yield mutationFn(args);\n            state.data = result;\n            return result;\n        }\n        catch (err) {\n            state.error = err;\n            throw err;\n        }\n        finally {\n            state.isLoading = false;\n        }\n    });\n    return Object.assign(Object.assign({}, state), { mutate });\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/query.ts?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   useMutation: () => (/* binding */ useMutation),\n/* harmony export */   useQuery: () => (/* binding */ useQuery)\n/* harmony export */ });\n/* harmony import */ var _reactive__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./reactive */ \"./src/core/reactive.ts\");\nvar __awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\n    return new (P || (P = Promise))(function (resolve, reject) {\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\n    });\n};\n\nfunction useQuery(queryFn, options = { enabled: true }) {\n    const state = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)({\n        data: null,\n        isLoading: false,\n        error: null\n    });\n    const execute = () => __awaiter(this, void 0, void 0, function* () {\n        state.isLoading = true;\n        state.error = null;\n        try {\n            const result = yield queryFn();\n            state.data = result;\n        }\n        catch (err) {\n            state.error = err;\n        }\n        finally {\n            state.isLoading = false;\n        }\n    });\n    if (options.enabled) {\n        // Run automatically\n        (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.effect)(() => {\n            // Basic effect wrapper to allow reactivity if queryFn relies on signals\n            execute();\n        });\n    }\n    return {\n        get data() { return state.data; },\n        get isLoading() { return state.isLoading; },\n        get error() { return state.error; },\n        refetch: execute\n    };\n}\nfunction useMutation(mutationFn) {\n    const state = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)({\n        data: null,\n        isLoading: false,\n        error: null\n    });\n    const mutate = (args) => __awaiter(this, void 0, void 0, function* () {\n        state.isLoading = true;\n        state.error = null;\n        try {\n            const result = yield mutationFn(args);\n            state.data = result;\n            return result;\n        }\n        catch (err) {\n            state.error = err;\n            throw err;\n        }\n        finally {\n            state.isLoading = false;\n        }\n    });\n    return {\n        get data() { return state.data; },\n        get isLoading() { return state.isLoading; },\n        get error() { return state.error; },\n        mutate\n    };\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/query.ts?\n}");
 
 /***/ },
 
@@ -100,6 +100,16 @@ eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpa
 
 /***/ },
 
+/***/ "./src/core/surge.ts"
+/*!***************************!*\
+  !*** ./src/core/surge.ts ***!
+  \***************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   muBurst: () => (/* binding */ muBurst),\n/* harmony export */   muSurge: () => (/* binding */ muSurge)\n/* harmony export */ });\n/**\n * muBurst - Adaptive Non-blocking Iterator\n * Processes large arrays in batches within a frame budget (typically 8-16ms)\n * to keep the UI responsive while executing at near-native loop speeds.\n */\nfunction muBurst(array, callback, options = {}) {\n    const { chunkSize = 1000, timeout = 8, onProgress } = options;\n    return new Promise((resolve) => {\n        let index = 0;\n        const total = array.length;\n        function process() {\n            const start = performance.now();\n            // Tight loop for high-speed processing\n            while (index < total && (performance.now() - start) < timeout) {\n                // Process in smaller bursts to allow more frequent time checks if needed\n                const endBurst = Math.min(index + chunkSize, total);\n                for (; index < endBurst; index++) {\n                    callback(array[index], index);\n                }\n            }\n            if (onProgress) {\n                onProgress((index / total) * 100);\n            }\n            if (index < total) {\n                requestAnimationFrame(process);\n            }\n            else {\n                resolve();\n            }\n        }\n        process();\n    });\n}\n/**\n * muSurge - Truly Parallel Execution\n * Distributes work across CPU cores using Web Workers.\n * Logic must be serializable.\n */\nfunction muSurge(array, taskFn, onProgress) {\n    const n = navigator.hardwareConcurrency || 4;\n    const chunkSize = Math.ceil(array.length / n);\n    const results = new Array(array.length);\n    let completedChunks = 0;\n    let completedItems = 0;\n    // Convert function to string if it isn't already\n    const fnStr = typeof taskFn === 'function' ? taskFn.toString() : taskFn;\n    const workerCode = `\r\n        self.onmessage = function(e) {\r\n            const { chunk, startIndex, fnStr } = e.data;\r\n            const fn = new Function('item', 'return (' + fnStr + ')(item)');\r\n            const results = chunk.map(fn);\r\n            self.postMessage({ results, startIndex });\r\n        };\r\n    `;\n    const blob = new Blob([workerCode], { type: 'application/javascript' });\n    const workerUrl = URL.createObjectURL(blob);\n    return new Promise((resolve) => {\n        if (array.length === 0)\n            return resolve([]);\n        for (let i = 0; i < n; i++) {\n            const start = i * chunkSize;\n            const end = Math.min(start + chunkSize, array.length);\n            if (start >= end) {\n                completedChunks++;\n                continue;\n            }\n            const chunk = array.slice(start, end);\n            const worker = new Worker(workerUrl);\n            worker.onmessage = (e) => {\n                const { results: chunkResults, startIndex } = e.data;\n                // Merge results back into main array\n                for (let j = 0; j < chunkResults.length; j++) {\n                    results[startIndex + j] = chunkResults[j];\n                }\n                completedChunks++;\n                completedItems += chunkResults.length;\n                if (onProgress)\n                    onProgress((completedItems / array.length) * 100);\n                worker.terminate();\n                if (completedChunks === n) {\n                    URL.revokeObjectURL(workerUrl);\n                    resolve(results);\n                }\n            };\n            worker.postMessage({ chunk, startIndex: start, fnStr });\n        }\n    });\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/surge.ts?\n}");
+
+/***/ },
+
 /***/ "./src/core/vault.ts"
 /*!***************************!*\
   !*** ./src/core/vault.ts ***!
@@ -116,7 +126,7 @@ eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpa
   \**********************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
-eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   Component: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent),\n/* harmony export */   MuBlochSphereElement: () => (/* reexport safe */ _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_10__.MuBlochSphereElement),\n/* harmony export */   MuComponent: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent),\n/* harmony export */   MuInfinity: () => (/* reexport safe */ _components_infinity_list__WEBPACK_IMPORTED_MODULE_11__.MuInfinity),\n/* harmony export */   MuRouter: () => (/* reexport safe */ _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter),\n/* harmony export */   MuStore: () => (/* reexport safe */ _store_index__WEBPACK_IMPORTED_MODULE_4__.MuStore),\n/* harmony export */   Router: () => (/* reexport safe */ _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter),\n/* harmony export */   Security: () => (/* reexport safe */ _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__.Security),\n/* harmony export */   Signal: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.Signal),\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__),\n/* harmony export */   defineComponent: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.defineComponent),\n/* harmony export */   effect: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect),\n/* harmony export */   getCurrentInstance: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.getCurrentInstance),\n/* harmony export */   hydrate: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.hydrate),\n/* harmony export */   muEffect: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muEffect),\n/* harmony export */   muEntangle: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muEntangle),\n/* harmony export */   muGate: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muGate),\n/* harmony export */   muGeom: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muGeom),\n/* harmony export */   muMeasure: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muMeasure),\n/* harmony export */   muMemo: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muMemo),\n/* harmony export */   muPulse: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muPulse),\n/* harmony export */   muQubit: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muQubit),\n/* harmony export */   muRegister: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muRegister),\n/* harmony export */   muSearch: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muSearch),\n/* harmony export */   muState: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muState),\n/* harmony export */   muTeleport: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muTeleport),\n/* harmony export */   muVault: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muVault),\n/* harmony export */   onMuDestroy: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuDestroy),\n/* harmony export */   onMuIdle: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuIdle),\n/* harmony export */   onMuInit: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuInit),\n/* harmony export */   onMuMount: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuMount),\n/* harmony export */   onMuResume: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuResume),\n/* harmony export */   onMuShake: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuShake),\n/* harmony export */   onMuVoice: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuVoice),\n/* harmony export */   persistent: () => (/* reexport safe */ _core_vault__WEBPACK_IMPORTED_MODULE_8__.persistent),\n/* harmony export */   reactive: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive),\n/* harmony export */   ref: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.ref),\n/* harmony export */   render: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.render),\n/* harmony export */   renderToString: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.renderToString),\n/* harmony export */   sanitize: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.sanitize),\n/* harmony export */   setCurrentInstance: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.setCurrentInstance),\n/* harmony export */   useMutation: () => (/* reexport safe */ _core_query__WEBPACK_IMPORTED_MODULE_7__.useMutation),\n/* harmony export */   useQuery: () => (/* reexport safe */ _core_query__WEBPACK_IMPORTED_MODULE_7__.useQuery)\n/* harmony export */ });\n/* harmony import */ var _core_reactive__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./core/reactive */ \"./src/core/reactive.ts\");\n/* harmony import */ var _core_component__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./core/component */ \"./src/core/component.ts\");\n/* harmony import */ var _core_renderer__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./core/renderer */ \"./src/core/renderer.ts\");\n/* harmony import */ var _router_index__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./router/index */ \"./src/router/index.ts\");\n/* harmony import */ var _store_index__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./store/index */ \"./src/store/index.ts\");\n/* harmony import */ var _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./security/sanitizer */ \"./src/security/sanitizer.ts\");\n/* harmony import */ var _core_hooks__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./core/hooks */ \"./src/core/hooks.ts\");\n/* harmony import */ var _core_query__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./core/query */ \"./src/core/query.ts\");\n/* harmony import */ var _core_vault__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./core/vault */ \"./src/core/vault.ts\");\n/* harmony import */ var _core_quantum__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./core/quantum */ \"./src/core/quantum.ts\");\n/* harmony import */ var _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./components/bloch-sphere */ \"./src/components/bloch-sphere.ts\");\n/* harmony import */ var _components_infinity_list__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ./components/infinity-list */ \"./src/components/infinity-list.ts\");\n\n\n\n\n\n\n\n\n\n\n\n\n// Global Mulan Object for non-module usage\n\n\n\n\n\n\n\n\n\n\nconst Mulan = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ reactive: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive,\n    effect: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect, Component: _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent, defineComponent: _core_component__WEBPACK_IMPORTED_MODULE_1__.defineComponent, Router: _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter, createRouter: _router_index__WEBPACK_IMPORTED_MODULE_3__.createRouter, Store: _store_index__WEBPACK_IMPORTED_MODULE_4__.MuStore, Security: _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__.Security }, _core_hooks__WEBPACK_IMPORTED_MODULE_6__), _core_query__WEBPACK_IMPORTED_MODULE_7__), _core_quantum__WEBPACK_IMPORTED_MODULE_9__), _components_infinity_list__WEBPACK_IMPORTED_MODULE_11__), { render: _core_renderer__WEBPACK_IMPORTED_MODULE_2__.render, \n    // MULAN INSIGHT: Branded Logging\n    log: (msg, ...args) => {\n        console.log(`%c[MulanJS]%c ${msg}`, \"color: #ff3e00; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;\", \"\", ...args);\n    }, warn: (msg, ...args) => {\n        console.warn(`%c[MulanJS]%c ${msg}`, \"color: #ffcc00; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;\", \"\", ...args);\n    }, error: (msg, ...args) => {\n        console.error(`%c[MulanJS]%c ${msg}`, \"color: #ff0000; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;\", \"\", ...args);\n    } });\n// Security: Freeze the object to prevent runtime tampering\nObject.freeze(Mulan);\nObject.freeze(Mulan.Security);\n// MULAN INSIGHT: Initialize Global Registry\nif (typeof window !== 'undefined') {\n    window.__MULAN_INSIGHT__ = window.__MULAN_INSIGHT__ || { components: new Map() };\n    // MULAN INSIGHT: HMR Support\n    window.__MULAN_REFRESH__ = () => {\n        var _a;\n        const components = (_a = window.__MULAN_INSIGHT__) === null || _a === void 0 ? void 0 : _a.components;\n        if (components) {\n            components.forEach((comp) => {\n                if (comp && typeof comp.update === 'function') {\n                    // Force refresh\n                    comp.update();\n                }\n            });\n        }\n    };\n}\nif (typeof window !== 'undefined') {\n    window.Mulan = Mulan;\n}\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Mulan);\n\n\n//# sourceURL=webpack://Mulan/./src/index.ts?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   Component: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent),\n/* harmony export */   MuBlochSphereElement: () => (/* reexport safe */ _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_11__.MuBlochSphereElement),\n/* harmony export */   MuComponent: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent),\n/* harmony export */   MuInfinity: () => (/* reexport safe */ _components_infinity_list__WEBPACK_IMPORTED_MODULE_12__.MuInfinity),\n/* harmony export */   MuRouter: () => (/* reexport safe */ _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter),\n/* harmony export */   MuStore: () => (/* reexport safe */ _store_index__WEBPACK_IMPORTED_MODULE_4__.MuStore),\n/* harmony export */   Router: () => (/* reexport safe */ _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter),\n/* harmony export */   Security: () => (/* reexport safe */ _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__.Security),\n/* harmony export */   Signal: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.Signal),\n/* harmony export */   activeControls: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.activeControls),\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__),\n/* harmony export */   defineComponent: () => (/* reexport safe */ _core_component__WEBPACK_IMPORTED_MODULE_1__.defineComponent),\n/* harmony export */   effect: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect),\n/* harmony export */   getCurrentInstance: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.getCurrentInstance),\n/* harmony export */   hydrate: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.hydrate),\n/* harmony export */   muBurst: () => (/* reexport safe */ _core_surge__WEBPACK_IMPORTED_MODULE_10__.muBurst),\n/* harmony export */   muControl: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muControl),\n/* harmony export */   muEffect: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muEffect),\n/* harmony export */   muEntangle: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muEntangle),\n/* harmony export */   muGate: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muGate),\n/* harmony export */   muGeom: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muGeom),\n/* harmony export */   muMeasure: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muMeasure),\n/* harmony export */   muMemo: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muMemo),\n/* harmony export */   muParallel: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muParallel),\n/* harmony export */   muPulse: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muPulse),\n/* harmony export */   muQubit: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muQubit),\n/* harmony export */   muRegister: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muRegister),\n/* harmony export */   muSearch: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muSearch),\n/* harmony export */   muState: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muState),\n/* harmony export */   muSurge: () => (/* reexport safe */ _core_surge__WEBPACK_IMPORTED_MODULE_10__.muSurge),\n/* harmony export */   muSwitch: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muSwitch),\n/* harmony export */   muTeleport: () => (/* reexport safe */ _core_quantum__WEBPACK_IMPORTED_MODULE_9__.muTeleport),\n/* harmony export */   muVault: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.muVault),\n/* harmony export */   onMuDestroy: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuDestroy),\n/* harmony export */   onMuIdle: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuIdle),\n/* harmony export */   onMuInit: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuInit),\n/* harmony export */   onMuMount: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuMount),\n/* harmony export */   onMuResume: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuResume),\n/* harmony export */   onMuShake: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuShake),\n/* harmony export */   onMuVoice: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.onMuVoice),\n/* harmony export */   persistent: () => (/* reexport safe */ _core_vault__WEBPACK_IMPORTED_MODULE_8__.persistent),\n/* harmony export */   reactive: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive),\n/* harmony export */   ref: () => (/* reexport safe */ _core_reactive__WEBPACK_IMPORTED_MODULE_0__.ref),\n/* harmony export */   render: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.render),\n/* harmony export */   renderToString: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.renderToString),\n/* harmony export */   sanitize: () => (/* reexport safe */ _core_renderer__WEBPACK_IMPORTED_MODULE_2__.sanitize),\n/* harmony export */   setCurrentInstance: () => (/* reexport safe */ _core_hooks__WEBPACK_IMPORTED_MODULE_6__.setCurrentInstance),\n/* harmony export */   useMutation: () => (/* reexport safe */ _core_query__WEBPACK_IMPORTED_MODULE_7__.useMutation),\n/* harmony export */   useQuery: () => (/* reexport safe */ _core_query__WEBPACK_IMPORTED_MODULE_7__.useQuery)\n/* harmony export */ });\n/* harmony import */ var _core_reactive__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./core/reactive */ \"./src/core/reactive.ts\");\n/* harmony import */ var _core_component__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./core/component */ \"./src/core/component.ts\");\n/* harmony import */ var _core_renderer__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./core/renderer */ \"./src/core/renderer.ts\");\n/* harmony import */ var _router_index__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./router/index */ \"./src/router/index.ts\");\n/* harmony import */ var _store_index__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./store/index */ \"./src/store/index.ts\");\n/* harmony import */ var _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./security/sanitizer */ \"./src/security/sanitizer.ts\");\n/* harmony import */ var _core_hooks__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(/*! ./core/hooks */ \"./src/core/hooks.ts\");\n/* harmony import */ var _core_query__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(/*! ./core/query */ \"./src/core/query.ts\");\n/* harmony import */ var _core_vault__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(/*! ./core/vault */ \"./src/core/vault.ts\");\n/* harmony import */ var _core_quantum__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(/*! ./core/quantum */ \"./src/core/quantum.ts\");\n/* harmony import */ var _core_surge__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(/*! ./core/surge */ \"./src/core/surge.ts\");\n/* harmony import */ var _components_bloch_sphere__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(/*! ./components/bloch-sphere */ \"./src/components/bloch-sphere.ts\");\n/* harmony import */ var _components_infinity_list__WEBPACK_IMPORTED_MODULE_12__ = __webpack_require__(/*! ./components/infinity-list */ \"./src/components/infinity-list.ts\");\n\n\n\n\n\n\n\n\n\n\n\n\n\n// Global Mulan Object for non-module usage\n\n\n\n\n\n\n\n\n\n\n\nconst Mulan = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ reactive: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive,\n    effect: _core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect, Component: _core_component__WEBPACK_IMPORTED_MODULE_1__.MuComponent, defineComponent: _core_component__WEBPACK_IMPORTED_MODULE_1__.defineComponent, Router: _router_index__WEBPACK_IMPORTED_MODULE_3__.MuRouter, createRouter: _router_index__WEBPACK_IMPORTED_MODULE_3__.createRouter, Store: _store_index__WEBPACK_IMPORTED_MODULE_4__.MuStore, Security: _security_sanitizer__WEBPACK_IMPORTED_MODULE_5__.Security }, _core_hooks__WEBPACK_IMPORTED_MODULE_6__), _core_query__WEBPACK_IMPORTED_MODULE_7__), _core_quantum__WEBPACK_IMPORTED_MODULE_9__), _core_surge__WEBPACK_IMPORTED_MODULE_10__), _components_infinity_list__WEBPACK_IMPORTED_MODULE_12__), { render: _core_renderer__WEBPACK_IMPORTED_MODULE_2__.render, \n    // MULAN INSIGHT: Branded Logging\n    log: (msg, ...args) => {\n        console.log(`%c[MulanJS]%c ${msg}`, \"color: #ff3e00; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;\", \"\", ...args);\n    }, warn: (msg, ...args) => {\n        console.warn(`%c[MulanJS]%c ${msg}`, \"color: #ffcc00; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;\", \"\", ...args);\n    }, error: (msg, ...args) => {\n        console.error(`%c[MulanJS]%c ${msg}`, \"color: #ff0000; font-weight: bold; background: #222; padding: 2px 4px; border-radius: 3px;\", \"\", ...args);\n    } });\n// Security: Freeze the object to prevent runtime tampering\nObject.freeze(Mulan);\nObject.freeze(Mulan.Security);\n// MULAN INSIGHT: Initialize Global Registry\nif (typeof window !== 'undefined') {\n    window.__MULAN_INSIGHT__ = window.__MULAN_INSIGHT__ || { components: new Map() };\n    // MULAN INSIGHT: HMR Support\n    window.__MULAN_REFRESH__ = () => {\n        var _a;\n        const components = (_a = window.__MULAN_INSIGHT__) === null || _a === void 0 ? void 0 : _a.components;\n        if (components) {\n            components.forEach((comp) => {\n                if (comp && typeof comp.update === 'function') {\n                    // Force refresh\n                    comp.update();\n                }\n            });\n        }\n    };\n}\nif (typeof window !== 'undefined') {\n    window.Mulan = Mulan;\n}\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Mulan);\n\n\n//# sourceURL=webpack://Mulan/./src/index.ts?\n}");
 
 /***/ },
 

package/dist/types/core/quantum.d.ts

@@ -2,6 +2,7 @@
  * Mulan Quantum (ASTR-Q+) Core
  * Advanced Simulation Engine for multi-qubit registers and entanglement.
  */
+export declare let activeControls: number[];
 export interface Amplitude {
     re: number;
     im: number;
@@ -48,3 +49,30 @@ export declare function muTeleport(reg: any, msgIdx: number, ancillaIdx: number,
  * @returns 0 or 1
  */
 export declare function muMeasure(reg: any, target?: number): number;
+/**
+ * Quantum Loop: Parallel Execution
+ * Applies a gate to multiple qubits "simultaneously" (in simulation steps).
+ * Ideal for initialization (Hadamard Transform) or global operations.
+ * @param reg Quantum Register
+ * @param qubits Array of qubit indices
+ * @param gate Gate type to apply (e.g. 'H', 'X')
+ */
+export declare function muParallel(reg: any, qubits: number[], gate: GateType): void;
+/**
+ * Applies a block of operations controlled by specific qubits.
+ * Enables "Quantum If/Else".
+ */
+export declare function muControl(reg: any, controlQubit: number, inverse: boolean, block: () => void): void;
+/**
+ * Quantum Switch: conditional Logic on Superposition
+ * Executes different logic branches based on the state of control qubits.
+ * Because the register can be in a superposition of states (e.g. |0> + |1>),
+ * MULTIPLE branches can execute effectively simultaneously on different subspaces.
+ *
+ * @param reg Quantum Register
+ * @param controlQubit The qubit controlling the switch (Single control for v1)
+ * @param cases Object mapping state (0 or 1) to a function executing quantum operations
+ */
+export declare function muSwitch(reg: any, controlQubit: number, cases: {
+    [key: number]: () => void;
+}): void;

package/dist/types/core/query.d.ts

@@ -1,14 +1,14 @@
 export declare function useQuery<T>(queryFn: () => Promise<T>, options?: {
     enabled?: boolean;
 }): {
+    readonly data: T | null;
+    readonly isLoading: boolean;
+    readonly error: any;
     refetch: () => Promise<void>;
-    data: T | null;
-    isLoading: boolean;
-    error: any;
 };
 export declare function useMutation<T, A = void>(mutationFn: (args: A) => Promise<T>): {
+    readonly data: T | null;
+    readonly isLoading: boolean;
+    readonly error: any;
     mutate: (args: A) => Promise<T>;
-    data: T | null;
-    isLoading: boolean;
-    error: any;
 };

package/dist/types/core/surge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Mulan Surge (ASTR-S)
+ * High-performance classical iteration and parallel processing engine.
+ */
+export interface BurstOptions {
+    chunkSize?: number;
+    timeout?: number;
+    onProgress?: (progress: number) => void;
+}
+/**
+ * muBurst - Adaptive Non-blocking Iterator
+ * Processes large arrays in batches within a frame budget (typically 8-16ms)
+ * to keep the UI responsive while executing at near-native loop speeds.
+ */
+export declare function muBurst<T>(array: T[], callback: (item: T, index: number) => void, options?: BurstOptions): Promise<void>;
+/**
+ * muSurge - Truly Parallel Execution
+ * Distributes work across CPU cores using Web Workers.
+ * Logic must be serializable.
+ */
+export declare function muSurge<T, R>(array: T[], taskFn: string | ((item: T) => R), onProgress?: (p: number) => void): Promise<R[]>;

package/dist/types/index.d.ts

@@ -8,6 +8,7 @@ export * from './core/hooks';
 export * from './core/query';
 export * from './core/vault';
 export * from './core/quantum';
+export * from './core/surge';
 export * from './components/bloch-sphere';
 export * from './components/infinity-list';
 import { reactive, effect } from './core/reactive';
@@ -17,6 +18,7 @@ import { MuStore } from './store/index';
 import { Security } from './security/sanitizer';
 import { render } from './core/renderer';
 import * as Quantum from './core/quantum';
+import * as Surge from './core/surge';
 import * as InfinityList from './components/infinity-list';
 declare const Mulan: {
     render: typeof render;
@@ -24,6 +26,8 @@ declare const Mulan: {
     warn: (msg: string, ...args: any[]) => void;
     error: (msg: string, ...args: any[]) => void;
     MuInfinity: typeof InfinityList.MuInfinity;
+    muBurst<T>(array: T[], callback: (item: T, index: number) => void, options?: Surge.BurstOptions): Promise<void>;
+    muSurge<T, R>(array: T[], taskFn: string | ((item: T) => R), onProgress?: (p: number) => void): Promise<R[]>;
     muRegister(n: number): any;
     muQubit(initial?: 0 | 1): any;
     muGate(reg: any, type: Quantum.GateType, target?: number, control?: number | number[]): void;
@@ -31,19 +35,25 @@ declare const Mulan: {
     muEntangle(reg: any, i: number, j: number): void;
     muTeleport(reg: any, msgIdx: number, ancillaIdx: number, targetIdx: number): void;
     muMeasure(reg: any, target?: number): number;
+    muParallel(reg: any, qubits: number[], gate: Quantum.GateType): void;
+    muControl(reg: any, controlQubit: number, inverse: boolean, block: () => void): void;
+    muSwitch(reg: any, controlQubit: number, cases: {
+        [key: number]: () => void;
+    }): void;
+    activeControls: number[];
     useQuery<T>(queryFn: () => Promise<T>, options?: {
         enabled?: boolean;
     }): {
+        readonly data: T | null;
+        readonly isLoading: boolean;
+        readonly error: any;
         refetch: () => Promise<void>;
-        data: T | null;
-        isLoading: boolean;
-        error: any;
     };
     useMutation<T, A = void>(mutationFn: (args: A) => Promise<T>): {
+        readonly data: T | null;
+        readonly isLoading: boolean;
+        readonly error: any;
         mutate: (args: A) => Promise<T>;
-        data: T | null;
-        isLoading: boolean;
-        error: any;
     };
     setCurrentInstance(instance: any): void;
     getCurrentInstance(): any;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mulanjs/mulanjs",
-    "version": "1.0.1-dev.20260219183505",
+    "version": "1.0.1-dev.20260220104511",
     "description": "A powerful, secure, and enterprise-grade JavaScript framework.",
     "main": "dist/mulan.js",
     "module": "dist/mulan.esm.js",