@emkodev/emroute 1.6.2 → 1.6.4

package/dist/src/overlay/overlay.service.js

@@ -0,0 +1,307 @@
+/**
+ * Overlay Service
+ *
+ * Programmatic API for modals, toasts, and popovers. For simple trigger
+ * patterns, use declarative HTML (commandfor/command + popover/dialog)
+ * with zero JS. This service covers dynamic content, programmatic
+ * triggers, and complex workflows.
+ *
+ * dismissAll() is DOM-aware: it closes both programmatic overlays
+ * managed by this service AND declarative popovers/dialogs found
+ * via DOM queries.
+ */
+import { overlayCSS } from "./overlay.css.js";
+const ANIMATION_SAFETY_TIMEOUT = 300;
+/**
+ * Animate an element out by setting `data-dismissing`, waiting for
+ * `transitionend`, then calling the provided callback. Includes a
+ * safety timeout in case the transition event never fires.
+ */
+function animateDismiss(el, onDone) {
+    el.setAttribute('data-dismissing', '');
+    let done = false;
+    const finish = () => {
+        if (done)
+            return;
+        done = true;
+        onDone();
+    };
+    el.addEventListener('transitionend', finish, { once: true });
+    setTimeout(finish, ANIMATION_SAFETY_TIMEOUT);
+}
+export function createOverlayService() {
+    let styleInjected = false;
+    // Modal state
+    let dialog = null;
+    // Uses `any` because modalResolve is reassigned across multiple modal() calls
+    // with different type parameters T. Each call creates a Promise.withResolvers<T>(),
+    // so the resolver function signature changes (accepts T | PromiseLike<T | undefined>).
+    // Type safety is maintained by closeModal<T>(value?: T) which ensures only valid
+    // types are passed to the resolver.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let modalResolve = null;
+    let modalOnClose;
+    // Toast state
+    let toastContainer = null;
+    // Popover state
+    let popoverEl = null;
+    let popoverAnchorObserver = null;
+    const supportsAnchor = typeof CSS !== 'undefined' &&
+        CSS.supports('anchor-name', '--a');
+    function injectCSS() {
+        if (styleInjected)
+            return;
+        styleInjected = true;
+        const style = document.createElement('style');
+        style.textContent = overlayCSS;
+        document.head.appendChild(style);
+    }
+    function ensureDialog() {
+        if (dialog)
+            return dialog;
+        injectCSS();
+        dialog = document.createElement('dialog');
+        dialog.setAttribute('data-overlay-modal', '');
+        document.body.appendChild(dialog);
+        dialog.addEventListener('click', (e) => {
+            if (e.target === dialog) {
+                closeModal(undefined);
+            }
+        });
+        return dialog;
+    }
+    function ensureToastContainer() {
+        if (toastContainer)
+            return toastContainer;
+        injectCSS();
+        toastContainer = document.createElement('div');
+        toastContainer.setAttribute('data-overlay-toast-container', '');
+        document.body.appendChild(toastContainer);
+        return toastContainer;
+    }
+    function ensurePopover() {
+        if (popoverEl)
+            return popoverEl;
+        injectCSS();
+        popoverEl = document.createElement('div');
+        popoverEl.setAttribute('data-overlay-popover', '');
+        popoverEl.setAttribute('popover', '');
+        document.body.appendChild(popoverEl);
+        return popoverEl;
+    }
+    // --- Modal ---
+    function modal(options) {
+        const d = ensureDialog();
+        // Clean up any lingering dismiss state from a previous close
+        d.removeAttribute('data-dismissing');
+        // Immediately dismiss popover — modal takes over the top layer
+        hidePopoverImmediate();
+        // Last wins: close current modal if open
+        if (d.open) {
+            d.close();
+            if (modalResolve) {
+                modalResolve(undefined);
+                modalResolve = null;
+            }
+            if (modalOnClose) {
+                modalOnClose();
+                modalOnClose = undefined;
+            }
+        }
+        d.innerHTML = '';
+        options.render(d);
+        modalOnClose = options.onClose;
+        const { promise, resolve } = Promise.withResolvers();
+        modalResolve = resolve;
+        d.showModal();
+        return promise;
+    }
+    function closeModal(value) {
+        if (!dialog || !dialog.open)
+            return;
+        const resolve = modalResolve;
+        const onClose = modalOnClose;
+        const dialogRef = dialog;
+        modalResolve = null;
+        modalOnClose = undefined;
+        animateDismiss(dialogRef, () => {
+            if (dialogRef && dialogRef.open) {
+                dialogRef.close();
+                if (resolve)
+                    resolve(value);
+                if (onClose)
+                    onClose();
+            }
+        });
+    }
+    // --- Toast ---
+    /** Remove dead toasts (dismissed or animation-finished) from container. */
+    function clearDeadToasts(container) {
+        for (const child of [...container.children]) {
+            const el = child;
+            if (el.hasAttribute('data-dismissing')) {
+                el.remove();
+            }
+        }
+    }
+    function toast(options) {
+        const container = ensureToastContainer();
+        // Clean up dead toasts before adding a new one
+        clearDeadToasts(container);
+        const el = document.createElement('div');
+        el.setAttribute('data-overlay-toast', '');
+        const timeout = options.timeout ?? 0;
+        if (timeout === 0) {
+            el.setAttribute('data-toast-manual', '');
+        }
+        else {
+            el.style.setProperty('--overlay-toast-duration', `${timeout}ms`);
+        }
+        options.render(el);
+        container.appendChild(el);
+        let dismissed = false;
+        const dismiss = () => {
+            if (dismissed)
+                return;
+            dismissed = true;
+            el.setAttribute('data-dismissing', '');
+        };
+        return { dismiss };
+    }
+    // --- Popover ---
+    function popover(options) {
+        const el = ensurePopover();
+        // Last wins: hide current popover if showing
+        cleanupPopoverAnchorObserver();
+        try {
+            el.hidePopover();
+        }
+        catch {
+            // Not shown — ignore
+        }
+        el.removeAttribute('data-dismissing');
+        el.innerHTML = '';
+        options.render(el);
+        // Anchor positioning
+        if (supportsAnchor) {
+            const anchorName = '--overlay-anchor';
+            options.anchor.style.setProperty('anchor-name', anchorName);
+            el.style.setProperty('position-anchor', anchorName);
+            el.style.removeProperty('top');
+            el.style.removeProperty('left');
+        }
+        else {
+            const rect = options.anchor.getBoundingClientRect();
+            el.style.top = `${rect.bottom + globalThis.scrollY}px`;
+            el.style.left = `${rect.left + globalThis.scrollX}px`;
+            el.style.position = 'absolute';
+        }
+        el.showPopover();
+        // Watch for anchor disconnect
+        watchAnchorDisconnect(options.anchor);
+    }
+    function watchAnchorDisconnect(anchor) {
+        cleanupPopoverAnchorObserver();
+        const parent = anchor.parentNode;
+        if (!parent) {
+            closePopover();
+            return;
+        }
+        popoverAnchorObserver = new MutationObserver(() => {
+            if (!document.contains(anchor)) {
+                closePopover();
+            }
+        });
+        popoverAnchorObserver.observe(parent, { childList: true });
+    }
+    /** Hide popover instantly without dismiss animation. */
+    function hidePopoverImmediate() {
+        cleanupPopoverAnchorObserver();
+        if (!popoverEl)
+            return;
+        try {
+            popoverEl.hidePopover();
+        }
+        catch {
+            // Not shown — ignore
+        }
+        popoverEl.removeAttribute('data-dismissing');
+    }
+    function cleanupPopoverAnchorObserver() {
+        if (popoverAnchorObserver) {
+            popoverAnchorObserver.disconnect();
+            popoverAnchorObserver = null;
+        }
+    }
+    function closePopover() {
+        cleanupPopoverAnchorObserver();
+        if (!popoverEl)
+            return;
+        // Check if popover is showing via matches(':popover-open')
+        let isOpen;
+        try {
+            isOpen = popoverEl.matches(':popover-open');
+        }
+        catch {
+            // :popover-open may not be supported — fall back
+            isOpen = popoverEl.hasAttribute('popover') && popoverEl.style.display !== 'none';
+        }
+        if (!isOpen)
+            return;
+        animateDismiss(popoverEl, () => {
+            try {
+                popoverEl.hidePopover();
+            }
+            catch {
+                // Already hidden
+            }
+        });
+    }
+    // --- Dismiss all ---
+    function dismissAll() {
+        // Close programmatic modal
+        if (dialog && dialog.open) {
+            const resolve = modalResolve;
+            const onClose = modalOnClose;
+            modalResolve = null;
+            modalOnClose = undefined;
+            dialog.removeAttribute('data-dismissing');
+            dialog.close();
+            if (resolve)
+                resolve(undefined);
+            if (onClose)
+                onClose();
+        }
+        // Hide programmatic popover
+        hidePopoverImmediate();
+        // Dismiss all toasts via CSS
+        if (toastContainer) {
+            for (const child of toastContainer.children) {
+                child.setAttribute('data-dismissing', '');
+            }
+        }
+        // Close declarative popovers found in the DOM
+        try {
+            for (const el of document.querySelectorAll(':popover-open')) {
+                el.hidePopover();
+            }
+        }
+        catch {
+            // :popover-open not supported
+        }
+        // Close declarative dialogs found in the DOM (skip our own)
+        for (const el of document.querySelectorAll('dialog[open]')) {
+            if (el !== dialog)
+                el.close();
+        }
+    }
+    return {
+        modal,
+        closeModal,
+        toast,
+        popover,
+        closePopover,
+        dismissAll,
+    };
+}
+//# sourceMappingURL=overlay.service.js.map

package/dist/src/overlay/overlay.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.service.js","sourceRoot":"","sources":["../../../src/overlay/overlay.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC;;;;GAIG;AACH,SAAS,cAAc,CAAC,EAAe,EAAE,MAAkB;IACzD,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAEvC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,MAAM,EAAE,CAAC;IACX,CAAC,CAAC;IAEF,EAAE,CAAC,gBAAgB,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,UAAU,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,cAAc;IACd,IAAI,MAAM,GAA6B,IAAI,CAAC;IAC5C,8EAA8E;IAC9E,oFAAoF;IACpF,uFAAuF;IACvF,iFAAiF;IACjF,oCAAoC;IACpC,8DAA8D;IAC9D,IAAI,YAAY,GAAkC,IAAI,CAAC;IACvD,IAAI,YAAsC,CAAC;IAE3C,cAAc;IACd,IAAI,cAAc,GAA0B,IAAI,CAAC;IAEjD,gBAAgB;IAChB,IAAI,SAAS,GAA0B,IAAI,CAAC;IAC5C,IAAI,qBAAqB,GAA4B,IAAI,CAAC;IAC1D,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,WAAW;QAC/C,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAErC,SAAS,SAAS;QAChB,IAAI,aAAa;YAAE,OAAO;QAC1B,aAAa,GAAG,IAAI,CAAC;QACrB,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,KAAK,CAAC,WAAW,GAAG,UAAU,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,YAAY;QACnB,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,SAAS,EAAE,CAAC;QACZ,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACrC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACxB,UAAU,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,oBAAoB;QAC3B,IAAI,cAAc;YAAE,OAAO,cAAc,CAAC;QAC1C,SAAS,EAAE,CAAC;QACZ,cAAc,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC/C,cAAc,CAAC,YAAY,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;QAChE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAC1C,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,SAAS,aAAa;QACpB,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAChC,SAAS,EAAE,CAAC;QACZ,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1C,SAAS,CAAC,YAAY,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACnD,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gBAAgB;IAEhB,SAAS,KAAK,CAAgB,OAAwB;QACpD,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;QAEzB,6DAA6D;QAC7D,CAAC,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAErC,+DAA+D;QAC/D,oBAAoB,EAAE,CAAC;QAEvB,yCAAyC;QACzC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,CAAC,CAAC,KAAK,EAAE,CAAC;YACV,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,EAAE,CAAC;gBACf,YAAY,GAAG,SAAS,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClB,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;QAE/B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAiB,CAAC;QACpE,YAAY,GAAG,OAAO,CAAC;QAEvB,CAAC,CAAC,SAAS,EAAE,CAAC;QAEd,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS,UAAU,CAAI,KAAS;QAC9B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,OAAO;QAEpC,MAAM,OAAO,GAAG,YAAY,CAAC;QAC7B,MAAM,OAAO,GAAG,YAAY,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,YAAY,GAAG,SAAS,CAAC;QAEzB,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE;YAC7B,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;gBAChC,SAAS,CAAC,KAAK,EAAE,CAAC;gBAClB,IAAI,OAAO;oBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC5B,IAAI,OAAO;oBAAE,OAAO,EAAE,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAEhB,2EAA2E;IAC3E,SAAS,eAAe,CAAC,SAAyB;QAChD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,EAAE,GAAG,KAAoB,CAAC;YAChC,IAAI,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACvC,EAAE,CAAC,MAAM,EAAE,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,KAAK,CAAC,OAAqB;QAClC,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;QAEzC,+CAA+C;QAC/C,eAAe,CAAC,SAAS,CAAC,CAAC;QAE3B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,0BAA0B,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAE1B,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAED,kBAAkB;IAElB,SAAS,OAAO,CAAC,OAAuB;QACtC,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;QAE3B,6CAA6C;QAC7C,4BAA4B,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,EAAE,CAAC,WAAW,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QACD,EAAE,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;QAEtC,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEnB,qBAAqB;QACrB,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,kBAAkB,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;YAC5D,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC;YACpD,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/B,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACpD,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC;YACvD,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC;YACtD,EAAE,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;QACjC,CAAC;QAED,EAAE,CAAC,WAAW,EAAE,CAAC;QAEjB,8BAA8B;QAC9B,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,SAAS,qBAAqB,CAAC,MAAmB;QAChD,4BAA4B,EAAE,CAAC;QAE/B,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;QACjC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,qBAAqB,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;YAChD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,qBAAqB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,wDAAwD;IACxD,SAAS,oBAAoB;QAC3B,4BAA4B,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,CAAC;YACH,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QACD,SAAS,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAC/C,CAAC;IAED,SAAS,4BAA4B;QACnC,IAAI,qBAAqB,EAAE,CAAC;YAC1B,qBAAqB,CAAC,UAAU,EAAE,CAAC;YACnC,qBAAqB,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,SAAS,YAAY;QACnB,4BAA4B,EAAE,CAAC;QAE/B,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,2DAA2D;QAC3D,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;YACjD,MAAM,GAAG,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC;QACnF,CAAC;QAED,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE;YAC7B,IAAI,CAAC;gBACH,SAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IAEtB,SAAS,UAAU;QACjB,2BAA2B;QAC3B,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,YAAY,CAAC;YAC7B,MAAM,OAAO,GAAG,YAAY,CAAC;YAC7B,YAAY,GAAG,IAAI,CAAC;YACpB,YAAY,GAAG,SAAS,CAAC;YAEzB,MAAM,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAK,EAAE,CAAC;YAEf,IAAI,OAAO;gBAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,OAAO;gBAAE,OAAO,EAAE,CAAC;QACzB,CAAC;QAED,4BAA4B;QAC5B,oBAAoB,EAAE,CAAC;QAEvB,6BAA6B;QAC7B,IAAI,cAAc,EAAE,CAAC;YACnB,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;gBAC3C,KAAqB,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC;YACH,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC3D,EAAkB,CAAC,WAAW,EAAE,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QAED,4DAA4D;QAC5D,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,gBAAgB,CAAoB,cAAc,CAAC,EAAE,CAAC;YAC9E,IAAI,EAAE,KAAK,MAAM;gBAAE,EAAE,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,UAAU;QACV,KAAK;QACL,OAAO;QACP,YAAY;QACZ,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/overlay/overlay.type.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Overlay Service Types
+ *
+ * Programmatic API for overlays. For simple cases, use declarative HTML
+ * attributes (commandfor/command + popover/dialog) — zero JS required.
+ * This service provides the imperative path for dynamic content,
+ * programmatic triggers, and complex workflows. dismissAll() is
+ * DOM-aware and closes both programmatic and declarative overlays.
+ */
+export interface OverlayService {
+    modal<T = undefined>(options: ModalOptions<T>): Promise<T | undefined>;
+    closeModal<T>(value?: T): void;
+    popover(options: PopoverOptions): void;
+    closePopover(): void;
+    toast(options: ToastOptions): {
+        dismiss(): void;
+    };
+    /** Close all open overlays — programmatic and declarative — and toasts. */
+    dismissAll(): void;
+}
+export interface ModalOptions<T = undefined> {
+    render(dialog: HTMLDialogElement): void;
+    onClose?(): void;
+}
+export interface PopoverOptions {
+    anchor: HTMLElement;
+    render(el: HTMLDivElement): void;
+}
+export interface ToastOptions {
+    render(el: HTMLDivElement): void;
+    /** Auto-dismiss timeout in ms. Default 0 (manual dismiss only). Set to a positive ms value for auto-dismiss via CSS animation. */
+    timeout?: number;
+}

package/dist/src/overlay/overlay.type.js

@@ -0,0 +1,11 @@
+/**
+ * Overlay Service Types
+ *
+ * Programmatic API for overlays. For simple cases, use declarative HTML
+ * attributes (commandfor/command + popover/dialog) — zero JS required.
+ * This service provides the imperative path for dynamic content,
+ * programmatic triggers, and complex workflows. dismissAll() is
+ * DOM-aware and closes both programmatic and declarative overlays.
+ */
+export {};
+//# sourceMappingURL=overlay.type.js.map

package/dist/src/overlay/overlay.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.type.js","sourceRoot":"","sources":["../../../src/overlay/overlay.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/src/renderer/spa/base.renderer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Base Renderer
+ *
+ * Shared rendering logic for SPA and Hash routers:
+ * - Route hierarchy traversal with nested slot rendering
+ * - Component loading, data fetching, and HTML rendering
+ * - Markdown render waiting
+ * - Document title updates
+ */
+import type { MatchedRoute, RouteConfig, RouteInfo } from '../../type/route.type.ts';
+import { RouteCore } from '../../route/route.core.ts';
+/**
+ * Abstract base for renderers that share the page rendering pipeline.
+ * Subclasses provide navigation mechanics (Navigation API, hashchange, etc.).
+ */
+export declare abstract class BaseRenderer {
+    protected core: RouteCore;
+    protected slot: Element | null;
+    constructor(core: RouteCore);
+    /**
+     * Render a matched page route with nested route support.
+     */
+    protected renderPage(routeInfo: RouteInfo, matched: MatchedRoute, signal: AbortSignal): Promise<void>;
+    /**
+     * Render a single route's content.
+     */
+    protected renderRouteContent(routeInfo: RouteInfo, route: RouteConfig, signal: AbortSignal, isLeaf?: boolean): Promise<{
+        html: string;
+        title?: string;
+    }>;
+    /**
+     * Wait for a <mark-down> element to finish rendering.
+     */
+    protected waitForMarkdownRender(element: HTMLElement): Promise<void>;
+    /**
+     * Update document.title from getTitle() result.
+     */
+    protected updateTitle(pageTitle?: string): void;
+}

package/dist/src/renderer/spa/base.renderer.js

@@ -0,0 +1,149 @@
+/**
+ * Base Renderer
+ *
+ * Shared rendering logic for SPA and Hash routers:
+ * - Route hierarchy traversal with nested slot rendering
+ * - Component loading, data fetching, and HTML rendering
+ * - Markdown render waiting
+ * - Document title updates
+ */
+import defaultPageComponent from "../../component/page.component.js";
+import { DEFAULT_ROOT_ROUTE } from "../../route/route.core.js";
+import { logger } from "../../util/logger.util.js";
+const MARKDOWN_RENDER_TIMEOUT = 5000;
+/**
+ * Abstract base for renderers that share the page rendering pipeline.
+ * Subclasses provide navigation mechanics (Navigation API, hashchange, etc.).
+ */
+export class BaseRenderer {
+    core;
+    slot = null;
+    constructor(core) {
+        this.core = core;
+    }
+    /**
+     * Render a matched page route with nested route support.
+     */
+    async renderPage(routeInfo, matched, signal) {
+        if (!this.slot)
+            return;
+        try {
+            const hierarchy = this.core.buildRouteHierarchy(routeInfo.pattern);
+            logger.render('page', routeInfo.pattern, `hierarchy: ${hierarchy.join(' > ')}`);
+            let currentSlot = this.slot;
+            let pageTitle;
+            for (let i = 0; i < hierarchy.length; i++) {
+                if (signal.aborted)
+                    return;
+                const routePattern = hierarchy[i];
+                const isLeaf = i === hierarchy.length - 1;
+                let route = this.core.matcher.findRoute(routePattern);
+                if (!route && routePattern === this.core.root) {
+                    route = { ...DEFAULT_ROOT_ROUTE, pattern: this.core.root };
+                }
+                if (!route) {
+                    logger.render('skip', routePattern, 'route not found');
+                    continue;
+                }
+                const routeType = isLeaf ? 'leaf' : 'layout';
+                logger.render(routeType, routePattern, `${route.files?.ts ?? 'default'} → slot`);
+                // Skip wildcard route appearing as its own parent (prevents double-render)
+                if (route === matched.route && routePattern !== matched.route.pattern) {
+                    continue;
+                }
+                const { html, title } = await this.renderRouteContent(routeInfo, route, signal, isLeaf);
+                if (signal.aborted)
+                    return;
+                currentSlot.setHTMLUnsafe(html);
+                if (title) {
+                    pageTitle = title;
+                }
+                // Wait for <mark-down> to finish rendering its content
+                // (must happen before attributing slots — router-slot may be inside markdown)
+                const markDown = currentSlot.querySelector('mark-down');
+                if (markDown) {
+                    await this.waitForMarkdownRender(markDown);
+                    if (signal.aborted)
+                        return;
+                }
+                // Attribute bare <router-slot> tags with this route's pattern
+                for (const slot of currentSlot.querySelectorAll('router-slot:not([pattern])')) {
+                    slot.setAttribute('pattern', routePattern);
+                }
+                if (!isLeaf) {
+                    const nestedSlot = currentSlot.querySelector(`router-slot[pattern="${CSS.escape(routePattern)}"]`);
+                    if (nestedSlot) {
+                        currentSlot = nestedSlot;
+                    }
+                    else {
+                        logger.warn(`Route "${routePattern}" has no <router-slot> ` +
+                            `for child routes to render into. ` +
+                            `Add <router-slot></router-slot> to the parent template.`);
+                    }
+                }
+            }
+            if (signal.aborted)
+                return;
+            this.updateTitle(pageTitle);
+            this.core.emit({
+                type: 'load',
+                pathname: routeInfo.pattern,
+                params: routeInfo.params,
+            });
+        }
+        catch (error) {
+            if (signal.aborted)
+                return;
+            throw error;
+        }
+    }
+    /**
+     * Render a single route's content.
+     */
+    async renderRouteContent(routeInfo, route, signal, isLeaf) {
+        if (route.modulePath === DEFAULT_ROOT_ROUTE.modulePath) {
+            return { html: `<router-slot pattern="${route.pattern}"></router-slot>` };
+        }
+        const files = route.files ?? {};
+        const component = files.ts
+            ? (await this.core.loadModule(files.ts)).default
+            : defaultPageComponent;
+        const context = await this.core.buildComponentContext(routeInfo, route, signal, isLeaf);
+        const data = await component.getData({ params: routeInfo.params, signal, context });
+        const html = component.renderHTML({ data, params: routeInfo.params, context });
+        const title = component.getTitle({ data, params: routeInfo.params, context });
+        return { html, title };
+    }
+    /**
+     * Wait for a <mark-down> element to finish rendering.
+     */
+    waitForMarkdownRender(element) {
+        return new Promise((resolve) => {
+            if (element.children.length > 0) {
+                resolve();
+                return;
+            }
+            const timeout = setTimeout(() => {
+                observer.disconnect();
+                resolve();
+            }, MARKDOWN_RENDER_TIMEOUT);
+            const observer = new MutationObserver(() => {
+                if (element.children.length > 0) {
+                    clearTimeout(timeout);
+                    observer.disconnect();
+                    resolve();
+                }
+            });
+            observer.observe(element, { childList: true });
+        });
+    }
+    /**
+     * Update document.title from getTitle() result.
+     */
+    updateTitle(pageTitle) {
+        if (pageTitle) {
+            document.title = pageTitle;
+        }
+    }
+}
+//# sourceMappingURL=base.renderer.js.map

package/dist/src/renderer/spa/base.renderer.js.map

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

package/dist/src/renderer/spa/hash.renderer.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Hash Router
+ *
+ * Lightweight client-side router for leaf mode mini-apps.
+ * Uses hashchange events + RouteCore pattern matching.
+ *
+ * Routes are defined inline by the consumer, not from the main manifest.
+ * Coexists with SpaHtmlRouter in root mode (SPA router skips hash changes).
+ */
+import type { RoutesManifest } from '../../type/route.type.ts';
+import type { ContextProvider } from '../../component/abstract.component.ts';
+import { RouteCore } from '../../route/route.core.ts';
+import { BaseRenderer } from './base.renderer.ts';
+/**
+ * A single hash route definition with a lazy module loader.
+ * @experimental
+ */
+export interface HashRouteConfig {
+    /** URLPattern pathname pattern (e.g. '/settings', '/users/:id'). */
+    pattern: string;
+    /** Lazy loader returning a module with a default PageComponent export. */
+    loader: () => Promise<unknown>;
+}
+/**
+ * Options for creating a HashRouter.
+ * @experimental
+ */
+export interface HashRouterOptions {
+    /** Inline route definitions. */
+    routes: HashRouteConfig[];
+    /** CSS selector or element to render into. Defaults to 'hash-slot'. */
+    slot?: string | Element;
+    /** Enriches every ComponentContext with app-level services. */
+    extendContext?: ContextProvider;
+}
+/**
+ * Hash-based mini-app router for leaf mode pages.
+ *
+ * Listens to `hashchange`, maps `#/path` → pattern match via RouteCore,
+ * renders matched PageComponent into a slot element.
+ *
+ * @experimental
+ */
+export declare class HashRouter extends BaseRenderer {
+    private boundHandler;
+    constructor(manifest: RoutesManifest, options?: {
+        extendContext?: ContextProvider;
+    });
+    /**
+     * Initialize: find slot, attach hashchange listener, render initial hash.
+     */
+    initialize(slot?: string | Element): Promise<void>;
+    /**
+     * Navigate to a hash path. Triggers hashchange → render.
+     */
+    navigate(hash: string): void;
+    /**
+     * Add event listener for router events.
+     */
+    addEventListener(listener: Parameters<RouteCore['addEventListener']>[0]): () => void;
+    /**
+     * Remove event listeners and release references.
+     */
+    dispose(): void;
+    /**
+     * Handle a hashchange event: parse hash, match, render.
+     */
+    private handleHashChange;
+}
+/**
+ * Create and initialize a hash router for a leaf-mode mini-app.
+ *
+ * The router instance is stored on `globalThis.__emroute_hash_router` for
+ * programmatic access. Calling twice returns the existing router with a warning.
+ *
+ * @experimental
+ */
+export declare function createHashRouter(options: HashRouterOptions): Promise<HashRouter>;