akanjs 2.3.13 → 2.4.0-rc.1

package/server/routeElementComposer.tsx

@@ -2,14 +2,14 @@ import type {
   Head,
   LayoutErrorRender,
   LayoutFallbackRoute,
-  PageConfig,
   LayoutNotFoundRender,
+  PageConfig,
   PathRoute,
   ResolvedHead,
   RouteRender,
 } from "akanjs/client";
-import { getExplicitPageConfigKeys, resolvePageState } from "../client/frameConfig";
 import { Children, cloneElement, isValidElement, type ReactElement, type ReactNode, Suspense } from "react";
+import { getExplicitPageConfigKeys, resolvePageState } from "../client/frameConfig";
 import { resolveHeadResult } from "./metadata";
 import { type AkanRouteSegmentState, createAkanRouteSegments, createAkanSegmentOutletKey } from "./routeState";
 import { isAkanRscPartialCommitEnabled } from "./rscPartialCommit";
@@ -61,16 +61,19 @@ export class RouteElementComposer {
     pathRoute,
     params,
     searchParams,
+    navKey,
   }: {
     pathRoute: PathRoute;
     params: Record<string, string>;
     searchParams: Record<string, string | string[]>;
+    navKey?: string;
   }): ReactNode {
     return RouteElementComposer.composeRenders({
       renders: RouteElementComposer.#getRenderStack(pathRoute),
       segments: isAkanRscPartialCommitEnabled() ? createAkanRouteSegments(pathRoute) : undefined,
       params,
       searchParams,
+      navKey,
     });
   }
 
@@ -79,11 +82,13 @@ export class RouteElementComposer {
     params,
     searchParams,
     patchStartIndex,
+    navKey,
   }: {
     pathRoute: PathRoute;
     params: Record<string, string>;
     searchParams: Record<string, string | string[]>;
     patchStartIndex: number;
+    navKey?: string;
   }): ReactNode | null {
     const renders = RouteElementComposer.#getRenderStack(pathRoute);
     if (!Number.isInteger(patchStartIndex) || patchStartIndex < 0 || patchStartIndex >= renders.length) return null;
@@ -91,9 +96,18 @@ export class RouteElementComposer {
       renders: renders.slice(patchStartIndex),
       params,
       searchParams,
+      navKey,
     });
   }
 
+  static async resolveSuffixLoadings(pathRoute: PathRoute, patchStartIndex: number): Promise<void> {
+    const renders = RouteElementComposer.#getRenderStack(pathRoute).slice(Math.max(patchStartIndex, 0));
+    
+    await Promise.all(
+      renders.map((routeRender) => Promise.resolve(routeRender?.resolveLoading?.()).catch(() => undefined)),
+    );
+  }
+
   static async resolveHead({
     pathRoute,
     params,
@@ -170,18 +184,23 @@ export class RouteElementComposer {
     segments,
     params,
     searchParams,
+    navKey,
   }: {
     renders: RouteRender[];
     segments?: AkanRouteSegmentState[];
     params: Record<string, string>;
     searchParams: Record<string, string | string[]>;
+    navKey?: string;
   }): ReactNode {
     let element: ReactNode = null;
     for (let i = renders.length - 1; i >= 0; i--) {
       const routeRender = renders[i];
       if (!routeRender) continue;
+      const loadingFallback = RouteElementComposer.#composeLoadingFallback(renders.slice(i), params);
+      const suspenseKey =
+        navKey && loadingFallback != null && i === renders.length - 1 ? `akan-loading:${navKey}` : undefined;
       element = (
-        <Suspense fallback={RouteElementComposer.#composeLoadingFallback(renders.slice(i), params)}>
+        <Suspense key={suspenseKey} fallback={loadingFallback}>
           <RouteElementComposer.AsyncRender routeRender={routeRender} params={params} searchParams={searchParams}>
             {element}
           </RouteElementComposer.AsyncRender>

package/server/routeTreeBuilder.ts

@@ -34,6 +34,7 @@ export const defaultPageState: PageState = {
   bottomInset: 0,
   gesture: true,
   cache: false,
+  ssr: "stream",
   topSafeAreaColor: "transparent",
   bottomSafeAreaColor: "transparent",
 };
@@ -341,6 +342,10 @@ export class RouteTreeBuilder {
     const loadModule = RouteTreeBuilder.#makeLazyModule(key, kind, loader);
     const routeRender: RouteRender = {
       isAsync: true,
+      resolveLoading: async () => {
+        const mod = await loadModule();
+        routeRender.Loading = mod.Loading as never;
+      },
       render: async (props: LayoutProps | PageProps) => {
         const mod = await loadModule();
         routeRender.Loading = mod.Loading as never;

package/server/rscWorker.tsx

@@ -2,6 +2,7 @@ import type {
   AkanNotFoundError,
   AkanRedirectError,
   LayoutFallbackRoute,
+  PageState,
   PathRoute,
   RedirectStatus,
   ResolvedHead,
@@ -9,6 +10,7 @@ import type {
 import { type AkanI18nConfig, DEFAULT_AKAN_I18N, getBasePathFromPathname, Logger } from "akanjs/common";
 import {
   getRequestDynamicUsage,
+  getRequestFrameState,
   getRequestPolicy,
   getRequestTheme,
   requestStorage,
@@ -214,6 +216,11 @@ export class RscRenderer {
     }
     this.#send = process.send.bind(process) as (message: unknown) => void;
     process.on("message", (msg: InMsg) => this.#handleMessage(msg));
+
+    process.on("disconnect", () => {
+      this.#logger.warn("parent IPC channel closed; exiting rsc worker");
+      process.exit(0);
+    });
     this.#logger.verbose(`constructed (pid=${process.pid})`);
   }
 
@@ -525,6 +532,7 @@ export class RscRenderer {
               patchStartSegment: undefined,
               patchHeadSafe: undefined,
               patchHeadSnapshot: undefined,
+              ssrBlocking: cached.ssrBlocking,
             },
             send: (message) => this.#send(message),
             isCancelled: () => this.#cancelledRenderRequests.has(requestId),
@@ -553,9 +561,11 @@ export class RscRenderer {
         else element = await this.#renderNotFound(urlObj);
         const traceCacheKey =
           effectivePatchDecision.status === "patch" ? (patchCacheEntry?.key ?? cacheEntry?.key) : cacheEntry?.key;
+        const ssrBlocking = getRequestFrameState<PageState>()?.ssr === "block";
         const trace: RscTraceMetadata = {
           ...createTraceBase(effectivePatchDecision, traceCacheKey),
           cache: cacheEntry ? "miss" : "bypass",
+          ssrBlocking,
         };
         this.#logger.verbose(`render[${requestId}] starting Flight stream`);
         const result = await this.#renderFlightElement(element, msg.clientManifest ?? this.#clientManifest, {
@@ -597,6 +607,7 @@ export class RscRenderer {
                   routeId,
                   tags: cacheState.tags,
                   theme: getRequestTheme(),
+                  ssrBlocking,
                   cacheState,
                   patch: createCachedRscPatchMetadata({
                     targetRouterState,
@@ -616,6 +627,7 @@ export class RscRenderer {
                   routeId,
                   tags: cacheState.tags,
                   theme: getRequestTheme(),
+                  ssrBlocking,
                   cacheState,
                 },
                 storeTtl,
@@ -1243,6 +1255,7 @@ export class RscRenderer {
       pathRoute,
       params: match.params,
       searchParams,
+      navKey: url.pathname + url.search,
     });
     return (
       <html
@@ -1283,11 +1296,14 @@ export class RscRenderer {
       basePath: this.#getBasePath(url),
     });
     setRequestFrameState(pathRoute.pageState);
+
+    await RouteElementComposer.resolveSuffixLoadings(pathRoute, patchStartIndex);
     return RouteElementComposer.composeSuffix({
       pathRoute,
       params: match.params,
       searchParams,
       patchStartIndex,
+      navKey: url.pathname + url.search,
     });
   }
 

package/server/rscWorkerCache.ts

@@ -16,6 +16,8 @@ export interface CachedRscResult {
   routeId?: string;
   tags?: string[];
   theme?: string;
+  /** Whether the matched route opted into blocking SSR (`pageConfig.ssr: "block"`). */
+  ssrBlocking?: boolean;
   cacheState: RouteCacheRenderState;
   patch?: CachedRscPatchMetadata;
 }

package/server/ssrFromRscRenderer.tsx

@@ -594,12 +594,13 @@ export class SsrFromRscRenderer {
       ? `${SsrFromRscRenderer.#clientBootstrap}\n${input.extraBootstrapInline}`
       : SsrFromRscRenderer.#clientBootstrap;
 
+    const waitForAllReady = input.waitForAllReady || process.env.AKAN_SSR_WAIT_FOR_ALL_READY === "1";
     const renderHtml = async () => {
       const root = await thenable;
       const stream = await renderToReadableStream(root, {
         bootstrapScriptContent: bootstrap,
       });
-      await stream.allReady;
+      if (waitForAllReady) await stream.allReady;
       return stream;
     };
     const requestContext = input.requestStore ?? input.request;

package/server/ssrTypes.ts

@@ -42,6 +42,13 @@ export interface RscTraceMetadata {
   patchHeadSafe?: boolean;
   patchHeadSnapshot?: string;
   routeState?: string;
+  /**
+   * Resolved from the matched route's `pageConfig.ssr === "block"`. Rides the
+   * trace so the host (which never resolves pageConfig itself) can decide
+   * whether the full-document SSR pass buffers until every Suspense boundary
+   * resolves. Absent/`false` means stream the shell first.
+   */
+  ssrBlocking?: boolean;
 }
 
 export interface SsrFromRscInput {
@@ -73,4 +80,11 @@ export interface SsrFromRscInput {
   injectThemeInitScript?: boolean;
   lateControl?: Promise<SsrLateRedirect | null>;
   onCancel?: (reason?: unknown) => void;
+  /**
+   * When true, buffer the whole document until every Suspense boundary resolves
+   * (`stream.allReady`) before emitting a byte, matching `pageConfig.ssr:
+   * "block"`. Defaults to shell-first streaming so `Loading` fallbacks surface.
+   * The `AKAN_SSR_WAIT_FOR_ALL_READY=1` env var forces blocking globally.
+   */
+  waitForAllReady?: boolean;
 }

package/server/webRouter.ts

@@ -578,6 +578,7 @@ export class WebRouter {
             importmap: this.#artifact.vendorMap,
             theme: themeCookieExists ? undefined : (rscResult.theme ?? "system"),
             lateControl: rscResult.lateControl,
+            waitForAllReady: rscResult.trace?.ssrBlocking ?? false,
             onCancel: (reason: unknown) => {
               rscResult.cancel(reason);
             },

package/service/ipcTypes.ts

@@ -1,6 +1,6 @@
 export type AkanChildRole = "all" | "federation" | "batch";
 
-export type AkanChildStatus = "starting" | "ready" | "healthy" | "draining" | "unhealthy" | "exited";
+export type AkanChildStatus = "starting" | "ready" | "healthy" | "draining" | "unhealthy" | "exited" | "crashed";
 
 export type AkanUpstream = { type: "unix"; socketPath: string } | { type: "tcp"; host: string; port: number };
 
@@ -110,6 +110,8 @@ export type AkanIpcMessage =
       replicaIdx: number;
       role: AkanChildRole;
       upstream?: AkanUpstream;
+      /** Actual websocket upstream the child bound; may differ from the preferred port when it was in use. */
+      wsUpstream?: Extract<AkanUpstream, { type: "tcp" }>;
       healthPath?: string;
     }
   | { type: "backend-ready"; pid: number }

package/signal/guard.ts

@@ -1,8 +1,8 @@
-import type { Cls } from "akanjs/base";
+import type { Cls, PromiseOrObject } from "akanjs/base";
 import type { SignalContext } from "./signalContext";
 
 export interface Guard {
-  canPass(context: SignalContext): boolean;
+  canPass(context: SignalContext): PromiseOrObject<boolean>;
 }
 
 export type GuardCls<Name extends string = string> = Cls<Guard, { readonly name: Name }>;
@@ -11,7 +11,7 @@ export type GuardCls<Name extends string = string> = Cls<Guard, { readonly name:
 export const guard = <T extends string>(name: T): GuardCls<T> => {
   return class Guard {
     static name = name;
-    canPass(context: SignalContext): boolean {
+    canPass(context: SignalContext): PromiseOrObject<boolean> {
       return true;
     }
   };

package/signal/signalContext.ts

@@ -99,6 +99,11 @@ export class SignalContext<
     }
     return instance as T;
   }
+  getService<T>(refName: string): T {
+    const service = this.#live.service.get(refName);
+    if (!service) throw new Exception.Error(`Service "${refName}" not found in live registry`);
+    return service as T;
+  }
   async init() {
     if (this.trace) {
       const start = performance.now();

package/store/baseSt.ts

@@ -44,6 +44,7 @@ export class BaseStore extends store("base" as const, () => ({
     bottomInset: 0,
     gesture: true,
     cache: false,
+    ssr: "stream",
     topSafeAreaColor: "var(--color-base-100, Canvas)",
     bottomSafeAreaColor: "var(--color-base-100, Canvas)",
   } as PageState,

package/types/client/csrTypes.d.ts

@@ -10,6 +10,19 @@ export type PageSafeAreaConfig = boolean | "top" | "bottom" | {
     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.
+ */
+export type SsrRenderMode = "stream" | "block";
 /** Per-page CSR configuration for transition, safe-area, and gesture behavior. */
 export interface PageConfig {
     transition?: TransitionType;
@@ -20,6 +33,8 @@ export interface PageConfig {
     bottomInset?: number | boolean;
     gesture?: boolean;
     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/metadata updates and the retained route chain head is invariant for
@@ -37,6 +52,7 @@ export interface CsrState {
     bottomInset: number;
     gesture: boolean;
     cache: boolean;
+    ssr: SsrRenderMode;
     topSafeAreaColor?: string;
     bottomSafeAreaColor?: string;
 }
@@ -98,6 +114,9 @@ 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`. */
+    resolveLoading?: () => void | Promise<void>;
     NotFound?: LayoutNotFoundRender;
     Error?: LayoutErrorRender;
     resolveNotFound?: () => PromiseOrObject<LayoutNotFoundRender | undefined>;

package/types/server/lifecycle/portInUse.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detects "address already in use" listen failures across the shapes Bun throws them in
+ * (`code: "EADDRINUSE"` on newer versions, message-only on older ones).
+ */
+export declare const isPortInUseError: (error: unknown) => boolean;

package/types/server/routeElementComposer.d.ts

@@ -11,17 +11,20 @@ export declare class RouteElementComposer {
         route: PathRoute | LayoutFallbackRoute;
         basePath?: string | null;
     }): Promise<import("akanjs/client").PageState>;
-    static compose({ pathRoute, params, searchParams, }: {
+    static compose({ pathRoute, params, searchParams, navKey, }: {
         pathRoute: PathRoute;
         params: Record<string, string>;
         searchParams: Record<string, string | string[]>;
+        navKey?: string;
     }): ReactNode;
-    static composeSuffix({ pathRoute, params, searchParams, patchStartIndex, }: {
+    static composeSuffix({ pathRoute, params, searchParams, patchStartIndex, navKey, }: {
         pathRoute: PathRoute;
         params: Record<string, string>;
         searchParams: Record<string, string | string[]>;
         patchStartIndex: number;
+        navKey?: string;
     }): ReactNode | null;
+    static resolveSuffixLoadings(pathRoute: PathRoute, patchStartIndex: number): Promise<void>;
     static resolveHead({ pathRoute, params, searchParams, }: {
         pathRoute: PathRoute;
         params: Record<string, string>;
@@ -41,11 +44,12 @@ export declare class RouteElementComposer {
         error?: unknown;
         digest?: string;
     }): Promise<ReactNode | null>;
-    static composeRenders({ renders, segments, params, searchParams, }: {
+    static composeRenders({ renders, segments, params, searchParams, navKey, }: {
         renders: RouteRender[];
         segments?: AkanRouteSegmentState[];
         params: Record<string, string>;
         searchParams: Record<string, string | string[]>;
+        navKey?: string;
     }): ReactNode;
     static renderAsync({ routeRender, children, params, searchParams, }: {
         routeRender: RouteRender;

package/types/server/rscWorkerCache.d.ts

@@ -8,6 +8,8 @@ export interface CachedRscResult {
     routeId?: string;
     tags?: string[];
     theme?: string;
+    /** Whether the matched route opted into blocking SSR (`pageConfig.ssr: "block"`). */
+    ssrBlocking?: boolean;
     cacheState: RouteCacheRenderState;
     patch?: CachedRscPatchMetadata;
 }

package/types/server/ssrTypes.d.ts

@@ -40,6 +40,13 @@ export interface RscTraceMetadata {
     patchHeadSafe?: boolean;
     patchHeadSnapshot?: string;
     routeState?: string;
+    /**
+     * Resolved from the matched route's `pageConfig.ssr === "block"`. Rides the
+     * trace so the host (which never resolves pageConfig itself) can decide
+     * whether the full-document SSR pass buffers until every Suspense boundary
+     * resolves. Absent/`false` means stream the shell first.
+     */
+    ssrBlocking?: boolean;
 }
 export interface SsrFromRscInput {
     request?: Request;
@@ -70,4 +77,11 @@ export interface SsrFromRscInput {
     injectThemeInitScript?: boolean;
     lateControl?: Promise<SsrLateRedirect | null>;
     onCancel?: (reason?: unknown) => void;
+    /**
+     * When true, buffer the whole document until every Suspense boundary resolves
+     * (`stream.allReady`) before emitting a byte, matching `pageConfig.ssr:
+     * "block"`. Defaults to shell-first streaming so `Loading` fallbacks surface.
+     * The `AKAN_SSR_WAIT_FOR_ALL_READY=1` env var forces blocking globally.
+     */
+    waitForAllReady?: boolean;
 }

package/types/service/ipcTypes.d.ts

@@ -1,5 +1,5 @@
 export type AkanChildRole = "all" | "federation" | "batch";
-export type AkanChildStatus = "starting" | "ready" | "healthy" | "draining" | "unhealthy" | "exited";
+export type AkanChildStatus = "starting" | "ready" | "healthy" | "draining" | "unhealthy" | "exited" | "crashed";
 export type AkanUpstream = {
     type: "unix";
     socketPath: string;
@@ -122,6 +122,10 @@ export type AkanIpcMessage = {
     replicaIdx: number;
     role: AkanChildRole;
     upstream?: AkanUpstream;
+    /** Actual websocket upstream the child bound; may differ from the preferred port when it was in use. */
+    wsUpstream?: Extract<AkanUpstream, {
+        type: "tcp";
+    }>;
     healthPath?: string;
 } | {
     type: "backend-ready";

package/types/signal/guard.d.ts

@@ -1,7 +1,7 @@
-import type { Cls } from "akanjs/base";
+import type { Cls, PromiseOrObject } from "akanjs/base";
 import type { SignalContext } from "./signalContext.d.ts";
 export interface Guard {
-    canPass(context: SignalContext): boolean;
+    canPass(context: SignalContext): PromiseOrObject<boolean>;
 }
 export type GuardCls<Name extends string = string> = Cls<Guard, {
     readonly name: Name;

package/types/signal/signalContext.d.ts

@@ -30,6 +30,7 @@ export declare class SignalContext<Ctx extends HttpExecutionContext | WebSocketE
         middleware: Map<string, MiddlewareCls>;
     });
     getAdaptor<T extends Adaptor>(adaptorCls: AdaptorCls<T>): T;
+    getService<T>(refName: string): T;
     init(): Promise<this>;
     exec(): Promise<Response | undefined>;
     static try(endpoint: Adaptor, endpointInfo: EndpointInfo, key: string, fn: () => Promise<Response | undefined>): Promise<Response | undefined>;

package/types/ui/Load/Units.d.ts

@@ -13,7 +13,7 @@ interface DefaultProps<L extends {
     loading?: ReactNode;
     filter?: (item: L, idx: number) => boolean;
     sort?: (a: L, b: L) => number;
-    renderEmpty?: null | (() => ReactNode);
+    renderEmpty?: null | (() => ReactNode) | false;
     renderItem?: (item: L, idx: number) => ReactNode;
     renderList?: (list: DataList<L>) => ReactNode;
     reverse?: boolean;

package/types/ui/Model/LoadView.d.ts

@@ -0,0 +1,10 @@
+import type { ClientView } from "akanjs/fetch";
+interface LoadViewProps<T extends string, Model extends {
+    id: string;
+}> {
+    view: ClientView<T, Model>;
+}
+export default function LoadView<T extends string, Light extends {
+    id: string;
+}>({ view }: LoadViewProps<T, Light>): import("react/jsx-runtime").JSX.Element;
+export {};

package/types/ui/Model/index.d.ts

@@ -8,6 +8,7 @@ export declare const Model: {
     Remove: typeof import("./Remove.d.ts").default;
     RemoveWrapper: typeof import("./RemoveWrapper.d.ts").default;
     LoadInit: typeof import("./LoadInit.d.ts").default;
+    LoadView: typeof import("./LoadView.d.ts").default;
     ViewWrapper: typeof import("./ViewWrapper.d.ts").default;
     ViewEditModal: typeof import("./ViewEditModal.d.ts").default;
     Edit: typeof import("./Edit.d.ts").default;

package/types/ui/Model/index_.d.ts

@@ -7,6 +7,7 @@ export declare const NewWrapper: typeof import("./NewWrapper.d.ts").default;
 export declare const EditWrapper: typeof import("./EditWrapper.d.ts").default;
 export declare const RemoveWrapper: typeof import("./RemoveWrapper.d.ts").default;
 export declare const LoadInit: typeof import("./LoadInit.d.ts").default;
+export declare const LoadView: typeof import("./LoadView.d.ts").default;
 export declare const ViewWrapper: typeof import("./ViewWrapper.d.ts").default;
 export declare const ViewEditModal: typeof import("./ViewEditModal.d.ts").default;
 export declare const Edit: typeof import("./Edit.d.ts").default;

package/types/webkit/index.d.ts

@@ -3,9 +3,13 @@ export { createRobotPage } from "./createRobotPage.d.ts";
 export { createSitemapPage } from "./createSitemapPage.d.ts";
 export { lazy } from "./lazy.d.ts";
 export type * from "./types.d.ts";
+export { useCamera } from "./useCamera.d.ts";
+export { useCodepush } from "./useCodepush.d.ts";
+export { useContact } from "./useContact.d.ts";
 export { useCsrValues } from "./useCsrValues.d.ts";
 export { useDebounce } from "./useDebounce.d.ts";
 export { useFetch, useFetchFn } from "./useFetch.d.ts";
+export { useGeoLocation } from "./useGeoLocation.d.ts";
 export { useHistory } from "./useHistory.d.ts";
 export { useInterval } from "./useInterval.d.ts";
 export { useLocation } from "./useLocation.d.ts";

package/types/webkit/useCamera.d.ts

@@ -0,0 +1,19 @@
+import { type CapacitorPermissionState } from "akanjs/client/capacitor";
+type PermissionStatus = {
+    camera: CapacitorPermissionState;
+    photos: CapacitorPermissionState;
+};
+/** Capacitor camera/photos hook with permission checks and app-settings fallback. */
+export declare const useCamera: () => {
+    permissions: PermissionStatus;
+    getPhoto: (src?: "prompt" | "camera" | "photos") => Promise<{
+        [key: string]: unknown;
+        dataUrl?: string;
+    } | undefined>;
+    pickImage: () => Promise<{
+        [key: string]: unknown;
+        photos: unknown[];
+    }>;
+    checkPermission: (type: "photos" | "camera" | "all") => Promise<void>;
+};
+export {};

package/types/webkit/useCodepush.d.ts

@@ -0,0 +1,16 @@
+import type { ProtoAppInfo, ProtoFile } from "akanjs/constant";
+export declare const useCodepush: ({ serverUrl }: {
+    serverUrl: string;
+}) => {
+    update: boolean;
+    version: string;
+    initialize: () => Promise<void>;
+    checkNewRelease: () => Promise<{
+        release: ProtoAppInfo & {
+            appBuild: string;
+        };
+        bundleFile: ProtoFile;
+    } | undefined>;
+    codepush: () => Promise<void>;
+    statManager: () => Promise<void>;
+};

package/types/webkit/useContact.d.ts

@@ -0,0 +1,11 @@
+import { type CapacitorPermissionState } from "akanjs/client/capacitor";
+type PermissionStatus = {
+    contacts: CapacitorPermissionState;
+};
+/** Capacitor contacts hook with permission checks and contact loading helpers. */
+export declare const useContact: () => {
+    permissions: PermissionStatus;
+    getContacts: () => Promise<unknown[]>;
+    checkPermission: () => Promise<void>;
+};
+export {};

package/types/webkit/useGeoLocation.d.ts

@@ -0,0 +1,8 @@
+/** Capacitor geolocation hook with permission checks and current position lookup. */
+export declare const useGeoLocation: () => {
+    checkPermission: () => Promise<{
+        geolocation: string;
+        coarseLocation: string;
+    }>;
+    getPosition: () => Promise<unknown>;
+};

package/types/webkit/usePurchase.d.ts

@@ -0,0 +1,19 @@
+import "cordova-plugin-purchase/www/store";
+export type PlatformType = "android" | "ios" | "all";
+export interface ProductType {
+    id: string;
+    type: keyof typeof CdvPurchase.ProductType;
+}
+export type CdvProductType = CdvPurchase.ProductType;
+export declare const usePurchase: ({ platform, productInfo, url, onPay, onSubscribe, }: {
+    platform: PlatformType;
+    productInfo: ProductType[];
+    url: string;
+    onPay?: (transaction: CdvPurchase.Transaction) => void | Promise<void>;
+    onSubscribe?: (transaction: CdvPurchase.Transaction) => void | Promise<void>;
+}) => {
+    isLoading: boolean;
+    products: CdvPurchase.Product[];
+    purchaseProduct: (product: CdvPurchase.Product) => Promise<void>;
+    restorePurchases: () => Promise<void>;
+};

package/ui/Load/Units.tsx

@@ -23,7 +23,7 @@ interface DefaultProps<L extends { id: string }> {
   loading?: ReactNode;
   filter?: (item: L, idx: number) => boolean;
   sort?: (a: L, b: L) => number;
-  renderEmpty?: null | (() => ReactNode);
+  renderEmpty?: null | (() => ReactNode) | false;
   renderItem?: (item: L, idx: number) => ReactNode;
   renderList?: (list: DataList<L>) => ReactNode;
   reverse?: boolean;
@@ -172,7 +172,7 @@ function Render<RefName extends string, Light extends { id: string }>({
   if (renderList)
     return (
       <>
-        {modelDataList.length ? (
+        {modelDataList.length || renderEmpty === false ? (
           <ContainerWrapper
             containerRef={containerRef}
             className={clsx(className, {

package/ui/Model/LoadView.tsx

@@ -0,0 +1,11 @@
+"use client";
+import type { ClientView } from "akanjs/fetch";
+
+import { Load } from "../Load";
+
+interface LoadViewProps<T extends string, Model extends { id: string }> {
+  view: ClientView<T, Model>;
+}
+export default function LoadView<T extends string, Light extends { id: string }>({ view }: LoadViewProps<T, Light>) {
+  return <Load.View view={view} renderView={() => null} loading={null} />;
+}