@symbiote-native/mail-composer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 A. Prokopenko
+
+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,172 @@
+# @symbiote-native/mail-composer
+
+Let users email you from inside the app: open the system mail composer with recipients, subject,
+body and attachments already filled in. One API for every [SymbioteNative](../../README.md)
+adapter (React, Vue, Svelte, Solid and Angular).
+
+It wraps [`expo-mail-composer`](https://github.com/expo/expo/tree/main/packages/expo-mail-composer)
+the same way [`@symbiote-native/sms`](../sms) wraps its upstream: `expo-modules-core` is a direct
+dependency, never the `expo` meta-package, and the upstream JS is hand-ported into `core/`. The
+mechanics live in the `symbiote-expo-native-module` project skill.
+
+Nothing is ever sent on the user's behalf. Both platforms open their own composer with the draft
+filled in; the user presses send, edits, or discards it.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --mail-composer
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --mail-composer
+```
+
+Either way: installs `@symbiote-native/mail-composer` and wires the native autolinking
+automatically - see [`@symbiote-native/cli`](../cli).
+
+<details>
+<summary>Manual install (no CLI - installing and wiring native autolinking by hand)</summary>
+
+```bash
+npm install @symbiote-native/mail-composer
+```
+
+`expo-mail-composer` and `expo-modules-core` come along as regular, pinned dependencies - never
+install either yourself, and never add the `expo` meta-package to this project (it bundles its
+own Metro/Babel pipeline that conflicts with this project's own).
+
+### Required one-time step: native autolinking wiring
+
+Unlike a plain RN native module, `expo-mail-composer`'s native code is discovered by
+`expo-modules-autolinking` - this needs wiring into the native host app **once**, covering this
+package and every other `expo-modules-core` package with zero further changes:
+
+| Platform | Touches                                                                               |
+| -------- | ------------------------------------------------------------------------------------- |
+| iOS      | `ios/Podfile` - add `use_expo_modules!`                                               |
+| iOS      | `AppDelegate.swift` - Expo's runtime-bootstrap hook                                   |
+| Android  | `settings.gradle` / `app/build.gradle` - resolve and include the Expo Gradle projects |
+| Android  | `MainApplication.kt` - Expo's bootstrap hook, plus a native-module name map           |
+
+Full mechanics live in the `symbiote-expo-native-module` skill. The per-package half of that
+table - the Gradle dependency and the module map entry - is generated by
+[`@symbiote-native/expo-modules-link`](../expo-modules-link) from this package's
+`native-link.json` on every install.
+
+### One Info.plist array key, no permissions, no config plugin
+
+- **No runtime permission on either platform.** Composing is a `MFMailComposeViewController` on
+  iOS and an `ACTION_SENDTO` chooser on Android - the user's own Mail app sends it.
+- **`LSApplicationQueriesSchemes` (iOS only).** `getClients()` checks each candidate mail app's
+  URL scheme with `canOpenURL`, which iOS 9+ silently refuses for an undeclared scheme - so
+  `native-link.json` carries the same 22-scheme list upstream's config plugin writes, generated
+  into your `Info.plist` automatically (merges additively with any other package's own entries).
+- **No manifest edit.** `expo-mail-composer` ships its own `<queries>` block for Android 11+
+  package-visibility rules; it merges in automatically once the Gradle project is included.
+- **No config plugin beyond the Info.plist key above.**
+
+</details>
+
+## Shape
+
+```
+src/core/                 the whole API: composeAsync + isAvailableAsync + getClients.
+                          native-module.ts resolves ExpoMailComposer through
+                          expo-modules-core's requireNativeModule.
+src/angular/              @symbiote-native/mail-composer/angular
+```
+
+`./react`, `./vue`, `./svelte`, and `./solid` are `exports`-map aliases straight onto `src/core/` -
+no physical per-framework file. All three exports are stateless free functions with no event
+stream, so there is nothing for a hook, composable, or service to wrap - the same reason
+[`@symbiote-native/sms`](../sms) does the same. `./angular` stays a physical file/subpath since
+Angular ships through a separate `ngc`/AOT build (`build-ngc/`). Import from
+`@symbiote-native/mail-composer` directly if you don't care which adapter you're on; the
+per-adapter subpaths exist so every wrapper package has the same import surface.
+
+## Use it
+
+```ts
+import { composeAsync, isAvailableAsync } from '@symbiote-native/mail-composer';
+
+if (await isAvailableAsync()) {
+  const { status } = await composeAsync({
+    recipients: ['support@example.com'],
+    subject: 'Order #1234',
+    body: 'Hi, I have a question about my order.',
+  });
+  // 'sent' | 'saved' | 'cancelled' on iOS; always 'sent' on Android
+}
+```
+
+Listing installed mail clients (iOS reports each one's URL scheme; Android its package name):
+
+```ts
+import { getClients } from '@symbiote-native/mail-composer';
+
+const clients = getClients();
+// [{ label: 'Gmail', url: 'googlegmail://' }, ...] on iOS
+// [{ label: 'Gmail', packageName: 'com.google.android.gm' }, ...] on Android
+```
+
+With an attachment:
+
+```ts
+await composeAsync({
+  recipients: ['support@example.com'],
+  attachments: ['file:///path/to/receipt.pdf'],
+});
+```
+
+## API
+
+| Export             | Signature                                             | Notes                                                              |
+| ------------------ | ------------------------------------------------------ | ------------------------------------------------------------------- |
+| `isAvailableAsync` | `() => Promise<boolean>`                                | `false` on iOS under an MDM profile blocking outgoing mail.          |
+| `composeAsync`     | `(options: IMailComposerOptions) => Promise<IMailComposerResult>` | Opens the composer. Resolves when it closes.               |
+| `getClients`       | `() => IMailClient[]`                                    | Synchronous - no native round-trip needed.                        |
+
+`IMailComposerOptions`: `recipients` / `ccRecipients` / `bccRecipients` (string arrays), `subject`,
+`body`, `isHtml`, `attachments` (app-internal file URIs).
+`IMailComposerResult`: `{ status: 'undetermined' | 'sent' | 'saved' | 'cancelled' }`.
+`IMailClient`: `label`, plus `url` (iOS) or `packageName` (Android).
+
+## Notes
+
+- **Check `isAvailableAsync()` first.** An iOS simulator cannot sign in to a mail account, so the composer
+  never opens there; offer a fallback such as copying the address.
+- **Attachments must live in the app's own storage** (`file://` URIs, for example from the cache directory).
+- **Android always resolves `sent`.** It has no way to read the composer's real outcome back -
+  upstream reports the same fixed status there.
+- **iOS needs a signed-in Mail app.** `isAvailableAsync`/`composeAsync` fail without one -
+  the same check `MFMailComposeViewController.canSendMail()` makes natively.
+
+## Common questions
+
+- **Nothing happens on the iOS Simulator.** It cannot sign in to a mail account; use a device.
+- **`isAvailableAsync()` is `true` on Android but no composer opens.** The Android check is weak and
+  some devices show a plain share sheet; offer a fallback such as copying the address.
+- **HTML body shows as text on Android.** `isHtml` is not reliable across Android mail apps.
+- **Sent or not?** iOS reports `sent` / `saved` / `cancelled`; Android always reports `sent`.
+- **Attachment missing.** Attach files from the app's own storage via `file://` URIs.
+
+Sources: [Expo docs: MailComposer](https://docs.expo.dev/versions/latest/sdk/mail-composer/),
+[expo/expo#35466](https://github.com/expo/expo/issues/35466),
+[expo/expo#37740](https://github.com/expo/expo/issues/37740),
+[expo/expo#16690](https://github.com/expo/expo/issues/16690),
+[expo/expo#20509](https://github.com/expo/expo/issues/20509).
+
+## Test it
+
+```bash
+pnpm vitest run packages/mail-composer
+```
+
+The core tests fake the native module in place of `requireNativeModule`'s runtime resolution -
+`ExpoMailComposer` only exists on a device, so a headless run would otherwise throw at import. The
+composer itself, and the `sent`/`saved`/`cancelled` distinction, can only be verified on a device.

package/build/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build/angular/index.js

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core/index.js';

package/build/core/index.d.ts

@@ -0,0 +1,2 @@
+export { composeAsync, getClients, isAvailableAsync } from './mail-composer';
+export type { IMailClient, IMailComposerOptions, IMailComposerResult, IMailComposerStatus, } from './types';

package/build/core/index.js

@@ -0,0 +1 @@
+export { composeAsync, getClients, isAvailableAsync } from './mail-composer.js';

package/build/core/mail-composer.d.ts

@@ -0,0 +1,7 @@
+import type { IMailClient, IMailComposerOptions, IMailComposerResult } from './types';
+/** Mail clients installed on the device — present as choices, or open one to check a reply. */
+export declare function getClients(): IMailClient[];
+/** Opens a mail modal (iOS) / chooser (Android). Android always resolves `{ status: 'sent' }`. */
+export declare function composeAsync(options: IMailComposerOptions): Promise<IMailComposerResult>;
+/** Whether `composeAsync` can be used — `false` on iOS under an MDM outgoing-mail block. */
+export declare function isAvailableAsync(): Promise<boolean>;

package/build/core/mail-composer.js

@@ -0,0 +1,13 @@
+import { expoMailComposer } from './native-module.js';
+/** Mail clients installed on the device — present as choices, or open one to check a reply. */
+export function getClients() {
+    return expoMailComposer.getClients();
+}
+/** Opens a mail modal (iOS) / chooser (Android). Android always resolves `{ status: 'sent' }`. */
+export async function composeAsync(options) {
+    return expoMailComposer.composeAsync(options);
+}
+/** Whether `composeAsync` can be used — `false` on iOS under an MDM outgoing-mail block. */
+export async function isAvailableAsync() {
+    return expoMailComposer.isAvailableAsync();
+}

package/build/core/native-module.d.ts

@@ -0,0 +1,7 @@
+import type { IMailClient, IMailComposerOptions, IMailComposerResult } from './types';
+export type INativeMailComposerModule = {
+    isAvailableAsync(): Promise<boolean>;
+    composeAsync(options: IMailComposerOptions): Promise<IMailComposerResult>;
+    getClients(): IMailClient[];
+};
+export declare const expoMailComposer: INativeMailComposerModule;

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_MAIL_COMPOSER_MODULE_NAME = 'ExpoMailComposer';
+export const expoMailComposer = requireNativeModule(EXPO_MAIL_COMPOSER_MODULE_NAME);

package/build/core/types.d.ts

@@ -0,0 +1,27 @@
+/** A mail client installed on the device. */
+export type IMailClient = {
+    /** The display name of the mail client. */
+    label: string;
+    /** The package name of the mail client application. @platform android */
+    packageName?: string;
+    /** The URL scheme of the mail client. @platform ios */
+    url?: string;
+};
+export type IMailComposerOptions = {
+    /** E-mail addresses of the recipients. */
+    recipients?: string[];
+    /** E-mail addresses of the CC recipients. */
+    ccRecipients?: string[];
+    /** E-mail addresses of the BCC recipients. */
+    bccRecipients?: string[];
+    subject?: string;
+    body?: string;
+    /** Whether `body` contains HTML tags. Not fully supported on Android. */
+    isHtml?: boolean;
+    /** App-internal file URIs to attach. */
+    attachments?: string[];
+};
+export type IMailComposerStatus = 'undetermined' | 'sent' | 'saved' | 'cancelled';
+export type IMailComposerResult = {
+    status: IMailComposerStatus;
+};

package/build/core/types.js

@@ -0,0 +1 @@
+export {};

package/build-ngc/angular/index.d.ts

@@ -0,0 +1 @@
+export * from '../core';

package/build-ngc/angular/index.js

@@ -0,0 +1,3 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core';
+//# sourceMappingURL=index.js.map

package/build-ngc/angular/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/angular/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,cAAc,SAAS,CAAC"}

package/build-ngc/core/index.d.ts

@@ -0,0 +1,2 @@
+export { composeAsync, getClients, isAvailableAsync } from './mail-composer';
+export type { IMailClient, IMailComposerOptions, IMailComposerResult, IMailComposerStatus, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,2 @@
+export { composeAsync, getClients, isAvailableAsync } from './mail-composer';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

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

package/build-ngc/core/mail-composer.d.ts

@@ -0,0 +1,7 @@
+import type { IMailClient, IMailComposerOptions, IMailComposerResult } from './types';
+/** Mail clients installed on the device — present as choices, or open one to check a reply. */
+export declare function getClients(): IMailClient[];
+/** Opens a mail modal (iOS) / chooser (Android). Android always resolves `{ status: 'sent' }`. */
+export declare function composeAsync(options: IMailComposerOptions): Promise<IMailComposerResult>;
+/** Whether `composeAsync` can be used — `false` on iOS under an MDM outgoing-mail block. */
+export declare function isAvailableAsync(): Promise<boolean>;

package/build-ngc/core/mail-composer.js

@@ -0,0 +1,14 @@
+import { expoMailComposer } from './native-module';
+/** Mail clients installed on the device — present as choices, or open one to check a reply. */
+export function getClients() {
+    return expoMailComposer.getClients();
+}
+/** Opens a mail modal (iOS) / chooser (Android). Android always resolves `{ status: 'sent' }`. */
+export async function composeAsync(options) {
+    return expoMailComposer.composeAsync(options);
+}
+/** Whether `composeAsync` can be used — `false` on iOS under an MDM outgoing-mail block. */
+export async function isAvailableAsync() {
+    return expoMailComposer.isAvailableAsync();
+}
+//# sourceMappingURL=mail-composer.js.map

package/build-ngc/core/mail-composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-composer.js","sourceRoot":"","sources":["../../src/core/mail-composer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnD,+FAA+F;AAC/F,MAAM,UAAU,UAAU;IACxB,OAAO,gBAAgB,CAAC,UAAU,EAAE,CAAC;AACvC,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA6B;IAE7B,OAAO,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,OAAO,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;AAC7C,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,7 @@
+import type { IMailClient, IMailComposerOptions, IMailComposerResult } from './types';
+export type INativeMailComposerModule = {
+    isAvailableAsync(): Promise<boolean>;
+    composeAsync(options: IMailComposerOptions): Promise<IMailComposerResult>;
+    getClients(): IMailClient[];
+};
+export declare const expoMailComposer: INativeMailComposerModule;

package/build-ngc/core/native-module.js

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_MAIL_COMPOSER_MODULE_NAME = 'ExpoMailComposer';
+export const expoMailComposer = requireNativeModule(EXPO_MAIL_COMPOSER_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

package/build-ngc/core/native-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAOxD,MAAM,8BAA8B,GAAG,kBAAkB,CAAC;AAQ1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CACjD,8BAA8B,CAC/B,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,27 @@
+/** A mail client installed on the device. */
+export type IMailClient = {
+    /** The display name of the mail client. */
+    label: string;
+    /** The package name of the mail client application. @platform android */
+    packageName?: string;
+    /** The URL scheme of the mail client. @platform ios */
+    url?: string;
+};
+export type IMailComposerOptions = {
+    /** E-mail addresses of the recipients. */
+    recipients?: string[];
+    /** E-mail addresses of the CC recipients. */
+    ccRecipients?: string[];
+    /** E-mail addresses of the BCC recipients. */
+    bccRecipients?: string[];
+    subject?: string;
+    body?: string;
+    /** Whether `body` contains HTML tags. Not fully supported on Android. */
+    isHtml?: boolean;
+    /** App-internal file URIs to attach. */
+    attachments?: string[];
+};
+export type IMailComposerStatus = 'undetermined' | 'sent' | 'saved' | 'cancelled';
+export type IMailComposerResult = {
+    status: IMailComposerStatus;
+};

package/build-ngc/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/native-link.json

@@ -0,0 +1,40 @@
+{
+  "android": {
+    "gradleProjectName": "expo-mail-composer",
+    "modules": [
+      {
+        "importPath": "expo.modules.mailcomposer.MailComposerModule",
+        "className": "MailComposerModule",
+        "nativeName": "ExpoMailComposer"
+      }
+    ]
+  },
+  "ios": {
+    "infoPlistArrayKeys": {
+      "LSApplicationQueriesSchemes": [
+        "airmail",
+        "message",
+        "bluemail",
+        "canary",
+        "edisonmail",
+        "szn-email",
+        "fastmail",
+        "x-gmxmail-netid-v1",
+        "googlegmail",
+        "mailrumail",
+        "ms-outlook",
+        "protonmail",
+        "ctxmail",
+        "readdle-spark",
+        "superhuman",
+        "telekommail",
+        "tutanota",
+        "x-webdemail-netid-v1",
+        "ymail",
+        "yandexmail",
+        "appcenter-f45b4c0b-75c9-2d01-7ab6-41f6a6015be2",
+        "mymail-mailto"
+      ]
+    }
+  }
+}

package/package.json

@@ -0,0 +1,150 @@
+{
+  "name": "@symbiote-native/mail-composer",
+  "version": "0.1.0",
+  "description": "expo-mail-composer wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Opens the system mail composer prefilled with recipients, subject, body, and attachments.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-mail-composer",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "email",
+    "mail-composer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/mail-composer"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/mail-composer#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./react": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./svelte": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./solid": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-mail-composer": "57.0.2",
+    "expo-modules-core": "57.0.20"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "^3.1.3",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/vue": "^3.1.0",
+    "@symbiote-native/solid": "^3.0.5",
+    "@symbiote-native/svelte": "^3.0.5"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "3.1.3",
+    "@symbiote-native/react": "3.1.0",
+    "@symbiote-native/engine": "1.4.0",
+    "@symbiote-native/solid": "3.0.5",
+    "@symbiote-native/test-utils": "0.4.5",
+    "@symbiote-native/vue": "3.1.0",
+    "@symbiote-native/svelte": "3.0.5"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,2 @@
+// No per-instance state or event stream to wrap in an injectable service — plain re-export.
+export * from '../core';

package/src/core/index.ts

@@ -0,0 +1,7 @@
+export { composeAsync, getClients, isAvailableAsync } from './mail-composer';
+export type {
+  IMailClient,
+  IMailComposerOptions,
+  IMailComposerResult,
+  IMailComposerStatus,
+} from './types';

package/src/core/mail-composer.ts

@@ -0,0 +1,23 @@
+import { expoMailComposer } from './native-module';
+import type {
+  IMailClient,
+  IMailComposerOptions,
+  IMailComposerResult,
+} from './types';
+
+/** Mail clients installed on the device — present as choices, or open one to check a reply. */
+export function getClients(): IMailClient[] {
+  return expoMailComposer.getClients();
+}
+
+/** Opens a mail modal (iOS) / chooser (Android). Android always resolves `{ status: 'sent' }`. */
+export async function composeAsync(
+  options: IMailComposerOptions,
+): Promise<IMailComposerResult> {
+  return expoMailComposer.composeAsync(options);
+}
+
+/** Whether `composeAsync` can be used — `false` on iOS under an MDM outgoing-mail block. */
+export async function isAvailableAsync(): Promise<boolean> {
+  return expoMailComposer.isAvailableAsync();
+}

package/src/core/native-module.ts

@@ -0,0 +1,18 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type {
+  IMailClient,
+  IMailComposerOptions,
+  IMailComposerResult,
+} from './types';
+
+const EXPO_MAIL_COMPOSER_MODULE_NAME = 'ExpoMailComposer';
+
+export type INativeMailComposerModule = {
+  isAvailableAsync(): Promise<boolean>;
+  composeAsync(options: IMailComposerOptions): Promise<IMailComposerResult>;
+  getClients(): IMailClient[];
+};
+
+export const expoMailComposer = requireNativeModule<INativeMailComposerModule>(
+  EXPO_MAIL_COMPOSER_MODULE_NAME,
+);

package/src/core/types.ts

@@ -0,0 +1,31 @@
+/** A mail client installed on the device. */
+export type IMailClient = {
+  /** The display name of the mail client. */
+  label: string;
+  /** The package name of the mail client application. @platform android */
+  packageName?: string;
+  /** The URL scheme of the mail client. @platform ios */
+  url?: string;
+};
+
+export type IMailComposerOptions = {
+  /** E-mail addresses of the recipients. */
+  recipients?: string[];
+  /** E-mail addresses of the CC recipients. */
+  ccRecipients?: string[];
+  /** E-mail addresses of the BCC recipients. */
+  bccRecipients?: string[];
+  subject?: string;
+  body?: string;
+  /** Whether `body` contains HTML tags. Not fully supported on Android. */
+  isHtml?: boolean;
+  /** App-internal file URIs to attach. */
+  attachments?: string[];
+};
+
+export type IMailComposerStatus =
+  'undetermined' | 'sent' | 'saved' | 'cancelled';
+
+export type IMailComposerResult = {
+  status: IMailComposerStatus;
+};