akanjs 3.0.0-beta.19 → 3.0.0-beta.20

package/base/base.ts

@@ -23,10 +23,10 @@ export type EnumInstance<RefName extends string = string, T = string | number> =
   }
 >;
 
-/** Returns true when a class was created by `enumOf`. */
+/** True for a `class X extends enumOf(...) {}`, not for the bare `enumOf(...)` result. */
 export const isEnum = (enumRef: Cls) => Object.getPrototypeOf(Object.getPrototypeOf(enumRef) ?? {}) === EnumPrototype;
 
-/** Creates a typed scalar enum class from a readonly list of string or number values. */
+/** `type` is `String` for string values, else `Int` when every value is an integer, else `Float`. */
 export const enumOf = <RefName extends string, T = string | number>(
   refName: RefName,
   values: readonly T[],
@@ -78,9 +78,7 @@ export const enumOf = <RefName extends string, T = string | number>(
   return Enum as unknown as EnumInstance<RefName, T>;
 };
 
-/** Id-keyed list helper used for light model collections and immutable-style list updates. */
 export class DataList<Light extends { id: string }> {
-  
   #idMap: Map<string, number>;
   length: number;
   values: Light[];
@@ -125,8 +123,7 @@ export class DataList<Light extends { id: string }> {
   }
   get(id: string) {
     const idx = this.#idMap.get(id);
-    if (idx === undefined) return undefined;
-    return this.values[idx];
+    return idx === undefined ? undefined : this.values[idx];
   }
   at(idx: number) {
     return this.values.at(idx);
@@ -143,12 +140,10 @@ export class DataList<Light extends { id: string }> {
     return this.#idMap.has(id);
   }
   find(fn: (value: Light, idx: number) => boolean) {
-    const val = this.values.find(fn);
-    return val;
+    return this.values.find(fn);
   }
   findIndex(fn: (value: Light, idx: number) => boolean) {
-    const val = this.values.findIndex(fn);
-    return val;
+    return this.values.findIndex(fn);
   }
   some(fn: (value: Light, idx: number) => boolean) {
     return this.values.some(fn);

package/base/baseEnv.ts

@@ -81,7 +81,7 @@ type RoutePrefixOverride = { api?: string; ws?: string };
 
 const globalWithPrefix = globalThis as typeof globalThis & { __AKAN_PREFIX__?: RoutePrefixOverride };
 
-/** Leading slash, no trailing slash. A blank value — or a bare `/`, which would swallow every page route — is no prefix at all and falls through to the next source. */
+/** Leading slash, no trailing slash; a blank value or a bare `/` (it would swallow every page route) is no prefix. */
 export const normalizeRoutePrefix = (value: string | undefined | null): string | undefined => {
   const trimmed = value?.trim();
   if (!trimmed) return undefined;
@@ -90,12 +90,9 @@ export const normalizeRoutePrefix = (value: string | undefined | null): string |
 };
 
 /**
- * Three sources, narrowest first. The global is what a server-rendered page's bootstrap script writes, so the
- * browser follows the process that rendered it. `AKAN_API_PREFIX` is deliberately outside the `AKAN_PUBLIC_*`
- * namespace: only that namespace is inlined into client bundles at build time, so a name inside it could never
- * act as a runtime override. `AKAN_PUBLIC_API_PREFIX` is the build-time default, and the only one a prebuilt CSR
- * or mobile bundle can read. Written out rather than looked up by key — a computed `process.env[...]` is opaque
- * to the bundler's define pass, and the public value would stop being inlined.
+ * Narrowest first: the SSR bootstrap global, then `AKAN_API_PREFIX` (outside `AKAN_PUBLIC_*`, which is inlined at build
+ * time, so it can override at runtime), then the build-time default. Written out: a computed `process.env[...]` escapes
+ * the bundler's define pass.
  */
 export const getApiPrefix = (): string =>
   normalizeRoutePrefix(globalWithPrefix.__AKAN_PREFIX__?.api) ??
@@ -117,7 +114,7 @@ export const resetEnvCache = () => {
 const missingPublicEnv = (key: string) =>
   `getEnv() cannot run at build time: akan build does not inject ${key}. Call it from a runtime function instead of at module scope (e.g. env(() => getEnv()) in adapt(), a method body, or a default thunk).`;
 
-/** Reads and caches Akan runtime environment values from process/browser environment settings. */
+/** Cached after the first call. */
 export const getEnv = (): ClientEnv => {
   if (cachedEnv) return cachedEnv;
   const appName = process.env.AKAN_PUBLIC_APP_NAME ?? "unknown";

package/base/databaseModes.ts

@@ -9,7 +9,7 @@ export interface DatabaseModeRequest {
   local: boolean;
 }
 
-/** The database modes, what each runs on, and how a process settles on one. The CLI and the server share it. */
+/** Shared by the CLI and the server. */
 export class DatabaseModes {
   static readonly all = ["single", "multiple", "cluster"] as const satisfies readonly DatabaseMode[];
   /** Packages a mode imports at runtime. A build carries them for every mode the app declares. */
@@ -44,9 +44,8 @@ export class DatabaseModes {
   }
 
   /**
-   * The mode this process runs in, or the reason it cannot pick one. A deployment that names no mode when the build
-   * carries several fails rather than falling back: the fallback would be a SQLite file inside each container, which a
-   * cluster deployment would find out about only once its instances disagreed.
+   * Throws when a build carrying several modes names none: the fallback would be a SQLite file in each container,
+   * which a cluster deployment would discover only once its instances disagreed.
    */
   static resolve({ requested, declared, local }: DatabaseModeRequest): DatabaseMode {
     const modes = declared?.trim() ? DatabaseModes.parseList(declared, "AKAN_DATABASE_MODES") : null;

package/base/primitiveRegistry.ts

@@ -4,10 +4,8 @@ import type { Cls } from "./types";
 
 export type { Dayjs };
 
-/** Shared dayjs factory re-export used by Akan documents, services, stores, and UI. */
 export const dayjs = dayjsLib;
 
-/** Registry that maps Akan primitive scalar names to their runtime scalar classes. */
 export class PrimitiveRegistry {
   static readonly #namePrimitiveMap = new Map<string, typeof PrimitiveScalar>();
   static readonly #primitiveNameMap = new Map<typeof PrimitiveScalar, string>();
@@ -50,10 +48,8 @@ export interface PrimitiveJsonSchema {
 }
 
 /**
- * How an agent — an MCP client or the in-page one — sees a primitive whose stored shape is not the one a model
- * should read or write: `schema` is what it is published as on both sides of a call, and `read` turns a stored or
- * wire value into that shape. There is no `write`, because every argument and every input field already runs
- * through `parseValue`; a primitive that accepts the agent's shape there has taken the write.
+ * How an agent sees a primitive whose stored shape is not the one a model should read: `schema` is its published shape
+ * and `read` maps a stored or wire value into it. No `write`: every input already runs through `parseValue`.
  */
 export interface PrimitiveAgentFace<Value = unknown> {
   schema: PrimitiveJsonSchema;
@@ -70,7 +66,7 @@ export class PrimitiveScalar {
   static [EXAMPLE_VALUE]: unknown = null;
   /** The wire shape, for a primitive the built-in schema table cannot know. Absent, it is published as a string. */
   static jsonSchema?: PrimitiveJsonSchema;
-  /** Absent, an agent sees the wire shape. See `PrimitiveAgentFace`. */
+  /** Absent, an agent sees the wire shape. */
   static agent?: PrimitiveAgentFace;
 
   static validate(value: PrimitiveValue): boolean {
@@ -119,7 +115,7 @@ export class PrimitiveScalar {
   }
 }
 
-/** Integer primitive scalar. Accepts safe integer numbers after parsing. */
+/** Safe integers only. */
 export class Int extends PrimitiveScalar {
   static override refName: "Int" = "Int";
   static override [SERVER_VALUE]: number;
@@ -140,7 +136,7 @@ export class Int extends PrimitiveScalar {
 }
 PrimitiveRegistry.register(Int);
 
-/** Floating point primitive scalar. Accepts finite numbers after parsing. */
+/** Finite numbers only. */
 export class Float extends PrimitiveScalar {
   static override refName: "Float" = "Float";
   static override [SERVER_VALUE]: number;
@@ -161,7 +157,7 @@ export class Float extends PrimitiveScalar {
 }
 PrimitiveRegistry.register(Float);
 
-/** 24-character hexadecimal id primitive used by Akan document and signal models. */
+/** 24 hexadecimal characters. */
 export class ID extends PrimitiveScalar {
   static override refName: "ID" = "ID";
   static override [SERVER_VALUE]: string;
@@ -188,7 +184,7 @@ export class ID extends PrimitiveScalar {
 }
 PrimitiveRegistry.register(ID);
 
-/** Open object primitive for intentionally flexible payloads or metadata blobs. */
+/** An intentionally open payload. */
 export class Any extends PrimitiveScalar {
   static override refName: "Any" = "Any";
   static override [DEFAULT_VALUE]: object | null = null;
@@ -295,34 +291,20 @@ declare global {
   }
 }
 
+const isBlankOrInvalid = (refName: string, value: PrimitiveValue) =>
+  value === "" ||
+  (refName === "Date" && typeof value === "string" && Number.isNaN(new Date(value).getTime())) ||
+  (refName === "Date" && value instanceof Date && Number.isNaN(value.getTime())) ||
+  (!!value && typeof value === "object" && "isValid" in value && !(value as { isValid: () => boolean }).isValid());
+
 const scalarPrimitiveStatics = {
-  _parse(
-    this: typeof PrimitiveScalar,
-    input: PrimitiveValue,
-    { optional = false }: { optional?: boolean } = {},
-  ): PrimitiveValue {
-    if (optional && (input === null || input === undefined)) return undefined;
-    const value = this.parseValue(input);
-    this._checkValue(value, { optional });
-    return value;
-  },
+  _parse: PrimitiveScalar._parse,
   _serialize(
     this: typeof PrimitiveScalar,
     value: PrimitiveValue,
     { optional = false }: { optional?: boolean } = {},
   ): PrimitiveValue {
-    if (optional && value === "") return undefined;
-    if (this.refName === "Date" && optional && typeof value === "string" && Number.isNaN(new Date(value).getTime()))
-      return undefined;
-    if (this.refName === "Date" && optional && value instanceof Date && Number.isNaN(value.getTime())) return undefined;
-    if (
-      optional &&
-      value &&
-      typeof value === "object" &&
-      "isValid" in value &&
-      !(value as { isValid: () => boolean }).isValid()
-    )
-      return undefined;
+    if (optional && isBlankOrInvalid(this.refName, value)) return undefined;
     this._checkValue(value, { optional });
     if (value === null || value === undefined) return undefined;
     return this.serializeValue(value);
@@ -336,18 +318,7 @@ const scalarPrimitiveStatics = {
       if (optional) return;
       else throw new Error(`Required ${this.refName} value: ${value}`);
     }
-    if (optional && value === "") return;
-    if (this.refName === "Date" && optional && typeof value === "string" && Number.isNaN(new Date(value).getTime()))
-      return;
-    if (this.refName === "Date" && optional && value instanceof Date && Number.isNaN(value.getTime())) return;
-    if (
-      optional &&
-      value &&
-      typeof value === "object" &&
-      "isValid" in value &&
-      !(value as { isValid: () => boolean }).isValid()
-    )
-      return;
+    if (optional && isBlankOrInvalid(this.refName, value)) return;
     if (!this.validate(value)) throw new Error(`Invalid ${this.refName} value: ${value}`);
   },
 };

package/base/symbols.ts

@@ -13,7 +13,7 @@ export const STATE_META = Symbol.for("akan.state");
 export const STATE_INIT_META = Symbol.for("akan.state.init");
 export const STATE_DERIVED_META = Symbol.for("akan.state.derived");
 export const ACTION_META = Symbol.for("akan.action");
-/** Which module declared each action. See `ActionOwner`. */
+/** Which module declared each action. */
 export const ACTION_OWNER_META = Symbol.for("akan.action.owner");
 /** What a dispatcher does, carried on the function so a component handed one can annotate the DOM with it. */
 export const ACTION_TAG = Symbol.for("akan.action.tag");

package/base/types.ts

@@ -116,7 +116,7 @@ export type MergeAllDoubleKeyOfObjects<
     : MergeAllDoubleKeyOfObjects<Rest, Key, SubKey, Acc>
   : Acc;
 
-export type Primitive = string | number | boolean | null | undefined; 
+export type Primitive = string | number | boolean | null | undefined;
 
 export type NestedKeysWithAllowed<T, Allowed = Primitive> = T extends Primitive
   ? never

package/base/utils.ts

@@ -21,10 +21,7 @@ export const applyFnToArrayObjects = <Input, Fn extends (arg: never) => unknown>
   arraiedData: Input,
   fn: Fn,
 ): ApplyFnToArrayObjectsResult<Input, ReturnType<Fn>> => {
-  if (Array.isArray(arraiedData))
-    return arraiedData.map((data) => applyFnToArrayObjects(data, fn)) as ApplyFnToArrayObjectsResult<
-      Input,
-      ReturnType<Fn>
-    >;
-  return fn(arraiedData as never) as ApplyFnToArrayObjectsResult<Input, ReturnType<Fn>>;
+  type Result = ApplyFnToArrayObjectsResult<Input, ReturnType<Fn>>;
+  if (Array.isArray(arraiedData)) return arraiedData.map((data) => applyFnToArrayObjects(data, fn)) as Result;
+  return fn(arraiedData as never) as Result;
 };

package/capacitor.base.config.ts

@@ -14,7 +14,7 @@ const getLocalIP = () => {
       if (alias.family === "IPv4" && !alias.internal) return alias.address;
     }
   }
-  return "127.0.0.1"; 
+  return "127.0.0.1";
 };
 
 const normalizeBasePath = (basePath: string | undefined) => basePath?.replace(/^\/+|\/+$/g, "");
@@ -91,11 +91,10 @@ const localCsrUrl = (ip: string, target: AkanMobileTargetConfig, appInfo: AppSca
 
 export const withBase = (
   configImp: (config: CapacitorConfig, target: AkanMobileTargetConfig) => CapacitorConfig = (config) => config,
-  appData?: AppScanResult,
+  appInfo?: AppScanResult,
   targetName?: string,
 ) => {
   const ip = getLocalIP();
-  const appInfo = appData;
   if (!appInfo) throw new Error("withBase requires apps/<app>/akan.app.json metadata.");
   const target = resolveTarget(appInfo, targetName);
   const {

package/client/capacitor.ts

@@ -188,7 +188,6 @@ type CapacitorImportCache = Partial<{
 type CapacitorPluginRegistry = Record<string, unknown>;
 
 declare global {
-  
   var __AKAN_CAPACITOR_IMPORTS__: CapacitorImportCache | undefined;
 }
 
@@ -217,13 +216,13 @@ const getCapacitorPlugin = <Plugin>(name: string): Plugin => {
   return plugin as Plugin;
 };
 
-export const loadCapacitorApp = () =>
-  loadCapacitorModule("app", async () => ({ App: getCapacitorPlugin<CapacitorAppModule["App"]>("App") }));
+const loadCapacitorPlugin = <K extends keyof CapacitorModuleMap>(
+  name: K,
+  plugin: keyof CapacitorModuleMap[K] & string,
+) => loadCapacitorModule(name, async () => ({ [plugin]: getCapacitorPlugin(plugin) }) as CapacitorModuleMap[K]);
 
-export const loadCapacitorBrowser = () =>
-  loadCapacitorModule("browser", async () => ({
-    Browser: getCapacitorPlugin<CapacitorBrowserModule["Browser"]>("Browser"),
-  }));
+export const loadCapacitorApp = () => loadCapacitorPlugin("app", "App");
+export const loadCapacitorBrowser = () => loadCapacitorPlugin("browser", "Browser");
 
 export const loadCapacitorCamera = () =>
   loadCapacitorModule("camera", async () => ({
@@ -232,28 +231,11 @@ export const loadCapacitorCamera = () =>
     CameraSource: { Prompt: "PROMPT", Camera: "CAMERA", Photos: "PHOTOS" },
   }));
 
-export const loadCapacitorContacts = () =>
-  loadCapacitorModule("contacts", async () => ({
-    Contacts: getCapacitorPlugin<CapacitorContactsModule["Contacts"]>("Contacts"),
-  }));
-
-export const loadCapacitorCore = () =>
-  loadCapacitorModule("core", async () => ({
-    CapacitorCookies: getCapacitorPlugin<CapacitorCoreModule["CapacitorCookies"]>("CapacitorCookies"),
-  }));
-
-export const loadCapacitorDevice = () =>
-  loadCapacitorModule("device", async () => ({
-    Device: getCapacitorPlugin<CapacitorDeviceModule["Device"]>("Device"),
-  }));
-
-export const loadCapacitorFcm = () =>
-  loadCapacitorModule("fcm", async () => ({ FCM: getCapacitorPlugin<CapacitorFcmModule["FCM"]>("FCM") }));
-
-export const loadCapacitorGeolocation = () =>
-  loadCapacitorModule("geolocation", async () => ({
-    Geolocation: getCapacitorPlugin<CapacitorGeolocationModule["Geolocation"]>("Geolocation"),
-  }));
+export const loadCapacitorContacts = () => loadCapacitorPlugin("contacts", "Contacts");
+export const loadCapacitorCore = () => loadCapacitorPlugin("core", "CapacitorCookies");
+export const loadCapacitorDevice = () => loadCapacitorPlugin("device", "Device");
+export const loadCapacitorFcm = () => loadCapacitorPlugin("fcm", "FCM");
+export const loadCapacitorGeolocation = () => loadCapacitorPlugin("geolocation", "Geolocation");
 
 export const loadCapacitorHaptics = () =>
   loadCapacitorModule("haptics", async () => ({
@@ -261,37 +243,10 @@ export const loadCapacitorHaptics = () =>
     ImpactStyle: { Light: "LIGHT", Medium: "MEDIUM", Heavy: "HEAVY" },
   }));
 
-export const loadCapacitorKeyboard = () =>
-  loadCapacitorModule("keyboard", async () => ({
-    Keyboard: getCapacitorPlugin<CapacitorKeyboardModule["Keyboard"]>("Keyboard"),
-  }));
-
-export const loadCapacitorPreferences = () =>
-  loadCapacitorModule("preferences", async () => ({
-    Preferences: getCapacitorPlugin<CapacitorPreferencesModule["Preferences"]>("Preferences"),
-  }));
-
-export const loadCapacitorPushNotifications = () =>
-  loadCapacitorModule("pushNotifications", async () => ({
-    PushNotifications: getCapacitorPlugin<CapacitorPushNotificationsModule["PushNotifications"]>("PushNotifications"),
-  }));
-
-export const loadCapacitorSafeArea = () =>
-  loadCapacitorModule("safeArea", async () => ({
-    SafeArea: getCapacitorPlugin<CapacitorSafeAreaModule["SafeArea"]>("SafeArea"),
-  }));
-
-export const loadCapacitorSpeechRecognition = () =>
-  loadCapacitorModule("speechRecognition", async () => ({
-    SpeechRecognition: getCapacitorPlugin<CapacitorSpeechRecognitionModule["SpeechRecognition"]>("SpeechRecognition"),
-  }));
-
-export const loadCapacitorTextToSpeech = () =>
-  loadCapacitorModule("textToSpeech", async () => ({
-    TextToSpeech: getCapacitorPlugin<CapacitorTextToSpeechModule["TextToSpeech"]>("TextToSpeech"),
-  }));
-
-export const loadCapacitorUpdater = () =>
-  loadCapacitorModule("updater", async () => ({
-    CapacitorUpdater: getCapacitorPlugin<CapacitorUpdaterModule["CapacitorUpdater"]>("CapacitorUpdater"),
-  }));
+export const loadCapacitorKeyboard = () => loadCapacitorPlugin("keyboard", "Keyboard");
+export const loadCapacitorPreferences = () => loadCapacitorPlugin("preferences", "Preferences");
+export const loadCapacitorPushNotifications = () => loadCapacitorPlugin("pushNotifications", "PushNotifications");
+export const loadCapacitorSafeArea = () => loadCapacitorPlugin("safeArea", "SafeArea");
+export const loadCapacitorSpeechRecognition = () => loadCapacitorPlugin("speechRecognition", "SpeechRecognition");
+export const loadCapacitorTextToSpeech = () => loadCapacitorPlugin("textToSpeech", "TextToSpeech");
+export const loadCapacitorUpdater = () => loadCapacitorPlugin("updater", "CapacitorUpdater");

package/client/cn.ts

@@ -1,11 +1,6 @@
 import { type ClassNameValue, extendTailwindMerge } from "tailwind-merge";
 
-/**
- * Akan's semantic color tokens beyond tailwind-merge's built-in Tailwind palette.
- * Registering them under `theme.color` teaches tailwind-merge that `bg-*`/`text-*`/
- * `border-*`/… built from these names belong to the same conflict group, so
- * `cn("bg-primary", "bg-open")` correctly resolves to `"bg-open"` instead of keeping both.
- */
+/** Registered with tailwind-merge so `cn("bg-primary", "bg-open")` resolves to `"bg-open"` instead of keeping both. */
 export const colorTokens = [
   "background",
   "foreground",
@@ -38,10 +33,7 @@ export const colorTokens = [
   "ring",
 ];
 
-/**
- * Akan's semantic radius tokens (`--radius-box` / `--radius-field` in ui/styles.css). Without them
- * `cn("rounded-field", "rounded-full")` keeps both classes and stylesheet order decides the winner.
- */
+/** `--radius-box` / `--radius-field`; unregistered, `cn("rounded-field", "rounded-full")` would keep both. */
 export const radiusTokens = ["box", "field"];
 
 const twMerge = extendTailwindMerge({
@@ -53,7 +45,5 @@ const twMerge = extendTailwindMerge({
   },
 });
 
-/** The one class-combining function: joins strings/arrays/conditional parts (`cond && "x"`) and
- *  resolves Tailwind conflicts with a shared tailwind-merge instance that knows Akan's semantic
- *  color tokens. clsx-style object syntax (`{ x: cond }`) is not supported — write `cond && "x"`. */
+/** Joins class parts and resolves Tailwind conflicts; object syntax (`{ x: cond }`) is unsupported — write `cond && "x"`. */
 export const cn = (...inputs: ClassNameValue[]) => twMerge(...inputs);

package/client/cookie.ts

@@ -43,15 +43,11 @@ export const setCookie = (
     .catch(() => undefined);
 };
 
-/**
- * Reads through `cookies()` on both sides, which is the only way the two agree: a hand-rolled
- * `split("=")[1]` truncates a value at its first `=` (base64 padding) and never decodes the `j:` form the
- * server branch does. Capacitor's own docs say to read `document.cookie`, and `cookies()` does.
- */
+/** Reads through `cookies()` on both sides: a hand-rolled `split("=")` cuts base64 padding and skips the `j:` form. */
 export const getCookie = (key: string): string | undefined => cookies().get(key)?.value;
 
 export const removeCookie = (key: string, options: { path: string } = { path: "/" }) => {
-
+  
   if (getEnv().side === "server") return;
   
   document.cookie = `${key}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=${options.path};`;
@@ -78,13 +74,8 @@ export const getStoredAuthToken = async (): Promise<string | undefined> => {
   return legacy && isOwnAuthToken(legacy) ? legacy : undefined;
 };
 
-/**
- * Decodes the current JWT into account data when it belongs to this app/environment.
- *
- * The two credentials read here are exactly the two the server honours — the app-scoped auth cookie and
- * `Authorization: Bearer` (`AccountMiddleware`). It used to fall back to a bare `jwt` *header*, which nothing
- * sends and no guard accepts, so a request carrying one read as signed in here and anonymous at the endpoint.
- */
+/** The current JWT's account when minted for this app and environment. Reads only the two credentials the server
+ * honours — the app-scoped auth cookie and `Authorization: Bearer` — so the two never disagree on who is signed in. */
 export const getAccount = <AddData = unknown>(): Account<AddData> => {
   const jwt = getAuthToken() ?? getHeader("authorization")?.replace(/^Bearer\s+/i, "");
   const defaultAccount = { appName: getEnv().appName, environment: getEnv().environment } as Account<AddData>;
@@ -104,7 +95,7 @@ export const setAuth = ({ jwt }: SetAuthOption) => {
   fetch.setJwt(jwt);
   setCookie(authTokenKey(), jwt);
   void storage.setItem(authTokenKey(), jwt);
-
+  
   removeCookie(legacyAuthTokenKey);
   void storage.removeItem(legacyAuthTokenKey);
 };
@@ -116,7 +107,7 @@ export const initAuth = ({ jwt }: InitAuthOption = {}) => {
   const stored = getAuthToken();
   const token = jwt ?? stored;
   if (token && !isOwnAuthToken(token)) {
-
+    
     Logger.warn("JWT ignored: it was minted for another app or environment");
     if (token === stored) resetAuth();
     return;

package/client/createFont.ts

@@ -1,5 +1,3 @@
-
-
 export const createFont = (_data: unknown) => null;
 export default createFont;
 export const Nanum_Gothic_Coding = createFont;

package/client/csrTypes.ts

@@ -18,21 +18,10 @@ export type PageSafeAreaConfig =
       bottom?: boolean;
       android?: "auto" | "edge-to-edge" | "none";
     };
-/**
- * Server-render strategy for the initial full-document SSR pass.
- * - `"stream"` (default): flush the shell — including any `Loading` Suspense
- *   fallback — as soon as it is ready, then stream the resolved page. Redirects
- *   decided in the shell still become real HTTP redirects; redirects thrown
- *   inside suspended content degrade to soft (client) redirects.
- * - `"block"`: buffer the whole document until every Suspense boundary resolves
- *   before sending a byte. The `Loading` fallback never reaches the browser, but
- *   a non-redirect error thrown in slow content can still yield a clean error
- *   page. Use only for routes that need that guarantee and do not care about SEO
- *   or first-paint of the fallback.
- */
+/** `"stream"` flushes the shell (`Loading` included) then streams; a redirect in suspended content becomes a client one.
+ * `"block"` buffers the whole document, so an error in slow content can still render a clean error page. */
 export type SsrRenderMode = "stream" | "block";
 
-/** Per-page CSR configuration for transition, safe-area, and gesture behavior. */
 export interface PageConfig {
   transition?: TransitionType;
   safeArea?: PageSafeAreaConfig;
@@ -44,20 +33,12 @@ export interface PageConfig {
   cache?: boolean;
   /** Initial full-document SSR strategy. Defaults to `"stream"`. */
   ssr?: SsrRenderMode;
-  /**
-   * Opt in to guarded RSC page suffix commits when the page does not require
-   * head updates and the retained route chain head is invariant for
-   * sibling navigations under the same layout.
-   */
+  /** Opt-in suffix-only RSC commits, for a page needing no head update under a layout head its siblings share. */
   rscPatchHeadSafe?: boolean;
   topSafeAreaColor?: string;
   bottomSafeAreaColor?: string;
-  /**
-   * Keeps the route out of `akan build`. The route still serves under `akan start`, but nothing about it
-   * reaches production: no bundle, no manifest entry, no URL. On a `_layout`, every route under that
-   * directory is excluded with it. Must be written as a literal `true`/`false` — the build reads it from
-   * the source without evaluating the module.
-   */
+  /** Keeps the route (on a `_layout`, its whole directory) out of `akan build` while `akan start` serves it. Write a
+   * literal `true`/`false`: the build reads it off the source without evaluating the module. */
   devOnly?: boolean;
 }
 
@@ -79,7 +60,6 @@ export interface PageProps {
   params: { [key: string]: string };
   searchParams: { [key: string]: string | string[] };
 }
-/** Props passed to Akan layout route modules. */
 export interface LayoutProps extends PageProps {
   children: ReactNode;
 }
@@ -124,8 +104,7 @@ export interface RouteRender {
   render: LayoutRender | PageRender;
   isAsync?: boolean;
   Loading?: LayoutLoadingRender | PageLoadingRender;
-  /** Loads the module and populates `Loading` without running `render`/`resolveHead`.
-   * Used by the patch (suffix) compose path, which never calls `resolveHead`. */
+  /** Loads the module and fills `Loading` without running `render`/`resolveHead` (the suffix compose path). */
   resolveLoading?: () => void | Promise<void>;
   NotFound?: LayoutNotFoundRender;
   Error?: LayoutErrorRender;
@@ -196,12 +175,10 @@ export interface Route {
   renderOverrides?: RouteRender;
   pageIncludesOwnLayout?: boolean;
   isSpecialRoute?: boolean;
-
   loader?: () => unknown;
   pageState?: PageState;
   pageConfigChain?: PageConfig[];
   explicitPageConfigKeys?: Partial<Record<keyof PageConfig, boolean>>;
-
   children: Map<string, Route>;
 }
 

package/client/decorators.ts

@@ -5,7 +5,7 @@ interface ToastProps {
   root?: string;
   duration?: number;
 }
-/** Decorates async actions with loading/success/error toast messages from `msg`. */
+/** Toasts `<root>.<key>-loading` / `-success` around the method; an error is toasted and logged, not rethrown. */
 export const Toast = ({ root, duration = 3 }: ToastProps = {}) => {
   return (target: any, key: string, descriptor: PropertyDescriptor) => {
     const originMethod = descriptor.value as (...args: any[]) => Promise<void>;