@akanjs/devkit 3.0.0-beta.20 → 3.0.0-beta.21

package/README.ko.md

@@ -44,7 +44,7 @@ await runner.build();
 - Frontend build transform과 RSC/SSR artifact builder.
 - `@akanjs/cli`가 사용하는 command/script decorator.
 - AI prompt, guideline, code-generation 지원 utility.
-- Capacitor와 mobile release helper.
+- `@akanjs/native` 기반 네이티브 모바일 빌드(iOS, Android)와 스토어 release helper.
 
 ## 패키지 경계
 
@@ -58,7 +58,7 @@ await runner.build();
 
 - [Bun](https://bun.sh) `>=1.4.0`
 - TypeScript
-- Optional peer는 Capacitor integration처럼 해당 기능을 사용할 때만 필요합니다.
+- `react`는 optional peer이며, 렌더링하는 기능에서만 필요합니다.
 
 ## 라이선스
 

package/README.md

@@ -43,7 +43,7 @@ await runner.build();
 - Frontend build transforms and RSC/SSR artifact builders.
 - Command/script decorators used by `@akanjs/cli`.
 - AI prompt, guideline, and code-generation support utilities.
-- Capacitor and mobile release helpers.
+- Native mobile builds on `@akanjs/native` (iOS, Android) and store release helpers.
 - The `akan code` agent engine, the tools it is given, and the shipped akan skills (`@akanjs/devkit/codeAgent`).
 
 ## Dev Server Sizing
@@ -63,7 +63,7 @@ defaults, the shares they derive from `AKAN_MEMORY_LIMIT`, and what a small cont
 
 - [Bun](https://bun.sh) `>=1.4.0`
 - TypeScript
-- Optional peers are only needed for the features that use them, such as Capacitor integration.
+- `react` is an optional peer, needed only by the features that render.
 
 ## License
 

package/akanConfig/akanConfig.test.ts

@@ -175,7 +175,7 @@ describe("AkanAppConfig", () => {
   test("refuses a csr-less build that ships a mobile app", () => {
     expect(
       () => new AkanAppConfig(app, [], packageJson, { web: { csr: false }, mobile: { appName: "portal" } }, baseDevEnv),
-    ).toThrow("the Capacitor build ships that bundle");
+    ).toThrow("the mobile apps ship that bundle");
   });
 
   test("installs only ca-certificates and tzdata in the default image", () => {
@@ -356,43 +356,6 @@ describe("AkanAppConfig", () => {
     expect(config.getMissingDatabaseModeDependencySpecs("cluster")).toEqual([
       `postgres@${runtimeDependencies.postgres}`,
     ]);
-    // The workspace-root install covers the toolchain plus every app Capacitor plugin, deduped (`@capacitor/core`).
-    const expectedMobilePackages: string[] = [
-      "@capacitor/cli",
-      "@capacitor/core",
-      "@capacitor/ios",
-      "@capacitor/android",
-      "@capacitor/assets",
-      "@capacitor/app",
-      "@capacitor/browser",
-      "@capacitor/camera",
-      "@capacitor/device",
-      "@capacitor/geolocation",
-      "@capacitor/haptics",
-      "@capacitor/inappbrowser",
-      "@capacitor/keyboard",
-      "@capacitor/preferences",
-      "@capacitor/push-notifications",
-      "capacitor-plugin-safe-area",
-    ];
-    expect(config.getMobileRuntimePackages() as string[]).toEqual(expectedMobilePackages);
-    expect(config.getMissingMobileDependencySpecs()).toEqual(
-      expectedMobilePackages.map((lib) => `${lib}@${runtimeDependencies[lib as keyof typeof runtimeDependencies]}`),
-    );
-    expect(config.getMobileAppCapacitorPlugins()).toEqual([
-      "@capacitor/app",
-      "@capacitor/browser",
-      "@capacitor/camera",
-      "@capacitor/core",
-      "@capacitor/device",
-      "@capacitor/geolocation",
-      "@capacitor/haptics",
-      "@capacitor/inappbrowser",
-      "@capacitor/keyboard",
-      "@capacitor/preferences",
-      "@capacitor/push-notifications",
-      "capacitor-plugin-safe-area",
-    ]);
   });
 
   test("normalizes multiple mobile targets and validates base paths", () => {
@@ -459,6 +422,63 @@ describe("AkanAppConfig", () => {
     ).toThrow("unknown basePath");
   });
 
+  test("merges the mobile-wide files and native settings into each target, the target winning", () => {
+    const config = new AkanAppConfig(
+      app,
+      [],
+      packageJson,
+      {
+        mobile: {
+          fileName: "portal",
+          files: { "android/res/raw/chime.mp3": "assets/chime.mp3" },
+          native: {
+            plugins: ["iap"],
+            ios: { infoPlist: { ITSAppUsesNonExemptEncryption: false } },
+            android: { manifest: ["<queries/>"], googleServices: "secrets/google-services.json" },
+          },
+          targets: {
+            default: {
+              files: { "ios/sound.caf": "assets/sound.caf" },
+              native: { plugins: ["iap", "share"], android: { manifest: ["<uses-feature/>"] } },
+            },
+          },
+        },
+      },
+      baseDevEnv,
+    );
+
+    expect(config.mobile.targets.default).toMatchObject({
+      fileName: "portal",
+      files: { "android/res/raw/chime.mp3": "assets/chime.mp3", "ios/sound.caf": "assets/sound.caf" },
+      native: {
+        plugins: ["iap", "share"],
+        ios: { infoPlist: { ITSAppUsesNonExemptEncryption: false } },
+        android: { manifest: ["<queries/>", "<uses-feature/>"], googleServices: "secrets/google-services.json" },
+      },
+    });
+  });
+
+  test("refuses the Capacitor-era keys with the setting that replaces them", () => {
+    const make = (mobile: Record<string, unknown>) => () =>
+      new AkanAppConfig(app, [], packageJson, { mobile } as never, baseDevEnv);
+
+    expect(make({ plugins: { Keyboard: { resize: "none" } } })).toThrow(
+      "mobile.plugins in apps/portal/akan.config.ts is a Capacitor setting",
+    );
+    expect(make({ targets: { default: { ios: { scheme: "App" } } } })).toThrow(
+      "mobile.targets.default.ios in apps/portal/akan.config.ts is a Capacitor setting",
+    );
+    expect(make({ targets: { default: { files: { android: { "app/google-services.json": "x.json" } } } } })).toThrow(
+      "google-services.json goes to native.android.googleServices",
+    );
+    expect(make({ files: { "App/App/Info.plist": "x.plist" } })).toThrow(
+      "must land under ios/<path>, android/res/<type>/<file> or android/assets/<path>",
+    );
+    expect(make({ server: { url: "http://x" } })).toThrow(
+      "mobile.server in apps/portal/akan.config.ts is not a mobile setting",
+    );
+  });
+
   test("derives a repo-scoped default appId and records explicit-mobile intent", () => {
     // No mobile section: appId defaults to the repo-scoped reverse-DNS id, and mobile is not explicit.
     const withoutMobile = new AkanAppConfig(app, [], packageJson, {}, baseDevEnv);

package/akanConfig/akanConfig.ts

@@ -40,22 +40,6 @@ const DEFAULT_OPTIMIZE_IMPORTS = [
 const WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"] as const;
 const DEFAULT_DOCKER_IMAGE = "oven/bun:1-slim";
 const SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"] as const;
-// Optional peers only, so a fresh workspace never installs them; the mobile preflight adds them at the root.
-const MOBILE_RUNTIME_PACKAGES = [
-  "@capacitor/cli",
-  "@capacitor/core",
-  "@capacitor/ios",
-  "@capacitor/android",
-  "@capacitor/assets",
-] as const;
-// `npx cap sync` registers only plugins the app's own package.json declares (else the bridge throws `Capacitor plugin
-// "Device" is not available.`), so they are declared there with "*" and deduped to the root-installed version.
-const MOBILE_APP_CAPACITOR_PLUGINS = [
-  ..."app browser camera core device geolocation haptics inappbrowser keyboard preferences push-notifications"
-    .split(" ")
-    .map((name) => `@capacitor/${name}`),
-  "capacitor-plugin-safe-area",
-];
 const DEFAULT_AKAN_IMAGE_CONFIG: AkanImageConfig = {
   deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
   imageSizes: [32, 48, 64, 96, 128, 256, 384],
@@ -237,7 +221,7 @@ export class AkanAppConfig implements AppConfigResult {
     // `akan build-ios` / `build-android` copy `dist/apps/<app>/csr/<target>.html` into the native project.
     if (!resolved.csr && this.hasMobileConfig)
       throw new Error(
-        `apps/${this.app.name}/akan.config.ts turns the CSR bundle off but declares mobile targets; the Capacitor build ships that bundle. Drop the mobile section or leave CSR on.`,
+        `apps/${this.app.name}/akan.config.ts turns the CSR bundle off but declares mobile targets; the mobile apps ship that bundle. Drop the mobile section or leave CSR on.`,
       );
     return resolved;
   }
@@ -247,10 +231,14 @@ export class AkanAppConfig implements AppConfigResult {
       indexPath: _indexPath,
       ...rawMobile
     } = (mobile ?? {}) as DeepPartial<AkanMobileConfig> & { indexPath?: unknown };
+    const configPath = `apps/${this.app.name}/akan.config.ts`;
+    AkanAppConfig.#assertMobileKeys(rawMobile, AkanAppConfig.#mobileKeys, "mobile", configPath);
     const appName = rawMobile.appName ?? this.app.name;
     const appId = rawMobile.appId ?? deriveDefaultAppId(this.baseDevEnv.repoName, this.app.name);
     const version = rawMobile.version ?? "0.0.1";
     const buildNum = rawMobile.buildNum ?? 1;
+    const files = AkanAppConfig.#resolveMobileFiles(rawMobile.files as AkanMobileConfig["files"], "mobile", configPath);
+    const native = rawMobile.native as AkanMobileConfig["native"];
     const defaultTargetName = this.#defaultMobileTargetName(rawTargets);
     const targetEntries = Object.entries(
       rawTargets ?? {
@@ -259,52 +247,114 @@ export class AkanAppConfig implements AppConfigResult {
     );
     const targets = Object.fromEntries(
       targetEntries.map(([name, rawTarget]) => {
-        const target = rawTarget as DeepPartial<AkanMobileTargetConfig>;
+        const target = (rawTarget ?? {}) as DeepPartial<AkanMobileTargetConfig>;
+        const where = `mobile.targets.${name}`;
+        AkanAppConfig.#assertMobileKeys(target, AkanAppConfig.#targetKeys, where, configPath);
         const fallbackBasePath = !rawTargets && this.basePaths.has(name) ? name : undefined;
         const basePath = (target.basePath ?? fallbackBasePath)?.replace(/^\/+|\/+$/g, "") || undefined;
         const indexPath = normalizeIndexPath(target.indexPath as string | undefined);
         const deepLinks = normalizeDeepLinks(target.deepLinks);
         if (basePath && !this.basePaths.has(basePath)) {
-          throw new Error(
-            `Mobile target '${name}' uses unknown basePath '${basePath}' in apps/${this.app.name}/akan.config.ts`,
-          );
+          throw new Error(`Mobile target '${name}' uses unknown basePath '${basePath}' in ${configPath}`);
         }
+        const targetFiles = AkanAppConfig.#resolveMobileFiles(
+          target.files as AkanMobileTargetConfig["files"],
+          where,
+          configPath,
+        );
+        const fileName = (target.fileName ?? rawMobile.fileName) as string | undefined;
         const resolved = {
-          ...rawMobile,
-          ...target,
           name,
           basePath,
           indexPath,
           deepLinks,
           appName: target.appName ?? appName,
           appId: target.appId ?? appId,
+          ...(fileName ? { fileName } : {}),
           version: target.version ?? version,
           buildNum: target.buildNum ?? buildNum,
-          plugins: {
-            ...rawMobile.plugins,
-            ...target.plugins,
-          },
-          android: {
-            ...rawMobile.android,
-            ...target.android,
-          },
-          ios: {
-            ...rawMobile.ios,
-            ...target.ios,
-          },
+          ...(target.assets ? { assets: target.assets as AkanMobileTargetConfig["assets"] } : {}),
+          ...(target.permissions ? { permissions: target.permissions as AkanMobileTargetConfig["permissions"] } : {}),
+          ...(files || targetFiles ? { files: { ...files, ...targetFiles } } : {}),
+          ...(native || target.native
+            ? { native: AkanAppConfig.#mergeNative(native, target.native as AkanMobileTargetConfig["native"]) }
+            : {}),
         } satisfies AkanMobileTargetConfig;
         return [name, resolved];
       }),
     );
     return {
-      ...rawMobile,
       appName,
       appId,
+      ...(rawMobile.fileName ? { fileName: rawMobile.fileName as string } : {}),
       version,
       buildNum,
+      ...(files ? { files } : {}),
+      ...(native ? { native } : {}),
       targets,
-      plugins: rawMobile.plugins,
-    } as AkanMobileConfig;
+    };
+  }
+  static readonly #mobileKeys = ["appName", "appId", "fileName", "version", "buildNum", "files", "native"];
+  static readonly #targetKeys = [
+    "basePath",
+    "indexPath",
+    "appName",
+    "appId",
+    "fileName",
+    "version",
+    "buildNum",
+    "assets",
+    "permissions",
+    "deepLinks",
+    "files",
+    "native",
+  ];
+  //* The Capacitor keys used to pass straight through; the native runtime takes typed ones, so a leftover is refused.
+  static #assertMobileKeys(section: object, known: string[], where: string, configPath: string) {
+    for (const key of Object.keys(section)) {
+      if (known.includes(key)) continue;
+      if (key === "plugins" || key === "ios" || key === "android")
+        throw new Error(
+          `${where}.${key} in ${configPath} is a Capacitor setting. The native runtime reads native.plugins, native.ios.{infoPlist,entitlements} and native.android.{manifest,application,activity,googleServices} instead.`,
+        );
+      throw new Error(`${where}.${key} in ${configPath} is not a mobile setting. Known: ${known.join(", ")}.`);
+    }
+  }
+  static readonly #fileTargetPattern = /^(?:ios\/.+|android\/res\/[^/]+\/[^/]+|android\/assets\/.+)$/;
+  static #resolveMobileFiles(files: AkanMobileTargetConfig["files"] | undefined, where: string, configPath: string) {
+    if (!files) return undefined;
+    for (const [to, from] of Object.entries(files)) {
+      if (typeof from !== "string")
+        throw new Error(
+          `${where}.files in ${configPath} maps where a file lands to its source now, e.g. { "android/res/raw/chime.mp3": "assets/chime.mp3" }. google-services.json goes to native.android.googleServices, and GoogleService-Info.plist is no longer needed.`,
+        );
+      if (!AkanAppConfig.#fileTargetPattern.test(to))
+        throw new Error(
+          `${where}.files["${to}"] in ${configPath} must land under ios/<path>, android/res/<type>/<file> or android/assets/<path>.`,
+        );
+    }
+    return files;
+  }
+  static #mergeNative(
+    base: AkanMobileTargetConfig["native"],
+    override: AkanMobileTargetConfig["native"],
+  ): NonNullable<AkanMobileTargetConfig["native"]> {
+    const plugins = [...new Set([...(base?.plugins ?? []), ...(override?.plugins ?? [])])];
+    const ios = { ...base?.ios, ...override?.ios };
+    const android: NonNullable<NonNullable<AkanMobileTargetConfig["native"]>["android"]> = {
+      ...base?.android,
+      ...override?.android,
+    };
+    for (const key of ["manifest", "application", "activity"] as const) {
+      const merged = [...(base?.android?.[key] ?? []), ...(override?.android?.[key] ?? [])];
+      if (merged.length) android[key] = merged;
+      else delete android[key];
+    }
+    return {
+      ...(plugins.length ? { plugins } : {}),
+      ...(Object.keys(ios).length ? { ios } : {}),
+      ...(Object.keys(android).length ? { android } : {}),
+    };
   }
   #defaultMobileTargetName(rawTargets: DeepPartial<AkanMobileConfig>["targets"] | undefined) {
     if (rawTargets && Object.keys(rawTargets).length > 0) return Object.keys(rawTargets)[0] as string;
@@ -480,16 +530,6 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     const modes = declared?.length ? declared : ["single"];
     return { modes: DatabaseModes.parseList(modes.join(","), `database.modes in apps/${app.name}/akan.config.ts`) };
   }
-  getMobileRuntimePackages() {
-    // Installed at the root too, so the app's "*" declarations resolve to the hoisted, peer-pinned version.
-    return [...new Set([...MOBILE_RUNTIME_PACKAGES, ...MOBILE_APP_CAPACITOR_PLUGINS])];
-  }
-  getMissingMobileDependencySpecs() {
-    return this.#getMissingDependencySpecs(this.getMobileRuntimePackages());
-  }
-  getMobileAppCapacitorPlugins() {
-    return [...MOBILE_APP_CAPACITOR_PLUGINS];
-  }
   #getMissingDependencySpecs(libs: readonly string[]) {
     const rootDependencies = {
       ...this.rootPackageJson.dependencies,

package/akanConfig/types.ts

@@ -5,10 +5,11 @@ export type {
   AkanDatabaseConfig,
   AkanExecutor,
   AkanMobileConfig,
+  AkanMobileNativeConfig,
   AkanMobileTargetConfig,
-  AkanNativeContext,
+  AkanNativeValue,
   AkanPlugin,
-  AkanPluginCapacitorConfig,
+  AkanPluginNativeConfig,
   AkanRouteConfig,
   AkanScanInfo,
   AkanSyncContext,
@@ -35,7 +36,6 @@ export type {
   MobileEnv,
   MobilePermission,
   PkgScanResult,
-  PluginRuntimeContext,
   ScanResult,
   WorkspaceScanResult,
 } from "akanjs";

package/akanContext.ts

@@ -16,7 +16,7 @@ import {
   workflowRunArtifactPath,
   workflowSyncDir,
 } from "./workflow";
-import { isScannedRootEntry, rootAllowedDirs, rootAllowedFiles } from "./workspaceLayout";
+import { isScannedRootEntry, rootAllowedDirs, rootAllowedFiles, rootEntryHintOf } from "./workspaceLayout";
 
 export type AkanContextFormat = "json" | "markdown";
 export type AkanModuleKind = "domain" | "service" | "scalar";
@@ -657,13 +657,16 @@ export class AkanContextAnalyzer {
         const allowed = entry.isDirectory()
           ? rootAllowedDirs[sys.type].has(entry.name)
           : rootAllowedFiles[sys.type].has(entry.name);
+        const rootEntryHint = rootEntryHintOf(sys.type, entry.name);
         if (!allowed)
           report(
             {
               severity: "error",
               code: `${sys.type}-root-unknown-entry`,
               path: `${sys.path}/${entry.name}`,
-              message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in ${sys.type} root: ${sys.path}/${entry.name}`,
+              message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in ${sys.type} root: ${sys.path}/${entry.name}${
+                rootEntryHint ? ` (${rootEntryHint})` : ""
+              }`,
             },
             repairAction(
               "module-shape",

package/artifact/implicitRootLayout.test.ts

@@ -150,4 +150,27 @@ describe("resolveSsrPageEntries", () => {
     expect(generatedSource).toContain("? await UserLayout({ params, searchParams, children })");
     expect(generatedSource).toContain("  return layout;\n}");
   });
+
+  test("prunes generated wrappers whose route file moved away", async () => {
+    const appRoot = await makeTempRoot();
+    const pageRoot = path.join(appRoot, "page");
+    await write(path.join(appRoot, "env", "env.client.ts"), "export const env = {};\n");
+    await write(path.join(pageRoot, "a", "_overrides.tsx"), "export default {};\n");
+    await write(path.join(pageRoot, "b", "_overrides.tsx"), "export default {};\n");
+    await write(path.join(pageRoot, "(home)", "_layout.tsx"), "export default ({ children }) => children;\n");
+    const resolve = async (pageKeys: string[]) =>
+      await resolveSsrPageEntries({ appCwdPath: appRoot, appName: "demo", pageKeys });
+    const generatedPaths = async (pageKeys: string[]) =>
+      (await resolve(pageKeys))
+        .filter((entry) => entry.moduleAbsPath.includes(`${path.sep}.akan${path.sep}`))
+        .map((entry) => entry.moduleAbsPath);
+
+    const before = await generatedPaths(["./(home)/_layout.tsx", "./a/_overrides.tsx", "./a/x.tsx"]);
+    const after = await generatedPaths(["./b/_overrides.tsx", "./b/y.tsx"]);
+
+    expect(before).toHaveLength(2);
+    for (const stale of before) expect(await Bun.file(stale).exists()).toBe(false);
+    expect(after).toHaveLength(2);
+    for (const fresh of after) expect(await Bun.file(fresh).exists()).toBe(true);
+  });
 });

package/artifact/implicitRootLayout.ts

@@ -1,3 +1,4 @@
+import { readdir, rm } from "node:fs/promises";
 import path from "node:path";
 import type { App } from "../commandDecorators";
 import { AsyncDefaultExportDetector } from "../transforms/asyncDefaultExportDetector";
@@ -41,6 +42,17 @@ export default function AkanUiOverridesLayout({ children }: { children?: ReactNo
   return absPath;
 }
 
+async function pruneGeneratedFiles(dirAbsPath: string, keepAbsPaths: string[]): Promise<void> {
+  const keep = new Set(keepAbsPaths);
+  const names = await readdir(dirAbsPath).catch(() => [] as string[]);
+  await Promise.all(
+    names
+      .map((name) => path.join(dirAbsPath, name))
+      .filter((absPath) => !keep.has(absPath))
+      .map((absPath) => rm(absPath, { force: true })),
+  );
+}
+
 interface RootBoundary {
   sourceKey: string | null;
   sourceAbsPath: string | null;
@@ -283,6 +295,18 @@ export async function resolveSsrPageEntries(opts: {
       seedAbsPaths: [...new Set([boundary.sourceAbsPath, rootSourceAbsPath].filter((absPath) => absPath !== null))],
     })),
   );
+  //? A moved `_overrides.tsx` or root layout leaves a wrapper importing a file that is gone.
+  const appCwdAbsPath = path.resolve(opts.appCwdPath);
+  await Promise.all([
+    pruneGeneratedFiles(
+      path.join(appCwdAbsPath, IMPLICIT_OVERRIDES_DIR),
+      base.filter(({ key }) => OVERRIDES_KEY_RE.test(key)).map(({ moduleAbsPath }) => moduleAbsPath),
+    ),
+    pruneGeneratedFiles(
+      path.join(appCwdAbsPath, IMPLICIT_LAYOUT_DIR),
+      generated.map(({ moduleAbsPath }) => moduleAbsPath),
+    ),
+  ]);
   return [...base, ...generated].sort((a, b) => a.key.localeCompare(b.key));
 }
 

package/biome.base.json

@@ -206,6 +206,32 @@
       ],
       "plugins": ["./node_modules/@akanjs/devkit/lint/no-init-fetch-in-client.grit"]
     },
+    {
+      "includes": [
+        "{apps,libs}/**/*.ts",
+        "{apps,libs}/**/*.tsx",
+        "!**/*.test.ts",
+        "!**/*.test.tsx",
+        "!**/*.spec.ts",
+        "!**/*.spec.tsx"
+      ],
+      "plugins": [
+        "./node_modules/@akanjs/devkit/lint/no-document-cookie.grit",
+        "./node_modules/@akanjs/devkit/lint/no-web-storage.grit"
+      ]
+    },
+    {
+      "includes": [
+        "{apps,libs}/**/*.ts",
+        "{apps,libs}/**/*.tsx",
+        "!{apps,libs}/**/webkit/**",
+        "!**/*.test.ts",
+        "!**/*.test.tsx",
+        "!**/*.spec.ts",
+        "!**/*.spec.tsx"
+      ],
+      "plugins": ["./node_modules/@akanjs/devkit/lint/no-web-only-api-outside-webkit.grit"]
+    },
     {
       "includes": [
         "**/ui/**/*.ts",

package/commandDecorators/command.ts

@@ -10,7 +10,7 @@ import chalk from "chalk";
 import { type Command, program } from "commander";
 import { AppSelectionMemory } from "../appSelectionMemory";
 import { AppExecutor, Executor, LibExecutor, ModuleExecutor, PkgExecutor, WorkspaceExecutor } from "../executors";
-// Never the root barrel: it drags ink, @trapezedev/project, ssh2 and the cloud stack into every command process.
+// Never the root barrel: it drags ink, ssh2 and the cloud stack into every command process.
 import { FileSys, getDirname } from "../fileSys";
 import type { PackageJson } from "../types";
 import {

package/executors.ts

@@ -21,7 +21,7 @@ import {
 } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
-import type { AkanPlugin, AkanSyncContext, PluginRuntimeContext } from "akanjs";
+import type { AkanPlugin, AkanSyncContext } from "akanjs";
 import {
   capitalize,
   getPageSourceFileViolation,
@@ -1480,17 +1480,6 @@ export class AppExecutor extends SysExecutor {
       return true;
     });
   }
-  async getPluginRuntimePackages(): Promise<string[]> {
-    const plugins = await this.collectPlugins();
-    const appConfig = await this.getConfig();
-    const ctx: PluginRuntimeContext = {
-      appName: this.name,
-      mobile: appConfig.mobile,
-      hasMobilePermission: (permission) =>
-        Object.values(appConfig.mobile.targets).some((target) => target.permissions?.includes(permission) ?? false),
-    };
-    return [...new Set(plugins.flatMap((plugin) => plugin.runtimePackages?.(ctx) ?? []))];
-  }
   async increaseBuildNum() {
     await increaseBuildNum(this);
   }

package/incrementalBuilder/buildBatch.proc.ts

@@ -1,5 +1,7 @@
 import path from "node:path";
 import { ApplicationBuildReporter } from "@akanjs/devkit/applicationBuildReporter";
+import { resolveSsrPageEntriesForApp } from "@akanjs/devkit/artifact/implicitRootLayout";
+import { computeRouteSeedIndex, saveRouteSeedIndex } from "@akanjs/devkit/artifact/routeSeedIndex";
 import type { App } from "@akanjs/devkit/commandDecorators";
 // Subpath imports only, as few as possible: spawned per generation, this process pays every import on every save.
 import { AppExecutor, WorkspaceExecutor } from "@akanjs/devkit/executors";
@@ -86,10 +88,14 @@ class BuildBatch {
     }
   }
 
+  // Rewritten with the bundle: the backend rereads it on `pages-updated` to pick up added, moved or deleted routes.
   async #buildPages(): Promise<void> {
     const started = Date.now();
     try {
-      const next = await new PagesBundleBuilder(this.#app).build();
+      const pageEntries = await resolveSsrPageEntriesForApp(this.#app, await this.#app.getPageKeys());
+      const seedIndex = computeRouteSeedIndex(pageEntries);
+      const next = await new PagesBundleBuilder(this.#app, "start", pageEntries).build();
+      await saveRouteSeedIndex(this.#request.artifactDir, seedIndex);
       this.#emit({
         type: "pages-updated",
         data: {

package/index.ts

@@ -7,10 +7,8 @@ export type * from "./akanContext";
 export type * from "./akanMcpContract";
 export type * from "./applicationBuildReporter";
 export type * from "./applicationBuildRunner";
-export type * from "./applicationReleasePackager";
 export type * from "./applicationTestPreload";
 export type * from "./artifact";
-export type * from "./capacitorApp";
 export type * from "./cloud";
 export type * from "./codeAgent";
 export type * from "./commandDecorators";

package/lint/__fixtures__/no-document-cookie/bad.tsx

@@ -0,0 +1,4 @@
+export const readTheme = () => document.cookie; // @flag
+export const writeTheme = (value: string) => { document.cookie = `theme=${value}`; }; // @flag
+export const throughWindow = () => window.document.cookie; // @flag
+export const throughGlobalThis = () => globalThis.document.cookie; // @flag

package/lint/__fixtures__/no-document-cookie/good.tsx

@@ -0,0 +1,7 @@
+import { getCookie, setCookie } from "akanjs/client";
+export const readTheme = () => getCookie("theme"); // @ok
+export const writeTheme = (value: string) => setCookie("theme", value); // @ok
+export const otherDocumentFields = () => document.title; // @ok
+export const aFieldNamedCookie = (req: { cookie: string }) => req.cookie; // @ok
+export const aLiteral = "document.cookie is empty on app://"; // @ok
+export const Docs = () => <p>getCookie reads the request, document.cookie the browser.</p>; // @ok

package/lint/__fixtures__/no-web-only-api-outside-webkit/bad.tsx

@@ -0,0 +1,7 @@
+export const share = (url: string) => navigator.share({ url }); // @flag
+export const canShare = () => typeof navigator.canShare === "function"; // @flag
+export const worker = () => navigator.serviceWorker.register("/sw.js"); // @flag
+export const ask = () => Notification.requestPermission(); // @flag
+export const permission = () => Notification.permission; // @flag
+export const locate = () => navigator.geolocation.getCurrentPosition(() => undefined); // @flag
+export const buzz = () => navigator.vibrate(50); // @flag

package/lint/__fixtures__/no-web-only-api-outside-webkit/good.tsx

@@ -0,0 +1,11 @@
+import { haptics } from "akanjs/client/native";
+import { useGeoLocation } from "akanjs/webkit";
+export const buzz = () => haptics.impact(); // @ok
+export const locate = () => useGeoLocation(); // @ok
+export const languages = () => navigator.languages; // @ok
+export const clipboard = (text: string) => navigator.clipboard.writeText(text); // @ok
+export const aField = (payload: { share: boolean }) => payload.share; // @ok
+export const aLiteral = "navigator.share is missing on Android"; // @ok
+export const Docs = () => <p>navigator.share is missing on Android.</p>; // @ok
+export const ModelZone = () => <Notification.Zone.Initialize />; // @ok
+export const model = (cnst: { Notification: unknown }) => cnst.Notification; // @ok

package/lint/__fixtures__/no-web-storage/bad.tsx

@@ -0,0 +1,6 @@
+export const readDraft = () => localStorage.getItem("draft"); // @flag
+export const writeDraft = (value: string) => localStorage.setItem("draft", value); // @flag
+export const readTab = () => sessionStorage.getItem("tab"); // @flag
+export const throughWindow = () => window.localStorage.getItem("draft"); // @flag
+export const throughGlobalThis = () => globalThis.sessionStorage.clear(); // @flag
+export const guarded = () => (typeof localStorage === "undefined" ? null : 1); // @flag

package/lint/__fixtures__/no-web-storage/good.tsx

@@ -0,0 +1,7 @@
+import { secretStorage, storage } from "akanjs/client";
+export const readDraft = () => storage.getItem("draft"); // @ok
+export const keepToken = (jwt: string) => secretStorage.setItem("jwt", jwt); // @ok
+export const aFieldWithTheName = (cache: { localStorage: string }) => cache.localStorage; // @ok
+export const anObjectKey = { sessionStorage: false }; // @ok
+export const aLiteral = "localStorage works in the shells"; // @ok
+export const Docs = () => <p>window.localStorage and sessionStorage work in the shells.</p>; // @ok