@limlabs/rex 0.0.1-test.1 → 0.3.0

package/dist/document.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+interface HtmlProps extends React.HTMLAttributes<HTMLHtmlElement> {
+    children?: React.ReactNode;
+}
+interface HeadProps {
+    children?: React.ReactNode;
+}
+export declare function Html({ children, ...props }: HtmlProps): React.ReactElement;
+export declare function Head({ children }: HeadProps): React.ReactElement;
+export declare function Main(): React.ReactElement;
+export declare function NextScript(): null;
+export default function Document(): React.ReactElement;
+export {};
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,SAAU,SAAQ,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;IAC/D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,SAAS,GAAG,KAAK,CAAC,YAAY,CAE1E;AAED,wBAAgB,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,KAAK,CAAC,YAAY,CAEhE;AAED,wBAAgB,IAAI,IAAI,KAAK,CAAC,YAAY,CAEzC;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,MAAM,CAAC,OAAO,UAAU,QAAQ,IAAI,KAAK,CAAC,YAAY,CAYrD"}

package/dist/document.js

@@ -0,0 +1,17 @@
+import React from 'react';
+export function Html({ children, ...props }) {
+    return React.createElement('html', props, children);
+}
+export function Head({ children }) {
+    return React.createElement('head', null, children);
+}
+export function Main() {
+    return React.createElement('div', { id: '__rex' });
+}
+export function NextScript() {
+    return null;
+}
+export default function Document() {
+    return React.createElement(Html, null, React.createElement(Head, null), React.createElement('body', null, React.createElement(Main, null), React.createElement(NextScript, null)));
+}
+//# sourceMappingURL=document.js.map

package/dist/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAU1B,MAAM,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAa;IACpD,OAAO,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAa;IAC1C,OAAO,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,QAAQ;IAC9B,OAAO,KAAK,CAAC,aAAa,CACxB,IAAI,EACJ,IAAI,EACJ,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAC/B,KAAK,CAAC,aAAa,CACjB,MAAM,EACN,IAAI,EACJ,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,EAC/B,KAAK,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CACtC,CACF,CAAC;AACJ,CAAC"}

package/dist/image.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface ImageProps {
+    src: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+    quality?: number;
+    priority?: boolean;
+    className?: string;
+}
+export default function Image(props: ImageProps): React.ReactElement;
+export {};
+//# sourceMappingURL=image.d.ts.map

package/dist/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../src/image.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAAC,YAAY,CAgBnE"}

package/dist/image.js

@@ -0,0 +1,22 @@
+import React from 'react';
+function buildSrc(src, w, q) {
+    return '/_rex/image?url=' + encodeURIComponent(src) + '&w=' + w + '&q=' + q;
+}
+export default function Image(props) {
+    const { src, width, height, alt, quality = 75, priority = false, className } = props;
+    const imgProps = {
+        alt: alt ?? '',
+        src: buildSrc(src, width ?? 1920, quality),
+        loading: priority ? 'eager' : 'lazy',
+        decoding: 'async',
+        style: { display: 'block', maxWidth: '100%', height: 'auto' },
+    };
+    if (width !== undefined)
+        imgProps.width = width;
+    if (height !== undefined)
+        imgProps.height = height;
+    if (className)
+        imgProps.className = className;
+    return React.createElement('img', imgProps);
+}
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../src/image.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,SAAS,QAAQ,CAAC,GAAW,EAAE,CAAS,EAAE,CAAS;IACjD,OAAO,kBAAkB,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,KAAiB;IAC7C,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAErF,MAAM,QAAQ,GAA8C;QAC1D,GAAG,EAAE,GAAG,IAAI,EAAE;QACd,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,IAAI,IAAI,EAAE,OAAO,CAAC;QAC1C,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;QACpC,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;KAC9D,CAAC;IAEF,IAAI,KAAK,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IAChD,IAAI,MAAM,KAAK,SAAS;QAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IACnD,IAAI,SAAS;QAAE,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IAE9C,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Html, Head, Main, NextScript } from './document.js';
+export { default as Link } from './link.js';
+export { useRouter, navigateTo } from './router.js';
+export { default as Image } from './image.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":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Rex framework exports
+export { Html, Head, Main, NextScript } from './document.js';
+export { default as Link } from './link.js';
+export { useRouter, navigateTo } from './router.js';
+export { default as Image } from './image.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,wBAAwB;AACxB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/link.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    href: string;
+}
+/**
+ * rex/link - Client-side navigation link.
+ * Renders an <a> tag that intercepts clicks for SPA navigation.
+ */
+export default function Link({ href, children, target, ...rest }: LinkProps): React.ReactElement;
+export {};
+//# sourceMappingURL=link.d.ts.map

package/dist/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,UAAU,SAAU,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACvE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,SAAS,GAAG,KAAK,CAAC,YAAY,CA2B/F"}

package/dist/link.js

@@ -0,0 +1,27 @@
+import React from 'react';
+import { navigateTo } from './router.js';
+/**
+ * rex/link - Client-side navigation link.
+ * Renders an <a> tag that intercepts clicks for SPA navigation.
+ */
+export default function Link({ href, children, target, ...rest }) {
+    function handleClick(e) {
+        if (e.metaKey ||
+            e.ctrlKey ||
+            e.shiftKey ||
+            e.altKey ||
+            target === '_blank' ||
+            (href && (href.startsWith('http://') || href.startsWith('https://')))) {
+            return;
+        }
+        e.preventDefault();
+        navigateTo(href);
+    }
+    return React.createElement('a', {
+        href,
+        onClick: handleClick,
+        target,
+        ...rest,
+    }, children);
+}
+//# sourceMappingURL=link.js.map

package/dist/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../src/link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAa;IACzE,SAAS,WAAW,CAAC,CAAsC;QACzD,IACE,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,MAAM;YACR,MAAM,KAAK,QAAQ;YACnB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,EACrE,CAAC;YACD,OAAO;QACT,CAAC;QAED,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,aAAa,CACxB,GAAG,EACH;QACE,IAAI;QACJ,OAAO,EAAE,WAAW;QACpB,MAAM;QACN,GAAG,IAAI;KACR,EACD,QAAQ,CACT,CAAC;AACJ,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,29 @@
+export interface RouterEvents {
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    emit(event: string, ...args: unknown[]): void;
+}
+export interface RexRouter {
+    pathname: string;
+    asPath: string;
+    query: Record<string, string>;
+    route: string;
+    push(url: string): void;
+    replace(url: string): void;
+    back(): void;
+    forward(): void;
+    reload(): void;
+    prefetch(url: string): void;
+    events: RouterEvents;
+    isReady: boolean;
+}
+/**
+ * Navigate to a new path via client-side routing.
+ */
+export declare function navigateTo(path: string): void;
+/**
+ * React hook that returns the current router instance.
+ */
+export declare function useRouter(): RexRouter;
+export default useRouter;
+//# 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":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;IAChB,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AA0BD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO7C;AAaD;;GAEG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAmCrC;AAED,eAAe,SAAS,CAAC"}

package/dist/router.js

@@ -0,0 +1,65 @@
+function getRouter() {
+    return window.__REX_ROUTER ?? null;
+}
+/**
+ * Navigate to a new path via client-side routing.
+ */
+export function navigateTo(path) {
+    const r = getRouter();
+    if (r) {
+        r.push(path);
+    }
+    else {
+        window.location.href = path;
+    }
+}
+function parseQuery(search) {
+    const query = {};
+    if (!search || search.length <= 1)
+        return query;
+    const pairs = search.substring(1).split('&');
+    for (const pair of pairs) {
+        const [key, value] = pair.split('=');
+        query[decodeURIComponent(key)] = decodeURIComponent(value ?? '');
+    }
+    return query;
+}
+/**
+ * React hook that returns the current router instance.
+ */
+export function useRouter() {
+    const r = getRouter();
+    const noop = () => { };
+    if (r?.state) {
+        return {
+            pathname: r.state.pathname,
+            asPath: r.state.asPath,
+            query: r.state.query,
+            route: r.state.route,
+            push: r.push,
+            replace: r.replace,
+            back: r.back,
+            forward: r.forward,
+            reload: r.reload,
+            prefetch: r.prefetch,
+            events: r.events,
+            isReady: true,
+        };
+    }
+    return {
+        pathname: window.location.pathname,
+        asPath: window.location.pathname + window.location.search,
+        query: parseQuery(window.location.search),
+        route: window.location.pathname,
+        push: (url) => { window.location.href = url; },
+        replace: (url) => { window.location.replace(url); },
+        back: () => { history.back(); },
+        forward: () => { history.forward(); },
+        reload: () => { window.location.reload(); },
+        prefetch: noop,
+        events: { on: noop, off: noop, emit: noop },
+        isReady: false,
+    };
+}
+export default useRouter;
+//# 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/server.d.ts

@@ -0,0 +1,111 @@
+export interface RexApiRequest {
+    /** HTTP method (e.g. "GET", "POST"). */
+    method: string;
+    /** The request URL path. */
+    url: string;
+    /** Request headers as a plain object. */
+    headers: Record<string, string>;
+    /** Parsed query parameters. */
+    query: Record<string, string>;
+    /** Request body (parsed JSON or raw string). */
+    body: unknown;
+    /** Request cookies as a plain object. */
+    cookies: Record<string, string>;
+}
+export interface RexApiResponse<T = unknown> {
+    /** Set the HTTP status code. */
+    status(code: number): RexApiResponse<T>;
+    /** Set a response header. */
+    setHeader(name: string, value: string): RexApiResponse<T>;
+    /** Send a JSON response. */
+    json(data: T): RexApiResponse<T>;
+    /** Send a string or object response. */
+    send(body: string | T): RexApiResponse<T>;
+    /** End the response. */
+    end(body?: string): RexApiResponse<T>;
+    /** Redirect to a URL, optionally with a status code. */
+    redirect(url: string): RexApiResponse<T>;
+    redirect(status: number, url: string): RexApiResponse<T>;
+}
+/** @deprecated Use `RexApiRequest` instead. */
+export type NextApiRequest = RexApiRequest;
+/** @deprecated Use `RexApiResponse` instead. */
+export type NextApiResponse<T = unknown> = RexApiResponse<T>;
+export interface RexOptions {
+    /** Path to the project root directory (containing pages/). */
+    root: string;
+    /** Whether to run in dev mode (enables HMR, error overlays). */
+    dev?: boolean;
+}
+export interface RouteMatch {
+    /** The route pattern, e.g. "/blog/:slug" */
+    pattern: string;
+    /** The module name, e.g. "blog/[slug]" */
+    moduleName: string;
+    /** Matched params, e.g. { slug: "hello" } */
+    params: Record<string, string>;
+}
+export interface PageResult {
+    /** Full HTML document. */
+    html: string;
+    /** HTTP status code. */
+    status: number;
+    /** Response headers. */
+    headers: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+export interface RexInstance {
+    /** Whether this instance is running in dev mode. */
+    readonly isDev: boolean;
+    /** The current build ID. */
+    readonly buildId: string;
+    /** The path to the static files directory (client JS/CSS bundles). */
+    readonly staticDir: string;
+    /**
+     * Match a URL path against the route trie.
+     * Returns the matched route info with params, or null if no match.
+     */
+    matchRoute(path: string): RouteMatch | null;
+    /**
+     * Run getServerSideProps for a given path and return the result.
+     */
+    getServerSideProps(path: string): Promise<Record<string, unknown>>;
+    /**
+     * Render a page to an HTML string with the given props.
+     */
+    renderToString(path: string, props: Record<string, unknown>): Promise<string>;
+    /**
+     * Render a full page (GSSP + SSR + document assembly).
+     * Returns HTML, status code, and headers.
+     */
+    renderPage(path: string): Promise<PageResult>;
+    /**
+     * Get a request handler function compatible with the Web Fetch API.
+     * Returns `(req: Request) => Promise<Response>`.
+     */
+    getRequestHandler(): (req: Request) => Promise<Response>;
+    /**
+     * Shut down the Rex instance, releasing V8 isolates and other resources.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a new Rex application instance.
+ *
+ * Scans the pages directory, builds bundles, initializes the V8 isolate pool,
+ * and returns a ready-to-use RexInstance.
+ *
+ * @example
+ * ```ts
+ * import { createRex } from '@limlabs/rex/server'
+ *
+ * const rex = await createRex({ root: './my-app' })
+ * const handle = rex.getRequestHandler()
+ *
+ * Bun.serve({ fetch: handle })
+ * ```
+ */
+export declare const createRex: (options: RexOptions) => Promise<RexInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,49 @@
+import { createRequire } from 'node:module';
+import { arch, platform } from 'node:process';
+function loadNativeBinding() {
+    const require = createRequire(import.meta.url);
+    const platformPackage = `@limlabs/rex-${platform}-${arch}`;
+    // Try platform-specific package first (for published npm packages)
+    try {
+        return require(platformPackage);
+    }
+    catch {
+        // Fall through to local .node file (development)
+    }
+    // Try local .node file (built with napi build)
+    try {
+        return require('../rex-napi.node');
+    }
+    catch {
+        // Fall through
+    }
+    // Try the build output from cargo
+    try {
+        return require('../../crates/rex_napi/rex-napi.node');
+    }
+    catch {
+        // Fall through
+    }
+    throw new Error(`Failed to load Rex native binding. ` +
+        `Tried: ${platformPackage}, ../rex-napi.node, ../../crates/rex_napi/rex-napi.node. ` +
+        `Make sure the native module is built (cd crates/rex_napi && npm run build-debug).`);
+}
+const binding = loadNativeBinding();
+/**
+ * Create a new Rex application instance.
+ *
+ * Scans the pages directory, builds bundles, initializes the V8 isolate pool,
+ * and returns a ready-to-use RexInstance.
+ *
+ * @example
+ * ```ts
+ * import { createRex } from '@limlabs/rex/server'
+ *
+ * const rex = await createRex({ root: './my-app' })
+ * const handle = rex.getRequestHandler()
+ *
+ * Bun.serve({ fetch: handle })
+ * ```
+ */
+export const createRex = binding.createRex;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AA+G9C,SAAS,iBAAiB;IACxB,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,gBAAgB,QAAQ,IAAI,IAAI,EAAE,CAAC;IAE3D,mEAAmE;IACnE,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,eAAe,CAAkB,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,kBAAkB,CAAkB,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,qCAAqC,CAAkB,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qCAAqC;QACrC,UAAU,eAAe,2DAA2D;QACpF,mFAAmF,CACpF,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC"}

package/package.json

@@ -1,16 +1,53 @@
 {
   "name": "@limlabs/rex",
-  "version": "0.0.1-test.1",
+  "version": "0.3.0",
   "description": "Rex - Next.js Pages Router reimplemented in Rust",
-  "main": "src/index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
-    ".": "./src/index.js",
-    "./document": "./src/document.js",
-    "./link": "./src/link.js",
-    "./router": "./src/router.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./document": {
+      "types": "./dist/document.d.ts",
+      "import": "./dist/document.js"
+    },
+    "./link": {
+      "types": "./dist/link.d.ts",
+      "import": "./dist/link.js"
+    },
+    "./router": {
+      "types": "./dist/router.d.ts",
+      "import": "./dist/router.js"
+    },
+    "./image": {
+      "types": "./dist/image.d.ts",
+      "import": "./dist/image.js"
+    },
+    "./middleware": {
+      "types": "./src/middleware.d.ts",
+      "import": "../../runtime/server/middleware.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "oxlint": "^1.0.0"
   },
   "peerDependencies": {
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   }
 }

package/src/document.tsx

@@ -0,0 +1,39 @@
+import React from 'react';
+
+interface HtmlProps extends React.HTMLAttributes<HTMLHtmlElement> {
+  children?: React.ReactNode;
+}
+
+interface HeadProps {
+  children?: React.ReactNode;
+}
+
+export function Html({ children, ...props }: HtmlProps): React.ReactElement {
+  return React.createElement('html', props, children);
+}
+
+export function Head({ children }: HeadProps): React.ReactElement {
+  return React.createElement('head', null, children);
+}
+
+export function Main(): React.ReactElement {
+  return React.createElement('div', { id: '__rex' });
+}
+
+export function NextScript(): null {
+  return null;
+}
+
+export default function Document(): React.ReactElement {
+  return React.createElement(
+    Html,
+    null,
+    React.createElement(Head, null),
+    React.createElement(
+      'body',
+      null,
+      React.createElement(Main, null),
+      React.createElement(NextScript, null)
+    )
+  );
+}

package/src/image.tsx

@@ -0,0 +1,33 @@
+import React from 'react';
+
+interface ImageProps {
+  src: string;
+  width?: number;
+  height?: number;
+  alt?: string;
+  quality?: number;
+  priority?: boolean;
+  className?: string;
+}
+
+function buildSrc(src: string, w: number, q: number): string {
+  return '/_rex/image?url=' + encodeURIComponent(src) + '&w=' + w + '&q=' + q;
+}
+
+export default function Image(props: ImageProps): React.ReactElement {
+  const { src, width, height, alt, quality = 75, priority = false, className } = props;
+
+  const imgProps: React.ImgHTMLAttributes<HTMLImageElement> = {
+    alt: alt ?? '',
+    src: buildSrc(src, width ?? 1920, quality),
+    loading: priority ? 'eager' : 'lazy',
+    decoding: 'async',
+    style: { display: 'block', maxWidth: '100%', height: 'auto' },
+  };
+
+  if (width !== undefined) imgProps.width = width;
+  if (height !== undefined) imgProps.height = height;
+  if (className) imgProps.className = className;
+
+  return React.createElement('img', imgProps);
+}

package/src/{index.js → index.ts}

@@ -2,3 +2,4 @@
 export { Html, Head, Main, NextScript } from './document.js';
 export { default as Link } from './link.js';
 export { useRouter, navigateTo } from './router.js';
+export { default as Image } from './image.js';

package/src/{link.js → link.tsx}

@@ -1,16 +1,16 @@
 import React from 'react';
 import { navigateTo } from './router.js';
 
+interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+  href: string;
+}
+
 /**
- * rex/link - Client-side navigation link
+ * rex/link - Client-side navigation link.
  * Renders an <a> tag that intercepts clicks for SPA navigation.
  */
-export default function Link({ href, children, target, rel, className, style, ...rest }) {
-  function handleClick(e) {
-    // Don't intercept if:
-    // - modifier key is held (user wants new tab)
-    // - target is set (external link behavior)
-    // - href is external
+export default function Link({ href, children, target, ...rest }: LinkProps): React.ReactElement {
+  function handleClick(e: React.MouseEvent<HTMLAnchorElement>): void {
     if (
       e.metaKey ||
       e.ctrlKey ||
@@ -29,12 +29,9 @@ export default function Link({ href, children, target, rel, className, style, ..
   return React.createElement(
     'a',
     {
-      href: href,
+      href,
       onClick: handleClick,
-      target: target,
-      rel: rel,
-      className: className,
-      style: style,
+      target,
       ...rest,
     },
     children

package/src/middleware.d.ts

@@ -0,0 +1,84 @@
+export interface NextURL {
+  /** The full URL string. */
+  href: string;
+  /** The pathname portion of the URL (e.g. "/blog/hello"). */
+  pathname: string;
+  /** The search/query string (e.g. "?foo=bar"). */
+  search: string;
+  /** String representation of the URL. */
+  toString(): string;
+}
+
+export interface NextRequest {
+  /** HTTP method (e.g. "GET", "POST"). */
+  method: string;
+  /** The full request URL string. */
+  url: string;
+  /** Parsed URL object with pathname, search, etc. */
+  nextUrl: NextURL;
+  /** Request headers as a plain object. */
+  headers: Record<string, string>;
+  /** Request cookies as a plain object. */
+  cookies: Record<string, string>;
+}
+
+export interface NextResponseInit {
+  /** Headers to add to the response. */
+  headers?: Record<string, string>;
+  /** Headers/options to modify the downstream request. */
+  request?: {
+    headers?: Record<string, string>;
+  };
+}
+
+export declare class NextResponse {
+  /**
+   * Continue to the next handler, optionally modifying response or request headers.
+   */
+  static next(init?: NextResponseInit): NextResponse;
+
+  /**
+   * Redirect the request to a different URL.
+   * @param url - The target URL (string or URL object).
+   * @param status - HTTP status code (default: 307).
+   */
+  static redirect(url: string | URL, status?: number): NextResponse;
+
+  /**
+   * Rewrite the request to a different URL without changing the browser URL.
+   * @param url - The target URL (string or URL object).
+   */
+  static rewrite(url: string | URL): NextResponse;
+}
+
+export interface MiddlewareConfig {
+  /**
+   * Route patterns to match. Supports:
+   * - Exact paths: "/about"
+   * - Dynamic segments: "/blog/:slug"
+   * - Catch-all: "/api/:path*"
+   *
+   * If omitted, middleware runs on all routes.
+   */
+  matcher?: string[];
+}
+
+/**
+ * Middleware function signature.
+ *
+ * @example
+ * ```ts
+ * import { NextResponse } from '@limlabs/rex/middleware'
+ * import type { MiddlewareFunction } from '@limlabs/rex/middleware'
+ *
+ * export const middleware: MiddlewareFunction = (request) => {
+ *   if (request.nextUrl.pathname === '/old') {
+ *     return NextResponse.redirect(new URL('/new', request.url))
+ *   }
+ *   return NextResponse.next()
+ * }
+ *
+ * export const config = { matcher: ['/old', '/dashboard/:path*'] }
+ * ```
+ */
+export type MiddlewareFunction = (request: NextRequest) => NextResponse;

package/src/router.ts

@@ -0,0 +1,109 @@
+export interface RouterEvents {
+  on(event: string, handler: (...args: unknown[]) => void): void;
+  off(event: string, handler: (...args: unknown[]) => void): void;
+  emit(event: string, ...args: unknown[]): void;
+}
+
+export interface RexRouter {
+  pathname: string;
+  asPath: string;
+  query: Record<string, string>;
+  route: string;
+  push(url: string): void;
+  replace(url: string): void;
+  back(): void;
+  forward(): void;
+  reload(): void;
+  prefetch(url: string): void;
+  events: RouterEvents;
+  isReady: boolean;
+}
+
+interface InternalRouter {
+  push(path: string): void;
+  replace(path: string): void;
+  back(): void;
+  forward(): void;
+  reload(): void;
+  prefetch(url: string): void;
+  events: RouterEvents;
+  state: {
+    pathname: string;
+    asPath: string;
+    query: Record<string, string>;
+    route: string;
+  };
+}
+
+declare const window: Window & {
+  __REX_ROUTER?: InternalRouter;
+};
+
+function getRouter(): InternalRouter | null {
+  return window.__REX_ROUTER ?? null;
+}
+
+/**
+ * Navigate to a new path via client-side routing.
+ */
+export function navigateTo(path: string): void {
+  const r = getRouter();
+  if (r) {
+    r.push(path);
+  } else {
+    window.location.href = path;
+  }
+}
+
+function parseQuery(search: string): Record<string, string> {
+  const query: Record<string, string> = {};
+  if (!search || search.length <= 1) return query;
+  const pairs = search.substring(1).split('&');
+  for (const pair of pairs) {
+    const [key, value] = pair.split('=');
+    query[decodeURIComponent(key)] = decodeURIComponent(value ?? '');
+  }
+  return query;
+}
+
+/**
+ * React hook that returns the current router instance.
+ */
+export function useRouter(): RexRouter {
+  const r = getRouter();
+  const noop = (): void => {};
+
+  if (r?.state) {
+    return {
+      pathname: r.state.pathname,
+      asPath: r.state.asPath,
+      query: r.state.query,
+      route: r.state.route,
+      push: r.push,
+      replace: r.replace,
+      back: r.back,
+      forward: r.forward,
+      reload: r.reload,
+      prefetch: r.prefetch,
+      events: r.events,
+      isReady: true,
+    };
+  }
+
+  return {
+    pathname: window.location.pathname,
+    asPath: window.location.pathname + window.location.search,
+    query: parseQuery(window.location.search),
+    route: window.location.pathname,
+    push: (url: string) => { window.location.href = url; },
+    replace: (url: string) => { window.location.replace(url); },
+    back: () => { history.back(); },
+    forward: () => { history.forward(); },
+    reload: () => { window.location.reload(); },
+    prefetch: noop,
+    events: { on: noop, off: noop, emit: noop },
+    isReady: false,
+  };
+}
+
+export default useRouter;

package/src/server.ts

@@ -0,0 +1,163 @@
+import { createRequire } from 'node:module';
+import { arch, platform } from 'node:process';
+
+// --- Public types ---
+
+export interface RexApiRequest {
+  /** HTTP method (e.g. "GET", "POST"). */
+  method: string;
+  /** The request URL path. */
+  url: string;
+  /** Request headers as a plain object. */
+  headers: Record<string, string>;
+  /** Parsed query parameters. */
+  query: Record<string, string>;
+  /** Request body (parsed JSON or raw string). */
+  body: unknown;
+  /** Request cookies as a plain object. */
+  cookies: Record<string, string>;
+}
+
+export interface RexApiResponse<T = unknown> {
+  /** Set the HTTP status code. */
+  status(code: number): RexApiResponse<T>;
+  /** Set a response header. */
+  setHeader(name: string, value: string): RexApiResponse<T>;
+  /** Send a JSON response. */
+  json(data: T): RexApiResponse<T>;
+  /** Send a string or object response. */
+  send(body: string | T): RexApiResponse<T>;
+  /** End the response. */
+  end(body?: string): RexApiResponse<T>;
+  /** Redirect to a URL, optionally with a status code. */
+  redirect(url: string): RexApiResponse<T>;
+  redirect(status: number, url: string): RexApiResponse<T>;
+}
+
+/** @deprecated Use `RexApiRequest` instead. */
+export type NextApiRequest = RexApiRequest;
+/** @deprecated Use `RexApiResponse` instead. */
+export type NextApiResponse<T = unknown> = RexApiResponse<T>;
+
+export interface RexOptions {
+  /** Path to the project root directory (containing pages/). */
+  root: string;
+  /** Whether to run in dev mode (enables HMR, error overlays). */
+  dev?: boolean;
+}
+
+export interface RouteMatch {
+  /** The route pattern, e.g. "/blog/:slug" */
+  pattern: string;
+  /** The module name, e.g. "blog/[slug]" */
+  moduleName: string;
+  /** Matched params, e.g. { slug: "hello" } */
+  params: Record<string, string>;
+}
+
+export interface PageResult {
+  /** Full HTML document. */
+  html: string;
+  /** HTTP status code. */
+  status: number;
+  /** Response headers. */
+  headers: Array<{ key: string; value: string }>;
+}
+
+export interface RexInstance {
+  /** Whether this instance is running in dev mode. */
+  readonly isDev: boolean;
+  /** The current build ID. */
+  readonly buildId: string;
+  /** The path to the static files directory (client JS/CSS bundles). */
+  readonly staticDir: string;
+
+  /**
+   * Match a URL path against the route trie.
+   * Returns the matched route info with params, or null if no match.
+   */
+  matchRoute(path: string): RouteMatch | null;
+
+  /**
+   * Run getServerSideProps for a given path and return the result.
+   */
+  getServerSideProps(path: string): Promise<Record<string, unknown>>;
+
+  /**
+   * Render a page to an HTML string with the given props.
+   */
+  renderToString(path: string, props: Record<string, unknown>): Promise<string>;
+
+  /**
+   * Render a full page (GSSP + SSR + document assembly).
+   * Returns HTML, status code, and headers.
+   */
+  renderPage(path: string): Promise<PageResult>;
+
+  /**
+   * Get a request handler function compatible with the Web Fetch API.
+   * Returns `(req: Request) => Promise<Response>`.
+   */
+  getRequestHandler(): (req: Request) => Promise<Response>;
+
+  /**
+   * Shut down the Rex instance, releasing V8 isolates and other resources.
+   */
+  close(): Promise<void>;
+}
+
+interface NativeBinding {
+  createRex(options: RexOptions): Promise<RexInstance>;
+}
+
+function loadNativeBinding(): NativeBinding {
+  const require = createRequire(import.meta.url);
+  const platformPackage = `@limlabs/rex-${platform}-${arch}`;
+
+  // Try platform-specific package first (for published npm packages)
+  try {
+    return require(platformPackage) as NativeBinding;
+  } catch {
+    // Fall through to local .node file (development)
+  }
+
+  // Try local .node file (built with napi build)
+  try {
+    return require('../rex-napi.node') as NativeBinding;
+  } catch {
+    // Fall through
+  }
+
+  // Try the build output from cargo
+  try {
+    return require('../../crates/rex_napi/rex-napi.node') as NativeBinding;
+  } catch {
+    // Fall through
+  }
+
+  throw new Error(
+    `Failed to load Rex native binding. ` +
+    `Tried: ${platformPackage}, ../rex-napi.node, ../../crates/rex_napi/rex-napi.node. ` +
+    `Make sure the native module is built (cd crates/rex_napi && npm run build-debug).`
+  );
+}
+
+const binding = loadNativeBinding();
+
+/**
+ * Create a new Rex application instance.
+ *
+ * Scans the pages directory, builds bundles, initializes the V8 isolate pool,
+ * and returns a ready-to-use RexInstance.
+ *
+ * @example
+ * ```ts
+ * import { createRex } from '@limlabs/rex/server'
+ *
+ * const rex = await createRex({ root: './my-app' })
+ * const handle = rex.getRequestHandler()
+ *
+ * Bun.serve({ fetch: handle })
+ * ```
+ */
+export const createRex = binding.createRex;

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/src/document.js

@@ -1,40 +0,0 @@
-import React from 'react';
-
-/**
- * rex/document exports
- * These components are meaningful during SSR and provide structure for the HTML document.
- * On the client side, they are essentially pass-throughs.
- */
-
-export function Html({ children, ...props }) {
-  return React.createElement('html', props, children);
-}
-
-export function Head({ children }) {
-  return React.createElement('head', null, children);
-}
-
-export function Main() {
-  // During SSR, this is replaced with the actual page content
-  return React.createElement('div', { id: '__rex' });
-}
-
-export function NextScript() {
-  // During SSR, this is replaced with the actual script tags
-  return null;
-}
-
-// Default document component
-export default function Document() {
-  return React.createElement(
-    Html,
-    null,
-    React.createElement(Head, null),
-    React.createElement(
-      'body',
-      null,
-      React.createElement(Main, null),
-      React.createElement(NextScript, null)
-    )
-  );
-}

package/src/router.js

@@ -1,114 +0,0 @@
-/**
- * rex/router - Client-side router
- * Handles SPA navigation by fetching page data and re-rendering.
- */
-
-let _initialized = false;
-let _currentPath = null;
-let _buildId = null;
-
-/**
- * Initialize the client-side router.
- * Called automatically on page load.
- */
-export function initializeRouter() {
-  if (_initialized) return;
-  _initialized = true;
-
-  _currentPath = window.location.pathname;
-  _buildId = window.__REX_BUILD_ID__ || '';
-
-  // Listen for browser back/forward
-  window.addEventListener('popstate', function(event) {
-    var path = window.location.pathname;
-    if (path !== _currentPath) {
-      _currentPath = path;
-      loadPage(path, false);
-    }
-  });
-}
-
-/**
- * Navigate to a new path via client-side routing.
- */
-export function navigateTo(path) {
-  if (path === _currentPath) return;
-
-  _currentPath = path;
-  window.history.pushState(null, '', path);
-  loadPage(path, true);
-}
-
-/**
- * Get the current route information (React hook style, but simplified).
- */
-export function useRouter() {
-  return {
-    pathname: window.location.pathname,
-    query: parseQuery(window.location.search),
-    push: navigateTo,
-    back: function() { window.history.back(); },
-  };
-}
-
-async function loadPage(path, isNavigation) {
-  try {
-    // Fetch page data
-    var dataPath = path === '/' ? '/index' : path;
-    var dataUrl = '/_rex/data/' + _buildId + dataPath + '.json';
-
-    var response = await fetch(dataUrl);
-
-    if (response.status === 404) {
-      // Build ID mismatch or route not found - full reload
-      window.location.href = path;
-      return;
-    }
-
-    if (!response.ok) {
-      throw new Error('Failed to fetch page data: ' + response.status);
-    }
-
-    var data = await response.json();
-
-    if (data.redirect) {
-      navigateTo(data.redirect.destination);
-      return;
-    }
-
-    if (data.notFound) {
-      // Show 404
-      window.location.href = path;
-      return;
-    }
-
-    // For the prototype, we do a full page reload
-    // A full implementation would dynamically import the page module
-    // and re-render using window.__REX_ROOT__.render()
-    window.location.href = path;
-
-  } catch (err) {
-    console.error('[Rex Router] Navigation error:', err);
-    window.location.href = path;
-  }
-}
-
-function parseQuery(search) {
-  var query = {};
-  if (!search || search.length <= 1) return query;
-  var pairs = search.substring(1).split('&');
-  for (var i = 0; i < pairs.length; i++) {
-    var pair = pairs[i].split('=');
-    query[decodeURIComponent(pair[0])] = decodeURIComponent(pair[1] || '');
-  }
-  return query;
-}
-
-// Auto-initialize when loaded in browser
-if (typeof window !== 'undefined') {
-  if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', initializeRouter);
-  } else {
-    initializeRouter();
-  }
-}