@tastic/hud 0.21.0 → 0.22.0

package/dist/index.js

@@ -200,6 +200,7 @@ __export(index_exports, {
   StatSection: () => StatSection,
   TriggerGaugeHost: () => TriggerGaugeHost,
   UpdateDialog: () => UpdateDialog,
+  WELL_SHADOW: () => WELL_SHADOW,
   getColorPopoverId: () => getColorPopoverId,
   getCpuDifficultyPopoverId: () => getCpuDifficultyPopoverId,
   getInlineColorPickerContentSize: () => getInlineColorPickerContentSize,
@@ -215,6 +216,7 @@ __export(index_exports, {
   useOverlayCardColors: () => useOverlayCardColors,
   usePopoverHost: () => usePopoverHost,
   useQuitConfirmation: () => useQuitConfirmation,
+  useWellColors: () => useWellColors,
   useZoneClampedAlign: () => useZoneClampedAlign
 });
 module.exports = __toCommonJS(index_exports);
@@ -226,16 +228,25 @@ var import_react_native3 = require("react-native");
 var import_react_native_paper2 = require("react-native-paper");
 
 // src/AchievementRow.tsx
-var import_auto_paper = require("@rific/auto-paper");
 var import_react_native = require("react-native");
 var import_react_native_paper = require("react-native-paper");
+
+// src/wellSurface.ts
+var import_auto_paper = require("@rific/auto-paper");
+var WELL_SHADOW = "0px 1px 2px rgba(0, 0, 0, 0.3), 0px 1px 3px 1px rgba(0, 0, 0, 0.15)";
+function useWellColors() {
+  const { colors } = (0, import_auto_paper.useAutoPaperTheme)();
+  return { bg: colors.surface, fg: colors.onSurface, fgMuted: colors.onSurfaceVariant };
+}
+
+// src/AchievementRow.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var LOCKED_BADGE_COLOR = "rgba(128,128,128,0.3)";
 function AchievementRow({ icon, title, description, badgeColor, unlockedLabel, checkColor, progress, deviceMarker, fg: fgOverride, fgMuted: fgMutedOverride, sectionBg: sectionBgOverride }) {
-  const { dark } = (0, import_auto_paper.useAutoPaperTheme)();
-  const fg = fgOverride ?? (dark ? "#FFFFFF" : "#000000");
-  const fgMuted = fgMutedOverride ?? (dark ? "rgba(255,255,255,0.5)" : "rgba(0,0,0,0.5)");
-  const sectionBg = sectionBgOverride ?? (dark ? "rgba(255,255,255,0.06)" : "rgba(0,0,0,0.04)");
+  const well = useWellColors();
+  const fg = fgOverride ?? well.fg;
+  const fgMuted = fgMutedOverride ?? well.fgMuted;
+  const sectionBg = sectionBgOverride ?? well.bg;
   const unlocked = unlockedLabel !== void 0;
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native.View, { style: [styles.row, { backgroundColor: sectionBg }], children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native.View, { style: [styles.badge, { backgroundColor: badgeColor }], children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native_paper.Icon, { source: icon, size: 20, color: unlocked ? "#000000" : fgMuted }) }),
@@ -278,6 +289,7 @@ var styles = import_react_native.StyleSheet.create({
   row: {
     alignItems: "center",
     borderRadius: 12,
+    boxShadow: WELL_SHADOW,
     flexDirection: "row",
     gap: 12,
     padding: 12
@@ -299,13 +311,13 @@ var MONO_FONT = import_react_native2.Platform.select({ ios: "Menlo", android: "m
 
 // src/AchievementCatalogSection.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
-function AchievementCatalogSection({ rows, label = "ALL ACHIEVEMENTS", fg, fgMuted: fgMutedOverride }) {
+function AchievementCatalogSection({ rows, label = "ALL ACHIEVEMENTS", fg, fgMuted: fgMutedOverride, sectionBg }) {
   const { dark } = (0, import_auto_paper2.useAutoPaperTheme)();
   const fgMuted = fgMutedOverride ?? (dark ? "rgba(255,255,255,0.5)" : "rgba(0,0,0,0.5)");
   const tierAccent = (tierColor) => dark ? tierColor : (0, import_auto_paper2.getBlendedColor)("#000000", tierColor, 0.5);
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_react.Fragment, { children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native_paper2.Text, { variant: "labelMedium", style: [styles2.label, { color: fgMuted, fontFamily: MONO_FONT }], children: label }),
-    rows.map((row) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AchievementRow, { icon: row.icon, title: row.title, description: row.description, badgeColor: row.unlockedAt !== void 0 ? row.tierColor : LOCKED_BADGE_COLOR, checkColor: tierAccent(row.tierColor), unlockedLabel: row.unlockedLabel, progress: row.progress, deviceMarker: row.deviceMarker, fg, fgMuted: fgMutedOverride }, row.id))
+    rows.map((row) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AchievementRow, { icon: row.icon, title: row.title, description: row.description, badgeColor: row.unlockedAt !== void 0 ? row.tierColor : LOCKED_BADGE_COLOR, checkColor: tierAccent(row.tierColor), unlockedLabel: row.unlockedLabel, progress: row.progress, deviceMarker: row.deviceMarker, fg, fgMuted: fgMutedOverride, sectionBg }, row.id))
   ] });
 }
 var styles2 = import_react_native3.StyleSheet.create({
@@ -360,14 +372,13 @@ var styles3 = import_react_native4.StyleSheet.create({
 });
 
 // src/StatRow.tsx
-var import_auto_paper4 = require("@rific/auto-paper");
 var import_react_native5 = require("react-native");
 var import_react_native_paper4 = require("react-native-paper");
 var import_jsx_runtime4 = require("react/jsx-runtime");
 function StatRow({ label, value, fg: fgOverride, fgMuted: fgMutedOverride }) {
-  const { dark } = (0, import_auto_paper4.useAutoPaperTheme)();
-  const fg = fgOverride ?? (dark ? "#FFFFFF" : "#000000");
-  const fgMuted = fgMutedOverride ?? (dark ? "rgba(255,255,255,0.5)" : "rgba(0,0,0,0.5)");
+  const well = useWellColors();
+  const fg = fgOverride ?? well.fg;
+  const fgMuted = fgMutedOverride ?? well.fgMuted;
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)(import_react_native5.View, { style: styles4.row, children: [
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_paper4.Text, { variant: "bodyMedium", style: { color: fgMuted }, children: label }),
     /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(import_react_native_paper4.Text, { variant: "bodyMedium", style: [styles4.value, { color: fg }], children: value })
@@ -385,14 +396,13 @@ var styles4 = import_react_native5.StyleSheet.create({
 });
 
 // src/StatSection.tsx
-var import_auto_paper5 = require("@rific/auto-paper");
 var import_react_native6 = require("react-native");
 var import_react_native_paper5 = require("react-native-paper");
 var import_jsx_runtime5 = require("react/jsx-runtime");
 function StatSection({ label, fg: fgOverride, sectionBg: sectionBgOverride, children }) {
-  const { dark } = (0, import_auto_paper5.useAutoPaperTheme)();
-  const fg = fgOverride ?? (dark ? "#FFFFFF" : "#000000");
-  const sectionBg = sectionBgOverride ?? (dark ? "rgba(255,255,255,0.06)" : "rgba(0,0,0,0.04)");
+  const well = useWellColors();
+  const fg = fgOverride ?? well.fg;
+  const sectionBg = sectionBgOverride ?? well.bg;
   return /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(import_react_native6.View, { style: [styles5.section, { backgroundColor: sectionBg }], children: [
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_react_native_paper5.Text, { variant: "labelMedium", style: [styles5.label, { color: fg }], children: label }),
     children
@@ -409,6 +419,7 @@ var styles5 = import_react_native6.StyleSheet.create({
   },
   section: {
     borderRadius: 12,
+    boxShadow: WELL_SHADOW,
     gap: 8,
     padding: 16
   }
@@ -416,16 +427,16 @@ var styles5 = import_react_native6.StyleSheet.create({
 
 // src/ActivityStatSection.tsx
 var import_jsx_runtime6 = require("react/jsx-runtime");
-function ActivityStatSection({ stats }) {
-  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(StatSection, { label: "ACTIVITY", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(StatRow, { label: "Days Played", value: String(stats.distinctDaysPlayed) }),
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(StatRow, { label: "Day Streak", value: String(stats.currentDayStreak) }),
-    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(StatRow, { label: "Best Day Streak", value: String(stats.bestDayStreak) })
+function ActivityStatSection({ stats, fg, fgMuted, sectionBg }) {
+  return /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)(StatSection, { label: "ACTIVITY", fg, sectionBg, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(StatRow, { label: "Days Played", value: String(stats.distinctDaysPlayed), fg, fgMuted }),
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(StatRow, { label: "Day Streak", value: String(stats.currentDayStreak), fg, fgMuted }),
+    /* @__PURE__ */ (0, import_jsx_runtime6.jsx)(StatRow, { label: "Best Day Streak", value: String(stats.bestDayStreak), fg, fgMuted })
   ] });
 }
 
 // src/BaseSettingsDialog.tsx
-var import_auto_paper9 = require("@rific/auto-paper");
+var import_auto_paper7 = require("@rific/auto-paper");
 var import_feedback_press2 = require("@rific/feedback-press");
 var import_updater = require("@rific/updater");
 var import_core4 = require("@tastic/core");
@@ -435,7 +446,7 @@ var import_react_native_paper9 = require("react-native-paper");
 var import_react_native_safe_area_context2 = require("react-native-safe-area-context");
 
 // src/ConfirmDialog.tsx
-var import_auto_paper8 = require("@rific/auto-paper");
+var import_auto_paper6 = require("@rific/auto-paper");
 var import_feedback_press = require("@rific/feedback-press");
 var import_core2 = require("@tastic/core");
 var import_react3 = require("react");
@@ -443,7 +454,7 @@ var import_react_native11 = require("react-native");
 var import_react_native_paper7 = require("react-native-paper");
 
 // src/DialogHeader.tsx
-var import_auto_paper6 = require("@rific/auto-paper");
+var import_auto_paper4 = require("@rific/auto-paper");
 var import_react_native7 = require("react-native");
 var import_react_native_paper6 = require("react-native-paper");
 var import_jsx_runtime7 = require("react/jsx-runtime");
@@ -452,7 +463,7 @@ function isCompactDialogHeight(height) {
   return height < COMPACT_DIALOG_HEIGHT;
 }
 function DialogHeader({ icon, title, color, compact = false, style }) {
-  const { colors } = (0, import_auto_paper6.useAutoPaperTheme)();
+  const { colors } = (0, import_auto_paper4.useAutoPaperTheme)();
   const accent = color ?? colors.primary;
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_react_native7.View, { style: [compact ? styles6.compact : styles6.full, style], children: [
     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(import_react_native_paper6.Icon, { source: icon, size: compact ? COMPACT_ICON_SIZE : ICON_SIZE, color: accent }),
@@ -549,11 +560,11 @@ var overlayActionStyles = import_react_native8.StyleSheet.create({
 });
 
 // src/OverlaySurface.tsx
-var import_auto_paper7 = require("@rific/auto-paper");
+var import_auto_paper5 = require("@rific/auto-paper");
 var import_react_native9 = require("react-native");
 var import_jsx_runtime8 = require("react/jsx-runtime");
 function useOverlayCardColors() {
-  const { colors } = (0, import_auto_paper7.useAutoPaperTheme)();
+  const { colors } = (0, import_auto_paper5.useAutoPaperTheme)();
   return { fg: colors.onSurface, fgMuted: colors.onSurfaceVariant, cardBorder: colors.outlineVariant, backdrop: colors.backdrop };
 }
 function OverlayBackdrop({ children, style, onLayout }) {
@@ -561,9 +572,9 @@ function OverlayBackdrop({ children, style, onLayout }) {
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_react_native9.View, { onLayout, style: [overlayStyles.overlay, { backgroundColor: backdrop }, style], children });
 }
 function OverlayCard({ children, style, ...rest }) {
-  const { isV3, roundness } = (0, import_auto_paper7.useAutoPaperTheme)();
-  const blur = (0, import_auto_paper7.useBlur)();
-  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_auto_paper7.BlurView, { blur, style: [overlayStyles.card, styles7.card, { borderRadius: (isV3 ? 7 : 1) * roundness }, style], ...rest, children });
+  const { isV3, roundness } = (0, import_auto_paper5.useAutoPaperTheme)();
+  const blur = (0, import_auto_paper5.useBlur)();
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_auto_paper5.BlurView, { blur, style: [overlayStyles.card, styles7.card, { borderRadius: (isV3 ? 7 : 1) * roundness }, style], ...rest, children });
 }
 var styles7 = import_react_native9.StyleSheet.create({
   card: { overflow: "hidden" }
@@ -589,7 +600,7 @@ function useCompactDialog(rotation = 0) {
 // src/ConfirmDialog.tsx
 var import_jsx_runtime9 = require("react/jsx-runtime");
 function ConfirmDialog({ visible, title, message, confirmLabel, cancelLabel, onConfirm, onCancel, rotation = 0, icon = "help-circle-outline", destructive = false }) {
-  const { colors } = (0, import_auto_paper8.useAutoPaperTheme)();
+  const { colors } = (0, import_auto_paper6.useAutoPaperTheme)();
   const { fg } = useOverlayCardColors();
   const { compact, onLayout } = useCompactDialog(rotation);
   const onCancelRef = (0, import_react3.useRef)(onCancel);
@@ -694,7 +705,7 @@ function SettingIcon({ source, color, containerColor }) {
   return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_react_native13.View, { style: [styles10.iconBadge, { backgroundColor: containerColor }], children: /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_react_native_paper9.Icon, { source, size: 18, color }) });
 }
 function BaseSettingsDialog({ visible, onDismiss, rotation: rotationOverride, version, lockOrientation, onLockOrientationChange, deferBottomEdgeGestures, onDeferBottomEdgeGestures, keepAwake, onKeepAwakeChange, hideSound = false, hideHaptics = false, hideAppearance = false, hideUpdateCheck = false, onUpdateError, onShowHowToPlay, children }) {
-  const { colors } = (0, import_auto_paper9.useAutoPaperTheme)();
+  const { colors } = (0, import_auto_paper7.useAutoPaperTheme)();
   const ambientRotation = (0, import_core4.useRotation)();
   const rotation = rotationOverride ?? ambientRotation;
   const window = (0, import_react_native13.useWindowDimensions)();
@@ -707,8 +718,8 @@ function BaseSettingsDialog({ visible, onDismiss, rotation: rotationOverride, ve
   const { settings: soundSettings, set: setSoundSettings } = (0, import_feedback_press2.useSoundSettings)();
   const sound = (0, import_react6.useContext)(import_feedback_press2.SoundContext);
   const { forceShort: forceHapticFeedback } = (0, import_feedback_press2.useVibration)();
-  const { settings: themeSettings, set: setThemeSettings } = (0, import_auto_paper9.useThemeSettings)();
-  const expoBlur = (0, import_auto_paper9.useBlurModule)();
+  const { settings: themeSettings, set: setThemeSettings } = (0, import_auto_paper7.useThemeSettings)();
+  const expoBlur = (0, import_auto_paper7.useBlurModule)();
   const [infoMessage, setInfoMessage] = (0, import_react6.useState)(null);
   const { manifest: updateManifest, onConfirm: onUpdateConfirm, respond: respondToUpdateConfirm } = useUpdateConfirmBridge();
   const { check, checking, updateReady } = (0, import_updater.useUpdater)({
@@ -731,8 +742,8 @@ function BaseSettingsDialog({ visible, onDismiss, rotation: rotationOverride, ve
   const showUpdateCheck = import_react_native13.Platform.OS !== "web" && !hideUpdateCheck;
   if (!opened) return null;
   return /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_react_native_paper9.Portal, { children: /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(RotatedFrame, { rotation, rotatedSafeArea: true, portalHost: true, passThrough: true, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_auto_paper9.Dialog, { visible, onDismiss, style: [styles10.dialog, { width: sheetWidth }], children: [
-      /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_auto_paper9.Dialog.ScrollArea, { style: styles10.scrollArea, children: /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_auto_paper9.FadingScrollView, { contentContainerStyle: styles10.scrollContent, showsVerticalScrollIndicator: false, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_auto_paper7.Dialog, { visible, onDismiss, style: [styles10.dialog, { width: sheetWidth }], children: [
+      /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_auto_paper7.Dialog.ScrollArea, { style: styles10.scrollArea, children: /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_auto_paper7.FadingScrollView, { contentContainerStyle: styles10.scrollContent, showsVerticalScrollIndicator: false, children: [
         /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(DialogHeader, { icon: "cog", title: "Settings", compact: compactHeader }),
         /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_react_native13.View, { style: styles10.content, children: [
           /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_react_native13.View, { style: styles10.toggleGroup, children: [
@@ -814,7 +825,7 @@ function BaseSettingsDialog({ visible, onDismiss, rotation: rotationOverride, ve
           ] }),
           showAppearance && /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_react_native13.View, { style: styles10.section, children: [
             /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_react_native_paper9.Text, { variant: "labelMedium", style: [styles10.sectionLabel, { color: colors.onSurfaceVariant }], children: "APPEARANCE" }),
-            /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_auto_paper9.AutoAppearancePicker, { showLabels: false }),
+            /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_auto_paper7.AutoAppearancePicker, { showLabels: false }),
             showBlur && /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(import_feedback_press2.TouchableRipple, { onPress: () => setThemeSettings({ blur: !themeSettings.blur }), style: styles10.toggleButton, accessibilityLabel: `Blur ${themeSettings.blur ? "on" : "off"}`, children: /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_react_native13.View, { style: styles10.toggleContent, children: [
               /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(SettingIcon, { source: themeSettings.blur ? "blur" : "blur-off", color: themeSettings.blur ? colors.tertiary : colors.onSurfaceVariant, containerColor: themeSettings.blur ? colors.tertiaryContainer : colors.surfaceVariant }),
               /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)(import_react_native13.View, { style: styles10.flexShrink, children: [
@@ -925,7 +936,7 @@ var styles10 = import_react_native13.StyleSheet.create({
 });
 
 // src/BaseStatsScreen.tsx
-var import_auto_paper10 = require("@rific/auto-paper");
+var import_auto_paper8 = require("@rific/auto-paper");
 var import_feedback_press3 = require("@rific/feedback-press");
 var import_core5 = require("@tastic/core");
 var import_react7 = require("react");
@@ -933,7 +944,7 @@ var import_react_native14 = require("react-native");
 var import_react_native_paper10 = require("react-native-paper");
 var import_jsx_runtime12 = require("react/jsx-runtime");
 function BaseStatsScreen({ rotation: rotationOverride, title = "Achievements", titleVariant = "headlineSmall", onBack, backLabel = "Back", hitSlop, insets, onReset, resetLabel = "Reset All Stats", resetConfirmTitle = "Reset Everything?", resetConfirmBody = "This permanently erases all stats and achievements. This cannot be undone.", fg: fgOverride, bg: bgOverride, children }) {
-  const { dark, colors } = (0, import_auto_paper10.useAutoPaperTheme)();
+  const { dark, colors } = (0, import_auto_paper8.useAutoPaperTheme)();
   const ambientRotation = (0, import_core5.useRotation)();
   const rotation = rotationOverride ?? ambientRotation;
   const [confirmResetVisible, setConfirmResetVisible] = (0, import_react7.useState)(false);
@@ -945,7 +956,7 @@ function BaseStatsScreen({ rotation: rotationOverride, title = "Achievements", t
       /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_feedback_press3.IconButton, { icon: "arrow-left", iconColor: fg, size: 24, hitSlop, onPress: onBack, accessibilityLabel: backLabel }),
       /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_react_native_paper10.Text, { variant: titleVariant, style: [styles11.title, { color: fg }], children: title })
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(import_auto_paper10.FadingScrollView, { style: styles11.scrollView, contentContainerStyle: [styles11.content, { paddingBottom: 32 + insets.bottom }], showsVerticalScrollIndicator: false, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(import_auto_paper8.FadingScrollView, { style: styles11.scrollView, contentContainerStyle: [styles11.content, { paddingBottom: 32 + insets.bottom }], showsVerticalScrollIndicator: false, children: [
       children,
       showReset && /* @__PURE__ */ (0, import_jsx_runtime12.jsx)(import_feedback_press3.Button, { mode: "contained", onPress: () => setConfirmResetVisible(true), buttonColor: colors.danger, textColor: colors.onDanger, style: styles11.resetButton, children: resetLabel })
     ] }),
@@ -1028,7 +1039,7 @@ var import_core9 = require("@tastic/core");
 var import_react_native20 = require("react-native");
 
 // src/SectionedDropdown.tsx
-var import_auto_paper11 = require("@rific/auto-paper");
+var import_auto_paper9 = require("@rific/auto-paper");
 var import_feedback_press4 = require("@rific/feedback-press");
 var import_core8 = require("@tastic/core");
 var import_react_native19 = require("react-native");
@@ -1189,8 +1200,8 @@ function SectionedDropdown({ id, host, icon, accessibilityLabel, sections, accen
   const ambientRotation = (0, import_core8.useRotation)();
   const rotation = rotationOverride ?? ambientRotation;
   const menuBg = dark ? "#000000" : "#FFFFFF";
-  const menuBorderColor = (0, import_auto_paper11.getBlendedColor)(mutedColor, menuBg, 0.5);
-  const resolvedOnAccentColor = onAccentColor ?? (0, import_auto_paper11.getColorRoles)(accentColor, menuBg).onColor;
+  const menuBorderColor = (0, import_auto_paper9.getBlendedColor)(mutedColor, menuBg, 0.5);
+  const resolvedOnAccentColor = onAccentColor ?? (0, import_auto_paper9.getColorRoles)(accentColor, menuBg).onColor;
   const fg = dark ? "#FFFFFF" : "#000000";
   const open = host.openId === id;
   const estimatedHeight = MENU_VERTICAL_PADDING + sections.reduce((sum, section, sectionIndex) => {
@@ -1431,7 +1442,7 @@ var styles17 = import_react_native22.StyleSheet.create({
 });
 
 // src/InlineColorPicker.tsx
-var import_auto_paper12 = require("@rific/auto-paper");
+var import_auto_paper10 = require("@rific/auto-paper");
 var import_feedback_press6 = require("@rific/feedback-press");
 var import_core10 = require("@tastic/core");
 var import_react_native23 = require("react-native");
@@ -1457,7 +1468,7 @@ function getInlineColorPickerContentSize(swatchCount, windowWidth, columns) {
   const height = SWATCHES_BORDER_WIDTH * 2 + SWATCHES_PADDING * 2 + SWATCH_SIZE * rows + SWATCHES_GAP * (rows - 1);
   return { width, height };
 }
-function InlineColorPicker({ id, host, value, onChange, previewValue, swatches = import_auto_paper12.defaultColors, takenValue, allowSwapTaken, dark, align: forcedAlign, alignOverride, rotation: rotationOverride, icon = "palette", tag, labelFontFamily = MONO_FONT, autoDismiss = true, columns, size = DEFAULT_SIZE }) {
+function InlineColorPicker({ id, host, value, onChange, previewValue, swatches = import_auto_paper10.defaultColors, takenValue, allowSwapTaken, dark, align: forcedAlign, alignOverride, rotation: rotationOverride, icon = "palette", tag, labelFontFamily = MONO_FONT, autoDismiss = true, columns, size = DEFAULT_SIZE }) {
   const ambientRotation = (0, import_core10.useRotation)();
   const rotation = rotationOverride ?? ambientRotation;
   const menuBg = dark ? "#000000" : "#FFFFFF";
@@ -1470,7 +1481,7 @@ function InlineColorPicker({ id, host, value, onChange, previewValue, swatches =
   const align = forcedAlign ?? placement.align;
   const displayFor = previewValue ?? ((hex) => hex);
   const displayValue = displayFor(value);
-  const contrastColor = (0, import_auto_paper12.getContrastColor)(displayValue);
+  const contrastColor = (0, import_auto_paper10.getContrastColor)(displayValue);
   const tagFontSize = size * (tag && EMOJI_PATTERN.test(tag) ? 0.6 : 0.4);
   return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(import_react_native23.View, { style: [styles18.anchor, open && styles18.anchorOpen], children: [
     /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_feedback_press6.TouchableRipple, { onPress: () => host.toggle(id), borderless: true, style: [styles18.trigger, { backgroundColor: displayValue, borderRadius: size / 2, height: size, width: size }], children: /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native23.View, { ref: triggerRef, collapsable: false, style: styles18.triggerMeasure, children: tag ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Text, { style: [styles18.tagLabel, { color: contrastColor, fontFamily: labelFontFamily, fontSize: tagFontSize }], numberOfLines: 1, adjustsFontSizeToFit: true, children: tag }) : /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Icon, { source: icon, size: size * 0.6, color: contrastColor }) }) }),
@@ -1489,7 +1500,7 @@ function InlineColorPicker({ id, host, value, onChange, previewValue, swatches =
           },
           borderless: true,
           style: [styles18.swatch, { backgroundColor: swatchDisplay }, selected && styles18.swatchSelected, taken && !swappable && styles18.swatchTaken],
-          children: selected ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Icon, { source: "check", size: 16, color: (0, import_auto_paper12.getContrastColor)(swatchDisplay) }) : swappable ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Icon, { source: "swap-horizontal", size: 16, color: (0, import_auto_paper12.getContrastColor)(swatchDisplay) }) : taken ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Icon, { source: "close", size: 16, color: (0, import_auto_paper12.getContrastColor)(swatchDisplay) }) : /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native23.View, {})
+          children: selected ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Icon, { source: "check", size: 16, color: (0, import_auto_paper10.getContrastColor)(swatchDisplay) }) : swappable ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Icon, { source: "swap-horizontal", size: 16, color: (0, import_auto_paper10.getContrastColor)(swatchDisplay) }) : taken ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native_paper13.Icon, { source: "close", size: 16, color: (0, import_auto_paper10.getContrastColor)(swatchDisplay) }) : /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(import_react_native23.View, {})
         },
         swatch.value
       );
@@ -1568,7 +1579,7 @@ var styles18 = import_react_native23.StyleSheet.create({
 });
 
 // src/LabeledDropdown.tsx
-var import_auto_paper13 = require("@rific/auto-paper");
+var import_auto_paper11 = require("@rific/auto-paper");
 var import_feedback_press7 = require("@rific/feedback-press");
 var import_react_native24 = require("react-native");
 var import_react_native_paper14 = require("react-native-paper");
@@ -1602,7 +1613,7 @@ function LabeledDropdown({ id, host, options, value, onChange, color, dark, alig
     ] }) }),
     /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(PopoverBody, { visible: open && measured, align, verticalAlign, caretColor: menuBg, caretBorderColor: color, caretBorderWidth: 2, triggerSize: TRIGGER_HEIGHT, children: /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_react_native24.ScrollView, { style: [styles19.menu, { backgroundColor: menuBg, borderColor: color, width: POPOVER_WIDTH, maxHeight }], contentContainerStyle: styles19.menuContent, showsVerticalScrollIndicator: false, children: options.map((option) => {
       const isSelected = option.value === value;
-      const onColor = (0, import_auto_paper13.getContrastColor)(color);
+      const onColor = (0, import_auto_paper11.getContrastColor)(color);
       return /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_feedback_press7.TouchableRipple, { onPress: () => handleSelect(option), style: [styles19.row, isSelected && { backgroundColor: color }], children: /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(import_react_native24.View, { style: styles19.rowInner, children: [
         option.icon && /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_react_native_paper14.Icon, { source: option.icon, size: 18, color: isSelected ? onColor : fg }),
         /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(import_react_native_paper14.Text, { style: [styles19.rowLabel, { color: isSelected ? onColor : fg }], numberOfLines: 1, children: option.label })
@@ -1942,6 +1953,7 @@ function useQuitConfirmation(hasProgress, onConfirmedBack) {
   StatSection,
   TriggerGaugeHost,
   UpdateDialog,
+  WELL_SHADOW,
   getColorPopoverId,
   getCpuDifficultyPopoverId,
   getInlineColorPickerContentSize,
@@ -1957,5 +1969,6 @@ function useQuitConfirmation(hasProgress, onConfirmedBack) {
   useOverlayCardColors,
   usePopoverHost,
   useQuitConfirmation,
+  useWellColors,
   useZoneClampedAlign
 });

package/dist/index.mjs

@@ -17,9 +17,11 @@ import {
   StatRow,
   StatSection,
   UpdateDialog,
+  WELL_SHADOW,
   getStaggeredWordDuration,
-  useCompactDialog
-} from "./chunk-UOA35OWJ.mjs";
+  useCompactDialog,
+  useWellColors
+} from "./chunk-N7A7W72S.mjs";
 import {
   COMPACT_DIALOG_HEIGHT,
   DialogHeader,
@@ -915,6 +917,7 @@ export {
   StatSection,
   TriggerGaugeHost,
   UpdateDialog,
+  WELL_SHADOW,
   getColorPopoverId,
   getCpuDifficultyPopoverId,
   getInlineColorPickerContentSize,
@@ -930,5 +933,6 @@ export {
   useOverlayCardColors,
   usePopoverHost,
   useQuitConfirmation,
+  useWellColors,
   useZoneClampedAlign
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tastic/hud",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Visual component kit for local-multiplayer React Native games: inline (non-modal) popovers, dropdowns, color pickers, gauges, ready buttons, and dialogs, built to stay scoped to one player's own zone on a shared screen",
   "keywords": [
     "react-native",

package/src/AchievementCatalogSection.tsx

@@ -15,12 +15,13 @@ import { MONO_FONT } from './fonts'
 interface Props {
   rows: AchievementCatalogRow[]
   label?: string
-  // Independently optional overrides for this section's own heading/row colors - default to the
-  // same useAutoPaperTheme()-derived formula as AchievementRow/StatSection/StatRow/BaseStatsScreen
-  // (see BaseStatsScreen's own doc for why) when omitted, so every existing caller renders
-  // identically to before. Passed straight through to each <AchievementRow>.
+  // Independently optional overrides for the heading's and rows' colors. fg and sectionBg go to each
+  // <AchievementRow> (whose own defaults are the well's, see wellSurface.ts). fgMuted goes to the heading and
+  // the rows; omitted, the heading (drawn on the screen, not on a well) keeps its own screen-derived default
+  // and the rows theirs.
   fg?: string
   fgMuted?: string
+  sectionBg?: string
 }
 
 // The "ALL ACHIEVEMENTS" heading + one <AchievementRow> per row - extracted verbatim from every
@@ -42,7 +43,7 @@ interface Props {
 // about 1.4:1 and 1.8:1 against the light screen's white, so a bar or check in either barely shows;
 // mixed, they're about 5:1 and 6:1 (bronze goes from about 3:1 to 9:1). The badge keeps the true tier
 // color: its glyph is black, which reads on all three.
-export function AchievementCatalogSection({ rows, label = 'ALL ACHIEVEMENTS', fg, fgMuted: fgMutedOverride }: Props) {
+export function AchievementCatalogSection({ rows, label = 'ALL ACHIEVEMENTS', fg, fgMuted: fgMutedOverride, sectionBg }: Props) {
   const { dark } = useAutoPaperTheme()
   const fgMuted = fgMutedOverride ?? (dark ? 'rgba(255,255,255,0.5)' : 'rgba(0,0,0,0.5)')
   const tierAccent = (tierColor: string) => (dark ? tierColor : getBlendedColor('#000000', tierColor, 0.5))
@@ -53,7 +54,7 @@ export function AchievementCatalogSection({ rows, label = 'ALL ACHIEVEMENTS', fg
         {label}
       </Text>
       {rows.map((row) => (
-        <AchievementRow key={row.id} icon={row.icon} title={row.title} description={row.description} badgeColor={row.unlockedAt !== undefined ? row.tierColor : LOCKED_BADGE_COLOR} checkColor={tierAccent(row.tierColor)} unlockedLabel={row.unlockedLabel} progress={row.progress} deviceMarker={row.deviceMarker} fg={fg} fgMuted={fgMutedOverride} />
+        <AchievementRow key={row.id} icon={row.icon} title={row.title} description={row.description} badgeColor={row.unlockedAt !== undefined ? row.tierColor : LOCKED_BADGE_COLOR} checkColor={tierAccent(row.tierColor)} unlockedLabel={row.unlockedLabel} progress={row.progress} deviceMarker={row.deviceMarker} fg={fg} fgMuted={fgMutedOverride} sectionBg={sectionBg} />
       ))}
     </Fragment>
   )

package/src/AchievementRow.tsx

@@ -1,7 +1,8 @@
-import { useAutoPaperTheme } from '@rific/auto-paper'
 import { StyleSheet, View } from 'react-native'
 import { Icon, ProgressBar, Text } from 'react-native-paper'
 
+import { useWellColors, WELL_SHADOW } from './wellSurface'
+
 // A neutral gray for a locked badge's own background - exported so a caller computing its own
 // badge color (unlocked ? tierColor : LOCKED_BADGE_COLOR, matching LightCycles' own achievements.tsx)
 // doesn't need to invent or duplicate this exact tone.
@@ -32,10 +33,9 @@ interface Props {
   // from a specific profile's own tab - optional since only an app with per-profile stat views has
   // this concept at all.
   deviceMarker?: boolean
-  // Independently optional overrides for this row's own text/background colors - each defaults to
-  // the same dark-mode-derived formula as StatRow/StatSection/BaseStatsScreen (see that component's
-  // own doc for why) when omitted, so every existing caller renders identically to before. A caller
-  // with its own app-wide chrome palette passes whichever of the three it needs.
+  // Independently optional overrides for this row's own text/background colors - each defaults to the well's
+  // (wellSurface.ts: the theme's surface and its onSurface/onSurfaceVariant text), like StatSection/StatRow. A
+  // caller with its own app-wide chrome palette passes whichever of the three it needs.
   fg?: string
   fgMuted?: string
   sectionBg?: string
@@ -44,16 +44,15 @@ interface Props {
 // One row per achievement - a tier-colored (or locked-gray) badge, title/description, an optional
 // progress bar while locked, and either an unlocked check-mark+label or a lock icon. Extracted
 // verbatim from LightCycles' own achievements.tsx, where this exact row shape backed its entire
-// "ALL ACHIEVEMENTS" list. fg/fgMuted/its own section background default to the same
-// useAutoPaperTheme()-derived formula as StatRow/StatSection/BaseStatsScreen (see BaseStatsScreen's
-// own doc for why), each independently overridable via the matching prop for a caller with its own
-// chrome palette. Has no opinion on what an achievement actually IS (id, unlock predicate, catalog)
+// "ALL ACHIEVEMENTS" list. Each row is its own well (wellSurface.ts: the theme's surface on MD3's level-1 shadow);
+// fg/fgMuted/its own background default to the well's colors, each independently overridable via the matching
+// prop for a caller with its own chrome palette. Has no opinion on what an achievement actually IS (id, unlock predicate, catalog)
 // - that stays entirely app-local; this is purely the presentational row.
 export function AchievementRow({ icon, title, description, badgeColor, unlockedLabel, checkColor, progress, deviceMarker, fg: fgOverride, fgMuted: fgMutedOverride, sectionBg: sectionBgOverride }: Props) {
-  const { dark } = useAutoPaperTheme()
-  const fg = fgOverride ?? (dark ? '#FFFFFF' : '#000000')
-  const fgMuted = fgMutedOverride ?? (dark ? 'rgba(255,255,255,0.5)' : 'rgba(0,0,0,0.5)')
-  const sectionBg = sectionBgOverride ?? (dark ? 'rgba(255,255,255,0.06)' : 'rgba(0,0,0,0.04)')
+  const well = useWellColors()
+  const fg = fgOverride ?? well.fg
+  const fgMuted = fgMutedOverride ?? well.fgMuted
+  const sectionBg = sectionBgOverride ?? well.bg
   const unlocked = unlockedLabel !== undefined
 
   return (
@@ -116,6 +115,7 @@ const styles = StyleSheet.create({
   row: {
     alignItems: 'center',
     borderRadius: 12,
+    boxShadow: WELL_SHADOW,
     flexDirection: 'row',
     gap: 12,
     padding: 12

package/src/ActivityStatSection.tsx

@@ -9,6 +9,11 @@ interface ActivityStats {
 
 interface Props {
   stats: ActivityStats
+  // Optional overrides for the section's and its rows' colors, passed straight through to StatSection and each
+  // StatRow (whose own defaults are the well's, see wellSurface.ts) - for a caller with its own chrome palette.
+  fg?: string
+  fgMuted?: string
+  sectionBg?: string
 }
 
 // The "ACTIVITY" StatSection (Days Played / Day Streak / Best Day Streak) - extracted verbatim
@@ -18,12 +23,12 @@ interface Props {
 // currentDayStreak/bestDayStreak) rather than importing DayStreakState itself, so this component
 // has no dependency on @tastic/achievements at all: any caller's own stats/statsView object that
 // happens to carry these three fields already satisfies it structurally.
-export function ActivityStatSection({ stats }: Props) {
+export function ActivityStatSection({ stats, fg, fgMuted, sectionBg }: Props) {
   return (
-    <StatSection label='ACTIVITY'>
-      <StatRow label='Days Played' value={String(stats.distinctDaysPlayed)} />
-      <StatRow label='Day Streak' value={String(stats.currentDayStreak)} />
-      <StatRow label='Best Day Streak' value={String(stats.bestDayStreak)} />
+    <StatSection label='ACTIVITY' fg={fg} sectionBg={sectionBg}>
+      <StatRow label='Days Played' value={String(stats.distinctDaysPlayed)} fg={fg} fgMuted={fgMuted} />
+      <StatRow label='Day Streak' value={String(stats.currentDayStreak)} fg={fg} fgMuted={fgMuted} />
+      <StatRow label='Best Day Streak' value={String(stats.bestDayStreak)} fg={fg} fgMuted={fgMuted} />
     </StatSection>
   )
 }

package/src/StatRow.tsx

@@ -1,29 +1,28 @@
-import { useAutoPaperTheme } from '@rific/auto-paper'
 import { StyleSheet, View } from 'react-native'
 import { Text } from 'react-native-paper'
 
+import { useWellColors } from './wellSurface'
+
 interface Props {
   label: string
   value: string
-  // Independently optional overrides for this row's own text colors - default to the same
-  // useAutoPaperTheme()-derived formula as BaseStatsScreen (see that component's own doc for why)
-  // when omitted, so every existing caller renders identically to before.
+  // Independently optional overrides for this row's own text colors - default to the text colors of the well it
+  // sits in (wellSurface.ts: onSurface, onSurfaceVariant).
   fg?: string
   fgMuted?: string
 }
 
 // A single labeled stat - label on the left (muted), value on the right (bold, full-contrast).
 // Extracted from LightCycles' own achievements.tsx, where this exact row shape backed every
-// section (Overall/Vs CPU/Two Player/Activity). fg/fgMuted default to the same
-// useAutoPaperTheme()-derived formula as BaseStatsScreen (see that component's own doc for why),
-// each independently overridable via the matching prop for a caller with its own chrome palette.
+// section (Overall/Vs CPU/Two Player/Activity). fg/fgMuted default to the text colors of the StatSection well it
+// sits in, each independently overridable via the matching prop for a caller with its own chrome palette.
 // Deliberately just label+value text, not a color swatch or profile chip - an app needing a row
-// with a leading visual builds its own on top of this same dark-mode formula (see LightCycles' own
+// with a leading visual builds its own on top of the same useWellColors() (see LightCycles' own
 // ColorStatRow/ProfileRankingRow for an example), since what that visual even is varies per game.
 export function StatRow({ label, value, fg: fgOverride, fgMuted: fgMutedOverride }: Props) {
-  const { dark } = useAutoPaperTheme()
-  const fg = fgOverride ?? (dark ? '#FFFFFF' : '#000000')
-  const fgMuted = fgMutedOverride ?? (dark ? 'rgba(255,255,255,0.5)' : 'rgba(0,0,0,0.5)')
+  const well = useWellColors()
+  const fg = fgOverride ?? well.fg
+  const fgMuted = fgMutedOverride ?? well.fgMuted
 
   return (
     <View style={styles.row}>

package/src/StatSection.tsx

@@ -1,29 +1,28 @@
-import { useAutoPaperTheme } from '@rific/auto-paper'
 import { ReactNode } from 'react'
 import { StyleSheet, View } from 'react-native'
 import { Text } from 'react-native-paper'
 
+import { useWellColors, WELL_SHADOW } from './wellSurface'
+
 interface Props {
   label: string
-  // Independently optional overrides for this section's own label color/background - default to
-  // the same useAutoPaperTheme()-derived formula as StatRow/BaseStatsScreen (see BaseStatsScreen's
-  // own doc for why) when omitted, so every existing caller renders identically to before.
+  // Independently optional overrides for this section's own label color/background - default to the well's
+  // (wellSurface.ts: the theme's surface and its onSurface text).
   fg?: string
   sectionBg?: string
   children: ReactNode
 }
 
-// A labeled, tinted-background grouping box - the "OVERALL"/"VS CPU"/"ACTIVITY"-style section
-// shape from LightCycles' own achievements.tsx, generalized to any content (typically a stack of
-// StatRow). fg/sectionBg default to the same useAutoPaperTheme()-derived formula as
-// StatRow/BaseStatsScreen (see BaseStatsScreen's own doc for why), each independently overridable
-// via the matching prop for a caller with its own chrome palette. The label itself carries the
-// section's own meaning (what it's a section OF), so this component has no opinion on that beyond
-// rendering the string it's given.
+// A labeled grouping box, a well (wellSurface.ts: the theme's surface on MD3's level-1 shadow) - the
+// "OVERALL"/"VS CPU"/"ACTIVITY"-style section shape from LightCycles' own achievements.tsx, generalized to any
+// content (typically a stack of StatRow). fg/sectionBg default to the well's colors, each independently
+// overridable via the matching prop for a caller with its own chrome palette. It was a faint tint until
+// 2026-10-17 (6% white in dark mode, 4% black in light). The label itself carries the section's own meaning
+// (what it's a section OF), so this component has no opinion on that beyond rendering the string it's given.
 export function StatSection({ label, fg: fgOverride, sectionBg: sectionBgOverride, children }: Props) {
-  const { dark } = useAutoPaperTheme()
-  const fg = fgOverride ?? (dark ? '#FFFFFF' : '#000000')
-  const sectionBg = sectionBgOverride ?? (dark ? 'rgba(255,255,255,0.06)' : 'rgba(0,0,0,0.04)')
+  const well = useWellColors()
+  const fg = fgOverride ?? well.fg
+  const sectionBg = sectionBgOverride ?? well.bg
 
   return (
     <View style={[styles.section, { backgroundColor: sectionBg }]}>
@@ -46,6 +45,7 @@ const styles = StyleSheet.create({
   },
   section: {
     borderRadius: 12,
+    boxShadow: WELL_SHADOW,
     gap: 8,
     padding: 16
   }

package/src/chrome/index.ts

@@ -23,3 +23,4 @@ export { StatRow } from '../StatRow'
 export { StatSection } from '../StatSection'
 export { UpdateDialog, type UpdateDialogProps } from '../UpdateDialog'
 export { useCompactDialog } from '../useCompactDialog'
+export { useWellColors, WELL_SHADOW, type WellColors } from '../wellSurface'