akanjs 3.0.0-beta.29 → 3.0.0-beta.30

package/README.ko.md

@@ -57,7 +57,7 @@ const config: AppConfig = {};
 export default config;
 ```
 
-프로덕션 앱은 `akan.config.ts`에서 routes, base paths, domains, mobile metadata, deployment options로
+프로덕션 앱은 `akan.config.ts`에서 routes, base paths, domains, native app settings, deployment options로
 자연스럽게 확장됩니다.
 
 ## 오래 읽히는 코드
@@ -66,7 +66,7 @@ Akan은 오래 운영되는 애플리케이션을 이해하기 쉽게 유지하
 가능한 형태로 둡니다.
 
 - **하나의 설정 표면**: `akan.config.ts`가 앱 단위 설정의 중심입니다. routes, domains, base paths,
-  mobile settings, deployment options가 필요해질 때까지 비워둘 수 있습니다.
+  native app settings, deployment options가 필요해질 때까지 비워둘 수 있습니다.
 - **모노리포 기반 재사용**: shared library와 domain module이 기본 단위이므로 검증된 비즈니스 코드를
   앱마다 다시 만들지 않고 함께 사용할 수 있습니다.
 - **엄격한 구조, 익숙한 코드**: 파일 위치, 파일명, 선언 방식, module boundary가 워크스페이스 전반에서
@@ -229,7 +229,7 @@ akan update
 ## 애플리케이션 설정
 
 `akan.config.ts`는 앱 단위 설정의 중심입니다. 단순한 앱에서는 비어 있을 수 있고, 필요할 때만
-routes, domains, base paths, mobile settings로 확장됩니다.
+routes, domains, base paths, native app settings로 확장됩니다.
 
 ```ts
 import type { AppConfig } from "akanjs";
@@ -239,7 +239,8 @@ const config: AppConfig = {
     { domains: { main: ["example.com", "www.example.com"] }, basePath: "web" },
     { domains: {}, basePath: "app" },
   ],
-  mobile: {
+  native: {
+    basePath: "app",
     appName: "Example",
     appId: "com.example.app",
     version: "1.0.0",

package/README.md

@@ -56,7 +56,7 @@ const config: AppConfig = {};
 export default config;
 ```
 
-Production apps can grow into routes, base paths, domains, mobile metadata, and deployment options through
+Production apps can grow into routes, base paths, domains, native app settings, and deployment options through
 `akan.config.ts`.
 
 ## Readable By Design
@@ -64,7 +64,7 @@ Production apps can grow into routes, base paths, domains, mobile metadata, and
 Akan keeps long-lived applications understandable by making the important decisions explicit and repeatable.
 
 - **One configuration surface**: `akan.config.ts` is the app-level control plane. It can stay empty until the
-  app actually needs routes, domains, base paths, mobile settings, or deployment options.
+  app actually needs routes, domains, base paths, native app settings, or deployment options.
 - **Monorepo-native reuse**: shared libraries and domain modules are first-class, so validated business code can
   be reused without rebuilding the same wheel in each app.
 - **Strict structure, familiar code**: file locations, names, declarations, and module boundaries follow the same
@@ -227,7 +227,7 @@ Common areas:
 ## Application Configuration
 
 `akan.config.ts` is the single place for app-level configuration. It can be empty for simple apps, then
-grow only when the app needs routes, domains, base paths, or mobile settings.
+grow only when the app needs routes, domains, base paths, or native app settings.
 
 ```ts
 import type { AppConfig } from "akanjs";
@@ -237,7 +237,8 @@ const config: AppConfig = {
     { domains: { main: ["example.com", "www.example.com"] }, basePath: "web" },
     { domains: {}, basePath: "app" },
   ],
-  mobile: {
+  native: {
+    basePath: "app",
     appName: "Example",
     appId: "com.example.app",
     version: "1.0.0",

package/index.ts

@@ -99,79 +99,24 @@ export interface AkanAssetsConfig {
 export type LibAssetsConfig = Pick<AkanAssetsConfig, "keepFonts">;
 
 export type DatabaseMode = "single" | "multiple" | "cluster";
-export type MobileEnv = "local" | "debug" | "develop" | "main";
-export type MobilePermission = "camera" | "contacts" | "location" | "push" | "speech";
+export type NativeEnv = "local" | "debug" | "develop" | "main";
+export type NativePermission = "camera" | "contacts" | "location" | "push" | "speech";
 
-export interface AkanMobileTargetAssets {
-  /** A square PNG, relative to the app folder, or it with the color behind its transparent areas. */
-  icon?: string | { image: string; backgroundColor?: string };
-  /** A PNG shown centered at launch, or the launch screen's color, image and when it hides. */
-  splash?: string | NonNullable<AkanNativeConfig["splash"]>;
-}
-
-export interface AkanMobileTargetDeepLinks {
-  schemes?: string[];
-  domains?: string[];
-  ios?: {
-    teamId?: string;
-  };
-  android?: {
-    sha256CertFingerprints?: string[];
-  };
-}
+export type AkanNativeValue = string | number | boolean | AkanNativeValue[] | { [key: string]: AkanNativeValue };
 
 /**
- * Files copied into the app, keyed by where they land: `ios/<path>` (the app bundle), `android/res/<type>/<file>` or
- * `android/assets/<path>`. The value is the source, relative to the app folder.
+ * One bundle id, or one per platform, for an app whose store listings already carry different ids. A platform without
+ * its own takes `default`.
  */
-export type AkanMobileTargetFiles = Record<string, string>;
-
-export type AkanNativeValue = string | number | boolean | AkanNativeValue[] | { [key: string]: AkanNativeValue };
+export type AkanNativeAppId =
+  | string
+  | { default?: string; ios?: string; android?: string; macos?: string; windows?: string; linux?: string };
 
-export interface AkanMobileNativeConfig {
-  /** Native runtime plugins beyond the ones the permissions bring, by builtin id (`"iap"`) or absolute folder. */
-  plugins?: string[];
-  ios?: {
-    infoPlist?: Record<string, AkanNativeValue>;
-    entitlements?: Record<string, AkanNativeValue>;
-  };
-  android?: {
-    /** XML at the `<manifest>` level; `${applicationId}` is replaced. */
-    manifest?: string[];
-    /** XML inside `<application>`. */
-    application?: string[];
-    /** XML inside the app's activity. */
-    activity?: string[];
-    /** The Firebase project's google-services.json, relative to the app folder, for FCM push on Android. */
-    googleServices?: string;
-    /** Media plays with sound without a tap first, as it does on iOS and the desktop: a signage screen. */
-    autoplay?: boolean;
-  };
-  /** Android's notification channel, status bar icon (relative to the app folder) and accent color. */
-  push?: AkanNativeConfig["push"];
-  /** The app's part of the iOS privacy manifest (PrivacyInfo.xcprivacy), which an App Store upload requires. */
-  privacy?: AkanNativeConfig["privacy"];
-  desktop?: {
-    /**
-     * The desktop app carries the app's server (API only, database mode single, on loopback) and its pages call
-     * nothing else. `build-desktop`, `start-desktop` and `publish-update` all read it, and an installed app refuses
-     * a release that carries a server when it has none, or none when it has one.
-     */
-    server?: boolean;
-    /**
-     * `"reload"`: a window whose page's process ends (a crash, a hang) loads it again every time, waiting
-     * longer after each end in a row, and the app relaunches when the webview's browser process ends — for an
-     * app nobody attends. `"errorPage"` (default): one reload, then an error page, and a quit for the browser.
-     */
-    recovery?: "errorPage" | "reload";
-    /** The main window from its first frame: borderless fullscreen, and no taskbar button (Windows, Linux). */
-    window?: { fullscreen?: boolean; skipTaskbar?: boolean };
-    /**
-     * Windows: `"auto"` answers getDisplayMedia() with the first screen at once, no picker or gesture — remote
-     * support on an unattended screen; it covers every media request, so not for an app that asks for a camera.
-     */
-    screenCapture?: "picker" | "auto";
-  };
+export interface AkanNativeDeepLinks {
+  /** Custom URL schemes the app opens (`board://…`). */
+  schemes?: string[];
+  /** Hosts whose https links open the app: universal links (iOS, `ios.teamId`) and app links (Android). */
+  domains?: string[];
 }
 
 /**
@@ -179,7 +124,7 @@ export interface AkanMobileNativeConfig {
  * desktop, the web bundle on a phone. `akan publish-update` writes and signs a release with a key on this machine;
  * `akan pack-update` writes an unsigned phone bundle for whoever holds the key to sign.
  */
-export interface AkanMobileUpdatesConfig {
+export interface AkanNativeUpdatesConfig {
   /**
    * A static base URL, https in a release build: `<url>/<os>-<arch>/<channel>.json` (desktop) or `<url>/<platform>/…`
    * (a phone's web bundle).
@@ -196,43 +141,115 @@ export interface AkanMobileUpdatesConfig {
   readyTimeout?: number;
 }
 
+export interface AkanNativeIosConfig {
+  /** The Apple team id: the universal links of `deepLinks.domains` (apple-app-site-association). */
+  teamId?: string;
+  infoPlist?: Record<string, AkanNativeValue>;
+  entitlements?: Record<string, AkanNativeValue>;
+  /** The app's part of the iOS privacy manifest (PrivacyInfo.xcprivacy), which an App Store upload requires. */
+  privacy?: AkanNativeConfig["privacy"];
+  /** Files copied into the app bundle, keyed by their path there; the value is the source, relative to the app folder. */
+  files?: Record<string, string>;
+}
+
+export interface AkanNativeAndroidConfig {
+  /** The signing certificates' SHA-256 fingerprints: the app links of `deepLinks.domains` (assetlinks.json). */
+  sha256CertFingerprints?: string[];
+  /** The Firebase project's google-services.json, relative to the app folder, for FCM push. */
+  googleServices?: string;
+  /** The notification channel, status bar icon (relative to the app folder) and accent color of pushes. */
+  push?: NonNullable<AkanNativeConfig["push"]>["android"];
+  /** Media plays with sound without a tap first, as it does on iOS and the desktop: a signage screen. */
+  autoplay?: boolean;
+  /** XML at the `<manifest>` level; `${applicationId}` is replaced. */
+  manifest?: string[];
+  /** XML inside `<application>`. */
+  application?: string[];
+  /** XML inside the app's activity. */
+  activity?: string[];
+  /** Files copied into the app, keyed `res/<type>/<file>` or `assets/<path>`; the value is the source. */
+  files?: Record<string, string>;
+}
+
+export interface AkanNativeDesktopConfig {
+  /**
+   * The desktop app carries the app's server (API only, database mode single, on loopback) and its pages call
+   * nothing else. `build-desktop`, `start-desktop` and `publish-update` all read it, and an installed app refuses
+   * a release that carries a server when it has none, or none when it has one.
+   */
+  server?: boolean;
+  /**
+   * `"reload"`: a window whose page's process ends (a crash, a hang) loads it again every time, waiting
+   * longer after each end in a row, and the app relaunches when the webview's browser process ends — for an
+   * app nobody attends. `"errorPage"` (default): one reload, then an error page, and a quit for the browser.
+   */
+  recovery?: "errorPage" | "reload";
+  /** The main window from its first frame: borderless fullscreen, and no taskbar button (Windows, Linux). */
+  window?: { fullscreen?: boolean; skipTaskbar?: boolean };
+  /**
+   * Windows: `"auto"` answers getDisplayMedia() with the first screen at once, no picker or gesture — remote
+   * support on an unattended screen; it covers every media request, so not for an app that asks for a camera.
+   */
+  screenCapture?: "picker" | "auto";
+}
+
 /**
- * One bundle id, or one per platform, for an app whose store listings already carry different ids. A platform without
- * its own takes `default`.
+ * What a native app (iOS, Android, desktop) is: the app's `native` section and each of its targets have this shape. A
+ * target takes the section and overrides it field by field: objects merge key by key, and any other value — a list
+ * included — replaces the section's.
  */
-export type AkanMobileAppId =
-  | string
-  | { default?: string; ios?: string; android?: string; macos?: string; windows?: string; linux?: string };
-
-export interface AkanMobileTargetConfig {
-  name: string;
+export interface AkanNativeSettings {
+  /** The client the app opens, a basePath the routes declare; an app without basePaths leaves it out. */
   basePath?: string;
+  /** Where the app starts, and falls back to for a deep link's stack and a back with no history. Default `/`. */
   indexPath?: string;
-  appName: string;
-  appId: AkanMobileAppId;
+  /** Default: the app's folder name. */
+  appName?: string;
+  /** Default: one made from the repository's and the app's names. */
+  appId?: AkanNativeAppId;
   /** Executables, archives and the Swift module; letters, digits, `.`, `_` and `-`. Default: the app's folder name. */
   fileName?: string;
+  /** Default `0.0.1`. */
+  version?: string;
+  /** Default 1. */
+  buildNum?: number;
+  /** A square PNG, relative to the app folder, or it with the color behind its transparent areas. */
+  icon?: string | { image: string; backgroundColor?: string };
+  /** A PNG shown centered at launch, or the launch screen's color, image and when it hides. */
+  splash?: string | NonNullable<AkanNativeConfig["splash"]>;
+  permissions?: NativePermission[];
+  /** Native runtime plugins beyond the ones the permissions bring: a builtin id (`"iap"`) or a folder, from the app's. */
+  plugins?: string[];
+  deepLinks?: AkanNativeDeepLinks;
+  updates?: Partial<AkanNativeUpdatesConfig>;
+  ios?: AkanNativeIosConfig;
+  android?: AkanNativeAndroidConfig;
+  desktop?: AkanNativeDesktopConfig;
+}
+
+/** `native` in akan.config.ts. Without `targets` the app has one target, named `default`. */
+export interface AkanNativeAppConfig extends AkanNativeSettings {
+  targets?: Record<string, AkanNativeSettings>;
+}
+
+/** One target of the app, its fields over the app's `native` section and the defaults. */
+export interface AkanNativeTarget
+  extends Omit<AkanNativeSettings, "appName" | "appId" | "version" | "buildNum" | "updates"> {
+  name: string;
+  appName: string;
+  appId: AkanNativeAppId;
   version: string;
   buildNum: number;
-  assets?: AkanMobileTargetAssets;
-  permissions?: MobilePermission[];
-  deepLinks?: AkanMobileTargetDeepLinks;
-  files?: AkanMobileTargetFiles;
-  native?: AkanMobileNativeConfig;
-  /** Over mobile.updates, field by field: a pilot target names its own channel. */
-  updates?: Partial<AkanMobileUpdatesConfig>;
+  updates?: AkanNativeUpdatesConfig;
 }
 
-export interface AkanMobileConfig {
+export interface AkanNativeAppResult {
   appName: string;
-  appId: AkanMobileAppId;
+  appId: AkanNativeAppId;
   fileName?: string;
   version: string;
   buildNum: number;
-  files?: AkanMobileTargetFiles;
-  native?: AkanMobileNativeConfig;
-  updates?: AkanMobileUpdatesConfig;
-  targets: Record<string, AkanMobileTargetConfig>;
+  targets: Record<string, AkanNativeTarget>;
 }
 
 export interface AkanScanInfo {
@@ -271,9 +288,9 @@ export interface AkanSyncContext {
   readEnvClient(): Promise<Record<string, unknown> | null>;
 }
 
-/** What a plugin adds to a mobile app whose target asks for its permission; the native build merges every one. */
+/** What a plugin adds to a native app whose target asks for its permission; the native build merges every one. */
 export interface AkanPluginNativeConfig {
-  permission: MobilePermission;
+  permission: NativePermission;
   /** Native runtime plugins, by builtin id (`"camera"`). */
   plugins?: string[];
   /** iOS usage texts by description name (`cameraUsageDescription`); `$(PRODUCT_NAME)` becomes the app name. */
@@ -335,7 +352,7 @@ export interface AppConfigResult {
   images: AkanImageConfig;
   i18n: AkanI18nConfig;
   publicEnv: string[];
-  mobile: AkanMobileConfig;
+  native: AkanNativeAppResult;
   secrets: string[];
   assets: AkanAssetsConfig;
 }
@@ -365,10 +382,11 @@ export interface LibConfigContext {
   readonly type: "lib";
 }
 
-export type AppConfigInput = Omit<DeepPartial<AppConfigResult>, "docker" | "web" | "bin"> & {
+export type AppConfigInput = Omit<DeepPartial<AppConfigResult>, "docker" | "web" | "bin" | "native"> & {
   docker?: DockerOption;
   web?: AkanWebOption;
   bin?: AkanBinConfig;
+  native?: AkanNativeAppConfig;
   plugins?: AkanPlugin[];
 };
 export type LibConfigInput = Omit<DeepPartial<LibConfigResult>, "bin"> & {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-beta.29",
+  "version": "3.0.0-beta.30",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/types/index.d.ts

@@ -82,89 +82,35 @@ export interface AkanAssetsConfig {
 /** A lib picks only which of its own fonts must survive; whether to prune at all belongs to the app. */
 export type LibAssetsConfig = Pick<AkanAssetsConfig, "keepFonts">;
 export type DatabaseMode = "single" | "multiple" | "cluster";
-export type MobileEnv = "local" | "debug" | "develop" | "main";
-export type MobilePermission = "camera" | "contacts" | "location" | "push" | "speech";
-export interface AkanMobileTargetAssets {
-    /** A square PNG, relative to the app folder, or it with the color behind its transparent areas. */
-    icon?: string | {
-        image: string;
-        backgroundColor?: string;
-    };
-    /** A PNG shown centered at launch, or the launch screen's color, image and when it hides. */
-    splash?: string | NonNullable<AkanNativeConfig["splash"]>;
-}
-export interface AkanMobileTargetDeepLinks {
-    schemes?: string[];
-    domains?: string[];
-    ios?: {
-        teamId?: string;
-    };
-    android?: {
-        sha256CertFingerprints?: string[];
-    };
-}
-/**
- * Files copied into the app, keyed by where they land: `ios/<path>` (the app bundle), `android/res/<type>/<file>` or
- * `android/assets/<path>`. The value is the source, relative to the app folder.
- */
-export type AkanMobileTargetFiles = Record<string, string>;
+export type NativeEnv = "local" | "debug" | "develop" | "main";
+export type NativePermission = "camera" | "contacts" | "location" | "push" | "speech";
 export type AkanNativeValue = string | number | boolean | AkanNativeValue[] | {
     [key: string]: AkanNativeValue;
 };
-export interface AkanMobileNativeConfig {
-    /** Native runtime plugins beyond the ones the permissions bring, by builtin id (`"iap"`) or absolute folder. */
-    plugins?: string[];
-    ios?: {
-        infoPlist?: Record<string, AkanNativeValue>;
-        entitlements?: Record<string, AkanNativeValue>;
-    };
-    android?: {
-        /** XML at the `<manifest>` level; `${applicationId}` is replaced. */
-        manifest?: string[];
-        /** XML inside `<application>`. */
-        application?: string[];
-        /** XML inside the app's activity. */
-        activity?: string[];
-        /** The Firebase project's google-services.json, relative to the app folder, for FCM push on Android. */
-        googleServices?: string;
-        /** Media plays with sound without a tap first, as it does on iOS and the desktop: a signage screen. */
-        autoplay?: boolean;
-    };
-    /** Android's notification channel, status bar icon (relative to the app folder) and accent color. */
-    push?: AkanNativeConfig["push"];
-    /** The app's part of the iOS privacy manifest (PrivacyInfo.xcprivacy), which an App Store upload requires. */
-    privacy?: AkanNativeConfig["privacy"];
-    desktop?: {
-        /**
-         * The desktop app carries the app's server (API only, database mode single, on loopback) and its pages call
-         * nothing else. `build-desktop`, `start-desktop` and `publish-update` all read it, and an installed app refuses
-         * a release that carries a server when it has none, or none when it has one.
-         */
-        server?: boolean;
-        /**
-         * `"reload"`: a window whose page's process ends (a crash, a hang) loads it again every time, waiting
-         * longer after each end in a row, and the app relaunches when the webview's browser process ends — for an
-         * app nobody attends. `"errorPage"` (default): one reload, then an error page, and a quit for the browser.
-         */
-        recovery?: "errorPage" | "reload";
-        /** The main window from its first frame: borderless fullscreen, and no taskbar button (Windows, Linux). */
-        window?: {
-            fullscreen?: boolean;
-            skipTaskbar?: boolean;
-        };
-        /**
-         * Windows: `"auto"` answers getDisplayMedia() with the first screen at once, no picker or gesture — remote
-         * support on an unattended screen; it covers every media request, so not for an app that asks for a camera.
-         */
-        screenCapture?: "picker" | "auto";
-    };
+/**
+ * One bundle id, or one per platform, for an app whose store listings already carry different ids. A platform without
+ * its own takes `default`.
+ */
+export type AkanNativeAppId = string | {
+    default?: string;
+    ios?: string;
+    android?: string;
+    macos?: string;
+    windows?: string;
+    linux?: string;
+};
+export interface AkanNativeDeepLinks {
+    /** Custom URL schemes the app opens (`board://…`). */
+    schemes?: string[];
+    /** Hosts whose https links open the app: universal links (iOS, `ios.teamId`) and app links (Android). */
+    domains?: string[];
 }
 /**
  * Where an installed app looks for newer releases of itself (the native runtime's updates plugin): the whole app on a
  * desktop, the web bundle on a phone. `akan publish-update` writes and signs a release with a key on this machine;
  * `akan pack-update` writes an unsigned phone bundle for whoever holds the key to sign.
  */
-export interface AkanMobileUpdatesConfig {
+export interface AkanNativeUpdatesConfig {
     /**
      * A static base URL, https in a release build: `<url>/<os>-<arch>/<channel>.json` (desktop) or `<url>/<platform>/…`
      * (a phone's web bundle).
@@ -180,46 +126,114 @@ export interface AkanMobileUpdatesConfig {
     /** How long a newly applied release has to call notifyReady() before it is rolled back, ms. Default 10000. */
     readyTimeout?: number;
 }
+export interface AkanNativeIosConfig {
+    /** The Apple team id: the universal links of `deepLinks.domains` (apple-app-site-association). */
+    teamId?: string;
+    infoPlist?: Record<string, AkanNativeValue>;
+    entitlements?: Record<string, AkanNativeValue>;
+    /** The app's part of the iOS privacy manifest (PrivacyInfo.xcprivacy), which an App Store upload requires. */
+    privacy?: AkanNativeConfig["privacy"];
+    /** Files copied into the app bundle, keyed by their path there; the value is the source, relative to the app folder. */
+    files?: Record<string, string>;
+}
+export interface AkanNativeAndroidConfig {
+    /** The signing certificates' SHA-256 fingerprints: the app links of `deepLinks.domains` (assetlinks.json). */
+    sha256CertFingerprints?: string[];
+    /** The Firebase project's google-services.json, relative to the app folder, for FCM push. */
+    googleServices?: string;
+    /** The notification channel, status bar icon (relative to the app folder) and accent color of pushes. */
+    push?: NonNullable<AkanNativeConfig["push"]>["android"];
+    /** Media plays with sound without a tap first, as it does on iOS and the desktop: a signage screen. */
+    autoplay?: boolean;
+    /** XML at the `<manifest>` level; `${applicationId}` is replaced. */
+    manifest?: string[];
+    /** XML inside `<application>`. */
+    application?: string[];
+    /** XML inside the app's activity. */
+    activity?: string[];
+    /** Files copied into the app, keyed `res/<type>/<file>` or `assets/<path>`; the value is the source. */
+    files?: Record<string, string>;
+}
+export interface AkanNativeDesktopConfig {
+    /**
+     * The desktop app carries the app's server (API only, database mode single, on loopback) and its pages call
+     * nothing else. `build-desktop`, `start-desktop` and `publish-update` all read it, and an installed app refuses
+     * a release that carries a server when it has none, or none when it has one.
+     */
+    server?: boolean;
+    /**
+     * `"reload"`: a window whose page's process ends (a crash, a hang) loads it again every time, waiting
+     * longer after each end in a row, and the app relaunches when the webview's browser process ends — for an
+     * app nobody attends. `"errorPage"` (default): one reload, then an error page, and a quit for the browser.
+     */
+    recovery?: "errorPage" | "reload";
+    /** The main window from its first frame: borderless fullscreen, and no taskbar button (Windows, Linux). */
+    window?: {
+        fullscreen?: boolean;
+        skipTaskbar?: boolean;
+    };
+    /**
+     * Windows: `"auto"` answers getDisplayMedia() with the first screen at once, no picker or gesture — remote
+     * support on an unattended screen; it covers every media request, so not for an app that asks for a camera.
+     */
+    screenCapture?: "picker" | "auto";
+}
 /**
- * One bundle id, or one per platform, for an app whose store listings already carry different ids. A platform without
- * its own takes `default`.
+ * What a native app (iOS, Android, desktop) is: the app's `native` section and each of its targets have this shape. A
+ * target takes the section and overrides it field by field: objects merge key by key, and any other value — a list
+ * included — replaces the section's.
  */
-export type AkanMobileAppId = string | {
-    default?: string;
-    ios?: string;
-    android?: string;
-    macos?: string;
-    windows?: string;
-    linux?: string;
-};
-export interface AkanMobileTargetConfig {
-    name: string;
+export interface AkanNativeSettings {
+    /** The client the app opens, a basePath the routes declare; an app without basePaths leaves it out. */
     basePath?: string;
+    /** Where the app starts, and falls back to for a deep link's stack and a back with no history. Default `/`. */
     indexPath?: string;
-    appName: string;
-    appId: AkanMobileAppId;
+    /** Default: the app's folder name. */
+    appName?: string;
+    /** Default: one made from the repository's and the app's names. */
+    appId?: AkanNativeAppId;
     /** Executables, archives and the Swift module; letters, digits, `.`, `_` and `-`. Default: the app's folder name. */
     fileName?: string;
+    /** Default `0.0.1`. */
+    version?: string;
+    /** Default 1. */
+    buildNum?: number;
+    /** A square PNG, relative to the app folder, or it with the color behind its transparent areas. */
+    icon?: string | {
+        image: string;
+        backgroundColor?: string;
+    };
+    /** A PNG shown centered at launch, or the launch screen's color, image and when it hides. */
+    splash?: string | NonNullable<AkanNativeConfig["splash"]>;
+    permissions?: NativePermission[];
+    /** Native runtime plugins beyond the ones the permissions bring: a builtin id (`"iap"`) or a folder, from the app's. */
+    plugins?: string[];
+    deepLinks?: AkanNativeDeepLinks;
+    updates?: Partial<AkanNativeUpdatesConfig>;
+    ios?: AkanNativeIosConfig;
+    android?: AkanNativeAndroidConfig;
+    desktop?: AkanNativeDesktopConfig;
+}
+/** `native` in akan.config.ts. Without `targets` the app has one target, named `default`. */
+export interface AkanNativeAppConfig extends AkanNativeSettings {
+    targets?: Record<string, AkanNativeSettings>;
+}
+/** One target of the app, its fields over the app's `native` section and the defaults. */
+export interface AkanNativeTarget extends Omit<AkanNativeSettings, "appName" | "appId" | "version" | "buildNum" | "updates"> {
+    name: string;
+    appName: string;
+    appId: AkanNativeAppId;
     version: string;
     buildNum: number;
-    assets?: AkanMobileTargetAssets;
-    permissions?: MobilePermission[];
-    deepLinks?: AkanMobileTargetDeepLinks;
-    files?: AkanMobileTargetFiles;
-    native?: AkanMobileNativeConfig;
-    /** Over mobile.updates, field by field: a pilot target names its own channel. */
-    updates?: Partial<AkanMobileUpdatesConfig>;
-}
-export interface AkanMobileConfig {
+    updates?: AkanNativeUpdatesConfig;
+}
+export interface AkanNativeAppResult {
     appName: string;
-    appId: AkanMobileAppId;
+    appId: AkanNativeAppId;
     fileName?: string;
     version: string;
     buildNum: number;
-    files?: AkanMobileTargetFiles;
-    native?: AkanMobileNativeConfig;
-    updates?: AkanMobileUpdatesConfig;
-    targets: Record<string, AkanMobileTargetConfig>;
+    targets: Record<string, AkanNativeTarget>;
 }
 export interface AkanScanInfo {
     /** Transitive lib dependencies of the app (or direct deps of a lib). */
@@ -265,9 +279,9 @@ export interface AkanSyncContext {
     /** Resolves `env/env.client.ts` and returns its exported `env`, or null when absent/invalid. */
     readEnvClient(): Promise<Record<string, unknown> | null>;
 }
-/** What a plugin adds to a mobile app whose target asks for its permission; the native build merges every one. */
+/** What a plugin adds to a native app whose target asks for its permission; the native build merges every one. */
 export interface AkanPluginNativeConfig {
-    permission: MobilePermission;
+    permission: NativePermission;
     /** Native runtime plugins, by builtin id (`"camera"`). */
     plugins?: string[];
     /** iOS usage texts by description name (`cameraUsageDescription`); `$(PRODUCT_NAME)` becomes the app name. */
@@ -325,7 +339,7 @@ export interface AppConfigResult {
     images: AkanImageConfig;
     i18n: AkanI18nConfig;
     publicEnv: string[];
-    mobile: AkanMobileConfig;
+    native: AkanNativeAppResult;
     secrets: string[];
     assets: AkanAssetsConfig;
 }
@@ -350,10 +364,11 @@ export interface LibConfigContext {
     readonly name: string;
     readonly type: "lib";
 }
-export type AppConfigInput = Omit<DeepPartial<AppConfigResult>, "docker" | "web" | "bin"> & {
+export type AppConfigInput = Omit<DeepPartial<AppConfigResult>, "docker" | "web" | "bin" | "native"> & {
     docker?: DockerOption;
     web?: AkanWebOption;
     bin?: AkanBinConfig;
+    native?: AkanNativeAppConfig;
     plugins?: AkanPlugin[];
 };
 export type LibConfigInput = Omit<DeepPartial<LibConfigResult>, "bin"> & {