flamefront 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flamefront",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "private": false,
   "description": "Typed centralized route manifests for Octane.",
   "license": "MIT",
@@ -51,38 +51,38 @@
   },
   "dependencies": {
     "@alloc/cmd-ts": "^0.17.1",
-    "@babel/generator": "^8.0.5",
-    "@babel/parser": "^8.0.5",
-    "@babel/traverse": "^8.0.5",
-    "@babel/types": "^8.0.5",
-    "@remix-run/route-pattern": "^0.24.0",
+    "@babel/generator": "^8.0.6",
+    "@babel/parser": "^8.0.6",
+    "@babel/traverse": "^8.0.6",
+    "@babel/types": "^8.0.6",
+    "@remix-run/route-pattern": "^0.24.1",
     "babel-dead-code-elimination": "^2.0.0",
-    "devalue": "^5.8.2",
+    "devalue": "^6.0.0",
     "satteri": "^0.10.5",
-    "srvx": "^1.0.4",
+    "srvx": "^1.0.5",
     "vite-plugin-satteri": "^0.3.5"
   },
   "devDependencies": {
-    "@octanejs/remix-router": "^0.1.48",
-    "@octanejs/vite-plugin": "^0.1.54",
+    "@octanejs/remix-router": "^0.1.49",
+    "@octanejs/vite-plugin": "^0.1.57",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@tsrx/prettier-plugin": "^0.3.137",
+    "@tsrx/prettier-plugin": "^0.4.6",
     "@types/babel__generator": "^7.27.0",
     "@types/babel__traverse": "^7.28.0",
-    "@types/node": "^26.5.1",
-    "octane": "^0.2.7",
+    "@types/node": "^26.6.2",
+    "octane": "^0.3.2",
     "oxc-tsrx": "^0.6.1",
-    "oxlint": "^1.82.0",
-    "oxlint-tsgolint": "^7.0.2001",
+    "oxlint": "^1.83.0",
+    "oxlint-tsgolint": "^7.0.2002",
     "playwright": "^1.63.0",
-    "prettier": "^3.9.6",
+    "prettier": "^3.9.8",
     "typescript": "^5.9.3",
     "vite": "^8.3.0",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "peerDependencies": {
-    "@octanejs/remix-router": ">=0.1.48",
-    "octane": ">=0.2.7",
+    "@octanejs/remix-router": ">=0.1.49",
+    "octane": ">=0.3.2",
     "vite": ">=8.3.0"
   }
 }

package/src/fragment-client.ts

@@ -77,6 +77,29 @@ function basenamePath(pathname: string, basename: string): string | null {
   return pathname.slice(basename.length) || "/"
 }
 
+function joinBasename(basename: string, pathname: string): string {
+  if (basename === "/") {
+    return pathname || "/"
+  }
+
+  if (pathname === "/") {
+    return basename
+  }
+
+  return `${basename}${pathname.startsWith("/") ? pathname : `/${pathname}`}`
+}
+
+/** The static build emits one fragment artifact beside each route document. */
+function staticRouteFragmentPath(routeUrl: URL, basename: string): string {
+  const appPathname =
+    basenamePath(routeUrl.pathname, basename) ?? routeUrl.pathname
+  const pathname = joinBasename(basename, appPathname).replace(/\/+$/, "")
+
+  return pathname === ""
+    ? "/index.fragment.json"
+    : `${pathname}/index.fragment.json`
+}
+
 function staticFragmentKey(url: URL, basename: string): string {
   const pathname = basenamePath(url.pathname, basename) ?? url.pathname
 
@@ -214,6 +237,49 @@ function fetchRouteFragment(
     })
 }
 
+/**
+ * Read the emitted artifact file for a static route. Hosts that cannot serve
+ * it — the dev server, or a deployment without generated files — fall back to
+ * the live fragment endpoint.
+ */
+async function readStaticRouteFragment(
+  routeUrl: URL,
+  basename: string,
+  signal: AbortSignal | undefined,
+): Promise<RouteFragmentArtifact | undefined> {
+  const endpoint = new URL(
+    staticRouteFragmentPath(routeUrl, basename),
+    routeUrl.origin,
+  )
+  const response = await globalThis.fetch(endpoint, {
+    headers: { Accept: "application/vnd.flamefront.fragment+json" },
+    ...(signal ? { signal } : {}),
+  })
+
+  if (!response.ok) {
+    return undefined
+  }
+
+  try {
+    return assertRouteFragmentArtifact(await response.json())
+  } catch {
+    return undefined
+  }
+}
+
+function fetchStaticRouteFragment(
+  routeUrl: URL,
+  basename: string,
+  signal: AbortSignal | undefined,
+): Promise<RouteFragmentArtifact> {
+  const fallback = () => fetchRouteFragment(routeUrl, basename, signal)
+
+  return readStaticRouteFragment(routeUrl, basename, signal).then(
+    (artifact) => artifact ?? fallback(),
+    fallback,
+  )
+}
+
 export function loadRouteFragment(
   url: string | URL,
   routing: RouteFragmentRoutingOptions = {},
@@ -238,11 +304,12 @@ export function loadRouteFragment(
   let pending = requests.get(requestKey)
 
   if (!pending) {
-    pending = fetchRouteFragment(
-      routeUrl,
-      routing.basename ?? "/",
-      options.signal,
-    )
+    const fetchFragment =
+      options.policy === "static"
+        ? fetchStaticRouteFragment
+        : fetchRouteFragment
+
+    pending = fetchFragment(routeUrl, routing.basename ?? "/", options.signal)
     requests.set(requestKey, pending)
 
     const evict = () => {

package/src/fragment.tsx

@@ -438,9 +438,9 @@ function createShellBoundary(
       ),
     }
     const shell = (
-      <UNSAFE_RouteContext.Provider value={shellRoute}>
+      <UNSAFE_RouteContext value={shellRoute}>
         <Component {...props} />
-      </UNSAFE_RouteContext.Provider>
+      </UNSAFE_RouteContext>
     )
     const body = shellHydrationBoundary(
       metadata.hydration ?? "full",
@@ -481,13 +481,13 @@ export function createRouteBoundary(
 function createContextBridge(stateRef: {
   readonly current: ContextBridgeState
 }): (props: Record<string, unknown>) => unknown {
-  const DataRouterProvider = UNSAFE_DataRouterContext.Provider
-  const DataRouterStateProvider = UNSAFE_DataRouterStateContext.Provider
-  const FetchersProvider = UNSAFE_FetchersContext.Provider
-  const LocationProvider = UNSAFE_LocationContext.Provider
-  const NavigationProvider = UNSAFE_NavigationContext.Provider
-  const RouteProvider = UNSAFE_RouteContext.Provider
-  const ViewTransitionProvider = UNSAFE_ViewTransitionContext.Provider
+  const DataRouterProvider = UNSAFE_DataRouterContext
+  const DataRouterStateProvider = UNSAFE_DataRouterStateContext
+  const FetchersProvider = UNSAFE_FetchersContext
+  const LocationProvider = UNSAFE_LocationContext
+  const NavigationProvider = UNSAFE_NavigationContext
+  const RouteProvider = UNSAFE_RouteContext
+  const ViewTransitionProvider = UNSAFE_ViewTransitionContext
 
   return () => {
     const { component, contexts } = stateRef.current

package/src/octane-default-renderer.tsx

@@ -97,7 +97,7 @@ export const defaultOctaneRenderer: OctaneRenderer = {
       errors: errorsForBoundary(staticContext, matches),
     }
     const outletRouter = createStaticRouter([outletRoute], outletContext)
-    const FragmentBoundaryProvider = routeFragmentBoundaryTarget.Provider
+    const FragmentBoundaryProvider = routeFragmentBoundaryTarget
     const FragmentRoot = () => (
       <FragmentBoundaryProvider
         value={options?.includeBoundary ? null : boundary}

package/src/octane-router-document.ts

@@ -16,14 +16,14 @@ export const RouterDocument: RouterDocumentComponent = (
   }) => unknown
 
   const content = createElement(
-    routeOutletHtmlContext.Provider,
+    routeOutletHtmlContext,
     { value: props.outletHtml ?? null },
     createElement(Router, { router: props.router }),
   )
 
   return props.documentAssets
     ? createElement(
-        documentAssetsContext.Provider,
+        documentAssetsContext,
         { value: props.documentAssets },
         content,
       )