@wasmedia/wimagemagick 0.2.0

package/dist/api.js

@@ -0,0 +1,218 @@
+/**
+ * MagickWand C API bindings via Emscripten cwrap.
+ *
+ * Provides typed wrappers around all exported MagickWand functions.
+ * For direct, low-level access to ImageMagick's C API from JavaScript.
+ */
+/** Create typed bindings for all exported MagickWand C functions. */
+export function createBindings(module) {
+    const w = (name, ret, args) => module.cwrap(name, ret, args);
+    return {
+        // Lifecycle
+        MagickWandGenesis: w("MagickWandGenesis", null, []),
+        MagickWandTerminus: w("MagickWandTerminus", null, []),
+        NewMagickWand: w("NewMagickWand", "number", []),
+        DestroyMagickWand: w("DestroyMagickWand", "number", ["number"]),
+        CloneMagickWand: w("CloneMagickWand", "number", ["number"]),
+        // Read/Write
+        MagickReadImage: w("MagickReadImage", "number", ["number", "string"]),
+        MagickWriteImage: w("MagickWriteImage", "number", ["number", "string"]),
+        MagickReadImageBlob: w("MagickReadImageBlob", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickGetImageBlob: w("MagickGetImageBlob", "number", [
+            "number",
+            "number",
+        ]),
+        // Memory
+        MagickRelinquishMemory: w("MagickRelinquishMemory", "number", ["number"]),
+        // Dimensions
+        MagickGetImageWidth: w("MagickGetImageWidth", "number", ["number"]),
+        MagickGetImageHeight: w("MagickGetImageHeight", "number", ["number"]),
+        // Format
+        MagickGetImageFormat: w("MagickGetImageFormat", "string", [
+            "number",
+        ]),
+        MagickSetImageFormat: w("MagickSetImageFormat", "number", [
+            "number",
+            "string",
+        ]),
+        // Resize
+        MagickResizeImage: w("MagickResizeImage", "number", [
+            "number",
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickAdaptiveResizeImage: w("MagickAdaptiveResizeImage", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickThumbnailImage: w("MagickThumbnailImage", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        // Crop/Extent
+        MagickCropImage: w("MagickCropImage", "number", [
+            "number",
+            "number",
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickExtentImage: w("MagickExtentImage", "number", [
+            "number",
+            "number",
+            "number",
+            "number",
+            "number",
+        ]),
+        // Transform
+        MagickRotateImage: w("MagickRotateImage", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickFlipImage: w("MagickFlipImage", "number", ["number"]),
+        MagickFlopImage: w("MagickFlopImage", "number", ["number"]),
+        MagickTransposeImage: w("MagickTransposeImage", "number", ["number"]),
+        MagickTransverseImage: w("MagickTransverseImage", "number", ["number"]),
+        // Filters
+        MagickBlurImage: w("MagickBlurImage", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickGaussianBlurImage: w("MagickGaussianBlurImage", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickSharpenImage: w("MagickSharpenImage", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickUnsharpMaskImage: w("MagickUnsharpMaskImage", "number", [
+            "number",
+            "number",
+            "number",
+            "number",
+            "number",
+        ]),
+        // Composite
+        MagickCompositeImage: w("MagickCompositeImage", "number", [
+            "number",
+            "number",
+            "number",
+            "number",
+            "number",
+            "number",
+        ]),
+        // Quality
+        MagickSetImageCompressionQuality: w("MagickSetImageCompressionQuality", "number", ["number", "number"]),
+        MagickGetImageCompressionQuality: w("MagickGetImageCompressionQuality", "number", ["number"]),
+        // Adjustments
+        MagickStripImage: w("MagickStripImage", "number", ["number"]),
+        MagickAutoOrientImage: w("MagickAutoOrientImage", "number", ["number"]),
+        MagickAutoLevelImage: w("MagickAutoLevelImage", "number", ["number"]),
+        MagickNormalizeImage: w("MagickNormalizeImage", "number", ["number"]),
+        MagickDeskewImage: w("MagickDeskewImage", "number", [
+            "number",
+            "number",
+        ]),
+        // Alpha
+        MagickSetImageAlphaChannel: w("MagickSetImageAlphaChannel", "number", [
+            "number",
+            "number",
+        ]),
+        // Errors
+        MagickGetException: w("MagickGetException", "string", [
+            "number",
+            "number",
+        ]),
+        MagickClearException: w("MagickClearException", "number", ["number"]),
+        // Resources
+        MagickSetResourceLimit: w("MagickSetResourceLimit", "number", [
+            "number",
+            "number",
+        ]),
+        MagickGetResourceLimit: w("MagickGetResourceLimit", "number", ["number"]),
+        // Settings
+        MagickSetSize: w("MagickSetSize", "number", [
+            "number",
+            "number",
+            "number",
+        ]),
+        MagickSetDepth: w("MagickSetDepth", "number", ["number", "number"]),
+        // Multi-image
+        MagickGetNumberImages: w("MagickGetNumberImages", "number", ["number"]),
+        MagickSetIteratorIndex: w("MagickSetIteratorIndex", "number", [
+            "number",
+            "number",
+        ]),
+        MagickResetIterator: w("MagickResetIterator", null, [
+            "number",
+        ]),
+        // Depth/Colorspace
+        MagickGetImageDepth: w("MagickGetImageDepth", "number", ["number"]),
+        MagickSetImageDepth: w("MagickSetImageDepth", "number", [
+            "number",
+            "number",
+        ]),
+        MagickGetImageColorspace: w("MagickGetImageColorspace", "number", [
+            "number",
+        ]),
+        MagickSetImageColorspace: w("MagickSetImageColorspace", "number", [
+            "number",
+            "number",
+        ]),
+        // Profiles
+        MagickProfileImage: w("MagickProfileImage", "number", [
+            "number",
+            "string",
+            "number",
+            "number",
+        ]),
+        MagickGetImageProfile: w("MagickGetImageProfile", "number", [
+            "number",
+            "string",
+            "number",
+        ]),
+        MagickRemoveImageProfile: w("MagickRemoveImageProfile", "number", [
+            "number",
+            "string",
+            "number",
+        ]),
+        // wimagemagick convenience wrappers
+        wimagemagick_identify: w("wimagemagick_identify", "number", [
+            "number",
+            "number",
+            "number",
+            "number",
+            "number",
+            "number",
+        ]),
+        wimagemagick_convert: w("wimagemagick_convert", "number", [
+            "number",
+            "number",
+            "string",
+            "number",
+            "number",
+        ]),
+        wimagemagick_resize: w("wimagemagick_resize", "number", [
+            "number",
+            "number",
+            "number",
+            "number",
+            "string",
+            "number",
+            "number",
+        ]),
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,71 @@
+/**
+ * CLI-style interface for ImageMagick commands.
+ *
+ * Wraps Module.callMain() with MEMFS file management and output capture.
+ * Uses IM7 syntax: callMain(['input.png', '-resize', '50%', 'output.jpg'])
+ */
+import type { WasmModule, CLIResult } from "./types.js";
+/** Build the `print`/`printErr` pair the loader passes to the WASM factory. */
+export declare function createOutputHooks(): Pick<WasmModule, "print" | "printErr">;
+/**
+ * Parse a command string into an argv array, respecting quoted strings.
+ *
+ * Examples:
+ *   "input.png -resize 50% output.jpg"  →  ["input.png", "-resize", "50%", "output.jpg"]
+ *   'input.png -set comment "hello world" output.jpg'  →  ["input.png", "-set", "comment", "hello world", "output.jpg"]
+ */
+export declare function parseCommand(command: string): string[];
+/**
+ * Execute an ImageMagick command with file I/O.
+ *
+ * @param module - The initialized WASM module
+ * @param command - Command string or argv array (IM7 syntax, no 'magick' prefix needed)
+ * @param inputFiles - Optional map of filename → data for input files
+ * @returns CLIResult with exit code, stdout, stderr, and output files
+ *
+ * @example
+ * ```typescript
+ * const result = await execute(module, 'input.png -resize 50% output.jpg', inputFiles);
+ * const jpeg = result.outputFiles.get('output.jpg');
+ * ```
+ */
+export declare function execute(module: WasmModule, command: string | string[], inputFiles?: Map<string, Uint8Array | ArrayBuffer>): CLIResult;
+/** Options for {@link identify}. */
+export interface IdentifyOptions {
+    /** Return ImageMagick's verbose description instead of `"<w> <h> <format>"`. */
+    verbose?: boolean;
+    /**
+     * Format to read the data as, e.g. `"DNG"` or `"CR2"`.
+     *
+     * Only the raw camera formats need it. Their coder is registered with
+     * `ExplicitFormatType`, so ImageMagick never selects it from a file's magic
+     * bytes — most raws are TIFF containers, and without a hint the TIFF coder
+     * claims them. When omitted, the raws {@link detectRawFormat} recognises
+     * (CR2, CR3, NEF, DNG, 3FR, IIQ) are supplied automatically; everything else
+     * is detected by ImageMagick itself.
+     */
+    format?: string;
+}
+/**
+ * Describe an image buffer, the way `magick identify` would.
+ *
+ * The build exposes ImageMagick's image command rather than its multi-tool
+ * dispatcher, so there is no `identify` sub-command; the description is
+ * produced with `info:` and read back from MEMFS, which also avoids the
+ * buffering of the WASM build's stdout.
+ *
+ * @param module - The initialized WASM module
+ * @param data - Image data to identify
+ * @param options - `true` for the verbose description, or an
+ *                  {@link IdentifyOptions} object
+ * @returns `"<width> <height> <format>"`, the verbose description, or the
+ *          error text if the image could not be read
+ *
+ * @example
+ * ```typescript
+ * identify(module, png);                          // "24 16 PNG"
+ * identify(module, cr2, { format: 'CR2' });       // "6024 4024 CR2"
+ * ```
+ */
+export declare function identify(module: WasmModule, data: Uint8Array | ArrayBuffer, options?: boolean | IdentifyOptions): string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA4BxD,+EAA+E;AAC/E,wBAAgB,iBAAiB,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC,CAW1E;AAiHD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAiCtD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC,GACjD,SAAS,CA+CX;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,GAAG,WAAW,EAC9B,OAAO,GAAE,OAAO,GAAG,eAAuB,GACzC,MAAM,CAwBR"}

package/dist/cli.js

@@ -0,0 +1,273 @@
+/**
+ * CLI-style interface for ImageMagick commands.
+ *
+ * Wraps Module.callMain() with MEMFS file management and output capture.
+ * Uses IM7 syntax: callMain(['input.png', '-resize', '50%', 'output.jpg'])
+ */
+import { createWorkDir, cleanWorkDir, writeToMemFS, readFromMemFS, existsInMemFS, readFilesFromMemFS, } from "./filesystem.js";
+import { detectRawFormat } from "./raw.js";
+let activeSink = null;
+/** Build the `print`/`printErr` pair the loader passes to the WASM factory. */
+export function createOutputHooks() {
+    return {
+        print: (text) => {
+            if (activeSink)
+                activeSink.stdout.push(text);
+            else
+                console.log(text);
+        },
+        printErr: (text) => {
+            if (activeSink)
+                activeSink.stderr.push(text);
+            else
+                console.error(text);
+        },
+    };
+}
+/** Run `fn` with module output redirected into strings. */
+function captureOutput(fn) {
+    const previous = activeSink;
+    const sink = { stdout: [], stderr: [] };
+    activeSink = sink;
+    try {
+        const value = fn();
+        return {
+            value,
+            stdout: sink.stdout.join("\n"),
+            stderr: sink.stderr.join("\n"),
+        };
+    }
+    finally {
+        activeSink = previous;
+    }
+}
+/**
+ * Pseudo-formats whose argument is content rather than a path — `xc:red`,
+ * `label:Hello world`, `gradient:red-blue`. Everything after the colon is
+ * passed through untouched for these.
+ *
+ * Every other `PREFIX:` is a format specifier on a real file (`dng:shot.cr2`,
+ * `png:out`, `info:report.txt`), and the part after the colon is a filename
+ * that has to be resolved in the working directory like any other.
+ */
+const CONTENT_PSEUDO_FORMATS = new Set([
+    "canvas",
+    "caption",
+    "checkerboard",
+    "clipboard",
+    "fractal",
+    "gradient",
+    "granite",
+    "hald",
+    "inline",
+    "label",
+    "logo",
+    "netscape",
+    "null",
+    "pango",
+    "pattern",
+    "plasma",
+    "radial-gradient",
+    "random",
+    "rose",
+    "screenshot",
+    "text",
+    "tile",
+    "vid",
+    "wizard",
+    "xc",
+]);
+/** Split `PREFIX:rest` into its parts, or return null if there is no prefix. */
+function splitFormatPrefix(arg) {
+    const colon = arg.indexOf(":");
+    if (colon <= 0)
+        return null;
+    const prefix = arg.slice(0, colon);
+    if (!/^[A-Za-z][A-Za-z0-9+-]*$/.test(prefix))
+        return null;
+    return { prefix, rest: arg.slice(colon + 1) };
+}
+/**
+ * A plain `name.ext`, deliberately stricter than the unprefixed check: the
+ * argument of `-define` also carries a colon (`jpeg:extent=1.5mb`), so
+ * anything carrying an `=`, a space or a bracket is left alone.
+ */
+const PLAIN_FILENAME = /^[A-Za-z0-9_][A-Za-z0-9_.-]*\.[A-Za-z0-9]{1,5}$/;
+/**
+ * Decide whether an argument names a file that lives in the working directory.
+ *
+ * ImageMagick argv mixes filenames with flags, geometry, colours and
+ * pseudo-format specifiers such as `xc:red` or `info:`; only the filenames may
+ * be rewritten to a working-directory path.
+ */
+function isWorkDirFile(arg, inputNames) {
+    if (arg.startsWith("-") || arg.startsWith("+"))
+        return false; // flag
+    if (arg.startsWith("/"))
+        return false; // already an absolute MEMFS path
+    if (inputNames.has(arg))
+        return true; // a file we just wrote
+    return /\.[A-Za-z0-9]{1,5}$/.test(arg); // looks like name.ext
+}
+/**
+ * Resolve one argument against the working directory, keeping any explicit
+ * `FORMAT:` prefix in place.
+ *
+ * The prefix matters for more than tidiness: the raw formats are registered
+ * with `ExplicitFormatType`, so ImageMagick will not pick LibRaw from a file's
+ * magic bytes — a DNG or CR2 is a TIFF at that level and the TIFF coder claims
+ * it. `dng:capture` is how the caller says otherwise.
+ */
+function rewriteArg(arg, inputNames, workDir) {
+    const split = splitFormatPrefix(arg);
+    if (split !== null) {
+        const { prefix, rest } = split;
+        if (CONTENT_PSEUDO_FORMATS.has(prefix.toLowerCase()))
+            return arg;
+        if (rest.startsWith("/"))
+            return arg; // already absolute
+        if (!inputNames.has(rest) && !PLAIN_FILENAME.test(rest))
+            return arg;
+        return `${prefix}:${workDir}/${rest}`;
+    }
+    return isWorkDirFile(arg, inputNames) ? `${workDir}/${arg}` : arg;
+}
+/**
+ * Parse a command string into an argv array, respecting quoted strings.
+ *
+ * Examples:
+ *   "input.png -resize 50% output.jpg"  →  ["input.png", "-resize", "50%", "output.jpg"]
+ *   'input.png -set comment "hello world" output.jpg'  →  ["input.png", "-set", "comment", "hello world", "output.jpg"]
+ */
+export function parseCommand(command) {
+    const args = [];
+    let current = "";
+    // Tracked separately from `current` so that an explicitly empty argument
+    // ("" or '') is still emitted rather than silently shifting argv.
+    let quoted = false;
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = 0; i < command.length; i++) {
+        const ch = command[i];
+        if (ch === "'" && !inDouble) {
+            inSingle = !inSingle;
+            quoted = true;
+        }
+        else if (ch === '"' && !inSingle) {
+            inDouble = !inDouble;
+            quoted = true;
+        }
+        else if (ch === " " && !inSingle && !inDouble) {
+            if (current.length > 0 || quoted) {
+                args.push(current);
+                current = "";
+                quoted = false;
+            }
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current.length > 0 || quoted) {
+        args.push(current);
+    }
+    return args;
+}
+/**
+ * Execute an ImageMagick command with file I/O.
+ *
+ * @param module - The initialized WASM module
+ * @param command - Command string or argv array (IM7 syntax, no 'magick' prefix needed)
+ * @param inputFiles - Optional map of filename → data for input files
+ * @returns CLIResult with exit code, stdout, stderr, and output files
+ *
+ * @example
+ * ```typescript
+ * const result = await execute(module, 'input.png -resize 50% output.jpg', inputFiles);
+ * const jpeg = result.outputFiles.get('output.jpg');
+ * ```
+ */
+export function execute(module, command, inputFiles) {
+    const args = typeof command === "string" ? parseCommand(command) : command;
+    const workDir = createWorkDir(module);
+    // Track input filenames so we can identify output files later
+    const inputNames = new Set();
+    // Write input files to MEMFS
+    if (inputFiles) {
+        for (const [name, data] of inputFiles) {
+            inputNames.add(name);
+            const bytes = data instanceof ArrayBuffer ? new Uint8Array(data) : data;
+            writeToMemFS(module, `${workDir}/${name}`, bytes);
+        }
+    }
+    // Rewrite filename arguments to workDir paths
+    const rewrittenArgs = args.map((arg) => rewriteArg(arg, inputNames, workDir));
+    // Execute with output captured
+    let exitCode;
+    let stdout = "";
+    let stderr = "";
+    try {
+        const run = captureOutput(() => module.callMain(rewrittenArgs));
+        exitCode = run.value;
+        stdout = run.stdout;
+        stderr = run.stderr;
+    }
+    catch (e) {
+        exitCode = 1;
+        stderr += `Exception: ${e}\n`;
+    }
+    // Read output files (all files in workDir that weren't inputs)
+    const outputFiles = readFilesFromMemFS(module, workDir, inputNames);
+    // Clean up
+    cleanWorkDir(module, workDir);
+    return {
+        exitCode,
+        stdout: stdout.trimEnd(),
+        stderr: stderr.trimEnd(),
+        outputFiles,
+    };
+}
+/**
+ * Describe an image buffer, the way `magick identify` would.
+ *
+ * The build exposes ImageMagick's image command rather than its multi-tool
+ * dispatcher, so there is no `identify` sub-command; the description is
+ * produced with `info:` and read back from MEMFS, which also avoids the
+ * buffering of the WASM build's stdout.
+ *
+ * @param module - The initialized WASM module
+ * @param data - Image data to identify
+ * @param options - `true` for the verbose description, or an
+ *                  {@link IdentifyOptions} object
+ * @returns `"<width> <height> <format>"`, the verbose description, or the
+ *          error text if the image could not be read
+ *
+ * @example
+ * ```typescript
+ * identify(module, png);                          // "24 16 PNG"
+ * identify(module, cr2, { format: 'CR2' });       // "6024 4024 CR2"
+ * ```
+ */
+export function identify(module, data, options = false) {
+    const { verbose = false, format: requested } = typeof options === "boolean" ? { verbose: options, format: undefined } : options;
+    const format = requested ?? detectRawFormat(data);
+    const workDir = createWorkDir(module);
+    const input = `${workDir}/input`;
+    const source = format ? `${format}:${input}` : input;
+    const report = `${workDir}/info.txt`;
+    try {
+        writeToMemFS(module, input, data);
+        const args = verbose
+            ? [source, "-verbose", `info:${report}`]
+            : [source, "-format", "%w %h %m", `info:${report}`];
+        const run = captureOutput(() => module.callMain(args));
+        if (run.value !== 0 || !existsInMemFS(module, report)) {
+            return run.stderr.trimEnd();
+        }
+        return new TextDecoder().decode(readFromMemFS(module, report)).trimEnd();
+    }
+    finally {
+        cleanWorkDir(module, workDir);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAiB3C,IAAI,UAAU,GAAsB,IAAI,CAAC;AAEzC,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE;YACtB,IAAI,UAAU;gBAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE;YACzB,IAAI,UAAU;gBAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBACxC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,SAAS,aAAa,CACpB,EAAW;IAEX,MAAM,QAAQ,GAAG,UAAU,CAAC;IAC5B,MAAM,IAAI,GAAe,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpD,UAAU,GAAG,IAAI,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,EAAE,CAAC;QACnB,OAAO;YACL,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SAC/B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,UAAU,GAAG,QAAQ,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,QAAQ;IACR,SAAS;IACT,cAAc;IACd,WAAW;IACX,SAAS;IACT,UAAU;IACV,SAAS;IACT,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;IACP,SAAS;IACT,QAAQ;IACR,iBAAiB;IACjB,QAAQ;IACR,MAAM;IACN,YAAY;IACZ,MAAM;IACN,MAAM;IACN,KAAK;IACL,QAAQ;IACR,IAAI;CACL,CAAC,CAAC;AAEH,gFAAgF;AAChF,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,cAAc,GAAG,iDAAiD,CAAC;AAEzE;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,GAAW,EAAE,UAAuB;IACzD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,OAAO;IACrE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,iCAAiC;IACxE,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,uBAAuB;IAC7D,OAAO,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,sBAAsB;AAChE,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,UAAU,CACjB,GAAW,EACX,UAAuB,EACvB,OAAe;IAEf,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QAC/B,IAAI,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,GAAG,CAAC;QACjE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,CAAC,mBAAmB;QACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC;QACpE,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,yEAAyE;IACzE,kEAAkE;IAClE,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnB,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,KAAK,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,OAAO,CACrB,MAAkB,EAClB,OAA0B,EAC1B,UAAkD;IAElD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEtC,8DAA8D;IAC9D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAErC,6BAA6B;IAC7B,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,UAAU,EAAE,CAAC;YACtC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,IAAI,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxE,YAAY,CAAC,MAAM,EAAE,GAAG,OAAO,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACrC,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,CACrC,CAAC;IAEF,+BAA+B;IAC/B,IAAI,QAAgB,CAAC;IACrB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;QAChE,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC;QACrB,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACpB,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IACtB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,GAAG,CAAC,CAAC;QACb,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,+DAA+D;IAC/D,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAEpE,WAAW;IACX,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE;QACxB,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE;QACxB,WAAW;KACZ,CAAC;AACJ,CAAC;AAmBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAkB,EAClB,IAA8B,EAC9B,UAAqC,KAAK;IAE1C,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAC1C,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACnF,MAAM,MAAM,GAAG,SAAS,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,GAAG,OAAO,QAAQ,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACrD,MAAM,MAAM,GAAG,GAAG,OAAO,WAAW,CAAC;IAErC,IAAI,CAAC;QACH,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,MAAM,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,MAAM,EAAE,CAAC,CAAC;QAEtD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YACtD,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3E,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/filesystem.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MEMFS filesystem helpers for managing files in the Emscripten virtual filesystem.
+ */
+import type { WasmModule } from "./types.js";
+/** Create a unique working directory in MEMFS. */
+export declare function createWorkDir(module: WasmModule): string;
+/** Remove a working directory and all its contents. */
+export declare function cleanWorkDir(module: WasmModule, dir: string): void;
+/** Write a Uint8Array or ArrayBuffer to a MEMFS path. */
+export declare function writeToMemFS(module: WasmModule, path: string, data: Uint8Array | ArrayBuffer): void;
+/** Read a file from MEMFS as Uint8Array. */
+export declare function readFromMemFS(module: WasmModule, path: string): Uint8Array;
+/** Check if a file exists in MEMFS. */
+export declare function existsInMemFS(module: WasmModule, path: string): boolean;
+/** Remove a file from MEMFS. */
+export declare function removeFromMemFS(module: WasmModule, path: string): void;
+/** Write multiple files to a MEMFS directory. Returns the directory path. */
+export declare function writeFilesToMemFS(module: WasmModule, dir: string, files: Map<string, Uint8Array | ArrayBuffer>): void;
+/** Read all files from a MEMFS directory. Returns a map of filename → data. */
+export declare function readFilesFromMemFS(module: WasmModule, dir: string, exclude?: Set<string>): Map<string, Uint8Array>;
+/**
+ * Copy a blob from WASM heap memory to a new Uint8Array.
+ * Use this when reading MagickGetImageBlob output.
+ */
+export declare function copyFromHeap(module: WasmModule, ptr: number, length: number): Uint8Array;
+/**
+ * Write data to WASM heap memory, returning the pointer.
+ * Caller must free the pointer with module._free().
+ */
+export declare function copyToHeap(module: WasmModule, data: Uint8Array | ArrayBuffer): number;
+/** Convert a Uint8Array to a Blob. */
+export declare function toBlob(data: Uint8Array, mimeType?: string): Blob;
+/** Convert a Uint8Array to a data URL. */
+export declare function toDataURL(data: Uint8Array, mimeType: string): string;
+/** Get MIME type for an image format. */
+export declare function getMimeType(format: string): string;
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../src/filesystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIxD;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAgBlE;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,UAAU,GAAG,WAAW,GAC7B,IAAI,CAGN;AAED,4CAA4C;AAC5C,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,GACX,UAAU,CAEZ;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAC3B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAOT;AAED,gCAAgC;AAChC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,GACX,IAAI,CAMN;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC,GAC3C,IAAI,CAIN;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACpB,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAqBzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,UAAU,CAIZ;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,UAAU,GAAG,WAAW,GAC7B,MAAM,CAKR;AAED,sCAAsC;AACtC,wBAAgB,MAAM,CACpB,IAAI,EAAE,UAAU,EAChB,QAAQ,GAAE,MAAmC,GAC5C,IAAI,CAEN;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpE;AAiBD,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD"}