video-fps-probe 0.3.0 → 0.4.0-beta.2

package/dist/cjs/url.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var RangeSourceError=class extends Error{code;status;constructor(e,t,n={}){super(t,n.cause===void 0?void 0:{cause:n.cause}),this.name=`RangeSourceError`,this.code=e,this.status=typeof n.status==`number`?n.status:null}};const e=/^\s*bytes\s+(\d+)-(\d+)\/(\d+|\*)\s*$/i,noop=()=>{},tag=e=>Object.prototype.toString.call(e);function shown(e){return typeof e==`string`?JSON.stringify(e):typeof e==`object`&&e?Array.isArray(e)?`an array`:`an object`:String(e)}function count(e,t,n=0){if(typeof e!=`number`||!Number.isSafeInteger(e)||e<n)throw TypeError(`${t} must be a non-negative safe integer${n>0?` of at least ${n}`:``}, got ${shown(e)}`);return e}function signalOf(e,t){if(e==null)return null;let n=e;if(typeof n!=`object`||typeof n.aborted!=`boolean`||typeof n.addEventListener!=`function`||typeof n.removeEventListener!=`function`)throw TypeError(`${t} must be an AbortSignal, got ${shown(e)}`);return e}function objectOf(e,t){if(e===void 0)return{};if(typeof e!=`object`||!e||Array.isArray(e))throw TypeError(`${t} must be an object, got ${shown(e)}`);return e}function fetcherOf(e){if(typeof e!=`function`)throw TypeError(`fetcher must be a function, got ${shown(e)}`);return e}const reasonOf=e=>e.reason??new DOMException(`This operation was aborted`,`AbortError`);function throwIfAborted(e){if(e?.aborted)throw reasonOf(e)}function linked(e,t){if(!e||!t||e===t||e.aborted||t.aborted)return[e?.aborted||!t?e:t,noop];let n=new AbortController,fromA=()=>n.abort(reasonOf(e)),fromB=()=>n.abort(reasonOf(t));return e.addEventListener(`abort`,fromA,{once:!0}),t.addEventListener(`abort`,fromB,{once:!0}),[n.signal,()=>(e.removeEventListener(`abort`,fromA),t.removeEventListener(`abort`,fromB))]}function untilAborted(e,t,n=noop){return new Promise((r,i)=>{let stop=()=>i(reasonOf(t));t?.aborted?stop():t?.addEventListener(`abort`,stop,{once:!0}),e.then(e=>{t?.removeEventListener(`abort`,stop),t?.aborted?n(e):r(e)},e=>{t?.removeEventListener(`abort`,stop),i(!t?.aborted&&e?.name===`AbortError`?Object.assign(Error(String(e),{cause:e}),{name:``}):e)})})}function attempt(e){try{return Promise.resolve(e())}catch(e){return Promise.reject(e)}}function discard(e){attempt(()=>e?.discard?.()).catch(noop)}function parseRange(t){let n=e.exec(t);if(!n)return null;let r=Number(n[1]),i=Number(n[2]),a=n[3]===`*`?null:Number(n[3]);return!Number.isSafeInteger(r)||!Number.isSafeInteger(i)||r>i||a!==null&&!Number.isSafeInteger(a)?null:{first:r,last:i,total:a}}const present=e=>e!=null,contentRangeOf=({contentRange:e})=>typeof e==`string`?e.trim()===``?null:e:present(e)?String(e):null;function replyOf(e,t){if(typeof e!=`object`||!e)throw new RangeSourceError(`invalid-reply`,`the reply to ${t} is ${shown(e)}, not an object`);return e}function refusal(e,t,n,r,i){let a=present(e.status)?e.status:null,o=contentRangeOf(e);if(a===null&&o===null)return new RangeSourceError(`unverifiable-reply`,`the reply to ${i} has neither a status nor a Content-Range, so it cannot be checked`);if(a!==null&&a!==206&&(a!==200||t!==0||n!==r))return new RangeSourceError(`unexpected-status`,`status ${shown(a)} to ${i} of an object of ${r} bytes, expected 206${t===0&&n===r?` or 200`:``}`,{status:a});if(o!==null){let e=parseRange(o);if(e&&e.total!==null&&e.total!==r)return new RangeSourceError(`size-changed`,`Content-Range ${shown(o)} gives an object of ${e.total} bytes, the source was opened at ${r} bytes`,{status:a});if(!e||e.first!==t||e.last!==n-1)return new RangeSourceError(`range-mismatch`,`Content-Range ${shown(o)} does not match ${i}`,{status:a})}return present(e.contentLength)&&e.contentLength!==n-t?new RangeSourceError(`length-mismatch`,`Content-Length ${shown(e.contentLength)} does not match ${i} (${n-t} bytes)`,{status:a}):null}function exactly(e,t,n){let r;if(ArrayBuffer.isView(e))r=new Uint8Array(e.buffer,e.byteOffset,e.byteLength);else if(tag(e)===`[object ArrayBuffer]`)r=new Uint8Array(e);else throw new RangeSourceError(`invalid-reply`,`${n} is ${e===null?`null`:typeof e}, not bytes`);if(r.byteLength>t)throw new RangeSourceError(`body-too-long`,`${n} holds ${r.byteLength} bytes, more than the ${t} requested`);if(r.byteLength<t)throw new RangeSourceError(`body-too-short`,`${n} holds ${r.byteLength} of the ${t} bytes requested`);return r.byteOffset===0&&r.byteLength===r.buffer.byteLength&&tag(r.buffer)===`[object ArrayBuffer]`?r:r.slice()}async function bodyOf(e,t,n,r){let i=`the body of ${n}`;try{if(present(e.bytes))return exactly(e.bytes,t,i);let a=e.body;if(typeof a!=`function`)throw new RangeSourceError(`invalid-reply`,`the reply to ${n} has neither bytes nor a body function`);return exactly(await untilAborted(attempt(()=>a.call(e,t)),r),t,i)}catch(t){throw discard(e),t}}function request(e,t,n,r){let i=`bytes=${t}-${n-1}`;return[i,untilAborted(attempt(()=>e({start:t,end:n,range:i,signal:r})),r,discard).then(e=>replyOf(e,i))]}function sourceOf(e,t,n,r){let read=async(i,a,o)=>{if(count(i,`start`),count(a,`end`),i>a||a>t)throw RangeError(`read needs start <= end <= size (${t}), got ${i} and ${a}`);let[s,c]=linked(n,signalOf(o,`signal`));try{if(throwIfAborted(s),i===a)return new Uint8Array;if(r&&a<=r.byteLength)return r.slice(i,a);let[n,o]=request(e,i,a,s),c=await o,l=refusal(c,i,a,t,n);if(l)throw discard(c),l;return await bodyOf(c,a-i,n,s)}finally{c()}},clamp=(e,n)=>{if(e===void 0)return n;let r=Math.round(Number(e))||0;return r<0?Math.max(t+r,0):Math.min(r,t)};return{size:t,read,slice(e,r){let i=clamp(e,0),a=Math.max(i,clamp(r,t));return{arrayBuffer:()=>read(i,a,n).then(e=>e.buffer)}}}}function rangeSource(e,t){let n=fetcherOf(e),r=objectOf(t,`init`);return sourceOf(n,count(r.size,`init.size`),signalOf(r.signal,`init.signal`),null)}async function openRangeSource(e,t={}){let n=fetcherOf(e),r=objectOf(t,`init`),i=signalOf(r.signal,`init.signal`);if(r.size!==void 0)return sourceOf(n,count(r.size,`init.size`),i,null);let a=r.headBytes===void 0?65536:count(r.headBytes,`init.headBytes`,1);throwIfAborted(i);let[o,s]=request(n,0,a,i),c=await s,l=present(c.status)?c.status:null,u=contentRangeOf(c),d=u===null?null:parseRange(u),f=present(c.contentLength)?c.contentLength:null,refuse=(e,t)=>{throw discard(c),new RangeSourceError(e,t,{status:l})};if((l===416||l===null)&&u!==null&&/^\s*bytes\s+\*\/0\s*$/i.test(u))return discard(c),sourceOf(n,0,i,new Uint8Array);let p;if(l===200)(f===null||!Number.isSafeInteger(f)||f<0||f>a)&&refuse(`unexpected-status`,`status 200 to ${o} with ${f===null?`no Content-Length`:`Content-Length ${shown(f)}`}: the server sent the whole object instead of the range, and only an object of at most ${a} bytes is accepted that way`),u!==null&&(!d||d.first!==0||d.last!==f-1||d.total!==f)&&refuse(`range-mismatch`,`Content-Range ${shown(u)} does not match the whole object of ${f} bytes`),p=f;else if(l===206||l===null&&u!==null)u===null&&refuse(`unverifiable-reply`,`the 206 reply to ${o} has no Content-Range, or does not expose it to a cross-origin page, so the object size is unknown: pass init.size`),(!d||d.total===null||d.first!==0||d.last!==Math.min(a,d.total)-1)&&refuse(`range-mismatch`,`Content-Range ${shown(u)} does not match ${o} of an object of known size`),f!==null&&f!==d.last+1&&refuse(`length-mismatch`,`Content-Length ${shown(f)} does not match Content-Range ${shown(u)}`),p=d.total;else if(l===null)return refuse(`unverifiable-reply`,`the reply to ${o} has neither a status nor a Content-Range, so it cannot be checked`);else return refuse(`unexpected-status`,`status ${shown(l)} to ${o}, expected 206`);return sourceOf(n,p,i,await bodyOf(c,Math.min(p,a),o,i))}function named(e,t){let n=e?.cause,r=n?.code??n?.message;return t?.aborted||e?.name!==`TypeError`||typeof r!=`string`?e:TypeError(`${e.message}: ${r}`,{cause:e})}function httpRange(e,t={}){let n=typeof e==`string`?e:typeof e?.href==`string`?e.href:null;if(!n)throw TypeError(`url must be a non-empty string or a URL, got ${shown(e)}`);let r=objectOf(t,`init`),i=objectOf(r.headers,`init.headers`),a=r.fetch??globalThis.fetch;if(typeof a!=`function`)throw TypeError(`httpRange needs a fetch function: pass init.fetch where globalThis.fetch does not exist`);return async({range:e,signal:t})=>{let r=new Headers(i);r.set(`range`,e),r.set(`accept-encoding`,`identity`);let fail=e=>{throw named(e,t)},o=await a(n,{headers:r,signal:t}).catch(fail),s=o.headers.get(`content-length`);return{status:o.status,contentRange:o.headers.get(`content-range`),contentLength:s===null?null:/^\s*\d+\s*$/.test(s)?Number(s):NaN,body:e=>o.body?readCapped(o.body,e,t).catch(fail):Promise.resolve(new Uint8Array),discard:()=>void o.body?.cancel().catch(noop)}}}async function readCapped(e,t,n=null){count(t,`expectedLength`);let r=signalOf(n,`signal`),next,stop,i=e;if(typeof i?.getReader==`function`){let t=e.getReader();next=()=>t.read(),stop=()=>void t.cancel().catch(noop)}else if(typeof i?.[Symbol.asyncIterator]==`function`){let t=e[Symbol.asyncIterator]();next=()=>t.next(),stop=()=>{attempt(()=>e.destroy?.()).catch(noop),attempt(()=>t.return?.()).catch(noop)}}else throw TypeError(`body must be a ReadableStream or an async iterable, got ${shown(e)}`);let a=new Uint8Array(t),o=0;try{for(;;){throwIfAborted(r);let e=await untilAborted(attempt(next),r);if(e.done)break;let n=e.value,i=ArrayBuffer.isView(n)?new Uint8Array(n.buffer,n.byteOffset,n.byteLength):tag(n)===`[object ArrayBuffer]`?new Uint8Array(n):null;if(!i)throw new RangeSourceError(`invalid-reply`,`the body gave a ${n===null?`null`:typeof n} chunk, not bytes`);if(o+i.byteLength>t)throw new RangeSourceError(`body-too-long`,`the body passed the ${t} bytes requested`);a.set(i,o),o+=i.byteLength}}catch(e){throw stop(),e}if(o<t)throw new RangeSourceError(`body-too-short`,`the body ended after ${o} of the ${t} bytes requested`);return a}exports.RangeSourceError=RangeSourceError,exports.httpRange=httpRange,exports.openRangeSource=openRangeSource,exports.rangeSource=rangeSource,exports.readCapped=readCapped;

package/dist/cjs/worker/protocol.d.cts

@@ -0,0 +1,47 @@
+import type { AnalyzeOptions, AnalyzeProgress, FileResult } from '../core/types.cjs';
+import type { ContainerFamily, WorkerEngineId } from '../plugins/types.cjs';
+export declare const PROTOCOL_VERSION = 1;
+export type WireOptions = Omit<AnalyzeOptions, 'signal' | 'onProgress'>;
+export type SkipReason = 'unsupported-container';
+export type WorkerErrorCode = 'unknown-engine' | 'protocol';
+export type AnalyzeRequest = {
+    type: 'analyze';
+    file: Blob;
+    name: string;
+    engine: WorkerEngineId;
+    options: WireOptions;
+};
+export type WarmRequest = {
+    type: 'warm';
+    engines: readonly WorkerEngineId[];
+    containers: readonly ContainerFamily[];
+};
+export type JobRequest = AnalyzeRequest | WarmRequest;
+export type WorkerRequest = {
+    v: typeof PROTOCOL_VERSION;
+    id: number;
+} & (JobRequest | {
+    type: 'cancel';
+});
+export type WorkerResponse = {
+    v: typeof PROTOCOL_VERSION;
+    id: number;
+} & ({
+    type: 'progress';
+    progress: AnalyzeProgress;
+} | {
+    type: 'result';
+    result: FileResult;
+} | {
+    type: 'skipped';
+    reason: SkipReason;
+    family: ContainerFamily | null;
+} | {
+    type: 'warmed';
+} | {
+    type: 'error';
+    message: string;
+    aborted: boolean;
+    code?: WorkerErrorCode;
+    reason?: 'load';
+});

package/dist/color/codec-string.js

@@ -0,0 +1,121 @@
+import { firstBox, u16, u32 } from "./config.js";
+import { avcConfigSps, hevcConfigSps } from "./sps.js";
+const H264_WITHOUT_EXTENSION = new Set([66, 77, 88]);
+const hex2 = (v) => v.toString(16).padStart(2, '0');
+const dec2 = (v) => String(v).padStart(2, '0');
+function reverseBits32(v) {
+    let out = 0;
+    for (let i = 0; i < 32; i++) {
+        out = out * 2 + (v & 1);
+        v >>>= 1;
+    }
+    return out;
+}
+function avcFacts(b, s, fourcc) {
+    if (s.end - s.start < 6)
+        return null;
+    const profile = b[s.start + 1];
+    const sps = avcConfigSps(b, s);
+    let q = s.start + 6;
+    for (let i = 0, n = b[s.start + 5] & 31; i < n && q + 2 <= s.end; i++)
+        q += 2 + u16(b, q);
+    if (q < s.end)
+        for (let i = 0, n = b[q++]; i < n && q + 2 <= s.end; i++)
+            q += 2 + u16(b, q);
+    const extended = !H264_WITHOUT_EXTENSION.has(profile);
+    return {
+        profile,
+        bitDepth: sps?.bitDepth ?? (!extended ? 8 : q + 4 <= s.end ? (b[q + 1] & 7) + 8 : null),
+        codecString: `${fourcc}.${hex2(profile)}${hex2(b[s.start + 2])}${hex2(b[s.start + 3])}`,
+        sps,
+    };
+}
+function hevcFacts(b, s, fourcc) {
+    if (s.end - s.start < 23)
+        return null;
+    const p = s.start;
+    const space = b[p + 1] >> 6;
+    const coded = b[p + 1] & 31;
+    const compatibility = u32(b, p + 2);
+    let profile = coded;
+    for (let i = 1; !profile && i < 32; i++)
+        if ((compatibility >>> (31 - i)) & 1)
+            profile = i;
+    let constraints = '';
+    for (let i = 5, any = false; i >= 0; i--) {
+        const c = b[p + 6 + i];
+        if (c || any) {
+            constraints = `.${c.toString(16)}${constraints}`;
+            any = true;
+        }
+    }
+    const codecString = `${fourcc}.${['', 'A', 'B', 'C'][space]}${coded}.${reverseBits32(compatibility).toString(16)}.${b[p + 1] & 0x20 ? 'H' : 'L'}${b[p + 12]}${constraints}`;
+    const sps = hevcConfigSps(b, s);
+    return { profile, bitDepth: sps?.bitDepth ?? (b[p + 17] & 7) + 8, codecString, sps };
+}
+function av1Facts(b, s) {
+    if (s.end - s.start < 4)
+        return null;
+    const profile = b[s.start + 1] >> 5;
+    const flags = b[s.start + 2];
+    const high = (flags >> 6) & 1;
+    const bitDepth = profile > 2 ? null : high ? (profile === 2 && flags & 0x20 ? 12 : 10) : 8;
+    const codecString = bitDepth === null ? null : `av01.${profile}.${dec2(b[s.start + 1] & 31)}${flags & 0x80 ? 'H' : 'M'}.${dec2(bitDepth)}`;
+    return { profile, bitDepth, codecString, sps: null };
+}
+function vp9String(profile, level, bitDepth) {
+    return profile === null || level === null || bitDepth === null ? null : `vp09.${dec2(profile)}.${dec2(level)}.${dec2(bitDepth)}`;
+}
+function vpcFacts(b, s) {
+    if (s.end - s.start < 7)
+        return null;
+    const profile = b[s.start + 4];
+    const bitDepth = b[s.start + 6] >> 4;
+    return { profile, bitDepth, codecString: vp9String(profile, b[s.start + 5], bitDepth), sps: null };
+}
+function vp9PrivateFacts(b, s) {
+    const features = new Map();
+    for (let q = s.start; q + 2 <= s.end;) {
+        const id = b[q];
+        const len = b[q + 1];
+        if (q + 2 + len > s.end)
+            break;
+        if (len === 1 && !features.has(id))
+            features.set(id, b[q + 2]);
+        q += 2 + len;
+    }
+    if (!features.size)
+        return null;
+    const profile = features.get(1) ?? null;
+    const bitDepth = features.get(3) ?? null;
+    return { profile, bitDepth, codecString: vp9String(profile, features.get(2) ?? null, bitDepth), sps: null };
+}
+export function isoConfigFacts(codecName, b, entry) {
+    const avcC = firstBox(entry, 'avcC');
+    if (codecName === 'h264' && avcC)
+        return avcFacts(b, avcC, entry.type);
+    const hvcC = firstBox(entry, 'hvcC');
+    if (codecName === 'hevc' && hvcC)
+        return hevcFacts(b, hvcC, entry.type);
+    const av1C = firstBox(entry, 'av1C');
+    if (codecName === 'av1' && av1C)
+        return av1Facts(b, av1C);
+    const vpcC = firstBox(entry, 'vpcC');
+    if (codecName === 'vp9' && vpcC)
+        return vpcFacts(b, vpcC);
+    return null;
+}
+export function matroskaConfigFacts(codecId, b, codecPrivate) {
+    if (!codecPrivate)
+        return null;
+    if (codecId === 'V_MPEG4/ISO/AVC')
+        return avcFacts(b, codecPrivate, 'avc1');
+    if (codecId === 'V_MPEGH/ISO/HEVC')
+        return hevcFacts(b, codecPrivate, 'hvc1');
+    if (codecId === 'V_AV1')
+        return av1Facts(b, codecPrivate);
+    return codecId === 'V_VP9' ? vp9PrivateFacts(b, codecPrivate) : null;
+}
+export function dolbyVisionString(fourcc, profile, level) {
+    return `${fourcc}.${dec2(profile)}.${dec2(level)}`;
+}

package/dist/color/config.js

@@ -0,0 +1,199 @@
+export const ID_VIDEO = 0xe0;
+export const ID_PIXEL_WIDTH = 0xb0;
+export const ID_PIXEL_HEIGHT = 0xba;
+export const ID_DISPLAY_WIDTH = 0x54b0;
+export const ID_DISPLAY_HEIGHT = 0x54ba;
+export const ID_DISPLAY_UNIT = 0x54b2;
+export const ID_STEREO_MODE = 0x53b8;
+export const ID_COLOUR = 0x55b0;
+export const ID_MATRIX_COEFFICIENTS = 0x55b1;
+export const ID_BITS_PER_CHANNEL = 0x55b2;
+export const ID_RANGE = 0x55b9;
+export const ID_TRANSFER_CHARACTERISTICS = 0x55ba;
+export const ID_PRIMARIES = 0x55bb;
+const ID_CODEC_ID = 0x86;
+const ID_CODEC_PRIVATE = 0x63a2;
+const ID_BLOCK_ADDITION_MAPPING = 0x41e4;
+export const ID_BLOCK_ADD_ID_TYPE = 0x41e7;
+export const ID_BLOCK_ADD_ID_EXTRA_DATA = 0x41ed;
+const VISUAL_ENTRY_HEADER = 86;
+const MAX_CODEC_ID = 64;
+const MIXED_ENTRY_TYPES = ['apcn', 'apch', 'dvpp', 'dvcp', 'jpeg'];
+export function u16(b, p) {
+    return (b[p] << 8) | b[p + 1];
+}
+export function u32(b, p) {
+    return ((b[p] << 24) | (b[p + 1] << 16) | (b[p + 2] << 8) | b[p + 3]) >>> 0;
+}
+export function i32(b, p) {
+    return (b[p] << 24) | (b[p + 1] << 16) | (b[p + 2] << 8) | b[p + 3];
+}
+export function fourccAt(b, p) {
+    return String.fromCharCode(b[p], b[p + 1], b[p + 2], b[p + 3]);
+}
+function* boxes(b, start, end, likeParser = false) {
+    let p = start;
+    while (p + 8 <= end) {
+        let size = u32(b, p);
+        const type = fourccAt(b, p + 4);
+        let header = 8;
+        if (size === 1) {
+            if (p + 16 > end || (!likeParser && u32(b, p + 8) !== 0))
+                return;
+            size = u32(b, p + 8) * 2 ** 32 + u32(b, p + 12);
+            header = 16;
+        }
+        else if (size === 0)
+            size = end - p;
+        if (likeParser && type === 'uuid')
+            header += 16;
+        if (size < header || size > Number.MAX_SAFE_INTEGER)
+            return;
+        const boxEnd = Math.min(p + size, end);
+        yield { type, start: p, end: boxEnd, payload: p + header };
+        p += size;
+    }
+}
+function sampleEntries(stsd) {
+    const out = [];
+    const top = boxes(stsd, 0, stsd.length).next();
+    if (top.done || top.value.type !== 'stsd')
+        return out;
+    const s = top.value;
+    if (s.payload + 8 > s.end)
+        return out;
+    const count = u32(stsd, s.payload + 4);
+    let seen = 0;
+    let first = '';
+    for (const e of boxes(stsd, s.payload + 8, s.end)) {
+        if (seen++ >= count)
+            break;
+        first ||= e.type;
+        if (e.type !== first && !MIXED_ENTRY_TYPES.includes(first) && (first !== 'AV1x' || e.type !== 'AVup'))
+            continue;
+        const entry = { type: e.type, children: [] };
+        out.push(entry);
+        if (e.start + VISUAL_ENTRY_HEADER > e.end)
+            continue;
+        for (const c of boxes(stsd, e.start + VISUAL_ENTRY_HEADER, e.end)) {
+            if (c.type === 'sinf') {
+                for (const f of boxes(stsd, c.payload, c.end))
+                    if (f.type === 'frma' && f.payload + 4 <= f.end)
+                        entry.type = fourccAt(stsd, f.payload);
+            }
+            entry.children.push({ type: c.type, start: c.payload, end: c.end });
+        }
+    }
+    return out;
+}
+const live = (b) => ArrayBuffer.isView(b) && b.buffer.byteLength > 0;
+const absentOrLive = (b) => b == null || live(b);
+function lastChild(b, parent, type) {
+    let last;
+    if (parent)
+        for (const c of boxes(b, parent.payload, parent.end, true))
+            if (c.type === type)
+                last = c;
+    return last;
+}
+function moovBoxes(moov, trak) {
+    const b = new Uint8Array(moov.buffer, moov.byteOffset, moov.byteLength);
+    const cut = (box) => (box ? b.subarray(box.start, box.end) : null);
+    const top = boxes(b, 0, b.length, true).next().value;
+    let mvhd;
+    let n = 0;
+    if (top?.type === 'moov') {
+        for (const c of boxes(b, top.payload, top.end, true)) {
+            if (c.type === 'mvhd')
+                mvhd = c;
+            else if (c.type === 'trak' && n++ === trak)
+                return { stsd: cut(lastChild(b, lastChild(b, lastChild(b, lastChild(b, c, 'mdia'), 'minf'), 'stbl'), 'stsd')), tkhd: cut(lastChild(b, c, 'tkhd')), mvhd: cut(mvhd) };
+        }
+    }
+    return null;
+}
+export function isoConfig(config) {
+    const found = config.family === 'isobmff' ? config : config.family === 'isobmff-moov' && live(config.moov) ? moovBoxes(config.moov, config.trak) : null;
+    return found && live(found.stsd) && absentOrLive(found.tkhd) && absentOrLive(found.mvhd) ? { bytes: found.stsd, entries: sampleEntries(found.stsd), tkhd: found.tkhd, mvhd: found.mvhd } : null;
+}
+export function firstBox(entry, type) {
+    return entry?.children.find((c) => c.type === type) ?? null;
+}
+export function boxPayload(box) {
+    if (!box)
+        return null;
+    const b = boxes(box, 0, box.length).next();
+    return b.done ? null : { start: b.value.payload, end: b.value.end };
+}
+function vint(b, p, end, marker) {
+    if (p >= end)
+        return null;
+    const first = b[p];
+    let len = 1;
+    while (len <= 8 && !(first & (0x80 >> (len - 1))))
+        len++;
+    if (len > 8 || p + len > end)
+        return null;
+    let v = marker ? first : first & (0xff >> len);
+    let ones = v === 0xff >> len;
+    for (let i = 1; i < len; i++) {
+        v = v * 256 + b[p + i];
+        ones &&= b[p + i] === 0xff;
+    }
+    return [!marker && ones ? -1 : v, len];
+}
+export function* elements(b, start, end) {
+    let p = start;
+    while (p < end) {
+        const id = vint(b, p, end, true);
+        if (!id)
+            return;
+        const size = vint(b, p + id[1], end, false);
+        if (!size || size[0] < 0)
+            return;
+        const data = p + id[1] + size[1];
+        const dataEnd = Math.min(data + size[0], end);
+        yield { id: id[0], start: data, end: dataEnd };
+        p = data + size[0];
+    }
+}
+export function elementUint(b, span) {
+    if (!span || span.end === span.start || span.end - span.start > 8)
+        return null;
+    let v = 0;
+    for (let p = span.start; p < span.end; p++)
+        v = v * 256 + b[p];
+    return v;
+}
+function children(b, span, out = new Map()) {
+    for (const e of elements(b, span.start, span.end))
+        if (e.id !== ID_COLOUR || !out.has(e.id))
+            out.set(e.id, e);
+    return out;
+}
+function codecIdAt(b, span) {
+    let id = '';
+    for (let p = span.start; p < span.end && p < span.start + MAX_CODEC_ID && b[p]; p++)
+        id += String.fromCharCode(b[p]);
+    return id;
+}
+export function matroskaConfig(config) {
+    const b = config.family === 'matroska' ? config.trackEntry : null;
+    if (!live(b))
+        return null;
+    const out = { bytes: b, codecId: '', codecPrivate: null, video: new Map(), colour: new Map(), mappings: [] };
+    for (const e of elements(b, 0, b.length)) {
+        if (e.id === ID_CODEC_ID)
+            out.codecId = codecIdAt(b, e);
+        else if (e.id === ID_CODEC_PRIVATE)
+            out.codecPrivate = e;
+        else if (e.id === ID_VIDEO)
+            children(b, e, out.video);
+        else if (e.id === ID_BLOCK_ADDITION_MAPPING)
+            out.mappings.push(children(b, e));
+    }
+    const colour = out.video.get(ID_COLOUR);
+    if (colour)
+        out.colour = children(b, colour);
+    return out;
+}

package/dist/color/index.d.ts

@@ -0,0 +1,7 @@
+import type { ColorInfo, FileResult, VideoTrackResult } from '../core/types.js';
+export type { CodecConfig, ColorInfo, ColorSource, DolbyVisionConfig } from '../core/types.js';
+export type ColorTrack = Pick<VideoTrackResult, 'codecName' | 'codecConfig'>;
+export declare function colorOf(track: ColorTrack): ColorInfo | null | undefined;
+export declare function withColor<R extends Pick<FileResult, 'videoTracks'>>(result: R, options?: {
+    keepCodecConfig?: boolean;
+}): R;

package/dist/color/index.js

@@ -0,0 +1,139 @@
+import { dolbyVisionString, isoConfigFacts, matroskaConfigFacts } from "./codec-string.js";
+import { elementUint, fourccAt, ID_BITS_PER_CHANNEL, ID_BLOCK_ADD_ID_EXTRA_DATA, ID_BLOCK_ADD_ID_TYPE, ID_MATRIX_COEFFICIENTS, ID_PRIMARIES, ID_RANGE, ID_TRANSFER_CHARACTERISTICS, isoConfig, matroskaConfig, u16, } from "./config.js";
+import { colorNames, namedCodes, UNSPECIFIED } from "./names.js";
+const DOLBY_VISION_FOURCCS = new Set(['dvh1', 'dvhe', 'dvav', 'dva1', 'dav1']);
+const DOLBY_VISION_BOXES = ['dvcC', 'dvvC', 'dvwC'];
+const DOLBY_VISION_MAPPINGS = new Set([0x64766343, 0x64767643]);
+const SPS_CODECS = new Set(['h264', 'hevc']);
+function dolbyVision(b, s) {
+    if (s.end - s.start < 4)
+        return null;
+    const p = s.start;
+    const bits = u16(b, p + 2);
+    const more = s.end - s.start >= 5;
+    return {
+        versionMajor: b[p],
+        versionMinor: b[p + 1],
+        profile: bits >> 9,
+        level: (bits >> 3) & 63,
+        rpu: (bits & 4) !== 0,
+        el: (bits & 2) !== 0,
+        bl: (bits & 1) !== 0,
+        compatibilityId: more ? b[p + 4] >> 4 : 0,
+        mdCompression: more ? (b[p + 4] >> 2) & 3 : 0,
+    };
+}
+function colrOf(b, s) {
+    if (s.end - s.start < 10)
+        return null;
+    const kind = fourccAt(b, s.start);
+    if (kind !== 'nclx' && kind !== 'nclc')
+        return null;
+    const codes = namedCodes([u16(b, s.start + 4), u16(b, s.start + 6), u16(b, s.start + 8)]);
+    return { source: 'colr', codes, fullRange: kind === 'nclx' ? (s.end - s.start >= 11 ? b[s.start + 10] >> 7 === 1 : false) : null };
+}
+function vpcOf(b, s) {
+    if (s.end - s.start < 12 || b[s.start] !== 1)
+        return null;
+    const p = s.start + 4;
+    return { source: 'vpcC', codes: namedCodes([b[p + 3], b[p + 4], b[p + 5]]), fullRange: (b[p + 2] & 1) === 1 };
+}
+function matroskaColour(b, colour) {
+    if (!colour.size)
+        return null;
+    const code = (id, reserved) => {
+        const v = elementUint(b, colour.get(id)) ?? UNSPECIFIED;
+        return reserved.includes(v) ? UNSPECIFIED : v;
+    };
+    const range = elementUint(b, colour.get(ID_RANGE));
+    return { source: 'Colour', codes: [code(ID_PRIMARIES, [0, 3]), code(ID_TRANSFER_CHARACTERISTICS, [0, 3]), code(ID_MATRIX_COEFFICIENTS, [3])], fullRange: range === 1 ? false : range === 2 ? true : null };
+}
+function hdrOf(transfer) {
+    return transfer === 'smpte2084' ? 'pq' : transfer === 'arib-std-b67' ? 'hlg' : null;
+}
+function resolve(codecName, container, facts, dv, bitDepth) {
+    const vui = SPS_CODECS.has(codecName) ? (facts?.sps?.vui ?? null) : null;
+    const specified = container !== null && container.codes.some((c) => c !== UNSPECIFIED);
+    const codes = specified ? container.codes : vui?.colour ? namedCodes(vui.colour) : null;
+    const source = specified ? container.source : vui?.colour ? 'sps' : null;
+    let fullRange = container?.fullRange ?? vui?.fullRange ?? null;
+    if (fullRange === null && codecName === 'hevc' && facts?.sps)
+        fullRange = false;
+    const [primaries, transfer, space] = colorNames(codes);
+    return {
+        range: fullRange === null ? null : fullRange ? 'pc' : 'tv',
+        primaries,
+        transfer,
+        space,
+        source: codes?.some((c) => c !== UNSPECIFIED) ? source : null,
+        bitDepth: facts?.bitDepth ?? bitDepth,
+        profile: facts?.profile ?? null,
+        codecString: facts?.codecString ?? null,
+        hdr: hdrOf(transfer),
+        dolbyVision: dv,
+    };
+}
+function isoColor(codecName, config) {
+    const iso = isoConfig(config);
+    if (!iso)
+        return undefined;
+    const first = iso.entries[0];
+    if (!first)
+        return null;
+    const b = iso.bytes;
+    let container = null;
+    let fullRange = null;
+    let dv = null;
+    for (const entry of iso.entries) {
+        for (const c of entry.children) {
+            const found = c.type === 'colr' ? colrOf(b, c) : c.type === 'vpcC' ? vpcOf(b, c) : null;
+            if (found) {
+                container = found;
+                fullRange = found.fullRange ?? fullRange;
+            }
+            if (DOLBY_VISION_BOXES.includes(c.type))
+                dv = dolbyVision(b, c) ?? dv;
+        }
+    }
+    const facts = isoConfigFacts(codecName, b, first);
+    if (dv && facts && DOLBY_VISION_FOURCCS.has(first.type))
+        facts.codecString = dolbyVisionString(first.type, dv.profile, dv.level);
+    return container || facts || dv ? resolve(codecName, container && { ...container, fullRange }, facts, dv, null) : null;
+}
+function matroskaColor(codecName, config) {
+    const mkv = matroskaConfig(config);
+    if (!mkv)
+        return undefined;
+    const b = mkv.bytes;
+    const container = matroskaColour(b, mkv.colour);
+    let dv = null;
+    for (const m of mkv.mappings) {
+        const extra = m.get(ID_BLOCK_ADD_ID_EXTRA_DATA);
+        if (DOLBY_VISION_MAPPINGS.has(elementUint(b, m.get(ID_BLOCK_ADD_ID_TYPE)) ?? -1) && extra)
+            dv = dolbyVision(b, extra) ?? dv;
+    }
+    const facts = matroskaConfigFacts(mkv.codecId, b, mkv.codecPrivate);
+    const bits = elementUint(b, mkv.colour.get(ID_BITS_PER_CHANNEL));
+    if (!container && !facts && !dv && !bits)
+        return null;
+    return resolve(codecName, container, facts, dv, bits ? bits : null);
+}
+export function colorOf(track) {
+    const config = track.codecConfig;
+    if (!config)
+        return undefined;
+    return config.family === 'matroska' ? matroskaColor(track.codecName, config) : isoColor(track.codecName, config);
+}
+export function withColor(result, options = {}) {
+    return {
+        ...result,
+        videoTracks: result.videoTracks.map((t) => {
+            if (!t.codecConfig)
+                return t;
+            const out = { ...t, color: colorOf(t) };
+            if (!options.keepCodecConfig)
+                delete out.codecConfig;
+            return out;
+        }),
+    };
+}

package/dist/color/names.js

@@ -0,0 +1,33 @@
+const PRIMARIES = 'reserved|bt709|unknown|reserved|bt470m|bt470bg|smpte170m|smpte240m|film|bt2020|smpte428|smpte431|smpte432||||||||||ebu3213'.split('|');
+const TRANSFERS = 'reserved|bt709|unknown|reserved|bt470m|bt470bg|smpte170m|smpte240m|linear|log100|log316|iec61966-2-4|bt1361e|iec61966-2-1|bt2020-10|bt2020-12|smpte2084|smpte428|arib-std-b67'.split('|');
+const MATRICES = 'gbr|bt709|unknown|reserved|fcc|bt470bg|smpte170m|smpte240m|ycgco|bt2020nc|bt2020c|smpte2085|chroma-derived-nc|chroma-derived-c|ictcp|ipt-c2|ycgco-re|ycgco-ro'.split('|');
+const EXTENDED_BASE = 256;
+const TABLES = {
+    primaries: { base: PRIMARIES, extended: ['vgamut'] },
+    transfer: { base: TRANSFERS, extended: ['vlog'] },
+    space: { base: MATRICES, extended: [] },
+};
+export const UNSPECIFIED = 2;
+export const VUI_RULE = {
+    h264: { colour: 'container-first', range: 'container-first' },
+    hevc: { colour: 'container-first', range: 'container-first' },
+};
+function nameOf(member, code) {
+    const table = TABLES[member];
+    return (code >= EXTENDED_BASE ? table.extended[code - EXTENDED_BASE] : table.base[code]) || undefined;
+}
+export function colorName(member, code) {
+    if (code === null || code === UNSPECIFIED)
+        return null;
+    return nameOf(member, code) ?? null;
+}
+export function namedOrUnspecified(member, code) {
+    return nameOf(member, code) === undefined ? UNSPECIFIED : code;
+}
+const MEMBERS = ['primaries', 'transfer', 'space'];
+export function namedCodes(codes) {
+    return MEMBERS.map((m, i) => namedOrUnspecified(m, codes[i]));
+}
+export function colorNames(codes) {
+    return codes ? MEMBERS.map((m, i) => colorName(m, codes[i])) : [null, null, null];
+}