@buoy-gg/shared-ui 7.0.33 → 7.0.34

package/lib/module/tools/defineTool.js

@@ -0,0 +1,74 @@
+"use strict";
+
+/**
+ * defineToolPreset / createToolFactory — the typed way to declare a tool.
+ *
+ * Every tool package exports a `xToolPreset` object literal and a
+ * `createXTool(options)` factory that restates the same literal with
+ * `options?.name || default` on each field. None of the 23 presets was
+ * annotated with core's `InstalledApp`, so a preset that drifted from the
+ * contract (a bad `slot`, a missing `component`) failed at runtime in the
+ * dial, not at compile time.
+ *
+ * `ToolPreset` is that contract, declared here in shared (which every tool
+ * already depends on) and structurally identical to core's `InstalledApp`.
+ * `defineToolPreset` is an identity function that type-checks the literal;
+ * `createToolFactory` derives the `createXTool` function from the preset so
+ * the defaults live in exactly one place.
+ *
+ * Auto-discovery (core's `autoDiscoverPresets` / `autoExternalSync`) stays
+ * as hand-written `require()` blocks on purpose: Metro needs each package
+ * name as a static string lexically inside its own try, so a manifest can't
+ * replace them.
+ */
+
+/** Where a tool should render within the floating menu surface. */
+
+/** What an icon renderer receives. Mirrors core's `FloatingMenuRenderCtx`. */
+
+/** Declarative modal chrome for a body-only tool. Mirrors core's `ToolModalConfig`. */
+
+/**
+ * The shape the floating menu installs. Structurally identical to core's
+ * `InstalledApp`; declared here so tool packages can type their presets
+ * without depending on core.
+ */
+
+/** Identity with a type check: the literal must satisfy `ToolPreset`. */
+export function defineToolPreset(preset) {
+  return preset;
+}
+
+/** The overrides every `createXTool` accepted. */
+
+/**
+ * Derive `createXTool(options)` from a preset: id/name/description overrides
+ * apply on top, and `mapProps` turns tool-specific options into `props`
+ * (merged over the preset's defaults).
+ *
+ * ```ts
+ * export const createNetworkTool = createToolFactory(networkToolPreset, (o: { enableSharedModalDimensions?: boolean }) => ({
+ *   enableSharedModalDimensions: o.enableSharedModalDimensions ?? false,
+ * }));
+ * ```
+ */
+export function createToolFactory(preset, mapProps, /** Last word on any other preset field (a recolored icon, say). */
+extend) {
+  return options => {
+    const overrides = options ?? {};
+    const props = preset.props === undefined && !mapProps ? undefined : {
+      ...(preset.props ?? {}),
+      ...(mapProps ? mapProps(overrides) : {})
+    };
+    return {
+      ...preset,
+      id: overrides.id || preset.id,
+      name: overrides.name || preset.name,
+      description: overrides.description || preset.description,
+      ...(props !== undefined ? {
+        props
+      } : {}),
+      ...(extend ? extend(overrides, preset) : {})
+    };
+  };
+}

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

@@ -0,0 +1,105 @@
+"use strict";
+
+/**
+ * ChangeRow — one recorded change in a state tool's history list.
+ *
+ * redux, zustand and jotai each drew the same row on top of `CompactRow`:
+ * a colored status word (the slice / store / atom), a sublabel ("1.2ms ·
+ * 3 keys changed"), the primary line (changed keys or a value preview), a
+ * relative timestamp, and a right-hand badge made of a mono verb (SET,
+ * WRITE, ADDITEM) plus an icon — a lightning bolt when state actually
+ * changed, a clock when the update was slow. The three copies differed
+ * only in how they computed those strings. This component owns the drawing;
+ * tools own the strings.
+ *
+ * testID convention (unchanged from the originals): `${testID}-badge`,
+ * `${testID}-change`, `${testID}-slow`, `${testID}-status`,
+ * `${testID}-sublabel`, `${testID}-keys`.
+ */
+
+import React from "react";
+import { StyleSheet, Text, View } from "react-native";
+import { buoyColors } from "../gameUI/constants/gameUIColors.js";
+import { CompactRow } from "./CompactRow.js";
+import { Clock, Zap } from "../../icons/index.js";
+import { RelativeTime } from "../../utils/time/RelativeTime.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function ChangeRow({
+  statusColor,
+  statusLabel,
+  sublabel,
+  primaryText,
+  timestamp,
+  badgeText,
+  changed = false,
+  slow = false,
+  badgePrefix,
+  customBadge,
+  plainBadgeText,
+  onPress,
+  testID,
+  accessibilityLabel
+}) {
+  // Always a custom badge, even when there is no icon to hang off it. The
+  // alternative — letting CompactRow draw `badgeText` itself — leaves the one
+  // row whose badge matters most (a write that changed NOTHING) as the only
+  // row in the list with no handle on its badge.
+  const badge = customBadge ?? (badgeText !== undefined || badgePrefix || changed || slow ? /*#__PURE__*/_jsxs(View, {
+    style: styles.badgeContainer,
+    children: [badgePrefix, badgeText !== undefined ? /*#__PURE__*/_jsx(Text, {
+      style: [styles.badgeText, {
+        color: statusColor
+      }],
+      testID: testID ? `${testID}-badge` : undefined,
+      children: badgeText
+    }) : null, slow ? /*#__PURE__*/_jsx(View, {
+      style: styles.iconBadge,
+      testID: testID ? `${testID}-slow` : undefined,
+      children: /*#__PURE__*/_jsx(Clock, {
+        size: 12,
+        color: buoyColors.error
+      })
+    }) : changed ? /*#__PURE__*/_jsx(View, {
+      style: styles.iconBadge,
+      testID: testID ? `${testID}-change` : undefined,
+      children: /*#__PURE__*/_jsx(Zap, {
+        size: 12,
+        color: buoyColors.warning
+      })
+    }) : null]
+  }) : undefined);
+  return /*#__PURE__*/_jsx(CompactRow, {
+    statusDotColor: statusColor,
+    statusLabel: statusLabel,
+    statusSublabel: sublabel,
+    primaryText: primaryText,
+    bottomRightText: /*#__PURE__*/_jsx(RelativeTime, {
+      timestamp: timestamp
+    }),
+    customBadge: badge,
+    badgeText: badge ? undefined : plainBadgeText,
+    badgeColor: statusColor,
+    showChevron: true,
+    onPress: onPress,
+    testID: testID,
+    statusTestID: testID ? `${testID}-status` : undefined,
+    statusSublabelTestID: testID ? `${testID}-sublabel` : undefined,
+    primaryTestID: testID ? `${testID}-keys` : undefined,
+    accessibilityLabel: accessibilityLabel
+  });
+}
+const styles = StyleSheet.create({
+  badgeContainer: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 4
+  },
+  badgeText: {
+    fontSize: 11,
+    fontWeight: "600",
+    fontFamily: "monospace"
+  },
+  iconBadge: {
+    paddingHorizontal: 4
+  }
+});

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

@@ -0,0 +1,91 @@
+"use strict";
+
+/**
+ * ChipStrip — a horizontally scrolling row of filter chips whose taps
+ * don't misfire while the strip is being panned.
+ *
+ * react-query drew this three times (query status, mutation status, storage
+ * type) with the same 5-point / 300 ms swipe-vs-tap discrimination. The
+ * strip and the discrimination live here; the chip is whatever the tool
+ * renders, wired through `useChipTap`.
+ */
+
+import { useCallback, useRef, useState } from "react";
+import { ScrollView, StyleSheet, View } from "react-native";
+
+/** How far a touch may travel and still count as a tap. */
+import { jsx as _jsx } from "react/jsx-runtime";
+const TAP_SLOP_PX = 5;
+/** How long after a scroll ends taps stay suppressed. */
+const SCROLL_SETTLE_MS = 300;
+/**
+ * Swipe-vs-tap discrimination for chips inside a horizontal ScrollView.
+ * A press that moved more than a few points, or landed while the strip was
+ * still scrolling, is a pan — not a filter toggle.
+ */
+export function useChipTap() {
+  const [isScrolling, setIsScrolling] = useState(false);
+  const touchStartX = useRef(0);
+  const touchStartY = useRef(0);
+  const onTouchStart = useCallback(event => {
+    touchStartX.current = event.nativeEvent.pageX;
+    touchStartY.current = event.nativeEvent.pageY;
+  }, []);
+  const isTap = useCallback(event => {
+    if (!event) return true;
+    const dx = Math.abs(event.nativeEvent.pageX - touchStartX.current);
+    const dy = Math.abs(event.nativeEvent.pageY - touchStartY.current);
+    return !(dx > TAP_SLOP_PX || dy > TAP_SLOP_PX || isScrolling);
+  }, [isScrolling]);
+  const settle = useCallback(() => {
+    setTimeout(() => setIsScrolling(false), SCROLL_SETTLE_MS);
+  }, []);
+  const begin = useCallback(() => setIsScrolling(true), []);
+  return {
+    scrollProps: {
+      onScrollBeginDrag: begin,
+      onScrollEndDrag: settle,
+      onMomentumScrollBegin: begin,
+      onMomentumScrollEnd: settle
+    },
+    onTouchStart,
+    isTap
+  };
+}
+export function ChipStrip({
+  children,
+  scrollProps,
+  sentryLabel,
+  style,
+  contentStyle
+}) {
+  return /*#__PURE__*/_jsx(View, {
+    style: [styles.container, style],
+    children: /*#__PURE__*/_jsx(ScrollView, {
+      "sentry-label": sentryLabel,
+      horizontal: true,
+      showsHorizontalScrollIndicator: false,
+      style: styles.scrollView,
+      contentContainerStyle: [styles.scrollContent, contentStyle],
+      ...scrollProps,
+      children: children
+    })
+  });
+}
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    minWidth: 0
+  },
+  scrollView: {
+    flex: 1
+  },
+  scrollContent: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 8,
+    paddingHorizontal: 4,
+    paddingVertical: 4,
+    flexGrow: 1
+  }
+});

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

@@ -0,0 +1,125 @@
+"use strict";
+
+/**
+ * DetailViewToggle — the row of view cards at the top of a detail screen
+ * (ACTION · STATE · DIFF, CHANGE · STATE · DIFF, …).
+ *
+ * redux, zustand and jotai each shipped their own copy, differing only in
+ * the view keys, labels and testID prefix. The cards, the accent chrome,
+ * the disabled state (diff with nothing to compare) and the a11y contract
+ * are all one component now; tools pass their `views`.
+ */
+
+import React, { memo } from "react";
+import { StyleSheet, Text, TouchableOpacity, View } from "react-native";
+import { night } from "../night/nightTheme.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+function DetailViewToggleImpl({
+  views,
+  activeView,
+  onViewChange,
+  disabledKeys,
+  testIDPrefix
+}) {
+  return /*#__PURE__*/_jsx(View, {
+    style: styles.container,
+    children: views.map(view => {
+      const isActive = activeView === view.key;
+      const isDisabled = disabledKeys?.includes(view.key) ?? false;
+      const activeColor = view.activeColor ?? night.color.accent;
+      const IconComponent = view.icon;
+      return /*#__PURE__*/_jsxs(TouchableOpacity, {
+        style: [styles.card, isActive && [styles.cardActive, {
+          borderColor: activeColor
+        }], isDisabled && styles.cardDisabled],
+        onPress: () => !isDisabled && onViewChange(view.key),
+        activeOpacity: isDisabled ? 1 : 0.8,
+        disabled: isDisabled,
+        testID: testIDPrefix ? `${testIDPrefix}-view-${view.key}` : undefined,
+        accessibilityRole: "button",
+        accessibilityLabel: view.label,
+        accessibilityState: {
+          selected: isActive,
+          disabled: isDisabled
+        },
+        children: [/*#__PURE__*/_jsxs(View, {
+          style: styles.cardContent,
+          children: [/*#__PURE__*/_jsx(IconComponent, {
+            size: 14,
+            color: isActive ? activeColor : isDisabled ? night.color.textTertiary : night.color.textSecondary
+          }), /*#__PURE__*/_jsx(Text, {
+            style: [styles.cardLabel, isActive && [styles.cardLabelActive, {
+              color: activeColor
+            }], isDisabled && styles.cardLabelDisabled],
+            children: view.label
+          })]
+        }), view.description ? /*#__PURE__*/_jsx(Text, {
+          style: [styles.cardDescription, isActive && styles.cardDescriptionActive, isDisabled && styles.cardDescriptionDisabled],
+          children: view.description
+        }) : null]
+      }, view.key);
+    })
+  });
+}
+export const DetailViewToggle = /*#__PURE__*/memo(DetailViewToggleImpl);
+const styles = StyleSheet.create({
+  container: {
+    flexDirection: "row",
+    gap: 8,
+    padding: 14,
+    // Transparent so the night sheet's star field shows through.
+    backgroundColor: "transparent"
+  },
+  card: {
+    flex: 1,
+    backgroundColor: night.color.surface,
+    borderRadius: 12,
+    borderWidth: 1,
+    borderColor: night.color.border,
+    padding: 10,
+    gap: 4
+  },
+  cardActive: {
+    borderWidth: 1.5,
+    backgroundColor: night.color.accentSoft,
+    shadowColor: night.color.accent,
+    shadowOffset: {
+      width: 0,
+      height: 2
+    },
+    shadowOpacity: 0.1,
+    shadowRadius: 8,
+    elevation: 3
+  },
+  cardDisabled: {
+    opacity: 0.5
+  },
+  cardContent: {
+    flexDirection: "row",
+    alignItems: "center",
+    gap: 6
+  },
+  cardLabel: {
+    fontSize: 10,
+    fontWeight: "700",
+    letterSpacing: 0.5,
+    color: night.color.textSecondary
+  },
+  cardLabelActive: {
+    color: night.color.text
+  },
+  cardLabelDisabled: {
+    color: night.color.textTertiary
+  },
+  cardDescription: {
+    fontSize: 9,
+    color: night.color.textTertiary,
+    lineHeight: 12
+  },
+  cardDescriptionActive: {
+    color: night.color.textSecondary
+  },
+  cardDescriptionDisabled: {
+    color: night.color.textTertiary
+  }
+});

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

@@ -45,7 +45,8 @@ export function DevToolsCard({
   style,
   contentStyle,
   testID,
-  accessibilityLabel
+  accessibilityLabel,
+  accessible
 }) {
   const isInteractive = !!onPress || !!onLongPress;
 
@@ -54,6 +55,7 @@ export function DevToolsCard({
     return /*#__PURE__*/_jsx(View, {
       style: [styles.wrapper, style],
       testID: testID,
+      accessible: accessible,
       accessibilityLabel: accessibilityLabel,
       children: /*#__PURE__*/_jsx(View, {
         style: [styles.card, isSelected && styles.selectedCard, contentStyle],