akanjs 3.0.0-alpha.5 → 3.0.0-alpha.7

package/client/clientRuntime.ts

@@ -75,6 +75,13 @@ globalWithRuntime[CLIENT_RUNTIME_KEY] = state;
 const missingRuntimeError = () =>
   new Error("Akan client runtime is not registered. Import the generated app client first.");
 
+const applyRuntimeErrorConstructor = (runtime: ClientRuntime) => {
+  const instance = (runtime.fetch as RuntimeFetch | undefined)?.instance as
+    | { setErrorConstructor?: (Err: unknown) => void }
+    | undefined;
+  if (typeof instance?.setErrorConstructor === "function") instance.setErrorConstructor(runtime.Err);
+};
+
 export const registerClientRuntime = <Runtime>(
   runtime: Runtime,
   { scope = "app" }: { scope?: RuntimeScope } = {},
@@ -82,6 +89,7 @@ export const registerClientRuntime = <Runtime>(
   if (state.scope === "app" && scope === "lib") return runtime;
   state.runtime = runtime as ClientRuntime;
   state.scope = scope;
+  applyRuntimeErrorConstructor(state.runtime);
   return runtime;
 };
 

package/client/cn.ts

@@ -38,10 +38,17 @@ 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.
+ */
+export const radiusTokens = ["box", "field"];
+
 const twMerge = extendTailwindMerge({
   extend: {
     theme: {
       color: colorTokens,
+      radius: radiusTokens,
     },
   },
 });

package/client/csrTypes.ts

@@ -455,6 +455,7 @@ export interface FrameLayoutState {
   keyboard: KeyboardFrameState;
   contentViewport: FrameContentViewportState;
   keyboardAccessory: KeyboardAccessoryFrameState;
+  contentAnchor?: "bottom";
   platformProfile: FramePlatformProfile;
   zIndex: FrameLayerZIndex;
   pageStateByPath: Map<string, PageState>;
@@ -463,6 +464,7 @@ export interface FrameSlotRegistration {
   scope?: FrameSlotScope;
   type: FrameSlotType;
   role?: FrameSlotRole;
+  contentAnchor?: "bottom";
   height?: number;
   estimatedHeight?: number;
   source?: "navbar" | "topInset" | "bottomInset" | "bottomTab" | (string & {});

package/client/frameDebug.ts

@@ -20,9 +20,10 @@ const isFrameDebugEnabled = () => {
 export function debugFrame(event: string, payload: DebugPayload = {}) {
   if (!isFrameDebugEnabled()) return;
   debugSeq += 1;
-  console.info(`[akan:frame:${debugSessionId}:${debugSeq}] ${event}`, {
+  const details = {
     href: window.location.href,
     now: Math.round(performance.now()),
     ...payload,
-  });
+  };
+  console.info(`[akan:frame:${debugSessionId}:${debugSeq}] ${event}`, details, JSON.stringify(details));
 }

package/common/index.ts

@@ -36,12 +36,17 @@ export { randomPicks } from "./randomPicks";
 export {
   assertUniqueRoutePatterns,
   compareRouteSpecificity,
+  getRouteExports,
   isRouteSourceFile,
   isSpecialRouteLeaf,
+  LAYOUT_ROUTE_EXPORTS,
   matchRoutePattern,
   normalizeRoutePattern,
+  PAGE_ROUTE_EXPORTS,
   type ParsedRouteModuleKey,
   parseRouteModuleKey,
+  RESERVED_ROUTE_CONFIG_EXPORTS,
+  ROOT_LAYOUT_ROUTE_EXPORTS,
   type RouteModuleKind,
   routeSegmentToPatternPart,
   routeSegmentToTreePath,

package/common/routeConvention.ts

@@ -9,6 +9,36 @@ const DIRECTORY_SCOPED_LEAVES = new Set(["_layout", "_index", "_overrides"]);
 
 export type RouteModuleKind = "page" | "layout" | "overrides";
 
+export const PAGE_ROUTE_EXPORTS: ReadonlySet<string> = new Set([
+  "default",
+  "pageConfig",
+  "head",
+  "metadata",
+  "generateHead",
+  "generateMetadata",
+  "Loading",
+]);
+export const LAYOUT_ROUTE_EXPORTS: ReadonlySet<string> = new Set([...PAGE_ROUTE_EXPORTS, "NotFound", "Error"]);
+export const ROOT_LAYOUT_ROUTE_EXPORTS: ReadonlySet<string> = new Set([
+  ...LAYOUT_ROUTE_EXPORTS,
+  "fonts",
+  "manifest",
+  "theme",
+  "reconnect",
+  "wsConnect",
+  "layoutStyle",
+  "gaTrackingId",
+]);
+/** Root-layout exports that are plain config rather than components, so a PascalCase check cannot allow them. */
+export const RESERVED_ROUTE_CONFIG_EXPORTS: ReadonlySet<string> = new Set(
+  [...ROOT_LAYOUT_ROUTE_EXPORTS].filter((name) => name !== "default" && !/^[A-Z]/.test(name)),
+);
+
+export function getRouteExports(kind: "page" | "layout", { rootLayout = false } = {}): ReadonlySet<string> {
+  if (kind === "page") return PAGE_ROUTE_EXPORTS;
+  return rootLayout ? ROOT_LAYOUT_ROUTE_EXPORTS : LAYOUT_ROUTE_EXPORTS;
+}
+
 export interface ParsedRouteModuleKey {
   key: string;
   kind: RouteModuleKind;

package/document/into.ts

@@ -88,6 +88,8 @@ export type Mdl<
   updateMany(query: _RawQuery, update: DocumentUpdateInput<_RawDoc>): Promise<UpdateResult>;
   removeOne(query: _RawQuery): Promise<UpdateResult>;
   removeMany(query: _RawQuery): Promise<UpdateResult>;
+  updateById(id: string, update: DocumentUpdateInput<_RawDoc>, options?: DocumentUpdateOptions): Promise<UpdateResult>;
+  removeById(id: string): Promise<UpdateResult>;
   bulkWrite(operations: BulkWriteOperation<Raw, _RawDoc, _RawQuery>[]): Promise<UpdateResult>;
   /** @deprecated Renamed to `count`. */
   countDocuments(query: _RawQuery): Promise<number>;

package/fetch/client/fetchClient.ts

@@ -37,6 +37,16 @@ export type FetchProxy<
   FetchClient &
   FetchType & { slice: SliceMetaObj; instance: FetchClient; _FetchType: FetchType; _SliceMetaObj: SliceMetaObj };
 
+interface SharedClientState {
+  proxy: FetchProxy | null;
+  origin: string | null;
+}
+
+const SHARED_CLIENT_KEY = Symbol.for("akanjs.fetch.sharedClient");
+const globalWithSharedClient = globalThis as typeof globalThis & { [SHARED_CLIENT_KEY]?: SharedClientState };
+const sharedClientState: SharedClientState = globalWithSharedClient[SHARED_CLIENT_KEY] ?? { proxy: null, origin: null };
+globalWithSharedClient[SHARED_CLIENT_KEY] = sharedClientState;
+
 type ClientSignalMap<SigType extends { fetch: any }> = {
   [K in keyof SigType as SigType[K] extends DatabaseSignal<any, any, any, any>
     ? K
@@ -80,6 +90,19 @@ export class FetchClient {
     FetchClient.#sharedSerializedSignal = {};
     FetchClient.#sharedRegistryVersion++;
   }
+  static resetSharedClient() {
+    sharedClientState.proxy = null;
+    sharedClientState.origin = null;
+  }
+  static #resolveSharedClientProxy(origin: string, Err?: ErrorConstructor) {
+    if (typeof window === "undefined") return null;
+    
+    if (sharedClientState.proxy) return sharedClientState.origin === origin ? sharedClientState.proxy : null;
+    const proxy = FetchClient.#makeProxy<unknown, Record<string, SliceMeta>>(new FetchClient(origin, {}, {}, Err));
+    sharedClientState.proxy = proxy;
+    sharedClientState.origin = origin;
+    return proxy;
+  }
   static #mergeSerializedSignalInto(
     serializedSignal: { [key: string]: SerializedSignal },
     refName: string,
@@ -700,10 +723,11 @@ export class FetchClient {
     sig: ClientSignalMap<SigType>;
     fetch: SigType["fetch"];
   } {
-    if (base) base.instance.applySignal(serializedSignal);
+    const shared = base ?? FetchClient.#resolveSharedClientProxy(origin, Err);
+    if (shared) shared.instance.applySignal(serializedSignal);
     if (base && Err) base.instance.setErrorConstructor(Err);
     const proxy =
-      base ??
+      shared ??
       FetchClient.#makeProxy<unknown, Record<string, SliceMeta>>(new FetchClient(origin, {}, serializedSignal, Err));
     if (connect) proxy.instance.connect();
     const sig = {} as any;

package/fetch/client/wsClient.ts

@@ -40,6 +40,8 @@ export class WsClient {
   #roomSubscribeMap = new Map<string, SubscribeOption>();
   #listenerMap = new Map<string, Set<Listener>>();
   #destroyed = false;
+  #connectRequested = false;
+  #unconnectedWarnTimers = new Map<string, ReturnType<typeof setTimeout>>();
   #jwt: string | null = null;
   connected = false;
 
@@ -70,6 +72,7 @@ export class WsClient {
   }
 
   connect() {
+    this.#connectRequested = true;
     if (this.#ws && this.#ws.readyState !== WebSocket.CLOSED) return;
     this.logger.debug(`Connecting to ${this.url}`);
     this.#destroyed = false;
@@ -187,10 +190,13 @@ export class WsClient {
   destroy() {
     this.logger.debug(`WebSocket destroying`);
     this.#destroyed = true;
+    this.#connectRequested = false;
     if (this.#reconnectTimer) {
       clearTimeout(this.#reconnectTimer);
       this.#reconnectTimer = null;
     }
+    for (const timer of this.#unconnectedWarnTimers.values()) clearTimeout(timer);
+    this.#unconnectedWarnTimers.clear();
     this.#ws?.close();
     this.#ws = null;
   }
@@ -231,9 +237,18 @@ export class WsClient {
   }
   #warnNotConnected(action: "emit" | "subscribe", key: string) {
     console.warn(
-      `[akanjs] WebSocket is not connected. Call fetch.instance.connect() or enable root layout "wsConnect" before ${action} "${key}".`,
+      `[akanjs] WebSocket is not connected. Call fetch.instance.connect(), or drop the root layout "wsConnect = false", before ${action} "${key}".`,
     );
   }
+  #warnUnconnectedSubscribe(key: string) {
+    if (this.#connectRequested || this.#unconnectedWarnTimers.has(key)) return;
+    const timer = setTimeout(() => {
+      this.#unconnectedWarnTimers.delete(key);
+      if (this.#connectRequested || this.#destroyed) return;
+      this.#warnNotConnected("subscribe", key);
+    }, 0);
+    this.#unconnectedWarnTimers.set(key, timer);
+  }
   emit(key: string, data: WsRequestPayload) {
     if (this.#ws?.readyState !== WebSocket.OPEN) {
       this.logger.warn("WebSocket not connected");
@@ -246,7 +261,7 @@ export class WsClient {
   }
   subscribe(option: { key: string; data: unknown[]; handleEvent: (data: unknown) => void }) {
     const roomId = WsClient.makeRoomId(option.key, option.data);
-    if (!this.#ws) this.#warnNotConnected("subscribe", option.key);
+    if (!this.#ws) this.#warnUnconnectedSubscribe(option.key);
     if (!this.#roomSubscribeMap.has(roomId)) {
       this.#roomSubscribeMap.set(roomId, { key: option.key, data: option.data, listener: new Set() });
       if (this.#ws?.readyState === WebSocket.OPEN) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-alpha.5",
+  "version": "3.0.0-alpha.7",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/server/resolver/CascadeRunner.ts

@@ -186,7 +186,7 @@ export class CascadeRunner {
     }
     if (!lines.length) return;
     const bulk = lines.filter((line) => line.endsWith("(bulk)")).length;
-    this.#logger.info(`${lines.length} cascade edge(s), ${bulk} in one query`);
+    this.#logger.verbose(`${lines.length} cascade edge(s), ${bulk} in one query`);
     for (const line of lines) this.#logger.verbose(line);
   }
 

package/server/resolver/database.resolver.ts

@@ -240,6 +240,9 @@ export class DatabaseResolver {
           updateMany: (query: QueryOf<any>, update: DocumentUpdateInput) => store.updateManyByQuery(query, update),
           removeOne: (query: QueryOf<any>) => store.removeOneByQuery(query),
           removeMany: (query: QueryOf<any>) => store.removeManyByQuery(query),
+          updateById: (id: string, update: DocumentUpdateInput, options?: { upsert?: boolean }) =>
+            store.updateOneByQuery({ id }, update, options),
+          removeById: (id: string) => store.removeOneByQuery({ id }),
           
           countDocuments: (query: QueryOf<any>) => store.count(query),
           bulkWrite: (

package/server/routeTreeBuilder.ts

@@ -13,6 +13,7 @@ import type {
 import {
   assertUniqueRoutePatterns,
   compareRouteSpecificity,
+  getRouteExports,
   matchRoutePattern,
   parseBasePaths,
   parseRouteModuleKey,
@@ -49,44 +50,6 @@ export interface RouteModuleCacheStats {
 }
 
 export class RouteTreeBuilder {
-  static readonly #pageRouteExports = new Set([
-    "default",
-    "pageConfig",
-    "head",
-    "metadata",
-    "generateHead",
-    "generateMetadata",
-    "Loading",
-  ]);
-  static readonly #rootLayoutExports = new Set([
-    "default",
-    "pageConfig",
-    "head",
-    "metadata",
-    "generateHead",
-    "generateMetadata",
-    "fonts",
-    "manifest",
-    "theme",
-    "reconnect",
-    "wsConnect",
-    "layoutStyle",
-    "gaTrackingId",
-    "Loading",
-    "NotFound",
-    "Error",
-  ]);
-  static readonly #layoutRouteExports = new Set([
-    "default",
-    "pageConfig",
-    "head",
-    "metadata",
-    "generateHead",
-    "generateMetadata",
-    "Loading",
-    "NotFound",
-    "Error",
-  ]);
   static readonly #moduleCacheStats: RouteModuleCacheStats = {
     moduleCount: 0,
     loadedModuleCount: 0,
@@ -309,12 +272,7 @@ export class RouteTreeBuilder {
       return;
     }
     const parsed = parseRouteModuleKey(key);
-    const allowed =
-      kind === "page"
-        ? RouteTreeBuilder.#pageRouteExports
-        : parsed.isInternalRootLayout
-          ? RouteTreeBuilder.#rootLayoutExports
-          : RouteTreeBuilder.#layoutRouteExports;
+    const allowed = getRouteExports(kind, { rootLayout: parsed.isInternalRootLayout });
     for (const exportName of Object.keys(mod)) {
       if (!allowed.has(exportName)) {
         throw new Error(`[route-convention] unsupported export "${exportName}" in ${key}`);

package/server/webRouter.ts

@@ -1,5 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import { getEnv } from "akanjs/base";
 import {
   type AkanI18nConfig,
@@ -61,6 +62,18 @@ export const DEFAULT_HTML_RESULT_CACHE_MAX_BODY_BYTES = 2 * 1024 * 1024;
 const ROUTE_CACHE_SWEEP_INTERVAL_MS = 60_000;
 const APPLE_APP_SITE_ASSOCIATION_PATH = "/.well-known/apple-app-site-association";
 const ANDROID_ASSET_LINKS_PATH = "/.well-known/assetlinks.json";
+const FIREBASE_MESSAGING_SW_PATH = "/firebase-messaging-sw.js";
+const FIREBASE_WEB_SDK_VERSION = "12.13.0";
+
+interface FirebaseClientEnvConfig {
+  apiKey: string;
+  authDomain?: string;
+  projectId: string;
+  storageBucket?: string;
+  messagingSenderId: string;
+  appId: string;
+  vapidKey?: string;
+}
 
 export function createRscRedirectResponse(
   location: string,
@@ -488,6 +501,16 @@ export class WebRouter {
         WebRouter.#deepLinkAssociationResponse(ANDROID_ASSET_LINKS_PATH, this.#artifact, {
           cacheControl: this.#prodMode ? "public, max-age=3600" : "no-store",
         }) ?? new Response("Not Found", { status: 404 }),
+      [FIREBASE_MESSAGING_SW_PATH]: async () => {
+        this.#requestStats.staticAsset += 1;
+        const firebaseConfig = await WebRouter.#resolveFirebaseClientConfig();
+        return new Response(WebRouter.#createFirebaseMessagingServiceWorker(firebaseConfig), {
+          headers: {
+            "Content-Type": "application/javascript; charset=utf-8",
+            "Cache-Control": "no-store",
+          },
+        });
+      },
       "/*": async (req) => {
         const url = new URL(req.url);
         if (WebRouter.#isImageOptimizerPath(url.pathname)) {
@@ -1008,6 +1031,79 @@ export class WebRouter {
     return process.env.AKAN_APP_DIR ?? path.dirname(Bun.main);
   }
 
+  static async #resolveFirebaseClientConfig(): Promise<FirebaseClientEnvConfig | null> {
+    const envPath = path.join(WebRouter.#resolveAppDir(), "env", "env.client.ts");
+    if (!fs.existsSync(envPath)) return null;
+    try {
+      const envUrl = pathToFileURL(envPath);
+      envUrl.searchParams.set("t", String(Date.now()));
+      const envModule = (await import(envUrl.href)) as { env?: { firebase?: unknown } };
+      return WebRouter.#normalizeFirebaseClientConfig(envModule.env?.firebase);
+    } catch {
+      return null;
+    }
+  }
+
+  static #normalizeFirebaseClientConfig(config: unknown): FirebaseClientEnvConfig | null {
+    if (!config || typeof config !== "object") return null;
+    const value = config as Partial<Record<keyof FirebaseClientEnvConfig, unknown>>;
+    if (
+      typeof value.apiKey !== "string" ||
+      typeof value.projectId !== "string" ||
+      typeof value.messagingSenderId !== "string" ||
+      typeof value.appId !== "string"
+    ) {
+      return null;
+    }
+    return {
+      apiKey: value.apiKey,
+      ...(typeof value.authDomain === "string" ? { authDomain: value.authDomain } : {}),
+      projectId: value.projectId,
+      ...(typeof value.storageBucket === "string" ? { storageBucket: value.storageBucket } : {}),
+      messagingSenderId: value.messagingSenderId,
+      appId: value.appId,
+    };
+  }
+
+  static #createFirebaseMessagingServiceWorker(config: FirebaseClientEnvConfig | null): string {
+    const configJson = JSON.stringify(config);
+    return `/* Generated by Akan.js. Do not edit. */
+const firebaseConfig = ${configJson};
+
+if (firebaseConfig) {
+  importScripts("https://www.gstatic.com/firebasejs/${FIREBASE_WEB_SDK_VERSION}/firebase-app-compat.js");
+  importScripts("https://www.gstatic.com/firebasejs/${FIREBASE_WEB_SDK_VERSION}/firebase-messaging-compat.js");
+
+  firebase.initializeApp(firebaseConfig);
+  const messaging = firebase.messaging();
+
+  const notificationUrl = (payload) =>
+    payload?.data?.url || payload?.fcmOptions?.link || payload?.notification?.click_action;
+
+  messaging.onBackgroundMessage((payload) => {
+    const title = payload?.notification?.title || "";
+    const options = {
+      body: payload?.notification?.body,
+      icon: payload?.notification?.icon,
+      image: payload?.notification?.image,
+      data: {
+        url: notificationUrl(payload),
+        FCM_MSG: payload,
+      },
+    };
+    self.registration.showNotification(title, options);
+  });
+}
+
+self.addEventListener("notificationclick", (event) => {
+  const url = event.notification?.data?.url || event.notification?.data?.FCM_MSG?.data?.url;
+  event.notification?.close();
+  if (!url) return;
+  event.waitUntil(clients.openWindow(url));
+});
+`;
+  }
+
   static #normalizeArtifact(artifact: BaseBuildArtifact, artifactDir: string): BaseBuildArtifact {
     const normalizedArtifactDir = path.resolve(artifactDir);
     const pagesBundlePath = WebRouter.#resolveArtifactPath(artifact.pagesBundlePath, normalizedArtifactDir);

package/store/types.ts

@@ -36,6 +36,13 @@ export type Get<State, Actions> = {
   get: () => State & Actions;
 };
 
+type VoidAction<T> = T extends (...args: infer Args) => infer Ret
+  ? [Ret] extends [PromiseLike<unknown>]
+    ? (...args: Args) => Promise<void>
+    : (...args: Args) => void
+  : T;
+export type VoidActions<Action> = { [K in keyof Action]: VoidAction<Action[K]> };
+
 export type StoreSliceMap<SlceCls extends SliceCls> = SlceCls[typeof SLICE_META];
 export type StoreSliceSuffix<SlceCls extends SliceCls, Suffix extends keyof StoreSliceMap<SlceCls>> = Suffix & string;
 export type StoreSliceSuffixCap<SlceCls extends SliceCls, Suffix extends keyof StoreSliceMap<SlceCls>> = Capitalize<

package/store/withSelector.ts

@@ -2,7 +2,7 @@ import type { Prettify } from "akanjs/base";
 import type { FieldState } from "akanjs/constant";
 import type { RefObject } from "react";
 import type { RootStoreCls } from "./rootStore";
-import type { SliceStateAction } from "./types";
+import type { SliceStateAction, VoidActions } from "./types";
 
 type SetKey<Key extends string> = `set${Capitalize<Key>}`;
 
@@ -28,7 +28,7 @@ type WithSelectorsOf<State, WritableState, Action, InternalSliceObj> = {
   use: {
     [K in keyof State]: () => State[K];
   };
-  do: Action & {
+  do: VoidActions<Action> & {
     [K in keyof WritableState as K extends string ? SetKey<K> : never]: (value: FieldState<WritableState[K]>) => void;
   };
   get: () => State;
@@ -52,9 +52,7 @@ export interface SliceSelectors<RefName extends string, State, Action> {
     [K in keyof State]: () => State[K];
   };
   do: Prettify<
-    {
-      [K in keyof Action]: Action[K];
-    } & {
+    VoidActions<Action> & {
       [K in keyof State as K extends string ? SetKey<K> : never]: (value: FieldState<State[K]>) => void;
     }
   >;

package/types/client/cn.d.ts

@@ -6,6 +6,11 @@ import { type ClassNameValue } from "tailwind-merge";
  * `cn("bg-primary", "bg-open")` correctly resolves to `"bg-open"` instead of keeping both.
  */
 export declare const colorTokens: string[];
+/**
+ * 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.
+ */
+export declare const radiusTokens: string[];
 /** 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"`. */

package/types/client/csrTypes.d.ts

@@ -428,6 +428,7 @@ export interface FrameLayoutState {
     keyboard: KeyboardFrameState;
     contentViewport: FrameContentViewportState;
     keyboardAccessory: KeyboardAccessoryFrameState;
+    contentAnchor?: "bottom";
     platformProfile: FramePlatformProfile;
     zIndex: FrameLayerZIndex;
     pageStateByPath: Map<string, PageState>;
@@ -436,6 +437,7 @@ export interface FrameSlotRegistration {
     scope?: FrameSlotScope;
     type: FrameSlotType;
     role?: FrameSlotRole;
+    contentAnchor?: "bottom";
     height?: number;
     estimatedHeight?: number;
     source?: "navbar" | "topInset" | "bottomInset" | "bottomTab" | (string & {});

package/types/common/index.d.ts

@@ -23,7 +23,7 @@ export { pathGet } from "./pathGet.d.ts";
 export { pathSet } from "./pathSet.d.ts";
 export { randomPick } from "./randomPick.d.ts";
 export { randomPicks } from "./randomPicks.d.ts";
-export { assertUniqueRoutePatterns, compareRouteSpecificity, isRouteSourceFile, isSpecialRouteLeaf, matchRoutePattern, normalizeRoutePattern, type ParsedRouteModuleKey, parseRouteModuleKey, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
+export { assertUniqueRoutePatterns, compareRouteSpecificity, getRouteExports, isRouteSourceFile, isSpecialRouteLeaf, LAYOUT_ROUTE_EXPORTS, matchRoutePattern, normalizeRoutePattern, PAGE_ROUTE_EXPORTS, type ParsedRouteModuleKey, parseRouteModuleKey, RESERVED_ROUTE_CONFIG_EXPORTS, ROOT_LAYOUT_ROUTE_EXPORTS, type RouteModuleKind, routeSegmentToPatternPart, routeSegmentToTreePath, tryParseRouteModuleKey, type ValidatePageSourceFileOptions, type ValidateSubRoutePageKeyOptions, validatePageSourceFile, validateSubRoutePageKey, } from "./routeConvention.d.ts";
 export { sleep } from "./sleep.d.ts";
 export { splitVersion } from "./splitVersion.d.ts";
 export { getBasePathFromPathname, parseBasePaths, parseSubRouteHosts, resolveSubRouteHosts } from "./subRoute.d.ts";

package/types/common/routeConvention.d.ts

@@ -1,4 +1,12 @@
 export type RouteModuleKind = "page" | "layout" | "overrides";
+export declare const PAGE_ROUTE_EXPORTS: ReadonlySet<string>;
+export declare const LAYOUT_ROUTE_EXPORTS: ReadonlySet<string>;
+export declare const ROOT_LAYOUT_ROUTE_EXPORTS: ReadonlySet<string>;
+/** Root-layout exports that are plain config rather than components, so a PascalCase check cannot allow them. */
+export declare const RESERVED_ROUTE_CONFIG_EXPORTS: ReadonlySet<string>;
+export declare function getRouteExports(kind: "page" | "layout", { rootLayout }?: {
+    rootLayout?: boolean | undefined;
+}): ReadonlySet<string>;
 export interface ParsedRouteModuleKey {
     key: string;
     kind: RouteModuleKind;

package/types/document/into.d.ts

@@ -62,6 +62,8 @@ export type Mdl<Doc, Raw, _RawDoc = DocumentModel<Raw>, _RawQuery extends Docume
     updateMany(query: _RawQuery, update: DocumentUpdateInput<_RawDoc>): Promise<UpdateResult>;
     removeOne(query: _RawQuery): Promise<UpdateResult>;
     removeMany(query: _RawQuery): Promise<UpdateResult>;
+    updateById(id: string, update: DocumentUpdateInput<_RawDoc>, options?: DocumentUpdateOptions): Promise<UpdateResult>;
+    removeById(id: string): Promise<UpdateResult>;
     bulkWrite(operations: BulkWriteOperation<Raw, _RawDoc, _RawQuery>[]): Promise<UpdateResult>;
     /** @deprecated Renamed to `count`. */
     countDocuments(query: _RawQuery): Promise<number>;

package/types/fetch/client/fetchClient.d.ts

@@ -35,6 +35,7 @@ export declare class FetchClient {
         [key: string]: SerializedSignal;
     }, ErrorCls?: ErrorConstructor | undefined);
     static resetSharedRegistry(): void;
+    static resetSharedClient(): void;
     setErrorConstructor(ErrorCls?: ErrorConstructor): void;
     applySignal(serializedSignal: {
         [key: string]: SerializedSignal;

package/types/store/baseSt.d.ts

@@ -297,7 +297,7 @@ export declare const st: {
         deviceToken: () => string;
         currentPath: () => string;
     };
-    do: RootStore & {
+    do: import("./types.d.ts").VoidActions<RootStore> & {
         setCsrLoaded: (value: boolean) => void;
         setPath: (value: string) => void;
         setPathname: (value: string) => void;

package/types/store/types.d.ts

@@ -30,6 +30,10 @@ export interface SetPick<State = any> {
 export type Get<State, Actions> = {
     get: () => State & Actions;
 };
+type VoidAction<T> = T extends (...args: infer Args) => infer Ret ? [Ret] extends [PromiseLike<unknown>] ? (...args: Args) => Promise<void> : (...args: Args) => void : T;
+export type VoidActions<Action> = {
+    [K in keyof Action]: VoidAction<Action[K]>;
+};
 export type StoreSliceMap<SlceCls extends SliceCls> = SlceCls[typeof SLICE_META];
 export type StoreSliceSuffix<SlceCls extends SliceCls, Suffix extends keyof StoreSliceMap<SlceCls>> = Suffix & string;
 export type StoreSliceSuffixCap<SlceCls extends SliceCls, Suffix extends keyof StoreSliceMap<SlceCls>> = Capitalize<StoreSliceSuffix<SlceCls, Suffix>>;

package/types/store/withSelector.d.ts

@@ -2,7 +2,7 @@ import type { Prettify } from "akanjs/base";
 import type { FieldState } from "akanjs/constant";
 import type { RefObject } from "react";
 import type { RootStoreCls } from "./rootStore.d.ts";
-import type { SliceStateAction } from "./types.d.ts";
+import type { SliceStateAction, VoidActions } from "./types.d.ts";
 type SetKey<Key extends string> = `set${Capitalize<Key>}`;
 export type WithSelectors<RtStoreCls extends RootStoreCls> = RtStoreCls extends RootStoreCls<any, infer WritableState, infer Action, infer InternalSliceObj, any, any, infer State> ? WithSelectorsOf<State, WritableState, Action, InternalSliceObj> : never;
 type WithSelectorsOf<State, WritableState, Action, InternalSliceObj> = {
@@ -18,7 +18,7 @@ type WithSelectorsOf<State, WritableState, Action, InternalSliceObj> = {
     use: {
         [K in keyof State]: () => State[K];
     };
-    do: Action & {
+    do: VoidActions<Action> & {
         [K in keyof WritableState as K extends string ? SetKey<K> : never]: (value: FieldState<WritableState[K]>) => void;
     };
     get: () => State;
@@ -32,9 +32,7 @@ export interface SliceSelectors<RefName extends string, State, Action> {
     use: {
         [K in keyof State]: () => State[K];
     };
-    do: Prettify<{
-        [K in keyof Action]: Action[K];
-    } & {
+    do: Prettify<VoidActions<Action> & {
         [K in keyof State as K extends string ? SetKey<K> : never]: (value: FieldState<State[K]>) => void;
     }>;
     get: () => State;

package/types/ui/CsrImage.d.ts

@@ -7,7 +7,7 @@ type CsrImageProps = Omit<ImgHTMLAttributes<HTMLImageElement>, "alt" | "src"> &
         imageSize: [number, number];
         abstractData?: string | null;
     } | null;
-    abstractData?: string;
+    abstractData?: string | null;
     priority?: boolean;
     preload?: boolean;
     quality?: number;

package/types/ui/Dropdown.d.ts

@@ -1,4 +1,6 @@
 import { type ReactNode } from "react";
+/** Put this on a menu item that runs its own interaction (a switch, a copy button) to keep the menu open. */
+export declare const DROPDOWN_KEEP_OPEN_ATTR = "data-dropdown-keep-open";
 export interface DropdownProps {
     /** Button/trigger content. */
     value: ReactNode;