@symbiote-native/image-manipulator 0.1.0

package/build-ngc/core/image-manipulator.js

@@ -0,0 +1,35 @@
+import { expoImageManipulator } from './native-module';
+import { SaveFormat } from './types';
+import { validateArguments } from './validators';
+/** Loads `source` and starts a new chainable manipulation context. */
+export function manipulate(source) {
+    return expoImageManipulator.manipulate(source);
+}
+/**
+ * @deprecated replaced by `manipulate(source)` / the returned context's chainable methods.
+ */
+export async function manipulateAsync(uri, actions = [], saveOptions = {}) {
+    validateArguments(uri, actions, saveOptions);
+    const { format = SaveFormat.JPEG, ...rest } = saveOptions;
+    const context = expoImageManipulator.manipulate(uri);
+    for (const action of actions) {
+        if ('resize' in action) {
+            context.resize(action.resize);
+        }
+        else if ('rotate' in action) {
+            context.rotate(action.rotate);
+        }
+        else if ('flip' in action) {
+            context.flip(action.flip);
+        }
+        else if ('crop' in action) {
+            context.crop(action.crop);
+        }
+    }
+    const image = await context.renderAsync();
+    const result = await image.saveAsync({ format, ...rest });
+    context.release();
+    image.release();
+    return result;
+}
+//# sourceMappingURL=image-manipulator.js.map

package/build-ngc/core/image-manipulator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-manipulator.js","sourceRoot":"","sources":["../../src/core/image-manipulator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAUjD,sEAAsE;AACtE,MAAM,UAAU,UAAU,CACxB,MAA+B;IAE/B,OAAO,oBAAoB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,UAAqB,EAAE,EACvB,cAA4B,EAAE;IAE9B,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAE7C,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC;IAC1D,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAErD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;aAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAE1D,OAAO,CAAC,OAAO,EAAE,CAAC;IAClB,KAAK,CAAC,OAAO,EAAE,CAAC;IAEhB,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,4 @@
+export { manipulate, manipulateAsync } from './image-manipulator';
+export type { IImageManipulatorContext, IImageRef } from './image-manipulator';
+export { FlipType, SaveFormat } from './types';
+export type { IAction, IActionCrop, IActionFlip, IActionResize, IActionRotate, IImageResult, ISaveOptions, } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,3 @@
+export { manipulate, manipulateAsync } from './image-manipulator';
+export { FlipType, SaveFormat } from './types';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/build-ngc/core/manipulator-context-controller.d.ts

@@ -0,0 +1,9 @@
+export type IReleasableContext = {
+    release: () => void;
+};
+export type IManipulatorContextController<TSource, TContext extends IReleasableContext> = {
+    resolve: (source: TSource) => TContext;
+    flushRelease: () => void;
+    release: () => void;
+};
+export declare function createManipulatorContextController<TSource, TContext extends IReleasableContext>(manipulate: (source: TSource) => TContext): IManipulatorContextController<TSource, TContext>;

package/build-ngc/core/manipulator-context-controller.js

@@ -0,0 +1,14 @@
+// Thin binding of `@symbiote-native/engine`'s generic `createResourceController` to this
+// package's own `.release()`-shaped context, kept for its own descriptive type names
+import { createResourceController } from '@symbiote-native/engine';
+export function createManipulatorContextController(manipulate) {
+    const controller = createResourceController(manipulate, context => {
+        context.release();
+    });
+    return {
+        resolve: controller.resolve,
+        flushRelease: controller.flushDispose,
+        release: controller.dispose,
+    };
+}
+//# sourceMappingURL=manipulator-context-controller.js.map

package/build-ngc/core/manipulator-context-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulator-context-controller.js","sourceRoot":"","sources":["../../src/core/manipulator-context-controller.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qFAAqF;AAErF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAanE,MAAM,UAAU,kCAAkC,CAIhD,UAAyC;IAEzC,MAAM,UAAU,GAAG,wBAAwB,CACzC,UAAU,EACV,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,CAAC,CACF,CAAC;IACF,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC"}

package/build-ngc/core/manipulator-resource-controller.d.ts

@@ -0,0 +1,6 @@
+import type { IImageManipulatorContext, IImageRef } from './index';
+export declare function createImageManipulatorResourceController(): {
+    resolve: (source: string | IImageRef) => IImageManipulatorContext;
+    flushDispose: () => void;
+    dispose: () => void;
+};

package/build-ngc/core/manipulator-resource-controller.js

@@ -0,0 +1,18 @@
+// Adapts `createManipulatorContextController`'s `.release()`-shaped controller to the
+// `resolve`/`flushDispose`/`dispose` shape every adapter's `createResourceHook` expects
+import { createManipulatorContextController, } from './manipulator-context-controller';
+import { manipulate } from './index';
+function createManipulatorResourceController(manipulateSource) {
+    const controller = createManipulatorContextController(manipulateSource);
+    return {
+        resolve: controller.resolve,
+        flushDispose: controller.flushRelease,
+        dispose: controller.release,
+    };
+}
+// Bakes in this package's own `manipulate`, so every adapter's `createResourceHook` binds a
+// plain zero-arg factory instead of repeating the same arrow wrapper five times
+export function createImageManipulatorResourceController() {
+    return createManipulatorResourceController(manipulate);
+}
+//# sourceMappingURL=manipulator-resource-controller.js.map

package/build-ngc/core/manipulator-resource-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manipulator-resource-controller.js","sourceRoot":"","sources":["../../src/core/manipulator-resource-controller.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,wFAAwF;AAExF,OAAO,EACL,kCAAkC,GAEnC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,SAAS,mCAAmC,CAI1C,gBAA+C;IAM/C,MAAM,UAAU,GAAG,kCAAkC,CAAC,gBAAgB,CAAC,CAAC;IACxE,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,gFAAgF;AAChF,MAAM,UAAU,wCAAwC;IAKtD,OAAO,mCAAmC,CAGxC,UAAU,CAAC,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,27 @@
+import { SharedObject, SharedRef } from 'expo-modules-core';
+import type { IImageResult, ISaveOptions } from './types';
+export declare class NativeImageRef extends SharedRef<'image'> {
+    width: number;
+    height: number;
+    saveAsync(options?: ISaveOptions): Promise<IImageResult>;
+}
+export declare class NativeImageManipulatorContext extends SharedObject {
+    resize(size: {
+        width?: number | null;
+        height?: number | null;
+    }): NativeImageManipulatorContext;
+    rotate(degrees: number): NativeImageManipulatorContext;
+    flip(flipType: 'vertical' | 'horizontal'): NativeImageManipulatorContext;
+    crop(rect: {
+        originX: number;
+        originY: number;
+        width: number;
+        height: number;
+    }): NativeImageManipulatorContext;
+    reset(): NativeImageManipulatorContext;
+    renderAsync(): Promise<NativeImageRef>;
+}
+export type INativeImageManipulatorModule = {
+    manipulate(source: string | NativeImageRef): NativeImageManipulatorContext;
+};
+export declare const expoImageManipulator: INativeImageManipulatorModule;

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

@@ -0,0 +1,4 @@
+import { requireNativeModule, SharedObject, SharedRef, } from 'expo-modules-core';
+const EXPO_IMAGE_MANIPULATOR_MODULE_NAME = 'ExpoImageManipulator';
+export const expoImageManipulator = requireNativeModule(EXPO_IMAGE_MANIPULATOR_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,SAAS,GACV,MAAM,mBAAmB,CAAC;AAG3B,MAAM,kCAAkC,GAAG,sBAAsB,CAAC;AA6BlE,MAAM,CAAC,MAAM,oBAAoB,GAC/B,mBAAmB,CACjB,kCAAkC,CACnC,CAAC"}

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

@@ -0,0 +1,47 @@
+export declare enum FlipType {
+    Vertical = "vertical",
+    Horizontal = "horizontal"
+}
+export declare enum SaveFormat {
+    JPEG = "jpeg",
+    PNG = "png",
+    WEBP = "webp"
+}
+export type IActionResize = {
+    /** Provide only one of `width`/`height` to preserve the image's ratio. */
+    resize: {
+        width?: number;
+        height?: number;
+    };
+};
+export type IActionRotate = {
+    /** Degrees, clockwise when positive, counter-clockwise when negative. */
+    rotate: number;
+};
+export type IActionFlip = {
+    flip: FlipType;
+};
+export type IActionCrop = {
+    crop: {
+        originX: number;
+        originY: number;
+        width: number;
+        height: number;
+    };
+};
+/** @deprecated use `manipulate(source)` instead. */
+export type IAction = IActionResize | IActionRotate | IActionFlip | IActionCrop;
+export type ISaveOptions = {
+    base64?: boolean;
+    /** `0.0`-`1.0`; `1` is no compression (highest quality). Default `1`. */
+    compress?: number;
+    /** Default `SaveFormat.JPEG`. */
+    format?: SaveFormat;
+};
+export type IImageResult = {
+    uri: string;
+    width: number;
+    height: number;
+    /** Set only when `base64` was truthy in `ISaveOptions`. */
+    base64?: string;
+};

package/build-ngc/core/types.js

@@ -0,0 +1,12 @@
+export var FlipType;
+(function (FlipType) {
+    FlipType["Vertical"] = "vertical";
+    FlipType["Horizontal"] = "horizontal";
+})(FlipType || (FlipType = {}));
+export var SaveFormat;
+(function (SaveFormat) {
+    SaveFormat["JPEG"] = "jpeg";
+    SaveFormat["PNG"] = "png";
+    SaveFormat["WEBP"] = "webp";
+})(SaveFormat || (SaveFormat = {}));
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,qCAAyB,CAAA;AAC3B,CAAC,EAHW,QAAQ,KAAR,QAAQ,QAGnB;AAED,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,2BAAa,CAAA;AACf,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB"}

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

@@ -0,0 +1,5 @@
+import type { IAction, ISaveOptions } from './types';
+export declare function validateArguments(uri: string, actions: IAction[], saveOptions: ISaveOptions): void;
+export declare function validateUri(uri: string): void;
+export declare function validateActions(actions: IAction[]): void;
+export declare function validateSaveOptions({ base64, compress, format, }: ISaveOptions): void;

package/build-ngc/core/validators.js

@@ -0,0 +1,93 @@
+import { FlipType, SaveFormat } from './types';
+const SUPPORTED_ACTION_TYPES = ['crop', 'flip', 'rotate', 'resize'];
+export function validateArguments(uri, actions, saveOptions) {
+    validateUri(uri);
+    validateActions(actions);
+    validateSaveOptions(saveOptions);
+}
+export function validateUri(uri) {
+    if (typeof uri !== 'string') {
+        throw new TypeError('The "uri" argument must be a string');
+    }
+}
+export function validateActions(actions) {
+    if (!Array.isArray(actions)) {
+        throw new TypeError('The "actions" argument must be an array');
+    }
+    for (const action of actions) {
+        if (typeof action !== 'object' || action === null) {
+            throw new TypeError('Action must be an object');
+        }
+        const actionKeys = Object.keys(action);
+        if (actionKeys.length !== 1) {
+            throw new TypeError(`Single action must contain exactly one transformation: ${SUPPORTED_ACTION_TYPES.join(', ')}`);
+        }
+        const actionType = actionKeys[0];
+        if (!SUPPORTED_ACTION_TYPES.includes(actionType)) {
+            throw new TypeError(`Unsupported action type: ${actionType}`);
+        }
+        if ('crop' in action) {
+            validateCropAction(action);
+        }
+        else if ('flip' in action) {
+            validateFlipAction(action);
+        }
+        else if ('rotate' in action) {
+            validateRotateAction(action);
+        }
+        else if ('resize' in action) {
+            validateResizeAction(action);
+        }
+    }
+}
+function validateCropAction(action) {
+    const isValid = typeof action.crop === 'object' &&
+        action.crop !== null &&
+        typeof action.crop.originX === 'number' &&
+        typeof action.crop.originY === 'number' &&
+        typeof action.crop.width === 'number' &&
+        typeof action.crop.height === 'number';
+    if (!isValid) {
+        throw new TypeError('Crop action must be an object of shape { originX: number; originY: number; width: number; height: number }');
+    }
+}
+function validateFlipAction(action) {
+    if (typeof action.flip !== 'string' ||
+        ![FlipType.Horizontal, FlipType.Vertical].includes(action.flip)) {
+        throw new TypeError(`Unsupported flip type: ${action.flip}`);
+    }
+}
+function validateRotateAction(action) {
+    if (typeof action.rotate !== 'number') {
+        throw new TypeError('Rotation must be a number');
+    }
+}
+function validateResizeAction(action) {
+    const isValid = typeof action.resize === 'object' &&
+        action.resize !== null &&
+        (typeof action.resize.width === 'number' ||
+            action.resize.width === undefined) &&
+        (typeof action.resize.height === 'number' ||
+            action.resize.height === undefined);
+    if (!isValid) {
+        throw new TypeError('Resize action must be an object of shape { width?: number; height?: number }');
+    }
+}
+export function validateSaveOptions({ base64, compress, format, }) {
+    if (base64 !== undefined && typeof base64 !== 'boolean') {
+        throw new TypeError('The "base64" argument must be a boolean');
+    }
+    if (compress !== undefined) {
+        if (typeof compress !== 'number') {
+            throw new TypeError('The "compress" argument must be a number');
+        }
+        if (compress < 0 || compress > 1) {
+            throw new TypeError('The "compress" argument must be a number between 0 and 1');
+        }
+    }
+    const allowedFormats = [SaveFormat.JPEG, SaveFormat.PNG, SaveFormat.WEBP];
+    if (format !== undefined && !allowedFormats.includes(format)) {
+        throw new TypeError(`The "format" argument must be one of: ${allowedFormats.join(', ')}`);
+    }
+}
+//# sourceMappingURL=validators.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/core/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAU/C,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAEpE,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,OAAkB,EAClB,WAAyB;IAEzB,WAAW,CAAC,GAAG,CAAC,CAAC;IACjB,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,mBAAmB,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAkB;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClD,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CACjB,0DAA0D,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9F,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,SAAS,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YACrB,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YAC5B,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAmB;IAC7C,MAAM,OAAO,GACX,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,MAAM,CAAC,IAAI,KAAK,IAAI;QACpB,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ;QACvC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,KAAK,QAAQ;QACvC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,QAAQ;QACrC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CACjB,4GAA4G,CAC7G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAmB;IAC7C,IACE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAC/D,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,0BAA0B,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAqB;IACjD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAqB;IACjD,MAAM,OAAO,GACX,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QACjC,MAAM,CAAC,MAAM,KAAK,IAAI;QACtB,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ;YACtC,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;QACpC,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ;YACvC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CACjB,8EAA8E,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAClC,MAAM,EACN,QAAQ,EACR,MAAM,GACO;IACb,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,SAAS,CACjB,0DAA0D,CAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,cAAc,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,SAAS,CACjB,yCAAyC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-image-manipulator",
+    "modules": [
+      {
+        "importPath": "expo.modules.imagemanipulator.ImageManipulatorModule",
+        "className": "ImageManipulatorModule",
+        "nativeName": "ExpoImageManipulator"
+      }
+    ]
+  }
+}

package/package.json

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

package/src/angular/index.ts

@@ -0,0 +1,2 @@
+export * from '../core';
+export { injectImageManipulator } from './inject-image-manipulator';

package/src/angular/inject-image-manipulator.ts

@@ -0,0 +1,17 @@
+// Angular twin of `useImageManipulator`, `injectX` shape matching
+// `@symbiote-native/navigation`'s `injectLinkingIntegration`
+
+import type { Signal } from '@angular/core';
+import { createResourceHook } from '@symbiote-native/angular';
+import type { IImageManipulatorContext, IImageRef } from '../core';
+import { createImageManipulatorResourceController } from '../core/manipulator-resource-controller';
+
+const injectManipulatorResource = createResourceHook(
+  createImageManipulatorResourceController,
+);
+
+export function injectImageManipulator(
+  source: () => string | IImageRef,
+): Signal<IImageManipulatorContext> {
+  return injectManipulatorResource(() => [source()]);
+}

package/src/core/image-manipulator.ts

@@ -0,0 +1,51 @@
+import { expoImageManipulator } from './native-module';
+import { SaveFormat } from './types';
+import { validateArguments } from './validators';
+import type {
+  NativeImageManipulatorContext,
+  NativeImageRef,
+} from './native-module';
+import type { IAction, IImageResult, ISaveOptions } from './types';
+
+export type { NativeImageManipulatorContext as IImageManipulatorContext };
+export type { NativeImageRef as IImageRef };
+
+/** Loads `source` and starts a new chainable manipulation context. */
+export function manipulate(
+  source: string | NativeImageRef,
+): NativeImageManipulatorContext {
+  return expoImageManipulator.manipulate(source);
+}
+
+/**
+ * @deprecated replaced by `manipulate(source)` / the returned context's chainable methods.
+ */
+export async function manipulateAsync(
+  uri: string,
+  actions: IAction[] = [],
+  saveOptions: ISaveOptions = {},
+): Promise<IImageResult> {
+  validateArguments(uri, actions, saveOptions);
+
+  const { format = SaveFormat.JPEG, ...rest } = saveOptions;
+  const context = expoImageManipulator.manipulate(uri);
+
+  for (const action of actions) {
+    if ('resize' in action) {
+      context.resize(action.resize);
+    } else if ('rotate' in action) {
+      context.rotate(action.rotate);
+    } else if ('flip' in action) {
+      context.flip(action.flip);
+    } else if ('crop' in action) {
+      context.crop(action.crop);
+    }
+  }
+  const image = await context.renderAsync();
+  const result = await image.saveAsync({ format, ...rest });
+
+  context.release();
+  image.release();
+
+  return result;
+}

package/src/core/index.ts

@@ -0,0 +1,12 @@
+export { manipulate, manipulateAsync } from './image-manipulator';
+export type { IImageManipulatorContext, IImageRef } from './image-manipulator';
+export { FlipType, SaveFormat } from './types';
+export type {
+  IAction,
+  IActionCrop,
+  IActionFlip,
+  IActionResize,
+  IActionRotate,
+  IImageResult,
+  ISaveOptions,
+} from './types';

package/src/core/manipulator-context-controller.ts

@@ -0,0 +1,34 @@
+// Thin binding of `@symbiote-native/engine`'s generic `createResourceController` to this
+// package's own `.release()`-shaped context, kept for its own descriptive type names
+
+import { createResourceController } from '@symbiote-native/engine';
+
+export type IReleasableContext = { release: () => void };
+
+export type IManipulatorContextController<
+  TSource,
+  TContext extends IReleasableContext,
+> = {
+  resolve: (source: TSource) => TContext;
+  flushRelease: () => void;
+  release: () => void;
+};
+
+export function createManipulatorContextController<
+  TSource,
+  TContext extends IReleasableContext,
+>(
+  manipulate: (source: TSource) => TContext,
+): IManipulatorContextController<TSource, TContext> {
+  const controller = createResourceController<TSource, TContext>(
+    manipulate,
+    context => {
+      context.release();
+    },
+  );
+  return {
+    resolve: controller.resolve,
+    flushRelease: controller.flushDispose,
+    release: controller.dispose,
+  };
+}

package/src/core/manipulator-resource-controller.ts

@@ -0,0 +1,40 @@
+// Adapts `createManipulatorContextController`'s `.release()`-shaped controller to the
+// `resolve`/`flushDispose`/`dispose` shape every adapter's `createResourceHook` expects
+
+import {
+  createManipulatorContextController,
+  type IReleasableContext,
+} from './manipulator-context-controller';
+import { manipulate } from './index';
+import type { IImageManipulatorContext, IImageRef } from './index';
+
+function createManipulatorResourceController<
+  TSource,
+  TContext extends IReleasableContext,
+>(
+  manipulateSource: (source: TSource) => TContext,
+): {
+  resolve: (source: TSource) => TContext;
+  flushDispose: () => void;
+  dispose: () => void;
+} {
+  const controller = createManipulatorContextController(manipulateSource);
+  return {
+    resolve: controller.resolve,
+    flushDispose: controller.flushRelease,
+    dispose: controller.release,
+  };
+}
+
+// Bakes in this package's own `manipulate`, so every adapter's `createResourceHook` binds a
+// plain zero-arg factory instead of repeating the same arrow wrapper five times
+export function createImageManipulatorResourceController(): {
+  resolve: (source: string | IImageRef) => IImageManipulatorContext;
+  flushDispose: () => void;
+  dispose: () => void;
+} {
+  return createManipulatorResourceController<
+    string | IImageRef,
+    IImageManipulatorContext
+  >(manipulate);
+}