@wasmedia/wimagemagick 0.2.0

package/dist/licenses/png-LICENSE.txt

@@ -0,0 +1,136 @@
+[ png 1.6.56 (2026-03-25) ]
+
+COPYRIGHT NOTICE, DISCLAIMER, and LICENSE
+=========================================
+
+PNG Reference Library License version 2
+---------------------------------------
+
+ * Copyright (c) 1995-2026 The PNG Reference Library Authors.
+ * Copyright (c) 2018-2026 Cosmin Truta.
+ * Copyright (c) 2000-2002, 2004, 2006-2018 Glenn Randers-Pehrson.
+ * Copyright (c) 1996-1997 Andreas Dilger.
+ * Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.
+
+The software is supplied "as is", without warranty of any kind,
+express or implied, including, without limitation, the warranties
+of merchantability, fitness for a particular purpose, title, and
+non-infringement.  In no event shall the Copyright owners, or
+anyone distributing the software, be liable for any damages or
+other liability, whether in contract, tort or otherwise, arising
+from, out of, or in connection with the software, or the use or
+other dealings in the software, even if advised of the possibility
+of such damage.
+
+Permission is hereby granted to use, copy, modify, and distribute
+this software, or portions hereof, for any purpose, without fee,
+subject to the following restrictions:
+
+ 1. The origin of this software must not be misrepresented; you
+    must not claim that you wrote the original software.  If you
+    use this software in a product, an acknowledgment in the product
+    documentation would be appreciated, but is not required.
+
+ 2. Altered source versions must be plainly marked as such, and must
+    not be misrepresented as being the original software.
+
+ 3. This Copyright notice may not be removed or altered from any
+    source or altered source distribution.
+
+
+PNG Reference Library License version 1 (for libpng 0.5 through 1.6.35)
+-----------------------------------------------------------------------
+
+libpng versions 1.0.7, July 1, 2000, through 1.6.35, July 15, 2018 are
+Copyright (c) 2000-2002, 2004, 2006-2018 Glenn Randers-Pehrson, are
+derived from libpng-1.0.6, and are distributed according to the same
+disclaimer and license as libpng-1.0.6 with the following individuals
+added to the list of Contributing Authors:
+
+    Simon-Pierre Cadieux
+    Eric S. Raymond
+    Mans Rullgard
+    Cosmin Truta
+    Gilles Vollant
+    James Yu
+    Mandar Sahastrabuddhe
+    Google Inc.
+    Vadim Barkov
+
+and with the following additions to the disclaimer:
+
+    There is no warranty against interference with your enjoyment of
+    the library or against infringement.  There is no warranty that our
+    efforts or the library will fulfill any of your particular purposes
+    or needs.  This library is provided with all faults, and the entire
+    risk of satisfactory quality, performance, accuracy, and effort is
+    with the user.
+
+Some files in the "contrib" directory and some configure-generated
+files that are distributed with libpng have other copyright owners, and
+are released under other open source licenses.
+
+libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
+Copyright (c) 1998-2000 Glenn Randers-Pehrson, are derived from
+libpng-0.96, and are distributed according to the same disclaimer and
+license as libpng-0.96, with the following individuals added to the
+list of Contributing Authors:
+
+    Tom Lane
+    Glenn Randers-Pehrson
+    Willem van Schaik
+
+libpng versions 0.89, June 1996, through 0.96, May 1997, are
+Copyright (c) 1996-1997 Andreas Dilger, are derived from libpng-0.88,
+and are distributed according to the same disclaimer and license as
+libpng-0.88, with the following individuals added to the list of
+Contributing Authors:
+
+    John Bowler
+    Kevin Bracey
+    Sam Bushell
+    Magnus Holmgren
+    Greg Roelofs
+    Tom Tanner
+
+Some files in the "scripts" directory have other copyright owners,
+but are released under this license.
+
+libpng versions 0.5, May 1995, through 0.88, January 1996, are
+Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.
+
+For the purposes of this copyright and license, "Contributing Authors"
+is defined as the following set of individuals:
+
+    Andreas Dilger
+    Dave Martindale
+    Guy Eric Schalnat
+    Paul Schmidt
+    Tim Wegner
+
+The PNG Reference Library is supplied "AS IS".  The Contributing
+Authors and Group 42, Inc. disclaim all warranties, expressed or
+implied, including, without limitation, the warranties of
+merchantability and of fitness for any purpose.  The Contributing
+Authors and Group 42, Inc. assume no liability for direct, indirect,
+incidental, special, exemplary, or consequential damages, which may
+result from the use of the PNG Reference Library, even if advised of
+the possibility of such damage.
+
+Permission is hereby granted to use, copy, modify, and distribute this
+source code, or portions hereof, for any purpose, without fee, subject
+to the following restrictions:
+
+ 1. The origin of this source code must not be misrepresented.
+
+ 2. Altered versions must be plainly marked as such and must not
+    be misrepresented as being the original source.
+
+ 3. This Copyright notice may not be removed or altered from any
+    source or altered source distribution.
+
+The Contributing Authors and Group 42, Inc. specifically permit,
+without fee, and encourage the use of this source code as a component
+to supporting the PNG file format in commercial products.  If you use
+this source code in a product, acknowledgment is not required but would
+be appreciated.

package/dist/licenses/tiff-LICENSE.txt

@@ -0,0 +1,51 @@
+[ tiff 4.7.1 (2025-09-12) ]
+
+# LibTIFF license
+
+Copyright © 1988-1997 Sam Leffler\
+Copyright © 1991-1997 Silicon Graphics, Inc.
+
+Permission to use, copy, modify, distribute, and sell this software and 
+its documentation for any purpose is hereby granted without fee, provided
+that (i) the above copyright notices and this permission notice appear in
+all copies of the software and related documentation, and (ii) the names of
+Sam Leffler and Silicon Graphics may not be used in any advertising or
+publicity relating to the software without the specific, prior written
+permission of Sam Leffler and Silicon Graphics.
+
+THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
+EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
+WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
+
+IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
+ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
+OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
+LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
+OF THIS SOFTWARE.
+
+# Lempel-Ziv & Welch Compression (tif_lzw.c) license
+The code of tif_lzw.c is derived from the compress program whose code is
+derived from software contributed to Berkeley by James A. Woods,
+derived from original work by Spencer Thomas and Joseph Orost.
+
+The original Berkeley copyright notice appears below in its entirety:
+
+Copyright (c) 1985, 1986 The Regents of the University of California.
+All rights reserved.
+
+This code is derived from software contributed to Berkeley by
+James A. Woods, derived from original work by Spencer Thomas
+and Joseph Orost.
+
+Redistribution and use in source and binary forms are permitted
+provided that the above copyright notice and this paragraph are
+duplicated in all such forms and that any documentation,
+advertising materials, and other materials related to such
+distribution and use acknowledge that the software was developed
+by the University of California, Berkeley.  The name of the
+University may not be used to endorse or promote products derived
+from this software without specific prior written permission.
+THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

package/dist/licenses/webp-LICENSE.txt

@@ -0,0 +1,31 @@
+[ webp 1.6.0 (2025-07-09) ]
+
+Copyright (c) 2010, Google Inc. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+  * Neither the name of Google nor the names of its contributors may
+    be used to endorse or promote products derived from this software
+    without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/dist/licenses/xml-LICENSE.txt

@@ -0,0 +1,26 @@
+[ xml 2.15.2 (2026-03-03) ]
+
+Except where otherwise noted in the source code (e.g. the files dict.c and
+list.c, which are covered by a similar licence but with different Copyright
+notices) all the files are:
+
+ Copyright (C) 1998-2012 Daniel Veillard.  All Rights Reserved.
+ Copyright (C) The Libxml2 Contributors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is fur-
+nished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FIT-
+NESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/dist/licenses/zlib-LICENSE.txt

@@ -0,0 +1,24 @@
+[ zlib 1.3.2 (2026-02-17) ]
+
+Copyright notice:
+
+ (C) 1995-2026 Jean-loup Gailly and Mark Adler
+
+  This software is provided 'as-is', without any express or implied
+  warranty.  In no event will the authors be held liable for any damages
+  arising from the use of this software.
+
+  Permission is granted to anyone to use this software for any purpose,
+  including commercial applications, and to alter it and redistribute it
+  freely, subject to the following restrictions:
+
+  1. The origin of this software must not be misrepresented; you must not
+     claim that you wrote the original software. If you use this software
+     in a product, an acknowledgment in the product documentation would be
+     appreciated but is not required.
+  2. Altered source versions must be plainly marked as such, and must not be
+     misrepresented as being the original software.
+  3. This notice may not be removed or altered from any source distribution.
+
+  Jean-loup Gailly        Mark Adler
+  jloup@gzip.org          madler@alumni.caltech.edu

package/dist/loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * WASM module loader.
+ */
+import type { WImageMagickOptions, WImageMagickInstance } from "./types.js";
+/**
+ * Initialize wimagemagick.
+ *
+ * @example
+ * ```typescript
+ * const wim = await initWImageMagick();
+ *
+ * // High-level API
+ * const img = wim.Image.fromBuffer(pngData);
+ * const jpeg = img.resize(800, 600).quality(85).toBuffer('JPEG');
+ * img.dispose();
+ *
+ * // CLI-style
+ * const result = wim.execute('input.png -resize 50% output.jpg', inputFiles);
+ *
+ * // Low-level API
+ * const wand = wim.api.NewMagickWand();
+ * ```
+ */
+export declare function initWImageMagick(options?: WImageMagickOptions): Promise<WImageMagickInstance>;
+//# 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;;GAEG;AAEH,OAAO,KAAK,EAEV,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAyB/B"}

package/dist/loader.js

@@ -0,0 +1,50 @@
+/**
+ * WASM module loader.
+ */
+import { createBindings } from "./api.js";
+import { WMagickImage, setSharedModule } from "./image.js";
+import { execute, createOutputHooks } from "./cli.js";
+async function loadModule(modulePath) {
+    const factory = await import(/* webpackIgnore: true */ modulePath);
+    const init = factory.default ?? factory;
+    // The output hooks must be handed to the factory: Emscripten reads
+    // print/printErr while constructing the module and ignores later changes.
+    const module = await init({ ...createOutputHooks() });
+    return module;
+}
+/**
+ * Initialize wimagemagick.
+ *
+ * @example
+ * ```typescript
+ * const wim = await initWImageMagick();
+ *
+ * // High-level API
+ * const img = wim.Image.fromBuffer(pngData);
+ * const jpeg = img.resize(800, 600).quality(85).toBuffer('JPEG');
+ * img.dispose();
+ *
+ * // CLI-style
+ * const result = wim.execute('input.png -resize 50% output.jpg', inputFiles);
+ *
+ * // Low-level API
+ * const wand = wim.api.NewMagickWand();
+ * ```
+ */
+export async function initWImageMagick(options) {
+    options?.onProgress?.("loading");
+    const modulePath = options?.wasmPath
+        ?? new URL("../dist/wimagemagick.js", import.meta.url).href;
+    const module = await loadModule(modulePath);
+    options?.onProgress?.("initializing");
+    setSharedModule(module);
+    options?.onProgress?.("ready");
+    const boundExecute = (command, inputFiles) => execute(module, command, inputFiles);
+    return {
+        Image: WMagickImage,
+        execute: boundExecute,
+        api: createBindings(module),
+        module,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEtD,KAAK,UAAU,UAAU,CAAC,UAAkB;IAC1C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,mEAAmE;IACnE,0EAA0E;IAC1E,MAAM,MAAM,GAAe,MAAM,IAAI,CAAC,EAAE,GAAG,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA6B;IAE7B,OAAO,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC;IAEjC,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ;WAC/B,IAAI,GAAG,CAAC,yBAAyB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAE9D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAE5C,OAAO,EAAE,UAAU,EAAE,CAAC,cAAc,CAAC,CAAC;IAEtC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,EAAE,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;IAE/B,MAAM,YAAY,GAAG,CACnB,OAA0B,EAC1B,UAAkD,EAClD,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAE1C,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,YAAY;QACrB,GAAG,EAAE,cAAc,CAAC,MAAM,CAAC;QAC3B,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/raw.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Recognise camera raw files from their first bytes.
+ *
+ * ImageMagick registers its raw coders with `ExplicitFormatType`, so it never
+ * picks LibRaw from a file's contents. Most raws are TIFF containers, and
+ * without a hint the TIFF coder claims them: a DNG comes back as the
+ * undemosaiced sensor mosaic, a NEF as its 160x120 embedded preview, and a CR2
+ * fails outright. Detecting the raw here lets the buffer entry points supply
+ * the hint themselves.
+ *
+ * Only signatures that have been checked against real camera files are
+ * matched, and the TIFF-based ones require the raw file's structure, not just
+ * a camera maker's name, so a TIFF written by a camera or scanner stays a TIFF.
+ */
+/**
+ * The ImageMagick format name for a camera raw file, or `undefined` if the
+ * data is not one this recognises.
+ *
+ * | Format | Signature |
+ * |--------|-----------|
+ * | CR3 | ISO media file with brand `crx ` |
+ * | CR2 | TIFF with `CR` and major version 2 at byte 8 |
+ * | IIQ | TIFF with `IIII` at byte 8 (Phase One) |
+ * | DNG | TIFF whose first IFD carries `DNGVersion` |
+ * | NEF | TIFF whose first IFD is a thumbnail with sub-IFDs and Make `NIKON…` |
+ * | 3FR | the same layout with Make `Hasselblad` |
+ * | ARW | the same layout with Make `SONY` |
+ * | DCR | the same layout with Make `Kodak` |
+ * | SRW | TIFF whose first IFD has no image size, only sub-IFDs, and Make `SAMSUNG` |
+ * | KDC | the same with Make `EASTMAN KODAK COMPANY` |
+ * | RAF, RW2, ORF, CRW, MRW, RAW | the fixed headers in {@link HEADER_SIGNATURES} |
+ *
+ * The fixed-header formats would reach LibRaw without the hint, because
+ * ImageMagick's own magic table (`coders/dng.h`) lists the same signatures;
+ * they are recognised here so that the answer to "is this a raw?" does not
+ * depend on which formats ImageMagick happens to sniff.
+ */
+export declare function detectRawFormat(data: Uint8Array | ArrayBuffer): string | undefined;
+//# sourceMappingURL=raw.d.ts.map

package/dist/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../src/raw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgGH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CA2BlF"}

package/dist/raw.js

@@ -0,0 +1,151 @@
+/**
+ * Recognise camera raw files from their first bytes.
+ *
+ * ImageMagick registers its raw coders with `ExplicitFormatType`, so it never
+ * picks LibRaw from a file's contents. Most raws are TIFF containers, and
+ * without a hint the TIFF coder claims them: a DNG comes back as the
+ * undemosaiced sensor mosaic, a NEF as its 160x120 embedded preview, and a CR2
+ * fails outright. Detecting the raw here lets the buffer entry points supply
+ * the hint themselves.
+ *
+ * Only signatures that have been checked against real camera files are
+ * matched, and the TIFF-based ones require the raw file's structure, not just
+ * a camera maker's name, so a TIFF written by a camera or scanner stays a TIFF.
+ */
+const TAG_NEW_SUBFILE_TYPE = 254;
+const TAG_IMAGE_WIDTH = 256;
+const TAG_IMAGE_LENGTH = 257;
+const TAG_MAKE = 271;
+const TAG_SUB_IFDS = 330;
+const TAG_DNG_VERSION = 50706;
+const ascii = (data, offset, text) => offset + text.length <= data.length &&
+    [...text].every((c, i) => data[offset + i] === c.charCodeAt(0));
+/** Read the few IFD0 tags the raw layouts are told apart by. */
+function readIfd0(data) {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const le = data[0] === 0x49;
+    const ifd = view.getUint32(4, le);
+    if (ifd + 2 > data.length)
+        return undefined;
+    const result = { isThumbnail: false, hasImageSize: false, hasSubIFDs: false, hasDNGVersion: false, make: "" };
+    const count = view.getUint16(ifd, le);
+    for (let i = 0; i < count; i++) {
+        const entry = ifd + 2 + i * 12;
+        if (entry + 12 > data.length)
+            break;
+        const tag = view.getUint16(entry, le);
+        const type = view.getUint16(entry + 2, le);
+        const n = view.getUint32(entry + 4, le);
+        if (tag === TAG_NEW_SUBFILE_TYPE) {
+            // LONG in the files seen; bit 0 marks a reduced-resolution image.
+            const value = type === 3 ? view.getUint16(entry + 8, le) : view.getUint32(entry + 8, le);
+            result.isThumbnail = (value & 1) === 1;
+        }
+        else if (tag === TAG_IMAGE_WIDTH || tag === TAG_IMAGE_LENGTH) {
+            result.hasImageSize = true;
+        }
+        else if (tag === TAG_SUB_IFDS) {
+            result.hasSubIFDs = n > 0;
+        }
+        else if (tag === TAG_DNG_VERSION) {
+            result.hasDNGVersion = true;
+        }
+        else if (tag === TAG_MAKE && type === 2) {
+            const start = n > 4 ? view.getUint32(entry + 8, le) : entry + 8;
+            const end = start + Math.min(n, 64);
+            if (end > data.length)
+                continue;
+            result.make = String.fromCharCode(...data.subarray(start, end)).replace(/\0.*$/s, "");
+        }
+    }
+    return result;
+}
+/**
+ * Raw formats with a fixed header, copied from ImageMagick's magic table
+ * (`coders/dng.h`). Each was checked against the header of a real camera
+ * file, named in its comment; RAF and MRW only against exiftool's test
+ * images, whose image data is stripped, so those two were not decoded.
+ */
+const HEADER_SIGNATURES = [
+    ["RAF", "FUJIFILMCCD-RAW "], // FinePix S5Pro
+    ["RW2", "IIU\x00\x18\x00\x00\x00"], // Lumix DMC-FZ70, DMC-LX3
+    ["RAW", "IIU\x00\x08\x00\x00\x00"], // older Leica/Panasonic .RAW: Digilux 2
+    // E-300. The IIRS and MMOR variants are not in ImageMagick's table and no
+    // sample was available, so they are left out.
+    ["ORF", "IIRO\x08\x00\x00\x00"],
+    ["CRW", "II\x1a\x00\x00\x00HEAPCCDR"], // EOS D60, Digital Rebel
+    ["MRW", "\x00MRM"], // DiMAGE A2
+];
+/**
+ * Makes whose raw files share the NEF layout: IFD0 is a reduced-resolution
+ * preview, and the sensor data hangs off its SubIFDs.
+ */
+const THUMBNAIL_LAYOUT_MAKES = [
+    ["NIKON", "NEF"],
+    ["Hasselblad", "3FR"],
+    ["SONY", "ARW"],
+    ["Kodak", "DCR"],
+];
+/**
+ * Makes whose raw files have an IFD0 with no image at all — no ImageWidth or
+ * ImageLength — and the sensor data in its SubIFDs. libtiff cannot read such
+ * a file, so claiming it costs nothing even if a non-raw TIFF matched.
+ */
+const SIZELESS_LAYOUT_MAKES = [
+    ["SAMSUNG", "SRW"],
+    ["EASTMAN KODAK COMPANY", "KDC"],
+];
+/**
+ * The ImageMagick format name for a camera raw file, or `undefined` if the
+ * data is not one this recognises.
+ *
+ * | Format | Signature |
+ * |--------|-----------|
+ * | CR3 | ISO media file with brand `crx ` |
+ * | CR2 | TIFF with `CR` and major version 2 at byte 8 |
+ * | IIQ | TIFF with `IIII` at byte 8 (Phase One) |
+ * | DNG | TIFF whose first IFD carries `DNGVersion` |
+ * | NEF | TIFF whose first IFD is a thumbnail with sub-IFDs and Make `NIKON…` |
+ * | 3FR | the same layout with Make `Hasselblad` |
+ * | ARW | the same layout with Make `SONY` |
+ * | DCR | the same layout with Make `Kodak` |
+ * | SRW | TIFF whose first IFD has no image size, only sub-IFDs, and Make `SAMSUNG` |
+ * | KDC | the same with Make `EASTMAN KODAK COMPANY` |
+ * | RAF, RW2, ORF, CRW, MRW, RAW | the fixed headers in {@link HEADER_SIGNATURES} |
+ *
+ * The fixed-header formats would reach LibRaw without the hint, because
+ * ImageMagick's own magic table (`coders/dng.h`) lists the same signatures;
+ * they are recognised here so that the answer to "is this a raw?" does not
+ * depend on which formats ImageMagick happens to sniff.
+ */
+export function detectRawFormat(data) {
+    const bytes = data instanceof ArrayBuffer ? new Uint8Array(data) : data;
+    if (ascii(bytes, 4, "ftypcrx "))
+        return "CR3";
+    for (const [format, header] of HEADER_SIGNATURES) {
+        if (ascii(bytes, 0, header))
+            return format;
+    }
+    const tiff = bytes.length >= 8 &&
+        ((bytes[0] === 0x49 && bytes[1] === 0x49 && bytes[2] === 0x2a && bytes[3] === 0x00) ||
+            (bytes[0] === 0x4d && bytes[1] === 0x4d && bytes[2] === 0x00 && bytes[3] === 0x2a));
+    if (!tiff)
+        return undefined;
+    if (ascii(bytes, 8, "CR") && bytes[10] === 2)
+        return "CR2";
+    if (ascii(bytes, 8, "IIII"))
+        return "IIQ";
+    const ifd0 = readIfd0(bytes);
+    if (!ifd0)
+        return undefined;
+    if (ifd0.hasDNGVersion)
+        return "DNG";
+    if (ifd0.isThumbnail && ifd0.hasSubIFDs) {
+        return THUMBNAIL_LAYOUT_MAKES.find(([prefix]) => ifd0.make.startsWith(prefix))?.[1];
+    }
+    if (!ifd0.hasImageSize && ifd0.hasSubIFDs) {
+        return SIZELESS_LAYOUT_MAKES.find(([prefix]) => ifd0.make.startsWith(prefix))?.[1];
+    }
+    return undefined;
+}
+//# sourceMappingURL=raw.js.map

package/dist/raw.js.map

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