@woosh/meep-engine 3.9.0 → 3.10.0

package/src/avif/native/heif/ItemProperty.d.ts

@@ -0,0 +1,244 @@
+/**
+ * Item property structs.
+ *
+ * One class per property box that AVIF defines, each a plain struct: fields and nothing else.
+ * Reading is {@link parse_item_property}, writing is {@link write_item_property}; keeping the
+ * behaviour out of the structs is what lets the decoder tree be imported without the writer.
+ *
+ * An unrecognised property becomes an {@link UnknownProperty} carrying its bytes verbatim, so a
+ * file can be read, modified and written back without losing properties this implementation does
+ * not understand.
+ *
+ * @see ISO/IEC 23008-12 section 9.3 "Item properties"
+ * @see ISO/IEC 23000-22 section 7.3 "AV1 Image Item Properties"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+/**
+ * `ispe` — the item's stored dimensions, before any transformative property is applied.
+ */
+export class ImageSpatialExtents {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} */
+    width: number;
+    /** @type {number} */
+    height: number;
+}
+/**
+ * `pixi` — bit depth per channel of the *decoded* image.
+ */
+export class PixelInformation {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {Uint8Array} */
+    bits_per_channel: Uint8Array;
+}
+/**
+ * `av1C` — the AV1 codec configuration record. `config_obus` carries the sequence header (and
+ * possibly metadata OBUs) that the item's own payload may omit.
+ */
+export class Av1Config {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} */
+    version: number;
+    /** @type {number} */
+    seq_profile: number;
+    /** @type {number} */
+    seq_level_idx_0: number;
+    /** @type {number} */
+    seq_tier_0: number;
+    /** @type {number} */
+    high_bitdepth: number;
+    /** @type {number} */
+    twelve_bit: number;
+    /** @type {number} */
+    monochrome: number;
+    /** @type {number} */
+    chroma_subsampling_x: number;
+    /** @type {number} */
+    chroma_subsampling_y: number;
+    /** @type {number} */
+    chroma_sample_position: number;
+    /** @type {number} `-1` when absent */
+    initial_presentation_delay_minus_one: number;
+    /** @type {Uint8Array} */
+    config_obus: Uint8Array;
+}
+/**
+ * `colr` — colour information. Either an `nclx` triple of CICP codes, or an embedded ICC profile.
+ */
+export class ColourInformation {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {string} `nclx`, `rICC` or `prof` */
+    colour_type: string;
+    /** @type {number} CICP colour primaries */
+    colour_primaries: number;
+    /** @type {number} CICP transfer characteristics */
+    transfer_characteristics: number;
+    /** @type {number} CICP matrix coefficients */
+    matrix_coefficients: number;
+    /** @type {number} `0` limited (studio) range, `1` full range */
+    full_range_flag: number;
+    /** @type {Uint8Array|null} ICC profile bytes, for `rICC` and `prof` */
+    icc_profile: Uint8Array | null;
+}
+/**
+ * `pasp` — pixel aspect ratio.
+ */
+export class PixelAspectRatio {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} */
+    h_spacing: number;
+    /** @type {number} */
+    v_spacing: number;
+}
+/**
+ * `clap` — clean aperture. A crop expressed as rationals, relative to the centre of the image.
+ */
+export class CleanAperture {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} */
+    width_numerator: number;
+    /** @type {number} */
+    width_denominator: number;
+    /** @type {number} */
+    height_numerator: number;
+    /** @type {number} */
+    height_denominator: number;
+    /** @type {number} */
+    horizontal_offset_numerator: number;
+    /** @type {number} */
+    horizontal_offset_denominator: number;
+    /** @type {number} */
+    vertical_offset_numerator: number;
+    /** @type {number} */
+    vertical_offset_denominator: number;
+}
+/**
+ * `irot` — rotation, anticlockwise, applied after `clap`.
+ */
+export class ImageRotation {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} `0 .. 3`, in units of 90 degrees anticlockwise */
+    angle: number;
+}
+/**
+ * `imir` — mirroring, applied after `clap` and before `irot`.
+ */
+export class ImageMirror {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} `0` mirror about a horizontal axis (top-bottom), `1` about a vertical axis */
+    axis: number;
+}
+/**
+ * `auxC` — marks an item as auxiliary, with a URN saying what kind. Alpha and depth both use this.
+ */
+export class AuxiliaryTypeProperty {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {string} */
+    aux_type: string;
+    /** @type {Uint8Array} */
+    aux_subtype: Uint8Array;
+}
+/**
+ * `clli` — content light level, in candela per square metre.
+ */
+export class ContentLightLevel {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} */
+    max_content_light_level: number;
+    /** @type {number} */
+    max_pic_average_light_level: number;
+}
+/**
+ * `mdcv` — mastering display colour volume. Chromaticities are in units of 0.00002, luminances in
+ * units of 0.0001 cd/m².
+ */
+export class MasteringDisplayColourVolume {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {Uint16Array} three (x, y) pairs, in R, G, B order */
+    display_primaries: Uint16Array;
+    /** @type {number} */
+    white_point_x: number;
+    /** @type {number} */
+    white_point_y: number;
+    /** @type {number} */
+    max_display_mastering_luminance: number;
+    /** @type {number} */
+    min_display_mastering_luminance: number;
+}
+/**
+ * `cclv` — content colour volume. Its payload is variable and is not interpreted here beyond being
+ * carried through unchanged.
+ */
+export class ContentColourVolume {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {Uint8Array} */
+    payload: Uint8Array;
+}
+/**
+ * `a1op` — selects an AV1 operating point for a layered item.
+ */
+export class OperatingPointSelector {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} */
+    op_index: number;
+}
+/**
+ * `lsel` — selects a layer of a layered item.
+ */
+export class LayerSelector {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {number} */
+    layer_id: number;
+}
+/**
+ * `a1lx` — byte sizes of the first three spatial layers, so a reader can find a layer without
+ * parsing the OBUs.
+ */
+export class LayeredImageIndexing {
+    static TYPE: string;
+    /** @type {string} */
+    type: string;
+    /** @type {Uint32Array} */
+    layer_size: Uint32Array;
+}
+/**
+ * Any property box this implementation does not model, kept byte-for-byte so it survives a
+ * read-modify-write.
+ */
+export class UnknownProperty {
+    /** @type {string} */
+    type: string;
+    /** @type {Uint8Array} */
+    payload: Uint8Array;
+}
+//# sourceMappingURL=ItemProperty.d.ts.map

package/src/avif/native/heif/ItemProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemProperty.d.ts","sourceRoot":"","sources":["../../../../../src/avif/native/heif/ItemProperty.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,OADW,MAAM,CACP;IAEV,qBAAqB;IACrB,QADW,MAAM,CACN;CACd;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,yBAAyB;IACzB,kBADW,UAAU,CACgB;CACxC;AAED;;;GAGG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,SADW,MAAM,CACL;IAEZ,qBAAqB;IACrB,aADW,MAAM,CACD;IAEhB,qBAAqB;IACrB,iBADW,MAAM,CACG;IAEpB,qBAAqB;IACrB,YADW,MAAM,CACF;IAEf,qBAAqB;IACrB,eADW,MAAM,CACC;IAElB,qBAAqB;IACrB,YADW,MAAM,CACF;IAEf,qBAAqB;IACrB,YADW,MAAM,CACF;IAEf,qBAAqB;IACrB,sBADW,MAAM,CACQ;IAEzB,qBAAqB;IACrB,sBADW,MAAM,CACQ;IAEzB,qBAAqB;IACrB,wBADW,MAAM,CACU;IAE3B,sCAAsC;IACtC,sCADW,MAAM,CACyB;IAE1C,yBAAyB;IACzB,aADW,UAAU,CACW;CACnC;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,8CAA8C;IAC9C,aADW,MAAM,CACI;IAErB,2CAA2C;IAC3C,kBADW,MAAM,CACI;IAErB,mDAAmD;IACnD,0BADW,MAAM,CACY;IAE7B,8CAA8C;IAC9C,qBADW,MAAM,CACO;IAExB,gEAAgE;IAChE,iBADW,MAAM,CACG;IAEpB,uEAAuE;IACvE,aADW,UAAU,GAAC,IAAI,CACP;CACtB;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,WADW,MAAM,CACH;IAEd,qBAAqB;IACrB,WADW,MAAM,CACH;CACjB;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,iBADW,MAAM,CACG;IAEpB,qBAAqB;IACrB,mBADW,MAAM,CACK;IAEtB,qBAAqB;IACrB,kBADW,MAAM,CACI;IAErB,qBAAqB;IACrB,oBADW,MAAM,CACM;IAEvB,qBAAqB;IACrB,6BADW,MAAM,CACe;IAEhC,qBAAqB;IACrB,+BADW,MAAM,CACiB;IAElC,qBAAqB;IACrB,2BADW,MAAM,CACa;IAE9B,qBAAqB;IACrB,6BADW,MAAM,CACe;CACnC;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,oEAAoE;IACpE,OADW,MAAM,CACP;CACb;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,gGAAgG;IAChG,MADW,MAAM,CACR;CACZ;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,UADW,MAAM,CACH;IAEd,yBAAyB;IACzB,aADW,UAAU,CACW;CACnC;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,yBADW,MAAM,CACW;IAE5B,qBAAqB;IACrB,6BADW,MAAM,CACe;CACnC;AAED;;;GAGG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,+DAA+D;IAC/D,mBADW,WAAW,CACiB;IAEvC,qBAAqB;IACrB,eADW,MAAM,CACC;IAElB,qBAAqB;IACrB,eADW,MAAM,CACC;IAElB,qBAAqB;IACrB,iCADW,MAAM,CACmB;IAEpC,qBAAqB;IACrB,iCADW,MAAM,CACmB;CACvC;AAED;;;GAGG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,yBAAyB;IACzB,SADW,UAAU,CACO;CAC/B;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,UADW,MAAM,CACJ;CAChB;AAED;;GAEG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,qBAAqB;IACrB,UADW,MAAM,CACJ;CAChB;AAED;;;GAGG;AACH;IACI,oBAAqB;IAErB,qBAAqB;IACrB,MADW,MAAM,CACH;IAEd,0BAA0B;IAC1B,YADW,WAAW,CACU;CACnC;AAED;;;GAGG;AACH;IACI,qBAAqB;IACrB,MADW,MAAM,CACP;IAEV,yBAAyB;IACzB,SADW,UAAU,CACO;CAC/B"}

package/src/avif/native/heif/ItemProperty.js

@@ -0,0 +1,321 @@
+/**
+ * Item property structs.
+ *
+ * One class per property box that AVIF defines, each a plain struct: fields and nothing else.
+ * Reading is {@link parse_item_property}, writing is {@link write_item_property}; keeping the
+ * behaviour out of the structs is what lets the decoder tree be imported without the writer.
+ *
+ * An unrecognised property becomes an {@link UnknownProperty} carrying its bytes verbatim, so a
+ * file can be read, modified and written back without losing properties this implementation does
+ * not understand.
+ *
+ * @see ISO/IEC 23008-12 section 9.3 "Item properties"
+ * @see ISO/IEC 23000-22 section 7.3 "AV1 Image Item Properties"
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+
+/**
+ * `ispe` — the item's stored dimensions, before any transformative property is applied.
+ */
+export class ImageSpatialExtents {
+    static TYPE = "ispe";
+
+    /** @type {string} */
+    type = "ispe";
+
+    /** @type {number} */
+    width = 0;
+
+    /** @type {number} */
+    height = 0;
+}
+
+/**
+ * `pixi` — bit depth per channel of the *decoded* image.
+ */
+export class PixelInformation {
+    static TYPE = "pixi";
+
+    /** @type {string} */
+    type = "pixi";
+
+    /** @type {Uint8Array} */
+    bits_per_channel = new Uint8Array(0);
+}
+
+/**
+ * `av1C` — the AV1 codec configuration record. `config_obus` carries the sequence header (and
+ * possibly metadata OBUs) that the item's own payload may omit.
+ */
+export class Av1Config {
+    static TYPE = "av1C";
+
+    /** @type {string} */
+    type = "av1C";
+
+    /** @type {number} */
+    version = 1;
+
+    /** @type {number} */
+    seq_profile = 0;
+
+    /** @type {number} */
+    seq_level_idx_0 = 0;
+
+    /** @type {number} */
+    seq_tier_0 = 0;
+
+    /** @type {number} */
+    high_bitdepth = 0;
+
+    /** @type {number} */
+    twelve_bit = 0;
+
+    /** @type {number} */
+    monochrome = 0;
+
+    /** @type {number} */
+    chroma_subsampling_x = 0;
+
+    /** @type {number} */
+    chroma_subsampling_y = 0;
+
+    /** @type {number} */
+    chroma_sample_position = 0;
+
+    /** @type {number} `-1` when absent */
+    initial_presentation_delay_minus_one = -1;
+
+    /** @type {Uint8Array} */
+    config_obus = new Uint8Array(0);
+}
+
+/**
+ * `colr` — colour information. Either an `nclx` triple of CICP codes, or an embedded ICC profile.
+ */
+export class ColourInformation {
+    static TYPE = "colr";
+
+    /** @type {string} */
+    type = "colr";
+
+    /** @type {string} `nclx`, `rICC` or `prof` */
+    colour_type = "nclx";
+
+    /** @type {number} CICP colour primaries */
+    colour_primaries = 2;
+
+    /** @type {number} CICP transfer characteristics */
+    transfer_characteristics = 2;
+
+    /** @type {number} CICP matrix coefficients */
+    matrix_coefficients = 2;
+
+    /** @type {number} `0` limited (studio) range, `1` full range */
+    full_range_flag = 1;
+
+    /** @type {Uint8Array|null} ICC profile bytes, for `rICC` and `prof` */
+    icc_profile = null;
+}
+
+/**
+ * `pasp` — pixel aspect ratio.
+ */
+export class PixelAspectRatio {
+    static TYPE = "pasp";
+
+    /** @type {string} */
+    type = "pasp";
+
+    /** @type {number} */
+    h_spacing = 1;
+
+    /** @type {number} */
+    v_spacing = 1;
+}
+
+/**
+ * `clap` — clean aperture. A crop expressed as rationals, relative to the centre of the image.
+ */
+export class CleanAperture {
+    static TYPE = "clap";
+
+    /** @type {string} */
+    type = "clap";
+
+    /** @type {number} */
+    width_numerator = 0;
+
+    /** @type {number} */
+    width_denominator = 1;
+
+    /** @type {number} */
+    height_numerator = 0;
+
+    /** @type {number} */
+    height_denominator = 1;
+
+    /** @type {number} */
+    horizontal_offset_numerator = 0;
+
+    /** @type {number} */
+    horizontal_offset_denominator = 1;
+
+    /** @type {number} */
+    vertical_offset_numerator = 0;
+
+    /** @type {number} */
+    vertical_offset_denominator = 1;
+}
+
+/**
+ * `irot` — rotation, anticlockwise, applied after `clap`.
+ */
+export class ImageRotation {
+    static TYPE = "irot";
+
+    /** @type {string} */
+    type = "irot";
+
+    /** @type {number} `0 .. 3`, in units of 90 degrees anticlockwise */
+    angle = 0;
+}
+
+/**
+ * `imir` — mirroring, applied after `clap` and before `irot`.
+ */
+export class ImageMirror {
+    static TYPE = "imir";
+
+    /** @type {string} */
+    type = "imir";
+
+    /** @type {number} `0` mirror about a horizontal axis (top-bottom), `1` about a vertical axis */
+    axis = 0;
+}
+
+/**
+ * `auxC` — marks an item as auxiliary, with a URN saying what kind. Alpha and depth both use this.
+ */
+export class AuxiliaryTypeProperty {
+    static TYPE = "auxC";
+
+    /** @type {string} */
+    type = "auxC";
+
+    /** @type {string} */
+    aux_type = "";
+
+    /** @type {Uint8Array} */
+    aux_subtype = new Uint8Array(0);
+}
+
+/**
+ * `clli` — content light level, in candela per square metre.
+ */
+export class ContentLightLevel {
+    static TYPE = "clli";
+
+    /** @type {string} */
+    type = "clli";
+
+    /** @type {number} */
+    max_content_light_level = 0;
+
+    /** @type {number} */
+    max_pic_average_light_level = 0;
+}
+
+/**
+ * `mdcv` — mastering display colour volume. Chromaticities are in units of 0.00002, luminances in
+ * units of 0.0001 cd/m².
+ */
+export class MasteringDisplayColourVolume {
+    static TYPE = "mdcv";
+
+    /** @type {string} */
+    type = "mdcv";
+
+    /** @type {Uint16Array} three (x, y) pairs, in R, G, B order */
+    display_primaries = new Uint16Array(6);
+
+    /** @type {number} */
+    white_point_x = 0;
+
+    /** @type {number} */
+    white_point_y = 0;
+
+    /** @type {number} */
+    max_display_mastering_luminance = 0;
+
+    /** @type {number} */
+    min_display_mastering_luminance = 0;
+}
+
+/**
+ * `cclv` — content colour volume. Its payload is variable and is not interpreted here beyond being
+ * carried through unchanged.
+ */
+export class ContentColourVolume {
+    static TYPE = "cclv";
+
+    /** @type {string} */
+    type = "cclv";
+
+    /** @type {Uint8Array} */
+    payload = new Uint8Array(0);
+}
+
+/**
+ * `a1op` — selects an AV1 operating point for a layered item.
+ */
+export class OperatingPointSelector {
+    static TYPE = "a1op";
+
+    /** @type {string} */
+    type = "a1op";
+
+    /** @type {number} */
+    op_index = 0;
+}
+
+/**
+ * `lsel` — selects a layer of a layered item.
+ */
+export class LayerSelector {
+    static TYPE = "lsel";
+
+    /** @type {string} */
+    type = "lsel";
+
+    /** @type {number} */
+    layer_id = 0;
+}
+
+/**
+ * `a1lx` — byte sizes of the first three spatial layers, so a reader can find a layer without
+ * parsing the OBUs.
+ */
+export class LayeredImageIndexing {
+    static TYPE = "a1lx";
+
+    /** @type {string} */
+    type = "a1lx";
+
+    /** @type {Uint32Array} */
+    layer_size = new Uint32Array(3);
+}
+
+/**
+ * Any property box this implementation does not model, kept byte-for-byte so it survives a
+ * read-modify-write.
+ */
+export class UnknownProperty {
+    /** @type {string} */
+    type = "";
+
+    /** @type {Uint8Array} */
+    payload = new Uint8Array(0);
+}

package/src/avif/native/heif/find_item_property.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Find an item's property of a given type.
+ *
+ * `ipma` indices are 1-based into `ipco`, so index `n` is `file.properties[n - 1]`. An index past
+ * the end of `ipco` is corruption and is skipped rather than throwing, because a file can carry a
+ * stale association for a property that was removed and the rest of it is still readable.
+ *
+ * @param {AvifFile} file
+ * @param {AvifItem} item
+ * @param {string} type four character property type
+ * @returns {object|null}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function find_item_property(file: AvifFile, item: AvifItem, type: string): object | null;
+//# sourceMappingURL=find_item_property.d.ts.map

package/src/avif/native/heif/find_item_property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_item_property.d.ts","sourceRoot":"","sources":["../../../../../src/avif/native/heif/find_item_property.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,yEANW,MAAM,GACJ,MAAM,GAAC,IAAI,CAiBvB"}

package/src/avif/native/heif/find_item_property.js

@@ -0,0 +1,28 @@
+/**
+ * Find an item's property of a given type.
+ *
+ * `ipma` indices are 1-based into `ipco`, so index `n` is `file.properties[n - 1]`. An index past
+ * the end of `ipco` is corruption and is skipped rather than throwing, because a file can carry a
+ * stale association for a property that was removed and the rest of it is still readable.
+ *
+ * @param {AvifFile} file
+ * @param {AvifItem} item
+ * @param {string} type four character property type
+ * @returns {object|null}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function find_item_property(file, item, type) {
+    const indices = item.property_indices;
+
+    for (let i = 0; i < indices.length; i++) {
+        const property = file.properties[indices[i] - 1];
+
+        if (property !== undefined && property.type === type) {
+            return property;
+        }
+    }
+
+    return null;
+}

package/src/avif/native/heif/find_item_references.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Collect the item IDs that `from_item_id` references with `reference_type`.
+ *
+ * `iref` may carry several entries with the same type and source — HEIF does not forbid it — so
+ * all of them are concatenated rather than the first being returned.
+ *
+ * @param {AvifFile} file
+ * @param {number} from_item_id
+ * @param {string} reference_type four character type, e.g. `dimg` or `auxl`
+ * @returns {number[]}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function find_item_references(file: AvifFile, from_item_id: number, reference_type: string): number[];
+//# sourceMappingURL=find_item_references.d.ts.map

package/src/avif/native/heif/find_item_references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_item_references.d.ts","sourceRoot":"","sources":["../../../../../src/avif/native/heif/find_item_references.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,mEAPW,MAAM,kBACN,MAAM,GACJ,MAAM,EAAE,CAmBpB"}

package/src/avif/native/heif/find_item_references.js

@@ -0,0 +1,29 @@
+/**
+ * Collect the item IDs that `from_item_id` references with `reference_type`.
+ *
+ * `iref` may carry several entries with the same type and source — HEIF does not forbid it — so
+ * all of them are concatenated rather than the first being returned.
+ *
+ * @param {AvifFile} file
+ * @param {number} from_item_id
+ * @param {string} reference_type four character type, e.g. `dimg` or `auxl`
+ * @returns {number[]}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function find_item_references(file, from_item_id, reference_type) {
+    const result = [];
+
+    for (let i = 0; i < file.references.length; i++) {
+        const reference = file.references[i];
+
+        if (reference.from_item_id === from_item_id && reference.reference_type === reference_type) {
+            for (let j = 0; j < reference.to_item_ids.length; j++) {
+                result.push(reference.to_item_ids[j]);
+            }
+        }
+    }
+
+    return result;
+}

package/src/avif/native/heif/find_items_referencing.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Collect the item IDs that reference `to_item_id` with `reference_type`.
+ *
+ * The inverse of {@link find_item_references}, and the direction that matters for auxiliary
+ * images: an alpha item declares an `auxl` reference *to* the colour item, so finding the alpha
+ * plane for a picture means searching by target.
+ *
+ * @param {AvifFile} file
+ * @param {number} to_item_id
+ * @param {string} reference_type
+ * @returns {number[]}
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2026
+ */
+export function find_items_referencing(file: AvifFile, to_item_id: number, reference_type: string): number[];
+//# sourceMappingURL=find_items_referencing.d.ts.map

package/src/avif/native/heif/find_items_referencing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find_items_referencing.d.ts","sourceRoot":"","sources":["../../../../../src/avif/native/heif/find_items_referencing.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,mEAPW,MAAM,kBACN,MAAM,GACJ,MAAM,EAAE,CAyBpB"}