vinext 0.0.0 → 0.0.2

package/dist/shims/script.d.ts

@@ -0,0 +1,58 @@
+/**
+ * next/script shim
+ *
+ * Provides the <Script> component for loading third-party scripts with
+ * configurable loading strategies.
+ *
+ * Strategies:
+ *   - "beforeInteractive": rendered as a <script> tag in SSR output
+ *   - "afterInteractive" (default): loaded client-side after hydration
+ *   - "lazyOnload": deferred until window.load + requestIdleCallback
+ *   - "worker": sets type="text/partytown" (requires Partytown setup)
+ */
+import React from "react";
+export interface ScriptProps {
+    /** Script source URL */
+    src?: string;
+    /** Loading strategy. Default: "afterInteractive" */
+    strategy?: "beforeInteractive" | "afterInteractive" | "lazyOnload" | "worker";
+    /** Unique identifier for the script */
+    id?: string;
+    /** Called when the script has loaded */
+    onLoad?: (e: Event) => void;
+    /** Called when the script is ready (after load, and on every re-render if already loaded) */
+    onReady?: () => void;
+    /** Called on script load error */
+    onError?: (e: Event) => void;
+    /** Inline script content */
+    children?: React.ReactNode;
+    /** Dangerous inner HTML */
+    dangerouslySetInnerHTML?: {
+        __html: string;
+    };
+    /** Script type attribute */
+    type?: string;
+    /** Async attribute */
+    async?: boolean;
+    /** Defer attribute */
+    defer?: boolean;
+    /** Crossorigin attribute */
+    crossOrigin?: string;
+    /** Nonce for CSP */
+    nonce?: string;
+    /** Integrity hash */
+    integrity?: string;
+    /** Additional attributes */
+    [key: string]: unknown;
+}
+/**
+ * Load a script imperatively (outside of React).
+ */
+export declare function handleClientScriptLoad(props: ScriptProps): void;
+/**
+ * Initialize multiple scripts at once (called during app bootstrap).
+ */
+export declare function initScriptLoader(scripts: ScriptProps[]): void;
+declare function Script(props: ScriptProps): React.ReactElement | null;
+export default Script;
+//# sourceMappingURL=script.d.ts.map

package/dist/shims/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../src/shims/script.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC9E,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC5B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,2BAA2B;IAC3B,uBAAuB,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sBAAsB;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAKD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA6B/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAI7D;AAED,iBAAS,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAgH7D;AAED,eAAe,MAAM,CAAC"}

package/dist/shims/script.js

@@ -0,0 +1,163 @@
+"use client";
+/**
+ * next/script shim
+ *
+ * Provides the <Script> component for loading third-party scripts with
+ * configurable loading strategies.
+ *
+ * Strategies:
+ *   - "beforeInteractive": rendered as a <script> tag in SSR output
+ *   - "afterInteractive" (default): loaded client-side after hydration
+ *   - "lazyOnload": deferred until window.load + requestIdleCallback
+ *   - "worker": sets type="text/partytown" (requires Partytown setup)
+ */
+import React, { useEffect, useRef } from "react";
+// Track scripts that have already been loaded to avoid duplicates
+const loadedScripts = new Set();
+/**
+ * Load a script imperatively (outside of React).
+ */
+export function handleClientScriptLoad(props) {
+    const { src, id, onLoad, onError, strategy: _strategy, onReady: _onReady, children, ...rest } = props;
+    if (typeof window === "undefined")
+        return;
+    const key = id ?? src ?? "";
+    if (key && loadedScripts.has(key))
+        return;
+    const el = document.createElement("script");
+    if (src)
+        el.src = src;
+    if (id)
+        el.id = id;
+    for (const [attr, value] of Object.entries(rest)) {
+        if (attr === "dangerouslySetInnerHTML" || attr === "className")
+            continue;
+        if (typeof value === "string") {
+            el.setAttribute(attr, value);
+        }
+        else if (typeof value === "boolean" && value) {
+            el.setAttribute(attr, "");
+        }
+    }
+    if (children && typeof children === "string") {
+        el.textContent = children;
+    }
+    if (onLoad)
+        el.addEventListener("load", onLoad);
+    if (onError)
+        el.addEventListener("error", onError);
+    document.body.appendChild(el);
+    if (key)
+        loadedScripts.add(key);
+}
+/**
+ * Initialize multiple scripts at once (called during app bootstrap).
+ */
+export function initScriptLoader(scripts) {
+    for (const script of scripts) {
+        handleClientScriptLoad(script);
+    }
+}
+function Script(props) {
+    const { src, id, strategy = "afterInteractive", onLoad, onReady, onError, children, dangerouslySetInnerHTML, ...rest } = props;
+    const hasMounted = useRef(false);
+    // SSR path: only "beforeInteractive" renders a <script> tag server-side
+    if (typeof window === "undefined") {
+        if (strategy === "beforeInteractive") {
+            const scriptProps = { ...rest };
+            if (src)
+                scriptProps.src = src;
+            if (id)
+                scriptProps.id = id;
+            if (dangerouslySetInnerHTML) {
+                scriptProps.dangerouslySetInnerHTML = dangerouslySetInnerHTML;
+            }
+            return React.createElement("script", scriptProps, children);
+        }
+        // Other strategies don't render during SSR
+        return null;
+    }
+    const key = id ?? src ?? "";
+    // Client path: load scripts via useEffect based on strategy
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    useEffect(() => {
+        if (hasMounted.current)
+            return;
+        hasMounted.current = true;
+        // Already loaded — just fire onReady
+        if (key && loadedScripts.has(key)) {
+            onReady?.();
+            return;
+        }
+        const load = () => {
+            if (key && loadedScripts.has(key)) {
+                onReady?.();
+                return;
+            }
+            const el = document.createElement("script");
+            if (src)
+                el.src = src;
+            if (id)
+                el.id = id;
+            for (const [attr, value] of Object.entries(rest)) {
+                if (attr === "className") {
+                    el.setAttribute("class", String(value));
+                }
+                else if (typeof value === "string") {
+                    el.setAttribute(attr, value);
+                }
+                else if (typeof value === "boolean" && value) {
+                    el.setAttribute(attr, "");
+                }
+            }
+            if (strategy === "worker") {
+                el.setAttribute("type", "text/partytown");
+            }
+            if (dangerouslySetInnerHTML?.__html) {
+                el.innerHTML = dangerouslySetInnerHTML.__html;
+            }
+            else if (children && typeof children === "string") {
+                el.textContent = children;
+            }
+            el.addEventListener("load", (e) => {
+                if (key)
+                    loadedScripts.add(key);
+                onLoad?.(e);
+                onReady?.();
+            });
+            if (onError) {
+                el.addEventListener("error", onError);
+            }
+            document.body.appendChild(el);
+        };
+        if (strategy === "lazyOnload") {
+            // Wait for window load, then use idle callback
+            if (document.readyState === "complete") {
+                if (typeof requestIdleCallback === "function") {
+                    requestIdleCallback(load);
+                }
+                else {
+                    setTimeout(load, 1);
+                }
+            }
+            else {
+                window.addEventListener("load", () => {
+                    if (typeof requestIdleCallback === "function") {
+                        requestIdleCallback(load);
+                    }
+                    else {
+                        setTimeout(load, 1);
+                    }
+                });
+            }
+        }
+        else {
+            // "afterInteractive" (default), "beforeInteractive" (client re-mount), "worker"
+            load();
+        }
+    }, [src, id, strategy, onLoad, onReady, onError, children, dangerouslySetInnerHTML, key, rest]);
+    // The component itself renders nothing — scripts are injected imperatively
+    return null;
+}
+export default Script;
+//# sourceMappingURL=script.js.map

package/dist/shims/script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../src/shims/script.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * next/script shim\n *\n * Provides the <Script> component for loading third-party scripts with\n * configurable loading strategies.\n *\n * Strategies:\n *   - \"beforeInteractive\": rendered as a <script> tag in SSR output\n *   - \"afterInteractive\" (default): loaded client-side after hydration\n *   - \"lazyOnload\": deferred until window.load + requestIdleCallback\n *   - \"worker\": sets type=\"text/partytown\" (requires Partytown setup)\n */\nimport React, { useEffect, useRef } from \"react\";\n\nexport interface ScriptProps {\n  /** Script source URL */\n  src?: string;\n  /** Loading strategy. Default: \"afterInteractive\" */\n  strategy?: \"beforeInteractive\" | \"afterInteractive\" | \"lazyOnload\" | \"worker\";\n  /** Unique identifier for the script */\n  id?: string;\n  /** Called when the script has loaded */\n  onLoad?: (e: Event) => void;\n  /** Called when the script is ready (after load, and on every re-render if already loaded) */\n  onReady?: () => void;\n  /** Called on script load error */\n  onError?: (e: Event) => void;\n  /** Inline script content */\n  children?: React.ReactNode;\n  /** Dangerous inner HTML */\n  dangerouslySetInnerHTML?: { __html: string };\n  /** Script type attribute */\n  type?: string;\n  /** Async attribute */\n  async?: boolean;\n  /** Defer attribute */\n  defer?: boolean;\n  /** Crossorigin attribute */\n  crossOrigin?: string;\n  /** Nonce for CSP */\n  nonce?: string;\n  /** Integrity hash */\n  integrity?: string;\n  /** Additional attributes */\n  [key: string]: unknown;\n}\n\n// Track scripts that have already been loaded to avoid duplicates\nconst loadedScripts = new Set<string>();\n\n/**\n * Load a script imperatively (outside of React).\n */\nexport function handleClientScriptLoad(props: ScriptProps): void {\n  const { src, id, onLoad, onError, strategy: _strategy, onReady: _onReady, children, ...rest } = props;\n  if (typeof window === \"undefined\") return;\n\n  const key = id ?? src ?? \"\";\n  if (key && loadedScripts.has(key)) return;\n\n  const el = document.createElement(\"script\");\n  if (src) el.src = src;\n  if (id) el.id = id;\n\n  for (const [attr, value] of Object.entries(rest)) {\n    if (attr === \"dangerouslySetInnerHTML\" || attr === \"className\") continue;\n    if (typeof value === \"string\") {\n      el.setAttribute(attr, value);\n    } else if (typeof value === \"boolean\" && value) {\n      el.setAttribute(attr, \"\");\n    }\n  }\n\n  if (children && typeof children === \"string\") {\n    el.textContent = children;\n  }\n\n  if (onLoad) el.addEventListener(\"load\", onLoad);\n  if (onError) el.addEventListener(\"error\", onError);\n\n  document.body.appendChild(el);\n  if (key) loadedScripts.add(key);\n}\n\n/**\n * Initialize multiple scripts at once (called during app bootstrap).\n */\nexport function initScriptLoader(scripts: ScriptProps[]): void {\n  for (const script of scripts) {\n    handleClientScriptLoad(script);\n  }\n}\n\nfunction Script(props: ScriptProps): React.ReactElement | null {\n  const {\n    src,\n    id,\n    strategy = \"afterInteractive\",\n    onLoad,\n    onReady,\n    onError,\n    children,\n    dangerouslySetInnerHTML,\n    ...rest\n  } = props;\n\n  const hasMounted = useRef(false);\n\n  // SSR path: only \"beforeInteractive\" renders a <script> tag server-side\n  if (typeof window === \"undefined\") {\n    if (strategy === \"beforeInteractive\") {\n      const scriptProps: Record<string, unknown> = { ...rest };\n      if (src) scriptProps.src = src;\n      if (id) scriptProps.id = id;\n      if (dangerouslySetInnerHTML) {\n        scriptProps.dangerouslySetInnerHTML = dangerouslySetInnerHTML;\n      }\n      return React.createElement(\"script\", scriptProps, children);\n    }\n    // Other strategies don't render during SSR\n    return null;\n  }\n\n  const key = id ?? src ?? \"\";\n\n  // Client path: load scripts via useEffect based on strategy\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  useEffect(() => {\n    if (hasMounted.current) return;\n    hasMounted.current = true;\n\n    // Already loaded — just fire onReady\n    if (key && loadedScripts.has(key)) {\n      onReady?.();\n      return;\n    }\n\n    const load = () => {\n      if (key && loadedScripts.has(key)) {\n        onReady?.();\n        return;\n      }\n\n      const el = document.createElement(\"script\");\n      if (src) el.src = src;\n      if (id) el.id = id;\n\n      for (const [attr, value] of Object.entries(rest)) {\n        if (attr === \"className\") {\n          el.setAttribute(\"class\", String(value));\n        } else if (typeof value === \"string\") {\n          el.setAttribute(attr, value);\n        } else if (typeof value === \"boolean\" && value) {\n          el.setAttribute(attr, \"\");\n        }\n      }\n\n      if (strategy === \"worker\") {\n        el.setAttribute(\"type\", \"text/partytown\");\n      }\n\n      if (dangerouslySetInnerHTML?.__html) {\n        el.innerHTML = dangerouslySetInnerHTML.__html as string;\n      } else if (children && typeof children === \"string\") {\n        el.textContent = children;\n      }\n\n      el.addEventListener(\"load\", (e) => {\n        if (key) loadedScripts.add(key);\n        onLoad?.(e);\n        onReady?.();\n      });\n\n      if (onError) {\n        el.addEventListener(\"error\", onError);\n      }\n\n      document.body.appendChild(el);\n    };\n\n    if (strategy === \"lazyOnload\") {\n      // Wait for window load, then use idle callback\n      if (document.readyState === \"complete\") {\n        if (typeof requestIdleCallback === \"function\") {\n          requestIdleCallback(load);\n        } else {\n          setTimeout(load, 1);\n        }\n      } else {\n        window.addEventListener(\"load\", () => {\n          if (typeof requestIdleCallback === \"function\") {\n            requestIdleCallback(load);\n          } else {\n            setTimeout(load, 1);\n          }\n        });\n      }\n    } else {\n      // \"afterInteractive\" (default), \"beforeInteractive\" (client re-mount), \"worker\"\n      load();\n    }\n  }, [src, id, strategy, onLoad, onReady, onError, children, dangerouslySetInnerHTML, key, rest]);\n\n  // The component itself renders nothing — scripts are injected imperatively\n  return null;\n}\n\nexport default Script;\n"]}

package/dist/shims/server-only.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shim for the `server-only` package.
+ *
+ * The real `server-only` npm package uses the `react-server` export
+ * condition: it's a no-op when resolved with react-server conditions
+ * (RSC environment), and throws when imported in a client bundle.
+ *
+ * In Vite with @vitejs/plugin-rsc, the RSC environment already uses
+ * react-server conditions, so if the real package is installed it works
+ * automatically. This shim exists as a fallback so users don't need to
+ * install `server-only` as a separate dependency — importing it just
+ * works.
+ *
+ * Build-time enforcement (preventing server code from leaking into
+ * client bundles) is handled by the RSC plugin's environment system
+ * and "use client" / "use server" directives, not by this module.
+ */
+export {};
+//# sourceMappingURL=server-only.d.ts.map

package/dist/shims/server-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-only.d.ts","sourceRoot":"","sources":["../../src/shims/server-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,CAAC"}

package/dist/shims/server-only.js

@@ -0,0 +1,19 @@
+/**
+ * Shim for the `server-only` package.
+ *
+ * The real `server-only` npm package uses the `react-server` export
+ * condition: it's a no-op when resolved with react-server conditions
+ * (RSC environment), and throws when imported in a client bundle.
+ *
+ * In Vite with @vitejs/plugin-rsc, the RSC environment already uses
+ * react-server conditions, so if the real package is installed it works
+ * automatically. This shim exists as a fallback so users don't need to
+ * install `server-only` as a separate dependency — importing it just
+ * works.
+ *
+ * Build-time enforcement (preventing server code from leaking into
+ * client bundles) is handled by the RSC plugin's environment system
+ * and "use client" / "use server" directives, not by this module.
+ */
+export {};
+//# sourceMappingURL=server-only.js.map

package/dist/shims/server-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-only.js","sourceRoot":"","sources":["../../src/shims/server-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG","sourcesContent":["/**\n * Shim for the `server-only` package.\n *\n * The real `server-only` npm package uses the `react-server` export\n * condition: it's a no-op when resolved with react-server conditions\n * (RSC environment), and throws when imported in a client bundle.\n *\n * In Vite with @vitejs/plugin-rsc, the RSC environment already uses\n * react-server conditions, so if the real package is installed it works\n * automatically. This shim exists as a fallback so users don't need to\n * install `server-only` as a separate dependency — importing it just\n * works.\n *\n * Build-time enforcement (preventing server code from leaking into\n * client bundles) is handled by the RSC plugin's environment system\n * and \"use client\" / \"use server\" directives, not by this module.\n */\n\n// Intentionally empty — this is a marker import, not a runtime API.\nexport {};\n"]}

package/dist/shims/server.d.ts

@@ -0,0 +1,178 @@
+/**
+ * next/server shim
+ *
+ * Provides NextRequest, NextResponse, and related types that work with
+ * standard Web APIs (Request/Response). This means they work on Node,
+ * Cloudflare Workers, Deno, and any WinterCG-compatible runtime.
+ *
+ * This is a pragmatic subset — we implement the most commonly used APIs
+ * rather than bug-for-bug parity with Next.js internals.
+ */
+export declare class NextRequest extends Request {
+    private _nextUrl;
+    private _cookies;
+    constructor(input: URL | RequestInfo, init?: RequestInit);
+    get nextUrl(): NextURL;
+    get cookies(): RequestCookies;
+    /**
+     * Client IP address. Prefers Cloudflare's trusted CF-Connecting-IP header
+     * over the spoofable X-Forwarded-For. Returns undefined if unavailable.
+     */
+    get ip(): string | undefined;
+    /**
+     * Geolocation data. Platform-dependent (e.g., Cloudflare, Vercel).
+     * Returns undefined if not available.
+     */
+    get geo(): {
+        city?: string;
+        country?: string;
+        region?: string;
+        latitude?: string;
+        longitude?: string;
+    } | undefined;
+}
+export declare class NextResponse<_Body = unknown> extends Response {
+    private _cookies;
+    constructor(body?: BodyInit | null, init?: ResponseInit);
+    get cookies(): ResponseCookies;
+    /**
+     * Create a JSON response.
+     */
+    static json<JsonBody>(body: JsonBody, init?: ResponseInit): NextResponse<JsonBody>;
+    /**
+     * Create a redirect response.
+     */
+    static redirect(url: string | URL, init?: number | ResponseInit): NextResponse;
+    /**
+     * Create a rewrite response (middleware pattern).
+     * Sets the x-middleware-rewrite header.
+     */
+    static rewrite(destination: string | URL, init?: MiddlewareResponseInit): NextResponse;
+    /**
+     * Continue to the next handler (middleware pattern).
+     * Sets the x-middleware-next header.
+     */
+    static next(init?: MiddlewareResponseInit): NextResponse;
+}
+export declare class NextURL {
+    private _url;
+    constructor(input: string | URL, base?: string | URL);
+    get href(): string;
+    get origin(): string;
+    get protocol(): string;
+    get host(): string;
+    get hostname(): string;
+    get port(): string;
+    get pathname(): string;
+    get search(): string;
+    get searchParams(): URLSearchParams;
+    get hash(): string;
+    set pathname(value: string);
+    set search(value: string);
+    set hash(value: string);
+    clone(): NextURL;
+    toString(): string;
+}
+interface CookieEntry {
+    name: string;
+    value: string;
+}
+export declare class RequestCookies {
+    private _headers;
+    constructor(headers: Headers);
+    private _parse;
+    get(name: string): CookieEntry | undefined;
+    getAll(): CookieEntry[];
+    has(name: string): boolean;
+    [Symbol.iterator](): IterableIterator<[string, CookieEntry]>;
+}
+export declare class ResponseCookies {
+    private _headers;
+    constructor(headers: Headers);
+    set(name: string, value: string, options?: CookieOptions): this;
+    get(name: string): CookieEntry | undefined;
+    getAll(): CookieEntry[];
+    delete(name: string): this;
+    [Symbol.iterator](): IterableIterator<[string, CookieEntry]>;
+}
+interface CookieOptions {
+    path?: string;
+    domain?: string;
+    maxAge?: number;
+    expires?: Date;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: "Strict" | "Lax" | "None";
+}
+export interface MiddlewareResponseInit extends ResponseInit {
+    request?: {
+        headers?: Headers;
+    };
+}
+export type NextMiddlewareResult = NextResponse | Response | null | undefined | void;
+export type NextMiddleware = (request: NextRequest, event: NextFetchEvent) => NextMiddlewareResult | Promise<NextMiddlewareResult>;
+/**
+ * Minimal NextFetchEvent — extends FetchEvent where available,
+ * otherwise provides the waitUntil pattern standalone.
+ */
+export declare class NextFetchEvent {
+    sourcePage: string;
+    private _waitUntilPromises;
+    constructor(params: {
+        page: string;
+    });
+    waitUntil(promise: Promise<unknown>): void;
+}
+/**
+ * Parse user agent string. Minimal implementation — for full UA parsing,
+ * apps should use a dedicated library like `ua-parser-js`.
+ */
+export declare function userAgentFromString(ua: string | undefined): UserAgent;
+export declare function userAgent({ headers }: {
+    headers: Headers;
+}): UserAgent;
+export interface UserAgent {
+    isBot: boolean;
+    ua: string;
+    browser: {
+        name?: string;
+        version?: string;
+        major?: string;
+    };
+    device: {
+        model?: string;
+        type?: string;
+        vendor?: string;
+    };
+    engine: {
+        name?: string;
+        version?: string;
+    };
+    os: {
+        name?: string;
+        version?: string;
+    };
+    cpu: {
+        architecture?: string;
+    };
+}
+/**
+ * after() — schedule work after the response is sent.
+ * In a real server, this would use the platform's waitUntil.
+ * Here we simply run it as a microtask (best-effort).
+ */
+export declare function after<T>(task: Promise<T> | (() => T | Promise<T>)): void;
+/**
+ * connection() — signals that the response requires a live connection
+ * (not a static/cached response). Opts the page out of ISR caching
+ * and sets Cache-Control: no-store on the response.
+ */
+export declare function connection(): Promise<void>;
+/**
+ * URLPattern re-export — used in middleware for route matching.
+ * Available natively in Node 20+, Cloudflare Workers, Deno.
+ * Falls back to urlpattern-polyfill if the global is not available.
+ */
+export declare const URLPattern: typeof globalThis.URLPattern;
+export {};
+//# sourceMappingURL=server.d.ts.map

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

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