@buoy-gg/shared-ui 7.0.32 → 7.0.34

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

@@ -0,0 +1,110 @@
+"use strict";
+
+/**
+ * Pill — the small caption chip every tool draws next to a row: a verdict
+ * ("UNUSED", "OVERSIZE"), a kind ("event", "transaction"), a link ("↔ 2"),
+ * a source ("MMKV"). Sixteen packages defined 150+ local pill styles that
+ * fall into five looks; those are the `variant`s here. Text is always in
+ * the pill's color (or the muted ink for `quiet`), never the series color
+ * of anything else.
+ *
+ * - `tinted`  — color fill at 15% + border at 40%   (scenarios, react-query chips)
+ * - `soft`    — color fill at 20%, rounded, no border (events correlation badge)
+ * - `outline` — color border only                   (sentry envelope types)
+ * - `quiet`   — neutral 6% white fill, muted text, optional color dot (assets)
+ * - `text`    — bare colored caption, no chrome       (images row badges)
+ */
+
+import { StyleSheet, Text, View } from "react-native";
+import { night } from "../night/nightTheme.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function Pill({
+  label,
+  color = night.color.textSecondary,
+  variant = "tinted",
+  size = "xs",
+  mono = false,
+  uppercase,
+  dot = false,
+  icon,
+  testID,
+  style
+}) {
+  const upper = uppercase ?? (variant === "tinted" || variant === "quiet" || variant === "text");
+  const textColor = variant === "quiet" ? night.color.textSecondary : color;
+  const chrome = variant === "tinted" ? {
+    backgroundColor: `${color}15`,
+    borderColor: `${color}40`,
+    borderWidth: 1
+  } : variant === "soft" ? {
+    backgroundColor: `${color}20`
+  } : variant === "outline" ? {
+    borderColor: color,
+    borderWidth: 1
+  } : variant === "quiet" ? {
+    backgroundColor: "rgba(255,255,255,0.06)"
+  } : {};
+  if (variant === "text") {
+    return /*#__PURE__*/_jsx(Text, {
+      style: [styles.text, size === "sm" && styles.textSm, mono && styles.mono, upper && styles.upper, {
+        color: textColor
+      }],
+      testID: testID,
+      children: label
+    });
+  }
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.pill, variant === "soft" && styles.pillSoft, size === "sm" && styles.pillSm, chrome, style],
+    children: [icon, dot && variant === "quiet" ? /*#__PURE__*/_jsx(View, {
+      style: [styles.dot, {
+        backgroundColor: color
+      }]
+    }) : null, /*#__PURE__*/_jsx(Text, {
+      style: [styles.text, size === "sm" && styles.textSm, mono && styles.mono, upper && styles.upper, {
+        color: textColor
+      }],
+      testID: testID,
+      children: label
+    })]
+  });
+}
+const styles = StyleSheet.create({
+  pill: {
+    flexDirection: "row",
+    alignItems: "center",
+    alignSelf: "flex-start",
+    gap: 4,
+    paddingHorizontal: 6,
+    paddingVertical: 2,
+    borderRadius: 4
+  },
+  pillSoft: {
+    paddingHorizontal: 8,
+    borderRadius: 10
+  },
+  pillSm: {
+    paddingHorizontal: 8,
+    paddingVertical: 3
+  },
+  dot: {
+    width: 5,
+    height: 5,
+    borderRadius: 2.5
+  },
+  text: {
+    fontSize: 10,
+    fontWeight: "600",
+    letterSpacing: 0.3
+  },
+  textSm: {
+    fontSize: 11
+  },
+  mono: {
+    fontFamily: "monospace"
+  },
+  upper: {
+    textTransform: "uppercase",
+    letterSpacing: 0.5,
+    fontWeight: "700"
+  }
+});

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

@@ -0,0 +1,112 @@
+"use strict";
+
+/**
+ * ToggleRow — a labeled switch row for a tool's settings surface.
+ *
+ * Every settings screen (impersonate, image-overlay, highlight-updates,
+ * perf-monitor, scenarios, storage, ask-buoy) drew its own `toggleRow` +
+ * `<Switch>` pair with the same night track colors. The native switch stays
+ * (a custom control would be a visible design change); the row chrome,
+ * the label/description stack and the accent/warning tone are shared.
+ *
+ * - `variant="card"`  — an elevated bordered pill row (image-overlay)
+ * - `variant="plain"` — a bare list row for use inside a card (impersonate)
+ */
+
+import { StyleSheet, Switch, Text, View } from "react-native";
+import { night } from "../night/nightTheme.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function ToggleRow({
+  label,
+  description,
+  value,
+  onValueChange,
+  disabled = false,
+  tone = "accent",
+  accessory,
+  variant = "card",
+  emphasizeLabel = false,
+  testID,
+  style
+}) {
+  const onColor = tone === "warning" ? night.color.warning : night.color.accent;
+  const isCard = variant === "card";
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.row, isCard ? styles.rowCard : styles.rowPlain, style],
+    children: [/*#__PURE__*/_jsxs(View, {
+      style: styles.info,
+      children: [/*#__PURE__*/_jsxs(View, {
+        style: styles.header,
+        children: [/*#__PURE__*/_jsx(Text, {
+          style: [isCard ? styles.labelCard : styles.labelPlain, emphasizeLabel && {
+            color: onColor
+          }],
+          numberOfLines: 2,
+          children: label
+        }), accessory]
+      }), description ? /*#__PURE__*/_jsx(Text, {
+        style: styles.description,
+        children: description
+      }) : null]
+    }), /*#__PURE__*/_jsx(Switch, {
+      value: value,
+      onValueChange: onValueChange,
+      disabled: disabled,
+      testID: testID,
+      accessibilityLabel: label,
+      trackColor: isCard ? {
+        false: night.color.surfaceElevated,
+        true: onColor
+      } : {
+        false: night.color.border,
+        true: `${onColor}50`
+      },
+      thumbColor: isCard ? undefined : value ? onColor : night.color.knob
+    })]
+  });
+}
+const styles = StyleSheet.create({
+  row: {
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "space-between"
+  },
+  rowCard: {
+    backgroundColor: night.color.surfaceElevated,
+    borderRadius: 8,
+    borderWidth: 1,
+    borderColor: night.color.border,
+    paddingHorizontal: 12,
+    paddingVertical: 8
+  },
+  rowPlain: {
+    paddingVertical: 12,
+    paddingHorizontal: 12
+  },
+  info: {
+    flex: 1,
+    marginRight: 12
+  },
+  header: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 8,
+    flexWrap: "wrap"
+  },
+  labelCard: {
+    fontSize: 13,
+    fontWeight: "500",
+    color: night.color.textSecondary
+  },
+  labelPlain: {
+    fontSize: 14,
+    fontWeight: "500",
+    color: night.color.text
+  },
+  description: {
+    fontSize: 12,
+    color: night.color.textTertiary,
+    lineHeight: 16,
+    marginTop: 3
+  }
+});

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

@@ -0,0 +1,149 @@
+"use strict";
+
+/**
+ * The one "nothing here" panel, for every tool that shows a list.
+ *
+ * WHY THIS EXISTS
+ *
+ * Every capture tool — network, events, highlight-updates, storage, zustand,
+ * redux, jotai, console — renders the same panel with the same four causes and
+ * different nouns. Written out per tool, that produced four copies of the same
+ * layout (each of which had to be re-inset by hand the first time a sentence
+ * was longer than "No events yet"), and four independent guesses at the
+ * PRECEDENCE between those causes. The guesses disagreed, and the disagreements
+ * were bugs:
+ *
+ *   - A search that matched nothing showed "Enable tracking to start
+ *     capturing" — pointing at a toggle that was already on.
+ *   - Turning every source chip off showed "Events will appear here as they
+ *     occur" — inviting you to go generate events that were already in the
+ *     store, behind your own filter.
+ *   - Typing into a search box while the store was empty produced no
+ *     acknowledgement of the query at all, which reads as a dead search box.
+ *
+ * So the precedence lives here, once, and each tool supplies only what is
+ * genuinely its own: the noun, and what "switched on but waiting" looks like
+ * for it (network fishes, events listens, the highlighter stares).
+ *
+ * SPLIT IN TWO ON PURPOSE
+ *
+ * `resolveListEmptyState` is a pure function returning `{ otto, title,
+ * message }`, and `ToolEmptyState` renders that object. Tools with a cause
+ * nobody else has — storage's "no issues found" (which is a PASS, not a
+ * failure), zustand's unregistered store — resolve the common cases and
+ * substitute their own, or skip the resolver and hand the shell a literal.
+ * Adding a mascot to every tool at once is then one edit in this file, which is
+ * also what makes the Flutter and Swift ports one component to mirror instead
+ * of eight.
+ */
+
+import { StyleSheet, Text, View } from "react-native";
+import { Otto } from "../otto/index.js";
+import { night } from "../night/nightTheme.js";
+
+/** What a "nothing here" panel says. */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The panel itself: Otto, a heading, a sentence. Nothing else — this only ever
+ * renders where the alternative is a blank body, so it has no actions and no
+ * decoration to compete with the list it stands in for.
+ */
+export function ToolEmptyState({
+  otto,
+  title,
+  message,
+  testID,
+  style
+}) {
+  return /*#__PURE__*/_jsxs(View, {
+    style: [styles.container, style],
+    testID: testID,
+    children: [/*#__PURE__*/_jsx(Otto, {
+      state: otto,
+      pixelSize: 2
+    }), /*#__PURE__*/_jsx(Text, {
+      style: styles.title,
+      testID: testID ? `${testID}-title` : undefined,
+      numberOfLines: 2,
+      children: title
+    }), /*#__PURE__*/_jsx(Text, {
+      style: styles.message,
+      testID: testID ? `${testID}-text` : undefined,
+      children: message
+    })]
+  });
+}
+/**
+ * Which "nothing here" this is, in the order the facts answer the question.
+ *
+ * A typed query first (see `search`), then the user's filters, then the
+ * capture switch, then the honest "nothing yet".
+ */
+export function resolveListEmptyState(facts) {
+  const {
+    subject,
+    verb = "captured",
+    search,
+    total = 0,
+    capturing,
+    waiting,
+    paused,
+    blocked
+  } = facts;
+  const term = (search ?? "").trim();
+  if (term) {
+    return {
+      otto: "sad",
+      // The query goes in the HEADING because checking what you typed is the
+      // first thing you do; the body names whichever blocker is in the way.
+      title: `No results for “${term}”`,
+      message: blocked ?? (total > 0 ? `None of the ${total} ${verb} ${subject} match. Clear the search to see them.` : capturing === false ? `Nothing is ${verb} to search — capture is off. Turn it on to start.` : `Nothing has been ${verb} yet, so there is nothing to match.`)
+    };
+  }
+  if (blocked) {
+    return {
+      otto: "filtering",
+      title: "Filtered Out",
+      message: blocked
+    };
+  }
+  if (total > 0) {
+    return {
+      otto: "filtering",
+      title: "Filtered Out",
+      message: `${total} ${verb} ${subject} ${total === 1 ? "is" : "are"} hidden by the active filters.`
+    };
+  }
+  if (capturing === false) {
+    return {
+      otto: paused?.otto ?? "paused",
+      title: paused?.title ?? "Not capturing",
+      message: paused?.message ?? "Capture is off. Turn it on to start."
+    };
+  }
+  return waiting;
+}
+const styles = StyleSheet.create({
+  container: {
+    alignItems: "center",
+    paddingVertical: 40,
+    // The generated sentences are full sentences. Every tool that hand-rolled
+    // this panel shipped without an inset and had it run to both edges of the
+    // sheet the first time the copy grew past a few words.
+    paddingHorizontal: 24
+  },
+  title: {
+    color: night.color.text,
+    fontSize: 14,
+    fontWeight: "600",
+    marginTop: 12,
+    marginBottom: 6,
+    textAlign: "center"
+  },
+  message: {
+    color: night.color.textTertiary,
+    fontSize: 12,
+    textAlign: "center",
+    lineHeight: 17
+  }
+});

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

@@ -0,0 +1,196 @@
+"use strict";
+
+/**
+ * ToolFooter — the night glass bar pinned to the bottom of a tool: dark
+ * backing over the star field, a hairline on top, safe-area padding when
+ * docked as a sheet, rounded corners when floating.
+ *
+ * `EventStepperFooter` draws this bar for the Previous/Next case; the
+ * images and react-query tools each re-drew it for their action bars with
+ * a comment saying "matches EventStepperFooter". This is that bar as a
+ * container, plus `FooterButton` — the mono uppercase plate button those
+ * action bars are made of — and the caption/message lines above the row.
+ */
+
+import { StyleSheet, Text, TouchableOpacity, View } from "react-native";
+import { night } from "../night/nightTheme.js";
+import { useSafeAreaInsets } from "../../hooks/useSafeAreaInsets.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function ToolFooter({
+  children,
+  safeArea = true,
+  paddingBottom = 12,
+  floating = false,
+  absolute = false,
+  gap = 8,
+  style,
+  testID
+}) {
+  const insets = useSafeAreaInsets();
+  const bottom = typeof safeArea === "number" ? safeArea + insets.bottom : safeArea ? paddingBottom + insets.bottom : paddingBottom;
+  return /*#__PURE__*/_jsx(View, {
+    style: [styles.footer, floating && styles.footerFloating, absolute && styles.footerAbsolute, {
+      paddingBottom: bottom,
+      gap
+    }, style],
+    testID: testID,
+    children: children
+  });
+}
+
+/** A row of footer buttons. */
+export function FooterRow({
+  children,
+  style
+}) {
+  return /*#__PURE__*/_jsx(View, {
+    style: [styles.row, style],
+    children: children
+  });
+}
+
+/** Tracking caption above a row ("MASS ACTIONS — every image on screen"). */
+export function FooterCaption({
+  children,
+  style
+}) {
+  return /*#__PURE__*/_jsx(Text, {
+    style: [styles.caption, style],
+    numberOfLines: 1,
+    children: children
+  });
+}
+
+/** Mono feedback line ("Restored 3 images"). */
+export function FooterMessage({
+  children,
+  tone = "info",
+  style
+}) {
+  return /*#__PURE__*/_jsx(Text, {
+    style: [styles.message, tone === "muted" && styles.messageMuted, style],
+    numberOfLines: 1,
+    children: children
+  });
+}
+export function FooterButton({
+  label,
+  onPress,
+  accent = false,
+  active = false,
+  disabled = false,
+  icon,
+  flex = true,
+  size = "sm",
+  testID,
+  accessibilityLabel,
+  style
+}) {
+  return /*#__PURE__*/_jsxs(TouchableOpacity, {
+    onPress: onPress,
+    disabled: disabled,
+    activeOpacity: 0.7,
+    accessibilityRole: "button",
+    accessibilityLabel: accessibilityLabel ?? label,
+    accessibilityState: {
+      disabled,
+      selected: active
+    },
+    testID: testID,
+    style: [styles.button, flex ? styles.buttonFlex : styles.buttonFixed, size === "md" && styles.buttonMd, active && styles.buttonActive, disabled && styles.disabled, style],
+    children: [icon, /*#__PURE__*/_jsx(Text, {
+      style: [styles.buttonText, size === "md" && styles.buttonTextMd, accent && !disabled && styles.buttonTextAccent, active && styles.buttonTextActive, disabled && styles.buttonTextDisabled],
+      children: label
+    })]
+  });
+}
+const styles = StyleSheet.create({
+  footer: {
+    paddingHorizontal: 12,
+    paddingTop: 10,
+    // Dark glass over the star field — the same bar EventStepperFooter draws.
+    backgroundColor: "rgba(5, 5, 5, 0.92)",
+    borderTopWidth: 1,
+    borderTopColor: night.color.border
+  },
+  footerFloating: {
+    borderBottomLeftRadius: 14,
+    borderBottomRightRadius: 14
+  },
+  footerAbsolute: {
+    position: "absolute",
+    left: 0,
+    right: 0,
+    bottom: 0
+  },
+  row: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 6
+  },
+  caption: {
+    color: night.color.textTertiary,
+    fontSize: 9,
+    fontWeight: "700",
+    letterSpacing: 0.8
+  },
+  message: {
+    color: night.color.info,
+    fontSize: 10,
+    fontFamily: "monospace"
+  },
+  messageMuted: {
+    color: night.color.textTertiary,
+    fontFamily: undefined
+  },
+  button: {
+    flexDirection: "row",
+    alignItems: "center",
+    justifyContent: "center",
+    gap: 6,
+    paddingVertical: 8,
+    // No horizontal padding: six of these share one row on a phone, and the
+    // mono uppercase label needs every point it can get before it wraps.
+    paddingHorizontal: 0,
+    borderRadius: 6,
+    backgroundColor: night.color.button,
+    borderWidth: StyleSheet.hairlineWidth,
+    borderColor: night.color.border
+  },
+  buttonFlex: {
+    flex: 1
+  },
+  buttonFixed: {
+    paddingHorizontal: 10
+  },
+  buttonMd: {
+    paddingVertical: 8
+  },
+  buttonActive: {
+    backgroundColor: night.color.accentSoft,
+    borderColor: night.color.accentBorderStrong
+  },
+  buttonText: {
+    fontSize: 10,
+    fontWeight: "600",
+    color: night.color.textSecondary,
+    fontFamily: "monospace",
+    textTransform: "uppercase"
+  },
+  buttonTextMd: {
+    fontSize: 11,
+    color: night.color.text
+  },
+  buttonTextAccent: {
+    color: night.color.warning
+  },
+  buttonTextActive: {
+    color: night.color.accent
+  },
+  buttonTextDisabled: {
+    color: night.color.textTertiary
+  },
+  disabled: {
+    opacity: 0.4
+  }
+});

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

@@ -70,7 +70,8 @@ export function WindowControls({
   onMinimize,
   onToggleMode,
   mode,
-  variant = "night"
+  variant = "night",
+  defaultExpanded
 }) {
   // Show action-based icon: what will happen when clicked
   const ToggleModeIcon = mode === "floating" ? DockBottom : FloatWindow;
@@ -125,7 +126,8 @@ export function WindowControls({
     onMinimize: onMinimize,
     onToggleMode: onToggleMode,
     mode: mode,
-    variant: variant
+    variant: variant,
+    defaultExpanded: defaultExpanded
   });
 }
 function ExpandableWindowControls({
@@ -133,11 +135,12 @@ function ExpandableWindowControls({
   onMinimize,
   onToggleMode,
   mode,
-  variant = "night"
+  variant = "night",
+  defaultExpanded = false
 }) {
   const isNight = variant === "night";
-  const [expanded, setExpanded] = useState(false);
-  const expandAnim = useRef(new Animated.Value(0)).current;
+  const [expanded, setExpanded] = useState(defaultExpanded);
+  const expandAnim = useRef(new Animated.Value(defaultExpanded ? 1 : 0)).current;
   const dismissTimeout = useRef(null);
   const ToggleModeIcon = mode === "floating" ? DockBottom : FloatWindow;
   const toggleModeLabel = mode === "floating" ? "Dock to bottom sheet" : "Make floating window";

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

@@ -21,6 +21,9 @@ export { CompactRow } from "./CompactRow.js";
 export { DevToolsCard, DEVTOOLS_CARD_CONSTANTS } from "./DevToolsCard.js";
 export { HeaderSearchButton } from "./HeaderSearchButton.js";
 export { EmptyState, NoDataEmptyState, NoResultsEmptyState, NoSearchResultsEmptyState } from "./EmptyState.js";
+// The shared "nothing here" panel + the precedence between its causes. Every
+// capture tool's list empty goes through this — see the file header.
+export { ToolEmptyState, resolveListEmptyState } from "./ToolEmptyState.js";
 export { StatusIndicator } from "./StatusIndicator.js";
 export { TimeDisplay } from "./TimeDisplay.js";
 export { DetailView } from "./DetailView.js";
@@ -37,4 +40,13 @@ export { PowerToggleButton } from "./PowerToggleButton.js";
 export { ExpandedInfoRow, PillBadge } from "./ExpandedInfoRow.js";
 
 // EventHistoryViewer components
-export { EventHistoryViewer, ViewToggleCards, DiffModeTabs, CompareBar, EventPickerModal } from "./EventHistoryViewer/index.js";
+export { EventHistoryViewer, ViewToggleCards, DiffModeTabs, CompareBar, EventPickerModal } from "./EventHistoryViewer/index.js";
+export { InfoRow } from "./InfoRow.js";
+export { DetailViewToggle } from "./DetailViewToggle.js";
+export { ChangeRow } from "./ChangeRow.js";
+export { Pill } from "./Pill.js";
+export { ToolFooter, FooterRow, FooterCaption, FooterMessage, FooterButton } from "./ToolFooter.js";
+export { EntityFilterView } from "./EntityFilterView.js";
+export { ToggleRow } from "./ToggleRow.js";
+export { ChipStrip, useChipTap } from "./ChipStrip.js";
+export { ExportPreview, sizeWarningLevel } from "./ExportPreview.js";

package/lib/module/ui/index.js

@@ -15,4 +15,10 @@ export { toolTheme } from "./toolTheme.js";
 export { CyberpunkSectionButton } from "./console/CyberpunkSectionButton.js";
 
 // Game UI (colors, hooks, components)
-export * from "./gameUI/index.js";
+export * from "./gameUI/index.js";
+
+// Otto — the Buoy mascot (see OTTO_PLACEMENT_PLAN.md for where he belongs)
+export * from "./otto/index.js";
+
+// FlatList presets (tuned window/batch values + the E2E clipping guard)
+export { EVENT_LIST_PRESET, LOG_LIST_PRESET, CLIP_OFFSCREEN_CELLS } from "./listPresets.js";

package/lib/module/ui/listPresets.js

@@ -0,0 +1,39 @@
+"use strict";
+
+/**
+ * FlatList presets for tool lists — the tuned window/batch values and the
+ * E2E clipping guard that eleven list sites carried as copy-pasted props.
+ *
+ * Spread them onto a FlatList: `<FlatList {...EVENT_LIST_PRESET} … />`.
+ * A tool that later moves to FlashList changes this file, not eleven.
+ */
+
+/**
+ * `removeClippedSubviews` is off in E2E bundles: clipped rows leave the
+ * hierarchy entirely, so a row past the fold reads to the test as "the tool
+ * stopped capturing".
+ */
+export const CLIP_OFFSCREEN_CELLS = !(typeof process !== "undefined" && process.env?.EXPO_PUBLIC_E2E);
+/**
+ * Event / change / request lists: rows are tall-ish and arrive in bursts.
+ * Window and batch values are the "tuned" winner of the buoy-optimize
+ * batch run on the network tool (2026-07-06, batch-1783396983529-6l7w).
+ */
+export const EVENT_LIST_PRESET = {
+  initialNumToRender: 12,
+  maxToRenderPerBatch: 8,
+  windowSize: 5,
+  updateCellsBatchingPeriod: 50,
+  removeClippedSubviews: CLIP_OFFSCREEN_CELLS
+};
+
+/**
+ * Log tails (console, sentry): rows are short single lines, the list is
+ * read from the bottom, and a scroll-to-end must not land on blank cells.
+ */
+export const LOG_LIST_PRESET = {
+  initialNumToRender: 30,
+  maxToRenderPerBatch: 30,
+  windowSize: 21,
+  removeClippedSubviews: CLIP_OFFSCREEN_CELLS
+};

package/lib/module/ui/night/primitives.js

@@ -154,12 +154,14 @@ export function NightChip({
   selected,
   onPress,
   disabled,
-  icon
+  icon,
+  testID
 }) {
   return /*#__PURE__*/_jsxs(TouchableOpacity, {
     activeOpacity: 0.7,
     disabled: disabled || !onPress,
     onPress: onPress,
+    testID: testID,
     style: [styles.chip, selected ? styles.chipSelected : null, disabled ? styles.chipDisabled : null],
     children: [icon, /*#__PURE__*/_jsx(Text, {
       style: [styles.chipText, selected ? styles.chipTextSelected : null],