akanjs 3.0.0-beta.2 → 3.0.0-beta.20

package/webkit/useDebounce.ts

@@ -2,18 +2,15 @@
 import { useCallback } from "react";
 
 const debounce = <Args extends unknown[], Return>(callback: (...args: Args) => Return, wait = 500) => {
-  
   let timer: NodeJS.Timeout;
   return (...args: Args) => {
     clearTimeout(timer);
-    
     timer = setTimeout(() => {
       callback(...args);
     }, wait);
   };
 };
 
-/** Returns a callback that runs only after calls have stopped for the wait time. */
 export const useDebounce = <Args extends unknown[], Return>(
   callback: (...args: Args) => Return,
   states: unknown[] = [],

package/webkit/useEscapeKey.tsx

@@ -1,14 +1,6 @@
 "use client";
 import { useEffect, useRef } from "react";
 
-/**
- * Escape belongs to the topmost dismissable surface only.
- *
- * A per-component `window` listener cannot know that: every open surface hears the same keydown, so a
- * dialog opened from another dialog took both down at once, and a confirm popover inside a modal would
- * have closed the modal under it. One shared stack keeps the order surfaces actually opened in and
- * hands the key to the last one.
- */
 const stack: (() => void)[] = [];
 
 const onKeyDown = (event: KeyboardEvent) => {
@@ -19,10 +11,7 @@ const onKeyDown = (event: KeyboardEvent) => {
   topmost();
 };
 
-/**
- * Close `onEscape` on Escape while `active`, but only while this surface is the topmost active one.
- * The callback is read through a ref, so a fresh closure per render does not reshuffle the stack.
- */
+/** Calls `onEscape` on Escape while `active` and this surface is the topmost active one. */
 export const useEscapeKey = (active: boolean, onEscape: () => void) => {
   const callbackRef = useRef(onEscape);
   useEffect(() => {

package/webkit/useFetch.ts

@@ -2,22 +2,18 @@
 import { isThenable } from "akanjs/common";
 import { useEffect, useMemo, useState } from "react";
 
-/** Tracks fulfillment state for a promise or immediate value inside a client component. */
 export const useFetch = <Return>(
   fnOrPromise: Promise<Return> | Return,
   { onError }: { onError?: (err: string) => void } = {},
 ): { fulfilled: boolean; value: Return | null } => {
-  const [asyncState, setAsyncState] = useState<{ fulfilled: boolean; value: Return | null }>({
-    fulfilled: false,
-    value: null,
-  });
+  const [settled, setSettled] = useState<{ source: unknown; value: Return } | null>(null);
   useEffect(() => {
     if (!isThenable(fnOrPromise)) return;
     let cancelled = false;
     void (async () => {
       try {
         const ret = await fnOrPromise;
-        if (!cancelled) setAsyncState({ fulfilled: true, value: ret });
+        if (!cancelled) setSettled({ source: fnOrPromise, value: ret });
       } catch (err) {
         if (cancelled) return;
         const content = `Error: ${typeof err === "string" ? err : (err as Error).message}`;
@@ -27,18 +23,16 @@ export const useFetch = <Return>(
     return () => {
       cancelled = true;
     };
-  }, []);
+  }, [fnOrPromise]);
   if (!isThenable(fnOrPromise)) {
     return { fulfilled: true, value: fnOrPromise as Return };
   }
-  return asyncState;
+  return settled?.source === fnOrPromise
+    ? { fulfilled: true, value: settled.value }
+    : { fulfilled: false, value: null };
 };
 
-/**
- * Like `useFetch`, but takes a factory function that is only called once
- * (or when `deps` change). Prevents duplicate network requests caused by
- * React re-renders.
- */
+/** Calls `factory` once per `deps` change, so a re-render does not start another request. */
 export const useFetchFn = <Return>(
   factory: () => Promise<Return> | Return,
   deps: unknown[] = [],

package/webkit/useFrameRuntime.ts

@@ -44,29 +44,8 @@ export const clonePageState = (pageState: PageState): PageState => ({ ...pageSta
 
 const resolveFrameSlotHeight = (slot: FrameSlotRegistration) => slot.height ?? slot.estimatedHeight ?? 0;
 
-const isInsetLockedByConfig = (_pathRoute: PathRoute, _key: "topInset" | "bottomInset") => {
-
-  return true;
-};
-
 const getLeafLayout = (pathRoute: PathRoute) => pathRoute.renderLayouts.at(-1);
 
-function isSlotEligibleForTarget({
-  sourcePath,
-  targetPath,
-  slot,
-  visiblePaths,
-}: {
-  sourcePath: string;
-  targetPath: string;
-  slot: FrameSlotRegistration;
-  visiblePaths: Set<string>;
-}) {
-  if (visiblePaths.has(sourcePath)) return true;
-  if (sourcePath === targetPath && slot.scope === "layout" && slot.cache) return true;
-  return slot.scope === "layout" && Boolean(slot.cache);
-}
-
 export function getFrameSlotsForPath(
   pathRoute: PathRoute,
   frameSlots: FrameSlotMap,
@@ -77,8 +56,8 @@ export function getFrameSlotsForPath(
   const targetLeafLayout = getLeafLayout(pathRoute);
   return Object.entries(frameSlots).flatMap(([sourcePath, slotsById]) => {
     const sourceRoute = routeByPath.get(sourcePath);
-    const slots = Object.values(slotsById).filter((slot) =>
-      isSlotEligibleForTarget({ sourcePath, targetPath: pathRoute.path, slot, visiblePaths }),
+    const slots = Object.values(slotsById).filter(
+      (slot) => visiblePaths.has(sourcePath) || (slot.scope === "layout" && Boolean(slot.cache)),
     );
     if (sourcePath === pathRoute.path) return slots;
     if (!sourceRoute || !targetLeafLayout || getLeafLayout(sourceRoute) !== targetLeafLayout) return [];
@@ -94,22 +73,8 @@ export function applyFrameSlots(
   visiblePaths: Set<string>,
 ) {
   const slots = getFrameSlotsForPath(pathRoute, frameSlots, pathRoutes, visiblePaths);
-  if (slots.length === 0) return clonePageState(basePageState);
   const pageState = clonePageState(basePageState);
-  if (!isInsetLockedByConfig(pathRoute, "topInset")) {
-    pageState.topInset = Math.max(
-      pageState.topInset,
-      ...slots.filter((slot) => slot.type === "topInset").map(resolveFrameSlotHeight),
-    );
-  }
-  if (!isInsetLockedByConfig(pathRoute, "bottomInset")) {
-    pageState.bottomInset = Math.max(
-      pageState.bottomInset,
-      ...slots.filter((slot) => slot.type === "bottomInset").map(resolveFrameSlotHeight),
-    );
-  }
-  const explicit = pathRoute.explicitPageConfigKeys ?? {};
-  if (!explicit.cache && slots.some((slot) => slot.cache)) pageState.cache = true;
+  if (!pathRoute.explicitPageConfigKeys?.cache && slots.some((slot) => slot.cache)) pageState.cache = true;
   return pageState;
 }
 
@@ -146,8 +111,7 @@ export function useFrameSlots() {
           const nextBucket = { ...prev[bucket] };
           if (Object.keys(nextPathSlots).length > 0) nextBucket[path] = nextPathSlots;
           else delete nextBucket[path];
-          const next = { ...prev, [bucket]: nextBucket };
-          return next;
+          return { ...prev, [bucket]: nextBucket };
         });
       };
     },
@@ -283,7 +247,6 @@ export function hasBottomAnchoredKeyboardSlot(path: string, frameSlots: FrameSlo
 
 export function resolveKeyboardFrame({
   keyboardHeight,
-  bottomSafeArea,
   visualViewportKeyboardHeight,
   platformProfile,
   sticky,
@@ -541,8 +504,7 @@ export function createFrameSnapshot({
 
 const getTransitionDuration = (type: TransitionType) => {
   if (typeof window !== "undefined" && window.matchMedia?.("(prefers-reduced-motion: reduce)")?.matches) return 1;
-  if (type === "bottomUp") return 220;
-  if (type === "scaleOut") return 220;
+  if (type === "bottomUp" || type === "scaleOut") return 220;
   if (type === "fade" || type === "stack") return 150;
   return 0;
 };

package/webkit/useGeoLocation.tsx

@@ -1,7 +1,7 @@
 "use client";
 import { loadCapacitorGeolocation } from "akanjs/client/capacitor";
 
-/** Capacitor geolocation hook with permission checks and current position lookup. */
+/** `getPosition` opens the app settings instead of resolving when location permission is denied. */
 export const useGeoLocation = () => {
   const checkPermission = async (): Promise<{ geolocation: string; coarseLocation: string }> => {
     const { Geolocation } = await loadCapacitorGeolocation();

package/webkit/useLocation.ts

@@ -7,14 +7,11 @@ interface UseLocationOptions {
 }
 export const useLocation = ({ rootRouteGuide }: UseLocationOptions) => {
   const getLocation = useCallback((href: string): Location => {
-    const getPathSegments = (pathname: string) => {
-      return [
-        ...pathname
-          .split("/")
-          .filter((pathSegment) => !!pathSegment)
-          .map((pathSegment) => `/${pathSegment}`),
-      ];
-    };
+    const getPathSegments = (pathname: string) =>
+      pathname
+        .split("/")
+        .filter((pathSegment) => !!pathSegment)
+        .map((pathSegment) => `/${pathSegment}`);
     const getPathRoute = (pathname: string): PathRoute => {
       const pathSegments = getPathSegments(pathname);
       const getTargetRouteGuide = (pathSegments: string[], routeGuide: RouteGuide): RouteGuide => {

package/webkit/usePageTool.tsx

@@ -3,9 +3,8 @@ import { Any, Int } from "akanjs/base";
 import { st } from "akanjs/store";
 
 interface PageToolOptions {
-  /** The slice's own `setPageOf<Model>`, or null while the screen draws no pager — one page needs no control. */
+  /** Null publishes nothing: a single page draws no pager. */
   name: string | null;
-  /** The model's refName, for the description an agent picks the tool by. */
   model: string;
   page: number;
   lastPage: number;
@@ -13,13 +12,7 @@ interface PageToolOptions {
   onSelect: (page: number) => void;
 }
 
-/**
- * Publishes one pager: the `setPageOf<Model>` its control already dispatches, plus the counts an agent needs to
- * aim it. Shared by the three components that draw a pager so all three speak the slice's one name.
- *
- * The page count rides the guard and the resource rather than the description, which is mount-static and would
- * keep quoting whatever the list held on its first render.
- */
+/** The page count rides the guard and the resource: the description is read once, at mount. */
 export const usePageTool = ({ name, model, page, lastPage, total, onSelect }: PageToolOptions) => {
   st.expose(name ? `pagesOf${model.charAt(0).toUpperCase()}${model.slice(1)}` : null, Any)
     .desc(`Where the ${model} list is paged to.`)

package/webkit/usePurchase.tsx

@@ -12,10 +12,7 @@ export interface ProductType {
 
 export type CdvProductType = CdvPurchase.ProductType;
 
-/**
- * @deprecated Built on `cordova-plugin-purchase`, which is a peer dependency of the whole package because of
- * this one hook. Replace with `@revenuecat/purchases-capacitor`; this stays only for apps already on it.
- */
+/** @deprecated Needs `cordova-plugin-purchase`, a package-wide peer dependency; use `@revenuecat/purchases-capacitor`. */
 export const usePurchase = ({
   platform,
   productInfo,
@@ -41,27 +38,19 @@ export const usePurchase = ({
       }
       const { App } = await loadCapacitorApp();
       const app = await App.getInfo();
-      if (platform === "all")
-        CdvPurchase.store.register([
-          ...productInfo.map((prouct) => ({
-            id: prouct.id,
-            platform: CdvPurchase.Platform.GOOGLE_PLAY,
-            type: CdvPurchase.ProductType[prouct.type],
-          })),
-          ...productInfo.map((prouct) => ({
-            id: prouct.id,
-            platform: CdvPurchase.Platform.APPLE_APPSTORE,
-            type: CdvPurchase.ProductType[prouct.type],
-          })),
-        ]);
-      else
-        CdvPurchase.store.register(
+      const storePlatforms =
+        platform === "all"
+          ? [CdvPurchase.Platform.GOOGLE_PLAY, CdvPurchase.Platform.APPLE_APPSTORE]
+          : [platform === "android" ? CdvPurchase.Platform.GOOGLE_PLAY : CdvPurchase.Platform.APPLE_APPSTORE];
+      CdvPurchase.store.register(
+        storePlatforms.flatMap((storePlatform) =>
           productInfo.map((product) => ({
             id: product.id,
-            platform: platform === "android" ? CdvPurchase.Platform.GOOGLE_PLAY : CdvPurchase.Platform.APPLE_APPSTORE,
+            platform: storePlatform,
             type: CdvPurchase.ProductType[product.type],
           })),
-        );
+        ),
+      );
 
       await CdvPurchase.store.initialize([
         { platform: CdvPurchase.Platform.APPLE_APPSTORE, options: { needAppReceipt: false } },
@@ -69,7 +58,6 @@ export const usePurchase = ({
       ]);
       await CdvPurchase.store.update();
       await CdvPurchase.store.restorePurchases();
-      
       CdvPurchase.store.validator = (async (
         request: { id: string; transaction: { id: string; purchaseToken: string; appStoreReceipt: string } },
         callback: (result: {
@@ -77,7 +65,7 @@ export const usePurchase = ({
           data: { id: string; latest_receipt: boolean; transaction: CdvPurchase.Transaction };
         }) => void,
       ) => {
-        const transactionId = request.transaction.id; 
+        const transactionId = request.transaction.id;
         const transactions = CdvPurchase.store.localTransactions;
         const verifingTransaction = transactions.find((transaction) => transaction.transactionId === transactionId);
 
@@ -105,20 +93,16 @@ export const usePurchase = ({
         billingRef.current = billing.json();
 
         callback({
-          
           ok: !!billing,
-          
           data: { id: request.id, latest_receipt: true, transaction: request.transaction } as any,
         });
       }) as any;
-      if (CdvPurchase.store.localReceipts.length > 0) {
-        CdvPurchase.store.localReceipts.forEach((receipt) => {
-          if (receipt.platform === CdvPurchase.Platform.GOOGLE_PLAY)
-            if (receipt.transactions[0].state === CdvPurchase.TransactionState.APPROVED)
-              void receipt.transactions[0].verify();
-            else void receipt.transactions[0].finish();
-        });
-      }
+      CdvPurchase.store.localReceipts.forEach((receipt) => {
+        if (receipt.platform === CdvPurchase.Platform.GOOGLE_PLAY)
+          if (receipt.transactions[0].state === CdvPurchase.TransactionState.APPROVED)
+            void receipt.transactions[0].verify();
+          else void receipt.transactions[0].finish();
+      });
 
       CdvPurchase.store
         .when()

package/webkit/useScreenScope.tsx

@@ -16,19 +16,8 @@ interface ScreenScopeOptions {
 
 const ITEM_CAP = 100;
 
-/**
- * Announces what a component has on screen: one scope for its mounted lifetime, plus an `<id>.items` resource
- * naming what it currently renders. `Load.Units`/`Load.View` call this, so every list and detail view is visible
- * to the in-page agent with no app code. Items are capped and the cap is declared — a truncated list must never
- * read as the whole one.
- *
- * Opened under the scope it is mounted in, not at the root: a list inside an `Agent.Zone` belongs to that zone's
- * view, and a view only sees keys in its own subtree.
- *
- * Returns the scope path, which the caller puts on the container it renders as `data-agent-scope`: that attribute
- * is how `readScreen({ section })` and `highlight` resolve a path the agent read in the screen context back to the
- * element. A caller that renders no container of its own simply is not addressable that way.
- */
+/** Opens a scope under the ambient one, plus an `<id>.items` resource capped at 100 and marked `truncated` past it.
+ * Returns the path the caller sets as `data-agent-scope`, which `readScreen({ section })` and `highlight` resolve. */
 export const useScreenScope = ({ id, kind, label, items }: ScreenScopeOptions) => {
   const surface = useSurface();
   const parent = useScopePath();

package/client/fetch.ts

@@ -1 +0,0 @@
-export { fetch, sig } from "./clientRuntime";

package/client/frameDebug.ts

@@ -1,29 +0,0 @@
-"use client";
-
-type DebugPayload = Record<string, unknown>;
-
-const debugSessionId = Math.random().toString(36).slice(2, 8);
-let debugSeq = 0;
-
-const isFrameDebugEnabled = () => {
-  if (typeof window === "undefined") return false;
-  const windowWithTarget = window as typeof window & { __AKAN_MOBILE_TARGET__?: unknown };
-  const search = new URLSearchParams(window.location.search);
-  return (
-    Boolean(windowWithTarget.__AKAN_MOBILE_TARGET__) ||
-    search.has("akanMobileTarget") ||
-    search.get("akanFrameDebug") === "1" ||
-    window.localStorage.getItem("akan:debug:frame") === "1"
-  );
-};
-
-export function debugFrame(event: string, payload: DebugPayload = {}) {
-  if (!isFrameDebugEnabled()) return;
-  debugSeq += 1;
-  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/deepObjectify.ts

@@ -1,42 +0,0 @@
-import { isDayjs } from "./isDayjs";
-
-interface DeepObjectifyOption {
-  serializable?: boolean;
-  convertDate?: "string" | "number";
-}
-
-const objectifyChild = (value: unknown, option: DeepObjectifyOption): unknown => {
-  const modelValue = value as { __ModelType__?: string } | null | undefined;
-  return modelValue?.__ModelType__ && !option.serializable ? value : deepObjectify(value, option);
-};
-
-export const deepObjectify = <T = unknown>(obj: T | null | undefined, option: DeepObjectifyOption = {}): T => {
-  if (isDayjs(obj) || obj?.constructor === Date) {
-    if (!option.serializable && !option.convertDate) return obj as T;
-    if (option.convertDate === "string") return obj.toISOString() as T;
-    else if (option.convertDate === "number")
-      return (isDayjs(obj) ? obj.toDate().getTime() : (obj as Date).getTime()) as T;
-    else return (isDayjs(obj) ? obj.toDate() : obj) as T;
-  } else if (Array.isArray(obj)) {
-    return obj.map((o: unknown) => deepObjectify(o, option)) as T;
-  } else if (obj instanceof Map) {
-    
-    const entries = [...obj.entries()].map(
-      ([key, value]: [string, unknown]) => [key, objectifyChild(value, option)] as const,
-    );
-    return (option.serializable ? Object.fromEntries(entries) : new Map(entries)) as T;
-  } else if (obj instanceof Set) {
-    const values = [...obj.values()].map((value: unknown) => objectifyChild(value, option));
-    return (option.serializable ? values : new Set(values)) as T;
-  } else if (obj && typeof obj === "object") {
-    const val: Record<string, unknown> = {};
-    const objRecord = obj as Record<string, unknown>;
-    
-    for (const key in objRecord) {
-      if (typeof objRecord[key] !== "function") val[key] = objectifyChild(objRecord[key], option);
-    }
-    return val as T;
-  } else {
-    return obj as unknown as T;
-  }
-};

package/common/dynamicRecord.ts

@@ -1,12 +0,0 @@
-/**
- * A generated surface read by a name computed at runtime.
- *
- * The framework's glue layers dispatch by name: a store action reaches `fetch[key]`, a resolver reaches
- * `service[method]`, a `Load.*` component reads `init[names.pageOfModel]`. None of those keys exist in a type,
- * because the type is generated from the model — so every one of them used to be spelled `as any`, which the
- * guide bans and which also silences the *value* type on the way out.
- *
- * This says the same thing about the index and nothing about the value: `as DynamicRecord` to index, then the
- * read carries its own `as T`. One alias so a reader can tell name-based dispatch from an untyped object.
- */
-export type DynamicRecord<Value = unknown> = { [key: string]: Value };

package/common/formatPhone.ts

@@ -1,7 +0,0 @@
-/** Formats supported phone-number strings into dashed display form. */
-export const formatPhone = (value: string) => {
-  if (!value) return "";
-  if (value.length === 10) return value.replace(/(\d{3})(\d{3})(\d{4})/, "$1-$2-$3");
-  else if (value.length === 13) return value.replace(/-/g, "").replace(/(\d{3})(\d{4})(\d{4})/, "$1-$2-$3");
-  else return value;
-};

package/common/getAllPropertyDescriptors.ts

@@ -1,13 +0,0 @@
-type Cls<T = unknown> = new (...args: never[]) => T;
-export const getAllPropertyDescriptors = (objRef: Cls): { [key: string]: PropertyDescriptor } => {
-  const descriptors: Record<string, PropertyDescriptor> = {};
-  let current = objRef.prototype as object | null;
-  while (current) {
-    Object.getOwnPropertyNames(current).forEach((name) => {
-      const descriptor = Object.getOwnPropertyDescriptor(current, name);
-      if (descriptor) descriptors[name] ??= descriptor;
-    });
-    current = Object.getPrototypeOf(current) as Cls | object;
-  }
-  return descriptors;
-};

package/common/lowerlize.ts

@@ -1,4 +0,0 @@
-/** Lowercases only the first character of a string. */
-export const lowerlize = (str: string) => {
-  return str.charAt(0).toLowerCase() + str.slice(1);
-};

package/common/mergeVersion.ts

@@ -1,10 +0,0 @@
-/**
- *
- * semantic version 규격에 맞게 조합하는 함수
- * https://semver.org/
- * @param major 릴리즈(플랫폼(google,apple,etc...)에 올라가 있는) 버전
- * @param minor 릴리즈(플랫폼(google,apple,etc...)에 올라가 있는) 버전
- * @param patch 코드푸시 (Framework 자체 버전)
- * @returns `major.minor.patch` 형식으로 조합된 버전
- */
-export const mergeVersion = (major: number, minor: number, patch: number) => `${major}.${minor}.${patch}`;

package/common/pathGet.ts

@@ -1,13 +0,0 @@
-type Indexable = Record<string | number, unknown>;
-
-const isIndexable = (value: unknown): value is Indexable => Object(value) === value;
-
-export const pathGet = (
-  path: string | (string | number)[],
-  obj: unknown,
-  separator = ".",
-  fallback: unknown = null,
-): unknown => {
-  const properties = Array.isArray(path) ? path : path.split(separator);
-  return properties.reduce((prev, curr) => (isIndexable(prev) ? (prev[curr] ?? fallback) : fallback), obj);
-};

package/common/pathGetLoose.ts

@@ -1,31 +0,0 @@
-type Indexable = Record<string, unknown>;
-
-const isIndexable = (value: unknown): value is Indexable => Object(value) === value;
-
-/**
- * Reads a dotted path whose segments may themselves contain the separator.
- *
- * Dictionary keys are built as `<refName>.<value>` and an enum value is a real-world identifier — `gpt-5.6-terra`,
- * `v1.2` — so the key is not a clean dotted path and `pathGet` splits it into segments that were never nodes.
- * The tree stores such a key literally, so resolution has to try joined prefixes too.
- */
-export const pathGetLoose = (
-  path: string | readonly string[],
-  obj: unknown,
-  separator = ".",
-  fallback: unknown = null,
-): unknown => {
-  const walk = (node: unknown, rest: readonly string[]): unknown => {
-    if (!rest.length) return node;
-    if (!isIndexable(node)) return undefined;
-    
-    for (let take = 1; take <= rest.length; take += 1) {
-      const child = node[rest.slice(0, take).join(separator)];
-      if (child === undefined) continue;
-      const found = walk(child, rest.slice(take));
-      if (found !== undefined) return found;
-    }
-    return undefined;
-  };
-  return walk(obj, Array.isArray(path) ? [...path] : (path as string).split(separator)) ?? fallback;
-};

package/common/pathSet.ts

@@ -1,28 +0,0 @@
-type MutableIndexable = Record<string | number, unknown>;
-type PathSegment = string | number;
-type Container = MutableIndexable | Map<PathSegment, unknown>;
-
-const toPathSegments = (path: string | readonly PathSegment[]) =>
-  Array.isArray(path) ? [...path] : path.toString().match(/[^.[\]]+/g) || [];
-
-const readChild = (container: Container, key: PathSegment) =>
-  container instanceof Map ? container.get(key) : container[key];
-
-const writeChild = (container: Container, key: PathSegment, value: unknown) => {
-  if (container instanceof Map) container.set(key, value);
-  else container[key] = value;
-};
-
-export const pathSet = <T>(obj: T, path: string | readonly PathSegment[], value: unknown): T => {
-  if (Object(obj) !== obj) return obj;
-  const pathSegments = toPathSegments(path);
-  const parent = pathSegments.slice(0, -1).reduce<Container>((a, c, i) => {
-    const child = readChild(a, c);
-    if (Object(child) === child) return child as Container;
-    const created = Math.abs(Number(pathSegments[i + 1])) >> 0 === +pathSegments[i + 1] ? [] : {};
-    writeChild(a, c, created);
-    return created as unknown as Container;
-  }, obj as Container);
-  writeChild(parent, pathSegments[pathSegments.length - 1], value);
-  return obj;
-};

package/common/plainFieldsOf.ts

@@ -1,13 +0,0 @@
-/**
- * Own and inherited enumerable data of an object as a plain record. An Akan model keeps its Date fields as
- * enumerable prototype accessors, which `Object.keys` and a spread never reach; methods are non-enumerable and stay
- * out either way.
- */
-export const plainFieldsOf = (source: object): Record<string, unknown> => {
-  const out: Record<string, unknown> = {};
-  for (const key in source) {
-    const value = (source as Record<string, unknown>)[key];
-    if (typeof value !== "function") out[key] = value;
-  }
-  return out;
-};

package/common/randomPicks.ts

@@ -1,12 +0,0 @@
-export const randomPicks = <T>(arr: T[] | readonly T[], count = 1, allowDuplicate = false): T[] => {
-  if (!allowDuplicate && arr.length <= count) return arr as T[];
-  const idxs: number[] = [];
-  let pickIdx: number;
-  for (let i = 0; i < count; i++) {
-    do {
-      pickIdx = Math.floor(Math.random() * arr.length);
-    } while (!allowDuplicate && idxs.includes(pickIdx));
-    idxs.push(pickIdx);
-  }
-  return idxs.map((idx) => arr[idx]);
-};

package/common/websocketAuth.ts

@@ -1,24 +0,0 @@
-export interface WebsocketAuthRequest {
-  key: string;
-  data: [string | null];
-}
-
-export interface WebsocketAuthAckData {
-  type: "auth";
-  revokedRooms: string[];
-}
-
-/**
- * Framework-owned websocket auth contract shared by the client and the server dispatcher.
- * The credential frame carries the raw bearer token; verifying it stays in userland middleware,
- * so the server only swaps the credential snapshot held on the socket.
- */
-export const websocketAuthContract = {
-  key: "__auth",
-  makeRequest: (jwt: string | null): WebsocketAuthRequest => ({ key: "__auth", data: [jwt] }),
-  makeAck: (revokedRooms: string[]): WebsocketAuthAckData => ({ type: "auth", revokedRooms }),
-  readJwt: (data: unknown): string | null => {
-    const jwt = Array.isArray(data) ? data[0] : null;
-    return typeof jwt === "string" && jwt.length > 0 ? jwt : null;
-  },
-} as const;