@reckona/mreact-router 0.0.1

package/dist/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { buildApp } from "./build.js";
+import { startDevServer } from "./dev-server.js";
+import { startServer } from "./serve.js";
+import { loadMreactRouterViteConfig } from "./vite-config.js";
+const command = process.argv[2] ?? "dev";
+const routeArg = process.argv[3];
+if (command === "build") {
+    const project = routeArg === undefined
+        ? await loadMreactRouterViteConfig({ command: "build", cwd: process.cwd() })
+        : { appDir: resolve(routeArg) };
+    const result = await buildApp({ ...project, outDir: resolve(".mreact") });
+    console.log(`Built ${result.routes.length} routes.`);
+}
+else if (command === "dev") {
+    const project = routeArg === undefined
+        ? await loadMreactRouterViteConfig({ command: "serve", cwd: process.cwd() })
+        : { appDir: resolve(routeArg) };
+    const server = await startDevServer({
+        ...project,
+        port: Number(process.env.PORT ?? 3001),
+    });
+    console.log(`mreact app router ready at ${server.url}`);
+}
+else if (command === "start") {
+    const server = await startServer({
+        outDir: resolve(process.argv[3] ?? ".mreact"),
+        port: Number(process.env.PORT ?? 3001),
+    });
+    console.log(`mreact app router serving built output at ${server.url}`);
+}
+else {
+    console.error(`Unknown command: ${command}`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;AACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEjC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS;QACpC,CAAC,CAAC,MAAM,0BAA0B,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5E,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC,CAAC;AACvD,CAAC;KAAM,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS;QACpC,CAAC,CAAC,MAAM,0BAA0B,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5E,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QAClC,GAAG,OAAO;QACV,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;KACvC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;AAC1D,CAAC;KAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAC7C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;KACvC,CAAC,CAAC;IACH,OAAO,CAAC,GAAG,CAAC,6CAA6C,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;AACzE,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,105 @@
+import { type ClientReferenceMetadata } from "@reckona/mreact-compiler";
+import type { AppRoute } from "./routes.js";
+export interface ClientRouteManifestEntry {
+    bytes?: number;
+    path: string;
+    kind: AppRoute["kind"];
+    client: boolean;
+    devScript?: string;
+    routeId?: string;
+    script?: string;
+    sourceMap?: string;
+}
+export interface ClientRouteInferenceCache {
+    importsByFile: Map<string, Promise<string[]>>;
+    resolvedByImport: Map<string, Promise<string | undefined>>;
+    sourceByFile: Map<string, Promise<string>>;
+}
+export interface ClientRouteInferenceResult {
+    client: boolean;
+    clientBoundaryImports: string[];
+}
+export declare function routeToClientManifestEntry(route: AppRoute): Promise<ClientRouteManifestEntry>;
+export declare function createClientRouteInferenceCache(): ClientRouteInferenceCache;
+export declare function isClientRouteModule(options: {
+    cache?: ClientRouteInferenceCache | undefined;
+    code: string;
+    filename: string;
+    routePath?: string | undefined;
+}): Promise<boolean>;
+export declare function inferClientRouteModule(options: {
+    cache?: ClientRouteInferenceCache | undefined;
+    code: string;
+    filename: string;
+    routePath?: string | undefined;
+}): Promise<ClientRouteInferenceResult>;
+export declare function isClientRouteSource(code: string): boolean;
+export declare function routeIdForPath(path: string): string;
+export declare function clientScriptForPath(path: string): string;
+export declare function withHydrationMarkers(options: {
+    assetBaseUrl?: string | undefined;
+    clientReferenceManifest?: readonly ClientReferenceMetadata[] | undefined;
+    html: string;
+    props: unknown;
+    routePath: string;
+    script?: string | undefined;
+}): string;
+export declare function withRouteMarkers(options: {
+    html: string;
+    routePath: string;
+}): string;
+export declare function hydrationMarkerParts(options: {
+    assetBaseUrl?: string | undefined;
+    clientReferenceManifest?: readonly ClientReferenceMetadata[] | undefined;
+    props: unknown;
+    routePath: string;
+    script?: string | undefined;
+}): {
+    prefix: string;
+    suffix: string;
+};
+export declare function buildClientRouteBundle(options: {
+    code: string;
+    clientReferenceManifest?: readonly ClientReferenceMetadata[] | undefined;
+    filename: string;
+    routePath: string;
+}): Promise<string>;
+export declare function buildClientRouteOutput(options: {
+    code: string;
+    clientReferenceManifest?: readonly ClientReferenceMetadata[] | undefined;
+    filename: string;
+    minify?: boolean;
+    routePath: string;
+    sourceMap?: boolean;
+    /**
+     * When `false`, omit the SPA navigation runtime (`__mreactPrefetch`,
+     * `__mreactNavigate`, prefetch hover handlers, history integration, etc.)
+     * from the emitted client bundle. The page can still hydrate and react to
+     * `cell` / event bindings — only cross-route SPA navigation is disabled.
+     * Useful for static / single-page interactive routes where the navigation
+     * runtime is dead code.
+     *
+     * Default: `true` (preserve current behavior).
+     *
+     * If unset, the source code is also inspected for a top-level
+     * `export const clientNavigation = false` hint and that takes precedence.
+     * See `docs/issues/open/2026-05-12-058-client-navigation-runtime-opt-in.md`.
+     */
+    clientNavigation?: boolean;
+}): Promise<{
+    code: string;
+    map?: string;
+}>;
+/**
+ * Detects the `export const clientNavigation = false` hint in a page module
+ * source. Returns the hinted value, or `true` when no hint is present (i.e.,
+ * preserve the historical "navigation runtime is always present" behavior).
+ *
+ * Regex-based to avoid pulling the JS parser into the build path. The pattern
+ * accepts the common formatting variants:
+ *   export const clientNavigation = false
+ *   export const   clientNavigation   =  false ;
+ *   export const clientNavigation: boolean = false
+ */
+export declare function detectClientNavigationHint(source: string): boolean;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}