@akanjs/devkit 2.1.1 → 2.1.2-rc.0

package/akanConfig/akanConfig.test.ts

@@ -7,7 +7,13 @@ import { AkanAppConfig, AkanLibConfig } from "./akanConfig";
 import type { DeepPartial, LibConfigResult } from "./types";
 
 const akanPackageJson = JSON.parse(
-  fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), "../../../akanjs/package.json"), "utf8"),
+  fs.readFileSync(
+    path.join(
+      path.dirname(fileURLToPath(import.meta.url)),
+      "../../../akanjs/package.json",
+    ),
+    "utf8",
+  ),
 ) as PackageJson;
 
 const packageJson: PackageJson = {
@@ -34,7 +40,13 @@ const baseDevEnv = {
 
 describe("AkanAppConfig", () => {
   test("applies defaults for route domains, i18n, image, mobile, and imports", () => {
-    const config = new AkanAppConfig(app, ["shared"], packageJson, {}, baseDevEnv);
+    const config = new AkanAppConfig(
+      app,
+      ["shared"],
+      packageJson,
+      {},
+      baseDevEnv,
+    );
 
     expect([...config.domains].sort()).toEqual([
       "portal-debug.akanjs.com",
@@ -61,7 +73,11 @@ describe("AkanAppConfig", () => {
       },
     });
     expect(config.barrelImports).toEqual(
-      expect.arrayContaining(["@apps/portal/ui", "@libs/shared/server", "akanjs/common"]),
+      expect.arrayContaining([
+        "@apps/portal/ui",
+        "@libs/shared/server",
+        "akanjs/common",
+      ]),
     );
     expect(config.docker.content).toContain("ENV AKAN_PUBLIC_APP_NAME=portal");
     expect(process.env.AKAN_PUBLIC_DEFAULT_LOCALE).toBe("en");
@@ -75,10 +91,21 @@ describe("AkanAppConfig", () => {
       {
         routes: [
           { domains: { debug: ["Root.Local:8282"], qa: ["QA.Root.Local"] } },
-          { basePath: "/admin/", domains: { debug: ["Admin.Local:8282"], main: ["Admin.Main.Local"] } },
+          {
+            basePath: "/admin/",
+            domains: {
+              debug: ["Admin.Local:8282"],
+              main: ["Admin.Main.Local"],
+            },
+          },
         ],
         i18n: { locales: ["ko", "en"], defaultLocale: "ko" },
-        mobile: { appName: "Portal App", appId: "com.portal.mobile", version: "1.2.3", buildNum: 7 },
+        mobile: {
+          appName: "Portal App",
+          appId: "com.portal.mobile",
+          version: "1.2.3",
+          buildNum: 7,
+        },
         images: { qualities: [80, 90], dangerouslyAllowSVG: true },
         docker: {
           image: { amd64: "oven/bun:amd64", arm64: "oven/bun:arm64" },
@@ -102,7 +129,12 @@ describe("AkanAppConfig", () => {
       "admin.local",
       "admin.main.local",
     ]);
-    expect([...config.branches].sort()).toEqual(["debug", "develop", "main", "qa"]);
+    expect([...config.branches].sort()).toEqual([
+      "debug",
+      "develop",
+      "main",
+      "qa",
+    ]);
     expect(config.i18n.defaultLocale).toBe("ko");
     expect(config.images.qualities).toEqual([80, 90]);
     expect(config.images.dangerouslyAllowSVG).toBe(true);
@@ -122,9 +154,17 @@ describe("AkanAppConfig", () => {
   });
 
   test("creates production package json and reports missing external versions", () => {
-    const config = new AkanAppConfig(app, [], packageJson, { externalLibs: ["@external/runtime"] }, baseDevEnv);
+    const config = new AkanAppConfig(
+      app,
+      [],
+      packageJson,
+      { externalLibs: ["@external/runtime"] },
+      baseDevEnv,
+    );
 
-    expect(config.getProductionPackageJson({ scripts: { start: "bun main.js" } })).toMatchObject({
+    expect(
+      config.getProductionPackageJson({ scripts: { start: "bun main.js" } }),
+    ).toMatchObject({
       name: "portal",
       main: "./main.js",
       scripts: { start: "bun main.js" },
@@ -145,11 +185,16 @@ describe("AkanAppConfig", () => {
       { externalLibs: ["missing-lib"] },
       baseDevEnv,
     );
-    expect(() => brokenConfig.getProductionPackageJson()).toThrow("Dependency missing-lib not found");
+    expect(() => brokenConfig.getProductionPackageJson()).toThrow(
+      "Dependency missing-lib not found",
+    );
   });
 
   test("falls back to akanjs package versions for built-in runtime dependencies", () => {
-    const runtimeDependencies = { ...akanPackageJson.dependencies, ...akanPackageJson.peerDependencies };
+    const runtimeDependencies = {
+      ...akanPackageJson.dependencies,
+      ...akanPackageJson.peerDependencies,
+    };
     const config = new AkanAppConfig(
       app,
       [],
@@ -168,44 +213,130 @@ describe("AkanAppConfig", () => {
     expect(config.getProductionPackageJson().dependencies).toEqual({
       react: runtimeDependencies.react,
       "react-dom": runtimeDependencies["react-dom"],
-      "react-server-dom-webpack": runtimeDependencies["react-server-dom-webpack"],
+      "react-server-dom-webpack":
+        runtimeDependencies["react-server-dom-webpack"],
       croner: runtimeDependencies.croner,
       sharp: runtimeDependencies.sharp,
     });
   });
 
   test("adds backend runtime packages by database mode", () => {
-    const runtimeDependencies = { ...akanPackageJson.dependencies, ...akanPackageJson.peerDependencies };
-    const singleConfig = new AkanAppConfig(app, [], packageJson, { defaultDatabaseMode: "single" }, baseDevEnv);
-    const multipleConfig = new AkanAppConfig(app, [], packageJson, { defaultDatabaseMode: "multiple" }, baseDevEnv);
-    const clusterConfig = new AkanAppConfig(app, [], packageJson, { defaultDatabaseMode: "cluster" }, baseDevEnv);
+    const runtimeDependencies = {
+      ...akanPackageJson.dependencies,
+      ...akanPackageJson.peerDependencies,
+    };
+    const singleConfig = new AkanAppConfig(
+      app,
+      [],
+      packageJson,
+      { defaultDatabaseMode: "single" },
+      baseDevEnv,
+    );
+    const multipleConfig = new AkanAppConfig(
+      app,
+      [],
+      packageJson,
+      { defaultDatabaseMode: "multiple" },
+      baseDevEnv,
+    );
+    const clusterConfig = new AkanAppConfig(
+      app,
+      [],
+      packageJson,
+      { defaultDatabaseMode: "cluster" },
+      baseDevEnv,
+    );
 
     expect(singleConfig.getProductionPackageJson().dependencies).toMatchObject({
       croner: runtimeDependencies.croner,
     });
-    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("ioredis");
-    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("bullmq");
-    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("@libsql/client");
-    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("postgres");
-    expect(singleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("protobufjs");
+    expect(
+      singleConfig.getProductionPackageJson().dependencies,
+    ).not.toHaveProperty("ioredis");
+    expect(
+      singleConfig.getProductionPackageJson().dependencies,
+    ).not.toHaveProperty("bullmq");
+    expect(
+      singleConfig.getProductionPackageJson().dependencies,
+    ).not.toHaveProperty("@libsql/client");
+    expect(
+      singleConfig.getProductionPackageJson().dependencies,
+    ).not.toHaveProperty("postgres");
+    expect(
+      singleConfig.getProductionPackageJson().dependencies,
+    ).not.toHaveProperty("protobufjs");
 
-    expect(multipleConfig.getProductionPackageJson().dependencies).toMatchObject({
+    expect(
+      multipleConfig.getProductionPackageJson().dependencies,
+    ).toMatchObject({
       "@libsql/client": runtimeDependencies["@libsql/client"],
       bullmq: runtimeDependencies.bullmq,
       croner: runtimeDependencies.croner,
       ioredis: runtimeDependencies.ioredis,
       protobufjs: runtimeDependencies.protobufjs,
     });
-    expect(multipleConfig.getProductionPackageJson().dependencies).not.toHaveProperty("postgres");
+    expect(
+      multipleConfig.getProductionPackageJson().dependencies,
+    ).not.toHaveProperty("postgres");
 
-    expect(clusterConfig.getProductionPackageJson().dependencies).toMatchObject({
-      bullmq: runtimeDependencies.bullmq,
-      croner: runtimeDependencies.croner,
-      ioredis: runtimeDependencies.ioredis,
-      postgres: runtimeDependencies.postgres,
-      protobufjs: runtimeDependencies.protobufjs,
-    });
-    expect(clusterConfig.getProductionPackageJson().dependencies).not.toHaveProperty("@libsql/client");
+    expect(clusterConfig.getProductionPackageJson().dependencies).toMatchObject(
+      {
+        bullmq: runtimeDependencies.bullmq,
+        croner: runtimeDependencies.croner,
+        ioredis: runtimeDependencies.ioredis,
+        postgres: runtimeDependencies.postgres,
+        protobufjs: runtimeDependencies.protobufjs,
+      },
+    );
+    expect(
+      clusterConfig.getProductionPackageJson().dependencies,
+    ).not.toHaveProperty("@libsql/client");
+  });
+
+  test("resolves database mode runtime packages and missing install specs", () => {
+    const runtimeDependencies = {
+      ...akanPackageJson.dependencies,
+      ...akanPackageJson.peerDependencies,
+    };
+    const config = new AkanAppConfig(
+      app,
+      [],
+      {
+        name: "repo",
+        version: "1.0.0",
+        description: "repo",
+        dependencies: {
+          bullmq: "5.0.0",
+        },
+        devDependencies: {
+          ioredis: "5.0.0",
+        },
+      },
+      {},
+      baseDevEnv,
+    );
+
+    expect(config.getDatabaseModeRuntimePackages("single")).toEqual([]);
+    expect(config.getDatabaseModeRuntimePackages("multiple")).toEqual([
+      "@libsql/client",
+      "bullmq",
+      "ioredis",
+      "protobufjs",
+    ]);
+    expect(config.getDatabaseModeRuntimePackages("cluster")).toEqual([
+      "bullmq",
+      "ioredis",
+      "postgres",
+      "protobufjs",
+    ]);
+    expect(config.getMissingDatabaseModeDependencySpecs("multiple")).toEqual([
+      `@libsql/client@${runtimeDependencies["@libsql/client"]}`,
+      `protobufjs@${runtimeDependencies.protobufjs}`,
+    ]);
+    expect(config.getMissingDatabaseModeDependencySpecs("cluster")).toEqual([
+      `postgres@${runtimeDependencies.postgres}`,
+      `protobufjs@${runtimeDependencies.protobufjs}`,
+    ]);
   });
 
   test("normalizes multiple mobile targets and validates base paths", () => {
@@ -266,7 +397,11 @@ describe("AkanLibConfig", () => {
     const lib = { name: "shared" } as never;
     expect(new AkanLibConfig(lib, {}).externalLibs).toEqual([]);
 
-    const config: DeepPartial<LibConfigResult> = { externalLibs: ["firebase-admin"] };
-    expect(new AkanLibConfig(lib, config).externalLibs).toEqual(["firebase-admin"]);
+    const config: DeepPartial<LibConfigResult> = {
+      externalLibs: ["firebase-admin"],
+    };
+    expect(new AkanLibConfig(lib, config).externalLibs).toEqual([
+      "firebase-admin",
+    ]);
   });
 });

package/akanConfig/akanConfig.ts

@@ -47,8 +47,18 @@ const DEFAULT_OPTIMIZE_IMPORTS = [
   "mui-core",
   "react-icons/*",
 ];
-const WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"] as const;
-const SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"] as const;
+const WORKSPACE_BARREL_FACETS = [
+  "ui",
+  "webkit",
+  "common",
+  "client",
+  "server",
+] as const;
+const SSR_RUNTIME_PACKAGES = [
+  "react",
+  "react-dom",
+  "react-server-dom-webpack",
+] as const;
 const NATIVE_RUNTIME_PACKAGES = ["sharp"] as const;
 const DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"] as const;
 const DATABASE_MODE_RUNTIME_PACKAGES = {
@@ -111,19 +121,31 @@ export class AkanAppConfig implements AppConfigResult {
     this.barrelImports = [
       ...DEFAULT_BARREL_IMPORTS,
       ...WORKSPACE_BARREL_FACETS.map((facet) => `@apps/${app.name}/${facet}`),
-      ...libs.flatMap((lib) => WORKSPACE_BARREL_FACETS.map((facet) => `@libs/${lib}/${facet}`)),
+      ...libs.flatMap((lib) =>
+        WORKSPACE_BARREL_FACETS.map((facet) => `@libs/${lib}/${facet}`),
+      ),
       ...(config?.barrelImports ?? []),
     ];
-    this.optimizeImports = [...new Set([...DEFAULT_OPTIMIZE_IMPORTS, ...(config?.optimizeImports ?? [])])];
-    this.images = mergeImageConfig(config?.images as Partial<AkanImageConfig> | undefined);
+    this.optimizeImports = [
+      ...new Set([
+        ...DEFAULT_OPTIMIZE_IMPORTS,
+        ...(config?.optimizeImports ?? []),
+      ]),
+    ];
+    this.images = mergeImageConfig(
+      config?.images as Partial<AkanImageConfig> | undefined,
+    );
     this.i18n = resolveAkanI18nConfig(config?.i18n);
     process.env.AKAN_PUBLIC_DEFAULT_LOCALE = this.i18n.defaultLocale;
     process.env.AKAN_PUBLIC_LOCALES = this.i18n.locales.join(",");
-    this.publicEnv = (config?.publicEnv as string[] | undefined) ?? ([] as string[]);
+    this.publicEnv =
+      (config?.publicEnv as string[] | undefined) ?? ([] as string[]);
     this.mobile = this.#resolveMobileConfig(config.mobile);
     this.docker = this.#makeDockerContent(config?.docker ?? {});
   }
-  #resolveMobileConfig(mobile: DeepPartial<AkanMobileConfig> | undefined): AkanMobileConfig {
+  #resolveMobileConfig(
+    mobile: DeepPartial<AkanMobileConfig> | undefined,
+  ): AkanMobileConfig {
     const { targets: rawTargets, ...rawMobile } = mobile ?? {};
     const appName = rawMobile.appName ?? this.app.name;
     const appId = rawMobile.appId ?? `com.${this.app.name}.app`;
@@ -138,8 +160,11 @@ export class AkanAppConfig implements AppConfigResult {
     const targets = Object.fromEntries(
       targetEntries.map(([name, rawTarget]) => {
         const target = rawTarget as DeepPartial<AkanMobileTargetConfig>;
-        const fallbackBasePath = !rawTargets && this.basePaths.has(name) ? name : undefined;
-        const basePath = (target.basePath ?? fallbackBasePath)?.replace(/^\/+|\/+$/g, "") || undefined;
+        const fallbackBasePath =
+          !rawTargets && this.basePaths.has(name) ? name : undefined;
+        const basePath =
+          (target.basePath ?? fallbackBasePath)?.replace(/^\/+|\/+$/g, "") ||
+          undefined;
         if (basePath && !this.basePaths.has(basePath)) {
           throw new Error(
             `Mobile target '${name}' uses unknown basePath '${basePath}' in apps/${this.app.name}/akan.config.ts`,
@@ -180,8 +205,11 @@ export class AkanAppConfig implements AppConfigResult {
       plugins: rawMobile.plugins,
     } as AkanMobileConfig;
   }
-  #defaultMobileTargetName(rawTargets: DeepPartial<AkanMobileConfig>["targets"] | undefined) {
-    if (rawTargets && Object.keys(rawTargets).length > 0) return Object.keys(rawTargets)[0] as string;
+  #defaultMobileTargetName(
+    rawTargets: DeepPartial<AkanMobileConfig>["targets"] | undefined,
+  ) {
+    if (rawTargets && Object.keys(rawTargets).length > 0)
+      return Object.keys(rawTargets)[0] as string;
     return this.basePaths.has(this.app.name) ? this.app.name : "default";
   }
   #applyRoutes(routes: AkanRouteConfig[] = []) {
@@ -190,28 +218,38 @@ export class AkanAppConfig implements AppConfigResult {
         const basePath = route.basePath.replace(/^\/+|\/+$/g, "");
         this.basePaths.add(basePath);
         const domains = this.subRoutes.getOrInsert(basePath, new Set());
-        Object.keys(route.domains).forEach((branch) => void this.branches.add(branch));
+        Object.keys(route.domains).forEach(
+          (branch) => void this.branches.add(branch),
+        );
         Object.values(route.domains)
           .flat()
           .forEach((domain) => {
             if (domain) domains.add(domain.toLowerCase().replace(/:\d+$/, ""));
           });
       } else {
-        Object.keys(route.domains).forEach((branch) => void this.branches.add(branch));
+        Object.keys(route.domains).forEach(
+          (branch) => void this.branches.add(branch),
+        );
         Object.values(route.domains)
           .flat()
           .forEach((domain) => {
-            if (domain) this.domains.add(domain.toLowerCase().replace(/:\d+$/, ""));
+            if (domain)
+              this.domains.add(domain.toLowerCase().replace(/:\d+$/, ""));
           });
       }
     }
     const appName = this.app.name.toLowerCase();
     const serveDomain = this.baseDevEnv.serveDomain.toLowerCase();
     if (this.subRoutes.size === 0)
-      this.branches.forEach((branch) => void this.domains.add(`${appName}-${branch}.${serveDomain}`));
+      this.branches.forEach(
+        (branch) =>
+          void this.domains.add(`${appName}-${branch}.${serveDomain}`),
+      );
     else
       Array.from(this.subRoutes.entries()).forEach(([basePath, domains]) => {
-        this.branches.forEach((domain) => void domains.add(`${basePath}-${domain}.${serveDomain}`));
+        this.branches.forEach(
+          (domain) => void domains.add(`${basePath}-${domain}.${serveDomain}`),
+        );
       });
   }
   #getDockerRunScripts(runs: (string | { [key in Arch]?: string })[]) {
@@ -227,12 +265,25 @@ export class AkanAppConfig implements AppConfigResult {
           .join("\n");
     });
   }
-  #getDockerImageScript(image: string | { [key in Arch]?: string }, defaultImage: string) {
+  #getDockerImageScript(
+    image: string | { [key in Arch]?: string },
+    defaultImage: string,
+  ) {
     if (typeof image === "string") return `FROM ${image}`;
-    else return archs.map((arch) => `FROM ${image[arch] ?? defaultImage} AS ${arch}`).join("\n");
+    else
+      return archs
+        .map((arch) => `FROM ${image[arch] ?? defaultImage} AS ${arch}`)
+        .join("\n");
   }
   #makeDockerContent(docker: DeepPartial<DockerConfig>): DockerConfig {
-    if (docker.content) return { content: docker.content, image: {}, preRuns: [], postRuns: [], command: [] };
+    if (docker.content)
+      return {
+        content: docker.content,
+        image: {},
+        preRuns: [],
+        postRuns: [],
+        command: [],
+      };
     const preRunScripts = this.#getDockerRunScripts(docker.preRuns ?? []);
     const postRunScripts = this.#getDockerRunScripts(docker.postRuns ?? []);
 
@@ -264,12 +315,20 @@ ENV AKAN_PUBLIC_LOCALES=${this.i18n.locales.join(",")}
 ENV AKAN_PUBLIC_OPERATION_MODE=cloud
 
 CMD [${command.map((c) => `"${c}"`).join(",")}]`;
-    return { content, image: imageScript, preRuns: docker.preRuns ?? [], postRuns: docker.postRuns ?? [], command };
+    return {
+      content,
+      image: imageScript,
+      preRuns: docker.preRuns ?? [],
+      postRuns: docker.postRuns ?? [],
+      command,
+    };
   }
   static async from(app: App) {
     const [configImp, baseDevEnv, libs, rootPackageJson] = await Promise.all([
       import(`${app.cwdPath}/akan.config.ts`).then((mod) => mod.default),
-      WorkspaceExecutor.getBaseDevEnv(path.join(app.workspace.workspaceRoot, ".env")),
+      WorkspaceExecutor.getBaseDevEnv(
+        path.join(app.workspace.workspaceRoot, ".env"),
+      ),
       app.workspace.getLibs(),
       app.workspace.getPackageJson(),
     ]);
@@ -277,11 +336,16 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     return new AkanAppConfig(app, libs, rootPackageJson, config, baseDevEnv);
   }
   #resolveProductionDependencyVersion(lib: string) {
-    const rootVersion = this.rootPackageJson.dependencies?.[lib] ?? this.rootPackageJson.devDependencies?.[lib];
+    const rootVersion =
+      this.rootPackageJson.dependencies?.[lib] ??
+      this.rootPackageJson.devDependencies?.[lib];
     if (rootVersion) return rootVersion;
     const akanPackageJson = getAkanPackageJson();
     if (AKAN_RUNTIME_PACKAGES.has(lib))
-      return akanPackageJson.dependencies?.[lib] ?? akanPackageJson.peerDependencies?.[lib];
+      return (
+        akanPackageJson.dependencies?.[lib] ??
+        akanPackageJson.peerDependencies?.[lib]
+      );
   }
   #getProductionRuntimePackages() {
     return [
@@ -289,9 +353,30 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
       ...SSR_RUNTIME_PACKAGES,
       ...NATIVE_RUNTIME_PACKAGES,
       ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
-      ...DATABASE_MODE_RUNTIME_PACKAGES[this.defaultDatabaseMode],
+      ...this.getDatabaseModeRuntimePackages(),
     ];
   }
+  getDatabaseModeRuntimePackages(
+    databaseMode: DatabaseMode = this.defaultDatabaseMode,
+  ) {
+    return [...DATABASE_MODE_RUNTIME_PACKAGES[databaseMode]];
+  }
+  getMissingDatabaseModeDependencySpecs(
+    databaseMode: DatabaseMode = this.defaultDatabaseMode,
+  ) {
+    const rootDependencies = {
+      ...this.rootPackageJson.dependencies,
+      ...this.rootPackageJson.devDependencies,
+    };
+    return this.getDatabaseModeRuntimePackages(databaseMode)
+      .filter((lib) => !rootDependencies[lib])
+      .map((lib) => {
+        const version = this.#resolveProductionDependencyVersion(lib);
+        if (!version)
+          throw new Error(`Dependency ${lib} not found in package.json`);
+        return `${lib}@${version}`;
+      });
+  }
   getProductionPackageJson(data: Partial<PackageJson> = {}): PackageJson {
     return {
       name: this.app.name,
@@ -301,7 +386,8 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
       dependencies: Object.fromEntries(
         [...new Set(this.#getProductionRuntimePackages())].map((lib) => {
           const version = this.#resolveProductionDependencyVersion(lib);
-          if (!version) throw new Error(`Dependency ${lib} not found in package.json`);
+          if (!version)
+            throw new Error(`Dependency ${lib} not found in package.json`);
           return [lib, version];
         }),
       ),
@@ -327,17 +413,26 @@ function getAkanPackageJson() {
   }
   for (const packageJsonPath of packageJsonPaths) {
     try {
-      akanPackageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8")) as PackageJson;
+      akanPackageJson = JSON.parse(
+        fs.readFileSync(packageJsonPath, "utf8"),
+      ) as PackageJson;
       return akanPackageJson;
     } catch {
       // Try the next known layout: source package first, bundled CLI package second.
     }
   }
-  akanPackageJson = { name: "akanjs", version: "0.0.0", description: "akanjs", dependencies: {} };
+  akanPackageJson = {
+    name: "akanjs",
+    version: "0.0.0",
+    description: "akanjs",
+    dependencies: {},
+  };
   return akanPackageJson;
 }
 
-function mergeImageConfig(config: Partial<AkanImageConfig> = {}): AkanImageConfig {
+function mergeImageConfig(
+  config: Partial<AkanImageConfig> = {},
+): AkanImageConfig {
   return {
     ...DEFAULT_AKAN_IMAGE_CONFIG,
     ...config,
@@ -345,8 +440,10 @@ function mergeImageConfig(config: Partial<AkanImageConfig> = {}): AkanImageConfi
     imageSizes: config.imageSizes ?? DEFAULT_AKAN_IMAGE_CONFIG.imageSizes,
     formats: config.formats ?? DEFAULT_AKAN_IMAGE_CONFIG.formats,
     qualities: config.qualities ?? DEFAULT_AKAN_IMAGE_CONFIG.qualities,
-    remotePatterns: config.remotePatterns ?? DEFAULT_AKAN_IMAGE_CONFIG.remotePatterns,
-    localPatterns: config.localPatterns ?? DEFAULT_AKAN_IMAGE_CONFIG.localPatterns,
+    remotePatterns:
+      config.remotePatterns ?? DEFAULT_AKAN_IMAGE_CONFIG.remotePatterns,
+    localPatterns:
+      config.localPatterns ?? DEFAULT_AKAN_IMAGE_CONFIG.localPatterns,
   };
 }
 
@@ -358,7 +455,9 @@ export class AkanLibConfig implements LibConfigResult {
     this.externalLibs = config?.externalLibs ?? [];
   }
   static async from(lib: Lib) {
-    const [configImp] = await Promise.all([import(`${lib.cwdPath}/akan.config.ts`).then((mod) => mod.default)]);
+    const [configImp] = await Promise.all([
+      import(`${lib.cwdPath}/akan.config.ts`).then((mod) => mod.default),
+    ]);
     const config = typeof configImp === "function" ? configImp(lib) : configImp;
     return new AkanLibConfig(lib, config);
   }

package/artifact/implicitRootLayout.test.ts

@@ -46,6 +46,8 @@ describe("resolveSsrPageEntries", () => {
     const generatedSource = await Bun.file(groupedRoot?.moduleAbsPath ?? "").text();
     expect(generatedSource).toContain('import * as inheritedLayout from "../../../page/_layout.tsx";');
     expect(generatedSource).not.toContain("<System.Provider");
+    expect(generatedSource).toContain("export const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;");
+    expect(generatedSource).toContain("export const Error = userLayout.Error ?? inheritedLayout.Error;");
     expect(generatedSource).toContain(
       "<UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>",
     );

package/artifact/implicitRootLayout.ts

@@ -135,8 +135,8 @@ async function writeGeneratedRootLayoutFile(opts: {
     ? `import UserLayout, * as userLayout from ${JSON.stringify(sourceSpecifier)};\n`
     : "const UserLayout = ({ children }) => children;\nconst userLayout = {};\n";
   const source = opts.includeSystemProvider
-    ? `import type { LayoutProps, PageProps } from "akanjs/client";\nimport { loadFonts } from "akanjs/client";\nimport { System } from "akanjs/ui";\nimport { env } from "@apps/${opts.appName}/env/env.client";\n${clientImport}${inheritedImport}${userImport}\nconst userFonts = userLayout.fonts ?? inheritedLayout.fonts ?? [];\nconst defaultFonts = userFonts.filter((font) => font.default);\nif (defaultFonts.length > 1) throw new Error("[route-convention] only one default font is allowed per root layout");\nconst defaultFont = defaultFonts[0];\nconst defaultFontClassName = defaultFont ? (defaultFont.className ?? \`font-\${defaultFont.name}\`) : undefined;\n\nexport async function generateHead(props: PageProps) {\n  if (userLayout.generateHead) return userLayout.generateHead(props);\n  if (userLayout.head !== undefined) return userLayout.head;\n  if (inheritedLayout.generateHead) return inheritedLayout.generateHead(props);\n  return inheritedLayout.head;\n}\n\nexport default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {\n  return (\n    <System.Provider\n      of={GeneratedLayout as never}\n      appName=${JSON.stringify(opts.appName)}\n      ${prefix ? `prefix=${JSON.stringify(prefix)}\n      ` : ""}params={params}\n      manifest={userLayout.manifest ?? inheritedLayout.manifest}\n      env={env}\n      theme={userLayout.theme ?? inheritedLayout.theme}\n      fonts={loadFonts(userFonts)}\n      className={defaultFontClassName}\n      gaTrackingId={userLayout.gaTrackingId ?? inheritedLayout.gaTrackingId}\n      layoutStyle={userLayout.layoutStyle ?? inheritedLayout.layoutStyle}\n      reconnect={userLayout.reconnect ?? inheritedLayout.reconnect ?? false}\n    >\n      <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>\n    </System.Provider>\n  );\n}\n`
-    : `import type { LayoutProps, PageProps } from "akanjs/client";\n${inheritedImport}${userImport}\nexport async function generateHead(props: PageProps) {\n  if (userLayout.generateHead) return userLayout.generateHead(props);\n  if (userLayout.head !== undefined) return userLayout.head;\n  if (inheritedLayout.generateHead) return inheritedLayout.generateHead(props);\n  return inheritedLayout.head;\n}\n\nexport default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {\n  return <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>;\n}\n`;
+    ? `import type { LayoutProps, PageProps } from "akanjs/client";\nimport { loadFonts } from "akanjs/client";\nimport { System } from "akanjs/ui";\nimport { env } from "@apps/${opts.appName}/env/env.client";\n${clientImport}${inheritedImport}${userImport}\nconst userFonts = userLayout.fonts ?? inheritedLayout.fonts ?? [];\nconst defaultFonts = userFonts.filter((font) => font.default);\nif (defaultFonts.length > 1) throw new Error("[route-convention] only one default font is allowed per root layout");\nconst defaultFont = defaultFonts[0];\nconst defaultFontClassName = defaultFont ? (defaultFont.className ?? \`font-\${defaultFont.name}\`) : undefined;\n\nexport async function generateHead(props: PageProps) {\n  if (userLayout.generateHead) return userLayout.generateHead(props);\n  if (userLayout.head !== undefined) return userLayout.head;\n  if (inheritedLayout.generateHead) return inheritedLayout.generateHead(props);\n  return inheritedLayout.head;\n}\n\nexport const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;\nexport const Error = userLayout.Error ?? inheritedLayout.Error;\n\nexport default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {\n  return (\n    <System.Provider\n      of={GeneratedLayout as never}\n      appName=${JSON.stringify(opts.appName)}\n      ${prefix ? `prefix=${JSON.stringify(prefix)}\n      ` : ""}params={params}\n      manifest={userLayout.manifest ?? inheritedLayout.manifest}\n      env={env}\n      theme={userLayout.theme ?? inheritedLayout.theme}\n      fonts={loadFonts(userFonts)}\n      className={defaultFontClassName}\n      gaTrackingId={userLayout.gaTrackingId ?? inheritedLayout.gaTrackingId}\n      layoutStyle={userLayout.layoutStyle ?? inheritedLayout.layoutStyle}\n      reconnect={userLayout.reconnect ?? inheritedLayout.reconnect ?? false}\n    >\n      <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>\n    </System.Provider>\n  );\n}\n`
+    : `import type { LayoutProps, PageProps } from "akanjs/client";\n${inheritedImport}${userImport}\nexport async function generateHead(props: PageProps) {\n  if (userLayout.generateHead) return userLayout.generateHead(props);\n  if (userLayout.head !== undefined) return userLayout.head;\n  if (inheritedLayout.generateHead) return inheritedLayout.generateHead(props);\n  return inheritedLayout.head;\n}\n\nexport const NotFound = userLayout.NotFound ?? inheritedLayout.NotFound;\nexport const Error = userLayout.Error ?? inheritedLayout.Error;\n\nexport default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {\n  return <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>;\n}\n`;
   await Bun.write(absPath, source);
   return absPath;
 }