@ng-native/expo 0.0.1 → 0.1.1

package/dist/map-view.js

@@ -0,0 +1,184 @@
+/**
+ * `<expo-map>`: `expo-maps`' Apple map on iOS and its Google map on Android, with markers,
+ * polylines, polygons and circles, a camera, and taps.
+ *
+ * ```ts
+ * registerExpoMap(Platform.OS); // once, at startup
+ *
+ * @Component({
+ *   imports: [MapView],
+ *   template: `
+ *     <expo-map class="flex-1" [markers]="stations" [cameraPosition]="london"
+ *       (markerClick)="open($event.nativeEvent.id)" />
+ *   `,
+ * })
+ * export class Stations {
+ *   private readonly map = viewChild.required(MapView);
+ *   zoomIn() { this.map().setCameraPosition({ coordinates: KINGS_CROSS, zoom: 16 }); }
+ * }
+ * ```
+ *
+ * One element rather than one per platform because the two views share everything an app reaches
+ * for first: a marker list, a camera position, the same three events and the same two view
+ * functions. What differs is inside the option objects, and each platform's native side reads only
+ * the fields it knows, so an app writes one template. The enum-valued options are the exception
+ * (a map type is `STANDARD` on iOS and `NORMAL` on Android) and are typed as either.
+ *
+ * Each input goes straight to the view as the prop `expo-maps` names it, except that a shape's
+ * colours are converted first, as `expo-maps`' own React components run them through
+ * `processColor`: native reads the converted value. The outputs are declared
+ * for their types only and are never emitted: the view's own event is what reaches `(markerClick)`,
+ * as with the components in `expo-ui-components.ts`, so `$event` is a native event and the payload
+ * is its `nativeEvent`.
+ *
+ * `setCameraPosition` and `selectMarker` are the functions `expo-maps` defines on the view. In
+ * React they are methods on a ref; underneath, native finds the view by the `nativeTag` it is
+ * called with, so they are called here with the tag the engine committed the view under.
+ *
+ * A committed view has a tag before native has mounted anything under it, and a function called
+ * in between finds no view to run on. So calls are held until the map says it is there, which both
+ * platforms do with a camera move once it first appears, and `ready` says whether it has.
+ */
+import { Component, DestroyRef, computed, ElementRef, InjectionToken, inject, input, output, signal, } from '@angular/core';
+import { Engine } from '@ng-native/fabric';
+import { expoModule, optional } from "./native.js";
+import { registerExpoView } from "./register-expo-view.js";
+import * as i0 from "@angular/core";
+/**
+ * Make `<expo-map>` commit as the platform's map: `ExpoAppleMaps` on iOS, `ExpoGoogleMaps` on
+ * Android. Each is its module's only view, so its default. Call once, before the first map.
+ */
+export function registerExpoMap(platform) {
+    registerExpoView('expo-map', platform === 'ios' ? 'ExpoAppleMaps' : 'ExpoGoogleMaps');
+}
+export class MapView {
+    /** Overridden in a test to move a camera without a map. */
+    static SOURCE = new InjectionToken('angular-native.mapViewSource', {
+        factory: () => {
+            const core = optional(() => require('expo-modules-core'));
+            // Only one of the two modules exists on a platform. Each map is its module's default
+            // view, so its functions are under the module's own name.
+            const functions = (module) => core?.requireOptionalNativeModule(module)?.ViewPrototypes?.[module];
+            return expoModule('expo-maps', () => functions('ExpoAppleMaps') ?? functions('ExpoGoogleMaps'));
+        },
+    });
+    functions = inject(MapView.SOURCE);
+    engine = inject(Engine);
+    node = inject(ElementRef).nativeElement;
+    appeared = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "appeared" }] : /* istanbul ignore next */ []));
+    /** Calls made before the map appeared, in the order they were made. */
+    held = [];
+    markers = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "markers" }] : /* istanbul ignore next */ []));
+    /** Lines, such as a route. */
+    polylines = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "polylines" }] : /* istanbul ignore next */ []));
+    /** Filled shapes. */
+    polygons = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "polygons" }] : /* istanbul ignore next */ []));
+    circles = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "circles" }] : /* istanbul ignore next */ []));
+    /** Where the camera is. A changed value moves it; so does `setCameraPosition`. */
+    cameraPosition = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "cameraPosition" }] : /* istanbul ignore next */ []));
+    properties = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "properties" }] : /* istanbul ignore next */ []));
+    uiSettings = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "uiSettings" }] : /* istanbul ignore next */ []));
+    colorScheme = input(/* @ts-ignore */
+    ...(ngDevMode ? [undefined, { debugName: "colorScheme" }] : /* istanbul ignore next */ []));
+    /** A tap on the map, not on a marker. */
+    mapClick = output();
+    /** A tap on a marker, with the marker as it was given. iOS 18 and later on iOS. */
+    markerClick = output();
+    /** The camera moved, by the user or by the app. Also sent once when the map first appears. */
+    cameraMove = output();
+    /** A tap on a polyline, a polygon or a circle. iOS 18 and later on iOS. */
+    polylineClick = output();
+    polygonClick = output();
+    circleClick = output();
+    nativePolylines = computed(() => this.polylines()?.map((line) => ({ ...line, color: this.engine.color(line.color) })), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "nativePolylines" }] : /* istanbul ignore next */ []));
+    nativePolygons = computed(() => this.polygons()?.map((shape) => this.filled(shape)), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "nativePolygons" }] : /* istanbul ignore next */ []));
+    nativeCircles = computed(() => this.circles()?.map((shape) => this.filled(shape)), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "nativeCircles" }] : /* istanbul ignore next */ []));
+    /**
+     * Whether the native map is on screen, so its functions can reach it. Until then
+     * `setCameraPosition` and `selectMarker` are held, and sent in order once it is.
+     */
+    ready = this.appeared.asReadonly();
+    constructor() {
+        const stop = this.engine.setEventListener(this.node, 'topCameraMove', () => this.appear());
+        inject(DestroyRef).onDestroy(() => {
+            stop();
+            this.release(false);
+        });
+    }
+    /**
+     * Move the camera. Held until the map is on screen, and false without the module or if the map
+     * goes before it gets there: there was never a map to move.
+     */
+    setCameraPosition(position) {
+        return this.call((functions, nativeTag) => functions.setCameraPosition.call({ nativeTag }, position));
+    }
+    /** Select a marker by its `id`, as a tap would, or clear the selection with none. */
+    selectMarker(id, options) {
+        return this.call((functions, nativeTag) => functions.selectMarker.call({ nativeTag }, id, options));
+    }
+    async call(run) {
+        const functions = this.functions;
+        if (!functions)
+            return false;
+        if (!this.appeared() && !(await new Promise((resolve) => this.held.push(resolve)))) {
+            return false;
+        }
+        const nativeTag = this.engine.tagOf(this.node);
+        if (nativeTag === null)
+            return false;
+        await run(functions, nativeTag);
+        return true;
+    }
+    filled(shape) {
+        return {
+            ...shape,
+            color: this.engine.color(shape.color),
+            lineColor: this.engine.color(shape.lineColor),
+        };
+    }
+    appear() {
+        if (this.appeared())
+            return;
+        this.appeared.set(true);
+        this.release(true);
+    }
+    /** Let every held call go, to native if the map is there and back to its caller if not. */
+    release(ready) {
+        const held = this.held;
+        this.held = [];
+        for (const resolve of held)
+            resolve(ready);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: MapView, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "22.2.0", type: MapView, isStandalone: true, selector: "expo-map", inputs: { markers: { classPropertyName: "markers", publicName: "markers", isSignal: true, isRequired: false, transformFunction: null }, polylines: { classPropertyName: "polylines", publicName: "polylines", isSignal: true, isRequired: false, transformFunction: null }, polygons: { classPropertyName: "polygons", publicName: "polygons", isSignal: true, isRequired: false, transformFunction: null }, circles: { classPropertyName: "circles", publicName: "circles", isSignal: true, isRequired: false, transformFunction: null }, cameraPosition: { classPropertyName: "cameraPosition", publicName: "cameraPosition", isSignal: true, isRequired: false, transformFunction: null }, properties: { classPropertyName: "properties", publicName: "properties", isSignal: true, isRequired: false, transformFunction: null }, uiSettings: { classPropertyName: "uiSettings", publicName: "uiSettings", isSignal: true, isRequired: false, transformFunction: null }, colorScheme: { classPropertyName: "colorScheme", publicName: "colorScheme", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { mapClick: "mapClick", markerClick: "markerClick", cameraMove: "cameraMove", polylineClick: "polylineClick", polygonClick: "polygonClick", circleClick: "circleClick" }, host: { properties: { "markers": "markers()", "polylines": "nativePolylines()", "polygons": "nativePolygons()", "circles": "nativeCircles()", "cameraPosition": "cameraPosition()", "properties": "properties()", "uiSettings": "uiSettings()", "colorScheme": "colorScheme()" } }, exportAs: ["map"], ngImport: i0, template: '', isInline: true });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: MapView, decorators: [{
+            type: Component,
+            args: [{
+                    selector: 'expo-map',
+                    exportAs: 'map',
+                    template: '',
+                    host: {
+                        '[markers]': 'markers()',
+                        '[polylines]': 'nativePolylines()',
+                        '[polygons]': 'nativePolygons()',
+                        '[circles]': 'nativeCircles()',
+                        '[cameraPosition]': 'cameraPosition()',
+                        '[properties]': 'properties()',
+                        '[uiSettings]': 'uiSettings()',
+                        '[colorScheme]': 'colorScheme()',
+                    },
+                }]
+        }], ctorParameters: () => [], propDecorators: { markers: [{ type: i0.Input, args: [{ isSignal: true, alias: "markers", required: false }] }], polylines: [{ type: i0.Input, args: [{ isSignal: true, alias: "polylines", required: false }] }], polygons: [{ type: i0.Input, args: [{ isSignal: true, alias: "polygons", required: false }] }], circles: [{ type: i0.Input, args: [{ isSignal: true, alias: "circles", required: false }] }], cameraPosition: [{ type: i0.Input, args: [{ isSignal: true, alias: "cameraPosition", required: false }] }], properties: [{ type: i0.Input, args: [{ isSignal: true, alias: "properties", required: false }] }], uiSettings: [{ type: i0.Input, args: [{ isSignal: true, alias: "uiSettings", required: false }] }], colorScheme: [{ type: i0.Input, args: [{ isSignal: true, alias: "colorScheme", required: false }] }], mapClick: [{ type: i0.Output, args: ["mapClick"] }], markerClick: [{ type: i0.Output, args: ["markerClick"] }], cameraMove: [{ type: i0.Output, args: ["cameraMove"] }], polylineClick: [{ type: i0.Output, args: ["polylineClick"] }], polygonClick: [{ type: i0.Output, args: ["polygonClick"] }], circleClick: [{ type: i0.Output, args: ["circleClick"] }] } });
+//# sourceMappingURL=map-view.js.map

package/dist/map-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-view.js","sourceRoot":"","sources":["../src/map-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,GACP,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAA8C,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;;AAmG3D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAA2B;IACzD,gBAAgB,CAAC,UAAU,EAAE,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACxF,CAAC;AAiBD,MAAM,OAAO,OAAO;IAClB,2DAA2D;IAC3D,MAAM,CAAU,MAAM,GAAG,IAAI,cAAc,CACzC,8BAA8B,EAC9B;QACE,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,IAAI,GAAG,QAAQ,CACnB,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAuC,CACzE,CAAC;YACF,qFAAqF;YACrF,0DAA0D;YAC1D,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,EAAE,CACnC,IAAI,EAAE,2BAA2B,CAE9B,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC;YACvC,OAAO,UAAU,CACf,WAAW,EACX,GAAG,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAChE,CAAC;QACJ,CAAC;KACF,CACF,CAAC;IAEe,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,GAAG,MAAM,CAAyB,UAAU,CAAC,CAAC,aAAa,CAAC;IAChE,QAAQ,GAAG,MAAM,CAAC,KAAK;iFAAC,CAAC;IAC1C,uEAAuE;IAC/D,IAAI,GAAiC,EAAE,CAAC;IAEvC,OAAO,GAAG,KAAK;2FAAwB,CAAC;IACjD,8BAA8B;IACrB,SAAS,GAAG,KAAK;6FAA0B,CAAC;IACrD,qBAAqB;IACZ,QAAQ,GAAG,KAAK;4FAAyB,CAAC;IAC1C,OAAO,GAAG,KAAK;2FAAwB,CAAC;IACjD,kFAAkF;IACzE,cAAc,GAAG,KAAK;kGAAqB,CAAC;IAC5C,UAAU,GAAG,KAAK;8FAAiB,CAAC;IACpC,UAAU,GAAG,KAAK;8FAAiB,CAAC;IACpC,WAAW,GAAG,KAAK;+FAAkB,CAAC;IAE/C,yCAAyC;IAChC,QAAQ,GAAG,MAAM,EAAiB,CAAC;IAC5C,mFAAmF;IAC1E,WAAW,GAAG,MAAM,EAAuB,CAAC;IACrD,8FAA8F;IACrF,UAAU,GAAG,MAAM,EAAsB,CAAC;IACnD,2EAA2E;IAClE,aAAa,GAAG,MAAM,EAAyB,CAAC;IAChD,YAAY,GAAG,MAAM,EAAwB,CAAC;IAC9C,WAAW,GAAG,MAAM,EAAuB,CAAC;IAElC,eAAe,GAAG,QAAQ,CAAC,GAAG,EAAE,CACjD,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;wFACrF,CAAC;IACiB,cAAc,GAAG,QAAQ,CAAC,GAAG,EAAE,CAChD,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;uFACpD,CAAC;IACiB,aAAa,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC/C,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;sFACnD,CAAC;IAEF;;;OAGG;IACM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAE5C;QACE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;YAChC,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,QAAuB;QACvC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACxC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC,CAC1D,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,YAAY,CAAC,EAAW,EAAE,OAA0B;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACxC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,CACxD,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,GAAsE;QAEtE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACrC,MAAM,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,MAAM,CAAmC,KAAQ;QACvD,OAAO;YACL,GAAG,KAAK;YACR,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;YACrC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;SAC9C,CAAC;IACJ,CAAC;IAEO,MAAM;QACZ,IAAI,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,2FAA2F;IACnF,OAAO,CAAC,KAAc;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,KAAK,MAAM,OAAO,IAAI,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;uGA/HU,OAAO;2FAAP,OAAO,slDAZR,EAAE;;2FAYD,OAAO;kBAfnB,SAAS;mBAAC;oBACT,QAAQ,EAAE,UAAU;oBACpB,QAAQ,EAAE,KAAK;oBACf,QAAQ,EAAE,EAAE;oBACZ,IAAI,EAAE;wBACJ,WAAW,EAAE,WAAW;wBACxB,aAAa,EAAE,mBAAmB;wBAClC,YAAY,EAAE,kBAAkB;wBAChC,WAAW,EAAE,iBAAiB;wBAC9B,kBAAkB,EAAE,kBAAkB;wBACtC,cAAc,EAAE,cAAc;wBAC9B,cAAc,EAAE,cAAc;wBAC9B,eAAe,EAAE,eAAe;qBACjC;iBACF","sourcesContent":["/**\n * `<expo-map>`: `expo-maps`' Apple map on iOS and its Google map on Android, with markers,\n * polylines, polygons and circles, a camera, and taps.\n *\n * ```ts\n * registerExpoMap(Platform.OS); // once, at startup\n *\n * @Component({\n *   imports: [MapView],\n *   template: `\n *     <expo-map class=\"flex-1\" [markers]=\"stations\" [cameraPosition]=\"london\"\n *       (markerClick)=\"open($event.nativeEvent.id)\" />\n *   `,\n * })\n * export class Stations {\n *   private readonly map = viewChild.required(MapView);\n *   zoomIn() { this.map().setCameraPosition({ coordinates: KINGS_CROSS, zoom: 16 }); }\n * }\n * ```\n *\n * One element rather than one per platform because the two views share everything an app reaches\n * for first: a marker list, a camera position, the same three events and the same two view\n * functions. What differs is inside the option objects, and each platform's native side reads only\n * the fields it knows, so an app writes one template. The enum-valued options are the exception\n * (a map type is `STANDARD` on iOS and `NORMAL` on Android) and are typed as either.\n *\n * Each input goes straight to the view as the prop `expo-maps` names it, except that a shape's\n * colours are converted first, as `expo-maps`' own React components run them through\n * `processColor`: native reads the converted value. The outputs are declared\n * for their types only and are never emitted: the view's own event is what reaches `(markerClick)`,\n * as with the components in `expo-ui-components.ts`, so `$event` is a native event and the payload\n * is its `nativeEvent`.\n *\n * `setCameraPosition` and `selectMarker` are the functions `expo-maps` defines on the view. In\n * React they are methods on a ref; underneath, native finds the view by the `nativeTag` it is\n * called with, so they are called here with the tag the engine committed the view under.\n *\n * A committed view has a tag before native has mounted anything under it, and a function called\n * in between finds no view to run on. So calls are held until the map says it is there, which both\n * platforms do with a camera move once it first appears, and `ready` says whether it has.\n */\nimport {\n  Component,\n  DestroyRef,\n  computed,\n  ElementRef,\n  InjectionToken,\n  inject,\n  input,\n  output,\n  signal,\n} from '@angular/core';\nimport { Engine, type EngineNode, type NativeSyntheticEvent } from '@ng-native/fabric';\nimport type { AppleMaps, CameraMoveEvent, Coordinates, GoogleMaps } from 'expo-maps';\nimport { expoModule, optional } from './native.ts';\nimport { registerExpoView } from './register-expo-view.ts';\n\n/** `expo-maps`' types with its enums as their string values, so no import of the module is needed. */\ntype Plain<T> = T extends string\n  ? `${T}`\n  : T extends readonly (infer U)[]\n    ? readonly Plain<U>[]\n    : T extends object\n      ? { readonly [K in keyof T]: Plain<T[K]> }\n      : T;\n\nexport type MapCoordinates = Coordinates;\nexport type MapCameraPosition = import('expo-maps').CameraPosition;\n\n/**\n * A marker. `id`, `coordinates` and `title` work on both platforms; `systemImage`, `monogram` and\n * `tintColor` are Apple's, `snippet`, `draggable`, `showCallout`, `anchor` and `zIndex` Google's.\n */\nexport type MapMarker = Plain<AppleMaps.Marker> & Plain<Omit<GoogleMaps.Marker, 'icon'>>;\n\n/** The map's properties: Apple's on iOS, Google's on Android. */\nexport type MapProperties = Plain<AppleMaps.MapProperties> | Plain<GoogleMaps.MapProperties>;\n\n/** Which controls the map shows. Each platform reads the settings it has. */\nexport type MapUiSettings = AppleMaps.MapUISettings & GoogleMaps.MapUISettings;\n\n/** `LIGHT` and `DARK` on both; `AUTOMATIC` is iOS's and `FOLLOW_SYSTEM` Android's. */\nexport type MapColorScheme = `${AppleMaps.MapColorScheme}` | `${GoogleMaps.MapColorScheme}`;\n\n/** A colour, as a template writes one: `'#ff5a36'`, `'rgba(0, 0, 0, 0.5)'`, `'green'`. */\nexport type MapColor = string;\n\n/**\n * A line through `coordinates`, such as a route. `contourStyle` is Apple's, `geodesic` Google's:\n * both draw the line along the Earth's curve rather than straight across the map.\n */\nexport interface MapPolyline {\n  readonly id?: string;\n  readonly coordinates: readonly MapCoordinates[];\n  readonly color?: MapColor;\n  readonly width?: number;\n  readonly contourStyle?: `${AppleMaps.ContourStyle}`;\n  readonly geodesic?: boolean;\n}\n\n/** A filled shape with `coordinates` as its corners. */\nexport interface MapPolygon {\n  readonly id?: string;\n  readonly coordinates: readonly MapCoordinates[];\n  readonly color?: MapColor;\n  readonly lineColor?: MapColor;\n  readonly lineWidth?: number;\n}\n\n/** A filled circle, `radius` metres across from `center`. */\nexport interface MapCircle {\n  readonly id?: string;\n  readonly center: MapCoordinates;\n  readonly radius: number;\n  readonly color?: MapColor;\n  readonly lineColor?: MapColor;\n  readonly lineWidth?: number;\n}\n\n/** Where to move the camera. `duration`, in milliseconds, is Android's; iOS does not animate it. */\nexport type MapCameraMove = MapCameraPosition & { readonly duration?: number };\n\nexport interface MapSelectOptions {\n  /** The zoom to animate to. */\n  readonly zoom?: number;\n  /** Whether to move the camera to the marker at all. Defaults to true. */\n  readonly moveCamera?: boolean;\n}\n\nexport type MapClickEvent = NativeSyntheticEvent<{ readonly coordinates: MapCoordinates }>;\nexport type MapMarkerClickEvent = NativeSyntheticEvent<MapMarker>;\nexport type MapCameraMoveEvent = NativeSyntheticEvent<CameraMoveEvent>;\n/** A tapped shape, as native holds it: its colours are native's own values, not strings. */\ntype Tapped<T> = Omit<T, 'color' | 'lineColor'> & {\n  readonly color?: unknown;\n  readonly lineColor?: unknown;\n};\nexport type MapPolylineClickEvent = NativeSyntheticEvent<Tapped<MapPolyline>>;\nexport type MapPolygonClickEvent = NativeSyntheticEvent<Tapped<MapPolygon>>;\n/** Android sends the circle's `center` and where it was tapped; iOS sends its centre as `coordinates`. */\nexport type MapCircleClickEvent = NativeSyntheticEvent<\n  Omit<Tapped<MapCircle>, 'center'> & {\n    readonly center?: MapCoordinates;\n    readonly coordinates?: MapCoordinates;\n    readonly clickCoordinates?: MapCoordinates;\n  }\n>;\n\n/** The functions `expo-maps` defines on both views, called with the view's tag as `this`. */\nexport interface MapViewFunctions {\n  setCameraPosition(this: { nativeTag: number }, position?: MapCameraMove): Promise<void>;\n  selectMarker(this: { nativeTag: number }, id?: string, options?: MapSelectOptions): Promise<void>;\n}\n\n/**\n * Make `<expo-map>` commit as the platform's map: `ExpoAppleMaps` on iOS, `ExpoGoogleMaps` on\n * Android. Each is its module's only view, so its default. Call once, before the first map.\n */\nexport function registerExpoMap(platform: 'ios' | 'android'): void {\n  registerExpoView('expo-map', platform === 'ios' ? 'ExpoAppleMaps' : 'ExpoGoogleMaps');\n}\n\n@Component({\n  selector: 'expo-map',\n  exportAs: 'map',\n  template: '',\n  host: {\n    '[markers]': 'markers()',\n    '[polylines]': 'nativePolylines()',\n    '[polygons]': 'nativePolygons()',\n    '[circles]': 'nativeCircles()',\n    '[cameraPosition]': 'cameraPosition()',\n    '[properties]': 'properties()',\n    '[uiSettings]': 'uiSettings()',\n    '[colorScheme]': 'colorScheme()',\n  },\n})\nexport class MapView {\n  /** Overridden in a test to move a camera without a map. */\n  static readonly SOURCE = new InjectionToken<MapViewFunctions | null>(\n    'angular-native.mapViewSource',\n    {\n      factory: () => {\n        const core = optional(\n          () => require('expo-modules-core') as typeof import('expo-modules-core'),\n        );\n        // Only one of the two modules exists on a platform. Each map is its module's default\n        // view, so its functions are under the module's own name.\n        const functions = (module: string) =>\n          core?.requireOptionalNativeModule<{\n            ViewPrototypes?: Record<string, MapViewFunctions>;\n          }>(module)?.ViewPrototypes?.[module];\n        return expoModule(\n          'expo-maps',\n          () => functions('ExpoAppleMaps') ?? functions('ExpoGoogleMaps'),\n        );\n      },\n    },\n  );\n\n  private readonly functions = inject(MapView.SOURCE);\n  private readonly engine = inject(Engine);\n  private readonly node = inject<ElementRef<EngineNode>>(ElementRef).nativeElement;\n  private readonly appeared = signal(false);\n  /** Calls made before the map appeared, in the order they were made. */\n  private held: ((ready: boolean) => void)[] = [];\n\n  readonly markers = input<readonly MapMarker[]>();\n  /** Lines, such as a route. */\n  readonly polylines = input<readonly MapPolyline[]>();\n  /** Filled shapes. */\n  readonly polygons = input<readonly MapPolygon[]>();\n  readonly circles = input<readonly MapCircle[]>();\n  /** Where the camera is. A changed value moves it; so does `setCameraPosition`. */\n  readonly cameraPosition = input<MapCameraPosition>();\n  readonly properties = input<MapProperties>();\n  readonly uiSettings = input<MapUiSettings>();\n  readonly colorScheme = input<MapColorScheme>();\n\n  /** A tap on the map, not on a marker. */\n  readonly mapClick = output<MapClickEvent>();\n  /** A tap on a marker, with the marker as it was given. iOS 18 and later on iOS. */\n  readonly markerClick = output<MapMarkerClickEvent>();\n  /** The camera moved, by the user or by the app. Also sent once when the map first appears. */\n  readonly cameraMove = output<MapCameraMoveEvent>();\n  /** A tap on a polyline, a polygon or a circle. iOS 18 and later on iOS. */\n  readonly polylineClick = output<MapPolylineClickEvent>();\n  readonly polygonClick = output<MapPolygonClickEvent>();\n  readonly circleClick = output<MapCircleClickEvent>();\n\n  protected readonly nativePolylines = computed(() =>\n    this.polylines()?.map((line) => ({ ...line, color: this.engine.color(line.color) })),\n  );\n  protected readonly nativePolygons = computed(() =>\n    this.polygons()?.map((shape) => this.filled(shape)),\n  );\n  protected readonly nativeCircles = computed(() =>\n    this.circles()?.map((shape) => this.filled(shape)),\n  );\n\n  /**\n   * Whether the native map is on screen, so its functions can reach it. Until then\n   * `setCameraPosition` and `selectMarker` are held, and sent in order once it is.\n   */\n  readonly ready = this.appeared.asReadonly();\n\n  constructor() {\n    const stop = this.engine.setEventListener(this.node, 'topCameraMove', () => this.appear());\n    inject(DestroyRef).onDestroy(() => {\n      stop();\n      this.release(false);\n    });\n  }\n\n  /**\n   * Move the camera. Held until the map is on screen, and false without the module or if the map\n   * goes before it gets there: there was never a map to move.\n   */\n  setCameraPosition(position: MapCameraMove): Promise<boolean> {\n    return this.call((functions, nativeTag) =>\n      functions.setCameraPosition.call({ nativeTag }, position),\n    );\n  }\n\n  /** Select a marker by its `id`, as a tap would, or clear the selection with none. */\n  selectMarker(id?: string, options?: MapSelectOptions): Promise<boolean> {\n    return this.call((functions, nativeTag) =>\n      functions.selectMarker.call({ nativeTag }, id, options),\n    );\n  }\n\n  private async call(\n    run: (functions: MapViewFunctions, nativeTag: number) => Promise<void>,\n  ): Promise<boolean> {\n    const functions = this.functions;\n    if (!functions) return false;\n    if (!this.appeared() && !(await new Promise<boolean>((resolve) => this.held.push(resolve)))) {\n      return false;\n    }\n    const nativeTag = this.engine.tagOf(this.node);\n    if (nativeTag === null) return false;\n    await run(functions, nativeTag);\n    return true;\n  }\n\n  private filled<T extends MapPolygon | MapCircle>(shape: T) {\n    return {\n      ...shape,\n      color: this.engine.color(shape.color),\n      lineColor: this.engine.color(shape.lineColor),\n    };\n  }\n\n  private appear(): void {\n    if (this.appeared()) return;\n    this.appeared.set(true);\n    this.release(true);\n  }\n\n  /** Let every held call go, to native if the map is there and back to its caller if not. */\n  private release(ready: boolean): void {\n    const held = this.held;\n    this.held = [];\n    for (const resolve of held) resolve(ready);\n  }\n}\n"]}

package/dist/media-library.d.ts

@@ -0,0 +1,103 @@
+/**
+ * `MediaLibrary`, bound to `expo-media-library`: saving to and reading from the user's photos and
+ * videos.
+ *
+ * ```ts
+ * import { AssetField, MediaLibrary, MediaType } from '@ng-native/expo/media-library';
+ *
+ * private readonly library = inject(MediaLibrary);
+ *
+ * async keep(uri: string): Promise<void> {
+ *   await this.library.save(uri);
+ * }
+ *
+ * async recentPhotos(): Promise<Asset[]> {
+ *   if (!(await this.library.permission.ensure())) return [];
+ *   return this.library.assets((query) =>
+ *     query.eq(AssetField.MEDIA_TYPE, MediaType.IMAGE).orderBy(AssetField.CREATION_TIME).limit(30),
+ *   );
+ * }
+ * ```
+ *
+ * The module's API is its classes: an `Asset` and an `Album` are handles whose details are read
+ * with their own async getters, and a `Query` is built by chaining. This service is where they
+ * are reached from, so a test can provide all three, and where the two permissions are: full
+ * access to read the library, and the write-only access saving needs, which is the one to ask for
+ * when that is all the app does.
+ *
+ * Changes to the library are a signal, but only once `watch()` is called: starting the listener
+ * reads the library, which is not something to do before the user has granted access.
+ *
+ * Without the module installed, every query answers empty, saving answers null, and the
+ * permissions are refused.
+ */
+import { InjectionToken, type Signal } from '@angular/core';
+import type { Album, Asset, AssetField as ExpoAssetField, AssetMetadata, MediaLibraryAssetsChangeEvent, MediaType as ExpoMediaType, Query } from 'expo-media-library';
+import { Permission } from './permissions.ts';
+import * as i0 from "@angular/core";
+type Expo = typeof import('expo-media-library');
+/** The module's functions and classes this service calls. A test provides fakes of each. */
+export type NativeMediaLibrary = Pick<Expo, 'getPermissionsAsync' | 'requestPermissionsAsync' | 'presentPermissionsPicker' | 'addListener' | 'Asset' | 'Album' | 'Query'>;
+type Args<K extends keyof NativeMediaLibrary> = NativeMediaLibrary[K] extends (...args: infer A) => unknown ? A : never;
+/**
+ * The kinds of asset, as `expo-media-library`'s own enum. Importing the enum from the module
+ * loads the module, which a test in Node cannot; these are the same strings, typed as the enum.
+ */
+export declare const MediaType: typeof ExpoMediaType;
+/** The fields a query filters and sorts on, as the module's own enum. */
+export declare const AssetField: typeof ExpoAssetField;
+export declare class MediaLibrary {
+    /** Overridden in a test to save photos to a library that is not there. */
+    static readonly SOURCE: InjectionToken<NativeMediaLibrary | null>;
+    private readonly native;
+    private readonly destroyRef;
+    private readonly changed;
+    private readonly changes;
+    private watching;
+    /** Full access: reading the library, as well as adding to it. */
+    readonly permission: Permission;
+    /** Write-only access, which is all `save()` needs and what it asks for. */
+    readonly writePermission: Permission;
+    /**
+     * Asks with the module's own options: write-only, and on Android 13 and later which of
+     * `'photo'`, `'video'` and `'audio'` to ask for. The answer also updates {@link permission}.
+     */
+    requestPermission(...options: Args<'requestPermissionsAsync'>): Promise<boolean>;
+    /**
+     * On iOS and Android 14 and later, after the user has granted access to only some photos, shows
+     * the system picker for changing which. Does nothing otherwise.
+     */
+    presentPermissionsPicker(...mediaTypes: Args<'presentPermissionsPicker'>): Promise<void>;
+    /**
+     * Saves a local image or video file to the library, into an album if one is given. Asks for
+     * write-only access first; null if it is refused.
+     */
+    save(uri: string, album?: Album): Promise<Asset | null>;
+    /**
+     * The assets a query finds, built on the module's own `Query`: `eq`, `within`, `gt`, `lt`,
+     * `orderBy`, `limit`, `offset` and `album`. Every asset without one.
+     */
+    assets(build?: (query: Query) => Query): Promise<Asset[]>;
+    /** The same query, answered with each asset's details at once rather than as handles. */
+    metadata(build?: (query: Query) => Query): Promise<AssetMetadata[]>;
+    /** The handle for an asset whose id is already known, such as one kept from an earlier query. */
+    asset(id: string): Asset | null;
+    deleteAssets(assets: Asset[]): Promise<void>;
+    albums(): Promise<Album[]>;
+    /** The album with this title, or null. */
+    album(title: string): Promise<Album | null>;
+    /** A new album holding the assets given, copied into it unless `move` is true. */
+    createAlbum(name: string, assets: Asset[] | string[], move?: boolean): Promise<Album | null>;
+    /** Deletes the albums, and with `deleteAssets` the assets in them too. */
+    deleteAlbums(albums: Album[], deleteAssets?: boolean): Promise<void>;
+    /**
+     * The library's most recent change, from the first call on: on iOS the assets inserted, deleted
+     * and updated, on Android an empty event. Call it once access is granted, since listening reads
+     * the library. The listener is removed when the app is destroyed.
+     */
+    watch(): Signal<MediaLibraryAssetsChangeEvent | null>;
+    private permissionFor;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MediaLibrary, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+export {};

package/dist/media-library.js

@@ -0,0 +1,160 @@
+/**
+ * `MediaLibrary`, bound to `expo-media-library`: saving to and reading from the user's photos and
+ * videos.
+ *
+ * ```ts
+ * import { AssetField, MediaLibrary, MediaType } from '@ng-native/expo/media-library';
+ *
+ * private readonly library = inject(MediaLibrary);
+ *
+ * async keep(uri: string): Promise<void> {
+ *   await this.library.save(uri);
+ * }
+ *
+ * async recentPhotos(): Promise<Asset[]> {
+ *   if (!(await this.library.permission.ensure())) return [];
+ *   return this.library.assets((query) =>
+ *     query.eq(AssetField.MEDIA_TYPE, MediaType.IMAGE).orderBy(AssetField.CREATION_TIME).limit(30),
+ *   );
+ * }
+ * ```
+ *
+ * The module's API is its classes: an `Asset` and an `Album` are handles whose details are read
+ * with their own async getters, and a `Query` is built by chaining. This service is where they
+ * are reached from, so a test can provide all three, and where the two permissions are: full
+ * access to read the library, and the write-only access saving needs, which is the one to ask for
+ * when that is all the app does.
+ *
+ * Changes to the library are a signal, but only once `watch()` is called: starting the listener
+ * reads the library, which is not something to do before the user has granted access.
+ *
+ * Without the module installed, every query answers empty, saving answers null, and the
+ * permissions are refused.
+ */
+import { DestroyRef, InjectionToken, Service, inject, signal } from '@angular/core';
+import { expoModule } from "./native.js";
+import { Permission } from "./permissions.js";
+import * as i0 from "@angular/core";
+/**
+ * The kinds of asset, as `expo-media-library`'s own enum. Importing the enum from the module
+ * loads the module, which a test in Node cannot; these are the same strings, typed as the enum.
+ */
+export const MediaType = {
+    UNKNOWN: 'unknown',
+    IMAGE: 'image',
+    AUDIO: 'audio',
+    VIDEO: 'video',
+};
+/** The fields a query filters and sorts on, as the module's own enum. */
+export const AssetField = {
+    CREATION_TIME: 'creationTime',
+    MODIFICATION_TIME: 'modificationTime',
+    MEDIA_TYPE: 'mediaType',
+    WIDTH: 'width',
+    HEIGHT: 'height',
+    DURATION: 'duration',
+    IS_FAVORITE: 'isFavorite',
+};
+/** The permission answer without the module: nothing granted, and nothing to ask. */
+const UNAVAILABLE = { status: 'denied', granted: false, canAskAgain: false };
+export class MediaLibrary {
+    /** Overridden in a test to save photos to a library that is not there. */
+    static SOURCE = new InjectionToken('angular-native.mediaLibrarySource', {
+        factory: () => expoModule('expo-media-library', () => require('expo-media-library')),
+    });
+    native = inject(MediaLibrary.SOURCE);
+    destroyRef = inject(DestroyRef);
+    changed = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "changed" }] : /* istanbul ignore next */ []));
+    changes = this.changed.asReadonly();
+    watching = false;
+    /** Full access: reading the library, as well as adding to it. */
+    permission = this.permissionFor(false);
+    /** Write-only access, which is all `save()` needs and what it asks for. */
+    writePermission = this.permissionFor(true);
+    /**
+     * Asks with the module's own options: write-only, and on Android 13 and later which of
+     * `'photo'`, `'video'` and `'audio'` to ask for. The answer also updates {@link permission}.
+     */
+    async requestPermission(...options) {
+        if (!this.native)
+            return false;
+        await this.native.requestPermissionsAsync(...options);
+        return this.permission.check();
+    }
+    /**
+     * On iOS and Android 14 and later, after the user has granted access to only some photos, shows
+     * the system picker for changing which. Does nothing otherwise.
+     */
+    async presentPermissionsPicker(...mediaTypes) {
+        await this.native?.presentPermissionsPicker(...mediaTypes);
+    }
+    /**
+     * Saves a local image or video file to the library, into an album if one is given. Asks for
+     * write-only access first; null if it is refused.
+     */
+    async save(uri, album) {
+        if (!this.native || !(await this.writePermission.ensure()))
+            return null;
+        return this.native.Asset.create(uri, album);
+    }
+    /**
+     * The assets a query finds, built on the module's own `Query`: `eq`, `within`, `gt`, `lt`,
+     * `orderBy`, `limit`, `offset` and `album`. Every asset without one.
+     */
+    async assets(build = (query) => query) {
+        if (!this.native)
+            return [];
+        return build(new this.native.Query()).exe();
+    }
+    /** The same query, answered with each asset's details at once rather than as handles. */
+    async metadata(build = (query) => query) {
+        if (!this.native)
+            return [];
+        return build(new this.native.Query()).exeForMetadata();
+    }
+    /** The handle for an asset whose id is already known, such as one kept from an earlier query. */
+    asset(id) {
+        return this.native ? new this.native.Asset(id) : null;
+    }
+    async deleteAssets(assets) {
+        await this.native?.Asset.delete(assets);
+    }
+    async albums() {
+        return (await this.native?.Album.getAll()) ?? [];
+    }
+    /** The album with this title, or null. */
+    async album(title) {
+        return (await this.native?.Album.get(title)) ?? null;
+    }
+    /** A new album holding the assets given, copied into it unless `move` is true. */
+    async createAlbum(name, assets, move) {
+        return (await this.native?.Album.create(name, assets, move)) ?? null;
+    }
+    /** Deletes the albums, and with `deleteAssets` the assets in them too. */
+    async deleteAlbums(albums, deleteAssets) {
+        await this.native?.Album.delete(albums, deleteAssets);
+    }
+    /**
+     * The library's most recent change, from the first call on: on iOS the assets inserted, deleted
+     * and updated, on Android an empty event. Call it once access is granted, since listening reads
+     * the library. The listener is removed when the app is destroyed.
+     */
+    watch() {
+        if (this.native && !this.watching) {
+            this.watching = true;
+            const subscription = this.native.addListener((event) => this.changed.set(event));
+            this.destroyRef.onDestroy(() => subscription.remove());
+        }
+        return this.changes;
+    }
+    permissionFor(writeOnly) {
+        return Permission.of(() => this.native?.getPermissionsAsync(writeOnly) ?? Promise.resolve(UNAVAILABLE), () => this.native?.requestPermissionsAsync(writeOnly) ?? Promise.resolve(UNAVAILABLE));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: MediaLibrary, deps: [], target: i0.ɵɵFactoryTarget.Service });
+    static ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.0", ngImport: i0, type: MediaLibrary });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: MediaLibrary, decorators: [{
+            type: Service
+        }] });
+//# sourceMappingURL=media-library.js.map

package/dist/media-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-library.js","sourceRoot":"","sources":["../src/media-library.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `MediaLibrary`, bound to `expo-media-library`: saving to and reading from the user's photos and\n * videos.\n *\n * ```ts\n * import { AssetField, MediaLibrary, MediaType } from '@ng-native/expo/media-library';\n *\n * private readonly library = inject(MediaLibrary);\n *\n * async keep(uri: string): Promise<void> {\n *   await this.library.save(uri);\n * }\n *\n * async recentPhotos(): Promise<Asset[]> {\n *   if (!(await this.library.permission.ensure())) return [];\n *   return this.library.assets((query) =>\n *     query.eq(AssetField.MEDIA_TYPE, MediaType.IMAGE).orderBy(AssetField.CREATION_TIME).limit(30),\n *   );\n * }\n * ```\n *\n * The module's API is its classes: an `Asset` and an `Album` are handles whose details are read\n * with their own async getters, and a `Query` is built by chaining. This service is where they\n * are reached from, so a test can provide all three, and where the two permissions are: full\n * access to read the library, and the write-only access saving needs, which is the one to ask for\n * when that is all the app does.\n *\n * Changes to the library are a signal, but only once `watch()` is called: starting the listener\n * reads the library, which is not something to do before the user has granted access.\n *\n * Without the module installed, every query answers empty, saving answers null, and the\n * permissions are refused.\n */\nimport { DestroyRef, InjectionToken, Service, inject, signal, type Signal } from '@angular/core';\nimport type {\n  Album,\n  Asset,\n  AssetField as ExpoAssetField,\n  AssetMetadata,\n  MediaLibraryAssetsChangeEvent,\n  MediaType as ExpoMediaType,\n  Query,\n} from 'expo-media-library';\nimport { expoModule } from './native.ts';\nimport { Permission, type PermissionResponse } from './permissions.ts';\n\ntype Expo = typeof import('expo-media-library');\n\n/** The module's functions and classes this service calls. A test provides fakes of each. */\nexport type NativeMediaLibrary = Pick<\n  Expo,\n  | 'getPermissionsAsync'\n  | 'requestPermissionsAsync'\n  | 'presentPermissionsPicker'\n  | 'addListener'\n  | 'Asset'\n  | 'Album'\n  | 'Query'\n>;\n\ntype Args<K extends keyof NativeMediaLibrary> = NativeMediaLibrary[K] extends (\n  ...args: infer A\n) => unknown\n  ? A\n  : never;\n\n/**\n * The kinds of asset, as `expo-media-library`'s own enum. Importing the enum from the module\n * loads the module, which a test in Node cannot; these are the same strings, typed as the enum.\n */\nexport const MediaType = {\n  UNKNOWN: 'unknown',\n  IMAGE: 'image',\n  AUDIO: 'audio',\n  VIDEO: 'video',\n} as unknown as typeof ExpoMediaType;\n\n/** The fields a query filters and sorts on, as the module's own enum. */\nexport const AssetField = {\n  CREATION_TIME: 'creationTime',\n  MODIFICATION_TIME: 'modificationTime',\n  MEDIA_TYPE: 'mediaType',\n  WIDTH: 'width',\n  HEIGHT: 'height',\n  DURATION: 'duration',\n  IS_FAVORITE: 'isFavorite',\n} as unknown as typeof ExpoAssetField;\n\n/** The permission answer without the module: nothing granted, and nothing to ask. */\nconst UNAVAILABLE: PermissionResponse = { status: 'denied', granted: false, canAskAgain: false };\n\n@Service()\nexport class MediaLibrary {\n  /** Overridden in a test to save photos to a library that is not there. */\n  static readonly SOURCE = new InjectionToken<NativeMediaLibrary | null>(\n    'angular-native.mediaLibrarySource',\n    {\n      factory: () => expoModule('expo-media-library', () => require('expo-media-library') as Expo),\n    },\n  );\n\n  private readonly native = inject(MediaLibrary.SOURCE);\n  private readonly destroyRef = inject(DestroyRef);\n  private readonly changed = signal<MediaLibraryAssetsChangeEvent | null>(null);\n  private readonly changes = this.changed.asReadonly();\n  private watching = false;\n\n  /** Full access: reading the library, as well as adding to it. */\n  readonly permission: Permission = this.permissionFor(false);\n\n  /** Write-only access, which is all `save()` needs and what it asks for. */\n  readonly writePermission: Permission = this.permissionFor(true);\n\n  /**\n   * Asks with the module's own options: write-only, and on Android 13 and later which of\n   * `'photo'`, `'video'` and `'audio'` to ask for. The answer also updates {@link permission}.\n   */\n  async requestPermission(...options: Args<'requestPermissionsAsync'>): Promise<boolean> {\n    if (!this.native) return false;\n    await this.native.requestPermissionsAsync(...options);\n    return this.permission.check();\n  }\n\n  /**\n   * On iOS and Android 14 and later, after the user has granted access to only some photos, shows\n   * the system picker for changing which. Does nothing otherwise.\n   */\n  async presentPermissionsPicker(...mediaTypes: Args<'presentPermissionsPicker'>): Promise<void> {\n    await this.native?.presentPermissionsPicker(...mediaTypes);\n  }\n\n  /**\n   * Saves a local image or video file to the library, into an album if one is given. Asks for\n   * write-only access first; null if it is refused.\n   */\n  async save(uri: string, album?: Album): Promise<Asset | null> {\n    if (!this.native || !(await this.writePermission.ensure())) return null;\n    return this.native.Asset.create(uri, album);\n  }\n\n  /**\n   * The assets a query finds, built on the module's own `Query`: `eq`, `within`, `gt`, `lt`,\n   * `orderBy`, `limit`, `offset` and `album`. Every asset without one.\n   */\n  async assets(build: (query: Query) => Query = (query) => query): Promise<Asset[]> {\n    if (!this.native) return [];\n    return build(new this.native.Query()).exe();\n  }\n\n  /** The same query, answered with each asset's details at once rather than as handles. */\n  async metadata(build: (query: Query) => Query = (query) => query): Promise<AssetMetadata[]> {\n    if (!this.native) return [];\n    return build(new this.native.Query()).exeForMetadata();\n  }\n\n  /** The handle for an asset whose id is already known, such as one kept from an earlier query. */\n  asset(id: string): Asset | null {\n    return this.native ? new this.native.Asset(id) : null;\n  }\n\n  async deleteAssets(assets: Asset[]): Promise<void> {\n    await this.native?.Asset.delete(assets);\n  }\n\n  async albums(): Promise<Album[]> {\n    return (await this.native?.Album.getAll()) ?? [];\n  }\n\n  /** The album with this title, or null. */\n  async album(title: string): Promise<Album | null> {\n    return (await this.native?.Album.get(title)) ?? null;\n  }\n\n  /** A new album holding the assets given, copied into it unless `move` is true. */\n  async createAlbum(\n    name: string,\n    assets: Asset[] | string[],\n    move?: boolean,\n  ): Promise<Album | null> {\n    return (await this.native?.Album.create(name, assets, move)) ?? null;\n  }\n\n  /** Deletes the albums, and with `deleteAssets` the assets in them too. */\n  async deleteAlbums(albums: Album[], deleteAssets?: boolean): Promise<void> {\n    await this.native?.Album.delete(albums, deleteAssets);\n  }\n\n  /**\n   * The library's most recent change, from the first call on: on iOS the assets inserted, deleted\n   * and updated, on Android an empty event. Call it once access is granted, since listening reads\n   * the library. The listener is removed when the app is destroyed.\n   */\n  watch(): Signal<MediaLibraryAssetsChangeEvent | null> {\n    if (this.native && !this.watching) {\n      this.watching = true;\n      const subscription = this.native.addListener((event) => this.changed.set(event));\n      this.destroyRef.onDestroy(() => subscription.remove());\n    }\n    return this.changes;\n  }\n\n  private permissionFor(writeOnly: boolean): Permission {\n    return Permission.of(\n      () => this.native?.getPermissionsAsync(writeOnly) ?? Promise.resolve(UNAVAILABLE),\n      () => this.native?.requestPermissionsAsync(writeOnly) ?? Promise.resolve(UNAVAILABLE),\n    );\n  }\n}\n"]}

package/dist/native-state.d.ts

@@ -0,0 +1,22 @@
+/** A value held on the native side, addressed by id. */
+export interface NativeState<T> {
+    /** What the view prop takes. `undefined` if the object has already been released. */
+    readonly id: number | undefined;
+    /**
+     * The current value.
+     *
+     * A write from JavaScript is scheduled onto the UI thread, so it is not readable back until
+     * that has run. `@expo/ui` says the same of its own accessors.
+     */
+    get(): T;
+    set(value: T): void;
+    /**
+     * Detach from the native object. Nothing else may use the state afterwards.
+     *
+     * Worth calling from `DestroyRef` for a field inside a list that comes and goes; a state that
+     * lives as long as the app does not need it.
+     */
+    release(): void;
+}
+/** Somewhere to hold a text field's text. See the file comment. */
+export declare function nativeState<T>(initial: T): NativeState<T> | null;

package/dist/native-state.js

@@ -0,0 +1,43 @@
+/**
+ * `ObservableState`: the one `@expo/ui` prop that is not a value.
+ *
+ * `TextFieldView` and `SecureFieldView` declare `text` as an `ObservableState` rather than a
+ * `String`, and what travels over the prop is the shared object's id, a number. Binding the string
+ * itself is the obvious thing to write and it fails as
+ * `FieldInvalidTypeException`, logged rather than thrown, so the field renders and simply ignores
+ * everything the app sets. Both fields also manage their own text when the prop is absent, which
+ * is why the mistake looks like it works: typing behaves, and only setting the value from Angular
+ * does nothing.
+ *
+ * The state lives on the native side and both sides hold a reference, so it survives the commit
+ * that a signal would not: writing to it moves the caret in a field that is already on screen,
+ * where a re-render would not. That is the whole reason the prop is shaped this way.
+ *
+ * ```ts
+ * protected readonly name = nativeState('');
+ * ```
+ * ```html
+ * <ui-text-field [text]="name?.id" (textChange)="typed.set($event.nativeEvent.value)" />
+ * ```
+ *
+ * `null` off a device, where there is no native module to hold the state. Bind `name?.id` and the
+ * prop is simply absent, which is the field's own unmanaged behaviour rather than a crash.
+ */
+import { optional } from "./native.js";
+/** Somewhere to hold a text field's text. See the file comment. */
+export function nativeState(initial) {
+    const raw = optional(() => {
+        const { requireNativeModule } = require('expo');
+        const module = requireNativeModule('ExpoUI');
+        return new module.ObservableState({ value: initial });
+    });
+    if (!raw)
+        return null;
+    return {
+        id: raw.__expo_shared_object_id__,
+        get: () => raw.getValue(),
+        set: (value) => raw.setValue({ value }),
+        release: () => raw.release(),
+    };
+}
+//# sourceMappingURL=native-state.js.map

package/dist/native-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-state.js","sourceRoot":"","sources":["../src/native-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA+BvC,mEAAmE;AACnE,MAAM,UAAU,WAAW,CAAI,OAAU;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE;QACxB,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,MAAM,CAA0B,CAAC;QACzE,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAE1C,CAAC;QACF,OAAO,IAAI,MAAM,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,yBAAyB;QACjC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAO;QAC9B,GAAG,EAAE,CAAC,KAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;QAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE;KAC7B,CAAC;AACJ,CAAC","sourcesContent":["/**\n * `ObservableState`: the one `@expo/ui` prop that is not a value.\n *\n * `TextFieldView` and `SecureFieldView` declare `text` as an `ObservableState` rather than a\n * `String`, and what travels over the prop is the shared object's id, a number. Binding the string\n * itself is the obvious thing to write and it fails as\n * `FieldInvalidTypeException`, logged rather than thrown, so the field renders and simply ignores\n * everything the app sets. Both fields also manage their own text when the prop is absent, which\n * is why the mistake looks like it works: typing behaves, and only setting the value from Angular\n * does nothing.\n *\n * The state lives on the native side and both sides hold a reference, so it survives the commit\n * that a signal would not: writing to it moves the caret in a field that is already on screen,\n * where a re-render would not. That is the whole reason the prop is shaped this way.\n *\n * ```ts\n * protected readonly name = nativeState('');\n * ```\n * ```html\n * <ui-text-field [text]=\"name?.id\" (textChange)=\"typed.set($event.nativeEvent.value)\" />\n * ```\n *\n * `null` off a device, where there is no native module to hold the state. Bind `name?.id` and the\n * prop is simply absent, which is the field's own unmanaged behaviour rather than a crash.\n */\nimport { optional } from './native.ts';\n\n/** What `useNativeState` builds by hand, since native exposes getters rather than a property. */\ninterface RawState {\n  readonly __expo_shared_object_id__?: number;\n  getValue(): unknown;\n  setValue(value: { value: unknown }): void;\n  release(): void;\n}\n\n/** A value held on the native side, addressed by id. */\nexport interface NativeState<T> {\n  /** What the view prop takes. `undefined` if the object has already been released. */\n  readonly id: number | undefined;\n  /**\n   * The current value.\n   *\n   * A write from JavaScript is scheduled onto the UI thread, so it is not readable back until\n   * that has run. `@expo/ui` says the same of its own accessors.\n   */\n  get(): T;\n  set(value: T): void;\n  /**\n   * Detach from the native object. Nothing else may use the state afterwards.\n   *\n   * Worth calling from `DestroyRef` for a field inside a list that comes and goes; a state that\n   * lives as long as the app does not need it.\n   */\n  release(): void;\n}\n\n/** Somewhere to hold a text field's text. See the file comment. */\nexport function nativeState<T>(initial: T): NativeState<T> | null {\n  const raw = optional(() => {\n    const { requireNativeModule } = require('expo') as typeof import('expo');\n    const module = requireNativeModule('ExpoUI') as {\n      ObservableState: new (init: { value: unknown }) => RawState;\n    };\n    return new module.ObservableState({ value: initial });\n  });\n  if (!raw) return null;\n\n  return {\n    id: raw.__expo_shared_object_id__,\n    get: () => raw.getValue() as T,\n    set: (value: T) => raw.setValue({ value }),\n    release: () => raw.release(),\n  };\n}\n"]}

package/dist/native.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Reaching an Expo module without importing one.
+ *
+ * A static `import ... from 'expo-battery'` makes the file unloadable by Node, which is what used
+ * to force every service into two files: the behaviour somewhere the test suite could reach, and
+ * the binding somewhere it could not. A `require` inside a function has neither problem. Metro
+ * still resolves the string literal at build time, so the module is bundled exactly as before and
+ * an app that has not installed it still gets a build error rather than a surprise at runtime;
+ * Node never evaluates the call at all, because nothing in a test asks for the real platform.
+ *
+ * The `catch` is doing two jobs, and only one of them is Node. In an ESM test `require` is not
+ * defined, so calling it throws `ReferenceError` and the service goes inert - the same state as
+ * a device that has no such sensor. On a device the throw is a module that is present but not
+ * linked, which is the same answer for the same reason.
+ */
+export declare function optional<T>(load: () => T): T | null;
+/** The platforms an Expo module is written for. */
+export type ModulePlatform = 'ios' | 'android' | 'web';
+/**
+ * A module the app needs and does not have: the package is not installed, or it is and the app was
+ * not rebuilt since, so its native half is not in the binary. Development builds and Expo Go carry
+ * only the native modules they were built with.
+ */
+export declare class MissingModuleError extends Error {
+    readonly name = "MissingModuleError";
+    /** The package, as it is installed: `expo-haptics`. */
+    readonly module: string;
+    constructor(module: string, platform: ModulePlatform, cause?: unknown);
+}
+/**
+ * The Expo module a service needs.
+ *
+ * Where the module exists for the platform the app is on, a module that is missing is a mistake
+ * the developer can fix, so this throws a `MissingModuleError` that says how - rather than leave a
+ * feature that silently does nothing. Anywhere it cannot exist - an iOS-only module on Android, the
+ * web, and Node, where a test runs with no platform at all - this answers null, and the service
+ * goes inert, as code shared across platforms needs it to.
+ *
+ * `load` answering null or undefined counts as missing too: `requireOptionalNativeModule` answers
+ * null rather than throwing.
+ */
+export declare function expoModule<T>(module: string, load: () => T | null | undefined, platforms?: readonly ModulePlatform[]): T | null;