Framework wiring

The request middleware every theme lists first in app/start.ts; it opens the private, per-request context the rest of the engine reads.

Builds the theme's TanStack router with the engine's defaults: a data cache, SSR hydration, a loading skeleton, and the error and 404 pages.

Creates the root route of app/routes/__root.tsx with the engine's store-settings loading, global head tags and "Store Unavailable" error page.

Reads the engine's context outside React: store settings, language, location, route id, auth token and the data cache.

Wraps a route module's head function into the head option of a TanStack route, with an optional step to change the result.

Optional request middleware that adds preload Link headers for the SDK, fonts and theme CSS to every HTML response.

Converts a HeadDescriptor (title, description, Open Graph, canonical, JSON-LD) into the meta, links, styles and scripts arrays a TanStack route returns.

Writes values into the current twilight context: the request's own on the server, the page's single context in the browser.

Runs a function inside a fresh request context on the server. twilightMiddleware() does this for every request, so themes rarely call it.

The anchor behind the engine's Link under TanStack Router: it adds the current language to internal paths and passes intent preloading on.

Turns an { html, body } attribute descriptor into React props to spread onto the html and body elements: class becomes className.

Merges several { html, body } descriptors into React props: every class is kept once, and for other attributes the last value wins.

Collects the html and body attributes the matched routes declare in staticData.documentAttrs, as React props for the root shell.

Deprecated: connects the engine's navigate and Link to TanStack Router. TwilightProvider now does this itself, with locale handling this one lacks.

Converts a HeadDescriptor into a Next.js App Router Metadata object; part of the engine's experimental, unfinished Next.js adapter.

The Next.js copies of attrs and mergeAttrs: descriptors in, htmlAttrs and bodyAttrs out, for a root layout that cannot call hooks.

The link adapter for Next.js setups. It renders a plain anchor, not next/link, so a click loads a whole new page.

Applies html and body attributes straight to the live document, and removes them again; for browser-only apps without TwilightProvider.