@buoy-gg/core 7.0.40 → 7.0.42

package/lib/typescript/commonjs/floatingMenu/DevToolsSettingsModal.shared.d.ts

@@ -0,0 +1,71 @@
+import { FC } from "react";
+import type { InstalledApp } from "./types";
+import type { StorageAdapter } from "@buoy-gg/floating-tools-react";
+/**
+ * Global settings that apply to all dev tools.
+ * These settings override individual tool configurations.
+ */
+export interface GlobalDevToolsSettings {
+    /**
+     * When true, all modals share the same dimensions/position.
+     * When false (default), each modal has its own independent persistence.
+     * Priority: Settings UI > Prop override > Default (false)
+     */
+    enableSharedModalDimensions?: boolean;
+    /**
+     * When true (default), window control buttons expand on tap for easier pressing.
+     * When false, buttons are directly tappable at small size.
+     */
+    expandableWindowControls?: boolean;
+}
+/**
+ * Serialized preferences that power the floating dev tools UI. Values persist across sessions
+ * via AsyncStorage so teams can tailor which tools appear in the dial or floating row.
+ */
+export interface DevToolsSettings {
+    /** Map of dial tool ids to enabled state (max slots enforced elsewhere). */
+    dialTools: Record<string, boolean>;
+    /** Map of floating tool ids to enabled state plus the environment indicator toggle. */
+    floatingTools: Record<string, boolean> & {
+        environment: boolean;
+    };
+    /** Global settings that apply to all dev tools */
+    globalSettings?: GlobalDevToolsSettings;
+}
+/**
+ * The subset of InstalledApp the settings modal needs per tool. `icon`/`color`
+ * let rows fall back to the tool's own glyph when getToolIcon() has no
+ * night-tuned override for it.
+ */
+interface SettingsToolInfo {
+    id: string;
+    name: string;
+    description?: string;
+    slot?: "dial" | "row" | "both";
+    icon?: InstalledApp["icon"];
+    color?: string;
+}
+interface DevToolsSettingsModalProps {
+    visible: boolean;
+    onClose: () => void;
+    onSettingsChange?: (settings: DevToolsSettings) => void;
+    initialSettings?: DevToolsSettings;
+    availableApps?: SettingsToolInfo[];
+    storage?: StorageAdapter;
+    zIndex?: number;
+}
+/**
+ * Configurable modal surface that lets engineers pick which dev tools appear in the dial and
+ * floating row. Persists preferences and enforces slot limits for a consistent UX.
+ *
+ * Styled in the "night" language (Everlights port — see shared-ui's
+ * ui/night): section labels outside near-black cards, hairline-separated
+ * rows, real switches, and a transparent header the star field runs through.
+ */
+export declare const DevToolsSettingsModal: FC<DevToolsSettingsModalProps>;
+export declare const useDevToolsSettings: () => {
+    settings: DevToolsSettings;
+    refreshSettings: () => void;
+};
+export {};
+//# sourceMappingURL=DevToolsSettingsModal.shared.d.ts.map

package/lib/typescript/commonjs/floatingMenu/DevToolsSettingsModal.web.d.ts

@@ -1,18 +1,4 @@
-/**
- * DevToolsSettingsModal - Web renderer for the dev tools settings modal.
- *
- * Uses shared configuration and logic from @buoy-gg/floating-tools-react.
- * Platform-specific: CSS, mouse events, web JSX.
- *
- * VISUAL PARITY: styled 1:1 against the native reference
- * (devtools-floating-menu/src/floatingMenu/DevToolsSettingsModal.tsx, which
- * renders in the "night" language — shared-ui's ui/night Everlights port —
- * inside JsModal variant="night"). shared-ui is RN-only, so the night tokens
- * and primitive styles are inlined below with provenance comments.
- *
- * @platform React DOM Web (Vite, CRA, Next.js, Electron)
- */
-import { type AvailableToolConfig, type DevToolsSettings, type StorageAdapter } from '@buoy-gg/floating-tools-react';
+import type { AvailableToolConfig, DevToolsSettings, StorageAdapter } from "@buoy-gg/floating-tools-react";
 export interface SettingsModalProps {
     visible: boolean;
     onClose: () => void;
@@ -22,5 +8,6 @@ export interface SettingsModalProps {
     storage?: StorageAdapter;
     onSettingsChange?: (settings: DevToolsSettings) => void;
 }
-export declare function SettingsModal({ visible, onClose, availableTools, defaultFloatingTools, defaultDialTools, storage, onSettingsChange, }: SettingsModalProps): import("react").JSX.Element | null;
+/** Adapts the browser host to the shared settings and account panel. */
+export declare function SettingsModal({ visible, onClose, availableTools, defaultFloatingTools, defaultDialTools, storage, onSettingsChange, }: SettingsModalProps): import("react").JSX.Element;
 //# sourceMappingURL=DevToolsSettingsModal.web.d.ts.map

package/lib/typescript/commonjs/floatingMenu/FloatingDevTools.web.d.ts

@@ -1,4 +1,8 @@
 import { type WebToolConfig, type Environment, type UserRole } from '@buoy-gg/floating-tools-react';
+import { type BrowserToolModules } from '../utils/createWebTools';
+import type { BrowserToolConfig } from '../utils/createWebTool';
+import type { ExternalSyncOptions } from './autoExternalSync';
+import type { EnvVarConfig } from './FloatingDevTools';
 export interface FloatingDevToolsProps {
     /** Current environment (local, dev, qa, staging, prod) */
     environment?: Environment;
@@ -8,14 +12,16 @@ export interface FloatingDevToolsProps {
     availableEnvironments?: Environment[];
     /** Callback when environment is switched */
     onEnvironmentSwitch?: (env: Environment) => void;
-    /** Custom tools to add (will be merged with auto-discovered) */
-    apps?: WebToolConfig[];
+    /** Custom tools to add to the registered packages. */
+    apps?: BrowserToolConfig[];
+    /** Imported tool packages, keyed by package name. */
+    modules?: BrowserToolModules;
+    externalSync?: boolean | ExternalSyncOptions;
+    requiredEnvVars?: EnvVarConfig[];
+    sentryGetClient?: () => unknown;
     /** Disable onboarding tooltips */
     disableHints?: boolean;
-    /**
-     * API parity with native. Desktop sync is native-only, so headless mode
-     * on web simply renders nothing.
-     */
+    /** Keep capture and desktop sync running without the floating menu. */
     headless?: boolean;
     licenseKey?: string;
     /** @deprecated Accounts are required for all dev tools. */

package/lib/typescript/commonjs/floatingMenu/defaultConfig.d.ts

@@ -19,7 +19,7 @@
  * All known tool IDs that can appear in the floating menu or dial menu.
  * This is a union type of all auto-discovered tool IDs.
  */
-export type BuiltInToolId = 'env' | 'network' | 'storage' | 'query' | 'query-wifi-toggle' | 'route-events' | 'debug-borders' | 'highlight-updates' | 'highlight-updates-modal' | 'redux' | 'zustand' | 'jotai' | 'events' | 'time-machine' | 'scenarios' | 'ask-buoy' | 'image-overlay' | 'perf-monitor' | 'perf-monitor-modal';
+export type BuiltInToolId = 'env' | 'network' | 'push-notifications' | 'storage' | 'query' | 'query-wifi-toggle' | 'route-events' | 'debug-borders' | 'highlight-updates' | 'highlight-updates-modal' | 'redux' | 'zustand' | 'jotai' | 'events' | 'time-machine' | 'clock' | 'scenarios' | 'ask-buoy' | 'image-overlay' | 'perf-monitor' | 'perf-monitor-modal';
 /**
  * Special floating-only tool IDs that only appear in the floating bubble row.
  */

package/lib/typescript/commonjs/floatingMenu/settingsBus.d.ts

@@ -1,10 +1,2 @@
-import type { DevToolsSettings } from './DevToolsSettingsModal';
-type Listener<T> = (payload: T) => void;
-declare class SimpleEventBus<T = DevToolsSettings> {
-    private listeners;
-    emit(payload: T): void;
-    addListener(listener: Listener<T>): () => boolean;
-}
-export declare const settingsBus: SimpleEventBus<DevToolsSettings>;
-export {};
+export { settingsEventBus as settingsBus } from "@buoy-gg/floating-tools-core";
 //# sourceMappingURL=settingsBus.d.ts.map

package/lib/typescript/commonjs/floatingMenu/useDesktopSyncStatus.web.d.ts

@@ -0,0 +1,3 @@
+import type { DesktopSyncStatus } from "./useDesktopSyncStatus";
+export declare function useDesktopSyncStatus(): DesktopSyncStatus | null;
+//# sourceMappingURL=useDesktopSyncStatus.web.d.ts.map

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

@@ -8,6 +8,8 @@
  */
 export { FloatingDevTools } from "./floatingMenu/FloatingDevTools.web";
 export type { FloatingDevToolsProps } from "./floatingMenu/FloatingDevTools.web";
+export { createWebTool } from "./utils/createWebTool";
+export { clearReleaseOptIn } from "./releaseOptIn";
 export { FloatingTools, UserStatus, Divider } from "./floatingMenu/floatingTools.web";
 export type { FloatingToolsProps } from "./floatingMenu/floatingTools.web";
 export { DialMenu } from "./floatingMenu/dial/DialDevTools.web";
@@ -18,4 +20,9 @@ export { AppHostProvider, AppOverlay, useAppHost } from "./floatingMenu/AppHost.
 export { autoDiscoverWebPresets, autoDiscoverWithCustom, getToolsBySlot, getEnabledTools, defaultToolPresets, } from "./utils/autoDiscoverPresets.web";
 export type { WebToolConfig, Environment, UserRole, StorageAdapter, DevToolsSettings, AvailableToolConfig, } from "@buoy-gg/floating-tools-react";
 export { useSettings, useFloatingTools, getToolLabel, getToolDescription, getToolColor, settingsColors, settingsStyles, dialColors, dialStyles, } from "@buoy-gg/floating-tools-react";
+export { createWebTools, type BrowserToolModules } from "./utils/createWebTools";
+export * from "./toolkit";
+export { useToolHost, useToolHeader, type ToolHostContextValue, type ToolHeaderOverride, type ToolToastType } from "./floatingMenu/ToolHost";
+export { DevToolsVisibilityProvider, useDevToolsVisibility } from "./floatingMenu/DevToolsVisibilityContext";
+export { appSyncAdapter } from "./floatingMenu/sync/appSyncAdapter";
 //# sourceMappingURL=index.web.d.ts.map

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

@@ -0,0 +1,8 @@
+declare module 'react-devtools-core' {
+    export function initialize(settings?: Record<string, unknown>): void;
+    const devtools: {
+        initialize(settings?: Record<string, unknown>): void;
+    };
+    export default devtools;
+}
+//# sourceMappingURL=reactDevtoolsTypes.d.ts.map

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

@@ -0,0 +1,4 @@
+export declare function hasReleaseOptIn(): boolean;
+export declare function markReleaseOptIn(): void;
+export declare function clearReleaseOptIn(): void;
+//# sourceMappingURL=releaseOptIn.d.ts.map

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

@@ -1,45 +1,8 @@
-/**
- * Auto-discovery utility for React DOM Web.
- *
- * Uses Vite's import.meta.glob to discover installed @buoy-gg/* packages
- * at build time. This provides Metro-like auto-discovery behavior for web.
- *
- * How it works:
- * 1. import.meta.glob scans node_modules at build time
- * 2. Only packages that are actually installed are included
- * 3. Missing packages don't cause errors (like Metro's try-catch)
- * 4. Custom tools can override discovered ones by ID
- *
- * @platform React DOM Web (Vite, CRA, Next.js, Electron)
- */
-import type { WebToolConfig } from '@buoy-gg/floating-tools-react';
-/**
- * Default tool presets for when packages don't export web presets yet.
- * These will be used until each @buoy-gg/* package exports its own preset.
- * Icons are the BIF brand icon components (same artwork as native) —
- * never emoji strings (tofu in WKWebView).
- */
+import type { WebToolConfig } from "@buoy-gg/floating-tools-react";
+/** Browser tools are registered through FloatingDevTools.apps. */
 export declare const defaultToolPresets: WebToolConfig[];
-/**
- * Auto-discover installed @buoy-gg/* tool packages.
- *
- * Uses Vite's import.meta.glob to find packages at build time.
- * Only installed packages are included (no errors for missing ones).
- *
- * Note: Until packages export web presets, this returns default presets.
- *
- * @returns Array of discovered tool configurations
- */
+/** @deprecated Pass explicitly imported presets through FloatingDevTools.apps. */
 export declare function autoDiscoverWebPresets(): WebToolConfig[];
-/**
- * Merge custom tools with auto-discovered ones.
- *
- * Custom tools take precedence - if a custom tool has the same ID as
- * a discovered tool, the custom one is used (same behavior as mobile).
- *
- * @param customTools - Custom tools to merge (optional)
- * @returns Merged array with custom tools taking precedence
- */
 export declare function autoDiscoverWithCustom(customTools?: WebToolConfig[]): WebToolConfig[];
 /**
  * Get tools filtered by slot.

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

@@ -0,0 +1,6 @@
+import type { WebToolConfig } from "@buoy-gg/floating-tools-react";
+import type { ToolPreset } from "@buoy-gg/shared-ui";
+/** Adapt a shared tool preset to the browser menu's icon renderer. */
+export type BrowserToolConfig = WebToolConfig & Pick<ToolPreset, "modal" | "sync">;
+export declare function createWebTool(preset: ToolPreset): BrowserToolConfig;
+//# sourceMappingURL=createWebTool.d.ts.map

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

@@ -0,0 +1,4 @@
+import { type ToolModule } from '@buoy-gg/shared-ui';
+export type BrowserToolModules = Record<string, ToolModule>;
+export declare function createWebTools(modules: BrowserToolModules): import("./createWebTool").BrowserToolConfig[];
+//# sourceMappingURL=createWebTools.d.ts.map

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

@@ -9,5 +9,5 @@
  * Drift is prevented by a test that fails when this disagrees with
  * package.json, so a version bump that forgets this file cannot ship.
  */
-export declare const SDK_VERSION = "7.0.40";
+export declare const SDK_VERSION = "7.0.42";
 //# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1,13 @@
+export { earlyHookScript } from './earlyHookScript';
+/**
+ * Call before importing React DOM so render and element inspectors can see app
+ * roots. It also starts recording fetch and XHR calls, so the Network tool shows
+ * the requests the page made before Buoy loaded.
+ *
+ * In a production build it runs only in a browser where Buoy has recently
+ * rendered (see releaseOptIn.ts), or with `enableInRelease`.
+ */
+export declare function registerBrowserDevTools(options?: {
+    enableInRelease?: boolean;
+}): boolean;
+//# sourceMappingURL=browserRegister.d.ts.map

package/lib/typescript/module/browserRegister.server.d.ts

@@ -0,0 +1,6 @@
+export { earlyHookScript } from './earlyHookScript';
+/** The server entry does not load the browser's React DevTools backend. */
+export declare function registerBrowserDevTools(_options?: {
+    enableInRelease?: boolean;
+}): boolean;
+//# sourceMappingURL=browserRegister.server.d.ts.map

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

@@ -0,0 +1,12 @@
+/**
+ * Inline script for pages where React DOM loads before any app code, such as
+ * the Next.js Pages Router.
+ *
+ * Put it in the page's `<head>`, ahead of every bundle. It holds on to the
+ * renderer React DOM registers, and `@buoy-gg/core/web/register` later hands
+ * that renderer to the full React DevTools backend. Without it, React DOM
+ * registers with Fast Refresh's placeholder hook, which keeps nothing, and
+ * Highlight Updates sees no renders.
+ */
+export declare const earlyHookScript: string;
+//# sourceMappingURL=earlyHookScript.d.ts.map

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

@@ -0,0 +1,52 @@
+/**
+ * Records the page's fetch and XHR calls from the first line of the app, before
+ * the Network tool has loaded.
+ *
+ * Buoy is usually loaded lazily, after the app has hydrated, so the requests a
+ * page makes while it loads (the session check, the first queries) used to be
+ * missed. `@buoy-gg/core/web/register` already has to run before React DOM, so
+ * it installs this recorder too. When Network capture starts, the tool calls
+ * `adopt` and turns each record into a normal request row, including requests
+ * that are still in flight. After that the recorder only passes calls through.
+ *
+ * It has no dependencies because it loads before everything else. The shape
+ * of `window.__BUOY_EARLY_NETWORK__` is shared with @buoy-gg/network
+ * (network/utils/adoptEarlyNetwork.ts); change both together.
+ */
+export interface EarlyFetchRecord {
+    kind: 'fetch';
+    input: RequestInfo | URL;
+    init?: RequestInit;
+    /** A copy of a `Request` body, taken before the app's request consumed it. */
+    requestCopy?: Request;
+    /** Real `Date.now()` when the call was made. */
+    start: number;
+    /**
+     * Settles when the headers arrive, with the app's response and a clone to
+     * read the body from (none for a stream), or with the error the app saw.
+     */
+    settled: Promise<{
+        response?: Response;
+        clone?: Response;
+        error?: unknown;
+        headersAt: number;
+    }>;
+}
+export interface EarlyXhrRecord {
+    kind: 'xhr';
+    xhr: XMLHttpRequest;
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body: unknown;
+    start: number;
+}
+export type EarlyNetworkRecord = EarlyFetchRecord | EarlyXhrRecord;
+export interface EarlyNetworkRecorder {
+    version: 1;
+    records: EarlyNetworkRecord[];
+    /** Hand every record to the Network tool and stop recording. Returns them once. */
+    adopt(): EarlyNetworkRecord[];
+}
+export declare function installEarlyNetworkRecorder(): void;
+//# sourceMappingURL=earlyNetwork.d.ts.map

package/lib/typescript/module/floatingMenu/AppHost.web.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import { AppInstance, OpenDefinition } from "./AppHostLogic";
+import { AppInstance, OpenDefinition, type ModalRestoreState } from "./AppHostLogic";
 type AppHostContextValue = {
     openApps: AppInstance[];
     isAnyOpen: boolean;
@@ -8,9 +8,9 @@ type AppHostContextValue = {
     closeAll: () => void;
     registerApps: (apps: any[]) => void;
     /** Minimize a tool - hides the modal but keeps state */
-    minimize: (instanceId: string) => void;
+    minimize: (instanceId: string, restoreState?: ModalRestoreState) => void;
     /** Restore a minimized tool to visible state */
-    restore: (instanceId: string) => void;
+    restore: (instanceId: string, restoreState?: ModalRestoreState) => void;
     /** Check if a specific tool is minimized */
     isMinimized: (instanceId: string) => boolean;
 };

package/lib/typescript/module/floatingMenu/BrowserToolRuntime.d.ts

@@ -0,0 +1,14 @@
+import type { BrowserToolModules } from '../utils/createWebTools';
+import type { BrowserToolConfig } from '../utils/createWebTool';
+import type { ExternalSyncOptions } from './autoExternalSync';
+import type { EnvVarConfig } from './FloatingDevTools';
+export interface BrowserToolRuntimeProps {
+    modules: BrowserToolModules;
+    apps?: BrowserToolConfig[];
+    requiredEnvVars?: EnvVarConfig[];
+    externalSync?: boolean | ExternalSyncOptions;
+    headless?: boolean;
+    sentryGetClient?: () => unknown;
+}
+export declare function BrowserToolRuntime(props: BrowserToolRuntimeProps): import("react").JSX.Element;
+//# sourceMappingURL=BrowserToolRuntime.d.ts.map

package/lib/typescript/module/floatingMenu/DevToolsSettingsModal.d.ts

@@ -1,68 +1,3 @@
-import { FC } from "react";
-import type { InstalledApp } from "./types";
-/**
- * Global settings that apply to all dev tools.
- * These settings override individual tool configurations.
- */
-export interface GlobalDevToolsSettings {
-    /**
-     * When true, all modals share the same dimensions/position.
-     * When false (default), each modal has its own independent persistence.
-     * Priority: Settings UI > Prop override > Default (false)
-     */
-    enableSharedModalDimensions?: boolean;
-    /**
-     * When true (default), window control buttons expand on tap for easier pressing.
-     * When false, buttons are directly tappable at small size.
-     */
-    expandableWindowControls?: boolean;
-}
-/**
- * Serialized preferences that power the floating dev tools UI. Values persist across sessions
- * via AsyncStorage so teams can tailor which tools appear in the dial or floating row.
- */
-export interface DevToolsSettings {
-    /** Map of dial tool ids to enabled state (max slots enforced elsewhere). */
-    dialTools: Record<string, boolean>;
-    /** Map of floating tool ids to enabled state plus the environment indicator toggle. */
-    floatingTools: Record<string, boolean> & {
-        environment: boolean;
-    };
-    /** Global settings that apply to all dev tools */
-    globalSettings?: GlobalDevToolsSettings;
-}
-/**
- * The subset of InstalledApp the settings modal needs per tool. `icon`/`color`
- * let rows fall back to the tool's own glyph when getToolIcon() has no
- * night-tuned override for it.
- */
-interface SettingsToolInfo {
-    id: string;
-    name: string;
-    description?: string;
-    slot?: "dial" | "row" | "both";
-    icon?: InstalledApp["icon"];
-    color?: string;
-}
-interface DevToolsSettingsModalProps {
-    visible: boolean;
-    onClose: () => void;
-    onSettingsChange?: (settings: DevToolsSettings) => void;
-    initialSettings?: DevToolsSettings;
-    availableApps?: SettingsToolInfo[];
-}
-/**
- * Configurable modal surface that lets engineers pick which dev tools appear in the dial and
- * floating row. Persists preferences and enforces slot limits for a consistent UX.
- *
- * Styled in the "night" language (Everlights port — see shared-ui's
- * ui/night): section labels outside near-black cards, hairline-separated
- * rows, real switches, and a transparent header the star field runs through.
- */
-export declare const DevToolsSettingsModal: FC<DevToolsSettingsModalProps>;
-export declare const useDevToolsSettings: () => {
-    settings: DevToolsSettings;
-    refreshSettings: () => void;
-};
-export {};
+export { DevToolsSettingsModal, useDevToolsSettings } from "./DevToolsSettingsModal.shared";
+export type { DevToolsSettings, GlobalDevToolsSettings } from "./DevToolsSettingsModal.shared";
 //# sourceMappingURL=DevToolsSettingsModal.d.ts.map

package/lib/typescript/module/floatingMenu/DevToolsSettingsModal.shared.d.ts

@@ -0,0 +1,71 @@
+import { FC } from "react";
+import type { InstalledApp } from "./types";
+import type { StorageAdapter } from "@buoy-gg/floating-tools-react";
+/**
+ * Global settings that apply to all dev tools.
+ * These settings override individual tool configurations.
+ */
+export interface GlobalDevToolsSettings {
+    /**
+     * When true, all modals share the same dimensions/position.
+     * When false (default), each modal has its own independent persistence.
+     * Priority: Settings UI > Prop override > Default (false)
+     */
+    enableSharedModalDimensions?: boolean;
+    /**
+     * When true (default), window control buttons expand on tap for easier pressing.
+     * When false, buttons are directly tappable at small size.
+     */
+    expandableWindowControls?: boolean;
+}
+/**
+ * Serialized preferences that power the floating dev tools UI. Values persist across sessions
+ * via AsyncStorage so teams can tailor which tools appear in the dial or floating row.
+ */
+export interface DevToolsSettings {
+    /** Map of dial tool ids to enabled state (max slots enforced elsewhere). */
+    dialTools: Record<string, boolean>;
+    /** Map of floating tool ids to enabled state plus the environment indicator toggle. */
+    floatingTools: Record<string, boolean> & {
+        environment: boolean;
+    };
+    /** Global settings that apply to all dev tools */
+    globalSettings?: GlobalDevToolsSettings;
+}
+/**
+ * The subset of InstalledApp the settings modal needs per tool. `icon`/`color`
+ * let rows fall back to the tool's own glyph when getToolIcon() has no
+ * night-tuned override for it.
+ */
+interface SettingsToolInfo {
+    id: string;
+    name: string;
+    description?: string;
+    slot?: "dial" | "row" | "both";
+    icon?: InstalledApp["icon"];
+    color?: string;
+}
+interface DevToolsSettingsModalProps {
+    visible: boolean;
+    onClose: () => void;
+    onSettingsChange?: (settings: DevToolsSettings) => void;
+    initialSettings?: DevToolsSettings;
+    availableApps?: SettingsToolInfo[];
+    storage?: StorageAdapter;
+    zIndex?: number;
+}
+/**
+ * Configurable modal surface that lets engineers pick which dev tools appear in the dial and
+ * floating row. Persists preferences and enforces slot limits for a consistent UX.
+ *
+ * Styled in the "night" language (Everlights port — see shared-ui's
+ * ui/night): section labels outside near-black cards, hairline-separated
+ * rows, real switches, and a transparent header the star field runs through.
+ */
+export declare const DevToolsSettingsModal: FC<DevToolsSettingsModalProps>;
+export declare const useDevToolsSettings: () => {
+    settings: DevToolsSettings;
+    refreshSettings: () => void;
+};
+export {};
+//# sourceMappingURL=DevToolsSettingsModal.shared.d.ts.map

package/lib/typescript/module/floatingMenu/DevToolsSettingsModal.web.d.ts

@@ -1,18 +1,4 @@
-/**
- * DevToolsSettingsModal - Web renderer for the dev tools settings modal.
- *
- * Uses shared configuration and logic from @buoy-gg/floating-tools-react.
- * Platform-specific: CSS, mouse events, web JSX.
- *
- * VISUAL PARITY: styled 1:1 against the native reference
- * (devtools-floating-menu/src/floatingMenu/DevToolsSettingsModal.tsx, which
- * renders in the "night" language — shared-ui's ui/night Everlights port —
- * inside JsModal variant="night"). shared-ui is RN-only, so the night tokens
- * and primitive styles are inlined below with provenance comments.
- *
- * @platform React DOM Web (Vite, CRA, Next.js, Electron)
- */
-import { type AvailableToolConfig, type DevToolsSettings, type StorageAdapter } from '@buoy-gg/floating-tools-react';
+import type { AvailableToolConfig, DevToolsSettings, StorageAdapter } from "@buoy-gg/floating-tools-react";
 export interface SettingsModalProps {
     visible: boolean;
     onClose: () => void;
@@ -22,5 +8,6 @@ export interface SettingsModalProps {
     storage?: StorageAdapter;
     onSettingsChange?: (settings: DevToolsSettings) => void;
 }
-export declare function SettingsModal({ visible, onClose, availableTools, defaultFloatingTools, defaultDialTools, storage, onSettingsChange, }: SettingsModalProps): import("react").JSX.Element | null;
+/** Adapts the browser host to the shared settings and account panel. */
+export declare function SettingsModal({ visible, onClose, availableTools, defaultFloatingTools, defaultDialTools, storage, onSettingsChange, }: SettingsModalProps): import("react").JSX.Element;
 //# sourceMappingURL=DevToolsSettingsModal.web.d.ts.map

package/lib/typescript/module/floatingMenu/FloatingDevTools.web.d.ts

@@ -1,4 +1,8 @@
 import { type WebToolConfig, type Environment, type UserRole } from '@buoy-gg/floating-tools-react';
+import { type BrowserToolModules } from '../utils/createWebTools';
+import type { BrowserToolConfig } from '../utils/createWebTool';
+import type { ExternalSyncOptions } from './autoExternalSync';
+import type { EnvVarConfig } from './FloatingDevTools';
 export interface FloatingDevToolsProps {
     /** Current environment (local, dev, qa, staging, prod) */
     environment?: Environment;
@@ -8,14 +12,16 @@ export interface FloatingDevToolsProps {
     availableEnvironments?: Environment[];
     /** Callback when environment is switched */
     onEnvironmentSwitch?: (env: Environment) => void;
-    /** Custom tools to add (will be merged with auto-discovered) */
-    apps?: WebToolConfig[];
+    /** Custom tools to add to the registered packages. */
+    apps?: BrowserToolConfig[];
+    /** Imported tool packages, keyed by package name. */
+    modules?: BrowserToolModules;
+    externalSync?: boolean | ExternalSyncOptions;
+    requiredEnvVars?: EnvVarConfig[];
+    sentryGetClient?: () => unknown;
     /** Disable onboarding tooltips */
     disableHints?: boolean;
-    /**
-     * API parity with native. Desktop sync is native-only, so headless mode
-     * on web simply renders nothing.
-     */
+    /** Keep capture and desktop sync running without the floating menu. */
     headless?: boolean;
     licenseKey?: string;
     /** @deprecated Accounts are required for all dev tools. */

package/lib/typescript/module/floatingMenu/defaultConfig.d.ts

@@ -19,7 +19,7 @@
  * All known tool IDs that can appear in the floating menu or dial menu.
  * This is a union type of all auto-discovered tool IDs.
  */
-export type BuiltInToolId = 'env' | 'network' | 'storage' | 'query' | 'query-wifi-toggle' | 'route-events' | 'debug-borders' | 'highlight-updates' | 'highlight-updates-modal' | 'redux' | 'zustand' | 'jotai' | 'events' | 'time-machine' | 'scenarios' | 'ask-buoy' | 'image-overlay' | 'perf-monitor' | 'perf-monitor-modal';
+export type BuiltInToolId = 'env' | 'network' | 'push-notifications' | 'storage' | 'query' | 'query-wifi-toggle' | 'route-events' | 'debug-borders' | 'highlight-updates' | 'highlight-updates-modal' | 'redux' | 'zustand' | 'jotai' | 'events' | 'time-machine' | 'clock' | 'scenarios' | 'ask-buoy' | 'image-overlay' | 'perf-monitor' | 'perf-monitor-modal';
 /**
  * Special floating-only tool IDs that only appear in the floating bubble row.
  */

package/lib/typescript/module/floatingMenu/settingsBus.d.ts

@@ -1,10 +1,2 @@
-import type { DevToolsSettings } from './DevToolsSettingsModal';
-type Listener<T> = (payload: T) => void;
-declare class SimpleEventBus<T = DevToolsSettings> {
-    private listeners;
-    emit(payload: T): void;
-    addListener(listener: Listener<T>): () => boolean;
-}
-export declare const settingsBus: SimpleEventBus<DevToolsSettings>;
-export {};
+export { settingsEventBus as settingsBus } from "@buoy-gg/floating-tools-core";
 //# sourceMappingURL=settingsBus.d.ts.map

package/lib/typescript/module/floatingMenu/useDesktopSyncStatus.web.d.ts

@@ -0,0 +1,3 @@
+import type { DesktopSyncStatus } from "./useDesktopSyncStatus";
+export declare function useDesktopSyncStatus(): DesktopSyncStatus | null;
+//# sourceMappingURL=useDesktopSyncStatus.web.d.ts.map

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

@@ -8,6 +8,8 @@
  */
 export { FloatingDevTools } from "./floatingMenu/FloatingDevTools.web";
 export type { FloatingDevToolsProps } from "./floatingMenu/FloatingDevTools.web";
+export { createWebTool } from "./utils/createWebTool";
+export { clearReleaseOptIn } from "./releaseOptIn";
 export { FloatingTools, UserStatus, Divider } from "./floatingMenu/floatingTools.web";
 export type { FloatingToolsProps } from "./floatingMenu/floatingTools.web";
 export { DialMenu } from "./floatingMenu/dial/DialDevTools.web";
@@ -18,4 +20,9 @@ export { AppHostProvider, AppOverlay, useAppHost } from "./floatingMenu/AppHost.
 export { autoDiscoverWebPresets, autoDiscoverWithCustom, getToolsBySlot, getEnabledTools, defaultToolPresets, } from "./utils/autoDiscoverPresets.web";
 export type { WebToolConfig, Environment, UserRole, StorageAdapter, DevToolsSettings, AvailableToolConfig, } from "@buoy-gg/floating-tools-react";
 export { useSettings, useFloatingTools, getToolLabel, getToolDescription, getToolColor, settingsColors, settingsStyles, dialColors, dialStyles, } from "@buoy-gg/floating-tools-react";
+export { createWebTools, type BrowserToolModules } from "./utils/createWebTools";
+export * from "./toolkit";
+export { useToolHost, useToolHeader, type ToolHostContextValue, type ToolHeaderOverride, type ToolToastType } from "./floatingMenu/ToolHost";
+export { DevToolsVisibilityProvider, useDevToolsVisibility } from "./floatingMenu/DevToolsVisibilityContext";
+export { appSyncAdapter } from "./floatingMenu/sync/appSyncAdapter";
 //# sourceMappingURL=index.web.d.ts.map