@mulanjs/mulanjs 1.0.1-dev.20260219221500 → 1.0.1-dev.20260220121828

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,13 +100,23 @@ 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        const taskFn = ${fnStr};\r\n        self.onmessage = function(e) {\r\n            const { chunk, startIndex } = e.data;\r\n            try {\r\n                const results = chunk.map(taskFn);\r\n                self.postMessage({ results, startIndex });\r\n            } catch (err) {\r\n                self.postMessage({ error: err.message, startIndex });\r\n            }\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 ***!
   \***************************/
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
-eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   persistent: () => (/* binding */ persistent)\n/* harmony export */ });\n/* harmony import */ var _hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./hooks */ \"./src/core/hooks.ts\");\n/* harmony import */ var _reactive__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./reactive */ \"./src/core/reactive.ts\");\n\n\nconst MULAN_SECRET = 'b3ast_mulan_s3cur1ty_k3y';\nfunction beastXOR(str) {\n    let result = '';\n    for (let i = 0; i < str.length; i++) {\n        result += String.fromCharCode(str.charCodeAt(i) ^ MULAN_SECRET.charCodeAt(i % MULAN_SECRET.length));\n    }\n    return btoa(result);\n}\nfunction beastDecode(encoded) {\n    const str = atob(encoded);\n    let result = '';\n    for (let i = 0; i < str.length; i++) {\n        result += String.fromCharCode(str.charCodeAt(i) ^ MULAN_SECRET.charCodeAt(i % MULAN_SECRET.length));\n    }\n    return result;\n}\n/**\n * Mulan Vault: The World's First Native Persistent State Primitive.\n * Now fortified with Iron Fortress Obfuscation.\n */\nfunction persistent(key, initialValue, options = {}) {\n    const storage = options.storage || window.localStorage;\n    // 1. Load from Storage\n    const stored = storage.getItem(key);\n    let startVal = initialValue;\n    if (stored) {\n        try {\n            const raw = options.encrypt ? beastDecode(stored) : stored;\n            startVal = JSON.parse(raw);\n        }\n        catch (e) {\n            console.warn(`[Iron Fortress] Corrupt persistent data for key \"${key}\", resetting.`);\n        }\n    }\n    // 2. Create Reactive State (Follow muState pattern for consistency)\n    const isObject = typeof startVal === 'object' && startVal !== null;\n    const state = isObject ? (0,_reactive__WEBPACK_IMPORTED_MODULE_1__.reactive)(startVal) : (0,_reactive__WEBPACK_IMPORTED_MODULE_1__.reactive)({ value: startVal });\n    // 3. Auto-Save on Change\n    (0,_hooks__WEBPACK_IMPORTED_MODULE_0__.muEffect)(() => {\n        try {\n            const payload = isObject ? state : state.value;\n            const raw = JSON.stringify(payload);\n            const toSave = options.encrypt ? beastXOR(raw) : raw;\n            storage.setItem(key, toSave);\n        }\n        catch (e) {\n            console.error(`[Iron Fortress] Failed to save key \"${key}\"`);\n        }\n    });\n    // 4. Sync across Tabs\n    const sync = (e) => {\n        if (e.key === key && e.newValue) {\n            try {\n                const raw = options.encrypt ? beastDecode(e.newValue) : e.newValue;\n                const newVal = JSON.parse(raw);\n                if (isObject) {\n                    Object.assign(state, newVal);\n                }\n                else {\n                    state.value = newVal;\n                }\n            }\n            catch (e) { }\n        }\n    };\n    window.addEventListener('storage', sync);\n    // Auto-cleanup if used inside a component\n    try {\n        const { onMuDestroy } = __webpack_require__(/*! ./hooks */ \"./src/core/hooks.ts\");\n        onMuDestroy(() => {\n            window.removeEventListener('storage', sync);\n        });\n    }\n    catch (e) {\n        // muVault might be used outside component setup in some advanced cases, \n        // fallback to manual or no-cleanup if so.\n    }\n    return state;\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/vault.ts?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   persistent: () => (/* binding */ persistent)\n/* harmony export */ });\n/* harmony import */ var _hooks__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./hooks */ \"./src/core/hooks.ts\");\n/* harmony import */ var _reactive__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./reactive */ \"./src/core/reactive.ts\");\n\n\n/**\n * Mulan Vault: The World's First Native Persistent State Primitive.\n */\nfunction persistent(key, initialValue, options = {}) {\n    const storage = options.storage || window.localStorage;\n    // 1. Load from Storage\n    const stored = storage.getItem(key);\n    let startVal = initialValue;\n    if (stored) {\n        try {\n            startVal = JSON.parse(stored);\n        }\n        catch (e) {\n            console.warn(`[Mulan Vault] Corrupt persistent data for key \"${key}\", resetting.`);\n        }\n    }\n    // 2. Create Reactive State (Follow muState pattern for consistency)\n    const isObject = typeof startVal === 'object' && startVal !== null;\n    const state = isObject ? (0,_reactive__WEBPACK_IMPORTED_MODULE_1__.reactive)(startVal) : (0,_reactive__WEBPACK_IMPORTED_MODULE_1__.reactive)({ value: startVal });\n    // 3. Auto-Save on Change\n    (0,_hooks__WEBPACK_IMPORTED_MODULE_0__.muEffect)(() => {\n        try {\n            const payload = isObject ? state : state.value;\n            const toSave = JSON.stringify(payload);\n            // Non-obfuscated persistence to satisfy security audits\n            storage.setItem(key, toSave);\n        }\n        catch (e) {\n            console.error(`[Mulan Vault] Failed to save key \"${key}\"`);\n        }\n    });\n    // 4. Sync across Tabs\n    const sync = (e) => {\n        if (e.key === key && e.newValue) {\n            try {\n                const newVal = JSON.parse(e.newValue);\n                if (isObject) {\n                    Object.assign(state, newVal);\n                }\n                else {\n                    state.value = newVal;\n                }\n            }\n            catch (e) { }\n        }\n    };\n    window.addEventListener('storage', sync);\n    // Auto-cleanup if used inside a component\n    try {\n        const { onMuDestroy } = __webpack_require__(/*! ./hooks */ \"./src/core/hooks.ts\");\n        onMuDestroy(() => {\n            window.removeEventListener('storage', sync);\n        });\n    }\n    catch (e) {\n        // muVault might be used outside component setup in some advanced cases, \n        // fallback to manual or no-cleanup if so.\n    }\n    return state;\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/vault.ts?\n}");
 
 /***/ },
 
@@ -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/compiler/compiler.d.ts

@@ -1,7 +1,8 @@
+import { CompilerOptions } from './script-compiler';
 export interface CompileResult {
     code: string;
     css: string;
     errors: string[];
     map?: string;
 }
-export declare function compileSFC(source: string, filename: string): Promise<CompileResult>;
+export declare function compileSFC(source: string, filename: string, options?: CompilerOptions): Promise<CompileResult>;

package/dist/types/compiler/script-compiler.d.ts

@@ -5,4 +5,7 @@ export interface ScriptCompileResult {
     errors: string[];
     map?: string;
 }
-export declare function compileScript(descriptor: SFCDescriptor): Promise<ScriptCompileResult>;
+export interface CompilerOptions {
+    readFileSync?: (file: string) => string;
+}
+export declare function compileScript(descriptor: SFCDescriptor, options?: CompilerOptions): Promise<ScriptCompileResult>;

package/dist/types/compiler/style-compiler.d.ts

@@ -1,7 +1,8 @@
 import { SFCDescriptor } from './sfc-parser';
+import { CompilerOptions } from './script-compiler';
 export interface StyleCompileResult {
     css: string;
     scopedId?: string;
     errors: string[];
 }
-export declare function compileStyle(descriptor: SFCDescriptor, filename: string): StyleCompileResult;
+export declare function compileStyle(descriptor: SFCDescriptor, filename: string, options?: CompilerOptions): StyleCompileResult;

package/dist/types/compiler/template-compiler.d.ts

@@ -3,5 +3,6 @@ import { ScriptCompileResult } from './script-compiler';
 export interface TemplateCompileResult {
     code: string;
     errors: string[];
+    map?: string;
 }
 export declare function compileTemplate(descriptor: SFCDescriptor, scriptResult: ScriptCompileResult, scopedId?: string): TemplateCompileResult;

package/dist/types/compiler.d.ts

@@ -1,7 +1,8 @@
+import { CompilerOptions } from './script-compiler';
 export interface CompileResult {
     code: string;
     css: string;
     errors: string[];
     map?: string;
 }
-export declare function compileSFC(source: string, filename: string): Promise<CompileResult>;
+export declare function compileSFC(source: string, filename: string, options?: CompilerOptions): Promise<CompileResult>;

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/core/vault.d.ts

@@ -7,6 +7,5 @@ export interface VaultOptions {
 }
 /**
  * Mulan Vault: The World's First Native Persistent State Primitive.
- * Now fortified with Iron Fortress Obfuscation.
  */
 export declare function persistent<T>(key: string, initialValue: T, options?: VaultOptions): any;

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/dist/types/script-compiler.d.ts

@@ -5,4 +5,7 @@ export interface ScriptCompileResult {
     errors: string[];
     map?: string;
 }
-export declare function compileScript(descriptor: SFCDescriptor): Promise<ScriptCompileResult>;
+export interface CompilerOptions {
+    readFileSync?: (file: string) => string;
+}
+export declare function compileScript(descriptor: SFCDescriptor, options?: CompilerOptions): Promise<ScriptCompileResult>;

package/dist/types/style-compiler.d.ts

@@ -1,7 +1,8 @@
 import { SFCDescriptor } from './sfc-parser';
+import { CompilerOptions } from './script-compiler';
 export interface StyleCompileResult {
     css: string;
     scopedId?: string;
     errors: string[];
 }
-export declare function compileStyle(descriptor: SFCDescriptor, filename: string): StyleCompileResult;
+export declare function compileStyle(descriptor: SFCDescriptor, filename: string, options?: CompilerOptions): StyleCompileResult;

package/dist/types/template-compiler.d.ts

@@ -3,5 +3,6 @@ import { ScriptCompileResult } from './script-compiler';
 export interface TemplateCompileResult {
     code: string;
     errors: string[];
+    map?: string;
 }
 export declare function compileTemplate(descriptor: SFCDescriptor, scriptResult: ScriptCompileResult, scopedId?: string): TemplateCompileResult;

package/package.json

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

package/src/compiler/compiler.ts

@@ -1,6 +1,6 @@
 
 import { parseMUJS } from './sfc-parser';
-import { compileScript } from './script-compiler';
+import { compileScript, CompilerOptions } from './script-compiler';
 import { compileTemplate } from './template-compiler';
 import { compileStyle } from './style-compiler';
 
@@ -11,12 +11,14 @@ export interface CompileResult {
     map?: string; // Source Map
 }
 
-export async function compileSFC(source: string, filename: string): Promise<CompileResult> {
+import { SourceMapGenerator, SourceMapConsumer } from 'source-map';
+
+export async function compileSFC(source: string, filename: string, options?: CompilerOptions): Promise<CompileResult> {
     // 1. Parse
     const descriptor = parseMUJS(source, filename);
 
     // 2. Script
-    const scriptResult = await compileScript(descriptor);
+    const scriptResult = await compileScript(descriptor, options);
     // Replace export default to capture the component
     // If the script already has 'export default', we intercept it.
     let scriptCode = scriptResult.code.replace('export default', 'const __component__ =');
@@ -25,11 +27,94 @@ export async function compileSFC(source: string, filename: string): Promise<Comp
     }
 
     // 3. Style
-    const styleResult = compileStyle(descriptor, filename);
+    const styleResult = compileStyle(descriptor, filename, options);
 
     // 4. Template
     const templateResult = compileTemplate(descriptor, scriptResult, styleResult.scopedId);
 
+    // Calculate offsets for source map merging
+    // 1. Script Code
+    // 2. Padding (newlines)
+    // 3. Template Code
+
+    // We need to count lines in scriptCode to know where template code starts in the final file
+    const scriptLineCount = scriptCode.split(/\r?\n/).length;
+    const paddingLines = 2; // Two newlines between script and template
+    const templateOffset = scriptLineCount + paddingLines;
+
+    let mergedMap: string | undefined;
+
+    // Merge Maps
+    if (filename) {
+        const generator = new SourceMapGenerator({
+            file: filename + '.js',
+        });
+
+        // 1. Apply Script Map
+        if (scriptResult.map) {
+            const scriptConsumer = await new SourceMapConsumer(JSON.parse(scriptResult.map));
+            scriptConsumer.eachMapping(mapping => {
+                if (mapping.source) {
+                    generator.addMapping({
+                        generated: {
+                            line: mapping.generatedLine, // Script is at the top, so no offset needed
+                            column: mapping.generatedColumn
+                        },
+                        original: {
+                            line: mapping.originalLine,
+                            column: mapping.originalColumn
+                        },
+                        source: mapping.source,
+                        name: mapping.name
+                    });
+                }
+            });
+            // Copy source content from script map
+            if (scriptConsumer.sources) {
+                scriptConsumer.sources.forEach(sourceFile => {
+                    const content = scriptConsumer.sourceContentFor(sourceFile);
+                    if (content) {
+                        generator.setSourceContent(sourceFile, content);
+                    }
+                });
+            }
+            scriptConsumer.destroy();
+        }
+
+        // 2. Apply Template Map
+        if (templateResult.map) {
+            const templateConsumer = await new SourceMapConsumer(JSON.parse(templateResult.map));
+            templateConsumer.eachMapping(mapping => {
+                if (mapping.source) {
+                    generator.addMapping({
+                        generated: {
+                            line: mapping.generatedLine + templateOffset, // Shift by script length
+                            column: mapping.generatedColumn
+                        },
+                        original: {
+                            line: mapping.originalLine, // Original line in .mujs
+                            column: mapping.originalColumn
+                        },
+                        source: mapping.source, // This should be the .mujs file
+                        name: mapping.name
+                    });
+                }
+            });
+            // Copy source content from template map
+            if (templateConsumer.sources) {
+                templateConsumer.sources.forEach(sourceFile => {
+                    const content = templateConsumer.sourceContentFor(sourceFile);
+                    if (content) {
+                        generator.setSourceContent(sourceFile, content);
+                    }
+                });
+            }
+            templateConsumer.destroy();
+        }
+
+        mergedMap = generator.toString();
+    }
+
     // 5. Assembly
     const cssInjection = styleResult.css ? `
 if (typeof document !== 'undefined') {
@@ -98,6 +183,6 @@ export default __component__;
         code: finalCode,
         css: styleResult.css,
         errors: [...scriptResult.errors, ...templateResult.errors],
-        map: scriptResult.map // Pass the map
+        map: mergedMap || scriptResult.map // Fallback to script map if merge fails
     };
 }