@akanjs/devkit 2.3.10-rc.0 → 2.3.10-rc.1

package/executors.ts

@@ -437,8 +437,11 @@ export class Executor {
   getPath(filePath: string) {
     if (path.isAbsolute(filePath)) return filePath;
     if (filePath.startsWith(".")) return path.join(this.cwdPath, filePath);
-    const baseParts = this.cwdPath.split("/").filter(Boolean);
-    const targetParts = filePath.split("/").filter(Boolean);
+    // Split on both separators so a Windows/mixed cwdPath (e.g. "C:\repo/apps/name") is parsed
+    // correctly, then rebuild with path.join so the result stays OS-native instead of the
+    // invalid "/C:\repo/..." the previous forward-slash-only reconstruction produced.
+    const baseParts = this.cwdPath.split(/[\\/]/).filter(Boolean);
+    const targetParts = filePath.split(/[\\/]/).filter(Boolean);
 
     let overlapLength = 0;
     for (let i = 1; i <= Math.min(baseParts.length, targetParts.length); i++) {
@@ -450,11 +453,7 @@ export class Executor {
         }
       if (isOverlap) overlapLength = i;
     }
-    const result =
-      overlapLength > 0
-        ? `/${[...baseParts, ...targetParts.slice(overlapLength)].join("/")}`
-        : `${this.cwdPath}/${filePath}`;
-    return result.replace(/\/+/g, "/");
+    return path.join(this.cwdPath, ...targetParts.slice(overlapLength));
   }
   async mkdir(dirPath: string) {
     const writePath = this.getPath(dirPath);

package/frontendBuild/frontendBuild.test.ts

@@ -2,7 +2,7 @@ import { afterEach, describe, expect, test } from "bun:test";
 import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import type { RoutesManifest } from "akanjs/server";
 import { CsrArtifactBuilder } from "./csrArtifactBuilder";
 import { CssCompiler, isIgnoredNodeModuleSource } from "./cssCompiler";
@@ -33,17 +33,19 @@ afterEach(async () => {
 });
 
 describe("PagesEntrySourceGenerator", () => {
-  test("generates dynamic import source using absolute module paths", () => {
+  test("generates dynamic import source using file:// module URLs", () => {
+    const indexAbs = path.resolve("/repo/apps/demo/page/_index.tsx");
+    const adminAbs = path.resolve("/repo/apps/demo/page/admin.tsx");
     const source = PagesEntrySourceGenerator.generate([
-      { key: "./_index.tsx", moduleAbsPath: "/repo/apps/demo/page/_index.tsx" },
-      { key: "./admin.tsx", moduleAbsPath: "/repo/apps/demo/page/admin.tsx" },
+      { key: "./_index.tsx", moduleAbsPath: indexAbs },
+      { key: "./admin.tsx", moduleAbsPath: adminAbs },
     ]);
 
     expect(source).toBe(
       [
         "export const pages = {",
-        '  "./_index.tsx": () => import("/repo/apps/demo/page/_index.tsx"),',
-        '  "./admin.tsx": () => import("/repo/apps/demo/page/admin.tsx"),',
+        `  "./_index.tsx": () => import(${JSON.stringify(pathToFileURL(indexAbs).href)}),`,
+        `  "./admin.tsx": () => import(${JSON.stringify(pathToFileURL(adminAbs).href)}),`,
         "};",
         "",
       ].join("\n"),
@@ -51,15 +53,17 @@ describe("PagesEntrySourceGenerator", () => {
   });
 
   test("generates static import source for single-file CSR bundles", () => {
+    const indexAbs = path.resolve("/repo/apps/demo/page/_index.tsx");
+    const adminAbs = path.resolve("/repo/apps/demo/page/admin.tsx");
     const source = PagesEntrySourceGenerator.generateStatic([
-      { key: "./_index.tsx", moduleAbsPath: "/repo/apps/demo/page/_index.tsx" },
-      { key: "./admin.tsx", moduleAbsPath: "/repo/apps/demo/page/admin.tsx" },
+      { key: "./_index.tsx", moduleAbsPath: indexAbs },
+      { key: "./admin.tsx", moduleAbsPath: adminAbs },
     ]);
 
     expect(source).toBe(
       [
-        'import * as page0 from "/repo/apps/demo/page/_index.tsx";',
-        'import * as page1 from "/repo/apps/demo/page/admin.tsx";',
+        `import * as page0 from ${JSON.stringify(pathToFileURL(indexAbs).href)};`,
+        `import * as page1 from ${JSON.stringify(pathToFileURL(adminAbs).href)};`,
         "export const pages = {",
         '  "./_index.tsx": { loader: async () => page0, isAsyncDefault: false },',
         '  "./admin.tsx": { loader: async () => page1, isAsyncDefault: false },',

package/frontendBuild/pagesEntrySourceGenerator.ts

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import ts from "typescript";
 import type { PageEntry } from "../artifact/implicitRootLayout";
 
@@ -16,8 +17,8 @@ export class PagesEntrySourceGenerator {
 
   generate(): string {
     const lines = this.#pageEntries.map(({ key, moduleAbsPath }) => {
-      const absPath = path.resolve(moduleAbsPath);
-      return `  ${JSON.stringify(key)}: () => import(${JSON.stringify(absPath)}),`;
+      const specifier = pathToFileURL(path.resolve(moduleAbsPath)).href;
+      return `  ${JSON.stringify(key)}: () => import(${JSON.stringify(specifier)}),`;
     });
     return `export const pages = {\n${lines.join("\n")}\n};\n`;
   }
@@ -28,8 +29,10 @@ export class PagesEntrySourceGenerator {
 
   generateStatic(): string {
     const imports = this.#pageEntries.map(({ moduleAbsPath }, index) => {
-      const absPath = path.resolve(moduleAbsPath);
-      return `import * as page${index} from ${JSON.stringify(absPath)};`;
+      // Emit a file:// URL so the specifier is separator-agnostic; a raw Windows path
+      // (backslashes, or mixed with forward slashes) is a fragile ESM import specifier.
+      const specifier = pathToFileURL(path.resolve(moduleAbsPath)).href;
+      return `import * as page${index} from ${JSON.stringify(specifier)};`;
     });
     const entries = this.#pageEntries.map(({ key, moduleAbsPath }, index) => {
       const isAsyncDefault = PagesEntrySourceGenerator.#hasAsyncDefaultExport(moduleAbsPath);

package/frontendBuild/ssrBaseArtifactBuilder.ts

@@ -99,11 +99,15 @@ export class SsrBaseArtifactBuilder {
     }
   > {
     const akanServerPath = await this.#resolveAkanServerPath();
-    const rscClientEntry = `${akanServerPath}/rscClient.tsx`;
-    const rscSegmentOutletEntry = `${akanServerPath}/rscSegmentOutlet.tsx`;
+    // Normalize entry paths with path.resolve so they match the resolved map keys the bundler
+    // stores (see ClientEntriesBundler#createOpaqueEntryAliases). Raw string concatenation keeps
+    // forward slashes, which on Windows fail to match the `\`-separated resolved keys and silently
+    // yield empty import-map URLs, breaking hydration.
+    const rscClientEntry = path.resolve(akanServerPath, "rscClient.tsx");
+    const rscSegmentOutletEntry = path.resolve(akanServerPath, "rscSegmentOutlet.tsx");
     const vendorEntries = VENDOR_SPECIFIERS.map((specifier) => ({
       specifier,
-      absPath: `${akanServerPath}/vendor/${specifier.replaceAll("/", "-").replaceAll(".", "-")}.ts`,
+      absPath: path.resolve(akanServerPath, "vendor", `${specifier.replaceAll("/", "-").replaceAll(".", "-")}.ts`),
     }));
     const entries = [rscClientEntry, rscSegmentOutletEntry, ...vendorEntries.map((v) => v.absPath)];
     const clientBundle = await new ClientEntriesBundler({ app: this.#app, entries, command: this.#command }).bundle();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "2.3.10-rc.0",
+  "version": "2.3.10-rc.1",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -32,7 +32,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.3.10-rc.0",
+    "akanjs": "2.3.10-rc.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",