SETUP 1. Drag the ShareSheet (Mobile) element onto your page. It works as an invisible controller (set show_button to false) or renders a built-in share button (show_button true).
2. The element is mobile-only. It renders as a 1x1 transparent placeholder in the Bubble editor — this is expected.

ELEMENT FIELDS (configure in the Properties panel)
- share_title: Subject line shown in iOS share sheet and email apps.
- default_message: Pre-filled text for Share text action when no override is passed.
- default_url: Pre-filled URL for Share text action when no override is passed.
- button_label: Label for the built-in share button (default: Share).
- button_color / text_color: Background and text colour of the built-in button.
- corner_radius: Border radius of the built-in button in px (default: 10).
- show_button: Show or hide the built-in share button.
- haptics_enabled: Fire haptic feedback on share/copy success (requires expo-haptics; silently skipped if unavailable).
- deep_link_scheme: URL scheme for your app (e.g. myapp).
- deep_link_path: Path segment for deep links (e.g. /product/123).
- fallback_url: Web URL opened when the deep link target app is not installed.
- image_quality: Compression quality for Share image / Save image (0–1 or 0–100, default 0.8).
- image_max_width: Max pixel width before resizing during Share image (optional).
- save_album_name: Camera-roll album name for Save image to library (optional).

WORKFLOW ACTIONS
- Share text: Shares a message + URL via the native OS share sheet. Inputs: message, url, title (all optional overrides).
- Share file: Shares a file URI via expo-sharing. Inputs: file_uri, mime_type, dialog_title.
- Open native share sheet: Opens share sheet with activityType capture. Inputs: message, url.
- Copy to clipboard: Copies text silently. Input: text.
- Build deep link: Constructs a deep link URL. Inputs: scheme, path, query (key=value pairs). Exposes built_deep_link state and fires Deep link built event.
- Open deep link: Opens a deep link; falls back to fallback_url if app not installed. Inputs: deep_link, fallback.
- Check availability: Checks expo-sharing availability. Sets is_available state and available_caps JSON, fires Availability checked event.
- Save to files: Writes text content to a temp file and shares it. Inputs: content, filename, mime_type.
- Share image: Resizes/compresses an image URI or base64 and shares via expo-sharing. Inputs: image_source, mime_type, dialog_title.
- Save image to library: Saves an image URI or base64 to the device camera roll. Inputs: image_source, album_name.

EXPOSED STATES
last_action, last_shared_content, last_result (shared/dismissed/copied/opened/built/error), last_activity_type, built_deep_link, error, is_available (yes/no), is_sharing (yes/no), saved_uri, image_uri, available_caps (JSON), last_error_code.

EVENTS
Share completed, Share dismissed, Copied to clipboard, Saved to files, Deep link built, Error, Image shared, Image saved to library, Availability checked.

LIBRARIES USED (all Bubble built-in)
react-native Share, expo-sharing, expo-clipboard, expo-linking, expo-file-system, expo-image-manipulator, expo-media-library, expo-haptics (feature-detected, optional).

NOTES
- Test on a real device via BubbleGo or TestFlight/Android — camera and share features are not available in web preview.
- All action handlers are wrapped in try/catch and surface errors via the error state and Error event.
- expo-haptics is feature-detected: it fires silently if unavailable, with no crash or build failure.