@madojs/mado 0.5.0

package/dist/src/router/navigation.js

@@ -0,0 +1,263 @@
+/**
+ * Browser integration: History API, click interception, hover-prefetch,
+ * View Transitions, queryParam.
+ *
+ * Everything that touches `window` / `document` / `history` lives here,
+ * so match.ts remains clean and testable without jsdom.
+ */
+import { signal } from "./../signal.js";
+import { compile, matchRoute, } from "./match.js";
+/**
+ * Minimal History API router.
+ *
+ *   const route = router({
+ *     '/':          () => html`<x-home/>`,
+ *     '/users/:id': ({ id }) => html`<x-user .id=${id}/>`,
+ *     '*':          () => html`<x-404/>`,
+ *   });
+ *
+ *   html`<main>${route.view}</main>`
+ *
+ * Lifecycle: subscribes to popstate + intercepts clicks
+ * on `<a data-link>` + hover-prefetch (if hook given). All this
+ * is removed in `dispose()` — mandatory to call in tests and
+ * dev-overlay, otherwise listener leak.
+ */
+export function router(routes, options = {}) {
+    const useViewTransitions = options.viewTransitions !== false;
+    const compiled = Object.entries(routes).map(([p, h]) => compile(p, h));
+    const fallback = compiled.find((r) => r.pattern === "*") ?? defaultFallback();
+    const path = signal(location.pathname);
+    const cleanups = [];
+    let disposed = false;
+    // -- popstate
+    const onPop = () => {
+        if (disposed)
+            return;
+        path.set(location.pathname);
+    };
+    window.addEventListener("popstate", onPop);
+    cleanups.push(() => window.removeEventListener("popstate", onPop));
+    // -- global click interception on <a data-link>
+    const onClick = (e) => {
+        if (disposed)
+            return;
+        const a = findAnchor(e, "a[data-link]");
+        if (!a)
+            return;
+        if (e.defaultPrevented)
+            return;
+        if (e.button !== 0)
+            return;
+        const me = e;
+        if (me.metaKey || me.ctrlKey || me.shiftKey || me.altKey)
+            return;
+        const url = new URL(a.href, location.href);
+        if (url.origin !== location.origin)
+            return;
+        e.preventDefault();
+        api.navigate(url.pathname + url.search + url.hash);
+    };
+    document.addEventListener("click", onClick);
+    cleanups.push(() => document.removeEventListener("click", onClick));
+    // -- hover-prefetch (>=50ms on <a data-link:not([data-no-prefetch])>)
+    let prefetchTimer = null;
+    const onMouseOver = (e) => {
+        if (disposed)
+            return;
+        if (!options.prefetch)
+            return;
+        const a = findAnchor(e, "a[data-link]:not([data-no-prefetch])");
+        if (!a)
+            return;
+        if (prefetchTimer)
+            clearTimeout(prefetchTimer);
+        prefetchTimer = setTimeout(() => {
+            try {
+                const url = new URL(a.href, location.href);
+                if (url.origin !== location.origin)
+                    return;
+                options.prefetch(url.pathname);
+            }
+            catch {
+                /* noop */
+            }
+        }, 50);
+    };
+    const onMouseOut = () => {
+        if (prefetchTimer) {
+            clearTimeout(prefetchTimer);
+            prefetchTimer = null;
+        }
+    };
+    document.addEventListener("mouseover", onMouseOver);
+    document.addEventListener("mouseout", onMouseOut);
+    cleanups.push(() => {
+        document.removeEventListener("mouseover", onMouseOver);
+        document.removeEventListener("mouseout", onMouseOut);
+        if (prefetchTimer)
+            clearTimeout(prefetchTimer);
+    });
+    const api = {
+        view: () => {
+            const p = path();
+            const m = matchRoute(p, compiled);
+            if (m)
+                return m.route.handler(m.params);
+            return fallback.handler({});
+        },
+        path,
+        navigate(to, opts) {
+            const apply = () => {
+                if (opts?.replace)
+                    history.replaceState(null, "", to);
+                else
+                    history.pushState(null, "", to);
+                path.set(location.pathname);
+                scrollToTop();
+            };
+            // View Transitions API: smooth crossfade between pages,
+            // if the browser supports it. Psychologically removes flashing
+            // even if the new page renders in 50-100ms.
+            const doc = document;
+            if (useViewTransitions && typeof doc.startViewTransition === "function") {
+                doc.startViewTransition(apply);
+            }
+            else {
+                apply();
+            }
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const c of cleanups.splice(0)) {
+                try {
+                    c();
+                }
+                catch {
+                    /* noop */
+                }
+            }
+        },
+    };
+    return api;
+}
+function findAnchor(e, selector) {
+    const fromElement = (node) => {
+        if (!(node instanceof Element))
+            return null;
+        const match = node.matches(selector) ? node : node.closest(selector);
+        if (!match || !("href" in match))
+            return null;
+        return match;
+    };
+    const direct = fromElement(e.target);
+    if (direct)
+        return direct;
+    if (typeof e.composedPath !== "function")
+        return null;
+    for (const node of e.composedPath()) {
+        const found = fromElement(node);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/** Default 404, if the manifest had no `'*'`. */
+function defaultFallback() {
+    return compile("*", () => {
+        const tpl = document.createElement("template");
+        tpl.innerHTML = `<pre>404: ${location.pathname}</pre>`;
+        return {
+            _mado: true,
+            strings: Object.assign([""], { raw: [""] }),
+            values: [tpl.content],
+        };
+    });
+}
+// ---------- navigate() ----------
+/**
+ * Global helper for programmatic navigation. Equivalent to
+ * `api.navigate(to)` for any active router — updates the URL
+ * via History API and dispatches `popstate`, which all
+ * active routers on the page will pick up.
+ *
+ *   import { navigate } from "@madojs/mado";
+ *   navigate("/users/42");
+ *
+ * Used inside form handlers / events when you don't have
+ * direct access to RouterApi (e.g. inside a component's setup function
+ * that didn't receive the router as a parameter).
+ */
+export function navigate(to, opts) {
+    if (typeof history === "undefined" || typeof window === "undefined")
+        return;
+    if (opts?.replace)
+        history.replaceState(null, "", to);
+    else
+        history.pushState(null, "", to);
+    scrollToTop();
+    // popstate is NOT dispatched automatically on pushState/replaceState,
+    // so we dispatch it manually — all active routers will hear and update.
+    window.dispatchEvent(new PopStateEvent("popstate"));
+}
+function scrollToTop() {
+    const maybeWindow = window;
+    if (typeof maybeWindow.scrollTo !== "function")
+        return;
+    try {
+        maybeWindow.scrollTo({ top: 0, left: 0 });
+    }
+    catch {
+        /* noop */
+    }
+}
+// ---------- queryParam ----------
+//
+// Reactive wrapper over ?foo=bar. Reading → signal, .set() → replaceState.
+// All queryParams in the app are synchronised via a shared signal bus.
+// The bus is lazily initialised on first queryParam() call, because
+// in SSR/test environments window/location may be connected later.
+let queryBus = null;
+function ensureQueryBus() {
+    if (queryBus)
+        return queryBus;
+    queryBus = signal(location.search);
+    window.addEventListener("popstate", () => queryBus.set(location.search));
+    return queryBus;
+}
+function syncQuery(next, push) {
+    const url = `${location.pathname}?${next.toString()}${location.hash}`.replace(/\?$/, "");
+    if (push)
+        history.pushState(null, "", url);
+    else
+        history.replaceState(null, "", url);
+    ensureQueryBus().set(location.search);
+}
+/**
+ * Reactive query parameter.
+ *
+ *   const page = queryParam('page', '1');
+ *   page();              // '1' (or current URL value)
+ *   page.set('2');       // history.replaceState and re-render
+ *   page.set(null);      // delete the parameter
+ */
+export function queryParam(name, defaultValue = "") {
+    const bus = ensureQueryBus();
+    const read = (() => {
+        const search = bus();
+        const params = new URLSearchParams(search);
+        return params.get(name) ?? defaultValue;
+    });
+    read.set = (value, opts) => {
+        const params = new URLSearchParams(location.search);
+        if (value === null || value === "")
+            params.delete(name);
+        else
+            params.set(name, value);
+        syncQuery(params, opts?.push ?? false);
+    };
+    return read;
+}
+//# sourceMappingURL=navigation.js.map

package/dist/src/router/navigation.js.map

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

package/dist/src/router.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Router module entry point. The implementation lives in `./router/`:
+ *
+ *   ./router/match.ts        — pure pattern matching (compile/flatten/normalize)
+ *   ./router/navigation.ts   — router() + navigate() + queryParam (touches window/history)
+ *   ./router/manifest.ts     — routes() + prefetchPath + lazy loading + sync-fast-path
+ *
+ * This file keeps compatibility for internal imports from `"./router.js"`.
+ * The public barrel (`src/index.ts`) also goes through this file.
+ */
+export { router, navigate, queryParam, type RouterApi, type RouterOptions, type QueryParam, type QuerySignal, } from "./router/navigation.js";
+export type { RouteHandler, RouteParams, Routes, RoutesMap, } from "./router/match.js";
+export { routes, prefetchPath, type RoutesOptions, _testHooks, } from "./router/manifest.js";

package/dist/src/router.js

@@ -0,0 +1,13 @@
+/**
+ * Router module entry point. The implementation lives in `./router/`:
+ *
+ *   ./router/match.ts        — pure pattern matching (compile/flatten/normalize)
+ *   ./router/navigation.ts   — router() + navigate() + queryParam (touches window/history)
+ *   ./router/manifest.ts     — routes() + prefetchPath + lazy loading + sync-fast-path
+ *
+ * This file keeps compatibility for internal imports from `"./router.js"`.
+ * The public barrel (`src/index.ts`) also goes through this file.
+ */
+export { router, navigate, queryParam, } from "./router/navigation.js";
+export { routes, prefetchPath, _testHooks, } from "./router/manifest.js";
+//# sourceMappingURL=router.js.map

package/dist/src/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,UAAU,GAKX,MAAM,wBAAwB,CAAC;AAShC,OAAO,EACL,MAAM,EACN,YAAY,EAEZ,UAAU,GACX,MAAM,sBAAsB,CAAC"}

package/dist/src/signal.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Reactivity via signals.
+ *
+ * Idea: a signal is a getter-function that also has .set / .update.
+ * When a signal is read inside an effect/computed, we record "who read it"
+ * and notify subscribers when the value changes. No proxies, no Virtual DOM.
+ *
+ * Performance:
+ *   - effect runs are deduplicated and scheduled via queueMicrotask,
+ *     so multiple .set() calls in a row produce a single subscriber pass;
+ *   - batch(fn) explicitly groups changes (supports arbitrary nesting);
+ *   - flushSync() — flush pending effects right now (useful in tests).
+ *
+ * API:
+ *   const count = signal(0);
+ *   count();            // get
+ *   count.set(5);       // set
+ *   count.update(n=>n+1);
+ *
+ *   const doubled = computed(() => count() * 2);
+ *
+ *   effect(() => console.log(count()));
+ *
+ *   batch(() => { a.set(1); b.set(2); });
+ */
+/**
+ * Group multiple signal changes into a single subscriber pass.
+ * Supports arbitrary nesting.
+ */
+export declare function batch<T>(fn: () => T): T;
+/**
+ * Forcefully flush pending effects right now (synchronously).
+ * Useful in tests: removes the need to wait for a microtask.
+ */
+export declare function flushSync(): void;
+export interface Signal<T> {
+    (): T;
+    set(value: T): void;
+    update(updater: (prev: T) => T): void;
+    peek(): T;
+}
+export declare function signal<T>(initial: T): Signal<T>;
+export interface Computed<T> {
+    (): T;
+    peek(): T;
+}
+/**
+ * Lazy computed based on a dirty-flag:
+ *   - fn is NOT called until the computed is read;
+ *   - if none of the deps changed since the last read — cached value is returned;
+ *   - when a dep changes the computed is marked dirty (NOT recomputed),
+ *     and triggers its own subscribers via schedule(). Subscribers
+ *     (an effect or another computed) will read our value on their next run
+ *     → fn is recomputed exactly once.
+ *
+ * Implementation: computed = "signal source" (has subscribers) +
+ * "tracker" (has deps). When a dep calls the tracker's run(),
+ * instead of actually recomputing we mark ourselves dirty and
+ * propagate to subscribers.
+ */
+export declare function computed<T>(fn: () => T): Computed<T>;
+export type Disposer = () => void;
+export declare function effect(fn: () => void | Disposer): Disposer;
+/**
+ * Execute a function outside of tracking — reading signals will not create a subscription.
+ */
+export declare function untracked<T>(fn: () => T): T;

package/dist/src/signal.js

@@ -0,0 +1,238 @@
+/**
+ * Reactivity via signals.
+ *
+ * Idea: a signal is a getter-function that also has .set / .update.
+ * When a signal is read inside an effect/computed, we record "who read it"
+ * and notify subscribers when the value changes. No proxies, no Virtual DOM.
+ *
+ * Performance:
+ *   - effect runs are deduplicated and scheduled via queueMicrotask,
+ *     so multiple .set() calls in a row produce a single subscriber pass;
+ *   - batch(fn) explicitly groups changes (supports arbitrary nesting);
+ *   - flushSync() — flush pending effects right now (useful in tests).
+ *
+ * API:
+ *   const count = signal(0);
+ *   count();            // get
+ *   count.set(5);       // set
+ *   count.update(n=>n+1);
+ *
+ *   const doubled = computed(() => count() * 2);
+ *
+ *   effect(() => console.log(count()));
+ *
+ *   batch(() => { a.set(1); b.set(2); });
+ */
+let activeTracker = null;
+// ---------- Scheduler ----------
+const pending = new Set();
+let batchDepth = 0;
+let flushScheduled = false;
+function schedule(sub) {
+    pending.add(sub);
+    if (batchDepth > 0)
+        return;
+    if (flushScheduled)
+        return;
+    flushScheduled = true;
+    queueMicrotask(flush);
+}
+function flush() {
+    flushScheduled = false;
+    // guard against Set modification during iteration
+    while (pending.size > 0) {
+        const subs = [...pending];
+        pending.clear();
+        for (const sub of subs) {
+            try {
+                sub();
+            }
+            catch (err) {
+                // a subscriber must not crash the others
+                // eslint-disable-next-line no-console
+                console.error("[mado] effect threw:", err);
+            }
+        }
+    }
+}
+/**
+ * Group multiple signal changes into a single subscriber pass.
+ * Supports arbitrary nesting.
+ */
+export function batch(fn) {
+    batchDepth++;
+    try {
+        return fn();
+    }
+    finally {
+        batchDepth--;
+        if (batchDepth === 0 && pending.size > 0 && !flushScheduled) {
+            flushScheduled = true;
+            queueMicrotask(flush);
+        }
+    }
+}
+/**
+ * Forcefully flush pending effects right now (synchronously).
+ * Useful in tests: removes the need to wait for a microtask.
+ */
+export function flushSync() {
+    flush();
+}
+export function signal(initial) {
+    let value = initial;
+    const subscribers = new Set();
+    const read = (() => {
+        if (activeTracker) {
+            subscribers.add(activeTracker.entry);
+            activeTracker.deps.add(subscribers);
+        }
+        return value;
+    });
+    read.set = (next) => {
+        if (Object.is(value, next))
+            return;
+        value = next;
+        // snapshot: a subscriber may re-subscribe in run(), mutating the Set
+        const snapshot = [...subscribers];
+        // sync subscribers (computed) first — mark dirty before effects read;
+        // then async via the scheduler.
+        for (const e of snapshot) {
+            if (e.sync) {
+                try {
+                    e.run();
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.error("[mado] sync subscriber threw:", err);
+                }
+            }
+        }
+        for (const e of snapshot) {
+            if (!e.sync)
+                schedule(e.run);
+        }
+    };
+    read.update = (fn) => read.set(fn(value));
+    read.peek = () => value;
+    return read;
+}
+/**
+ * Lazy computed based on a dirty-flag:
+ *   - fn is NOT called until the computed is read;
+ *   - if none of the deps changed since the last read — cached value is returned;
+ *   - when a dep changes the computed is marked dirty (NOT recomputed),
+ *     and triggers its own subscribers via schedule(). Subscribers
+ *     (an effect or another computed) will read our value on their next run
+ *     → fn is recomputed exactly once.
+ *
+ * Implementation: computed = "signal source" (has subscribers) +
+ * "tracker" (has deps). When a dep calls the tracker's run(),
+ * instead of actually recomputing we mark ourselves dirty and
+ * propagate to subscribers.
+ */
+export function computed(fn) {
+    const subscribers = new Set();
+    let value = undefined;
+    let dirty = true;
+    const onInvalidate = () => {
+        // dep changed → mark dirty synchronously and cascade.
+        // Sync subscribers (other computed) are triggered immediately — they also
+        // set dirty without delay. Async (effects) go through the scheduler.
+        if (dirty)
+            return;
+        dirty = true;
+        const snapshot = [...subscribers];
+        for (const e of snapshot) {
+            if (e.sync) {
+                try {
+                    e.run();
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.error("[mado] sync subscriber threw:", err);
+                }
+            }
+            else {
+                schedule(e.run);
+            }
+        }
+    };
+    const tracker = {
+        deps: new Set(),
+        entry: { run: onInvalidate, sync: true },
+    };
+    const recompute = () => {
+        for (const dep of tracker.deps)
+            dep.delete(tracker.entry);
+        tracker.deps.clear();
+        const prev = activeTracker;
+        activeTracker = tracker;
+        try {
+            value = fn();
+        }
+        finally {
+            activeTracker = prev;
+        }
+        dirty = false;
+    };
+    const read = (() => {
+        if (activeTracker) {
+            subscribers.add(activeTracker.entry);
+            activeTracker.deps.add(subscribers);
+        }
+        if (dirty)
+            recompute();
+        return value;
+    });
+    read.peek = () => {
+        if (dirty)
+            recompute();
+        return value;
+    };
+    return read;
+}
+export function effect(fn) {
+    let cleanup;
+    const run = () => {
+        for (const dep of tracker.deps)
+            dep.delete(tracker.entry);
+        tracker.deps.clear();
+        if (typeof cleanup === "function")
+            cleanup();
+        const prev = activeTracker;
+        activeTracker = tracker;
+        try {
+            cleanup = fn();
+        }
+        finally {
+            activeTracker = prev;
+        }
+    };
+    const tracker = {
+        deps: new Set(),
+        entry: { run, sync: false },
+    };
+    run();
+    return () => {
+        for (const dep of tracker.deps)
+            dep.delete(tracker.entry);
+        tracker.deps.clear();
+        if (typeof cleanup === "function")
+            cleanup();
+    };
+}
+/**
+ * Execute a function outside of tracking — reading signals will not create a subscription.
+ */
+export function untracked(fn) {
+    const prev = activeTracker;
+    activeTracker = null;
+    try {
+        return fn();
+    }
+    finally {
+        activeTracker = prev;
+    }
+}
+//# sourceMappingURL=signal.js.map

package/dist/src/signal.js.map

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

package/docs/README.md

@@ -0,0 +1,12 @@
+# Mado docs
+
+Documentation is organized by language.
+
+| Language | Status |
+|---|---|
+| [Français](./fr/README.md) | translated |
+| [English](./en/README.md) | translated |
+| [Ukrainian](./uk/README.md) | translated |
+| [Russian](./ru/README.md) | translated |
+
+Translations and comment localization are tracked separately from core work.