catalyst-core 0.2.0-beta.3 → 0.3.0-beta.1

package/dist/native/bridge/hooks/useHapticFeedback.js

@@ -1 +1,196 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useHapticFeedback=exports.requestHapticFeedback=void 0;var _react=require("react");var _NativeBridge=_interopRequireDefault(require("../utils/NativeBridge.js"));var _NativeInterfaces=require("../constants/NativeInterfaces.js");var _useBaseHook=require("../useBaseHook.js");var _errors=require("../errors.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */const requestHapticFeedback=(feedbackType="light")=>{if(typeof window==="undefined"){return Promise.resolve(null);}if(!window.WebBridge){throw new Error("WebBridge is not initialized. Call WebBridge.init() first.");}return new Promise((resolve,reject)=>{try{if(!_NativeBridge.default.isAvailable()){reject(new Error("Native bridge not available"));return;}const handleHapticResponse=data=>{window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.HAPTIC_FEEDBACK);if(data===_NativeInterfaces.RESPONSE_STATUS.SUCCESS){resolve(data);}else{reject(new Error(`Haptic feedback failed: ${data}`));}};window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.HAPTIC_FEEDBACK,handleHapticResponse);_NativeBridge.default.haptic.feedback(feedbackType);console.log("📳 Haptic feedback requested:",feedbackType);}catch(error){reject(error);}});};exports.requestHapticFeedback=requestHapticFeedback;const detectHapticCapabilities=isNative=>{const userAgent=typeof navigator!=="undefined"?navigator.userAgent.toLowerCase():"";if(isNative){const platform=userAgent.includes("android")?"android":userAgent.includes("iphone")||userAgent.includes("ipad")?"ios":"native";const availableTypes=platform==="ios"?["light","medium","heavy","success","warning","error","selection","impact"]:["light","medium","heavy"];return{isSupported:true,availableTypes,platform};}const isSupported=typeof navigator!=="undefined"&&"vibrate"in navigator;return{isSupported,availableTypes:isSupported?["light","medium","heavy"]:[],platform:"web"};};const useHapticFeedback=({webFallback}={})=>{const base=(0,_useBaseHook.useBaseHook)("useHapticFeedback",{hasWebFallback:true,webFallback});const[capabilities,setCapabilities]=(0,_react.useState)(()=>detectHapticCapabilities(base.isNative));if(base.webFallbackDisabled){return{data:null,loading:false,progress:null,error:null,isWeb:true,isNative:false,webFallbackActive:false,webFallbackDisabled:true,setWebFallback:base.setWebFallback,execute:()=>{},clear:()=>{},clearError:()=>{},triggerHaptic:()=>{},trigger:()=>{},light:()=>{},medium:()=>{},heavy:()=>{},success:()=>{},warning:()=>{},errorHaptic:()=>{},selection:()=>{},impact:()=>{},capabilities:{isSupported:false,availableTypes:[],platform:"web"},isSupported:false,isAvailable:false,availableTypes:[],HAPTIC_TYPES:{}};}const HAPTIC_TYPES={LIGHT:"light",MEDIUM:"medium",HEAVY:"heavy",SUCCESS:"success",WARNING:"warning",ERROR:"error",SELECTION:"selection",IMPACT:"impact"};(0,_react.useEffect)(()=>{setCapabilities(detectHapticCapabilities(base.isNative));},[base.isNative]);const handleWebHaptic=type=>{if(!navigator.vibrate)return false;const vibrationPatterns={[HAPTIC_TYPES.LIGHT]:[50],[HAPTIC_TYPES.MEDIUM]:[100],[HAPTIC_TYPES.HEAVY]:[200],[HAPTIC_TYPES.SUCCESS]:[100,50,100],[HAPTIC_TYPES.WARNING]:[200,100,200],[HAPTIC_TYPES.ERROR]:[300,100,300,100,300],[HAPTIC_TYPES.SELECTION]:[25],[HAPTIC_TYPES.IMPACT]:[150]};navigator.vibrate(vibrationPatterns[type]||[100]);return true;};const handleHapticTrigger=async(type,options={})=>{try{base.setLoading(true);base.updateProgress({state:"active",phase:"triggering",message:`Triggering ${type} haptic feedback...`});const success=base.isNative?await requestHapticFeedback(type):handleWebHaptic(type,options);base.setDataAndComplete({lastType:type,lastOptions:options,timestamp:new Date().toISOString(),success,capabilities,lastOperation:"trigger",operationSuccess:success});return success;}catch(error){console.error("📳 Haptic feedback failed:",error);base.handleNativeError(error);return false;}};const executeHaptic=(type="light",options={})=>{if(!capabilities.isSupported){base.handleNativeError((0,_errors.createStandardError)(_errors.ERROR_CODES.FEATURE_UNSUPPORTED,"Haptic feedback not supported",null,"Device does not support haptic feedback"));return;}return handleHapticTrigger(type,options);};return{data:base.data,loading:base.loading,progress:base.progress,error:base.error,isWeb:base.isWeb,isNative:base.isNative,webFallbackActive:base.webFallbackActive,webFallbackDisabled:false,setWebFallback:base.setWebFallback,clear:base.clear,clearError:base.clearError,execute:executeHaptic,triggerHaptic:executeHaptic,trigger:executeHaptic,light:()=>executeHaptic(HAPTIC_TYPES.LIGHT),medium:()=>executeHaptic(HAPTIC_TYPES.MEDIUM),heavy:()=>executeHaptic(HAPTIC_TYPES.HEAVY),success:()=>executeHaptic(HAPTIC_TYPES.SUCCESS),warning:()=>executeHaptic(HAPTIC_TYPES.WARNING),errorHaptic:()=>executeHaptic(HAPTIC_TYPES.ERROR),selection:()=>executeHaptic(HAPTIC_TYPES.SELECTION),impact:()=>executeHaptic(HAPTIC_TYPES.IMPACT),capabilities,isSupported:capabilities.isSupported,isAvailable:capabilities.isSupported,availableTypes:capabilities.availableTypes,HAPTIC_TYPES};};exports.useHapticFeedback=useHapticFeedback;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useHapticFeedback = exports.requestHapticFeedback = void 0;
+var _react = require("react");
+var _NativeBridge = _interopRequireDefault(require("../utils/NativeBridge.js"));
+var _NativeInterfaces = require("../constants/NativeInterfaces.js");
+var _useBaseHook = require("../useBaseHook.js");
+var _errors = require("../errors.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */
+
+const requestHapticFeedback = (feedbackType = "light") => {
+  if (typeof window === "undefined") {
+    return Promise.resolve(null);
+  }
+  if (!window.WebBridge) {
+    throw new Error("WebBridge is not initialized. Call WebBridge.init() first.");
+  }
+  return new Promise((resolve, reject) => {
+    try {
+      if (!_NativeBridge.default.isAvailable()) {
+        reject(new Error("Native bridge not available"));
+        return;
+      }
+      const handleHapticResponse = data => {
+        window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.HAPTIC_FEEDBACK);
+        if (data === _NativeInterfaces.RESPONSE_STATUS.SUCCESS) {
+          resolve(data);
+        } else {
+          reject(new Error(`Haptic feedback failed: ${data}`));
+        }
+      };
+      window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.HAPTIC_FEEDBACK, handleHapticResponse);
+      _NativeBridge.default.haptic.feedback(feedbackType);
+      console.log("📳 Haptic feedback requested:", feedbackType);
+    } catch (error) {
+      reject(error);
+    }
+  });
+};
+exports.requestHapticFeedback = requestHapticFeedback;
+const detectHapticCapabilities = isNative => {
+  const userAgent = typeof navigator !== "undefined" ? navigator.userAgent.toLowerCase() : "";
+  if (isNative) {
+    const platform = userAgent.includes("android") ? "android" : userAgent.includes("iphone") || userAgent.includes("ipad") ? "ios" : "native";
+    const availableTypes = platform === "ios" ? ["light", "medium", "heavy", "success", "warning", "error", "selection", "impact"] : ["light", "medium", "heavy"];
+    return {
+      isSupported: true,
+      availableTypes,
+      platform
+    };
+  }
+  const isSupported = typeof navigator !== "undefined" && "vibrate" in navigator;
+  return {
+    isSupported,
+    availableTypes: isSupported ? ["light", "medium", "heavy"] : [],
+    platform: "web"
+  };
+};
+const useHapticFeedback = ({
+  webFallback
+} = {}) => {
+  const base = (0, _useBaseHook.useBaseHook)("useHapticFeedback", {
+    hasWebFallback: true,
+    webFallback
+  });
+  const [capabilities, setCapabilities] = (0, _react.useState)(() => detectHapticCapabilities(base.isNative));
+  if (base.webFallbackDisabled) {
+    return {
+      data: null,
+      loading: false,
+      progress: null,
+      error: null,
+      isWeb: true,
+      isNative: false,
+      webFallbackActive: false,
+      webFallbackDisabled: true,
+      setWebFallback: base.setWebFallback,
+      execute: () => {},
+      clear: () => {},
+      clearError: () => {},
+      triggerHaptic: () => {},
+      trigger: () => {},
+      light: () => {},
+      medium: () => {},
+      heavy: () => {},
+      success: () => {},
+      warning: () => {},
+      errorHaptic: () => {},
+      selection: () => {},
+      impact: () => {},
+      capabilities: {
+        isSupported: false,
+        availableTypes: [],
+        platform: "web"
+      },
+      isSupported: false,
+      isAvailable: false,
+      availableTypes: [],
+      HAPTIC_TYPES: {}
+    };
+  }
+  const HAPTIC_TYPES = {
+    LIGHT: "light",
+    MEDIUM: "medium",
+    HEAVY: "heavy",
+    SUCCESS: "success",
+    WARNING: "warning",
+    ERROR: "error",
+    SELECTION: "selection",
+    IMPACT: "impact"
+  };
+  (0, _react.useEffect)(() => {
+    setCapabilities(detectHapticCapabilities(base.isNative));
+  }, [base.isNative]);
+  const handleWebHaptic = type => {
+    if (!navigator.vibrate) return false;
+    const vibrationPatterns = {
+      [HAPTIC_TYPES.LIGHT]: [50],
+      [HAPTIC_TYPES.MEDIUM]: [100],
+      [HAPTIC_TYPES.HEAVY]: [200],
+      [HAPTIC_TYPES.SUCCESS]: [100, 50, 100],
+      [HAPTIC_TYPES.WARNING]: [200, 100, 200],
+      [HAPTIC_TYPES.ERROR]: [300, 100, 300, 100, 300],
+      [HAPTIC_TYPES.SELECTION]: [25],
+      [HAPTIC_TYPES.IMPACT]: [150]
+    };
+    navigator.vibrate(vibrationPatterns[type] || [100]);
+    return true;
+  };
+  const handleHapticTrigger = async (type, options = {}) => {
+    try {
+      base.setLoading(true);
+      base.updateProgress({
+        state: "active",
+        phase: "triggering",
+        message: `Triggering ${type} haptic feedback...`
+      });
+      const success = base.isNative ? await requestHapticFeedback(type) : handleWebHaptic(type, options);
+      base.setDataAndComplete({
+        lastType: type,
+        lastOptions: options,
+        timestamp: new Date().toISOString(),
+        success,
+        capabilities,
+        lastOperation: "trigger",
+        operationSuccess: success
+      });
+      return success;
+    } catch (error) {
+      console.error("📳 Haptic feedback failed:", error);
+      base.handleNativeError(error);
+      return false;
+    }
+  };
+  const executeHaptic = (type = "light", options = {}) => {
+    if (!capabilities.isSupported) {
+      base.handleNativeError((0, _errors.createStandardError)(_errors.ERROR_CODES.FEATURE_UNSUPPORTED, "Haptic feedback not supported", null, "Device does not support haptic feedback"));
+      return;
+    }
+    return handleHapticTrigger(type, options);
+  };
+  return {
+    data: base.data,
+    loading: base.loading,
+    progress: base.progress,
+    error: base.error,
+    isWeb: base.isWeb,
+    isNative: base.isNative,
+    webFallbackActive: base.webFallbackActive,
+    webFallbackDisabled: false,
+    setWebFallback: base.setWebFallback,
+    clear: base.clear,
+    clearError: base.clearError,
+    execute: executeHaptic,
+    triggerHaptic: executeHaptic,
+    trigger: executeHaptic,
+    light: () => executeHaptic(HAPTIC_TYPES.LIGHT),
+    medium: () => executeHaptic(HAPTIC_TYPES.MEDIUM),
+    heavy: () => executeHaptic(HAPTIC_TYPES.HEAVY),
+    success: () => executeHaptic(HAPTIC_TYPES.SUCCESS),
+    warning: () => executeHaptic(HAPTIC_TYPES.WARNING),
+    errorHaptic: () => executeHaptic(HAPTIC_TYPES.ERROR),
+    selection: () => executeHaptic(HAPTIC_TYPES.SELECTION),
+    impact: () => executeHaptic(HAPTIC_TYPES.IMPACT),
+    capabilities,
+    isSupported: capabilities.isSupported,
+    isAvailable: capabilities.isSupported,
+    availableTypes: capabilities.availableTypes,
+    HAPTIC_TYPES
+  };
+};
+exports.useHapticFeedback = useHapticFeedback;

package/dist/native/bridge/hooks/useIntent.js

@@ -1 +1,95 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useIntent=void 0;var _react=require("react");var _NativeBridge=_interopRequireDefault(require("../utils/NativeBridge.js"));var _NativeInterfaces=require("../constants/NativeInterfaces.js");var _useBaseHook=require("../useBaseHook.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */const useIntent=()=>{const base=(0,_useBaseHook.useBaseHook)("useIntent");if(typeof window==="undefined"){return{data:null,loading:false,progress:null,error:null,isWeb:true,isNative:false,execute:()=>{},clear:()=>{},clearError:()=>{},isLoading:false,processingState:null,openFile:()=>{},success:null,reset:()=>{}};}if(!window.WebBridge){throw new Error("WebBridge is not initialized. Call WebBridge.init() first.");}(0,_react.useEffect)(()=>{window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_SUCCESS,data=>{console.log("📄 Intent completed successfully:",data);base.setDataAndComplete({result:data,success:true});});window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_ERROR,data=>{console.error("📄 Intent error:",data);base.handleNativeError(data);});window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_CANCELLED,data=>{console.log("📄 Intent cancelled:",data);base.setLoading(false);base.resetProgress();});return()=>{window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_SUCCESS);window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_ERROR);window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_CANCELLED);};},[base.setDataAndComplete,base.handleNativeError,base.setLoading,base.resetProgress]);const openFile=(fileUrl,mimeType=null)=>{if(!fileUrl){base.handleNativeError("File URL is required");return;}console.log("📄 File open with intent requested:",{fileUrl,mimeType});base.executeOperation(()=>{base.updateProgress({state:"opening_file",phase:"processing",message:"Opening file with external app..."});_NativeBridge.default.file.openWithIntent(fileUrl,mimeType);},"intent file open");};return{data:base.data,loading:base.loading,progress:base.progress,error:base.error,isWeb:base.isWeb,isNative:base.isNative,execute:openFile,clear:base.clear,clearError:base.clearError,isLoading:base.loading,processingState:base.progress?.phase||null,openFile,success:base.data?.success||null,reset:base.clear};};exports.useIntent=useIntent;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useIntent = void 0;
+var _react = require("react");
+var _NativeBridge = _interopRequireDefault(require("../utils/NativeBridge.js"));
+var _NativeInterfaces = require("../constants/NativeInterfaces.js");
+var _useBaseHook = require("../useBaseHook.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */
+
+const useIntent = () => {
+  const base = (0, _useBaseHook.useBaseHook)("useIntent");
+  if (typeof window === "undefined") {
+    return {
+      data: null,
+      loading: false,
+      progress: null,
+      error: null,
+      isWeb: true,
+      isNative: false,
+      execute: () => {},
+      clear: () => {},
+      clearError: () => {},
+      isLoading: false,
+      processingState: null,
+      openFile: () => {},
+      success: null,
+      reset: () => {}
+    };
+  }
+  if (!window.WebBridge) {
+    throw new Error("WebBridge is not initialized. Call WebBridge.init() first.");
+  }
+  (0, _react.useEffect)(() => {
+    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_SUCCESS, data => {
+      console.log("📄 Intent completed successfully:", data);
+      base.setDataAndComplete({
+        result: data,
+        success: true
+      });
+    });
+    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_ERROR, data => {
+      console.error("📄 Intent error:", data);
+      base.handleNativeError(data);
+    });
+    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_CANCELLED, data => {
+      console.log("📄 Intent cancelled:", data);
+      base.setLoading(false);
+      base.resetProgress();
+    });
+    return () => {
+      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_SUCCESS);
+      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_ERROR);
+      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_CANCELLED);
+    };
+  }, [base.setDataAndComplete, base.handleNativeError, base.setLoading, base.resetProgress]);
+  const openFile = (fileUrl, mimeType = null) => {
+    if (!fileUrl) {
+      base.handleNativeError("File URL is required");
+      return;
+    }
+    console.log("📄 File open with intent requested:", {
+      fileUrl,
+      mimeType
+    });
+    base.executeOperation(() => {
+      base.updateProgress({
+        state: "opening_file",
+        phase: "processing",
+        message: "Opening file with external app..."
+      });
+      _NativeBridge.default.file.openWithIntent(fileUrl, mimeType);
+    }, "intent file open");
+  };
+  return {
+    data: base.data,
+    loading: base.loading,
+    progress: base.progress,
+    error: base.error,
+    isWeb: base.isWeb,
+    isNative: base.isNative,
+    execute: openFile,
+    clear: base.clear,
+    clearError: base.clearError,
+    isLoading: base.loading,
+    processingState: base.progress?.phase || null,
+    openFile,
+    success: base.data?.success || null,
+    reset: base.clear
+  };
+};
+exports.useIntent = useIntent;

package/dist/native/bridge/hooks/useNativeTransition.js

@@ -1,4 +1,21 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useNativeTransition=void 0;var _react=require("react");var _reactRouterDom=require("react-router-dom");var _NativeBridge=_interopRequireDefault(require("../utils/NativeBridge.js"));var _NativeInterfaces=require("../constants/NativeInterfaces.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */const DEFAULT_DURATION=300;const DEFAULT_TIMEOUT_MULTIPLIER=3;const MIN_TIMEOUT=800;/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useNativeTransition = void 0;
+var _react = require("react");
+var _reactRouterDom = require("react-router-dom");
+var _NativeBridge = _interopRequireDefault(require("../utils/NativeBridge.js"));
+var _NativeInterfaces = require("../constants/NativeInterfaces.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */
+
+const DEFAULT_DURATION = 300;
+const DEFAULT_TIMEOUT_MULTIPLIER = 3;
+const MIN_TIMEOUT = 800;
+
+/**
  * Wraps useNavigate with native slide/fade transitions using a snapshot overlay pattern.
  *
  * Native path:
@@ -15,29 +32,187 @@
  *   direction: 'left' | 'right' | 'up' | 'down' (default: 'left')
  *   duration: ms (default: 300)
  *   timeout: ms safety timer (default: max(duration*3, 800))
- */const useNativeTransition=(defaults={})=>{const router=(0,_reactRouterDom.useNavigate)();const isNative=typeof window!=="undefined"&&_NativeBridge.default.isAvailable();const[transitioning,setTransitioning]=(0,_react.useState)(false);const overlayRef=(0,_react.useRef)(null);const webTimeoutRef=(0,_react.useRef)(null);const pendingCommitRef=(0,_react.useRef)(null);// Register native callbacks once
-(0,_react.useEffect)(()=>{if(typeof window==="undefined"||!window.WebBridge)return;window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_COMMITTED,()=>{setTransitioning(false);});window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_CANCELLED,()=>{setTransitioning(false);});window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_TIMEOUT,()=>{console.warn("🔀 useNativeTransition: native safety timeout fired — overlay force-faded");setTransitioning(false);});return()=>{window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_COMMITTED);window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_CANCELLED);window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_TIMEOUT);};},[]);// Web fallback: create/remove a CSS overlay on document.body
-const _showWebOverlay=(0,_react.useCallback)(duration=>{if(typeof document==="undefined")return;const overlay=document.createElement("div");overlay.style.cssText=["position:fixed","inset:0","z-index:9999","background:var(--transition-overlay-color,#fff)",`transition:opacity ${duration}ms ease`,"opacity:0","pointer-events:none"].join(";");document.body.appendChild(overlay);overlayRef.current=overlay;// Trigger enter animation (fade in)
-requestAnimationFrame(()=>{requestAnimationFrame(()=>{overlay.style.opacity="1";});});},[]);const _hideWebOverlay=(0,_react.useCallback)(duration=>{const overlay=overlayRef.current;if(!overlay)return;overlay.style.opacity="0";const cleanup=()=>{overlay.remove();overlayRef.current=null;setTransitioning(false);};// Use transitionend when possible, fallback to setTimeout
-overlay.addEventListener("transitionend",cleanup,{once:true});webTimeoutRef.current=setTimeout(cleanup,duration+50);},[]);// Cancel any in-flight web transition (e.g. safety timeout path)
-const _cancelWebOverlay=(0,_react.useCallback)(()=>{clearTimeout(webTimeoutRef.current);if(overlayRef.current){overlayRef.current.remove();overlayRef.current=null;}setTransitioning(false);},[]);/**
-     * navigate(to, options)
-     *
-     * Options (in addition to standard react-router NavigateOptions):
-     *   type: 'slide' | 'fade'
-     *   direction: 'left' | 'right' | 'up' | 'down'
-     *   duration: ms
-     *   timeout: ms (native safety timer; web safety timer uses duration*3)
-     *   replace: boolean (passed to router)
-     *   state: any (passed to router)
-     */const navigate=(0,_react.useCallback)((to,options={})=>{const{type=defaults.type??"slide",direction=defaults.direction??"left",duration=defaults.duration??DEFAULT_DURATION,timeout=defaults.timeout??Math.max(duration*DEFAULT_TIMEOUT_MULTIPLIER,MIN_TIMEOUT),replace=false,state,...rest}=options;const routerOpts={replace,state,...rest};setTransitioning(true);if(isNative){try{_NativeBridge.default.transition.start({type,direction,duration,timeout});// Route swap happens immediately — native overlay hides the skeleton
-router(to,routerOpts);// Give the new page one frame to mount before committing
-requestAnimationFrame(()=>{requestAnimationFrame(()=>{try{_NativeBridge.default.transition.commit();}catch(err){console.error("🔀 useNativeTransition: commitTransition failed:",err);_NativeBridge.default.transition.cancel();setTransitioning(false);}});});}catch(err){console.error("🔀 useNativeTransition: startTransition failed, falling back to plain navigate:",err);setTransitioning(false);router(to,routerOpts);}}else{// Web fallback — CSS overlay
-_showWebOverlay(duration);const webSafetyTimeout=Math.max(duration*DEFAULT_TIMEOUT_MULTIPLIER,MIN_TIMEOUT);pendingCommitRef.current={duration,webSafetyTimeout};// Route swap after overlay is visible
-requestAnimationFrame(()=>{requestAnimationFrame(()=>{router(to,routerOpts);// Commit: fade overlay back out
-requestAnimationFrame(()=>{requestAnimationFrame(()=>{_hideWebOverlay(duration);});});});});// Web safety timeout
-webTimeoutRef.current=setTimeout(()=>{console.warn("🔀 useNativeTransition: web safety timeout — removing overlay");_cancelWebOverlay();},webSafetyTimeout);}},[isNative,defaults,router,_showWebOverlay,_hideWebOverlay,_cancelWebOverlay]);/**
-     * Imperatively cancel an in-flight transition (e.g. error boundary).
-     * On native: fires cancelTransition bridge command.
-     * On web: removes overlay immediately.
-     */const cancelTransition=(0,_react.useCallback)(()=>{if(isNative){try{_NativeBridge.default.transition.cancel();}catch(_){/* swallow — cancel is best-effort */}}else{_cancelWebOverlay();}setTransitioning(false);},[isNative,_cancelWebOverlay]);return{navigate,cancelTransition,transitioning,isNative,isWeb:!isNative};};exports.useNativeTransition=useNativeTransition;
+ */
+const useNativeTransition = (defaults = {}) => {
+  const router = (0, _reactRouterDom.useNavigate)();
+  const isNative = typeof window !== "undefined" && _NativeBridge.default.isAvailable();
+  const [transitioning, setTransitioning] = (0, _react.useState)(false);
+  const overlayRef = (0, _react.useRef)(null);
+  const webTimeoutRef = (0, _react.useRef)(null);
+  const pendingCommitRef = (0, _react.useRef)(null);
+
+  // Register native callbacks once
+  (0, _react.useEffect)(() => {
+    if (typeof window === "undefined" || !window.WebBridge) return;
+    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_COMMITTED, () => {
+      setTransitioning(false);
+    });
+    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_CANCELLED, () => {
+      setTransitioning(false);
+    });
+    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_TIMEOUT, () => {
+      console.warn("🔀 useNativeTransition: native safety timeout fired — overlay force-faded");
+      setTransitioning(false);
+    });
+    return () => {
+      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_COMMITTED);
+      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_CANCELLED);
+      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_TRANSITION_TIMEOUT);
+    };
+  }, []);
+
+  // Web fallback: create/remove a CSS overlay on document.body
+  const _showWebOverlay = (0, _react.useCallback)(duration => {
+    if (typeof document === "undefined") return;
+    const overlay = document.createElement("div");
+    overlay.style.cssText = ["position:fixed", "inset:0", "z-index:9999", "background:var(--transition-overlay-color,#fff)", `transition:opacity ${duration}ms ease`, "opacity:0", "pointer-events:none"].join(";");
+    document.body.appendChild(overlay);
+    overlayRef.current = overlay;
+
+    // Trigger enter animation (fade in)
+    requestAnimationFrame(() => {
+      requestAnimationFrame(() => {
+        overlay.style.opacity = "1";
+      });
+    });
+  }, []);
+  const _hideWebOverlay = (0, _react.useCallback)(duration => {
+    const overlay = overlayRef.current;
+    if (!overlay) return;
+    overlay.style.opacity = "0";
+    const cleanup = () => {
+      overlay.remove();
+      overlayRef.current = null;
+      setTransitioning(false);
+    };
+
+    // Use transitionend when possible, fallback to setTimeout
+    overlay.addEventListener("transitionend", cleanup, {
+      once: true
+    });
+    webTimeoutRef.current = setTimeout(cleanup, duration + 50);
+  }, []);
+
+  // Cancel any in-flight web transition (e.g. safety timeout path)
+  const _cancelWebOverlay = (0, _react.useCallback)(() => {
+    clearTimeout(webTimeoutRef.current);
+    if (overlayRef.current) {
+      overlayRef.current.remove();
+      overlayRef.current = null;
+    }
+    setTransitioning(false);
+  }, []);
+
+  /**
+   * navigate(to, options)
+   *
+   * Options (in addition to standard react-router NavigateOptions):
+   *   type: 'slide' | 'fade'
+   *   direction: 'left' | 'right' | 'up' | 'down'
+   *   duration: ms
+   *   timeout: ms (native safety timer; web safety timer uses duration*3)
+   *   replace: boolean (passed to router)
+   *   state: any (passed to router)
+   */
+  const navigate = (0, _react.useCallback)((to, options = {}) => {
+    const {
+      type = defaults.type ?? "slide",
+      direction = defaults.direction ?? "left",
+      duration = defaults.duration ?? DEFAULT_DURATION,
+      timeout = defaults.timeout ?? Math.max(duration * DEFAULT_TIMEOUT_MULTIPLIER, MIN_TIMEOUT),
+      replace = false,
+      state,
+      ...rest
+    } = options;
+    const routerOpts = {
+      replace,
+      state,
+      ...rest
+    };
+    setTransitioning(true);
+    if (isNative) {
+      try {
+        _NativeBridge.default.transition.start({
+          type,
+          direction,
+          duration,
+          timeout
+        });
+
+        // Route swap happens immediately — native overlay hides the skeleton
+        router(to, routerOpts);
+
+        // Give the new page one frame to mount before committing
+        requestAnimationFrame(() => {
+          requestAnimationFrame(() => {
+            try {
+              _NativeBridge.default.transition.commit();
+            } catch (err) {
+              console.error("🔀 useNativeTransition: commitTransition failed:", err);
+              _NativeBridge.default.transition.cancel();
+              setTransitioning(false);
+            }
+          });
+        });
+      } catch (err) {
+        console.error("🔀 useNativeTransition: startTransition failed, falling back to plain navigate:", err);
+        setTransitioning(false);
+        router(to, routerOpts);
+      }
+    } else {
+      // Web fallback — CSS overlay
+      _showWebOverlay(duration);
+      const webSafetyTimeout = Math.max(duration * DEFAULT_TIMEOUT_MULTIPLIER, MIN_TIMEOUT);
+      pendingCommitRef.current = {
+        duration,
+        webSafetyTimeout
+      };
+
+      // Route swap after overlay is visible
+      requestAnimationFrame(() => {
+        requestAnimationFrame(() => {
+          router(to, routerOpts);
+
+          // Commit: fade overlay back out
+          requestAnimationFrame(() => {
+            requestAnimationFrame(() => {
+              _hideWebOverlay(duration);
+            });
+          });
+        });
+      });
+
+      // Web safety timeout
+      webTimeoutRef.current = setTimeout(() => {
+        console.warn("🔀 useNativeTransition: web safety timeout — removing overlay");
+        _cancelWebOverlay();
+      }, webSafetyTimeout);
+    }
+  }, [isNative, defaults, router, _showWebOverlay, _hideWebOverlay, _cancelWebOverlay]);
+
+  /**
+   * Imperatively cancel an in-flight transition (e.g. error boundary).
+   * On native: fires cancelTransition bridge command.
+   * On web: removes overlay immediately.
+   */
+  const cancelTransition = (0, _react.useCallback)(() => {
+    if (isNative) {
+      try {
+        _NativeBridge.default.transition.cancel();
+      } catch (_) {
+        /* swallow — cancel is best-effort */
+      }
+    } else {
+      _cancelWebOverlay();
+    }
+    setTransitioning(false);
+  }, [isNative, _cancelWebOverlay]);
+  return {
+    navigate,
+    cancelTransition,
+    transitioning,
+    isNative,
+    isWeb: !isNative
+  };
+};
+exports.useNativeTransition = useNativeTransition;

package/dist/native/bridge/hooks/useNetworkStatus.js

@@ -1,3 +1,84 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useNetworkStatus=void 0;var _react=require("react");var _NativeBridge=_interopRequireDefault(require("../utils/NativeBridge.js"));var _NativeInterfaces=require("../constants/NativeInterfaces.js");var _utils=require("./utils.js");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */const useNetworkStatus=({webFallback}={})=>{// navigator.onLine is unreliable in some dev/Electron environments — default true if undefined
-const initialOnline=typeof navigator!=="undefined"&&typeof navigator.onLine==="boolean"?navigator.onLine:true;const[status,setStatus]=(0,_react.useState)({online:initialOnline,type:null});const[error,setError]=(0,_react.useState)(null);const isNative=_NativeBridge.default.isAvailable();const[webFallbackState,setWebFallback]=(0,_react.useState)(true);const webFallbackResolved=webFallback!==undefined?webFallback!==false:webFallbackState;const webFallbackActive=!isNative&&webFallbackResolved;const webFallbackDisabled=!isNative&&!webFallbackResolved;(0,_react.useEffect)(()=>{if(typeof window==="undefined")return;if(!isNative){if(webFallbackDisabled)return;// Web fallback: browser online/offline events
-const handleOnline=()=>setStatus({online:true,type:null});const handleOffline=()=>setStatus({online:false,type:null});window.addEventListener("online",handleOnline);window.addEventListener("offline",handleOffline);return()=>{window.removeEventListener("online",handleOnline);window.removeEventListener("offline",handleOffline);};}if(!window.WebBridge)return;const handleStatus=payload=>{try{const parsed=(0,_utils.parseNativePayload)(payload)||{};setStatus({online:Boolean(parsed.online),type:parsed.type||null});setError(null);}catch(e){console.error("🌐 Error parsing network status:",e);setError(e.message);}};window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.NETWORK_STATUS_CHANGED,handleStatus);try{_NativeBridge.default.network.getStatus();}catch(e){setError(e.message||"Network status unavailable");}return()=>{window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.NETWORK_STATUS_CHANGED);};},[isNative,webFallbackDisabled]);return{...status,error,isNative,isWeb:!isNative,webFallbackActive,webFallbackDisabled,setWebFallback};};exports.useNetworkStatus=useNetworkStatus;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useNetworkStatus = void 0;
+var _react = require("react");
+var _NativeBridge = _interopRequireDefault(require("../utils/NativeBridge.js"));
+var _NativeInterfaces = require("../constants/NativeInterfaces.js");
+var _utils = require("./utils.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps */
+
+const useNetworkStatus = ({
+  webFallback
+} = {}) => {
+  // navigator.onLine is unreliable in some dev/Electron environments — default true if undefined
+  const initialOnline = typeof navigator !== "undefined" && typeof navigator.onLine === "boolean" ? navigator.onLine : true;
+  const [status, setStatus] = (0, _react.useState)({
+    online: initialOnline,
+    type: null
+  });
+  const [error, setError] = (0, _react.useState)(null);
+  const isNative = _NativeBridge.default.isAvailable();
+  const [webFallbackState, setWebFallback] = (0, _react.useState)(true);
+  const webFallbackResolved = webFallback !== undefined ? webFallback !== false : webFallbackState;
+  const webFallbackActive = !isNative && webFallbackResolved;
+  const webFallbackDisabled = !isNative && !webFallbackResolved;
+  (0, _react.useEffect)(() => {
+    if (typeof window === "undefined") return;
+    if (!isNative) {
+      if (webFallbackDisabled) return;
+
+      // Web fallback: browser online/offline events
+      const handleOnline = () => setStatus({
+        online: true,
+        type: null
+      });
+      const handleOffline = () => setStatus({
+        online: false,
+        type: null
+      });
+      window.addEventListener("online", handleOnline);
+      window.addEventListener("offline", handleOffline);
+      return () => {
+        window.removeEventListener("online", handleOnline);
+        window.removeEventListener("offline", handleOffline);
+      };
+    }
+    if (!window.WebBridge) return;
+    const handleStatus = payload => {
+      try {
+        const parsed = (0, _utils.parseNativePayload)(payload) || {};
+        setStatus({
+          online: Boolean(parsed.online),
+          type: parsed.type || null
+        });
+        setError(null);
+      } catch (e) {
+        console.error("🌐 Error parsing network status:", e);
+        setError(e.message);
+      }
+    };
+    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.NETWORK_STATUS_CHANGED, handleStatus);
+    try {
+      _NativeBridge.default.network.getStatus();
+    } catch (e) {
+      setError(e.message || "Network status unavailable");
+    }
+    return () => {
+      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.NETWORK_STATUS_CHANGED);
+    };
+  }, [isNative, webFallbackDisabled]);
+  return {
+    ...status,
+    error,
+    isNative,
+    isWeb: !isNative,
+    webFallbackActive,
+    webFallbackDisabled,
+    setWebFallback
+  };
+};
+exports.useNetworkStatus = useNetworkStatus;