@aglyn/aglyn 1.0.0-beta.197 → 1.0.0-beta.199

package/src/lib/app-utils/media-embedded-metadata/heif.js

@@ -0,0 +1,354 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * HEIF metadata blocks — HEIC, HEIF and AVIF — read-only (AGL-3331).
+ *
+ * These are ISO base media files (ISO/IEC 14496-12): a run of boxes, each a
+ * 32-bit size (1 = a 64-bit size follows, 0 = to the end), a four-character
+ * type, and a payload. A still image's metadata is not in a box of its own
+ * but in ITEMS (ISO/IEC 23008-12, 6 and Annex A):
+ *
+ * - `meta` (a full box) holds the item catalogue.
+ * - `iinf` lists the items; each `infe` (versions 2 and 3) names an item's
+ *   type. EXIF is item type `Exif`; XMP is item type `mime` with content
+ *   type `application/rdf+xml`.
+ * - `iloc` (versions 0–2) says where each item's bytes are: a base offset
+ *   and extents, with field widths the box itself declares. Only
+ *   construction method 0 (offsets into this file) is followed.
+ * - An `Exif` item starts with a 4-byte `exif_tiff_header_offset` (Annex
+ *   A.2.1), the number of bytes — usually the six of `Exif\0\0` — between
+ *   that field and the TIFF header.
+ * - `iref` `cdsc` references say which item a metadata item describes; the
+ *   EXIF and XMP of the primary item (`pitm`) are preferred over those of a
+ *   thumbnail or an auxiliary image.
+ * - The ICC profile is a `colr` property of type `prof` or `rICC` in
+ *   `iprp`/`ipco`.
+ *
+ * HEIF is not writable here: its item offsets are absolute, so resizing an
+ * item would move every extent after it.
+ */ import { inflateRawSync, inflateSync } from "zlib";
+import { asciiBytes, bytesAt, concatBytes, readAscii, readU16BE, readU32BE, trimNul, utf8Decode } from "./image-blocks.js";
+/** `ftyp` brands that mark an image in the HEIF family. */ const HEIF_BRANDS = new Set([
+    'mif1',
+    'mif2',
+    'msf1',
+    'miaf',
+    'heic',
+    'heix',
+    'heim',
+    'heis',
+    'hevc',
+    'hevx',
+    'hevm',
+    'hevs',
+    'avif',
+    'avis',
+    'avio'
+]);
+const EXIF_HEADER = asciiBytes('Exif\0\0');
+const TIFF_II = asciiBytes('II*\0');
+const TIFF_MM = asciiBytes('MM\0*');
+/** Box and item counts past which the walk stops. */ const MAX_BOXES = 65536;
+const MAX_ITEMS = 65536;
+/** The most a deflate-encoded XMP item may inflate to. */ const MAX_INFLATED = 32 * 1024 * 1024;
+/** 2^53 bounds a safe integer; a 64-bit field above it is not an offset. */ function readU64BE(bytes, offset) {
+    const high = readU32BE(bytes, offset);
+    if (high > 0x1fffff) return Number.NaN;
+    return high * 0x100000000 + readU32BE(bytes, offset + 4);
+}
+/** Reads the boxes laid end to end in `[start, end)`, stopping at damage. */ function readBoxes(bytes, start, end) {
+    const boxes = [];
+    const limit = Math.min(end, bytes.length);
+    let offset = start;
+    while(offset + 8 <= limit && boxes.length < MAX_BOXES){
+        let size = readU32BE(bytes, offset);
+        let header = 8;
+        if (size === 1) {
+            if (offset + 16 > limit) break;
+            size = readU64BE(bytes, offset + 8);
+            header = 16;
+        } else if (size === 0) {
+            size = limit - offset;
+        }
+        if (!(size >= header) || offset + size > limit) break;
+        boxes.push({
+            type: readAscii(bytes, offset + 4, 4),
+            start: offset,
+            payload: offset + header,
+            end: offset + size
+        });
+        offset += size;
+    }
+    return boxes;
+}
+/** An unsigned big-endian integer of 0, 4 or 8 bytes, or NaN otherwise. */ function readSized(bytes, offset, size) {
+    if (size === 0) return 0;
+    if (size === 4) return readU32BE(bytes, offset);
+    if (size === 8) return readU64BE(bytes, offset);
+    return Number.NaN;
+}
+/** A NUL-terminated string inside `[offset, end)`, and where it ends. */ function readCString(bytes, offset, end) {
+    const nul = bytes.subarray(0, end).indexOf(0, offset);
+    const stop = nul < 0 ? end : nul;
+    return {
+        text: utf8Decode(bytes.subarray(offset, stop)),
+        next: stop + 1
+    };
+}
+/** The `infe` entries of an `iinf` box (ISO/IEC 14496-12, 8.11.6). */ function readItemInfos(bytes, iinf) {
+    var _bytes_iinf_payload;
+    const version = (_bytes_iinf_payload = bytes[iinf.payload]) != null ? _bytes_iinf_payload : 0;
+    const entries = iinf.payload + 4 + (version === 0 ? 2 : 4);
+    const items = [];
+    for (const infe of readBoxes(bytes, entries, iinf.end)){
+        var _bytes_infe_payload;
+        if (infe.type !== 'infe' || items.length >= MAX_ITEMS) continue;
+        const infeVersion = (_bytes_infe_payload = bytes[infe.payload]) != null ? _bytes_infe_payload : 0;
+        // Versions 0 and 1 predate item types; HEIF requires 2 or 3.
+        if (infeVersion !== 2 && infeVersion !== 3) continue;
+        let at = infe.payload + 4;
+        const id = infeVersion === 2 ? readU16BE(bytes, at) : readU32BE(bytes, at);
+        at += infeVersion === 2 ? 2 : 4;
+        at += 2; // item_protection_index
+        if (at + 4 > infe.end) continue;
+        const type = readAscii(bytes, at, 4);
+        at += 4;
+        const item = {
+            id,
+            type
+        };
+        const name = readCString(bytes, at, infe.end);
+        if (type === 'mime' && name.next < infe.end) {
+            const contentType = readCString(bytes, name.next, infe.end);
+            item.contentType = contentType.text;
+            if (contentType.next < infe.end) {
+                item.contentEncoding = readCString(bytes, contentType.next, infe.end).text;
+            }
+        }
+        items.push(item);
+    }
+    return items;
+}
+/**
+ * The locations of the wanted items from an `iloc` box (ISO/IEC 14496-12,
+ * 8.11.3), or an empty map when the box is malformed.
+ */ function readItemLocations(bytes, iloc, wanted) {
+    var _bytes_iloc_payload, _bytes_at, _bytes_;
+    const out = new Map();
+    const version = (_bytes_iloc_payload = bytes[iloc.payload]) != null ? _bytes_iloc_payload : 0;
+    if (version > 2) return out;
+    let at = iloc.payload + 4;
+    const sizes = (_bytes_at = bytes[at]) != null ? _bytes_at : 0;
+    const sizes2 = (_bytes_ = bytes[at + 1]) != null ? _bytes_ : 0;
+    const offsetSize = sizes >> 4;
+    const lengthSize = sizes & 0x0f;
+    const baseOffsetSize = sizes2 >> 4;
+    const indexSize = version === 1 || version === 2 ? sizes2 & 0x0f : 0;
+    at += 2;
+    const itemCount = version < 2 ? readU16BE(bytes, at) : readU32BE(bytes, at);
+    at += version < 2 ? 2 : 4;
+    for(let i = 0; i < itemCount && i < MAX_ITEMS; i += 1){
+        if (at >= iloc.end) break;
+        const id = version < 2 ? readU16BE(bytes, at) : readU32BE(bytes, at);
+        at += version < 2 ? 2 : 4;
+        let constructionMethod = 0;
+        if (version === 1 || version === 2) {
+            constructionMethod = readU16BE(bytes, at) & 0x0f;
+            at += 2;
+        }
+        const dataReferenceIndex = readU16BE(bytes, at);
+        at += 2;
+        const baseOffset = readSized(bytes, at, baseOffsetSize);
+        at += baseOffsetSize;
+        const extentCount = readU16BE(bytes, at);
+        at += 2;
+        const extents = [];
+        for(let e = 0; e < extentCount; e += 1){
+            at += indexSize;
+            const offset = readSized(bytes, at, offsetSize);
+            at += offsetSize;
+            const length = readSized(bytes, at, lengthSize);
+            at += lengthSize;
+            if (at > iloc.end || Number.isNaN(offset) || Number.isNaN(length) || Number.isNaN(baseOffset)) {
+                return out;
+            }
+            extents.push({
+                offset: baseOffset + offset,
+                length
+            });
+        }
+        if (wanted.has(id) && !out.has(id)) {
+            out.set(id, {
+                constructionMethod,
+                dataReferenceIndex,
+                extents
+            });
+        }
+    }
+    return out;
+}
+/** The item's bytes, or `null` when it is stored anywhere but this file. */ function itemBytes(bytes, location) {
+    if (!location || location.constructionMethod !== 0 || location.dataReferenceIndex !== 0) {
+        return null;
+    }
+    if (!location.extents.length) return null;
+    const parts = [];
+    for (const { offset, length } of location.extents){
+        // A zero length means "to the end of the file" (8.11.3.3).
+        const end = length === 0 ? bytes.length : offset + length;
+        if (offset < 0 || offset > bytes.length || end > bytes.length) return null;
+        parts.push(bytes.subarray(offset, end));
+    }
+    return concatBytes(parts);
+}
+/**
+ * The TIFF bytes of an `Exif` item: past the 4-byte offset field and the
+ * offset it gives. Writers have been seen to leave `Exif\0\0` in front of
+ * the header while declaring an offset of 0, or to declare 6 with no prefix
+ * written, so those two readings are tried too — but only where a TIFF
+ * header actually begins, never a guess.
+ */ function exifFromItem(payload) {
+    const isTiff = (at)=>bytesAt(payload, at, TIFF_II) || bytesAt(payload, at, TIFF_MM);
+    const declared = 4 + readU32BE(payload, 0);
+    for (const at of [
+        declared,
+        4
+    ]){
+        if (isTiff(at)) return payload.slice(at);
+        if (bytesAt(payload, at, EXIF_HEADER) && isTiff(at + EXIF_HEADER.length)) {
+            return payload.slice(at + EXIF_HEADER.length);
+        }
+    }
+    return undefined;
+}
+/** The text of an XMP item, decoding a `deflate` content encoding. */ function xmpFromItem(payload, encoding) {
+    let data = payload;
+    if (encoding === 'deflate') {
+        try {
+            data = new Uint8Array(inflateSync(payload, {
+                maxOutputLength: MAX_INFLATED
+            }));
+        } catch (unused) {
+            try {
+                data = new Uint8Array(inflateRawSync(payload, {
+                    maxOutputLength: MAX_INFLATED
+                }));
+            } catch (unused) {
+                return undefined;
+            }
+        }
+    } else if (encoding) {
+        return undefined;
+    }
+    return trimNul(utf8Decode(data));
+}
+/** The item ids each `cdsc` reference says an item describes. */ function describedBy(bytes, iref) {
+    var _bytes_iref_payload;
+    const out = new Map();
+    if (!iref) return out;
+    const wide = ((_bytes_iref_payload = bytes[iref.payload]) != null ? _bytes_iref_payload : 0) === 1;
+    const idSize = wide ? 4 : 2;
+    const readId = (at)=>wide ? readU32BE(bytes, at) : readU16BE(bytes, at);
+    for (const reference of readBoxes(bytes, iref.payload + 4, iref.end)){
+        if (reference.type !== 'cdsc') continue;
+        const from = readId(reference.payload);
+        const count = readU16BE(bytes, reference.payload + idSize);
+        const to = [];
+        for(let i = 0; i < count; i += 1){
+            const at = reference.payload + idSize + 2 + i * idSize;
+            if (at + idSize > reference.end) break;
+            to.push(readId(at));
+        }
+        out.set(from, to);
+    }
+    return out;
+}
+/**
+ * Reads the metadata blocks of a HEIC, HEIF or AVIF image. Returns `null`
+ * when the bytes are not in the HEIF family (no `ftyp` with a HEIF brand);
+ * a malformed file yields what could be read.
+ */ export function readHeifBlocks(bytes) {
+    var _bytes_pitm_payload;
+    const top = readBoxes(bytes, 0, bytes.length);
+    const ftyp = top[0];
+    if (!ftyp || ftyp.type !== 'ftyp') return null;
+    // The major brand, a minor version (skipped), then compatible brands.
+    let heif = HEIF_BRANDS.has(readAscii(bytes, ftyp.payload, 4));
+    for(let at = ftyp.payload + 8; at + 4 <= ftyp.end && !heif; at += 4){
+        heif = HEIF_BRANDS.has(readAscii(bytes, at, 4));
+    }
+    if (!heif) return null;
+    const blocks = {};
+    const meta = top.find((box)=>box.type === 'meta');
+    if (!meta) return blocks;
+    const children = readBoxes(bytes, meta.payload + 4, meta.end);
+    const child = (type)=>children.find((box)=>box.type === type);
+    const iprp = child('iprp');
+    const ipco = iprp && readBoxes(bytes, iprp.payload, iprp.end).find((box)=>box.type === 'ipco');
+    for (const property of ipco ? readBoxes(bytes, ipco.payload, ipco.end) : []){
+        if (property.type !== 'colr' || property.payload + 4 > property.end) continue;
+        const colourType = readAscii(bytes, property.payload, 4);
+        if (colourType === 'prof' || colourType === 'rICC') {
+            blocks.icc = bytes.slice(property.payload + 4, property.end);
+            break;
+        }
+    }
+    const iinf = child('iinf');
+    const iloc = child('iloc');
+    if (!iinf || !iloc) return blocks;
+    const infos = readItemInfos(bytes, iinf);
+    const exifItems = infos.filter((item)=>item.type === 'Exif');
+    const xmpItems = infos.filter((item)=>{
+        var _item_contentType;
+        return item.type === 'mime' && ((_item_contentType = item.contentType) == null ? void 0 : _item_contentType.trim().toLowerCase()) === 'application/rdf+xml';
+    });
+    if (!exifItems.length && !xmpItems.length) return blocks;
+    const pitm = child('pitm');
+    const primary = pitm ? ((_bytes_pitm_payload = bytes[pitm.payload]) != null ? _bytes_pitm_payload : 0) === 0 ? readU16BE(bytes, pitm.payload + 4) : readU32BE(bytes, pitm.payload + 4) : undefined;
+    const references = describedBy(bytes, child('iref'));
+    // The primary image's own metadata first, then the rest in file order.
+    const describesPrimary = (item)=>{
+        var _references_get;
+        return primary !== undefined && ((_references_get = references.get(item.id)) != null ? _references_get : []).includes(primary);
+    };
+    const rank = (items)=>[
+            ...items.filter(describesPrimary),
+            ...items.filter((item)=>!describesPrimary(item))
+        ];
+    const locations = readItemLocations(bytes, iloc, new Set([
+        ...exifItems,
+        ...xmpItems
+    ].map((item)=>item.id)));
+    for (const item of rank(exifItems)){
+        const payload = itemBytes(bytes, locations.get(item.id));
+        const exif = payload && exifFromItem(payload);
+        if (exif) {
+            blocks.exif = exif;
+            break;
+        }
+    }
+    for (const item of rank(xmpItems)){
+        const payload = itemBytes(bytes, locations.get(item.id));
+        const xmp = payload && xmpFromItem(payload, item.contentEncoding);
+        if (xmp) {
+            blocks.xmp = xmp;
+            break;
+        }
+    }
+    return blocks;
+}
+
+//# sourceMappingURL=heif.js.map

package/src/lib/app-utils/media-embedded-metadata/heif.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/aglyn/src/lib/app-utils/media-embedded-metadata/heif.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * HEIF metadata blocks — HEIC, HEIF and AVIF — read-only (AGL-3331).\n *\n * These are ISO base media files (ISO/IEC 14496-12): a run of boxes, each a\n * 32-bit size (1 = a 64-bit size follows, 0 = to the end), a four-character\n * type, and a payload. A still image's metadata is not in a box of its own\n * but in ITEMS (ISO/IEC 23008-12, 6 and Annex A):\n *\n * - `meta` (a full box) holds the item catalogue.\n * - `iinf` lists the items; each `infe` (versions 2 and 3) names an item's\n *   type. EXIF is item type `Exif`; XMP is item type `mime` with content\n *   type `application/rdf+xml`.\n * - `iloc` (versions 0–2) says where each item's bytes are: a base offset\n *   and extents, with field widths the box itself declares. Only\n *   construction method 0 (offsets into this file) is followed.\n * - An `Exif` item starts with a 4-byte `exif_tiff_header_offset` (Annex\n *   A.2.1), the number of bytes — usually the six of `Exif\\0\\0` — between\n *   that field and the TIFF header.\n * - `iref` `cdsc` references say which item a metadata item describes; the\n *   EXIF and XMP of the primary item (`pitm`) are preferred over those of a\n *   thumbnail or an auxiliary image.\n * - The ICC profile is a `colr` property of type `prof` or `rICC` in\n *   `iprp`/`ipco`.\n *\n * HEIF is not writable here: its item offsets are absolute, so resizing an\n * item would move every extent after it.\n */\n\nimport { inflateRawSync, inflateSync } from 'zlib'\nimport {\n  asciiBytes,\n  bytesAt,\n  concatBytes,\n  readAscii,\n  readU16BE,\n  readU32BE,\n  trimNul,\n  utf8Decode,\n  type ImageBlocks,\n} from './image-blocks'\n\n/** `ftyp` brands that mark an image in the HEIF family. */\nconst HEIF_BRANDS = new Set([\n  'mif1',\n  'mif2',\n  'msf1',\n  'miaf',\n  'heic',\n  'heix',\n  'heim',\n  'heis',\n  'hevc',\n  'hevx',\n  'hevm',\n  'hevs',\n  'avif',\n  'avis',\n  'avio',\n])\n\nconst EXIF_HEADER = asciiBytes('Exif\\0\\0')\nconst TIFF_II = asciiBytes('II*\\0')\nconst TIFF_MM = asciiBytes('MM\\0*')\n\n/** Box and item counts past which the walk stops. */\nconst MAX_BOXES = 65536\nconst MAX_ITEMS = 65536\n/** The most a deflate-encoded XMP item may inflate to. */\nconst MAX_INFLATED = 32 * 1024 * 1024\n\ninterface Box {\n  type: string\n  start: number\n  /** First payload byte, after the size, type and any large size. */\n  payload: number\n  end: number\n}\n\n/** 2^53 bounds a safe integer; a 64-bit field above it is not an offset. */\nfunction readU64BE(bytes: Uint8Array, offset: number): number {\n  const high = readU32BE(bytes, offset)\n  if (high > 0x1fffff) return Number.NaN\n  return high * 0x100000000 + readU32BE(bytes, offset + 4)\n}\n\n/** Reads the boxes laid end to end in `[start, end)`, stopping at damage. */\nfunction readBoxes(bytes: Uint8Array, start: number, end: number): Box[] {\n  const boxes: Box[] = []\n  const limit = Math.min(end, bytes.length)\n  let offset = start\n  while (offset + 8 <= limit && boxes.length < MAX_BOXES) {\n    let size = readU32BE(bytes, offset)\n    let header = 8\n    if (size === 1) {\n      if (offset + 16 > limit) break\n      size = readU64BE(bytes, offset + 8)\n      header = 16\n    } else if (size === 0) {\n      size = limit - offset\n    }\n    if (!(size >= header) || offset + size > limit) break\n    boxes.push({\n      type: readAscii(bytes, offset + 4, 4),\n      start: offset,\n      payload: offset + header,\n      end: offset + size,\n    })\n    offset += size\n  }\n  return boxes\n}\n\n/** An unsigned big-endian integer of 0, 4 or 8 bytes, or NaN otherwise. */\nfunction readSized(bytes: Uint8Array, offset: number, size: number): number {\n  if (size === 0) return 0\n  if (size === 4) return readU32BE(bytes, offset)\n  if (size === 8) return readU64BE(bytes, offset)\n  return Number.NaN\n}\n\n/** A NUL-terminated string inside `[offset, end)`, and where it ends. */\nfunction readCString(\n  bytes: Uint8Array,\n  offset: number,\n  end: number,\n): { text: string; next: number } {\n  const nul = bytes.subarray(0, end).indexOf(0, offset)\n  const stop = nul < 0 ? end : nul\n  return { text: utf8Decode(bytes.subarray(offset, stop)), next: stop + 1 }\n}\n\ninterface ItemInfo {\n  id: number\n  type: string\n  contentType?: string\n  contentEncoding?: string\n}\n\n/** The `infe` entries of an `iinf` box (ISO/IEC 14496-12, 8.11.6). */\nfunction readItemInfos(bytes: Uint8Array, iinf: Box): ItemInfo[] {\n  const version = bytes[iinf.payload] ?? 0\n  const entries = iinf.payload + 4 + (version === 0 ? 2 : 4)\n  const items: ItemInfo[] = []\n  for (const infe of readBoxes(bytes, entries, iinf.end)) {\n    if (infe.type !== 'infe' || items.length >= MAX_ITEMS) continue\n    const infeVersion = bytes[infe.payload] ?? 0\n    // Versions 0 and 1 predate item types; HEIF requires 2 or 3.\n    if (infeVersion !== 2 && infeVersion !== 3) continue\n    let at = infe.payload + 4\n    const id = infeVersion === 2 ? readU16BE(bytes, at) : readU32BE(bytes, at)\n    at += infeVersion === 2 ? 2 : 4\n    at += 2 // item_protection_index\n    if (at + 4 > infe.end) continue\n    const type = readAscii(bytes, at, 4)\n    at += 4\n    const item: ItemInfo = { id, type }\n    const name = readCString(bytes, at, infe.end)\n    if (type === 'mime' && name.next < infe.end) {\n      const contentType = readCString(bytes, name.next, infe.end)\n      item.contentType = contentType.text\n      if (contentType.next < infe.end) {\n        item.contentEncoding = readCString(\n          bytes,\n          contentType.next,\n          infe.end,\n        ).text\n      }\n    }\n    items.push(item)\n  }\n  return items\n}\n\ninterface ItemLocation {\n  constructionMethod: number\n  dataReferenceIndex: number\n  extents: { offset: number; length: number }[]\n}\n\n/**\n * The locations of the wanted items from an `iloc` box (ISO/IEC 14496-12,\n * 8.11.3), or an empty map when the box is malformed.\n */\nfunction readItemLocations(\n  bytes: Uint8Array,\n  iloc: Box,\n  wanted: Set<number>,\n): Map<number, ItemLocation> {\n  const out = new Map<number, ItemLocation>()\n  const version = bytes[iloc.payload] ?? 0\n  if (version > 2) return out\n  let at = iloc.payload + 4\n  const sizes = bytes[at] ?? 0\n  const sizes2 = bytes[at + 1] ?? 0\n  const offsetSize = sizes >> 4\n  const lengthSize = sizes & 0x0f\n  const baseOffsetSize = sizes2 >> 4\n  const indexSize = version === 1 || version === 2 ? sizes2 & 0x0f : 0\n  at += 2\n  const itemCount = version < 2 ? readU16BE(bytes, at) : readU32BE(bytes, at)\n  at += version < 2 ? 2 : 4\n  for (let i = 0; i < itemCount && i < MAX_ITEMS; i += 1) {\n    if (at >= iloc.end) break\n    const id = version < 2 ? readU16BE(bytes, at) : readU32BE(bytes, at)\n    at += version < 2 ? 2 : 4\n    let constructionMethod = 0\n    if (version === 1 || version === 2) {\n      constructionMethod = readU16BE(bytes, at) & 0x0f\n      at += 2\n    }\n    const dataReferenceIndex = readU16BE(bytes, at)\n    at += 2\n    const baseOffset = readSized(bytes, at, baseOffsetSize)\n    at += baseOffsetSize\n    const extentCount = readU16BE(bytes, at)\n    at += 2\n    const extents: { offset: number; length: number }[] = []\n    for (let e = 0; e < extentCount; e += 1) {\n      at += indexSize\n      const offset = readSized(bytes, at, offsetSize)\n      at += offsetSize\n      const length = readSized(bytes, at, lengthSize)\n      at += lengthSize\n      if (\n        at > iloc.end ||\n        Number.isNaN(offset) ||\n        Number.isNaN(length) ||\n        Number.isNaN(baseOffset)\n      ) {\n        return out\n      }\n      extents.push({ offset: baseOffset + offset, length })\n    }\n    if (wanted.has(id) && !out.has(id)) {\n      out.set(id, { constructionMethod, dataReferenceIndex, extents })\n    }\n  }\n  return out\n}\n\n/** The item's bytes, or `null` when it is stored anywhere but this file. */\nfunction itemBytes(\n  bytes: Uint8Array,\n  location: ItemLocation | undefined,\n): Uint8Array | null {\n  if (\n    !location ||\n    location.constructionMethod !== 0 ||\n    location.dataReferenceIndex !== 0\n  ) {\n    return null\n  }\n  if (!location.extents.length) return null\n  const parts: Uint8Array[] = []\n  for (const { offset, length } of location.extents) {\n    // A zero length means \"to the end of the file\" (8.11.3.3).\n    const end = length === 0 ? bytes.length : offset + length\n    if (offset < 0 || offset > bytes.length || end > bytes.length) return null\n    parts.push(bytes.subarray(offset, end))\n  }\n  return concatBytes(parts)\n}\n\n/**\n * The TIFF bytes of an `Exif` item: past the 4-byte offset field and the\n * offset it gives. Writers have been seen to leave `Exif\\0\\0` in front of\n * the header while declaring an offset of 0, or to declare 6 with no prefix\n * written, so those two readings are tried too — but only where a TIFF\n * header actually begins, never a guess.\n */\nfunction exifFromItem(payload: Uint8Array): Uint8Array | undefined {\n  const isTiff = (at: number) =>\n    bytesAt(payload, at, TIFF_II) || bytesAt(payload, at, TIFF_MM)\n  const declared = 4 + readU32BE(payload, 0)\n  for (const at of [declared, 4]) {\n    if (isTiff(at)) return payload.slice(at)\n    if (bytesAt(payload, at, EXIF_HEADER) && isTiff(at + EXIF_HEADER.length)) {\n      return payload.slice(at + EXIF_HEADER.length)\n    }\n  }\n  return undefined\n}\n\n/** The text of an XMP item, decoding a `deflate` content encoding. */\nfunction xmpFromItem(\n  payload: Uint8Array,\n  encoding: string | undefined,\n): string | undefined {\n  let data: Uint8Array = payload\n  if (encoding === 'deflate') {\n    try {\n      data = new Uint8Array(\n        inflateSync(payload, { maxOutputLength: MAX_INFLATED }),\n      )\n    } catch {\n      try {\n        data = new Uint8Array(\n          inflateRawSync(payload, { maxOutputLength: MAX_INFLATED }),\n        )\n      } catch {\n        return undefined\n      }\n    }\n  } else if (encoding) {\n    return undefined\n  }\n  return trimNul(utf8Decode(data))\n}\n\n/** The item ids each `cdsc` reference says an item describes. */\nfunction describedBy(\n  bytes: Uint8Array,\n  iref: Box | undefined,\n): Map<number, number[]> {\n  const out = new Map<number, number[]>()\n  if (!iref) return out\n  const wide = (bytes[iref.payload] ?? 0) === 1\n  const idSize = wide ? 4 : 2\n  const readId = (at: number) =>\n    wide ? readU32BE(bytes, at) : readU16BE(bytes, at)\n  for (const reference of readBoxes(bytes, iref.payload + 4, iref.end)) {\n    if (reference.type !== 'cdsc') continue\n    const from = readId(reference.payload)\n    const count = readU16BE(bytes, reference.payload + idSize)\n    const to: number[] = []\n    for (let i = 0; i < count; i += 1) {\n      const at = reference.payload + idSize + 2 + i * idSize\n      if (at + idSize > reference.end) break\n      to.push(readId(at))\n    }\n    out.set(from, to)\n  }\n  return out\n}\n\n/**\n * Reads the metadata blocks of a HEIC, HEIF or AVIF image. Returns `null`\n * when the bytes are not in the HEIF family (no `ftyp` with a HEIF brand);\n * a malformed file yields what could be read.\n */\nexport function readHeifBlocks(bytes: Uint8Array): ImageBlocks | null {\n  const top = readBoxes(bytes, 0, bytes.length)\n  const ftyp = top[0]\n  if (!ftyp || ftyp.type !== 'ftyp') return null\n  // The major brand, a minor version (skipped), then compatible brands.\n  let heif = HEIF_BRANDS.has(readAscii(bytes, ftyp.payload, 4))\n  for (let at = ftyp.payload + 8; at + 4 <= ftyp.end && !heif; at += 4) {\n    heif = HEIF_BRANDS.has(readAscii(bytes, at, 4))\n  }\n  if (!heif) return null\n\n  const blocks: ImageBlocks = {}\n  const meta = top.find((box) => box.type === 'meta')\n  if (!meta) return blocks\n  const children = readBoxes(bytes, meta.payload + 4, meta.end)\n  const child = (type: string) => children.find((box) => box.type === type)\n\n  const iprp = child('iprp')\n  const ipco =\n    iprp &&\n    readBoxes(bytes, iprp.payload, iprp.end).find((box) => box.type === 'ipco')\n  for (const property of ipco ? readBoxes(bytes, ipco.payload, ipco.end) : []) {\n    if (property.type !== 'colr' || property.payload + 4 > property.end)\n      continue\n    const colourType = readAscii(bytes, property.payload, 4)\n    if (colourType === 'prof' || colourType === 'rICC') {\n      blocks.icc = bytes.slice(property.payload + 4, property.end)\n      break\n    }\n  }\n\n  const iinf = child('iinf')\n  const iloc = child('iloc')\n  if (!iinf || !iloc) return blocks\n  const infos = readItemInfos(bytes, iinf)\n  const exifItems = infos.filter((item) => item.type === 'Exif')\n  const xmpItems = infos.filter(\n    (item) =>\n      item.type === 'mime' &&\n      item.contentType?.trim().toLowerCase() === 'application/rdf+xml',\n  )\n  if (!exifItems.length && !xmpItems.length) return blocks\n\n  const pitm = child('pitm')\n  const primary = pitm\n    ? (bytes[pitm.payload] ?? 0) === 0\n      ? readU16BE(bytes, pitm.payload + 4)\n      : readU32BE(bytes, pitm.payload + 4)\n    : undefined\n  const references = describedBy(bytes, child('iref'))\n  // The primary image's own metadata first, then the rest in file order.\n  const describesPrimary = (item: ItemInfo) =>\n    primary !== undefined && (references.get(item.id) ?? []).includes(primary)\n  const rank = (items: ItemInfo[]) => [\n    ...items.filter(describesPrimary),\n    ...items.filter((item) => !describesPrimary(item)),\n  ]\n\n  const locations = readItemLocations(\n    bytes,\n    iloc,\n    new Set([...exifItems, ...xmpItems].map((item) => item.id)),\n  )\n  for (const item of rank(exifItems)) {\n    const payload = itemBytes(bytes, locations.get(item.id))\n    const exif = payload && exifFromItem(payload)\n    if (exif) {\n      blocks.exif = exif\n      break\n    }\n  }\n  for (const item of rank(xmpItems)) {\n    const payload = itemBytes(bytes, locations.get(item.id))\n    const xmp = payload && xmpFromItem(payload, item.contentEncoding)\n    if (xmp) {\n      blocks.xmp = xmp\n      break\n    }\n  }\n  return blocks\n}\n"],"names":["inflateRawSync","inflateSync","asciiBytes","bytesAt","concatBytes","readAscii","readU16BE","readU32BE","trimNul","utf8Decode","HEIF_BRANDS","Set","EXIF_HEADER","TIFF_II","TIFF_MM","MAX_BOXES","MAX_ITEMS","MAX_INFLATED","readU64BE","bytes","offset","high","Number","NaN","readBoxes","start","end","boxes","limit","Math","min","length","size","header","push","type","payload","readSized","readCString","nul","subarray","indexOf","stop","text","next","readItemInfos","iinf","version","entries","items","infe","infeVersion","at","id","item","name","contentType","contentEncoding","readItemLocations","iloc","wanted","out","Map","sizes","sizes2","offsetSize","lengthSize","baseOffsetSize","indexSize","itemCount","i","constructionMethod","dataReferenceIndex","baseOffset","extentCount","extents","e","isNaN","has","set","itemBytes","location","parts","exifFromItem","isTiff","declared","slice","undefined","xmpFromItem","encoding","data","Uint8Array","maxOutputLength","describedBy","iref","wide","idSize","readId","reference","from","count","to","readHeifBlocks","top","ftyp","heif","blocks","meta","find","box","children","child","iprp","ipco","property","colourType","icc","infos","exifItems","filter","xmpItems","trim","toLowerCase","pitm","primary","references","describesPrimary","get","includes","rank","locations","map","exif","xmp"],"mappings":"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"}

package/src/lib/app-utils/media-embedded-metadata/icc.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The profile description of an ICC profile, or `null` when the bytes are
+ * not a profile, carry no `desc` tag, or it holds no readable text. Never
+ * throws.
+ */
+export declare function readIccDescription(icc: Uint8Array): string | null;

package/src/lib/app-utils/media-embedded-metadata/icc.js

@@ -0,0 +1,85 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * The one thing the DAM shows from an ICC profile: its description — "sRGB
+ * IEC61966-2.1", "Display P3" (AGL-3331).
+ *
+ * An ICC profile is a 128-byte header (the signature `acsp` at offset 36), a
+ * tag count at 128, then 12-byte tag table entries of signature, offset and
+ * size (ICC.1:2010, 7.3). The description is the `desc` tag, whose type
+ * depends on the profile's version:
+ *
+ * - v2: `textDescriptionType` (ICC.1:2001-04) — an ASCII string with its
+ *   length, then an optional Unicode and ScriptCode copy.
+ * - v4: `multiLocalizedUnicodeType` (ICC.1:2010) — records of language,
+ *   country, length and offset over UTF-16BE text. The first record is the
+ *   profile's own choice of default.
+ * - Some writers use a plain `textType`; that is read as ASCII.
+ */ import { readAscii, readU32BE, trimNul, utf16beDecode } from "./image-blocks.js";
+/** Tags read before giving up on finding `desc`. */ const MAX_TAGS = 1024;
+/** A description longer than this is not a name; it is cut here. */ const MAX_DESCRIPTION = 512;
+/** Keeps a decoded description to something a person can read. */ function clean(text) {
+    const trimmed = trimNul(text).replace(/\0[\s\S]*$/, '').trim();
+    return trimmed ? trimmed.slice(0, MAX_DESCRIPTION) : null;
+}
+/** A `textDescriptionType` body: ASCII first, then its Unicode copy. */ function textDescription(tag) {
+    const asciiCount = readU32BE(tag, 8);
+    const asciiEnd = 12 + asciiCount;
+    if (asciiCount > 0 && asciiEnd <= tag.length) {
+        const ascii = clean(readAscii(tag, 12, asciiCount));
+        if (ascii) return ascii;
+    }
+    // Unicode language code (4) and character count (4), then UTF-16BE.
+    if (asciiEnd + 8 > tag.length) return null;
+    const unicodeCount = readU32BE(tag, asciiEnd + 4);
+    const start = asciiEnd + 8;
+    const end = Math.min(tag.length, start + unicodeCount * 2);
+    return unicodeCount ? clean(utf16beDecode(tag.subarray(start, end))) : null;
+}
+/** A `multiLocalizedUnicodeType` body: its first record. */ function multiLocalized(tag) {
+    const records = readU32BE(tag, 8);
+    const recordSize = readU32BE(tag, 12);
+    if (!records || recordSize < 12 || 16 + recordSize > tag.length) return null;
+    const length = readU32BE(tag, 16 + 4);
+    const offset = readU32BE(tag, 16 + 8);
+    if (offset >= tag.length) return null;
+    return clean(utf16beDecode(tag.subarray(offset, Math.min(tag.length, offset + length))));
+}
+/**
+ * The profile description of an ICC profile, or `null` when the bytes are
+ * not a profile, carry no `desc` tag, or it holds no readable text. Never
+ * throws.
+ */ export function readIccDescription(icc) {
+    if (icc.length < 132 || readAscii(icc, 36, 4) !== 'acsp') return null;
+    const count = Math.min(readU32BE(icc, 128), MAX_TAGS);
+    for(let i = 0; i < count; i += 1){
+        const entry = 132 + i * 12;
+        if (entry + 12 > icc.length) return null;
+        if (readAscii(icc, entry, 4) !== 'desc') continue;
+        const offset = readU32BE(icc, entry + 4);
+        const size = readU32BE(icc, entry + 8);
+        if (offset < 128 || offset + 12 > icc.length) return null;
+        const tag = icc.subarray(offset, Math.min(icc.length, offset + size));
+        const type = readAscii(tag, 0, 4);
+        if (type === 'desc') return textDescription(tag);
+        if (type === 'mluc') return multiLocalized(tag);
+        if (type === 'text') return clean(readAscii(tag, 8, tag.length - 8));
+        return null;
+    }
+    return null;
+}
+
+//# sourceMappingURL=icc.js.map

package/src/lib/app-utils/media-embedded-metadata/icc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/aglyn/src/lib/app-utils/media-embedded-metadata/icc.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * The one thing the DAM shows from an ICC profile: its description — \"sRGB\n * IEC61966-2.1\", \"Display P3\" (AGL-3331).\n *\n * An ICC profile is a 128-byte header (the signature `acsp` at offset 36), a\n * tag count at 128, then 12-byte tag table entries of signature, offset and\n * size (ICC.1:2010, 7.3). The description is the `desc` tag, whose type\n * depends on the profile's version:\n *\n * - v2: `textDescriptionType` (ICC.1:2001-04) — an ASCII string with its\n *   length, then an optional Unicode and ScriptCode copy.\n * - v4: `multiLocalizedUnicodeType` (ICC.1:2010) — records of language,\n *   country, length and offset over UTF-16BE text. The first record is the\n *   profile's own choice of default.\n * - Some writers use a plain `textType`; that is read as ASCII.\n */\n\nimport { readAscii, readU32BE, trimNul, utf16beDecode } from './image-blocks'\n\n/** Tags read before giving up on finding `desc`. */\nconst MAX_TAGS = 1024\n/** A description longer than this is not a name; it is cut here. */\nconst MAX_DESCRIPTION = 512\n\n/** Keeps a decoded description to something a person can read. */\nfunction clean(text: string): string | null {\n  const trimmed = trimNul(text)\n    .replace(/\\0[\\s\\S]*$/, '')\n    .trim()\n  return trimmed ? trimmed.slice(0, MAX_DESCRIPTION) : null\n}\n\n/** A `textDescriptionType` body: ASCII first, then its Unicode copy. */\nfunction textDescription(tag: Uint8Array): string | null {\n  const asciiCount = readU32BE(tag, 8)\n  const asciiEnd = 12 + asciiCount\n  if (asciiCount > 0 && asciiEnd <= tag.length) {\n    const ascii = clean(readAscii(tag, 12, asciiCount))\n    if (ascii) return ascii\n  }\n  // Unicode language code (4) and character count (4), then UTF-16BE.\n  if (asciiEnd + 8 > tag.length) return null\n  const unicodeCount = readU32BE(tag, asciiEnd + 4)\n  const start = asciiEnd + 8\n  const end = Math.min(tag.length, start + unicodeCount * 2)\n  return unicodeCount ? clean(utf16beDecode(tag.subarray(start, end))) : null\n}\n\n/** A `multiLocalizedUnicodeType` body: its first record. */\nfunction multiLocalized(tag: Uint8Array): string | null {\n  const records = readU32BE(tag, 8)\n  const recordSize = readU32BE(tag, 12)\n  if (!records || recordSize < 12 || 16 + recordSize > tag.length) return null\n  const length = readU32BE(tag, 16 + 4)\n  const offset = readU32BE(tag, 16 + 8)\n  if (offset >= tag.length) return null\n  return clean(\n    utf16beDecode(tag.subarray(offset, Math.min(tag.length, offset + length))),\n  )\n}\n\n/**\n * The profile description of an ICC profile, or `null` when the bytes are\n * not a profile, carry no `desc` tag, or it holds no readable text. Never\n * throws.\n */\nexport function readIccDescription(icc: Uint8Array): string | null {\n  if (icc.length < 132 || readAscii(icc, 36, 4) !== 'acsp') return null\n  const count = Math.min(readU32BE(icc, 128), MAX_TAGS)\n  for (let i = 0; i < count; i += 1) {\n    const entry = 132 + i * 12\n    if (entry + 12 > icc.length) return null\n    if (readAscii(icc, entry, 4) !== 'desc') continue\n    const offset = readU32BE(icc, entry + 4)\n    const size = readU32BE(icc, entry + 8)\n    if (offset < 128 || offset + 12 > icc.length) return null\n    const tag = icc.subarray(offset, Math.min(icc.length, offset + size))\n    const type = readAscii(tag, 0, 4)\n    if (type === 'desc') return textDescription(tag)\n    if (type === 'mluc') return multiLocalized(tag)\n    if (type === 'text') return clean(readAscii(tag, 8, tag.length - 8))\n    return null\n  }\n  return null\n}\n"],"names":["readAscii","readU32BE","trimNul","utf16beDecode","MAX_TAGS","MAX_DESCRIPTION","clean","text","trimmed","replace","trim","slice","textDescription","tag","asciiCount","asciiEnd","length","ascii","unicodeCount","start","end","Math","min","subarray","multiLocalized","records","recordSize","offset","readIccDescription","icc","count","i","entry","size","type"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;CAeC,GAED,SAASA,SAAS,EAAEC,SAAS,EAAEC,OAAO,EAAEC,aAAa,QAAQ,oBAAgB;AAE7E,kDAAkD,GAClD,MAAMC,WAAW;AACjB,kEAAkE,GAClE,MAAMC,kBAAkB;AAExB,gEAAgE,GAChE,SAASC,MAAMC,IAAY;IACzB,MAAMC,UAAUN,QAAQK,MACrBE,OAAO,CAAC,cAAc,IACtBC,IAAI;IACP,OAAOF,UAAUA,QAAQG,KAAK,CAAC,GAAGN,mBAAmB;AACvD;AAEA,sEAAsE,GACtE,SAASO,gBAAgBC,GAAe;IACtC,MAAMC,aAAab,UAAUY,KAAK;IAClC,MAAME,WAAW,KAAKD;IACtB,IAAIA,aAAa,KAAKC,YAAYF,IAAIG,MAAM,EAAE;QAC5C,MAAMC,QAAQX,MAAMN,UAAUa,KAAK,IAAIC;QACvC,IAAIG,OAAO,OAAOA;IACpB;IACA,oEAAoE;IACpE,IAAIF,WAAW,IAAIF,IAAIG,MAAM,EAAE,OAAO;IACtC,MAAME,eAAejB,UAAUY,KAAKE,WAAW;IAC/C,MAAMI,QAAQJ,WAAW;IACzB,MAAMK,MAAMC,KAAKC,GAAG,CAACT,IAAIG,MAAM,EAAEG,QAAQD,eAAe;IACxD,OAAOA,eAAeZ,MAAMH,cAAcU,IAAIU,QAAQ,CAACJ,OAAOC,SAAS;AACzE;AAEA,0DAA0D,GAC1D,SAASI,eAAeX,GAAe;IACrC,MAAMY,UAAUxB,UAAUY,KAAK;IAC/B,MAAMa,aAAazB,UAAUY,KAAK;IAClC,IAAI,CAACY,WAAWC,aAAa,MAAM,KAAKA,aAAab,IAAIG,MAAM,EAAE,OAAO;IACxE,MAAMA,SAASf,UAAUY,KAAK,KAAK;IACnC,MAAMc,SAAS1B,UAAUY,KAAK,KAAK;IACnC,IAAIc,UAAUd,IAAIG,MAAM,EAAE,OAAO;IACjC,OAAOV,MACLH,cAAcU,IAAIU,QAAQ,CAACI,QAAQN,KAAKC,GAAG,CAACT,IAAIG,MAAM,EAAEW,SAASX;AAErE;AAEA;;;;CAIC,GACD,OAAO,SAASY,mBAAmBC,GAAe;IAChD,IAAIA,IAAIb,MAAM,GAAG,OAAOhB,UAAU6B,KAAK,IAAI,OAAO,QAAQ,OAAO;IACjE,MAAMC,QAAQT,KAAKC,GAAG,CAACrB,UAAU4B,KAAK,MAAMzB;IAC5C,IAAK,IAAI2B,IAAI,GAAGA,IAAID,OAAOC,KAAK,EAAG;QACjC,MAAMC,QAAQ,MAAMD,IAAI;QACxB,IAAIC,QAAQ,KAAKH,IAAIb,MAAM,EAAE,OAAO;QACpC,IAAIhB,UAAU6B,KAAKG,OAAO,OAAO,QAAQ;QACzC,MAAML,SAAS1B,UAAU4B,KAAKG,QAAQ;QACtC,MAAMC,OAAOhC,UAAU4B,KAAKG,QAAQ;QACpC,IAAIL,SAAS,OAAOA,SAAS,KAAKE,IAAIb,MAAM,EAAE,OAAO;QACrD,MAAMH,MAAMgB,IAAIN,QAAQ,CAACI,QAAQN,KAAKC,GAAG,CAACO,IAAIb,MAAM,EAAEW,SAASM;QAC/D,MAAMC,OAAOlC,UAAUa,KAAK,GAAG;QAC/B,IAAIqB,SAAS,QAAQ,OAAOtB,gBAAgBC;QAC5C,IAAIqB,SAAS,QAAQ,OAAOV,eAAeX;QAC3C,IAAIqB,SAAS,QAAQ,OAAO5B,MAAMN,UAAUa,KAAK,GAAGA,IAAIG,MAAM,GAAG;QACjE,OAAO;IACT;IACA,OAAO;AACT"}