@buoy-gg/shared-ui 7.0.78 → 7.0.80

package/lib/typescript/commonjs/dataViewer/flattenTree.d.ts

@@ -0,0 +1,35 @@
+import { JsonValue } from "../types/types";
+/**
+ * Pure tree → rows flattening for VirtualizedDataExplorer.
+ *
+ * Lives outside the component so it can be unit tested without React Native.
+ * Every child of an expanded node becomes a row: the list is virtualized, so
+ * rows are cheap, and the header's "(N items)" must match what you can scroll
+ * to. An earlier version stopped after 150 children (a leftover `break` meant to
+ * "yield" that nothing ever resumed) and capped the count at 500.
+ */
+export declare const MAX_DEPTH_LIMIT = 15;
+export interface FlatDataItem {
+    id: string;
+    key: string;
+    value: JsonValue;
+    valueType: string;
+    depth: number;
+    isExpandable: boolean;
+    isExpanded: boolean;
+    parentId?: string;
+    hasChildren: boolean;
+    childCount: number;
+    path: string[];
+    type: string;
+    isLastChild?: boolean;
+    parentHasMoreSiblings?: boolean[];
+    siblingIndex?: number;
+    totalSiblings?: number;
+}
+export declare const getValueType: (value: JsonValue) => string;
+export declare const getValueCount: (value: JsonValue, valueType: string) => number;
+/** A collection's children as [key, value] pairs, in display order. */
+export declare const getChildEntries: (value: JsonValue, valueType: string) => [string, JsonValue][];
+export declare function flattenTree(value: JsonValue, expandedSet: Set<string>, circularCache: WeakSet<object>, maxDepth: number, key?: string, depth?: number, parentId?: string, path?: string[], siblingIndex?: number, totalSiblings?: number, parentHasMoreSiblings?: boolean[]): FlatDataItem[];
+//# sourceMappingURL=flattenTree.d.ts.map

package/lib/typescript/commonjs/dataViewer/liveEntries.d.ts

@@ -0,0 +1,19 @@
+import { JsonValue } from "../types/types";
+/**
+ * Pure helpers for LiveExplorer's child list, kept out of the component so they
+ * can be unit tested without React Native.
+ *
+ * Every child is listed. Long lists are split into collapsed pages of
+ * `LIVE_PAGE_SIZE`, so a huge array costs one header row per page until you
+ * open one. Children past 1,000 used to be dropped, so they could not be reached.
+ */
+export declare const LIVE_PAGE_SIZE = 100;
+export type LiveEntry = {
+    label: string;
+    value: JsonValue;
+};
+/** A node's children, in display order. */
+export declare function getLiveSubEntries(value: JsonValue): LiveEntry[];
+/** `[first...last]` for page `index`; the last page stops at the real end. */
+export declare function livePageRange(index: number, total: number, size?: number): string;
+//# sourceMappingURL=liveEntries.d.ts.map

package/lib/typescript/commonjs/hooks/safe-area-impl.d.ts

@@ -1,7 +1,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-10-23T07:23:13.273Z
+ * Generated at: 2026-10-31T18:38:31.842Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/typescript/commonjs/icons/index.d.ts

@@ -28,4 +28,5 @@ export { ClockToolIcon, CLOCK_TOOL_ICON_COLOR } from "@buoy-gg/floating-tools-co
 export { PermissionsIcon, PERMISSIONS_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { LifecycleToolIcon, LIFECYCLE_TOOL_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { LocationToolIcon, LOCATION_TOOL_ICON_COLOR } from "@buoy-gg/floating-tools-core";
+export { OtaInspectorIcon, OTA_INSPECTOR_ICON_COLOR } from '@buoy-gg/floating-tools-core';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts

@@ -14,10 +14,11 @@ export * from "./tools/defineTool";
 export * from "./sync/toolActionRegistry";
 export * from "./sync/toolUiBridge";
 export * from "./sync/toolScreenHeader";
-export { absoluteFill, displayValue, parseDisplayValue, getSafeAreaInsets, persistentStorage, isUsingPersistentStorage, getStorageBackendType, safeStringify, getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, loadOptionalModule, getCachedOptionalModule, setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, type RenderCauseCounts, registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, superJsonSerialize, superJsonDeserialize, type SuperJSONResult, realNow, getRealAppState, subscribeRealAppState, BUOY_SYNTHETIC_MARK, countBuoyListener, type RealAppState, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, getDevServerOrigin, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable, } from "./utils";
+export { absoluteFill, displayValue, parseDisplayValue, getSafeAreaInsets, persistentStorage, setItemChecked, getItemChecked, storageIsMemoryOnly, isUsingPersistentStorage, getStorageBackendType, safeStringify, getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, loadOptionalModule, getCachedOptionalModule, setRenderCaptureProvider, getRenderCaptureProvider, type RenderCaptureProvider, type RenderCaptureSummary, type RenderCaptureTopComponent, type RenderCauseCounts, registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, type StateSnapshotPreview, type StateSnapshotPreviewItem, type StateSnapshotPreviewVerdict, superJsonSerialize, superJsonDeserialize, type SuperJSONResult, realNow, getRealAppState, subscribeRealAppState, BUOY_SYNTHETIC_MARK, countBuoyListener, type RealAppState, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, getDevServerOrigin, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, getSafeCurrentRoute, isExpoRouterAvailable, } from "./utils";
 export type { SafeRouteLocation } from "./utils";
 export * from "./utils/toolModules";
 export { subscribeStorageWrites } from "./utils/storageWrites";
+export { FiberRootAnchor, getAnchoredFiberRoots } from "./utils/fiberRootAnchor";
 export { registerBrowserRouter, browserRouter, subscribeBrowserNavigation } from "./utils/browserNavigation";
 export { PREVIEW_ITEM_RENDER_BYTE_LIMIT, createRestoreScope, emptyRestoreResult, failedRestore, skippedRestore, classifyPreviewItem, wontApply, unionKeys, type RestoreScope, type RestoreScopeOptions, type ClassifyOptions, type ClassifyInput, } from "./utils/snapshotProviderKit";
 export { entityColor, formatValuePreview, shallowDiffSummary, type ValuePreviewOptions, type ShallowDiffSummary, } from "./utils/stateTools";
@@ -51,7 +52,7 @@ export type { Environment } from "./types/types";
 export { normalizeEnvironment } from "./types/types";
 export { HintsProvider, useHintsDisabled, useHintsContext } from "./context";
 export * from "./history";
-export { FeatureGate, UpgradePrompt, useFeatureGate, ProFeatureBanner, UpgradeModal, BuoyUpgradeSheet, BuoySignInCard, BuoyNeedsPlanCard, useSignInState, ProBadge, ProUpgradeModal, FreeAccountPrompt, LOGIN_COMMAND, getUseIsPro, getUseLicense, getUseTier, signOutOfBuoy, TIER_LIMITS, useLimit, resolveEffectiveTier } from "./license";
+export { FeatureGate, UpgradePrompt, useFeatureGate, ProFeatureBanner, UpgradeModal, BuoyUpgradeSheet, BuoySignInCard, BuoyNeedsPlanCard, BuoyGetProCard, useSignInState, ProBadge, ProUpgradeModal, FreeAccountPrompt, LOGIN_COMMAND, getUseIsPro, getUseLicense, getUseTier, signOutOfBuoy, TIER_LIMITS, useLimit, resolveEffectiveTier } from "./license";
 export type { FeatureGateProps, ProFeatureBannerProps, UpgradeModalProps, BuoyUpgradeSheetProps, ProUpgradeModalProps, FreeAccountPromptProps, BuoyTier, TierLimitKey } from "./license";
 export { getAccountAccess, hasAccountAccess, assertAccountAccess, subscribeAccountAccess, getUseAccountAccess, retryAccountAccess, isProNow, getTeamCredential } from "./license/licenseModule";
 export { setBuoyAppId, getBuoyAppId } from "./utils/appIdentity";

package/lib/typescript/commonjs/license/BuoyUpgradeSheet.d.ts

@@ -14,6 +14,14 @@ export declare function BuoySignInCard({ onClose, onNotConfigured, footer, }: {
 export declare function BuoyNeedsPlanCard({ onClose }: {
     onClose: () => void;
 }): import("react").JSX.Element;
+/**
+ * "Get Buoy Pro": a QR code and a link to buoy.gg/pricing, then a way to
+ * check again. BuoyUpgradeSheet shows it in a Modal; the parity sheet draws
+ * it inline.
+ */
+export declare function BuoyGetProCard({ onClose }: {
+    onClose: () => void;
+}): import("react").JSX.Element;
 export interface BuoyUpgradeSheetProps {
     visible: boolean;
     onClose: () => void;

package/lib/typescript/commonjs/license/index.d.ts

@@ -1,6 +1,6 @@
 export { FeatureGate, UpgradePrompt, useFeatureGate, ProFeatureBanner, UpgradeModal, ProBadge, ProUpgradeModal } from "./FeatureGate";
 export type { FeatureGateProps, ProFeatureBannerProps, UpgradeModalProps, ProUpgradeModalProps } from "./FeatureGate";
-export { BuoyUpgradeSheet, BuoySignInCard, BuoyNeedsPlanCard, useSignInState } from "./BuoyUpgradeSheet";
+export { BuoyUpgradeSheet, BuoySignInCard, BuoyNeedsPlanCard, BuoyGetProCard, useSignInState } from "./BuoyUpgradeSheet";
 export type { BuoyUpgradeSheetProps } from "./BuoyUpgradeSheet";
 export { FreeAccountPrompt, LOGIN_COMMAND } from "./FreeAccountPrompt";
 export type { FreeAccountPromptProps } from "./FreeAccountPrompt";

package/lib/typescript/commonjs/sync/keyedArrays.d.ts

@@ -4,8 +4,13 @@
  * Every item must carry it, and every value must be a distinct string/number —
  * a duplicated id would make an addressed edit ambiguous, and silently picking
  * the first match is exactly the kind of "helpful" guess that loses data.
+ *
+ * A unique `…Id` field counts too: Haiven's `/chat/me` rows carry only
+ * `channelId`, and a keyed edit on them was written over the list as an object.
+ * When `keys` are given, the field holding one of them wins, so a studio patch
+ * keyed by slug edits that studio instead of appending a new one under `id`.
  */
-export declare function identityField(items: unknown[]): string | undefined;
+export declare function identityField(items: unknown[], keys?: string[]): string | undefined;
 /**
  * Let a caller address list items by their own id instead of resending the list.
  *

package/lib/typescript/commonjs/ui/floating/FloatingTool.d.ts

@@ -27,6 +27,11 @@ export type FloatingToolProps = {
      * out of the way of app headers.
      */
     defaultPlacement?: "top" | "bottom";
+    /**
+     * Extra room a "bottom" tool keeps above the safe area, e.g. for the dev
+     * warning banner (LogBox) that covers the bottom of a dev build.
+     */
+    bottomClearance?: number;
     children?: ReactNode;
     /** When true, pushes the bubble to the side (hidden position) */
     pushToSide?: boolean;
@@ -70,7 +75,7 @@ export type FloatingToolProps = {
  * @performance Implements efficient boundary checking and position validation
  * @performance Includes debounced position saving for optimal storage performance
  */
-export declare function FloatingTool({ id, suspendPointerEvents, revealToken, variant, dragFromSurface, accessibilityLabel, minimizedStack, hasMinimizedStack, accessory, handleAdornment, enablePositionPersistence, defaultPlacement, pushToSide, centerOnboarding, children, environment, availableEnvironments, onEnvironmentSwitch, showEnvironmentSelector, }: FloatingToolProps): import("react").JSX.Element | null;
+export declare function FloatingTool({ id, suspendPointerEvents, revealToken, variant, dragFromSurface, accessibilityLabel, minimizedStack, hasMinimizedStack, accessory, handleAdornment, enablePositionPersistence, defaultPlacement, bottomClearance, pushToSide, centerOnboarding, children, environment, availableEnvironments, onEnvironmentSwitch, showEnvironmentSelector, }: FloatingToolProps): import("react").JSX.Element | null;
 /** Native AppHost gets its anchor from the minimized-tools provider. */
 export declare function getBubbleAnchorPosition(): {
     x: number;

package/lib/typescript/commonjs/ui/listPresets.d.ts

@@ -5,14 +5,14 @@
  * Spread them onto a FlatList: `<FlatList {...EVENT_LIST_PRESET} … />`.
  * A tool that later moves to FlashList changes this file, not eleven.
  */
-import type { FlatListProps } from "react-native";
+import { type FlatListProps } from "react-native";
 /**
  * `removeClippedSubviews` is off in E2E bundles: clipped rows leave the
  * hierarchy entirely, so a row past the fold reads to the test as "the tool
  * stopped capturing".
  */
 export declare const CLIP_OFFSCREEN_CELLS: boolean;
-type ListPreset = Pick<FlatListProps<unknown>, "initialNumToRender" | "maxToRenderPerBatch" | "windowSize" | "updateCellsBatchingPeriod" | "removeClippedSubviews">;
+type ListPreset = Pick<FlatListProps<unknown>, "initialNumToRender" | "maxToRenderPerBatch" | "windowSize" | "updateCellsBatchingPeriod" | "removeClippedSubviews" | "keyboardShouldPersistTaps" | "keyboardDismissMode">;
 /**
  * Event / change / request lists: rows are tall-ish and arrive in bursts.
  * Window and batch values are the "tuned" winner of the buoy-optimize

package/lib/typescript/commonjs/utils/fiberRootAnchor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The app's React roots, found without React DevTools.
+ *
+ * Highlight Updates finds roots through `__REACT_DEVTOOLS_GLOBAL_HOOK__`. React
+ * Native sets that hook up only in dev builds, so in a release build Bug Links
+ * got no taps and no screen text. A class component's instance holds its own
+ * fiber (`_reactInternals`) in every React build. Walking up from it reaches
+ * the root it is mounted in. FloatingDevTools mounts one inside the app's tree.
+ */
+import { Component } from "react";
+/** Renders nothing. While mounted, its root shows in `getAnchoredFiberRoots()`. */
+export declare class FiberRootAnchor extends Component {
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    render(): null;
+}
+/** The FiberRoot (with `.current`) of every mounted anchor, once each. */
+export declare function getAnchoredFiberRoots(): any[];
+//# sourceMappingURL=fiberRootAnchor.d.ts.map

package/lib/typescript/commonjs/utils/index.d.ts

@@ -1,7 +1,7 @@
 export { absoluteFill } from "./absoluteFill";
 export { displayValue, parseDisplayValue } from "./displayValue";
 export { getSafeAreaInsets } from "./getSafeAreaInsets";
-export { persistentStorage, isUsingPersistentStorage, getStorageBackendType, type DevToolsStorage, } from "./persistentStorage";
+export { persistentStorage, setItemChecked, getItemChecked, storageIsMemoryOnly, isUsingPersistentStorage, getStorageBackendType, type DevToolsStorage, } from "./persistentStorage";
 export { safeStringify } from "./safeStringify";
 export { getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstructorName, isEmpty, getValueSize, } from "./typeHelpers";
 export { parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath, } from "./valueFormatting";
@@ -21,4 +21,5 @@ export { browserRouter, getBrowserHref, getBrowserRouteURL, registerBrowserRoute
 export { isDOMElement, getDOMControlProps, getDOMFiber, getDOMNodeHandle, getDOMPublicInstance, resolveDOMEventEmitter } from "./domRuntime";
 export { registerToolModules, getRegisteredToolModule, getToolModuleVersion, type ToolModule } from "./toolModules";
 export { loadToolModule } from "./loadToolModule";
+export { FiberRootAnchor, getAnchoredFiberRoots } from "./fiberRootAnchor";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/utils/minimalSuperJSON.d.ts

@@ -13,12 +13,14 @@ export interface SuperJSONResult {
     };
 }
 export declare function serialize(object: any): SuperJSONResult;
-export declare function deserialize<T = unknown>(payload: SuperJSONResult): T;
+export declare function deserialize<T = unknown>(payload: SuperJSONResult, options?: {
+    skipBadAnnotations?: boolean;
+}): T;
 /**
  * Drop the annotations whose value `drop` rejects. A bug case's scrubber can
  * replace a Date with "[removed:pii]"; the Date annotation left behind would
  * turn that into Invalid Date (or throw, for a BigInt) on deserialize.
  */
-export declare function dropAnnotations(payload: SuperJSONResult, drop: (value: unknown) => boolean): SuperJSONResult;
+export declare function dropAnnotations(payload: SuperJSONResult, drop: (value: unknown, type: unknown) => boolean): SuperJSONResult;
 export {};
 //# sourceMappingURL=minimalSuperJSON.d.ts.map

package/lib/typescript/commonjs/utils/persistentStorage.d.ts

@@ -29,6 +29,21 @@ type StorageBackend = "filesystem" | "asyncstorage" | "localstorage" | "memory";
  * Same API as AsyncStorage for easy migration.
  */
 export declare const persistentStorage: DevToolsStorage;
+/**
+ * Like persistentStorage.setItem, but says whether the value reached disk:
+ * false when the backend failed or kept it in memory only. For data that is
+ * worthless half saved (a blob in chunks, an undo copy).
+ */
+export declare function setItemChecked(key: string, value: string, options?: {
+    strict?: boolean;
+}): Promise<boolean>;
+/**
+ * Like persistentStorage.getItem, but a read that fails throws instead of
+ * looking like a missing value: null means nothing is saved there. For data
+ * that a save would replace whole (a list), where "empty" and "couldn't
+ * read" must never be mixed up.
+ */
+export declare function getItemChecked(key: string): Promise<string | null>;
 /**
  * Check if persistent storage (FileSystem) is being used
  */
@@ -36,10 +51,14 @@ export declare function isUsingPersistentStorage(): Promise<boolean>;
 /**
  * Get the current storage backend type
  */
+/** True when nothing saved outlives the app (no file store, AsyncStorage or localStorage). */
+export declare function storageIsMemoryOnly(): Promise<boolean>;
 export declare function getStorageBackendType(): Promise<StorageBackend>;
 /**
  * Force re-initialization of storage (useful for testing)
  */
 export declare function resetStorageInit(): void;
+/** Tests only: use this file module (or none) and pick the store again. */
+export declare function setFileSystemForTests(fs: unknown): void;
 export {};
 //# sourceMappingURL=persistentStorage.d.ts.map

package/lib/typescript/commonjs/utils/persistentStorage.web.d.ts

@@ -3,4 +3,21 @@ export type { DevToolsStorage } from "./persistentStorage";
 export declare const persistentStorage: DevToolsStorage;
 export declare function isUsingPersistentStorage(): Promise<boolean>;
 export declare function getStorageBackendType(): Promise<"localstorage" | "memory">;
+/**
+ * Write and report whether it reached the browser's storage, like the native
+ * setItemChecked: false when storage is blocked or full (the value is still
+ * kept for this session). Bug links saves a loaded case this way, so a reload
+ * can still restore the app.
+ */
+export declare function setItemChecked(key: string, value: string, _options?: {
+    strict?: boolean;
+}): Promise<boolean>;
+/**
+ * Like getItem, but a read that fails throws instead of looking like a
+ * missing value (the native getItemChecked). With no browser storage at all,
+ * this session's own copy is all there is.
+ */
+export declare function getItemChecked(key: string): Promise<string | null>;
+/** True when nothing saved outlives the page. */
+export declare function storageIsMemoryOnly(): Promise<boolean>;
 //# sourceMappingURL=persistentStorage.web.d.ts.map

package/lib/typescript/module/JsModal.d.ts

@@ -100,10 +100,9 @@ interface JsModalProps {
     /** Chrome variant — see {@link ModalVariant}. */
     variant?: ModalVariant;
     /**
-     * iOS, bottom sheet only: move the sheet up while the keyboard is open, so
-     * a field in the sheet and the buttons under it stay in view. On by
-     * default. Pass false when the body handles the keyboard itself (Ask
-     * Buoy's composer pads for it), or the two would lift it twice.
+     * Lift the bottom sheet above the iOS keyboard. On by default. A body that
+     * keeps its own input above the keyboard (Ask Buoy's KeyboardPad) passes
+     * false, or it would move twice.
      */
     avoidKeyboard?: boolean;
 }

package/lib/typescript/module/JsModal.web.d.ts

@@ -85,6 +85,8 @@ export interface ModalState {
     };
 }
 export interface JsModalProps {
+    /** Native only (lifts the sheet above the iOS keyboard). Accepted here for parity. */
+    avoidKeyboard?: boolean;
     visible: boolean;
     onClose: () => void;
     children: ReactNode;

package/lib/typescript/module/bugCase/appInfo.d.ts

@@ -0,0 +1,17 @@
+export interface BugCaseAppInfo {
+    /** Bundle id (iOS) or package name (Android). */
+    id?: string;
+    /** The version people see, like "4.2.0". */
+    version?: string;
+    /** The build number, like "4210". */
+    build?: string;
+}
+type Modules = {
+    application?: unknown;
+    constants?: unknown;
+};
+/** Tests pass stand-ins for expo-application and expo-constants (undefined: not installed). */
+export declare function setAppInfoModulesForTests(modules: Modules | null): void;
+export declare function bugCaseAppInfo(): BugCaseAppInfo;
+export {};
+//# sourceMappingURL=appInfo.d.ts.map

package/lib/typescript/module/bugCase/appInfo.web.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The web build's app facts: none. A browser page has no bundle id or build
+ * number to read, and the native modules appInfo.ts reads don't exist here
+ * (the web build refuses them). The case leaves these fields out.
+ */
+export interface BugCaseAppInfo {
+    id?: string;
+    version?: string;
+    build?: string;
+}
+export declare function bugCaseAppInfo(): BugCaseAppInfo;
+/** The same test hook as the native file, so shared tests import either. */
+export declare function setAppInfoModulesForTests(_modules: unknown): void;
+//# sourceMappingURL=appInfo.web.d.ts.map

package/lib/typescript/module/bugCase/format.d.ts

@@ -10,6 +10,7 @@ import type { BugCase, BugCaseNetworkCall } from "./types";
 export declare function isFailedCall(call: BugCaseNetworkCall): boolean;
 export declare function formatBugCase(kase: BugCase, options?: {
     link?: string;
-    maxCalls?: number;
+    maxCalls?: number; /** Saved picture files, in picture order (MCP). */
+    pictureFiles?: readonly string[];
 }): string;
 //# sourceMappingURL=format.d.ts.map

package/lib/typescript/module/bugCase/index.d.ts

@@ -1,3 +1,5 @@
+export { bugCaseAppInfo } from "./appInfo";
+export type { BugCaseAppInfo } from "./appInfo";
 export { captureBugCase, DEFAULT_BUG_CASE_BUDGET } from "./capture";
 export type { BugCaseBudget, CaptureBugCaseOptions } from "./capture";
 export { base64UrlDecode, base64UrlEncode, BUG_CASE_LOCK_FORMAT, bugCaseHeader, BugCaseLockError, bugLinkUrl, lockBugCase, MAX_BUG_CASE_BYTES, parseBugLink, readBugCaseHeader, unlockBugCase, webCaseCrypto, } from "./lock";
@@ -5,10 +7,15 @@ export type { BugCaseCrypto, BugCaseHeader, BugCaseLockErrorCode, LockedBugCase
 export { bugCaseRecorderStatus, startBugCaseRecorder, stopBugCaseRecorder } from "./recorder";
 export type { BugCaseRecorderStatus } from "./recorder";
 export { formatBugCase, isFailedCall } from "./format";
+export { BugCaseShapeError, validateBugCase } from "./validate";
+export { addDroppedWhy, base64Bytes, cleanDroppedWhy, DEFAULT_MEDIA_BUDGET, describeDroppedWhy, DROPPED_NOT_JPEG, DROPPED_TO_FIT, fitBugCaseMedia, frameSteps, validateBugCaseMedia, } from "./media";
+export type { BugCaseFrame, BugCaseFrameKind, BugCaseMedia, BugCaseMediaBudget, BugCaseMediaSettings } from "./media";
 export { classifyKey, keyWords, REMOVED_MARK, removedMark, ScrubLimitError, scrubBugCase } from "./scrub";
 export type { ScrubbedItem, ScrubKind, ScrubResult, ScrubRules } from "./scrub";
 export { bugCaseSteps, formatBugCaseSteps, safeTouch } from "./steps";
 export type { BugCaseRouteVisit, BugCaseStep, BugCaseTouch } from "./steps";
 export { BUG_CASE_VERSION } from "./types";
 export type { BugCase, BugCaseConsoleLine, BugCaseMissing, BugCaseNetworkCall, BugCaseScreenElement, } from "./types";
+export { blobSha256, deviceCode, deviceCommit, newDeviceNonce, DEVICE_NONCE_BYTES, fitCard, keyProof, keyProofHash, kitId, kitKey, lockSecret, makeKit, MAX_CARD_JSON_BYTES, newCaseKeyParts, openCard, openKitForDevice, openSecret, pairBytes, pairFrom, checkPair, parseKit, parseWrap, rootLockAad, sealCard, sealKitForDevice, signRecord, teamKeyIdOf, TeamKeyError, unwrapCaseKey, verifyRecord, versionLockAad, webTeamKeyCrypto, wrapCaseKey, WRAP_SUITE, } from "./teamKey";
+export type { BugCard, BugCardFields, BugWrap, CaseKeyParts, KitKind, P256Pair, TeamKeyCrypto, TeamKeyErrorCode, TeamKeyRecord } from "./teamKey";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/bugCase/lock.d.ts

@@ -39,6 +39,13 @@ export interface BugCaseHeader {
     errors: number;
     removed: number;
     missing: number;
+    /**
+     * 16 random bytes, base64url. The team wrap and the card are bound to it.
+     * Optional: blobs from before team keys have none, and still open.
+     */
+    caseTag?: string;
+    /** SHA-256 of the key proof (teamKey.ts `keyProof`), base64url. Comes with `caseTag`. */
+    keyProofHash?: string;
 }
 export interface LockedBugCase {
     blob: Uint8Array;
@@ -74,9 +81,15 @@ export declare function bugCaseHeader(kase: BugCase, bytes: number): BugCaseHead
  * `options.key` locks under an existing link's key (with a fresh nonce), so a
  * case can be replaced, say to add a note, and the link people already have
  * keeps working.
+ *
+ * `caseTag` and `keyProofHash` (teamKey.ts `newCaseKeyParts`) go in the plain
+ * header for team keys. A note edit passes the first tag again, so it never
+ * changes.
  */
 export declare function lockBugCase(kase: BugCase, crypto?: BugCaseCrypto, options?: {
     key?: string;
+    caseTag?: string;
+    keyProofHash?: string;
 }): Promise<LockedBugCase>;
 /** For the server: the plain header, read without the key. */
 export declare function readBugCaseHeader(blob: Uint8Array): BugCaseHeader;

package/lib/typescript/module/bugCase/media.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Frames in a bug case: pictures and video
+ * (research/bug-links-2026-10/media/SPEC.md, rules C1 to C5).
+ *
+ * A frame is a boxed JPEG from the phone. The boxes went on in native code
+ * before the frame was kept (H1), so nothing here looks inside the pixels.
+ * The text scrubber never sees `jpeg` either (C4): capture adds media after
+ * the scrub.
+ */
+export type BugCaseFrameKind = "last" | "tap" | "video";
+export interface BugCaseFrame {
+    /** Steady clock, ms (F10). Frames, taps, errors and calls share it. */
+    t: number;
+    /** Wall time, ms since 1970, for people. */
+    wall?: number;
+    /** "last" is the app just before Buoy opened (F8). */
+    kind: BugCaseFrameKind;
+    /** The touch's seq, for kind "tap". */
+    tap?: number;
+    /** Size in points. */
+    w: number;
+    h: number;
+    /** Base64 JPEG. */
+    jpeg: string;
+    /** How many parts were boxed. */
+    boxes: number;
+}
+export interface BugCaseMediaSettings {
+    maskAllText: boolean;
+    maskAllImages: boolean;
+    maskAllInputs: boolean;
+}
+export interface BugCaseMedia {
+    frames: BugCaseFrame[];
+    /** "Bug here" marks on the steady clock (C2a). */
+    marks: number[];
+    settings: BugCaseMediaSettings;
+    /** How many frames C2 left out, so the viewer can say so. */
+    dropped: number;
+    /** Why they were left out, as short reasons with a count each (C5). Old cases have none. */
+    droppedWhy?: Record<string, number>;
+}
+export interface BugCaseMediaBudget {
+    frames: number;
+    bytes: number;
+}
+/** C2. */
+export declare const DEFAULT_MEDIA_BUDGET: BugCaseMediaBudget;
+/** Bytes a base64 string decodes to. */
+export declare function base64Bytes(b64: string): number;
+/**
+ * C2: keep the frames that matter most, inside the budget. In order: the
+ * "last" frame, tap frames (newest first), video frames near a mark (closest
+ * first), then the other video frames spread across the clip.
+ */
+export declare function fitBugCaseMedia(frames: BugCaseFrame[], marks: number[], budget?: BugCaseMediaBudget): {
+    frames: BugCaseFrame[];
+    dropped: number;
+};
+/** Reasons the case itself adds when it leaves frames out. */
+export declare const DROPPED_TO_FIT = "left out to fit the case";
+export declare const DROPPED_NOT_JPEG = "not a picture Buoy can show";
+/** Adds `n` to one reason, keeping the list short and every reason plain. */
+export declare function addDroppedWhy(why: Record<string, number>, reason: string, n: number): Record<string, number>;
+/** The phone's reasons, kept only when each is plain words with a whole count. */
+export declare function cleanDroppedWhy(raw: unknown): Record<string, number>;
+/**
+ * Which step each frame belongs to (V1): a tap frame goes with the step its
+ * tap made. A frame with no tap link has no step.
+ */
+export declare function frameSteps(frames: readonly BugCaseFrame[], touches: readonly {
+    seq?: number;
+    t: number;
+}[], steps: readonly {
+    t: number;
+    taps?: number[];
+}[]): (number | null)[];
+/** "4 the screen was moving, 1 left out to fit the case", biggest first. */
+export declare function describeDroppedWhy(why: Record<string, number> | undefined): string;
+/**
+ * 0..n-1 in an order where every start of the list is spread across the
+ * range: the two ends, then the middle, then the quarters, and so on.
+ */
+export declare function spreadOrder(n: number): number[];
+/**
+ * C3: keep `media` only with frames that are JPEGs. A bad frame is dropped,
+ * not the case. Then C2 again, since a hand-made case can hold anything.
+ */
+export declare function validateBugCaseMedia(raw: unknown): BugCaseMedia | undefined;
+//# sourceMappingURL=media.d.ts.map

package/lib/typescript/module/bugCase/recorder.d.ts

@@ -2,6 +2,7 @@ export interface BugCaseRecorderStatus {
     watching: string[];
     touches: boolean;
 }
+/** Start recording, or add the tools that registered since the last call. */
 export declare function startBugCaseRecorder(): Promise<BugCaseRecorderStatus>;
 export declare function stopBugCaseRecorder(): void;
 export declare function bugCaseRecorderStatus(): BugCaseRecorderStatus;

package/lib/typescript/module/bugCase/scrub.d.ts

@@ -22,8 +22,8 @@
  *   NO "LOOKS RANDOM" RULE. Entropy caught nothing the rules above missed and
  *   broke order ids, hashes and commit SHAs. It was dropped on the evidence.
  *
- * Removed values become `[removed:secret]` / `[removed:pii]` so the loader can
- * graft the teammate's own value back into the same spot (see graft.ts).
+ * Removed values become `[removed:secret]` / `[removed:pii]`. A load writes
+ * the marks as they are; Restore puts the teammate's own values back.
  *
  * Pure and synchronous so it can be argued with in a unit test. Callers on a
  * phone run it after the capture has been shown as done, off the tap.

package/lib/typescript/module/bugCase/steps.d.ts

@@ -14,6 +14,8 @@ export interface BugCaseTouch {
     /** Capture order. Wins over `t`, which moves when the app clock is faked. */
     seq?: number;
     t: number;
+    /** Real time, which Buoy's clock tool never moves. Tap pictures are matched by it. Old cases have none. */
+    wall?: number;
     kind: "press" | "longPress" | "text" | "toggle" | "slider";
     target: {
         name: string;
@@ -32,7 +34,15 @@ export interface BugCaseRouteVisit {
 export interface BugCaseStep {
     t: number;
     text: string;
+    /** The touches (by seq) this step stands for, so a tap picture finds its step. Old cases have none. */
+    taps?: number[];
 }
+/**
+ * A tap on React Native's own dev chrome (the LogBox warning banners and
+ * their inspector), not on the app. It showed up on the link page as
+ * "Tapped LogBoxButton" when a tester closed a warning.
+ */
+export declare function isDevChromeTouch(touch: BugCaseTouch): boolean;
 /**
  * Drop what a case must never carry: the text a field held or received.
  * Toggle and slider values stay; they are what the step is about.