flowboard-react 0.3.0 → 0.4.1

package/README.md

@@ -74,6 +74,17 @@ await Flowboard.launchOnboarding({
 });
 ```
 
+Launch a specific onboarding by ID (without replacing default cached onboarding used by `launchOnboarding`):
+
+```tsx
+await Flowboard.launchOnboardingById('YOUR_ONBOARDING_ID', {
+  locale: 'fr_FR',
+  onOnboardEnd: (formData) => {
+    console.log('Specific flow completed:', formData);
+  },
+});
+```
+
 Re-initialize:
 
 ```tsx
@@ -84,6 +95,7 @@ await Flowboard.reinit();
 
 - `Flowboard.init({ appId, bundleId, debug, enableAnalytics })`
 - `Flowboard.launchOnboarding({ customScreenBuilder, customActionBuilder, onOnboardEnd, onStepChange, enableAnalytics, alwaysRestart, resumeProgress })`
+- `Flowboard.launchOnboardingById(onboardingId, { locale, customScreenBuilder, customActionBuilder, onOnboardEnd, onStepChange, enableAnalytics, alwaysRestart, resumeProgress })`
 - `Flowboard.reinit()`
 - `FlowboardProvider` (required to host modal flow)
 

package/lib/module/Flowboard.js

@@ -44,15 +44,7 @@ export class Flowboard {
     if (!Flowboard.appId) {
       throw new Error('Flowboard.init() must be called before launchOnboarding');
     }
-    try {
-      const context = AnalyticsManager.instance.clientContextSnapshot ?? (await ClientContext.create());
-      AnalyticsManager.instance.configure({
-        enabled: options.enableAnalytics ?? true,
-        context
-      });
-    } catch (error) {
-      Flowboard.log(`Failed to configure analytics for launch: ${String(error)}`);
-    }
+    await Flowboard.configureAnalyticsForLaunch(options.enableAnalytics);
     let data = await Flowboard.repository.getOnboardingJson();
     if (!data) {
       Flowboard.log('Data not in cache. Waiting for initialization...');
@@ -80,6 +72,33 @@ export class Flowboard {
       Flowboard.log('Failed to launch: Data is null.');
       return;
     }
+    await Flowboard.launchResolvedOnboarding(data, options);
+  }
+  static async launchOnboardingById(onboardingId, options = {}) {
+    Flowboard.log(`Attempting to launch onboarding by id: ${onboardingId}`);
+    if (!Flowboard.appId) {
+      throw new Error('Flowboard.init() must be called before launchOnboardingById');
+    }
+    const normalizedOnboardingId = onboardingId.trim();
+    if (!normalizedOnboardingId) {
+      throw new Error('onboardingId must be a non-empty string');
+    }
+    await Flowboard.configureAnalyticsForLaunch(options.enableAnalytics);
+    const locale = await Flowboard.resolveLocale(options.locale);
+    let data;
+    try {
+      data = await Flowboard.service.fetchOnboardingById({
+        onboardingId: normalizedOnboardingId,
+        locale
+      });
+    } catch (error) {
+      Flowboard.log(`Failed to load onboarding by id: ${String(error)}`);
+      Alert.alert('Failed to load onboarding', String(error));
+      return;
+    }
+    await Flowboard.launchResolvedOnboarding(data, options);
+  }
+  static async launchResolvedOnboarding(data, options) {
     const shouldResumeProgress = options.resumeProgress === true && options.alwaysRestart !== true;
     if (options.alwaysRestart || !shouldResumeProgress) {
       await Flowboard.repository.clearProgress();
@@ -113,6 +132,25 @@ export class Flowboard {
       initialFormData
     });
   }
+  static async configureAnalyticsForLaunch(enableAnalytics) {
+    try {
+      const context = AnalyticsManager.instance.clientContextSnapshot ?? (await ClientContext.create());
+      AnalyticsManager.instance.configure({
+        enabled: enableAnalytics ?? true,
+        context
+      });
+    } catch (error) {
+      Flowboard.log(`Failed to configure analytics for launch: ${String(error)}`);
+    }
+  }
+  static async resolveLocale(requestedLocale) {
+    const normalized = requestedLocale?.trim();
+    if (normalized) {
+      return normalized;
+    }
+    const context = AnalyticsManager.instance.clientContextSnapshot ?? (await ClientContext.create());
+    return context.locale || 'en_US';
+  }
   static async initialize() {
     Flowboard.log('Checking local cache...');
     const cached = await Flowboard.repository.getOnboardingJson();

package/lib/module/Flowboard.js.map

@@ -1 +1 @@
-{"version":3,"names":["Alert","ClientContext","ResolverService","OnboardingRepository","AnalyticsManager","Flowboard","appId","bundleId","debug","repository","service","initPromise","listeners","Set","subscribe","listener","add","delete","init","params","log","clientContext","create","instance","configure","enabled","enableAnalytics","context","error","String","initialize","reinit","clearLocalCaches","fetchAndSave","launchOnboarding","options","Error","clientContextSnapshot","data","getOnboardingJson","alert","shouldResumeProgress","resumeProgress","alwaysRestart","clearProgress","initialStep","initialFormData","flowId","flow_id","savedStep","getProgressStepForFlow","savedFormData","getProgressFormDataForFlow","undefined","screens","Array","isArray","length","maxIndex","Object","keys","emitLaunch","cached","startSession","flowData","startTime","Date","now","installId","json","fetchOnboardingJson","saveOnboardingJson","duration","trackOnboardLoaded","durationMs","Promise","all","clearOnboardingJson","payload","forEach","message","console"],"sourceRoot":"../../src","sources":["Flowboard.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Alert","ClientContext","ResolverService","OnboardingRepository","AnalyticsManager","Flowboard","appId","bundleId","debug","repository","service","initPromise","listeners","Set","subscribe","listener","add","delete","init","params","log","clientContext","create","instance","configure","enabled","enableAnalytics","context","error","String","initialize","reinit","clearLocalCaches","fetchAndSave","launchOnboarding","options","Error","configureAnalyticsForLaunch","data","getOnboardingJson","alert","launchResolvedOnboarding","launchOnboardingById","onboardingId","normalizedOnboardingId","trim","locale","resolveLocale","fetchOnboardingById","shouldResumeProgress","resumeProgress","alwaysRestart","clearProgress","initialStep","initialFormData","flowId","flow_id","savedStep","getProgressStepForFlow","savedFormData","getProgressFormDataForFlow","undefined","screens","Array","isArray","length","maxIndex","Object","keys","emitLaunch","clientContextSnapshot","requestedLocale","normalized","cached","startSession","flowData","startTime","Date","now","installId","json","fetchOnboardingJson","saveOnboardingJson","duration","trackOnboardLoaded","durationMs","Promise","all","clearOnboardingJson","payload","forEach","message","console"],"sourceRoot":"../../src","sources":["Flowboard.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/components/FlowboardRenderer.js

@@ -1385,6 +1385,9 @@ function WheelPicker({
     formData,
     itemTemplate
   }), [formData, itemTemplate, options, properties]);
+  const wheelScrollY = React.useRef(new Animated.Value(0)).current;
+  const wheelScrollRef = React.useRef(null);
+  const lastCommittedWheelValue = React.useRef(null);
   const toggleSelection = value => {
     setSelectedValues(prev => {
       let next = [...prev];
@@ -1409,6 +1412,53 @@ function WheelPicker({
   };
   const layout = properties.layout ?? 'wheel';
   const spacing = Number(properties.spacing ?? 8);
+  const wheelItemHeight = Math.max(1, Number(properties.wheelItemHeight ?? 48));
+  const requestedVisible = Math.max(3, Math.floor(Number(properties.visibleItems ?? 5)));
+  const visibleItems = requestedVisible % 2 === 0 ? requestedVisible + 1 : requestedVisible;
+  const wheelRowStride = wheelItemHeight + Math.max(0, spacing);
+  const wheelContainerHeight = wheelItemHeight * visibleItems;
+  const clampWheelIndex = React.useCallback(index => Math.max(0, Math.min(index, Math.max(0, resolvedOptions.length - 1))), [resolvedOptions.length]);
+  const getWheelSelectedIndex = React.useCallback(() => {
+    if (resolvedOptions.length === 0) return 0;
+    const targetValue = selectedValues[0];
+    if (targetValue === undefined) return 0;
+    const found = resolvedOptions.findIndex(option => String(option.value ?? '') === String(targetValue));
+    return found >= 0 ? found : 0;
+  }, [resolvedOptions, selectedValues]);
+  const commitWheelSelection = React.useCallback(index => {
+    const safeIndex = clampWheelIndex(index);
+    const selectedOption = resolvedOptions[safeIndex];
+    if (!selectedOption) return;
+    const value = String(selectedOption.value ?? '');
+    if (!value) return;
+    setSelectedValues(prev => {
+      if (prev.length === 1 && prev[0] === value) {
+        return prev;
+      }
+      return [value];
+    });
+    if (lastCommittedWheelValue.current !== value) {
+      lastCommittedWheelValue.current = value;
+      onChanged(value);
+      if (properties.autoGoNext === true) {
+        requestAnimationFrame(() => onAction('next', {
+          selectedValue: value
+        }));
+      }
+    }
+  }, [clampWheelIndex, onAction, onChanged, properties.autoGoNext, resolvedOptions]);
+  React.useEffect(() => {
+    if (layout !== 'wheel' || resolvedOptions.length === 0) return;
+    const selectedIndex = getWheelSelectedIndex();
+    const offsetY = selectedIndex * wheelRowStride;
+    requestAnimationFrame(() => {
+      wheelScrollRef.current?.scrollTo({
+        y: offsetY,
+        animated: false
+      });
+      wheelScrollY.setValue(offsetY);
+    });
+  }, [getWheelSelectedIndex, layout, resolvedOptions.length, wheelRowStride, wheelScrollY]);
   const renderItem = (option, index) => {
     const value = String(option.value ?? '');
     const isSelected = selectedValues.includes(value);
@@ -1471,29 +1521,130 @@ function WheelPicker({
     });
   }
   if (layout === 'wheel') {
-    const itemHeight = Math.max(1, Number(properties.wheelItemHeight ?? 48));
-    const requestedVisible = Math.max(3, Math.floor(Number(properties.visibleItems ?? 5)));
-    const visibleItems = requestedVisible % 2 === 0 ? requestedVisible + 1 : requestedVisible;
-    const containerHeight = itemHeight * visibleItems;
-    const centerPadding = Math.max(0, (containerHeight - itemHeight) / 2);
-    return /*#__PURE__*/_jsx(View, {
+    const centerPadding = Math.max(0, (wheelContainerHeight - wheelRowStride) / 2);
+    const centerLineTop = (wheelContainerHeight - wheelItemHeight) / 2;
+    const baseUnselectedStyle = properties.unselectedStyle ?? properties.selectedStyle ?? {};
+    const overlayBorderColor = parseColor(properties.wheelCenterBorderColor ?? properties.wheelSelectedBorderColor ?? baseUnselectedStyle.borderColor ?? '#D6D6DC');
+    const overlayBackgroundColor = parseColor(properties.wheelCenterBackgroundColor ?? '#24FFFFFF');
+    const handleWheelMomentumEnd = event => {
+      const offsetY = Number(event?.nativeEvent?.contentOffset?.y ?? 0);
+      const settledIndex = clampWheelIndex(Math.round(offsetY / wheelRowStride));
+      const targetOffset = settledIndex * wheelRowStride;
+      if (Math.abs(targetOffset - offsetY) > 0.5) {
+        wheelScrollRef.current?.scrollTo({
+          y: targetOffset,
+          animated: true
+        });
+      }
+      commitWheelSelection(settledIndex);
+    };
+    return /*#__PURE__*/_jsxs(View, {
       style: {
-        height: containerHeight
+        height: wheelContainerHeight,
+        overflow: 'hidden'
       },
-      children: /*#__PURE__*/_jsx(ScrollView, {
+      children: [/*#__PURE__*/_jsx(Animated.ScrollView, {
+        ref: wheelScrollRef,
         showsVerticalScrollIndicator: false,
+        bounces: false,
+        decelerationRate: "fast",
+        snapToInterval: wheelRowStride,
+        snapToAlignment: "start",
+        disableIntervalMomentum: false,
+        onMomentumScrollEnd: handleWheelMomentumEnd,
         contentContainerStyle: {
           paddingVertical: centerPadding
         },
-        children: resolvedOptions.map((option, index) => /*#__PURE__*/_jsx(View, {
-          style: {
-            minHeight: itemHeight,
-            justifyContent: 'center',
-            marginBottom: spacing > 0 && index < resolvedOptions.length - 1 ? spacing : 0
-          },
-          children: renderItem(option, index)
-        }, `wheel-column-option-${index}`))
-      })
+        onScroll: Animated.event([{
+          nativeEvent: {
+            contentOffset: {
+              y: wheelScrollY
+            }
+          }
+        }], {
+          useNativeDriver: true
+        }),
+        scrollEventThrottle: 16,
+        children: resolvedOptions.map((option, index) => {
+          const inputRange = [(index - 2) * wheelRowStride, (index - 1) * wheelRowStride, index * wheelRowStride, (index + 1) * wheelRowStride, (index + 2) * wheelRowStride];
+          const opacity = wheelScrollY.interpolate({
+            inputRange,
+            outputRange: [0.35, 0.6, 1, 0.6, 0.35],
+            extrapolate: 'clamp'
+          });
+          const scale = wheelScrollY.interpolate({
+            inputRange,
+            outputRange: [0.82, 0.91, 1, 0.91, 0.82],
+            extrapolate: 'clamp'
+          });
+          const rotateX = wheelScrollY.interpolate({
+            inputRange,
+            outputRange: ['55deg', '28deg', '0deg', '-28deg', '-55deg'],
+            extrapolate: 'clamp'
+          });
+          const translateY = wheelScrollY.interpolate({
+            inputRange,
+            outputRange: [-10, -4, 0, 4, 10],
+            extrapolate: 'clamp'
+          });
+          return /*#__PURE__*/_jsx(Animated.View, {
+            style: {
+              height: wheelRowStride,
+              justifyContent: 'center',
+              opacity,
+              transform: [{
+                perspective: 1200
+              }, {
+                translateY
+              }, {
+                rotateX
+              }, {
+                scale
+              }]
+            },
+            children: /*#__PURE__*/_jsx(View, {
+              style: {
+                minHeight: wheelItemHeight,
+                justifyContent: 'center'
+              },
+              children: renderItem(option, index)
+            })
+          }, `wheel-column-option-${index}`);
+        })
+      }), /*#__PURE__*/_jsx(View, {
+        pointerEvents: "none",
+        style: {
+          position: 'absolute',
+          left: 0,
+          right: 0,
+          top: centerLineTop,
+          height: wheelItemHeight,
+          borderRadius: 14,
+          borderWidth: 1,
+          borderColor: overlayBorderColor,
+          backgroundColor: overlayBackgroundColor
+        }
+      }), /*#__PURE__*/_jsx(LinearGradient, {
+        pointerEvents: "none",
+        colors: ['rgba(255,255,255,0.92)', 'rgba(255,255,255,0)'],
+        style: {
+          position: 'absolute',
+          top: 0,
+          left: 0,
+          right: 0,
+          height: centerPadding
+        }
+      }), /*#__PURE__*/_jsx(LinearGradient, {
+        pointerEvents: "none",
+        colors: ['rgba(255,255,255,0)', 'rgba(255,255,255,0.92)'],
+        style: {
+          position: 'absolute',
+          bottom: 0,
+          left: 0,
+          right: 0,
+          height: centerPadding
+        }
+      })]
     });
   }
   return /*#__PURE__*/_jsx(View, {