@wireai/activation 0.14.1 → 0.14.2

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 All notable changes to `@wireai/activation` (formerly `wireai-onboarding`).
 Historical entries below the rename keep the old package name on purpose.
 
+## [0.14.2] - 2026-08-18
+
+**PATCH: no public surface gained, lost or renamed a member.** `SpotlightOverlay` keeps its props
+and its export; `expo-blur` stays an OPTIONAL peer.
+
+### Fixed
+
+- **The coachmarks subpath no longer force-imports its optional peer `expo-blur`.**
+  `SpotlightOverlay` did `import { BlurView } from "expo-blur"` at module scope and built its
+  animated blur component at module load, and `coachmarks/index.ts` re-exports the overlay with no
+  wildcard escape — so importing ANYTHING from `@wireai/activation/coachmarks`, even
+  `setCoachmarkStorage`, dragged `expo-blur` in. A host that took the peer's "optional" at its word
+  and skipped installing it hit a Metro resolution failure the moment it touched coachmarks, which
+  is why the AI Mobile Launcher tiers (and any Expo Go build) could not adopt the capability. The
+  peer is now resolved through a guarded lazy require with a string-literal specifier inside a
+  try/catch (the same shape as `icons/expoIcons.ts` / `device/appVersion.ts`), and the animated
+  component is built once on first render, so the subpath carries no static top-level import of the
+  peer.
+  - **Degradation, by design:** when `expo-blur` is absent the spotlight drops the frost to an
+    equivalent dimmed scrim. The ring, tooltip and gestures behave identically — a missing
+    decorative frost never blanks a tour, never crashes, never renders empty.
+  - `metro/index.js` `OPTIONAL_MODULES` and `tsup.config.ts` now treat `expo-blur` as a guarded
+    optional peer (moved off the static-peer list), so the built `dist/` collects it as optional and
+    the metro helper's empty-module safety net covers it for hosts that disable Metro's
+    `allowOptionalDependencies`.
+
 ## [0.14.1] - 2026-08-18
 
 Two rulings from the 0.14.0 audit, applied. Both were reproduced there and left for a decision

package/dist/coachmarks/index.js

@@ -2,7 +2,6 @@
 
 var React3 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
-var expoBlur = require('expo-blur');
 var reactNative = require('react-native');
 var Animated = require('react-native-reanimated');
 
@@ -11,7 +10,12 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var React3__default = /*#__PURE__*/_interopDefault(React3);
 var Animated__default = /*#__PURE__*/_interopDefault(Animated);
 
-// src/coachmarks/CoachmarkProvider.tsx
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 
 // src/features/defaults.ts
 var defaultWireFeatures = Object.freeze({
@@ -90,8 +94,8 @@ var DEFAULT_TIMEOUT_MS = 4e3;
 var failOpen = async (storage, key) => {
   var _a;
   if (!storage) return defaultWireFeatures;
-  const cached = await readCachedFeatures(storage, key);
-  return (_a = cached == null ? void 0 : cached.features) != null ? _a : defaultWireFeatures;
+  const cached2 = await readCachedFeatures(storage, key);
+  return (_a = cached2 == null ? void 0 : cached2.features) != null ? _a : defaultWireFeatures;
 };
 var fetchWithTimeout = async (url, apiKey, timeoutMs) => {
   const controller = typeof AbortController !== "undefined" ? new AbortController() : void 0;
@@ -329,6 +333,47 @@ var useOnboardingTheme = () => {
   const ctx = React3.useContext(OnboardingThemeContext);
   return ctx != null ? ctx : mergeTheme();
 };
+
+// src/coachmarks/expoBlur.ts
+var runtimeRequire = (moduleName) => {
+  if (moduleName !== "expo-blur") return void 0;
+  if (typeof __require !== "function") return void 0;
+  try {
+    return require("expo-blur");
+  } catch {
+    return void 0;
+  }
+};
+var interop = (mod) => {
+  if (!mod || typeof mod !== "object") return void 0;
+  const ns = mod;
+  if (ns.BlurView) return ns;
+  const def = mod.default;
+  if (def && typeof def === "object") return def;
+  return ns;
+};
+var asComponent = (value) => {
+  if (typeof value === "function") return value;
+  if (value && typeof value === "object" && "$$typeof" in value) {
+    return value;
+  }
+  return void 0;
+};
+var cached;
+var resolveBlurView = (requireModule = runtimeRequire) => {
+  try {
+    if (cached === void 0 || requireModule !== runtimeRequire) {
+      const resolved = interop(requireModule("expo-blur"));
+      const component = resolved ? asComponent(resolved.BlurView) : void 0;
+      if (requireModule === runtimeRequire) cached = component != null ? component : null;
+      return component;
+    }
+    if (cached === null) return void 0;
+    return cached;
+  } catch {
+    return void 0;
+  }
+};
 var SWIPE_MS = 700;
 var TAP_MS = 320;
 var SPREAD_MS = 620;
@@ -543,7 +588,6 @@ var styles = reactNative.StyleSheet.create({
 });
 var GestureHint = React3__default.default.memo(GestureHintComponent);
 GestureHint.displayName = "GestureHint";
-var AnimatedBlurView = Animated__default.default.createAnimatedComponent(expoBlur.BlurView);
 var BLUR_INTENSITY = 26;
 var FADE_MS = 280;
 var RING_PADDING = 10;
@@ -565,6 +609,10 @@ var SpotlightOverlayComponent = ({
   const theme = useOnboardingTheme();
   const accent = accentColor != null ? accentColor : theme.colors.primary;
   const accentText = accentTextColor != null ? accentTextColor : theme.colors.onPrimary;
+  const AnimatedBlurView = React3.useMemo(() => {
+    const BlurView = resolveBlurView();
+    return BlurView ? Animated__default.default.createAnimatedComponent(BlurView) : null;
+  }, []);
   const showGesture = gesture !== "none" && gesture !== "tap" && gesture !== "double_tap";
   const intensity = Animated.useSharedValue(0);
   const ringScale = Animated.useSharedValue(1);
@@ -613,13 +661,23 @@ var SpotlightOverlayComponent = ({
       entering: Animated.FadeIn.duration(FADE_MS),
       exiting: Animated.FadeOut.duration(FADE_MS),
       children: [
-        /* @__PURE__ */ jsxRuntime.jsx(
+        AnimatedBlurView ? /* @__PURE__ */ jsxRuntime.jsx(
           AnimatedBlurView,
           {
             tint: "dark",
             animatedProps: blurAnimatedProps,
             style: reactNative.StyleSheet.absoluteFill
           }
+        ) : (
+          // `expo-blur` absent → a plain dimmed scrim stands in for the frost. Same dark backdrop
+          // the tour reads against, so the ring, tooltip and gestures behave identically.
+          /* @__PURE__ */ jsxRuntime.jsx(
+            Animated__default.default.View,
+            {
+              style: [reactNative.StyleSheet.absoluteFill, styles2.scrim],
+              pointerEvents: "none"
+            }
+          )
         ),
         /* @__PURE__ */ jsxRuntime.jsx(
           reactNative.Pressable,
@@ -686,6 +744,11 @@ var styles2 = reactNative.StyleSheet.create({
     zIndex: 9999,
     elevation: 9999
   },
+  // Fallback backdrop when `expo-blur` is absent. A structural dim (not a brand token), tuned to
+  // read like the dark blur at BLUR_INTENSITY so the ring + tooltip keep the same contrast.
+  scrim: {
+    backgroundColor: "rgba(0, 0, 0, 0.55)"
+  },
   ring: {
     position: "absolute",
     borderWidth: 2.5,