@svta/cml-608 1.0.3 → 1.1.1

package/dist/index.js

@@ -15,10 +15,46 @@ const VerboseLevel = {
 	DEBUG: 3,
 	DATA: 3
 };
-
 //#endregion
 //#region src/CaptionsLogger.ts
 /**
+*
+* This code was ported from the dash.js project at:
+*   https://github.com/Dash-Industry-Forum/dash.js/blob/development/externals/cea608-parser.js
+*   https://github.com/Dash-Industry-Forum/dash.js/commit/8269b26a761e0853bb21d78780ed945144ecdd4d#diff-71bc295a2d6b6b7093a1d3290d53a4b2
+*
+* The original copyright appears below:
+*
+* The copyright in this software is being made available under the BSD License,
+* included below. This software may be subject to other third party and contributor
+* rights, including patent rights, and no such rights are granted under this license.
+*
+* Copyright (c) 2015-2016, DASH Industry Forum.
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without modification,
+* are permitted provided that the following conditions are met:
+*  1. Redistributions of source code must retain the above copyright notice, this
+*  list of conditions and the following disclaimer.
+*  * Redistributions in binary form must reproduce the above copyright notice,
+*  this list of conditions and the following disclaimer in the documentation and/or
+*  other materials provided with the distribution.
+*  2. Neither the name of Dash Industry Forum nor the names of its
+*  contributors may be used to endorse or promote products derived from this software
+*  without specific prior written permission.
+*
+*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
+*  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+*  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+*  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+*  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+*  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+*  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+*  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+*  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+*  POSSIBILITY OF SUCH DAMAGE.
+*/
+/**
 * CaptionsLogger. To be removed in the future.
 *
 * @public
@@ -35,7 +71,6 @@ var CaptionsLogger = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/PenState.ts
 /**
@@ -81,10 +116,46 @@ var PenState = class {
 		this.flash = newPenState.flash;
 	}
 };
-
 //#endregion
 //#region src/StyledUnicodeChar.ts
 /**
+*
+* This code was ported from the dash.js project at:
+*   https://github.com/Dash-Industry-Forum/dash.js/blob/development/externals/cea608-parser.js
+*   https://github.com/Dash-Industry-Forum/dash.js/commit/8269b26a761e0853bb21d78780ed945144ecdd4d#diff-71bc295a2d6b6b7093a1d3290d53a4b2
+*
+* The original copyright appears below:
+*
+* The copyright in this software is being made available under the BSD License,
+* included below. This software may be subject to other third party and contributor
+* rights, including patent rights, and no such rights are granted under this license.
+*
+* Copyright (c) 2015-2016, DASH Industry Forum.
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without modification,
+* are permitted provided that the following conditions are met:
+*  1. Redistributions of source code must retain the above copyright notice, this
+*  list of conditions and the following disclaimer.
+*  * Redistributions in binary form must reproduce the above copyright notice,
+*  this list of conditions and the following disclaimer in the documentation and/or
+*  other materials provided with the distribution.
+*  2. Neither the name of Dash Industry Forum nor the names of its
+*  contributors may be used to endorse or promote products derived from this software
+*  without specific prior written permission.
+*
+*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
+*  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+*  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+*  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+*  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+*  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+*  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+*  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+*  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+*  POSSIBILITY OF SUCH DAMAGE.
+*/
+/**
 * Unicode character with styling and background.
 *
 * @public
@@ -116,11 +187,6 @@ var StyledUnicodeChar = class {
 		return this.uchar === " " && this.penState.isDefault();
 	}
 };
-
-//#endregion
-//#region src/utils/NR_COLS.ts
-const NR_COLS = 100;
-
 //#endregion
 //#region src/utils/specialCea608CharsCodes.ts
 /**
@@ -218,16 +284,51 @@ const specialCea608CharsCodes = {
 	206: 9495,
 	207: 9499
 };
-
 //#endregion
 //#region src/utils/getCharForByte.ts
 function getCharForByte(byte) {
 	return String.fromCharCode(specialCea608CharsCodes[byte] || byte);
 }
-
 //#endregion
 //#region src/Row.ts
 /**
+*
+* This code was ported from the dash.js project at:
+*   https://github.com/Dash-Industry-Forum/dash.js/blob/development/externals/cea608-parser.js
+*   https://github.com/Dash-Industry-Forum/dash.js/commit/8269b26a761e0853bb21d78780ed945144ecdd4d#diff-71bc295a2d6b6b7093a1d3290d53a4b2
+*
+* The original copyright appears below:
+*
+* The copyright in this software is being made available under the BSD License,
+* included below. This software may be subject to other third party and contributor
+* rights, including patent rights, and no such rights are granted under this license.
+*
+* Copyright (c) 2015-2016, DASH Industry Forum.
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without modification,
+* are permitted provided that the following conditions are met:
+*  1. Redistributions of source code must retain the above copyright notice, this
+*  list of conditions and the following disclaimer.
+*  * Redistributions in binary form must reproduce the above copyright notice,
+*  this list of conditions and the following disclaimer in the documentation and/or
+*  other materials provided with the distribution.
+*  2. Neither the name of Dash Industry Forum nor the names of its
+*  contributors may be used to endorse or promote products derived from this software
+*  without specific prior written permission.
+*
+*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
+*  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+*  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+*  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+*  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+*  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+*  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+*  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+*  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+*  POSSIBILITY OF SUCH DAMAGE.
+*/
+/**
 * CTA-608 row consisting of NR_COLS instances of StyledUnicodeChar.
 *
 * @public
@@ -238,19 +339,19 @@ var Row = class {
 		this.cueStartTime = null;
 		this.pos = 0;
 		this.currPenState = new PenState();
-		for (let i = 0; i < NR_COLS; i++) this.chars.push(new StyledUnicodeChar());
+		for (let i = 0; i < 100; i++) this.chars.push(new StyledUnicodeChar());
 		this.logger = logger;
 	}
 	equals(other) {
-		for (let i = 0; i < NR_COLS; i++) if (!this.chars[i].equals(other.chars[i])) return false;
+		for (let i = 0; i < 100; i++) if (!this.chars[i].equals(other.chars[i])) return false;
 		return true;
 	}
 	copy(other) {
-		for (let i = 0; i < NR_COLS; i++) this.chars[i].copy(other.chars[i]);
+		for (let i = 0; i < 100; i++) this.chars[i].copy(other.chars[i]);
 	}
 	isEmpty() {
 		let empty = true;
-		for (let i = 0; i < NR_COLS; i++) if (!this.chars[i].isEmpty()) {
+		for (let i = 0; i < 100; i++) if (!this.chars[i].isEmpty()) {
 			empty = false;
 			break;
 		}
@@ -264,9 +365,9 @@ var Row = class {
 		if (this.pos < 0) {
 			this.logger.log(VerboseLevel.DEBUG, "Negative cursor position " + this.pos);
 			this.pos = 0;
-		} else if (this.pos > NR_COLS) {
+		} else if (this.pos > 100) {
 			this.logger.log(VerboseLevel.DEBUG, "Too large cursor position " + this.pos);
-			this.pos = NR_COLS;
+			this.pos = 100;
 		}
 	}
 	/**
@@ -287,7 +388,7 @@ var Row = class {
 	insertChar(byte) {
 		if (byte >= 144) this.backSpace();
 		const char = getCharForByte(byte);
-		if (this.pos >= NR_COLS) {
+		if (this.pos >= 100) {
 			this.logger.log(VerboseLevel.ERROR, () => "Cannot insert " + byte.toString(16) + " (" + char + ") at position " + this.pos + ". Skipping it!");
 			return;
 		}
@@ -296,7 +397,7 @@ var Row = class {
 	}
 	clearFromPos(startPos) {
 		let i;
-		for (i = startPos; i < NR_COLS; i++) this.chars[i].reset();
+		for (i = startPos; i < 100; i++) this.chars[i].reset();
 	}
 	clear() {
 		this.clearFromPos(0);
@@ -309,7 +410,7 @@ var Row = class {
 	getTextString() {
 		const chars = [];
 		let empty = true;
-		for (let i = 0; i < NR_COLS; i++) {
+		for (let i = 0; i < 100; i++) {
 			const char = this.chars[i].uchar;
 			if (char !== " ") empty = false;
 			chars.push(char);
@@ -322,14 +423,46 @@ var Row = class {
 		this.chars[this.pos].setPenState(this.currPenState);
 	}
 };
-
-//#endregion
-//#region src/utils/NR_ROWS.ts
-const NR_ROWS = 15;
-
 //#endregion
 //#region src/CaptionScreen.ts
 /**
+*
+* This code was ported from the dash.js project at:
+*   https://github.com/Dash-Industry-Forum/dash.js/blob/development/externals/cea608-parser.js
+*   https://github.com/Dash-Industry-Forum/dash.js/commit/8269b26a761e0853bb21d78780ed945144ecdd4d#diff-71bc295a2d6b6b7093a1d3290d53a4b2
+*
+* The original copyright appears below:
+*
+* The copyright in this software is being made available under the BSD License,
+* included below. This software may be subject to other third party and contributor
+* rights, including patent rights, and no such rights are granted under this license.
+*
+* Copyright (c) 2015-2016, DASH Industry Forum.
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without modification,
+* are permitted provided that the following conditions are met:
+*  1. Redistributions of source code must retain the above copyright notice, this
+*  list of conditions and the following disclaimer.
+*  * Redistributions in binary form must reproduce the above copyright notice,
+*  this list of conditions and the following disclaimer in the documentation and/or
+*  other materials provided with the distribution.
+*  2. Neither the name of Dash Industry Forum nor the names of its
+*  contributors may be used to endorse or promote products derived from this software
+*  without specific prior written permission.
+*
+*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
+*  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+*  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+*  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+*  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+*  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+*  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+*  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+*  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+*  POSSIBILITY OF SUCH DAMAGE.
+*/
+/**
 * Keep a CTA-608 screen of 32x15 styled characters
 *
 * @public
@@ -337,30 +470,30 @@ const NR_ROWS = 15;
 var CaptionScreen = class {
 	constructor(logger = new CaptionsLogger()) {
 		this.rows = [];
-		this.currRow = NR_ROWS - 1;
+		this.currRow = 14;
 		this.nrRollUpRows = null;
 		this.lastOutputScreen = null;
-		for (let i = 0; i < NR_ROWS; i++) this.rows.push(new Row(logger));
+		for (let i = 0; i < 15; i++) this.rows.push(new Row(logger));
 		this.logger = logger;
 	}
 	reset() {
-		for (let i = 0; i < NR_ROWS; i++) this.rows[i].clear();
-		this.currRow = NR_ROWS - 1;
+		for (let i = 0; i < 15; i++) this.rows[i].clear();
+		this.currRow = 14;
 	}
 	equals(other) {
 		let equal = true;
-		for (let i = 0; i < NR_ROWS; i++) if (!this.rows[i].equals(other.rows[i])) {
+		for (let i = 0; i < 15; i++) if (!this.rows[i].equals(other.rows[i])) {
 			equal = false;
 			break;
 		}
 		return equal;
 	}
 	copy(other) {
-		for (let i = 0; i < NR_ROWS; i++) this.rows[i].copy(other.rows[i]);
+		for (let i = 0; i < 15; i++) this.rows[i].copy(other.rows[i]);
 	}
 	isEmpty() {
 		let empty = true;
-		for (let i = 0; i < NR_ROWS; i++) if (!this.rows[i].isEmpty()) {
+		for (let i = 0; i < 15; i++) if (!this.rows[i].isEmpty()) {
 			empty = false;
 			break;
 		}
@@ -393,7 +526,7 @@ var CaptionScreen = class {
 		let newRow = pacData.row - 1;
 		if (this.nrRollUpRows && newRow < this.nrRollUpRows - 1) newRow = this.nrRollUpRows - 1;
 		if (this.nrRollUpRows && this.currRow !== newRow) {
-			for (let i = 0; i < NR_ROWS; i++) this.rows[i].clear();
+			for (let i = 0; i < 15; i++) this.rows[i].clear();
 			const topRowIndex = this.currRow + 1 - this.nrRollUpRows;
 			const lastOutputScreen = this.lastOutputScreen;
 			if (lastOutputScreen) {
@@ -451,7 +584,7 @@ var CaptionScreen = class {
 		const displayText = [];
 		let text = "";
 		let rowNr = -1;
-		for (let i = 0; i < NR_ROWS; i++) {
+		for (let i = 0; i < 15; i++) {
 			const rowText = this.rows[i].getTextString();
 			if (rowText) {
 				rowNr = i + 1;
@@ -459,15 +592,16 @@ var CaptionScreen = class {
 				else displayText.push(rowText.trim());
 			}
 		}
-		if (displayText.length > 0) if (asOneRow) text = "[" + displayText.join(" | ") + "]";
-		else text = displayText.join("\n");
+		if (displayText.length > 0) {
+			if (asOneRow) text = "[" + displayText.join(" | ") + "]";
+			else text = displayText.join("\n");
+		}
 		return text;
 	}
 	getTextAndFormat() {
 		return this.rows;
 	}
 };
-
 //#endregion
 //#region src/Cta608Channel.ts
 /**
@@ -483,7 +617,7 @@ var Cta608Channel = class {
 		this.displayedMemory = new CaptionScreen(logger);
 		this.nonDisplayedMemory = new CaptionScreen(logger);
 		this.lastOutputScreen = new CaptionScreen(logger);
-		this.currRollUpRow = this.displayedMemory.rows[NR_ROWS - 1];
+		this.currRollUpRow = this.displayedMemory.rows[14];
 		this.writeScreen = this.displayedMemory;
 		this.mode = null;
 		this.cueStartTime = null;
@@ -496,7 +630,7 @@ var Cta608Channel = class {
 		this.nonDisplayedMemory.reset();
 		this.lastOutputScreen.reset();
 		this.outputFilter?.reset?.();
-		this.currRollUpRow = this.displayedMemory.rows[NR_ROWS - 1];
+		this.currRollUpRow = this.displayedMemory.rows[14];
 		this.writeScreen = this.displayedMemory;
 		this.mode = null;
 		this.cueStartTime = null;
@@ -645,7 +779,6 @@ var Cta608Channel = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/utils/backgroundColors.ts
 const backgroundColors = [
@@ -659,7 +792,6 @@ const backgroundColors = [
 	"black",
 	"transparent"
 ];
-
 //#endregion
 //#region src/utils/createCmdHistory.ts
 function createCmdHistory() {
@@ -668,13 +800,11 @@ function createCmdHistory() {
 		b: null
 	};
 }
-
 //#endregion
 //#region src/utils/hasCmdRepeated.ts
 function hasCmdRepeated(a, b, cmdHistory) {
 	return cmdHistory.a === a && cmdHistory.b === b;
 }
-
 //#endregion
 //#region src/utils/numArrayToHexArray.ts
 function numArrayToHexArray(numArray) {
@@ -682,7 +812,6 @@ function numArrayToHexArray(numArray) {
 	for (const num of numArray) hexArray.push(num.toString(16));
 	return hexArray;
 }
-
 //#endregion
 //#region src/utils/rowsHighCh1.ts
 const rowsHighCh1 = {
@@ -694,7 +823,6 @@ const rowsHighCh1 = {
 	19: 13,
 	20: 15
 };
-
 //#endregion
 //#region src/utils/rowsHighCh2.ts
 const rowsHighCh2 = {
@@ -706,7 +834,6 @@ const rowsHighCh2 = {
 	27: 13,
 	28: 15
 };
-
 //#endregion
 //#region src/utils/rowsLowCh1.ts
 const rowsLowCh1 = {
@@ -719,7 +846,6 @@ const rowsLowCh1 = {
 	19: 12,
 	20: 14
 };
-
 //#endregion
 //#region src/utils/rowsLowCh2.ts
 const rowsLowCh2 = {
@@ -732,17 +858,52 @@ const rowsLowCh2 = {
 	27: 12,
 	28: 14
 };
-
 //#endregion
 //#region src/utils/setLastCmd.ts
 function setLastCmd(a, b, cmdHistory) {
 	cmdHistory.a = a;
 	cmdHistory.b = b;
 }
-
 //#endregion
 //#region src/Cta608Parser.ts
 /**
+*
+* This code was ported from the dash.js project at:
+*   https://github.com/Dash-Industry-Forum/dash.js/blob/development/externals/cea608-parser.js
+*   https://github.com/Dash-Industry-Forum/dash.js/commit/8269b26a761e0853bb21d78780ed945144ecdd4d#diff-71bc295a2d6b6b7093a1d3290d53a4b2
+*
+* The original copyright appears below:
+*
+* The copyright in this software is being made available under the BSD License,
+* included below. This software may be subject to other third party and contributor
+* rights, including patent rights, and no such rights are granted under this license.
+*
+* Copyright (c) 2015-2016, DASH Industry Forum.
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without modification,
+* are permitted provided that the following conditions are met:
+*  1. Redistributions of source code must retain the above copyright notice, this
+*  list of conditions and the following disclaimer.
+*  * Redistributions in binary form must reproduce the above copyright notice,
+*  this list of conditions and the following disclaimer in the documentation and/or
+*  other materials provided with the distribution.
+*  2. Neither the name of Dash Industry Forum nor the names of its
+*  contributors may be used to endorse or promote products derived from this software
+*  without specific prior written permission.
+*
+*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY
+*  EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+*  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+*  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+*  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+*  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+*  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+*  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+*  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+*  POSSIBILITY OF SUCH DAMAGE.
+*/
+/**
 * CEA-608 caption parser.
 *
 * @public
@@ -983,7 +1144,46 @@ var Cta608Parser = class {
 		for (const channel of this.channels) if (channel) channel.cueSplitAtTime(t);
 	}
 };
-
+//#endregion
+//#region src/utils/parseCcData.ts
+function isCCType(type) {
+	return type === 0 || type === 1;
+}
+function isNonEmptyCCData(ccData1, ccData2) {
+	return (ccData1 & 127) > 0 || (ccData2 & 127) > 0;
+}
+/**
+* Parse an ATSC A/53 Part 4 `cc_data()` structure into per-field byte pairs.
+*
+* The payload is identical for every carriage format — an AVC/HEVC/VVC SEI message and
+* an AV1 `metadata_itu_t_t35` OBU carry the same bytes under the same T.35/GA94
+* identifier — so this is the single parser shared by all of them. Only the envelope
+* around it differs.
+*
+* `cc_data()` is self-delimiting: `cc_count` states how many 3-byte constructs follow,
+* so anything after them (SEI `rbsp_trailing_bits`, an AV1 OBU `trailing_bits` byte) is
+* ignored without needing to be recognized.
+*
+* @param raw - The DataView holding the `cc_data()` structure
+* @param pos - The position of the first `cc_data()` byte, holding `cc_count`
+* @param endPos - The exclusive upper bound to read within
+* @param fieldData - Field 1 and field 2 byte arrays, appended to in place
+*/
+function parseCcData(raw, pos, endPos, fieldData) {
+	if (pos + 2 > endPos) return;
+	const ccCount = raw.getUint8(pos) & 31;
+	let cursor = pos + 2;
+	const ccEnd = Math.min(cursor + ccCount * 3, endPos);
+	for (; cursor + 2 < ccEnd; cursor += 3) {
+		const byte = raw.getUint8(cursor);
+		if (!(byte & 4)) continue;
+		const ccType = byte & 3;
+		if (!isCCType(ccType)) continue;
+		const ccData1 = raw.getUint8(cursor + 1);
+		const ccData2 = raw.getUint8(cursor + 2);
+		if (isNonEmptyCCData(ccData1, ccData2)) fieldData[ccType].push(ccData1, ccData2);
+	}
+}
 //#endregion
 //#region src/extractCta608Data.ts
 /**
@@ -996,33 +1196,163 @@ var Cta608Parser = class {
 * @public
 */
 function extractCta608Data(raw, cta608Range) {
-	let pos = cta608Range[0];
 	const fieldData = [[], []];
-	pos += 8;
-	const ccCount = raw.getUint8(pos) & 31;
-	pos += 2;
-	for (let i = 0; i < ccCount; i++) {
-		const byte = raw.getUint8(pos);
-		const ccValid = byte & 4;
-		const ccType = byte & 3;
-		pos++;
-		const ccData1 = raw.getUint8(pos);
-		pos++;
-		const ccData2 = raw.getUint8(pos);
-		pos++;
-		if (ccValid && (ccData1 & 127) + (ccData2 & 127) !== 0) {
-			if (ccType === 0) {
-				fieldData[0].push(ccData1);
-				fieldData[0].push(ccData2);
-			} else if (ccType === 1) {
-				fieldData[1].push(ccData1);
-				fieldData[1].push(ccData2);
-			}
-		}
+	parseCcData(raw, cta608Range[0] + 8, cta608Range[0] + cta608Range[1], fieldData);
+	return fieldData;
+}
+//#endregion
+//#region src/utils/isCta608UserData.ts
+/**
+* The 8-byte ATSC A/53 user identifier that prefixes a `cc_data()` payload, per
+* ANSI-SCTE 128: `itu_t_t35_country_code` (0xB5, USA), `terminal_provider_code`
+* (0x0031, ATSC), `terminal_provider_oriented_code` ('GA94'), and
+* `user_data_type_code` (0x03, cc_data).
+*
+* Both carriage formats use it unchanged — an AVC/HEVC/VVC
+* `user_data_registered_itu_t_t35` SEI message and an AV1 `metadata_itu_t_t35` OBU — so
+* this identifies CTA-608 user data for either.
+*
+* @param raw - The DataView holding the T.35 payload
+* @param pos - The position of `itu_t_t35_country_code`
+* @returns true when the 8 bytes at `pos` identify CTA-608 caption data
+*/
+function isCta608UserData(raw, pos) {
+	return raw.getUint8(pos) === 181 && raw.getUint16(pos + 1) === 49 && raw.getUint32(pos + 3) === 1195456820 && raw.getUint8(pos + 7) === 3;
+}
+//#endregion
+//#region src/utils/obuHelpers.ts
+/**
+* AV1 `OBU_METADATA` unit type
+*/
+const OBU_METADATA = 5;
+/**
+* AV1 `METADATA_TYPE_ITUT_T35` metadata type
+*/
+const METADATA_TYPE_ITUT_T35 = 4;
+/**
+* The maximum number of bytes in an AV1 leb128() value
+*/
+const LEB128_MAX_BYTES = 8;
+/**
+* Read an AV1 `leb128()` variable-length integer (AV1 spec section 4.10.5): up to 8
+* bytes, 7 value bits each, least significant group first, with the high bit marking
+* continuation.
+*
+* Groups are combined by multiplication rather than by `<<`, because a leb128 value may
+* exceed the 32 bits a JavaScript shift operates on.
+*
+* @param raw - The DataView to read from
+* @param pos - The position of the first leb128 byte
+* @param endPos - The exclusive upper bound to read within
+* @returns The value and its byte length, or null when it is truncated or overlong
+*/
+function readLeb128(raw, pos, endPos) {
+	let value = 0;
+	for (let i = 0; i < LEB128_MAX_BYTES; i++) {
+		if (pos + i >= endPos) return null;
+		const byte = raw.getUint8(pos + i);
+		value += (byte & 127) * 2 ** (i * 7);
+		if (!(byte & 128)) return {
+			value,
+			size: i + 1
+		};
+	}
+	return null;
+}
+/**
+* Detects whether an AV1 OBU header starts an `OBU_METADATA` unit and locates its
+* payload.
+*
+* The header is one byte — `obu_forbidden_bit` (1), `obu_type` (4),
+* `obu_extension_flag` (1), `obu_has_size_field` (1), `obu_reserved_1bit` (1) — followed
+* by an optional extension byte and, when `obu_has_size_field` is set, `obu_size` as a
+* leb128. An OBU without `obu_size` runs to the end of the temporal unit, which mp4
+* permits only for the final OBU in a sample.
+*
+* @param raw - The DataView containing the OBU
+* @param pos - The position of the OBU header byte
+* @param endPos - The exclusive end of the enclosing sample
+* @returns The payload bounds and whether this is a metadata OBU, or null if malformed
+*/
+function readObu(raw, pos, endPos) {
+	const header = raw.getUint8(pos);
+	if (header & 128) return null;
+	let payloadStart = pos + 1;
+	if (header & 4) payloadStart++;
+	let payloadEnd = endPos;
+	if (header & 2) {
+		const obuSize = readLeb128(raw, payloadStart, endPos);
+		if (!obuSize) return null;
+		payloadStart += obuSize.size;
+		payloadEnd = payloadStart + obuSize.value;
+		if (payloadEnd > endPos) return null;
+	}
+	return {
+		isMetadata: (header >> 3 & 15) === OBU_METADATA,
+		payloadStart,
+		payloadEnd
+	};
+}
+/**
+* Parse CTA-608 field data out of an AV1 metadata OBU payload, ignoring metadata OBUs
+* of any other type.
+*
+* The payload is `metadata_type` as a leb128, then — for ITU-T T.35 — the 8-byte A/53
+* user identifier and the `cc_data()` structure. Unlike an SEI NAL unit an OBU carries
+* no emulation prevention, so the bytes are read verbatim.
+*
+* @param raw - The DataView containing the OBU payload
+* @param pos - The position of `metadata_type`
+* @param endPos - The exclusive end of the OBU payload
+* @param fieldData - Field 1 and field 2 byte arrays, appended to in place
+*/
+function parseCta608DataFromMetadataObu(raw, pos, endPos, fieldData) {
+	const metadataType = readLeb128(raw, pos, endPos);
+	if (!metadataType || metadataType.value !== METADATA_TYPE_ITUT_T35) return;
+	const userDataStart = pos + metadataType.size;
+	if (userDataStart + 10 > endPos || !isCta608UserData(raw, userDataStart)) return;
+	parseCcData(raw, userDataStart + 8, endPos, fieldData);
+}
+//#endregion
+//#region src/extractCta608DataFromAv1Sample.ts
+/**
+* Extracts CTA-608 data from an AV1 (`av01`) sample.
+*
+* AV1 has no NAL units, so captions ride in an `metadata_itu_t_t35` OBU rather than in
+* an SEI message. The caption payload is unchanged — the same A/53 `cc_data()` under the
+* same T.35/GA94 identifier that {@link extractCta608DataFromSample} reads — so the
+* returned field data feeds {@link Cta608Parser} identically.
+*
+* This is a separate function rather than a codec branch inside
+* {@link extractCta608DataFromSample} because the two carriages are framed differently and
+* neither sample is self-identifying. A NAL unit sample puts a fixed-width big-endian
+* length in front of each unit, and that width is only known from `lengthSizeMinusOne` in
+* the `avcC`/`hvcC` config. An AV1 sample uses the low-overhead format, where each OBU
+* carries its own `obu_size` after the header — and may omit it on the last OBU. Select on
+* the sample entry type (`av01`) instead.
+*
+* @param raw - The DataView with media data
+* @param startPos - The start position of the sample within the DataView
+* @param sampleSize - The size of the sample in bytes
+* @returns fieldData array containing field 1 and field 2 data arrays
+*
+* @example
+* {@includeCode ../test/extractCta608DataFromAv1Sample.test.ts#example}
+*
+* @public
+*/
+function extractCta608DataFromAv1Sample(raw, startPos, sampleSize) {
+	const fieldData = [[], []];
+	const endPos = Math.min(startPos + sampleSize, raw.byteLength);
+	let cursor = startPos;
+	while (cursor < endPos) {
+		const obu = readObu(raw, cursor, endPos);
+		if (!obu) break;
+		if (obu.isMetadata) parseCta608DataFromMetadataObu(raw, obu.payloadStart, obu.payloadEnd, fieldData);
+		cursor = Math.max(obu.payloadEnd, cursor + 1);
 	}
 	return fieldData;
 }
-
 //#endregion
 //#region src/utils/seiHelpers.ts
 function getSeiData(raw, startPos, endPos) {
@@ -1036,17 +1366,7 @@ function getSeiData(raw, startPos, endPos) {
 }
 function isCea608Sei(payloadType, payloadSize, sei, pos) {
 	if (payloadType !== 4 || payloadSize < 8) return false;
-	if (sei.getUint8(pos) !== 181) return false;
-	if (sei.getUint16(pos + 1) !== 49) return false;
-	if (sei.getUint32(pos + 3) !== 1195456820) return false;
-	if (sei.getUint8(pos + 7) !== 3) return false;
-	return true;
-}
-function isCCType(type) {
-	return type === 0 || type === 1;
-}
-function isNonEmptyCCData(ccData1, ccData2) {
-	return (ccData1 & 127) > 0 || (ccData2 & 127) > 0;
+	return isCta608UserData(sei, pos);
 }
 /**
 * H.264 SEI NAL unit type
@@ -1113,25 +1433,10 @@ function parseCta608DataFromSei(sei, fieldData) {
 		do
 			payloadSize += now = sei.getUint8(cursor++);
 		while (now === 255);
-		if (isCea608Sei(payloadType, payloadSize, sei, cursor)) {
-			const pos = cursor + 10;
-			const ccCount = pos + (sei.getUint8(pos - 2) & 31) * 3;
-			for (let i = pos; i < ccCount; i += 3) {
-				const byte = sei.getUint8(i);
-				if (byte & 4) {
-					const ccType = byte & 3;
-					if (isCCType(ccType)) {
-						const ccData1 = sei.getUint8(i + 1);
-						const ccData2 = sei.getUint8(i + 2);
-						if (isNonEmptyCCData(ccData1, ccData2)) fieldData[ccType].push(ccData1, ccData2);
-					}
-				}
-			}
-		}
+		if (isCea608Sei(payloadType, payloadSize, sei, cursor)) parseCcData(sei, cursor + 8, cursor + payloadSize, fieldData);
 		cursor += payloadSize;
 	}
 }
-
 //#endregion
 //#region src/extractCta608DataFromSample.ts
 /**
@@ -1160,7 +1465,6 @@ function extractCta608DataFromSample(raw, startPos, sampleSize) {
 	}
 	return fieldData;
 }
-
 //#endregion
 //#region src/findCta608Nalus.ts
 /**
@@ -1176,12 +1480,12 @@ function extractCta608DataFromSample(raw, startPos, sampleSize) {
 function findCta608Nalus(raw, startPos, size) {
 	let nalSize = 0, cursor = startPos;
 	const cta608NaluRanges = [];
-	const isCTA608SEI = (payloadType, payloadSize, raw$1, pos) => {
+	const isCTA608SEI = (payloadType, payloadSize, raw, pos) => {
 		if (payloadType !== 4 || payloadSize < 8) return null;
-		const countryCode = raw$1.getUint8(pos);
-		const providerCode = raw$1.getUint16(pos + 1);
-		const userIdentifier = raw$1.getUint32(pos + 3);
-		const userDataTypeCode = raw$1.getUint8(pos + 7);
+		const countryCode = raw.getUint8(pos);
+		const providerCode = raw.getUint16(pos + 1);
+		const userIdentifier = raw.getUint32(pos + 3);
+		const userDataTypeCode = raw.getUint8(pos + 7);
 		return countryCode == 181 && providerCode == 49 && userIdentifier == 1195456820 && userDataTypeCode == 3;
 	};
 	while (cursor < startPos + size) {
@@ -1213,7 +1517,6 @@ function findCta608Nalus(raw, startPos, size) {
 	}
 	return cta608NaluRanges;
 }
-
 //#endregion
 //#region src/SccParser.ts
 /**
@@ -1307,7 +1610,7 @@ var SccParser = class {
 		return this.nrLinesParsed;
 	}
 };
-
 //#endregion
-export { CaptionScreen, CaptionsLogger, Cta608Channel, Cta608Parser, PenState, Row, SccParser, StyledUnicodeChar, VerboseLevel, extractCta608Data, extractCta608DataFromSample, findCta608Nalus };
+export { CaptionScreen, CaptionsLogger, Cta608Channel, Cta608Parser, PenState, Row, SccParser, StyledUnicodeChar, VerboseLevel, extractCta608Data, extractCta608DataFromAv1Sample, extractCta608DataFromSample, findCta608Nalus };
+
 //# sourceMappingURL=index.js.map