@buoy-gg/core 7.0.32 → 7.0.34

package/lib/module/floatingMenu/autoExternalSync.js

@@ -12,13 +12,16 @@
  * package, discovered with the same guarded-require pattern as
  * autoDiscoverPresets. No <DevToolsSync> wiring needed in the app.
  *
- * Identity defaults come from expo-constants when available (app name →
- * "MyApp (ios)" / "myapp-ios"), overridable via the `externalSync` prop.
+ * Identity defaults come from deviceIdentity.ts: the app name (expo-constants)
+ * plus a persisted per-install tail, so two devices on one build register as
+ * two devices — "MyApp (iPhone 17 Pro · 2c1d)" / "myapp-ios-3f9a2c1d".
+ * Overridable via the `externalSync` prop.
  */
 import { useEffect, useMemo, useRef } from "react";
 import { Platform } from "react-native";
 import { reportOptionalRequireError } from "./optionalRequire.js";
 import { appSyncAdapter } from "./sync/appSyncAdapter.js";
+import { useDeviceIdentity } from "./deviceIdentity.js";
 import { registerToolAdapters } from "@buoy-gg/shared-ui";
 
 /* eslint-disable @typescript-eslint/no-var-requires */
@@ -41,6 +44,7 @@ let zustandModule = null;
 let jotaiModule = null;
 let eventsModule = null;
 let consoleModule = null;
+let sentryModule = null;
 let envModule = null;
 let highlightUpdatesModule = null;
 let debugBordersModule = null;
@@ -106,6 +110,11 @@ try {
 } catch (e) {
   reportOptionalRequireError("@buoy-gg/console", e);
 }
+try {
+  sentryModule = require("@buoy-gg/sentry");
+} catch (e) {
+  reportOptionalRequireError("@buoy-gg/sentry", e);
+}
 try {
   envModule = require("@buoy-gg/env");
 } catch (e) {
@@ -171,13 +180,12 @@ function getAppName() {
   const constants = expoConstantsModule?.default ?? expoConstantsModule;
   return constants?.expoConfig?.name ?? constants?.manifest2?.extra?.expoClient?.name ?? null;
 }
-function defaultIdentity() {
-  const appName = getAppName();
-  const slug = (appName ?? "buoy").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-  return {
-    deviceName: `${appName ?? "Buoy Device"} (${Platform.OS})`,
-    deviceId: `${slug || "buoy"}-${Platform.OS}`
-  };
+
+/** expo-constants' `deviceName`: the simulator's name on a sim, the model on Android. */
+function getHardwareName() {
+  const constants = expoConstantsModule?.default ?? expoConstantsModule;
+  const name = constants?.deviceName;
+  return typeof name === "string" && name.length > 0 ? name : null;
 }
 /**
  * Build the `toolId -> sync adapter` map from whatever tool packages the app
@@ -241,12 +249,16 @@ export function AutoExternalSync({
     requiredEnvVars,
     customApps
   });
-  const identity = useMemo(defaultIdentity, []);
-  const deviceId = options?.deviceId ?? identity.deviceId;
+  const identity = useDeviceIdentity(options, {
+    appName: getAppName(),
+    hardwareName: getHardwareName(),
+    platform: Platform.OS
+  });
+  const deviceId = identity?.deviceId ?? null;
   const {
     socket
   } = useExternalSyncSocket({
-    deviceName: options?.deviceName ?? identity.deviceName,
+    deviceName: identity?.deviceName ?? "Buoy Device",
     // Older external-sync versions predate getDefaultSocketURL and require
     // an explicit URL — keep the literal fallback for them.
     socketURL: options?.socketURL ?? externalSyncModule.getDefaultSocketURL?.() ?? "http://localhost:42831",
@@ -335,6 +347,9 @@ function useToolAdapterMapInner(queryAdapter, requiredEnvVars, customApps) {
     if (consoleModule?.consoleSyncAdapter) {
       map.console = consoleModule.consoleSyncAdapter;
     }
+    if (sentryModule?.sentrySyncAdapter) {
+      map.sentry = sentryModule.sentrySyncAdapter;
+    }
     // Lazy: time-machine imports `@buoy-gg/core` (useToolHost), and this file
     // is loaded from core's index. Requiring it at module top-level is a
     // require cycle (LogBox on every reload). Waiting until first render
@@ -358,14 +373,14 @@ function useToolAdapterMapInner(queryAdapter, requiredEnvVars, customApps) {
       reportOptionalRequireError("@buoy-gg/scenarios", e);
     }
     // Lazy, same require-cycle reason as time-machine and scenarios: the
-    // copilot package imports `@buoy-gg/core` for the tool-host hooks.
+    // ask-buoy package imports `@buoy-gg/core` for the tool-host hooks.
     try {
-      const copilotModule = require("@buoy-gg/copilot");
-      if (copilotModule?.copilotSyncAdapter) {
-        map.copilot = copilotModule.copilotSyncAdapter;
+      const askBuoyModule = require("@buoy-gg/ask-buoy");
+      if (askBuoyModule?.askBuoySyncAdapter) {
+        map["ask-buoy"] = askBuoyModule.askBuoySyncAdapter;
       }
     } catch (e) {
-      reportOptionalRequireError("@buoy-gg/copilot", e);
+      reportOptionalRequireError("@buoy-gg/ask-buoy", e);
     }
     if (envModule?.createEnvSyncAdapter) {
       map.env = envModule.createEnvSyncAdapter(requiredEnvVars ?? []);

package/lib/module/floatingMenu/deviceIdentity.js

@@ -0,0 +1,163 @@
+"use strict";
+
+/**
+ * How a device introduces itself to the Buoy Desktop broker.
+ *
+ * The id used to be `<app-slug>-<platform>` — a BUILD identity, not a device
+ * identity. Every phone and simulator running the same app registered under
+ * the same id, and the broker (which deliberately lets one device hold
+ * several sockets for Fast Refresh) treated each newcomer as a reconnect and
+ * handed it the identity. Actions then landed on whichever device connected
+ * most recently, silently. See DEVICE_IDENTITY_COLLISION.md.
+ *
+ * Now the id carries a per-install tail minted once and persisted:
+ *
+ *   deviceId   = "<app-slug>-<platform>-<8 hex>"      e.g. acme-app-ios-3f9a2c1d
+ *   deviceName = "<App Name> (<hardware> · <last 4>)" e.g. Acme App (iPhone 17 Pro · 2c1d)
+ *
+ * The tail is what makes two devices on one build two devices. The name's
+ * hardware label comes from expo-constants' `deviceName` when available (the
+ * simulator's own name on a sim, "iPhone" on iOS 16+ hardware, the model on
+ * Android) and falls back to the platform; the 4-char tail is always on so
+ * two identical simulators never share a label.
+ *
+ * Persistence: native goes through shared's `persistentStorage` (file system
+ * → AsyncStorage → memory); web uses `sessionStorage` so every browser TAB
+ * is its own device — `localStorage` is shared across tabs and would collide
+ * exactly the way the old default did. The id does not survive a reinstall
+ * on purpose: it crosses an unauthenticated LAN socket, and deleting the app
+ * should reset it.
+ *
+ * An explicit `externalSync.deviceId` bypasses all of this; whoever pins an
+ * id owns its uniqueness.
+ */
+import { useEffect, useMemo, useState } from "react";
+import { Platform } from "react-native";
+import { devToolsStorageKeys, persistentStorage } from "@buoy-gg/shared-ui";
+
+/** Minimal getItem/setItem surface, so storage can be injected in tests. */
+
+export const INSTALL_ID_LENGTH = 8;
+
+/** 8 lowercase hex chars — short enough to read, random enough for a LAN. */
+export function generateInstallId() {
+  let out = "";
+  while (out.length < INSTALL_ID_LENGTH) {
+    out += (Math.random() * 16 | 0).toString(16);
+  }
+  return out;
+}
+function slugify(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+}
+/** Pure: turns the inputs into the id/name pair the broker sees. */
+export function buildDeviceIdentity({
+  appName,
+  hardwareName,
+  platform,
+  installId,
+  deviceId
+}) {
+  const slug = slugify(appName ?? "buoy") || "buoy";
+  const label = appName ?? "Buoy Device";
+  const hardware = hardwareName?.trim() || platform;
+  if (deviceId) {
+    // The app pinned its own id: it can also pin its own name, so keep the
+    // default name free of a tail that would refer to an id nobody sees.
+    return {
+      deviceId,
+      deviceName: `${label} (${hardware})`
+    };
+  }
+  const id = `${slug}-${platform}-${installId}`;
+  return {
+    deviceId: id,
+    deviceName: `${label} (${hardware} · ${installId.slice(-4)})`
+  };
+}
+
+// Web: every tab is a device, so the id lives in the tab's sessionStorage.
+function sessionStore() {
+  const g = globalThis;
+  try {
+    return g.sessionStorage ?? null;
+  } catch {
+    return null;
+  }
+}
+/**
+ * The persisted per-install tail: read it, or mint and store it on the first
+ * dial. Storage failures degrade to a fresh in-memory id rather than blocking
+ * the socket — a per-launch id still beats the old colliding one.
+ */
+export async function loadInstallId({
+  platform = Platform.OS,
+  store,
+  mint = generateInstallId
+} = {}) {
+  const key = devToolsStorageKeys.sync.deviceId();
+  const target = store === undefined ? platform === "web" ? sessionStore() : persistentStorage : store;
+  if (!target) return mint();
+  try {
+    const existing = await target.getItem(key);
+    if (existing && existing.length > 0) return existing;
+    const fresh = mint();
+    await target.setItem(key, fresh);
+    return fresh;
+  } catch {
+    return mint();
+  }
+}
+let installIdPromise = null;
+
+/**
+ * Process-wide memo so every mount (and every Fast Refresh of the component
+ * that calls it) shares one storage round-trip and one id.
+ */
+export function getInstallId() {
+  if (!installIdPromise) installIdPromise = loadInstallId();
+  return installIdPromise;
+}
+
+/** Tests only. */
+export function resetInstallIdForTests() {
+  installIdPromise = null;
+}
+/**
+ * The identity to dial with. Null until the per-install id is read from
+ * storage (one round-trip on first mount; memoized process-wide after) —
+ * both sync hooks no-op on a null id, so the socket simply dials a beat
+ * later. An explicit `deviceId` skips the read entirely; an explicit
+ * `deviceName` is used verbatim.
+ */
+export function useDeviceIdentity(options, env) {
+  const pinnedId = options?.deviceId;
+  const pinnedName = options?.deviceName;
+  const loadId = env.loadId ?? getInstallId;
+  const platform = env.platform ?? Platform.OS;
+  const [installId, setInstallId] = useState(null);
+  useEffect(() => {
+    if (pinnedId) return;
+    let cancelled = false;
+    loadId().then(id => {
+      if (!cancelled) setInstallId(id);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [pinnedId, loadId]);
+  return useMemo(() => {
+    if (!pinnedId && !installId) return null;
+    const identity = buildDeviceIdentity({
+      appName: env.appName,
+      hardwareName: env.hardwareName,
+      platform,
+      installId: installId ?? "",
+      deviceId: pinnedId
+    });
+    return pinnedName ? {
+      ...identity,
+      deviceName: pinnedName
+    } : identity;
+  }, [pinnedId, pinnedName, installId, env.appName, env.hardwareName, platform]);
+}

package/lib/module/floatingMenu/dial/DialDevTools.js

@@ -6,7 +6,6 @@ import { absoluteFill } from "@buoy-gg/shared-ui";
 // Icons are provided by installedApps; no direct icon imports here.
 import { DialIcon } from "./DialIcon.js";
 import { DialHyperspace } from "./DialHyperspace.js";
-import { ALL_TOOLS_REGISTRY } from "../allToolsRegistry.js";
 import { DialPagination } from "./DialPagination.js";
 import { getRankedToolIds, isDialUsageLoaded, loadDialUsage, recordToolUsage } from "./dialUsageStore.js";
 import { persistentStorage, useHintsDisabled, devToolsStorageKeys, buoyColors, ToolBackground, useToolBackground } from "@buoy-gg/shared-ui";
@@ -15,7 +14,7 @@ import { useProAccess } from "@buoy-gg/license";
 import { renderAppIcon } from "../AppIcon.js";
 import { useAppHost } from "../AppHost";
 import { OnboardingTooltip } from "./OnboardingTooltip";
-import { getDialLayout, MAX_DIAL_SLOTS, DIAL_BUTTON_SIZE, DIAL_ICON_GLYPH_SIZE, dialAnimationConfig, dialColors } from "@buoy-gg/floating-tools-core";
+import { getDialLayout, MAX_DIAL_SLOTS, DIAL_BUTTON_SIZE, dialAnimationConfig, dialColors } from "@buoy-gg/floating-tools-core";
 
 // The circle size depends on the live window width, so it's computed inside
 // the component via useWindowDimensions — a module-scope Dimensions.get
@@ -258,38 +257,6 @@ export const DialDevTools = ({
     return map;
   }, [dialApps, actions, open, onClose]);
 
-  // Tools from the global registry that are NOT installed in this app.
-  // These are appended after all available tools so paging "next" eventually
-  // reveals them. They are display-only (real icon + real name + "Unavailable").
-  const unavailableTools = useMemo(() => {
-    const installedIds = new Set(dialApps.map(a => a.id));
-    return ALL_TOOLS_REGISTRY.filter(t => !installedIds.has(t.id));
-  }, [dialApps]);
-
-  // Build stable IconType entries for each unavailable tool.
-  const unavailableIconsById = useMemo(() => {
-    const map = new Map();
-    for (const tool of unavailableTools) {
-      map.set(tool.id, {
-        id: tool.id,
-        name: tool.name,
-        // Pre-render the icon at the standard GLYPH size (not the slot size —
-        // the slot also holds the label + "Unavailable" caption, so a glyph
-        // rendered at DIAL_ICON_SIZE overflows the slot and looks ~2x bigger
-        // than installed tools' icons).
-        icon: tool.renderIcon(DIAL_ICON_GLYPH_SIZE),
-        iconComponent: undefined,
-        color: tool.color,
-        unavailable: true,
-        // Tapping an unavailable tool is intentionally a no-op: the dial stays
-        // open and no modal launches, signalling the tool is not installed.
-        // Future: add a brief Toast with an install link here.
-        onPress: () => {}
-      });
-    }
-    return map;
-  }, [unavailableTools]);
-
   // Snapshot the usage-ranked order when the dial opens. It stays stable while
   // open so icons don't jump positions mid-interaction.
   const [rankedIds, setRankedIds] = useState(() => getRankedToolIds(dialApps.map(a => a.id)));
@@ -309,8 +276,9 @@ export const DialDevTools = ({
     };
   }, [dialApps]);
 
-  // Page count spans available tools (usage-ranked) + unavailable tools (appended).
-  const pageCount = Math.max(1, Math.ceil((rankedIds.length + unavailableTools.length) / MAX_DIAL_SLOTS));
+  // Page count spans the installed tools (usage-ranked). Only tools the app
+  // actually has appear in the dial — nothing is shown for uninstalled ones.
+  const pageCount = Math.max(1, Math.ceil(rankedIds.length / MAX_DIAL_SLOTS));
   const [currentPage, setCurrentPage] = useState(0);
   const safePage = Math.min(currentPage, pageCount - 1);
 
@@ -318,18 +286,13 @@ export const DialDevTools = ({
   // snapshotted on open, so each icon's page and slot are fixed for the
   // session — which lets us mount all icons once and paginate purely by
   // toggling visibility (no remounts on page change).
-  //
-  // Order: usage-ranked available tools first, unavailable tools appended at
-  // the very end. This guarantees unavailable items always appear on the last
-  // pages and never displace available tools.
   const allDialIcons = useMemo(() => {
-    const allIds = [...rankedIds, ...unavailableTools.map(t => t.id)];
-    return allIds.map(id => iconsById.get(id) ?? unavailableIconsById.get(id)).filter(icon => Boolean(icon)).map((icon, i) => ({
+    return rankedIds.map(id => iconsById.get(id)).filter(icon => Boolean(icon)).map((icon, i) => ({
       icon,
       page: Math.floor(i / MAX_DIAL_SLOTS),
       slot: i % MAX_DIAL_SLOTS
     }));
-  }, [rankedIds, iconsById, unavailableTools, unavailableIconsById]);
+  }, [rankedIds, iconsById]);
 
   // Empty slot indices for the current page (only the last page can be
   // partial). These are cheap placeholder dots.
@@ -532,10 +495,6 @@ export const DialDevTools = ({
     });
   };
   const handleIconPress = icon => {
-    // Unavailable tools are display-only. Return early so the dial stays open
-    // and no modal or animation is triggered. The dimmed appearance already
-    // communicates that the tool is not installed.
-    if (icon.unavailable) return;
     setSelectedIcon(1);
     const interaction = dialAnimationConfig?.interaction ?? {
       iconSelect: {

package/lib/module/floatingMenu/dial/DialIcon.js

@@ -183,35 +183,6 @@ export const DialIcon = ({
       children: /*#__PURE__*/_jsx(View, {
         style: styles.emptyDot
       })
-    }) : icon.unavailable ?
-    /*#__PURE__*/
-    // ── Unavailable tool ──────────────────────────────────────────────────
-    // Renders the real icon + real name at NORMAL styling (visually identical
-    // to an installed tool). The ONLY signal that it's unavailable is the small
-    // muted "Unavailable" caption under the name. It's non-interactive: no
-    // Pressable, and the dial stays open when tapped because
-    // DialDevTools.handleIconPress returns early for unavailable icons.
-    _jsxs(View, {
-      style: styles.pressable,
-      children: [/*#__PURE__*/_jsx(View, {
-        style: styles.iconWrapper,
-        children: /*#__PURE__*/_jsx(View, {
-          style: styles.iconClamp,
-          children: icon.icon
-        })
-      }), /*#__PURE__*/_jsx(Text, {
-        style: styles.label,
-        numberOfLines: 1,
-        adjustsFontSizeToFit: true,
-        minimumFontScale: 0.7,
-        children: icon.name.toUpperCase()
-      }), /*#__PURE__*/_jsx(Text, {
-        style: styles.unavailableCaption,
-        numberOfLines: 1,
-        adjustsFontSizeToFit: true,
-        minimumFontScale: 0.6,
-        children: "Unavailable"
-      })]
     }) : /*#__PURE__*/_jsxs(Pressable, {
       onPress: () => onPress(icon),
       onPressIn: handlePressIn,
@@ -289,8 +260,8 @@ const styles = StyleSheet.create({
   },
   /**
    * Hard clamp for PRE-RENDERED icon nodes (icon.icon) — the path where the
-   * glyph's size is baked in by whoever created the node (unavailable-tool
-   * registry entries, consumer custom tools) rather than controlled here. The
+   * glyph's size is baked in by whoever created the node (consumer custom
+   * tools) rather than controlled here. The
    * fixed overflow-hidden box guarantees an oversized node can never blow past
    * its slot and dwarf neighboring icons — worst case it center-crops. The
    * iconComponent path stays unclipped: we render it at DIAL_ICON_GLYPH_SIZE
@@ -324,20 +295,5 @@ const styles = StyleSheet.create({
     backgroundColor: dialColors.emptyDotBackground,
     borderWidth: dialStyles.emptySlot.borderWidth,
     borderColor: dialColors.emptyDotBorder
-  },
-  // ── Unavailable tool styles ────────────────────────────────────────────────
-  /**
-   * Small muted caption shown under the (normal-styled) tool name — the only
-   * signal that the tool is not installed. Kept compact (smaller than the label)
-   * so the extra line doesn't disturb the arc layout. Uses the shared muted
-   * theme token rather than a hardcoded color.
-   */
-  unavailableCaption: {
-    fontSize: dialStyles.icon.label.fontSize - 1,
-    fontWeight: dialStyles.icon.label.fontWeight,
-    letterSpacing: dialStyles.icon.label.letterSpacing,
-    fontFamily: dialStyles.icon.label.fontFamily,
-    color: dialColors.iconLabelMuted,
-    textTransform: "uppercase"
   }
 });

package/lib/module/version.js

@@ -11,4 +11,4 @@
  * 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 const SDK_VERSION = "7.0.32";
+export const SDK_VERSION = "7.0.34";

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

@@ -39,6 +39,25 @@ export interface StorageKeyConfig {
     description?: string;
     storageType: "async" | "secure" | "mmkv";
 }
+/**
+ * Ask Buoy's config, mirrored structurally so core never depends on the
+ * optional `@buoy-gg/ask-buoy` package (it is required lazily, like every other
+ * tool). The object is handed to `createAskBuoyTool` untouched, so any field
+ * that package accepts passes through — the index signature is the seam.
+ */
+export interface FloatingAskBuoyConfig {
+    /** Your company's own LLM gateway. Buoy never proxies or holds a key. */
+    endpoint: string;
+    /** Model id passed through to the endpoint. */
+    model: string;
+    /** Which request/response shape the endpoint speaks. @default "anthropic" */
+    protocol?: "anthropic" | "openai";
+    /** Resolved fresh per request — the app's own short-lived session token. */
+    headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** DEV ONLY — compiled into the bundle in plaintext. Use `headers` + a gateway. */
+    apiKey?: string;
+    [key: string]: unknown;
+}
 /**
  * Props for FloatingDevTools component.
  *
@@ -101,6 +120,24 @@ export interface FloatingDevToolsProps extends Omit<FloatingMenuProps, "apps"> {
      * ```
      */
     requiredStorageKeys?: StorageKeyConfig[];
+    /**
+     * Wire Ask Buoy (the in-app AI chat) to your team's AI endpoint — the
+     * documented one-prop setup. Requires `@buoy-gg/ask-buoy` to be installed;
+     * the config is exactly what `createAskBuoyTool` takes and passes through
+     * untouched.
+     *
+     * @example
+     * ```tsx
+     * <FloatingDevTools
+     *   askBuoy={{
+     *     endpoint: "https://ai.acme.com/v1/messages",
+     *     model: "claude-sonnet-4-5",
+     *     headers: async () => ({ Authorization: `Bearer ${await auth.getToken()}` }),
+     *   }}
+     * />
+     * ```
+     */
+    askBuoy?: FloatingAskBuoyConfig;
     /**
      * Optional children to render within the DevToolsVisibilityProvider context.
      * Useful for tools that need to react to DevTools visibility (like DebugBordersStandaloneOverlay).
@@ -331,5 +368,5 @@ export interface FloatingDevToolsProps extends Omit<FloatingMenuProps, "apps"> {
  *
  * @param props - FloatingDevTools props
  */
-export declare const FloatingDevTools: ({ apps, requiredEnvVars, requiredStorageKeys, children, disableHints, defaultFloatingTools, defaultDialTools, requireLicense, licenseKey: licenseKeyProp, zustandStores, environment, externalSync, headless, ...props }: FloatingDevToolsProps) => React.JSX.Element | null;
+export declare const FloatingDevTools: ({ apps, requiredEnvVars, requiredStorageKeys, askBuoy, children, disableHints, defaultFloatingTools, defaultDialTools, requireLicense, licenseKey: licenseKeyProp, zustandStores, environment, externalSync, headless, ...props }: FloatingDevToolsProps) => React.JSX.Element | null;
 //# sourceMappingURL=FloatingDevTools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FloatingDevTools.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/FloatingDevTools.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+D,MAAM,OAAO,CAAC;AAGpF,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAOtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAQ5C,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EAEvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,GACP,KAAK,CAAC;IACV,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAC5E;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IAEtB;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IAEjC;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEzC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAAC,EAAE,qBAAqB,CAAC;IAE7C;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IAErC;;;;;;;;;;;;;;;;OAgBG;IACH,qBAAqB,CAAC,EAAE,OAAO,oBAAoB,EAAE,WAAW,EAAE,CAAC;IAEnE;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,oBAAoB,EAAE,WAAW,KAAK,IAAI,CAAC;IAEtF;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAE7C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,eAAO,MAAM,gBAAgB,GAAI,0NAe9B,qBAAqB,6BAybvB,CAAC"}
+{"version":3,"file":"FloatingDevTools.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/FloatingDevTools.tsx"],"names":[],"mappings":"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"}

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

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

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

@@ -12,9 +12,19 @@ export interface ExternalSyncOptions {
      * broker on another machine.
      */
     socketURL?: string;
-    /** Shown in the desktop device list. @default "<app name> (<platform>)" */
+    /**
+     * Shown in the desktop device list.
+     * @default "<app name> (<hardware> · <last 4 of the id>)"
+     */
     deviceName?: string;
-    /** Stable device identity across restarts. @default "<app-slug>-<platform>" */
+    /**
+     * Stable device identity across restarts. Leave unset: the default is
+     * `<app-slug>-<platform>-<per-install id>`, minted once and persisted, so
+     * every device running this build is its own entry in Buoy Desktop and
+     * `list_devices`. If you do pin one, it MUST be unique per device — two
+     * devices sharing an id look like one device to the broker, and actions
+     * land on whichever connected last.
+     */
     deviceId?: string;
     /**
      * Allow this build to dial the broker when `__DEV__` is false (a release /

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

@@ -1 +1 @@
-{"version":3,"file":"autoExternalSync.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/autoExternalSync.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAsJjD,iFAAiF;AACjF,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAuBD,UAAU,qBAAqB;IAC7B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IACjC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,eAAe,EACf,UAAU,GACX,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,eAAe,EACf,UAAU,GACX,EAAE,mBAAmB,QAYrB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,eAAe,EACf,KAAK,EACL,IAAI,EACJ,UAAU,EACV,UAAU,GACX,EAAE,qBAAqB,QAuDvB"}
+{"version":3,"file":"autoExternalSync.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/autoExternalSync.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AA6JjD,iFAAiF;AACjF,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAkBD,UAAU,qBAAqB;IAC7B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IACjC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,YAAY,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,eAAe,EACf,UAAU,GACX,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAS/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,eAAe,EACf,UAAU,GACX,EAAE,mBAAmB,QAYrB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,eAAe,EACf,KAAK,EACL,IAAI,EACJ,UAAU,EACV,UAAU,GACX,EAAE,qBAAqB,QA2DvB"}

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' | 'copilot' | 'image-overlay' | 'perf-monitor' | 'perf-monitor-modal';
+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';
 /**
  * Special floating-only tool IDs that only appear in the floating bubble row.
  */

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

@@ -1 +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,OAAO,GACP,SAAS,GACT,OAAO,GACP,QAAQ,GACR,cAAc,GACd,WAAW,GACX,SAAS,GACT,eAAe,GACf,cAAc,GACd,oBAAoB,CAAC;AAEzB;;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;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAW9E;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,CAcjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,UAAU,CAazD;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"}
+{"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,OAAO,GACP,SAAS,GACT,OAAO,GACP,QAAQ,GACR,cAAc,GACd,WAAW,GACX,UAAU,GACV,eAAe,GACf,cAAc,GACd,oBAAoB,CAAC;AAEzB;;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;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAW9E;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,CAcjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,UAAU,CAazD;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/deviceIdentity.d.ts

@@ -0,0 +1,66 @@
+export interface DeviceIdentity {
+    deviceName: string;
+    deviceId: string;
+}
+/** Minimal getItem/setItem surface, so storage can be injected in tests. */
+export interface IdentityStore {
+    getItem(key: string): Promise<string | null> | string | null;
+    setItem(key: string, value: string): Promise<void> | void;
+}
+export declare const INSTALL_ID_LENGTH = 8;
+/** 8 lowercase hex chars — short enough to read, random enough for a LAN. */
+export declare function generateInstallId(): string;
+export interface BuildIdentityInput {
+    /** Expo config name; null for bare RN. */
+    appName: string | null;
+    /** expo-constants `deviceName`; null when unavailable. */
+    hardwareName?: string | null;
+    platform: string;
+    /** The persisted per-install tail. */
+    installId: string;
+    /** An explicit `externalSync.deviceId` — used verbatim, no tail in the name. */
+    deviceId?: string;
+}
+/** Pure: turns the inputs into the id/name pair the broker sees. */
+export declare function buildDeviceIdentity({ appName, hardwareName, platform, installId, deviceId, }: BuildIdentityInput): DeviceIdentity;
+export interface LoadInstallIdOptions {
+    platform?: string;
+    /** Storage override (tests). Defaults to sessionStorage on web, persistentStorage elsewhere. */
+    store?: IdentityStore | null;
+    mint?: () => string;
+}
+/**
+ * The persisted per-install tail: read it, or mint and store it on the first
+ * dial. Storage failures degrade to a fresh in-memory id rather than blocking
+ * the socket — a per-launch id still beats the old colliding one.
+ */
+export declare function loadInstallId({ platform, store, mint, }?: LoadInstallIdOptions): Promise<string>;
+/**
+ * Process-wide memo so every mount (and every Fast Refresh of the component
+ * that calls it) shares one storage round-trip and one id.
+ */
+export declare function getInstallId(): Promise<string>;
+/** Tests only. */
+export declare function resetInstallIdForTests(): void;
+export interface DeviceIdentityOptions {
+    deviceId?: string;
+    deviceName?: string;
+}
+export interface DeviceIdentityEnvironment {
+    /** Expo config name; null for bare RN. */
+    appName: string | null;
+    /** expo-constants `deviceName`; null when unavailable. */
+    hardwareName: string | null;
+    platform?: string;
+    /** The install-id loader (tests inject one; production uses the memo). */
+    loadId?: () => Promise<string>;
+}
+/**
+ * The identity to dial with. Null until the per-install id is read from
+ * storage (one round-trip on first mount; memoized process-wide after) —
+ * both sync hooks no-op on a null id, so the socket simply dials a beat
+ * later. An explicit `deviceId` skips the read entirely; an explicit
+ * `deviceName` is used verbatim.
+ */
+export declare function useDeviceIdentity(options: DeviceIdentityOptions | undefined, env: DeviceIdentityEnvironment): DeviceIdentity | null;
+//# sourceMappingURL=deviceIdentity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deviceIdentity.d.ts","sourceRoot":"","sources":["../../../../src/floatingMenu/deviceIdentity.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3D;AAED,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,6EAA6E;AAC7E,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AASD,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,EAAE,kBAAkB,GAAG,cAAc,CAcrC;AAYD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,EAClC,QAAsB,EACtB,KAAK,EACL,IAAwB,GACzB,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB7C;AAID;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAG9C;AAED,kBAAkB;AAClB,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAC1C,GAAG,EAAE,yBAAyB,GAC7B,cAAc,GAAG,IAAI,CA4BvB"}