@mulanjs/mulanjs 1.0.1-dev.20260212143840

package/dist/mulan.js

@@ -0,0 +1,215 @@
+/*
+ * ATTENTION: The "eval" devtool has been used (maybe by default in mode: "development").
+ * This devtool is neither made for production nor for readable output files.
+ * It uses "eval()" calls to create a separate source file in the browser devtools.
+ * If you are trying to read the output file, select a different devtool (https://webpack.js.org/configuration/devtool/)
+ * or disable the default devtool with "devtool: false".
+ * If you are looking for production-ready output files, see mode: "production" (https://webpack.js.org/configuration/mode/).
+ */
+(function webpackUniversalModuleDefinition(root, factory) {
+	if(typeof exports === 'object' && typeof module === 'object')
+		module.exports = factory();
+	else if(typeof define === 'function' && define.amd)
+		define([], factory);
+	else if(typeof exports === 'object')
+		exports["Mulan"] = factory();
+	else
+		root["Mulan"] = factory();
+})(this, () => {
+return /******/ (() => { // webpackBootstrap
+/******/ 	"use strict";
+/******/ 	var __webpack_modules__ = ({
+
+/***/ "./src/components/bloch-sphere.ts"
+/*!****************************************!*\
+  !*** ./src/components/bloch-sphere.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 */   MuBlochSphereElement: () => (/* binding */ MuBlochSphereElement)\n/* harmony export */ });\n/* harmony import */ var _core_reactive__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../core/reactive */ \"./src/core/reactive.ts\");\n\nclass MuBlochSphereElement extends HTMLElement {\n    static get observedAttributes() {\n        return ['size'];\n    }\n    constructor() {\n        super();\n        this._arrow = null;\n        this._container = null;\n        this._disposeEffect = null;\n        this.attachShadow({ mode: 'open' });\n    }\n    connectedCallback() {\n        this.render();\n    }\n    disconnectedCallback() {\n        if (this._disposeEffect) {\n            this._disposeEffect();\n            this._disposeEffect = null;\n        }\n    }\n    // Property setter for 'qubit' (passed as .qubit=\"${q}\" in Mulan)\n    set qubit(val) {\n        this._qubit = val;\n        this.initReactivity();\n    }\n    get qubit() {\n        return this._qubit;\n    }\n    attributeChangedCallback(name, oldValue, newValue) {\n        if (name === 'size' && this._container) {\n            this._container.style.width = newValue + 'px';\n            this._container.style.height = newValue + 'px';\n        }\n    }\n    initReactivity() {\n        if (this._disposeEffect)\n            this._disposeEffect();\n        if (!this._qubit)\n            return;\n        // MulanJS Effect: Run whenever the qubit state changes\n        this._disposeEffect = (0,_core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect)(() => {\n            const state = this._qubit.value; // Access reactive proxy\n            if (!state || !state.amplitudes)\n                return;\n            // Assume Single Qubit for Visualizer (Index 0 if passed a register)\n            // If passed a register, we visualize the first qubit's logical projection (partial trace simplified)\n            // Or assume input IS a specific qubit projection?\n            // For simplified demo, we assume the register is size 1 OR we visualize Q0 of the register.\n            const amps = state.amplitudes;\n            // Support 1-qubit visualization from N-qubit register requires partial trace.\n            // For now, let's assume the user passes a 1-qubit register OR we visualize index 0.\n            // |psi> = a|0> + b|1>\n            // a = amps[0] (re, im)\n            // b = amps[1] (re, im)\n            // Dealing with multi-qubit registers (naive projection for visualization):\n            // We sum up probabilities for 0xxxx vs 1xxxx to get Z-axis.\n            // This is \"marginal probability\".\n            let p0 = 0;\n            let p1 = 0;\n            // Calculate Probabilities\n            for (let i = 0; i < amps.length; i++) {\n                const mag = amps[i].re * amps[i].re + amps[i].im * amps[i].im;\n                if ((i & 1) === 0)\n                    p0 += mag;\n                else\n                    p1 += mag;\n            }\n            // Theta from Z-projection\n            // P0 = cos^2(theta/2) -> theta = 2 * acos(sqrt(P0))\n            const theta = 2 * Math.acos(Math.min(1, Math.sqrt(p0)));\n            // Phi?\n            // Phase is relative phase between |0> and |1>.\n            // We can look at the phase of the '1' component relative to '0'.\n            // Simple approach: Look at amps[1] phase vs amps[0] phase.\n            // But with entanglement, pure state phase is tricky.\n            // Let's implement full density matrix if needed, but for now:\n            // naive: atan2(amps[1].im, amps[1].re) - atan2(amps[0].im, amps[0].re)\n            // We use the first pair (0 and 1) as proxy if multiple.\n            const a0 = amps[0];\n            const a1 = amps[1]; // Valid for N>=1\n            const phase0 = Math.atan2(a0.im, a0.re);\n            const phase1 = Math.atan2(a1.im, a1.re);\n            let phi = phase1 - phase0;\n            // Update Arrow\n            this.updateArrow(theta, phi);\n        });\n    }\n    updateArrow(theta, phi) {\n        if (!this._arrow)\n            return;\n        // Convert Quantum Coords (Theta, Phi) to CSS Transforms\n        // Theta 0 = Top (|0>)\n        // Theta PI = Bottom (|1>)\n        // Theta PI/2 = Equator\n        // CSS Rotate sequence:\n        // 1. Start pointing UP (Y or Z axis in CSS?)\n        // Let's say Arrow starts pointing UP (Y-).\n        // Rotate Z by Phi (Azimuth)\n        // Rotate X by Theta (Polar) - No, that's not standard Euler.\n        // Standard Physics:\n        // Z is Up (in Bloch), but CSS 3D Y is usually 'Down' or 'Up'.\n        // Let's Map:\n        // Bloch Z+ (|0>) -> CSS Y- (Top)\n        // Bloch Z- (|1>) -> CSS Y+ (Bottom)\n        // Bloch X+ (|+>) -> CSS Z+ (Front)\n        // Transform:\n        // rotateY(phi) ? No, phi rotates around Z-axis (Vertical).\n        // theta rotates from Z-axis down.\n        // CSS:\n        // rotateY(phi) -> Rotates around Vertical axis.\n        // rotateZ(theta) -> Rotates \"down\" from up?\n        // Let's simplify:\n        // transform: rotateY(${phi}rad) rotateZ(${theta}rad)\n        // Note: CSS rotations order matters.\n        const degTheta = theta * (180 / Math.PI);\n        const degPhi = phi * (180 / Math.PI);\n        // Adjustment for visual alignment\n        this._arrow.style.transform = `rotateY(${degPhi}deg) rotateZ(${degTheta}deg)`;\n        // Color based on state\n        const isSuperposition = Math.abs(theta - Math.PI / 2) < 0.1;\n        this._arrow.style.backgroundColor = isSuperposition ? '#00ffff' : '#ff00ff';\n    }\n    render() {\n        if (!this.shadowRoot)\n            return;\n        const size = this.getAttribute('size') || '200';\n        this.shadowRoot.innerHTML = `\r\n            <style>\r\n                :host {\r\n                    display: inline-block;\r\n                    perspective: 1000px;\r\n                }\r\n                .sphere-container {\r\n                    width: ${size}px;\r\n                    height: ${size}px;\r\n                    position: relative;\r\n                    transform-style: preserve-3d;\r\n                    margin: 0 auto;\r\n                }\r\n                .sphere {\r\n                    width: 100%;\r\n                    height: 100%;\r\n                    border-radius: 50%;\r\n                    border: 1px solid rgba(255, 255, 255, 0.2);\r\n                    position: absolute;\r\n                    background: radial-gradient(circle at 30% 30%, rgba(255, 255, 255, 0.1), rgba(0, 0, 0, 0.8));\r\n                    box-shadow: inset 0 0 20px rgba(255, 255, 255, 0.05);\r\n                    transform: rotateX(15deg) rotateY(15deg); /* Initial tilt for view */\r\n                }\r\n                /* Equator Ring */\r\n                .equator {\r\n                    position: absolute;\r\n                    top: 50%;\r\n                    left: 0;\r\n                    width: 100%;\r\n                    height: 100%;\r\n                    border: 1px dashed rgba(255, 255, 255, 0.3);\r\n                    border-radius: 50%;\r\n                    transform: rotateX(90deg);\r\n                    pointer-events: none;\r\n                }\r\n                /* Axis Lines */\r\n                .axis {\r\n                    position: absolute;\r\n                    background: rgba(255, 255, 255, 0.1);\r\n                }\r\n                .z-axis { width: 2px; height: 100%; left: 50%; top: 0; }\r\n                \r\n                /* The Quantum Arrow */\r\n                .arrow-container {\r\n                    position: absolute;\r\n                    top: 50%;\r\n                    left: 50%;\r\n                    width: 0;\r\n                    height: 0;\r\n                    transform-style: preserve-3d;\r\n                    transform: rotateX(15deg) rotateY(15deg); /* Match sphere tilt */\r\n                }\r\n                \r\n                .arrow-pivot {\r\n                    position: absolute;\r\n                    top: 0;\r\n                    left: 0;\r\n                    width: 4px;\r\n                    height: 50%; /* Length of radius */\r\n                    /* Pivot logic: we want to rotate around the center point */\r\n                    /* CSS Default transform-origin is 50% 50% */\r\n                    /* We construct the arrow such that it points UP from center */\r\n                }\r\n                \r\n                .arrow-rod {\r\n                    width: 4px;\r\n                    height: ${parseInt(size) / 2 - 10}px;\r\n                    background: #ff00ff;\r\n                    position: absolute;\r\n                    bottom: 0;\r\n                    left: -2px;\r\n                    transform-origin: bottom center;\r\n                    transition: transform 0.5s cubic-bezier(0.175, 0.885, 0.32, 1.275), background-color 0.3s;\r\n                    border-radius: 2px;\r\n                    box-shadow: 0 0 10px currentColor;\r\n                }\r\n                \r\n                .arrow-head {\r\n                    width: 0; \r\n                    height: 0; \r\n                    border-left: 6px solid transparent;\r\n                    border-right: 6px solid transparent;\r\n                    border-bottom: 12px solid #ff00ff;\r\n                    position: absolute;\r\n                    top: -10px;\r\n                    left: -6px;\r\n                }\r\n                \r\n                .label {\r\n                    position: absolute;\r\n                    color: #aaa;\r\n                    font-family: monospace;\r\n                    font-size: 10px;\r\n                }\r\n                .label-0 { top: 5px; left: 50%; transform: translateX(-50%); }\r\n                .label-1 { bottom: 5px; left: 50%; transform: translateX(-50%); }\r\n            </style>\r\n            \r\n            <div class=\"sphere-container\">\r\n                <div class=\"sphere\">\r\n                    <div class=\"equator\"></div>\r\n                    <div class=\"axis z-axis\"></div>\r\n                    <div class=\"label label-0\">|0></div>\r\n                    <div class=\"label label-1\">|1></div>\r\n                </div>\r\n                \r\n                <div class=\"arrow-container\">\r\n                    <!-- The rod is the actual rotating element -->\r\n                    <div class=\"arrow-rod\">\r\n                        <div class=\"arrow-head\"></div>\r\n                    </div>\r\n                </div>\r\n            </div>\r\n        `;\n        this._container = this.shadowRoot.querySelector('.sphere-container');\n        this._arrow = this.shadowRoot.querySelector('.arrow-rod');\n        // Re-init reactivity if qubit was set before render\n        if (this._qubit)\n            this.initReactivity();\n    }\n}\n// Register the custom element\nif (typeof customElements !== 'undefined') {\n    customElements.define('mu-bloch-sphere', MuBlochSphereElement);\n}\n\n\n//# sourceURL=webpack://Mulan/./src/components/bloch-sphere.ts?\n}");
+
+/***/ },
+
+/***/ "./src/core/component.ts"
+/*!*******************************!*\
+  !*** ./src/core/component.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 */   MuComponent: () => (/* binding */ MuComponent),\n/* harmony export */   defineComponent: () => (/* binding */ defineComponent)\n/* harmony export */ });\n/* harmony import */ var _renderer__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./renderer */ \"./src/core/renderer.ts\");\n/* harmony import */ var _hooks__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./hooks */ \"./src/core/hooks.ts\");\n/* harmony import */ var _reactive__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./reactive */ \"./src/core/reactive.ts\");\n\n\n\n// Or a simple component that returns an object of state/methods used by template? \n// For Mulan 2.0, let's say functional component returns a template string render function explicitly.\nclass MuComponent {\n    constructor(container) {\n        this._hooks = {};\n        this._effects = [];\n        this._isDestroyed = false;\n        this._propsQueue = [];\n        this._eventQueue = [];\n        this.container = container;\n        this.state = {};\n        this.$uid = 'mu_' + Math.random().toString(36).substr(2, 9);\n        // MULAN INSIGHT: Global Registry for Debugging\n        if (typeof window !== 'undefined') {\n            const global = window;\n            global.__MULAN_INSIGHT__ = global.__MULAN_INSIGHT__ || { components: new Map() };\n            global.__MULAN_INSIGHT__.components.set(this.$uid, this);\n        }\n        // Setup context for hooks\n        (0,_hooks__WEBPACK_IMPORTED_MODULE_1__.setCurrentInstance)(this);\n        this.setup();\n        (0,_hooks__WEBPACK_IMPORTED_MODULE_1__.setCurrentInstance)(null);\n    }\n    // Optional setup method for class components wanting to use hooks\n    setup() { }\n    onMount() {\n        var _a, _c;\n        // Mulan Cycle: Init\n        (_a = this._hooks.onMuInit) === null || _a === void 0 ? void 0 : _a.forEach(fn => fn());\n        // Mulan Cycle: Mount (Simulated immediately after init for now in this version)\n        (_c = this._hooks.onMuMount) === null || _c === void 0 ? void 0 : _c.forEach(fn => fn());\n    }\n    onUpdate() { }\n    onDestroy() {\n        var _a, _c;\n        if (this._isDestroyed)\n            return;\n        this._isDestroyed = true;\n        console.log(`[Mulan Cycle] Destroying component ${this.$uid} (${this.constructor.name})`);\n        // MULAN INSIGHT: Cleanup\n        if (typeof window !== 'undefined') {\n            const global = window;\n            (_a = global.__MULAN_INSIGHT__) === null || _a === void 0 ? void 0 : _a.components.delete(this.$uid);\n        }\n        // Mulan Cycle: Stop all effects to prevent leaks\n        console.log(`[Mulan Cycle] Stopping ${this._effects.length} effects for ${this.$uid}`);\n        this._effects.forEach(stop => stop());\n        this._effects = [];\n        // Mulan Cycle: Destroy hooks\n        (_c = this._hooks.onMuDestroy) === null || _c === void 0 ? void 0 : _c.forEach(fn => fn());\n    }\n    // Helper for compiler to register property bindings\n    _b(id, prop, value) {\n        this._propsQueue.push([id, prop, value]);\n        return \"\";\n    }\n    // Helper for compiler to register event bindings\n    _e(id, type, handler) {\n        this._eventQueue.push([id, type, handler]);\n        return \"\";\n    }\n    mount() {\n        console.log(`[Mulan Cycle] Mounting component ${this.$uid}`);\n        const stop = (0,_reactive__WEBPACK_IMPORTED_MODULE_2__.effect)(() => {\n            console.log(`[Mulan Reactivity] Triggering update for ${this.$uid}`);\n            this.update();\n        });\n        this._effects.push(stop);\n        this.onMount();\n    }\n    update() {\n        if (this._isDestroyed) {\n            console.warn(`[Mulan Warning] Update called on destroyed component ${this.$uid}. Blocking render.`);\n            return;\n        }\n        // Clear queues before render\n        this._propsQueue = [];\n        this._eventQueue = [];\n        const template = this.template();\n        // Render HTML\n        (0,_renderer__WEBPACK_IMPORTED_MODULE_0__.render)(template, this.container);\n        // Flush Side Effects\n        this.flushProps();\n        this.flushEvents();\n        this.onUpdate();\n    }\n    flushProps() {\n        for (const [id, prop, value] of this._propsQueue) {\n            const el = this.container.querySelector(`[data-mu-id=\"${id}\"]`);\n            if (el) {\n                // @ts-ignore\n                el[prop] = value;\n            }\n        }\n        this._propsQueue = [];\n    }\n    flushEvents() {\n        for (const [id, type, handler] of this._eventQueue) {\n            const el = this.container.querySelector(`[data-mu-id=\"${id}\"]`);\n            if (el) {\n                // Bind handler to this component instance to ensure 'this' works in methods\n                el.addEventListener(type, handler.bind(this));\n            }\n        }\n        this._eventQueue = [];\n    }\n}\n// Helper to create functional components wrapped in the class system\n// Helper to create functional components wrapped in the class system\n// Supports both () => render and { setup() } signatures\nfunction defineComponent(optionsOrSetup) {\n    return class UniversalComponent extends MuComponent {\n        constructor(container) {\n            super(container);\n            // setup() is called by super constructor\n        }\n        setup() {\n            let setupResult;\n            if (typeof optionsOrSetup === 'function') {\n                // It's a setup function returning render fn\n                setupResult = optionsOrSetup.call(this);\n            }\n            else if (typeof optionsOrSetup === 'object' && optionsOrSetup.setup) {\n                // It's an options object with setup()\n                setupResult = optionsOrSetup.setup.call(this);\n            }\n            // Handle result\n            if (typeof setupResult === 'function') {\n                // It's a render function\n                this.template = setupResult;\n            }\n            else if (setupResult && typeof setupResult === 'object') {\n                // It's bindings\n                Object.assign(this, setupResult);\n                // We assume template is assigned to prototype by compiler\n            }\n        }\n        template() {\n            return '';\n        }\n    };\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/component.ts?\n}");
+
+/***/ },
+
+/***/ "./src/core/hooks.ts"
+/*!***************************!*\
+  !*** ./src/core/hooks.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 */   getCurrentInstance: () => (/* binding */ getCurrentInstance),\n/* harmony export */   muEffect: () => (/* binding */ muEffect),\n/* harmony export */   muGeom: () => (/* binding */ muGeom),\n/* harmony export */   muMemo: () => (/* binding */ muMemo),\n/* harmony export */   muPulse: () => (/* binding */ muPulse),\n/* harmony export */   muState: () => (/* binding */ muState),\n/* harmony export */   muVault: () => (/* binding */ muVault),\n/* harmony export */   onMuDestroy: () => (/* binding */ onMuDestroy),\n/* harmony export */   onMuIdle: () => (/* binding */ onMuIdle),\n/* harmony export */   onMuInit: () => (/* binding */ onMuInit),\n/* harmony export */   onMuMount: () => (/* binding */ onMuMount),\n/* harmony export */   onMuResume: () => (/* binding */ onMuResume),\n/* harmony export */   onMuShake: () => (/* binding */ onMuShake),\n/* harmony export */   onMuVoice: () => (/* binding */ onMuVoice),\n/* harmony export */   setCurrentInstance: () => (/* binding */ setCurrentInstance)\n/* harmony export */ });\n/* harmony import */ var _reactive__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./reactive */ \"./src/core/reactive.ts\");\n/* harmony import */ var _vault__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./vault */ \"./src/core/vault.ts\");\n\n\n// Global context to track the current component instance\nlet currentInstance = null;\nfunction setCurrentInstance(instance) {\n    currentInstance = instance;\n}\nfunction getCurrentInstance() {\n    return currentInstance;\n}\n// --- Mulan Unique Reactivity Hooks ---\nfunction muState(initialValue) {\n    if (typeof initialValue === 'object' && initialValue !== null) {\n        return (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)(initialValue);\n    }\n    // Core reactive state container for primitives\n    return (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)({ value: initialValue });\n}\nfunction muMemo(computeFn) {\n    const signal = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)({ value: undefined });\n    const stop = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.effect)(() => {\n        signal.value = computeFn();\n    });\n    const instance = getCurrentInstance();\n    if (instance) {\n        if (!instance._effects)\n            instance._effects = [];\n        instance._effects.push(stop);\n    }\n    return signal;\n}\nfunction muEffect(fn) {\n    const stop = (0,_reactive__WEBPACK_IMPORTED_MODULE_0__.effect)(fn);\n    const instance = getCurrentInstance();\n    if (instance) {\n        if (!instance._effects)\n            instance._effects = [];\n        instance._effects.push(stop);\n    }\n}\n// --- The \"Mulan Cycle\" (Lifecycle) ---\nfunction onMuInit(fn) {\n    const instance = getCurrentInstance();\n    if (instance) {\n        if (!instance._hooks)\n            instance._hooks = {};\n        if (!instance._hooks.onMuInit)\n            instance._hooks.onMuInit = [];\n        instance._hooks.onMuInit.push(fn);\n    }\n    else {\n        console.warn('onMuInit called outside of component setup context.');\n    }\n}\nfunction onMuMount(fn) {\n    // New hook for when component is actually in DOM (simulated for now via update)\n    const instance = getCurrentInstance();\n    if (instance) {\n        if (!instance._hooks)\n            instance._hooks = {};\n        if (!instance._hooks.onMuMount)\n            instance._hooks.onMuMount = [];\n        instance._hooks.onMuMount.push(fn);\n    }\n}\nfunction onMuDestroy(fn) {\n    const instance = getCurrentInstance();\n    if (instance) {\n        if (!instance._hooks)\n            instance._hooks = {};\n        if (!instance._hooks.onMuDestroy)\n            instance._hooks.onMuDestroy = [];\n        instance._hooks.onMuDestroy.push(fn);\n    }\n}\n/**\n * onMuIdle - The \"Environment Life\" Hook.\n * Executes heavy logic ONLY when the browser is taking a nap (idle).\n */\nfunction onMuIdle(fn) {\n    const instance = getCurrentInstance();\n    // Polyfill for Safari/Old Browsers\n    const requestIdleCallback = window.requestIdleCallback || function (cb) {\n        return setTimeout(() => {\n            cb({\n                didTimeout: false,\n                timeRemaining: function () { return 50; }\n            });\n        }, 1);\n    };\n    const cancelIdleCallback = window.cancelIdleCallback || function (id) {\n        clearTimeout(id);\n    };\n    const idleId = requestIdleCallback(() => {\n        fn();\n    });\n    // Auto-cleanup if component dies before idle time\n    if (instance) {\n        onMuDestroy(() => {\n            cancelIdleCallback(idleId);\n        });\n    }\n}\n/**\n * onMuResume - The \"Tab Life\" Hook.\n * Executes when the user switches BACK to this tab.\n * Perfect for refreshing data or resuming animations to save battery.\n */\nfunction onMuResume(fn) {\n    const handler = () => {\n        if (document.visibilityState === 'visible') {\n            fn();\n        }\n    };\n    document.addEventListener('visibilitychange', handler);\n    onMuDestroy(() => document.removeEventListener('visibilitychange', handler));\n}\n/**\n * onMuShake - The \"Physical Life\" Hook.\n * Executes when the device is shaken.\n * Usage: Undo, Refresh, or \"Rage Quit\" easter eggs.\n */\nfunction onMuShake(fn) {\n    // Threshold for shake detection\n    const threshold = 15;\n    let lastX = 0, lastY = 0, lastZ = 0;\n    let lastTime = 0;\n    const handler = (e) => {\n        const current = e.accelerationIncludingGravity;\n        if (!current)\n            return;\n        const time = Date.now();\n        if ((time - lastTime) > 100) {\n            const diffTime = time - lastTime;\n            lastTime = time;\n            const x = current.x || 0;\n            const y = current.y || 0;\n            const z = current.z || 0;\n            const speed = Math.abs(x + y + z - lastX - lastY - lastZ) / diffTime * 10000;\n            if (speed > threshold) {\n                fn();\n            }\n            lastX = x;\n            lastY = y;\n            lastZ = z;\n        }\n    };\n    if (window.DeviceMotionEvent) {\n        window.addEventListener('devicemotion', handler);\n        onMuDestroy(() => window.removeEventListener('devicemotion', handler));\n    }\n    else {\n        console.warn(\"[MulanJS] Device Motion not supported on this device.\");\n    }\n}\n/**\n * onMuVoice - The \"Sound Life\" Hook.\n * Executes when a specific word is spoken.\n * @param command The word to listen for (e.g., \"save\", \"next\")\n * @param fn The action to take\n */\nfunction onMuVoice(command, fn) {\n    const SpeechRecognition = window.SpeechRecognition || window.webkitSpeechRecognition;\n    if (!SpeechRecognition) {\n        console.warn(\"[MulanJS] Voice Control (Web Speech API) not supported in this browser.\");\n        return;\n    }\n    const recognition = new SpeechRecognition();\n    recognition.continuous = true;\n    recognition.lang = 'en-US';\n    recognition.interimResults = false;\n    recognition.onresult = (event) => {\n        const last = event.results.length - 1;\n        const spoken = event.results[last][0].transcript.trim().toLowerCase();\n        console.log(`[Mulan Voice] Heard: \"${spoken}\"`);\n        if (spoken.includes(command.toLowerCase())) {\n            fn();\n        }\n    };\n    recognition.start();\n    // Auto-restart if it stops (Continuous listening)\n    recognition.onend = () => {\n        // Simple check to see if we should still be listening\n        // In a real app we might want more control\n        // recognition.start(); \n    };\n    onMuDestroy(() => {\n        recognition.stop();\n    });\n}\n// --- \"Outside The Box\" Hooks (Mulan Exclusives) ---\n/**\n * muGeom - Tracks window or element dimensions reactively.\n */\nfunction muGeom() {\n    const dims = muState({ width: window.innerWidth, height: window.innerHeight });\n    const handler = () => {\n        dims.width = window.innerWidth;\n        dims.height = window.innerHeight;\n    };\n    window.addEventListener('resize', handler);\n    // Auto-cleanup\n    onMuDestroy(() => {\n        window.removeEventListener('resize', handler);\n    });\n    return dims;\n}\n/**\n * muPulse - Reactive network status.\n */\nfunction muPulse() {\n    const status = muState({ online: navigator.onLine });\n    const setOnline = () => status.online = true;\n    const setOffline = () => status.online = false;\n    window.addEventListener('online', setOnline);\n    window.addEventListener('offline', setOffline);\n    onMuDestroy(() => {\n        window.removeEventListener('online', setOnline);\n        window.removeEventListener('offline', setOffline);\n    });\n    return status;\n}\n/**\n * muVault - Secure reactive LocalStorage wrapper.\n * Powered by the Iron Fortress persistent primitive.\n */\nfunction muVault(key, initial, options = {}) {\n    return (0,_vault__WEBPACK_IMPORTED_MODULE_1__.persistent)(key, initial, options);\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/hooks.ts?\n}");
+
+/***/ },
+
+/***/ "./src/core/quantum.ts"
+/*!*****************************!*\
+  !*** ./src/core/quantum.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 */   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}");
+
+/***/ },
+
+/***/ "./src/core/query.ts"
+/*!***************************!*\
+  !*** ./src/core/query.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 */   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}");
+
+/***/ },
+
+/***/ "./src/core/reactive.ts"
+/*!******************************!*\
+  !*** ./src/core/reactive.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 */   Signal: () => (/* binding */ Signal),\n/* harmony export */   effect: () => (/* binding */ effect),\n/* harmony export */   reactive: () => (/* binding */ reactive),\n/* harmony export */   ref: () => (/* binding */ ref)\n/* harmony export */ });\n// MulanJS 2.0: Signal-Powered Reactivity Engine\n// \"Compatible Surface, World-Class Engine\"\nlet activeEffect = null;\nconst targetMap = new WeakMap();\n// --- Signal Core (The Engine) ---\nclass Signal {\n    constructor(initialValue) {\n        this._subscribers = new Set();\n        this._value = initialValue;\n    }\n    get value() {\n        if (activeEffect) {\n            this._subscribers.add(activeEffect);\n        }\n        return this._value;\n    }\n    set value(newValue) {\n        if (newValue !== this._value) {\n            this._value = newValue;\n            this.notify();\n        }\n    }\n    notify() {\n        this._subscribers.forEach(fn => fn());\n    }\n}\n// --- Compatibility Layer (The Surface) ---\nfunction effect(fn) {\n    let stopped = false;\n    const run = () => {\n        if (stopped)\n            return;\n        const prev = activeEffect;\n        activeEffect = run;\n        try {\n            fn();\n        }\n        finally {\n            activeEffect = prev;\n        }\n    };\n    run();\n    return () => {\n        stopped = true;\n    };\n}\nfunction track(target, key) {\n    if (activeEffect) {\n        let depsMap = targetMap.get(target);\n        if (!depsMap) {\n            targetMap.set(target, (depsMap = new Map()));\n        }\n        let dep = depsMap.get(key);\n        if (!dep) {\n            depsMap.set(key, (dep = new Set()));\n        }\n        dep.add(activeEffect);\n    }\n}\nfunction trigger(target, key) {\n    const depsMap = targetMap.get(target);\n    if (!depsMap)\n        return;\n    const dep = depsMap.get(key);\n    if (dep) {\n        dep.forEach((fn) => fn());\n    }\n}\n/**\n * Creates a reactive proxy object (Vue-compatible).\n * Now optimized to respect Mulan Cycle.\n */\nfunction reactive(target) {\n    return new Proxy(target, {\n        get(obj, prop, receiver) {\n            // IRON FORTRESS: Prototype Pollution Protection (Read)\n            if (prop === '__proto__' || prop === 'constructor' || prop === 'prototype') {\n                return undefined;\n            }\n            track(obj, prop);\n            const val = Reflect.get(obj, prop, receiver);\n            if (val !== null && typeof val === 'object') {\n                return reactive(val);\n            }\n            return val;\n        },\n        set(obj, prop, value, receiver) {\n            // IRON FORTRESS: Prototype Pollution Protection\n            if (prop === '__proto__' || prop === 'constructor' || prop === 'prototype') {\n                console.warn(`[Iron Fortress] Blocked attempt to modify dangerous property: ${String(prop)}`);\n                return false;\n            }\n            const result = Reflect.set(obj, prop, value, receiver);\n            trigger(obj, prop);\n            return result;\n        },\n    });\n}\n/**\n * Creates a standalone reactive reference.\n * Backed by the Mulan Signal Engine.\n */\nfunction ref(value) {\n    return new Signal(value);\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/reactive.ts?\n}");
+
+/***/ },
+
+/***/ "./src/core/renderer.ts"
+/*!******************************!*\
+  !*** ./src/core/renderer.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 */   hydrate: () => (/* binding */ hydrate),\n/* harmony export */   render: () => (/* binding */ render),\n/* harmony export */   renderToString: () => (/* binding */ renderToString),\n/* harmony export */   sanitize: () => (/* binding */ sanitize)\n/* harmony export */ });\nfunction render(template, container) {\n    // Focus Preservation (The \"Mulan Glance\" Technique)\n    let focusedId = null;\n    let selectionStart = null;\n    let selectionEnd = null;\n    let preservedValue = null;\n    if (document.activeElement && container.contains(document.activeElement)) {\n        const el = document.activeElement;\n        if (el.hasAttribute('data-mu-id')) {\n            focusedId = el.getAttribute('data-mu-id');\n            if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {\n                selectionStart = el.selectionStart;\n                selectionEnd = el.selectionEnd;\n                preservedValue = el.value;\n            }\n        }\n    }\n    container.innerHTML = template;\n    // Restore Focus and Value\n    if (focusedId) {\n        const el = container.querySelector(`[data-mu-id=\"${focusedId}\"]`);\n        if (el) {\n            // Restore value first to ensure cursor positioning works correctly\n            if (preservedValue !== null && (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement)) {\n                el.value = preservedValue;\n            }\n            el.focus();\n            if ((el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) && selectionStart !== null) {\n                try {\n                    el.setSelectionRange(selectionStart, selectionEnd);\n                }\n                catch (e) {\n                    // input types that don't support selection (e.g. number/email) might throw\n                }\n            }\n        }\n    }\n}\nfunction hydrate(template, container) {\n    // In a string-based framework, hydration is often just \"take over\".\n    // For now, we'll verify if the server content matches (simple check)\n    // and then assume control. In a more advanced version, we'd attach listeners without re-rendering.\n    if (container.innerHTML.trim() !== template.trim()) {\n        console.warn('Hydration Mismatch: Server rendered content differs from Client.');\n        container.innerHTML = template; // Fallback to full render\n    }\n    else {\n        // console.log('Hydration Successful.');\n    }\n    // Future: Attach event listeners here if we had a mechanism for it.\n}\nfunction renderToString(template) {\n    // SSR Function: returns the HTML string for the server to send.\n    // Can include additional sanitization or metadata injection here.\n    return template;\n}\nfunction sanitize(str) {\n    // Check if we are in a browser environment\n    if (typeof document !== 'undefined') {\n        const temp = document.createElement('div');\n        temp.textContent = str;\n        return temp.innerHTML;\n    }\n    // Simple SSR fallback sanitizer (rudimentary)\n    return str.replace(/&/g, \"&amp;\")\n        .replace(/</g, \"&lt;\")\n        .replace(/>/g, \"&gt;\")\n        .replace(/\"/g, \"&quot;\")\n        .replace(/'/g, \"&#039;\");\n}\n\n\n//# sourceURL=webpack://Mulan/./src/core/renderer.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}");
+
+/***/ },
+
+/***/ "./src/index.ts"
+/*!**********************!*\
+  !*** ./src/index.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 */   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 */   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\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\nconst Mulan = 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, 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__), { \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}\nwindow.Mulan = Mulan;\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (Mulan);\n\n\n//# sourceURL=webpack://Mulan/./src/index.ts?\n}");
+
+/***/ },
+
+/***/ "./src/router/index.ts"
+/*!*****************************!*\
+  !*** ./src/router/index.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 */   MuRouter: () => (/* binding */ MuRouter),\n/* harmony export */   createRouter: () => (/* binding */ createRouter)\n/* harmony export */ });\n/* harmony import */ var _core_renderer__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../core/renderer */ \"./src/core/renderer.ts\");\n/* harmony import */ var _security_sanitizer__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../security/sanitizer */ \"./src/security/sanitizer.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\n\nclass MuRouter {\n    constructor(routes, rootContainer = null) {\n        this.currentPath = '';\n        this.currentComponent = null;\n        this.lastRouteId = 0;\n        this.routes = routes;\n        this.rootContainer = rootContainer;\n        this.isServer = rootContainer === null; // If no container, assume server/headless mode\n        if (!this.isServer) {\n            window.addEventListener('hashchange', this.handleRoute.bind(this));\n            this.handleRoute(); // Initial load\n        }\n    }\n    // SSR Method: Simulate a route visit on the server\n    serverLookup(path) {\n        return __awaiter(this, void 0, void 0, function* () {\n            this.currentPath = path;\n            const { route, params } = this.matchRoute(path);\n            if (route) {\n                // Run guards/resolvers here if needed\n                let componentToRender = route.component;\n                // Support Lazy Loading\n                if (typeof componentToRender === 'function' && !componentToRender.prototype) {\n                    const module = yield componentToRender();\n                    componentToRender = module.default || module;\n                }\n                if (typeof componentToRender === 'function') {\n                    // Class component SSR\n                    // We need a dummy container for the component to \"render\" into its own buffer\n                    // For simplicity in this string-based framework, we mock the container\n                    const mockContainer = { innerHTML: '' };\n                    const instance = new componentToRender(mockContainer);\n                    if (instance.setParams)\n                        instance.setParams(params);\n                    // Manually trigger mount logic without DOM effects if possible, or just template()\n                    // Ideally, we just want the template string.\n                    return instance.template();\n                }\n                else {\n                    return componentToRender;\n                }\n            }\n            return '<!-- 404 -->';\n        });\n    }\n    matchRoute(hash) {\n        // Simple exact match first\n        let route = this.routes.find((r) => r.path === hash);\n        if (route)\n            return { route, params: {} };\n        // Regex match for params e.g. /user/:id\n        for (const r of this.routes) {\n            const paramNames = [];\n            const regexPath = r.path.replace(/:([^/]+)/g, (_, key) => {\n                paramNames.push(key);\n                return '([^/]+)';\n            });\n            const match = new RegExp(`^${regexPath}$`).exec(hash);\n            if (match) {\n                const params = {};\n                paramNames.forEach((name, i) => {\n                    // SECURE: Automatically sanitize all route parameters\n                    params[name] = _security_sanitizer__WEBPACK_IMPORTED_MODULE_1__.Security.sanitize(match[i + 1]);\n                });\n                return { route: r, params };\n            }\n        }\n        return { route: undefined, params: {} };\n    }\n    handleRoute() {\n        return __awaiter(this, void 0, void 0, function* () {\n            if (this.isServer)\n                return;\n            const currentRouteId = ++this.lastRouteId;\n            const hash = window.location.hash.slice(1) || '/';\n            const { route, params } = this.matchRoute(hash);\n            // Security Check: Validate URL to prevent malicious hash injection\n            if (hash !== '/' && !_security_sanitizer__WEBPACK_IMPORTED_MODULE_1__.Security.validateUrl('http://dummy.com' + hash)) {\n                console.error(\"Security Alert: Malformed URL detected.\");\n                return;\n            }\n            // Navigation Guard (Middleware)\n            if (route === null || route === void 0 ? void 0 : route.beforeEnter) {\n                yield new Promise((resolve) => {\n                    route.beforeEnter(hash, this.currentPath, (allow) => {\n                        if (allow)\n                            resolve();\n                        else {\n                            console.warn(`Navigation to ${hash} blocked by guard.`);\n                            // Ideally redirect or stay, here we just stop processing\n                            throw new Error('Navigation Blocked');\n                        }\n                    });\n                }).catch(() => { return; }); // Stop execution if blocked\n            }\n            this.currentPath = hash;\n            if (route) {\n                if (route.title) {\n                    document.title = route.title;\n                }\n                else if (route.meta && route.meta.title) {\n                    // Fallback to meta.title if used\n                    document.title = route.meta.title;\n                }\n                if (this.rootContainer) {\n                    // Mulan Cycle: Destroy previous component before rendering new one\n                    if (this.currentComponent) {\n                        console.log(`[Router] Navigation from ${this.currentPath} to ${hash}. Destroying previous component.`);\n                        if (this.currentComponent.onDestroy) {\n                            this.currentComponent.onDestroy();\n                        }\n                    }\n                    this.rootContainer.innerHTML = ''; // Clear previous content\n                }\n                let componentToRender = route.component;\n                // Support Lazy Loading\n                if (typeof componentToRender === 'function' && !componentToRender.prototype) {\n                    try {\n                        const module = yield componentToRender();\n                        if (currentRouteId !== this.lastRouteId) {\n                            console.log(`[Router] Navigation to ${hash} interrupted by newer navigation. Abandoning.`);\n                            return;\n                        }\n                        componentToRender = module.default || module;\n                    }\n                    catch (e) {\n                        console.error(\"Failed to lazy load component\", e);\n                        return;\n                    }\n                }\n                if (typeof componentToRender === 'function') {\n                    // It's a class component\n                    if (this.rootContainer) {\n                        const instance = new componentToRender(this.rootContainer);\n                        this.currentComponent = instance;\n                        // Inject params if the component accepts them\n                        if (instance.setParams) {\n                            instance.setParams(params);\n                        }\n                        instance.mount();\n                    }\n                }\n                else if (typeof componentToRender === 'object' && componentToRender.template) {\n                    // Object Component (Simple SFC without script or Options API)\n                    const html = componentToRender.template();\n                    if (this.rootContainer)\n                        (0,_core_renderer__WEBPACK_IMPORTED_MODULE_0__.render)(html, this.rootContainer);\n                    this.currentComponent = null;\n                }\n                else {\n                    // Simple HTML string/template\n                    if (this.rootContainer)\n                        (0,_core_renderer__WEBPACK_IMPORTED_MODULE_0__.render)(componentToRender, this.rootContainer);\n                    this.currentComponent = null; // String templates don't have lifecycle instances\n                }\n            }\n            else {\n                if (this.rootContainer)\n                    (0,_core_renderer__WEBPACK_IMPORTED_MODULE_0__.render)('<div style=\"text-align:center; padding:50px;\"><h1>404</h1><p>Page Not Found</p></div>', this.rootContainer);\n            }\n        });\n    }\n    navigate(path) {\n        if (this.isServer) {\n            this.currentPath = path;\n        }\n        else {\n            window.location.hash = path;\n        }\n    }\n}\n// --- Factory for Easy Usage ---\nconst createRouter = (options) => {\n    return new MuRouter(options.routes, options.rootContainer);\n};\n// --- Web Component: <mu-link> ---\n// Usage: <mu-link to=\"/about\">About Us</mu-link>\nif (typeof window !== 'undefined' && !customElements.get('mu-link')) {\n    class MuLink extends HTMLElement {\n        constructor() {\n            super();\n            this.addEventListener('click', (e) => {\n                e.preventDefault();\n                const to = this.getAttribute('to');\n                if (to) {\n                    // Update Hash for SPA Navigation\n                    window.location.hash = to;\n                }\n            });\n        }\n        connectedCallback() {\n            this.style.cursor = 'pointer';\n            this.style.color = 'var(--primary, #9C27B0)'; // Default to brand color if available\n            this.style.textDecoration = 'none';\n        }\n        static get observedAttributes() { return ['to']; }\n    }\n    customElements.define('mu-link', MuLink);\n}\n\n\n//# sourceURL=webpack://Mulan/./src/router/index.ts?\n}");
+
+/***/ },
+
+/***/ "./src/security/sanitizer.ts"
+/*!***********************************!*\
+  !*** ./src/security/sanitizer.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 */   Security: () => (/* binding */ Security)\n/* harmony export */ });\nclass Security {\n    static sanitize(input) {\n        // 1. Basic entity encoding\n        let secure = input\n            .replace(/&/g, \"&amp;\")\n            .replace(/</g, \"&lt;\")\n            .replace(/>/g, \"&gt;\")\n            .replace(/\"/g, \"&quot;\")\n            .replace(/'/g, \"&#039;\");\n        // 2. Remove dangerous events (extra layer if encoding fails)\n        const dangerousEvents = ['onload', 'onclick', 'onerror', 'onmouseover', 'onfocus'];\n        dangerousEvents.forEach(event => {\n            const regex = new RegExp(event, 'gi');\n            secure = secure.replace(regex, 'data-blocked-' + event);\n        });\n        return secure;\n    }\n    /**\n     * Generates a strict Content Security Policy header value.\n     * @param options Configuration for allowed sources\n     */\n    static generateCSP(options = {}) {\n        const scriptSrc = [\"'self'\", ...(options.scriptSrc || [])].join(\" \");\n        const styleSrc = [\"'self'\", \"'unsafe-inline'\", ...(options.styleSrc || [])].join(\" \");\n        return `default-src 'self'; script-src ${scriptSrc}; style-src ${styleSrc}; object-src 'none'; base-uri 'self';`;\n    }\n    static validateUrl(url) {\n        // Basic URL validation\n        const pattern = new RegExp('^(https?:\\\\/\\\\/)?' + // protocol\n            '((([a-z\\\\d]([a-z\\\\d-]*[a-z\\\\d])*)\\\\.)+[a-z]{2,}|' + // domain name\n            '((\\\\d{1,3}\\\\.){3}\\\\d{1,3}))' + // OR ip (v4) address\n            '(\\\\:\\\\d+)?(\\\\/[-a-z\\\\d%_.~+]*)*' + // port and path\n            '(\\\\?[;&a-z\\\\d%_.~+=-]*)?' + // query string\n            '(\\\\#[-a-z\\\\d_]*)?$', 'i'); // fragment locator\n        return !!pattern.test(url);\n    }\n    /**\n     * Prevents XSS by sanitizing common input fields on blur.\n     * Can be used as a utility in forms.\n     */\n    static preventXSS(inputElement) {\n        inputElement.addEventListener('blur', (e) => {\n            const target = e.target;\n            target.value = Security.sanitize(target.value);\n        });\n    }\n}\n\n\n//# sourceURL=webpack://Mulan/./src/security/sanitizer.ts?\n}");
+
+/***/ },
+
+/***/ "./src/store/index.ts"
+/*!****************************!*\
+  !*** ./src/store/index.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 */   MuStore: () => (/* binding */ MuStore)\n/* harmony export */ });\n/* harmony import */ var _core_reactive__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../core/reactive */ \"./src/core/reactive.ts\");\n\nclass MuStore {\n    constructor(initialState, options) {\n        this.subscribers = [];\n        // Load from local storage if persist is true\n        let loadedState = initialState;\n        if (options === null || options === void 0 ? void 0 : options.persist) {\n            const key = options.key || 'mulan-store';\n            try {\n                const stored = localStorage.getItem(key);\n                if (stored) {\n                    loadedState = Object.assign(Object.assign({}, initialState), JSON.parse(stored));\n                }\n            }\n            catch (e) {\n                console.error(\"Failed to load state\", e);\n            }\n            // Auto-save effect\n            (0,_core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect)(() => {\n                localStorage.setItem(key, JSON.stringify(this.state));\n            });\n        }\n        this.state = (0,_core_reactive__WEBPACK_IMPORTED_MODULE_0__.reactive)(loadedState);\n    }\n    // Subscribe to changes\n    subscribe(fn) {\n        this.subscribers.push(fn);\n        (0,_core_reactive__WEBPACK_IMPORTED_MODULE_0__.effect)(() => {\n            fn(this.state);\n        });\n    }\n    // Action dispatcher pattern\n    dispatch(action) {\n        const result = action(this.state);\n        if (result instanceof Promise) {\n            result.then(() => {\n                // Optional: Notify subscribers of async completion if needed manually?\n                // But reactive() handles updates automatically.\n            });\n        }\n    }\n}\n\n\n//# sourceURL=webpack://Mulan/./src/store/index.ts?\n}");
+
+/***/ }
+
+/******/ 	});
+/************************************************************************/
+/******/ 	// The module cache
+/******/ 	var __webpack_module_cache__ = {};
+/******/ 	
+/******/ 	// The require function
+/******/ 	function __webpack_require__(moduleId) {
+/******/ 		// Check if module is in cache
+/******/ 		var cachedModule = __webpack_module_cache__[moduleId];
+/******/ 		if (cachedModule !== undefined) {
+/******/ 			return cachedModule.exports;
+/******/ 		}
+/******/ 		// Check if module exists (development only)
+/******/ 		if (__webpack_modules__[moduleId] === undefined) {
+/******/ 			var e = new Error("Cannot find module '" + moduleId + "'");
+/******/ 			e.code = 'MODULE_NOT_FOUND';
+/******/ 			throw e;
+/******/ 		}
+/******/ 		// Create a new module (and put it into the cache)
+/******/ 		var module = __webpack_module_cache__[moduleId] = {
+/******/ 			// no module.id needed
+/******/ 			// no module.loaded needed
+/******/ 			exports: {}
+/******/ 		};
+/******/ 	
+/******/ 		// Execute the module function
+/******/ 		__webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+/******/ 	
+/******/ 		// Return the exports of the module
+/******/ 		return module.exports;
+/******/ 	}
+/******/ 	
+/************************************************************************/
+/******/ 	/* webpack/runtime/define property getters */
+/******/ 	(() => {
+/******/ 		// define getter functions for harmony exports
+/******/ 		__webpack_require__.d = (exports, definition) => {
+/******/ 			for(var key in definition) {
+/******/ 				if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+/******/ 					Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });
+/******/ 				}
+/******/ 			}
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
+/******/ 	(() => {
+/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/make namespace object */
+/******/ 	(() => {
+/******/ 		// define __esModule on exports
+/******/ 		__webpack_require__.r = (exports) => {
+/******/ 			if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
+/******/ 				Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+/******/ 			}
+/******/ 			Object.defineProperty(exports, '__esModule', { value: true });
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/************************************************************************/
+/******/ 	
+/******/ 	// startup
+/******/ 	// Load entry module and return exports
+/******/ 	// This entry module can't be inlined because the eval devtool is used.
+/******/ 	var __webpack_exports__ = __webpack_require__("./src/index.ts");
+/******/ 	__webpack_exports__ = __webpack_exports__["default"];
+/******/ 	
+/******/ 	return __webpack_exports__;
+/******/ })()
+;
+});

package/dist/router/index.js

@@ -0,0 +1,210 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { render } from '../core/renderer';
+import { Security } from '../security/sanitizer';
+export class MuRouter {
+    constructor(routes, rootContainer = null) {
+        this.currentPath = '';
+        this.currentComponent = null;
+        this.lastRouteId = 0;
+        this.routes = routes;
+        this.rootContainer = rootContainer;
+        this.isServer = rootContainer === null; // If no container, assume server/headless mode
+        if (!this.isServer) {
+            window.addEventListener('hashchange', this.handleRoute.bind(this));
+            this.handleRoute(); // Initial load
+        }
+    }
+    // SSR Method: Simulate a route visit on the server
+    serverLookup(path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.currentPath = path;
+            const { route, params } = this.matchRoute(path);
+            if (route) {
+                // Run guards/resolvers here if needed
+                let componentToRender = route.component;
+                // Support Lazy Loading
+                if (typeof componentToRender === 'function' && !componentToRender.prototype) {
+                    const module = yield componentToRender();
+                    componentToRender = module.default || module;
+                }
+                if (typeof componentToRender === 'function') {
+                    // Class component SSR
+                    // We need a dummy container for the component to "render" into its own buffer
+                    // For simplicity in this string-based framework, we mock the container
+                    const mockContainer = { innerHTML: '' };
+                    const instance = new componentToRender(mockContainer);
+                    if (instance.setParams)
+                        instance.setParams(params);
+                    // Manually trigger mount logic without DOM effects if possible, or just template()
+                    // Ideally, we just want the template string.
+                    return instance.template();
+                }
+                else {
+                    return componentToRender;
+                }
+            }
+            return '<!-- 404 -->';
+        });
+    }
+    matchRoute(hash) {
+        // Simple exact match first
+        let route = this.routes.find((r) => r.path === hash);
+        if (route)
+            return { route, params: {} };
+        // Regex match for params e.g. /user/:id
+        for (const r of this.routes) {
+            const paramNames = [];
+            const regexPath = r.path.replace(/:([^/]+)/g, (_, key) => {
+                paramNames.push(key);
+                return '([^/]+)';
+            });
+            const match = new RegExp(`^${regexPath}$`).exec(hash);
+            if (match) {
+                const params = {};
+                paramNames.forEach((name, i) => {
+                    // SECURE: Automatically sanitize all route parameters
+                    params[name] = Security.sanitize(match[i + 1]);
+                });
+                return { route: r, params };
+            }
+        }
+        return { route: undefined, params: {} };
+    }
+    handleRoute() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.isServer)
+                return;
+            const currentRouteId = ++this.lastRouteId;
+            const hash = window.location.hash.slice(1) || '/';
+            const { route, params } = this.matchRoute(hash);
+            // Security Check: Validate URL to prevent malicious hash injection
+            if (hash !== '/' && !Security.validateUrl('http://dummy.com' + hash)) {
+                console.error("Security Alert: Malformed URL detected.");
+                return;
+            }
+            // Navigation Guard (Middleware)
+            if (route === null || route === void 0 ? void 0 : route.beforeEnter) {
+                yield new Promise((resolve) => {
+                    route.beforeEnter(hash, this.currentPath, (allow) => {
+                        if (allow)
+                            resolve();
+                        else {
+                            console.warn(`Navigation to ${hash} blocked by guard.`);
+                            // Ideally redirect or stay, here we just stop processing
+                            throw new Error('Navigation Blocked');
+                        }
+                    });
+                }).catch(() => { return; }); // Stop execution if blocked
+            }
+            this.currentPath = hash;
+            if (route) {
+                if (route.title) {
+                    document.title = route.title;
+                }
+                else if (route.meta && route.meta.title) {
+                    // Fallback to meta.title if used
+                    document.title = route.meta.title;
+                }
+                if (this.rootContainer) {
+                    // Mulan Cycle: Destroy previous component before rendering new one
+                    if (this.currentComponent) {
+                        console.log(`[Router] Navigation from ${this.currentPath} to ${hash}. Destroying previous component.`);
+                        if (this.currentComponent.onDestroy) {
+                            this.currentComponent.onDestroy();
+                        }
+                    }
+                    this.rootContainer.innerHTML = ''; // Clear previous content
+                }
+                let componentToRender = route.component;
+                // Support Lazy Loading
+                if (typeof componentToRender === 'function' && !componentToRender.prototype) {
+                    try {
+                        const module = yield componentToRender();
+                        if (currentRouteId !== this.lastRouteId) {
+                            console.log(`[Router] Navigation to ${hash} interrupted by newer navigation. Abandoning.`);
+                            return;
+                        }
+                        componentToRender = module.default || module;
+                    }
+                    catch (e) {
+                        console.error("Failed to lazy load component", e);
+                        return;
+                    }
+                }
+                if (typeof componentToRender === 'function') {
+                    // It's a class component
+                    if (this.rootContainer) {
+                        const instance = new componentToRender(this.rootContainer);
+                        this.currentComponent = instance;
+                        // Inject params if the component accepts them
+                        if (instance.setParams) {
+                            instance.setParams(params);
+                        }
+                        instance.mount();
+                    }
+                }
+                else if (typeof componentToRender === 'object' && componentToRender.template) {
+                    // Object Component (Simple SFC without script or Options API)
+                    const html = componentToRender.template();
+                    if (this.rootContainer)
+                        render(html, this.rootContainer);
+                    this.currentComponent = null;
+                }
+                else {
+                    // Simple HTML string/template
+                    if (this.rootContainer)
+                        render(componentToRender, this.rootContainer);
+                    this.currentComponent = null; // String templates don't have lifecycle instances
+                }
+            }
+            else {
+                if (this.rootContainer)
+                    render('<div style="text-align:center; padding:50px;"><h1>404</h1><p>Page Not Found</p></div>', this.rootContainer);
+            }
+        });
+    }
+    navigate(path) {
+        if (this.isServer) {
+            this.currentPath = path;
+        }
+        else {
+            window.location.hash = path;
+        }
+    }
+}
+// --- Factory for Easy Usage ---
+export const createRouter = (options) => {
+    return new MuRouter(options.routes, options.rootContainer);
+};
+// --- Web Component: <mu-link> ---
+// Usage: <mu-link to="/about">About Us</mu-link>
+if (typeof window !== 'undefined' && !customElements.get('mu-link')) {
+    class MuLink extends HTMLElement {
+        constructor() {
+            super();
+            this.addEventListener('click', (e) => {
+                e.preventDefault();
+                const to = this.getAttribute('to');
+                if (to) {
+                    // Update Hash for SPA Navigation
+                    window.location.hash = to;
+                }
+            });
+        }
+        connectedCallback() {
+            this.style.cursor = 'pointer';
+            this.style.color = 'var(--primary, #9C27B0)'; // Default to brand color if available
+            this.style.textDecoration = 'none';
+        }
+        static get observedAttributes() { return ['to']; }
+    }
+    customElements.define('mu-link', MuLink);
+}