@reckona/mreact-router 0.0.149 → 0.0.151

package/dist/typed-routes.d.ts

@@ -1,7 +1,8 @@
 export type RouteSearchValue = boolean | number | string | null | undefined;
 export type RouteSearchParams = Record<string, RouteSearchValue | readonly RouteSearchValue[]>;
 export type RouteParamsFor<Path extends `/${string}`> = Simplify<ExtractRouteParams<Path>>;
-export type AppRouteHref<Path extends `/${string}`> = HasRouteParams<Path> extends true ? (options: DynamicHrefOptions<Path>) => string : (options?: StaticHrefOptions) => string;
+export type AppRouteHref<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never ? (options?: StaticHrefOptions) => string : (options: DynamicHrefOptions<Path>) => string;
+export type AppRouteLinkHref<Path extends `/${string}`> = `${AppRouteLinkPathname<Path>}${AppRouteLinkHrefSuffix}`;
 export interface StaticHrefOptions {
     hash?: string | undefined;
     search?: RouteSearchParams | undefined;
@@ -19,6 +20,10 @@ type SegmentRouteParam<Segment extends string> = Segment extends `:...${infer Na
 type Simplify<T> = {
     [Key in keyof T]: T[Key];
 } & {};
+export type AppRouteLinkHrefSuffix = "" | `?${string}` | `#${string}` | `?${string}#${string}`;
+export type AppRouteLinkPathname<Path extends `/${string}`> = Path extends "/" ? "/" : Path extends `/${infer Segments}` ? `/${AppRouteLinkSegments<Segments>}` : never;
+export type AppRouteLinkSegments<Segments extends string> = Segments extends `${infer Segment}/${infer Rest}` ? `${AppRouteLinkSegment<Segment>}/${AppRouteLinkSegments<Rest>}` : AppRouteLinkSegment<Segments>;
+export type AppRouteLinkSegment<Segment extends string> = Segment extends `:${string}` ? string : Segment;
 export declare function href<const Path extends `/${string}`>(path: Path, ...args: HasRouteParams<Path> extends true ? [options: DynamicHrefOptions<Path>] : [options?: StaticHrefOptions]): string;
 export {};
 //# sourceMappingURL=typed-routes.d.ts.map

package/dist/typed-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-routes.d.ts","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CACpC,MAAM,EACN,gBAAgB,GAAG,SAAS,gBAAgB,EAAE,CAC/C,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IAAI,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAE3F,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,GACnF,CAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,MAAM,GAC7C,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,MAAM,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,CAAE,SAAQ,iBAAiB;IACtF,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,KAAK,cAAc,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IAAI,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,KAAK,GACrF,KAAK,GACL,IAAI,CAAC;AAET,KAAK,kBAAkB,CAAC,IAAI,SAAS,MAAM,IAAI,IAAI,SAAS,GAAG,MAAM,OAAO,IAAI,MAAM,IAAI,EAAE,GACxF,iBAAiB,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,GACrD,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAE5B,KAAK,iBAAiB,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,SAAS,OAAO,MAAM,IAAI,EAAE,GAChF;KAAG,GAAG,IAAI,IAAI,GAAG,SAAS,MAAM,EAAE;CAAE,GACpC,OAAO,SAAS,IAAI,MAAM,IAAI,EAAE,GAC9B;KAAG,GAAG,IAAI,IAAI,GAAG,MAAM;CAAE,GACzB,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3B,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;CAAE,GAAG,EAAE,CAAC;AAErD,wBAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,EAClD,IAAI,EAAE,IAAI,EACV,GAAG,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,GACtC,CAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,GACnC,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,GAChC,MAAM,CA0CR"}
+{"version":3,"file":"typed-routes.d.ts","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"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"}

package/dist/typed-routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"typed-routes.js","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"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","sourcesContent":["export type RouteSearchValue = boolean | number | string | null | undefined;\nexport type RouteSearchParams = Record<\n  string,\n  RouteSearchValue | readonly RouteSearchValue[]\n>;\n\nexport type RouteParamsFor<Path extends `/${string}`> = Simplify<ExtractRouteParams<Path>>;\n\nexport type AppRouteHref<Path extends `/${string}`> = HasRouteParams<Path> extends true\n  ? (options: DynamicHrefOptions<Path>) => string\n  : (options?: StaticHrefOptions) => string;\n\nexport interface StaticHrefOptions {\n  hash?: string | undefined;\n  search?: RouteSearchParams | undefined;\n}\n\nexport interface DynamicHrefOptions<Path extends `/${string}`> extends StaticHrefOptions {\n  params: RouteParamsFor<Path>;\n}\n\ntype HasRouteParams<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never\n  ? false\n  : true;\n\ntype ExtractRouteParams<Path extends string> = Path extends `${infer Segment}/${infer Rest}`\n  ? SegmentRouteParam<Segment> & ExtractRouteParams<Rest>\n  : SegmentRouteParam<Path>;\n\ntype SegmentRouteParam<Segment extends string> = Segment extends `:...${infer Name}`\n  ? { [Key in Name]: readonly string[] }\n  : Segment extends `:${infer Name}`\n    ? { [Key in Name]: string }\n    : Record<never, never>;\n\ntype Simplify<T> = { [Key in keyof T]: T[Key] } & {};\n\nexport function href<const Path extends `/${string}`>(\n  path: Path,\n  ...args: HasRouteParams<Path> extends true\n    ? [options: DynamicHrefOptions<Path>]\n    : [options?: StaticHrefOptions]\n): string {\n  assertInternalRoutePath(path);\n\n  const options = args[0] as\n    | (StaticHrefOptions & { params?: Record<string, readonly string[] | string> | undefined })\n    | undefined;\n  const params =\n    options !== undefined && \"params\" in options && options.params !== undefined\n      ? (options.params as Record<string, readonly string[] | string>)\n      : {};\n  const pathname = path\n    .split(\"/\")\n    .map((segment) => {\n      if (segment.startsWith(\":...\")) {\n        const name = segment.slice(4);\n        const value = params[name];\n\n        if (!Array.isArray(value)) {\n          throw new Error(`Missing catch-all route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return value.map((part) => encodeURIComponent(part)).join(\"/\");\n      }\n\n      if (segment.startsWith(\":\")) {\n        const name = segment.slice(1);\n        const value = params[name];\n\n        if (typeof value !== \"string\") {\n          throw new Error(`Missing route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return encodeURIComponent(value);\n      }\n\n      return segment;\n    })\n    .join(\"/\");\n  const search = searchString(options?.search);\n  const hash = options?.hash === undefined ? \"\" : `#${encodeURIComponent(options.hash)}`;\n\n  return `${pathname}${search}${hash}`;\n}\n\nfunction assertInternalRoutePath(path: string): void {\n  if (!path.startsWith(\"/\") || path.startsWith(\"//\")) {\n    throw new Error(`href() expected an internal route path, received ${JSON.stringify(path)}.`);\n  }\n\n  for (let index = 0; index < path.length; index += 1) {\n    const code = path.charCodeAt(index);\n\n    if (code <= 0x1f || code === 0x7f) {\n      throw new Error(\"href() route paths must not contain control characters.\");\n    }\n  }\n}\n\nfunction searchString(search: RouteSearchParams | undefined): string {\n  if (search === undefined) {\n    return \"\";\n  }\n\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(search)) {\n    const values = Array.isArray(value) ? value : [value];\n\n    for (const entry of values) {\n      if (entry !== undefined && entry !== null) {\n        params.append(key, String(entry));\n      }\n    }\n  }\n\n  const value = params.toString();\n\n  return value === \"\" ? \"\" : `?${value}`;\n}\n"]}
+{"version":3,"file":"typed-routes.js","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"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","sourcesContent":["export type RouteSearchValue = boolean | number | string | null | undefined;\nexport type RouteSearchParams = Record<\n  string,\n  RouteSearchValue | readonly RouteSearchValue[]\n>;\n\nexport type RouteParamsFor<Path extends `/${string}`> = Simplify<ExtractRouteParams<Path>>;\n\nexport type AppRouteHref<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never\n  ? (options?: StaticHrefOptions) => string\n  : (options: DynamicHrefOptions<Path>) => string;\n\nexport type AppRouteLinkHref<Path extends `/${string}`> =\n  `${AppRouteLinkPathname<Path>}${AppRouteLinkHrefSuffix}`;\n\nexport interface StaticHrefOptions {\n  hash?: string | undefined;\n  search?: RouteSearchParams | undefined;\n}\n\nexport interface DynamicHrefOptions<Path extends `/${string}`> extends StaticHrefOptions {\n  params: RouteParamsFor<Path>;\n}\n\ntype HasRouteParams<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never\n  ? false\n  : true;\n\ntype ExtractRouteParams<Path extends string> = Path extends `${infer Segment}/${infer Rest}`\n  ? SegmentRouteParam<Segment> & ExtractRouteParams<Rest>\n  : SegmentRouteParam<Path>;\n\ntype SegmentRouteParam<Segment extends string> = Segment extends `:...${infer Name}`\n  ? { [Key in Name]: readonly string[] }\n  : Segment extends `:${infer Name}`\n    ? { [Key in Name]: string }\n    : Record<never, never>;\n\ntype Simplify<T> = { [Key in keyof T]: T[Key] } & {};\n\nexport type AppRouteLinkHrefSuffix = \"\" | `?${string}` | `#${string}` | `?${string}#${string}`;\n\nexport type AppRouteLinkPathname<Path extends `/${string}`> = Path extends \"/\"\n  ? \"/\"\n  : Path extends `/${infer Segments}`\n    ? `/${AppRouteLinkSegments<Segments>}`\n    : never;\n\nexport type AppRouteLinkSegments<Segments extends string> = Segments extends `${infer Segment}/${infer Rest}`\n  ? `${AppRouteLinkSegment<Segment>}/${AppRouteLinkSegments<Rest>}`\n  : AppRouteLinkSegment<Segments>;\n\nexport type AppRouteLinkSegment<Segment extends string> = Segment extends `:${string}`\n  ? string\n  : Segment;\n\nexport function href<const Path extends `/${string}`>(\n  path: Path,\n  ...args: HasRouteParams<Path> extends true\n    ? [options: DynamicHrefOptions<Path>]\n    : [options?: StaticHrefOptions]\n): string {\n  assertInternalRoutePath(path);\n\n  const options = args[0] as\n    | (StaticHrefOptions & { params?: Record<string, readonly string[] | string> | undefined })\n    | undefined;\n  const params =\n    options !== undefined && \"params\" in options && options.params !== undefined\n      ? (options.params as Record<string, readonly string[] | string>)\n      : {};\n  const pathname = path\n    .split(\"/\")\n    .map((segment) => {\n      if (segment.startsWith(\":...\")) {\n        const name = segment.slice(4);\n        const value = params[name];\n\n        if (!Array.isArray(value)) {\n          throw new Error(`Missing catch-all route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return value.map((part) => encodeURIComponent(part)).join(\"/\");\n      }\n\n      if (segment.startsWith(\":\")) {\n        const name = segment.slice(1);\n        const value = params[name];\n\n        if (typeof value !== \"string\") {\n          throw new Error(`Missing route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return encodeURIComponent(value);\n      }\n\n      return segment;\n    })\n    .join(\"/\");\n  const search = searchString(options?.search);\n  const hash = options?.hash === undefined ? \"\" : `#${encodeURIComponent(options.hash)}`;\n\n  return `${pathname}${search}${hash}`;\n}\n\nfunction assertInternalRoutePath(path: string): void {\n  if (!path.startsWith(\"/\") || path.startsWith(\"//\")) {\n    throw new Error(`href() expected an internal route path, received ${JSON.stringify(path)}.`);\n  }\n\n  for (let index = 0; index < path.length; index += 1) {\n    const code = path.charCodeAt(index);\n\n    if (code <= 0x1f || code === 0x7f) {\n      throw new Error(\"href() route paths must not contain control characters.\");\n    }\n  }\n}\n\nfunction searchString(search: RouteSearchParams | undefined): string {\n  if (search === undefined) {\n    return \"\";\n  }\n\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(search)) {\n    const values = Array.isArray(value) ? value : [value];\n\n    for (const entry of values) {\n      if (entry !== undefined && entry !== null) {\n        params.append(key, String(entry));\n      }\n    }\n  }\n\n  const value = params.toString();\n\n  return value === \"\" ? \"\" : `?${value}`;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reckona/mreact-router",
-  "version": "0.0.149",
+  "version": "0.0.151",
   "description": "File-system app router, SSR, actions, and deployment adapters for mreact.",
   "keywords": [
     "jsx",
@@ -105,20 +105,20 @@
   },
   "dependencies": {
     "typescript": "^6.0.3",
-    "@reckona/mreact": "0.0.149",
-    "@reckona/mreact-compiler": "0.0.149",
-    "@reckona/mreact-query": "0.0.149",
-    "@reckona/mreact-compat": "0.0.149",
-    "@reckona/mreact-devtools": "0.0.149",
-    "@reckona/mreact-reactive-core": "0.0.149",
-    "@reckona/mreact-server": "0.0.149",
-    "@reckona/mreact-shared": "0.0.149",
-    "@reckona/mreact-reactive-dom": "0.0.149"
+    "@reckona/mreact": "0.0.151",
+    "@reckona/mreact-compat": "0.0.151",
+    "@reckona/mreact-devtools": "0.0.151",
+    "@reckona/mreact-reactive-core": "0.0.151",
+    "@reckona/mreact-query": "0.0.151",
+    "@reckona/mreact-compiler": "0.0.151",
+    "@reckona/mreact-reactive-dom": "0.0.151",
+    "@reckona/mreact-shared": "0.0.151",
+    "@reckona/mreact-server": "0.0.151"
   },
   "peerDependencies": {
     "vite": ">=8 <9"
   },
   "optionalDependencies": {
-    "@reckona/mreact-router-native": "0.0.149"
+    "@reckona/mreact-router-native": "0.0.151"
   }
 }

package/src/actions.ts

@@ -286,6 +286,11 @@ export async function dispatchServerActionRequest(options: {
   appDir: string;
   importPolicy?: AppRouterImportPolicy | undefined;
   request: Request;
+  renderSingleFlightNavigation?: ((options: {
+    path: string;
+    request: Request;
+    revalidatedPaths: readonly string[];
+  }) => Promise<Response | undefined>) | undefined;
   routeCache?: AppRouterCache | undefined;
   serverActionCacheVersion?: string | undefined;
   serverActions?: AppRouterServerActionOptions | undefined;
@@ -293,8 +298,14 @@ export async function dispatchServerActionRequest(options: {
   const { revalidatedPaths, value } = await withRouteCacheContext(options.routeCache, () =>
     dispatchServerActionRequestWithoutCacheContext(options),
   );
+  const singleFlight = await renderSingleFlightActionResponse({
+    render: options.renderSingleFlightNavigation,
+    request: options.request,
+    response: value,
+    revalidatedPaths,
+  });
 
-  return withRevalidationHeader(value, revalidatedPaths);
+  return withRevalidationHeader(singleFlight ?? value, revalidatedPaths);
 }
 
 async function dispatchServerActionRequestWithoutCacheContext(options: {
@@ -568,6 +579,70 @@ function redirectToFormReferer(request: Request): Response {
   });
 }
 
+async function renderSingleFlightActionResponse(options: {
+  render:
+    | ((options: {
+      path: string;
+      request: Request;
+      revalidatedPaths: readonly string[];
+    }) => Promise<Response | undefined>)
+    | undefined;
+  request: Request;
+  response: Response;
+  revalidatedPaths: readonly string[];
+}): Promise<Response | undefined> {
+  if (
+    options.render === undefined ||
+    options.revalidatedPaths.length === 0 ||
+    options.request.headers.get("x-mreact-action-single-flight") !== "1" ||
+    !isFormActionRedirectResponse(options.response)
+  ) {
+    return undefined;
+  }
+
+  const path = sameOriginResponseLocationPath(options.request, options.response);
+
+  if (path === undefined || !options.revalidatedPaths.includes(normalizeActionPath(path))) {
+    return undefined;
+  }
+
+  const rendered = await options.render({
+    path,
+    request: options.request,
+    revalidatedPaths: options.revalidatedPaths,
+  });
+
+  if (rendered === undefined) {
+    return undefined;
+  }
+
+  rendered.headers.set("x-mreact-action-single-flight", "1");
+  return rendered;
+}
+
+function isFormActionRedirectResponse(response: Response): boolean {
+  return response.status >= 300 && response.status < 400 && response.headers.has("location");
+}
+
+function sameOriginResponseLocationPath(request: Request, response: Response): string | undefined {
+  const location = response.headers.get("location");
+
+  if (location === null) {
+    return undefined;
+  }
+
+  try {
+    const requestUrl = new URL(request.url);
+    const locationUrl = new URL(location, requestUrl);
+
+    return locationUrl.origin === requestUrl.origin
+      ? `${locationUrl.pathname}${locationUrl.search}`
+      : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
 function sameOriginRefererPath(request: Request): string | undefined {
   const referer = request.headers.get("referer");
 
@@ -587,6 +662,13 @@ function sameOriginRefererPath(request: Request): string | undefined {
   }
 }
 
+function normalizeActionPath(path: string): string {
+  const pathname = path.startsWith("/") ? path : `/${path}`;
+  const withoutTrailing = pathname.length > 1 ? pathname.replace(/\/+$/, "") : pathname;
+
+  return withoutTrailing === "" ? "/" : withoutTrailing;
+}
+
 function withRevalidationHeader(response: Response, paths: string[]): Response {
   if (paths.length > 0) {
     response.headers.set("x-mreact-revalidate", paths.join(","));

package/src/build.ts

@@ -744,17 +744,17 @@ function typedRoutesDeclaration(routes: readonly AppRoute[]): string {
     return left.localeCompare(right);
   });
   const routeUnion = routePaths.map((routePath) => JSON.stringify(routePath)).join(" | ");
-  const routesObject = routePaths
-    .map((routePath) => `  readonly ${JSON.stringify(routePath)}: AppRouteHref<${JSON.stringify(routePath)}>;`)
-    .join("\n");
-
   return [
-    `import type { AppRouteHref } from "@reckona/mreact-router";`,
+    `import type { AppRouteLinkHref as MreactAppRouteLinkHref } from "@reckona/mreact-router";`,
     ``,
     `export type AppRoutePath = ${routeUnion === "" ? "never" : routeUnion};`,
-    `export declare const routes: {`,
-    routesObject,
-    `};`,
+    `export type AppRouteHref = MreactAppRouteLinkHref<AppRoutePath>;`,
+    ``,
+    `declare module "@reckona/mreact-router/link" {`,
+    `  interface AppRouteDeclarations {`,
+    `    readonly path: AppRoutePath;`,
+    `  }`,
+    `}`,
     ``,
   ].join("\n");
 }

package/src/client.ts

@@ -3512,6 +3512,22 @@ function __mreactInstallNavigation() {
     }
   });
   __mreactObserveViewportPrefetchAnchors(document);
+  document.addEventListener("submit", (event) => {
+    if (event.defaultPrevented || typeof fetch !== "function") {
+      return;
+    }
+
+    const submission = __mreactServerActionSubmissionFromEvent(event);
+
+    if (submission === null) {
+      return;
+    }
+
+    event.preventDefault();
+    void __mreactSubmitServerActionForm(submission).catch(() => {
+      location.href = submission.action;
+    });
+  });
   document.addEventListener("click", (event) => {
     if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
       return;
@@ -3562,6 +3578,100 @@ function __mreactInstallNavigation() {
   });
 }
 
+function __mreactServerActionSubmissionFromEvent(event) {
+  const target = event.target;
+  const form = target instanceof Element ? target.closest("form") : null;
+  const submitter = __mreactFormSubmitterFromEvent(event);
+
+  if (!(form instanceof HTMLFormElement)) {
+    return null;
+  }
+
+  const action = submitter?.getAttribute("formaction") ?? form.action;
+  const method = submitter?.getAttribute("formmethod") ?? form.method;
+  const targetName = submitter?.getAttribute("formtarget") ?? form.target;
+  const actionUrl = new URL(action, location.href);
+
+  if (
+    targetName !== "" ||
+    actionUrl.origin !== location.origin ||
+    actionUrl.pathname !== "/_mreact/actions" ||
+    method.toUpperCase() !== "POST"
+  ) {
+    return null;
+  }
+
+  return { action: actionUrl.href, form, submitter };
+}
+
+function __mreactFormSubmitterFromEvent(event) {
+  const submitter = event.submitter;
+
+  return submitter instanceof HTMLElement ? submitter : null;
+}
+
+async function __mreactSubmitServerActionForm(submission) {
+  const response = await fetch(submission.action, {
+    body: __mreactServerActionFormData(submission.form, submission.submitter),
+    headers: { "x-mreact-action-single-flight": "1" },
+    method: "POST",
+  });
+  __mreactApplyRevalidationHeader(response);
+
+  const contentType = response.headers.get("content-type") ?? "";
+  const singleFlight = response.headers.get("x-mreact-action-single-flight") === "1";
+  if (
+    !singleFlight &&
+    !contentType.includes("text/html")
+  ) {
+    location.href = response.url || submission.action;
+    return;
+  }
+
+  const html = await response.text();
+  const applied = __mreactApplyServerActionHtml(html, singleFlight);
+
+  if (!applied) {
+    location.href = response.url || submission.action;
+  }
+}
+
+function __mreactServerActionFormData(form, submitter) {
+  if (submitter !== null) {
+    try {
+      return new FormData(form, submitter);
+    } catch {
+      // Older DOM implementations only accept the form argument.
+    }
+  }
+
+  return new FormData(form);
+}
+
+function __mreactApplyServerActionHtml(html, singleFlight) {
+  __mreactSaveCurrentHistoryState();
+  const applied = __mreactApplyNavigationHtml(html, location.href);
+
+  if (!applied) {
+    if (
+      !singleFlight ||
+      typeof document === "undefined" ||
+      typeof document.open !== "function"
+    ) {
+      return false;
+    }
+
+    document.open();
+    document.write(html);
+    document.close();
+    return true;
+  }
+
+  __mreactResetNavigationFocus();
+  __mreactAnnounceNavigation();
+  return true;
+}
+
 function __mreactInstallNavigationFetchRevalidation() {
   if (
     __mreactNavigationState.fetchRevalidationInstalled ||

package/src/index.ts

@@ -87,6 +87,11 @@ export type {
 export type { ServerActionContext } from "./actions.js";
 export type {
   AppRouteHref,
+  AppRouteLinkHref,
+  AppRouteLinkHrefSuffix,
+  AppRouteLinkPathname,
+  AppRouteLinkSegment,
+  AppRouteLinkSegments,
   DynamicHrefOptions,
   RouteParamsFor,
   RouteSearchParams,
@@ -144,10 +149,14 @@ export type {
 export type { CookieOptions } from "./cookies.js";
 export type { AppRouterImportPolicy } from "./import-policy.js";
 export type {
+  AppRouteDeclarations,
+  ConcreteLinkHrefGuard,
   LinkChild,
+  LinkHref,
   LinkOptions,
   LinkPrefetch,
   LinkProps,
+  RegisteredAppRoutePath,
   LinkScroll,
   LinkTransition,
   TrustedLinkHtml,

package/src/link.ts

@@ -2,6 +2,14 @@ import { escapeHtmlAttribute, escapeHtmlText } from "@reckona/mreact-shared/html
 import type { HtmlSink } from "@reckona/mreact-shared/compiler-contract";
 import type { ReactCompatElement, ReactCompatNode } from "@reckona/mreact-compat";
 import { safeUrlAttributeValue } from "@reckona/mreact-shared/url-safety";
+import type { AppRouteLinkHref } from "./typed-routes.js";
+export type {
+  AppRouteLinkHref,
+  AppRouteLinkHrefSuffix,
+  AppRouteLinkPathname,
+  AppRouteLinkSegment,
+  AppRouteLinkSegments,
+} from "./typed-routes.js";
 
 const TRUSTED_LINK_HTML = Symbol.for("modular.react.router.trusted_link_html");
 
@@ -10,21 +18,28 @@ export type LinkScroll = "top" | "preserve";
 export type LinkTransition = "auto" | "none" | false;
 export type TrustedLinkHtml = { readonly [TRUSTED_LINK_HTML]: string };
 export type LinkChild = ReactCompatNode | Node | TrustedLinkHtml | readonly LinkChild[];
-
-export interface LinkOptions {
-  href: string;
+export interface AppRouteDeclarations {}
+export type RegisteredAppRoutePath = AppRouteDeclarations extends { readonly path: infer Path }
+  ? Extract<Path, `/${string}`>
+  : never;
+export type LinkHref = [RegisteredAppRoutePath] extends [never]
+  ? string
+  : AppRouteLinkHref<RegisteredAppRoutePath>;
+
+export interface LinkOptions<Href extends string = LinkHref> {
+  href: Href;
   prefetch?: LinkPrefetch | undefined;
   reload?: boolean | undefined;
   scroll?: LinkScroll | undefined;
   transition?: LinkTransition | undefined;
 }
 
-export interface LinkProps extends LinkOptions {
+export interface LinkProps<Href extends string = LinkHref> extends LinkOptions<Href> {
   children?: LinkChild;
   [attribute: string]: unknown;
 }
 
-export function linkProps(options: LinkOptions): Record<string, string> {
+export function linkProps(options: LinkOptions<string>): Record<string, string> {
   return {
     href: options.href,
     ...(options.prefetch === undefined || options.prefetch === "intent"
@@ -40,11 +55,19 @@ export function linkProps(options: LinkOptions): Record<string, string> {
   };
 }
 
-export function Link(props: LinkProps): ReactCompatElement;
-export function Link(sink: HtmlSink, props: LinkProps): void;
+export type ConcreteLinkHrefGuard<Href extends string> = [RegisteredAppRoutePath] extends [never]
+  ? unknown
+  : Href extends Extract<RegisteredAppRoutePath, `${string}:${string}`>
+    ? { readonly __mreactRoutePatternHrefError__: never }
+    : unknown;
+
+export function Link<const Href extends LinkHref>(
+  props: LinkProps<Href> & ConcreteLinkHrefGuard<Href>,
+): ReactCompatElement;
+export function Link(sink: HtmlSink, props: LinkProps<string>): void;
 export function Link(
-  sinkOrProps: HtmlSink | LinkProps,
-  maybeProps?: LinkProps,
+  sinkOrProps: HtmlSink | LinkProps<string>,
+  maybeProps?: LinkProps<string>,
 ): ReactCompatElement | string | HTMLAnchorElement | void {
   if (maybeProps !== undefined) {
     (sinkOrProps as HtmlSink).append(renderLinkString(maybeProps));
@@ -60,7 +83,7 @@ export function Link(
   [TRUSTED_LINK_HTML]: html,
 });
 
-function renderLink(props: LinkProps): string | HTMLAnchorElement {
+function renderLink(props: LinkProps<string>): string | HTMLAnchorElement {
   const { href, prefetch, reload, scroll, transition, ...rest } = props;
   const propsWithLinkAttrs = {
     ...rest,
@@ -74,7 +97,7 @@ function renderLink(props: LinkProps): string | HTMLAnchorElement {
   return renderAnchorString(propsWithLinkAttrs);
 }
 
-function renderLinkString(props: LinkProps): string {
+function renderLinkString(props: LinkProps<string>): string {
   const { href, prefetch, reload, scroll, transition, ...rest } = props;
 
   return renderAnchorString({

package/src/render.ts

@@ -812,6 +812,16 @@ async function renderAppRequestInternal(options: RenderAppRequestOptions): Promi
       appDir: options.appDir,
       importPolicy: options.importPolicy,
       request: options.request,
+      renderSingleFlightNavigation: async (singleFlight) =>
+        renderAppRequestInternal({
+          ...options,
+          matchedRoute: undefined,
+          request: singleFlightNavigationRequest({
+            path: singleFlight.path,
+            request: singleFlight.request,
+          }),
+          requestUrl: undefined,
+        }),
       routeCache: options.routeCache,
       ...(options.serverModuleCacheVersion === undefined
         ? {}
@@ -1672,6 +1682,25 @@ function isNavigationRouteCacheReloadRequest(request: Request): boolean {
   );
 }
 
+function singleFlightNavigationRequest(options: { path: string; request: Request }): Request {
+  const actionUrl = new URL(options.request.url);
+  const targetUrl = new URL(options.path, actionUrl);
+  const headers = new Headers();
+  const cookie = options.request.headers.get("cookie");
+
+  if (cookie !== null) {
+    headers.set("cookie", cookie);
+  }
+
+  headers.set("x-mreact-navigation", "1");
+  headers.set("x-mreact-navigation-cache", "reload");
+
+  return new Request(targetUrl, {
+    headers,
+    method: "GET",
+  });
+}
+
 async function nearestBoundaryFileForPage(options: {
   appDir: string;
   filename: string;

package/src/typed-routes.ts

@@ -6,9 +6,12 @@ export type RouteSearchParams = Record<
 
 export type RouteParamsFor<Path extends `/${string}`> = Simplify<ExtractRouteParams<Path>>;
 
-export type AppRouteHref<Path extends `/${string}`> = HasRouteParams<Path> extends true
-  ? (options: DynamicHrefOptions<Path>) => string
-  : (options?: StaticHrefOptions) => string;
+export type AppRouteHref<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never
+  ? (options?: StaticHrefOptions) => string
+  : (options: DynamicHrefOptions<Path>) => string;
+
+export type AppRouteLinkHref<Path extends `/${string}`> =
+  `${AppRouteLinkPathname<Path>}${AppRouteLinkHrefSuffix}`;
 
 export interface StaticHrefOptions {
   hash?: string | undefined;
@@ -35,6 +38,22 @@ type SegmentRouteParam<Segment extends string> = Segment extends `:...${infer Na
 
 type Simplify<T> = { [Key in keyof T]: T[Key] } & {};
 
+export type AppRouteLinkHrefSuffix = "" | `?${string}` | `#${string}` | `?${string}#${string}`;
+
+export type AppRouteLinkPathname<Path extends `/${string}`> = Path extends "/"
+  ? "/"
+  : Path extends `/${infer Segments}`
+    ? `/${AppRouteLinkSegments<Segments>}`
+    : never;
+
+export type AppRouteLinkSegments<Segments extends string> = Segments extends `${infer Segment}/${infer Rest}`
+  ? `${AppRouteLinkSegment<Segment>}/${AppRouteLinkSegments<Rest>}`
+  : AppRouteLinkSegment<Segments>;
+
+export type AppRouteLinkSegment<Segment extends string> = Segment extends `:${string}`
+  ? string
+  : Segment;
+
 export function href<const Path extends `/${string}`>(
   path: Path,
   ...args: HasRouteParams<Path> extends true