@ossido-labs/ossido 0.1.0

package/dist/esm/hydration/browserLogForwarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserLogForwarding.js","names":[],"sources":["../../../src/hydration/browserLogForwarding.ts"],"sourcesContent":["/**\n * Dev-only: forward browser `console.*` (and uncaught errors) to the Ossido dev\n * server console, where they are printed tagged `[FE]`. The server applies the\n * `logging.browser` level/enabled config. The original console output is kept\n * intact.\n */\n\ninterface ForwardedError {\n  name: string;\n  message: string;\n  stack: Array<string>;\n}\n\ninterface ForwardedEntry {\n  level: string;\n  message: string;\n  error?: ForwardedError;\n  /** A client-side navigation event (rather than a `console.*` call). */\n  navigation?: boolean;\n  /** For a navigation that loaded data: the data response's HTTP status. */\n  status?: number;\n  /** For a navigation that loaded data: how long the load took, in ms. */\n  durationMs?: number;\n}\n\nconst CONSOLE_METHODS = [\n  'log',\n  'info',\n  'warn',\n  'error',\n  'debug',\n  'trace',\n] as const;\n\nconst LOGS_ENDPOINT = '/__ossido/logs';\n// A route's server data is loaded from `/__ossido/data{pathname}{searchStr}`, so\n// the request URL encodes the navigation path — that's how a data load is\n// correlated back to the navigation that triggered it.\nconst DATA_ROUTE_PREFIX = '/__ossido/data';\nconst FLUSH_DELAY_MS = 60;\nconst MAX_FRAMES = 6;\n// Cap the in-flight/recent data-load map so an un-consumed entry (e.g. an error\n// retry that refetches without navigating) can't grow it without bound.\nconst MAX_TRACKED_DATA_LOADS = 50;\n\n/** The outcome of a route's data fetch, correlated to a navigation by path. */\ninterface NavDataLoad {\n  status: number;\n  durationMs: number;\n}\n\n/** Mirror the backend's status→level mapping so a failed data load stands out. */\nfunction levelForStatus(status: number): string {\n  if (status >= 500) return 'error';\n  if (status >= 400) return 'warn';\n  return 'info';\n}\n\nfunction formatArg(arg: unknown): string {\n  if (typeof arg === 'string') return arg;\n  if (arg instanceof Error) return `${arg.name}: ${arg.message}`;\n  if (arg === undefined) return 'undefined';\n  try {\n    return JSON.stringify(arg);\n  } catch {\n    return String(arg);\n  }\n}\n\n/** Tidy a browser stack: drop the leading `Name: message` line, trim frames and\n * strip the dev-server origin so paths read like the project source. */\nfunction cleanStack(stack: string | undefined): Array<string> {\n  if (!stack) return [];\n  const origin = typeof location !== 'undefined' ? location.origin : '';\n  return stack\n    .split('\\n')\n    .map((line) => line.trim())\n    .filter((line) => line.startsWith('at ') || line.includes('@'))\n    .map((line) =>\n      line.replaceAll(`${origin}/`, '').replaceAll('vite-server/', ''),\n    )\n    .slice(0, MAX_FRAMES);\n}\n\nfunction toEntry(level: string, args: ReadonlyArray<unknown>): ForwardedEntry {\n  const message = args.map(formatArg).join(' ');\n  const errorArg = args.find((arg): arg is Error => arg instanceof Error);\n  const error = errorArg\n    ? {\n        name: errorArg.name,\n        message: errorArg.message,\n        stack: cleanStack(errorArg.stack),\n      }\n    : undefined;\n  return { level, message, error };\n}\n\nlet installed = false;\n\nexport function installBrowserLogForwarding(): void {\n  if (installed || typeof window === 'undefined') return;\n  installed = true;\n\n  const queue: Array<ForwardedEntry> = [];\n  let scheduled = false;\n\n  const flush = (): void => {\n    scheduled = false;\n    if (queue.length === 0) return;\n    const body = JSON.stringify(queue.splice(0, queue.length));\n    // A typed Blob makes `sendBeacon` post `application/json` (it defaults to\n    // `text/plain`). `sendBeacon` is fire-and-forget and survives page unload;\n    // fall back to a keepalive fetch when unavailable or when it rejects.\n    const blob = new Blob([body], { type: 'application/json' });\n    if (!navigator.sendBeacon?.(LOGS_ENDPOINT, blob)) {\n      void fetch(LOGS_ENDPOINT, {\n        method: 'POST',\n        body,\n        headers: { 'Content-Type': 'application/json' },\n        keepalive: true,\n      }).catch(() => undefined);\n    }\n  };\n\n  const schedule = (): void => {\n    if (scheduled) return;\n    scheduled = true;\n    setTimeout(flush, FLUSH_DELAY_MS);\n  };\n\n  const enqueue = (level: string, args: ReadonlyArray<unknown>): void => {\n    try {\n      queue.push(toEntry(level, args));\n      schedule();\n    } catch {\n      // Never let forwarding break the console.\n    }\n  };\n\n  // Curried wrapper: `level -> original console method -> forwarding method`.\n  // The wrapped method logs as usual, then forwards the call to the server.\n  const withForwarding =\n    (level: string) =>\n    (original: (...args: Array<unknown>) => void) =>\n    (...args: Array<unknown>): void => {\n      original(...args);\n      enqueue(level, args);\n    };\n\n  for (const method of CONSOLE_METHODS) {\n    console[method] = withForwarding(method)(console[method].bind(console));\n  }\n\n  window.addEventListener('error', (event) => {\n    enqueue('error', [event.error ?? event.message]);\n  });\n  window.addEventListener('unhandledrejection', (event) => {\n    enqueue('error', [event.reason]);\n  });\n\n  // Observe route data loads so a navigation's log line can carry the load's\n  // status + duration (mirroring the backend request log). Keyed by the\n  // navigation path — the `/__ossido/data{path}` URL encodes it — and consumed by\n  // the matching navigation report.\n  const dataLoads = new Map<string, Promise<NavDataLoad | null>>();\n  const originalFetch =\n    typeof window.fetch === 'function' ? window.fetch.bind(window) : undefined;\n  if (originalFetch) {\n    window.fetch = (\n      input: RequestInfo | URL,\n      init?: RequestInit,\n    ): Promise<Response> => {\n      const request = originalFetch(input, init);\n      try {\n        const raw =\n          typeof input === 'string'\n            ? input\n            : input instanceof URL\n              ? input.href\n              : input.url;\n        const { pathname, search } = new URL(raw, location.origin);\n        if (pathname.startsWith(DATA_ROUTE_PREFIX)) {\n          // Strip the prefix to recover the navigation path (`pathname+search`).\n          const navPath =\n            pathname.slice(DATA_ROUTE_PREFIX.length) + search || '/';\n          const start = performance.now();\n          if (dataLoads.size >= MAX_TRACKED_DATA_LOADS) {\n            const oldest = dataLoads.keys().next().value;\n            if (oldest !== undefined) dataLoads.delete(oldest);\n          }\n          dataLoads.set(\n            navPath,\n            request.then(\n              (res) => ({\n                status: res.status,\n                durationMs: performance.now() - start,\n              }),\n              () => null,\n            ),\n          );\n        }\n      } catch {\n        // Correlation is best-effort; never let it interfere with the fetch.\n      }\n      return request;\n    };\n  }\n\n  // Report client-side navigations so the dev server logs them too. The router\n  // commits every navigation via history.pushState/replaceState; back/forward\n  // fire popstate. (The initial load is a normal request the server already\n  // logs, and does not go through these.)\n  const emitNavigation = async (): Promise<void> => {\n    try {\n      const path = window.location.pathname + window.location.search;\n      const load = dataLoads.get(path);\n      dataLoads.delete(path);\n      const timing = load ? await load : null;\n      queue.push(\n        timing\n          ? {\n              level: levelForStatus(timing.status),\n              message: path,\n              navigation: true,\n              status: timing.status,\n              durationMs: timing.durationMs,\n            }\n          : { level: 'info', message: path, navigation: true },\n      );\n      schedule();\n    } catch {\n      // Never let reporting break navigation.\n    }\n  };\n\n  // Defer via a microtask so the router's own popstate handler (which starts the\n  // data fetch) has run before we correlate — the fetch is then already tracked.\n  const reportNavigation = (): void => {\n    queueMicrotask(() => {\n      void emitNavigation();\n    });\n  };\n\n  const patchHistory = (method: 'pushState' | 'replaceState'): void => {\n    const original = history[method].bind(history);\n    history[method] = (...args: Parameters<History['pushState']>): void => {\n      original(...args);\n      reportNavigation();\n    };\n  };\n  patchHistory('pushState');\n  patchHistory('replaceState');\n  window.addEventListener('popstate', reportNavigation);\n}\n"],"mappings":"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"}

package/dist/esm/hydration/index.d.ts

@@ -0,0 +1,4 @@
+import type { createRoute } from '@ossido-labs/ossido-router';
+type RouteTree = ReturnType<typeof createRoute>;
+export declare function hydrate(routeTree: RouteTree): void;
+export {};

package/dist/esm/hydration/index.js

@@ -0,0 +1,24 @@
+import { SERVER_PAYLOAD_VARIABLE_NAME } from "../constants.js";
+import { OssidoEntryPoint } from "../shared/OssidoEntryPoint.js";
+import { installBrowserLogForwarding } from "./browserLogForwarding.js";
+import { createRouter, preloadRouteChain } from "@ossido-labs/ossido-router";
+import { jsx } from "react/jsx-runtime";
+import { hydrateRoot } from "react-dom/client";
+import { warmDevErrorSource } from "@ossido-labs/ossido-ui";
+
+//#region src/hydration/index.tsx
+function hydrate(routeTree) {
+	if (window["__OSSIDO_SERVER_PAYLOAD__"]?.mode === "Dev") {
+		installBrowserLogForwarding();
+		warmDevErrorSource();
+	}
+	const router = createRouter({ routeTree });
+	const initialPathname = window["__OSSIDO_SERVER_PAYLOAD__"]?.location?.pathname ?? window.location.pathname;
+	preloadRouteChain(router, initialPathname).finally(() => {
+		hydrateRoot(document, /* @__PURE__ */ jsx(OssidoEntryPoint, { router }));
+	});
+}
+
+//#endregion
+export { hydrate };
+//# sourceMappingURL=index.js.map

package/dist/esm/hydration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/hydration/index.tsx"],"sourcesContent":["import { hydrateRoot } from 'react-dom/client';\nimport { createRouter, preloadRouteChain } from '@ossido-labs/ossido-router';\nimport type { createRoute } from '@ossido-labs/ossido-router';\nimport { warmDevErrorSource } from '@ossido-labs/ossido-ui';\n\nimport { OssidoEntryPoint } from '../shared/OssidoEntryPoint';\nimport { SERVER_PAYLOAD_VARIABLE_NAME } from '../constants';\n\nimport { installBrowserLogForwarding } from './browserLogForwarding';\n\ntype RouteTree = ReturnType<typeof createRoute>;\n\nexport function hydrate(routeTree: RouteTree): void {\n  // In development, mirror the browser console into the dev server console and\n  // prefetch the error-overlay's source-highlighting libraries up front (not on\n  // first error), so a highlighted excerpt is ready the moment one is needed.\n  if (window[SERVER_PAYLOAD_VARIABLE_NAME]?.mode === 'Dev') {\n    installBrowserLogForwarding();\n    warmDevErrorSource();\n  }\n\n  // Create a new router instance\n  const router = createRouter({ routeTree });\n\n  // Load the matched route's code (page + wrapping layouts) BEFORE hydrating:\n  // the server preloads the same chain and renders the page content inline, so\n  // the first client render must also resolve it synchronously — hydrating\n  // while the `React.lazy` chunk is still loading would mismatch that HTML.\n  const initialPathname =\n    window[SERVER_PAYLOAD_VARIABLE_NAME]?.location?.pathname ??\n    window.location.pathname;\n  void preloadRouteChain(router, initialPathname).finally(() => {\n    hydrateRoot(document, <OssidoEntryPoint router={router} />);\n  });\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,QAAQ,WAA4B;CAIlD,IAAI,mCAAoC,EAAE,SAAS,OAAO;EACxD,4BAA4B;EAC5B,mBAAmB;CACrB;CAGA,MAAM,SAAS,aAAa,EAAE,UAAU,CAAC;CAMzC,MAAM,kBACJ,mCAAoC,EAAE,UAAU,YAChD,OAAO,SAAS;CAClB,AAAK,kBAAkB,QAAQ,eAAe,CAAC,CAAC,cAAc;EAC5D,YAAY,UAAU,oBAAC,kBAAD,EAA0B,OAAS,EAAC;CAC5D,CAAC;AACH"}

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+export { createRoute, createRootRoute, createRouter, Link, useRouter, } from '@ossido-labs/ossido-router';
+export type { OssidoErrorProps } from '@ossido-labs/ossido-router';
+export { dynamic, RouteLazyLoading as __ossido__internal__lazyLoadRoute, } from './shared/dynamic';
+export { __ossido__internal__applyRouteHot } from './shared/routeHot';
+export { OssidoScripts } from './shared/OssidoScripts';
+export type { OssidoLayoutProps } from './types';

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { dynamic } from "./shared/dynamic/dynamic.js";
+import { RouteLazyLoading } from "./shared/dynamic/RouteLazyLoading.js";
+import { __ossido__internal__applyRouteHot } from "./shared/routeHot.js";
+import { OssidoScripts } from "./shared/OssidoScripts.js";
+import { Link, createRootRoute, createRoute, createRouter, useRouter } from "@ossido-labs/ossido-router";
+
+export { Link, OssidoScripts, __ossido__internal__applyRouteHot, RouteLazyLoading as __ossido__internal__lazyLoadRoute, createRootRoute, createRoute, createRouter, dynamic, useRouter };

package/dist/esm/shared/DevResources.d.ts

@@ -0,0 +1,7 @@
+import type { JSX } from 'react';
+import type { OssidoConfigServer } from '../config';
+interface DevResourcesProps {
+    devServerConfig?: OssidoConfigServer;
+}
+export declare const DevResources: ({ devServerConfig, }: DevResourcesProps) => JSX.Element;
+export {};

package/dist/esm/shared/DevResources.js

@@ -0,0 +1,45 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/shared/DevResources.tsx
+const DEFAULT_SERVER_CONFIG = {
+	host: "localhost",
+	origin: null,
+	port: 3e3
+};
+const VITE_PROXY_PATH = "/vite-server";
+const DevResources = ({ devServerConfig }) => {
+	const { host, origin, port } = devServerConfig ?? DEFAULT_SERVER_CONFIG;
+	const viteBaseUrl = origin != null ? `${origin}${VITE_PROXY_PATH}` : `http://${host}:${port}${VITE_PROXY_PATH}`;
+	/**
+	* These scripts must execute in order: the react-refresh preamble has to run
+	* (and set `__vite_plugin_react_preamble_installed__`) before `client-main`
+	* loads any React component, otherwise `@vitejs/plugin-react-swc` throws
+	* "can't detect preamble". `type="module"` already defers execution without
+	* blocking parsing, so `async` only removes the ordering guarantee and must
+	* NOT be used here — it caused an intermittent preamble race.
+	*/
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx("script", {
+			type: "module",
+			children: [
+				`import RefreshRuntime from '${viteBaseUrl}/@react-refresh'`,
+				"RefreshRuntime.injectIntoGlobalHook(window)",
+				"window.$RefreshReg$ = () => {}",
+				"window.$RefreshSig$ = () => (type) => type",
+				"window.__vite_plugin_react_preamble_installed__ = true"
+			].join("\n")
+		}),
+		/* @__PURE__ */ jsx("script", {
+			type: "module",
+			src: `${viteBaseUrl}/@vite/client`
+		}),
+		/* @__PURE__ */ jsx("script", {
+			type: "module",
+			src: `${viteBaseUrl}/client-main.tsx`
+		})
+	] });
+};
+
+//#endregion
+export { DevResources };
+//# sourceMappingURL=DevResources.js.map

package/dist/esm/shared/DevResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevResources.js","names":[],"sources":["../../../src/shared/DevResources.tsx"],"sourcesContent":["import type { JSX } from 'react';\n\nimport type { OssidoConfigServer } from '../config';\n\nconst DEFAULT_SERVER_CONFIG = { host: 'localhost', origin: null, port: 3000 };\nconst VITE_PROXY_PATH = '/vite-server';\n\ninterface DevResourcesProps {\n  devServerConfig?: OssidoConfigServer;\n}\n\nexport const DevResources = ({\n  devServerConfig,\n}: DevResourcesProps): JSX.Element => {\n  const { host, origin, port } = devServerConfig ?? DEFAULT_SERVER_CONFIG;\n\n  const viteBaseUrl =\n    origin != null\n      ? `${origin}${VITE_PROXY_PATH}`\n      : `http://${host}:${port}${VITE_PROXY_PATH}`;\n\n  /**\n   * These scripts must execute in order: the react-refresh preamble has to run\n   * (and set `__vite_plugin_react_preamble_installed__`) before `client-main`\n   * loads any React component, otherwise `@vitejs/plugin-react-swc` throws\n   * \"can't detect preamble\". `type=\"module\"` already defers execution without\n   * blocking parsing, so `async` only removes the ordering guarantee and must\n   * NOT be used here — it caused an intermittent preamble race.\n   */\n  return (\n    <>\n      <script type=\"module\">\n        {[\n          `import RefreshRuntime from '${viteBaseUrl}/@react-refresh'`,\n          'RefreshRuntime.injectIntoGlobalHook(window)',\n          'window.$RefreshReg$ = () => {}',\n          'window.$RefreshSig$ = () => (type) => type',\n          'window.__vite_plugin_react_preamble_installed__ = true',\n        ].join('\\n')}\n      </script>\n      <script type=\"module\" src={`${viteBaseUrl}/@vite/client`}></script>\n      <script type=\"module\" src={`${viteBaseUrl}/client-main.tsx`}></script>\n    </>\n  );\n};\n"],"mappings":";;;AAIA,MAAM,wBAAwB;CAAE,MAAM;CAAa,QAAQ;CAAM,MAAM;AAAK;AAC5E,MAAM,kBAAkB;AAMxB,MAAa,gBAAgB,EAC3B,sBACoC;CACpC,MAAM,EAAE,MAAM,QAAQ,SAAS,mBAAmB;CAElD,MAAM,cACJ,UAAU,OACN,GAAG,SAAS,oBACZ,UAAU,KAAK,GAAG,OAAO;;;;;;;;;CAU/B,OACE;EACE,oBAAC,UAAD;GAAQ,MAAK;aACV;IACC,+BAA+B,YAAY;IAC3C;IACA;IACA;IACA;GACF,CAAC,CAAC,KAAK,IAAI;EACL;EACR,oBAAC,UAAD;GAAQ,MAAK;GAAS,KAAK,GAAG,YAAY;EAAwB;EAClE,oBAAC,UAAD;GAAQ,MAAK;GAAS,KAAK,GAAG,YAAY;EAA2B;CACrE;AAEN"}

package/dist/esm/shared/OssidoContext.d.ts

@@ -0,0 +1,14 @@
+import type { JSX, ReactNode } from 'react';
+import type { ServerPayload } from '../types';
+interface OssidoContextProviderProps {
+    serverPayload?: ServerPayload;
+    rawServerPayload?: string;
+    children: ReactNode;
+}
+/**
+ * @warning THIS SHOULD NOT BE EXPOSED TO USERLAND
+ *
+ * @see https://github.com/tuono-labs/tuono/issues/410
+ */
+export declare function OssidoContextProvider({ serverPayload, rawServerPayload, children, }: OssidoContextProviderProps): JSX.Element;
+export {};

package/dist/esm/shared/OssidoContext.js

@@ -0,0 +1,28 @@
+import { SERVER_PAYLOAD_VARIABLE_NAME } from "../constants.js";
+import { OssidoContext } from "./ossido-context.js";
+import { useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/shared/OssidoContext.tsx
+const isServerSide = typeof window === "undefined";
+/**
+* @warning THIS SHOULD NOT BE EXPOSED TO USERLAND
+*
+* @see https://github.com/tuono-labs/tuono/issues/410
+*/
+function OssidoContextProvider({ serverPayload, rawServerPayload, children }) {
+	const contextValue = useMemo(() => {
+		return {
+			serverPayload: isServerSide ? serverPayload : window[SERVER_PAYLOAD_VARIABLE_NAME],
+			rawServerPayload
+		};
+	}, [serverPayload, rawServerPayload]);
+	return /* @__PURE__ */ jsx(OssidoContext, {
+		value: contextValue,
+		children
+	});
+}
+
+//#endregion
+export { OssidoContextProvider };
+//# sourceMappingURL=OssidoContext.js.map

package/dist/esm/shared/OssidoContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OssidoContext.js","names":[],"sources":["../../../src/shared/OssidoContext.tsx"],"sourcesContent":["import type { JSX, ReactNode } from 'react';\nimport { useMemo } from 'react';\n\nimport type { ServerPayload } from '../types';\nimport { SERVER_PAYLOAD_VARIABLE_NAME } from '../constants';\n\nimport { OssidoContext, type OssidoContextValue } from './ossido-context';\n\nconst isServerSide = typeof window === 'undefined';\n\ninterface OssidoContextProviderProps {\n  serverPayload?: ServerPayload;\n  rawServerPayload?: string;\n\n  children: ReactNode;\n}\n\n/**\n * @warning THIS SHOULD NOT BE EXPOSED TO USERLAND\n *\n * @see https://github.com/tuono-labs/tuono/issues/410\n */\nexport function OssidoContextProvider({\n  serverPayload,\n  rawServerPayload,\n  children,\n}: OssidoContextProviderProps): JSX.Element {\n  const contextValue: OssidoContextValue = useMemo(() => {\n    // At least one of these two should be defined\n    const _serverPayload = (\n      isServerSide ? serverPayload : window[SERVER_PAYLOAD_VARIABLE_NAME]\n    ) as ServerPayload;\n\n    return {\n      // Maybe this logic should be integrated using defaults\n      serverPayload: _serverPayload,\n      rawServerPayload,\n    };\n  }, [serverPayload, rawServerPayload]);\n\n  return <OssidoContext value={contextValue}>{children}</OssidoContext>;\n}\n"],"mappings":";;;;;;AAQA,MAAM,eAAe,OAAO,WAAW;;;;;;AAcvC,SAAgB,sBAAsB,EACpC,eACA,kBACA,YAC0C;CAC1C,MAAM,eAAmC,cAAc;EAMrD,OAAO;GAEL,eALA,eAAe,gBAAgB,OAAO;GAMtC;EACF;CACF,GAAG,CAAC,eAAe,gBAAgB,CAAC;CAEpC,OAAO,oBAAC,eAAD;EAAe,OAAO;EAAe;CAAwB;AACtE"}

package/dist/esm/shared/OssidoEntryPoint.d.ts

@@ -0,0 +1,11 @@
+import type { JSX } from 'react';
+import type { RouterInstanceType } from '@ossido-labs/ossido-router';
+import type { ServerPayload } from '../types';
+interface OssidoEntryPointProps {
+    router: RouterInstanceType;
+    serverPayload?: ServerPayload;
+    /** The raw payload JSON (server render only) — see {@link OssidoContext}. */
+    rawServerPayload?: string;
+}
+export declare function OssidoEntryPoint({ router, serverPayload, rawServerPayload, }: OssidoEntryPointProps): JSX.Element;
+export {};

package/dist/esm/shared/OssidoEntryPoint.js

@@ -0,0 +1,17 @@
+import { OssidoContextProvider } from "./OssidoContext.js";
+import { RouterContextProviderWrapper } from "./RouterContextProviderWrapper.js";
+import { StrictMode } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/shared/OssidoEntryPoint.tsx
+function OssidoEntryPoint({ router, serverPayload, rawServerPayload }) {
+	return /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(OssidoContextProvider, {
+		serverPayload,
+		rawServerPayload,
+		children: /* @__PURE__ */ jsx(RouterContextProviderWrapper, { router })
+	}) });
+}
+
+//#endregion
+export { OssidoEntryPoint };
+//# sourceMappingURL=OssidoEntryPoint.js.map

package/dist/esm/shared/OssidoEntryPoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OssidoEntryPoint.js","names":[],"sources":["../../../src/shared/OssidoEntryPoint.tsx"],"sourcesContent":["import { StrictMode } from 'react';\nimport type { JSX } from 'react';\nimport type { RouterInstanceType } from '@ossido-labs/ossido-router';\n\nimport type { ServerPayload } from '../types';\n\nimport { OssidoContextProvider } from './OssidoContext';\nimport { RouterContextProviderWrapper } from './RouterContextProviderWrapper';\n\ninterface OssidoEntryPointProps {\n  router: RouterInstanceType;\n  serverPayload?: ServerPayload;\n  /** The raw payload JSON (server render only) — see {@link OssidoContext}. */\n  rawServerPayload?: string;\n}\n\nexport function OssidoEntryPoint({\n  router,\n  serverPayload,\n  rawServerPayload,\n}: OssidoEntryPointProps): JSX.Element {\n  return (\n    <StrictMode>\n      <OssidoContextProvider\n        serverPayload={serverPayload}\n        rawServerPayload={rawServerPayload}\n      >\n        <RouterContextProviderWrapper router={router} />\n      </OssidoContextProvider>\n    </StrictMode>\n  );\n}\n"],"mappings":";;;;;;AAgBA,SAAgB,iBAAiB,EAC/B,QACA,eACA,oBACqC;CACrC,OACE,oBAAC,YAAD,YACE,oBAAC,uBAAD;EACiB;EACG;YAElB,oBAAC,8BAAD,EAAsC,OAAS;CAC1B,GACb;AAEhB"}

package/dist/esm/shared/OssidoScripts.d.ts

@@ -0,0 +1,2 @@
+import type { JSX } from 'react';
+export declare function OssidoScripts(): JSX.Element;

package/dist/esm/shared/OssidoScripts.js

@@ -0,0 +1,34 @@
+import { SERVER_PAYLOAD_VARIABLE_NAME } from "../constants.js";
+import { DevResources } from "./DevResources.js";
+import { ProdResources } from "./ProdResources.js";
+import { useOssidoContextRawServerPayload, useOssidoContextServerPayload } from "./ossido-context.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/shared/OssidoScripts.tsx
+/**
+* The payload is embedded as a JS expression inside a `<script>`, so a string
+* value containing `<\/script>` (or `<!--`) could otherwise break out of the tag.
+* Escaping `<` to its unicode form neutralises that while remaining valid JSON.
+*/
+function escapeForScript(json) {
+	return json.replace(/</g, "\\u003c");
+}
+function OssidoScripts() {
+	const serverPayload = useOssidoContextServerPayload();
+	const payloadJson = useOssidoContextRawServerPayload() ?? JSON.stringify(serverPayload);
+	return /* @__PURE__ */ jsxs(Fragment, { children: [
+		/* @__PURE__ */ jsx("script", {
+			suppressHydrationWarning: true,
+			dangerouslySetInnerHTML: { __html: `window['${SERVER_PAYLOAD_VARIABLE_NAME}']=${escapeForScript(payloadJson)}` }
+		}),
+		serverPayload.mode === "Dev" && /* @__PURE__ */ jsx(DevResources, { devServerConfig: serverPayload.devServerConfig }),
+		serverPayload.mode === "Prod" && /* @__PURE__ */ jsx(ProdResources, {
+			jsBundles: serverPayload.jsBundles,
+			cssBundles: serverPayload.cssBundles
+		})
+	] });
+}
+
+//#endregion
+export { OssidoScripts };
+//# sourceMappingURL=OssidoScripts.js.map

package/dist/esm/shared/OssidoScripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OssidoScripts.js","names":[],"sources":["../../../src/shared/OssidoScripts.tsx"],"sourcesContent":["import type { JSX } from 'react';\n\nimport { SERVER_PAYLOAD_VARIABLE_NAME } from '../constants';\n\nimport { DevResources } from './DevResources';\nimport { ProdResources } from './ProdResources';\nimport {\n  useOssidoContextRawServerPayload,\n  useOssidoContextServerPayload,\n} from './ossido-context';\n\n/**\n * The payload is embedded as a JS expression inside a `<script>`, so a string\n * value containing `</script>` (or `<!--`) could otherwise break out of the tag.\n * Escaping `<` to its unicode form neutralises that while remaining valid JSON.\n */\nfunction escapeForScript(json: string): string {\n  return json.replace(/</g, '\\\\u003c');\n}\n\nexport function OssidoScripts(): JSX.Element {\n  const serverPayload = useOssidoContextServerPayload();\n  const rawServerPayload = useOssidoContextRawServerPayload();\n\n  // On the server, reuse the exact JSON the Rust runtime already produced —\n  // avoiding a second full `JSON.stringify` of the payload inside V8. On the\n  // client the raw string isn't available, so fall back to stringifying the\n  // parsed payload; that output is discarded during hydration\n  // (`suppressHydrationWarning` keeps the server-rendered script, which has\n  // already executed and set `window[...]`).\n  const payloadJson = rawServerPayload ?? JSON.stringify(serverPayload);\n\n  return (\n    <>\n      <script\n        suppressHydrationWarning\n        dangerouslySetInnerHTML={{\n          __html: `window['${SERVER_PAYLOAD_VARIABLE_NAME}']=${escapeForScript(payloadJson)}`,\n        }}\n      />\n      {serverPayload.mode === 'Dev' && (\n        <DevResources devServerConfig={serverPayload.devServerConfig} />\n      )}\n      {serverPayload.mode === 'Prod' && (\n        <ProdResources\n          jsBundles={serverPayload.jsBundles}\n          cssBundles={serverPayload.cssBundles}\n        />\n      )}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAgBA,SAAS,gBAAgB,MAAsB;CAC7C,OAAO,KAAK,QAAQ,MAAM,SAAS;AACrC;AAEA,SAAgB,gBAA6B;CAC3C,MAAM,gBAAgB,8BAA8B;CASpD,MAAM,cARmB,iCAQU,KAAK,KAAK,UAAU,aAAa;CAEpE,OACE;EACE,oBAAC,UAAD;GACE;GACA,yBAAyB,EACvB,QAAQ,WAAW,6BAA6B,KAAK,gBAAgB,WAAW,IAClF;EACD;EACA,cAAc,SAAS,SACtB,oBAAC,cAAD,EAAc,iBAAiB,cAAc,gBAAkB;EAEhE,cAAc,SAAS,UACtB,oBAAC,eAAD;GACE,WAAW,cAAc;GACzB,YAAY,cAAc;EAC3B;CAEH;AAEN"}

package/dist/esm/shared/ProdResources.d.ts

@@ -0,0 +1,7 @@
+import type { JSX } from 'react';
+interface ProdResourcesProps {
+    jsBundles: Array<string> | null;
+    cssBundles: Array<string> | null;
+}
+export declare const ProdResources: ({ cssBundles, jsBundles, }: ProdResourcesProps) => JSX.Element;
+export {};

package/dist/esm/shared/ProdResources.js

@@ -0,0 +1,18 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/shared/ProdResources.tsx
+const ProdResources = ({ cssBundles, jsBundles }) => {
+	return /* @__PURE__ */ jsxs(Fragment, { children: [cssBundles?.map((cssHref) => /* @__PURE__ */ jsx("link", {
+		rel: "stylesheet",
+		precedence: "high",
+		type: "text/css",
+		href: `/${cssHref}`
+	}, cssHref)), jsBundles?.map((scriptSrc) => /* @__PURE__ */ jsx("script", {
+		type: "module",
+		src: `/${scriptSrc}`
+	}, scriptSrc))] });
+};
+
+//#endregion
+export { ProdResources };
+//# sourceMappingURL=ProdResources.js.map

package/dist/esm/shared/ProdResources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProdResources.js","names":[],"sources":["../../../src/shared/ProdResources.tsx"],"sourcesContent":["import type { JSX } from 'react';\n\ninterface ProdResourcesProps {\n  jsBundles: Array<string> | null;\n  cssBundles: Array<string> | null;\n}\n\nexport const ProdResources = ({\n  cssBundles,\n  jsBundles,\n}: ProdResourcesProps): JSX.Element => {\n  return (\n    <>\n      {cssBundles?.map((cssHref) => (\n        <link\n          key={cssHref}\n          rel=\"stylesheet\"\n          precedence=\"high\"\n          type=\"text/css\"\n          href={`/${cssHref}`}\n        />\n      ))}\n\n      {jsBundles?.map((scriptSrc) => (\n        <script key={scriptSrc} type=\"module\" src={`/${scriptSrc}`}></script>\n      ))}\n    </>\n  );\n};\n"],"mappings":";;;AAOA,MAAa,iBAAiB,EAC5B,YACA,gBACqC;CACrC,OACE,4CACG,YAAY,KAAK,YAChB,oBAAC,QAAD;EAEE,KAAI;EACJ,YAAW;EACX,MAAK;EACL,MAAM,IAAI;CACX,GALM,OAKN,CACF,GAEA,WAAW,KAAK,cACf,oBAAC,UAAD;EAAwB,MAAK;EAAS,KAAK,IAAI;CAAqB,GAAvD,SAAuD,CACrE,CACD;AAEN"}

package/dist/esm/shared/RouterContextProviderWrapper.d.ts

@@ -0,0 +1,14 @@
+import type { JSX } from 'react';
+import type { RouterInstanceType } from '@ossido-labs/ossido-router';
+interface RouterContextProviderWrapperProps {
+    router: RouterInstanceType;
+}
+/**
+ * This component is needed to get the data from {@link OssidoContext}
+ * since the provider is also located in {@link OssidoEntryPoint}
+ * hence the context cannot be accessed directly there
+ *
+ * @see https://github.com/tuono-labs/tuono/issues/410
+ */
+export declare function RouterContextProviderWrapper({ router, }: RouterContextProviderWrapperProps): JSX.Element;
+export {};

package/dist/esm/shared/RouterContextProviderWrapper.js

@@ -0,0 +1,27 @@
+import { useOssidoContextServerPayload } from "./ossido-context.js";
+import { RouterProvider } from "@ossido-labs/ossido-router";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/shared/RouterContextProviderWrapper.tsx
+/**
+* This component is needed to get the data from {@link OssidoContext}
+* since the provider is also located in {@link OssidoEntryPoint}
+* hence the context cannot be accessed directly there
+*
+* @see https://github.com/tuono-labs/tuono/issues/410
+*/
+function RouterContextProviderWrapper({ router }) {
+	const serverPayload = useOssidoContextServerPayload();
+	return /* @__PURE__ */ jsx(RouterProvider, {
+		router,
+		serverInitialLocation: serverPayload.location,
+		serverInitialData: serverPayload.data,
+		serverInitialLayoutData: serverPayload.layoutData,
+		serverInitialError: serverPayload.serverError,
+		mode: serverPayload.mode
+	});
+}
+
+//#endregion
+export { RouterContextProviderWrapper };
+//# sourceMappingURL=RouterContextProviderWrapper.js.map

package/dist/esm/shared/RouterContextProviderWrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterContextProviderWrapper.js","names":[],"sources":["../../../src/shared/RouterContextProviderWrapper.tsx"],"sourcesContent":["import type { JSX } from 'react';\nimport { RouterProvider } from '@ossido-labs/ossido-router';\nimport type { RouterInstanceType } from '@ossido-labs/ossido-router';\n\nimport { useOssidoContextServerPayload } from './ossido-context';\n\ninterface RouterContextProviderWrapperProps {\n  router: RouterInstanceType;\n}\n\n/**\n * This component is needed to get the data from {@link OssidoContext}\n * since the provider is also located in {@link OssidoEntryPoint}\n * hence the context cannot be accessed directly there\n *\n * @see https://github.com/tuono-labs/tuono/issues/410\n */\nexport function RouterContextProviderWrapper({\n  router,\n}: RouterContextProviderWrapperProps): JSX.Element {\n  const serverPayload = useOssidoContextServerPayload();\n\n  return (\n    <RouterProvider\n      router={router}\n      serverInitialLocation={serverPayload.location}\n      serverInitialData={serverPayload.data}\n      serverInitialLayoutData={serverPayload.layoutData}\n      serverInitialError={serverPayload.serverError}\n      // Read `mode` from the payload context (available on server AND client);\n      // the client `hydrateRoot` passes no `serverPayload` prop, so a prop-based\n      // mode would be `undefined` during hydration.\n      mode={serverPayload.mode}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,SAAgB,6BAA6B,EAC3C,UACiD;CACjD,MAAM,gBAAgB,8BAA8B;CAEpD,OACE,oBAAC,gBAAD;EACU;EACR,uBAAuB,cAAc;EACrC,mBAAmB,cAAc;EACjC,yBAAyB,cAAc;EACvC,oBAAoB,cAAc;EAIlC,MAAM,cAAc;CACrB;AAEL"}

package/dist/esm/shared/dynamic/RouteLazyLoading.d.ts

@@ -0,0 +1,6 @@
+import type { RouteComponent } from '@ossido-labs/ossido-router';
+type ImportFn = () => Promise<{
+    default: RouteComponent;
+}>;
+export declare const RouteLazyLoading: (factory: ImportFn) => RouteComponent;
+export {};

package/dist/esm/shared/dynamic/RouteLazyLoading.js

@@ -0,0 +1,20 @@
+import { createElement, lazy } from "react";
+
+//#region src/shared/dynamic/RouteLazyLoading.tsx
+const RouteLazyLoading = (factory) => {
+	let LoadedComponent;
+	const LazyComponent = lazy(factory);
+	const loadComponent = () => factory().then((module) => {
+		LoadedComponent = module.default;
+	});
+	const Component = (props) => createElement(LoadedComponent || LazyComponent, props);
+	Component.preload = loadComponent;
+	if (import.meta.env.DEV) Component.update = (next) => {
+		LoadedComponent = next;
+	};
+	return Component;
+};
+
+//#endregion
+export { RouteLazyLoading };
+//# sourceMappingURL=RouteLazyLoading.js.map

package/dist/esm/shared/dynamic/RouteLazyLoading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteLazyLoading.js","names":[],"sources":["../../../../src/shared/dynamic/RouteLazyLoading.tsx"],"sourcesContent":["import { lazy, createElement } from 'react';\nimport type { ReactElement } from 'react';\n\nimport type { RouteComponent } from '@ossido-labs/ossido-router';\n\ntype ImportFn = () => Promise<{ default: RouteComponent }>;\n\nexport const RouteLazyLoading = (factory: ImportFn): RouteComponent => {\n  let LoadedComponent: RouteComponent | undefined;\n  const LazyComponent = lazy<RouteComponent>(factory);\n\n  const loadComponent = (): Promise<void> =>\n    factory().then((module) => {\n      LoadedComponent = module.default;\n    });\n\n  const Component = (\n    props: React.ComponentProps<RouteComponent>,\n  ): ReactElement => createElement(LoadedComponent || LazyComponent, props);\n\n  Component.preload = loadComponent;\n\n  // Dev-only: HMR swaps the resolved component in place when a route-module edit\n  // breaks React Fast Refresh (otherwise vite escalates to a full page reload).\n  // The generated route tree calls this from its `import.meta.hot.accept`\n  // handler; a router re-render then renders the new component. Absent in prod.\n  if (import.meta.env.DEV) {\n    Component.update = (next: RouteComponent): void => {\n      LoadedComponent = next;\n    };\n  }\n\n  return Component;\n};\n"],"mappings":";;;AAOA,MAAa,oBAAoB,YAAsC;CACrE,IAAI;CACJ,MAAM,gBAAgB,KAAqB,OAAO;CAElD,MAAM,sBACJ,QAAQ,CAAC,CAAC,MAAM,WAAW;EACzB,kBAAkB,OAAO;CAC3B,CAAC;CAEH,MAAM,aACJ,UACiB,cAAc,mBAAmB,eAAe,KAAK;CAExE,UAAU,UAAU;CAMpB,IAAI,YAAY,IAAI,KAClB,UAAU,UAAU,SAA+B;EACjD,kBAAkB;CACpB;CAGF,OAAO;AACT"}

package/dist/esm/shared/dynamic/dynamic.d.ts

@@ -0,0 +1,15 @@
+import type { ComponentType } from 'react';
+interface ComponentModule<T> {
+    default: React.ComponentType<T>;
+}
+interface DynamicOptions {
+    ssr?: boolean;
+    loading?: React.ComponentType<unknown> | null;
+}
+type Loader<T = object> = () => Promise<React.ComponentType<T> | ComponentModule<T>>;
+/**
+ * This function lets you dynamically import a component.
+ * It uses [React.lazy()](https://react.dev/reference/react/lazy) with [Suspense](https://react.dev/reference/react/Suspense) under the hood.
+ */
+export declare function dynamic<T = object>(importFn: Loader<T>, opts?: DynamicOptions): ComponentType<T>;
+export {};

package/dist/esm/shared/dynamic/dynamic.js

@@ -0,0 +1,57 @@
+import { Fragment, Suspense, lazy } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/shared/dynamic/dynamic.tsx
+/**
+* This component is heavily inspired by Next.js dynamic function
+* Link: https://github.com/vercel/next.js/blob/1df81bcea62800198884438a2bb27ba14c9d506a/packages/next/src/shared/lib/dynamic.tsx
+*/
+const isServerSide = typeof window === "undefined";
+const defaultLoaderOptions = {
+	ssr: true,
+	loading: null,
+	loader: () => Promise.resolve(() => null)
+};
+function noSSR(LoadableInitializer, loadableOptions) {
+	if (!isServerSide) return LoadableInitializer(loadableOptions);
+	if (!loadableOptions.loading) return () => null;
+	const Loading = loadableOptions.loading;
+	function NoSSRLoading() {
+		return /* @__PURE__ */ jsx(Loading, {});
+	}
+	return NoSSRLoading;
+}
+function Loadable(options) {
+	const opts = {
+		...defaultLoaderOptions,
+		...options
+	};
+	const Lazy = lazy(() => opts.loader().then());
+	const Loading = opts.loading;
+	function LoadableComponent(props) {
+		return /* @__PURE__ */ jsx(Loading ? Suspense : Fragment, {
+			...Loading ? { fallback: Loading ? /* @__PURE__ */ jsx(Loading, {}) : null } : {},
+			children: /* @__PURE__ */ jsx(Lazy, { ...props })
+		});
+	}
+	LoadableComponent.displayName = "LoadableComponent";
+	return LoadableComponent;
+}
+/**
+* This function lets you dynamically import a component.
+* It uses [React.lazy()](https://react.dev/reference/react/lazy) with [Suspense](https://react.dev/reference/react/Suspense) under the hood.
+*/
+function dynamic(importFn, opts) {
+	if (typeof opts?.ssr === "boolean" && !opts.ssr) return noSSR(Loadable, {
+		...opts,
+		loader: importFn
+	});
+	return Loadable({
+		...opts,
+		loader: importFn
+	});
+}
+
+//#endregion
+export { dynamic };
+//# sourceMappingURL=dynamic.js.map

package/dist/esm/shared/dynamic/dynamic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic.js","names":[],"sources":["../../../../src/shared/dynamic/dynamic.tsx"],"sourcesContent":["/**\n * This component is heavily inspired by Next.js dynamic function\n * Link: https://github.com/vercel/next.js/blob/1df81bcea62800198884438a2bb27ba14c9d506a/packages/next/src/shared/lib/dynamic.tsx\n */\n// This module is a dynamic-import HOC factory: it defines internal components\n// and exports `dynamic` (which returns a component). There is no top-level\n// component here whose state a hot reload would drop, so the Fast Refresh\n// boundary rule doesn't apply.\n/* eslint-disable react-refresh/only-export-components */\nimport { lazy, Suspense, Fragment } from 'react';\nimport type { ComponentType } from 'react';\n\nconst isServerSide = typeof window === 'undefined';\n\ninterface ComponentModule<T> {\n  default: React.ComponentType<T>;\n}\n\ninterface DynamicOptions {\n  ssr?: boolean;\n  loading?: React.ComponentType<unknown> | null;\n}\n\ntype Loader<T = object> = () => Promise<\n  React.ComponentType<T> | ComponentModule<T>\n>;\n\ninterface LoadableOptions<T> extends DynamicOptions {\n  loader: Loader<T>;\n}\n\ntype LoadableFn = <T = object>(options: LoadableOptions<T>) => ComponentType<T>;\n\nconst defaultLoaderOptions: LoadableOptions<object> = {\n  ssr: true,\n  loading: null,\n  loader: () => Promise.resolve(() => null),\n};\n\nfunction noSSR<T = object>(\n  LoadableInitializer: LoadableFn,\n  loadableOptions: LoadableOptions<T>,\n): React.ComponentType<T> {\n  if (!isServerSide) {\n    return LoadableInitializer(loadableOptions);\n  }\n\n  if (!loadableOptions.loading) return () => null;\n\n  const Loading = loadableOptions.loading;\n  // This will only be rendered on the server side\n  function NoSSRLoading(): React.JSX.Element {\n    return <Loading />;\n  }\n  return NoSSRLoading;\n}\n\nfunction Loadable<T = object>(options: LoadableOptions<T>): ComponentType<T> {\n  const opts = { ...defaultLoaderOptions, ...options };\n  const Lazy = lazy(() => opts.loader().then());\n  const Loading = opts.loading;\n\n  function LoadableComponent(props: T): React.JSX.Element {\n    const fallbackElement = Loading ? <Loading /> : null;\n\n    const Wrap = Loading ? Suspense : Fragment;\n    const wrapProps = Loading ? { fallback: fallbackElement } : {};\n\n    // TODO: In case ssr = false handle also the assets preloading\n    return (\n      <Wrap {...wrapProps}>\n        <Lazy {...props} />\n      </Wrap>\n    );\n  }\n  LoadableComponent.displayName = 'LoadableComponent';\n\n  return LoadableComponent;\n}\n\n/**\n * This function lets you dynamically import a component.\n * It uses [React.lazy()](https://react.dev/reference/react/lazy) with [Suspense](https://react.dev/reference/react/Suspense) under the hood.\n */\nexport function dynamic<T = object>(\n  importFn: Loader<T>,\n  opts?: DynamicOptions,\n): ComponentType<T> {\n  if (typeof opts?.ssr === 'boolean' && !opts.ssr) {\n    return noSSR<T>(Loadable, { ...opts, loader: importFn });\n  }\n  return Loadable<T>({ ...opts, loader: importFn });\n}\n"],"mappings":";;;;;;;;AAYA,MAAM,eAAe,OAAO,WAAW;AAqBvC,MAAM,uBAAgD;CACpD,KAAK;CACL,SAAS;CACT,cAAc,QAAQ,cAAc,IAAI;AAC1C;AAEA,SAAS,MACP,qBACA,iBACwB;CACxB,IAAI,CAAC,cACH,OAAO,oBAAoB,eAAe;CAG5C,IAAI,CAAC,gBAAgB,SAAS,aAAa;CAE3C,MAAM,UAAU,gBAAgB;CAEhC,SAAS,eAAkC;EACzC,OAAO,oBAAC,SAAD,CAAU;CACnB;CACA,OAAO;AACT;AAEA,SAAS,SAAqB,SAA+C;CAC3E,MAAM,OAAO;EAAE,GAAG;EAAsB,GAAG;CAAQ;CACnD,MAAM,OAAO,WAAW,KAAK,OAAO,CAAC,CAAC,KAAK,CAAC;CAC5C,MAAM,UAAU,KAAK;CAErB,SAAS,kBAAkB,OAA6B;EAOtD,OACE,oBALW,UAAU,WAAW,UAKhC;GAAM,GAJU,UAAU,EAAE,UAHN,UAAU,oBAAC,SAAD,CAAU,KAAI,KAGQ,IAAI,CAAC;aAKzD,oBAAC,MAAD,EAAM,GAAI,MAAQ;EACd;CAEV;CACA,kBAAkB,cAAc;CAEhC,OAAO;AACT;;;;;AAMA,SAAgB,QACd,UACA,MACkB;CAClB,IAAI,OAAO,MAAM,QAAQ,aAAa,CAAC,KAAK,KAC1C,OAAO,MAAS,UAAU;EAAE,GAAG;EAAM,QAAQ;CAAS,CAAC;CAEzD,OAAO,SAAY;EAAE,GAAG;EAAM,QAAQ;CAAS,CAAC;AAClD"}

package/dist/esm/shared/dynamic/index.d.ts

@@ -0,0 +1,2 @@
+export { dynamic } from './dynamic';
+export { RouteLazyLoading } from './RouteLazyLoading';

package/dist/esm/shared/ossido-context.d.ts

@@ -0,0 +1,22 @@
+import type { ServerPayload } from '../types';
+export interface OssidoContextValue {
+    serverPayload: ServerPayload;
+    /**
+     * The exact JSON string the Rust runtime produced for this render, available
+     * only on the server. `OssidoScripts` embeds it verbatim instead of
+     * re-`JSON.stringify`-ing the parsed payload inside V8. Undefined on the
+     * client (which reads the already-parsed object off `window`).
+     */
+    rawServerPayload?: string;
+}
+export declare const OssidoContext: import("react").Context<OssidoContextValue>;
+/**
+ * @warning THIS SHOULD NOT BE EXPOSED TO USERLAND
+ */
+export declare function useOssidoContextServerPayload(): OssidoContextValue['serverPayload'];
+/**
+ * @warning THIS SHOULD NOT BE EXPOSED TO USERLAND
+ *
+ * The raw server payload JSON (server render only); undefined on the client.
+ */
+export declare function useOssidoContextRawServerPayload(): OssidoContextValue['rawServerPayload'];

package/dist/esm/shared/ossido-context.js

@@ -0,0 +1,22 @@
+import { createContext, useContext } from "react";
+
+//#region src/shared/ossido-context.ts
+const OssidoContext = createContext({});
+/**
+* @warning THIS SHOULD NOT BE EXPOSED TO USERLAND
+*/
+function useOssidoContextServerPayload() {
+	return useContext(OssidoContext).serverPayload;
+}
+/**
+* @warning THIS SHOULD NOT BE EXPOSED TO USERLAND
+*
+* The raw server payload JSON (server render only); undefined on the client.
+*/
+function useOssidoContextRawServerPayload() {
+	return useContext(OssidoContext).rawServerPayload;
+}
+
+//#endregion
+export { OssidoContext, useOssidoContextRawServerPayload, useOssidoContextServerPayload };
+//# sourceMappingURL=ossido-context.js.map

package/dist/esm/shared/ossido-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ossido-context.js","names":[],"sources":["../../../src/shared/ossido-context.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nimport type { ServerPayload } from '../types';\n\nexport interface OssidoContextValue {\n  serverPayload: ServerPayload;\n  /**\n   * The exact JSON string the Rust runtime produced for this render, available\n   * only on the server. `OssidoScripts` embeds it verbatim instead of\n   * re-`JSON.stringify`-ing the parsed payload inside V8. Undefined on the\n   * client (which reads the already-parsed object off `window`).\n   */\n  rawServerPayload?: string;\n}\n\nexport const OssidoContext = createContext({} as OssidoContextValue);\n\n/**\n * @warning THIS SHOULD NOT BE EXPOSED TO USERLAND\n */\nexport function useOssidoContextServerPayload(): OssidoContextValue['serverPayload'] {\n  return useContext(OssidoContext).serverPayload;\n}\n\n/**\n * @warning THIS SHOULD NOT BE EXPOSED TO USERLAND\n *\n * The raw server payload JSON (server render only); undefined on the client.\n */\nexport function useOssidoContextRawServerPayload(): OssidoContextValue['rawServerPayload'] {\n  return useContext(OssidoContext).rawServerPayload;\n}\n"],"mappings":";;;AAeA,MAAa,gBAAgB,cAAc,CAAC,CAAuB;;;;AAKnE,SAAgB,gCAAqE;CACnF,OAAO,WAAW,aAAa,CAAC,CAAC;AACnC;;;;;;AAOA,SAAgB,mCAA2E;CACzF,OAAO,WAAW,aAAa,CAAC,CAAC;AACnC"}

package/dist/esm/shared/routeHot.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Dev-only. Runs the generated route tree's component reassignments (swapping
+ * the route components affected by an HMR update), then bumps the router hot
+ * store so the match tree re-renders with them.
+ *
+ * Called from the `import.meta.hot.accept(...)` block the route generator emits.
+ * That block is guarded by `if (import.meta.hot)`, so prod builds dead-code
+ * eliminate it and tree-shake this helper away.
+ */
+export declare function __ossido__internal__applyRouteHot(apply: () => void): void;

package/dist/esm/shared/routeHot.js

@@ -0,0 +1,20 @@
+import { notifyRouteHotUpdate } from "@ossido-labs/ossido-router";
+
+//#region src/shared/routeHot.ts
+/**
+* Dev-only. Runs the generated route tree's component reassignments (swapping
+* the route components affected by an HMR update), then bumps the router hot
+* store so the match tree re-renders with them.
+*
+* Called from the `import.meta.hot.accept(...)` block the route generator emits.
+* That block is guarded by `if (import.meta.hot)`, so prod builds dead-code
+* eliminate it and tree-shake this helper away.
+*/
+function __ossido__internal__applyRouteHot(apply) {
+	apply();
+	notifyRouteHotUpdate();
+}
+
+//#endregion
+export { __ossido__internal__applyRouteHot };
+//# sourceMappingURL=routeHot.js.map

package/dist/esm/shared/routeHot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeHot.js","names":[],"sources":["../../../src/shared/routeHot.ts"],"sourcesContent":["import { notifyRouteHotUpdate } from '@ossido-labs/ossido-router';\n\n/**\n * Dev-only. Runs the generated route tree's component reassignments (swapping\n * the route components affected by an HMR update), then bumps the router hot\n * store so the match tree re-renders with them.\n *\n * Called from the `import.meta.hot.accept(...)` block the route generator emits.\n * That block is guarded by `if (import.meta.hot)`, so prod builds dead-code\n * eliminate it and tree-shake this helper away.\n */\nexport function __ossido__internal__applyRouteHot(apply: () => void): void {\n  apply();\n  notifyRouteHotUpdate();\n}\n"],"mappings":";;;;;;;;;;;;AAWA,SAAgB,kCAAkC,OAAyB;CACzE,MAAM;CACN,qBAAqB;AACvB"}

package/dist/esm/ssr/index.d.ts

@@ -0,0 +1,4 @@
+export { serverSideRendering } from './server';
+export { MessageChannelPolyfill } from './polyfills/MessageChannel';
+export { EventPolyfill } from './polyfills/Event';
+export { MessageEventPolyfill } from './polyfills/MessageEvent';

package/dist/esm/ssr/index.js

@@ -0,0 +1,6 @@
+import { MessageChannelPolyfill } from "./polyfills/MessageChannel.js";
+import { serverSideRendering } from "./server.js";
+import { EventPolyfill } from "./polyfills/Event.js";
+import { MessageEventPolyfill } from "./polyfills/MessageEvent.js";
+
+export { EventPolyfill, MessageChannelPolyfill, MessageEventPolyfill, serverSideRendering };

package/dist/esm/ssr/polyfills/Event.d.ts

@@ -0,0 +1,18 @@
+/**
+ * https://dom.spec.whatwg.org/#interface-event
+ */
+export declare class EventPolyfill implements Event {
+    type: string;
+    bubbles: boolean;
+    cancelable: boolean;
+    composed: boolean;
+    currentTarget: EventTarget | null;
+    defaultPrevented: boolean;
+    eventPhase: number;
+    isTrusted: boolean;
+    target: EventTarget | null;
+    timeStamp: number;
+    returnValue: boolean;
+    srcElement: EventTarget | null;
+    constructor(type: string, eventInitDict?: EventInit);
+}