akanjs 3.0.0 → 3.0.1

package/client/csrTypes.ts

@@ -116,6 +116,8 @@ export interface RouteRender {
   resolveHead?: ResolveHead;
   getPageConfig?: () => PromiseOrObject<PageConfig | undefined>;
   getLayoutPageConfig?: () => PromiseOrObject<PageConfig | undefined>;
+  /** A root layout's `theme`, readable before it renders. */
+  getLayoutTheme?: () => PromiseOrObject<string | undefined>;
   /** The `page()` chain behind a page render, when it was declared as one — what a page prompt is read off. */
   getRouteDefinition?: () => PromiseOrObject<RouteDefinition | undefined>;
 }
@@ -179,7 +181,6 @@ export interface Route {
   /** Synthetic layout render from a `_overrides.tsx` at this node; wraps the subtree in a UI-override provider. */
   renderOverrides?: RouteRender;
   pageIncludesOwnLayout?: boolean;
-  isSpecialRoute?: boolean;
   loader?: () => unknown;
   pageState?: PageState;
   pageConfigChain?: PageConfig[];
@@ -355,7 +356,6 @@ export interface PathRoute {
   renderRootLayouts: RouteRender[];
   renderLayouts: RouteRender[];
   resolveHead?: ResolveHead;
-  isSpecialRoute?: boolean;
 }
 
 export type FrameSlotScope = "page" | "layout";

package/common/index.ts

@@ -139,7 +139,6 @@ export {
   getPageSourceFileViolation,
   getRouteExports,
   isRouteSourceFile,
-  isSpecialRouteLeaf,
   LAYOUT_ROUTE_EXPORTS,
   matchRoutePattern,
   normalizeRoutePattern,

package/common/routeConvention.ts

@@ -3,7 +3,6 @@ const SOURCE_EXT_RE = /\.(tsx|ts|jsx|js)$/;
 const RESERVED_ROUTE_FILES = new Set(["_layout", "_index", "_overrides"]);
 const INTERNAL_ROOT_LAYOUT_LEAF = "__root_layout";
 const IMPLICIT_LOCALE_SEGMENT = "[lang]";
-const SPECIAL_ROUTE_LEAVES = new Set(["robots.txt"]);
 
 const DIRECTORY_SCOPED_LEAVES = new Set(["_layout", "_index", "_overrides"]);
 
@@ -45,7 +44,6 @@ export interface ParsedRouteModuleKey {
   ext: string;
   leaf: string;
   pattern: string;
-  isSpecialRoute: boolean;
   isInternalRootLayout: boolean;
 }
 
@@ -140,8 +138,7 @@ export function parseRouteModuleKey(key: string): ParsedRouteModuleKey {
 
   const sourceRouteSegments =
     DIRECTORY_SCOPED_LEAVES.has(leaf) || isInternalRootLayout ? moduleSegments.slice(0, -1) : moduleSegments;
-  const isSpecialRoute = kind === "page" && SPECIAL_ROUTE_LEAVES.has(leaf);
-  const routeSegments = isSpecialRoute ? sourceRouteSegments : [IMPLICIT_LOCALE_SEGMENT, ...sourceRouteSegments];
+  const routeSegments = [IMPLICIT_LOCALE_SEGMENT, ...sourceRouteSegments];
   for (const segment of routeSegments) validateRouteSegment(segment, key);
 
   return {
@@ -153,15 +150,10 @@ export function parseRouteModuleKey(key: string): ParsedRouteModuleKey {
     ext,
     leaf,
     pattern: normalizeRoutePattern(routeSegments),
-    isSpecialRoute,
     isInternalRootLayout,
   };
 }
 
-export function isSpecialRouteLeaf(leaf: string): boolean {
-  return SPECIAL_ROUTE_LEAVES.has(leaf);
-}
-
 export function tryParseRouteModuleKey(key: string): ParsedRouteModuleKey | null {
   try {
     return parseRouteModuleKey(key);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/server/cachePolicy.ts

@@ -7,6 +7,7 @@ export interface RouteCacheKeyInput {
   request: Request;
   url: URL;
   theme?: string;
+  variant?: string;
 }
 
 export interface RouteCacheRenderState {
@@ -116,7 +117,7 @@ export function isRouteCachePathAllowed(
   return matches(allow);
 }
 
-export function createRouteCacheKey({ request, url, theme = "" }: RouteCacheKeyInput): string {
+export function createRouteCacheKey({ request, url, theme = "", variant }: RouteCacheKeyInput): string {
   return [
     getClientFacingOrigin(request, url),
     request.headers.get("x-base-path") ?? "",
@@ -126,6 +127,7 @@ export function createRouteCacheKey({ request, url, theme = "" }: RouteCacheKeyI
     url.search,
     request.headers.get("accept-language") ?? "",
     theme,
+    ...(variant ? [variant] : []),
   ].join("\n");
 }
 
@@ -153,7 +155,15 @@ export function resolvePublicRouteCacheEntryDecision(input: PublicRouteCacheEntr
     return { entry: null, reason: "path-excluded" };
   }
   if (!isPublicRouteCacheableRequest(input.request)) return { entry: null, reason: "request-not-public" };
-  return { entry: createRouteCacheEntry({ request: input.request, url: input.url, theme: input.theme, ttl }) };
+  return {
+    entry: createRouteCacheEntry({
+      request: input.request,
+      url: input.url,
+      theme: input.theme,
+      variant: input.variant,
+      ttl,
+    }),
+  };
 }
 
 export function resolveRouteCacheStoreTtl(baseTtl: number, state: RouteCacheRenderState): number | null {

package/server/crawler.ts

@@ -0,0 +1,6 @@
+
+const crawlerPattern =
+  /(?<!cu)bot|crawl|spider|slurp|-user\b|preview|facebookexternalhit|facebookcatalog|meta-external|kakaotalk-scrap|whatsapp|vkshare|embedly|iframely|mastodon|anthropic-ai|cohere-ai|google-inspectiontool|googleother|mediapartners-google|yeti\b|daum\/|daumoa|ia_archiver/i;
+
+export const isCrawlerUserAgent = (userAgent: string | null | undefined): boolean =>
+  !!userAgent && crawlerPattern.test(userAgent);

package/server/head.tsx

@@ -39,10 +39,6 @@ export function renderAkanHeadSnapshot(snapshot: AkanHeadSnapshotV1): Head {
   );
 }
 
-export function shouldRenderLocaleAlternates(options: { isSpecialRoute?: boolean }): boolean {
-  return options.isSpecialRoute !== true;
-}
-
 function isResolvedHead(value: unknown): value is ResolvedHead {
   return isRecord(value) && "node" in value;
 }

package/server/robots.ts

@@ -2,33 +2,11 @@ import { getApiPrefix } from "akanjs/base";
 
 const DEFAULT_DISALLOW_PATHS = ["/_akan", "/admin", "/manager", "/private"] as const;
 
-const DEFAULT_AI_CRAWLERS = [
-  "GPTBot",
-  "ChatGPT-User",
-  "CCBot",
-  "ClaudeBot",
-  "Claude-Web",
-  "anthropic-ai",
-  "Google-Extended",
-  "PerplexityBot",
-  "Perplexity-User",
-  "Bytespider",
-  "Amazonbot",
-  "Applebot-Extended",
-  "Meta-ExternalAgent",
-  "FacebookBot",
-  "Diffbot",
-  "Omgilibot",
-  "Omgili",
-] as const;
-
 export function createDefaultRobotsTxt(): string {
   const lines = [
     "User-agent: *",
     "Allow: /",
     ...[getApiPrefix(), ...DEFAULT_DISALLOW_PATHS].map((path) => `Disallow: ${path}`),
-    "",
-    ...DEFAULT_AI_CRAWLERS.flatMap((crawler) => [`User-agent: ${crawler}`, "Disallow: /", ""]),
   ];
-  return `${lines.join("\n").trimEnd()}\n`;
+  return `${lines.join("\n")}\n`;
 }

package/server/routeTreeBuilder.ts

@@ -171,7 +171,6 @@ export class RouteTreeBuilder {
         : {
             renderPage: routeRender,
             pageIncludesOwnLayout: parsed.leaf === "_index",
-            isSpecialRoute: parsed.isSpecialRoute,
           }),
     } as Route);
   }
@@ -198,7 +197,6 @@ export class RouteTreeBuilder {
               renderRootLayouts: layer.pageRenderRootLayouts,
               renderLayouts: layer.pageRenderLayouts,
               resolveHead: RouteTreeBuilder.#composeHeadResolvers(route.renderPage.resolveHead, pageHead),
-              isSpecialRoute: route.isSpecialRoute,
               pageState: route.pageState ?? defaultPageState,
             },
           ]
@@ -301,6 +299,10 @@ export class RouteTreeBuilder {
       routeRender.getRouteDefinition = async () => (await loadModule()).definition;
     } else {
       routeRender.getLayoutPageConfig = pageConfigOf;
+      routeRender.getLayoutTheme = async () => {
+        const { module: mod } = await loadModule();
+        return "theme" in mod ? (mod.theme as string | undefined) : undefined;
+      };
       routeRender.resolveNotFound = async () => syncFallbacks((await loadModule()).module as LayoutModule).NotFound;
       routeRender.resolveError = async () => syncFallbacks((await loadModule()).module as LayoutModule).Error;
     }

package/server/rscWorker.tsx

@@ -17,6 +17,7 @@ import {
   pushRequestFallback,
   requestStorage,
   setRequestFrameState,
+  setRequestTheme,
   untrackedCookies,
   untrackedRequest,
   updateRequestPolicy,
@@ -36,12 +37,7 @@ import {
   resolveRouteCacheStoreTtl,
   shouldStoreRouteCache,
 } from "./cachePolicy";
-import {
-  createAkanLocaleAlternateHeadSnapshot,
-  mergeAkanHeadSnapshots,
-  renderAkanHeadSnapshot,
-  shouldRenderLocaleAlternates,
-} from "./head";
+import { createAkanLocaleAlternateHeadSnapshot, mergeAkanHeadSnapshots, renderAkanHeadSnapshot } from "./head";
 import { LogForwarder } from "./logging/logForwarder";
 import { ProcessMetricsCollector } from "./processMetricsCollector";
 import { RouteElementComposer } from "./routeElementComposer";
@@ -1223,7 +1219,7 @@ export class RscRenderer {
             searchParams,
           })
         : { node: undefined };
-    const routeHeadSnapshot = this.#createRouteHeadSnapshot(url, routeHead, {});
+    const routeHeadSnapshot = this.#createRouteHeadSnapshot(url, routeHead);
     return (
       <html lang={params.lang ?? getPathnameLocale(pathname, this.#i18n)} suppressHydrationWarning>
         <head key="head">
@@ -1254,14 +1250,16 @@ export class RscRenderer {
       basePath: this.#getBasePath(url),
     });
     setRequestFrameState(pathRoute.pageState);
+    
+    const rootThemes = await Promise.all(pathRoute.renderRootLayouts.map((render) => render.getLayoutTheme?.()));
+    const rootTheme = rootThemes.find((theme) => theme !== undefined);
+    if (rootTheme) setRequestTheme(rootTheme);
     const routeHead = await RouteElementComposer.resolveHeadWithSnapshot({
       pathRoute,
       params: match.params,
       searchParams,
     });
-    const routeHeadSnapshot = this.#createRouteHeadSnapshot(url, routeHead, {
-      isSpecialRoute: pathRoute.isSpecialRoute,
-    });
+    const routeHeadSnapshot = this.#createRouteHeadSnapshot(url, routeHead);
     const body = RouteElementComposer.compose({
       pathRoute,
       params: match.params,
@@ -1277,9 +1275,7 @@ export class RscRenderer {
           {routeHeadSnapshot
             ? renderAkanHeadSnapshot(routeHeadSnapshot)
             : (routeHead.node ?? this.#renderDefaultHead())}
-          {!routeHeadSnapshot && shouldRenderLocaleAlternates({ isSpecialRoute: pathRoute.isSpecialRoute })
-            ? this.#renderLocaleAlternates(url)
-            : null}
+          {routeHeadSnapshot ? null : this.#renderLocaleAlternates(url)}
           {this.#renderStylesheet(url.pathname)}
         </head>
         <body key="body">{body}</body>
@@ -1370,22 +1366,14 @@ export class RscRenderer {
       params: match.params,
       searchParams,
     });
-    return this.#createRouteHeadSnapshot(url, routeHead, {
-      isSpecialRoute: match.pathRoute.isSpecialRoute,
-    });
+    return this.#createRouteHeadSnapshot(url, routeHead);
   }
 
-  #createRouteHeadSnapshot(
-    url: URL,
-    routeHead: ResolvedHead,
-    options: { isSpecialRoute?: boolean },
-  ): ResolvedHead["headSnapshot"] {
+  #createRouteHeadSnapshot(url: URL, routeHead: ResolvedHead): ResolvedHead["headSnapshot"] {
     if (!routeHead.headSnapshot) return undefined;
     return mergeAkanHeadSnapshots(
       routeHead.headSnapshot,
-      shouldRenderLocaleAlternates(options)
-        ? createAkanLocaleAlternateHeadSnapshot(this.#getLocaleAlternateLanguages(url))
-        : undefined,
+      createAkanLocaleAlternateHeadSnapshot(this.#getLocaleAlternateLanguages(url)),
     );
   }
 

package/server/ssrFromRscRenderer.tsx

@@ -9,7 +9,7 @@ import { renderToReadableStream } from "react-dom/server.browser";
 import { createFromNodeStream } from "react-server-dom-webpack/client.node";
 import { parsePositiveInt } from "./cachePolicy";
 import { concatBytes } from "./rscHttp";
-import type { SsrChunkRegistryStats, SsrFromRscInput, SsrLateRedirect } from "./ssrTypes";
+import type { SsrChunkRegistryStats, SsrDocumentOptions, SsrFromRscInput, SsrLateRedirect } from "./ssrTypes";
 
 const DEFAULT_SSR_CHUNK_REGISTRY_MAX_ENTRIES = 1024;
 const DEFAULT_MAX_PENDING_INLINE_RSC_SCRIPTS = 32;
@@ -593,21 +593,13 @@ export class SsrFromRscRenderer {
     const base = `${SsrFromRscRenderer.#clientBootstrap}${SsrFromRscRenderer.#prefixBootstrap()}`;
     const bootstrap = input.extraBootstrapInline ? `${base}\n${input.extraBootstrapInline}` : base;
 
-    const waitForAllReady = input.waitForAllReady || process.env.AKAN_SSR_WAIT_FOR_ALL_READY === "1";
-    const renderHtml = async () => {
-      const root = await thenable;
-      const stream = await renderToReadableStream(root, {
-        bootstrapScriptContent: bootstrap,
-        onError: (error) => SsrFromRscRenderer.#reportRenderError(error, input),
+    const renderHtml = async () =>
+      await SsrFromRscRenderer.renderDocument(await thenable, {
+        bootstrap,
+        waitForAllReady: input.waitForAllReady || process.env.AKAN_SSR_WAIT_FOR_ALL_READY === "1",
+        inlineBoundaries: input.inlineBoundaries,
+        onError: (error, phase) => SsrFromRscRenderer.#reportRenderError(error, input, phase),
       });
-      if (waitForAllReady) await stream.allReady;
-      else {
-        SsrFromRscRenderer.holdPostShellErrors(stream, (error) =>
-          SsrFromRscRenderer.#reportRenderError(error, input, "post-shell"),
-        );
-      }
-      return stream;
-    };
     const requestContext = input.requestStore ?? input.request;
     const htmlStream =
       requestContext && requestStorage ? await requestStorage.run(requestContext, renderHtml) : await renderHtml();
@@ -661,6 +653,18 @@ export class SsrFromRscRenderer {
     };
   }
 
+  static async renderDocument(root: ReactNode, options: SsrDocumentOptions): Promise<ReadableStream<Uint8Array>> {
+    const stream = await renderToReadableStream(root, {
+      bootstrapScriptContent: options.bootstrap,
+      
+      ...(options.inlineBoundaries ? { progressiveChunkSize: Number.POSITIVE_INFINITY } : {}),
+      onError: (error) => options.onError(error),
+    });
+    if (options.waitForAllReady || options.inlineBoundaries) await stream.allReady;
+    else SsrFromRscRenderer.holdPostShellErrors(stream, (error) => options.onError(error, "post-shell"));
+    return stream;
+  }
+
   static holdPostShellErrors(stream: { allReady: Promise<void> }, report: (error: unknown) => void): void {
     void stream.allReady.catch(report);
   }

package/server/ssrTypes.ts

@@ -61,4 +61,13 @@ export interface SsrFromRscInput {
   onCancel?: (reason?: unknown) => void;
   /** Buffers until `stream.allReady` (`pageConfig.ssr: "block"`); `AKAN_SSR_WAIT_FOR_ALL_READY=1` forces it globally. */
   waitForAllReady?: boolean;
+  /** Buffers like `waitForAllReady` and writes every Suspense boundary in place, for a reader that runs no script. */
+  inlineBoundaries?: boolean;
+}
+
+export interface SsrDocumentOptions {
+  bootstrap: string;
+  waitForAllReady?: boolean;
+  inlineBoundaries?: boolean;
+  onError: (error: unknown, phase?: string) => void;
 }

package/server/webRouter.ts

@@ -36,6 +36,7 @@ import {
   shouldStoreRouteCache,
 } from "./cachePolicy";
 import { encodedFileResponse } from "./contentEncoding";
+import { isCrawlerUserAgent } from "./crawler";
 import { HMR_CLIENT_SCRIPT } from "./hmr/clientScript";
 import { CSR_DEV_ROUTE_PREFIX, resolveDevCsrMode, SSR_DEV_DIRNAME, SSR_DEV_ROUTE_PREFIX } from "./hmr/csrDevManifest";
 import { CsrDevShell } from "./hmr/csrDevShell";
@@ -600,7 +601,8 @@ export class WebRouter {
         try {
           this.#requestStats.fullSsr += 1;
           const manifest = await this.#ensureRoute(url);
-          const htmlCacheDecision = this.#getHtmlCacheEntry(req, url);
+          const isCrawler = isCrawlerUserAgent(req.headers.get("user-agent"));
+          const htmlCacheDecision = this.#getHtmlCacheEntry(req, url, isCrawler);
           const htmlCacheEntry = htmlCacheDecision.entry;
           const cachedHtml = htmlCacheEntry ? this.#getCachedHtml(htmlCacheEntry.key) : null;
           if (cachedHtml) {
@@ -643,6 +645,7 @@ export class WebRouter {
             },
             lateControl: rscResult.lateControl,
             waitForAllReady: rscResult.trace?.ssrBlocking ?? false,
+            inlineBoundaries: isCrawler,
             onCancel: (reason: unknown) => {
               rscResult.cancel(reason);
             },
@@ -814,7 +817,7 @@ export class WebRouter {
     }
   }
 
-  #getHtmlCacheEntry(req: Request, url: URL): { entry: RouteCacheEntry | null; reason?: string } {
+  #getHtmlCacheEntry(req: Request, url: URL, isCrawler: boolean): { entry: RouteCacheEntry | null; reason?: string } {
 
     if (this.#ssrDevShell) {
       this.#htmlCacheBypass += 1;
@@ -824,6 +827,7 @@ export class WebRouter {
       request: req,
       url,
       theme: WebRouter.#cookieValue(req, "theme"),
+      variant: isCrawler ? "crawler" : undefined,
       defaultEnabled: this.#prodMode,
       defaultAllow: this.#prodMode,
       env: {

package/types/client/csrTypes.d.ts

@@ -113,6 +113,8 @@ export interface RouteRender {
     resolveHead?: ResolveHead;
     getPageConfig?: () => PromiseOrObject<PageConfig | undefined>;
     getLayoutPageConfig?: () => PromiseOrObject<PageConfig | undefined>;
+    /** A root layout's `theme`, readable before it renders. */
+    getLayoutTheme?: () => PromiseOrObject<string | undefined>;
     /** The `page()` chain behind a page render, when it was declared as one — what a page prompt is read off. */
     getRouteDefinition?: () => PromiseOrObject<RouteDefinition | undefined>;
 }
@@ -176,7 +178,6 @@ export interface Route {
     /** Synthetic layout render from a `_overrides.tsx` at this node; wraps the subtree in a UI-override provider. */
     renderOverrides?: RouteRender;
     pageIncludesOwnLayout?: boolean;
-    isSpecialRoute?: boolean;
     loader?: () => unknown;
     pageState?: PageState;
     pageConfigChain?: PageConfig[];
@@ -327,7 +328,6 @@ export interface PathRoute {
     renderRootLayouts: RouteRender[];
     renderLayouts: RouteRender[];
     resolveHead?: ResolveHead;
-    isSpecialRoute?: boolean;
 }
 export type FrameSlotScope = "page" | "layout";
 export type FrameSlotType = "topInset" | "bottomInset";

package/types/common/index.d.ts

@@ -34,7 +34,7 @@ export { randomPick, randomPicks } from "./randomPick.d.ts";
 export { hostFromRequest, isJsonContentType, originFromRequest } from "./requestOrigin.d.ts";
 export { RestClient, type RestClientOptions, type RestRequestOptions } from "./restClient.d.ts";
 export { round } from "./round.d.ts";
-export { assertUniqueRoutePatterns, compareRouteSpecificity, getPageSourceFileViolation, getRouteExports, isRouteSourceFile, isSpecialRouteLeaf, LAYOUT_ROUTE_EXPORTS, matchRoutePattern, normalizeRoutePattern, PAGE_ROUTE_EXPORTS, type ParsedRouteModuleKey, parseRouteModuleKey, RESERVED_ROUTE_CONFIG_EXPORTS, ROOT_LAYOUT_ROUTE_EXPORTS, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
+export { assertUniqueRoutePatterns, compareRouteSpecificity, getPageSourceFileViolation, getRouteExports, isRouteSourceFile, LAYOUT_ROUTE_EXPORTS, matchRoutePattern, normalizeRoutePattern, PAGE_ROUTE_EXPORTS, type ParsedRouteModuleKey, parseRouteModuleKey, RESERVED_ROUTE_CONFIG_EXPORTS, ROOT_LAYOUT_ROUTE_EXPORTS, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
 export { sleep } from "./sleep.d.ts";
 export { getBasePathFromPathname, parseBasePaths, parseSubRouteHosts, resolveSubRouteHosts } from "./subRoute.d.ts";
 export { TrustedProxy } from "./TrustedProxy.d.ts";

package/types/common/routeConvention.d.ts

@@ -16,7 +16,6 @@ export interface ParsedRouteModuleKey {
     ext: string;
     leaf: string;
     pattern: string;
-    isSpecialRoute: boolean;
     isInternalRootLayout: boolean;
 }
 export interface ValidateSubRoutePageKeyOptions {
@@ -32,7 +31,6 @@ export declare function getPageSourceFileViolation(filePath: string): string | n
 export declare function validatePageSourceFile(filePath: string, options?: ValidatePageSourceFileOptions): boolean;
 export declare function validateSubRoutePageKey(key: string, basePaths: Iterable<string>, options?: ValidateSubRoutePageKeyOptions): void;
 export declare function parseRouteModuleKey(key: string): ParsedRouteModuleKey;
-export declare function isSpecialRouteLeaf(leaf: string): boolean;
 export declare function tryParseRouteModuleKey(key: string): ParsedRouteModuleKey | null;
 export declare function normalizeRoutePattern(segments: string[]): string;
 export declare function routeSegmentToPatternPart(segment: string): string;

package/types/server/cachePolicy.d.ts

@@ -4,6 +4,7 @@ export interface RouteCacheKeyInput {
     request: Request;
     url: URL;
     theme?: string;
+    variant?: string;
 }
 export interface RouteCacheRenderState {
     cacheable: boolean;
@@ -62,7 +63,7 @@ export declare function isRouteCachePathAllowed(pathname: string, options?: {
     deny?: string | null;
     defaultAllow?: boolean;
 }): boolean;
-export declare function createRouteCacheKey({ request, url, theme }: RouteCacheKeyInput): string;
+export declare function createRouteCacheKey({ request, url, theme, variant }: RouteCacheKeyInput): string;
 export declare function createRouteCacheEntry(input: RouteCacheKeyInput & {
     ttl: number;
 }): RouteCacheEntry;

package/types/server/crawler.d.ts

@@ -0,0 +1 @@
+export declare const isCrawlerUserAgent: (userAgent: string | null | undefined) => boolean;

package/types/server/head.d.ts

@@ -3,7 +3,4 @@ import { type AkanHeadSnapshotV1 } from "./routeState.d.ts";
 export declare function createAkanLocaleAlternateHeadSnapshot(languages: Record<string, string>): AkanHeadSnapshotV1;
 export declare function mergeAkanHeadSnapshots(...snapshots: Array<AkanHeadSnapshotV1 | null | undefined>): AkanHeadSnapshotV1 | undefined;
 export declare function renderAkanHeadSnapshot(snapshot: AkanHeadSnapshotV1): Head;
-export declare function shouldRenderLocaleAlternates(options: {
-    isSpecialRoute?: boolean;
-}): boolean;
 export declare function resolveHeadResult(value: ResolveHeadResult): ResolvedHead;

package/types/server/ssrFromRscRenderer.d.ts

@@ -1,5 +1,6 @@
 import { type AkanRequestStore } from "akanjs/fetch";
-import type { SsrChunkRegistryStats, SsrFromRscInput, SsrLateRedirect } from "./ssrTypes.d.ts";
+import type { ReactNode } from "react";
+import type { SsrChunkRegistryStats, SsrDocumentOptions, SsrFromRscInput, SsrLateRedirect } from "./ssrTypes.d.ts";
 export declare class SsrChunkRegistry<T> {
     #private;
     readonly maxEntries: number;
@@ -35,6 +36,7 @@ export declare class SsrFromRscRenderer {
     #private;
     static getChunkRegistryStats(): SsrChunkRegistryStats;
     render(input: SsrFromRscInput): Promise<ReadableStream<Uint8Array>>;
+    static renderDocument(root: ReactNode, options: SsrDocumentOptions): Promise<ReadableStream<Uint8Array>>;
     static holdPostShellErrors(stream: {
         allReady: Promise<void>;
     }, report: (error: unknown) => void): void;

package/types/server/ssrTypes.d.ts

@@ -57,4 +57,12 @@ export interface SsrFromRscInput {
     onCancel?: (reason?: unknown) => void;
     /** Buffers until `stream.allReady` (`pageConfig.ssr: "block"`); `AKAN_SSR_WAIT_FOR_ALL_READY=1` forces it globally. */
     waitForAllReady?: boolean;
+    /** Buffers like `waitForAllReady` and writes every Suspense boundary in place, for a reader that runs no script. */
+    inlineBoundaries?: boolean;
+}
+export interface SsrDocumentOptions {
+    bootstrap: string;
+    waitForAllReady?: boolean;
+    inlineBoundaries?: boolean;
+    onError: (error: unknown, phase?: string) => void;
 }

package/types/ui/recipe/badgeRecipe.d.ts

@@ -1,15 +1,15 @@
 /** 뱃지 look — 시맨틱 variant × size, outline 플래그는 색을 유지한 외곽선 스타일. `<Badge>` 가 소비하며, recipes.badge 슬롯으로 교체 가능. */
 export declare const badgeRecipe: (variants?: Omit<({
     size?: "lg" | "md" | "sm" | "xs" | undefined;
-    outline?: boolean | undefined;
     variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
+    outline?: boolean | undefined;
 } & {
     class?: import("tailwind-variants").ClassValue;
     className?: never;
 }) | ({
     size?: "lg" | "md" | "sm" | "xs" | undefined;
-    outline?: boolean | undefined;
     variant?: "default" | "error" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "neutral" | "outline" | undefined;
+    outline?: boolean | undefined;
 } & {
     class?: never;
     className?: import("tailwind-variants").ClassValue;

package/types/ui/recipe/buttonRecipe.d.ts

@@ -1,16 +1,16 @@
 /** 버튼 look — 시맨틱 variant × size × shape, outline 플래그는 색을 유지한 외곽선 스타일. `<Button>` 이 소비하며, `_overrides.tsx` 의 recipes.button 슬롯으로 교체 가능. */
 export declare const buttonRecipe: (variants?: Omit<({
     size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
-    outline?: boolean | undefined;
     variant?: "default" | "link" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
+    outline?: boolean | undefined;
     shape?: "default" | "circle" | "square" | undefined;
 } & {
     class?: import("tailwind-variants").ClassValue;
     className?: never;
 }) | ({
     size?: "lg" | "md" | "sm" | "xs" | "icon" | undefined;
-    outline?: boolean | undefined;
     variant?: "default" | "link" | "info" | "warning" | "success" | "primary" | "secondary" | "accent" | "destructive" | "neutral" | "outline" | "ghost" | undefined;
+    outline?: boolean | undefined;
     shape?: "default" | "circle" | "square" | undefined;
 } & {
     class?: never;

package/types/webkit/useFrameRuntime.d.ts

@@ -86,7 +86,6 @@ export declare function resolvePathRoutesWithFrameState(pathRoutes: PathRoute[],
     renderRootLayouts: import("akanjs/client").RouteRender[];
     renderLayouts: import("akanjs/client").RouteRender[];
     resolveHead?: import("akanjs/client").ResolveHead;
-    isSpecialRoute?: boolean;
 }[];
 export declare function resolveLocationWithFrameState(location: Location | null, resolvedPathRouteMap: Map<string, PathRoute>): Location | null;
 export declare function useFrameRuntimeResync({ updateViewport }: {

package/vendor/@akanjs/native/packages/cli/src/lib/addons.ts

@@ -71,7 +71,8 @@ function listFiles(dir: string): string[] {
   if (!existsSync(dir)) return [];
   return (readdirSync(dir, { recursive: true }) as string[])
     .map((file) => join(dir, file))
-    .filter((file) => statSync(file).isFile());
+    .filter((file) => statSync(file).isFile())
+    .sort((a, b) => a.localeCompare(b));
 }
 
 /** The folder of the package a file belongs to: the deepest node_modules/<name> (or <@scope>/<name>) above it. */

package/vendor/@akanjs/native/packages/cli/src/lib/exec.ts

@@ -62,14 +62,24 @@ export async function exec(cmd: string[], options: ExecOptions = {}): Promise<Ex
   const signal = signals.getStore();
   
   const stream = options.inherit && isTerminal() ? "inherit" : "pipe";
+
+  const group = !!signal && process.platform !== "win32";
   const proc = Bun.spawn(cmd, {
     cwd: options.cwd,
     env: options.env ? { ...process.env, ...options.env } : process.env,
     stdin: "ignore",
     stdout: stream,
     stderr: stream,
-    ...(signal ? { signal } : {}),
+    ...(group ? { detached: true } : signal ? { signal } : {}),
   });
+  const killGroup = () => {
+    try {
+      process.kill(-proc.pid, "SIGTERM");
+    } catch {
+    }
+  };
+  if (group && signal) signal.addEventListener("abort", killGroup, { once: true });
+  void proc.exited.finally(() => signal?.removeEventListener("abort", killGroup));
   let stdout = "";
   let stderr = "";
   if (options.inherit && stream === "pipe") {