@buoy-gg/core 1.7.2

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

@@ -0,0 +1,95 @@
+import React, { ReactNode } from "react";
+/**
+ * Modal state to restore when reopening a minimized tool
+ */
+export interface ModalRestoreState {
+    /** Modal display mode */
+    mode: "bottomSheet" | "floating";
+    /** Panel height for bottom sheet mode */
+    panelHeight?: number;
+    /** Position for floating mode */
+    floatingPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Dimensions for floating mode */
+    floatingDimensions?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Represents a minimized tool that can be restored
+ */
+export interface MinimizedTool {
+    /** Unique instance ID for this minimized tool */
+    instanceId: string;
+    /** Tool identifier (e.g., "storage", "network") */
+    id: string;
+    /** Display name for the tool */
+    title: string;
+    /** Icon component or element to display in the minimized stack */
+    icon: ReactNode;
+    /** Accent color for the tool */
+    color?: string;
+    /** Timestamp when the tool was minimized */
+    minimizedAt: number;
+    /** Modal state to restore when reopening */
+    modalState?: ModalRestoreState;
+}
+/**
+ * Position for a minimized tool icon in the stack
+ */
+export interface IconPosition {
+    x: number;
+    y: number;
+}
+/**
+ * Calculate the position of a minimized tool icon in the stack
+ * Icons stack upward from bottom-right corner
+ */
+export declare function getIconPosition(index: number): IconPosition;
+/**
+ * Get the icon size constant
+ */
+export declare function getIconSize(): number;
+/**
+ * Context value for minimized tools management
+ */
+interface MinimizedToolsContextValue {
+    /** List of currently minimized tools */
+    minimizedTools: MinimizedTool[];
+    /** Minimize a tool - removes from open apps and adds to minimized stack */
+    minimize: (tool: Omit<MinimizedTool, "minimizedAt">) => void;
+    /** Restore a minimized tool - removes from stack and triggers reopen */
+    restore: (instanceId: string) => MinimizedTool | null;
+    /** Check if a tool is currently minimized */
+    isMinimized: (id: string) => boolean;
+    /** Get a minimized tool by its instance ID */
+    getMinimizedTool: (instanceId: string) => MinimizedTool | undefined;
+    /** Clear all minimized tools */
+    clearAll: () => void;
+    /** Number of minimized tools */
+    count: number;
+    /** Get the target position for a new minimized icon (for animation) */
+    getNextIconPosition: () => IconPosition;
+    /** Get position of an existing minimized tool's icon */
+    getToolIconPosition: (instanceId: string) => IconPosition | null;
+}
+interface MinimizedToolsProviderProps {
+    children: ReactNode;
+    /** Callback to get icon for a tool by its id (used for restoration from storage) */
+    getToolIcon?: (id: string) => ReactNode;
+}
+/**
+ * Provider component for minimized tools management.
+ * Handles state, persistence, and provides context to children.
+ */
+export declare function MinimizedToolsProvider({ children, getToolIcon, }: MinimizedToolsProviderProps): React.JSX.Element;
+/**
+ * Hook to access minimized tools context.
+ * Must be used within a MinimizedToolsProvider.
+ */
+export declare function useMinimizedTools(): MinimizedToolsContextValue;
+export {};
+//# sourceMappingURL=MinimizedToolsContext.d.ts.map

package/lib/typescript/commonjs/floatingMenu/MinimizedToolsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MinimizedToolsContext.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAOZ,SAAS,EAEV,MAAM,OAAO,CAAC;AAQf;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,IAAI,EAAE,aAAa,GAAG,UAAU,CAAC;IACjC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,mCAAmC;IACnC,kBAAkB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,IAAI,EAAE,SAAS,CAAC;IAChB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAWD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAY3D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,UAAU,0BAA0B;IAClC,wCAAwC;IACxC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,KAAK,IAAI,CAAC;IAC7D,wEAAwE;IACxE,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,GAAG,IAAI,CAAC;IACtD,6CAA6C;IAC7C,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,8CAA8C;IAC9C,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;IACpE,gCAAgC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,YAAY,CAAC;IACxC,wDAAwD;IACxD,mBAAmB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;CAClE;AAkCD,UAAU,2BAA2B;IACnC,QAAQ,EAAE,SAAS,CAAC;IACpB,oFAAoF;IACpF,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,WAAW,GACZ,EAAE,2BAA2B,qBAwJ7B;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,0BAA0B,CAmB9D"}

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

@@ -0,0 +1,10 @@
+import React from "react";
+import { MinimizedTool } from "./MinimizedToolsContext";
+export interface MinimizedToolsStackProps {
+    /** Callback when a tool should be restored */
+    onRestore?: (tool: MinimizedTool) => void;
+    /** Width of the parent container (for matching widths) */
+    containerWidth?: number;
+}
+export declare function MinimizedToolsStack({ onRestore, containerWidth, }: MinimizedToolsStackProps): React.JSX.Element;
+//# sourceMappingURL=MinimizedToolsStack.d.ts.map

package/lib/typescript/commonjs/floatingMenu/MinimizedToolsStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MinimizedToolsStack.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/MinimizedToolsStack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAS9D,OAAO,EAAqB,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA+K3E,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,cAA8B,GAC/B,EAAE,wBAAwB,qBA8C1B"}

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

@@ -0,0 +1,21 @@
+/**
+ * ToggleStateManager
+ *
+ * Global event emitter for toggle-only dev tools to notify when their state changes.
+ * This allows FloatingMenu to re-render and update icon colors.
+ */
+type Listener = () => void;
+declare class ToggleStateManager {
+    private listeners;
+    /**
+     * Subscribe to any toggle state change
+     */
+    subscribe(listener: Listener): () => void;
+    /**
+     * Notify all subscribers that a toggle state changed
+     */
+    notify(): void;
+}
+export declare const toggleStateManager: ToggleStateManager;
+export {};
+//# sourceMappingURL=ToggleStateManager.d.ts.map

package/lib/typescript/commonjs/floatingMenu/ToggleStateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleStateManager.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/ToggleStateManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B,cAAM,kBAAkB;IACtB,OAAO,CAAC,SAAS,CAA4B;IAE7C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC;;OAEG;IACH,MAAM,IAAI,IAAI;CAGf;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

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

@@ -0,0 +1,75 @@
+import type { InstalledApp } from "./types";
+/**
+ * Automatically discovers and loads dev tool presets from installed packages.
+ *
+ * This function attempts to import presets from known dev tool packages.
+ * If a package is installed, its preset will be automatically loaded.
+ * If a package is not installed, it will be silently skipped.
+ *
+ * This enables zero-config setup - just install the packages you want
+ * and they'll automatically appear in your dev tools!
+ *
+ * @returns Array of automatically discovered preset configurations
+ *
+ * @example
+ * ```tsx
+ * import { FloatingDevTools, autoDiscoverPresets } from '@buoy-gg/core';
+ *
+ * // Automatically discover and load all installed dev tool presets
+ * const autoPresets = autoDiscoverPresets();
+ *
+ * function App() {
+ *   return (
+ *     <FloatingDevTools
+ *       apps={autoPresets} // That's it! All installed tools load automatically
+ *       environment="local"
+ *       userRole="admin"
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Combine auto-discovery with custom tools
+ * const autoPresets = autoDiscoverPresets();
+ * const customTools = [
+ *   {
+ *     id: "my-custom-tool",
+ *     name: "CUSTOM",
+ *     // ... custom config
+ *   },
+ * ];
+ *
+ * const allTools = [...autoPresets, ...customTools];
+ *
+ * <FloatingDevTools apps={allTools} />
+ * ```
+ */
+export declare function autoDiscoverPresets(): InstalledApp[];
+/**
+ * Merges auto-discovered presets with custom tools, ensuring no duplicates.
+ * Custom tools take precedence over auto-discovered ones with the same ID.
+ *
+ * @param customTools - Array of custom tool configurations
+ * @returns Combined array of tools with custom tools taking precedence
+ *
+ * @example
+ * ```tsx
+ * import { FloatingDevTools, autoDiscoverPresetsWithCustom } from '@buoy-gg/core';
+ * import { createEnvTool } from '@buoy-gg/env';
+ *
+ * const customTools = [
+ *   // Override the env preset with custom config
+ *   createEnvTool({
+ *     requiredEnvVars: myRequiredVars,
+ *   }),
+ * ];
+ *
+ * const allTools = autoDiscoverPresetsWithCustom(customTools);
+ *
+ * <FloatingDevTools apps={allTools} />
+ * ```
+ */
+export declare function autoDiscoverPresetsWithCustom(customTools: InstalledApp[]): InstalledApp[];
+//# sourceMappingURL=autoDiscoverPresets.d.ts.map

package/lib/typescript/commonjs/floatingMenu/autoDiscoverPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoDiscoverPresets.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/autoDiscoverPresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,EAAE,CA0IpD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,YAAY,EAAE,GAC1B,YAAY,EAAE,CAahB"}

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

@@ -0,0 +1,120 @@
+/**
+ * Type-safe default configuration for React Buoy DevTools.
+ *
+ * This module provides a simple, type-safe way for teams to configure
+ * which tools are enabled by default in the floating menu and dial menu.
+ *
+ * @example
+ * ```tsx
+ * import { FloatingDevTools } from '@buoy-gg/core';
+ *
+ * // Simple: Enable specific tools by default
+ * <FloatingDevTools
+ *   defaultFloatingTools={['env', 'environment', 'network']}
+ *   defaultDialTools={['env', 'network', 'storage', 'query']}
+ * />
+ * ```
+ */
+/**
+ * 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' | 'benchmark';
+/**
+ * Special floating-only tool IDs that only appear in the floating bubble row.
+ */
+export type FloatingOnlyToolId = 'environment';
+/**
+ * All tool IDs that can appear in the floating menu (bubble row).
+ * Includes all built-in tools plus floating-only tools.
+ */
+export type FloatingToolId = BuiltInToolId | FloatingOnlyToolId;
+/**
+ * Tool IDs that can appear in the dial menu.
+ * Same as BuiltInToolId (environment badge is floating-only).
+ */
+export type DialToolId = BuiltInToolId;
+/**
+ * Maximum number of tools allowed in the dial menu.
+ */
+export declare const MAX_DIAL_TOOLS = 6;
+/**
+ * Configuration for default floating menu tools.
+ * Pass an array of tool IDs to enable by default.
+ *
+ * @example
+ * ```tsx
+ * const floatingDefaults: DefaultFloatingConfig = ['env', 'environment', 'network'];
+ * ```
+ */
+export type DefaultFloatingConfig = FloatingToolId[];
+/**
+ * Configuration for default dial menu tools.
+ * Pass an array of 1-6 tool IDs to enable by default.
+ *
+ * @example
+ * ```tsx
+ * const dialDefaults: DefaultDialConfig = ['env', 'network', 'storage', 'query'];
+ * ```
+ */
+export type DefaultDialConfig = DialToolId[];
+/**
+ * Validates that a dial configuration doesn't exceed the maximum allowed tools.
+ * Throws an error with helpful message if validation fails.
+ *
+ * @param tools - Array of dial tool IDs to validate
+ * @throws Error if more than MAX_DIAL_TOOLS are provided
+ *
+ * @example
+ * ```tsx
+ * // This is valid
+ * validateDialConfig(['env', 'network', 'storage']);
+ *
+ * // This throws an error
+ * validateDialConfig(['env', 'network', 'storage', 'query', 'route-events', 'debug-borders', 'benchmark']);
+ * // Error: "Dial menu default configuration has 7 tools, but maximum is 6..."
+ * ```
+ */
+export declare function validateDialConfig(tools: DefaultDialConfig): void;
+/**
+ * Helper to create a type-safe default configuration.
+ * Provides autocomplete and validation at compile time.
+ *
+ * @example
+ * ```tsx
+ * import { createDefaultConfig } from '@buoy-gg/core';
+ *
+ * const config = createDefaultConfig({
+ *   floating: ['env', 'environment', 'network', 'query-wifi-toggle'],
+ *   dial: ['env', 'network', 'storage', 'query', 'route-events', 'debug-borders'],
+ * });
+ *
+ * <FloatingDevTools
+ *   defaultFloatingTools={config.floating}
+ *   defaultDialTools={config.dial}
+ * />
+ * ```
+ */
+export declare function createDefaultConfig<F extends FloatingToolId[], D extends DialToolId[]>(config: {
+    floating?: F;
+    dial?: D;
+}): {
+    floating: F | undefined;
+    dial: D | undefined;
+};
+/**
+ * Type guard to check if a string is a valid FloatingToolId.
+ */
+export declare function isFloatingToolId(id: string): id is FloatingToolId;
+/**
+ * Type guard to check if a string is a valid DialToolId.
+ */
+export declare function isDialToolId(id: string): id is DialToolId;
+/**
+ * Converts an array of tool IDs into a settings record.
+ * Used internally to convert default config to DevToolsSettings format.
+ *
+ * @internal
+ */
+export declare function toolIdsToRecord<T extends string>(ids: T[], allPossibleIds: T[]): Record<string, boolean>;
+//# sourceMappingURL=defaultConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultConfig.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/defaultConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,SAAS,GACT,SAAS,GACT,OAAO,GACP,mBAAmB,GACnB,cAAc,GACd,eAAe,GACf,mBAAmB,GACnB,yBAAyB,GACzB,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG,cAAc,EAAE,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,EAAE,CAAC;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CASjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,SAAS,cAAc,EAAE,EAC1B,CAAC,SAAS,UAAU,EAAE,EACtB,MAAM,EAAE;IACR,QAAQ,CAAC,EAAE,CAAC,CAAC;IACb,IAAI,CAAC,EAAE,CAAC,CAAC;CACV,GAAG;IACF,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;CACrB,CAUA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,cAAc,CAejE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,UAAU,CAczD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,GAAG,EAAE,CAAC,EAAE,EACR,cAAc,EAAE,CAAC,EAAE,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/lib/typescript/commonjs/floatingMenu/dial/DialDevTools.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode, FC } from "react";
+import { type DevToolsSettings } from "../DevToolsSettingsModal";
+import type { InstalledApp, FloatingMenuActions, FloatingMenuState } from "../types";
+export type IconType = {
+    id?: string;
+    name: string;
+    icon: ReactNode;
+    /**
+     * Original icon component/function for dynamic rendering with hooks.
+     *
+     * ⚠️ IMPORTANT - DO NOT REMOVE THIS PROPERTY ⚠️
+     * This allows DialIcon to render the icon as a JSX component, enabling
+     * React hooks to work (e.g., WiFi toggle subscribing to onlineManager).
+     */
+    iconComponent?: (ctx: {
+        slot?: string;
+        size?: number;
+        state?: FloatingMenuState;
+        actions?: FloatingMenuActions;
+    }) => ReactNode;
+    color: string;
+    onPress: () => void;
+};
+interface DialDevToolsProps {
+    onClose?: () => void;
+    onSettingsPress?: () => void;
+    settings?: DevToolsSettings;
+    autoOpenSettings?: boolean;
+    apps: InstalledApp[];
+    state?: FloatingMenuState;
+    actions?: FloatingMenuActions;
+}
+export declare const DialDevTools: FC<DialDevToolsProps>;
+export {};
+//# sourceMappingURL=DialDevTools.d.ts.map

package/lib/typescript/commonjs/floatingMenu/dial/DialDevTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialDevTools.d.ts","sourceRoot":"","sources":["../../../../../src/floatingMenu/dial/DialDevTools.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAwC,SAAS,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAmB5E,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAqBlB,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,mBAAmB,CAAA;KAAE,KAAK,SAAS,CAAC;IAC/H,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAgpB9C,CAAC"}

package/lib/typescript/commonjs/floatingMenu/dial/DialIcon.d.ts

@@ -0,0 +1,14 @@
+import { FC } from "react";
+import { Animated } from "react-native";
+import { IconType } from "./DialDevTools";
+type Props = {
+    index: number;
+    icon: IconType;
+    iconsProgress: Animated.Value;
+    onPress: (index: number) => void;
+    selectedIcon: number;
+    totalIcons: number;
+};
+export declare const DialIcon: FC<Props>;
+export {};
+//# sourceMappingURL=DialIcon.d.ts.map

package/lib/typescript/commonjs/floatingMenu/dial/DialIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialIcon.d.ts","sourceRoot":"","sources":["../../../../../src/floatingMenu/dial/DialIcon.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAU,EAAE,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAML,QAAQ,EACT,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAmB1C,KAAK,KAAK,GAAG;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC;IAC9B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,KAAK,CA2L9B,CAAC"}

package/lib/typescript/commonjs/floatingMenu/dial/OnboardingTooltip.d.ts

@@ -0,0 +1,12 @@
+import { FC } from "react";
+interface OnboardingTooltipProps {
+    visible: boolean;
+    onDismiss: () => void;
+    /** Optional custom title. Defaults to "Welcome to Buoy Tools!" */
+    title?: string;
+    /** Optional custom message. Defaults to dial menu instruction */
+    message?: string;
+}
+export declare const OnboardingTooltip: FC<OnboardingTooltipProps>;
+export {};
+//# sourceMappingURL=OnboardingTooltip.d.ts.map

package/lib/typescript/commonjs/floatingMenu/dial/OnboardingTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnboardingTooltip.d.ts","sourceRoot":"","sources":["../../../../../src/floatingMenu/dial/OnboardingTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAqB,MAAM,OAAO,CAAC;AAY9C,UAAU,sBAAsB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAiJxD,CAAC"}

package/lib/typescript/commonjs/floatingMenu/dial/onboardingConstants.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared constants for onboarding tooltip positioning
+ * These ensure the floating menu aligns perfectly under the tooltip arrow
+ * All positions are calculated dynamically based on screen size
+ */
+export declare const ARROW_BOTTOM_OFFSET = -40;
+export declare const ARROW_HEIGHT = 20;
+export declare const SPACING_GAP = 10;
+/**
+ * Calculate the center Y position of the screen
+ * This is used to vertically center the onboarding UI
+ *
+ * @returns Y coordinate at the center of the screen
+ */
+export declare function getScreenCenterY(): number;
+/**
+ * Calculate the tooltip position to center it vertically on screen
+ * Uses flexbox-style centering - tooltip will center itself with its actual size
+ *
+ * @returns Distance from screen bottom for tooltip positioning
+ */
+export declare function calculateTooltipPosition(): number;
+/**
+ * Calculate the position where a target element should be placed
+ * to align directly under the tooltip arrow
+ *
+ * @returns Distance from screen bottom where element should be positioned
+ */
+export declare function calculateTargetPosition(): number;
+//# sourceMappingURL=onboardingConstants.d.ts.map

package/lib/typescript/commonjs/floatingMenu/dial/onboardingConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboardingConstants.d.ts","sourceRoot":"","sources":["../../../../../src/floatingMenu/dial/onboardingConstants.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAGH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAUjD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAWhD"}

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

@@ -0,0 +1,56 @@
+import { ReactNode } from "react";
+import { type Environment } from "@buoy-gg/shared-ui";
+import { type UserRole } from "@buoy-gg/floating-tools-core";
+export type { UserRole };
+export declare function Divider(): import("react").JSX.Element;
+export declare function UserStatus({ userRole, onPress, }: {
+    userRole: UserRole;
+    onPress?: () => void;
+}): import("react").JSX.Element;
+export type FloatingToolsProps = {
+    enablePositionPersistence?: boolean;
+    children?: ReactNode;
+    /** When true, pushes the bubble to the side (hidden position) */
+    pushToSide?: boolean;
+    /** When true, centers the bubble on screen (for onboarding) */
+    centerOnboarding?: boolean;
+    /** Current environment for the environment selector */
+    environment?: Environment;
+    /** Available environments for switching */
+    availableEnvironments?: Environment[];
+    /** Callback when environment is selected */
+    onEnvironmentSwitch?: (env: Environment) => void;
+    /** Whether environment selector should be shown */
+    showEnvironmentSelector?: boolean;
+};
+/**
+ * FloatingTools - A draggable, resizable bubble for development tools
+ *
+ * This component provides a floating bubble interface that can contain various
+ * development tools and controls. It features:
+ * - Drag and drop positioning with boundary constraints
+ * - Hide/show functionality by dragging to screen edge
+ * - Position persistence across app restarts
+ * - Safe area aware positioning
+ * - Automatic divider insertion between child components
+ *
+ * @param props - Configuration for the floating tools
+ * @param props.enablePositionPersistence - Whether to save/restore position (default: true)
+ * @param props.children - Child components to render in the bubble
+ *
+ * @returns JSX.Element representing the floating tools bubble
+ *
+ * @example
+ * ```typescript
+ * <FloatingTools enablePositionPersistence={true}>
+ *   <UserStatus userRole="admin" onPress={handleUserPress} />
+ *   <ToolButton onPress={openSettings} />
+ * </FloatingTools>
+ * ```
+ *
+ * @performance Uses native driver animations for smooth positioning
+ * @performance Implements efficient boundary checking and position validation
+ * @performance Includes debounced position saving for optimal storage performance
+ */
+export declare function FloatingTools({ enablePositionPersistence, pushToSide, centerOnboarding, children, environment, availableEnvironments, onEnvironmentSwitch, showEnvironmentSelector, }: FloatingToolsProps): import("react").JSX.Element;
+//# sourceMappingURL=floatingTools.d.ts.map

package/lib/typescript/commonjs/floatingMenu/floatingTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingTools.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/floatingTools.tsx"],"names":[],"mappings":"AAAA,OAAO,EASL,SAAS,EACV,MAAM,OAAO,CAAC;AAsBf,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjF,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EAAE,QAAQ,EAAE,CAAC;AAiPzB,wBAAgB,OAAO,gCAQtB;AAuBD,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,GACR,EAAE;IACD,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,+BA8CA;AAmBD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,WAAW,EAAE,CAAC;IACtC,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,mDAAmD;IACnD,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAAC,EAC5B,yBAAgC,EAChC,UAAkB,EAClB,gBAAwB,EACxB,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,uBAA+B,GAChC,EAAE,kBAAkB,+BA+ZpB"}

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

@@ -0,0 +1,10 @@
+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 {};
+//# sourceMappingURL=settingsBus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settingsBus.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/settingsBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAExC,cAAM,cAAc,CAAC,CAAC,GAAG,gBAAgB;IACvC,OAAO,CAAC,SAAS,CAA+B;IAEhD,IAAI,CAAC,OAAO,EAAE,CAAC;IAUf,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;CAIlC;AAED,eAAO,MAAM,WAAW,kCAAyC,CAAC"}

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

@@ -0,0 +1,56 @@
+import { ComponentType } from "react";
+/** Where a tool should render within the floating menu surface. */
+export type AppSlot = "row" | "dial" | "both";
+/** Generic, dynamic context shared with floating tools. */
+export type FloatingMenuState = Record<string, unknown>;
+/** Named callbacks that floating tools can invoke. */
+export type FloatingMenuActions = Record<string, (...args: any[]) => void>;
+/**
+ * Runtime details provided to tool icon renderers so they can adapt to the menu slot
+ * and size they are rendered within.
+ */
+export type FloatingMenuRenderCtx = {
+    /** Slot where the icon is being rendered (row or dial). */
+    slot: AppSlot;
+    /** Pixel size that the icon should try to fit within. */
+    size: number;
+    /** Optional shared state object supplied by the host. */
+    state?: FloatingMenuState;
+    /** Optional shared action callbacks supplied by the host. */
+    actions?: FloatingMenuActions;
+};
+/** Declarative description of an app that can be launched from the floating menu. */
+export interface InstalledApp {
+    /** Unique identifier used for persistence and settings. */
+    id: string;
+    /** Human readable name shown in accessibility labels and modal headers. */
+    name: string;
+    /** Brief description of what this tool does, shown in settings. */
+    description?: string;
+    /** Visual or functional icon to render in the floating menu. */
+    icon: React.ReactNode | ((ctx: FloatingMenuRenderCtx) => React.ReactNode);
+    /** Preferred layout slot; defaults to `"both"` when unspecified. */
+    slot?: AppSlot;
+    /** Optional accent color for the tool. */
+    color?: string;
+    /** Plug-and-play launching component handled by the AppHost. */
+    component: ComponentType<any>;
+    /** Props to pass to the launched component (e.g. requiredEnvVars). */
+    props?: Record<string, unknown>;
+    /**
+     * How to render the component:
+     * - self-modal: component expects visible/onClose; we supply them.
+     * - host-modal: we wrap your component in a simple RN Modal.
+     * - inline: full-screen overlay, absolutely positioned.
+     * - toggle-only: no modal/overlay, only calls onPress callback.
+     */
+    launchMode?: "self-modal" | "host-modal" | "inline" | "toggle-only";
+    /** Prevent more than one instance of this app at a time. */
+    singleton?: boolean;
+    /**
+     * Optional callback invoked when the app icon is pressed.
+     * For toggle-only tools, call `actions?.notifyToggleChange?.()` to update icon colors.
+     */
+    onPress?: (actions?: FloatingMenuActions) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/floatingMenu/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACxD,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,2DAA2D;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B,CAAC;AAEF,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,EAAE,qBAAqB,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1E,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;IACpE,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACnD"}

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

@@ -0,0 +1,18 @@
+export { FloatingDevTools } from "./floatingMenu/FloatingDevTools";
+export type { FloatingDevToolsProps, EnvVarConfig, StorageKeyConfig, } from "./floatingMenu/FloatingDevTools";
+export { autoDiscoverPresets, autoDiscoverPresetsWithCustom, } from "./floatingMenu/autoDiscoverPresets";
+export { createDefaultConfig, validateDialConfig, isFloatingToolId, isDialToolId, MAX_DIAL_TOOLS, } from "./floatingMenu/defaultConfig";
+export type { BuiltInToolId, FloatingToolId, FloatingOnlyToolId, DialToolId, DefaultFloatingConfig, DefaultDialConfig, } from "./floatingMenu/defaultConfig";
+export { FloatingMenu } from "./floatingMenu/FloatingMenu";
+export * from "./floatingMenu/types";
+export { DevToolsSettingsModal, useDevToolsSettings, } from "./floatingMenu/DevToolsSettingsModal";
+export type { DevToolsSettings, GlobalDevToolsSettings } from "./floatingMenu/DevToolsSettingsModal";
+export { AppHostProvider, AppOverlay, useAppHost, } from "./floatingMenu/AppHost";
+export { DevToolsVisibilityProvider, useDevToolsVisibility, } from "./floatingMenu/DevToolsVisibilityContext";
+export { toggleStateManager } from "./floatingMenu/ToggleStateManager";
+export { MinimizedToolsProvider, useMinimizedTools, getIconPosition, getIconSize, } from "./floatingMenu/MinimizedToolsContext";
+export type { MinimizedTool, ModalRestoreState, IconPosition, } from "./floatingMenu/MinimizedToolsContext";
+export { MinimizedToolsStack } from "./floatingMenu/MinimizedToolsStack";
+export { LicenseManager, useLicense, useFeatureAccess, useSeats, useIsPro, setLicenseKey, isPro, hasEntitlement, } from "@buoy-gg/license";
+export type { LicenseState, LicenseEvent, LicenseListener, } from "@buoy-gg/license";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAGrG,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,GACX,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAGvE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,WAAW,GACZ,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAIzE,OAAO,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,KAAK,EACL,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}