@akanjs/devkit 3.0.0 → 3.0.1

package/artifact/implicitRootLayout.test.ts

@@ -69,7 +69,8 @@ describe("resolveSsrPageEntries", () => {
 
     const generatedSource = await Bun.file(groupedRoot?.moduleAbsPath ?? "").text();
     expect(generatedSource).toContain("<System.Provider");
-    expect(generatedSource).toContain("theme={userLayout.theme ?? inheritedLayout.theme}");
+    expect(generatedSource).toContain("export const theme = userLayout.theme ?? inheritedLayout.theme;");
+    expect(generatedSource).toContain("theme={theme}");
     expect(generatedSource).toContain('import { allDictionary } from "../dict/useDict.ts";');
     expect(generatedSource).toContain(
       'allDictionary={process.env.AKAN_PUBLIC_RENDER_ENV === "ssr" ? allDictionary : undefined}',

package/artifact/implicitRootLayout.ts

@@ -215,6 +215,7 @@ const defaultFonts = userFonts.filter((font) => font.default);
 if (defaultFonts.length > 1) throw new Error("[route-convention] only one default font is allowed per root layout");
 const defaultFont = defaultFonts[0];
 const defaultFontClassName = defaultFont ? (defaultFont.className ?? \`font-\${defaultFont.name}\`) : undefined;
+export const theme = userLayout.theme ?? inheritedLayout.theme;
 
 ${layoutExports}(
     <System.Provider
@@ -223,7 +224,7 @@ ${layoutExports}(
       ${prefix ? `prefix=${JSON.stringify(prefix)}\n      ` : ""}params={params}
       manifest={userLayout.manifest ?? inheritedLayout.manifest}
       env={env}
-      theme={userLayout.theme ?? inheritedLayout.theme}
+      theme={theme}
       fonts={loadFonts(userFonts)}
       className={defaultFontClassName}
       layoutStyle={userLayout.layoutStyle ?? inheritedLayout.layoutStyle}

package/artifact/routeSeedIndex.test.ts

@@ -33,20 +33,6 @@ describe("computeRouteSeedIndex", () => {
     ).toThrow("route conflict");
   });
 
-  test("keeps special route seeds outside implicit locale", () => {
-    const index = computeRouteSeedIndex([
-      {
-        key: "./__root_layout.tsx",
-        moduleAbsPath: "/app/.akan/generated/root-layouts/__root_layout.tsx",
-        seedAbsPaths: ["/app/page/_layout.tsx"],
-      },
-      { key: "./robots.txt.tsx", moduleAbsPath: "/app/page/robots.txt.tsx" },
-    ]);
-    const robots = index.entries.find((entry) => entry.routeId === "/robots.txt");
-    expect(robots?.seeds).not.toContain(path.resolve("/app/.akan/generated/root-layouts/__root_layout.tsx"));
-    expect(robots?.seeds).not.toContain(path.resolve("/app/page/_layout.tsx"));
-  });
-
   test("serializes seed paths relative to the artifact directory", () => {
     const artifactDir = "/repo/dist/apps/akan/.akan/artifact";
     const serialized = serializeRouteSeedIndexForArtifact(

package/biome.base.json

@@ -176,6 +176,10 @@
       "includes": ["{apps,libs}/**/*.store.ts"],
       "plugins": ["./node_modules/@akanjs/devkit/lint/no-return-in-store-action.grit"]
     },
+    {
+      "includes": ["{apps,libs}/**/*.constant.ts"],
+      "plugins": ["./node_modules/@akanjs/devkit/lint/no-static-in-object-light-model.grit"]
+    },
     {
       "includes": ["{apps,libs}/**/*.ts", "{apps,libs}/**/*.tsx"],
       "plugins": ["./node_modules/@akanjs/devkit/lint/no-deprecated-log-level.grit"]

package/csrE2e/csrE2eHarness.fixture.ts

@@ -203,9 +203,10 @@ export class CsrE2eHarness {
     await Bun.sleep(50);
   }
 
-  //? The CSR frame's own dev sync-navigation event: it calls the app router's push/replace, as a click would.
+  //? The CSR frame's own dev sync-navigation event: it calls the app router's push/replace, as a click would, and a
+  //? `back` onto the entry under the page goes back, as another screen's relayed back does.
   //? The frame drops a navigation that starts while a transition runs, so each one waits the transition out.
-  async navigate(href: string, kind: "push" | "replace" = "push", { settleMs = SETTLE_MS } = {}) {
+  async navigate(href: string, kind: "push" | "replace" | "back" = "push", { settleMs = SETTLE_MS } = {}) {
     const target = new URL(href, this.origin);
     await this.evaluate(
       (next: string, how: string) => {

package/csrE2e/csrPageStack.e2e.test.ts

@@ -63,6 +63,19 @@ describe.skipIf(!CsrE2eHarness.enabled)("CSR page stack (minimal, /e2e/stack)",
     expect(await csr.reloaded()).toBe(false);
   }, 90_000);
 
+  test("a back relayed from another screen pops onto the entry under the page, keeping its state", async () => {
+    await csr.open(TAB_A);
+    await csr.navigate(item("31"));
+    await csr.type(currentInput, "thirty-one");
+    await csr.navigate(item("32"));
+    await csr.navigate(item("31"), "back");
+    expect(await itemIdsIn(CURRENT)).toEqual(["31"]);
+    expect(await csr.values(currentInput)).toEqual(["thirty-one"]);
+    await csr.back();
+    expect((await csr.currentPath()).split("?")[0]).toEndWith(TAB_A);
+    expect(await csr.reloaded()).toBe(false);
+  }, 60_000);
+
   test("a replace within one route updates the page in place", async () => {
     await csr.open(item("21"));
     await csr.type(currentInput, "kept");

package/frontendBuild/hmrWatcher.ts

@@ -61,6 +61,12 @@ export class HmrWatcher {
           const abs = path.resolve(root, filename.toString());
           this.#queue(abs);
         });
+        //? Linux emits an unreadable subdirectory as an async EPERM error event, which throws when unhandled.
+        //? The coverage-gap scan already warns about it, so only other errors are worth a warning here.
+        w.on("error", (err: NodeJS.ErrnoException) => {
+          if (err.code === "EACCES" || err.code === "EPERM") this.#logger.verbose(`[hmr] ${err.message}`);
+          else this.#logger.warn(`[hmr] watcher error under ${root}: ${err.message}`);
+        });
         this.#watchers.push(w);
         this.#logger.verbose(`[hmr] watching ${root}`);
       } catch (err) {

package/integration/devStability.integration.test.ts

@@ -583,10 +583,13 @@ describe("dev resource budgets", () => {
     expect(await DevStabilityHarness.buildWorkerProcess(host.proc.pid)).toBeNull();
   });
 
+  //? Between a fresh builder and one that has built a route, or the host stops enforcing it or never recycles.
+  //? macOS keeps the bundler arenas (~380MiB built); Linux measured 101-115MiB fresh, 157-176MiB built and settled.
+  const CEILING_MB = process.platform === "linux" ? 135 : 200;
+
   budgetTest("recycles the builder at an unmeetable ceiling and keeps developing through it", async () => {
     const harness = await createHarness();
-    // 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 host = await harness.startHost({ timeoutMs: BOOT_MS, env: { AKAN_BUILDER_MAX_RSS_MB: String(CEILING_MB) } });
     const start = host.markLog();
     await harness.waitForHttpText("initial-client-marker", WAIT_MS);
 
@@ -598,7 +601,7 @@ describe("dev resource budgets", () => {
 
     const recycleLog = await host.waitForLogSince(
       start,
-      /recycling builder pid=(\d+) \((rss=\d+MiB>=200MiB after \d+ build\(s\))\)/,
+      new RegExp(`recycling builder pid=(\\d+) \\((rss=\\d+MiB>=${CEILING_MB}MiB after \\d+ build\\(s\\))[;)]`),
       WAIT_MS,
     );
     await host.waitForLogSince(start, /exiting for recycle/, WAIT_MS);
@@ -634,7 +637,7 @@ describe("dev resource budgets", () => {
     const settled = await DevStabilityHarness.builderProcess(host.proc.pid);
     const warned = /ceiling costs about one boot build per interval/.test(host.logs.join("").slice(start));
     //? Past the interval (a slow machine) the next report recycles instead of warning: either answer settles it.
-    if ((settled?.rssBytes ?? 0) >= 200 * MB && !warned)
+    if ((settled?.rssBytes ?? 0) >= CEILING_MB * MB && !warned)
       await host.waitForLogSince(
         settledFrom,
         /ceiling costs about one boot build per interval|recycling builder pid=\d+|skipped: the builder fell to/,
@@ -645,7 +648,7 @@ describe("dev resource budgets", () => {
 
   budgetTest("serves a page requested while the builder is being replaced", async () => {
     const harness = await createHarness();
-    const host = await harness.startHost({ timeoutMs: BOOT_MS, env: { AKAN_BUILDER_MAX_RSS_MB: "200" } });
+    const host = await harness.startHost({ timeoutMs: BOOT_MS, env: { AKAN_BUILDER_MAX_RSS_MB: String(CEILING_MB) } });
     const port = await harness.resolvePort();
     await harness.waitForHttpText("initial-client-marker", WAIT_MS);
 

package/integration/devStabilityHarness.ts

@@ -269,6 +269,8 @@ export const dictionary = serviceDictionary(["en", "ko"])
         // The dev-plan/hmr assertions match verbose-level lines.
         AKAN_PUBLIC_LOG_LEVEL: "verbose",
         NODE_NO_WARNINGS: "1",
+        //? CI's `.env` names the branch; any env but local makes `akan start` ssh-tunnel to that cluster's Redis.
+        AKAN_PUBLIC_ENV: "local",
         PORT_OFFSET: String(offset),
         // Pinned: `getDevPort()` derives from the fixture's index in `apps/`, which parallel runs keep moving.
         AKAN_DEV_PORT: String(port),

package/lint/__fixtures__/no-static-in-object-light-model/bad.ts

@@ -0,0 +1,43 @@
+import { enumOf, ID, Int } from "akanjs/base";
+import { via } from "akanjs/constant";
+
+export class QuizInput extends via((field) => ({
+  userId: field(ID, { ref: "user", immutable: true }),
+})) {}
+
+export class QuizObject extends via(QuizInput, (field) => ({
+  correctNum: field(Int, { default: 0, min: 0 }),
+})) {
+  static maxNum = 4; // @flag
+  static readonly minNum = 1; // @flag
+  private static secretNum = 2; // @flag
+  static { // @flag
+    QuizObject.maxNum = 5;
+  }
+}
+
+export class LightQuiz extends via(
+  QuizObject,
+  ["userId", "correctNum"] as const,
+  (resolve) => ({}),
+) {
+  static choiceNum = 4; // @flag
+  static xpOfCorrect(comboNum: number) { // @flag
+    return comboNum * 10;
+  }
+  static async loadAll() { // @flag
+    return [];
+  }
+  static get defaultNum() { // @flag
+    return 1;
+  }
+  isPerfect() {
+    return this.correctNum === 4;
+  }
+}
+
+export class LightRenamed extends via(QuizObject, ["userId"] as const, (resolve) => ({})) {
+  static sizeNum = 1; // @flag
+}
+
+export class Quiz extends via(QuizObject, LightQuiz, (resolve) => ({})) {}

package/lint/__fixtures__/no-static-in-object-light-model/fixture.json

@@ -0,0 +1 @@
+{ "path": "lib/quiz/quiz.constant.ts" }

package/lint/__fixtures__/no-static-in-object-light-model/good.ts

@@ -0,0 +1,42 @@
+import { ID, Int } from "akanjs/base";
+import { via } from "akanjs/constant";
+
+export class QuizInput extends via((field) => ({
+  userId: field(ID, { ref: "user", immutable: true }),
+})) {
+  static minSize = 4; // @ok
+}
+
+export class QuizObject extends via(QuizInput, (field) => ({
+  correctNum: field(Int, { default: 0, min: 0 }),
+})) {}
+
+export class LightQuiz extends via(QuizObject, ["userId", "correctNum"] as const, (resolve) => ({})) {
+  isPerfect() { // @ok
+    return this.correctNum === 4;
+  }
+  staticNum = 1; // @ok
+}
+
+export class Quiz extends via(QuizObject, LightQuiz, (resolve) => ({})) {
+  static choiceNum = 4; // @ok
+  static xpOfCorrect(comboNum: number) { // @ok
+    return comboNum * 10;
+  }
+}
+
+export class QuizInsight extends via(Quiz, (field) => ({})) {
+  static emptyNum = 0; // @ok
+}
+
+export class Coordinate extends via((field) => ({
+  lat: field(Int),
+})) {
+  static getDistanceKm(a: Coordinate, b: Coordinate) { // @ok
+    return a.lat - b.lat;
+  }
+}
+
+export class ObjectRegistry {
+  static instance = new ObjectRegistry(); // @ok
+}

package/lint/no-static-in-object-light-model.grit

@@ -0,0 +1,27 @@
+engine biome(1.0)
+language js(typescript, jsx)
+
+// `via(XObject, LightX, ...)` mixes in only the prototypes of XObject and LightX (applyMixins in
+// akanjs/common), so a static declared on either never reaches the full model `X`. Statics belong on
+// XInput (or a scalar), X, or XInsight. The Object class is recognised by its `*Object` name, because its
+// via() shape is identical to the Insight's; the Light class also by its `[...] as const` field tuple.
+or {
+  JsMethodClassMember(),
+  JsPropertyClassMember(),
+  JsGetterClassMember(),
+  JsSetterClassMember(),
+  JsStaticInitializationBlockClassMember()
+} as $member where {
+  $member <: r"(?:(?:public|protected|private|declare|override|readonly|accessor)\s+)*static\b[\s\S]*",
+  $member <: within JsClassDeclaration() as $model where {
+    $model <: or {
+      r"class\s+(?:Light[A-Za-z0-9_$]*|[A-Za-z0-9_$]*Object)\s+extends\s+via\([\s\S]*",
+      r"class\s+[A-Za-z0-9_$]+\s+extends\s+via\(\s*[A-Za-z0-9_$.]+\s*,\s*\[[\s\S]*"
+    }
+  },
+  register_diagnostic(
+    span = $member,
+    message = "A static on an XObject or LightX class never reaches the full model, because via() mixes in their prototypes only. Declare it on XInput, the full model X, or XInsight instead.",
+    severity = "error"
+  )
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "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",
+    "akanjs": "3.0.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/subspace.test.ts

@@ -10,7 +10,16 @@ import { isolateEnv, tempDirs, writeText as write } from "./testHelpers";
 //? Each case drives several real git clones and pushes; on a 4-core Windows VM that alone lands at 2-5s.
 setDefaultTimeout(20_000);
 
-isolateEnv({ AKAN_PUBLIC_REPO_NAME: "workspace", AKAN_PUBLIC_SERVE_DOMAIN: "example.com", AKAN_PUBLIC_ENV: "local" });
+//? Subspace commits in its clone with the host's identity, and a CI host has none configured.
+isolateEnv({
+  AKAN_PUBLIC_REPO_NAME: "workspace",
+  AKAN_PUBLIC_SERVE_DOMAIN: "example.com",
+  AKAN_PUBLIC_ENV: "local",
+  GIT_AUTHOR_NAME: "t",
+  GIT_AUTHOR_EMAIL: "t@t",
+  GIT_COMMITTER_NAME: "t",
+  GIT_COMMITTER_EMAIL: "t@t",
+});
 const makeTempRoot = tempDirs("akan-subspace-");
 
 const git = async (cwd: string, args: string[]) =>