alabjs 0.1.0

package/dist/router/code-router.js

@@ -0,0 +1,258 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Alab Code-Based Router — type-safe client-side navigation.
+ *
+ * The file-system router stays the default (zero config). This module is
+ * opt-in for large apps that need IDE searchability, typed `href` props,
+ * search param schemas, and co-located loaders.
+ *
+ * Inspired by TanStack Router.
+ *
+ * @example
+ * ```ts
+ * // routes.ts
+ * import { createRoute, createRouter } from "alabjs/router";
+ * import { z } from "zod";
+ * import UserPage from "./app/users/[id]/page.js";
+ * import UserError from "./app/users/[id]/error.js";
+ *
+ * export const userRoute = createRoute({
+ *   path: "/users/$id",
+ *   search: z.object({ tab: z.enum(["posts", "about"]).optional() }),
+ *   loader: ({ params }) => getUser(params.id),
+ *   component: UserPage,
+ *   errorComponent: UserError,
+ * });
+ *
+ * export const router = createRouter([userRoute]);
+ * ```
+ *
+ * ```tsx
+ * // app/layout.tsx
+ * import { RouterProvider } from "alabjs/router";
+ * import { router } from "../routes.js";
+ *
+ * export default function RootLayout({ children }) {
+ *   return <RouterProvider router={router}>{children}</RouterProvider>;
+ * }
+ * ```
+ */
+import { createContext, useContext, useState, useEffect, useCallback, } from "react";
+/**
+ * Define a type-safe route.
+ *
+ * @example
+ * ```ts
+ * export const postRoute = createRoute({
+ *   path: "/posts/$id",
+ *   loader: ({ params }) => fetchPost(params.id),
+ *   component: PostPage,
+ * });
+ * ```
+ */
+export function createRoute(config) {
+    const paramNames = [];
+    const regexStr = config.path
+        .split("/")
+        .map((seg) => {
+        if (seg.startsWith("$")) {
+            paramNames.push(seg.slice(1));
+            return "([^/]+)";
+        }
+        return seg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    })
+        .join("/");
+    const regex = config.path === "/" ? /^\/$/ : new RegExp(`^${regexStr}\\/?$`);
+    return { ...config, _regex: regex, _paramNames: paramNames };
+}
+/** Assemble multiple routes into a router instance. */
+export function createRouter(routes) {
+    // Sort: static routes before dynamic ones (fewer params = higher priority).
+    const sorted = [...routes].sort((a, b) => a._paramNames.length - b._paramNames.length);
+    return { routes: sorted };
+}
+const RouterCtx = createContext(null);
+function useRouterCtx() {
+    const ctx = useContext(RouterCtx);
+    if (!ctx)
+        throw new Error("[alabjs] useParams / useSearch / navigate must be used inside <RouterProvider>");
+    return ctx;
+}
+// ─── Route matching ───────────────────────────────────────────────────────────
+function matchRoute(routes, pathname) {
+    for (const route of routes) {
+        const match = route._regex.exec(pathname);
+        if (match) {
+            const params = {};
+            route._paramNames.forEach((name, i) => {
+                params[name] = decodeURIComponent(match[i + 1] ?? "");
+            });
+            return { route, params };
+        }
+    }
+    return null;
+}
+function parseSearch(searchStr, schema) {
+    const raw = Object.fromEntries(new URLSearchParams(searchStr).entries());
+    if (!schema)
+        return raw;
+    const result = schema.safeParse(raw);
+    return result.success ? result.data : raw;
+}
+/**
+ * Wrap your root layout with `RouterProvider` to enable typed navigation.
+ *
+ * @example
+ * ```tsx
+ * import { RouterProvider } from "alabjs/router";
+ * import { router } from "../routes.js";
+ *
+ * export default function RootLayout({ children }) {
+ *   return <RouterProvider router={router}>{children}</RouterProvider>;
+ * }
+ * ```
+ */
+export function RouterProvider({ router, children }) {
+    const buildState = useCallback(async (pathname, search) => {
+        const matched = matchRoute(router.routes, pathname);
+        if (!matched) {
+            return {
+                pathname, search,
+                params: {},
+                searchParsed: parseSearch(search),
+                loaderData: undefined,
+                matchedRoute: null,
+            };
+        }
+        const { route, params } = matched;
+        const searchParsed = parseSearch(search, route.search);
+        let loaderData = undefined;
+        if (route.loader) {
+            loaderData = await route.loader({
+                params: params,
+                search: searchParsed,
+            });
+        }
+        return { pathname, search, params, searchParsed, loaderData, matchedRoute: route };
+    }, [router]);
+    const [state, setState] = useState({
+        pathname: typeof window !== "undefined" ? window.location.pathname : "/",
+        search: typeof window !== "undefined" ? window.location.search : "",
+        params: {},
+        searchParsed: {},
+        loaderData: undefined,
+        matchedRoute: null,
+    });
+    // Run loader for initial route.
+    useEffect(() => {
+        void buildState(window.location.pathname, window.location.search).then(setState);
+    }, [buildState]);
+    // Intercept Alab's SPA navigate events.
+    useEffect(() => {
+        const handler = () => {
+            void buildState(window.location.pathname, window.location.search).then(setState);
+        };
+        window.addEventListener("popstate", handler);
+        return () => window.removeEventListener("popstate", handler);
+    }, [buildState]);
+    const navigate = useCallback((href) => {
+        if (typeof window !== "undefined" && "__alabjs_navigate" in window) {
+            window.__alabjs_navigate(href);
+        }
+        else {
+            window.location.href = href;
+        }
+        void buildState(href.split("?")[0] ?? href, href.includes("?") ? href.split("?")[1] ?? "" : "").then(setState);
+    }, [buildState]);
+    return (_jsx(RouterCtx.Provider, { value: { ...state, navigate }, children: children }));
+}
+// ─── Hooks ────────────────────────────────────────────────────────────────────
+/**
+ * Access typed path params for a specific route.
+ *
+ * @example
+ * ```tsx
+ * const params = useParams(userRoute);
+ * params.id; // string ✅
+ * params.foo; // TS error ✅
+ * ```
+ */
+export function useParams(_route) {
+    return useRouterCtx().params;
+}
+/**
+ * Access typed, schema-validated search params for a specific route.
+ *
+ * @example
+ * ```tsx
+ * const search = useSearch(postRoute);
+ * search.tab; // "posts" | "about" | undefined ✅
+ * ```
+ */
+export function useSearch(_route) {
+    return useRouterCtx().searchParsed;
+}
+/**
+ * Access the data returned by the route's `loader` function.
+ *
+ * @example
+ * ```tsx
+ * const user = useLoaderData(userRoute);
+ * user.name; // typed from loader return ✅
+ * ```
+ */
+export function useLoaderData(_route) {
+    return useRouterCtx().loaderData;
+}
+/**
+ * Returns a typed `navigate` function.
+ *
+ * @example
+ * ```tsx
+ * const nav = useNavigate();
+ * nav("/users/42");
+ * nav("/users/42?tab=posts");
+ * ```
+ */
+export function useNavigate() {
+    return useRouterCtx().navigate;
+}
+/**
+ * A type-safe `<Link>` bound to a route descriptor.
+ * Compile-time error if required params are missing or wrong type.
+ *
+ * @example
+ * ```tsx
+ * <RouteLink to={userRoute} params={{ id: "42" }}>
+ *   View user
+ * </RouteLink>
+ * ```
+ */
+export function RouteLink({ to, params, search, children, onClick, ...rest }) {
+    const { navigate } = useRouterCtx();
+    // Build href from route path + params + search.
+    const href = buildHref(to.path, params, search);
+    const handleClick = (e) => {
+        onClick?.(e);
+        if (e.defaultPrevented)
+            return;
+        if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey)
+            return;
+        e.preventDefault();
+        navigate(href);
+    };
+    return (_jsx("a", { href: href, onClick: handleClick, ...rest, children: children }));
+}
+function buildHref(path, params, search) {
+    let resolved = path;
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            resolved = resolved.replace(`$${k}`, encodeURIComponent(v));
+        }
+    }
+    if (search && Object.keys(search).length > 0) {
+        resolved += "?" + new URLSearchParams(Object.fromEntries(Object.entries(search).map(([k, v]) => [k, String(v)]))).toString();
+    }
+    return resolved;
+}
+//# sourceMappingURL=code-router.js.map

package/dist/router/code-router.js.map

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

package/dist/router/code-router.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-router.test.d.ts.map

package/dist/router/code-router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-router.test.d.ts","sourceRoot":"","sources":["../../src/router/code-router.test.ts"],"names":[],"mappings":""}

package/dist/router/code-router.test.js

@@ -0,0 +1,128 @@
+import { describe, it, expect } from "vitest";
+import { createRoute, createRouter } from "./code-router.js";
+// ─── createRoute ──────────────────────────────────────────────────────────────
+describe("createRoute", () => {
+    it("creates a route descriptor with regex and param names", () => {
+        const route = createRoute({
+            path: "/users/$id",
+            component: () => null,
+        });
+        expect(route._regex).toBeInstanceOf(RegExp);
+        expect(route._paramNames).toEqual(["id"]);
+    });
+    it("matches static paths", () => {
+        const route = createRoute({
+            path: "/about",
+            component: () => null,
+        });
+        expect(route._regex.test("/about")).toBe(true);
+        expect(route._regex.test("/about/")).toBe(true);
+        expect(route._regex.test("/other")).toBe(false);
+    });
+    it("matches dynamic segments", () => {
+        const route = createRoute({
+            path: "/users/$id",
+            component: () => null,
+        });
+        expect(route._regex.test("/users/42")).toBe(true);
+        expect(route._regex.test("/users/abc")).toBe(true);
+        expect(route._regex.test("/users")).toBe(false);
+        expect(route._regex.test("/users/42/extra")).toBe(false);
+    });
+    it("extracts multiple params", () => {
+        const route = createRoute({
+            path: "/posts/$slug/comments/$commentId",
+            component: () => null,
+        });
+        expect(route._paramNames).toEqual(["slug", "commentId"]);
+        const match = route._regex.exec("/posts/hello-world/comments/99");
+        expect(match).not.toBe(null);
+        expect(match[1]).toBe("hello-world");
+        expect(match[2]).toBe("99");
+    });
+    it("matches root path", () => {
+        const route = createRoute({
+            path: "/",
+            component: () => null,
+        });
+        expect(route._regex.test("/")).toBe(true);
+        expect(route._regex.test("/other")).toBe(false);
+        expect(route._paramNames).toEqual([]);
+    });
+    it("escapes special regex characters in static segments", () => {
+        const route = createRoute({
+            path: "/search.html",
+            component: () => null,
+        });
+        expect(route._regex.test("/search.html")).toBe(true);
+        expect(route._regex.test("/searchXhtml")).toBe(false);
+    });
+    it("preserves config properties", () => {
+        const component = () => null;
+        const loader = async () => ({ data: true });
+        const route = createRoute({
+            path: "/test",
+            component,
+            loader,
+        });
+        expect(route.component).toBe(component);
+        expect(route.loader).toBe(loader);
+        expect(route.path).toBe("/test");
+    });
+});
+// ─── createRouter ─────────────────────────────────────────────────────────────
+describe("createRouter", () => {
+    it("returns a router with sorted routes", () => {
+        const staticRoute = createRoute({ path: "/users/new", component: () => null });
+        const dynamicRoute = createRoute({ path: "/users/$id", component: () => null });
+        const router = createRouter([dynamicRoute, staticRoute]);
+        // Static route (0 params) should come first
+        expect(router.routes[0]._paramNames).toHaveLength(0);
+        expect(router.routes[1]._paramNames).toHaveLength(1);
+    });
+    it("handles empty routes array", () => {
+        const router = createRouter([]);
+        expect(router.routes).toEqual([]);
+    });
+    it("preserves routes with equal param counts", () => {
+        const a = createRoute({ path: "/users/$id", component: () => null });
+        const b = createRoute({ path: "/posts/$slug", component: () => null });
+        const router = createRouter([a, b]);
+        expect(router.routes).toHaveLength(2);
+    });
+});
+// ─── Route matching via regex ─────────────────────────────────────────────────
+describe("route matching", () => {
+    it("dynamic route captures params correctly", () => {
+        const route = createRoute({
+            path: "/users/$id",
+            component: () => null,
+        });
+        const match = route._regex.exec("/users/42");
+        expect(match).not.toBe(null);
+        const params = {};
+        route._paramNames.forEach((name, i) => {
+            params[name] = decodeURIComponent(match[i + 1]);
+        });
+        expect(params).toEqual({ id: "42" });
+    });
+    it("handles encoded URI components in params", () => {
+        const route = createRoute({
+            path: "/posts/$slug",
+            component: () => null,
+        });
+        const match = route._regex.exec("/posts/hello%20world");
+        expect(match).not.toBe(null);
+        expect(decodeURIComponent(match[1])).toBe("hello world");
+    });
+    it("multiple dynamic routes in router — first match wins", () => {
+        const staticRoute = createRoute({ path: "/users/admin", component: () => null });
+        const dynamicRoute = createRoute({ path: "/users/$id", component: () => null });
+        const router = createRouter([dynamicRoute, staticRoute]);
+        // Static should be first in sorted order (0 params)
+        const first = router.routes[0];
+        expect(first._regex.test("/users/admin")).toBe(true);
+        expect(first._paramNames).toHaveLength(0);
+    });
+});
+//# sourceMappingURL=code-router.test.js.map

package/dist/router/code-router.test.js.map

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

package/dist/router/index.d.ts

@@ -0,0 +1,4 @@
+export type { Route, RouteKind, RouteManifest } from "./manifest.js";
+export { createRoute, createRouter, RouterProvider, RouteLink, useParams, useSearch, useLoaderData, useNavigate, } from "./code-router.js";
+export type { RouteDescriptor, RouteConfig, RouteParams, Router, RouterProviderProps, } from "./code-router.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,MAAM,EACN,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1,2 @@
+export { createRoute, createRouter, RouterProvider, RouteLink, useParams, useSearch, useLoaderData, useNavigate, } from "./code-router.js";
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/router/manifest.d.ts

@@ -0,0 +1,12 @@
+export type RouteKind = "page" | "server" | "layout" | "error" | "loading" | "api";
+export interface Route {
+    path: string;
+    file: string;
+    kind: RouteKind;
+    ssr: boolean;
+    params: string[];
+}
+export interface RouteManifest {
+    routes: Route[];
+}
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/router/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;AAEnF,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB"}

package/dist/router/manifest.js

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

package/dist/router/manifest.js.map

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

package/dist/server/app.d.ts

@@ -0,0 +1,13 @@
+import type { RouteManifest } from "../router/manifest.js";
+export interface AlabApp {
+    listen(port?: number): void;
+}
+/**
+ * Create and return an Alab HTTP application backed by H3.
+ *
+ * In production (`alab start`), this is the entry point.
+ * In development, Vite's dev server wraps the SSR logic directly via the
+ * dev command middleware — this function is not used in dev.
+ */
+export declare function createApp(manifest: RouteManifest, distDir: string): AlabApp;
+//# sourceMappingURL=app.d.ts.map

package/dist/server/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAwD3D,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAyY3E"}