@akanjs/devkit 3.0.0-beta.24 → 3.0.0-beta.25

package/integration/devStability.integration.test.ts

@@ -24,7 +24,7 @@ const isRefreshMessage = (msg: unknown): boolean =>
   typeof msg === "object" &&
   msg !== null &&
   "type" in msg &&
-  (msg.type === "client-refresh" || msg.type === "rsc-refresh" || msg.type === "reload");
+  (msg.type === "ssr-update" || msg.type === "rsc-refresh" || msg.type === "reload");
 
 const isBuildStatus =
   (status: "error" | "ok") =>
@@ -148,7 +148,7 @@ describe("dev stability integration harness", () => {
     await host.waitForLogSince(mark, /\[backend-reload\]|Shutting down gracefully|stopping backend/);
     await host.waitForLogSince(mark, /backend ready pid=(\d+)|AkanApp gateway is running on port/);
     expect(host.proc.killed).toBe(false);
-    expect(host.logs.join("").slice(mark)).not.toMatch(/\[hmr\].*(client-refresh|rsc-refresh)/);
+    expect(host.logs.join("").slice(mark)).not.toMatch(/\[hmr\].*rsc-refresh|\[ssr\] registry generation/);
     await hmr?.waitForNoMessageSince(hmrMark, isRefreshMessage);
     hmr?.close();
   });
@@ -179,7 +179,10 @@ describe("dev stability integration harness", () => {
     if (hmr) {
       await expectHmrMessage(hmr, hmrMark, isRefreshMessage, "a client refresh");
     } else {
-      await host.waitForLogSince(mark, /\[hmr\].*(client-refresh|rsc-refresh|reload)|\[SSR\] pages-updated/);
+      await host.waitForLogSince(
+        mark,
+        /\[hmr\].*(rsc-refresh|reload)|\[ssr\] registry generation|\[SSR\] pages-updated/,
+      );
     }
     expect(host.logs.join("").slice(mark)).not.toMatch(/\[backend-reload\]/);
     hmr?.close();
@@ -487,7 +490,8 @@ describe("dev resource budgets", () => {
         `csr-armed-marker-${attempt}`,
       ),
     );
-    await host.waitForLogSince(resyncMark, /csr-rebundle ok|csr-dev generation=\d+ patch/, WAIT_MS);
+    // A worker logs `csr-dev generation=N patch`; the resident builder's patcher logs `csr-patch generation=N patch`.
+    await host.waitForLogSince(resyncMark, /csr-rebundle ok|csr-(?:dev|patch) generation=\d+ patch/, WAIT_MS);
   });
 
   budgetTest("bounds the rsc worker and the tree across repeated saves", async () => {
@@ -498,6 +502,9 @@ describe("dev resource budgets", () => {
       env: { AKAN_RSC_WORKER_MAX_RELOADS: "1", AKAN_RSC_WORKER_MIN_RECYCLE_INTERVAL_MS: "1" },
     });
     await harness.waitForHttpText("initial-client-marker", WAIT_MS);
+    // The first page no longer waits for the SSR registry's boot build; the host logs when its worker is done, whether or
+    // not a backend was up to take the build's announcement.
+    await host.waitForLogSince(0, /\[builder\] boot builds settled/, WAIT_MS);
 
     const idleTotal = await DevStabilityHarness.processTreeRssBytes(host.proc.pid);
     const idleWithoutBuilder = await DevStabilityHarness.processTreeRssBytes(host.proc.pid, { excludeBuilder: true });
@@ -543,7 +550,7 @@ describe("dev resource budgets", () => {
 
   budgetTest("recycles the builder at an unmeetable ceiling and keeps developing through it", async () => {
     const harness = await createHarness();
-    // Deliberately below the post-boot builder: it no longer grows into a ceiling, so it must start over one.
+    // Below the builder once it has served the first route build (about 380MiB), which arms the recycle.
     const host = await harness.startHost({ timeoutMs: BOOT_MS, env: { AKAN_BUILDER_MAX_RSS_MB: "200" } });
     const start = host.markLog();
     await harness.waitForHttpText("initial-client-marker", WAIT_MS);
@@ -579,14 +586,18 @@ describe("dev resource budgets", () => {
     );
     await harness.waitForHttpText("marker-after-recycle", WAIT_MS);
 
-    // A tight ceiling is reported, and still enforced (recycles are throttled), never disabled for the session.
+    // A ceiling the replacement is back over within the interval is reported, and still enforced (recycles are
+    // throttled), never disabled for the session. Whether it is back over depends on the machine's allocator, so the
+    // warning is asserted only when it is; the decision itself is unit-tested (devHostPolicy).
     for (let i = 1; i <= 3; i++) {
       const { mark } = await harness.editUntilSeen(host, (attempt) =>
         harness.replaceText("ui/ClientMarker.tsx", /marker(-[\w-]+)?/, `marker-settled-${i}-${attempt}`),
       );
       await host.waitForLogSince(mark, /pages-rebundle ok/, WAIT_MS).catch(() => undefined);
     }
-    await host.waitForLogSince(start, /ceiling costs about one boot build per interval/, WAIT_MS);
+    const settled = await DevStabilityHarness.builderProcess(host.proc.pid);
+    if ((settled?.rssBytes ?? 0) >= 200 * MB)
+      await host.waitForLogSince(start, /ceiling costs about one boot build per interval/, WAIT_MS);
     expect(host.logs.join("").slice(start)).not.toMatch(/no longer enforcing it this session/);
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "3.0.0-beta.24",
+  "version": "3.0.0-beta.25",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -47,7 +47,7 @@
     "@earendil-works/pi-tui": "0.86.1",
     "@inquirer/prompts": "^8.4.3",
     "@tailwindcss/node": "^4.3.0",
-    "akanjs": "3.0.0-beta.24",
+    "akanjs": "3.0.0-beta.25",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/transforms/rscUseClientTransform.ts

@@ -10,8 +10,12 @@ const STAR_REEXPORT_HINT_RE = /\bexport\s*\*\s*from\b/;
 export interface UseClientTransformArgs {
   path: string;
   workspaceRoot?: string;
+  /** Told each `"use client"` module's export names, the only part of it the server graph holds. */
+  onClientModule?: (path: string, exports: string[]) => void;
 }
 
+export const hasUseClientDirective = (source: string): boolean => USE_CLIENT_RE.test(source);
+
 export function toClientReferencePath(absPath: string, workspaceRoot: string): string {
   return path.relative(path.resolve(workspaceRoot), path.resolve(absPath)).split(path.sep).join("/");
 }
@@ -51,7 +55,10 @@ export function transformUseClient(source: string, args: UseClientTransformArgs)
   if (!USE_CLIENT_RE.test(source)) return null;
   if (IMPLICIT_ROOT_LAYOUT_RE.test(args.path)) return null;
   const exports = scanUseClientExports(source, args.path, args.workspaceRoot);
+  //? Not reported without exports: the module then stays in the server bundle as it is, so a save of it changes what
+  //? the server runs, which a client module's edit that kept its export names does not.
   if (exports.length === 0) return null;
+  args.onClientModule?.(args.path, exports);
 
   const referencePath = args.workspaceRoot ? toClientReferencePath(args.path, args.workspaceRoot) : args.path;
   const filePathLit = JSON.stringify(referencePath);

package/transforms/transforms.test.ts

@@ -27,6 +27,19 @@ describe("transformUseClient", () => {
     ).toBeNull();
   });
 
+  test("a client module with no exports stays server code and is not reported as a client module", () => {
+    const reported: string[] = [];
+    const onClientModule = (file: string) => reported.push(file);
+    expect(
+      transformUseClient('"use client";\nimport "./side-effect";\n', { path: "/repo/ui/Fx.tsx", onClientModule }),
+    ).toBeNull();
+    expect(reported).toEqual([]);
+    expect(
+      transformUseClient('"use client"; export const value = 1;', { path: "/repo/ui/V.tsx", onClientModule }),
+    ).not.toBeNull();
+    expect(reported).toEqual(["/repo/ui/V.tsx"]);
+  });
+
   test("stubs named and default exports as RSC client references", () => {
     const source = [
       "// comment before directive",

package/transforms/useClientBundlePlugin.ts

@@ -3,7 +3,9 @@ import { loaderFor } from "./moduleSyntax";
 import { transformUseClient } from "./rscUseClientTransform";
 
 /** `workspaceRoot` makes reference keys workspace-relative; they must match the client manifest's keys. */
-export function createUseClientBundlePlugin(options: { workspaceRoot?: string } = {}): BunPlugin {
+export function createUseClientBundlePlugin(
+  options: { workspaceRoot?: string; onClientModule?: (path: string, exports: string[]) => void } = {},
+): BunPlugin {
   return {
     name: "akan-use-client-bundle",
     setup(build) {
@@ -18,6 +20,7 @@ export function createUseClientBundlePlugin(options: { workspaceRoot?: string }
         const stubbed = transformUseClient(source, {
           path: args.path,
           workspaceRoot: options.workspaceRoot,
+          onClientModule: options.onClientModule,
         });
         if (stubbed === null) return undefined;
         return { contents: stubbed, loader: loaderFor(args.path) };