@wasmedia/wenblend 0.1.0

package/dist/loader.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Per-tool wasm module loading.
+ *
+ * Two facts drive this file:
+ *
+ *   1. Each tool is its own ~3 MB module. A page that only blends must
+ *      not pay for the fuse module, so the import is per-tool and lazy.
+ *   2. Both tools keep state in C++ globals and neither resets it, so a
+ *      module INSTANCE is never reused across invocations.
+ *
+ * So two things are cached per tool and one is not:
+ *
+ *   - the JS glue's factory (the dynamic import), and
+ *   - the COMPILED `WebAssembly.Module`, fetched and compiled once and
+ *     handed to every later factory call through Emscripten's
+ *     `instantiateWasm` hook, so a new instance costs an instantiate,
+ *     not a re-download and re-compile of ~3 MB;
+ *   - never the instance itself.
+ *
+ * Without the hook, each factory call runs the glue's own createWasm,
+ * which fetches and compiles the .wasm from scratch every time.
+ */
+import type { WasmModule, LoaderOptions } from "./types.js";
+export type Tool = "enblend" | "enfuse";
+/**
+ * Output hooks, bound at construction.
+ *
+ * Emscripten reads `Module["print"]`/`Module["printErr"]` exactly once,
+ * inside the factory body, and binds them into module-local variables
+ * before the factory's promise resolves. Assigning `module.print` after
+ * `await factory(...)` returns is inert. Callers that want to capture
+ * output must build their closures first and pass them into
+ * `createInstance`.
+ */
+export type InstanceHooks = Pick<WasmModule, "print" | "printErr">;
+/** A tool's Emscripten module factory: the default export of its `.js` glue. */
+export type ModuleFactory = (config?: Record<string, unknown>) => Promise<WasmModule>;
+type FactoryLoader = (tool: Tool, options?: LoaderOptions) => Promise<ModuleFactory>;
+/** Test seam: replace the dynamic import. */
+export declare function __setFactoryLoader(fn: FactoryLoader): void;
+/** Test seam: replace the wasm fetch-and-compile step. */
+export declare function __setWasmCompiler(fn: (tool: Tool, options?: LoaderOptions) => Promise<WebAssembly.Module>): void;
+/** Test seam: drop cached factories and compiled modules. */
+export declare function resetFactoryCache(): void;
+/**
+ * Import a tool's JS glue and return its module factory. Cached per tool and resolved glue URL.
+ *
+ * Calling the returned factory directly compiles the .wasm afresh on every
+ * call; `createInstance` is what supplies the cached compiled module.
+ *
+ * `async` so that a `wasmPath` that is not a valid URL rejects rather than
+ * throwing synchronously. The cache lookup still happens before the first
+ * `await`, so concurrent first calls share one import.
+ */
+export declare function loadFactory(tool: Tool, options?: LoaderOptions): Promise<ModuleFactory>;
+/**
+ * Build a fresh module instance.
+ *
+ * Never cache the result. See the file header.
+ *
+ * `hooks` is passed straight into the factory's config object, since that
+ * is the only point at which `print`/`printErr` can take effect (see
+ * `InstanceHooks`).
+ *
+ * The compiled module reaches the glue through `instantiateWasm`: the glue
+ * calls it with its import object in place of its own fetch-and-compile,
+ * and waits for `receiveInstance`. That wait has no rejection path — the
+ * glue wraps the hook in a promise whose `reject` it never calls — so a
+ * compile or instantiate failure is raced against the factory here, or
+ * the call would hang forever instead of rejecting.
+ */
+export declare function createInstance(tool: Tool, options?: LoaderOptions, hooks?: Partial<InstanceHooks>): Promise<WasmModule>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC;AAEnE,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AACtF,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAoGrF,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAE1D;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GACvE,IAAI,CAEN;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAW7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC,CAkBrB"}

package/dist/loader.js

@@ -0,0 +1,181 @@
+/**
+ * Per-tool wasm module loading.
+ *
+ * Two facts drive this file:
+ *
+ *   1. Each tool is its own ~3 MB module. A page that only blends must
+ *      not pay for the fuse module, so the import is per-tool and lazy.
+ *   2. Both tools keep state in C++ globals and neither resets it, so a
+ *      module INSTANCE is never reused across invocations.
+ *
+ * So two things are cached per tool and one is not:
+ *
+ *   - the JS glue's factory (the dynamic import), and
+ *   - the COMPILED `WebAssembly.Module`, fetched and compiled once and
+ *     handed to every later factory call through Emscripten's
+ *     `instantiateWasm` hook, so a new instance costs an instantiate,
+ *     not a re-download and re-compile of ~3 MB;
+ *   - never the instance itself.
+ *
+ * Without the hook, each factory call runs the glue's own createWasm,
+ * which fetches and compiles the .wasm from scratch every time.
+ */
+const MODULE_FILE = {
+    enblend: "wenblend.js",
+    enfuse: "wenfuse.js",
+};
+const WASM_FILE = {
+    enblend: "wenblend.wasm",
+    enfuse: "wenfuse.wasm",
+};
+// Both caches are keyed on the tool AND the absolute glue URL, so a second
+// call with a different `wasmPath` loads that module instead of silently
+// reusing the first. Relative and absolute spellings of one location resolve
+// to the same key.
+const factories = new Map();
+const compiled = new Map();
+function glueUrl(tool, options) {
+    return options?.wasmPath
+        ?? new URL(`../dist/${MODULE_FILE[tool]}`, import.meta.url).href;
+}
+/**
+ * The glue's absolute URL. `new URL` needs an absolute base, but `wasmPath`
+ * may be relative (what bundlers hand out, e.g. Vite's `?url`), so it is
+ * resolved against this module — the same base `import()` uses for the glue.
+ */
+function resolvedGlueUrl(tool, options) {
+    return new URL(glueUrl(tool, options), import.meta.url);
+}
+function cacheKey(tool, options) {
+    return `${tool} ${resolvedGlueUrl(tool, options).href}`;
+}
+async function importFactory(tool, options) {
+    const mod = await import(/* webpackIgnore: true */ glueUrl(tool, options));
+    return (mod.default ?? mod);
+}
+/**
+ * Fetch and compile a tool's .wasm.
+ *
+ * The URL is the one the glue itself would use: its `locateFile` default
+ * resolves the .wasm name against the glue's own directory. `file:` URLs
+ * (Node) are read from disk, because Node's fetch does not do `file:`;
+ * everything else is fetched, streaming-compiled where the server's MIME
+ * type allows and compiled from bytes where it does not — the same
+ * fallback the glue performs.
+ */
+async function compileWasm(tool, options) {
+    const url = new URL(WASM_FILE[tool], resolvedGlueUrl(tool, options));
+    if (url.protocol === "file:") {
+        // A variable specifier keeps bundlers from trying to resolve a Node
+        // builtin into browser code; this branch only runs under Node.
+        const fsSpec = "node:fs/promises";
+        const urlSpec = "node:url";
+        const { readFile } = await import(/* webpackIgnore: true */ /* @vite-ignore */ fsSpec);
+        const { fileURLToPath } = await import(/* webpackIgnore: true */ /* @vite-ignore */ urlSpec);
+        return WebAssembly.compile(await readFile(fileURLToPath(url)));
+    }
+    const response = fetch(url.href, { credentials: "same-origin" });
+    if (typeof WebAssembly.compileStreaming === "function") {
+        try {
+            return await WebAssembly.compileStreaming(response);
+        }
+        catch {
+            // Wrong MIME type, most often. Fall through to compiling bytes.
+        }
+    }
+    const res = await response;
+    if (!res.ok)
+        throw new Error(`failed to fetch ${url.href}: HTTP ${res.status}`);
+    return WebAssembly.compile(await res.arrayBuffer());
+}
+let compileWasmImpl = compileWasm;
+/**
+ * The compiled module for a tool, compiled at most once per resolved URL.
+ *
+ * A promise is cached, so concurrent first calls share one compile. A
+ * failed compile is evicted, so a transient network error is retried on
+ * the next call rather than poisoning the cache for the page's lifetime.
+ */
+async function loadCompiled(tool, options) {
+    const key = cacheKey(tool, options);
+    let existing = compiled.get(key);
+    if (!existing) {
+        existing = compileWasmImpl(tool, options).catch((err) => {
+            compiled.delete(key);
+            throw err;
+        });
+        compiled.set(key, existing);
+    }
+    return existing;
+}
+let loadFactoryImpl = importFactory;
+/** Test seam: replace the dynamic import. */
+export function __setFactoryLoader(fn) {
+    loadFactoryImpl = fn;
+}
+/** Test seam: replace the wasm fetch-and-compile step. */
+export function __setWasmCompiler(fn) {
+    compileWasmImpl = fn;
+}
+/** Test seam: drop cached factories and compiled modules. */
+export function resetFactoryCache() {
+    factories.clear();
+    compiled.clear();
+    loadFactoryImpl = importFactory;
+    compileWasmImpl = compileWasm;
+}
+/**
+ * Import a tool's JS glue and return its module factory. Cached per tool and resolved glue URL.
+ *
+ * Calling the returned factory directly compiles the .wasm afresh on every
+ * call; `createInstance` is what supplies the cached compiled module.
+ *
+ * `async` so that a `wasmPath` that is not a valid URL rejects rather than
+ * throwing synchronously. The cache lookup still happens before the first
+ * `await`, so concurrent first calls share one import.
+ */
+export async function loadFactory(tool, options) {
+    const key = cacheKey(tool, options);
+    let existing = factories.get(key);
+    if (!existing) {
+        existing = loadFactoryImpl(tool, options).catch((err) => {
+            factories.delete(key);
+            throw err;
+        });
+        factories.set(key, existing);
+    }
+    return existing;
+}
+/**
+ * Build a fresh module instance.
+ *
+ * Never cache the result. See the file header.
+ *
+ * `hooks` is passed straight into the factory's config object, since that
+ * is the only point at which `print`/`printErr` can take effect (see
+ * `InstanceHooks`).
+ *
+ * The compiled module reaches the glue through `instantiateWasm`: the glue
+ * calls it with its import object in place of its own fetch-and-compile,
+ * and waits for `receiveInstance`. That wait has no rejection path — the
+ * glue wraps the hook in a promise whose `reject` it never calls — so a
+ * compile or instantiate failure is raced against the factory here, or
+ * the call would hang forever instead of rejecting.
+ */
+export async function createInstance(tool, options, hooks) {
+    options?.onProgress?.("loading");
+    const factory = await loadFactory(tool, options);
+    options?.onProgress?.("initializing");
+    let fail;
+    const failed = new Promise((_, reject) => { fail = reject; });
+    const instantiateWasm = (imports, receiveInstance) => {
+        loadCompiled(tool, options)
+            .then(async (module) => receiveInstance(await WebAssembly.instantiate(module, imports), module))
+            .catch(fail);
+        return {};
+    };
+    const instance = await Promise.race([factory({ ...hooks, instantiateWasm }), failed]);
+    options?.onProgress?.("ready");
+    return instance;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/operations.d.ts

@@ -0,0 +1,45 @@
+/**
+ * High-level functional API.
+ *
+ * Enblend is invocation-oriented — N inputs plus flags produce one
+ * output — so this layer is a thin argv builder rather than the
+ * chainable object the single-image siblings expose.
+ */
+import type { InputImage, BlendOptions, FuseOptions, LoaderOptions, FileInput, OutputDir, WrittenFile } from "./types.js";
+import type { Tool } from "./loader.js";
+export type ImageInput = InputImage | Uint8Array | ArrayBuffer;
+/**
+ * Give every input a name, auto-naming bare buffers positionally.
+ *
+ * Throws on a name collision rather than silently renaming: a caller who
+ * supplies an explicit name may reference it again in `options.args`
+ * (an `--exclude somefile.tif` flag, say), so renaming around a clash
+ * could silently break a working invocation in a new way. Two inputs
+ * sharing a name would otherwise stage to the same MEMFS path — the
+ * second overwriting the first — and the tool would run to completion
+ * on the wrong input set with no error, which is exactly the kind of
+ * silent corruption this port cannot afford another instance of.
+ */
+export declare function normalizeInputs(images: ImageInput[]): InputImage[];
+export declare function normalizeInputs(images: FileInput[]): FileInput[];
+export declare function runOperation(tool: Tool, images: ImageInput[] | FileInput[], options?: (BlendOptions | FuseOptions) & {
+    outputDir?: OutputDir;
+}, loaderOptions?: LoaderOptions): Promise<Uint8Array | WrittenFile>;
+/**
+ * Blend overlapping images into one.
+ *
+ * Enblend positions images by their TIFF XPosition/YPosition tags, not
+ * by any argument. Inputs without correct offsets — two unaligned
+ * JPEGs, say — produce a valid file containing a useless image. Use
+ * remapped output from a stitcher.
+ */
+export declare function blend(images: ImageInput[], options?: BlendOptions, loaderOptions?: LoaderOptions): Promise<Uint8Array>;
+export declare function blend(images: FileInput[], options: BlendOptions & {
+    outputDir: OutputDir;
+}, loaderOptions?: LoaderOptions): Promise<WrittenFile>;
+/** Fuse a bracketed exposure series into one image. */
+export declare function fuse(images: ImageInput[], options?: FuseOptions, loaderOptions?: LoaderOptions): Promise<Uint8Array>;
+export declare function fuse(images: FileInput[], options: FuseOptions & {
+    outputDir: OutputDir;
+}, loaderOptions?: LoaderOptions): Promise<WrittenFile>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG1H,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAI/D;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAAC;AACpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC;AAwDlE,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,EAAE,EAClC,OAAO,GAAE,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAO,EACtE,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,UAAU,GAAG,WAAW,CAAC,CAiCnC;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACxH,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAKlJ,uDAAuD;AACvD,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtH,wBAAgB,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,EAAE,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC"}

package/dist/operations.js

@@ -0,0 +1,94 @@
+/**
+ * High-level functional API.
+ *
+ * Enblend is invocation-oriented — N inputs plus flags produce one
+ * output — so this layer is a thin argv builder rather than the
+ * chainable object the single-image siblings expose.
+ */
+import { EnblendError } from "./types.js";
+import { enblend, enfuse } from "./cli.js";
+import { isFileInput } from "./staging.js";
+const DEFAULT_OUTPUT = "output.tif";
+export function normalizeInputs(images) {
+    const seen = new Set();
+    return images.map((image, i) => {
+        const input = image instanceof Uint8Array || image instanceof ArrayBuffer
+            ? { name: `in${i}.tif`, data: image }
+            : image;
+        if (seen.has(input.name)) {
+            throw new Error(`normalizeInputs: duplicate input name "${input.name}"`);
+        }
+        seen.add(input.name);
+        return input;
+    });
+}
+// Short options that take an argument in enblend or enfuse ("v" and "w" take
+// an optional one). getopt treats the rest of a cluster after any of these as
+// that argument, so scanning a cluster for "o" stops at the first of them.
+const SHORT_WITH_ARGUMENT = new Set(["b", "d", "f", "l", "m", "o", "v", "w"]);
+/** Whether getopt_long would read `arg` as the output option, as enblend and enfuse define it. */
+function isOutputOption(arg) {
+    if (arg.startsWith("--")) {
+        // Any unambiguous prefix of a long option is accepted, so "--out" is
+        // "--output". "--o" is ambiguous in enblend (it has --optimize too) but
+        // means --output in enfuse; rejecting it costs nothing either way.
+        const name = arg.slice(2).split("=", 1)[0];
+        return name.startsWith("o") && "output".startsWith(name);
+    }
+    if (!arg.startsWith("-"))
+        return false;
+    for (const c of arg.slice(1)) {
+        if (c === "o")
+            return true;
+        if (SHORT_WITH_ARGUMENT.has(c))
+            return false;
+    }
+    return false;
+}
+/**
+ * Reject output settings that could only end in a confusing "produced no
+ * output file" after a full run. The tool writes into its per-invocation
+ * work directory, and the output is collected from there by name, so it
+ * must be a plain file name that no input shares, and set only once.
+ */
+function validateOutput(output, args, inputs) {
+    if (output === "" || output === "." || output === ".." || /[/\\]/.test(output)) {
+        throw new Error(`options.output must be a plain file name, got "${output}"`);
+    }
+    const setsOutput = args.find(isOutputOption);
+    if (setsOutput !== undefined) {
+        throw new Error(`set the output file with options.output, not "${setsOutput}" in args`);
+    }
+    if (inputs.some((i) => i.name === output)) {
+        throw new Error(`input name "${output}" collides with the output file name`);
+    }
+}
+export async function runOperation(tool, images, options = {}, loaderOptions) {
+    if (images.length === 0) {
+        throw new Error(`${tool} requires at least one input image`);
+    }
+    const files = images.every(isFileInput);
+    const inputs = normalizeInputs(images);
+    const output = options.output ?? DEFAULT_OUTPUT;
+    validateOutput(output, options.args ?? [], inputs);
+    const argv = ["-o", output, ...(options.args ?? []), ...inputs.map((i) => i.name)];
+    const invoke = tool === "enblend" ? enblend : enfuse;
+    const result = files
+        ? await invoke(argv, inputs, { ...loaderOptions, outputDir: options.outputDir })
+        : await invoke(argv, inputs, loaderOptions);
+    if (result.exitCode !== 0) {
+        throw new EnblendError(`${tool} exited with code ${result.exitCode}${result.stderr ? `: ${result.stderr}` : ""}`, result.exitCode, result.stderr);
+    }
+    const produced = "written" in result ? result.written.get(output) : result.outputFiles.get(output);
+    if (!produced) {
+        throw new EnblendError(`${tool} exited cleanly but produced no output file "${output}"`, 0, result.stderr);
+    }
+    return produced;
+}
+export function blend(images, options, loaderOptions) {
+    return runOperation("enblend", images, options, loaderOptions);
+}
+export function fuse(images, options, loaderOptions) {
+    return runOperation("enfuse", images, options, loaderOptions);
+}
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

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

package/dist/staging.d.ts

@@ -0,0 +1,37 @@
+/**
+ * How a run's files reach the tool and come back.
+ *
+ * runTool() has one flow: stage, callMain, collect, release. This interface
+ * is what varies. stageBuffers is the MEMFS path every caller used before file
+ * mode existed, and its behaviour is unchanged. stageFiles (file mode) mounts
+ * files through wopfs.
+ */
+import type { FileInput, InputImage, LoaderOptions, OutputDir, WasmModule, WrittenFile } from "./types.js";
+export interface Staging {
+    /** The directory the tool runs in (its cwd). */
+    readonly workDir: string;
+    readonly inputNames: ReadonlySet<string>;
+    /** Everything the run created. Buffer mode: bytes. File mode: committed files. */
+    collect(): Promise<Map<string, Uint8Array | WrittenFile>>;
+    /** Total input pixels, for OutOfMemoryError. Callable after release(). */
+    pixelCount(): Promise<number | undefined>;
+    /** Idempotent. runTool calls it in a finally on every path. */
+    release(): Promise<void>;
+}
+export declare function stageBuffers(module: WasmModule, inputs: InputImage[]): Staging;
+/** True for `{ name, file }`, the file-mode input shape. */
+export declare function isFileInput(x: unknown): x is FileInput;
+/**
+ * How many files a run can create, from its argv: the -o output, plus
+ * --visualize's image, plus a soft and a hard mask per input for
+ * --save-mask(s). enblend and enfuse create no temporary files (spec,
+ * finding 2). --load-mask(s) reads, so it adds nothing here.
+ */
+export declare function scratchFor(argv: readonly string[], inputCount: number): number;
+/**
+ * Mount the run's files through wopfs. Everything is opened here, before
+ * callMain, because the tool cannot await. The pool is strict: spilling
+ * would put new files back in memory and defeat the point (spec, Decisions).
+ */
+export declare function stageFiles(module: WasmModule, inputs: FileInput[], outputDir: OutputDir, argv: readonly string[], options?: LoaderOptions): Promise<Staging>;
+//# sourceMappingURL=staging.d.ts.map

package/dist/staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staging.d.ts","sourceRoot":"","sources":["../src/staging.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK3G,MAAM,WAAW,OAAO;IACtB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,kFAAkF;IAClF,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC;IAC1D,0EAA0E;IAC1E,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1C,+DAA+D;IAC/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CA6B9E;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAEtD;AASD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAK9E;AA6CD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,SAAS,EAAE,EACnB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,OAAO,CAAC,CAoClB"}

package/dist/staging.js

@@ -0,0 +1,157 @@
+/**
+ * How a run's files reach the tool and come back.
+ *
+ * runTool() has one flow: stage, callMain, collect, release. This interface
+ * is what varies. stageBuffers is the MEMFS path every caller used before file
+ * mode existed, and its behaviour is unchanged. stageFiles (file mode) mounts
+ * files through wopfs.
+ */
+import { createWorkDir, stageInputs, collectOutputs, cleanWorkDir, nextWorkDirName, toBytes } from "./filesystem.js";
+import { tiffPixelCount, tiffPixelCountAt } from "./tiff-header.js";
+import { loadWopfs } from "./wopfs.js";
+export function stageBuffers(module, inputs) {
+    const workDir = createWorkDir(module);
+    const inputNames = stageInputs(module, workDir, inputs);
+    let released = false;
+    return {
+        workDir,
+        inputNames,
+        async collect() {
+            return collectOutputs(module, workDir, inputNames);
+        },
+        async pixelCount() {
+            // With no inputs no header states a count, so none is known; 0 would be a claim.
+            if (inputs.length === 0)
+                return undefined;
+            let total = 0;
+            for (const input of inputs) {
+                const n = tiffPixelCount(toBytes(input.data));
+                if (n === undefined)
+                    return undefined;
+                total += n;
+            }
+            return total;
+        },
+        async release() {
+            if (released)
+                return;
+            released = true;
+            // The instance is discarded after this call (never reused, per
+            // createInstance's contract), so there is no previous cwd to restore.
+            cleanWorkDir(module, workDir);
+        },
+    };
+}
+/** True for `{ name, file }`, the file-mode input shape. */
+export function isFileInput(x) {
+    return typeof x === "object" && x !== null && "file" in x && "name" in x && !("data" in x);
+}
+// getopt_long accepts any unambiguous prefix of a long option. Over-counting
+// costs an empty pre-opened file; under-counting fails the run, so a prefix
+// match errs on the generous side.
+const longName = (arg) => (arg.startsWith("--") ? arg.slice(2).split("=", 1)[0] : "");
+const names = (argv, option) => argv.some((arg) => { const n = longName(arg); return n.length >= 2 && option.startsWith(n); });
+/**
+ * How many files a run can create, from its argv: the -o output, plus
+ * --visualize's image, plus a soft and a hard mask per input for
+ * --save-mask(s). enblend and enfuse create no temporary files (spec,
+ * finding 2). --load-mask(s) reads, so it adds nothing here.
+ */
+export function scratchFor(argv, inputCount) {
+    let n = 1;
+    if (names(argv, "visualize"))
+        n += 1;
+    if (names(argv, "save-masks"))
+        n += 2 * inputCount;
+    return n;
+}
+/** A reader for the pixel count: a byte range of a file, without reading the rest. */
+function readerFor(file) {
+    if (typeof file === "string") {
+        return async (offset, length) => {
+            // A variable specifier: the browser build never resolves node:fs.
+            const specifier = "node:fs/promises";
+            const { open } = await import(/* @vite-ignore */ specifier);
+            const handle = await open(file, "r");
+            try {
+                const buffer = new Uint8Array(length);
+                const { bytesRead } = await handle.read(buffer, 0, length, offset);
+                return buffer.subarray(0, bytesRead);
+            }
+            finally {
+                await handle.close();
+            }
+        };
+    }
+    return async (offset, length) => new Uint8Array(await (await file.getFile()).slice(offset, offset + length).arrayBuffer());
+}
+/**
+ * Turn what wopfs committed into a WrittenFile. On the main thread wopfs
+ * falls back to MEMFS, which returns bytes and ignores outputDir. Write those
+ * into outputDir here, so file mode hands back a file in every environment.
+ */
+async function toWrittenFile(c, outputDir) {
+    if (c.handle)
+        return { name: c.path, file: c.handle, size: c.size };
+    if (c.hostPath)
+        return { name: c.path, file: c.hostPath, size: c.size };
+    if (c.bytes && typeof outputDir !== "string") {
+        // Check before creating the file, so a failure leaves no empty file behind.
+        if (typeof FileSystemFileHandle === "undefined" || !("createWritable" in FileSystemFileHandle.prototype)) {
+            throw new Error("file mode on this thread needs FileSystemFileHandle.createWritable; run it in a dedicated worker instead");
+        }
+        const handle = await outputDir.getFileHandle(c.path, { create: true });
+        const writable = await handle.createWritable();
+        await writable.write(c.bytes);
+        await writable.close();
+        return { name: c.path, file: handle, size: c.bytes.length };
+    }
+    throw new Error(`wopfs committed "${c.path}" with neither a file nor bytes`);
+}
+/**
+ * Mount the run's files through wopfs. Everything is opened here, before
+ * callMain, because the tool cannot await. The pool is strict: spilling
+ * would put new files back in memory and defeat the point (spec, Decisions).
+ */
+export async function stageFiles(module, inputs, outputDir, argv, options) {
+    const wopfs = await loadWopfs(options);
+    const workDir = nextWorkDirName();
+    const mount = await wopfs.mountFiles(module, workDir, {
+        inputs: Object.fromEntries(inputs.map((i) => [i.name, i.file])),
+        outputDir,
+        scratch: scratchFor(argv, inputs.length),
+        onExhausted: "strict",
+    });
+    let released = false;
+    return {
+        workDir,
+        inputNames: new Set(inputs.map((i) => i.name)),
+        async collect() {
+            const out = new Map();
+            for (const c of await mount.commit())
+                out.set(c.path, await toWrittenFile(c, outputDir));
+            return out;
+        },
+        async pixelCount() {
+            if (inputs.length === 0)
+                return undefined;
+            let total = 0;
+            for (const input of inputs) {
+                const n = await tiffPixelCountAt(readerFor(input.file));
+                if (n === undefined)
+                    return undefined;
+                total += n;
+            }
+            return total;
+        },
+        async release() {
+            if (released)
+                return;
+            released = true;
+            // runTool ran the tool inside the mount; wopfs >= 0.2.0 moves the cwd
+            // out before unmounting (https://gitlab.com/wasmedia/wopfs/-/work_items/2).
+            await mount.release();
+        },
+    };
+}
+//# sourceMappingURL=staging.js.map

package/dist/staging.js.map

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

package/dist/tiff-header.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pixel count of a TIFF, read from its header and image directories only.
+ *
+ * One walker serves both callers: buffer mode, which has the whole file's
+ * bytes, and file mode, where the file sits in OPFS or on disk and only the
+ * few hundred bytes the walk needs should be read. The walker is a generator
+ * that yields the byte ranges it needs; tiffPixelCount drives it from a byte
+ * array, and tiffPixelCountAt from an async reader.
+ */
+/** A random-access reader. A short or empty result means past the end. */
+export type ReadAt = (offset: number, length: number) => Promise<Uint8Array>;
+/** The pixel count of a TIFF held in memory. */
+export declare function tiffPixelCount(bytes: Uint8Array): number | undefined;
+/** The pixel count of a TIFF read through `readAt`, fetching only what the walk needs. */
+export declare function tiffPixelCountAt(readAt: ReadAt): Promise<number | undefined>;
+//# sourceMappingURL=tiff-header.d.ts.map