@svta/cml-iso-bmff 1.0.0-alpha.3 → 1.0.0-alpha.4

package/dist/index.d.ts

@@ -37,6 +37,14 @@ type AudioRenderingIndicationBox = FullBox & {
   audioRenderingIndication: number;
 };
 //#endregion
+//#region src/IsoBoxType.d.ts
+/**
+* Iso Box Type
+*
+* @public
+*/
+type IsoBoxType = `${string}${string}${string}${string}`;
+//#endregion
 //#region src/boxes/AudioSampleEntryType.d.ts
 /**
 * The type of audio sample entry box.
@@ -68,7 +76,7 @@ type AudioSampleEntryBoxChild = any;
 *
 * @public
 */
-type AudioSampleEntryBox<T$1 extends AudioSampleEntryType = AudioSampleEntryType> = SampleEntryBox & {
+type AudioSampleEntryBox<T$1 extends IsoBoxType = AudioSampleEntryType> = SampleEntryBox & {
   type: T$1;
   reserved2: number[];
   channelcount: number;
@@ -79,6 +87,16 @@ type AudioSampleEntryBox<T$1 extends AudioSampleEntryType = AudioSampleEntryType
   boxes: AudioSampleEntryBoxChild[];
 };
 //#endregion
+//#region src/boxes/Box.d.ts
+/**
+* Base Box Type
+*
+* @public
+*/
+type Box<T$1 extends IsoBoxType = never> = {
+  type: T$1;
+};
+//#endregion
 //#region src/boxes/ChunkLargeOffsetBox.d.ts
 /**
 * Chunk Large Offset Box - 'co64'
@@ -288,6 +306,39 @@ type EditBox = {
   boxes: EditBoxChild[];
 };
 //#endregion
+//#region src/boxes/SubsampleEncryption.d.ts
+/**
+* Subsample Encryption
+*
+* @public
+*/
+type SubsampleEncryption = {
+  bytesOfClearData: number;
+  bytesOfProtectedData: number;
+};
+//#endregion
+//#region src/boxes/EncryptedSample.d.ts
+/**
+* Encrypted Sample
+*
+* @public
+*/
+type EncryptedSample = {
+  initializationVector?: Uint8Array;
+  subsampleEncryption?: SubsampleEncryption[];
+};
+//#endregion
+//#region src/boxes/Entity.d.ts
+/**
+* Entity
+*
+* @public
+*/
+type Entity = {
+  /** Entity ID */
+  entityId: number;
+};
+//#endregion
 //#region src/boxes/EventMessageBox.d.ts
 /**
 * ISO/IEC 23009-1:2014 - 5.10.3.3 Event Message Box
@@ -417,6 +468,18 @@ type IpmpInfoBox = FullBox & {
   ipmpDescr: any[];
 };
 //#endregion
+//#region src/boxes/ItemExtent.d.ts
+/**
+* Item Extent
+*
+* @public
+*/
+type ItemExtent = {
+  extentIndex?: number;
+  extentOffset: number;
+  extentLength: number;
+};
+//#endregion
 //#region src/boxes/ItemInfoEntry.d.ts
 /**
 * Item Info Entry - 'infe'
@@ -451,18 +514,6 @@ type ItemInfoBox = {
   entryCount: number;
 };
 //#endregion
-//#region src/boxes/ItemExtent.d.ts
-/**
-* Item Extent
-*
-* @public
-*/
-type ItemExtent = {
-  extentIndex?: number;
-  extentOffset: number;
-  extentLength: number;
-};
-//#endregion
 //#region src/boxes/ItemLocation.d.ts
 /**
 * Item Location
@@ -688,7 +739,7 @@ type VisualSampleEntryBoxChild = any;
 *
 * @public
 */
-type VisualSampleEntryBox<T$1 extends VisualSampleEntryType = VisualSampleEntryType> = SampleEntryBox & {
+type VisualSampleEntryBox<T$1 extends IsoBoxType = VisualSampleEntryType> = SampleEntryBox & {
   type: T$1;
   preDefined1: number;
   reserved2: number;
@@ -1168,28 +1219,6 @@ type SampleAuxiliaryInformationSizesBox = FullBox & {
   sampleInfoSize?: number[];
 };
 //#endregion
-//#region src/boxes/SubsampleEncryption.d.ts
-/**
-* Subsample Encryption
-*
-* @public
-*/
-type SubsampleEncryption = {
-  bytesOfClearData: number;
-  bytesOfProtectedData: number;
-};
-//#endregion
-//#region src/boxes/EncryptedSample.d.ts
-/**
-* Encrypted Sample
-*
-* @public
-*/
-type EncryptedSample = {
-  initializationVector?: Uint8Array;
-  subsampleEncryption?: SubsampleEncryption[];
-};
-//#endregion
 //#region src/boxes/SampleEncryptionBox.d.ts
 /**
 * Sample Encryption Box - 'senc'
@@ -1389,17 +1418,6 @@ type MovieFragmentRandomAccessBox = {
   boxes: MovieFragmentRandomAccessBoxChild[];
 };
 //#endregion
-//#region src/boxes/Entity.d.ts
-/**
-* Entity
-*
-* @public
-*/
-type Entity = {
-  /** Entity ID */
-  entityId: number;
-};
-//#endregion
 //#region src/boxes/PreselectionGroupBox.d.ts
 /**
 * Child boxes of Preselection Group Box
@@ -1641,6 +1659,54 @@ type WebVttSourceLabelBox = {
   sourceLabel: string;
 };
 //#endregion
+//#region src/fields/DATA.d.ts
+/**
+* The data field type
+*
+* @public
+*/
+declare const DATA = "data";
+//#endregion
+//#region src/fields/INT.d.ts
+/**
+* The integer field type
+*
+* @public
+*/
+declare const INT = "int";
+//#endregion
+//#region src/fields/STRING.d.ts
+/**
+* The string field type
+*
+* @public
+*/
+declare const STRING = "string";
+//#endregion
+//#region src/fields/TEMPLATE.d.ts
+/**
+* The template field type
+*
+* @public
+*/
+declare const TEMPLATE = "template";
+//#endregion
+//#region src/fields/UINT.d.ts
+/**
+* The unsigned integer field type
+*
+* @public
+*/
+declare const UINT = "uint";
+//#endregion
+//#region src/fields/UTF8.d.ts
+/**
+* The UTF8 field type
+*
+* @public
+*/
+declare const UTF8 = "utf8";
+//#endregion
 //#region src/IsoBoxMap.d.ts
 /**
 * Comprehensive mapping from box type strings to their corresponding TypeScript interfaces
@@ -1758,21 +1824,49 @@ type IsoBoxMap = {
 */
 type IsoBox = IsoBoxMap[keyof IsoBoxMap];
 //#endregion
-//#region src/IsoBoxData.d.ts
+//#region src/IsoBoxContainerMap.d.ts
 /**
-* ISO data
+* Map of container box types to their allowed child box types
 *
 * @public
 */
-type IsoBoxData = ArrayBuffer | ArrayBufferView<ArrayBuffer>;
+type IsoBoxContainerMap = {
+  dinf: DataInformationBox;
+  edts: EditBox;
+  grpl: GroupsListBox;
+  mdia: MediaBox;
+  meco: AdditionalMetadataContainerBox;
+  mfra: MovieFragmentRandomAccessBox;
+  minf: MediaInformationBox;
+  moof: MovieFragmentBox;
+  moov: MovieBox;
+  mvex: MovieExtendsBox;
+  schi: SchemeInformationBox;
+  sinf: ProtectionSchemeInformationBox;
+  stbl: SampleTableBox;
+  strk: SubTrackBox;
+  traf: TrackFragmentBox;
+  trak: TrackBox;
+  tref: TrackReferenceBox;
+  udta: UserDataBox;
+  vttc: WebVttCueBox;
+};
 //#endregion
-//#region src/IsoBoxReader.d.ts
+//#region src/IsoBoxContainer.d.ts
 /**
-* ISO BMFF box reader
+* Iso Box Container Type
+*
+* @public
+*/
+type IsoBoxContainer = IsoBoxContainerMap[keyof IsoBoxContainerMap];
+//#endregion
+//#region src/IsoBoxData.d.ts
+/**
+* ISO data
 *
 * @public
 */
-type IsoBoxReader<B$1 extends IsoBox> = (view: IsoBoxReadView) => B$1;
+type IsoBoxData = ArrayBuffer | ArrayBufferView<ArrayBuffer>;
 //#endregion
 //#region src/IsoBoxReaderMap.d.ts
 /**
@@ -1780,7 +1874,7 @@ type IsoBoxReader<B$1 extends IsoBox> = (view: IsoBoxReadView) => B$1;
 *
 * @public
 */
-type IsoBoxReaderMap = Partial<{ [P in IsoBox["type"]]: IsoBoxReader<Extract<IsoBox, Record<"type", P>>> }>;
+type IsoBoxReaderMap = Record<string, IsoBoxReader>;
 //#endregion
 //#region src/IsoBoxReadViewConfig.d.ts
 /**
@@ -1788,11 +1882,11 @@ type IsoBoxReaderMap = Partial<{ [P in IsoBox["type"]]: IsoBoxReader<Extract<Iso
 *
 * @public
 */
-type IsoBoxReadViewConfig<R extends IsoBoxReaderMap = IsoBoxReaderMap> = {
+type IsoBoxReadViewConfig = {
   /**
   * A map of box parsers to their box types
   */
-  readers?: R;
+  readers?: IsoBoxReaderMap;
 };
 //#endregion
 //#region src/IsoFieldTypeMap.d.ts
@@ -1811,21 +1905,26 @@ type IsoFieldTypeMap = {
   utf8string: string;
 };
 //#endregion
-//#region src/IsoParsedBox.d.ts
+//#region src/ParsedBox.d.ts
 /**
-* Iso Parsed Box Type
+* A Parsed Box Type
 *
 * @public
 */
-type IsoParsedBox<T$1 extends IsoBox = IsoBox> = T$1 & Omit<Box, "type">;
+type ParsedBox<T$1 = Box> = (T$1 extends IsoBox ? T$1 & Omit<Box, "type"> : T$1) & {
+  view: IsoBoxReadView;
+  size: number;
+  largesize?: number;
+  usertype?: number[];
+};
 //#endregion
-//#region src/ParsedBox.d.ts
+//#region src/ParsedIsoBox.d.ts
 /**
 * Parsed Box Type
 *
 * @public
 */
-type ParsedBox = IsoParsedBox | Box;
+type ParsedIsoBox = ParsedBox<IsoBox | Box>;
 //#endregion
 //#region src/IsoBoxReadView.d.ts
 /**
@@ -1834,7 +1933,7 @@ type ParsedBox = IsoParsedBox | Box;
 *
 * @public
 */
-declare class IsoBoxReadView<R extends IsoBoxReaderMap = IsoBoxReaderMap> {
+declare class IsoBoxReadView {
   private dataView;
   private offset;
   private config;
@@ -1847,7 +1946,7 @@ declare class IsoBoxReadView<R extends IsoBoxReaderMap = IsoBoxReaderMap> {
   * @param raw - The raw data to view.
   * @param config - The configuration for the IsoView.
   */
-  constructor(raw: IsoBoxData, config?: IsoBoxReadViewConfig<R>);
+  constructor(raw: IsoBoxData, config?: IsoBoxReadViewConfig);
   /**
   * The buffer of the data view.
   */
@@ -1878,7 +1977,7 @@ declare class IsoBoxReadView<R extends IsoBoxReaderMap = IsoBoxReaderMap> {
   * @param size - The size of the slice.
   * @returns A new IsoView instance.
   */
-  slice: (offset: number, size: number) => IsoBoxReadView<R>;
+  slice: (offset: number, size: number) => IsoBoxReadView;
   private read;
   /**
   * Reads a unsigned integer from the data view.
@@ -1948,7 +2047,7 @@ declare class IsoBoxReadView<R extends IsoBoxReaderMap = IsoBoxReaderMap> {
   *
   * @returns The box.
   */
-  readBox: () => Box;
+  readBox: () => ParsedBox;
   /**
   * Reads a number of boxes from the data view.
   *
@@ -1969,126 +2068,28 @@ declare class IsoBoxReadView<R extends IsoBoxReaderMap = IsoBoxReaderMap> {
   *
   * @returns A generator of boxes.
   */
-  [Symbol.iterator](): Generator<ParsedBox>;
+  [Symbol.iterator](): Generator<ParsedIsoBox>;
 }
 //#endregion
-//#region src/boxes/Box.d.ts
-/**
-* Base Box Type
-*
-* @public
-*/
-type Box = {
-  type: "";
-  size: number;
-  view: IsoBoxReadView;
-  largesize?: number;
-  usertype?: number[];
-};
-//#endregion
-//#region src/fields/DATA.d.ts
-/**
-* The data field type
-*
-* @public
-*/
-declare const DATA = "data";
-//#endregion
-//#region src/fields/INT.d.ts
-/**
-* The integer field type
-*
-* @public
-*/
-declare const INT = "int";
-//#endregion
-//#region src/fields/STRING.d.ts
-/**
-* The string field type
-*
-* @public
-*/
-declare const STRING = "string";
-//#endregion
-//#region src/fields/TEMPLATE.d.ts
-/**
-* The template field type
-*
-* @public
-*/
-declare const TEMPLATE = "template";
-//#endregion
-//#region src/fields/UINT.d.ts
-/**
-* The unsigned integer field type
-*
-* @public
-*/
-declare const UINT = "uint";
-//#endregion
-//#region src/fields/UTF8.d.ts
-/**
-* The UTF8 field type
-*
-* @public
-*/
-declare const UTF8 = "utf8";
-//#endregion
-//#region src/IsoBoxContainerMap.d.ts
-/**
-* Map of container box types to their allowed child box types
-*
-* @public
-*/
-type IsoBoxContainerMap = {
-  dinf: DataInformationBox;
-  edts: EditBox;
-  grpl: GroupsListBox;
-  mdia: MediaBox;
-  meco: AdditionalMetadataContainerBox;
-  mfra: MovieFragmentRandomAccessBox;
-  minf: MediaInformationBox;
-  moof: MovieFragmentBox;
-  moov: MovieBox;
-  mvex: MovieExtendsBox;
-  schi: SchemeInformationBox;
-  sinf: ProtectionSchemeInformationBox;
-  stbl: SampleTableBox;
-  strk: SubTrackBox;
-  traf: TrackFragmentBox;
-  trak: TrackBox;
-  tref: TrackReferenceBox;
-  udta: UserDataBox;
-  vttc: WebVttCueBox;
-};
-//#endregion
-//#region src/IsoBoxContainer.d.ts
+//#region src/IsoBoxReader.d.ts
 /**
-* Iso Box Container Type
+* ISO BMFF box reader
 *
 * @public
 */
-type IsoBoxContainer = IsoBoxContainerMap[keyof IsoBoxContainerMap];
+type IsoBoxReader<B = unknown> = (view: IsoBoxReadView) => B;
 //#endregion
 //#region src/IsoBoxReaderReturn.d.ts
 /**
-* Return type for a box reader.
+* Return type for the ISO box reader.
 *
-* @public
-*/
-type BoxReturn<T$1 extends IsoBoxReaderMap> = IsoParsedBox<{ [K in keyof T$1]: T$1[K] extends IsoBoxReader<infer B> ? B : never }[keyof T$1]>;
-/**
-* Return type for a container reader
-*
-* @public
-*/
-type ContainerReturn = IsoParsedBox<IsoBoxContainer>;
-/**
-* Return type for the ISO box reader
+* Creates a discriminated union of all box types returned by the readers,
+* plus ParsedBox for unknown/container boxes. This enables type narrowing
+* via `box.type === 'xxxx'`.
 *
 * @public
 */
-type IsoBoxReaderReturn<T$1 extends IsoBoxReaderMap> = BoxReturn<T$1> | ContainerReturn | ParsedBox;
+type IsoBoxReaderReturn<T$1> = { [K in keyof T$1]: T$1[K] extends ((...args: never[]) => infer R) ? ParsedBox<R> : never }[keyof T$1] | ParsedIsoBox;
 //#endregion
 //#region src/IsoBoxStreamable.d.ts
 /**
@@ -2096,7 +2097,7 @@ type IsoBoxReaderReturn<T$1 extends IsoBoxReaderMap> = BoxReturn<T$1> | Containe
 *
 * @public
 */
-type IsoBoxStreamable = IsoBox | Box | ArrayBufferView;
+type IsoBoxStreamable = IsoBox | ParsedIsoBox | ArrayBufferView;
 //#endregion
 //#region src/IsoBoxWriterMap.d.ts
 /**
@@ -2125,7 +2126,7 @@ type IsoBoxWriteViewConfig = {
 *
 * @public
 */
-type IsoBoxWriter<B$1> = (box: B$1, config: IsoBoxWriteViewConfig) => ArrayBufferView;
+type IsoBoxWriter<B> = (box: B, config: IsoBoxWriteViewConfig) => ArrayBufferView;
 //#endregion
 //#region src/IsoBoxWriteView.d.ts
 /**
@@ -2236,7 +2237,28 @@ declare class IsoBoxWriteView {
 *
 * @public
 */
-type IsoTypedParsedBox<T$1 extends keyof IsoBoxMap> = IsoBoxMap[T$1] & Omit<Box, "type">;
+type IsoTypedParsedBox<T$1 extends keyof IsoBoxMap> = ParsedBox<IsoBoxMap[T$1]>;
+//#endregion
+//#region src/TraverseIsoBoxesConfig.d.ts
+/**
+* Configuration options for traversing ISO boxes.
+*
+* @public
+*/
+type TraverseIsoBoxesConfig = {
+  /**
+  * Whether to traverse the boxes depth-first or breadth-first.
+  *
+  * @defaultValue true
+  */
+  depthFirst?: boolean;
+  /**
+  * The maximum depth to traverse. A value of 0 will only traverse the root boxes.
+  *
+  * @defaultValue Infinity
+  */
+  maxDepth?: number;
+};
 //#endregion
 //#region src/createIsoBoxReadableStream.d.ts
 /**
@@ -2254,6 +2276,46 @@ type IsoTypedParsedBox<T$1 extends keyof IsoBoxMap> = IsoBoxMap[T$1] & Omit<Box,
 */
 declare function createIsoBoxReadableStream(boxes: Iterable<IsoBoxStreamable>, config?: IsoBoxWriteViewConfig): ReadableStream<Uint8Array>;
 //#endregion
+//#region src/filterIsoBoxes.d.ts
+/**
+* Filters boxes in the tree that satisfy the provided testing function.
+*
+* This function traverses the entire box structure (including nested boxes)
+* and returns all boxes for which the callback returns true.
+*
+* @param boxes - The boxes to search through
+* @param callback - A function that accepts a box and returns true if it matches
+* @param config - Configuration options for traversal
+*
+* @returns An array of boxes that satisfy the callback
+*
+* @example
+* {@includeCode ../test/filterIsoBoxes.test.ts#example}
+*
+* @public
+*/
+declare function filterIsoBoxes<T$1 extends ParsedIsoBox>(boxes: Iterable<T$1>, callback: (box: T$1) => boolean, config?: TraverseIsoBoxesConfig): T$1[];
+//#endregion
+//#region src/findIsoBox.d.ts
+/**
+* Finds the first box in the tree that satisfies the provided testing function.
+*
+* This function traverses the entire box structure (including nested boxes)
+* and returns the first box for which the callback returns true.
+*
+* @param boxes - The boxes to search through
+* @param callback - A function that accepts a box and returns true if it matches
+* @param config - Configuration options for traversal
+*
+* @returns The first box that satisfies the callback, or null if none is found
+*
+* @example
+* {@includeCode ../test/findIsoBox.test.ts#example}
+*
+* @public
+*/
+declare function findIsoBox<T$1 extends ParsedIsoBox>(boxes: Iterable<T$1>, callback: (box: T$1) => boolean, config?: TraverseIsoBoxesConfig): T$1 | null;
+//#endregion
 //#region src/IsoBoxReadableStream.d.ts
 /**
 * A readable stream of ISO BMFF boxes as Uint8Arrays.
@@ -2284,15 +2346,20 @@ declare class IsoBoxReadableStream extends ReadableStream<Uint8Array> {
 *
 * @public
 */
-declare function readIsoBoxes<R extends IsoBoxReaderMap>(raw: IsoBoxData, config?: IsoBoxReadViewConfig<R>): IsoBoxReaderReturn<R>[];
+declare function readIsoBoxes<const R$1 extends IsoBoxReaderMap>(raw: IsoBoxData, config: IsoBoxReadViewConfig & {
+  readers: R$1;
+}): IsoBoxReaderReturn<R$1>[];
+/**
+* @public
+*/
+declare function readIsoBoxes(raw: IsoBoxData, config?: IsoBoxReadViewConfig): ParsedIsoBox[];
 //#endregion
 //#region src/traverseIsoBoxes.d.ts
 /**
 * Traverse ISO boxes
 *
 * @param boxes - The boxes to traverse
-* @param depthFirst - Whether to traverse the boxes depth-first or breadth-first
-* @param maxDepth - The maximum depth to traverse. A value of 0 will only traverse the root boxes.
+* @param config - Configuration options for traversal
 *
 * @returns A generator of boxes
 *
@@ -2301,7 +2368,7 @@ declare function readIsoBoxes<R extends IsoBoxReaderMap>(raw: IsoBoxData, config
 *
 * @public
 */
-declare function traverseIsoBoxes(boxes: Iterable<ParsedBox>, depthFirst?: boolean, maxDepth?: number): Generator<ParsedBox>;
+declare function traverseIsoBoxes(boxes: Iterable<ParsedIsoBox>, config?: TraverseIsoBoxesConfig): Generator<ParsedIsoBox>;
 //#endregion
 //#region src/writeIsoBox.d.ts
 /**
@@ -2332,6 +2399,56 @@ declare function writeIsoBox(box: IsoBoxStreamable, config?: IsoBoxWriteViewConf
 */
 declare function writeIsoBoxes(boxes: Iterable<IsoBoxStreamable>, config?: IsoBoxWriteViewConfig): Uint8Array[];
 //#endregion
+//#region src/readers/createAudioSampleEntryReader.d.ts
+/**
+* Creates a reader function for AudioSampleEntryBox with a custom type.
+*
+* This utility allows reading audio sample entry boxes with types that
+* aren't in the standard AudioSampleEntryType union (e.g., 'mp4a', 'enca').
+*
+* @param type - The 4-character box type
+*
+* @returns A reader function that can be passed to readIsoBoxes
+*
+* @example
+* ```ts
+* const boxes = readIsoBoxes(data, {
+*   readers: {
+*     'ac-3': createAudioSampleEntryReader('ac-3'),
+*     'ec-3': createAudioSampleEntryReader('ec-3'),
+*   }
+* })
+* ```
+*
+* @public
+*/
+declare function createAudioSampleEntryReader<T$1 extends IsoBoxType>(type: T$1): (view: IsoBoxReadView) => AudioSampleEntryBox<T$1>;
+//#endregion
+//#region src/readers/createVisualSampleEntryReader.d.ts
+/**
+* Creates a reader function for VisualSampleEntryBox with a custom type.
+*
+* This utility allows reading visual sample entry boxes with types that
+* aren't in the standard VisualSampleEntryType union (e.g., 'avc1', 'hvc1').
+*
+* @param type - The 4-character box type
+*
+* @returns A reader function that can be passed to readIsoBoxes
+*
+* @example
+* ```ts
+* const boxes = readIsoBoxes(data, {
+*   readers: {
+*     'vp09': createVisualSampleEntryReader('vp09'),
+*     'av01': createVisualSampleEntryReader('av01'),
+*   }
+* })
+* ```
+*
+* @public
+*/
+declare function createVisualSampleEntryReader<T$1 extends IsoBoxType>(type: T$1): (view: IsoBoxReadView) => VisualSampleEntryBox<T$1>;
+//#endregion
 //#region src/readers/readArdi.d.ts
 /**
 * Parse a AudioRenderingIndicationBox from an IsoView
@@ -2355,7 +2472,7 @@ declare function readArdi(view: IsoBoxReadView): AudioRenderingIndicationBox;
 *
 * @public
 */
-declare function readAudioSampleEntryBox<T$1 extends AudioSampleEntryType>(type: T$1, view: IsoBoxReadView): AudioSampleEntryBox<T$1>;
+declare function readAudioSampleEntryBox<T$1 extends IsoBoxType>(type: T$1, view: IsoBoxReadView): AudioSampleEntryBox<T$1>;
 //#endregion
 //#region src/readers/readAvc1.d.ts
 /**
@@ -3028,7 +3145,7 @@ declare function readUrn(view: IsoBoxReadView): DataEntryUrnBox;
 *
 * @public
 */
-declare function readVisualSampleEntryBox<T$1 extends VisualSampleEntryType>(type: T$1, view: IsoBoxReadView): VisualSampleEntryBox<T$1>;
+declare function readVisualSampleEntryBox<T$1 extends IsoBoxType>(type: T$1, view: IsoBoxReadView): VisualSampleEntryBox<T$1>;
 //#endregion
 //#region src/readers/readVlab.d.ts
 /**
@@ -3094,7 +3211,7 @@ declare const CONTAINERS: string[];
 *
 * @public
 */
-declare function isContainer(box: IsoBox | Box): box is IsoBoxContainer;
+declare function isContainer<T$1 extends IsoBox | Box<IsoBox["type"]>>(box: T$1): box is T$1 & IsoBoxContainer;
 //#endregion
 //#region src/utils/isFullBox.d.ts
 /**
@@ -3948,5 +4065,5 @@ declare function writeVttC(box: WebVttConfigurationBox): IsoBoxWriteView;
 */
 declare function writeVtte(_: WebVttEmptySampleBox): IsoBoxWriteView;
 //#endregion
-export { AdditionalMetadataContainerBox, AdditionalMetadataContainerBoxChild, AudioRenderingIndicationBox, AudioSampleEntryBox, AudioSampleEntryBoxChild, AudioSampleEntryType, Box, BoxReturn, CONTAINERS, ChunkLargeOffsetBox, ChunkOffsetBox, CompactSampleSizeBox, CompositionTimeToSampleBox, CompositionTimeToSampleEntry, ContainerReturn, DATA, DataEntryUrlBox, DataEntryUrnBox, DataInformationBox, DataInformationBoxChild, DataReferenceBox, DecodingTimeSample, DecodingTimeToSampleBox, DegradationPriorityBox, EditBox, EditBoxChild, EditListBox, EditListEntry, EncryptedSample, Entity, EventMessageBox, ExtendedLanguageBox, FileTypeBox, FreeSpaceBox, FullBox, GroupsListBox, GroupsListBoxChild, HandlerReferenceBox, HintMediaHeaderBox, INT, IdentifiedMediaDataBox, IpmpInfoBox, IsoBox, IsoBoxContainer, IsoBoxContainerMap, IsoBoxData, IsoBoxMap, IsoBoxReadView, IsoBoxReadViewConfig, IsoBoxReadableStream, IsoBoxReader, IsoBoxReaderMap, IsoBoxReaderReturn, IsoBoxStreamable, IsoBoxWriteView, IsoBoxWriteViewConfig, IsoBoxWriter, IsoBoxWriterMap, IsoFieldTypeMap, IsoParsedBox, IsoTypedParsedBox, ItemExtent, ItemInfoBox, ItemInfoBoxChild, ItemInfoEntry, ItemLocation, ItemLocationBox, ItemProtectionBox, ItemProtectionBoxChild, ItemReferenceBox, ItemReferenceBoxChild, LabelBox, MediaBox, MediaBoxChild, MediaDataBox, MediaHeaderBox, MediaInformationBox, MediaInformationBoxChild, MetaBox, MetaBoxChild, MovieBox, MovieBoxChild, MovieExtendsBox, MovieExtendsBoxChild, MovieExtendsHeaderBox, MovieFragmentBox, MovieFragmentBoxChild, MovieFragmentHeaderBox, MovieFragmentRandomAccessBox, MovieFragmentRandomAccessBoxChild, MovieFragmentRandomAccessOffsetBox, MovieHeaderBox, NullMediaHeaderBox, OriginalFormatBox, ParsedBox, PreselectionGroupBox, PreselectionGroupBoxChild, PrimaryItemBox, ProducerReferenceTimeBox, ProtectionSchemeInformationBox, ProtectionSchemeInformationBoxChild, ProtectionSystemSpecificHeaderBox, STRING, SampleAuxiliaryInformationOffsetsBox, SampleAuxiliaryInformationSizesBox, SampleDependencyTypeBox, SampleDescriptionBox, SampleEncryptionBox, SampleEntryBox, SampleGroupDescriptionBox, SampleSizeBox, SampleTableBox, SampleTableBoxChild, SampleToChunkBox, SampleToChunkEntry, SampleToGroupBox, SampleToGroupEntry, SchemeInformationBox, SchemeInformationBoxChild, SchemeTypeBox, SegmentIndexBox, SegmentIndexReference, SegmentTypeBox, ShadowSyncEntry, ShadowSyncSampleBox, SingleItemTypeReferenceBox, SoundMediaHeaderBox, SubTrackBox, SubTrackBoxChild, Subsample, SubsampleEncryption, SubsampleEntry, SubsampleInformationBox, Subsegment, SubsegmentIndexBox, SubsegmentRange, SubtitleMediaHeaderBox, SyncSample, SyncSampleBox, TEMPLATE, TrackBox, TrackBoxChild, TrackEncryptionBox, TrackExtendsBox, TrackFragmentBaseMediaDecodeTimeBox, TrackFragmentBox, TrackFragmentBoxChild, TrackFragmentHeaderBox, TrackFragmentRandomAccessBox, TrackFragmentRandomAccessEntry, TrackHeaderBox, TrackKindBox, TrackReferenceBox, TrackReferenceBoxChild, TrackReferenceTypeBox, TrackRunBox, TrackRunSample, TypeBox, UINT, UTF8, UserDataBox, UserDataBoxChild, VideoMediaHeaderBox, VisualSampleEntryBox, VisualSampleEntryBoxChild, VisualSampleEntryType, WebVttConfigurationBox, WebVttCueBox, WebVttCueChild, WebVttCueIdBox, WebVttCuePayloadBox, WebVttEmptySampleBox, WebVttSettingsBox, WebVttSourceLabelBox, co64, createIsoBoxReadableStream, isContainer, isFullBox, readArdi, readAudioSampleEntryBox, readAvc1, readAvc2, readAvc3, readAvc4, readCtts, readDref, readElng, readElst, readEmsg, readEnca, readEncv, readFree, readFrma, readFtyp, readHdlr, readHev1, readHvc1, readIden, readImda, readIsoBoxes, readKind, readLabl, readMdat, readMdhd, readMehd, readMeta, readMfhd, readMfro, readMp4a, readMvhd, readPayl, readPrft, readPrsl, readPssh, readSchm, readSdtp, readSidx, readSkip, readSmhd, readSsix, readSthd, readStsd, readStss, readSttg, readStts, readStyp, readSubs, readTenc, readTfdt, readTfhd, readTfra, readTkhd, readTrex, readTrun, readUrl, readUrn, readVisualSampleEntryBox, readVlab, readVmhd, readVttC, readVtte, stz2, traverseIsoBoxes, url, urn, writeArdi, writeAudioSampleEntryBox, writeAvc1, writeAvc2, writeAvc3, writeAvc4, writeCtts, writeDref, writeElng, writeElst, writeEmsg, writeEnca, writeEncv, writeFree, writeFrma, writeFtyp, writeHdlr, writeHev1, writeHvc1, writeIden, writeImda, writeIsoBox, writeIsoBoxes, writeKind, writeLabl, writeMdat, writeMdhd, writeMehd, writeMeta, writeMfhd, writeMfro, writeMp4a, writeMvhd, writePayl, writePrft, writePrsl, writePssh, writeSchm, writeSdtp, writeSidx, writeSkip, writeSmhd, writeSsix, writeSthd, writeStsd, writeStss, writeSttg, writeStts, writeStyp, writeSubs, writeTenc, writeTfdt, writeTfhd, writeTfra, writeTkhd, writeTrex, writeTrun, writeUrl, writeUrn, writeVisualSampleEntryBox, writeVlab, writeVmhd, writeVttC, writeVtte };
+export { AdditionalMetadataContainerBox, AdditionalMetadataContainerBoxChild, AudioRenderingIndicationBox, AudioSampleEntryBox, AudioSampleEntryBoxChild, AudioSampleEntryType, Box, CONTAINERS, ChunkLargeOffsetBox, ChunkOffsetBox, CompactSampleSizeBox, CompositionTimeToSampleBox, CompositionTimeToSampleEntry, DATA, DataEntryUrlBox, DataEntryUrnBox, DataInformationBox, DataInformationBoxChild, DataReferenceBox, DecodingTimeSample, DecodingTimeToSampleBox, DegradationPriorityBox, EditBox, EditBoxChild, EditListBox, EditListEntry, EncryptedSample, Entity, EventMessageBox, ExtendedLanguageBox, FileTypeBox, FreeSpaceBox, FullBox, GroupsListBox, GroupsListBoxChild, HandlerReferenceBox, HintMediaHeaderBox, INT, IdentifiedMediaDataBox, IpmpInfoBox, IsoBox, IsoBoxContainer, IsoBoxContainerMap, IsoBoxData, IsoBoxMap, IsoBoxReadView, IsoBoxReadViewConfig, IsoBoxReadableStream, IsoBoxReader, IsoBoxReaderMap, IsoBoxReaderReturn, IsoBoxStreamable, IsoBoxType, IsoBoxWriteView, IsoBoxWriteViewConfig, IsoBoxWriter, IsoBoxWriterMap, IsoFieldTypeMap, IsoTypedParsedBox, ItemExtent, ItemInfoBox, ItemInfoBoxChild, ItemInfoEntry, ItemLocation, ItemLocationBox, ItemProtectionBox, ItemProtectionBoxChild, ItemReferenceBox, ItemReferenceBoxChild, LabelBox, MediaBox, MediaBoxChild, MediaDataBox, MediaHeaderBox, MediaInformationBox, MediaInformationBoxChild, MetaBox, MetaBoxChild, MovieBox, MovieBoxChild, MovieExtendsBox, MovieExtendsBoxChild, MovieExtendsHeaderBox, MovieFragmentBox, MovieFragmentBoxChild, MovieFragmentHeaderBox, MovieFragmentRandomAccessBox, MovieFragmentRandomAccessBoxChild, MovieFragmentRandomAccessOffsetBox, MovieHeaderBox, NullMediaHeaderBox, OriginalFormatBox, ParsedBox, ParsedIsoBox, PreselectionGroupBox, PreselectionGroupBoxChild, PrimaryItemBox, ProducerReferenceTimeBox, ProtectionSchemeInformationBox, ProtectionSchemeInformationBoxChild, ProtectionSystemSpecificHeaderBox, STRING, SampleAuxiliaryInformationOffsetsBox, SampleAuxiliaryInformationSizesBox, SampleDependencyTypeBox, SampleDescriptionBox, SampleEncryptionBox, SampleEntryBox, SampleGroupDescriptionBox, SampleSizeBox, SampleTableBox, SampleTableBoxChild, SampleToChunkBox, SampleToChunkEntry, SampleToGroupBox, SampleToGroupEntry, SchemeInformationBox, SchemeInformationBoxChild, SchemeTypeBox, SegmentIndexBox, SegmentIndexReference, SegmentTypeBox, ShadowSyncEntry, ShadowSyncSampleBox, SingleItemTypeReferenceBox, SoundMediaHeaderBox, SubTrackBox, SubTrackBoxChild, Subsample, SubsampleEncryption, SubsampleEntry, SubsampleInformationBox, Subsegment, SubsegmentIndexBox, SubsegmentRange, SubtitleMediaHeaderBox, SyncSample, SyncSampleBox, TEMPLATE, TrackBox, TrackBoxChild, TrackEncryptionBox, TrackExtendsBox, TrackFragmentBaseMediaDecodeTimeBox, TrackFragmentBox, TrackFragmentBoxChild, TrackFragmentHeaderBox, TrackFragmentRandomAccessBox, TrackFragmentRandomAccessEntry, TrackHeaderBox, TrackKindBox, TrackReferenceBox, TrackReferenceBoxChild, TrackReferenceTypeBox, TrackRunBox, TrackRunSample, TraverseIsoBoxesConfig, TypeBox, UINT, UTF8, UserDataBox, UserDataBoxChild, VideoMediaHeaderBox, VisualSampleEntryBox, VisualSampleEntryBoxChild, VisualSampleEntryType, WebVttConfigurationBox, WebVttCueBox, WebVttCueChild, WebVttCueIdBox, WebVttCuePayloadBox, WebVttEmptySampleBox, WebVttSettingsBox, WebVttSourceLabelBox, co64, createAudioSampleEntryReader, createIsoBoxReadableStream, createVisualSampleEntryReader, filterIsoBoxes, findIsoBox, isContainer, isFullBox, readArdi, readAudioSampleEntryBox, readAvc1, readAvc2, readAvc3, readAvc4, readCtts, readDref, readElng, readElst, readEmsg, readEnca, readEncv, readFree, readFrma, readFtyp, readHdlr, readHev1, readHvc1, readIden, readImda, readIsoBoxes, readKind, readLabl, readMdat, readMdhd, readMehd, readMeta, readMfhd, readMfro, readMp4a, readMvhd, readPayl, readPrft, readPrsl, readPssh, readSchm, readSdtp, readSidx, readSkip, readSmhd, readSsix, readSthd, readStsd, readStss, readSttg, readStts, readStyp, readSubs, readTenc, readTfdt, readTfhd, readTfra, readTkhd, readTrex, readTrun, readUrl, readUrn, readVisualSampleEntryBox, readVlab, readVmhd, readVttC, readVtte, stz2, traverseIsoBoxes, url, urn, writeArdi, writeAudioSampleEntryBox, writeAvc1, writeAvc2, writeAvc3, writeAvc4, writeCtts, writeDref, writeElng, writeElst, writeEmsg, writeEnca, writeEncv, writeFree, writeFrma, writeFtyp, writeHdlr, writeHev1, writeHvc1, writeIden, writeImda, writeIsoBox, writeIsoBoxes, writeKind, writeLabl, writeMdat, writeMdhd, writeMehd, writeMeta, writeMfhd, writeMfro, writeMp4a, writeMvhd, writePayl, writePrft, writePrsl, writePssh, writeSchm, writeSdtp, writeSidx, writeSkip, writeSmhd, writeSsix, writeSthd, writeStsd, writeStss, writeSttg, writeStts, writeStyp, writeSubs, writeTenc, writeTfdt, writeTfhd, writeTfra, writeTkhd, writeTrex, writeTrun, writeUrl, writeUrn, writeVisualSampleEntryBox, writeVlab, writeVmhd, writeVttC, writeVtte };
 //# sourceMappingURL=index.d.ts.map