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

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

@@ -0,0 +1,529 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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.
+ */ /**
+ * IPTC IIM, and the Photoshop image resource block that carries it
+ * (AGL-3331).
+ *
+ * ## IIM
+ *
+ * The IPTC Information Interchange Model (IIM 4.2) is a flat run of
+ * datasets: `0x1C`, record, dataset, a 2-byte big-endian length, the data.
+ * A length with its top bit set is the extended form (§1.5.4): the low 15
+ * bits count the length bytes that follow. Record 2 is the "application
+ * record" every photo tool writes; record 1:90 names the character set, and
+ * `ESC % G` (ISO 2022) there means UTF-8. Without it the text is whatever
+ * the writer used, so each value decodes as UTF-8 when it is valid UTF-8
+ * and as Latin-1 otherwise.
+ *
+ * ## Photoshop image resources (IRB)
+ *
+ * In a JPEG (APP13 after `Photoshop 3.0\0`), a TIFF (tag 34377) and a PSD,
+ * IIM travels inside an image resource block: a run of resources, each
+ * `8BIM`, a 2-byte id, a Pascal name padded to even, a 4-byte size and the
+ * data padded to even (Photoshop File Formats §"Image Resource Blocks").
+ * Resource 0x0404 holds the IIM and 0x0425 its MD5, which Photoshop and the
+ * Metadata Working Group use to notice IPTC edited behind their back, so
+ * the digest is kept in step with every write.
+ *
+ * ## Writing
+ *
+ * {@link writeIim} syncs every mapped key in the patch — adding, replacing
+ * or removing datasets, a list as one dataset per item — and leaves every
+ * other dataset byte-identical and where it was. {@link writeIrbIptc}
+ * rewrites 0x0404 (and 0x0425) and copies every other resource through
+ * byte for byte, in order.
+ */ import { createHash } from "crypto";
+import { decodeLegacyText, isUtf8 } from "./exif.js";
+/** The record 2 datasets this module maps, IIM 4.2 §6. */ const FIELDS = [
+    {
+        key: 'title',
+        dataset: 5
+    },
+    {
+        key: 'keywords',
+        dataset: 25,
+        repeatable: true
+    },
+    {
+        key: 'instructions',
+        dataset: 40
+    },
+    {
+        key: 'creator',
+        dataset: 80,
+        repeatable: true
+    },
+    {
+        key: 'city',
+        dataset: 90
+    },
+    {
+        key: 'state',
+        dataset: 95
+    },
+    {
+        key: 'country',
+        dataset: 101
+    },
+    {
+        key: 'headline',
+        dataset: 105
+    },
+    {
+        key: 'credit',
+        dataset: 110
+    },
+    {
+        key: 'source',
+        dataset: 115
+    },
+    {
+        key: 'copyright',
+        dataset: 116
+    },
+    {
+        key: 'description',
+        dataset: 120
+    }
+];
+const DATE_CREATED = 55;
+const TIME_CREATED = 60;
+/**
+ * Record 2 datasets that are binary, not text, and so are never transcoded:
+ * RecordVersion and the ObjectData preview (IIM 4.2 §6.2, 2:200–2:202).
+ */ const BINARY_DATASETS = new Set([
+    0,
+    200,
+    201,
+    202
+]);
+/** 1:90 = `ESC % G`: UTF-8, ISO 2022 / ISO-IR 196. */ const UTF8_CHARSET = new Uint8Array([
+    0x1b,
+    0x25,
+    0x47
+]);
+/** The 2-byte RecordVersion IIM 4 writes into 1:00 and 2:00. */ const RECORD_VERSION = new Uint8Array([
+    0x00,
+    0x04
+]);
+const IRB_SIGNATURES = new Set([
+    '8BIM',
+    'MeSa',
+    'PHUT',
+    'AgHg',
+    'DCSR'
+]);
+const IPTC_RESOURCE = 0x0404;
+const IPTC_DIGEST_RESOURCE = 0x0425;
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?(Z|[+-]\d{2}:\d{2})?)?$/;
+const utf8Lenient = new TextDecoder('utf-8');
+const encoder = new TextEncoder();
+function concat(parts) {
+    const out = new Uint8Array(parts.reduce((n, part)=>n + part.length, 0));
+    let at = 0;
+    for (const part of parts){
+        out.set(part, at);
+        at += part.length;
+    }
+    return out;
+}
+function sameBytes(a, b) {
+    if (a.length !== b.length) return false;
+    for(let i = 0; i < a.length; i++)if (a[i] !== b[i]) return false;
+    return true;
+}
+function isAscii(text) {
+    for(let i = 0; i < text.length; i++)if (text.charCodeAt(i) > 0x7f) return false;
+    return true;
+}
+/**
+ * Datasets up to the first byte that does not start one. Whatever follows
+ * (padding, a truncated dataset, junk) is `rest`.
+ */ function parseIim(iim) {
+    const datasets = [];
+    let at = 0;
+    while(at + 5 <= iim.length && iim[at] === 0x1c){
+        var _iim_, _iim_1, _iim_2, _iim_3;
+        let size = ((_iim_ = iim[at + 3]) != null ? _iim_ : 0) << 8 | ((_iim_1 = iim[at + 4]) != null ? _iim_1 : 0);
+        let header = 5;
+        if (size & 0x8000) {
+            var _iim_4;
+            // IIM 4.2 §1.5.4: the extended form counts its own length bytes.
+            const bytes = size & 0x7fff;
+            if (bytes < 1 || bytes > 4 || at + 5 + bytes > iim.length) break;
+            size = 0;
+            for(let i = 0; i < bytes; i++)size = size * 256 + ((_iim_4 = iim[at + 5 + i]) != null ? _iim_4 : 0);
+            header += bytes;
+        }
+        if (at + header + size > iim.length) break;
+        datasets.push({
+            record: (_iim_2 = iim[at + 1]) != null ? _iim_2 : 0,
+            dataset: (_iim_3 = iim[at + 2]) != null ? _iim_3 : 0,
+            data: iim.subarray(at + header, at + header + size),
+            raw: iim.subarray(at, at + header + size)
+        });
+        at += header + size;
+    }
+    return {
+        datasets,
+        rest: iim.subarray(at)
+    };
+}
+function encodeDataset(record, dataset, data) {
+    if (data.length <= 0x7fff) {
+        return concat([
+            [
+                0x1c,
+                record,
+                dataset,
+                data.length >> 8,
+                data.length & 0xff
+            ],
+            data
+        ]);
+    }
+    const n = data.length;
+    return concat([
+        [
+            0x1c,
+            record,
+            dataset,
+            0x80,
+            0x04
+        ],
+        [
+            n >>> 24 & 0xff,
+            n >>> 16 & 0xff,
+            n >>> 8 & 0xff,
+            n & 0xff
+        ],
+        data
+    ]);
+}
+/** Whether 1:90 declares UTF-8: `ESC % G`, or ISO 2022's `ESC % / G|H|I`. */ function declaresUtf8(datasets) {
+    var _d_;
+    const charset = datasets.find((d)=>d.record === 1 && d.dataset === 90);
+    const d = charset == null ? void 0 : charset.data;
+    if (!d || d[0] !== 0x1b || d[1] !== 0x25) return false;
+    return d[2] === 0x47 || d[2] === 0x2f && [
+        0x47,
+        0x48,
+        0x49
+    ].includes((_d_ = d[3]) != null ? _d_ : 0);
+}
+function iimEntryText(data, utf8) {
+    const text = utf8 ? utf8Lenient.decode(data) : decodeLegacyText(data);
+    const nul = text.indexOf('\0');
+    return (nul >= 0 ? text.slice(0, nul) : text).trim();
+}
+/**
+ * 2:55 "CCYYMMDD" and 2:60 "HHMMSS±HHMM" as ISO 8601. The zone is kept as
+ * recorded; a time with none (some writers drop it) stays local.
+ */ function iptcDate(date, time) {
+    const d = date ? /^(\d{4})(\d{2})(\d{2})$/.exec(date) : null;
+    if (!d) return null;
+    const [, year, month, day] = d;
+    if (!year || !month || !day || year === '0000') return null;
+    if (+month < 1 || +month > 12 || +day < 1 || +day > 31) return null;
+    const iso = `${year}-${month}-${day}`;
+    const t = time ? /^(\d{2}):?(\d{2}):?(\d{2})(?:([+-])(\d{2}):?(\d{2}))?$/.exec(time) : null;
+    if (!t) return iso;
+    const [, hour, minute, second, sign, zoneHour, zoneMinute] = t;
+    if (+(hour != null ? hour : 99) > 23 || +(minute != null ? minute : 99) > 59 || +(second != null ? second : 99) > 60) {
+        return iso;
+    }
+    const zone = sign ? `${sign}${zoneHour}:${zoneMinute}` : '';
+    return `${iso}T${hour}:${minute}:${second}${zone}`;
+}
+/**
+ * An IIM stream without the zero padding its container added after the
+ * last dataset (a TIFF tag pads to four bytes). Zeros inside a dataset are
+ * data and are kept, as is anything after the datasets that is not zero.
+ */ export function trimIimPadding(iim) {
+    const { rest } = parseIim(iim);
+    return rest.length && rest.every((byte)=>byte === 0) ? iim.subarray(0, iim.length - rest.length) : iim;
+}
+/** Read the mapped record 2 datasets of an IIM stream. Never throws. */ export function readIim(iim) {
+    try {
+        var _texts_, _texts_1;
+        const { datasets } = parseIim(iim);
+        const utf8 = declaresUtf8(datasets);
+        const texts = (dataset)=>datasets.filter((d)=>d.record === 2 && d.dataset === dataset).map((d)=>iimEntryText(d.data, utf8)).filter(Boolean);
+        const out = [];
+        for (const field of FIELDS){
+            const [first, ...more] = texts(field.dataset);
+            if (first === undefined) continue;
+            out.push({
+                key: field.key,
+                value: field.repeatable ? [
+                    ...new Set([
+                        first,
+                        ...more
+                    ])
+                ] : first,
+                source: 'iptc'
+            });
+        }
+        const created = iptcDate((_texts_ = texts(DATE_CREATED)[0]) != null ? _texts_ : null, (_texts_1 = texts(TIME_CREATED)[0]) != null ? _texts_1 : null);
+        if (created) out.push({
+            key: 'createdAt',
+            value: created,
+            source: 'iptc'
+        });
+        return out;
+    } catch (unused) {
+        return [];
+    }
+}
+/** A patch value as the list of dataset values it becomes. */ function iimEntryValues(value, repeatable) {
+    if (value === null) return [];
+    const items = (Array.isArray(value) ? value : [
+        value
+    ]).map((item)=>item.trim()).filter(Boolean);
+    if (repeatable) return [
+        ...new Set(items)
+    ];
+    return items.length ? [
+        items.join(', ')
+    ] : [];
+}
+/** The index of the first dataset that sorts after record:dataset. */ function sortedIndex(list, record, dataset) {
+    const index = list.findIndex((d)=>d.record > record || d.record === record && d.dataset > dataset);
+    return index < 0 ? list.length : index;
+}
+/**
+ * Sync the mapped keys of `patch` into an IIM stream: every key present is
+ * made to hold exactly the patched value(s), `null` removing its datasets.
+ * Datasets this module does not map (2:00 RecordVersion included) keep
+ * their bytes and their order; new ones go where record:dataset order puts
+ * them. Returns `iim` itself when nothing changed.
+ *
+ * Text is written as UTF-8. When a value is not ASCII and 1:90 does not
+ * already say UTF-8, 1:90 is set to `ESC % G` and the other record 2 text
+ * is transcoded from Latin-1 so it does not turn to mojibake under the new
+ * declaration. IIM's per-dataset length limits (64 bytes for a keyword,
+ * 2000 for a caption) are not enforced: every current reader ignores them,
+ * and truncating someone's caption is worse than exceeding a 1999 limit.
+ */ export function writeIim(iim, patch) {
+    const { datasets, rest } = parseIim(iim);
+    const patched = (key)=>Object.prototype.hasOwnProperty.call(patch, key) && patch[key] !== undefined;
+    const edits = new Map();
+    for (const field of FIELDS){
+        const value = patch[field.key];
+        if (patched(field.key) && value !== undefined) {
+            edits.set(field.dataset, iimEntryValues(value, Boolean(field.repeatable)));
+        }
+    }
+    if (patched('createdAt')) {
+        const value = patch['createdAt'];
+        const iso = typeof value === 'string' ? ISO_DATE.exec(value.trim()) : null;
+        if (value === null) {
+            edits.set(DATE_CREATED, []);
+            edits.set(TIME_CREATED, []);
+        } else if (iso) {
+            var _ref;
+            const [, year, month, day, hour, minute, second, zone] = iso;
+            edits.set(DATE_CREATED, [
+                `${year}${month}${day}`
+            ]);
+            // No zone recorded, none invented: the time is written without one.
+            const offset = zone === 'Z' ? '+0000' : (_ref = zone == null ? void 0 : zone.replace(':', '')) != null ? _ref : '';
+            edits.set(TIME_CREATED, hour ? [
+                `${hour}${minute}${second != null ? second : '00'}${offset}`
+            ] : []);
+        }
+    }
+    if (!edits.size) return iim;
+    let list = datasets.slice();
+    const values = [
+        ...edits.values()
+    ].flat();
+    if (!declaresUtf8(list) && values.some((v)=>!isAscii(v))) {
+        list = list.map((d)=>d.record === 2 && !BINARY_DATASETS.has(d.dataset) && !edits.has(d.dataset) && !isUtf8(d.data) ? _extends({}, d, {
+                data: encoder.encode(decodeLegacyText(d.data)),
+                raw: null
+            }) : d);
+        const charset = {
+            record: 1,
+            dataset: 90,
+            data: UTF8_CHARSET,
+            raw: null
+        };
+        const existing = list.findIndex((d)=>d.record === 1 && d.dataset === 90);
+        if (existing >= 0) {
+            list[existing] = charset;
+        } else {
+            if (!list.some((d)=>d.record === 1)) {
+                // IIM 4.2 §5: 1:00 ModelVersion is mandatory in the envelope.
+                list.splice(sortedIndex(list, 1, 0), 0, {
+                    record: 1,
+                    dataset: 0,
+                    data: RECORD_VERSION,
+                    raw: null
+                });
+            }
+            list.splice(sortedIndex(list, 1, 90), 0, charset);
+        }
+    }
+    for (const [dataset, texts] of [
+        ...edits
+    ].sort((a, b)=>a[0] - b[0])){
+        const first = list.findIndex((d)=>d.record === 2 && d.dataset === dataset);
+        const kept = list.filter((d)=>!(d.record === 2 && d.dataset === dataset));
+        const fresh = texts.map((text)=>({
+                record: 2,
+                dataset,
+                data: encoder.encode(text),
+                raw: null
+            }));
+        kept.splice(first >= 0 ? first : sortedIndex(kept, 2, dataset), 0, ...fresh);
+        list = kept;
+    }
+    if (values.length && !list.some((d)=>d.record === 2 && d.dataset === 0)) {
+        // IIM 4.2 §6: 2:00 RecordVersion is mandatory in the application record.
+        list.splice(sortedIndex(list, 2, 0), 0, {
+            record: 2,
+            dataset: 0,
+            data: RECORD_VERSION,
+            raw: null
+        });
+    }
+    // Zero padding after the last dataset is dropped (a container pads again
+    // as it needs to); anything else there is kept as found.
+    const tail = rest.some((byte)=>byte !== 0) ? rest : new Uint8Array();
+    const out = concat([
+        ...list.map((d)=>{
+            var _d_raw;
+            return (_d_raw = d.raw) != null ? _d_raw : encodeDataset(d.record, d.dataset, d.data);
+        }),
+        tail
+    ]);
+    return sameBytes(out, iim) ? iim : out;
+}
+function parseIrb(irb) {
+    const resources = [];
+    let at = 0;
+    while(at + 12 <= irb.length){
+        var _irb_, _irb_nameEnd, _irb_1, _irb_2, _irb_3, _irb_4, _irb_5;
+        const signature = String.fromCharCode(...irb.subarray(at, at + 4));
+        if (!IRB_SIGNATURES.has(signature)) break;
+        const nameLength = (_irb_ = irb[at + 6]) != null ? _irb_ : 0;
+        const nameEnd = at + 6 + (nameLength + 2 & ~1);
+        if (nameEnd + 4 > irb.length) break;
+        const size = ((_irb_nameEnd = irb[nameEnd]) != null ? _irb_nameEnd : 0) * 0x1000000 + (((_irb_1 = irb[nameEnd + 1]) != null ? _irb_1 : 0) << 16 | ((_irb_2 = irb[nameEnd + 2]) != null ? _irb_2 : 0) << 8 | ((_irb_3 = irb[nameEnd + 3]) != null ? _irb_3 : 0));
+        const dataAt = nameEnd + 4;
+        if (dataAt + size > irb.length) break;
+        const end = Math.min(dataAt + size + size % 2, irb.length);
+        resources.push({
+            signature,
+            id: ((_irb_4 = irb[at + 4]) != null ? _irb_4 : 0) << 8 | ((_irb_5 = irb[at + 5]) != null ? _irb_5 : 0),
+            name: irb.subarray(at + 6, nameEnd),
+            data: irb.subarray(dataAt, dataAt + size),
+            raw: irb.subarray(at, end)
+        });
+        at = end;
+    }
+    return {
+        resources,
+        rest: irb.subarray(at)
+    };
+}
+function encodeResource(resource, data) {
+    const n = data.length;
+    return concat([
+        [
+            ...resource.signature
+        ].map((c)=>c.charCodeAt(0)),
+        [
+            resource.id >> 8,
+            resource.id & 0xff
+        ],
+        resource.name,
+        [
+            n >>> 24 & 0xff,
+            n >>> 16 & 0xff,
+            n >>> 8 & 0xff,
+            n & 0xff
+        ],
+        data,
+        n % 2 ? [
+            0
+        ] : []
+    ]);
+}
+const isIptcResource = (r)=>r.signature === '8BIM' && r.id === IPTC_RESOURCE;
+/** The IIM held in an image resource block (resource 0x0404), or null. */ export function irbIim(irb) {
+    try {
+        var _ref;
+        var _parseIrb_resources_find;
+        return (_ref = (_parseIrb_resources_find = parseIrb(irb).resources.find(isIptcResource)) == null ? void 0 : _parseIrb_resources_find.data) != null ? _ref : null;
+    } catch (unused) {
+        return null;
+    }
+}
+/** Whether an image resource block holds IPTC (resource 0x0404). */ export function irbHasIptc(irb) {
+    return irbIim(irb) !== null;
+}
+/** Read the IPTC of an image resource block. Never throws. */ export function readIrbIptc(irb) {
+    const iim = irbIim(irb);
+    return iim ? readIim(iim) : [];
+}
+/**
+ * Put `iim` in resource 0x0404, or take the resource out when `iim` is
+ * null, and bring the 0x0425 digest in step (set to the new IIM's MD5, or
+ * removed with it). A block without 0x0404 gets one at the end. Every other
+ * resource, and anything after the last one, is copied byte for byte.
+ */ export function replaceIrbIim(irb, iim) {
+    const { resources, rest } = parseIrb(irb);
+    const digest = iim ? new Uint8Array(createHash('md5').update(iim).digest()) : null;
+    const parts = [];
+    let replaced = false;
+    for (const resource of resources){
+        if (isIptcResource(resource) && !replaced) {
+            replaced = true;
+            if (iim) parts.push(encodeResource(resource, iim));
+        } else if (resource.signature === '8BIM' && resource.id === IPTC_DIGEST_RESOURCE) {
+            if (digest) parts.push(encodeResource(resource, digest));
+        } else {
+            parts.push(resource.raw);
+        }
+    }
+    if (!replaced && iim) {
+        parts.push(encodeResource({
+            signature: '8BIM',
+            id: IPTC_RESOURCE,
+            name: new Uint8Array(2)
+        }, iim));
+    }
+    const out = concat([
+        ...parts,
+        rest
+    ]);
+    return sameBytes(out, irb) ? irb : out;
+}
+/**
+ * Write a patch into the IPTC of an image resource block. A block without
+ * IPTC is returned as is: new values go to XMP, never into a new IIM (the
+ * Metadata Working Group's rule).
+ */ export function writeIrbIptc(irb, patch) {
+    const iim = irbIim(irb);
+    if (!iim) return irb;
+    const next = writeIim(iim, patch);
+    return next === iim ? irb : replaceIrbIim(irb, next);
+}
+
+//# sourceMappingURL=iptc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/aglyn/src/lib/app-utils/media-embedded-metadata/iptc.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 * IPTC IIM, and the Photoshop image resource block that carries it\n * (AGL-3331).\n *\n * ## IIM\n *\n * The IPTC Information Interchange Model (IIM 4.2) is a flat run of\n * datasets: `0x1C`, record, dataset, a 2-byte big-endian length, the data.\n * A length with its top bit set is the extended form (§1.5.4): the low 15\n * bits count the length bytes that follow. Record 2 is the \"application\n * record\" every photo tool writes; record 1:90 names the character set, and\n * `ESC % G` (ISO 2022) there means UTF-8. Without it the text is whatever\n * the writer used, so each value decodes as UTF-8 when it is valid UTF-8\n * and as Latin-1 otherwise.\n *\n * ## Photoshop image resources (IRB)\n *\n * In a JPEG (APP13 after `Photoshop 3.0\\0`), a TIFF (tag 34377) and a PSD,\n * IIM travels inside an image resource block: a run of resources, each\n * `8BIM`, a 2-byte id, a Pascal name padded to even, a 4-byte size and the\n * data padded to even (Photoshop File Formats §\"Image Resource Blocks\").\n * Resource 0x0404 holds the IIM and 0x0425 its MD5, which Photoshop and the\n * Metadata Working Group use to notice IPTC edited behind their back, so\n * the digest is kept in step with every write.\n *\n * ## Writing\n *\n * {@link writeIim} syncs every mapped key in the patch — adding, replacing\n * or removing datasets, a list as one dataset per item — and leaves every\n * other dataset byte-identical and where it was. {@link writeIrbIptc}\n * rewrites 0x0404 (and 0x0425) and copies every other resource through\n * byte for byte, in order.\n */\n\nimport { createHash } from 'crypto'\n\nimport { decodeLegacyText, isUtf8 } from './exif'\nimport type { EmbeddedCandidate, EmbeddedPatch } from './types'\n\n/** The record 2 datasets this module maps, IIM 4.2 §6. */\nconst FIELDS: ReadonlyArray<{\n  key: string\n  dataset: number\n  repeatable?: boolean\n}> = [\n  { key: 'title', dataset: 5 }, // Object Name\n  { key: 'keywords', dataset: 25, repeatable: true },\n  { key: 'instructions', dataset: 40 }, // Special Instructions\n  { key: 'creator', dataset: 80, repeatable: true }, // By-line\n  { key: 'city', dataset: 90 },\n  { key: 'state', dataset: 95 }, // Province/State\n  { key: 'country', dataset: 101 }, // Country/Primary Location Name\n  { key: 'headline', dataset: 105 },\n  { key: 'credit', dataset: 110 },\n  { key: 'source', dataset: 115 },\n  { key: 'copyright', dataset: 116 }, // Copyright Notice\n  { key: 'description', dataset: 120 }, // Caption/Abstract\n]\n\nconst DATE_CREATED = 55\nconst TIME_CREATED = 60\n\n/**\n * Record 2 datasets that are binary, not text, and so are never transcoded:\n * RecordVersion and the ObjectData preview (IIM 4.2 §6.2, 2:200–2:202).\n */\nconst BINARY_DATASETS: ReadonlySet<number> = new Set([0, 200, 201, 202])\n\n/** 1:90 = `ESC % G`: UTF-8, ISO 2022 / ISO-IR 196. */\nconst UTF8_CHARSET = new Uint8Array([0x1b, 0x25, 0x47])\n\n/** The 2-byte RecordVersion IIM 4 writes into 1:00 and 2:00. */\nconst RECORD_VERSION = new Uint8Array([0x00, 0x04])\n\nconst IRB_SIGNATURES: ReadonlySet<string> = new Set([\n  '8BIM',\n  'MeSa',\n  'PHUT',\n  'AgHg',\n  'DCSR',\n])\nconst IPTC_RESOURCE = 0x0404\nconst IPTC_DIGEST_RESOURCE = 0x0425\n\nconst ISO_DATE =\n  /^(\\d{4})-(\\d{2})-(\\d{2})(?:T(\\d{2}):(\\d{2})(?::(\\d{2})(?:\\.\\d+)?)?(Z|[+-]\\d{2}:\\d{2})?)?$/\n\nconst utf8Lenient = new TextDecoder('utf-8')\nconst encoder = new TextEncoder()\n\ninterface IimEntry {\n  record: number\n  dataset: number\n  data: Uint8Array\n  /** The dataset exactly as stored, header included; null when new. */\n  raw: Uint8Array | null\n}\n\nfunction concat(parts: ArrayLike<number>[]): Uint8Array {\n  const out = new Uint8Array(parts.reduce((n, part) => n + part.length, 0))\n  let at = 0\n  for (const part of parts) {\n    out.set(part, at)\n    at += part.length\n  }\n  return out\n}\n\nfunction sameBytes(a: Uint8Array, b: Uint8Array): boolean {\n  if (a.length !== b.length) return false\n  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false\n  return true\n}\n\nfunction isAscii(text: string): boolean {\n  for (let i = 0; i < text.length; i++)\n    if (text.charCodeAt(i) > 0x7f) return false\n  return true\n}\n\n/**\n * Datasets up to the first byte that does not start one. Whatever follows\n * (padding, a truncated dataset, junk) is `rest`.\n */\nfunction parseIim(iim: Uint8Array): { datasets: IimEntry[]; rest: Uint8Array } {\n  const datasets: IimEntry[] = []\n  let at = 0\n  while (at + 5 <= iim.length && iim[at] === 0x1c) {\n    let size = ((iim[at + 3] ?? 0) << 8) | (iim[at + 4] ?? 0)\n    let header = 5\n    if (size & 0x8000) {\n      // IIM 4.2 §1.5.4: the extended form counts its own length bytes.\n      const bytes = size & 0x7fff\n      if (bytes < 1 || bytes > 4 || at + 5 + bytes > iim.length) break\n      size = 0\n      for (let i = 0; i < bytes; i++) size = size * 256 + (iim[at + 5 + i] ?? 0)\n      header += bytes\n    }\n    if (at + header + size > iim.length) break\n    datasets.push({\n      record: iim[at + 1] ?? 0,\n      dataset: iim[at + 2] ?? 0,\n      data: iim.subarray(at + header, at + header + size),\n      raw: iim.subarray(at, at + header + size),\n    })\n    at += header + size\n  }\n  return { datasets, rest: iim.subarray(at) }\n}\n\nfunction encodeDataset(record: number, dataset: number, data: Uint8Array) {\n  if (data.length <= 0x7fff) {\n    return concat([\n      [0x1c, record, dataset, data.length >> 8, data.length & 0xff],\n      data,\n    ])\n  }\n  const n = data.length\n  return concat([\n    [0x1c, record, dataset, 0x80, 0x04],\n    [(n >>> 24) & 0xff, (n >>> 16) & 0xff, (n >>> 8) & 0xff, n & 0xff],\n    data,\n  ])\n}\n\n/** Whether 1:90 declares UTF-8: `ESC % G`, or ISO 2022's `ESC % / G|H|I`. */\nfunction declaresUtf8(datasets: readonly IimEntry[]): boolean {\n  const charset = datasets.find((d) => d.record === 1 && d.dataset === 90)\n  const d = charset?.data\n  if (!d || d[0] !== 0x1b || d[1] !== 0x25) return false\n  return (\n    d[2] === 0x47 || (d[2] === 0x2f && [0x47, 0x48, 0x49].includes(d[3] ?? 0))\n  )\n}\n\nfunction iimEntryText(data: Uint8Array, utf8: boolean): string {\n  const text = utf8 ? utf8Lenient.decode(data) : decodeLegacyText(data)\n  const nul = text.indexOf('\\0')\n  return (nul >= 0 ? text.slice(0, nul) : text).trim()\n}\n\n/**\n * 2:55 \"CCYYMMDD\" and 2:60 \"HHMMSS±HHMM\" as ISO 8601. The zone is kept as\n * recorded; a time with none (some writers drop it) stays local.\n */\nfunction iptcDate(date: string | null, time: string | null): string | null {\n  const d = date ? /^(\\d{4})(\\d{2})(\\d{2})$/.exec(date) : null\n  if (!d) return null\n  const [, year, month, day] = d\n  if (!year || !month || !day || year === '0000') return null\n  if (+month < 1 || +month > 12 || +day < 1 || +day > 31) return null\n  const iso = `${year}-${month}-${day}`\n  const t = time\n    ? /^(\\d{2}):?(\\d{2}):?(\\d{2})(?:([+-])(\\d{2}):?(\\d{2}))?$/.exec(time)\n    : null\n  if (!t) return iso\n  const [, hour, minute, second, sign, zoneHour, zoneMinute] = t\n  if (+(hour ?? 99) > 23 || +(minute ?? 99) > 59 || +(second ?? 99) > 60) {\n    return iso\n  }\n  const zone = sign ? `${sign}${zoneHour}:${zoneMinute}` : ''\n  return `${iso}T${hour}:${minute}:${second}${zone}`\n}\n\n/**\n * An IIM stream without the zero padding its container added after the\n * last dataset (a TIFF tag pads to four bytes). Zeros inside a dataset are\n * data and are kept, as is anything after the datasets that is not zero.\n */\nexport function trimIimPadding(iim: Uint8Array): Uint8Array {\n  const { rest } = parseIim(iim)\n  return rest.length && rest.every((byte) => byte === 0)\n    ? iim.subarray(0, iim.length - rest.length)\n    : iim\n}\n\n/** Read the mapped record 2 datasets of an IIM stream. Never throws. */\nexport function readIim(iim: Uint8Array): EmbeddedCandidate[] {\n  try {\n    const { datasets } = parseIim(iim)\n    const utf8 = declaresUtf8(datasets)\n    const texts = (dataset: number) =>\n      datasets\n        .filter((d) => d.record === 2 && d.dataset === dataset)\n        .map((d) => iimEntryText(d.data, utf8))\n        .filter(Boolean)\n    const out: EmbeddedCandidate[] = []\n    for (const field of FIELDS) {\n      const [first, ...more] = texts(field.dataset)\n      if (first === undefined) continue\n      out.push({\n        key: field.key,\n        value: field.repeatable ? [...new Set([first, ...more])] : first,\n        source: 'iptc',\n      })\n    }\n    const created = iptcDate(\n      texts(DATE_CREATED)[0] ?? null,\n      texts(TIME_CREATED)[0] ?? null,\n    )\n    if (created) out.push({ key: 'createdAt', value: created, source: 'iptc' })\n    return out\n  } catch {\n    return []\n  }\n}\n\n/** A patch value as the list of dataset values it becomes. */\nfunction iimEntryValues(\n  value: string | string[] | null,\n  repeatable: boolean,\n): string[] {\n  if (value === null) return []\n  const items = (Array.isArray(value) ? value : [value])\n    .map((item) => item.trim())\n    .filter(Boolean)\n  if (repeatable) return [...new Set(items)]\n  return items.length ? [items.join(', ')] : []\n}\n\n/** The index of the first dataset that sorts after record:dataset. */\nfunction sortedIndex(\n  list: readonly IimEntry[],\n  record: number,\n  dataset: number,\n) {\n  const index = list.findIndex(\n    (d) => d.record > record || (d.record === record && d.dataset > dataset),\n  )\n  return index < 0 ? list.length : index\n}\n\n/**\n * Sync the mapped keys of `patch` into an IIM stream: every key present is\n * made to hold exactly the patched value(s), `null` removing its datasets.\n * Datasets this module does not map (2:00 RecordVersion included) keep\n * their bytes and their order; new ones go where record:dataset order puts\n * them. Returns `iim` itself when nothing changed.\n *\n * Text is written as UTF-8. When a value is not ASCII and 1:90 does not\n * already say UTF-8, 1:90 is set to `ESC % G` and the other record 2 text\n * is transcoded from Latin-1 so it does not turn to mojibake under the new\n * declaration. IIM's per-dataset length limits (64 bytes for a keyword,\n * 2000 for a caption) are not enforced: every current reader ignores them,\n * and truncating someone's caption is worse than exceeding a 1999 limit.\n */\nexport function writeIim(iim: Uint8Array, patch: EmbeddedPatch): Uint8Array {\n  const { datasets, rest } = parseIim(iim)\n  const patched = (key: string) =>\n    Object.prototype.hasOwnProperty.call(patch, key) && patch[key] !== undefined\n  const edits = new Map<number, string[]>()\n  for (const field of FIELDS) {\n    const value = patch[field.key]\n    if (patched(field.key) && value !== undefined) {\n      edits.set(field.dataset, iimEntryValues(value, Boolean(field.repeatable)))\n    }\n  }\n  if (patched('createdAt')) {\n    const value = patch['createdAt']\n    const iso = typeof value === 'string' ? ISO_DATE.exec(value.trim()) : null\n    if (value === null) {\n      edits.set(DATE_CREATED, [])\n      edits.set(TIME_CREATED, [])\n    } else if (iso) {\n      const [, year, month, day, hour, minute, second, zone] = iso\n      edits.set(DATE_CREATED, [`${year}${month}${day}`])\n      // No zone recorded, none invented: the time is written without one.\n      const offset = zone === 'Z' ? '+0000' : (zone?.replace(':', '') ?? '')\n      edits.set(\n        TIME_CREATED,\n        hour ? [`${hour}${minute}${second ?? '00'}${offset}`] : [],\n      )\n    }\n  }\n  if (!edits.size) return iim\n\n  let list = datasets.slice()\n  const values = [...edits.values()].flat()\n  if (!declaresUtf8(list) && values.some((v) => !isAscii(v))) {\n    list = list.map((d) =>\n      d.record === 2 &&\n      !BINARY_DATASETS.has(d.dataset) &&\n      !edits.has(d.dataset) &&\n      !isUtf8(d.data)\n        ? { ...d, data: encoder.encode(decodeLegacyText(d.data)), raw: null }\n        : d,\n    )\n    const charset: IimEntry = {\n      record: 1,\n      dataset: 90,\n      data: UTF8_CHARSET,\n      raw: null,\n    }\n    const existing = list.findIndex((d) => d.record === 1 && d.dataset === 90)\n    if (existing >= 0) {\n      list[existing] = charset\n    } else {\n      if (!list.some((d) => d.record === 1)) {\n        // IIM 4.2 §5: 1:00 ModelVersion is mandatory in the envelope.\n        list.splice(sortedIndex(list, 1, 0), 0, {\n          record: 1,\n          dataset: 0,\n          data: RECORD_VERSION,\n          raw: null,\n        })\n      }\n      list.splice(sortedIndex(list, 1, 90), 0, charset)\n    }\n  }\n\n  for (const [dataset, texts] of [...edits].sort((a, b) => a[0] - b[0])) {\n    const first = list.findIndex((d) => d.record === 2 && d.dataset === dataset)\n    const kept = list.filter((d) => !(d.record === 2 && d.dataset === dataset))\n    const fresh = texts.map((text): IimEntry => ({\n      record: 2,\n      dataset,\n      data: encoder.encode(text),\n      raw: null,\n    }))\n    kept.splice(first >= 0 ? first : sortedIndex(kept, 2, dataset), 0, ...fresh)\n    list = kept\n  }\n  if (values.length && !list.some((d) => d.record === 2 && d.dataset === 0)) {\n    // IIM 4.2 §6: 2:00 RecordVersion is mandatory in the application record.\n    list.splice(sortedIndex(list, 2, 0), 0, {\n      record: 2,\n      dataset: 0,\n      data: RECORD_VERSION,\n      raw: null,\n    })\n  }\n\n  // Zero padding after the last dataset is dropped (a container pads again\n  // as it needs to); anything else there is kept as found.\n  const tail = rest.some((byte) => byte !== 0) ? rest : new Uint8Array()\n  const out = concat([\n    ...list.map((d) => d.raw ?? encodeDataset(d.record, d.dataset, d.data)),\n    tail,\n  ])\n  return sameBytes(out, iim) ? iim : out\n}\n\n// ---------------------------------------------------------------------------\n// Photoshop image resources\n// ---------------------------------------------------------------------------\n\ninterface Resource {\n  signature: string\n  id: number\n  /** The Pascal name as stored: length byte, text, pad to even. */\n  name: Uint8Array\n  data: Uint8Array\n  /** The whole resource as stored, padding included. */\n  raw: Uint8Array\n}\n\nfunction parseIrb(irb: Uint8Array): {\n  resources: Resource[]\n  rest: Uint8Array\n} {\n  const resources: Resource[] = []\n  let at = 0\n  while (at + 12 <= irb.length) {\n    const signature = String.fromCharCode(...irb.subarray(at, at + 4))\n    if (!IRB_SIGNATURES.has(signature)) break\n    const nameLength = irb[at + 6] ?? 0\n    const nameEnd = at + 6 + ((nameLength + 2) & ~1)\n    if (nameEnd + 4 > irb.length) break\n    const size =\n      (irb[nameEnd] ?? 0) * 0x1000000 +\n      (((irb[nameEnd + 1] ?? 0) << 16) |\n        ((irb[nameEnd + 2] ?? 0) << 8) |\n        (irb[nameEnd + 3] ?? 0))\n    const dataAt = nameEnd + 4\n    if (dataAt + size > irb.length) break\n    const end = Math.min(dataAt + size + (size % 2), irb.length)\n    resources.push({\n      signature,\n      id: ((irb[at + 4] ?? 0) << 8) | (irb[at + 5] ?? 0),\n      name: irb.subarray(at + 6, nameEnd),\n      data: irb.subarray(dataAt, dataAt + size),\n      raw: irb.subarray(at, end),\n    })\n    at = end\n  }\n  return { resources, rest: irb.subarray(at) }\n}\n\nfunction encodeResource(\n  resource: Pick<Resource, 'signature' | 'id' | 'name'>,\n  data: Uint8Array,\n): Uint8Array {\n  const n = data.length\n  return concat([\n    [...resource.signature].map((c) => c.charCodeAt(0)),\n    [resource.id >> 8, resource.id & 0xff],\n    resource.name,\n    [(n >>> 24) & 0xff, (n >>> 16) & 0xff, (n >>> 8) & 0xff, n & 0xff],\n    data,\n    n % 2 ? [0] : [],\n  ])\n}\n\nconst isIptcResource = (r: Resource) =>\n  r.signature === '8BIM' && r.id === IPTC_RESOURCE\n\n/** The IIM held in an image resource block (resource 0x0404), or null. */\nexport function irbIim(irb: Uint8Array): Uint8Array | null {\n  try {\n    return parseIrb(irb).resources.find(isIptcResource)?.data ?? null\n  } catch {\n    return null\n  }\n}\n\n/** Whether an image resource block holds IPTC (resource 0x0404). */\nexport function irbHasIptc(irb: Uint8Array): boolean {\n  return irbIim(irb) !== null\n}\n\n/** Read the IPTC of an image resource block. Never throws. */\nexport function readIrbIptc(irb: Uint8Array): EmbeddedCandidate[] {\n  const iim = irbIim(irb)\n  return iim ? readIim(iim) : []\n}\n\n/**\n * Put `iim` in resource 0x0404, or take the resource out when `iim` is\n * null, and bring the 0x0425 digest in step (set to the new IIM's MD5, or\n * removed with it). A block without 0x0404 gets one at the end. Every other\n * resource, and anything after the last one, is copied byte for byte.\n */\nexport function replaceIrbIim(\n  irb: Uint8Array,\n  iim: Uint8Array | null,\n): Uint8Array {\n  const { resources, rest } = parseIrb(irb)\n  const digest = iim\n    ? new Uint8Array(createHash('md5').update(iim).digest())\n    : null\n  const parts: Uint8Array[] = []\n  let replaced = false\n  for (const resource of resources) {\n    if (isIptcResource(resource) && !replaced) {\n      replaced = true\n      if (iim) parts.push(encodeResource(resource, iim))\n    } else if (\n      resource.signature === '8BIM' &&\n      resource.id === IPTC_DIGEST_RESOURCE\n    ) {\n      if (digest) parts.push(encodeResource(resource, digest))\n    } else {\n      parts.push(resource.raw)\n    }\n  }\n  if (!replaced && iim) {\n    parts.push(\n      encodeResource(\n        { signature: '8BIM', id: IPTC_RESOURCE, name: new Uint8Array(2) },\n        iim,\n      ),\n    )\n  }\n  const out = concat([...parts, rest])\n  return sameBytes(out, irb) ? irb : out\n}\n\n/**\n * Write a patch into the IPTC of an image resource block. A block without\n * IPTC is returned as is: new values go to XMP, never into a new IIM (the\n * Metadata Working Group's rule).\n */\nexport function writeIrbIptc(\n  irb: Uint8Array,\n  patch: EmbeddedPatch,\n): Uint8Array {\n  const iim = irbIim(irb)\n  if (!iim) return irb\n  const next = writeIim(iim, patch)\n  return next === iim ? irb : replaceIrbIim(irb, next)\n}\n"],"names":["createHash","decodeLegacyText","isUtf8","FIELDS","key","dataset","repeatable","DATE_CREATED","TIME_CREATED","BINARY_DATASETS","Set","UTF8_CHARSET","Uint8Array","RECORD_VERSION","IRB_SIGNATURES","IPTC_RESOURCE","IPTC_DIGEST_RESOURCE","ISO_DATE","utf8Lenient","TextDecoder","encoder","TextEncoder","concat","parts","out","reduce","n","part","length","at","set","sameBytes","a","b","i","isAscii","text","charCodeAt","parseIim","iim","datasets","size","header","bytes","push","record","data","subarray","raw","rest","encodeDataset","declaresUtf8","d","charset","find","includes","iimEntryText","utf8","decode","nul","indexOf","slice","trim","iptcDate","date","time","exec","year","month","day","iso","t","hour","minute","second","sign","zoneHour","zoneMinute","zone","trimIimPadding","every","byte","readIim","texts","filter","map","Boolean","field","first","more","undefined","value","source","created","iimEntryValues","items","Array","isArray","item","join","sortedIndex","list","index","findIndex","writeIim","patch","patched","Object","prototype","hasOwnProperty","call","edits","Map","offset","replace","values","flat","some","v","has","encode","existing","splice","sort","kept","fresh","tail","parseIrb","irb","resources","signature","String","fromCharCode","nameLength","nameEnd","dataAt","end","Math","min","id","name","encodeResource","resource","c","isIptcResource","r","irbIim","irbHasIptc","readIrbIptc","replaceIrbIim","digest","update","replaced","writeIrbIptc","next"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCC,GAED,SAASA,UAAU,QAAQ,SAAQ;AAEnC,SAASC,gBAAgB,EAAEC,MAAM,QAAQ,YAAQ;AAGjD,wDAAwD,GACxD,MAAMC,SAID;IACH;QAAEC,KAAK;QAASC,SAAS;IAAE;IAC3B;QAAED,KAAK;QAAYC,SAAS;QAAIC,YAAY;IAAK;IACjD;QAAEF,KAAK;QAAgBC,SAAS;IAAG;IACnC;QAAED,KAAK;QAAWC,SAAS;QAAIC,YAAY;IAAK;IAChD;QAAEF,KAAK;QAAQC,SAAS;IAAG;IAC3B;QAAED,KAAK;QAASC,SAAS;IAAG;IAC5B;QAAED,KAAK;QAAWC,SAAS;IAAI;IAC/B;QAAED,KAAK;QAAYC,SAAS;IAAI;IAChC;QAAED,KAAK;QAAUC,SAAS;IAAI;IAC9B;QAAED,KAAK;QAAUC,SAAS;IAAI;IAC9B;QAAED,KAAK;QAAaC,SAAS;IAAI;IACjC;QAAED,KAAK;QAAeC,SAAS;IAAI;CACpC;AAED,MAAME,eAAe;AACrB,MAAMC,eAAe;AAErB;;;CAGC,GACD,MAAMC,kBAAuC,IAAIC,IAAI;IAAC;IAAG;IAAK;IAAK;CAAI;AAEvE,oDAAoD,GACpD,MAAMC,eAAe,IAAIC,WAAW;IAAC;IAAM;IAAM;CAAK;AAEtD,8DAA8D,GAC9D,MAAMC,iBAAiB,IAAID,WAAW;IAAC;IAAM;CAAK;AAElD,MAAME,iBAAsC,IAAIJ,IAAI;IAClD;IACA;IACA;IACA;IACA;CACD;AACD,MAAMK,gBAAgB;AACtB,MAAMC,uBAAuB;AAE7B,MAAMC,WACJ;AAEF,MAAMC,cAAc,IAAIC,YAAY;AACpC,MAAMC,UAAU,IAAIC;AAUpB,SAASC,OAAOC,KAA0B;IACxC,MAAMC,MAAM,IAAIZ,WAAWW,MAAME,MAAM,CAAC,CAACC,GAAGC,OAASD,IAAIC,KAAKC,MAAM,EAAE;IACtE,IAAIC,KAAK;IACT,KAAK,MAAMF,QAAQJ,MAAO;QACxBC,IAAIM,GAAG,CAACH,MAAME;QACdA,MAAMF,KAAKC,MAAM;IACnB;IACA,OAAOJ;AACT;AAEA,SAASO,UAAUC,CAAa,EAAEC,CAAa;IAC7C,IAAID,EAAEJ,MAAM,KAAKK,EAAEL,MAAM,EAAE,OAAO;IAClC,IAAK,IAAIM,IAAI,GAAGA,IAAIF,EAAEJ,MAAM,EAAEM,IAAK,IAAIF,CAAC,CAACE,EAAE,KAAKD,CAAC,CAACC,EAAE,EAAE,OAAO;IAC7D,OAAO;AACT;AAEA,SAASC,QAAQC,IAAY;IAC3B,IAAK,IAAIF,IAAI,GAAGA,IAAIE,KAAKR,MAAM,EAAEM,IAC/B,IAAIE,KAAKC,UAAU,CAACH,KAAK,MAAM,OAAO;IACxC,OAAO;AACT;AAEA;;;CAGC,GACD,SAASI,SAASC,GAAe;IAC/B,MAAMC,WAAuB,EAAE;IAC/B,IAAIX,KAAK;IACT,MAAOA,KAAK,KAAKU,IAAIX,MAAM,IAAIW,GAAG,CAACV,GAAG,KAAK,KAAM;YAClCU,OAA2BA,QAY9BA,QACCA;QAbX,IAAIE,OAAO,EAAEF,QAAAA,GAAG,CAACV,KAAK,EAAE,YAAXU,QAAe,MAAM,MAAMA,SAAAA,GAAG,CAACV,KAAK,EAAE,YAAXU,SAAe;QACvD,IAAIG,SAAS;QACb,IAAID,OAAO,QAAQ;gBAKoCF;YAJrD,iEAAiE;YACjE,MAAMI,QAAQF,OAAO;YACrB,IAAIE,QAAQ,KAAKA,QAAQ,KAAKd,KAAK,IAAIc,QAAQJ,IAAIX,MAAM,EAAE;YAC3Da,OAAO;YACP,IAAK,IAAIP,IAAI,GAAGA,IAAIS,OAAOT,IAAKO,OAAOA,OAAO,QAAOF,SAAAA,GAAG,CAACV,KAAK,IAAIK,EAAE,YAAfK,SAAmB;YACxEG,UAAUC;QACZ;QACA,IAAId,KAAKa,SAASD,OAAOF,IAAIX,MAAM,EAAE;QACrCY,SAASI,IAAI,CAAC;YACZC,MAAM,GAAEN,SAAAA,GAAG,CAACV,KAAK,EAAE,YAAXU,SAAe;YACvBlC,OAAO,GAAEkC,SAAAA,GAAG,CAACV,KAAK,EAAE,YAAXU,SAAe;YACxBO,MAAMP,IAAIQ,QAAQ,CAAClB,KAAKa,QAAQb,KAAKa,SAASD;YAC9CO,KAAKT,IAAIQ,QAAQ,CAAClB,IAAIA,KAAKa,SAASD;QACtC;QACAZ,MAAMa,SAASD;IACjB;IACA,OAAO;QAAED;QAAUS,MAAMV,IAAIQ,QAAQ,CAAClB;IAAI;AAC5C;AAEA,SAASqB,cAAcL,MAAc,EAAExC,OAAe,EAAEyC,IAAgB;IACtE,IAAIA,KAAKlB,MAAM,IAAI,QAAQ;QACzB,OAAON,OAAO;YACZ;gBAAC;gBAAMuB;gBAAQxC;gBAASyC,KAAKlB,MAAM,IAAI;gBAAGkB,KAAKlB,MAAM,GAAG;aAAK;YAC7DkB;SACD;IACH;IACA,MAAMpB,IAAIoB,KAAKlB,MAAM;IACrB,OAAON,OAAO;QACZ;YAAC;YAAMuB;YAAQxC;YAAS;YAAM;SAAK;QACnC;YAAEqB,MAAM,KAAM;YAAOA,MAAM,KAAM;YAAOA,MAAM,IAAK;YAAMA,IAAI;SAAK;QAClEoB;KACD;AACH;AAEA,2EAA2E,GAC3E,SAASK,aAAaX,QAA6B;QAKgBY;IAJjE,MAAMC,UAAUb,SAASc,IAAI,CAAC,CAACF,IAAMA,EAAEP,MAAM,KAAK,KAAKO,EAAE/C,OAAO,KAAK;IACrE,MAAM+C,IAAIC,2BAAAA,QAASP,IAAI;IACvB,IAAI,CAACM,KAAKA,CAAC,CAAC,EAAE,KAAK,QAAQA,CAAC,CAAC,EAAE,KAAK,MAAM,OAAO;IACjD,OACEA,CAAC,CAAC,EAAE,KAAK,QAASA,CAAC,CAAC,EAAE,KAAK,QAAQ;QAAC;QAAM;QAAM;KAAK,CAACG,QAAQ,EAACH,MAAAA,CAAC,CAAC,EAAE,YAAJA,MAAQ;AAE3E;AAEA,SAASI,aAAaV,IAAgB,EAAEW,IAAa;IACnD,MAAMrB,OAAOqB,OAAOvC,YAAYwC,MAAM,CAACZ,QAAQ7C,iBAAiB6C;IAChE,MAAMa,MAAMvB,KAAKwB,OAAO,CAAC;IACzB,OAAO,AAACD,CAAAA,OAAO,IAAIvB,KAAKyB,KAAK,CAAC,GAAGF,OAAOvB,IAAG,EAAG0B,IAAI;AACpD;AAEA;;;CAGC,GACD,SAASC,SAASC,IAAmB,EAAEC,IAAmB;IACxD,MAAMb,IAAIY,OAAO,0BAA0BE,IAAI,CAACF,QAAQ;IACxD,IAAI,CAACZ,GAAG,OAAO;IACf,MAAM,GAAGe,MAAMC,OAAOC,IAAI,GAAGjB;IAC7B,IAAI,CAACe,QAAQ,CAACC,SAAS,CAACC,OAAOF,SAAS,QAAQ,OAAO;IACvD,IAAI,CAACC,QAAQ,KAAK,CAACA,QAAQ,MAAM,CAACC,MAAM,KAAK,CAACA,MAAM,IAAI,OAAO;IAC/D,MAAMC,MAAM,GAAGH,KAAK,CAAC,EAAEC,MAAM,CAAC,EAAEC,KAAK;IACrC,MAAME,IAAIN,OACN,yDAAyDC,IAAI,CAACD,QAC9D;IACJ,IAAI,CAACM,GAAG,OAAOD;IACf,MAAM,GAAGE,MAAMC,QAAQC,QAAQC,MAAMC,UAAUC,WAAW,GAAGN;IAC7D,IAAI,EAAEC,eAAAA,OAAQ,MAAM,MAAM,EAAEC,iBAAAA,SAAU,MAAM,MAAM,EAAEC,iBAAAA,SAAU,MAAM,IAAI;QACtE,OAAOJ;IACT;IACA,MAAMQ,OAAOH,OAAO,GAAGA,OAAOC,SAAS,CAAC,EAAEC,YAAY,GAAG;IACzD,OAAO,GAAGP,IAAI,CAAC,EAAEE,KAAK,CAAC,EAAEC,OAAO,CAAC,EAAEC,SAASI,MAAM;AACpD;AAEA;;;;CAIC,GACD,OAAO,SAASC,eAAexC,GAAe;IAC5C,MAAM,EAAEU,IAAI,EAAE,GAAGX,SAASC;IAC1B,OAAOU,KAAKrB,MAAM,IAAIqB,KAAK+B,KAAK,CAAC,CAACC,OAASA,SAAS,KAChD1C,IAAIQ,QAAQ,CAAC,GAAGR,IAAIX,MAAM,GAAGqB,KAAKrB,MAAM,IACxCW;AACN;AAEA,sEAAsE,GACtE,OAAO,SAAS2C,QAAQ3C,GAAe;IACrC,IAAI;YAmBA4C,SACAA;QAnBF,MAAM,EAAE3C,QAAQ,EAAE,GAAGF,SAASC;QAC9B,MAAMkB,OAAON,aAAaX;QAC1B,MAAM2C,QAAQ,CAAC9E,UACbmC,SACG4C,MAAM,CAAC,CAAChC,IAAMA,EAAEP,MAAM,KAAK,KAAKO,EAAE/C,OAAO,KAAKA,SAC9CgF,GAAG,CAAC,CAACjC,IAAMI,aAAaJ,EAAEN,IAAI,EAAEW,OAChC2B,MAAM,CAACE;QACZ,MAAM9D,MAA2B,EAAE;QACnC,KAAK,MAAM+D,SAASpF,OAAQ;YAC1B,MAAM,CAACqF,OAAO,GAAGC,KAAK,GAAGN,MAAMI,MAAMlF,OAAO;YAC5C,IAAImF,UAAUE,WAAW;YACzBlE,IAAIoB,IAAI,CAAC;gBACPxC,KAAKmF,MAAMnF,GAAG;gBACduF,OAAOJ,MAAMjF,UAAU,GAAG;uBAAI,IAAII,IAAI;wBAAC8E;2BAAUC;qBAAK;iBAAE,GAAGD;gBAC3DI,QAAQ;YACV;QACF;QACA,MAAMC,UAAU9B,UACdoB,UAAAA,MAAM5E,aAAa,CAAC,EAAE,YAAtB4E,UAA0B,OAC1BA,WAAAA,MAAM3E,aAAa,CAAC,EAAE,YAAtB2E,WAA0B;QAE5B,IAAIU,SAASrE,IAAIoB,IAAI,CAAC;YAAExC,KAAK;YAAauF,OAAOE;YAASD,QAAQ;QAAO;QACzE,OAAOpE;IACT,EAAE,eAAM;QACN,OAAO,EAAE;IACX;AACF;AAEA,4DAA4D,GAC5D,SAASsE,eACPH,KAA+B,EAC/BrF,UAAmB;IAEnB,IAAIqF,UAAU,MAAM,OAAO,EAAE;IAC7B,MAAMI,QAAQ,AAACC,CAAAA,MAAMC,OAAO,CAACN,SAASA,QAAQ;QAACA;KAAM,AAAD,EACjDN,GAAG,CAAC,CAACa,OAASA,KAAKpC,IAAI,IACvBsB,MAAM,CAACE;IACV,IAAIhF,YAAY,OAAO;WAAI,IAAII,IAAIqF;KAAO;IAC1C,OAAOA,MAAMnE,MAAM,GAAG;QAACmE,MAAMI,IAAI,CAAC;KAAM,GAAG,EAAE;AAC/C;AAEA,oEAAoE,GACpE,SAASC,YACPC,IAAyB,EACzBxD,MAAc,EACdxC,OAAe;IAEf,MAAMiG,QAAQD,KAAKE,SAAS,CAC1B,CAACnD,IAAMA,EAAEP,MAAM,GAAGA,UAAWO,EAAEP,MAAM,KAAKA,UAAUO,EAAE/C,OAAO,GAAGA;IAElE,OAAOiG,QAAQ,IAAID,KAAKzE,MAAM,GAAG0E;AACnC;AAEA;;;;;;;;;;;;;CAaC,GACD,OAAO,SAASE,SAASjE,GAAe,EAAEkE,KAAoB;IAC5D,MAAM,EAAEjE,QAAQ,EAAES,IAAI,EAAE,GAAGX,SAASC;IACpC,MAAMmE,UAAU,CAACtG,MACfuG,OAAOC,SAAS,CAACC,cAAc,CAACC,IAAI,CAACL,OAAOrG,QAAQqG,KAAK,CAACrG,IAAI,KAAKsF;IACrE,MAAMqB,QAAQ,IAAIC;IAClB,KAAK,MAAMzB,SAASpF,OAAQ;QAC1B,MAAMwF,QAAQc,KAAK,CAAClB,MAAMnF,GAAG,CAAC;QAC9B,IAAIsG,QAAQnB,MAAMnF,GAAG,KAAKuF,UAAUD,WAAW;YAC7CqB,MAAMjF,GAAG,CAACyD,MAAMlF,OAAO,EAAEyF,eAAeH,OAAOL,QAAQC,MAAMjF,UAAU;QACzE;IACF;IACA,IAAIoG,QAAQ,cAAc;QACxB,MAAMf,QAAQc,KAAK,CAAC,YAAY;QAChC,MAAMnC,MAAM,OAAOqB,UAAU,WAAW1E,SAASiD,IAAI,CAACyB,MAAM7B,IAAI,MAAM;QACtE,IAAI6B,UAAU,MAAM;YAClBoB,MAAMjF,GAAG,CAACvB,cAAc,EAAE;YAC1BwG,MAAMjF,GAAG,CAACtB,cAAc,EAAE;QAC5B,OAAO,IAAI8D,KAAK;;YACd,MAAM,GAAGH,MAAMC,OAAOC,KAAKG,MAAMC,QAAQC,QAAQI,KAAK,GAAGR;YACzDyC,MAAMjF,GAAG,CAACvB,cAAc;gBAAC,GAAG4D,OAAOC,QAAQC,KAAK;aAAC;YACjD,oEAAoE;YACpE,MAAM4C,SAASnC,SAAS,MAAM,kBAAWA,wBAAAA,KAAMoC,OAAO,CAAC,KAAK,sBAAO;YACnEH,MAAMjF,GAAG,CACPtB,cACAgE,OAAO;gBAAC,GAAGA,OAAOC,SAASC,iBAAAA,SAAU,OAAOuC,QAAQ;aAAC,GAAG,EAAE;QAE9D;IACF;IACA,IAAI,CAACF,MAAMtE,IAAI,EAAE,OAAOF;IAExB,IAAI8D,OAAO7D,SAASqB,KAAK;IACzB,MAAMsD,SAAS;WAAIJ,MAAMI,MAAM;KAAG,CAACC,IAAI;IACvC,IAAI,CAACjE,aAAakD,SAASc,OAAOE,IAAI,CAAC,CAACC,IAAM,CAACnF,QAAQmF,KAAK;QAC1DjB,OAAOA,KAAKhB,GAAG,CAAC,CAACjC,IACfA,EAAEP,MAAM,KAAK,KACb,CAACpC,gBAAgB8G,GAAG,CAACnE,EAAE/C,OAAO,KAC9B,CAAC0G,MAAMQ,GAAG,CAACnE,EAAE/C,OAAO,KACpB,CAACH,OAAOkD,EAAEN,IAAI,IACV,aAAKM;gBAAGN,MAAM1B,QAAQoG,MAAM,CAACvH,iBAAiBmD,EAAEN,IAAI;gBAAIE,KAAK;iBAC7DI;QAEN,MAAMC,UAAoB;YACxBR,QAAQ;YACRxC,SAAS;YACTyC,MAAMnC;YACNqC,KAAK;QACP;QACA,MAAMyE,WAAWpB,KAAKE,SAAS,CAAC,CAACnD,IAAMA,EAAEP,MAAM,KAAK,KAAKO,EAAE/C,OAAO,KAAK;QACvE,IAAIoH,YAAY,GAAG;YACjBpB,IAAI,CAACoB,SAAS,GAAGpE;QACnB,OAAO;YACL,IAAI,CAACgD,KAAKgB,IAAI,CAAC,CAACjE,IAAMA,EAAEP,MAAM,KAAK,IAAI;gBACrC,8DAA8D;gBAC9DwD,KAAKqB,MAAM,CAACtB,YAAYC,MAAM,GAAG,IAAI,GAAG;oBACtCxD,QAAQ;oBACRxC,SAAS;oBACTyC,MAAMjC;oBACNmC,KAAK;gBACP;YACF;YACAqD,KAAKqB,MAAM,CAACtB,YAAYC,MAAM,GAAG,KAAK,GAAGhD;QAC3C;IACF;IAEA,KAAK,MAAM,CAAChD,SAAS8E,MAAM,IAAI;WAAI4B;KAAM,CAACY,IAAI,CAAC,CAAC3F,GAAGC,IAAMD,CAAC,CAAC,EAAE,GAAGC,CAAC,CAAC,EAAE,EAAG;QACrE,MAAMuD,QAAQa,KAAKE,SAAS,CAAC,CAACnD,IAAMA,EAAEP,MAAM,KAAK,KAAKO,EAAE/C,OAAO,KAAKA;QACpE,MAAMuH,OAAOvB,KAAKjB,MAAM,CAAC,CAAChC,IAAM,CAAEA,CAAAA,EAAEP,MAAM,KAAK,KAAKO,EAAE/C,OAAO,KAAKA,OAAM;QACxE,MAAMwH,QAAQ1C,MAAME,GAAG,CAAC,CAACjD,OAAoB,CAAA;gBAC3CS,QAAQ;gBACRxC;gBACAyC,MAAM1B,QAAQoG,MAAM,CAACpF;gBACrBY,KAAK;YACP,CAAA;QACA4E,KAAKF,MAAM,CAAClC,SAAS,IAAIA,QAAQY,YAAYwB,MAAM,GAAGvH,UAAU,MAAMwH;QACtExB,OAAOuB;IACT;IACA,IAAIT,OAAOvF,MAAM,IAAI,CAACyE,KAAKgB,IAAI,CAAC,CAACjE,IAAMA,EAAEP,MAAM,KAAK,KAAKO,EAAE/C,OAAO,KAAK,IAAI;QACzE,yEAAyE;QACzEgG,KAAKqB,MAAM,CAACtB,YAAYC,MAAM,GAAG,IAAI,GAAG;YACtCxD,QAAQ;YACRxC,SAAS;YACTyC,MAAMjC;YACNmC,KAAK;QACP;IACF;IAEA,yEAAyE;IACzE,yDAAyD;IACzD,MAAM8E,OAAO7E,KAAKoE,IAAI,CAAC,CAACpC,OAASA,SAAS,KAAKhC,OAAO,IAAIrC;IAC1D,MAAMY,MAAMF,OAAO;WACd+E,KAAKhB,GAAG,CAAC,CAACjC;gBAAMA;oBAAAA,SAAAA,EAAEJ,GAAG,YAALI,SAASF,cAAcE,EAAEP,MAAM,EAAEO,EAAE/C,OAAO,EAAE+C,EAAEN,IAAI;;QACrEgF;KACD;IACD,OAAO/F,UAAUP,KAAKe,OAAOA,MAAMf;AACrC;AAgBA,SAASuG,SAASC,GAAe;IAI/B,MAAMC,YAAwB,EAAE;IAChC,IAAIpG,KAAK;IACT,MAAOA,KAAK,MAAMmG,IAAIpG,MAAM,CAAE;YAGToG,OAIhBA,cACEA,QACCA,QACDA,QAMGA,QAA2BA;QAfnC,MAAME,YAAYC,OAAOC,YAAY,IAAIJ,IAAIjF,QAAQ,CAAClB,IAAIA,KAAK;QAC/D,IAAI,CAACf,eAAeyG,GAAG,CAACW,YAAY;QACpC,MAAMG,cAAaL,QAAAA,GAAG,CAACnG,KAAK,EAAE,YAAXmG,QAAe;QAClC,MAAMM,UAAUzG,KAAK,IAAK,CAAA,AAACwG,aAAa,IAAK,CAAC,CAAA;QAC9C,IAAIC,UAAU,IAAIN,IAAIpG,MAAM,EAAE;QAC9B,MAAMa,OACJ,EAACuF,eAAAA,GAAG,CAACM,QAAQ,YAAZN,eAAgB,KAAK,YACrB,CAAA,EAAEA,SAAAA,GAAG,CAACM,UAAU,EAAE,YAAhBN,SAAoB,MAAM,KAC1B,EAACA,SAAAA,GAAG,CAACM,UAAU,EAAE,YAAhBN,SAAoB,MAAM,MAC3BA,SAAAA,GAAG,CAACM,UAAU,EAAE,YAAhBN,SAAoB,EAAC;QAC1B,MAAMO,SAASD,UAAU;QACzB,IAAIC,SAAS9F,OAAOuF,IAAIpG,MAAM,EAAE;QAChC,MAAM4G,MAAMC,KAAKC,GAAG,CAACH,SAAS9F,OAAQA,OAAO,GAAIuF,IAAIpG,MAAM;QAC3DqG,UAAUrF,IAAI,CAAC;YACbsF;YACAS,IAAI,EAAEX,SAAAA,GAAG,CAACnG,KAAK,EAAE,YAAXmG,SAAe,MAAM,MAAMA,SAAAA,GAAG,CAACnG,KAAK,EAAE,YAAXmG,SAAe;YAChDY,MAAMZ,IAAIjF,QAAQ,CAAClB,KAAK,GAAGyG;YAC3BxF,MAAMkF,IAAIjF,QAAQ,CAACwF,QAAQA,SAAS9F;YACpCO,KAAKgF,IAAIjF,QAAQ,CAAClB,IAAI2G;QACxB;QACA3G,KAAK2G;IACP;IACA,OAAO;QAAEP;QAAWhF,MAAM+E,IAAIjF,QAAQ,CAAClB;IAAI;AAC7C;AAEA,SAASgH,eACPC,QAAqD,EACrDhG,IAAgB;IAEhB,MAAMpB,IAAIoB,KAAKlB,MAAM;IACrB,OAAON,OAAO;QACZ;eAAIwH,SAASZ,SAAS;SAAC,CAAC7C,GAAG,CAAC,CAAC0D,IAAMA,EAAE1G,UAAU,CAAC;QAChD;YAACyG,SAASH,EAAE,IAAI;YAAGG,SAASH,EAAE,GAAG;SAAK;QACtCG,SAASF,IAAI;QACb;YAAElH,MAAM,KAAM;YAAOA,MAAM,KAAM;YAAOA,MAAM,IAAK;YAAMA,IAAI;SAAK;QAClEoB;QACApB,IAAI,IAAI;YAAC;SAAE,GAAG,EAAE;KACjB;AACH;AAEA,MAAMsH,iBAAiB,CAACC,IACtBA,EAAEf,SAAS,KAAK,UAAUe,EAAEN,EAAE,KAAK5H;AAErC,wEAAwE,GACxE,OAAO,SAASmI,OAAOlB,GAAe;IACpC,IAAI;;YACKD;QAAP,gBAAOA,2BAAAA,SAASC,KAAKC,SAAS,CAAC3E,IAAI,CAAC0F,oCAA7BjB,yBAA8CjF,IAAI,mBAAI;IAC/D,EAAE,eAAM;QACN,OAAO;IACT;AACF;AAEA,kEAAkE,GAClE,OAAO,SAASqG,WAAWnB,GAAe;IACxC,OAAOkB,OAAOlB,SAAS;AACzB;AAEA,4DAA4D,GAC5D,OAAO,SAASoB,YAAYpB,GAAe;IACzC,MAAMzF,MAAM2G,OAAOlB;IACnB,OAAOzF,MAAM2C,QAAQ3C,OAAO,EAAE;AAChC;AAEA;;;;;CAKC,GACD,OAAO,SAAS8G,cACdrB,GAAe,EACfzF,GAAsB;IAEtB,MAAM,EAAE0F,SAAS,EAAEhF,IAAI,EAAE,GAAG8E,SAASC;IACrC,MAAMsB,SAAS/G,MACX,IAAI3B,WAAWZ,WAAW,OAAOuJ,MAAM,CAAChH,KAAK+G,MAAM,MACnD;IACJ,MAAM/H,QAAsB,EAAE;IAC9B,IAAIiI,WAAW;IACf,KAAK,MAAMV,YAAYb,UAAW;QAChC,IAAIe,eAAeF,aAAa,CAACU,UAAU;YACzCA,WAAW;YACX,IAAIjH,KAAKhB,MAAMqB,IAAI,CAACiG,eAAeC,UAAUvG;QAC/C,OAAO,IACLuG,SAASZ,SAAS,KAAK,UACvBY,SAASH,EAAE,KAAK3H,sBAChB;YACA,IAAIsI,QAAQ/H,MAAMqB,IAAI,CAACiG,eAAeC,UAAUQ;QAClD,OAAO;YACL/H,MAAMqB,IAAI,CAACkG,SAAS9F,GAAG;QACzB;IACF;IACA,IAAI,CAACwG,YAAYjH,KAAK;QACpBhB,MAAMqB,IAAI,CACRiG,eACE;YAAEX,WAAW;YAAQS,IAAI5H;YAAe6H,MAAM,IAAIhI,WAAW;QAAG,GAChE2B;IAGN;IACA,MAAMf,MAAMF,OAAO;WAAIC;QAAO0B;KAAK;IACnC,OAAOlB,UAAUP,KAAKwG,OAAOA,MAAMxG;AACrC;AAEA;;;;CAIC,GACD,OAAO,SAASiI,aACdzB,GAAe,EACfvB,KAAoB;IAEpB,MAAMlE,MAAM2G,OAAOlB;IACnB,IAAI,CAACzF,KAAK,OAAOyF;IACjB,MAAM0B,OAAOlD,SAASjE,KAAKkE;IAC3B,OAAOiD,SAASnH,MAAMyF,MAAMqB,cAAcrB,KAAK0B;AACjD"}

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

@@ -0,0 +1,43 @@
+/**
+ * @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.
+ */
+import { type ImageBlockUpdate, type ImageBlocks } from './image-blocks';
+/**
+ * Reads the metadata blocks of a JPEG. Returns `null` when the bytes are not
+ * a JPEG (no SOI); a damaged or truncated header yields whatever blocks came
+ * before the damage.
+ *
+ * The first EXIF and first main-XMP segment win, as every reader does; all
+ * Photoshop APP13 payloads are concatenated in file order.
+ */
+export declare function readJpegBlocks(bytes: Uint8Array): ImageBlocks | null;
+/**
+ * Writes an update into a JPEG and returns the new file. Only the header's
+ * metadata segments change; every other segment and the whole of SOS→EOI
+ * and beyond are copied byte for byte.
+ *
+ * - A block that exists is replaced in place (and any later duplicates of
+ *   it removed); `null` removes every copy.
+ * - A new block goes to its standard position: EXIF right after SOI and a
+ *   leading APP0 JFIF/JFXX run, XMP after EXIF, APP13 after XMP.
+ * - Extended XMP, ICC, COM and every other segment are never touched.
+ *
+ * Throws `EmbeddedWriteError` for a file that is not a JPEG or whose header
+ * is truncated, for a block too large for its segment (EXIF over 65527
+ * bytes, XMP over 65502), for an MPF index it cannot keep pointing at the
+ * right bytes, and for a PNG text update.
+ */
+export declare function writeJpegBlocks(bytes: Uint8Array, update: ImageBlockUpdate): Uint8Array;