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

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

@@ -0,0 +1,417 @@
+/**
+ * @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 tags of a WebM or Matroska film (AGL-3331). Read-only, like MP4.
+ *
+ * Matroska is EBML (RFC 8794): every element is a variable-length ID, a
+ * variable-length size and a payload. The file is an EBML header naming the
+ * DocType, then one `Segment` whose top-level children include `Info`
+ * (title, date, muxer) and `Tags`, and — the bulk of the file — `Cluster`s
+ * of media (RFC 9559 §5.1).
+ *
+ * ## Reading without downloading the film
+ *
+ * Every read goes through the random-access reader and is sized exactly: an
+ * element header is read in at most two pieces (see `headerAt`), so even the
+ * header of a `Cluster` costs its own few bytes and nothing of its payload.
+ * The Segment's children are walked from the start until the first
+ * `Cluster`; anything that lives past the media — `Tags` usually does,
+ * because a muxer writes them last — is reached through the `SeekHead`
+ * index (RFC 9559 §5.1.1), whose positions count from the start of the
+ * Segment's payload. A Segment of unknown size (a live recording, which is
+ * what a browser's MediaRecorder writes) runs to the end of the file, and a
+ * `Cluster` of unknown size simply ends the walk.
+ *
+ * ## What is read
+ *
+ * - `Info` (§5.1.2): `Title`, `DateUTC` (signed nanoseconds since
+ *   2001-01-01T00:00:00Z), `WritingApp` — or `MuxingApp` when that is all
+ *   there is — as the encoder.
+ * - `Tags` (§5.1.8): the `SimpleTag`s of every `Tag` that targets the whole
+ *   file — no track, edition, chapter or attachment UID — preferring target
+ *   level 50, the film itself. A per-track tag (ffmpeg writes a `DURATION`
+ *   for every track) describes a stream, not the file, and is skipped.
+ *   Nested SimpleTags are not read.
+ *
+ * Tags outrank `Info` for the same idea: `DATE_RECORDED` says when the
+ * recording began, `DateUTC` only when the file was muxed.
+ */ import { otherEmbeddedKey } from "../media-embedded-fields.js";
+// Element IDs, with their length-marker bits, as the specifications list them.
+const ID_EBML = 0x1a45dfa3;
+const ID_DOCTYPE = 0x4282;
+const ID_SEGMENT = 0x18538067;
+const ID_SEEKHEAD = 0x114d9b74;
+const ID_SEEK = 0x4dbb;
+const ID_SEEKID = 0x53ab;
+const ID_SEEKPOSITION = 0x53ac;
+const ID_INFO = 0x1549a966;
+const ID_TITLE = 0x7ba9;
+const ID_DATEUTC = 0x4461;
+const ID_MUXINGAPP = 0x4d80;
+const ID_WRITINGAPP = 0x5741;
+const ID_TAGS = 0x1254c367;
+const ID_TAG = 0x7373;
+const ID_TARGETS = 0x63c0;
+const ID_TARGETTYPEVALUE = 0x68ca;
+const ID_TAG_UIDS = new Set([
+    0x63c5,
+    0x63c9,
+    0x63c4,
+    0x63c6
+]);
+const ID_SIMPLETAG = 0x67c8;
+const ID_TAGNAME = 0x45a3;
+const ID_TAGSTRING = 0x4487;
+const ID_CLUSTER = 0x1f43b675;
+const EBML_HEADER_MAX_BYTES = 4096;
+const SEEKHEAD_MAX_BYTES = 1024 * 1024;
+const INFO_MAX_BYTES = 1024 * 1024;
+const TAGS_MAX_BYTES = 8 * 1024 * 1024;
+/** Top-level elements ahead of the first Cluster: a handful, in practice. */ const MAX_TOP_LEVEL = 256;
+const MAX_CHILDREN = 65536;
+/** Milliseconds from 1970 to 2001-01-01T00:00:00Z, Matroska's epoch. */ const EPOCH_2001_MS = 978307200000;
+/** The length of a VINT from its first byte's leading zeros (RFC 8794 §4). */ function vintLength(first) {
+    for(let length = 1, mask = 0x80; length <= 8; length++, mask >>= 1){
+        if (first & mask) return length;
+    }
+    return 0;
+}
+/** An element ID: 1 to 4 bytes, marker bit kept (RFC 8794 §5). */ function readId(bytes, at) {
+    var _bytes_at, _bytes_;
+    const length = vintLength((_bytes_at = bytes[at]) != null ? _bytes_at : 0);
+    if (!length || length > 4 || at + length > bytes.length) return null;
+    let id = 0;
+    for(let index = 0; index < length; index++)id = id * 256 + ((_bytes_ = bytes[at + index]) != null ? _bytes_ : 0);
+    return {
+        id,
+        length
+    };
+}
+/**
+ * An element data size: 1 to 8 bytes, marker bit dropped; every value bit
+ * set means "unknown" (RFC 8794 §6.2). A size past 2^53 is refused.
+ */ function readSize(bytes, at) {
+    var _bytes_at;
+    const first = (_bytes_at = bytes[at]) != null ? _bytes_at : 0;
+    const length = vintLength(first);
+    if (!length || at + length > bytes.length) return null;
+    let value = first & 0xff >> length;
+    let allOnes = value === 0xff >> length;
+    for(let index = 1; index < length; index++){
+        var _bytes_;
+        const byte = (_bytes_ = bytes[at + index]) != null ? _bytes_ : 0;
+        value = value * 256 + byte;
+        if (byte !== 0xff) allOnes = false;
+    }
+    if (allOnes) return {
+        size: null,
+        length
+    };
+    return Number.isSafeInteger(value) ? {
+        size: value,
+        length
+    } : null;
+}
+/** The elements inside `bytes[start, end)`, clamped to it. */ function elements(bytes, start, end) {
+    const out = [];
+    let at = start;
+    while(at < end && out.length < MAX_CHILDREN){
+        const id = readId(bytes, at);
+        if (!id) break;
+        const size = readSize(bytes, at + id.length);
+        if (!size) break;
+        const body = at + id.length + size.length;
+        if (body > end) break;
+        // An unknown size inside a buffer can only run to the buffer's end.
+        const length = size.size === null ? end - body : Math.min(size.size, end - body);
+        out.push({
+            id: id.id,
+            start: at,
+            body,
+            size: length
+        });
+        at = body + length;
+    }
+    return out;
+}
+const payload = (bytes, element)=>{
+    var _element_size;
+    return bytes.subarray(element.body, element.body + ((_element_size = element.size) != null ? _element_size : 0));
+};
+/** A Matroska string: UTF-8, possibly zero-padded (RFC 8794 §7.4, §7.5). */ const text = (bytes)=>new TextDecoder('utf-8').decode(bytes).replace(/\0+$/, '');
+function unsigned(bytes) {
+    if (bytes.length > 8) return null;
+    let value = 0;
+    for (const byte of bytes)value = value * 256 + byte;
+    return Number.isSafeInteger(value) ? value : null;
+}
+/**
+ * One element header read through the reader in at most two sized pieces:
+ * five bytes — a 4-byte ID and the first byte of the size, which says how
+ * long the size is — then whatever of the size is still missing. For a
+ * `Cluster` (a 4-byte ID) the first read is all header; for a shorter ID it
+ * may run into that element's own payload, never into a Cluster's — so no
+ * read reaches into the media this module means to skip.
+ */ async function headerAt(reader, at) {
+    var _held_;
+    if (at < 0 || at >= reader.size) return null;
+    const head = await reader.read(at, Math.min(reader.size, at + 5));
+    const id = readId(head, 0);
+    if (!id) return null;
+    const sizeAt = at + id.length;
+    const held = head.subarray(id.length);
+    const length = vintLength((_held_ = held[0]) != null ? _held_ : 0);
+    if (!held.length || !length) return null;
+    let sizeBytes = held.subarray(0, length);
+    if (held.length < length) {
+        const rest = await reader.read(sizeAt + held.length, sizeAt + length);
+        if (held.length + rest.length < length) return null;
+        sizeBytes = new Uint8Array(length);
+        sizeBytes.set(held);
+        sizeBytes.set(rest, held.length);
+    }
+    const size = readSize(sizeBytes, 0);
+    if (!size) return null;
+    return {
+        id: id.id,
+        start: at,
+        body: sizeAt + length,
+        size: size.size
+    };
+}
+/** Official tag names (Matroska Media Container Tag Specifications). */ const TAG_KEYS = {
+    TITLE: 'title',
+    ARTIST: 'creator',
+    DESCRIPTION: 'description',
+    COMMENT: 'comment',
+    DATE_RECORDED: 'createdAt',
+    COPYRIGHT: 'copyright',
+    KEYWORDS: 'keywords',
+    ENCODER: 'encoder'
+};
+/**
+ * A tag date — `YYYY-MM-DD hh:mm:ss.mss`, any tail of it omitted — in the
+ * catalog's form. The tag specification names no zone, so none is added.
+ */ function normalizeTagDate(raw) {
+    const value = raw.trim();
+    const match = /^(\d{4}-\d{2}-\d{2})[T ](\d{2}:\d{2}(?::\d{2})?)(?:[.,](\d+))?(Z|[+-]\d{2}:\d{2})?$/.exec(value);
+    if (!match) return value;
+    const [, date, time, fraction, zone] = match;
+    return `${date}T${time}${fraction ? `.${fraction.slice(0, 3)}` : ''}${zone != null ? zone : ''}`;
+}
+let Collector = class Collector {
+    add(key, value, rank, label) {
+        const trimmed = value.trim();
+        if (!trimmed) return;
+        let candidate;
+        if (key === 'keywords') {
+            const items = trimmed.split(/[,;]/).map((item)=>item.trim()).filter(Boolean);
+            if (!items.length) return;
+            candidate = {
+                key,
+                value: items,
+                source: 'webm',
+                editable: false
+            };
+        } else if (key === 'creator') {
+            candidate = {
+                key,
+                value: [
+                    trimmed
+                ],
+                source: 'webm',
+                editable: false
+            };
+        } else if (key === 'createdAt') {
+            candidate = {
+                key,
+                value: normalizeTagDate(trimmed),
+                source: 'webm',
+                editable: false
+            };
+        } else {
+            candidate = {
+                key,
+                value: trimmed,
+                source: 'webm',
+                editable: false
+            };
+            if (label) candidate.label = label;
+        }
+        const held = this.byKey.get(key);
+        if (!held || rank < held.rank) this.byKey.set(key, {
+            candidate,
+            rank
+        });
+    }
+    candidates() {
+        return [
+            ...this.byKey.values()
+        ].map(({ candidate })=>candidate);
+    }
+    constructor(){
+        this.byKey = new Map();
+    }
+};
+/** Ranks: a film-level tag, another whole-file tag, then Info. */ const RANK_TAG_FILM = 0;
+const RANK_TAG_OTHER = 10;
+const RANK_INFO = 20;
+function readTags(bytes, out) {
+    for (const tag of elements(bytes, 0, bytes.length)){
+        var _tag_size;
+        if (tag.id !== ID_TAG) continue;
+        const parts = elements(bytes, tag.body, tag.body + ((_tag_size = tag.size) != null ? _tag_size : 0));
+        const targets = parts.find((part)=>part.id === ID_TARGETS);
+        let level = 50;
+        let wholeFile = true;
+        if (targets) {
+            var _targets_size;
+            for (const target of elements(bytes, targets.body, targets.body + ((_targets_size = targets.size) != null ? _targets_size : 0))){
+                const value = unsigned(payload(bytes, target));
+                if (target.id === ID_TARGETTYPEVALUE && value !== null) level = value;
+                if (ID_TAG_UIDS.has(target.id) && value !== 0) wholeFile = false;
+            }
+        }
+        if (!wholeFile) continue;
+        const rank = level === 50 ? RANK_TAG_FILM : RANK_TAG_OTHER;
+        for (const simple of parts){
+            var _simple_size;
+            if (simple.id !== ID_SIMPLETAG) continue;
+            let name = '';
+            let value = null;
+            for (const field of elements(bytes, simple.body, simple.body + ((_simple_size = simple.size) != null ? _simple_size : 0))){
+                if (field.id === ID_TAGNAME) name = text(payload(bytes, field)).trim();
+                else if (field.id === ID_TAGSTRING) value = text(payload(bytes, field));
+            }
+            if (!name || value === null) continue;
+            const key = TAG_KEYS[name.toUpperCase()];
+            if (key) out.add(key, value, rank);
+            else out.add(otherEmbeddedKey('webm', name), value, rank, name);
+        }
+    }
+}
+function readInfo(bytes, out) {
+    let muxingApp = '';
+    let writingApp = '';
+    for (const field of elements(bytes, 0, bytes.length)){
+        const value = payload(bytes, field);
+        if (field.id === ID_TITLE) out.add('title', text(value), RANK_INFO);
+        else if (field.id === ID_MUXINGAPP) muxingApp = text(value).trim();
+        else if (field.id === ID_WRITINGAPP) writingApp = text(value).trim();
+        else if (field.id === ID_DATEUTC && value.length === 8) {
+            const nanoseconds = new DataView(value.buffer, value.byteOffset, value.byteLength).getBigInt64(0);
+            const date = new Date(EPOCH_2001_MS + Number(nanoseconds / 1000000n));
+            if (!Number.isNaN(date.getTime())) {
+                out.add('createdAt', date.toISOString().replace(/\.\d{3}Z$/, 'Z'), RANK_INFO);
+            }
+        }
+    }
+    const encoder = writingApp || muxingApp;
+    if (encoder) out.add('encoder', encoder, RANK_INFO);
+    if (muxingApp && writingApp && muxingApp !== writingApp) {
+        out.add(otherEmbeddedKey('webm', 'MuxingApp'), muxingApp, RANK_INFO, 'Muxing application');
+    }
+}
+/**
+ * Read a film's tags through random access.
+ *
+ * Null when the bytes do not open with an EBML header whose DocType is
+ * `webm` or `matroska`. Every candidate is `editable: false`.
+ */ export async function readWebm(reader) {
+    const ebml = await headerAt(reader, 0);
+    if (!ebml || ebml.id !== ID_EBML || ebml.size === null) return null;
+    if (ebml.size > EBML_HEADER_MAX_BYTES) return null;
+    const header = await reader.read(ebml.body, ebml.body + ebml.size);
+    const docType = elements(header, 0, header.length).find((element)=>element.id === ID_DOCTYPE);
+    const kind = docType ? text(payload(header, docType)) : '';
+    if (kind !== 'webm' && kind !== 'matroska') return null;
+    // The Segment follows the header, perhaps after a Void.
+    let segment = null;
+    let at = ebml.body + ebml.size;
+    for(let count = 0; count < 16; count++){
+        const element = await headerAt(reader, at);
+        if (!element) break;
+        if (element.id === ID_SEGMENT) {
+            segment = element;
+            break;
+        }
+        if (element.size === null) break;
+        at = element.body + element.size;
+    }
+    const out = new Collector();
+    if (!segment) return {
+        candidates: []
+    };
+    const origin = segment.body;
+    const segmentEnd = segment.size === null ? reader.size : Math.min(reader.size, segment.body + segment.size);
+    const visited = new Set();
+    const infos = [];
+    const tags = [];
+    const pending = [];
+    const visit = async (element)=>{
+        if (visited.has(element.start) || element.size === null) return;
+        const cap = element.id === ID_SEEKHEAD ? SEEKHEAD_MAX_BYTES : element.id === ID_INFO ? INFO_MAX_BYTES : element.id === ID_TAGS ? TAGS_MAX_BYTES : 0;
+        if (!cap || element.size > cap) return;
+        visited.add(element.start);
+        const bytes = await reader.read(element.body, Math.min(segmentEnd, element.body + element.size));
+        if (element.id === ID_INFO) infos.push(bytes);
+        else if (element.id === ID_TAGS) tags.push(bytes);
+        else {
+            for (const seek of elements(bytes, 0, bytes.length)){
+                var _seek_size;
+                if (seek.id !== ID_SEEK) continue;
+                let id = null;
+                let position = null;
+                for (const field of elements(bytes, seek.body, seek.body + ((_seek_size = seek.size) != null ? _seek_size : 0))){
+                    const value = payload(bytes, field);
+                    if (field.id === ID_SEEKID) id = unsigned(value);
+                    else if (field.id === ID_SEEKPOSITION) position = unsigned(value);
+                }
+                if (id !== null && position !== null && (id === ID_INFO || id === ID_TAGS || id === ID_SEEKHEAD)) {
+                    pending.push({
+                        id,
+                        at: origin + position
+                    });
+                }
+            }
+        }
+    };
+    // Walk the Segment's children up to the first Cluster.
+    at = origin;
+    for(let count = 0; count < MAX_TOP_LEVEL && at < segmentEnd; count++){
+        const element = await headerAt(reader, at);
+        if (!element || element.id === ID_CLUSTER || element.size === null) break;
+        await visit(element);
+        at = element.body + element.size;
+    }
+    // Then what the index says lives beyond it — a second SeekHead included,
+    // one level deep, which is as far as the specification nests them.
+    for(let round = 0; round < 2 && pending.length; round++){
+        const targets = pending.splice(0);
+        for (const target of targets){
+            if (visited.has(target.at) || target.at >= segmentEnd) continue;
+            const element = await headerAt(reader, target.at);
+            if (element && element.id === target.id) await visit(element);
+        }
+    }
+    for (const bytes of tags)readTags(bytes, out);
+    for (const bytes of infos)readInfo(bytes, out);
+    return {
+        candidates: out.candidates()
+    };
+}
+
+//# sourceMappingURL=webm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/aglyn/src/lib/app-utils/media-embedded-metadata/webm.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 tags of a WebM or Matroska film (AGL-3331). Read-only, like MP4.\n *\n * Matroska is EBML (RFC 8794): every element is a variable-length ID, a\n * variable-length size and a payload. The file is an EBML header naming the\n * DocType, then one `Segment` whose top-level children include `Info`\n * (title, date, muxer) and `Tags`, and — the bulk of the file — `Cluster`s\n * of media (RFC 9559 §5.1).\n *\n * ## Reading without downloading the film\n *\n * Every read goes through the random-access reader and is sized exactly: an\n * element header is read in at most two pieces (see `headerAt`), so even the\n * header of a `Cluster` costs its own few bytes and nothing of its payload.\n * The Segment's children are walked from the start until the first\n * `Cluster`; anything that lives past the media — `Tags` usually does,\n * because a muxer writes them last — is reached through the `SeekHead`\n * index (RFC 9559 §5.1.1), whose positions count from the start of the\n * Segment's payload. A Segment of unknown size (a live recording, which is\n * what a browser's MediaRecorder writes) runs to the end of the file, and a\n * `Cluster` of unknown size simply ends the walk.\n *\n * ## What is read\n *\n * - `Info` (§5.1.2): `Title`, `DateUTC` (signed nanoseconds since\n *   2001-01-01T00:00:00Z), `WritingApp` — or `MuxingApp` when that is all\n *   there is — as the encoder.\n * - `Tags` (§5.1.8): the `SimpleTag`s of every `Tag` that targets the whole\n *   file — no track, edition, chapter or attachment UID — preferring target\n *   level 50, the film itself. A per-track tag (ffmpeg writes a `DURATION`\n *   for every track) describes a stream, not the file, and is skipped.\n *   Nested SimpleTags are not read.\n *\n * Tags outrank `Info` for the same idea: `DATE_RECORDED` says when the\n * recording began, `DateUTC` only when the file was muxed.\n */\n\nimport {\n  otherEmbeddedKey,\n  type MediaEmbeddedCanonicalKey,\n} from '../media-embedded-fields'\nimport type { EmbeddedByteReader, EmbeddedCandidate } from './types'\n\n// Element IDs, with their length-marker bits, as the specifications list them.\nconst ID_EBML = 0x1a45dfa3\nconst ID_DOCTYPE = 0x4282\nconst ID_SEGMENT = 0x18538067\nconst ID_SEEKHEAD = 0x114d9b74\nconst ID_SEEK = 0x4dbb\nconst ID_SEEKID = 0x53ab\nconst ID_SEEKPOSITION = 0x53ac\nconst ID_INFO = 0x1549a966\nconst ID_TITLE = 0x7ba9\nconst ID_DATEUTC = 0x4461\nconst ID_MUXINGAPP = 0x4d80\nconst ID_WRITINGAPP = 0x5741\nconst ID_TAGS = 0x1254c367\nconst ID_TAG = 0x7373\nconst ID_TARGETS = 0x63c0\nconst ID_TARGETTYPEVALUE = 0x68ca\nconst ID_TAG_UIDS = new Set([0x63c5, 0x63c9, 0x63c4, 0x63c6])\nconst ID_SIMPLETAG = 0x67c8\nconst ID_TAGNAME = 0x45a3\nconst ID_TAGSTRING = 0x4487\nconst ID_CLUSTER = 0x1f43b675\n\nconst EBML_HEADER_MAX_BYTES = 4096\nconst SEEKHEAD_MAX_BYTES = 1024 * 1024\nconst INFO_MAX_BYTES = 1024 * 1024\nconst TAGS_MAX_BYTES = 8 * 1024 * 1024\n/** Top-level elements ahead of the first Cluster: a handful, in practice. */\nconst MAX_TOP_LEVEL = 256\nconst MAX_CHILDREN = 65536\n/** Milliseconds from 1970 to 2001-01-01T00:00:00Z, Matroska's epoch. */\nconst EPOCH_2001_MS = 978307200000\n\ninterface ElementHeader {\n  id: number\n  start: number\n  /** Where the payload begins. */\n  body: number\n  /** The payload size; null for the \"unknown\" size (all value bits set). */\n  size: number | null\n}\n\n/** The length of a VINT from its first byte's leading zeros (RFC 8794 §4). */\nfunction vintLength(first: number): number {\n  for (let length = 1, mask = 0x80; length <= 8; length++, mask >>= 1) {\n    if (first & mask) return length\n  }\n  return 0\n}\n\n/** An element ID: 1 to 4 bytes, marker bit kept (RFC 8794 §5). */\nfunction readId(\n  bytes: Uint8Array,\n  at: number,\n): { id: number; length: number } | null {\n  const length = vintLength(bytes[at] ?? 0)\n  if (!length || length > 4 || at + length > bytes.length) return null\n  let id = 0\n  for (let index = 0; index < length; index++)\n    id = id * 256 + (bytes[at + index] ?? 0)\n  return { id, length }\n}\n\n/**\n * An element data size: 1 to 8 bytes, marker bit dropped; every value bit\n * set means \"unknown\" (RFC 8794 §6.2). A size past 2^53 is refused.\n */\nfunction readSize(\n  bytes: Uint8Array,\n  at: number,\n): { size: number | null; length: number } | null {\n  const first = bytes[at] ?? 0\n  const length = vintLength(first)\n  if (!length || at + length > bytes.length) return null\n  let value = first & (0xff >> length)\n  let allOnes = value === 0xff >> length\n  for (let index = 1; index < length; index++) {\n    const byte = bytes[at + index] ?? 0\n    value = value * 256 + byte\n    if (byte !== 0xff) allOnes = false\n  }\n  if (allOnes) return { size: null, length }\n  return Number.isSafeInteger(value) ? { size: value, length } : null\n}\n\n/** The elements inside `bytes[start, end)`, clamped to it. */\nfunction elements(\n  bytes: Uint8Array,\n  start: number,\n  end: number,\n): ElementHeader[] {\n  const out: ElementHeader[] = []\n  let at = start\n  while (at < end && out.length < MAX_CHILDREN) {\n    const id = readId(bytes, at)\n    if (!id) break\n    const size = readSize(bytes, at + id.length)\n    if (!size) break\n    const body = at + id.length + size.length\n    if (body > end) break\n    // An unknown size inside a buffer can only run to the buffer's end.\n    const length =\n      size.size === null ? end - body : Math.min(size.size, end - body)\n    out.push({ id: id.id, start: at, body, size: length })\n    at = body + length\n  }\n  return out\n}\n\nconst payload = (bytes: Uint8Array, element: ElementHeader) =>\n  bytes.subarray(element.body, element.body + (element.size ?? 0))\n\n/** A Matroska string: UTF-8, possibly zero-padded (RFC 8794 §7.4, §7.5). */\nconst text = (bytes: Uint8Array) =>\n  new TextDecoder('utf-8').decode(bytes).replace(/\\0+$/, '')\n\nfunction unsigned(bytes: Uint8Array): number | null {\n  if (bytes.length > 8) return null\n  let value = 0\n  for (const byte of bytes) value = value * 256 + byte\n  return Number.isSafeInteger(value) ? value : null\n}\n\n/**\n * One element header read through the reader in at most two sized pieces:\n * five bytes — a 4-byte ID and the first byte of the size, which says how\n * long the size is — then whatever of the size is still missing. For a\n * `Cluster` (a 4-byte ID) the first read is all header; for a shorter ID it\n * may run into that element's own payload, never into a Cluster's — so no\n * read reaches into the media this module means to skip.\n */\nasync function headerAt(\n  reader: EmbeddedByteReader,\n  at: number,\n): Promise<ElementHeader | null> {\n  if (at < 0 || at >= reader.size) return null\n  const head = await reader.read(at, Math.min(reader.size, at + 5))\n  const id = readId(head, 0)\n  if (!id) return null\n  const sizeAt = at + id.length\n  const held = head.subarray(id.length)\n  const length = vintLength(held[0] ?? 0)\n  if (!held.length || !length) return null\n  let sizeBytes = held.subarray(0, length)\n  if (held.length < length) {\n    const rest = await reader.read(sizeAt + held.length, sizeAt + length)\n    if (held.length + rest.length < length) return null\n    sizeBytes = new Uint8Array(length)\n    sizeBytes.set(held)\n    sizeBytes.set(rest, held.length)\n  }\n  const size = readSize(sizeBytes, 0)\n  if (!size) return null\n  return { id: id.id, start: at, body: sizeAt + length, size: size.size }\n}\n\ntype VideoKey = Extract<\n  MediaEmbeddedCanonicalKey,\n  | 'title'\n  | 'creator'\n  | 'description'\n  | 'comment'\n  | 'createdAt'\n  | 'copyright'\n  | 'keywords'\n  | 'encoder'\n>\n\n/** Official tag names (Matroska Media Container Tag Specifications). */\nconst TAG_KEYS: Record<string, VideoKey> = {\n  TITLE: 'title',\n  ARTIST: 'creator',\n  DESCRIPTION: 'description',\n  COMMENT: 'comment',\n  DATE_RECORDED: 'createdAt',\n  COPYRIGHT: 'copyright',\n  KEYWORDS: 'keywords',\n  ENCODER: 'encoder',\n}\n\n/**\n * A tag date — `YYYY-MM-DD hh:mm:ss.mss`, any tail of it omitted — in the\n * catalog's form. The tag specification names no zone, so none is added.\n */\nfunction normalizeTagDate(raw: string): string {\n  const value = raw.trim()\n  const match =\n    /^(\\d{4}-\\d{2}-\\d{2})[T ](\\d{2}:\\d{2}(?::\\d{2})?)(?:[.,](\\d+))?(Z|[+-]\\d{2}:\\d{2})?$/.exec(\n      value,\n    )\n  if (!match) return value\n  const [, date, time, fraction, zone] = match\n  return `${date}T${time}${fraction ? `.${fraction.slice(0, 3)}` : ''}${zone ?? ''}`\n}\n\nclass Collector {\n  private readonly byKey = new Map<\n    string,\n    { candidate: EmbeddedCandidate; rank: number }\n  >()\n\n  add(key: string, value: string, rank: number, label?: string): void {\n    const trimmed = value.trim()\n    if (!trimmed) return\n    let candidate: EmbeddedCandidate\n    if (key === 'keywords') {\n      const items = trimmed\n        .split(/[,;]/)\n        .map((item) => item.trim())\n        .filter(Boolean)\n      if (!items.length) return\n      candidate = { key, value: items, source: 'webm', editable: false }\n    } else if (key === 'creator') {\n      candidate = { key, value: [trimmed], source: 'webm', editable: false }\n    } else if (key === 'createdAt') {\n      candidate = {\n        key,\n        value: normalizeTagDate(trimmed),\n        source: 'webm',\n        editable: false,\n      }\n    } else {\n      candidate = { key, value: trimmed, source: 'webm', editable: false }\n      if (label) candidate.label = label\n    }\n    const held = this.byKey.get(key)\n    if (!held || rank < held.rank) this.byKey.set(key, { candidate, rank })\n  }\n\n  candidates(): EmbeddedCandidate[] {\n    return [...this.byKey.values()].map(({ candidate }) => candidate)\n  }\n}\n\n/** Ranks: a film-level tag, another whole-file tag, then Info. */\nconst RANK_TAG_FILM = 0\nconst RANK_TAG_OTHER = 10\nconst RANK_INFO = 20\n\nfunction readTags(bytes: Uint8Array, out: Collector): void {\n  for (const tag of elements(bytes, 0, bytes.length)) {\n    if (tag.id !== ID_TAG) continue\n    const parts = elements(bytes, tag.body, tag.body + (tag.size ?? 0))\n    const targets = parts.find((part) => part.id === ID_TARGETS)\n    let level = 50\n    let wholeFile = true\n    if (targets) {\n      for (const target of elements(\n        bytes,\n        targets.body,\n        targets.body + (targets.size ?? 0),\n      )) {\n        const value = unsigned(payload(bytes, target))\n        if (target.id === ID_TARGETTYPEVALUE && value !== null) level = value\n        if (ID_TAG_UIDS.has(target.id) && value !== 0) wholeFile = false\n      }\n    }\n    if (!wholeFile) continue\n    const rank = level === 50 ? RANK_TAG_FILM : RANK_TAG_OTHER\n    for (const simple of parts) {\n      if (simple.id !== ID_SIMPLETAG) continue\n      let name = ''\n      let value: string | null = null\n      for (const field of elements(\n        bytes,\n        simple.body,\n        simple.body + (simple.size ?? 0),\n      )) {\n        if (field.id === ID_TAGNAME) name = text(payload(bytes, field)).trim()\n        else if (field.id === ID_TAGSTRING) value = text(payload(bytes, field))\n      }\n      if (!name || value === null) continue\n      const key = TAG_KEYS[name.toUpperCase()]\n      if (key) out.add(key, value, rank)\n      else out.add(otherEmbeddedKey('webm', name), value, rank, name)\n    }\n  }\n}\n\nfunction readInfo(bytes: Uint8Array, out: Collector): void {\n  let muxingApp = ''\n  let writingApp = ''\n  for (const field of elements(bytes, 0, bytes.length)) {\n    const value = payload(bytes, field)\n    if (field.id === ID_TITLE) out.add('title', text(value), RANK_INFO)\n    else if (field.id === ID_MUXINGAPP) muxingApp = text(value).trim()\n    else if (field.id === ID_WRITINGAPP) writingApp = text(value).trim()\n    else if (field.id === ID_DATEUTC && value.length === 8) {\n      const nanoseconds = new DataView(\n        value.buffer,\n        value.byteOffset,\n        value.byteLength,\n      ).getBigInt64(0)\n      const date = new Date(EPOCH_2001_MS + Number(nanoseconds / 1_000_000n))\n      if (!Number.isNaN(date.getTime())) {\n        out.add(\n          'createdAt',\n          date.toISOString().replace(/\\.\\d{3}Z$/, 'Z'),\n          RANK_INFO,\n        )\n      }\n    }\n  }\n  const encoder = writingApp || muxingApp\n  if (encoder) out.add('encoder', encoder, RANK_INFO)\n  if (muxingApp && writingApp && muxingApp !== writingApp) {\n    out.add(\n      otherEmbeddedKey('webm', 'MuxingApp'),\n      muxingApp,\n      RANK_INFO,\n      'Muxing application',\n    )\n  }\n}\n\n/**\n * Read a film's tags through random access.\n *\n * Null when the bytes do not open with an EBML header whose DocType is\n * `webm` or `matroska`. Every candidate is `editable: false`.\n */\nexport async function readWebm(\n  reader: EmbeddedByteReader,\n): Promise<{ candidates: EmbeddedCandidate[] } | null> {\n  const ebml = await headerAt(reader, 0)\n  if (!ebml || ebml.id !== ID_EBML || ebml.size === null) return null\n  if (ebml.size > EBML_HEADER_MAX_BYTES) return null\n  const header = await reader.read(ebml.body, ebml.body + ebml.size)\n  const docType = elements(header, 0, header.length).find(\n    (element) => element.id === ID_DOCTYPE,\n  )\n  const kind = docType ? text(payload(header, docType)) : ''\n  if (kind !== 'webm' && kind !== 'matroska') return null\n\n  // The Segment follows the header, perhaps after a Void.\n  let segment: ElementHeader | null = null\n  let at = ebml.body + ebml.size\n  for (let count = 0; count < 16; count++) {\n    const element = await headerAt(reader, at)\n    if (!element) break\n    if (element.id === ID_SEGMENT) {\n      segment = element\n      break\n    }\n    if (element.size === null) break\n    at = element.body + element.size\n  }\n  const out = new Collector()\n  if (!segment) return { candidates: [] }\n  const origin = segment.body\n  const segmentEnd =\n    segment.size === null\n      ? reader.size\n      : Math.min(reader.size, segment.body + segment.size)\n\n  const visited = new Set<number>()\n  const infos: Uint8Array[] = []\n  const tags: Uint8Array[] = []\n  const pending: Array<{ id: number; at: number }> = []\n\n  const visit = async (element: ElementHeader) => {\n    if (visited.has(element.start) || element.size === null) return\n    const cap =\n      element.id === ID_SEEKHEAD\n        ? SEEKHEAD_MAX_BYTES\n        : element.id === ID_INFO\n          ? INFO_MAX_BYTES\n          : element.id === ID_TAGS\n            ? TAGS_MAX_BYTES\n            : 0\n    if (!cap || element.size > cap) return\n    visited.add(element.start)\n    const bytes = await reader.read(\n      element.body,\n      Math.min(segmentEnd, element.body + element.size),\n    )\n    if (element.id === ID_INFO) infos.push(bytes)\n    else if (element.id === ID_TAGS) tags.push(bytes)\n    else {\n      for (const seek of elements(bytes, 0, bytes.length)) {\n        if (seek.id !== ID_SEEK) continue\n        let id: number | null = null\n        let position: number | null = null\n        for (const field of elements(\n          bytes,\n          seek.body,\n          seek.body + (seek.size ?? 0),\n        )) {\n          const value = payload(bytes, field)\n          if (field.id === ID_SEEKID) id = unsigned(value)\n          else if (field.id === ID_SEEKPOSITION) position = unsigned(value)\n        }\n        if (\n          id !== null &&\n          position !== null &&\n          (id === ID_INFO || id === ID_TAGS || id === ID_SEEKHEAD)\n        ) {\n          pending.push({ id, at: origin + position })\n        }\n      }\n    }\n  }\n\n  // Walk the Segment's children up to the first Cluster.\n  at = origin\n  for (let count = 0; count < MAX_TOP_LEVEL && at < segmentEnd; count++) {\n    const element = await headerAt(reader, at)\n    if (!element || element.id === ID_CLUSTER || element.size === null) break\n    await visit(element)\n    at = element.body + element.size\n  }\n  // Then what the index says lives beyond it — a second SeekHead included,\n  // one level deep, which is as far as the specification nests them.\n  for (let round = 0; round < 2 && pending.length; round++) {\n    const targets = pending.splice(0)\n    for (const target of targets) {\n      if (visited.has(target.at) || target.at >= segmentEnd) continue\n      const element = await headerAt(reader, target.at)\n      if (element && element.id === target.id) await visit(element)\n    }\n  }\n\n  for (const bytes of tags) readTags(bytes, out)\n  for (const bytes of infos) readInfo(bytes, out)\n  return { candidates: out.candidates() }\n}\n"],"names":["otherEmbeddedKey","ID_EBML","ID_DOCTYPE","ID_SEGMENT","ID_SEEKHEAD","ID_SEEK","ID_SEEKID","ID_SEEKPOSITION","ID_INFO","ID_TITLE","ID_DATEUTC","ID_MUXINGAPP","ID_WRITINGAPP","ID_TAGS","ID_TAG","ID_TARGETS","ID_TARGETTYPEVALUE","ID_TAG_UIDS","Set","ID_SIMPLETAG","ID_TAGNAME","ID_TAGSTRING","ID_CLUSTER","EBML_HEADER_MAX_BYTES","SEEKHEAD_MAX_BYTES","INFO_MAX_BYTES","TAGS_MAX_BYTES","MAX_TOP_LEVEL","MAX_CHILDREN","EPOCH_2001_MS","vintLength","first","length","mask","readId","bytes","at","id","index","readSize","value","allOnes","byte","size","Number","isSafeInteger","elements","start","end","out","body","Math","min","push","payload","element","subarray","text","TextDecoder","decode","replace","unsigned","headerAt","reader","held","head","read","sizeAt","sizeBytes","rest","Uint8Array","set","TAG_KEYS","TITLE","ARTIST","DESCRIPTION","COMMENT","DATE_RECORDED","COPYRIGHT","KEYWORDS","ENCODER","normalizeTagDate","raw","trim","match","exec","date","time","fraction","zone","slice","Collector","add","key","rank","label","trimmed","candidate","items","split","map","item","filter","Boolean","source","editable","byKey","get","candidates","values","Map","RANK_TAG_FILM","RANK_TAG_OTHER","RANK_INFO","readTags","tag","parts","targets","find","part","level","wholeFile","target","has","simple","name","field","toUpperCase","readInfo","muxingApp","writingApp","nanoseconds","DataView","buffer","byteOffset","byteLength","getBigInt64","Date","isNaN","getTime","toISOString","encoder","readWebm","ebml","header","docType","kind","segment","count","origin","segmentEnd","visited","infos","tags","pending","visit","cap","seek","position","round","splice"],"mappings":"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"}

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

@@ -0,0 +1,37 @@
+/**
+ * @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 WebP. Returns `null` when the bytes are not
+ * a WebP; a damaged file yields what came before the damage.
+ */
+export declare function readWebpBlocks(bytes: Uint8Array): ImageBlocks | null;
+/**
+ * Writes an update into a WebP and returns the new file.
+ *
+ * An existing `EXIF` or `XMP ` chunk is replaced in place (later duplicates
+ * removed); a new one goes after the image — EXIF before any existing XMP,
+ * XMP after EXIF — as the extended format orders them. `null` removes every
+ * copy. The `VP8X` EXIF and XMP flags are set to match what the file then
+ * holds; ICC, alpha and animation flags are left as they were.
+ *
+ * Throws `EmbeddedWriteError` for a file that is not a WebP or is truncated,
+ * for a layout that is neither simple nor extended, for a simple file whose
+ * bitstream header cannot give the canvas size a conversion needs, and for
+ * an IRB or PNG text update.
+ */
+export declare function writeWebpBlocks(bytes: Uint8Array, update: ImageBlockUpdate): Uint8Array;