@sarakusha/ebml 0.0.4

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+
+### 0.0.4 (2026-05-25)

package/README.md

@@ -0,0 +1,43 @@
+# @sarakusha/ebml
+
+Yet another library for parsing [EBML](http://ebml.sourceforge.net/). The main difference from existing libraries is browser support.
+Instead of a [Node Stream API](https://nodejs.org/api/stream.html#stream_class_stream_transform) and buffers, the [Web Streams API](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) and typed arrays (```Uint8Array```) are used. Of course you can use it for node.js too. Another difference is that the library is built automatically from official [EBML](https://raw.githubusercontent.com/ietf-wg-cellar/ebml-specification/master/ebml.xml) and [matroska](https://raw.githubusercontent.com/ietf-wg-cellar/matroska-specification/master/ebml_matroska.xml) specifications.
+
+> This library is written in typescript from scratch and is not a fork of existing libraries.
+
+# Caveat
+This version of the library only supports EBML decoding.
+
+# Usage
+
+The EbmlDecoder class is implemented as a [```TransformStream``` ](https://developer.mozilla.org/en-US/docs/Web/API/TransformStream) of the Streams API. The input to this transform function should be binary EBML, provided in a Uint8Array. The output of the stream is a series of ```Element``` objects.
+
+```ts
+// The base interface
+interface Element {
+  // The id of the EBML tag in hexadecimal format.
+  id: HexID;
+  // The data type of the EBML tag
+  type: ElementType;
+  // The name of the EBML tag
+  name: string;
+  // The total size of the tag in bytes
+  size: number;
+  // Tag attributes from the official specification.
+  spec?: ElementSpec;
+}
+
+type ElementType =
+  | 'master' /* master element (contains other EBML sub-elements of the next lower level) */
+  | 'uinteger' /* unsigned integer. Some of these are UIDs, coded as 128-bit numbers */
+  | 'integer' /* signed integer */
+  | 'float' /* IEEE-754 floating point number */
+  | 'string' /* printable ASCII text string */
+  | 'utf-8' /* printable utf-8 Unicode text string */
+  | 'date' /* a 64-bit signed timestamp, in nanoseconds after (or before) `2001-01-01T00:00UTC` */
+  | 'binary' /* binary data, otherwise uninterpreted */
+  | 'unknown';
+```
+There are two base 'flavors' of `Element`:
+* ```MasterElement``` is element that contains one or more child elements.
+* ```ContentElement``` is a tag element only contains data.

package/build/CancelError.cjs

@@ -0,0 +1,14 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region src/CancelError.ts
+var CancelError = class extends Error {
+	constructor(message = "Canceled by user") {
+		super(message);
+	}
+};
+//#endregion
+exports.default = CancelError;
+
+//# sourceMappingURL=CancelError.cjs.map

package/build/CancelError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CancelError.cjs","names":[],"sources":["../src/CancelError.ts"],"sourcesContent":["export default class CancelError extends Error {\n  constructor(message = 'Canceled by user') {\n    super(message);\n  }\n}\n"],"mappings":";;;;;AAAA,IAAqB,cAArB,cAAyC,MAAM;CAC7C,YAAY,UAAU,oBAAoB;EACxC,MAAM,OAAO;CACf;AACF"}

package/build/CancelError.d.cts

@@ -0,0 +1 @@
+export type * from './CancelError.d.mts'

package/build/CancelError.d.mts

@@ -0,0 +1,7 @@
+//#region src/CancelError.d.ts
+declare class CancelError extends Error {
+  constructor(message?: string);
+}
+//#endregion
+export { CancelError as default };
+//# sourceMappingURL=CancelError.d.mts.map

package/build/CancelError.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CancelError.d.mts","names":[],"sources":["../src/CancelError.ts"],"mappings":";cAAqB,WAAA,SAAoB,KAAK;cAChC,OAAA;AAAA"}

package/build/CancelError.mjs

@@ -0,0 +1,10 @@
+//#region src/CancelError.ts
+var CancelError = class extends Error {
+	constructor(message = "Canceled by user") {
+		super(message);
+	}
+};
+//#endregion
+export { CancelError as default };
+
+//# sourceMappingURL=CancelError.mjs.map

package/build/CancelError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CancelError.mjs","names":[],"sources":["../src/CancelError.ts"],"sourcesContent":["export default class CancelError extends Error {\n  constructor(message = 'Canceled by user') {\n    super(message);\n  }\n}\n"],"mappings":";AAAA,IAAqB,cAArB,cAAyC,MAAM;CAC7C,YAAY,UAAU,oBAAoB;EACxC,MAAM,OAAO;CACf;AACF"}

package/build/Deferred-7Cu0KIje.mjs

@@ -0,0 +1,28 @@
+//#region src/Deferred.ts
+var Deferred = class {
+	promise;
+	#resolve;
+	#reject;
+	constructor() {
+		this.promise = new Promise((resolve, reject) => {
+			this.#resolve = resolve;
+			this.#reject = reject;
+		});
+	}
+	resolve = (result) => {
+		const resolve = this.#resolve;
+		this.#resolve = void 0;
+		this.#reject = void 0;
+		if (resolve) resolve(result);
+	};
+	reject = (err) => {
+		const reject = this.#reject;
+		this.#resolve = void 0;
+		this.#reject = void 0;
+		if (reject) reject(err);
+	};
+};
+//#endregion
+export { Deferred as t };
+
+//# sourceMappingURL=Deferred-7Cu0KIje.mjs.map

package/build/Deferred-7Cu0KIje.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deferred-7Cu0KIje.mjs","names":["#resolve","#reject"],"sources":["../src/Deferred.ts"],"sourcesContent":["export default class Deferred<T = void> {\n  readonly promise: Promise<T>;\n\n  #resolve: undefined | ((result: T) => void);\n\n  #reject: undefined | ((error: Error) => void);\n\n  constructor() {\n    this.promise = new Promise<T>((resolve, reject) => {\n      this.#resolve = resolve;\n      this.#reject = reject;\n    });\n  }\n\n  readonly resolve = (result: T): void => {\n    const resolve = this.#resolve;\n    this.#resolve = undefined;\n    this.#reject = undefined;\n    if (resolve) {\n      resolve(result);\n    }\n  };\n\n  readonly reject = (err: Error): void => {\n    const reject = this.#reject;\n    this.#resolve = undefined;\n    this.#reject = undefined;\n    if (reject) {\n      reject(err);\n    }\n  };\n}\n"],"mappings":";AAAA,IAAqB,WAArB,MAAwC;CACtC;CAEA;CAEA;CAEA,cAAc;EACZ,KAAK,UAAU,IAAI,SAAY,SAAS,WAAW;GACjD,KAAKA,WAAW;GAChB,KAAKC,UAAU;EACjB,CAAC;CACH;CAEA,WAAoB,WAAoB;EACtC,MAAM,UAAU,KAAKD;EACrB,KAAKA,WAAW,KAAA;EAChB,KAAKC,UAAU,KAAA;EACf,IAAI,SACF,QAAQ,MAAM;CAElB;CAEA,UAAmB,QAAqB;EACtC,MAAM,SAAS,KAAKA;EACpB,KAAKD,WAAW,KAAA;EAChB,KAAKC,UAAU,KAAA;EACf,IAAI,QACF,OAAO,GAAG;CAEd;AACF"}

package/build/Deferred-CB69mtbF.cjs

@@ -0,0 +1,33 @@
+//#region src/Deferred.ts
+var Deferred = class {
+	promise;
+	#resolve;
+	#reject;
+	constructor() {
+		this.promise = new Promise((resolve, reject) => {
+			this.#resolve = resolve;
+			this.#reject = reject;
+		});
+	}
+	resolve = (result) => {
+		const resolve = this.#resolve;
+		this.#resolve = void 0;
+		this.#reject = void 0;
+		if (resolve) resolve(result);
+	};
+	reject = (err) => {
+		const reject = this.#reject;
+		this.#resolve = void 0;
+		this.#reject = void 0;
+		if (reject) reject(err);
+	};
+};
+//#endregion
+Object.defineProperty(exports, "Deferred", {
+	enumerable: true,
+	get: function() {
+		return Deferred;
+	}
+});
+
+//# sourceMappingURL=Deferred-CB69mtbF.cjs.map

package/build/Deferred-CB69mtbF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deferred-CB69mtbF.cjs","names":["#resolve","#reject"],"sources":["../src/Deferred.ts"],"sourcesContent":["export default class Deferred<T = void> {\n  readonly promise: Promise<T>;\n\n  #resolve: undefined | ((result: T) => void);\n\n  #reject: undefined | ((error: Error) => void);\n\n  constructor() {\n    this.promise = new Promise<T>((resolve, reject) => {\n      this.#resolve = resolve;\n      this.#reject = reject;\n    });\n  }\n\n  readonly resolve = (result: T): void => {\n    const resolve = this.#resolve;\n    this.#resolve = undefined;\n    this.#reject = undefined;\n    if (resolve) {\n      resolve(result);\n    }\n  };\n\n  readonly reject = (err: Error): void => {\n    const reject = this.#reject;\n    this.#resolve = undefined;\n    this.#reject = undefined;\n    if (reject) {\n      reject(err);\n    }\n  };\n}\n"],"mappings":";AAAA,IAAqB,WAArB,MAAwC;CACtC;CAEA;CAEA;CAEA,cAAc;EACZ,KAAK,UAAU,IAAI,SAAY,SAAS,WAAW;GACjD,KAAKA,WAAW;GAChB,KAAKC,UAAU;EACjB,CAAC;CACH;CAEA,WAAoB,WAAoB;EACtC,MAAM,UAAU,KAAKD;EACrB,KAAKA,WAAW,KAAA;EAChB,KAAKC,UAAU,KAAA;EACf,IAAI,SACF,QAAQ,MAAM;CAElB;CAEA,UAAmB,QAAqB;EACtC,MAAM,SAAS,KAAKA;EACpB,KAAKD,WAAW,KAAA;EAChB,KAAKC,UAAU,KAAA;EACf,IAAI,QACF,OAAO,GAAG;CAEd;AACF"}

package/build/Element-8JyOKTYb.cjs

@@ -0,0 +1,73 @@
+//#region src/Element.ts
+let BlockLacing = /* @__PURE__ */ function(BlockLacing) {
+	BlockLacing[BlockLacing["None"] = 0] = "None";
+	BlockLacing[BlockLacing["Xiph"] = 1] = "Xiph";
+	BlockLacing[BlockLacing["EBML"] = 2] = "EBML";
+	BlockLacing[BlockLacing["FixedSize"] = 3] = "FixedSize";
+	return BlockLacing;
+}({});
+const isMasterElement = (element) => element.type === "master";
+const isContentElement = (element) => element.type !== "master";
+const isBlockElement = (element) => element.id === "0xA1";
+const isBlockGroupElement = (element) => element.name === "BlockGroup";
+const isSimpleBlockElement = (element) => element.id === "0xA3";
+const isTrackType = (value) => value.name === "TrackType";
+const isTimestamp = (value) => value.name === "Timestamp";
+const isDuration = (value) => value.name === "Duration";
+//#endregion
+Object.defineProperty(exports, "BlockLacing", {
+	enumerable: true,
+	get: function() {
+		return BlockLacing;
+	}
+});
+Object.defineProperty(exports, "isBlockElement", {
+	enumerable: true,
+	get: function() {
+		return isBlockElement;
+	}
+});
+Object.defineProperty(exports, "isBlockGroupElement", {
+	enumerable: true,
+	get: function() {
+		return isBlockGroupElement;
+	}
+});
+Object.defineProperty(exports, "isContentElement", {
+	enumerable: true,
+	get: function() {
+		return isContentElement;
+	}
+});
+Object.defineProperty(exports, "isDuration", {
+	enumerable: true,
+	get: function() {
+		return isDuration;
+	}
+});
+Object.defineProperty(exports, "isMasterElement", {
+	enumerable: true,
+	get: function() {
+		return isMasterElement;
+	}
+});
+Object.defineProperty(exports, "isSimpleBlockElement", {
+	enumerable: true,
+	get: function() {
+		return isSimpleBlockElement;
+	}
+});
+Object.defineProperty(exports, "isTimestamp", {
+	enumerable: true,
+	get: function() {
+		return isTimestamp;
+	}
+});
+Object.defineProperty(exports, "isTrackType", {
+	enumerable: true,
+	get: function() {
+		return isTrackType;
+	}
+});
+
+//# sourceMappingURL=Element-8JyOKTYb.cjs.map

package/build/Element-8JyOKTYb.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Element-8JyOKTYb.cjs","names":[],"sources":["../src/Element.ts"],"sourcesContent":["import type { ElementSpec, ElementType, HexID } from './ElementSpec';\n\nexport const enum BlockLacing {\n  None,\n  Xiph,\n  EBML,\n  FixedSize,\n}\n\ninterface ContentTypeMap extends Record<ElementType, number | bigint | string | Date | Uint8Array> {\n  uinteger: number | bigint;\n  integer: number | bigint;\n  float: number;\n  string: string;\n  'utf-8': string;\n  date: Date;\n  binary: number;\n  unknown: Uint8Array;\n}\n\nexport interface Element {\n  id: HexID;\n  type: ElementType;\n  name: string;\n  size: number;\n  spec?: ElementSpec;\n}\n\ntype ContentElementType = Exclude<ElementType, 'master'>;\n\nexport interface ContentElement<T extends ContentElementType = ContentElementType> extends Element {\n  type: T;\n  data: Uint8Array;\n  value: ContentTypeMap[T];\n}\n\nexport interface MasterElement extends Element {\n  type: 'master';\n  isClosing?: true;\n}\n\nexport interface BlockElement extends ContentElement<'binary'> {\n  id: '0xA1';\n  /** the coded information in the element */\n  payload: Uint8Array;\n  /** unsigned integer indicating the payload's track */\n  track: number;\n  /** the block's Timecode value */\n  value: number;\n  /** the codec SHOULD decode this frame but not display it */\n  invisible?: true;\n  /** Lacing is only useful for small contiguous data to save space.\n   *  This is usually the case for audio tracks and not the case for\n   *  video -- which use a lot of data -- or subtitle tracks -- which have long gaps. */\n  lacing?: BlockLacing;\n}\n\nexport interface SimpleBlockElement extends Omit<BlockElement, 'id'> {\n  id: '0xA3';\n  /** set to `true` if the payload starts an I frame */\n  keyframe?: true;\n  /** the frames of the Block can be discarded during playing if needed */\n  discardable?: true;\n}\n\nexport const isMasterElement = (element: Element): element is MasterElement =>\n  element.type === 'master';\n\nexport const isContentElement = (element: Element): element is ContentElement<ContentElementType> =>\n  element.type !== 'master';\n\nexport const isBlockElement = (element: Element): element is BlockElement => element.id === '0xA1';\n\nexport const isBlockGroupElement = (element: Element): element is MasterElement =>\n  element.name === 'BlockGroup';\n\nexport const isSimpleBlockElement = (element: Element): element is SimpleBlockElement =>\n  element.id === '0xA3';\n\nexport const isTrackType = (value: Element): value is ContentElement<'uinteger'> =>\n  value.name === 'TrackType';\n\nexport const isTimestamp = (value: Element): value is ContentElement<'uinteger'> =>\n  value.name === 'Timestamp';\n\nexport const isDuration = (value: Element): value is ContentElement<'float'> =>\n  value.name === 'Duration';\n"],"mappings":";AAEA,IAAkB,cAAX,yBAAA,aAAA;CACL,YAAA,YAAA,UAAA,KAAA;CACA,YAAA,YAAA,UAAA,KAAA;CACA,YAAA,YAAA,UAAA,KAAA;CACA,YAAA,YAAA,eAAA,KAAA;;AACF,EAAA,CAAA,CAAA;AA0DA,MAAa,mBAAmB,YAC9B,QAAQ,SAAS;AAEnB,MAAa,oBAAoB,YAC/B,QAAQ,SAAS;AAEnB,MAAa,kBAAkB,YAA8C,QAAQ,OAAO;AAE5F,MAAa,uBAAuB,YAClC,QAAQ,SAAS;AAEnB,MAAa,wBAAwB,YACnC,QAAQ,OAAO;AAEjB,MAAa,eAAe,UAC1B,MAAM,SAAS;AAEjB,MAAa,eAAe,UAC1B,MAAM,SAAS;AAEjB,MAAa,cAAc,UACzB,MAAM,SAAS"}

package/build/Element-CC4E6wMR.d.mts

@@ -0,0 +1,134 @@
+//#region src/ElementSpec.d.ts
+type ElementType = 'master' | 'uinteger' | 'integer' | 'float' | 'string' | 'utf-8' | 'date' | 'binary' | 'unknown';
+type HexID = `0x${string}`;
+type Count = `${bigint}`;
+type TRUE = '1';
+type Purpose = 'definition' | 'rationale' | 'usage notes';
+type Documentation<P extends Purpose = 'definition'> = {
+  '#text': string;
+  '@_lang': string;
+  '@_purpose': P;
+};
+type ExtraDocumentation = [Documentation, Documentation<'rationale'> | Documentation<'usage notes'>];
+type WebmExtension = {
+  '@_type': 'webmproject.org';
+  '@_webm': TRUE;
+};
+type MatroskaExtension = {
+  '@_type': 'libmatroska';
+  '@_cppname': string;
+};
+type DivXExtension = {
+  '@_type': 'divx.com';
+  '@_divx': TRUE;
+};
+type StreamCopyExtension = {
+  '@_type': 'stream copy';
+  '@_keep': TRUE;
+};
+type Extension = WebmExtension | MatroskaExtension | DivXExtension | StreamCopyExtension;
+type EnumValue = {
+  documentation?: Documentation | Documentation[];
+  '@_value': string;
+  '@_label': string;
+};
+type EnumRestriction = {
+  enum: EnumValue[];
+};
+type Restriction = EnumRestriction;
+type PathChain = `\\${string}`;
+type MAXIMUM_ALLOWED_LEVEL = 8;
+type Last<T extends string[]> = T extends [...unknown[], infer L] ? L : never;
+type ConcatPrevious<T extends string[]> = Last<T> extends string ? `${Last<T>}${PathChain}` : never;
+type Mapped<N extends number, Result extends string[] = [PathChain]> = Result['length'] extends N ? Result : Mapped<N, [...Result, ConcatPrevious<Result>]>;
+/**
+ * https://stackoverflow.com/a/70720063/5267202
+ */
+type Path = Mapped<MAXIMUM_ALLOWED_LEVEL>[number];
+type ElementSpec = {
+  '@_name': string;
+  '@_path': Path;
+  '@_id': HexID;
+  '@_type': ElementType;
+  '@_range'?: string;
+  '@_default'?: string;
+  '@_minOccurs'?: Count;
+  '@_maxOccurs'?: Count;
+  '@_length'?: Count;
+  '@_minver'?: Count;
+  '@_maxver'?: Count;
+  '@_unknownsizeallowed'?: TRUE;
+  '@_recurring'?: TRUE;
+  '@_recursive'?: TRUE;
+  documentation?: Documentation | ExtraDocumentation;
+  extension?: Extension | Extension[];
+  restriction?: Restriction;
+};
+//#endregion
+//#region src/Element.d.ts
+declare const enum BlockLacing {
+  None = 0,
+  Xiph = 1,
+  EBML = 2,
+  FixedSize = 3
+}
+interface ContentTypeMap extends Record<ElementType, number | bigint | string | Date | Uint8Array> {
+  uinteger: number | bigint;
+  integer: number | bigint;
+  float: number;
+  string: string;
+  'utf-8': string;
+  date: Date;
+  binary: number;
+  unknown: Uint8Array;
+}
+interface Element {
+  id: HexID;
+  type: ElementType;
+  name: string;
+  size: number;
+  spec?: ElementSpec;
+}
+type ContentElementType = Exclude<ElementType, 'master'>;
+interface ContentElement<T extends ContentElementType = ContentElementType> extends Element {
+  type: T;
+  data: Uint8Array;
+  value: ContentTypeMap[T];
+}
+interface MasterElement extends Element {
+  type: 'master';
+  isClosing?: true;
+}
+interface BlockElement extends ContentElement<'binary'> {
+  id: '0xA1';
+  /** the coded information in the element */
+  payload: Uint8Array;
+  /** unsigned integer indicating the payload's track */
+  track: number;
+  /** the block's Timecode value */
+  value: number;
+  /** the codec SHOULD decode this frame but not display it */
+  invisible?: true;
+  /** Lacing is only useful for small contiguous data to save space.
+   *  This is usually the case for audio tracks and not the case for
+   *  video -- which use a lot of data -- or subtitle tracks -- which have long gaps. */
+  lacing?: BlockLacing;
+}
+interface SimpleBlockElement extends Omit<BlockElement, 'id'> {
+  id: '0xA3';
+  /** set to `true` if the payload starts an I frame */
+  keyframe?: true;
+  /** the frames of the Block can be discarded during playing if needed */
+  discardable?: true;
+}
+declare const isMasterElement: (element: Element) => element is MasterElement;
+declare const isContentElement: (element: Element) => element is ContentElement<ContentElementType>;
+declare const isBlockElement: (element: Element) => element is BlockElement;
+declare const isBlockGroupElement: (element: Element) => element is MasterElement;
+declare const isSimpleBlockElement: (element: Element) => element is SimpleBlockElement;
+declare const isTrackType: (value: Element) => value is ContentElement<"uinteger">;
+declare const isTimestamp: (value: Element) => value is ContentElement<"uinteger">;
+declare const isDuration: (value: Element) => value is ContentElement<"float">;
+//#endregion
+export { MasterElement as a, isBlockGroupElement as c, isMasterElement as d, isSimpleBlockElement as f, Element as i, isContentElement as l, isTrackType as m, BlockLacing as n, SimpleBlockElement as o, isTimestamp as p, ContentElement as r, isBlockElement as s, BlockElement as t, isDuration as u };
+//# sourceMappingURL=Element-CC4E6wMR.d.mts.map

package/build/Element-CC4E6wMR.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Element-CC4E6wMR.d.mts","names":[],"sources":["../src/ElementSpec.ts","../src/Element.ts"],"mappings":"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"}

package/build/Element-ChEar-fo.mjs

@@ -0,0 +1,20 @@
+//#region src/Element.ts
+let BlockLacing = /* @__PURE__ */ function(BlockLacing) {
+	BlockLacing[BlockLacing["None"] = 0] = "None";
+	BlockLacing[BlockLacing["Xiph"] = 1] = "Xiph";
+	BlockLacing[BlockLacing["EBML"] = 2] = "EBML";
+	BlockLacing[BlockLacing["FixedSize"] = 3] = "FixedSize";
+	return BlockLacing;
+}({});
+const isMasterElement = (element) => element.type === "master";
+const isContentElement = (element) => element.type !== "master";
+const isBlockElement = (element) => element.id === "0xA1";
+const isBlockGroupElement = (element) => element.name === "BlockGroup";
+const isSimpleBlockElement = (element) => element.id === "0xA3";
+const isTrackType = (value) => value.name === "TrackType";
+const isTimestamp = (value) => value.name === "Timestamp";
+const isDuration = (value) => value.name === "Duration";
+//#endregion
+export { isDuration as a, isTimestamp as c, isContentElement as i, isTrackType as l, isBlockElement as n, isMasterElement as o, isBlockGroupElement as r, isSimpleBlockElement as s, BlockLacing as t };
+
+//# sourceMappingURL=Element-ChEar-fo.mjs.map

package/build/Element-ChEar-fo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Element-ChEar-fo.mjs","names":[],"sources":["../src/Element.ts"],"sourcesContent":["import type { ElementSpec, ElementType, HexID } from './ElementSpec';\n\nexport const enum BlockLacing {\n  None,\n  Xiph,\n  EBML,\n  FixedSize,\n}\n\ninterface ContentTypeMap extends Record<ElementType, number | bigint | string | Date | Uint8Array> {\n  uinteger: number | bigint;\n  integer: number | bigint;\n  float: number;\n  string: string;\n  'utf-8': string;\n  date: Date;\n  binary: number;\n  unknown: Uint8Array;\n}\n\nexport interface Element {\n  id: HexID;\n  type: ElementType;\n  name: string;\n  size: number;\n  spec?: ElementSpec;\n}\n\ntype ContentElementType = Exclude<ElementType, 'master'>;\n\nexport interface ContentElement<T extends ContentElementType = ContentElementType> extends Element {\n  type: T;\n  data: Uint8Array;\n  value: ContentTypeMap[T];\n}\n\nexport interface MasterElement extends Element {\n  type: 'master';\n  isClosing?: true;\n}\n\nexport interface BlockElement extends ContentElement<'binary'> {\n  id: '0xA1';\n  /** the coded information in the element */\n  payload: Uint8Array;\n  /** unsigned integer indicating the payload's track */\n  track: number;\n  /** the block's Timecode value */\n  value: number;\n  /** the codec SHOULD decode this frame but not display it */\n  invisible?: true;\n  /** Lacing is only useful for small contiguous data to save space.\n   *  This is usually the case for audio tracks and not the case for\n   *  video -- which use a lot of data -- or subtitle tracks -- which have long gaps. */\n  lacing?: BlockLacing;\n}\n\nexport interface SimpleBlockElement extends Omit<BlockElement, 'id'> {\n  id: '0xA3';\n  /** set to `true` if the payload starts an I frame */\n  keyframe?: true;\n  /** the frames of the Block can be discarded during playing if needed */\n  discardable?: true;\n}\n\nexport const isMasterElement = (element: Element): element is MasterElement =>\n  element.type === 'master';\n\nexport const isContentElement = (element: Element): element is ContentElement<ContentElementType> =>\n  element.type !== 'master';\n\nexport const isBlockElement = (element: Element): element is BlockElement => element.id === '0xA1';\n\nexport const isBlockGroupElement = (element: Element): element is MasterElement =>\n  element.name === 'BlockGroup';\n\nexport const isSimpleBlockElement = (element: Element): element is SimpleBlockElement =>\n  element.id === '0xA3';\n\nexport const isTrackType = (value: Element): value is ContentElement<'uinteger'> =>\n  value.name === 'TrackType';\n\nexport const isTimestamp = (value: Element): value is ContentElement<'uinteger'> =>\n  value.name === 'Timestamp';\n\nexport const isDuration = (value: Element): value is ContentElement<'float'> =>\n  value.name === 'Duration';\n"],"mappings":";AAEA,IAAkB,cAAX,yBAAA,aAAA;CACL,YAAA,YAAA,UAAA,KAAA;CACA,YAAA,YAAA,UAAA,KAAA;CACA,YAAA,YAAA,UAAA,KAAA;CACA,YAAA,YAAA,eAAA,KAAA;;AACF,EAAA,CAAA,CAAA;AA0DA,MAAa,mBAAmB,YAC9B,QAAQ,SAAS;AAEnB,MAAa,oBAAoB,YAC/B,QAAQ,SAAS;AAEnB,MAAa,kBAAkB,YAA8C,QAAQ,OAAO;AAE5F,MAAa,uBAAuB,YAClC,QAAQ,SAAS;AAEnB,MAAa,wBAAwB,YACnC,QAAQ,OAAO;AAEjB,MAAa,eAAe,UAC1B,MAAM,SAAS;AAEjB,MAAa,eAAe,UAC1B,MAAM,SAAS;AAEjB,MAAa,cAAc,UACzB,MAAM,SAAS"}

package/build/FadeTransform.cjs

@@ -0,0 +1,90 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+const require_Deferred = require("./Deferred-CB69mtbF.cjs");
+//#region src/FadeTransform.ts
+const easeOutCubic = (t, b, c, d) => c * ((t = t / d - 1) * t * t + 1) + b;
+var FadeTransform = class extends TransformStream {
+	setDisableFadeOut;
+	constructor({ disableIn, disableOut, duration: fadeDuration = 200 } = {}) {
+		let deferred;
+		let last;
+		let ctx = null;
+		let init = {};
+		let disableFadeOut = disableOut;
+		const initialize = (chunk) => {
+			if (!ctx) ctx = new OffscreenCanvas(chunk.displayWidth, chunk.displayHeight).getContext("2d");
+			if (!init) {
+				const { displayWidth, displayHeight, visibleRect, duration, timestamp } = chunk;
+				init = {
+					displayWidth,
+					displayHeight,
+					visibleRect: visibleRect ?? void 0,
+					duration: duration ?? void 0,
+					timestamp: timestamp ?? void 0
+				};
+			}
+		};
+		super({
+			transform(chunk, controller) {
+				if (!disableFadeOut) {
+					last?.close();
+					last = chunk.clone();
+				}
+				const timestamp = chunk.timestamp ? chunk.timestamp : 0;
+				if (!disableIn && timestamp / 1e3 < fadeDuration) {
+					if (!ctx) initialize(chunk);
+					if (ctx) {
+						const brightness = easeOutCubic(timestamp / 1e3, 0, 100, fadeDuration);
+						ctx.filter = `brightness(${brightness}%)`;
+						ctx.drawImage(chunk, 0, 0);
+						chunk.close();
+						init.timestamp = timestamp;
+						const frame = new VideoFrame(ctx.canvas, init);
+						controller.enqueue(frame);
+						return;
+					}
+				}
+				controller.enqueue(chunk);
+			},
+			flush: async (controller) => {
+				if (last && last.timestamp && !disableFadeOut) {
+					if (!ctx) initialize(last);
+					if (ctx) {
+						deferred = new require_Deferred.Deferred();
+						const context = ctx;
+						const orig = last;
+						const { timestamp: start } = last;
+						const duration = last.duration ? last.duration / 1e3 : 33;
+						const fadeOut = (time) => {
+							context.filter = `brightness(${easeOutCubic(Math.max(0, fadeDuration - time), 0, 100, fadeDuration)}%)`;
+							context.drawImage(orig, 0, 0);
+							init.timestamp = start + time * 1e3;
+							const frame = new VideoFrame(context.canvas, init);
+							controller.enqueue(frame);
+							const next = time + duration;
+							if (next > fadeDuration) {
+								orig.close();
+								deferred?.resolve();
+							} else setTimeout(() => fadeOut(next), 0);
+						};
+						fadeOut(duration);
+					}
+				}
+				await deferred?.promise;
+			}
+		});
+		this.setDisableFadeOut = (value) => {
+			disableFadeOut = value;
+			if (disableFadeOut) {
+				last?.close();
+				last = void 0;
+			}
+		};
+	}
+};
+//#endregion
+exports.default = FadeTransform;
+
+//# sourceMappingURL=FadeTransform.cjs.map

package/build/FadeTransform.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FadeTransform.cjs","names":["Deferred"],"sources":["../src/FadeTransform.ts"],"sourcesContent":["import Deferred from './Deferred';\n\nexport type FadeOptions = {\n  disableIn?: boolean;\n  disableOut?: boolean;\n  duration?: number;\n};\n\nconst easeOutCubic = (t: number, b: number, c: number, d: number) =>\n  // eslint-disable-next-line no-param-reassign\n  c * ((t = t / d - 1) * t * t + 1) + b;\n\nexport default class FadeTransform extends TransformStream<VideoFrame, VideoFrame> {\n  setDisableFadeOut: (value?: boolean) => void;\n\n  constructor({ disableIn, disableOut, duration: fadeDuration = 200 }: FadeOptions = {}) {\n    let deferred: Deferred | undefined;\n    let last: VideoFrame | undefined;\n    let ctx: OffscreenCanvasRenderingContext2D | null = null;\n    let init: VideoFrameInit = {};\n    let disableFadeOut = disableOut;\n    const initialize = (chunk: VideoFrame): void => {\n      if (!ctx) {\n        const offscreen = new OffscreenCanvas(chunk.displayWidth, chunk.displayHeight);\n        ctx = offscreen.getContext('2d');\n      }\n      if (!init) {\n        const { displayWidth, displayHeight, visibleRect, duration, timestamp } = chunk;\n        init = {\n          displayWidth,\n          displayHeight,\n          visibleRect: visibleRect ?? undefined,\n          duration: duration ?? undefined,\n          timestamp: timestamp ?? undefined,\n        };\n      }\n    };\n    super({\n      transform(chunk, controller) {\n        if (!disableFadeOut) {\n          last?.close();\n          last = chunk.clone();\n        }\n        const timestamp = chunk.timestamp ? chunk.timestamp : 0;\n        if (!disableIn && timestamp / 1000 < fadeDuration) {\n          if (!ctx) initialize(chunk);\n          if (ctx) {\n            const brightness = easeOutCubic(timestamp / 1000, 0, 100, fadeDuration);\n            ctx.filter = `brightness(${brightness}%)`;\n            ctx.drawImage(chunk, 0, 0);\n            chunk.close();\n            init.timestamp = timestamp;\n            const frame = new VideoFrame(ctx.canvas as unknown as ImageBitmap, init);\n            controller.enqueue(frame);\n            return;\n          }\n        }\n        controller.enqueue(chunk);\n      },\n      flush: async (controller) => {\n        if (last && last.timestamp && !disableFadeOut) {\n          if (!ctx) initialize(last);\n          if (ctx) {\n            deferred = new Deferred();\n            const context = ctx;\n            const orig = last;\n            const { timestamp: start } = last;\n            const duration = last.duration ? last.duration / 1000 : 33;\n            const fadeOut = (time: number) => {\n              const brightness = easeOutCubic(\n                Math.max(0, fadeDuration - time),\n                0,\n                100,\n                fadeDuration,\n              );\n              context.filter = `brightness(${brightness}%)`;\n              context.drawImage(orig, 0, 0);\n              init.timestamp = start + time * 1000;\n              const frame = new VideoFrame(context.canvas as unknown as ImageBitmap, init);\n              controller.enqueue(frame);\n              const next = time + duration;\n              if (next > fadeDuration) {\n                orig.close();\n                deferred?.resolve();\n              } else setTimeout(() => fadeOut(next), 0);\n            };\n            fadeOut(duration);\n          }\n        }\n        await deferred?.promise;\n      },\n    });\n    this.setDisableFadeOut = (value?: boolean) => {\n      disableFadeOut = value;\n      if (disableFadeOut) {\n        last?.close();\n        last = undefined;\n      }\n    };\n  }\n}\n"],"mappings":";;;;;;AAQA,MAAM,gBAAgB,GAAW,GAAW,GAAW,MAErD,MAAM,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK;AAEtC,IAAqB,gBAArB,cAA2C,gBAAwC;CACjF;CAEA,YAAY,EAAE,WAAW,YAAY,UAAU,eAAe,QAAqB,CAAC,GAAG;EACrF,IAAI;EACJ,IAAI;EACJ,IAAI,MAAgD;EACpD,IAAI,OAAuB,CAAC;EAC5B,IAAI,iBAAiB;EACrB,MAAM,cAAc,UAA4B;GAC9C,IAAI,CAAC,KAEH,MAAM,IADgB,gBAAgB,MAAM,cAAc,MAAM,aAClD,EAAE,WAAW,IAAI;GAEjC,IAAI,CAAC,MAAM;IACT,MAAM,EAAE,cAAc,eAAe,aAAa,UAAU,cAAc;IAC1E,OAAO;KACL;KACA;KACA,aAAa,eAAe,KAAA;KAC5B,UAAU,YAAY,KAAA;KACtB,WAAW,aAAa,KAAA;IAC1B;GACF;EACF;EACA,MAAM;GACJ,UAAU,OAAO,YAAY;IAC3B,IAAI,CAAC,gBAAgB;KACnB,MAAM,MAAM;KACZ,OAAO,MAAM,MAAM;IACrB;IACA,MAAM,YAAY,MAAM,YAAY,MAAM,YAAY;IACtD,IAAI,CAAC,aAAa,YAAY,MAAO,cAAc;KACjD,IAAI,CAAC,KAAK,WAAW,KAAK;KAC1B,IAAI,KAAK;MACP,MAAM,aAAa,aAAa,YAAY,KAAM,GAAG,KAAK,YAAY;MACtE,IAAI,SAAS,cAAc,WAAW;MACtC,IAAI,UAAU,OAAO,GAAG,CAAC;MACzB,MAAM,MAAM;MACZ,KAAK,YAAY;MACjB,MAAM,QAAQ,IAAI,WAAW,IAAI,QAAkC,IAAI;MACvE,WAAW,QAAQ,KAAK;MACxB;KACF;IACF;IACA,WAAW,QAAQ,KAAK;GAC1B;GACA,OAAO,OAAO,eAAe;IAC3B,IAAI,QAAQ,KAAK,aAAa,CAAC,gBAAgB;KAC7C,IAAI,CAAC,KAAK,WAAW,IAAI;KACzB,IAAI,KAAK;MACP,WAAW,IAAIA,iBAAAA,SAAS;MACxB,MAAM,UAAU;MAChB,MAAM,OAAO;MACb,MAAM,EAAE,WAAW,UAAU;MAC7B,MAAM,WAAW,KAAK,WAAW,KAAK,WAAW,MAAO;MACxD,MAAM,WAAW,SAAiB;OAOhC,QAAQ,SAAS,cANE,aACjB,KAAK,IAAI,GAAG,eAAe,IAAI,GAC/B,GACA,KACA,YAEsC,EAAE;OAC1C,QAAQ,UAAU,MAAM,GAAG,CAAC;OAC5B,KAAK,YAAY,QAAQ,OAAO;OAChC,MAAM,QAAQ,IAAI,WAAW,QAAQ,QAAkC,IAAI;OAC3E,WAAW,QAAQ,KAAK;OACxB,MAAM,OAAO,OAAO;OACpB,IAAI,OAAO,cAAc;QACvB,KAAK,MAAM;QACX,UAAU,QAAQ;OACpB,OAAO,iBAAiB,QAAQ,IAAI,GAAG,CAAC;MAC1C;MACA,QAAQ,QAAQ;KAClB;IACF;IACA,MAAM,UAAU;GAClB;EACF,CAAC;EACD,KAAK,qBAAqB,UAAoB;GAC5C,iBAAiB;GACjB,IAAI,gBAAgB;IAClB,MAAM,MAAM;IACZ,OAAO,KAAA;GACT;EACF;CACF;AACF"}

package/build/FadeTransform.d.cts

@@ -0,0 +1 @@
+export type * from './FadeTransform.d.mts'

package/build/FadeTransform.d.mts

@@ -0,0 +1,17 @@
+//#region src/FadeTransform.d.ts
+type FadeOptions = {
+  disableIn?: boolean;
+  disableOut?: boolean;
+  duration?: number;
+};
+declare class FadeTransform extends TransformStream<VideoFrame, VideoFrame> {
+  setDisableFadeOut: (value?: boolean) => void;
+  constructor({
+    disableIn,
+    disableOut,
+    duration: fadeDuration
+  }?: FadeOptions);
+}
+//#endregion
+export { FadeOptions, FadeTransform as default };
+//# sourceMappingURL=FadeTransform.d.mts.map

package/build/FadeTransform.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FadeTransform.d.mts","names":[],"sources":["../src/FadeTransform.ts"],"mappings":";KAEY,WAAA;EACV,SAAA;EACA,UAAA;EACA,QAAA;AAAA;AAAA,cAOmB,aAAA,SAAsB,eAAA,CAAgB,UAAA,EAAY,UAAA;EACrE,iBAAA,GAAoB,KAAA;;IAEN,SAAA;IAAW,UAAA;IAAY,QAAA,EAAU;EAAA,IAAsB,WAAA;AAAA"}

package/build/FadeTransform.mjs

@@ -0,0 +1,86 @@
+import { t as Deferred } from "./Deferred-7Cu0KIje.mjs";
+//#region src/FadeTransform.ts
+const easeOutCubic = (t, b, c, d) => c * ((t = t / d - 1) * t * t + 1) + b;
+var FadeTransform = class extends TransformStream {
+	setDisableFadeOut;
+	constructor({ disableIn, disableOut, duration: fadeDuration = 200 } = {}) {
+		let deferred;
+		let last;
+		let ctx = null;
+		let init = {};
+		let disableFadeOut = disableOut;
+		const initialize = (chunk) => {
+			if (!ctx) ctx = new OffscreenCanvas(chunk.displayWidth, chunk.displayHeight).getContext("2d");
+			if (!init) {
+				const { displayWidth, displayHeight, visibleRect, duration, timestamp } = chunk;
+				init = {
+					displayWidth,
+					displayHeight,
+					visibleRect: visibleRect ?? void 0,
+					duration: duration ?? void 0,
+					timestamp: timestamp ?? void 0
+				};
+			}
+		};
+		super({
+			transform(chunk, controller) {
+				if (!disableFadeOut) {
+					last?.close();
+					last = chunk.clone();
+				}
+				const timestamp = chunk.timestamp ? chunk.timestamp : 0;
+				if (!disableIn && timestamp / 1e3 < fadeDuration) {
+					if (!ctx) initialize(chunk);
+					if (ctx) {
+						const brightness = easeOutCubic(timestamp / 1e3, 0, 100, fadeDuration);
+						ctx.filter = `brightness(${brightness}%)`;
+						ctx.drawImage(chunk, 0, 0);
+						chunk.close();
+						init.timestamp = timestamp;
+						const frame = new VideoFrame(ctx.canvas, init);
+						controller.enqueue(frame);
+						return;
+					}
+				}
+				controller.enqueue(chunk);
+			},
+			flush: async (controller) => {
+				if (last && last.timestamp && !disableFadeOut) {
+					if (!ctx) initialize(last);
+					if (ctx) {
+						deferred = new Deferred();
+						const context = ctx;
+						const orig = last;
+						const { timestamp: start } = last;
+						const duration = last.duration ? last.duration / 1e3 : 33;
+						const fadeOut = (time) => {
+							context.filter = `brightness(${easeOutCubic(Math.max(0, fadeDuration - time), 0, 100, fadeDuration)}%)`;
+							context.drawImage(orig, 0, 0);
+							init.timestamp = start + time * 1e3;
+							const frame = new VideoFrame(context.canvas, init);
+							controller.enqueue(frame);
+							const next = time + duration;
+							if (next > fadeDuration) {
+								orig.close();
+								deferred?.resolve();
+							} else setTimeout(() => fadeOut(next), 0);
+						};
+						fadeOut(duration);
+					}
+				}
+				await deferred?.promise;
+			}
+		});
+		this.setDisableFadeOut = (value) => {
+			disableFadeOut = value;
+			if (disableFadeOut) {
+				last?.close();
+				last = void 0;
+			}
+		};
+	}
+};
+//#endregion
+export { FadeTransform as default };
+
+//# sourceMappingURL=FadeTransform.mjs.map