@akanjs/devkit 2.3.2 → 2.3.3-rc.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @akanjs/devkit
 
+## 2.3.2
+
+### Patch Changes
+
+- d6db24d: Fix dev runtime refresh for client components, dictionaries, and signal metadata while keeping regenerated server page bundles aligned with live app signal definitions.
+- 1a48756: Add RSC partial navigation patch handling and supporting SSR build updates, plus benchmark harness improvements for validating production behavior.
+- Updated dependencies [940d6db]
+- Updated dependencies [d6db24d]
+- Updated dependencies [dc60773]
+- Updated dependencies [ffe68ec]
+- Updated dependencies [1a48756]
+- Updated dependencies [1a48756]
+- Updated dependencies [1a48756]
+- Updated dependencies [1a48756]
+- Updated dependencies [1a48756]
+- Updated dependencies [4fc2673]
+  - akanjs@2.4.0
+
 ## 2.2.12
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "2.3.2",
+  "version": "2.3.3-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.2",
+    "akanjs": "2.3.3-rc.1",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "^5.5.20",

package/transforms/externalizeFrameworkPlugin.test.ts

@@ -0,0 +1,182 @@
+import { afterEach, describe, expect, test } from "bun:test";
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createExternalizeFrameworkPlugin } from "./externalizeFrameworkPlugin";
+
+const tempRoots: string[] = [];
+
+const makeTempRoot = async () => {
+  const root = await mkdtemp(path.join(os.tmpdir(), "akan-devkit-externalize-"));
+  tempRoots.push(root);
+  return root;
+};
+
+const write = async (filePath: string, content: string) => {
+  await mkdir(path.dirname(filePath), { recursive: true });
+  await writeFile(filePath, content);
+};
+
+afterEach(async () => {
+  await Promise.all(tempRoots.splice(0).map((root) => rm(root, { recursive: true, force: true })));
+});
+
+describe("createExternalizeFrameworkPlugin", () => {
+  test("bundles akanjs/server workspace sources into production pages artifacts", async () => {
+    const root = await makeTempRoot();
+    const entry = path.join(root, "entry.ts");
+    const outdir = path.join(root, "out");
+    await write(
+      entry,
+      [
+        'import { optionMarker } from "akanjs/server";',
+        'import { tryMarker } from "akanjs/server/decorators";',
+        'import { jsx } from "react/jsx-runtime";',
+        "export const markers = [optionMarker, tryMarker, jsx];",
+        "",
+      ].join("\n"),
+    );
+    await write(path.join(root, "pkgs/akanjs/server/index.ts"), 'export const optionMarker = "akan-option";\n');
+    await write(path.join(root, "pkgs/akanjs/server/decorators.ts"), 'export const tryMarker = "akan-try";\n');
+
+    const plugin = await createExternalizeFrameworkPlugin({
+      app: {
+        workspace: { workspaceRoot: root },
+        getTsConfig: async () => ({
+          compilerOptions: {
+            paths: {
+              "akanjs": ["./pkgs/akanjs/index.ts"],
+              "akanjs/*": ["./pkgs/akanjs/*"],
+              "akanjs/server": ["./pkgs/akanjs/server/index.ts"],
+              "akanjs/server/*": ["./pkgs/akanjs/server/*"],
+            },
+          },
+        }),
+      } as never,
+    });
+
+    const result = await Bun.build({
+      entrypoints: [entry],
+      outdir,
+      target: "bun",
+      format: "esm",
+      plugins: [plugin],
+    });
+
+    expect(result.success).toBe(true);
+    const output = await result.outputs.find((artifact) => artifact.kind === "entry-point")?.text();
+    expect(output).toContain("akan-option");
+    expect(output).toContain("akan-try");
+    expect(output).not.toMatch(/from\s+["']akanjs\/server(?:\/decorators)?["']/);
+    expect(output).toContain("react/jsx-runtime");
+  });
+
+  test("externalizes optional backend dependencies reached through bundled akanjs/server sources", async () => {
+    const root = await makeTempRoot();
+    const entry = path.join(root, "entry.ts");
+    const outdir = path.join(root, "out");
+    await write(
+      entry,
+      [
+        'import { optionMarker, redisLoader } from "akanjs/server";',
+        "export const marker = optionMarker;",
+        "export const loader = redisLoader;",
+        "",
+      ].join("\n"),
+    );
+    await write(
+      path.join(root, "pkgs/akanjs/server/index.ts"),
+      [
+        'import { loadRedis } from "akanjs/service";',
+        'export const optionMarker = "akan-option";',
+        "export const redisLoader = loadRedis;",
+        "",
+      ].join("\n"),
+    );
+    await write(path.join(root, "pkgs/akanjs/service/index.ts"), 'export * from "./predefinedAdaptor";\n');
+    await write(
+      path.join(root, "pkgs/akanjs/service/predefinedAdaptor/index.ts"),
+      'export const loadRedis = async () => import("ioredis");\n',
+    );
+
+    const plugin = await createExternalizeFrameworkPlugin({
+      app: {
+        workspace: { workspaceRoot: root },
+        getTsConfig: async () => ({
+          compilerOptions: {
+            paths: {
+              "akanjs": ["./pkgs/akanjs/index.ts"],
+              "akanjs/*": ["./pkgs/akanjs/*"],
+              "akanjs/server": ["./pkgs/akanjs/server/index.ts"],
+              "akanjs/server/*": ["./pkgs/akanjs/server/*"],
+            },
+          },
+        }),
+      } as never,
+    });
+
+    const result = await Bun.build({
+      entrypoints: [entry],
+      outdir,
+      target: "bun",
+      format: "esm",
+      plugins: [plugin],
+    });
+
+    expect(result.success).toBe(true);
+    const output = await result.outputs.find((artifact) => artifact.kind === "entry-point")?.text();
+    expect(output).toContain("akan-option");
+    expect(output).toContain("ioredis");
+    expect(output).not.toMatch(/from\s+["']akanjs\/(?:server|service)["']/);
+  });
+
+  test("lets published akanjs package exports resolve when workspace paths are absent", async () => {
+    const root = await makeTempRoot();
+    const entry = path.join(root, "entry.ts");
+    const outdir = path.join(root, "out");
+    await write(
+      entry,
+      [
+        'import { optionMarker } from "akanjs/server";',
+        'import { jsx } from "react/jsx-runtime";',
+        "export const markers = [optionMarker, jsx];",
+        "",
+      ].join("\n"),
+    );
+    await write(
+      path.join(root, "node_modules/akanjs/package.json"),
+      JSON.stringify({
+        name: "akanjs",
+        type: "module",
+        exports: {
+          "./server": {
+            import: "./server/index.ts",
+            default: "./server/index.ts",
+          },
+        },
+      }),
+    );
+    await write(path.join(root, "node_modules/akanjs/server/index.ts"), 'export const optionMarker = "published-option";\n');
+
+    const plugin = await createExternalizeFrameworkPlugin({
+      app: {
+        workspace: { workspaceRoot: root },
+        getTsConfig: async () => ({ compilerOptions: { paths: {} } }),
+      } as never,
+    });
+
+    const result = await Bun.build({
+      entrypoints: [entry],
+      outdir,
+      target: "bun",
+      format: "esm",
+      plugins: [plugin],
+    });
+
+    expect(result.success).toBe(true);
+    const output = await result.outputs.find((artifact) => artifact.kind === "entry-point")?.text();
+    expect(output).toContain("published-option");
+    expect(output).not.toMatch(/from\s+["']akanjs\/server["']/);
+    expect(output).toContain("react/jsx-runtime");
+  });
+});

package/transforms/externalizeFrameworkPlugin.ts

@@ -28,7 +28,7 @@ import type { App } from "../commandDecorators";
  *      inlined so transitive `"use client"` stubs work.
  *   2. Specifiers listed in `include` (workspace aliases like
  *      `@apps/*`, `@libs/*`) are NEVER externalized.
- *   3. React / RSC runtime packages and framework host packages are
+ *   3. React / RSC runtime packages and build-time tooling packages are
  *      externalized so the runtime supplies a single shared instance.
  *   4. Other bare npm packages are bundled so the Docker runtime does not
  *      need to install every transitive page dependency separately.
@@ -60,8 +60,16 @@ const DEFAULT_INCLUDE = ["akanjs/", "@apps/", "@libs/"];
 // otherwise bundle them. These are runtime hosts or shared singleton
 // framework packages; ordinary npm dependencies intentionally fall through
 // to Bun's resolver and get bundled.
-const DEFAULT_EXCLUDE_EXACT = new Set<string>(["akanjs/webkit", "akanjs/server", "@akanjs/cli", "@akanjs/devkit"]);
-const DEFAULT_EXCLUDE_PREFIX = ["akanjs/server/", "@akanjs/cli/", "@akanjs/devkit/"];
+const DEFAULT_EXCLUDE_EXACT = new Set<string>(["akanjs/webkit", "@akanjs/cli", "@akanjs/devkit"]);
+const DEFAULT_EXCLUDE_PREFIX = ["@akanjs/cli/", "@akanjs/devkit/"];
+const OPTIONAL_BACKEND_EXTERNAL_EXACT = new Set<string>([
+  "@libsql/client",
+  "bullmq",
+  "croner",
+  "ioredis",
+  "postgres",
+  "protobufjs",
+]);
 const RUNTIME_EXTERNAL_EXACT = new Set<string>([
   "react",
   "react-dom",
@@ -141,6 +149,7 @@ export async function createExternalizeFrameworkPlugin(options: ExternalizeFrame
         for (const prefix of DEFAULT_EXCLUDE_PREFIX) {
           if (spec.startsWith(prefix)) return { path: spec, external: true };
         }
+        if (OPTIONAL_BACKEND_EXTERNAL_EXACT.has(spec)) return { path: spec, external: true };
         if (RUNTIME_EXTERNAL_EXACT.has(spec)) return { path: spec, external: true };
         for (const prefix of RUNTIME_EXTERNAL_PREFIX) {
           if (spec.startsWith(prefix)) return { path: spec, external: true };