smart-lifecycle 0.1.1

package/dist/components/smart-link/smart-link.lifecycle-manager.js

@@ -0,0 +1,53 @@
+/**
+ * Implements the responsibility of wiring navigation events for smart-link.
+ */
+import { SmartLifecycleManager } from '../../behaviors/lifecycle-manager.base.js';
+/**
+ * Lifecycle manager for smart-link component
+ */
+export class SmartLinkLifecycleManager extends SmartLifecycleManager {
+    hostResolver;
+    eventListeners = [];
+    /**
+     * Initializes a new instance of SmartLinkLifecycleManager.
+     *
+     * @param hostResolver - Resolver for obtaining host elements
+     * @throws Error if hostResolver is null or undefined
+     */
+    constructor(hostResolver) {
+        super();
+        this.hostResolver = hostResolver;
+        if (!hostResolver) {
+            throw new Error('Host resolver is required');
+        }
+    }
+    onComponentReady(component) {
+        const host = this.hostResolver.resolve(component);
+        const anchor = host.querySelector('a');
+        if (!anchor)
+            return;
+        // Get target route
+        const to = host.getAttribute('to') || '/';
+        // Configure anchor
+        anchor.href = to;
+        anchor.textContent = host.textContent || to;
+        // Prevent default navigation and use History API
+        const clickHandler = (e) => {
+            e.preventDefault();
+            // Change URL without reload
+            window.history.pushState({}, '', to);
+            // Dispatch event for router to listen
+            window.dispatchEvent(new PopStateEvent('popstate'));
+        };
+        anchor.addEventListener('click', clickHandler);
+        this.eventListeners.push({ target: anchor, event: 'click', handler: clickHandler });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    onComponentDestroy(_component) {
+        this.eventListeners.forEach(({ target, event, handler }) => {
+            target.removeEventListener(event, handler);
+        });
+        this.eventListeners = [];
+    }
+}
+//# sourceMappingURL=smart-link.lifecycle-manager.js.map

package/dist/components/smart-link/smart-link.lifecycle-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-link.lifecycle-manager.js","sourceRoot":"","sources":["../../../src/components/smart-link/smart-link.lifecycle-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAIlF;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,qBAAgC;IAShD;IARrB,cAAc,GAA+F,EAAE,CAAC;IAExH;;;;;OAKG;IACH,YAA6B,YAA2B;QACtD,KAAK,EAAE,CAAC;QADmB,iBAAY,GAAZ,YAAY,CAAe;QAEtD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAES,gBAAgB,CAAC,SAAoB;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAsB,CAAC;QAC5D,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,mBAAmB;QACnB,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;QAE1C,mBAAmB;QACnB,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACjB,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAE5C,iDAAiD;QACjD,MAAM,YAAY,GAAG,CAAC,CAAa,EAAE,EAAE;YACrC,CAAC,CAAC,cAAc,EAAE,CAAC;YAEnB,4BAA4B;YAC5B,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAErC,sCAAsC;YACtC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAA6B,EAAE,CAAC,CAAC;IACvG,CAAC;IAED,6DAA6D;IACnD,kBAAkB,CAAC,UAAqB;QAChD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;YACzD,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/components/smart-link.d.ts

@@ -0,0 +1,2 @@
+export { SmartLinkElement } from './smart-link/smart-link-element.js';
+//# sourceMappingURL=smart-link.d.ts.map

package/dist/components/smart-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-link.d.ts","sourceRoot":"","sources":["../../src/components/smart-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/components/smart-link.js

@@ -0,0 +1,2 @@
+export { SmartLinkElement } from './smart-link/smart-link-element.js';
+//# sourceMappingURL=smart-link.js.map

package/dist/components/smart-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-link.js","sourceRoot":"","sources":["../../src/components/smart-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/components/smart-router/navigation-service.interface.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Defines the responsibility of providing programmatic navigation for SPAs.
+ */
+export interface INavigationService {
+    /**
+     * Navigate to a route programmatically.
+     *
+     * @param path - Target pathname (e.g., '/users/123')
+     * @param options - Navigation options
+     * @param options.replace - When true, uses replaceState instead of pushState
+     */
+    navigate(path: string, options?: {
+        replace?: boolean;
+    }): void;
+    /**
+     * Returns the current browser pathname.
+     *
+     * @returns The current pathname string (e.g., '/users/123')
+     */
+    getCurrentPath(): string;
+}
+//# sourceMappingURL=navigation-service.interface.d.ts.map

package/dist/components/smart-router/navigation-service.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-service.interface.d.ts","sourceRoot":"","sources":["../../../src/components/smart-router/navigation-service.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAE9D;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC;CAC1B"}

package/dist/components/smart-router/navigation-service.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=navigation-service.interface.js.map

package/dist/components/smart-router/navigation-service.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-service.interface.js","sourceRoot":"","sources":["../../../src/components/smart-router/navigation-service.interface.ts"],"names":[],"mappings":""}

package/dist/components/smart-router/navigation.d.ts

@@ -0,0 +1,57 @@
+import type { INavigationService } from "./navigation-service.interface.js";
+/**
+ * Implements the responsibility of providing browser-based programmatic navigation.
+ *
+ * @description
+ * Uses the History API for pushState/replaceState navigation and dispatches
+ * a synthetic popstate event so `<smart-router>` picks up the change.
+ * No-op in non-browser environments (SSR safe).
+ */
+export declare class BrowserNavigationService implements INavigationService {
+    /**
+     * Navigate to a route programmatically.
+     *
+     * @param path - Target pathname (e.g., '/users/123')
+     * @param options - Navigation options
+     * @param options.replace - When true, uses replaceState instead of pushState
+     */
+    navigate(path: string, options?: {
+        replace?: boolean;
+    }): void;
+    /**
+     * Returns the current browser pathname.
+     *
+     * @returns The current pathname string, or '/' in non-browser environments
+     */
+    getCurrentPath(): string;
+}
+/**
+ * Convenience wrapper that delegates to the registered INavigationService.
+ * Allows framework users to call `navigate('/path')` without resolving the service manually.
+ *
+ * @param path - Target pathname
+ * @param options - Navigation options
+ *
+ * @example
+ * ```typescript
+ * import { navigate } from 'smartcomponents';
+ * navigate('/users/123');
+ * navigate('/home', { replace: true });
+ * ```
+ */
+export declare function navigate(path: string, options?: {
+    replace?: boolean;
+}): void;
+/**
+ * Convenience wrapper that delegates to the registered INavigationService.
+ *
+ * @returns The current pathname string
+ *
+ * @example
+ * ```typescript
+ * import { getCurrentPath } from 'smartcomponents';
+ * const path = getCurrentPath(); // e.g. '/users/123'
+ * ```
+ */
+export declare function getCurrentPath(): string;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/components/smart-router/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/components/smart-router/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAS5E;;;;;;;GAOG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAYjE;;;;OAIG;IACH,cAAc,IAAI,MAAM;CAIzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,IAAI,CAKN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC"}

package/dist/components/smart-router/navigation.js

@@ -0,0 +1,75 @@
+import { Services } from "../../providers/service-provider.js";
+/**
+ * SSR guard — ensures navigation helpers only execute in browser environments.
+ */
+const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+/**
+ * Implements the responsibility of providing browser-based programmatic navigation.
+ *
+ * @description
+ * Uses the History API for pushState/replaceState navigation and dispatches
+ * a synthetic popstate event so `<smart-router>` picks up the change.
+ * No-op in non-browser environments (SSR safe).
+ */
+export class BrowserNavigationService {
+    /**
+     * Navigate to a route programmatically.
+     *
+     * @param path - Target pathname (e.g., '/users/123')
+     * @param options - Navigation options
+     * @param options.replace - When true, uses replaceState instead of pushState
+     */
+    navigate(path, options = {}) {
+        if (!isBrowser)
+            return;
+        if (options.replace) {
+            window.history.replaceState({}, "", path);
+        }
+        else {
+            window.history.pushState({}, "", path);
+        }
+        window.dispatchEvent(new PopStateEvent("popstate"));
+    }
+    /**
+     * Returns the current browser pathname.
+     *
+     * @returns The current pathname string, or '/' in non-browser environments
+     */
+    getCurrentPath() {
+        if (!isBrowser)
+            return "/";
+        return window.location.pathname;
+    }
+}
+/**
+ * Convenience wrapper that delegates to the registered INavigationService.
+ * Allows framework users to call `navigate('/path')` without resolving the service manually.
+ *
+ * @param path - Target pathname
+ * @param options - Navigation options
+ *
+ * @example
+ * ```typescript
+ * import { navigate } from 'smartcomponents';
+ * navigate('/users/123');
+ * navigate('/home', { replace: true });
+ * ```
+ */
+export function navigate(path, options = {}) {
+    Services.get("INavigationService").navigate(path, options);
+}
+/**
+ * Convenience wrapper that delegates to the registered INavigationService.
+ *
+ * @returns The current pathname string
+ *
+ * @example
+ * ```typescript
+ * import { getCurrentPath } from 'smartcomponents';
+ * const path = getCurrentPath(); // e.g. '/users/123'
+ * ```
+ */
+export function getCurrentPath() {
+    return Services.get("INavigationService").getCurrentPath();
+}
+//# sourceMappingURL=navigation.js.map

package/dist/components/smart-router/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../../src/components/smart-router/navigation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAE/D;;GAEG;AACH,MAAM,SAAS,GACb,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,CAAC;AAEnE;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAwB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAY,EAAE,UAAiC,EAAE;QACxD,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,IAAI,CAAC,SAAS;YAAE,OAAO,GAAG,CAAC;QAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAClC,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,UAAiC,EAAE;IAEnC,QAAQ,CAAC,GAAG,CAAqB,oBAAoB,CAAC,CAAC,QAAQ,CAC7D,IAAI,EACJ,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,CAAC,GAAG,CACjB,oBAAoB,CACrB,CAAC,cAAc,EAAE,CAAC;AACrB,CAAC"}

package/dist/components/smart-router/smart-router-element.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Implements the responsibility of client-side URL routing from a lightweight custom element.
+ *
+ * @description
+ * Pure custom element that handles URL-based routing for SPAs using the History API.
+ * Collects `<template data-route="...">` children, listens for popstate events,
+ * and renders the matching route template into an outlet div.
+ * Does not use the SmartComponent rendering pipeline — no template compilation,
+ * no reactive bindings, no lifecycle manager.
+ *
+ * Supports exact routes, dynamic segments (/users/:id), and wildcard fallback (*).
+ *
+ * @example
+ * ```html
+ * <smart-router>
+ *   <template data-route="/">Home Page</template>
+ *   <template data-route="/about">About Us</template>
+ *   <template data-route="/users/:id">User Profile for :id</template>
+ *   <template data-route="*">404 Not Found</template>
+ * </smart-router>
+ * ```
+ */
+export declare class SmartRouterElement extends HTMLElement {
+    private routes;
+    private outlet;
+    private currentParams;
+    private currentTemplate;
+    private eventListeners;
+    /**
+     * Returns a copy of the current route parameters.
+     *
+     * @returns The current route parameters as key-value pairs
+     */
+    get routeParams(): Record<string, string>;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private renderRoute;
+    private escapeHtml;
+    private paramsEqual;
+    private matchRoute;
+}
+//# sourceMappingURL=smart-router-element.d.ts.map

package/dist/components/smart-router/smart-router-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-router-element.d.ts","sourceRoot":"","sources":["../../../src/components/smart-router/smart-router-element.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAwBH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,cAAc,CAId;IAER;;;;OAIG;IACH,IAAI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExC;IAED,iBAAiB,IAAI,IAAI;IAmCzB,oBAAoB,IAAI,IAAI;IAW5B,OAAO,CAAC,WAAW;IAyCnB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,UAAU;CAsEnB"}

package/dist/components/smart-router/smart-router-element.js

@@ -0,0 +1,188 @@
+/**
+ * Implements the responsibility of client-side URL routing from a lightweight custom element.
+ *
+ * @description
+ * Pure custom element that handles URL-based routing for SPAs using the History API.
+ * Collects `<template data-route="...">` children, listens for popstate events,
+ * and renders the matching route template into an outlet div.
+ * Does not use the SmartComponent rendering pipeline — no template compilation,
+ * no reactive bindings, no lifecycle manager.
+ *
+ * Supports exact routes, dynamic segments (/users/:id), and wildcard fallback (*).
+ *
+ * @example
+ * ```html
+ * <smart-router>
+ *   <template data-route="/">Home Page</template>
+ *   <template data-route="/about">About Us</template>
+ *   <template data-route="/users/:id">User Profile for :id</template>
+ *   <template data-route="*">404 Not Found</template>
+ * </smart-router>
+ * ```
+ */
+const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+const HTML_ESCAPE_PATTERN = /[&<>"']/g;
+const HTML_ESCAPE_MAP = {
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+};
+export class SmartRouterElement extends HTMLElement {
+    routes = [];
+    outlet = null;
+    currentParams = {};
+    currentTemplate = null;
+    eventListeners = [];
+    /**
+     * Returns a copy of the current route parameters.
+     *
+     * @returns The current route parameters as key-value pairs
+     */
+    get routeParams() {
+        return { ...this.currentParams };
+    }
+    connectedCallback() {
+        this.eventListeners = [];
+        if (!isBrowser) {
+            return;
+        }
+        this.style.display = "contents";
+        const templates = Array.from(this.children).filter((child) => child.tagName === "TEMPLATE" && child.hasAttribute("data-route"));
+        this.routes = templates.map((template) => ({
+            path: template.dataset.route || "/",
+            template,
+        }));
+        this.outlet = document.createElement("div");
+        this.outlet.className = "router-outlet";
+        this.appendChild(this.outlet);
+        const handlePopState = () => {
+            this.renderRoute();
+        };
+        window.addEventListener("popstate", handlePopState);
+        this.eventListeners.push({
+            target: window,
+            event: "popstate",
+            handler: handlePopState,
+        });
+        this.renderRoute();
+    }
+    disconnectedCallback() {
+        this.eventListeners.forEach(({ target, event, handler }) => {
+            target.removeEventListener(event, handler);
+        });
+        this.eventListeners = [];
+        this.routes = [];
+        this.outlet = null;
+        this.currentParams = {};
+        this.currentTemplate = null;
+    }
+    renderRoute() {
+        if (!this.outlet) {
+            return;
+        }
+        const path = window.location.pathname;
+        const match = this.matchRoute(path);
+        if (match) {
+            if (match.template === this.currentTemplate &&
+                this.paramsEqual(match.params, this.currentParams)) {
+                return;
+            }
+            this.outlet.innerHTML = "";
+            let processedHtml = match.template.innerHTML;
+            for (const [key, value] of Object.entries(match.params)) {
+                processedHtml = processedHtml.replace(new RegExp(`:${key}`, "g"), this.escapeHtml(value));
+            }
+            this.outlet.innerHTML = processedHtml;
+            this.currentTemplate = match.template;
+            this.currentParams = match.params;
+            this.dispatchEvent(new CustomEvent("route-change", {
+                bubbles: true,
+                detail: { path, params: match.params },
+            }));
+        }
+        else {
+            this.outlet.innerHTML = "<p>Route not found</p>";
+            this.currentTemplate = null;
+            this.currentParams = {};
+        }
+    }
+    escapeHtml(text) {
+        return text.replace(HTML_ESCAPE_PATTERN, (char) => HTML_ESCAPE_MAP[char]);
+    }
+    paramsEqual(a, b) {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length) {
+            return false;
+        }
+        for (const key of keysA) {
+            if (a[key] !== b[key]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    matchRoute(path) {
+        for (const route of this.routes) {
+            if (route.path === path) {
+                return { template: route.template, params: {} };
+            }
+            if (route.path === "*") {
+                continue;
+            }
+            const routeParts = route.path.split("/");
+            const pathParts = path.split("/");
+            const hasWildcardSuffix = routeParts[routeParts.length - 1] === "**";
+            if (hasWildcardSuffix) {
+                const prefixParts = routeParts.slice(0, -1);
+                if (pathParts.length < prefixParts.length) {
+                    continue;
+                }
+                const params = {};
+                let isMatch = true;
+                for (let i = 0; i < prefixParts.length; i++) {
+                    if (prefixParts[i].startsWith(":")) {
+                        if (!pathParts[i]) {
+                            isMatch = false;
+                            break;
+                        }
+                        params[prefixParts[i].slice(1)] = pathParts[i];
+                    }
+                    else if (prefixParts[i] !== pathParts[i]) {
+                        isMatch = false;
+                        break;
+                    }
+                }
+                if (isMatch) {
+                    return { template: route.template, params };
+                }
+                continue;
+            }
+            if (routeParts.length !== pathParts.length) {
+                continue;
+            }
+            const params = {};
+            let isMatch = true;
+            for (let i = 0; i < routeParts.length; i++) {
+                if (routeParts[i].startsWith(":")) {
+                    params[routeParts[i].slice(1)] = pathParts[i];
+                }
+                else if (routeParts[i] !== pathParts[i]) {
+                    isMatch = false;
+                    break;
+                }
+            }
+            if (isMatch) {
+                return { template: route.template, params };
+            }
+        }
+        const wildcard = this.routes.find((route) => route.path === "*");
+        if (wildcard) {
+            return { template: wildcard.template, params: {} };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=smart-router-element.js.map

package/dist/components/smart-router/smart-router-element.js.map

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

package/dist/components/smart-router/smart-router.component.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SmartRouter - Client-side router component
+ *
+ * @description
+ * Handles URL-based routing for SPAs using the History API.
+ * Listens for popstate events and renders matching routes.
+ * Works with smart-link for navigation.
+ *
+ * @example
+ * ```html
+ * <smart-router>
+ *   <template data-route="/">Home Page</template>
+ *   <template data-route="/about">About Us</template>
+ *   <template data-route="/users/:id">User Profile</template>
+ *   <template data-route="*">404 Not Found</template>
+ * </smart-router>
+ *
+ * <nav>
+ *   <smart-link to="/">Home</smart-link>
+ *   <smart-link to="/about">About</smart-link>
+ * </nav>
+ * ```
+ */
+import { SmartComponent } from '../../core/smart-component.js';
+export declare class SmartRouter extends SmartComponent {
+}
+//# sourceMappingURL=smart-router.component.d.ts.map

package/dist/components/smart-router/smart-router.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-router.component.d.ts","sourceRoot":"","sources":["../../../src/components/smart-router/smart-router.component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAI/D,qBAUa,WAAY,SAAQ,cAAc;CAAG"}

package/dist/components/smart-router/smart-router.component.js

@@ -0,0 +1,89 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+/**
+ * SmartRouter - Client-side router component
+ *
+ * @description
+ * Handles URL-based routing for SPAs using the History API.
+ * Listens for popstate events and renders matching routes.
+ * Works with smart-link for navigation.
+ *
+ * @example
+ * ```html
+ * <smart-router>
+ *   <template data-route="/">Home Page</template>
+ *   <template data-route="/about">About Us</template>
+ *   <template data-route="/users/:id">User Profile</template>
+ *   <template data-route="*">404 Not Found</template>
+ * </smart-router>
+ *
+ * <nav>
+ *   <smart-link to="/">Home</smart-link>
+ *   <smart-link to="/about">About</smart-link>
+ * </nav>
+ * ```
+ */
+import { SmartComponent } from '../../core/smart-component.js';
+import { SmartRender } from '../../decorators/smart-render.decorator.js';
+import { SmartRouterLifecycleManager } from './smart-router.lifecycle-manager.js';
+let SmartRouter = (() => {
+    let _classDecorators = [SmartRender({
+            selector: 'smart-router',
+            template: `
+    <div class="smart-router-wrapper" style="display: contents">
+      <div class="router-outlet"></div>
+      <smart-host style="display:none"></smart-host>
+    </div>
+  `,
+            lifecycle: SmartRouterLifecycleManager
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = SmartComponent;
+    var SmartRouter = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            SmartRouter = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return SmartRouter = _classThis;
+})();
+export { SmartRouter };
+//# sourceMappingURL=smart-router.component.js.map

package/dist/components/smart-router/smart-router.component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-router.component.js","sourceRoot":"","sources":["../../../src/components/smart-router/smart-router.component.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;IAYrE,WAAW;4BAVvB,WAAW,CAAC;YACX,QAAQ,EAAE,cAAc;YACxB,QAAQ,EAAE;;;;;GAKT;YACD,SAAS,EAAE,2BAA2B;SACvC,CAAC;;;;sBAC+B,cAAc;2BAAtB,SAAQ,WAAc;;;;YAA/C,6KAAkD;;;YAArC,uDAAW;;;;;SAAX,WAAW"}

package/dist/components/smart-router/smart-router.lifecycle-manager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Implements the responsibility of wiring routing logic for smart-router.
+ */
+import { SmartLifecycleManager } from '../../behaviors/lifecycle-manager.base.js';
+import type { IHostResolver } from '../../rendering/host-resolver/host-resolver.interface.js';
+import type { SmartRouter } from './smart-router.component.js';
+/**
+ * Lifecycle manager for smart-router component
+ */
+export declare class SmartRouterLifecycleManager extends SmartLifecycleManager<SmartRouter> {
+    private readonly hostResolver;
+    private routes;
+    private eventListeners;
+    /**
+     * Initializes a new instance of SmartRouterLifecycleManager.
+     *
+     * @param hostResolver - Resolver for obtaining host elements
+     * @throws Error if hostResolver is null or undefined
+     */
+    constructor(hostResolver: IHostResolver);
+    protected onComponentReady(component: SmartRouter): void;
+    protected onComponentDestroy(): void;
+    private matchRoute;
+}
+//# sourceMappingURL=smart-router.lifecycle-manager.d.ts.map

package/dist/components/smart-router/smart-router.lifecycle-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-router.lifecycle-manager.d.ts","sourceRoot":"","sources":["../../../src/components/smart-router/smart-router.lifecycle-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0DAA0D,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAe/D;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,qBAAqB,CAAC,WAAW,CAAC;IAUrE,OAAO,CAAC,QAAQ,CAAC,YAAY;IATzC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,cAAc,CAAkG;IAExH;;;;;OAKG;gBAC0B,YAAY,EAAE,aAAa;IAOxD,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IAkDxD,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAOpC,OAAO,CAAC,UAAU;CA4CnB"}