@symbiote-native/live-photo 0.0.0-stage → 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

@@ -1,3 +1,226 @@
-# Temporary Holding Version
+# @symbiote-native/live-photo
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[`expo-live-photo`](https://docs.expo.dev/versions/latest/sdk/live-photo/) for **every**
+[SymbioteNative](../../README.md) adapter: React, Vue, Svelte, Solid and Angular. Shows a Live
+Photo, iOS only.
+
+Built the same way as [`@symbiote-native/clipboard`](../clipboard)'s `ClipboardPasteButton`, an
+`expo-modules-core` native view reached through `requireNativeViewManager` (see the
+`symbiote-expo-native-module` project skill: why `expo-modules-core` is depended on directly and never
+the `expo` meta-package, why the upstream JS is hand-ported into `core/`, and how autolinking finds the
+native module). One render function in `core/` returns a descriptor and every adapter only turns it into
+its own element.
+
+## Install
+
+**New app:**
+
+```bash
+npx @symbiote-native/cli new my-app --live-photo
+```
+
+**Existing SymbioteNative app:**
+
+```bash
+npx @symbiote-native/cli add --live-photo
+```
+
+Either way: installs `@symbiote-native/live-photo` 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/live-photo
+```
+
+Depends on `expo-live-photo` and `expo-modules-core` directly (regular dependencies, pinned to exact
+versions, since this package's `core/` is hand-ported against one specific native API shape).
+Never install `expo-live-photo` yourself, and never add the `expo` 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
+
+`expo-live-photo`'s native code is discovered by `expo-modules-autolinking`, not by RN's own
+`react-native.config.cjs` mechanism. Wire it into the native host app **once**, it covers this package
+and every other `expo-modules-core` package with zero further changes. The steps and the
+mechanics behind them are in the `symbiote-expo-native-module` skill and in
+[`@symbiote-native/network`](../network)'s README; the reference app is `examples/expo-react`.
+
+</details>
+
+## Shape
+
+```
+src/core/                live-photo-view.ts - createLivePhotoViewHandle(getNode) and the render function.
+                         types.ts - ILivePhotoAsset, ILivePhotoViewHandle, ILivePhotoPlaybackStyle.
+src/react/               @symbiote-native/live-photo/react   - LivePhotoView (ref carries the handle)
+src/vue/                 @symbiote-native/live-photo/vue     - LivePhotoView (a template ref, the functions are exposed)
+src/svelte/              @symbiote-native/live-photo/svelte  - LivePhotoView (bind:this)
+src/solid/               @symbiote-native/live-photo/solid   - LivePhotoView (ref={fn})
+src/angular/             @symbiote-native/live-photo/angular - LivePhotoView (the functions are methods)
+```
+
+A native Expo view keeps its functions on its module's view prototypes and native finds the view by its
+native tag, so the engine's `defineExpoViewMethods` makes that call. Each adapter only hands over its host
+node. `native-link.json` carries only `ios.upstreamPackage`, upstream has no Android folder.
+
+## Use it
+
+### React
+
+```tsx
+import { useRef } from 'react';
+import { LivePhotoView, type ILivePhotoViewHandle } from '@symbiote-native/live-photo/react';
+
+const handle = useRef<ILivePhotoViewHandle>(null);
+
+<LivePhotoView
+  ref={handle}
+  style={{ width: 300, height: 400 }}
+  source={{ photoUri, pairedVideoUri }}
+  onLoadError={error => console.warn(error.message)}
+/>;
+<button title="Play" onPress={() => handle.current?.startPlayback('hint')} />;
+```
+
+### Vue
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { LivePhotoView, type ILivePhotoViewHandle } from '@symbiote-native/live-photo/vue';
+
+const handle = ref<ILivePhotoViewHandle | null>(null);
+</script>
+
+<template>
+  <LivePhotoView
+    ref="handle"
+    :style="{ width: 300, height: 400 }"
+    :source="{ photoUri, pairedVideoUri }"
+    @loadError="error => console.warn(error.message)"
+  />
+  <button title="Play" @press="handle?.startPlayback('hint')" />
+</template>
+```
+
+### Angular
+
+```ts
+import { Component } from '@angular/core';
+import { SYMBIOTE_ELEMENTS } from '@symbiote-native/angular';
+import { LivePhotoView } from '@symbiote-native/live-photo/angular';
+
+@Component({
+  standalone: true,
+  imports: [LivePhotoView, SYMBIOTE_ELEMENTS],
+  template: `
+    <LivePhotoView
+      #view
+      [style]="{ width: 300, height: 400 }"
+      [source]="{ photoUri, pairedVideoUri }"
+      [onLoadError]="onLoadError"
+    />
+    <button title="Play" (press)="view.startPlayback('hint')" />
+  `,
+})
+export class LivePhotoCard {
+  readonly photoUri = '...';
+  readonly pairedVideoUri = '...';
+  readonly onLoadError = (error: { message: string }): void => console.warn(error.message);
+}
+```
+
+### Svelte
+
+```svelte
+<script lang="ts">
+  import { LivePhotoView, type ILivePhotoViewHandle } from '@symbiote-native/live-photo/svelte';
+
+  let handle = $state<ILivePhotoViewHandle | undefined>();
+</script>
+
+<LivePhotoView
+  bind:this={handle}
+  style={{ width: 300, height: 400 }}
+  source={{ photoUri, pairedVideoUri }}
+  onLoadError={error => console.warn(error.message)}
+/>
+<button title="Play" onPress={() => handle?.startPlayback('hint')} />
+```
+
+### Solid
+
+```tsx
+import { createSignal } from 'solid-js';
+import { LivePhotoView, type ILivePhotoViewHandle } from '@symbiote-native/live-photo/solid';
+
+const [handle, setHandle] = createSignal<ILivePhotoViewHandle>();
+
+<LivePhotoView
+  ref={setHandle}
+  style={{ width: 300, height: 400 }}
+  source={{ photoUri, pairedVideoUri }}
+  onLoadError={error => console.warn(error.message)}
+/>;
+<button title="Play" onPress={() => handle()?.startPlayback('hint')} />;
+```
+
+## API
+
+```ts
+<LivePhotoView source={{ photoUri, pairedVideoUri }} isMuted?={true} contentFit?={'contain' | 'cover'}
+               useDefaultGestureRecognizer?={true}
+               onLoadStart? onPreviewPhotoLoad? onLoadComplete? onLoadError?({ message }) onPlaybackStart? onPlaybackStop? />
+// handle:
+startPlayback(style?: 'full' | 'hint'): void     // default 'full'
+stopPlayback(): void
+```
+
+Off iOS the view renders nothing, with a warning in development, and the handle throws
+`UnavailabilityError`. Ported from upstream's `LivePhotoView.tsx`.
+
+## Notes
+
+- **iOS only.** Off iOS the view renders nothing, with a warning in development, and the handle
+  throws `UnavailabilityError`. Check `Platform.OS` before you render it.
+- **A Live Photo is two files.** The still photo and the paired video, and they must stay a pair:
+  the pairing lives in their metadata, so editing or recompressing either one breaks it.
+- **Playback style.** `startPlayback()` plays the full clip, `startPlayback('hint')` plays the short
+  preview you see when you press a photo in the Photos app.
+- **Muted by default.** `isMuted` is `true`, unmute it when the sound is part of the content.
+- **Press and hold plays** while `useDefaultGestureRecognizer` is `true`. Turn it off and call
+  `startPlayback` yourself if the photo has its own gestures.
+- **Not ported.** Nothing. Upstream ships no tests and no config plugin, the suites here are written against its behavior.
+
+## Common questions
+
+- **Where do the two URIs come from?** `@symbiote-native/image-picker` with
+  `mediaTypes: ['livePhotos']`: `assets[0].uri` and `assets[0].pairedVideoAsset?.uri`. A photo in
+  iCloud needs `shouldDownloadFromNetwork`.
+- **No Live Photo in the Simulator.** The Simulator cannot make one, use a real device.
+- **`onLoadError` or no playback.** The files are not one pair, or one was edited. Pass the two URIs
+  of one pick, untouched.
+- **Media library.** Resolving the still half was reported to throw for some assets, prefer the
+  picker.
+- **No sound.** `isMuted` defaults to `true`.
+- **Playback styles.** `startPlayback('full')` or `startPlayback('hint')`.
+- **Android.** Not available, the view renders nothing.
+
+Sources: [Expo docs: LivePhoto](https://docs.expo.dev/versions/latest/sdk/live-photo/),
+[expo/expo#47730](https://github.com/expo/expo/issues/47730),
+[expo/expo#46512](https://github.com/expo/expo/issues/46512),
+[expo/expo#48658](https://github.com/expo/expo/issues/48658).
+
+## Test it
+
+No device is needed for the logic. The core tests (`src/core/*.test.ts`) replace `expo-modules-core`
+(`requireNativeViewManager`, `Platform`) and assert the descriptor a render function returns. The
+adapter tests (`src/{react,vue,solid,angular}/**/*.test.*`, `vitest`) render the real component over the
+recording Fabric with an injected view config and assert the committed payload, and Svelte's
+`*.smoke.test.ts` compile the `.svelte` files and mount them. Painting itself is verified on a device in
+the six `examples/expo-*` canary apps (`examples/expo-react`, `examples/expo-vue-sfc`,
+`examples/expo-vue-tsx`, `examples/expo-svelte`, `examples/expo-solid`, `examples/expo-angular`), see the
+parent [README](../../README.md).

package/build/angular/index.d.ts

@@ -0,0 +1,2 @@
+export { LivePhotoView } from './live-photo-view';
+export { LIVE_PHOTO_MODULE_NAME, livePhotoViewName, type ILivePhotoAsset, type ILivePhotoContentFit, type ILivePhotoLoadError, type ILivePhotoPlaybackStyle, type ILivePhotoViewHandle, type ILivePhotoViewProps, } from '../core';

package/build/angular/index.js

@@ -0,0 +1,3 @@
+// @symbiote-native/live-photo/angular: показ живых фото на общем ядре
+export { LivePhotoView } from './live-photo-view/index.js';
+export { LIVE_PHOTO_MODULE_NAME, livePhotoViewName, } from '../core/index.js';

package/build/angular/live-photo-view/index.d.ts

@@ -0,0 +1,21 @@
+import { NativeViewBase } from '@symbiote-native/angular';
+import type { IDescriptor } from '@symbiote-native/components';
+import type { ILivePhotoPlaybackStyle, ILivePhotoViewProps } from '../../core';
+/** Angular twin of `expo-live-photo`'s `LivePhotoView`, iOS only */
+export declare class LivePhotoView extends NativeViewBase {
+    source?: ILivePhotoViewProps['source'];
+    isMuted?: ILivePhotoViewProps['isMuted'];
+    contentFit?: ILivePhotoViewProps['contentFit'];
+    useDefaultGestureRecognizer?: ILivePhotoViewProps['useDefaultGestureRecognizer'];
+    onPlaybackStart?: ILivePhotoViewProps['onPlaybackStart'];
+    onPlaybackStop?: ILivePhotoViewProps['onPlaybackStop'];
+    onLoadStart?: ILivePhotoViewProps['onLoadStart'];
+    onPreviewPhotoLoad?: ILivePhotoViewProps['onPreviewPhotoLoad'];
+    onLoadComplete?: ILivePhotoViewProps['onLoadComplete'];
+    onLoadError?: ILivePhotoViewProps['onLoadError'];
+    private readonly handle;
+    protected readonly propNames: readonly ["source", "isMuted", "contentFit", "useDefaultGestureRecognizer", "onPlaybackStart", "onPlaybackStop", "onLoadStart", "onPreviewPhotoLoad", "onLoadComplete", "onLoadError"];
+    protected renderView(props: object): IDescriptor | null;
+    startPlayback(playbackStyle?: ILivePhotoPlaybackStyle): void;
+    stopPlayback(): void;
+}

package/build/angular/live-photo-view/index.js

@@ -0,0 +1,147 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { ChangeDetectionStrategy, Component, Input } from '@angular/core';
+import { DescriptorOutlet, NativeViewBase } from '@symbiote-native/angular';
+import { createLivePhotoViewHandle, renderLivePhotoView } from '../../core/index.js';
+/** Angular twin of `expo-live-photo`'s `LivePhotoView`, iOS only */
+let LivePhotoView = (() => {
+    let _classDecorators = [Component({
+            selector: 'LivePhotoView',
+            standalone: true,
+            imports: [DescriptorOutlet],
+            changeDetection: ChangeDetectionStrategy.OnPush,
+            template: `@if (descriptor; as node) {
+    <symbiote-descriptor-outlet [node]="node" />
+  }`,
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = NativeViewBase;
+    let _source_decorators;
+    let _source_initializers = [];
+    let _source_extraInitializers = [];
+    let _isMuted_decorators;
+    let _isMuted_initializers = [];
+    let _isMuted_extraInitializers = [];
+    let _contentFit_decorators;
+    let _contentFit_initializers = [];
+    let _contentFit_extraInitializers = [];
+    let _useDefaultGestureRecognizer_decorators;
+    let _useDefaultGestureRecognizer_initializers = [];
+    let _useDefaultGestureRecognizer_extraInitializers = [];
+    let _onPlaybackStart_decorators;
+    let _onPlaybackStart_initializers = [];
+    let _onPlaybackStart_extraInitializers = [];
+    let _onPlaybackStop_decorators;
+    let _onPlaybackStop_initializers = [];
+    let _onPlaybackStop_extraInitializers = [];
+    let _onLoadStart_decorators;
+    let _onLoadStart_initializers = [];
+    let _onLoadStart_extraInitializers = [];
+    let _onPreviewPhotoLoad_decorators;
+    let _onPreviewPhotoLoad_initializers = [];
+    let _onPreviewPhotoLoad_extraInitializers = [];
+    let _onLoadComplete_decorators;
+    let _onLoadComplete_initializers = [];
+    let _onLoadComplete_extraInitializers = [];
+    let _onLoadError_decorators;
+    let _onLoadError_initializers = [];
+    let _onLoadError_extraInitializers = [];
+    var LivePhotoView = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _source_decorators = [Input()];
+            _isMuted_decorators = [Input()];
+            _contentFit_decorators = [Input()];
+            _useDefaultGestureRecognizer_decorators = [Input()];
+            _onPlaybackStart_decorators = [Input()];
+            _onPlaybackStop_decorators = [Input()];
+            _onLoadStart_decorators = [Input()];
+            _onPreviewPhotoLoad_decorators = [Input()];
+            _onLoadComplete_decorators = [Input()];
+            _onLoadError_decorators = [Input()];
+            __esDecorate(null, null, _source_decorators, { kind: "field", name: "source", static: false, private: false, access: { has: obj => "source" in obj, get: obj => obj.source, set: (obj, value) => { obj.source = value; } }, metadata: _metadata }, _source_initializers, _source_extraInitializers);
+            __esDecorate(null, null, _isMuted_decorators, { kind: "field", name: "isMuted", static: false, private: false, access: { has: obj => "isMuted" in obj, get: obj => obj.isMuted, set: (obj, value) => { obj.isMuted = value; } }, metadata: _metadata }, _isMuted_initializers, _isMuted_extraInitializers);
+            __esDecorate(null, null, _contentFit_decorators, { kind: "field", name: "contentFit", static: false, private: false, access: { has: obj => "contentFit" in obj, get: obj => obj.contentFit, set: (obj, value) => { obj.contentFit = value; } }, metadata: _metadata }, _contentFit_initializers, _contentFit_extraInitializers);
+            __esDecorate(null, null, _useDefaultGestureRecognizer_decorators, { kind: "field", name: "useDefaultGestureRecognizer", static: false, private: false, access: { has: obj => "useDefaultGestureRecognizer" in obj, get: obj => obj.useDefaultGestureRecognizer, set: (obj, value) => { obj.useDefaultGestureRecognizer = value; } }, metadata: _metadata }, _useDefaultGestureRecognizer_initializers, _useDefaultGestureRecognizer_extraInitializers);
+            __esDecorate(null, null, _onPlaybackStart_decorators, { kind: "field", name: "onPlaybackStart", static: false, private: false, access: { has: obj => "onPlaybackStart" in obj, get: obj => obj.onPlaybackStart, set: (obj, value) => { obj.onPlaybackStart = value; } }, metadata: _metadata }, _onPlaybackStart_initializers, _onPlaybackStart_extraInitializers);
+            __esDecorate(null, null, _onPlaybackStop_decorators, { kind: "field", name: "onPlaybackStop", static: false, private: false, access: { has: obj => "onPlaybackStop" in obj, get: obj => obj.onPlaybackStop, set: (obj, value) => { obj.onPlaybackStop = value; } }, metadata: _metadata }, _onPlaybackStop_initializers, _onPlaybackStop_extraInitializers);
+            __esDecorate(null, null, _onLoadStart_decorators, { kind: "field", name: "onLoadStart", static: false, private: false, access: { has: obj => "onLoadStart" in obj, get: obj => obj.onLoadStart, set: (obj, value) => { obj.onLoadStart = value; } }, metadata: _metadata }, _onLoadStart_initializers, _onLoadStart_extraInitializers);
+            __esDecorate(null, null, _onPreviewPhotoLoad_decorators, { kind: "field", name: "onPreviewPhotoLoad", static: false, private: false, access: { has: obj => "onPreviewPhotoLoad" in obj, get: obj => obj.onPreviewPhotoLoad, set: (obj, value) => { obj.onPreviewPhotoLoad = value; } }, metadata: _metadata }, _onPreviewPhotoLoad_initializers, _onPreviewPhotoLoad_extraInitializers);
+            __esDecorate(null, null, _onLoadComplete_decorators, { kind: "field", name: "onLoadComplete", static: false, private: false, access: { has: obj => "onLoadComplete" in obj, get: obj => obj.onLoadComplete, set: (obj, value) => { obj.onLoadComplete = value; } }, metadata: _metadata }, _onLoadComplete_initializers, _onLoadComplete_extraInitializers);
+            __esDecorate(null, null, _onLoadError_decorators, { kind: "field", name: "onLoadError", static: false, private: false, access: { has: obj => "onLoadError" in obj, get: obj => obj.onLoadError, set: (obj, value) => { obj.onLoadError = value; } }, metadata: _metadata }, _onLoadError_initializers, _onLoadError_extraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            LivePhotoView = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        source = __runInitializers(this, _source_initializers, void 0);
+        isMuted = (__runInitializers(this, _source_extraInitializers), __runInitializers(this, _isMuted_initializers, void 0));
+        contentFit = (__runInitializers(this, _isMuted_extraInitializers), __runInitializers(this, _contentFit_initializers, void 0));
+        useDefaultGestureRecognizer = (__runInitializers(this, _contentFit_extraInitializers), __runInitializers(this, _useDefaultGestureRecognizer_initializers, void 0));
+        onPlaybackStart = (__runInitializers(this, _useDefaultGestureRecognizer_extraInitializers), __runInitializers(this, _onPlaybackStart_initializers, void 0));
+        onPlaybackStop = (__runInitializers(this, _onPlaybackStart_extraInitializers), __runInitializers(this, _onPlaybackStop_initializers, void 0));
+        onLoadStart = (__runInitializers(this, _onPlaybackStop_extraInitializers), __runInitializers(this, _onLoadStart_initializers, void 0));
+        onPreviewPhotoLoad = (__runInitializers(this, _onLoadStart_extraInitializers), __runInitializers(this, _onPreviewPhotoLoad_initializers, void 0));
+        onLoadComplete = (__runInitializers(this, _onPreviewPhotoLoad_extraInitializers), __runInitializers(this, _onLoadComplete_initializers, void 0));
+        onLoadError = (__runInitializers(this, _onLoadComplete_extraInitializers), __runInitializers(this, _onLoadError_initializers, void 0));
+        handle = (__runInitializers(this, _onLoadError_extraInitializers), createLivePhotoViewHandle(() => this.hostNode()));
+        propNames = [
+            'source',
+            'isMuted',
+            'contentFit',
+            'useDefaultGestureRecognizer',
+            'onPlaybackStart',
+            'onPlaybackStop',
+            'onLoadStart',
+            'onPreviewPhotoLoad',
+            'onLoadComplete',
+            'onLoadError',
+        ];
+        renderView(props) {
+            return renderLivePhotoView(props);
+        }
+        startPlayback(playbackStyle) {
+            this.handle.startPlayback(playbackStyle);
+        }
+        stopPlayback() {
+            this.handle.stopPlayback();
+        }
+    };
+    return LivePhotoView = _classThis;
+})();
+export { LivePhotoView };

package/build/core/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const LIVE_PHOTO_MODULE_NAME = "ExpoLivePhoto";
+export declare const LIVE_PHOTO_PACKAGE_NAME = "expo-live-photo";

package/build/core/constants.js

@@ -0,0 +1,3 @@
+export const LIVE_PHOTO_MODULE_NAME = 'ExpoLivePhoto';
+// The label upstream puts into its `UnavailabilityError`
+export const LIVE_PHOTO_PACKAGE_NAME = 'expo-live-photo';

package/build/core/index.d.ts

@@ -0,0 +1,3 @@
+export { LIVE_PHOTO_MODULE_NAME } from './constants';
+export { createLivePhotoViewHandle, ensureLivePhotoViewRegistered, livePhotoViewName, renderLivePhotoView, } from './live-photo-view';
+export type { ILivePhotoAsset, ILivePhotoContentFit, ILivePhotoLoadError, ILivePhotoPlaybackStyle, ILivePhotoViewHandle, ILivePhotoViewProps, } from './types';

package/build/core/index.js

@@ -0,0 +1,2 @@
+export { LIVE_PHOTO_MODULE_NAME } from './constants.js';
+export { createLivePhotoViewHandle, ensureLivePhotoViewRegistered, livePhotoViewName, renderLivePhotoView, } from './live-photo-view.js';

package/build/core/live-photo-view.d.ts

@@ -0,0 +1,8 @@
+import type { IDescriptor } from '@symbiote-native/components';
+import type { ISymbioteNode } from '@symbiote-native/engine';
+import type { ILivePhotoViewHandle } from './types';
+export declare const livePhotoViewName: () => string;
+export declare function ensureLivePhotoViewRegistered(): boolean;
+/** `null` means the caller renders nothing, live photos exist only on iOS */
+export declare function renderLivePhotoView(props: object): IDescriptor | null;
+export declare function createLivePhotoViewHandle(getNode: () => ISymbioteNode | null | undefined): ILivePhotoViewHandle;

package/build/core/live-photo-view.js

@@ -0,0 +1,57 @@
+// Ядро `LivePhotoView`: нативный view с живыми фото, только iOS
+import { Platform, UnavailabilityError, requireNativeModule, requireNativeViewManager, } from 'expo-modules-core';
+import { el } from '@symbiote-native/components';
+import { defineExpoNativeView, defineExpoViewMethods, getNativeTag, isDevBuild, } from '@symbiote-native/engine';
+import { LIVE_PHOTO_MODULE_NAME, LIVE_PHOTO_PACKAGE_NAME } from './constants.js';
+const LOAD_ERROR_PROP = 'onLoadError';
+// Регистрация идёт при рендере: побочный эффект барреля теряется в release
+const livePhotoView = defineExpoNativeView(requireNativeViewManager, LIVE_PHOTO_MODULE_NAME);
+const callViewFunction = defineExpoViewMethods(requireNativeModule, LIVE_PHOTO_MODULE_NAME);
+export const livePhotoViewName = livePhotoView.name;
+function isAvailable() {
+    return Platform.select({ ios: true, default: false });
+}
+export function ensureLivePhotoViewRegistered() {
+    return isAvailable() && livePhotoView.ensureRegistered();
+}
+function isLoadError(value) {
+    return typeof Reflect.get(Object(value), 'message') === 'string';
+}
+// Нативное событие несёт полезную нагрузку в `nativeEvent`, наружу уходит она сама
+function toLoadErrorHandler(onLoadError) {
+    return (event) => {
+        if (typeof onLoadError !== 'function')
+            return;
+        if (isLoadError(event.nativeEvent))
+            onLoadError(event.nativeEvent);
+    };
+}
+/** `null` means the caller renders nothing, live photos exist only on iOS */
+export function renderLivePhotoView(props) {
+    if (!ensureLivePhotoViewRegistered()) {
+        if (isDevBuild())
+            console.warn("'LivePhotoView' is not available.");
+        return null;
+    }
+    return el(livePhotoViewName(), {
+        ...Object.fromEntries(Object.entries(props)),
+        [LOAD_ERROR_PROP]: toLoadErrorHandler(Reflect.get(props, LOAD_ERROR_PROP)),
+    });
+}
+// A view that has not committed yet has no native tag, the call is dropped like upstream's
+// `nativeRef.current?.` does
+function callIfMounted(getNode, method, args) {
+    if (!isAvailable()) {
+        throw new UnavailabilityError(LIVE_PHOTO_PACKAGE_NAME, method);
+    }
+    const node = getNode();
+    if (node && getNativeTag(node) !== undefined) {
+        callViewFunction(node, method, args);
+    }
+}
+export function createLivePhotoViewHandle(getNode) {
+    return {
+        startPlayback: (playbackStyle) => callIfMounted(getNode, 'startPlayback', [playbackStyle ?? 'full']),
+        stopPlayback: () => callIfMounted(getNode, 'stopPlayback', []),
+    };
+}

package/build/core/types.d.ts

@@ -0,0 +1,50 @@
+import type { IAccessibilityProps, IAriaProps, IResponderProps } from '@symbiote-native/components';
+import type { IStyleProp, ISymbioteEvent, IViewStyle } from '@symbiote-native/engine';
+/**
+ * A live photo asset
+ *
+ * The photo and the video must come from one unaltered live photo file, the pairing lives in
+ * their metadata and native cannot rebuild it
+ */
+export type ILivePhotoAsset = {
+    /** The URI of the photo part of the live photo */
+    photoUri: string;
+    /** The URI of the video part of the live photo */
+    pairedVideoUri: string;
+};
+export type ILivePhotoLoadError = {
+    /** Reason for the load failure */
+    message: string;
+};
+/** `contain` fits the larger dimension to the target, `cover` fills the whole target */
+export type ILivePhotoContentFit = 'contain' | 'cover';
+/** `hint` plays a short part of the video, `full` plays all of it */
+export type ILivePhotoPlaybackStyle = 'hint' | 'full';
+export type ILivePhotoViewProps = IAccessibilityProps & IAriaProps & IResponderProps & {
+    /** The live photo asset to display */
+    source?: ILivePhotoAsset | null;
+    /** Whether the live photo plays without audio, `true` by default */
+    isMuted?: boolean;
+    /** `contain` by default */
+    contentFit?: ILivePhotoContentFit;
+    /** Playback starts on press and hold when `true`, which is the default */
+    useDefaultGestureRecognizer?: boolean;
+    onPlaybackStart?: () => void;
+    onPlaybackStop?: () => void;
+    onLoadStart?: () => void;
+    /** The preview photo is loaded */
+    onPreviewPhotoLoad?: () => void;
+    /** The live photo is loaded and ready to play */
+    onLoadComplete?: () => void;
+    onLoadError?: (error: ILivePhotoLoadError) => void;
+    style?: IStyleProp<IViewStyle>;
+    testID?: string;
+    nativeID?: string;
+    onLayout?: (event: ISymbioteEvent) => void;
+};
+/** What a ref to the view hands out */
+export type ILivePhotoViewHandle = {
+    /** Plays the video part, the full video unless `playbackStyle` says `hint` */
+    startPlayback: (playbackStyle?: ILivePhotoPlaybackStyle) => void;
+    stopPlayback: () => void;
+};

package/build/core/types.js

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

package/build/react/index.d.ts

@@ -0,0 +1,3 @@
+export { LivePhotoView } from './live-photo-view';
+export type { ILivePhotoViewReactProps } from './live-photo-view';
+export { LIVE_PHOTO_MODULE_NAME, livePhotoViewName, type ILivePhotoAsset, type ILivePhotoContentFit, type ILivePhotoLoadError, type ILivePhotoPlaybackStyle, type ILivePhotoViewHandle, type ILivePhotoViewProps, } from '../core';

package/build/react/index.js

@@ -0,0 +1,3 @@
+// @symbiote-native/live-photo/react: показ живых фото на общем ядре
+export { LivePhotoView } from './live-photo-view.js';
+export { LIVE_PHOTO_MODULE_NAME, livePhotoViewName, } from '../core/index.js';

package/build/react/live-photo-view.d.ts

@@ -0,0 +1,8 @@
+import type { ReactElement, Ref } from 'react';
+import type { ILivePhotoViewHandle, ILivePhotoViewProps } from '../core';
+export type ILivePhotoViewReactProps = ILivePhotoViewProps & {
+    ref?: Ref<ILivePhotoViewHandle>;
+    className?: string;
+};
+/** React twin of `expo-live-photo`'s `LivePhotoView`, iOS only */
+export declare function LivePhotoView({ ref, ...props }: ILivePhotoViewReactProps): ReactElement | null;

package/build/react/live-photo-view.js

@@ -0,0 +1,13 @@
+import { useImperativeHandle, useState } from 'react';
+import { descriptorToReact } from '@symbiote-native/react';
+import { createHostNodeHolder } from '@symbiote-native/components';
+import { createLivePhotoViewHandle, renderLivePhotoView } from '../core/index.js';
+/** React twin of `expo-live-photo`'s `LivePhotoView`, iOS only */
+export function LivePhotoView({ ref, ...props }) {
+    const [host] = useState(createHostNodeHolder);
+    useImperativeHandle(ref, () => createLivePhotoViewHandle(host.getNode), [
+        host,
+    ]);
+    const descriptor = renderLivePhotoView(props);
+    return descriptor ? descriptorToReact(host.capture(descriptor)) : null;
+}

package/build/solid/index.d.ts

@@ -0,0 +1,3 @@
+export { LivePhotoView } from './live-photo-view';
+export type { ILivePhotoViewSolidProps } from './live-photo-view';
+export { LIVE_PHOTO_MODULE_NAME, livePhotoViewName, type ILivePhotoAsset, type ILivePhotoContentFit, type ILivePhotoLoadError, type ILivePhotoPlaybackStyle, type ILivePhotoViewHandle, type ILivePhotoViewProps, } from '../core';

package/build/solid/index.js

@@ -0,0 +1,3 @@
+// @symbiote-native/live-photo/solid: показ живых фото на общем ядре
+export { LivePhotoView } from './live-photo-view.js';
+export { LIVE_PHOTO_MODULE_NAME, livePhotoViewName, } from '../core/index.js';

package/build/solid/live-photo-view.d.ts

@@ -0,0 +1,8 @@
+import type { ISymbioteNode } from '@symbiote-native/engine';
+import type { ILivePhotoViewHandle, ILivePhotoViewProps } from '../core';
+export type ILivePhotoViewSolidProps = ILivePhotoViewProps & {
+    /** Gets the handle that starts and stops the playback */
+    ref?: (handle: ILivePhotoViewHandle) => void;
+};
+/** Solid twin of `expo-live-photo`'s `LivePhotoView`, iOS only */
+export declare function LivePhotoView(props: ILivePhotoViewSolidProps): ISymbioteNode | null;

package/build/solid/live-photo-view.js

@@ -0,0 +1,18 @@
+import { splitProps } from 'solid-js';
+import { descriptorToSolid } from '@symbiote-native/solid';
+import { createHostNodeHolder } from '@symbiote-native/components';
+import { createLivePhotoViewHandle, renderLivePhotoView } from '../core/index.js';
+/** Solid twin of `expo-live-photo`'s `LivePhotoView`, iOS only */
+export function LivePhotoView(props) {
+    const [own, viewProps] = splitProps(props, ['ref']);
+    const host = createHostNodeHolder();
+    const render = () => {
+        const descriptor = renderLivePhotoView({ ...viewProps });
+        return descriptor && host.capture(descriptor);
+    };
+    const initial = render();
+    if (!initial)
+        return null;
+    own.ref?.(createLivePhotoViewHandle(host.getNode));
+    return descriptorToSolid(() => render() ?? initial);
+}

package/build/svelte/index.d.ts

@@ -0,0 +1,2 @@
+export { default as LivePhotoView } from './live-photo-view.svelte';
+export * from '../core';