@symbiote-native/print 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,144 @@
+# @symbiote-native/print
+
+Print an invoice, a ticket or any HTML or PDF through the system print UI, or render HTML to a PDF
+file you can share. One API for every [SymbioteNative](../../README.md) adapter (React, Vue,
+Svelte, Solid and Angular).
+
+It wraps [`expo-print`](https://github.com/expo/expo/tree/main/packages/expo-print) (AirPrint on
+iOS, the print framework on Android) the same way
+[`@symbiote-native/mail-composer`](../mail-composer) 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.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --print
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --print
+```
+
+Either way: installs `@symbiote-native/print` 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/print
+```
+
+`expo-print` 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-print`'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.
+
+### No permissions, no config plugin
+
+- **No runtime permission on either platform.** Both the AirPrint sheet and Android's print
+  framework are OS chrome the user drives directly - nothing our code touches needs a grant.
+- **No manifest edit.** `expo-print`'s own `AndroidManifest.xml` declares nothing.
+- **No config plugin.** Upstream ships none (`app.plugin.js` doesn't exist in the package) - a
+  clean `native-link.json` with only the Android module entry is the whole file.
+
+</details>
+
+## Shape
+
+```
+src/core/                 the whole API: printAsync + selectPrinterAsync + printToFileAsync +
+                          Orientation. native-module.ts resolves ExpoPrint through
+                          expo-modules-core's requireNativeModule.
+src/angular/              @symbiote-native/print/angular
+```
+
+`./react`, `./vue`, `./svelte`, and `./solid` are `exports`-map aliases straight onto `src/core/` -
+no physical per-framework file, same reason [`@symbiote-native/mail-composer`](../mail-composer)
+does the same: every export here is a stateless free function or a plain constant, nothing to wrap
+in a hook, composable, or service. `./angular` stays a physical file/subpath since Angular ships
+through a separate `ngc`/AOT build (`build-ngc/`).
+
+## Use it
+
+```ts
+import { printAsync, printToFileAsync } from '@symbiote-native/print';
+
+await printAsync({ html: '<h1>Invoice #1234</h1>' });
+
+const { uri } = await printToFileAsync({ html: '<h1>Invoice #1234</h1>' });
+```
+
+Selecting a printer first (iOS only):
+
+```ts
+import { printAsync, selectPrinterAsync } from '@symbiote-native/print';
+
+const { url } = await selectPrinterAsync();
+await printAsync({ html: '<h1>Invoice #1234</h1>', printerUrl: url });
+```
+
+## API
+
+| Export              | Signature                                              | Notes                                      |
+| ------------------- | ------------------------------------------------------- | ------------------------------------------- |
+| `printAsync`        | `(options: IPrintOptions) => Promise<void>`              | Exactly one of `uri`/`html`. One at a time. |
+| `selectPrinterAsync` | `() => Promise<IPrinter>`                               | iOS only - throws elsewhere.               |
+| `printToFileAsync`  | `(options?: IFilePrintOptions) => Promise<IFilePrintResult>` | Renders HTML to a PDF in the cache dir.    |
+| `Orientation`       | `{ portrait: string; landscape: string }`                | Values for `IPrintOptions.orientation`.    |
+
+## Notes
+
+- **One print job at a time.** A second `printAsync` call while one is in flight rejects
+  immediately - same guard upstream keeps as module-level state.
+- **`markupFormatterIOS` is kept as upstream's deprecated option.** On iOS it stands in for
+  `html`/`uri`, warns on every call, and `useMarkupFormatter` is the replacement.
+
+## Common questions
+
+- **Images missing from the page or PDF.** A local `file://` image can fail inside HTML, and may
+  work in development but not in release. Embed it as a base64 `data:` URI or use an `https://` URL.
+- **Extra blank page at the end.** A known HTML-to-PDF quirk: keep content slightly shorter than the
+  page, and set margins with an `@page { margin: ... }` rule.
+- **Page size and margins.** `width`/`height` (pixels, default 612 by 792) and `margins`, or `@page`.
+- **Save or share the PDF.** Pass the `uri` from `printToFileAsync` to
+  [`@symbiote-native/sharing`](../sharing).
+
+Sources: [Expo docs: Print](https://docs.expo.dev/versions/latest/sdk/print/),
+[expo/expo#6169](https://github.com/expo/expo/issues/6169),
+[expo/expo#7435](https://github.com/expo/expo/issues/7435),
+[expo/expo#24011](https://github.com/expo/expo/issues/24011).
+
+## Test it
+
+```bash
+pnpm vitest run packages/print
+```
+
+The core tests fake the native module in place of `requireNativeModule`'s runtime resolution -
+`ExpoPrint` only exists on a device, so a headless run would otherwise throw at import. Upstream
+ships no test suite of its own (`expo-print`'s `src/` has no `__tests__`), so nothing to port -
+every test here is net-new coverage of the ported logic (input validation, the in-flight guard,
+the `selectPrinter`-unavailable branch).

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 { Orientation, printAsync, printToFileAsync, selectPrinterAsync, } from './print';
+export type { IFilePrintOptions, IFilePrintResult, IPageMargins, IPrintOptions, IPrintOrientation, IPrinter, } from './types';

package/build/core/index.js

@@ -0,0 +1 @@
+export { Orientation, printAsync, printToFileAsync, selectPrinterAsync, } from './print.js';

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

@@ -0,0 +1,9 @@
+import type { IFilePrintOptions, IFilePrintResult, IPrintOptions, IPrintOrientation, IPrinter } from './types';
+export type INativePrintModule = {
+    Orientation: IPrintOrientation;
+    print(options: IPrintOptions): Promise<void>;
+    /** iOS only — absent on Android's native module. */
+    selectPrinter?(): Promise<IPrinter>;
+    printToFileAsync(options: IFilePrintOptions): Promise<IFilePrintResult>;
+};
+export declare const expoPrint: INativePrintModule;

package/build/core/native-module.js

@@ -0,0 +1,3 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_PRINT_MODULE_NAME = 'ExpoPrint';
+export const expoPrint = requireNativeModule(EXPO_PRINT_MODULE_NAME);

package/build/core/print.d.ts

@@ -0,0 +1,8 @@
+import type { IFilePrintOptions, IFilePrintResult, IPrintOptions, IPrinter } from './types';
+export declare const Orientation: import("./types").IPrintOrientation;
+/** Opens the native print window (AirPrint / Android's print framework). */
+export declare function printAsync(options: IPrintOptions): Promise<void>;
+/** Opens a printer picker; the result feeds `printerUrl` into `printAsync`. iOS only. */
+export declare function selectPrinterAsync(): Promise<IPrinter>;
+/** Renders HTML to a PDF file in the app's cache directory. */
+export declare function printToFileAsync(options?: IFilePrintOptions): Promise<IFilePrintResult>;

package/build/core/print.js

@@ -0,0 +1,42 @@
+import { Platform, UnavailabilityError } from 'expo-modules-core';
+import { expoPrint } from './native-module.js';
+export const Orientation = expoPrint.Orientation;
+let isPrinting = false;
+/** Opens the native print window (AirPrint / Android's print framework). */
+export async function printAsync(options) {
+    // The deprecated formatter option stands in for `html` and `uri` on iOS only
+    const hasMarkupFormatter = Platform.select({
+        ios: Boolean(options.markupFormatterIOS),
+        default: false,
+    });
+    if (!options.uri && !options.html && !hasMarkupFormatter) {
+        throw new Error('Must provide either `html` or `uri` to print');
+    }
+    if (options.uri && options.html) {
+        throw new Error('Must provide exactly one of `html` and `uri` but both were specified');
+    }
+    if (options.markupFormatterIOS !== undefined) {
+        console.warn('The markupFormatterIOS option is deprecated. Use useMarkupFormatter instead.');
+    }
+    if (isPrinting) {
+        throw new Error('Another print request is already in progress');
+    }
+    isPrinting = true;
+    try {
+        return await expoPrint.print(options);
+    }
+    finally {
+        isPrinting = false;
+    }
+}
+/** Opens a printer picker; the result feeds `printerUrl` into `printAsync`. iOS only. */
+export async function selectPrinterAsync() {
+    if (expoPrint.selectPrinter) {
+        return await expoPrint.selectPrinter();
+    }
+    throw new UnavailabilityError('Print', 'selectPrinterAsync');
+}
+/** Renders HTML to a PDF file in the app's cache directory. */
+export async function printToFileAsync(options = {}) {
+    return await expoPrint.printToFileAsync(options);
+}

package/build/core/types.d.ts

@@ -0,0 +1,48 @@
+export type IPageMargins = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export type IPrintOrientation = {
+    portrait: string;
+    landscape: string;
+};
+export type IPrintOptions = {
+    /** PDF file URI — remote, local, or a `data:application/pdf;base64,` URI. iOS + Android. */
+    uri?: string;
+    /** HTML string to print. iOS + Android. */
+    html?: string;
+    /** Page width in pixels. Defaults to 612 (US Letter @ 72 PPI). Only with `html`. */
+    width?: number;
+    /** Page height in pixels. Defaults to 792 (US Letter @ 72 PPI). Only with `html`. */
+    height?: number;
+    /** Printer URL from `selectPrinterAsync`. iOS only. */
+    printerUrl?: string;
+    /** Uses UIMarkupTextPrintFormatter instead of WebView — no images. iOS only. */
+    useMarkupFormatter?: boolean;
+    /** @deprecated Use `useMarkupFormatter` instead. iOS only */
+    markupFormatterIOS?: string;
+    orientation?: string;
+    margins?: IPageMargins;
+};
+export type IPrinter = {
+    name: string;
+    url: string;
+};
+export type IFilePrintOptions = {
+    html?: string;
+    useMarkupFormatter?: boolean;
+    width?: number;
+    height?: number;
+    margins?: IPageMargins;
+    base64?: boolean;
+    /** Android only. Default 100. */
+    textZoom?: number;
+};
+export type IFilePrintResult = {
+    uri: string;
+    numberOfPages: number;
+    /** Present only when `base64` was requested; no `data:` prefix. */
+    base64?: string;
+};

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 { Orientation, printAsync, printToFileAsync, selectPrinterAsync, } from './print';
+export type { IFilePrintOptions, IFilePrintResult, IPageMargins, IPrintOptions, IPrintOrientation, IPrinter, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,2 @@
+export { Orientation, printAsync, printToFileAsync, selectPrinterAsync, } from './print';
+//# 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,EACL,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { IFilePrintOptions, IFilePrintResult, IPrintOptions, IPrintOrientation, IPrinter } from './types';
+export type INativePrintModule = {
+    Orientation: IPrintOrientation;
+    print(options: IPrintOptions): Promise<void>;
+    /** iOS only — absent on Android's native module. */
+    selectPrinter?(): Promise<IPrinter>;
+    printToFileAsync(options: IFilePrintOptions): Promise<IFilePrintResult>;
+};
+export declare const expoPrint: INativePrintModule;

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

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_PRINT_MODULE_NAME = 'ExpoPrint';
+export const expoPrint = requireNativeModule(EXPO_PRINT_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;AASxD,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAU3C,MAAM,CAAC,MAAM,SAAS,GAAG,mBAAmB,CAC1C,sBAAsB,CACvB,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { IFilePrintOptions, IFilePrintResult, IPrintOptions, IPrinter } from './types';
+export declare const Orientation: import("./types").IPrintOrientation;
+/** Opens the native print window (AirPrint / Android's print framework). */
+export declare function printAsync(options: IPrintOptions): Promise<void>;
+/** Opens a printer picker; the result feeds `printerUrl` into `printAsync`. iOS only. */
+export declare function selectPrinterAsync(): Promise<IPrinter>;
+/** Renders HTML to a PDF file in the app's cache directory. */
+export declare function printToFileAsync(options?: IFilePrintOptions): Promise<IFilePrintResult>;

package/build-ngc/core/print.js

@@ -0,0 +1,43 @@
+import { Platform, UnavailabilityError } from 'expo-modules-core';
+import { expoPrint } from './native-module';
+export const Orientation = expoPrint.Orientation;
+let isPrinting = false;
+/** Opens the native print window (AirPrint / Android's print framework). */
+export async function printAsync(options) {
+    // The deprecated formatter option stands in for `html` and `uri` on iOS only
+    const hasMarkupFormatter = Platform.select({
+        ios: Boolean(options.markupFormatterIOS),
+        default: false,
+    });
+    if (!options.uri && !options.html && !hasMarkupFormatter) {
+        throw new Error('Must provide either `html` or `uri` to print');
+    }
+    if (options.uri && options.html) {
+        throw new Error('Must provide exactly one of `html` and `uri` but both were specified');
+    }
+    if (options.markupFormatterIOS !== undefined) {
+        console.warn('The markupFormatterIOS option is deprecated. Use useMarkupFormatter instead.');
+    }
+    if (isPrinting) {
+        throw new Error('Another print request is already in progress');
+    }
+    isPrinting = true;
+    try {
+        return await expoPrint.print(options);
+    }
+    finally {
+        isPrinting = false;
+    }
+}
+/** Opens a printer picker; the result feeds `printerUrl` into `printAsync`. iOS only. */
+export async function selectPrinterAsync() {
+    if (expoPrint.selectPrinter) {
+        return await expoPrint.selectPrinter();
+    }
+    throw new UnavailabilityError('Print', 'selectPrinterAsync');
+}
+/** Renders HTML to a PDF file in the app's cache directory. */
+export async function printToFileAsync(options = {}) {
+    return await expoPrint.printToFileAsync(options);
+}
+//# sourceMappingURL=print.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../src/core/print.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;AAEjD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAsB;IACrD,6EAA6E;IAC7E,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC;QACzC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACxC,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CACV,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,UAAU,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,UAAU,GAAG,KAAK,CAAC;IACrB,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;QAC5B,OAAO,MAAM,SAAS,CAAC,aAAa,EAAE,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;AAC/D,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAA6B,EAAE;IAE/B,OAAO,MAAM,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC"}

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

@@ -0,0 +1,48 @@
+export type IPageMargins = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+};
+export type IPrintOrientation = {
+    portrait: string;
+    landscape: string;
+};
+export type IPrintOptions = {
+    /** PDF file URI — remote, local, or a `data:application/pdf;base64,` URI. iOS + Android. */
+    uri?: string;
+    /** HTML string to print. iOS + Android. */
+    html?: string;
+    /** Page width in pixels. Defaults to 612 (US Letter @ 72 PPI). Only with `html`. */
+    width?: number;
+    /** Page height in pixels. Defaults to 792 (US Letter @ 72 PPI). Only with `html`. */
+    height?: number;
+    /** Printer URL from `selectPrinterAsync`. iOS only. */
+    printerUrl?: string;
+    /** Uses UIMarkupTextPrintFormatter instead of WebView — no images. iOS only. */
+    useMarkupFormatter?: boolean;
+    /** @deprecated Use `useMarkupFormatter` instead. iOS only */
+    markupFormatterIOS?: string;
+    orientation?: string;
+    margins?: IPageMargins;
+};
+export type IPrinter = {
+    name: string;
+    url: string;
+};
+export type IFilePrintOptions = {
+    html?: string;
+    useMarkupFormatter?: boolean;
+    width?: number;
+    height?: number;
+    margins?: IPageMargins;
+    base64?: boolean;
+    /** Android only. Default 100. */
+    textZoom?: number;
+};
+export type IFilePrintResult = {
+    uri: string;
+    numberOfPages: number;
+    /** Present only when `base64` was requested; no `data:` prefix. */
+    base64?: string;
+};

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,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-print",
+    "modules": [
+      {
+        "importPath": "expo.modules.print.PrintModule",
+        "className": "PrintModule",
+        "nativeName": "ExpoPrint"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,151 @@
+{
+  "name": "@symbiote-native/print",
+  "version": "0.1.0",
+  "description": "expo-print wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Prints a PDF/HTML document (AirPrint on iOS, the print framework on Android) or renders HTML to a PDF file.",
+  "license": "MIT",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-print",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "print",
+    "airprint",
+    "pdf"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/print"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/print#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-print": "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/solid": "^3.0.5",
+    "@symbiote-native/react": "^3.1.0",
+    "@symbiote-native/engine": "^1.4.0",
+    "@symbiote-native/svelte": "^3.0.5",
+    "@symbiote-native/vue": "^3.1.0"
+  },
+  "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,14 @@
+export {
+  Orientation,
+  printAsync,
+  printToFileAsync,
+  selectPrinterAsync,
+} from './print';
+export type {
+  IFilePrintOptions,
+  IFilePrintResult,
+  IPageMargins,
+  IPrintOptions,
+  IPrintOrientation,
+  IPrinter,
+} from './types';

package/src/core/native-module.ts

@@ -0,0 +1,22 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type {
+  IFilePrintOptions,
+  IFilePrintResult,
+  IPrintOptions,
+  IPrintOrientation,
+  IPrinter,
+} from './types';
+
+const EXPO_PRINT_MODULE_NAME = 'ExpoPrint';
+
+export type INativePrintModule = {
+  Orientation: IPrintOrientation;
+  print(options: IPrintOptions): Promise<void>;
+  /** iOS only — absent on Android's native module. */
+  selectPrinter?(): Promise<IPrinter>;
+  printToFileAsync(options: IFilePrintOptions): Promise<IFilePrintResult>;
+};
+
+export const expoPrint = requireNativeModule<INativePrintModule>(
+  EXPO_PRINT_MODULE_NAME,
+);

package/src/core/print.ts

@@ -0,0 +1,59 @@
+import { Platform, UnavailabilityError } from 'expo-modules-core';
+import { expoPrint } from './native-module';
+import type {
+  IFilePrintOptions,
+  IFilePrintResult,
+  IPrintOptions,
+  IPrinter,
+} from './types';
+
+export const Orientation = expoPrint.Orientation;
+
+let isPrinting = false;
+
+/** Opens the native print window (AirPrint / Android's print framework). */
+export async function printAsync(options: IPrintOptions): Promise<void> {
+  // The deprecated formatter option stands in for `html` and `uri` on iOS only
+  const hasMarkupFormatter = Platform.select({
+    ios: Boolean(options.markupFormatterIOS),
+    default: false,
+  });
+  if (!options.uri && !options.html && !hasMarkupFormatter) {
+    throw new Error('Must provide either `html` or `uri` to print');
+  }
+  if (options.uri && options.html) {
+    throw new Error(
+      'Must provide exactly one of `html` and `uri` but both were specified',
+    );
+  }
+  if (options.markupFormatterIOS !== undefined) {
+    console.warn(
+      'The markupFormatterIOS option is deprecated. Use useMarkupFormatter instead.',
+    );
+  }
+  if (isPrinting) {
+    throw new Error('Another print request is already in progress');
+  }
+
+  isPrinting = true;
+  try {
+    return await expoPrint.print(options);
+  } finally {
+    isPrinting = false;
+  }
+}
+
+/** Opens a printer picker; the result feeds `printerUrl` into `printAsync`. iOS only. */
+export async function selectPrinterAsync(): Promise<IPrinter> {
+  if (expoPrint.selectPrinter) {
+    return await expoPrint.selectPrinter();
+  }
+  throw new UnavailabilityError('Print', 'selectPrinterAsync');
+}
+
+/** Renders HTML to a PDF file in the app's cache directory. */
+export async function printToFileAsync(
+  options: IFilePrintOptions = {},
+): Promise<IFilePrintResult> {
+  return await expoPrint.printToFileAsync(options);
+}

package/src/core/types.ts

@@ -0,0 +1,53 @@
+export type IPageMargins = {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+};
+
+export type IPrintOrientation = {
+  portrait: string;
+  landscape: string;
+};
+
+export type IPrintOptions = {
+  /** PDF file URI — remote, local, or a `data:application/pdf;base64,` URI. iOS + Android. */
+  uri?: string;
+  /** HTML string to print. iOS + Android. */
+  html?: string;
+  /** Page width in pixels. Defaults to 612 (US Letter @ 72 PPI). Only with `html`. */
+  width?: number;
+  /** Page height in pixels. Defaults to 792 (US Letter @ 72 PPI). Only with `html`. */
+  height?: number;
+  /** Printer URL from `selectPrinterAsync`. iOS only. */
+  printerUrl?: string;
+  /** Uses UIMarkupTextPrintFormatter instead of WebView — no images. iOS only. */
+  useMarkupFormatter?: boolean;
+  /** @deprecated Use `useMarkupFormatter` instead. iOS only */
+  markupFormatterIOS?: string;
+  orientation?: string;
+  margins?: IPageMargins;
+};
+
+export type IPrinter = {
+  name: string;
+  url: string;
+};
+
+export type IFilePrintOptions = {
+  html?: string;
+  useMarkupFormatter?: boolean;
+  width?: number;
+  height?: number;
+  margins?: IPageMargins;
+  base64?: boolean;
+  /** Android only. Default 100. */
+  textZoom?: number;
+};
+
+export type IFilePrintResult = {
+  uri: string;
+  numberOfPages: number;
+  /** Present only when `base64` was requested; no `data:` prefix. */
+  base64?: string;
+};