@mulanjs/mulanjs 1.0.1-dev.20260220134357 → 1.0.1-dev.20260222103836

package/dist/compiler/compiler.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compileSFC = compileSFC;
+exports.compileSFC = void 0;
 const sfc_parser_1 = require("./sfc-parser");
 const script_compiler_1 = require("./script-compiler");
 const template_compiler_1 = require("./template-compiler");
@@ -37,8 +37,8 @@ async function compileSFC(source, filename, options) {
         });
         // 1. Apply Script Map
         if (scriptResult.map) {
-            const scriptConsumer = await new source_map_1.SourceMapConsumer(JSON.parse(scriptResult.map));
-            scriptConsumer.eachMapping(mapping => {
+            const scriptConsumer = new source_map_1.SourceMapConsumer(JSON.parse(scriptResult.map));
+            scriptConsumer.eachMapping((mapping) => {
                 if (mapping.source) {
                     generator.addMapping({
                         generated: {
@@ -56,19 +56,19 @@ async function compileSFC(source, filename, options) {
             });
             // Copy source content from script map
             if (scriptConsumer.sources) {
-                scriptConsumer.sources.forEach(sourceFile => {
+                scriptConsumer.sources.forEach((sourceFile) => {
                     const content = scriptConsumer.sourceContentFor(sourceFile);
                     if (content) {
                         generator.setSourceContent(sourceFile, content);
                     }
                 });
             }
-            scriptConsumer.destroy();
+            // scriptConsumer.destroy() not needed in 0.6.x
         }
         // 2. Apply Template Map
         if (templateResult.map) {
-            const templateConsumer = await new source_map_1.SourceMapConsumer(JSON.parse(templateResult.map));
-            templateConsumer.eachMapping(mapping => {
+            const templateConsumer = new source_map_1.SourceMapConsumer(JSON.parse(templateResult.map));
+            templateConsumer.eachMapping((mapping) => {
                 if (mapping.source) {
                     generator.addMapping({
                         generated: {
@@ -86,14 +86,14 @@ async function compileSFC(source, filename, options) {
             });
             // Copy source content from template map
             if (templateConsumer.sources) {
-                templateConsumer.sources.forEach(sourceFile => {
+                templateConsumer.sources.forEach((sourceFile) => {
                     const content = templateConsumer.sourceContentFor(sourceFile);
                     if (content) {
                         generator.setSourceContent(sourceFile, content);
                     }
                 });
             }
-            templateConsumer.destroy();
+            // templateConsumer.destroy() not needed in 0.6.x
         }
         mergedMap = generator.toString();
     }
@@ -166,3 +166,4 @@ export default __component__;
         map: mergedMap || scriptResult.map // Fallback to script map if merge fails
     };
 }
+exports.compileSFC = compileSFC;

package/dist/compiler/script-compiler.js

@@ -15,25 +15,15 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compileScript = compileScript;
+exports.compileScript = void 0;
 const ts = __importStar(require("typescript"));
 const source_map_1 = require("source-map");
 const path = __importStar(require("path"));
@@ -78,6 +68,7 @@ async function compileScript(descriptor, options) {
         return { code: content, errors: [] };
     }
 }
+exports.compileScript = compileScript;
 // Global list of Mulan hooks for auto-imports and reactivity exemption
 const COMMON_HOOKS = ['muState', 'onMuMount', 'onMuInit', 'onMuDestroy', 'muEffect', 'muMemo', 'muQubit', 'muGate', 'muMeasure', 'muRegister', 'muEntangle', 'persistent'];
 async function compileSetupScript(script, isTs, descriptor, content, filename, isExternal, externalPath) {
@@ -214,7 +205,7 @@ export default ${hasDefineComponent ? 'defineComponent' : '_defineComponent'}({
                     originalSource = descriptor.source;
                     linesBeforeScript = originalSource.substring(0, script.start).split('\n').length - 1;
                 }
-                const consumer = await new source_map_1.SourceMapConsumer(finalMap);
+                const consumer = new source_map_1.SourceMapConsumer(JSON.parse(finalMap));
                 const generator = new source_map_1.SourceMapGenerator({
                     file: filename,
                     sourceRoot: ''
@@ -246,7 +237,7 @@ export default ${hasDefineComponent ? 'defineComponent' : '_defineComponent'}({
                 // If inline, we set source content of .mujs (the whole file)
                 // If external, we set source content of the .ts file
                 generator.setSourceContent(relativePath, originalSource);
-                consumer.eachMapping(m => {
+                consumer.eachMapping((m) => {
                     if (m.originalLine === null)
                         return;
                     // m.originalLine is the line in `finalCode` (1-based because SourceMapConsumer uses 1-based)
@@ -278,7 +269,7 @@ export default ${hasDefineComponent ? 'defineComponent' : '_defineComponent'}({
                     }
                 });
                 finalMap = generator.toString();
-                consumer.destroy();
+                // consumer.destroy() not needed in 0.6.x
             }
             catch (e) {
                 console.warn('[MulanJS] Failed to patch source map:', e);
@@ -328,7 +319,7 @@ async function compileStandardScript(script, descriptor, content, filename, isEx
                 originalSource = descriptor.source;
                 linesBeforeScript = descriptor.source.substring(0, script.start).split('\n').length - 1;
             }
-            const consumer = await new source_map_1.SourceMapConsumer(finalMap);
+            const consumer = new source_map_1.SourceMapConsumer(JSON.parse(finalMap));
             const generator = new source_map_1.SourceMapGenerator({
                 file: filename,
                 sourceRoot: ''
@@ -353,7 +344,7 @@ async function compileStandardScript(script, descriptor, content, filename, isEx
                 }
             }
             generator.setSourceContent(relativePath, originalSource);
-            consumer.eachMapping(m => {
+            consumer.eachMapping((m) => {
                 if (m.originalLine === null)
                     return;
                 const originalLine = m.originalLine + linesBeforeScript;
@@ -371,7 +362,7 @@ async function compileStandardScript(script, descriptor, content, filename, isEx
                 });
             });
             finalMap = generator.toString();
-            consumer.destroy();
+            // consumer.destroy() removed for v0.6.1
         }
         catch (e) { /* ignore */ }
     }

package/dist/compiler/sfc-parser.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseMUJS = parseMUJS;
+exports.parseMUJS = void 0;
 /**
  * Standardized State-Machine Parser for MulanJS
  * Parses .mujs files safely, handling attributes, quotes, and nested content.
@@ -91,3 +91,4 @@ function parseMUJS(source, filename) {
     }
     return descriptor;
 }
+exports.parseMUJS = parseMUJS;

package/dist/compiler/style-compiler.js

@@ -15,25 +15,15 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compileStyle = compileStyle;
+exports.compileStyle = void 0;
 const path = __importStar(require("path"));
 function compileStyle(descriptor, filename, options) {
     const styles = descriptor.styles;
@@ -101,6 +91,7 @@ function compileStyle(descriptor, filename, options) {
         errors: []
     };
 }
+exports.compileStyle = compileStyle;
 // Simple hash for ID generation
 function hash(str) {
     let hash = 0;

package/dist/compiler/template-compiler.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compileTemplate = compileTemplate;
+exports.compileTemplate = void 0;
 // --- Compile Function ---
 const source_map_1 = require("source-map");
 function compileTemplate(descriptor, scriptResult, scopedId) {
@@ -71,6 +71,7 @@ function compileTemplate(descriptor, scriptResult, scopedId) {
         map
     };
 }
+exports.compileTemplate = compileTemplate;
 // --- Parser (Recursive Descent) ---
 function parse(template, errors) {
     // Root Wrapper

package/dist/core/component.js

@@ -62,6 +62,12 @@ export class MuComponent {
         this._eventQueue.push([id, type, handler]);
         return "";
     }
+    // Manual binding helper for template literals
+    bind(handler, type = 'click') {
+        const id = 'ev_' + Math.random().toString(36).substr(2, 9);
+        this._e(id, type, handler);
+        return `data-mu-id="${id}"`;
+    }
     mount() {
         console.log(`[Mulan Cycle] Mounting component ${this.$uid}`);
         const stop = effect(() => {

package/dist/core/hooks.js

@@ -227,3 +227,145 @@ export function muPulse() {
 export function muVault(key, initial, options = {}) {
     return persistent(key, initial, Object.assign(Object.assign({}, options), { onCleanup: (fn) => onMuDestroy(fn) }));
 }
+// --- Next-Gen MulanJS Hooks ---
+/**
+ * muSuspense - The Asynchronous Barrier.
+ * Natively handles async state (loading/data/error) without wrapper components.
+ */
+export function muSuspense(promiseFn) {
+    const state = muState({
+        loading: true,
+        data: null,
+        error: null
+    });
+    // Execute immediately safely
+    promiseFn()
+        .then(res => {
+        state.data = res;
+        state.loading = false;
+    })
+        .catch(err => {
+        state.error = err;
+        state.loading = false;
+    });
+    return state;
+}
+/**
+ * onMuVisibility - The Intersection Observer Hook.
+ * Triggers when the component enters/leaves the viewport.
+ */
+export function onMuVisibility(callback, options = { threshold: 0.1 }) {
+    const instance = getCurrentInstance();
+    // We defer observation to mount phase to ensure DOM exists
+    onMuMount(() => {
+        if (!instance || !instance.container)
+            return;
+        const observer = new IntersectionObserver((entries) => {
+            entries.forEach(entry => {
+                callback(entry.isIntersecting);
+            });
+        }, options);
+        observer.observe(instance.container);
+        onMuDestroy(() => {
+            observer.disconnect();
+        });
+    });
+}
+/**
+ * muDebounced - High-performance debouncing built directly into a reactive signal.
+ */
+export function muDebounced(initialValue, delayMs) {
+    const state = muState(initialValue);
+    let timeoutId;
+    return {
+        get value() {
+            return state.value;
+        },
+        set value(newVal) {
+            clearTimeout(timeoutId);
+            timeoutId = setTimeout(() => {
+                state.value = newVal;
+            }, delayMs);
+        }
+    };
+}
+/**
+ * muThrottled - High-performance throttling built directly into a reactive signal.
+ */
+export function muThrottled(initialValue, delayMs) {
+    const state = muState(initialValue);
+    let lastRan = 0;
+    return {
+        get value() {
+            return state.value;
+        },
+        set value(newVal) {
+            const now = Date.now();
+            if (now - lastRan >= delayMs) {
+                state.value = newVal;
+                lastRan = now;
+            }
+        }
+    };
+}
+/**
+ * onMuPanic - The Iron Fortress Error Boundary.
+ * Catches unhandled exceptions within the component scope.
+ */
+export function onMuPanic(fallbackFn) {
+    const instance = getCurrentInstance();
+    const handler = (event) => {
+        // Broad catch - in a full implementation, we'd inspect the stack trace 
+        // to isolate if it originated from `instance` specifically.
+        // For Mulan 2.0 MVP, we execute the fallback.
+        const error = event instanceof ErrorEvent ? event.error : event.reason;
+        console.error(`[Iron Fortress] Component ${(instance === null || instance === void 0 ? void 0 : instance.$uid) || 'Unknown'} Panic:`, error);
+        fallbackFn(error);
+        // Prevent default browser crash if handled
+        event.preventDefault();
+    };
+    window.addEventListener('error', handler);
+    window.addEventListener('unhandledrejection', handler);
+    onMuDestroy(() => {
+        window.removeEventListener('error', handler);
+        window.removeEventListener('unhandledrejection', handler);
+    });
+}
+/**
+ * muHistory - State with built-in Undo/Redo tracking.
+ */
+export function muHistory(initialValue) {
+    const state = muState(initialValue);
+    // Explicit wrapper object because muState treats bare arrays dynamically
+    const historyTracker = muState({ log: [initialValue] });
+    const pointer = muState(0);
+    const updateValue = (newVal) => {
+        // If we are back in history and make a NEW change, we drop the 'future'
+        if (pointer.value < historyTracker.log.length - 1) {
+            historyTracker.log = historyTracker.log.slice(0, pointer.value + 1);
+        }
+        historyTracker.log.push(newVal);
+        pointer.value = historyTracker.log.length - 1;
+        state.value = newVal;
+    };
+    const undo = () => {
+        if (pointer.value > 0) {
+            pointer.value--;
+            state.value = historyTracker.log[pointer.value];
+        }
+    };
+    const redo = () => {
+        if (pointer.value < historyTracker.log.length - 1) {
+            pointer.value++;
+            state.value = historyTracker.log[pointer.value];
+        }
+    };
+    return {
+        get value() { return state.value; },
+        set value(newVal) { updateValue(newVal); },
+        undo,
+        redo,
+        get past() { return historyTracker.log.slice(0, pointer.value); },
+        get future() { return historyTracker.log.slice(pointer.value + 1); }
+    };
+}

package/dist/mulan.esm.js

@@ -38,18 +38,24 @@ var hooks_namespaceObject = {};
 __webpack_require__.r(hooks_namespaceObject);
 __webpack_require__.d(hooks_namespaceObject, {
   getCurrentInstance: () => (getCurrentInstance),
+  muDebounced: () => (muDebounced),
   muEffect: () => (muEffect),
   muGeom: () => (muGeom),
+  muHistory: () => (muHistory),
   muMemo: () => (muMemo),
   muPulse: () => (muPulse),
   muState: () => (muState),
+  muSuspense: () => (muSuspense),
+  muThrottled: () => (muThrottled),
   muVault: () => (muVault),
   onMuDestroy: () => (onMuDestroy),
   onMuIdle: () => (onMuIdle),
   onMuInit: () => (onMuInit),
   onMuMount: () => (onMuMount),
+  onMuPanic: () => (onMuPanic),
   onMuResume: () => (onMuResume),
   onMuShake: () => (onMuShake),
+  onMuVisibility: () => (onMuVisibility),
   onMuVoice: () => (onMuVoice),
   setCurrentInstance: () => (setCurrentInstance)
 });
@@ -601,6 +607,148 @@ function muPulse() {
 function muVault(key, initial, options = {}) {
     return persistent(key, initial, Object.assign(Object.assign({}, options), { onCleanup: (fn) => onMuDestroy(fn) }));
 }
+// --- Next-Gen MulanJS Hooks ---
+/**
+ * muSuspense - The Asynchronous Barrier.
+ * Natively handles async state (loading/data/error) without wrapper components.
+ */
+function muSuspense(promiseFn) {
+    const state = muState({
+        loading: true,
+        data: null,
+        error: null
+    });
+    // Execute immediately safely
+    promiseFn()
+        .then(res => {
+        state.data = res;
+        state.loading = false;
+    })
+        .catch(err => {
+        state.error = err;
+        state.loading = false;
+    });
+    return state;
+}
+/**
+ * onMuVisibility - The Intersection Observer Hook.
+ * Triggers when the component enters/leaves the viewport.
+ */
+function onMuVisibility(callback, options = { threshold: 0.1 }) {
+    const instance = getCurrentInstance();
+    // We defer observation to mount phase to ensure DOM exists
+    onMuMount(() => {
+        if (!instance || !instance.container)
+            return;
+        const observer = new IntersectionObserver((entries) => {
+            entries.forEach(entry => {
+                callback(entry.isIntersecting);
+            });
+        }, options);
+        observer.observe(instance.container);
+        onMuDestroy(() => {
+            observer.disconnect();
+        });
+    });
+}
+/**
+ * muDebounced - High-performance debouncing built directly into a reactive signal.
+ */
+function muDebounced(initialValue, delayMs) {
+    const state = muState(initialValue);
+    let timeoutId;
+    return {
+        get value() {
+            return state.value;
+        },
+        set value(newVal) {
+            clearTimeout(timeoutId);
+            timeoutId = setTimeout(() => {
+                state.value = newVal;
+            }, delayMs);
+        }
+    };
+}
+/**
+ * muThrottled - High-performance throttling built directly into a reactive signal.
+ */
+function muThrottled(initialValue, delayMs) {
+    const state = muState(initialValue);
+    let lastRan = 0;
+    return {
+        get value() {
+            return state.value;
+        },
+        set value(newVal) {
+            const now = Date.now();
+            if (now - lastRan >= delayMs) {
+                state.value = newVal;
+                lastRan = now;
+            }
+        }
+    };
+}
+/**
+ * onMuPanic - The Iron Fortress Error Boundary.
+ * Catches unhandled exceptions within the component scope.
+ */
+function onMuPanic(fallbackFn) {
+    const instance = getCurrentInstance();
+    const handler = (event) => {
+        // Broad catch - in a full implementation, we'd inspect the stack trace 
+        // to isolate if it originated from `instance` specifically.
+        // For Mulan 2.0 MVP, we execute the fallback.
+        const error = event instanceof ErrorEvent ? event.error : event.reason;
+        console.error(`[Iron Fortress] Component ${(instance === null || instance === void 0 ? void 0 : instance.$uid) || 'Unknown'} Panic:`, error);
+        fallbackFn(error);
+        // Prevent default browser crash if handled
+        event.preventDefault();
+    };
+    window.addEventListener('error', handler);
+    window.addEventListener('unhandledrejection', handler);
+    onMuDestroy(() => {
+        window.removeEventListener('error', handler);
+        window.removeEventListener('unhandledrejection', handler);
+    });
+}
+/**
+ * muHistory - State with built-in Undo/Redo tracking.
+ */
+function muHistory(initialValue) {
+    const state = muState(initialValue);
+    // Explicit wrapper object because muState treats bare arrays dynamically
+    const historyTracker = muState({ log: [initialValue] });
+    const pointer = muState(0);
+    const updateValue = (newVal) => {
+        // If we are back in history and make a NEW change, we drop the 'future'
+        if (pointer.value < historyTracker.log.length - 1) {
+            historyTracker.log = historyTracker.log.slice(0, pointer.value + 1);
+        }
+        historyTracker.log.push(newVal);
+        pointer.value = historyTracker.log.length - 1;
+        state.value = newVal;
+    };
+    const undo = () => {
+        if (pointer.value > 0) {
+            pointer.value--;
+            state.value = historyTracker.log[pointer.value];
+        }
+    };
+    const redo = () => {
+        if (pointer.value < historyTracker.log.length - 1) {
+            pointer.value++;
+            state.value = historyTracker.log[pointer.value];
+        }
+    };
+    return {
+        get value() { return state.value; },
+        set value(newVal) { updateValue(newVal); },
+        undo,
+        redo,
+        get past() { return historyTracker.log.slice(0, pointer.value); },
+        get future() { return historyTracker.log.slice(pointer.value + 1); }
+    };
+}
 
 ;// ./src/core/component.ts
 
@@ -667,6 +815,12 @@ class MuComponent {
         this._eventQueue.push([id, type, handler]);
         return "";
     }
+    // Manual binding helper for template literals
+    bind(handler, type = 'click') {
+        const id = 'ev_' + Math.random().toString(36).substr(2, 9);
+        this._e(id, type, handler);
+        return `data-mu-id="${id}"`;
+    }
     mount() {
         console.log(`[Mulan Cycle] Mounting component ${this.$uid}`);
         const stop = effect(() => {
@@ -2053,6 +2207,6 @@ if (typeof window !== 'undefined') {
 }
 /* harmony default export */ const src = (Mulan);
 
-export { MuComponent as Component, MuBlochSphereElement, MuComponent, MuInfinity, MuRouter, MuStore, MuRouter as Router, Security, Signal, activeControls, src as default, defineComponent, effect, getCurrentInstance, hydrate, muBurst, muControl, muEffect, muEntangle, muGate, muGeom, muMeasure, muMemo, muParallel, muPulse, muQubit, muRegister, muSearch, muState, muSurge, muSwitch, muTeleport, muVault, onMuDestroy, onMuIdle, onMuInit, onMuMount, onMuResume, onMuShake, onMuVoice, persistent, reactive, ref, render, renderToString, sanitize, setCurrentInstance, useMutation, useQuery };
+export { MuComponent as Component, MuBlochSphereElement, MuComponent, MuInfinity, MuRouter, MuStore, MuRouter as Router, Security, Signal, activeControls, src as default, defineComponent, effect, getCurrentInstance, hydrate, muBurst, muControl, muDebounced, muEffect, muEntangle, muGate, muGeom, muHistory, muMeasure, muMemo, muParallel, muPulse, muQubit, muRegister, muSearch, muState, muSurge, muSuspense, muSwitch, muTeleport, muThrottled, muVault, onMuDestroy, onMuIdle, onMuInit, onMuMount, onMuPanic, onMuResume, onMuShake, onMuVisibility, onMuVoice, persistent, reactive, ref, render, renderToString, sanitize, setCurrentInstance, useMutation, useQuery };
 
 //# sourceMappingURL=mulan.esm.js.map