@praxisjs/router 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# @praxisjs/router
+
+## 0.1.0
+
+### Minor Changes
+
+- aaf7dab: Initial beta release
+
+### Patch Changes
+
+- Updated dependencies [aaf7dab]
+  - @praxisjs/core@0.1.0
+  - @praxisjs/jsx@0.1.0
+  - @praxisjs/shared@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/components/index.d.ts

@@ -0,0 +1,3 @@
+export { Link } from "./link";
+export { RouterView } from "./router-view";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,3 @@
+export { Link } from "./link";
+export { RouterView } from "./router-view";
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/components/link.d.ts

@@ -0,0 +1,11 @@
+import type { Children, VNode } from "@praxisjs/shared";
+interface LinkProps {
+    to: string;
+    replace?: boolean;
+    class?: string;
+    activeClass?: string;
+    children?: Children | Children[];
+}
+export declare function Link({ to, replace, class: cls, activeClass, children, }: LinkProps): VNode;
+export {};
+//# sourceMappingURL=link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/components/link.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAIxD,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;CAClC;AAED,wBAAgB,IAAI,CAAC,EACnB,EAAE,EACF,OAAe,EACf,KAAK,EAAE,GAAQ,EACf,WAAsB,EACtB,QAAQ,GACT,EAAE,SAAS,GAAG,KAAK,CAyBnB"}

package/dist/components/link.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "@praxisjs/jsx/jsx-runtime";
+import { computed } from "@praxisjs/core";
+import { useRouter } from "../router";
+export function Link({ to, replace = false, class: cls = "", activeClass = "active", children, }) {
+    const router = useRouter();
+    const isActive = computed(() => router.location().path === to);
+    const handleClick = (e) => {
+        e.preventDefault();
+        if (replace) {
+            void router.replace(to);
+        }
+        else {
+            void router.push(to);
+        }
+    };
+    return (_jsx("a", { href: to, class: () => [cls, isActive() ? activeClass : ""].filter(Boolean).join(" "), onClick: handleClick, children: children }));
+}
+//# sourceMappingURL=link.js.map

package/dist/components/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/components/link.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAUtC,MAAM,UAAU,IAAI,CAAC,EACnB,EAAE,EACF,OAAO,GAAG,KAAK,EACf,KAAK,EAAE,GAAG,GAAG,EAAE,EACf,WAAW,GAAG,QAAQ,EACtB,QAAQ,GACE;IACV,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IAE/D,MAAM,WAAW,GAAG,CAAC,CAAa,EAAE,EAAE;QACpC,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CACL,YACE,IAAI,EAAE,EAAE,EACR,KAAK,EAAE,GAAG,EAAE,CACV,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAEhE,OAAO,EAAE,WAAW,YAEnB,QAAQ,GACP,CACL,CAAC;AACJ,CAAC"}

package/dist/components/router-view.d.ts

@@ -0,0 +1,3 @@
+import type { VNode } from "@praxisjs/shared";
+export declare function RouterView(): VNode;
+//# sourceMappingURL=router-view.d.ts.map

package/dist/components/router-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-view.d.ts","sourceRoot":"","sources":["../../src/components/router-view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,wBAAgB,UAAU,IAAI,KAAK,CAWlC"}

package/dist/components/router-view.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "@praxisjs/jsx/jsx-runtime";
+import { useRouter } from "../router";
+export function RouterView() {
+    const router = useRouter();
+    return (_jsx("div", { "data-router-view": "true", children: () => {
+            const Component = router.currentComponent();
+            return Component ? _jsx(Component, {}) : null;
+        } }));
+}
+//# sourceMappingURL=router-view.js.map

package/dist/components/router-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-view.js","sourceRoot":"","sources":["../../src/components/router-view.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,OAAO,CACL,kCAAsB,MAAM,YACzB,GAAG,EAAE;YACJ,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC,CAAC,CAAC,KAAC,SAAS,KAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1C,CAAC,GACG,CACP,CAAC;AACJ,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,2 @@
+export declare function Route(path: string): <T extends new (...args: any[]) => any>(constructor: T) => T;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,IAEf,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,aAAa,CAAC,KAAG,CAAC,CAQ3E"}

package/dist/decorators.js

@@ -0,0 +1,12 @@
+export function Route(path) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return function (constructor) {
+        Object.defineProperty(constructor, "__routePath", {
+            value: path,
+            writable: false,
+            configurable: false,
+        });
+        return constructor;
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,8DAA8D;IAC9D,OAAO,UAAiD,WAAc;QACpE,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,aAAa,EAAE;YAChD,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createRouter, lazy, useRouter, useParams, useQuery, useLocation, Router, } from "./router";
+export type { RouteDefinition, RouteLocation, RouteParams, RouteQuery, RouteComponent, LazyRouteComponent, } from "./types/route";
+export { RouterView, Link } from "./components";
+export { Route } from "./decorators";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACV,cAAc,EACd,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createRouter, lazy, useRouter, useParams, useQuery, useLocation, Router, } from "./router";
+export { RouterView, Link } from "./components";
+export { Route } from "./decorators";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,MAAM,GACP,MAAM,UAAU,CAAC;AAUlB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,37 @@
+import type { Signal, Computed } from "@praxisjs/shared";
+import type { LazyRouteComponent, RouteComponent, RouteDefinition, RouteLocation, RouteParams, RouteQuery } from "./types/route";
+export declare class Router {
+    private readonly compiled;
+    private readonly _location;
+    private _prevLocation;
+    private readonly _component;
+    private readonly _loading;
+    private readonly _resolvedComponents;
+    readonly location: Signal<RouteLocation>;
+    readonly currentComponent: Signal<RouteComponent | null>;
+    readonly loading: Signal<boolean>;
+    readonly params: Computed<RouteParams>;
+    readonly query: Computed<RouteQuery>;
+    constructor(routes: RouteDefinition[]);
+    private addRoute;
+    private buildLocation;
+    private matchParams;
+    private isLazy;
+    private resolveComponent;
+    private resolveAndSetComponent;
+    private syncFromBrowser;
+    push(path: string, query?: RouteQuery, hash?: string): Promise<void>;
+    replace(path: string, query?: RouteQuery): Promise<void>;
+    back(): void;
+    forward(): void;
+    go(delta: number): void;
+}
+export declare function lazy(loader: () => Promise<{
+    default: new (...args: any[]) => any;
+}>): LazyRouteComponent;
+export declare function createRouter(routes: RouteDefinition[]): Router;
+export declare function useRouter(): Router;
+export declare function useParams(): Computed<RouteParams>;
+export declare function useQuery(): Computed<RouteQuery>;
+export declare function useLocation(): Signal<RouteLocation>;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIzD,OAAO,KAAK,EAEV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,aAAa,EACb,WAAW,EACX,UAAU,EACX,MAAM,eAAe,CAAC;AAEvB,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGhC;IAEJ,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAEzB,MAAM,EAAE,eAAe,EAAE;IA4BrC,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,MAAM;YAMA,gBAAgB;YAuBhB,sBAAsB;YAKtB,eAAe;IAUvB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBpE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D,IAAI,IAAI,IAAI;IAGZ,OAAO,IAAI,IAAI;IAIf,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGxB;AAKD,wBAAgB,IAAI,CAElB,MAAM,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;CAAE,CAAC,GAC9D,kBAAkB,CAEpB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAG9D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,wBAAgB,SAAS,IAAI,QAAQ,CAAC,WAAW,CAAC,CAEjD;AAED,wBAAgB,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,CAE/C;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,aAAa,CAAC,CAEnD"}

package/dist/router.js

@@ -0,0 +1,152 @@
+import { computed, signal } from "@praxisjs/core";
+import { compilePath, parseQuery } from "./utils";
+export class Router {
+    constructor(routes) {
+        this.compiled = [];
+        this._prevLocation = null;
+        this._resolvedComponents = new Map();
+        for (const route of routes) {
+            this.addRoute(route);
+        }
+        const initial = this.buildLocation(window.location.pathname, window.location.search, window.location.hash);
+        this._location = signal(initial);
+        this._loading = signal(false);
+        this._component = signal(null);
+        this.location = this._location;
+        this.currentComponent = this._component;
+        this.loading = this._loading;
+        this.params = computed(() => this._location().params);
+        this.query = computed(() => this._location().query);
+        void this.resolveAndSetComponent(initial.path);
+        window.addEventListener("popstate", () => {
+            void this.syncFromBrowser();
+        });
+    }
+    addRoute(route, prefix = "") {
+        const fullPath = prefix + route.path;
+        const { regex, paramNames } = compilePath(fullPath);
+        this.compiled.push({ definition: route, regex, paramNames });
+        if (route.children) {
+            for (const child of route.children) {
+                this.addRoute(child, fullPath === "/" ? "" : fullPath);
+            }
+        }
+    }
+    buildLocation(pathname, search, hash) {
+        const params = this.matchParams(pathname);
+        return {
+            path: pathname,
+            params,
+            query: parseQuery(search),
+            hash: hash.replace("#", ""),
+        };
+    }
+    matchParams(path) {
+        for (const route of this.compiled) {
+            const match = route.regex.exec(path);
+            if (!match)
+                continue;
+            const params = {};
+            route.paramNames.forEach((name, i) => {
+                params[name] = match[i + 1] ?? "";
+            });
+            return params;
+        }
+        return {};
+    }
+    isLazy(c) {
+        return "__isLazy" in c && (c).__isLazy;
+    }
+    async resolveComponent(path) {
+        for (const route of this.compiled) {
+            if (!route.regex.test(path))
+                continue;
+            const { component } = route.definition;
+            if (!this.isLazy(component))
+                return component;
+            const cached = this._resolvedComponents.get(component);
+            if (cached)
+                return cached;
+            this._loading.set(true);
+            try {
+                const mod = await component();
+                this._resolvedComponents.set(component, mod.default);
+                return mod.default;
+            }
+            finally {
+                this._loading.set(false);
+            }
+        }
+        return null;
+    }
+    async resolveAndSetComponent(path) {
+        const component = await this.resolveComponent(path);
+        this._component.set(component);
+    }
+    async syncFromBrowser() {
+        const loc = this.buildLocation(window.location.pathname, window.location.search, window.location.hash);
+        this._location.set(loc);
+        await this.resolveAndSetComponent(loc.path);
+    }
+    async push(path, query, hash) {
+        const search = query ? "?" + new URLSearchParams(query).toString() : "";
+        const hashStr = hash ? `#${hash}` : "";
+        const fullUrl = path + search + hashStr;
+        const loc = this.buildLocation(path, search, hashStr);
+        const matched = this.compiled.find((r) => r.regex.test(path));
+        if (matched?.definition.beforeEnter) {
+            const result = await matched.definition.beforeEnter(loc, this._prevLocation);
+            if (result === false)
+                return;
+            if (typeof result === "string") {
+                return this.push(result);
+            }
+        }
+        this._prevLocation = this._location();
+        window.history.pushState(null, "", fullUrl);
+        this._location.set(loc);
+        await this.resolveAndSetComponent(path);
+    }
+    async replace(path, query) {
+        const search = query ? "?" + new URLSearchParams(query).toString() : "";
+        const loc = this.buildLocation(path, search, "");
+        this._prevLocation = this._location();
+        window.history.replaceState(null, "", path + search);
+        this._location.set(loc);
+        await this.resolveAndSetComponent(path);
+    }
+    back() {
+        window.history.back();
+    }
+    forward() {
+        window.history.forward();
+    }
+    go(delta) {
+        window.history.go(delta);
+    }
+}
+let _router = null;
+export function lazy(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+loader) {
+    return Object.assign(() => loader(), { __isLazy: true });
+}
+export function createRouter(routes) {
+    _router = new Router(routes);
+    return _router;
+}
+export function useRouter() {
+    if (!_router)
+        throw new Error("[Router] createRouter() was not called.");
+    return _router;
+}
+export function useParams() {
+    return useRouter().params;
+}
+export function useQuery() {
+    return useRouter().query;
+}
+export function useLocation() {
+    return useRouter().location;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/types/route.d.ts

@@ -0,0 +1,27 @@
+export type RouteParams = Record<string, string>;
+export type RouteQuery = Record<string, string>;
+export interface RouteLocation {
+    path: string;
+    params: RouteParams;
+    query: RouteQuery;
+    hash: string;
+}
+export type RouteComponent = (new (...args: any[]) => any) | ((...args: any[]) => any);
+export interface LazyRouteComponent {
+    (): Promise<{
+        default: new (...args: any[]) => any;
+    }>;
+    readonly __isLazy: true;
+}
+export interface RouteDefinition {
+    path: string;
+    component: RouteComponent | LazyRouteComponent;
+    children?: RouteDefinition[];
+    beforeEnter?: (to: RouteLocation, from: RouteLocation | null) => boolean | string | Promise<boolean | string>;
+}
+export interface CompiledRoute {
+    definition: RouteDefinition;
+    regex: RegExp;
+    paramNames: string[];
+}
+//# sourceMappingURL=route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/types/route.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GAEtB,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAE7B,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IAEjC,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;KAAE,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,cAAc,GAAG,kBAAkB,CAAC;IAC/C,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,CACZ,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,aAAa,GAAG,IAAI,KACvB,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/dist/types/route.js

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

package/dist/types/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/types/route.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+import type { RouteQuery } from "./types/route";
+export declare function compilePath(path: string): {
+    regex: RegExp;
+    paramNames: string[];
+};
+export declare function parseQuery(search: string): RouteQuery;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAgBA;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAUrD"}

package/dist/utils.js

@@ -0,0 +1,26 @@
+export function compilePath(path) {
+    const paramNames = [];
+    // /users/:id/posts/:postId → /users/([^/]+)/posts/([^/]+)
+    // /docs/**                 → /docs/(.*)
+    const regexStr = path
+        .replace(/\*\*/g, "(.*)")
+        .replace(/:([^/]+)/g, (_, name) => {
+        paramNames.push(name);
+        return "([^/]+)";
+    });
+    return {
+        regex: new RegExp(`^${regexStr}$`),
+        paramNames,
+    };
+}
+export function parseQuery(search) {
+    const query = {};
+    if (!search || search === "?")
+        return query;
+    const params = new URLSearchParams(search.startsWith("?") ? search.slice(1) : search);
+    params.forEach((value, key) => {
+        query[key] = value;
+    });
+    return query;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,IAAY;IAItC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,0DAA0D;IAC1D,wCAAwC;IACxC,MAAM,QAAQ,GAAG,IAAI;SAClB,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;SACxB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAS,EAAE,IAAY,EAAE,EAAE;QAChD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,KAAK,EAAE,IAAI,MAAM,CAAC,IAAI,QAAQ,GAAG,CAAC;QAClC,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,eAAe,CAChC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAClD,CAAC;IACF,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@praxisjs/router",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@praxisjs/core": "0.1.0",
+    "@praxisjs/jsx": "0.1.0",
+    "@praxisjs/shared": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/src/components/index.ts

@@ -0,0 +1,2 @@
+export { Link } from "./link";
+export { RouterView } from "./router-view";

package/src/components/link.tsx

@@ -0,0 +1,45 @@
+import { computed } from "@praxisjs/core";
+import type { Children, VNode } from "@praxisjs/shared";
+
+import { useRouter } from "../router";
+
+interface LinkProps {
+  to: string;
+  replace?: boolean;
+  class?: string;
+  activeClass?: string;
+  children?: Children | Children[];
+}
+
+export function Link({
+  to,
+  replace = false,
+  class: cls = "",
+  activeClass = "active",
+  children,
+}: LinkProps): VNode {
+  const router = useRouter();
+
+  const isActive = computed(() => router.location().path === to);
+
+  const handleClick = (e: MouseEvent) => {
+    e.preventDefault();
+    if (replace) {
+      void router.replace(to);
+    } else {
+      void router.push(to);
+    }
+  };
+
+  return (
+    <a
+      href={to}
+      class={() =>
+        [cls, isActive() ? activeClass : ""].filter(Boolean).join(" ")
+      }
+      onClick={handleClick}
+    >
+      {children}
+    </a>
+  );
+}

package/src/components/router-view.tsx

@@ -0,0 +1,16 @@
+import type { VNode } from "@praxisjs/shared";
+
+import { useRouter } from "../router";
+
+export function RouterView(): VNode {
+  const router = useRouter();
+
+  return (
+    <div data-router-view="true">
+      {() => {
+        const Component = router.currentComponent();
+        return Component ? <Component /> : null;
+      }}
+    </div>
+  );
+}

package/src/decorators.ts

@@ -0,0 +1,11 @@
+export function Route(path: string) {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  return function <T extends new (...args: any[]) => any>(constructor: T): T {
+    Object.defineProperty(constructor, "__routePath", {
+      value: path,
+      writable: false,
+      configurable: false,
+    });
+    return constructor;
+  };
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+export {
+  createRouter,
+  lazy,
+  useRouter,
+  useParams,
+  useQuery,
+  useLocation,
+  Router,
+} from "./router";
+export type {
+  RouteDefinition,
+  RouteLocation,
+  RouteParams,
+  RouteQuery,
+  RouteComponent,
+  LazyRouteComponent,
+} from "./types/route";
+
+export { RouterView, Link } from "./components";
+export { Route } from "./decorators";

package/src/router.ts

@@ -0,0 +1,221 @@
+import { computed, signal } from "@praxisjs/core";
+import type { Signal, Computed } from "@praxisjs/shared";
+
+import { compilePath, parseQuery } from "./utils";
+
+import type {
+  CompiledRoute,
+  LazyRouteComponent,
+  RouteComponent,
+  RouteDefinition,
+  RouteLocation,
+  RouteParams,
+  RouteQuery,
+} from "./types/route";
+
+export class Router {
+  private readonly compiled: CompiledRoute[] = [];
+  private readonly _location: Signal<RouteLocation>;
+  private _prevLocation: RouteLocation | null = null;
+  private readonly _component: Signal<RouteComponent | null>;
+  private readonly _loading: Signal<boolean>;
+  private readonly _resolvedComponents = new Map<
+    LazyRouteComponent,
+    RouteComponent
+  >();
+
+  readonly location: Signal<RouteLocation>;
+  readonly currentComponent: Signal<RouteComponent | null>;
+  readonly loading: Signal<boolean>;
+  readonly params: Computed<RouteParams>;
+  readonly query: Computed<RouteQuery>;
+
+  constructor(routes: RouteDefinition[]) {
+    for (const route of routes) {
+      this.addRoute(route);
+    }
+
+    const initial = this.buildLocation(
+      window.location.pathname,
+      window.location.search,
+      window.location.hash,
+    );
+    this._location = signal<RouteLocation>(initial);
+    this._loading = signal<boolean>(false);
+    this._component = signal<RouteComponent | null>(null);
+
+    this.location = this._location;
+    this.currentComponent = this._component;
+    this.loading = this._loading;
+
+    this.params = computed(() => this._location().params);
+    this.query = computed(() => this._location().query);
+
+    void this.resolveAndSetComponent(initial.path);
+
+    window.addEventListener("popstate", () => {
+      void this.syncFromBrowser();
+    });
+  }
+
+  private addRoute(route: RouteDefinition, prefix = ""): void {
+    const fullPath = prefix + route.path;
+    const { regex, paramNames } = compilePath(fullPath);
+    this.compiled.push({ definition: route, regex, paramNames });
+
+    if (route.children) {
+      for (const child of route.children) {
+        this.addRoute(child, fullPath === "/" ? "" : fullPath);
+      }
+    }
+  }
+
+  private buildLocation(
+    pathname: string,
+    search: string,
+    hash: string,
+  ): RouteLocation {
+    const params = this.matchParams(pathname);
+    return {
+      path: pathname,
+      params,
+      query: parseQuery(search),
+      hash: hash.replace("#", ""),
+    };
+  }
+
+  private matchParams(path: string): RouteParams {
+    for (const route of this.compiled) {
+      const match = route.regex.exec(path);
+      if (!match) continue;
+      const params: RouteParams = {};
+      route.paramNames.forEach((name, i) => {
+        params[name] = match[i + 1] ?? "";
+      });
+      return params;
+    }
+    return {};
+  }
+
+  private isLazy(
+    c: RouteComponent | LazyRouteComponent,
+  ): c is LazyRouteComponent {
+    return "__isLazy" in c && (c).__isLazy;
+  }
+
+  private async resolveComponent(
+    path: string,
+  ): Promise<RouteComponent | null> {
+    for (const route of this.compiled) {
+      if (!route.regex.test(path)) continue;
+      const { component } = route.definition;
+      if (!this.isLazy(component)) return component;
+
+      const cached = this._resolvedComponents.get(component);
+      if (cached) return cached;
+
+      this._loading.set(true);
+      try {
+        const mod = await component();
+        this._resolvedComponents.set(component, mod.default);
+        return mod.default;
+      } finally {
+        this._loading.set(false);
+      }
+    }
+    return null;
+  }
+
+  private async resolveAndSetComponent(path: string): Promise<void> {
+    const component = await this.resolveComponent(path);
+    this._component.set(component);
+  }
+
+  private async syncFromBrowser(): Promise<void> {
+    const loc = this.buildLocation(
+      window.location.pathname,
+      window.location.search,
+      window.location.hash,
+    );
+    this._location.set(loc);
+    await this.resolveAndSetComponent(loc.path);
+  }
+
+  async push(path: string, query?: RouteQuery, hash?: string): Promise<void> {
+    const search = query ? "?" + new URLSearchParams(query).toString() : "";
+    const hashStr = hash ? `#${hash}` : "";
+    const fullUrl = path + search + hashStr;
+
+    const loc = this.buildLocation(path, search, hashStr);
+
+    const matched = this.compiled.find((r) => r.regex.test(path));
+    if (matched?.definition.beforeEnter) {
+      const result = await matched.definition.beforeEnter(
+        loc,
+        this._prevLocation,
+      );
+      if (result === false) return;
+      if (typeof result === "string") {
+        return this.push(result);
+      }
+    }
+
+    this._prevLocation = this._location();
+    window.history.pushState(null, "", fullUrl);
+    this._location.set(loc);
+    await this.resolveAndSetComponent(path);
+  }
+
+  async replace(path: string, query?: RouteQuery): Promise<void> {
+    const search = query ? "?" + new URLSearchParams(query).toString() : "";
+    const loc = this.buildLocation(path, search, "");
+
+    this._prevLocation = this._location();
+    window.history.replaceState(null, "", path + search);
+    this._location.set(loc);
+    await this.resolveAndSetComponent(path);
+  }
+
+  back(): void {
+    window.history.back();
+  }
+  forward(): void {
+    window.history.forward();
+  }
+
+  go(delta: number): void {
+    window.history.go(delta);
+  }
+}
+
+let _router: Router | null = null;
+
+
+export function lazy(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  loader: () => Promise<{ default: new (...args: any[]) => any }>,
+): LazyRouteComponent {
+  return Object.assign(() => loader(), { __isLazy: true as const });
+}
+
+export function createRouter(routes: RouteDefinition[]): Router {
+  _router = new Router(routes);
+  return _router;
+}
+
+export function useRouter(): Router {
+  if (!_router) throw new Error("[Router] createRouter() was not called.");
+  return _router;
+}
+
+export function useParams(): Computed<RouteParams> {
+  return useRouter().params;
+}
+
+export function useQuery(): Computed<RouteQuery> {
+  return useRouter().query;
+}
+
+export function useLocation(): Signal<RouteLocation> {
+  return useRouter().location;
+}

package/src/types/route.ts

@@ -0,0 +1,37 @@
+export type RouteParams = Record<string, string>;
+export type RouteQuery = Record<string, string>;
+
+export interface RouteLocation {
+  path: string;
+  params: RouteParams;
+  query: RouteQuery;
+  hash: string;
+}
+
+export type RouteComponent =
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | (new (...args: any[]) => any) // class component
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  | ((...args: any[]) => any); // function component
+
+export interface LazyRouteComponent {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  (): Promise<{ default: new (...args: any[]) => any }>;
+  readonly __isLazy: true;
+}
+
+export interface RouteDefinition {
+  path: string;
+  component: RouteComponent | LazyRouteComponent;
+  children?: RouteDefinition[];
+  beforeEnter?: (
+    to: RouteLocation,
+    from: RouteLocation | null,
+  ) => boolean | string | Promise<boolean | string>;
+}
+
+export interface CompiledRoute {
+  definition: RouteDefinition;
+  regex: RegExp;
+  paramNames: string[];
+}

package/src/utils.ts

@@ -0,0 +1,34 @@
+import type { RouteQuery } from "./types/route";
+
+export function compilePath(path: string): {
+  regex: RegExp;
+  paramNames: string[];
+} {
+  const paramNames: string[] = [];
+
+  // /users/:id/posts/:postId → /users/([^/]+)/posts/([^/]+)
+  // /docs/**                 → /docs/(.*)
+  const regexStr = path
+    .replace(/\*\*/g, "(.*)")
+    .replace(/:([^/]+)/g, (_: string, name: string) => {
+      paramNames.push(name);
+      return "([^/]+)";
+    });
+
+  return {
+    regex: new RegExp(`^${regexStr}$`),
+    paramNames,
+  };
+}
+
+export function parseQuery(search: string): RouteQuery {
+  const query: RouteQuery = {};
+  if (!search || search === "?") return query;
+  const params = new URLSearchParams(
+    search.startsWith("?") ? search.slice(1) : search,
+  );
+  params.forEach((value, key) => {
+    query[key] = value;
+  });
+  return query;
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declarationDir": "./dist"
+  },
+  "include": ["src"]
+}