alabjs 0.1.0

package/dist/i18n/index.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Alab i18n — locale routing with zero runtime overhead.
+ *
+ * Locale is detected once per request (from URL prefix → cookie → Accept-Language)
+ * and injected into a React context. Pages are served at `/:locale/path`.
+ *
+ * @example
+ * ```ts
+ * // i18n.ts (project root)
+ * import { createI18nConfig } from "alabjs/i18n";
+ *
+ * export const i18n = createI18nConfig({
+ *   locales: ["en", "fil", "es"],
+ *   defaultLocale: "en",
+ * });
+ * ```
+ *
+ * ```ts
+ * // middleware.ts — redirect bare paths to locale prefix
+ * import { i18n } from "./i18n.js";
+ * import { redirect } from "alabjs/middleware";
+ *
+ * export async function middleware(req: Request) {
+ *   const locale = i18n.detectLocale(req);
+ *   const { pathname } = new URL(req.url);
+ *
+ *   // Already has a locale prefix — pass through
+ *   if (i18n.hasLocalePrefix(pathname)) return;
+ *
+ *   // Redirect /about → /en/about
+ *   return redirect(`/${locale}${pathname}`);
+ * }
+ * ```
+ *
+ * ```tsx
+ * // app/[locale]/layout.tsx
+ * import { LocaleProvider } from "alabjs/i18n";
+ *
+ * export default function LocaleLayout({ params, children }) {
+ *   return <LocaleProvider locale={params.locale}>{children}</LocaleProvider>;
+ * }
+ * ```
+ */
+import { type ReactNode } from "react";
+export interface I18nConfig {
+    /** All supported locale codes, e.g. `["en", "fil", "es"]`. */
+    locales: string[];
+    /** Locale used when no match is found. Must be in `locales`. */
+    defaultLocale: string;
+}
+export interface I18nInstance extends I18nConfig {
+    /**
+     * Detect the best locale for an incoming request.
+     *
+     * Priority order:
+     * 1. URL pathname prefix (`/en/`, `/fil/`)
+     * 2. `locale` cookie
+     * 3. `Accept-Language` header (first matching locale)
+     * 4. `defaultLocale`
+     */
+    detectLocale(req: Request): string;
+    /** Return true if the pathname already starts with a supported locale prefix. */
+    hasLocalePrefix(pathname: string): boolean;
+    /**
+     * Strip the locale prefix from a pathname.
+     * `/en/about` → `/about`, `/about` → `/about`
+     */
+    stripLocale(pathname: string): string;
+    /**
+     * Build a locale-prefixed path.
+     * `localePath("fil", "/about")` → `/fil/about`
+     */
+    localePath(locale: string, path: string): string;
+}
+/**
+ * Create an i18n configuration instance.
+ *
+ * @example
+ * ```ts
+ * export const i18n = createI18nConfig({ locales: ["en", "fil"], defaultLocale: "en" });
+ * ```
+ */
+export declare function createI18nConfig(config: I18nConfig): I18nInstance;
+export interface LocaleProviderProps {
+    locale: string;
+    children: ReactNode;
+}
+/**
+ * Provide the current locale to all child components.
+ * Place this in your `app/[locale]/layout.tsx`.
+ *
+ * @example
+ * ```tsx
+ * export default function LocaleLayout({ params, children }) {
+ *   return <LocaleProvider locale={params.locale}>{children}</LocaleProvider>;
+ * }
+ * ```
+ */
+export declare function LocaleProvider({ locale, children }: LocaleProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Read the current locale from context.
+ * Must be used inside a `<LocaleProvider>`.
+ *
+ * @example
+ * ```tsx
+ * const locale = useLocale(); // "en" | "fil" | "es"
+ * ```
+ */
+export declare function useLocale(): string;
+import type { AnchorHTMLAttributes } from "react";
+export interface LocaleLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    href: string;
+    /**
+     * Override the locale for this link. Defaults to the current locale from context.
+     * Pass `false` to emit the href with no locale prefix.
+     */
+    locale?: string | false;
+}
+/**
+ * A `<Link>`-compatible anchor that automatically prefixes the `href` with
+ * the current (or specified) locale.
+ *
+ * @example
+ * ```tsx
+ * // Current locale is "en"
+ * <LocaleLink href="/about">About</LocaleLink>
+ * // renders: <a href="/en/about">About</a>
+ *
+ * // Switch to Filipino
+ * <LocaleLink href="/about" locale="fil">Filipino</LocaleLink>
+ * // renders: <a href="/fil/about">Filipino</a>
+ * ```
+ */
+export declare function LocaleLink({ href, locale, children, onClick, ...rest }: LocaleLinkProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlE,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C;;;;;;;;OAQG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,iFAAiF;IACjF,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAClD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAgDjE;AAMD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,2CAEvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAID,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,WAAW,eAAgB,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,eAAe,2CAmBvF"}

package/dist/i18n/index.js

@@ -0,0 +1,189 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Alab i18n — locale routing with zero runtime overhead.
+ *
+ * Locale is detected once per request (from URL prefix → cookie → Accept-Language)
+ * and injected into a React context. Pages are served at `/:locale/path`.
+ *
+ * @example
+ * ```ts
+ * // i18n.ts (project root)
+ * import { createI18nConfig } from "alabjs/i18n";
+ *
+ * export const i18n = createI18nConfig({
+ *   locales: ["en", "fil", "es"],
+ *   defaultLocale: "en",
+ * });
+ * ```
+ *
+ * ```ts
+ * // middleware.ts — redirect bare paths to locale prefix
+ * import { i18n } from "./i18n.js";
+ * import { redirect } from "alabjs/middleware";
+ *
+ * export async function middleware(req: Request) {
+ *   const locale = i18n.detectLocale(req);
+ *   const { pathname } = new URL(req.url);
+ *
+ *   // Already has a locale prefix — pass through
+ *   if (i18n.hasLocalePrefix(pathname)) return;
+ *
+ *   // Redirect /about → /en/about
+ *   return redirect(`/${locale}${pathname}`);
+ * }
+ * ```
+ *
+ * ```tsx
+ * // app/[locale]/layout.tsx
+ * import { LocaleProvider } from "alabjs/i18n";
+ *
+ * export default function LocaleLayout({ params, children }) {
+ *   return <LocaleProvider locale={params.locale}>{children}</LocaleProvider>;
+ * }
+ * ```
+ */
+import { createContext, useContext } from "react";
+/**
+ * Create an i18n configuration instance.
+ *
+ * @example
+ * ```ts
+ * export const i18n = createI18nConfig({ locales: ["en", "fil"], defaultLocale: "en" });
+ * ```
+ */
+export function createI18nConfig(config) {
+    const { locales, defaultLocale } = config;
+    if (!locales.includes(defaultLocale)) {
+        throw new Error(`[alabjs/i18n] defaultLocale "${defaultLocale}" must be in the locales array`);
+    }
+    const localeSet = new Set(locales);
+    function detectLocale(req) {
+        const url = new URL(req.url);
+        // 1. URL prefix
+        const firstSegment = url.pathname.split("/")[1] ?? "";
+        if (localeSet.has(firstSegment))
+            return firstSegment;
+        // 2. Cookie
+        const cookieHeader = req.headers.get("cookie") ?? "";
+        const localeCookie = parseCookieLocale(cookieHeader, locales);
+        if (localeCookie)
+            return localeCookie;
+        // 3. Accept-Language
+        const acceptLang = req.headers.get("accept-language") ?? "";
+        const detected = parseAcceptLanguage(acceptLang, locales);
+        if (detected)
+            return detected;
+        return defaultLocale;
+    }
+    function hasLocalePrefix(pathname) {
+        const first = pathname.split("/")[1] ?? "";
+        return localeSet.has(first);
+    }
+    function stripLocale(pathname) {
+        const first = pathname.split("/")[1] ?? "";
+        if (localeSet.has(first)) {
+            return pathname.slice(first.length + 1) || "/";
+        }
+        return pathname;
+    }
+    function localePath(locale, path) {
+        const clean = path.startsWith("/") ? path : `/${path}`;
+        return `/${locale}${clean}`;
+    }
+    return { locales, defaultLocale, detectLocale, hasLocalePrefix, stripLocale, localePath };
+}
+// ─── React context ────────────────────────────────────────────────────────────
+const LocaleCtx = createContext("en");
+/**
+ * Provide the current locale to all child components.
+ * Place this in your `app/[locale]/layout.tsx`.
+ *
+ * @example
+ * ```tsx
+ * export default function LocaleLayout({ params, children }) {
+ *   return <LocaleProvider locale={params.locale}>{children}</LocaleProvider>;
+ * }
+ * ```
+ */
+export function LocaleProvider({ locale, children }) {
+    return _jsx(LocaleCtx.Provider, { value: locale, children: children });
+}
+/**
+ * Read the current locale from context.
+ * Must be used inside a `<LocaleProvider>`.
+ *
+ * @example
+ * ```tsx
+ * const locale = useLocale(); // "en" | "fil" | "es"
+ * ```
+ */
+export function useLocale() {
+    return useContext(LocaleCtx);
+}
+/**
+ * A `<Link>`-compatible anchor that automatically prefixes the `href` with
+ * the current (or specified) locale.
+ *
+ * @example
+ * ```tsx
+ * // Current locale is "en"
+ * <LocaleLink href="/about">About</LocaleLink>
+ * // renders: <a href="/en/about">About</a>
+ *
+ * // Switch to Filipino
+ * <LocaleLink href="/about" locale="fil">Filipino</LocaleLink>
+ * // renders: <a href="/fil/about">Filipino</a>
+ * ```
+ */
+export function LocaleLink({ href, locale, children, onClick, ...rest }) {
+    const currentLocale = useLocale();
+    const targetLocale = locale === false ? null : (locale ?? currentLocale);
+    const resolvedHref = targetLocale ? `/${targetLocale}${href.startsWith("/") ? href : `/${href}`}` : href;
+    const handleClick = (e) => {
+        onClick?.(e);
+        if (e.defaultPrevented)
+            return;
+        if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey)
+            return;
+        e.preventDefault();
+        if (typeof window !== "undefined" && "__alabjs_navigate" in window) {
+            window.__alabjs_navigate(resolvedHref);
+        }
+        else {
+            window.location.href = resolvedHref;
+        }
+    };
+    return _jsx("a", { href: resolvedHref, onClick: handleClick, ...rest, children: children });
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function parseCookieLocale(cookieHeader, locales) {
+    for (const part of cookieHeader.split(";")) {
+        const [key, val] = part.trim().split("=");
+        if (key?.trim() === "locale" && val && locales.includes(val.trim())) {
+            return val.trim();
+        }
+    }
+    return null;
+}
+function parseAcceptLanguage(header, locales) {
+    // Parse "en-US,en;q=0.9,fil;q=0.8" → [["en-US", 1], ["en", 0.9], ["fil", 0.8]]
+    const entries = header
+        .split(",")
+        .map((part) => {
+        const [lang, q] = part.trim().split(";q=");
+        return { lang: lang?.trim() ?? "", q: parseFloat(q ?? "1") };
+    })
+        .sort((a, b) => b.q - a.q);
+    for (const { lang } of entries) {
+        // Exact match first (e.g. "fil")
+        if (locales.includes(lang))
+            return lang;
+        // Language-only match (e.g. "en" matches "en-US")
+        const base = lang.split("-")[0] ?? "";
+        const match = locales.find((l) => l === base || l.startsWith(base + "-"));
+        if (match)
+            return match;
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAoClE;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAE1C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,gCAAgC,aAAa,gCAAgC,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAEnC,SAAS,YAAY,CAAC,GAAY;QAChC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE7B,gBAAgB;QAChB,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,OAAO,YAAY,CAAC;QAErD,YAAY;QACZ,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,YAAY,GAAG,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,YAAY;YAAE,OAAO,YAAY,CAAC;QAEtC,qBAAqB;QACrB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,SAAS,eAAe,CAAC,QAAgB;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,WAAW,CAAC,QAAgB;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;QACjD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,SAAS,UAAU,CAAC,MAAc,EAAE,IAAY;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QACvD,OAAO,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAC5F,CAAC;AAED,iFAAiF;AAEjF,MAAM,SAAS,GAAG,aAAa,CAAS,IAAI,CAAC,CAAC;AAO9C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAuB;IACtE,OAAO,KAAC,SAAS,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,YAAG,QAAQ,GAAsB,CAAC;AAC5E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC;AAC/B,CAAC;AAeD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,EAAmB;IACtF,MAAM,aAAa,GAAG,SAAS,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC;IAEzE,MAAM,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzG,MAAM,WAAW,GAA+C,CAAC,CAAC,EAAE,EAAE;QACpE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACb,IAAI,CAAC,CAAC,gBAAgB;YAAE,OAAO;QAC/B,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO;QAC7D,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,mBAAmB,IAAI,MAAM,EAAE,CAAC;YAClE,MAAqD,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,YAAY,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,YAAG,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,KAAM,IAAI,YAAG,QAAQ,GAAK,CAAC;AAC/E,CAAC;AAED,iFAAiF;AAEjF,SAAS,iBAAiB,CAAC,YAAoB,EAAE,OAAiB;IAChE,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,QAAQ,IAAI,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACpE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc,EAAE,OAAiB;IAC5D,+EAA+E;IAC/E,MAAM,OAAO,GAAG,MAAM;SACnB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;IAC/D,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;QAC/B,iCAAiC;QACjC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,kDAAkD;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;QAC1E,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { defineServerFn } from "./server/index.js";
+export type { ServerFn, ServerFnContext, AlabPage, PageMetadata, GenerateMetadata, RouteParams, } from "./types/index.js";
+export { createApp } from "./server/app.js";
+//# 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,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EACV,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { defineServerFn } from "./server/index.js";
+export { createApp } from "./server/app.js";
+//# 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,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,204 @@
+/**
+ * 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 { type ComponentType, type ReactNode } from "react";
+/** Extract `$param` names from a path string. */
+type ExtractRouteParams<Path extends string> = Path extends `${string}$${infer Param}/${infer Rest}` ? Param | ExtractRouteParams<`/${Rest}`> : Path extends `${string}$${infer Param}` ? Param : never;
+/** Typed record of path params for a route. */
+export type RouteParams<Path extends string> = [
+    ExtractRouteParams<Path>
+] extends [never] ? Record<string, never> : {
+    readonly [K in ExtractRouteParams<Path>]: string;
+};
+interface SchemaLike<T> {
+    parse(input: unknown): T;
+    safeParse(input: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}
+type InferSchema<S> = S extends SchemaLike<infer T> ? T : Record<string, string>;
+export interface RouteConfig<Path extends string, Search extends SchemaLike<unknown> | undefined, LoaderData> {
+    /** URL path using `$param` syntax: `"/users/$id"`, `"/posts/$slug/edit"`. */
+    path: Path;
+    /**
+     * Zod (or any schema) that validates + parses search params.
+     * Parsed value is available via `useSearch(route)`.
+     */
+    search?: Search;
+    /**
+     * Runs before the component mounts — blocks render until resolved.
+     * Data is available via `useLoaderData(route)`.
+     */
+    loader?: (ctx: {
+        params: RouteParams<Path>;
+        search: Search extends SchemaLike<unknown> ? InferSchema<Search> : Record<string, string>;
+    }) => Promise<LoaderData>;
+    /** The page component for this route. */
+    component: ComponentType<{
+        params: RouteParams<Path>;
+        search: Search extends SchemaLike<unknown> ? InferSchema<Search> : Record<string, string>;
+        loaderData: LoaderData;
+    }>;
+    /**
+     * Rendered when the loader throws or component throws during render.
+     * Equivalent to `error.tsx` in the file-system router.
+     */
+    errorComponent?: ComponentType<{
+        error: Error;
+        reset: () => void;
+    }>;
+    /**
+     * Rendered while the loader is running.
+     * Equivalent to `loading.tsx` in the file-system router.
+     */
+    pendingComponent?: ComponentType;
+}
+export interface RouteDescriptor<Path extends string = string, Search extends SchemaLike<unknown> | undefined = undefined, LoaderData = undefined> extends RouteConfig<Path, Search, LoaderData> {
+    /** @internal Compiled regex for matching this route's path. */
+    _regex: RegExp;
+    /** @internal Ordered param names extracted from the path. */
+    _paramNames: string[];
+}
+/**
+ * Define a type-safe route.
+ *
+ * @example
+ * ```ts
+ * export const postRoute = createRoute({
+ *   path: "/posts/$id",
+ *   loader: ({ params }) => fetchPost(params.id),
+ *   component: PostPage,
+ * });
+ * ```
+ */
+export declare function createRoute<Path extends string, Search extends SchemaLike<unknown> | undefined = undefined, LoaderData = undefined>(config: RouteConfig<Path, Search, LoaderData>): RouteDescriptor<Path, Search, LoaderData>;
+export interface Router {
+    routes: RouteDescriptor[];
+}
+/** Assemble multiple routes into a router instance. */
+export declare function createRouter(routes: RouteDescriptor[]): Router;
+export interface RouterProviderProps {
+    router: Router;
+    children?: ReactNode;
+}
+/**
+ * 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 declare function RouterProvider({ router, children }: RouterProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Access typed path params for a specific route.
+ *
+ * @example
+ * ```tsx
+ * const params = useParams(userRoute);
+ * params.id; // string ✅
+ * params.foo; // TS error ✅
+ * ```
+ */
+export declare function useParams<Path extends string, S extends SchemaLike<unknown> | undefined, L>(_route: RouteDescriptor<Path, S, L>): RouteParams<Path>;
+/**
+ * Access typed, schema-validated search params for a specific route.
+ *
+ * @example
+ * ```tsx
+ * const search = useSearch(postRoute);
+ * search.tab; // "posts" | "about" | undefined ✅
+ * ```
+ */
+export declare function useSearch<Path extends string, S extends SchemaLike<unknown> | undefined, L>(_route: RouteDescriptor<Path, S, L>): S extends SchemaLike<unknown> ? InferSchema<S> : Record<string, string>;
+/**
+ * Access the data returned by the route's `loader` function.
+ *
+ * @example
+ * ```tsx
+ * const user = useLoaderData(userRoute);
+ * user.name; // typed from loader return ✅
+ * ```
+ */
+export declare function useLoaderData<Path extends string, S extends SchemaLike<unknown> | undefined, L>(_route: RouteDescriptor<Path, S, L>): L;
+/**
+ * Returns a typed `navigate` function.
+ *
+ * @example
+ * ```tsx
+ * const nav = useNavigate();
+ * nav("/users/42");
+ * nav("/users/42?tab=posts");
+ * ```
+ */
+export declare function useNavigate(): (href: string) => void;
+type LinkToRoute<Path extends string, S extends SchemaLike<unknown> | undefined, L> = {
+    /** Destination route descriptor (replaces `href`). */
+    to: RouteDescriptor<Path, S, L>;
+    /** Path params — required when the route has dynamic segments. */
+    params?: RouteParams<Path>;
+    /** Search params to append. */
+    search?: S extends SchemaLike<infer T> ? Partial<T & Record<string, string>> : Record<string, string>;
+    children?: ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    onClick?: React.MouseEventHandler<HTMLAnchorElement>;
+};
+/**
+ * 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 declare function RouteLink<Path extends string, S extends SchemaLike<unknown> | undefined, L>({ to, params, search, children, onClick, ...rest }: LinkToRoute<Path, S, L>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=code-router.d.ts.map

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

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