@mismo/next 0.1.0-beta.0 → 0.1.0-beta.1

package/README.md

@@ -7,7 +7,7 @@ mismo for Next.js (App Router). [mismo](https://mismo.dev) shares screens, route
 ## Install
 
 ```sh
-npm i @mismo/core @mismo/next
+pnpm add @mismo/core @mismo/next
 ```
 
 ## Setup
@@ -26,6 +26,25 @@ export default withMismo(
 
 `@acme/app` is your shared package, which Next.js compiles along with mismo. Supports Next.js `>=16 <17`.
 
+## Route options
+
+Plain values go beside the screen, and mismo copies them into the generated server page. Code goes in the route's server file, which the native app never bundles:
+
+```ts
+// routes/orgs/[id].tsx
+export const next = { revalidate: 3600 } satisfies NextRouteOptions;
+
+// routes/orgs/[id].server.ts
+export const next = {
+  async generateMetadata({ params }) {
+    const { id } = await params;
+    return { title: `Organization ${id}` };
+  },
+} satisfies NextServerOptions;
+```
+
+Shared screens stay client components, since they also run on native. See [route options](https://mismo.dev/docs/route-options).
+
 See [Getting started](https://mismo.dev/docs/getting-started) for the whole setup: the shared routes package, and each app.
 
 ## License

package/dist/config.d.ts

@@ -1,12 +1,12 @@
 export interface WithMismoOptions {
-    /** The shared `routes.config.ts`, relative to the app. */
-    config: string;
-    /** The App Router's folder, relative to the app: `app`, or `src/app`. */
-    outDir: string;
-    /** The app's types file, relative to the app. */
-    types: string;
-    /** The app's folder. Next.js loads its config there, so it is `process.cwd()` by default. */
-    cwd?: string;
+  /** The shared `routes.config.ts`, relative to the app. */
+  config: string;
+  /** The App Router's folder, relative to the app: `app`, or `src/app`. */
+  outDir: string;
+  /** The app's types file, relative to the app. */
+  types: string;
+  /** The app's folder. Next.js loads its config there, so it is `process.cwd()` by default. */
+  cwd?: string;
 }
 /**
  * Next.js's config for an app on mismo: writes the app's routes into the App Router's folder when
@@ -17,3 +17,4 @@ export interface WithMismoOptions {
  *     export default withMismo({ … }, { config: "../shared/routes.config.ts", outDir: "app", types: "app/routes.gen.ts" });
  */
 export declare function withMismo<T extends object>(nextConfig: T, { config, outDir, types, cwd }: WithMismoOptions): T;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../src/config.ts"],"mappings":"A,iBAiBiB;;EAEf;;EAEA;;EAEA;;EAEA;;;;;;;;;;wBAWc,UAAU,kBAAkB,YAAY,KAAK,QAAQ,QAAQ,OAAO,OAAuB,mBAAmB"}

package/dist/config.js

@@ -1,33 +1,54 @@
+import { output } from "./output.js";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { watchAppRoutes } from "@mismo/core/generate";
-import { output } from "./output.js";
+// src/config.ts
 /**
- * Next.js's config for an app on mismo: writes the app's routes into the App Router's folder when
- * Next.js loads its config (before it reads the folder, for `next dev` and `next build` alike), and
- * again in dev as route files come and go; and points `@mismo/core` at Next.js's runtime, for Turbopack
- * and for webpack.
- *
- *     export default withMismo({ … }, { config: "../shared/routes.config.ts", outDir: "app", types: "app/routes.gen.ts" });
- */
-export function withMismo(nextConfig, { config, outDir, types, cwd = process.cwd() }) {
-    const next = nextConfig;
-    watchAppRoutes({ config, output: output({ outDir, types }), cwd });
-    // From the app, which depends on this adapter: the shared package importing `@mismo/core` may not.
-    const runtime = createRequire(path.join(cwd, "package.json")).resolve("@mismo/next/runtime");
-    // Turbopack takes a path relative to the app, webpack an absolute one.
-    const relative = `./${path.relative(cwd, runtime).split(path.sep).join("/")}`;
-    const previous = next.webpack;
-    const changed = {
-        turbopack: {
-            ...next.turbopack,
-            resolveAlias: { ...next.turbopack?.resolveAlias, "@mismo/core": relative },
-        },
-        webpack: (webpackConfig, context) => {
-            const config = previous ? previous(webpackConfig, context) : webpackConfig;
-            config.resolve = { ...config.resolve, alias: { ...config.resolve?.alias, "@mismo/core$": runtime } };
-            return config;
-        },
-    };
-    return { ...next, ...changed };
+* Next.js's config for an app on mismo: writes the app's routes into the App Router's folder when
+* Next.js loads its config (before it reads the folder, for `next dev` and `next build` alike), and
+* again in dev as route files come and go; and points `@mismo/core` at Next.js's runtime, for Turbopack
+* and for webpack.
+*
+*     export default withMismo({ … }, { config: "../shared/routes.config.ts", outDir: "app", types: "app/routes.gen.ts" });
+*/
+function withMismo(nextConfig, { config, outDir, types, cwd = process.cwd() }) {
+	const next = nextConfig;
+	watchAppRoutes({
+		config,
+		output: output({
+			outDir,
+			types
+		}),
+		cwd
+	});
+	const runtime = createRequire(path.join(cwd, "package.json")).resolve("@mismo/next/runtime");
+	const relative = `./${path.relative(cwd, runtime).split(path.sep).join("/")}`;
+	const previous = next.webpack;
+	const changed = {
+		turbopack: {
+			...next.turbopack,
+			resolveAlias: {
+				...next.turbopack?.resolveAlias,
+				"@mismo/core": relative
+			}
+		},
+		webpack: (webpackConfig, context) => {
+			const config = previous ? previous(webpackConfig, context) : webpackConfig;
+			config.resolve = {
+				...config.resolve,
+				alias: {
+					...config.resolve?.alias,
+					"@mismo/core$": runtime
+				}
+			};
+			return config;
+		}
+	};
+	return {
+		...next,
+		...changed
+	};
 }
+export { withMismo };
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../src/config.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nimport { watchAppRoutes } from \"@mismo/core/generate\";\n\nimport { output } from \"./output.ts\";\n\n/** The part of Next.js's config this changes, read from any config object. */\ninterface NextConfigPart {\n  turbopack?: { resolveAlias?: Record<string, unknown> } | undefined;\n  webpack?: ((config: WebpackConfig, context: unknown) => WebpackConfig) | null | undefined;\n}\n\ninterface WebpackConfig {\n  resolve?: { alias?: Record<string, unknown> };\n}\n\nexport interface WithMismoOptions {\n  /** The shared `routes.config.ts`, relative to the app. */\n  config: string;\n  /** The App Router's folder, relative to the app: `app`, or `src/app`. */\n  outDir: string;\n  /** The app's types file, relative to the app. */\n  types: string;\n  /** The app's folder. Next.js loads its config there, so it is `process.cwd()` by default. */\n  cwd?: string;\n}\n\n/**\n * Next.js's config for an app on mismo: writes the app's routes into the App Router's folder when\n * Next.js loads its config (before it reads the folder, for `next dev` and `next build` alike), and\n * again in dev as route files come and go; and points `@mismo/core` at Next.js's runtime, for Turbopack\n * and for webpack.\n *\n *     export default withMismo({ … }, { config: \"../shared/routes.config.ts\", outDir: \"app\", types: \"app/routes.gen.ts\" });\n */\nexport function withMismo<T extends object>(nextConfig: T, { config, outDir, types, cwd = process.cwd() }: WithMismoOptions): T {\n  const next = nextConfig as T & NextConfigPart;\n  watchAppRoutes({ config, output: output({ outDir, types }), cwd });\n\n  // From the app, which depends on this adapter: the shared package importing `@mismo/core` may not.\n  const runtime = createRequire(path.join(cwd, \"package.json\")).resolve(\"@mismo/next/runtime\");\n  // Turbopack takes a path relative to the app, webpack an absolute one.\n  const relative = `./${path.relative(cwd, runtime).split(path.sep).join(\"/\")}`;\n  const previous = next.webpack;\n\n  const changed: NextConfigPart = {\n    turbopack: {\n      ...next.turbopack,\n      resolveAlias: { ...next.turbopack?.resolveAlias, \"@mismo/core\": relative },\n    },\n    webpack: (webpackConfig: WebpackConfig, context: unknown) => {\n      const config = previous ? previous(webpackConfig, context) : webpackConfig;\n      config.resolve = { ...config.resolve, alias: { ...config.resolve?.alias, \"@mismo/core$\": runtime } };\n      return config;\n    },\n  };\n\n  return { ...next, ...changed };\n}\n"],"mappings":";;;;;;;;;;;;;AAoCA,SAAgB,UAA4B,YAAe,EAAE,QAAQ,QAAQ,OAAO,MAAM,QAAQ,IAAI,KAA0B;CAC9H,MAAM,OAAO;CACb,eAAe;EAAE;EAAQ,QAAQ,OAAO;GAAE;GAAQ;EAAM,CAAC;EAAG;CAAI,CAAC;CAGjE,MAAM,UAAU,cAAc,KAAK,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,QAAQ,qBAAqB;CAE3F,MAAM,WAAW,KAAK,KAAK,SAAS,KAAK,OAAO,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;CAC1E,MAAM,WAAW,KAAK;CAEtB,MAAM,UAA0B;EAC9B,WAAW;GACT,GAAG,KAAK;GACR,cAAc;IAAE,GAAG,KAAK,WAAW;IAAc,eAAe;GAAS;EAC3E;EACA,UAAU,eAA8B,YAAqB;GAC3D,MAAM,SAAS,WAAW,SAAS,eAAe,OAAO,IAAI;GAC7D,OAAO,UAAU;IAAE,GAAG,OAAO;IAAS,OAAO;KAAE,GAAG,OAAO,SAAS;KAAO,gBAAgB;IAAQ;GAAE;GACnG,OAAO;EACT;CACF;CAEA,OAAO;EAAE,GAAG;EAAM,GAAG;CAAQ;AAC/B"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import { output } from "./output.js";
+import { NextRouteOptions, NextServerOptions } from "./options.js";
 export declare const next: {
-    name: string;
-    rules: import("@mismo/core/generate").RouteRules;
-    output: typeof output;
+  name: string;
+  rules: import("@mismo/core/generate").RouteRules;
+  output: typeof output;
 };
+export type { NextRouteOptions, NextServerOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;qBAOa"}

package/dist/index.js

@@ -1,6 +1,10 @@
 import { output, rules } from "./output.js";
-export const next = {
-    name: "Next.js",
-    rules,
-    output,
+// src/index.ts
+const next = {
+	name: "Next.js",
+	rules,
+	output
 };
+export { next };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// `@mismo/next`: mismo for Next.js's App Router. Routes written out for a Next.js app (`output`),\n// and what the App Router cannot express (`rules`). The runtime is `@mismo/next/runtime`, pointed\n// at by `withMismo` (`@mismo/next/config`).\nimport type { RouterAdapter } from \"@mismo/core/adapter\";\n\nimport { output, rules } from \"./output.ts\";\n\nexport const next = {\n  name: \"Next.js\",\n  rules,\n  output,\n} satisfies RouterAdapter;\n\nexport type { NextRouteOptions, NextServerOptions } from \"./options.ts\";\n"],"mappings":";;AAOA,MAAa,OAAO;CAClB,MAAM;CACN;CACA;AACF"}

package/dist/options.d.ts

@@ -0,0 +1,50 @@
+import { Metadata, ResolvingMetadata, ResolvingViewport, Viewport } from "next";
+/** What Next.js passes `generateMetadata` and `generateViewport`: the route's params and query. */
+type RouteProps = {
+  params: Promise<Record<string, string | string[] | undefined>>;
+  searchParams: Promise<Record<string, string | string[] | undefined>>;
+};
+/** Route segment config: written as literals, since Next.js reads it without running the file. */
+type SegmentConfig = {
+  dynamic?: "auto" | "force-dynamic" | "error" | "force-static";
+  dynamicParams?: boolean;
+  revalidate?: number | false;
+  fetchCache?: "auto" | "default-cache" | "only-cache" | "force-cache" | "force-no-store" | "default-no-store" | "only-no-store";
+  runtime?: "nodejs" | "edge";
+  preferredRegion?: "auto" | "global" | "home" | string | string[];
+  maxDuration?: number;
+};
+/**
+ * Next.js's options for a shared route that are plain values, exported as `next` from the route's
+ * own module: metadata and segment config. The module is a client component, which Next.js can't
+ * read from the server, so mismo copies each value into the generated server page as written. Each
+ * must stand on its own: no names, calls or functions. Anything that needs code goes in the route's
+ * server file (`NextServerOptions`).
+ *
+ *     export const next = { metadata: { title: "Settings" }, revalidate: 60 } satisfies NextRouteOptions;
+ */
+export type NextRouteOptions = SegmentConfig & {
+  metadata?: Metadata;
+  viewport?: Viewport;
+};
+/**
+ * Next.js's options for a shared route that run on the server, exported as `next` from the route's
+ * server file (`orgs/[id].server.ts`), which only the web app's generated server components import:
+ * functions such as `generateMetadata` and `generateStaticParams`, and any value that needs code.
+ *
+ *     export const next = {
+ *       async generateMetadata({ params }) {
+ *         const { id } = await params;
+ *         return { title: `Organization ${id}` };
+ *       },
+ *     } satisfies NextServerOptions;
+ */
+export type NextServerOptions = SegmentConfig & {
+  metadata?: Metadata;
+  generateMetadata?: (props: RouteProps, parent: ResolvingMetadata) => Metadata | Promise<Metadata>;
+  viewport?: Viewport;
+  generateViewport?: (props: RouteProps, parent: ResolvingViewport) => Viewport | Promise<Viewport>;
+  generateStaticParams?: () => Record<string, string | string[]>[] | Promise<Record<string, string | string[]>[]>;
+};
+export {};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","names":[],"sources":["../src/options.ts"],"mappings":";;KAGK;EACH,QAAQ,QAAQ;EAChB,cAAc,QAAQ;;;KAInB;EACH;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;YAYU,mBAAmB;EAC7B,WAAW;EACX,WAAW;;;;;;;;;;;;;;YAeD,oBAAoB;EAC9B,WAAW;EACX,oBAAoB,OAAO,YAAY,QAAQ,sBAAsB,WAAW,QAAQ;EACxF,WAAW;EACX,oBAAoB,OAAO,YAAY,QAAQ,sBAAsB,WAAW,QAAQ;EACxF,6BAA6B,sCAAsC,QAAQ"}

package/dist/output.d.ts

@@ -1,14 +1,21 @@
-import { type RouteOutput, type RouteRules } from "@mismo/core/adapter";
-/** What Next.js's App Router cannot express, from its folder conventions. */
-export declare const rules: RouteRules;
+import { RouteOutput } from "@mismo/core/adapter";
 /**
  * Next.js's files, for a web app on the App Router: the routes folder's layout in `app/`, a
  * `page.tsx` per page and a `layout.tsx` per layout, next to the app's own (its root `layout.tsx`
- * among them). The shared screens use hooks, so each file is a client component. A page renders in
- * a Suspense boundary, which Next.js needs around `useSearchParams` to prerender it; a layout hands
- * the page Next.js gives it (`children`) to `Slot`.
+ * among them).
+ *
+ * Each is a server component that renders a client one beside it: `page.tsx` renders
+ * `mismo-page.tsx`, `layout.tsx` renders `mismo-layout.tsx`. The shared screens use hooks, so they
+ * render on the client side of that line; the server file carries the route's Next.js options
+ * (metadata, `generateStaticParams`, its rendering and caching config), which Next.js reads only
+ * from server files. They come from the route's server file, `orgs/[id].server.ts`, as
+ * `export const next = { … }` (see `NextServerOptions`).
+ *
+ * A page renders in a Suspense boundary, which Next.js needs around `useSearchParams` to prerender
+ * it; a layout hands the page Next.js gives it (`children`) to `Slot`.
  */
 export declare function output({ outDir, types }: {
-    outDir: string;
-    types: string;
+  outDir: string;
+  types: string;
 }): RouteOutput;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","names":[],"sources":["../src/output.ts"],"mappings":";;;;;;;;;;;;;;;;wBAuDgB,SAAS,QAAQ;EAAW;EAAgB;IAAkB"}

package/dist/output.js

@@ -1,66 +1,142 @@
 import path from "node:path";
-import { GENERATED, importPath, isGroup, isParam, oneUrlPerPage, placesOf } from "@mismo/core/adapter";
+import { GENERATED, exportedOptions, importPath, isGroup, isParam, isPlainValue, oneUrlPerPage, placesOf, serverModule } from "@mismo/core/adapter";
+// src/output.ts
 /** What Next.js's App Router cannot express, from its folder conventions. */
-export const rules = {
-    router: "Next.js",
-    target: "web",
-    check(routes) {
-        // It refuses two pages that resolve to one URL, such as `(a)/about` and `(b)/about`.
-        const problems = oneUrlPerPage(routes, "Next.js");
-        // Folder names it reads as something other than a route, without an error.
-        for (const { route } of placesOf(routes)) {
-            for (const segment of route.segments) {
-                if (isParam(segment))
-                    continue;
-                if (segment.startsWith("_"))
-                    problems.push(`${route.id}: "${segment}" starts with "_", a private folder to Next.js, left out of its routes.`);
-                if (segment.startsWith("@"))
-                    problems.push(`${route.id}: "${segment}" starts with "@", a parallel route's slot to Next.js.`);
-                if (isGroup(segment) && segment.startsWith("(."))
-                    problems.push(`${route.id}: "${segment}" is an intercepting route to Next.js.`);
-            }
-        }
-        return problems;
-    },
+const rules = {
+	router: "Next.js",
+	target: "web",
+	check(routes) {
+		const problems = oneUrlPerPage(routes, "Next.js");
+		for (const { route } of placesOf(routes)) for (const segment of route.segments) {
+			if (isParam(segment)) continue;
+			if (segment.startsWith("_")) problems.push(`${route.id}: "${segment}" starts with "_", a private folder to Next.js, left out of its routes.`);
+			if (segment.startsWith("@")) problems.push(`${route.id}: "${segment}" starts with "@", a parallel route's slot to Next.js.`);
+			if (isGroup(segment) && segment.startsWith("(.")) problems.push(`${route.id}: "${segment}" is an intercepting route to Next.js.`);
+		}
+		return problems;
+	}
 };
 /**
- * Next.js's files, for a web app on the App Router: the routes folder's layout in `app/`, a
- * `page.tsx` per page and a `layout.tsx` per layout, next to the app's own (its root `layout.tsx`
- * among them). The shared screens use hooks, so each file is a client component. A page renders in
- * a Suspense boundary, which Next.js needs around `useSearchParams` to prerender it; a layout hands
- * the page Next.js gives it (`children`) to `Slot`.
- */
-export function output({ outDir, types }) {
-    return {
-        name: "next",
-        target: "web",
-        outDir,
-        types,
-        rules,
-        runtime: "@mismo/next/runtime",
-        emit(routes, context) {
-            const files = new Map();
-            for (const { route, folder } of placesOf(routes)) {
-                const segments = [...folder, ...route.segments].map(toNext);
-                const dirs = route.layout || segments.at(-1) !== "index" ? segments : segments.slice(0, -1);
-                const file = [...dirs, route.layout ? "layout.tsx" : "page.tsx"].join("/");
-                const from = importPath(path.join(context.outDir, file), route.file);
-                files.set(file, route.layout ? layoutFile(from) : pageFile(from));
-            }
-            return files;
-        },
-    };
+* Next.js's files, for a web app on the App Router: the routes folder's layout in `app/`, a
+* `page.tsx` per page and a `layout.tsx` per layout, next to the app's own (its root `layout.tsx`
+* among them).
+*
+* Each is a server component that renders a client one beside it: `page.tsx` renders
+* `mismo-page.tsx`, `layout.tsx` renders `mismo-layout.tsx`. The shared screens use hooks, so they
+* render on the client side of that line; the server file carries the route's Next.js options
+* (metadata, `generateStaticParams`, its rendering and caching config), which Next.js reads only
+* from server files. They come from the route's server file, `orgs/[id].server.ts`, as
+* `export const next = { … }` (see `NextServerOptions`).
+*
+* A page renders in a Suspense boundary, which Next.js needs around `useSearchParams` to prerender
+* it; a layout hands the page Next.js gives it (`children`) to `Slot`.
+*/
+function output({ outDir, types }) {
+	return {
+		name: "next",
+		target: "web",
+		outDir,
+		types,
+		rules,
+		runtime: "@mismo/next/runtime",
+		emit(routes, context) {
+			const files = /* @__PURE__ */ new Map();
+			for (const { route, folder } of placesOf(routes)) {
+				const segments = [...folder, ...route.segments].map(toNext);
+				const dirs = route.layout || segments.at(-1) !== "index" ? segments : segments.slice(0, -1);
+				const kind = route.layout ? "layout" : "page";
+				const server = [...dirs, `${kind}.tsx`].join("/");
+				const client = [...dirs, `mismo-${kind}.tsx`].join("/");
+				const from = importPath(path.join(context.outDir, client), route.file);
+				files.set(client, route.layout ? clientLayout(from) : clientPage(from));
+				files.set(server, serverFile(route, kind, path.join(context.outDir, server)));
+			}
+			return files;
+		}
+	};
 }
 /** A segment as Next.js spells it: `:id` is `[id]`. */
-const toNext = (segment) => (isParam(segment) ? `[${segment.slice(1)}]` : segment);
-const pageFile = (from) => `${GENERATED}"use client";
+const toNext = (segment) => isParam(segment) ? `[${segment.slice(1)}]` : segment;
+/** Options Next.js reads as values at run time: passed on as the export of their name. */
+const VALUE_EXPORTS = /* @__PURE__ */ new Set([
+	"metadata",
+	"generateMetadata",
+	"viewport",
+	"generateViewport",
+	"generateStaticParams"
+]);
+/**
+* Route segment config: Next.js reads these from the file's source without running it, so each
+* must be a literal, and is written into the generated file as one.
+*/
+const CONFIG_EXPORTS = /* @__PURE__ */ new Set([
+	"dynamic",
+	"dynamicParams",
+	"revalidate",
+	"fetchCache",
+	"runtime",
+	"preferredRegion",
+	"maxDuration"
+]);
+const LITERAL = /^(?:-?\d+(?:\.\d+)?|true|false|"[^"\\]*"|'[^'\\]*'|\[\s*(?:(?:"[^"]*"|'[^']*')\s*,?\s*)*\])$/;
+/**
+* The server component: the route's Next.js options, and the client component it renders.
+*
+* Options come from two places. The route's module may set plain values (`metadata: { title }`,
+* `revalidate: 60`): it's a client module Next.js can't read from the server, so they're copied in
+* as text. Its server file may set anything, functions included (`generateMetadata`), and is
+* imported. An option set in both is an error, so each has one source.
+*/
+function serverFile(route, kind, at) {
+	const imports = [];
+	const exports = [];
+	const server = serverModule(route.file);
+	const fromModule = exportedOptions(route.file, "next") ?? /* @__PURE__ */ new Map();
+	const fromServer = server && exportedOptions(server, "next") || /* @__PURE__ */ new Map();
+	const known = (key, where) => {
+		if (!VALUE_EXPORTS.has(key) && !CONFIG_EXPORTS.has(key)) throw new Error(`${where}: \`next.${key}\` isn't a Next.js route option. It takes ${[...VALUE_EXPORTS, ...CONFIG_EXPORTS].join(", ")}.`);
+	};
+	const config = (key, value, where) => {
+		const literal = value.replace(/\s+as\s+const$/, "").trim();
+		if (!LITERAL.test(literal)) throw new Error(`${where}: \`next.${key}\` must be a literal, such as \`${key}: 60\`. Next.js reads it without running the file.`);
+		exports.push(`export const ${key} = ${literal};`);
+	};
+	for (const [key, value] of fromModule) {
+		known(key, route.id);
+		if (fromServer.has(key)) throw new Error(`${route.id}: \`next.${key}\` is set in both the route's module and its server file. Keep one.`);
+		if (CONFIG_EXPORTS.has(key)) config(key, value, route.id);
+		else if (isPlainValue(value)) exports.push(`export const ${key} = ${value.replace(/\s+as\s+const$/, "").trim()};`);
+		else throw new Error(`${route.id}: \`next.${key}\` isn't a plain value, so the server can't take it from the route's module. Move it to the route's server file, ${route.id}.server.ts.`);
+	}
+	for (const [key, value] of fromServer) {
+		known(key, `${route.id}.server`);
+		if (CONFIG_EXPORTS.has(key)) config(key, value, `${route.id}.server`);
+		else exports.push(`export const ${key} = next.${key};`);
+	}
+	if (server && exports.some((line) => line.includes("= next."))) imports.push(`import { next } from "${importPath(at, server)}";`);
+	if (kind === "layout") {
+		imports.unshift("import type { ReactNode } from \"react\";");
+		imports.push("import Shell from \"./mismo-layout\";");
+	} else imports.push("import Screen from \"./mismo-page\";");
+	const component = kind === "layout" ? `export default function MismoLayout({ children }: { children: ReactNode }) {
+  return <Shell>{children}</Shell>;
+}` : `export default function MismoPage() {
+  return <Screen />;
+}`;
+	return `${GENERATED}${[
+		imports.join("\n"),
+		...exports.length ? [exports.join("\n")] : [],
+		component
+	].join("\n\n")}\n`;
+}
+const clientPage = (from) => `${GENERATED}"use client";
 
 import { Suspense } from "react";
 
 import Page from "${from}";
 
 // Next.js prerenders a page only with a boundary around \`useSearchParams\`.
-export default function MismoPage() {
+export default function MismoScreen() {
   return (
     <Suspense>
       <Page />
@@ -68,7 +144,7 @@ export default function MismoPage() {
   );
 }
 `;
-const layoutFile = (from) => `${GENERATED}"use client";
+const clientLayout = (from) => `${GENERATED}"use client";
 
 import { SlotChildren } from "@mismo/next/runtime";
 import type { ReactNode } from "react";
@@ -76,7 +152,7 @@ import type { ReactNode } from "react";
 import Layout from "${from}";
 
 // Next.js gives a layout its page as \`children\`: the shared layout renders it with \`Slot\`.
-export default function MismoLayout({ children }: { children: ReactNode }) {
+export default function MismoShell({ children }: { children: ReactNode }) {
   return (
     <SlotChildren value={children}>
       <Layout />
@@ -84,3 +160,6 @@ export default function MismoLayout({ children }: { children: ReactNode }) {
   );
 }
 `;
+export { output, rules };
+
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","names":[],"sources":["../src/output.ts"],"sourcesContent":["import path from \"node:path\";\n\nimport {\n  exportedOptions,\n  type Files,\n  isPlainValue,\n  GENERATED,\n  importPath,\n  isGroup,\n  isParam,\n  oneUrlPerPage,\n  placesOf,\n  type RouteOutput,\n  type RouteRules,\n  type SharedRoute,\n  serverModule,\n} from \"@mismo/core/adapter\";\n\n/** What Next.js's App Router cannot express, from its folder conventions. */\nexport const rules: RouteRules = {\n  router: \"Next.js\",\n  target: \"web\",\n  check(routes) {\n    // It refuses two pages that resolve to one URL, such as `(a)/about` and `(b)/about`.\n    const problems = oneUrlPerPage(routes, \"Next.js\");\n\n    // Folder names it reads as something other than a route, without an error.\n    for (const { route } of placesOf(routes)) {\n      for (const segment of route.segments) {\n        if (isParam(segment)) continue;\n        if (segment.startsWith(\"_\")) problems.push(`${route.id}: \"${segment}\" starts with \"_\", a private folder to Next.js, left out of its routes.`);\n        if (segment.startsWith(\"@\")) problems.push(`${route.id}: \"${segment}\" starts with \"@\", a parallel route's slot to Next.js.`);\n        if (isGroup(segment) && segment.startsWith(\"(.\")) problems.push(`${route.id}: \"${segment}\" is an intercepting route to Next.js.`);\n      }\n    }\n\n    return problems;\n  },\n};\n\n/**\n * Next.js's files, for a web app on the App Router: the routes folder's layout in `app/`, a\n * `page.tsx` per page and a `layout.tsx` per layout, next to the app's own (its root `layout.tsx`\n * among them).\n *\n * Each is a server component that renders a client one beside it: `page.tsx` renders\n * `mismo-page.tsx`, `layout.tsx` renders `mismo-layout.tsx`. The shared screens use hooks, so they\n * render on the client side of that line; the server file carries the route's Next.js options\n * (metadata, `generateStaticParams`, its rendering and caching config), which Next.js reads only\n * from server files. They come from the route's server file, `orgs/[id].server.ts`, as\n * `export const next = { … }` (see `NextServerOptions`).\n *\n * A page renders in a Suspense boundary, which Next.js needs around `useSearchParams` to prerender\n * it; a layout hands the page Next.js gives it (`children`) to `Slot`.\n */\nexport function output({ outDir, types }: { outDir: string; types: string }): RouteOutput {\n  return {\n    name: \"next\",\n    target: \"web\",\n    outDir,\n    types,\n    rules,\n    runtime: \"@mismo/next/runtime\",\n    emit(routes, context) {\n      const files: Files = new Map();\n\n      for (const { route, folder } of placesOf(routes)) {\n        const segments = [...folder, ...route.segments].map(toNext);\n        const dirs = route.layout || segments.at(-1) !== \"index\" ? segments : segments.slice(0, -1);\n        const kind = route.layout ? \"layout\" : \"page\";\n        const server = [...dirs, `${kind}.tsx`].join(\"/\");\n        const client = [...dirs, `mismo-${kind}.tsx`].join(\"/\");\n\n        const from = importPath(path.join(context.outDir, client), route.file);\n        files.set(client, route.layout ? clientLayout(from) : clientPage(from));\n        files.set(server, serverFile(route, kind, path.join(context.outDir, server)));\n      }\n\n      return files;\n    },\n  };\n}\n\n/** A segment as Next.js spells it: `:id` is `[id]`. */\nconst toNext = (segment: string) => (isParam(segment) ? `[${segment.slice(1)}]` : segment);\n\n/** Options Next.js reads as values at run time: passed on as the export of their name. */\nconst VALUE_EXPORTS = new Set([\"metadata\", \"generateMetadata\", \"viewport\", \"generateViewport\", \"generateStaticParams\"]);\n\n/**\n * Route segment config: Next.js reads these from the file's source without running it, so each\n * must be a literal, and is written into the generated file as one.\n */\nconst CONFIG_EXPORTS = new Set([\"dynamic\", \"dynamicParams\", \"revalidate\", \"fetchCache\", \"runtime\", \"preferredRegion\", \"maxDuration\"]);\nconst LITERAL = /^(?:-?\\d+(?:\\.\\d+)?|true|false|\"[^\"\\\\]*\"|'[^'\\\\]*'|\\[\\s*(?:(?:\"[^\"]*\"|'[^']*')\\s*,?\\s*)*\\])$/;\n\n/**\n * The server component: the route's Next.js options, and the client component it renders.\n *\n * Options come from two places. The route's module may set plain values (`metadata: { title }`,\n * `revalidate: 60`): it's a client module Next.js can't read from the server, so they're copied in\n * as text. Its server file may set anything, functions included (`generateMetadata`), and is\n * imported. An option set in both is an error, so each has one source.\n */\nfunction serverFile(route: SharedRoute, kind: \"page\" | \"layout\", at: string): string {\n  const imports: string[] = [];\n  const exports: string[] = [];\n  const server = serverModule(route.file);\n  const fromModule = exportedOptions(route.file, \"next\") ?? new Map<string, string>();\n  const fromServer = (server && exportedOptions(server, \"next\")) || new Map<string, string>();\n\n  const known = (key: string, where: string) => {\n    if (!VALUE_EXPORTS.has(key) && !CONFIG_EXPORTS.has(key)) {\n      throw new Error(`${where}: \\`next.${key}\\` isn't a Next.js route option. It takes ${[...VALUE_EXPORTS, ...CONFIG_EXPORTS].join(\", \")}.`);\n    }\n  };\n  const config = (key: string, value: string, where: string) => {\n    const literal = value.replace(/\\s+as\\s+const$/, \"\").trim();\n    if (!LITERAL.test(literal)) {\n      throw new Error(`${where}: \\`next.${key}\\` must be a literal, such as \\`${key}: 60\\`. Next.js reads it without running the file.`);\n    }\n    exports.push(`export const ${key} = ${literal};`);\n  };\n\n  for (const [key, value] of fromModule) {\n    known(key, route.id);\n    if (fromServer.has(key)) throw new Error(`${route.id}: \\`next.${key}\\` is set in both the route's module and its server file. Keep one.`);\n    if (CONFIG_EXPORTS.has(key)) config(key, value, route.id);\n    else if (isPlainValue(value)) exports.push(`export const ${key} = ${value.replace(/\\s+as\\s+const$/, \"\").trim()};`);\n    else {\n      throw new Error(\n        `${route.id}: \\`next.${key}\\` isn't a plain value, so the server can't take it from the route's module. Move it to the route's server file, ${route.id}.server.ts.`,\n      );\n    }\n  }\n\n  for (const [key, value] of fromServer) {\n    known(key, `${route.id}.server`);\n    if (CONFIG_EXPORTS.has(key)) config(key, value, `${route.id}.server`);\n    else exports.push(`export const ${key} = next.${key};`);\n  }\n  if (server && exports.some((line) => line.includes(\"= next.\"))) imports.push(`import { next } from \"${importPath(at, server)}\";`);\n\n  if (kind === \"layout\") {\n    imports.unshift('import type { ReactNode } from \"react\";');\n    imports.push('import Shell from \"./mismo-layout\";');\n  } else {\n    imports.push('import Screen from \"./mismo-page\";');\n  }\n\n  const component =\n    kind === \"layout\"\n      ? `export default function MismoLayout({ children }: { children: ReactNode }) {\n  return <Shell>{children}</Shell>;\n}`\n      : `export default function MismoPage() {\n  return <Screen />;\n}`;\n\n  return `${GENERATED}${[imports.join(\"\\n\"), ...(exports.length ? [exports.join(\"\\n\")] : []), component].join(\"\\n\\n\")}\\n`;\n}\n\nconst clientPage = (from: string) => `${GENERATED}\"use client\";\n\nimport { Suspense } from \"react\";\n\nimport Page from \"${from}\";\n\n// Next.js prerenders a page only with a boundary around \\`useSearchParams\\`.\nexport default function MismoScreen() {\n  return (\n    <Suspense>\n      <Page />\n    </Suspense>\n  );\n}\n`;\n\nconst clientLayout = (from: string) => `${GENERATED}\"use client\";\n\nimport { SlotChildren } from \"@mismo/next/runtime\";\nimport type { ReactNode } from \"react\";\n\nimport Layout from \"${from}\";\n\n// Next.js gives a layout its page as \\`children\\`: the shared layout renders it with \\`Slot\\`.\nexport default function MismoShell({ children }: { children: ReactNode }) {\n  return (\n    <SlotChildren value={children}>\n      <Layout />\n    </SlotChildren>\n  );\n}\n`;\n"],"mappings":"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"}

package/dist/runtime.d.ts

@@ -1,28 +1,29 @@
-import { type ReactNode } from "react";
-import { type BackLinkProps, type Href, type LinkProps, type Nav, type Routes, type SearchParams, type To } from "@mismo/core/contract";
-export { pathOf, type BackLinkProps, type Href, type LinkProps, type Nav, type Routes, type SearchParams, type To, } from "@mismo/core/contract";
+import { ReactNode } from "react";
+import { BackLinkProps, BackLinkProps as BackLinkProps$1, Href, Href as Href$1, LinkProps, LinkProps as LinkProps$1, Nav, Nav as Nav$1, Routes, Routes as Routes$1, SearchParams, SearchParams as SearchParams$1, To, To as To$1, pathOf } from "@mismo/core/contract";
 /** For the generated `layout.tsx`: the page below the shared layout it renders. */
 export declare function SlotChildren({ value, children }: {
-    value: ReactNode;
-    children: ReactNode;
+  value: ReactNode;
+  children: ReactNode;
 }): import("react").JSX.Element;
 /** Where a layout renders its child route. */
 export declare function Slot(): import("react").JSX.Element;
 /** A real link, so it can be opened in a new tab. Next.js loads its page ahead as it shows. */
-export declare function Link({ to, replace, label, children }: LinkProps): import("react").JSX.Element;
+export declare function Link({ to, replace, label, children }: LinkProps$1): import("react").JSX.Element;
 /**
  * Goes back when there is somewhere to go back to in this app, and to `fallback` otherwise. A real
  * link to `fallback`, so a modified click still opens it in a new tab.
  */
-export declare function BackLink({ fallback, label, children }: BackLinkProps): import("react").JSX.Element;
+export declare function BackLink({ fallback, label, children }: BackLinkProps$1): import("react").JSX.Element;
 /** Navigates as soon as it renders, replacing the current entry. */
 export declare function Redirect({ to }: {
-    to: To;
+  to: To$1;
 }): null;
-export declare function useNav(): Nav;
+export declare function useNav(): Nav$1;
 /** The current path, such as `/orgs/acme`. */
 export declare function usePathname(): string;
 /** The current route's params. `href` is the route the screen is for, which types them. */
-export declare function useParams<H extends Href>(_href: H): Routes[H];
+export declare function useParams<H extends Href$1>(_href: H): Routes$1[H];
 /** The query of the current URL. A key given twice is its first value, as on native. */
-export declare function useSearchParams(): SearchParams;
+export declare function useSearchParams(): SearchParams$1;
+export { type BackLinkProps, type Href, type LinkProps, type Nav, type Routes, type SearchParams, type To, pathOf };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":["LinkProps","BackLinkProps","To","Nav","Href","Routes","SearchParams"],"sources":["../src/runtime.tsx"],"mappings":";;;wBA+BgB,eAAe,OAAO;EAAc,OAAO;EAAW,UAAU;oBAAW,IAAA;;wBAK3E,wBAAI,IAAA;;wBAKJ,OAAO,IAAI,SAAiB,OAAO,YAAYA,8BAAS,IAAA;;;;;wBAsBxD,WAAW,UAAU,OAAO,YAAYC,kCAAa,IAAA;;wBAiBrD,WAAW;EAAQ,IAAIC;;wBAQvB,UAAUC;;wBAgBV;;wBAKA,UAAU,UAAUC,QAAM,OAAO,IAAIC,SAAO;;wBAK5C,mBAAmBC"}

package/dist/runtime.js

@@ -1,79 +1,93 @@
 "use client";
-import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import NextLink from "next/link";
-import { usePathname as useNextPathname, useParams as useNextParams, useRouter, useSearchParams as useNextSearchParams, } from "next/navigation";
+import { useParams as useParams$1, usePathname as usePathname$1, useRouter, useSearchParams as useSearchParams$1 } from "next/navigation";
 import { createContext, useContext, useEffect, useMemo } from "react";
-import { pathOf } from "@mismo/core/contract";
-export { pathOf, } from "@mismo/core/contract";
+import { pathOf, pathOf as pathOf$1 } from "@mismo/core/contract";
+import { Fragment, jsx } from "react/jsx-runtime";
+// src/runtime.tsx
 /**
- * The page a Next.js layout was given. Next.js passes it as `children`, where other routers render
- * an outlet: the generated `layout.tsx` provides it, and `Slot` renders it, so a shared layout is
- * the same on every router.
- */
+* The page a Next.js layout was given. Next.js passes it as `children`, where other routers render
+* an outlet: the generated `layout.tsx` provides it, and `Slot` renders it, so a shared layout is
+* the same on every router.
+*/
 const Children = createContext(null);
 /** For the generated `layout.tsx`: the page below the shared layout it renders. */
-export function SlotChildren({ value, children }) {
-    return _jsx(Children.Provider, { value: value, children: children });
+function SlotChildren({ value, children }) {
+	return /* @__PURE__ */ jsx(Children.Provider, {
+		value,
+		children
+	});
 }
 /** Where a layout renders its child route. */
-export function Slot() {
-    return _jsx(_Fragment, { children: useContext(Children) });
+function Slot() {
+	return /* @__PURE__ */ jsx(Fragment, { children: useContext(Children) });
 }
 /** A real link, so it can be opened in a new tab. Next.js loads its page ahead as it shows. */
-export function Link({ to, replace = false, label, children }) {
-    return (_jsx(NextLink, { href: pathOf(to), replace: replace, "aria-label": label, children: children }));
+function Link({ to, replace = false, label, children }) {
+	return /* @__PURE__ */ jsx(NextLink, {
+		href: pathOf$1(to),
+		replace,
+		"aria-label": label,
+		children
+	});
 }
 /**
- * Whether there is an earlier entry in this site's history to go back to. The Navigation API says
- * so exactly; without it, any earlier entry counts.
- */
+* Whether there is an earlier entry in this site's history to go back to. The Navigation API says
+* so exactly; without it, any earlier entry counts.
+*/
 function canGoBack() {
-    const browser = globalThis;
-    if (!browser.history)
-        return false;
-    return browser.navigation?.canGoBack ?? browser.history.length > 1;
+	const browser = globalThis;
+	if (!browser.history) return false;
+	return browser.navigation?.canGoBack ?? browser.history.length > 1;
 }
 /**
- * Goes back when there is somewhere to go back to in this app, and to `fallback` otherwise. A real
- * link to `fallback`, so a modified click still opens it in a new tab.
- */
-export function BackLink({ fallback, label, children }) {
-    const router = useRouter();
-    const onClick = (event) => {
-        if (event.button !== 0 || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey || !canGoBack())
-            return;
-        event.preventDefault();
-        router.back();
-    };
-    return (_jsx(NextLink, { href: pathOf(fallback), "aria-label": label, onClick: onClick, children: children }));
+* Goes back when there is somewhere to go back to in this app, and to `fallback` otherwise. A real
+* link to `fallback`, so a modified click still opens it in a new tab.
+*/
+function BackLink({ fallback, label, children }) {
+	const router = useRouter();
+	const onClick = (event) => {
+		if (event.button !== 0 || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey || !canGoBack()) return;
+		event.preventDefault();
+		router.back();
+	};
+	return /* @__PURE__ */ jsx(NextLink, {
+		href: pathOf$1(fallback),
+		"aria-label": label,
+		onClick,
+		children
+	});
 }
 /** Navigates as soon as it renders, replacing the current entry. */
-export function Redirect({ to }) {
-    const router = useRouter();
-    const path = pathOf(to);
-    useEffect(() => router.replace(path), [router, path]);
-    return null;
+function Redirect({ to }) {
+	const router = useRouter();
+	const path = pathOf$1(to);
+	useEffect(() => router.replace(path), [router, path]);
+	return null;
 }
-export function useNav() {
-    const router = useRouter();
-    return useMemo(() => ({
-        go: (to) => router.push(pathOf(to)),
-        replace: (to) => router.replace(pathOf(to)),
-        back: () => router.back(),
-        canGoBack,
-        preload: async (to) => router.prefetch(pathOf(to)),
-    }), [router]);
+function useNav() {
+	const router = useRouter();
+	return useMemo(() => ({
+		go: (to) => router.push(pathOf$1(to)),
+		replace: (to) => router.replace(pathOf$1(to)),
+		back: () => router.back(),
+		canGoBack,
+		preload: async (to) => router.prefetch(pathOf$1(to))
+	}), [router]);
 }
 /** The current path, such as `/orgs/acme`. */
-export function usePathname() {
-    return useNextPathname();
+function usePathname() {
+	return usePathname$1();
 }
 /** The current route's params. `href` is the route the screen is for, which types them. */
-export function useParams(_href) {
-    return useNextParams();
+function useParams(_href) {
+	return useParams$1();
 }
 /** The query of the current URL. A key given twice is its first value, as on native. */
-export function useSearchParams() {
-    const search = useNextSearchParams();
-    return useMemo(() => Object.fromEntries([...search.keys()].map((key) => [key, search.get(key) ?? undefined])), [search]);
+function useSearchParams() {
+	const search = useSearchParams$1();
+	return useMemo(() => Object.fromEntries([...search.keys()].map((key) => [key, search.get(key) ?? void 0])), [search]);
 }
+export { BackLink, Link, Redirect, Slot, SlotChildren, pathOf, useNav, useParams, usePathname, useSearchParams };
+
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":["pathOf","useNextPathname","useNextParams","useNextSearchParams"],"sources":["../src/runtime.tsx"],"sourcesContent":["\"use client\";\n\nimport NextLink from \"next/link\";\nimport {\n  usePathname as useNextPathname,\n  useParams as useNextParams,\n  useRouter,\n  useSearchParams as useNextSearchParams,\n} from \"next/navigation\";\nimport { createContext, type MouseEvent, type ReactNode, useContext, useEffect, useMemo } from \"react\";\nimport { type BackLinkProps, type Href, type LinkProps, type Nav, pathOf, type Routes, type SearchParams, type To } from \"@mismo/core/contract\";\n\nexport {\n  pathOf,\n  type BackLinkProps,\n  type Href,\n  type LinkProps,\n  type Nav,\n  type Routes,\n  type SearchParams,\n  type To,\n} from \"@mismo/core/contract\";\n\n/**\n * The page a Next.js layout was given. Next.js passes it as `children`, where other routers render\n * an outlet: the generated `layout.tsx` provides it, and `Slot` renders it, so a shared layout is\n * the same on every router.\n */\nconst Children = createContext<ReactNode>(null);\n\n/** For the generated `layout.tsx`: the page below the shared layout it renders. */\nexport function SlotChildren({ value, children }: { value: ReactNode; children: ReactNode }) {\n  return <Children.Provider value={value}>{children}</Children.Provider>;\n}\n\n/** Where a layout renders its child route. */\nexport function Slot() {\n  return <>{useContext(Children)}</>;\n}\n\n/** A real link, so it can be opened in a new tab. Next.js loads its page ahead as it shows. */\nexport function Link({ to, replace = false, label, children }: LinkProps) {\n  return (\n    <NextLink href={pathOf(to)} replace={replace} aria-label={label}>\n      {children}\n    </NextLink>\n  );\n}\n\n/**\n * Whether there is an earlier entry in this site's history to go back to. The Navigation API says\n * so exactly; without it, any earlier entry counts.\n */\nfunction canGoBack(): boolean {\n  const browser = globalThis as { navigation?: { canGoBack?: boolean }; history?: { length: number } };\n  if (!browser.history) return false;\n  return browser.navigation?.canGoBack ?? browser.history.length > 1;\n}\n\n/**\n * Goes back when there is somewhere to go back to in this app, and to `fallback` otherwise. A real\n * link to `fallback`, so a modified click still opens it in a new tab.\n */\nexport function BackLink({ fallback, label, children }: BackLinkProps) {\n  const router = useRouter();\n\n  const onClick = (event: MouseEvent) => {\n    if (event.button !== 0 || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey || !canGoBack()) return;\n    event.preventDefault();\n    router.back();\n  };\n\n  return (\n    <NextLink href={pathOf(fallback)} aria-label={label} onClick={onClick}>\n      {children}\n    </NextLink>\n  );\n}\n\n/** Navigates as soon as it renders, replacing the current entry. */\nexport function Redirect({ to }: { to: To }) {\n  const router = useRouter();\n  const path = pathOf(to);\n\n  useEffect(() => router.replace(path), [router, path]);\n  return null;\n}\n\nexport function useNav(): Nav {\n  const router = useRouter();\n\n  return useMemo(\n    () => ({\n      go: (to) => router.push(pathOf(to)),\n      replace: (to) => router.replace(pathOf(to)),\n      back: () => router.back(),\n      canGoBack,\n      preload: async (to) => router.prefetch(pathOf(to)),\n    }),\n    [router],\n  );\n}\n\n/** The current path, such as `/orgs/acme`. */\nexport function usePathname(): string {\n  return useNextPathname();\n}\n\n/** The current route's params. `href` is the route the screen is for, which types them. */\nexport function useParams<H extends Href>(_href: H): Routes[H] {\n  return useNextParams() as unknown as Routes[H];\n}\n\n/** The query of the current URL. A key given twice is its first value, as on native. */\nexport function useSearchParams(): SearchParams {\n  const search = useNextSearchParams();\n  return useMemo(() => Object.fromEntries([...search.keys()].map((key) => [key, search.get(key) ?? undefined])), [search]);\n}\n"],"mappings":";;;;;;;;;;;;AA4BA,MAAM,WAAW,cAAyB,IAAI;;AAG9C,SAAgB,aAAa,EAAE,OAAO,YAAuD;CAC3F,OAAO,oBAAC,SAAS,UAAV;EAA0B;EAAQ;CAA4B,CAAA;AACvE;;AAGA,SAAgB,OAAO;CACrB,OAAO,oBAAA,UAAA,EAAA,UAAG,WAAW,QAAQ,EAAI,CAAA;AACnC;;AAGA,SAAgB,KAAK,EAAE,IAAI,UAAU,OAAO,OAAO,YAAuB;CACxE,OACE,oBAAC,UAAD;EAAU,MAAMA,SAAO,EAAE;EAAY;EAAS,cAAY;EACvD;CACO,CAAA;AAEd;;;;;AAMA,SAAS,YAAqB;CAC5B,MAAM,UAAU;CAChB,IAAI,CAAC,QAAQ,SAAS,OAAO;CAC7B,OAAO,QAAQ,YAAY,aAAa,QAAQ,QAAQ,SAAS;AACnE;;;;;AAMA,SAAgB,SAAS,EAAE,UAAU,OAAO,YAA2B;CACrE,MAAM,SAAS,UAAU;CAEzB,MAAM,WAAW,UAAsB;EACrC,IAAI,MAAM,WAAW,KAAK,MAAM,WAAW,MAAM,UAAU,MAAM,WAAW,MAAM,YAAY,CAAC,UAAU,GAAG;EAC5G,MAAM,eAAe;EACrB,OAAO,KAAK;CACd;CAEA,OACE,oBAAC,UAAD;EAAU,MAAMA,SAAO,QAAQ;EAAG,cAAY;EAAgB;EAC3D;CACO,CAAA;AAEd;;AAGA,SAAgB,SAAS,EAAE,MAAkB;CAC3C,MAAM,SAAS,UAAU;CACzB,MAAM,OAAOA,SAAO,EAAE;CAEtB,gBAAgB,OAAO,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC;CACpD,OAAO;AACT;AAEA,SAAgB,SAAc;CAC5B,MAAM,SAAS,UAAU;CAEzB,OAAO,eACE;EACL,KAAK,OAAO,OAAO,KAAKA,SAAO,EAAE,CAAC;EAClC,UAAU,OAAO,OAAO,QAAQA,SAAO,EAAE,CAAC;EAC1C,YAAY,OAAO,KAAK;EACxB;EACA,SAAS,OAAO,OAAO,OAAO,SAASA,SAAO,EAAE,CAAC;CACnD,IACA,CAAC,MAAM,CACT;AACF;;AAGA,SAAgB,cAAsB;CACpC,OAAOC,cAAgB;AACzB;;AAGA,SAAgB,UAA0B,OAAqB;CAC7D,OAAOC,YAAc;AACvB;;AAGA,SAAgB,kBAAgC;CAC9C,MAAM,SAASC,kBAAoB;CACnC,OAAO,cAAc,OAAO,YAAY,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,KAAK,OAAO,IAAI,GAAG,KAAK,KAAA,CAAS,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;AACzH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mismo/next",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.1",
   "description": "mismo for Next.js (App Router): run shared screens and routes in a Next.js app.",
   "keywords": [
     "mismo",
@@ -10,6 +10,14 @@
     "routes"
   ],
   "homepage": "https://mismo.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KrakenWagen/mismo.git",
+    "directory": "packages/next"
+  },
+  "bugs": {
+    "url": "https://github.com/KrakenWagen/mismo/issues"
+  },
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -35,7 +43,7 @@
     "node": ">=22.18"
   },
   "dependencies": {
-    "@mismo/core": "^0.1.0-beta.0"
+    "@mismo/core": "^0.1.0-beta.1"
   },
   "peerDependencies": {
     "next": ">=16 <17",
@@ -52,6 +60,6 @@
   },
   "scripts": {
     "typecheck": "tsc -p tsconfig.json",
-    "build": "rm -rf dist && tsc -p tsconfig.build.json && node ../scripts/fix-declarations.mjs dist"
+    "build": "tsdown"
   }
 }