@sigx/lynx-share 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andreas Ekdahl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,54 @@
+# @sigx/lynx-share
+
+Native share dialog for sigx-lynx. `UIActivityViewController` on iOS, `Intent.ACTION_SEND` chooser on Android.
+
+## Install
+
+```bash
+pnpm add @sigx/lynx-share
+```
+
+```ts
+// sigx.lynx.config.ts
+export default defineLynxConfig({
+    modules: ['@sigx/lynx-share'],
+});
+```
+
+No special permissions on either platform.
+
+## Usage
+
+```ts
+import { Share } from '@sigx/lynx-share';
+
+Share.share({
+    title: 'Check this out',
+    message: 'Built with sigx-lynx!',
+    url: 'https://sigx.dev',
+});
+```
+
+## API
+
+| Method                                | Notes                                                                                              |
+| ------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `share(options: ShareOptions): void`  | Sync — fire-and-forget. The share sheet dismissal isn't surfaced as a callback.                    |
+| `isAvailable(): boolean`              | Whether the native module is registered in the current build.                                      |
+
+```ts
+interface ShareOptions {
+    title?: string;
+    message?: string;
+    url?: string;
+}
+```
+
+## Gotchas
+
+- **Sharing files** isn't directly supported — `url` is treated as a string (web URL). For local file sharing, the native side would need to handle file URIs and FileProvider authority, which isn't wired here yet.
+- **No completion callback.** If you need to know whether the user actually shared (vs. cancelled the sheet), you'll need to extend the native module with `UIActivityViewController.completionWithItemsHandler` (iOS) / `ACTION_SEND` result handling (Android, harder — there's no clean signal).
+
+## Reference app
+
+`examples/lynx-one/my-sigx-app/src/cards/ShareCard.tsx` covers a simple share-sheet trigger with title + message + URL.

package/android/com/sigx/share/ShareModule.kt

@@ -0,0 +1,44 @@
+package com.sigx.share
+
+import android.content.Context
+import android.content.Intent
+import com.lynx.jsbridge.LynxMethod
+import com.lynx.jsbridge.LynxModule
+import com.lynx.react.bridge.ReadableMap
+
+/**
+ * Native share dialog module.
+ * JS usage: NativeModules.Share.share({ title: "Check this out", text: "Hello!", url: "https://..." })
+ */
+class ShareModule(context: Context) : LynxModule(context) {
+
+    @LynxMethod
+    fun share(options: ReadableMap?) {
+        if (options == null) return
+
+        val title = if (options.hasKey("title")) options.getString("title") else null
+        val text = if (options.hasKey("text")) options.getString("text") else null
+        val url = if (options.hasKey("url")) options.getString("url") else null
+
+        val shareText = buildString {
+            text?.let { append(it) }
+            url?.let {
+                if (isNotEmpty()) append("\n")
+                append(it)
+            }
+        }
+
+        val intent = Intent(Intent.ACTION_SEND).apply {
+            type = "text/plain"
+            if (title != null) putExtra(Intent.EXTRA_SUBJECT, title)
+            if (shareText.isNotEmpty()) putExtra(Intent.EXTRA_TEXT, shareText)
+            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+        }
+
+        val chooser = Intent.createChooser(intent, title ?: "Share").apply {
+            addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+        }
+        mContext.startActivity(chooser)
+    }
+}
+

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Share } from './share.js';
+export type { ShareOptions } from './share.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { Share } from './share.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/share.d.ts

@@ -0,0 +1,20 @@
+export interface ShareOptions {
+    title?: string;
+    message?: string;
+    url?: string;
+}
+/**
+ * Native share dialog APIs.
+ *
+ * @example
+ * ```ts
+ * import { Share } from '@sigx/lynx-share';
+ *
+ * Share.share({ title: 'Check this out', message: 'Built with sigx-lynx!', url: 'https://sigx.dev' });
+ * ```
+ */
+export declare const Share: {
+    readonly share: (options: ShareOptions) => void;
+    readonly isAvailable: () => boolean;
+};
+//# sourceMappingURL=share.d.ts.map

package/dist/share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.d.ts","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,KAAK;8BACC,YAAY,KAAG,IAAI;gCAInB,OAAO;CAGhB,CAAC"}

package/dist/share.js

@@ -0,0 +1,21 @@
+import { callSync, isModuleAvailable } from '@sigx/lynx-core';
+const MODULE = 'Share';
+/**
+ * Native share dialog APIs.
+ *
+ * @example
+ * ```ts
+ * import { Share } from '@sigx/lynx-share';
+ *
+ * Share.share({ title: 'Check this out', message: 'Built with sigx-lynx!', url: 'https://sigx.dev' });
+ * ```
+ */
+export const Share = {
+    share(options) {
+        callSync(MODULE, 'share', options);
+    },
+    isAvailable() {
+        return isModuleAvailable(MODULE);
+    },
+};
+//# sourceMappingURL=share.js.map

package/dist/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../src/share.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,MAAM,GAAG,OAAO,CAAC;AAQvB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB,KAAK,CAAC,OAAqB;QACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,WAAW;QACP,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACK,CAAC"}

package/ios/ShareModule.swift

@@ -0,0 +1,47 @@
+import UIKit
+import Lynx
+
+/// Native share dialog module.
+/// JS usage: NativeModules.Share.share({ title: "Check this", text: "Hello!", url: "https://..." })
+class ShareModule: NSObject, LynxModule {
+
+    @objc static var name: String { "Share" }
+
+    @objc static var methodLookup: [String: String] {
+        [
+            "share": NSStringFromSelector(#selector(share(_:))),
+        ]
+    }
+
+    required override init() { super.init() }
+    required init(param: Any) { super.init() }
+
+    @objc func share(_ options: [String: Any]?) {
+        guard let options = options else { return }
+
+        let title = options["title"] as? String
+        let text = options["text"] as? String
+        let urlString = options["url"] as? String
+
+        var items: [Any] = []
+        if let text = text { items.append(text) }
+        if let urlString = urlString, let url = URL(string: urlString) {
+            items.append(url)
+        }
+
+        guard !items.isEmpty else { return }
+
+        DispatchQueue.main.async {
+            let activityVC = UIActivityViewController(activityItems: items, applicationActivities: nil)
+            activityVC.setValue(title, forKey: "subject")
+
+            if let popover = activityVC.popoverPresentationController {
+                popover.sourceView = UIApplication.shared.windows.first?.rootViewController?.view
+                popover.sourceRect = CGRect(x: UIScreen.main.bounds.midX, y: UIScreen.main.bounds.midY, width: 0, height: 0)
+                popover.permittedArrowDirections = []
+            }
+
+            UIApplication.shared.windows.first?.rootViewController?.present(activityVC, animated: true)
+        }
+    }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@sigx/lynx-share",
+  "version": "0.1.0",
+  "description": "Native share dialog for sigx-lynx",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./sigx-module.json": "./sigx-module.json"
+  },
+  "files": [
+    "dist",
+    "ios",
+    "android",
+    "sigx-module.json"
+  ],
+  "dependencies": {
+    "@sigx/lynx-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "author": "Andreas Ekdahl",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/sigx-module.json

@@ -0,0 +1,16 @@
+{
+    "name": "Share",
+    "package": "@sigx/lynx-share",
+    "description": "Native share dialog",
+    "platforms": ["android", "ios"],
+    "ios": {
+        "moduleClass": "ShareModule",
+        "sourceDir": "ios",
+        "methods": ["share"]
+    },
+    "android": {
+        "moduleClass": "com.sigx.share.ShareModule",
+        "sourceDir": "android",
+        "permissions": []
+    }
+}