@toyz/loom 0.1.0

package/dist/router/outlet.js

@@ -0,0 +1,171 @@
+/**
+ * Loom Router — <loom-outlet>
+ *
+ * Renders the component matched by the current route.
+ * Supports `inherit-styles` attribute to pass parent stylesheets
+ * into the routed component's shadow root.
+ *
+ * Resolves the initial route on connect so pages render even if
+ * RouteChanged fired before the outlet entered the DOM.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { LoomElement } from "../element";
+import { component, on, prop, ROUTE_PROPS, TRANSFORMS } from "../decorators";
+import { matchRoute } from "./route";
+import { RouteChanged } from "./events";
+import { params as paramsSentinel, routeQuery as querySentinel } from "../decorators/state";
+let LoomOutlet = class LoomOutlet extends LoomElement {
+    /** Stylesheets to pass down to routed components via adoptStyles() */
+    styles = [];
+    scrollToTop = true;
+    /** Optional callback invoked with the routed element after mount */
+    routeMount = null;
+    _currentTag = null;
+    _currentEl = null;
+    _initialResolved = false;
+    onRouteChanged(e) {
+        this._show(e.path, e.params);
+    }
+    /** Called after the first render — resolve whatever the current URL is */
+    firstUpdated() {
+        if (this._initialResolved)
+            return;
+        this._initialResolved = true;
+        const path = location.hash.slice(1) || "/";
+        const match = matchRoute(path);
+        if (match) {
+            this._show(path, match.params);
+        }
+    }
+    _show(path, params) {
+        const match = matchRoute(path);
+        const tag = match?.entry.tag ?? null;
+        if (!tag) {
+            this._clear();
+            return;
+        }
+        // Same component — just update data
+        if (tag === this._currentTag && this._currentEl) {
+            this._injectRouteData(this._currentEl, params);
+            return;
+        }
+        this._clear();
+        this._mount(tag, params);
+        if (this.scrollToTop)
+            this._scrollToTop();
+    }
+    _mount(tag, params) {
+        const el = document.createElement(tag);
+        this._injectRouteData(el, params);
+        // Pass explicit styles to the routed component
+        if (this.styles.length > 0) {
+            this._adoptParentStyles(el);
+        }
+        this.shadow.appendChild(el);
+        this._currentTag = tag;
+        this._currentEl = el;
+        // Notify consumer
+        if (this.routeMount) {
+            queueMicrotask(() => this.routeMount?.(el));
+        }
+    }
+    /**
+     * Inject route params and query params into the element.
+     * Uses ROUTE_PROPS metadata when available (typed properties),
+     * falls back to setAttribute for backward compat.
+     */
+    _injectRouteData(el, params) {
+        const ctor = el.constructor;
+        const routeBindings = ctor[ROUTE_PROPS] ?? [];
+        const transforms = ctor[TRANSFORMS];
+        const queryMap = this._parseQuery();
+        const boundParamKeys = new Set();
+        for (const binding of routeBindings) {
+            let value;
+            if (binding.params === paramsSentinel) {
+                // Full param decompose: @prop({params})
+                value = { ...params };
+            }
+            else if (typeof binding.param === "string") {
+                // Single param pick: @prop({ param: "id" })
+                value = params[binding.param] ?? "";
+                boundParamKeys.add(binding.param);
+            }
+            else if (binding.query === querySentinel) {
+                // Full query decompose: @prop({query: routeQuery})
+                value = Object.fromEntries(queryMap);
+            }
+            else if (typeof binding.query === "string") {
+                // Single query pick: @prop({ query: "tab" })
+                value = queryMap.get(binding.query) ?? "";
+            }
+            // Apply @transform if registered
+            if (transforms?.has(binding.propKey) && value !== undefined) {
+                value = transforms.get(binding.propKey)(value);
+            }
+            el[binding.propKey] = value;
+        }
+        // Backward compat: set unbound params as attributes
+        for (const [key, val] of Object.entries(params)) {
+            if (!boundParamKeys.has(key)) {
+                el.setAttribute(key, val);
+            }
+        }
+    }
+    /** Parse query params from the URL hash */
+    _parseQuery() {
+        const hash = location.hash;
+        const qIdx = hash.indexOf("?");
+        return new URLSearchParams(qIdx >= 0 ? hash.slice(qIdx + 1) : "");
+    }
+    _adoptParentStyles(el) {
+        if (typeof el.adoptStyles === "function") {
+            el.adoptStyles(this.styles);
+        }
+    }
+    _clear() {
+        if (this._currentEl) {
+            this._currentEl.remove();
+            this._currentEl = null;
+            this._currentTag = null;
+        }
+    }
+    _scrollToTop() {
+        // Walk up the DOM tree (including shadow host boundaries)
+        let node = this;
+        while (node) {
+            if (node instanceof Element && node.scrollTop > 0) {
+                node.scrollTop = 0;
+            }
+            // Cross shadow DOM boundary
+            const root = node.getRootNode();
+            if (root instanceof ShadowRoot) {
+                node = root.host;
+            }
+            else {
+                node = node.parentElement;
+            }
+        }
+        // Always scroll the window as failsafe
+        window.scrollTo(0, 0);
+    }
+};
+__decorate([
+    prop
+], LoomOutlet.prototype, "styles", void 0);
+__decorate([
+    prop
+], LoomOutlet.prototype, "scrollToTop", void 0);
+__decorate([
+    on(RouteChanged)
+], LoomOutlet.prototype, "onRouteChanged", null);
+LoomOutlet = __decorate([
+    component("loom-outlet")
+], LoomOutlet);
+export { LoomOutlet };
+//# sourceMappingURL=outlet.js.map

package/dist/router/outlet.js.map

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

package/dist/router/route.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Loom Router — Route table and decorators
+ *
+ * @route(path, opts?) registers a component class as a route handler.
+ * @guard(name?) marks a method as a named route guard.
+ */
+export declare const ROUTE_PATH: unique symbol;
+export declare const GUARD_HANDLERS: unique symbol;
+export interface RouteEntry {
+    pattern: string;
+    regex: RegExp;
+    paramNames: string[];
+    tag: string;
+    ctor: any;
+    /** Named guards to check before rendering this route */
+    guards: string[];
+}
+/** Global route table — populated by @route decorators */
+export declare const routes: RouteEntry[];
+/**
+ * Global guard registry — populated by @guard decorators.
+ * Maps guard name → { proto, key, injectMeta }
+ */
+export interface GuardRegistration {
+    proto: any;
+    key: string;
+}
+export declare const guardRegistry: Map<string, GuardRegistration>;
+/**
+ * Match a path against the route table.
+ * Returns the matched entry + extracted params, or null.
+ */
+export declare function matchRoute(path: string): {
+    entry: RouteEntry;
+    params: Record<string, string>;
+} | null;
+interface RouteOptions {
+    /** Named guards to check before this route is rendered */
+    guards?: string[];
+}
+/**
+ * Register a class as a route handler.
+ *
+ * ```ts
+ * @route("/docs/:slug")
+ * @component("page-docs")
+ * class PageDocs extends LoomElement { ... }
+ *
+ * @route("/admin", { guards: ["auth", "role"] })
+ * @component("page-admin")
+ * class PageAdmin extends LoomElement { ... }
+ * ```
+ */
+export declare function route(pattern: string, opts?: RouteOptions): (ctor: any) => void;
+/**
+ * Mark a method as a named route guard.
+ *
+ * Return `true` to allow, `false` to block, or a `string` to redirect.
+ * Async guards are awaited. Supports @inject on parameters.
+ *
+ * ```ts
+ * @guard("auth")
+ * checkAuth(@inject(AuthService) auth: AuthService) {
+ *   return auth.isLoggedIn ? true : "/login";
+ * }
+ *
+ * // Derived name from method name:
+ * @guard
+ * checkRole(@inject(UserStore) users: UserStore) {
+ *   return users.current?.role === "admin" ? true : "/forbidden";
+ * }
+ * ```
+ */
+export declare function guard(nameOrTarget: any, key?: string): any;
+export {};
+//# sourceMappingURL=route.d.ts.map

package/dist/router/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/router/route.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,UAAU,eAA4B,CAAC;AACpD,eAAO,MAAM,cAAc,eAA8B,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,wDAAwD;IACxD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,0DAA0D;AAC1D,eAAO,MAAM,MAAM,EAAE,UAAU,EAAO,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,GAAG,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AACD,eAAO,MAAM,aAAa,gCAAuC,CAAC;AA4BlE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAYrG;AAID,UAAU,YAAY;IACpB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,IAChD,MAAM,GAAG,UA4BlB;AAeD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAa1D"}

package/dist/router/route.js

@@ -0,0 +1,147 @@
+/**
+ * Loom Router — Route table and decorators
+ *
+ * @route(path, opts?) registers a component class as a route handler.
+ * @guard(name?) marks a method as a named route guard.
+ */
+export const ROUTE_PATH = Symbol("loom:route:path");
+export const GUARD_HANDLERS = Symbol("loom:route:guards");
+/** Global route table — populated by @route decorators */
+export const routes = [];
+export const guardRegistry = new Map();
+/**
+ * Compile a route pattern into a regex + param name list.
+ *
+ * `/docs/:slug` → { regex: /^\/docs\/([^/]+)$/, paramNames: ["slug"] }
+ * `*`           → { regex: /^.*$/, paramNames: [] }
+ */
+function compilePattern(pattern) {
+    if (pattern === "*") {
+        return { regex: /^.*$/, paramNames: [] };
+    }
+    const paramNames = [];
+    const regexStr = pattern
+        .split("/")
+        .map((seg) => {
+        if (seg.startsWith(":")) {
+            paramNames.push(seg.slice(1));
+            return "([^/]+)";
+        }
+        return seg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    })
+        .join("\\/");
+    return { regex: new RegExp(`^${regexStr}$`), paramNames };
+}
+/**
+ * Match a path against the route table.
+ * Returns the matched entry + extracted params, or null.
+ */
+export function matchRoute(path) {
+    for (const entry of routes) {
+        const m = path.match(entry.regex);
+        if (m) {
+            const params = {};
+            entry.paramNames.forEach((name, i) => {
+                params[name] = m[i + 1];
+            });
+            return { entry, params };
+        }
+    }
+    return null;
+}
+/**
+ * Register a class as a route handler.
+ *
+ * ```ts
+ * @route("/docs/:slug")
+ * @component("page-docs")
+ * class PageDocs extends LoomElement { ... }
+ *
+ * @route("/admin", { guards: ["auth", "role"] })
+ * @component("page-admin")
+ * class PageAdmin extends LoomElement { ... }
+ * ```
+ */
+export function route(pattern, opts) {
+    return (ctor) => {
+        ctor[ROUTE_PATH] = pattern;
+        const { regex, paramNames } = compilePattern(pattern);
+        // Defer tag resolution — the @component decorator may not have run yet.
+        // We use a getter to lazily resolve the custom element tag.
+        const entry = {
+            pattern,
+            regex,
+            paramNames,
+            get tag() {
+                // Find the tag registered for this constructor
+                return _tagForCtor(ctor);
+            },
+            ctor,
+            guards: opts?.guards ?? [],
+        };
+        // Wildcard goes last
+        if (pattern === "*") {
+            routes.push(entry);
+        }
+        else {
+            // Insert before wildcards
+            const wildcardIdx = routes.findIndex((r) => r.pattern === "*");
+            if (wildcardIdx === -1)
+                routes.push(entry);
+            else
+                routes.splice(wildcardIdx, 0, entry);
+        }
+    };
+}
+/** Resolve the custom element tag for a constructor */
+function _tagForCtor(ctor) {
+    // Search customElements registry
+    const name = customElements.getName?.(ctor);
+    if (name)
+        return name;
+    // Fallback: scan internal app registry (custom elements v1 doesn't have getName everywhere)
+    // We store the tag on the constructor via @component
+    return ctor.__loom_tag ?? ctor.name.toLowerCase();
+}
+// ── @guard decorator ──
+/**
+ * Mark a method as a named route guard.
+ *
+ * Return `true` to allow, `false` to block, or a `string` to redirect.
+ * Async guards are awaited. Supports @inject on parameters.
+ *
+ * ```ts
+ * @guard("auth")
+ * checkAuth(@inject(AuthService) auth: AuthService) {
+ *   return auth.isLoggedIn ? true : "/login";
+ * }
+ *
+ * // Derived name from method name:
+ * @guard
+ * checkRole(@inject(UserStore) users: UserStore) {
+ *   return users.current?.role === "admin" ? true : "/forbidden";
+ * }
+ * ```
+ */
+export function guard(nameOrTarget, key) {
+    if (typeof key === "string") {
+        // Bare @guard (no name) — derive name from method name
+        _registerGuard(nameOrTarget, key, key);
+        return;
+    }
+    if (typeof nameOrTarget === "string") {
+        // @guard("auth") — factory form with explicit name
+        return (target, methodKey) => {
+            _registerGuard(target, methodKey, nameOrTarget);
+        };
+    }
+}
+function _registerGuard(proto, key, name) {
+    // Legacy: store on prototype for backward compat
+    if (!proto[GUARD_HANDLERS])
+        proto[GUARD_HANDLERS] = [];
+    proto[GUARD_HANDLERS].push(key);
+    // New: register in global registry by name
+    guardRegistry.set(name, { proto, key });
+}
+//# sourceMappingURL=route.js.map

package/dist/router/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/router/route.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAY1D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,MAAM,GAAiB,EAAE,CAAC;AAUvC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,EAA6B,CAAC;AAElE;;;;;GAKG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,OAAO;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC;SACD,IAAI,CAAC,KAAK,CAAC,CAAC;IAEf,OAAO,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;gBACnC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AASD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,KAAK,CAAC,OAAe,EAAE,IAAmB;IACxD,OAAO,CAAC,IAAS,EAAE,EAAE;QAClB,IAAY,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;QACpC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAEtD,wEAAwE;QACxE,4DAA4D;QAC5D,MAAM,KAAK,GAAe;YACxB,OAAO;YACP,KAAK;YACL,UAAU;YACV,IAAI,GAAG;gBACL,+CAA+C;gBAC/C,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YACD,IAAI;YACJ,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;SAC3B,CAAC;QAEF,qBAAqB;QACrB,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,0BAA0B;YAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC;YAC/D,IAAI,WAAW,KAAK,CAAC,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;gBACtC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,uDAAuD;AACvD,SAAS,WAAW,CAAC,IAAS;IAC5B,iCAAiC;IACjC,MAAM,IAAI,GAAI,cAAsB,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAEtB,4FAA4F;IAC5F,qDAAqD;IACrD,OAAQ,IAAY,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AAC7D,CAAC;AAED,yBAAyB;AAEzB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,KAAK,CAAC,YAAiB,EAAE,GAAY;IACnD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,uDAAuD;QACvD,cAAc,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,mDAAmD;QACnD,OAAO,CAAC,MAAW,EAAE,SAAiB,EAAE,EAAE;YACxC,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QAClD,CAAC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAU,EAAE,GAAW,EAAE,IAAY;IAC3D,iDAAiD;IACjD,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;QAAE,KAAK,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IACvD,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhC,2CAA2C;IAC3C,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/router/router.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Loom Router — LoomRouter service
+ *
+ * Dual-mode (hash/history) router with named guard support.
+ * Register via app.use(new LoomRouter({ mode: "hash" }))
+ */
+import { type RouterMode } from "./mode";
+export interface RouterOptions {
+    mode?: "hash" | "history";
+}
+export interface RouteInfo {
+    path: string;
+    params: Record<string, string>;
+    tag: string | null;
+}
+export declare class LoomRouter {
+    readonly mode: RouterMode;
+    private _current;
+    constructor(opts?: RouterOptions);
+    /** Current route info (read-only snapshot) */
+    get current(): Readonly<RouteInfo>;
+    /** Start listening for URL changes and resolve the initial route */
+    start(): () => void;
+    /** Navigate to a path */
+    go(path: string): Promise<void>;
+    /** Navigate without creating a history entry */
+    replace(path: string): Promise<void>;
+    /** Go back in history */
+    back(): void;
+    /** Go forward in history */
+    forward(): void;
+    /** Build an href for the current mode */
+    href(path: string): string;
+    /** Resolve the current URL against the route table and emit RouteChanged */
+    private _resolve;
+    /**
+     * Run guards for the target route.
+     *
+     * Checks named guards from @route({ guards: [...] }) first,
+     * then falls back to @guard methods on the component prototype.
+     * Resolves @inject params on guard methods from the DI container.
+     */
+    private _checkGuards;
+    /**
+     * Resolve @inject parameters for a method.
+     * Uses the same INJECT_PARAMS metadata as @factory.
+     */
+    private _resolveInjectParams;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/router/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,QAAQ,CAAC;AAMhE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAmD;gBAEvD,IAAI,GAAE,aAAkB;IAIpC,8CAA8C;IAC9C,IAAI,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAEjC;IAED,oEAAoE;IACpE,KAAK,IAAI,MAAM,IAAI;IAMnB,yBAAyB;IACnB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrC,gDAAgD;IAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1C,yBAAyB;IACzB,IAAI,IAAI,IAAI;IAIZ,4BAA4B;IAC5B,OAAO,IAAI,IAAI;IAIf,yCAAyC;IACzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1B,4EAA4E;IAC5E,OAAO,CAAC,QAAQ;IAchB;;;;;;OAMG;YACW,YAAY;IAwC1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;CAe7B"}

package/dist/router/router.js

@@ -0,0 +1,140 @@
+/**
+ * Loom Router — LoomRouter service
+ *
+ * Dual-mode (hash/history) router with named guard support.
+ * Register via app.use(new LoomRouter({ mode: "hash" }))
+ */
+import { bus } from "../bus";
+import { HashMode, HistoryMode } from "./mode";
+import { matchRoute, GUARD_HANDLERS, guardRegistry } from "./route";
+import { RouteChanged } from "./events";
+import { INJECT_PARAMS } from "../decorators/symbols";
+import { app } from "../app";
+export class LoomRouter {
+    mode;
+    _current = { path: "/", params: {}, tag: null };
+    constructor(opts = {}) {
+        this.mode = opts.mode === "history" ? new HistoryMode() : new HashMode();
+    }
+    /** Current route info (read-only snapshot) */
+    get current() {
+        return this._current;
+    }
+    /** Start listening for URL changes and resolve the initial route */
+    start() {
+        const cleanup = this.mode.listen(() => this._resolve());
+        this._resolve();
+        return cleanup;
+    }
+    /** Navigate to a path */
+    async go(path) {
+        const allowed = await this._checkGuards(path);
+        if (allowed === false)
+            return;
+        if (typeof allowed === "string") {
+            // Redirect
+            return this.go(allowed);
+        }
+        this.mode.write(path);
+        this._resolve();
+    }
+    /** Navigate without creating a history entry */
+    async replace(path) {
+        const allowed = await this._checkGuards(path);
+        if (allowed === false)
+            return;
+        if (typeof allowed === "string") {
+            return this.replace(allowed);
+        }
+        this.mode.replace(path);
+        this._resolve();
+    }
+    /** Go back in history */
+    back() {
+        history.back();
+    }
+    /** Go forward in history */
+    forward() {
+        history.forward();
+    }
+    /** Build an href for the current mode */
+    href(path) {
+        return this.mode.href(path);
+    }
+    /** Resolve the current URL against the route table and emit RouteChanged */
+    _resolve() {
+        const path = this.mode.read();
+        const match = matchRoute(path);
+        const previous = this._current.path;
+        this._current = {
+            path,
+            params: match?.params ?? {},
+            tag: match?.entry.tag ?? null,
+        };
+        bus.emit(new RouteChanged(path, this._current.params, previous));
+    }
+    /**
+     * Run guards for the target route.
+     *
+     * Checks named guards from @route({ guards: [...] }) first,
+     * then falls back to @guard methods on the component prototype.
+     * Resolves @inject params on guard methods from the DI container.
+     */
+    async _checkGuards(path) {
+        const match = matchRoute(path);
+        if (!match)
+            return true; // No route = no guards
+        // Collect guards to run: named guards from route entry + prototype guards
+        const namedGuards = match.entry.guards ?? [];
+        const protoGuards = match.entry.ctor.prototype?.[GUARD_HANDLERS] ?? [];
+        // No guards at all = allow
+        if (namedGuards.length === 0 && protoGuards.length === 0)
+            return true;
+        // 1. Run named guards from the global registry
+        for (const guardName of namedGuards) {
+            const reg = guardRegistry.get(guardName);
+            if (!reg) {
+                console.warn(`[LoomRouter] Guard "${guardName}" not found in registry`);
+                continue;
+            }
+            const args = this._resolveInjectParams(reg.proto, reg.key);
+            const result = await reg.proto[reg.key].apply(reg.proto, args);
+            if (result === false)
+                return false;
+            if (typeof result === "string")
+                return result;
+        }
+        // 2. Run legacy @guard methods on the component prototype
+        const proto = match.entry.ctor.prototype;
+        for (const key of protoGuards) {
+            // Skip if already run as a named guard
+            if (namedGuards.some((n) => guardRegistry.get(n)?.key === key))
+                continue;
+            const args = this._resolveInjectParams(proto, key);
+            const result = await proto[key].apply(proto, args);
+            if (result === false)
+                return false;
+            if (typeof result === "string")
+                return result;
+        }
+        return true;
+    }
+    /**
+     * Resolve @inject parameters for a method.
+     * Uses the same INJECT_PARAMS metadata as @factory.
+     */
+    _resolveInjectParams(proto, method) {
+        const injectMeta = proto[INJECT_PARAMS] ?? [];
+        const methodParams = injectMeta
+            .filter((m) => m.method === method)
+            .sort((a, b) => a.index - b.index);
+        if (methodParams.length === 0)
+            return [];
+        const args = [];
+        for (const param of methodParams) {
+            args[param.index] = app.get(param.key);
+        }
+        return args;
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router/router.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Loom — Storage Medium
+ *
+ * Pluggable persistence for Reactive<T> and CollectionStore<T>.
+ * Three built-in implementations: Memory (default), Local, Session.
+ * Implement StorageMedium for custom backends (IndexedDB, NATS KV, REST, etc).
+ */
+/** Sync read/write contract for a storage medium */
+export interface StorageMedium {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+/** Options bag for persistent Reactive/CollectionStore */
+export interface PersistOptions {
+    /** Storage key — must be unique across your app */
+    key: string;
+    /** Storage medium — defaults to MemoryStorage (no persistence) */
+    storage: StorageMedium;
+}
+/**
+ * In-memory storage. No persistence — values lost on page reload.
+ * This is the implicit default when no storage is configured.
+ */
+export declare class MemoryStorage implements StorageMedium {
+    private data;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+/**
+ * localStorage wrapper — survives page reloads and browser restarts.
+ *
+ * ```ts
+ * const count = new Reactive(0, { key: "app:count", storage: new LocalMedium() });
+ * ```
+ */
+export declare class LocalMedium implements StorageMedium {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+/**
+ * sessionStorage wrapper — survives page reloads but not browser restarts.
+ *
+ * ```ts
+ * const temp = new Reactive("", { key: "app:temp", storage: new SessionMedium() });
+ * ```
+ */
+export declare class SessionMedium implements StorageMedium {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+//# sourceMappingURL=storage.d.ts.map