@su-engineering/heic 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SourceColor, H as HeicWarning, a as SupportReport, D as DecodeOptions, b as DecodedImage, c as DecoderAdapter } from './types-Bv9KPnri.js';
-export { A as AdapterRequest, d as AdapterResult, O as OutputColorSpace, e as Strategy, T as TransformsApplied } from './types-Bv9KPnri.js';
+import { S as SourceColor, H as HeicWarning, a as SupportReport, C as ConvertOptions, b as ConvertedImage, D as DecodeOptions, c as DecodedImage, d as DecoderAdapter } from './types-nCqKJJpp.js';
+export { A as AdapterRequest, e as AdapterResult, O as OutputColorSpace, f as Strategy, T as TransformsApplied } from './types-nCqKJJpp.js';
 
 /**
  * Typed error hierarchy. The parser consumes hostile input and the decode path
@@ -433,6 +433,12 @@ declare function isHeic(input: BinaryInput): Promise<IsHeicResult>;
  * naming what was missing, rather than silently fetching a megabyte.
  */
 declare function decodeHeic(input: BinaryInput, options?: DecodeOptions): Promise<DecodedImage>;
+/**
+ * Convert the primary HEIC image to JPEG or PNG using the browser's encoder.
+ * Uses the same explicit decode cascade as decodeHeic and releases all pixels.
+ * Source EXIF is not copied into the output file.
+ */
+declare function convertHeic(input: BinaryInput, options?: ConvertOptions): Promise<ConvertedImage>;
 /**
  * Registers a wasm (or other) fallback adapter for every subsequent decode.
  *
@@ -442,4 +448,4 @@ declare function decodeHeic(input: BinaryInput, options?: DecodeOptions): Promis
 declare function registerDecoderAdapter(adapter: DecoderAdapter | undefined): void;
 declare function getRegisteredAdapter(): DecoderAdapter | undefined;
 
-export { type BinaryInput, DecodeOptions, DecodedImage, DecoderAdapter, type GridDescriptor, HeicAbortError, HeicDecodeError, HeicError, type HeicErrorContext, HeicParseError, HeicUnsupportedError, HeicWarning, type HeifFile, type HvcC, type ImagePlan, type IsHeicResult, type ItemInfo, type ItemLocation, type ItemProperties, type ItemProperty, type ItemReferences, type PlannedTile, SourceColor, SupportReport, type TileGroup, type TransformOp, decodeHeic, findProperty, getRegisteredAdapter, hvccToAnnexBPrologue, hvccToCodecString, isHeic, lengthPrefixedToAnnexB, parseGridPayload, parseHeif, parseHvcC, planDecode, probeSupport, propertiesForItem, readGrid, readItemData, registerDecoderAdapter };
+export { type BinaryInput, ConvertOptions, ConvertedImage, DecodeOptions, DecodedImage, DecoderAdapter, type GridDescriptor, HeicAbortError, HeicDecodeError, HeicError, type HeicErrorContext, HeicParseError, HeicUnsupportedError, HeicWarning, type HeifFile, type HvcC, type ImagePlan, type IsHeicResult, type ItemInfo, type ItemLocation, type ItemProperties, type ItemProperty, type ItemReferences, type PlannedTile, SourceColor, SupportReport, type TileGroup, type TransformOp, convertHeic, decodeHeic, findProperty, getRegisteredAdapter, hvccToAnnexBPrologue, hvccToCodecString, isHeic, lengthPrefixedToAnnexB, parseGridPayload, parseHeif, parseHvcC, planDecode, probeSupport, propertiesForItem, readGrid, readItemData, registerDecoderAdapter };

package/dist/index.js

@@ -1553,6 +1553,37 @@ async function decodeHeic(input, options = {}) {
     itemId: plan.primaryItemId
   });
 }
+async function convertHeic(input, options = {}) {
+  const { type = "image/jpeg", quality = 0.92, ...decodeOptions } = options;
+  if (type !== "image/jpeg" && type !== "image/png") {
+    throw new TypeError("type must be image/jpeg or image/png");
+  }
+  if (!Number.isFinite(quality) || quality < 0 || quality > 1) {
+    throw new RangeError("quality must be a finite number between 0 and 1");
+  }
+  const decoded = await decodeHeic(input, decodeOptions);
+  let canvas;
+  try {
+    throwIfAborted(options.signal);
+    canvas = createCanvas(decoded.width, decoded.height);
+    const ctx = canvas.getContext("2d", { colorSpace: options.colorSpace ?? "srgb", alpha: false });
+    if (!ctx) throw new HeicDecodeError("Could not get a 2d context for conversion", {});
+    ctx.drawImage(decoded.image, 0, 0);
+    const blob = await canvas.convertToBlob({ type, quality });
+    throwIfAborted(options.signal);
+    if (blob.type !== type || blob.size === 0) {
+      throw new HeicDecodeError(`Browser could not encode ${type}`, {});
+    }
+    const { image: _image, ...metadata } = decoded;
+    return { ...metadata, blob };
+  } finally {
+    decoded.image.close();
+    if (canvas) {
+      canvas.width = 0;
+      canvas.height = 0;
+    }
+  }
+}
 var registeredAdapter;
 function registerDecoderAdapter(adapter) {
   registeredAdapter = adapter;
@@ -1643,6 +1674,6 @@ function describeError(error) {
   return error instanceof Error ? error.message : String(error);
 }
 
-export { decodeHeic, findProperty, getRegisteredAdapter, hvccToAnnexBPrologue, hvccToCodecString, isHeic, lengthPrefixedToAnnexB, parseGridPayload, parseHeif, parseHvcC, planDecode, probeSupport, propertiesForItem, readGrid, readItemData, registerDecoderAdapter };
+export { convertHeic, decodeHeic, findProperty, getRegisteredAdapter, hvccToAnnexBPrologue, hvccToCodecString, isHeic, lengthPrefixedToAnnexB, parseGridPayload, parseHeif, parseHvcC, planDecode, probeSupport, propertiesForItem, readGrid, readItemData, registerDecoderAdapter };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map