@buoy-gg/shared-ui 7.0.16 → 7.0.17

package/lib/commonjs/utils/stateSnapshotRegistry.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getStateSnapshotProvider = getStateSnapshotProvider;
+exports.getStateSnapshotProviders = getStateSnapshotProviders;
+exports.registerStateSnapshotProvider = registerStateSnapshotProvider;
+exports.subscribeToStateSnapshotProviders = subscribeToStateSnapshotProviders;
+/**
+ * Cross-package bridge for app-state snapshot & restore (Time Machine).
+ *
+ * Each state tool (`@buoy-gg/storage`, `@buoy-gg/redux`, `@buoy-gg/zustand`,
+ * `@buoy-gg/jotai`, `@buoy-gg/react-query`) registers a provider here at
+ * module init (or from its app-lifetime sync hook); `@buoy-gg/time-machine`
+ * consumes the registry. Neither side imports the other — same
+ * optional-capability pattern as renderCaptureRegistry.
+ *
+ * Apps can also register custom providers for state Buoy doesn't know about.
+ */
+
+const providers = new Map();
+const listeners = new Set();
+function notify() {
+  listeners.forEach(l => {
+    try {
+      l();
+    } catch {
+      // listener errors must not break registration
+    }
+  });
+}
+
+/**
+ * Register a provider. Last registration wins for a given id.
+ * Returns an unregister function (only removes the provider if it is still
+ * the registered one for that id).
+ */
+function registerStateSnapshotProvider(provider) {
+  providers.set(provider.id, provider);
+  notify();
+  return () => {
+    if (providers.get(provider.id) === provider) {
+      providers.delete(provider.id);
+      notify();
+    }
+  };
+}
+function getStateSnapshotProviders() {
+  return Array.from(providers.values());
+}
+function getStateSnapshotProvider(id) {
+  return providers.get(id) ?? null;
+}
+
+/** Notifies when providers register/unregister (query registers late). */
+function subscribeToStateSnapshotProviders(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}

package/lib/module/hooks/index.js

@@ -1,6 +1,7 @@
 "use strict";
 
 export { useFilterManager } from "./useFilterManager.js";
+export { usePersistedState } from "./usePersistedState.js";
 export { useSafeAreaInsets } from "./useSafeAreaInsets.js";
 export { getSafeAreaInsets } from "./useSafeAreaInsets.js";
 export { useDeviceInfo, getDeviceInfo, logDeviceInfo } from "./useDeviceInfo.js";

package/lib/module/hooks/safe-area-impl.js

@@ -3,7 +3,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-08-06T20:33:57.771Z
+ * Generated at: 2026-08-07T14:32:36.664Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/module/hooks/usePersistedState.js

@@ -0,0 +1,68 @@
+"use strict";
+
+import { useCallback, useEffect, useRef, useState } from "react";
+import { persistentStorage } from "../utils/persistentStorage.js";
+
+/**
+ * Per-key cache so remounts (and multiple consumers of the same key) render
+ * the last-known value immediately instead of flashing the default while the
+ * async backend loads again.
+ */
+const hydratedCache = new Map();
+
+/**
+ * `useState` persisted through `persistentStorage` (FileSystem → AsyncStorage
+ * → memory). Replaces the load-then-`hasLoaded`-guard `useEffect` pattern
+ * every tool used to hand-roll.
+ *
+ * Values are JSON-serialized; the default is returned until hydration
+ * completes (subsequent mounts of the same key hydrate synchronously from an
+ * in-memory cache). The third tuple element reports hydration so callers can
+ * defer writes that must not clobber a not-yet-loaded value.
+ *
+ * ```tsx
+ * const [tab, setTab, tabHydrated] = usePersistedState("@react_buoy_custom_flags_tab", "flags");
+ * ```
+ */
+export function usePersistedState(key, defaultValue) {
+  const [value, setValue] = useState(() => hydratedCache.has(key) ? hydratedCache.get(key) : defaultValue);
+  const [hydrated, setHydrated] = useState(() => hydratedCache.has(key));
+  const keyRef = useRef(key);
+  keyRef.current = key;
+  useEffect(() => {
+    if (hydratedCache.has(key)) {
+      setValue(hydratedCache.get(key));
+      setHydrated(true);
+      return;
+    }
+    let cancelled = false;
+    persistentStorage.getItem(key).then(raw => {
+      if (cancelled) return;
+      if (raw != null) {
+        try {
+          const parsed = JSON.parse(raw);
+          hydratedCache.set(key, parsed);
+          setValue(parsed);
+        } catch {
+          // Corrupt payload — fall back to the default and let the next
+          // write repair it.
+        }
+      }
+      setHydrated(true);
+    }).catch(() => {
+      if (!cancelled) setHydrated(true);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [key]);
+  const set = useCallback(next => {
+    setValue(prev => {
+      const resolved = typeof next === "function" ? next(prev) : next;
+      hydratedCache.set(keyRef.current, resolved);
+      persistentStorage.setItem(keyRef.current, JSON.stringify(resolved)).catch(() => {});
+      return resolved;
+    });
+  }, []);
+  return [value, set, hydrated];
+}

package/lib/module/icons/index.js

@@ -11,6 +11,7 @@ export { EnvIcon, ENV_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 // into core, so these are the same artwork the Flutter build renders. Tool
 // packages re-export from here rather than drawing their own copies.
 export { ConsoleIcon, CONSOLE_ICON_COLOR } from "@buoy-gg/floating-tools-core";
+export { TimeMachineIcon, TIME_MACHINE_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { ImagesIcon, IMAGES_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { AssetsIcon, ASSETS_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { ImpersonateIcon, IMPERSONATE_ICON_COLOR } from "@buoy-gg/floating-tools-core";

package/lib/module/index.js

@@ -26,6 +26,10 @@ parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath,
 loadOptionalModule, getCachedOptionalModule,
 // Render-commit capture bridge (provider: highlight-updates, consumer: perf-monitor)
 setRenderCaptureProvider, getRenderCaptureProvider,
+// State snapshot bridge (providers: storage/redux/zustand/jotai/react-query, consumer: time-machine)
+registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders,
+// Minimal superjson (Date/Map/Set/BigInt-safe round-trip) for snapshot payloads
+superJsonSerialize, superJsonDeserialize,
 // JS-bundle reload (core's `app` adapter + perf-monitor's batch runner)
 reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS,
 // Subscribable base class for self-managing listeners

package/lib/module/storage/devToolsStorageKeys.js

@@ -31,6 +31,28 @@ export const devToolsStorageKeys = {
     dimensions: () => `${devToolsStorageKeys.modal.root()}_dimensions`,
     hintAcknowledged: () => `${devToolsStorageKeys.modal.root()}_hint_acknowledged`
   },
+  /**
+   * Namespace factory for third-party custom tools. Keys share the
+   * `@react_buoy` prefix, so `isDevToolsStorageKey` filtering (and the Storage
+   * tool's internal-key handling) covers custom-tool persistence for free.
+   *
+   * ```ts
+   * const keys = devToolsStorageKeys.custom("feature-flags");
+   * keys.modal();          // "@react_buoy_custom_feature-flags_modal"
+   * keys.key("overrides"); // "@react_buoy_custom_feature-flags_overrides"
+   * ```
+   */
+  custom: toolId => {
+    const root = `${devToolsStorageKeys.base}_custom_${toolId}`;
+    return {
+      root: () => root,
+      /** JsModal `persistenceKey` for this tool's window dimensions. */
+      modal: () => `${root}_modal`,
+      settings: () => `${root}_settings`,
+      /** Arbitrary tool-scoped key. */
+      key: suffix => `${root}_${suffix}`
+    };
+  },
   /**
    * Settings-related storage keys
    */

package/lib/module/ui/components/ModalHeader.js

@@ -1,7 +1,8 @@
 "use strict";
 
-import { View, Text, TouchableOpacity, StyleSheet } from "react-native";
-import { ChevronLeft, X } from "../../icons/index.js";
+import { View, Text, TextInput, TouchableOpacity, StyleSheet } from "react-native";
+import { useEffect, useRef } from "react";
+import { ChevronLeft, Search as SearchIcon, X } from "../../icons/index.js";
 import { buoyColors } from "../gameUI/constants/gameUIColors.js";
 
 // Base ModalHeader container component
@@ -111,10 +112,51 @@ export function Actions({
 }
 Actions.displayName = "ModalHeaderActions";
 
+// Expanding search input for the header. Render this IN PLACE OF
+// `ModalHeader.Content` while search is active — it fills the same flex slot.
+// Extracts the idiom env/network/storage each hand-rolled (~50 lines apiece).
+
+export function HeaderSearch({
+  value,
+  onChangeText,
+  onCancel,
+  placeholder = "Search...",
+  autoFocus = true
+}) {
+  const inputRef = useRef(null);
+  useEffect(() => {
+    if (autoFocus) inputRef.current?.focus();
+  }, [autoFocus]);
+  return /*#__PURE__*/_jsxs(View, {
+    style: styles.searchContainer,
+    children: [/*#__PURE__*/_jsx(SearchIcon, {
+      size: 12,
+      color: buoyColors.textSecondary
+    }), /*#__PURE__*/_jsx(TextInput, {
+      ref: inputRef,
+      style: styles.searchInput,
+      placeholder: placeholder,
+      placeholderTextColor: buoyColors.textMuted,
+      value: value,
+      onChangeText: onChangeText,
+      autoCorrect: false,
+      autoCapitalize: "none"
+    }), /*#__PURE__*/_jsx(TouchableOpacity, {
+      onPress: onCancel,
+      style: styles.searchCancelButton,
+      children: /*#__PURE__*/_jsx(X, {
+        size: 12,
+        color: buoyColors.textSecondary
+      })
+    })]
+  });
+}
+
 // Attach sub-components to the main component
 ModalHeader.Navigation = Navigation;
 ModalHeader.Content = Content;
 ModalHeader.Actions = Actions;
+ModalHeader.Search = HeaderSearch;
 const styles = StyleSheet.create({
   headerContainer: {
     flexDirection: "row",
@@ -162,5 +204,31 @@ const styles = StyleSheet.create({
   },
   headerContentNoMargin: {
     marginHorizontal: 0
+  },
+  searchContainer: {
+    flexDirection: "row",
+    alignItems: "center",
+    flex: 1,
+    backgroundColor: buoyColors.input,
+    borderRadius: 6,
+    paddingHorizontal: 10,
+    paddingVertical: 4,
+    marginHorizontal: 12,
+    marginVertical: 4,
+    height: 32,
+    borderWidth: 1,
+    borderColor: buoyColors.border
+  },
+  searchInput: {
+    flex: 1,
+    marginLeft: 8,
+    fontSize: 13,
+    color: buoyColors.text,
+    padding: 0,
+    height: "100%"
+  },
+  searchCancelButton: {
+    padding: 4,
+    marginLeft: 4
   }
 });

package/lib/module/ui/components/ToolButton.js

@@ -0,0 +1,86 @@
+"use strict";
+
+import { StyleSheet, Text, TouchableOpacity } from "react-native";
+import { buoyColors, gameUIColors } from "../gameUI/constants/gameUIColors.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The shared action button for dev-tool surfaces. Fills the gap where every
+ * tool hand-styled its own TouchableOpacity for "Clear", "Apply", "Reset".
+ */
+export function ToolButton({
+  label,
+  onPress,
+  variant = "primary",
+  size = "medium",
+  disabled = false,
+  icon,
+  style
+}) {
+  const palette = VARIANTS[variant];
+  return /*#__PURE__*/_jsxs(TouchableOpacity, {
+    accessibilityRole: "button",
+    accessibilityLabel: label,
+    onPress: onPress,
+    disabled: disabled,
+    style: [styles.base, size === "small" ? styles.small : styles.medium, {
+      backgroundColor: palette.background,
+      borderColor: palette.border,
+      borderWidth: variant === "ghost" ? 0 : 1
+    }, disabled && styles.disabled, style],
+    children: [icon, /*#__PURE__*/_jsx(Text, {
+      style: [styles.label, size === "small" && styles.labelSmall, {
+        color: palette.text
+      }],
+      children: label
+    })]
+  });
+}
+const VARIANTS = {
+  primary: {
+    background: buoyColors.primary + "22",
+    border: buoyColors.primary + "66",
+    text: buoyColors.primary
+  },
+  danger: {
+    background: gameUIColors.error + "15",
+    border: gameUIColors.error + "60",
+    text: gameUIColors.error
+  },
+  warning: {
+    background: gameUIColors.warning + "15",
+    border: gameUIColors.warning + "60",
+    text: gameUIColors.warning
+  },
+  ghost: {
+    background: "transparent",
+    border: "transparent",
+    text: buoyColors.textSecondary
+  }
+};
+const styles = StyleSheet.create({
+  base: {
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "center",
+    gap: 6,
+    borderRadius: 8
+  },
+  medium: {
+    paddingVertical: 8,
+    paddingHorizontal: 14
+  },
+  small: {
+    paddingVertical: 5,
+    paddingHorizontal: 10
+  },
+  disabled: {
+    opacity: 0.4
+  },
+  label: {
+    fontSize: 12,
+    fontWeight: "600"
+  },
+  labelSmall: {
+    fontSize: 11
+  }
+});

package/lib/module/ui/components/index.js

@@ -13,6 +13,7 @@ export { FilterSection, FilterBadge, AddFilterInput, AddFilterButton, FilterList
 export { CompactFilterChips } from "./CompactFilterChips.js";
 export { Badge, StatusBadge, CountBadge, TypeBadge, MethodBadge } from "./Badge.js";
 export { TabSelector } from "./TabSelector.js";
+export { ToolButton } from "./ToolButton.js";
 export { EventListItem } from "./EventListItem.js";
 export { StatsCard } from "./StatsCard.js";
 export { CompactRow } from "./CompactRow.js";

package/lib/module/ui/index.js

@@ -5,6 +5,9 @@
 // Components
 export * from "./components/index.js";
 
+// Semantic design tokens for tool surfaces
+export { toolTheme } from "./toolTheme.js";
+
 // Console UI bits
 export { CyberpunkSectionButton } from "./console/CyberpunkSectionButton.js";
 

package/lib/module/ui/toolTheme.js

@@ -0,0 +1,93 @@
+"use strict";
+
+import { buoyColors, gameUIColors } from "./gameUI/constants/gameUIColors.js";
+
+/**
+ * Semantic design tokens for dev-tool surfaces — the single documented entry
+ * point for custom-tool authors (and, over time, internal tools).
+ *
+ * Buoy historically grew three color systems (`buoyColors`, `gameUIColors`,
+ * `macOSColors`) with tribal knowledge about which to use where. `toolTheme`
+ * encodes that knowledge: surfaces/text come from the brand palette, semantic
+ * status colors from the gameUI palette. Consumers should not need to know
+ * that split exists.
+ */
+export const toolTheme = {
+  colors: {
+    /** Modal/page background. */
+    surface: buoyColors.base,
+    /** Card / row background, one step above surface. */
+    card: buoyColors.card,
+    /** Pressed/hover background. */
+    hover: buoyColors.hover,
+    /** Text-input background. */
+    input: buoyColors.input,
+    border: buoyColors.border,
+    borderStrong: buoyColors.borderStrong,
+    text: buoyColors.text,
+    textSecondary: buoyColors.textSecondary,
+    textMuted: buoyColors.textMuted,
+    /** Buoy teal — primary accent. */
+    accent: buoyColors.primary,
+    success: gameUIColors.success,
+    warning: gameUIColors.warning,
+    error: gameUIColors.error,
+    info: gameUIColors.info
+  },
+  /**
+   * Text presets matching the styles internal tools re-declare per file.
+   * Spread into a style: `style={[toolTheme.text.label, { color: ... }]}`.
+   */
+  text: {
+    /** Modal/section titles. */
+    title: {
+      fontSize: 14,
+      fontWeight: "600",
+      color: buoyColors.text
+    },
+    /** Default body copy. */
+    body: {
+      fontSize: 13,
+      color: buoyColors.text
+    },
+    /** Secondary copy under a primary line. */
+    subtitle: {
+      fontSize: 12,
+      color: buoyColors.textSecondary
+    },
+    /** ALL-CAPS section labels ("LOCAL OVERRIDES"). */
+    label: {
+      fontSize: 10,
+      fontWeight: "700",
+      color: buoyColors.textMuted,
+      letterSpacing: 1.2,
+      fontFamily: "monospace"
+    },
+    /** Monospace values (keys, ids, payload snippets). */
+    mono: {
+      fontSize: 11,
+      color: buoyColors.textSecondary,
+      fontFamily: "monospace"
+    },
+    /** Timestamps and fine print. */
+    small: {
+      fontSize: 9,
+      color: buoyColors.textMuted,
+      fontFamily: "monospace"
+    }
+  },
+  /** 4-based spacing scale used across tool surfaces. */
+  spacing: {
+    xs: 4,
+    sm: 8,
+    md: 12,
+    lg: 16,
+    xl: 24
+  },
+  radius: {
+    sm: 6,
+    md: 8,
+    lg: 12,
+    pill: 9999
+  }
+};

package/lib/module/utils/index.js

@@ -9,6 +9,8 @@ export { getValueType, isPrimitive, isJsonSerializable, isValidJson, getConstruc
 export { parseValue, formatValue, getTypeColor, truncateText, flattenObject, formatPath } from "./valueFormatting.js";
 export { loadOptionalModule, getCachedOptionalModule } from "./loadOptionalModule.js";
 export { setRenderCaptureProvider, getRenderCaptureProvider } from "./renderCaptureRegistry.js";
+export { registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders } from "./stateSnapshotRegistry.js";
+export { serialize as superJsonSerialize, deserialize as superJsonDeserialize } from "./minimalSuperJSON.js";
 export { reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS } from "./reloadApp.js";
 export { Subscribable } from "./subscribable.js";
 export { subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange } from "./subscriberCountNotifier.js";

package/lib/module/utils/stateSnapshotRegistry.js

@@ -0,0 +1,55 @@
+"use strict";
+
+/**
+ * Cross-package bridge for app-state snapshot & restore (Time Machine).
+ *
+ * Each state tool (`@buoy-gg/storage`, `@buoy-gg/redux`, `@buoy-gg/zustand`,
+ * `@buoy-gg/jotai`, `@buoy-gg/react-query`) registers a provider here at
+ * module init (or from its app-lifetime sync hook); `@buoy-gg/time-machine`
+ * consumes the registry. Neither side imports the other — same
+ * optional-capability pattern as renderCaptureRegistry.
+ *
+ * Apps can also register custom providers for state Buoy doesn't know about.
+ */
+
+const providers = new Map();
+const listeners = new Set();
+function notify() {
+  listeners.forEach(l => {
+    try {
+      l();
+    } catch {
+      // listener errors must not break registration
+    }
+  });
+}
+
+/**
+ * Register a provider. Last registration wins for a given id.
+ * Returns an unregister function (only removes the provider if it is still
+ * the registered one for that id).
+ */
+export function registerStateSnapshotProvider(provider) {
+  providers.set(provider.id, provider);
+  notify();
+  return () => {
+    if (providers.get(provider.id) === provider) {
+      providers.delete(provider.id);
+      notify();
+    }
+  };
+}
+export function getStateSnapshotProviders() {
+  return Array.from(providers.values());
+}
+export function getStateSnapshotProvider(id) {
+  return providers.get(id) ?? null;
+}
+
+/** Notifies when providers register/unregister (query registers late). */
+export function subscribeToStateSnapshotProviders(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}

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

@@ -1,4 +1,5 @@
 export { useFilterManager } from "./useFilterManager";
+export { usePersistedState } from "./usePersistedState";
 export { useSafeAreaInsets } from "./useSafeAreaInsets";
 export { getSafeAreaInsets } from "./useSafeAreaInsets";
 export { useDeviceInfo, getDeviceInfo, logDeviceInfo, type DeviceInfo, type PlatformInfo, type DisplayInfo, type AccessibilitySettings, type AppearanceInfo, type LocaleInfo, type StatusBarInfo, type KeyboardInfo, type AppStateInfo, type UniqueIdentifiers, type SettingsInfo, } from "./useDeviceInfo";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC"}

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

@@ -1,7 +1,7 @@
 /**
  * Auto-generated safe area implementation
  * Detected: none
- * Generated at: 2026-08-06T20:33:57.771Z
+ * Generated at: 2026-08-07T14:32:36.664Z
  *
  * DO NOT EDIT - This file is generated by scripts/detect-safe-area.js
  *

package/lib/typescript/commonjs/hooks/usePersistedState.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `useState` persisted through `persistentStorage` (FileSystem → AsyncStorage
+ * → memory). Replaces the load-then-`hasLoaded`-guard `useEffect` pattern
+ * every tool used to hand-roll.
+ *
+ * Values are JSON-serialized; the default is returned until hydration
+ * completes (subsequent mounts of the same key hydrate synchronously from an
+ * in-memory cache). The third tuple element reports hydration so callers can
+ * defer writes that must not clobber a not-yet-loaded value.
+ *
+ * ```tsx
+ * const [tab, setTab, tabHydrated] = usePersistedState("@react_buoy_custom_flags_tab", "flags");
+ * ```
+ */
+export declare function usePersistedState<T>(key: string, defaultValue: T): [T, (next: T | ((prev: T) => T)) => void, boolean];
+//# sourceMappingURL=usePersistedState.d.ts.map

package/lib/typescript/commonjs/hooks/usePersistedState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistedState.d.ts","sourceRoot":"","sources":["../../../../src/hooks/usePersistedState.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,CAoDpD"}

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

@@ -2,6 +2,7 @@ export * from "./primitives";
 export { NetworkIcon, NETWORK_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { EnvIcon, ENV_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { ConsoleIcon, CONSOLE_ICON_COLOR } from "@buoy-gg/floating-tools-core";
+export { TimeMachineIcon, TIME_MACHINE_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { ImagesIcon, IMAGES_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { AssetsIcon, ASSETS_ICON_COLOR } from "@buoy-gg/floating-tools-core";
 export { ImpersonateIcon, IMPERSONATE_ICON_COLOR } from "@buoy-gg/floating-tools-core";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/icons/index.tsx"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKvE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/icons/index.tsx"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAG7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKvE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,cAAc,gBAAgB,CAAC"}

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

@@ -1,6 +1,6 @@
 export * from "./ui";
 export * from "./stores";
-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, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable, } from "./utils";
+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, registerStateSnapshotProvider, getStateSnapshotProviders, getStateSnapshotProvider, subscribeToStateSnapshotProviders, type StateSnapshotProvider, type StateSnapshotProviderStatus, type StateSnapshotCapture, type StateSnapshotRestoreResult, superJsonSerialize, superJsonDeserialize, type SuperJSONResult, reloadApp, scheduleReloadApp, resolveReloadStrategy, REMOTE_RELOAD_DELAY_MS, type ReloadStrategy, type ResolvedReloadStrategy, Subscribable, type SubscribableListener, subscriberCountNotifier, subscribeToSubscriberCountChanges, notifySubscriberCountChange, useSafeRouter, useSafePathname, useSafeSegments, useSafeGlobalSearchParams, getSafeRouter, getSafeCurrentPathname, isExpoRouterAvailable, } from "./utils";
 export * from "./utils/formatting";
 export * from "./utils/time";
 export { isPlainObject as isPlainObjectUtil } from "./utils/typeHelpers";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}