youtube-transcript-nodejs 0.1.0

package/dist/esm/models/TranscriptList.js

@@ -0,0 +1,79 @@
+import { NoTranscriptFound } from '../errors/index.js';
+import { Transcript } from './Transcript.js';
+/**
+ * Collection of all available transcript tracks for a video.
+ *
+ * Created via `YouTubeTranscriptApi.list(videoId)`. Use the `find*` helpers
+ * to pick a track, then call `.fetch()` on the result.
+ */
+export class TranscriptList {
+    videoId;
+    manuallyCreatedTranscripts;
+    generatedTranscripts;
+    translationLanguages;
+    constructor(videoId, manuallyCreatedTranscripts, generatedTranscripts, translationLanguages) {
+        this.videoId = videoId;
+        this.manuallyCreatedTranscripts = manuallyCreatedTranscripts;
+        this.generatedTranscripts = generatedTranscripts;
+        this.translationLanguages = translationLanguages;
+    }
+    /**
+     * Find a transcript matching one of the given language codes.
+     * Manual tracks are preferred over generated ones.
+     */
+    findTranscript(languageCodes) {
+        return this.findInOrder(languageCodes, [this.manuallyCreatedTranscripts, this.generatedTranscripts]);
+    }
+    /**
+     * Find only an ASR-generated transcript.
+     */
+    findGeneratedTranscript(languageCodes) {
+        return this.findInOrder(languageCodes, [this.generatedTranscripts]);
+    }
+    /**
+     * Find only a manually uploaded transcript.
+     */
+    findManuallyCreatedTranscript(languageCodes) {
+        return this.findInOrder(languageCodes, [this.manuallyCreatedTranscripts]);
+    }
+    findInOrder(codes, pools) {
+        for (const code of codes) {
+            for (const pool of pools) {
+                const found = pool.find((t) => t.languageCode === code);
+                if (found)
+                    return found;
+            }
+        }
+        throw new NoTranscriptFound({
+            videoId: this.videoId,
+            requestedLanguageCodes: codes,
+            transcriptData: this,
+        });
+    }
+    /**
+     * Iterate over all transcripts (manual first, then generated).
+     */
+    *[Symbol.iterator]() {
+        yield* this.manuallyCreatedTranscripts;
+        yield* this.generatedTranscripts;
+    }
+}
+/**
+ * Factory helper to build a TranscriptList from raw caption data.
+ *
+ * `httpClient` is propagated to each Transcript so they can fetch their
+ * own cues lazily.
+ */
+export function buildTranscriptList(httpClient, videoId, captionTracks, translationLanguages) {
+    const manual = [];
+    const generated = [];
+    for (const track of captionTracks) {
+        const t = new Transcript(httpClient, videoId, track.baseUrl, track.name, track.languageCode, track.kind === 'asr', track.isTranslatable ? translationLanguages : []);
+        if (track.kind === 'asr')
+            generated.push(t);
+        else
+            manual.push(t);
+    }
+    return new TranscriptList(videoId, manual, generated, translationLanguages);
+}
+//# sourceMappingURL=TranscriptList.js.map

package/dist/esm/models/TranscriptList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranscriptList.js","sourceRoot":"","sources":["../../../src/models/TranscriptList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,OAAO,CAAS;IAChB,0BAA0B,CAAwB;IAClD,oBAAoB,CAAwB;IAC5C,oBAAoB,CAAiC;IAE9D,YACE,OAAe,EACf,0BAAiD,EACjD,oBAA2C,EAC3C,oBAAoD;QAEpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,0BAA0B,GAAG,0BAA0B,CAAC;QAC7D,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,aAAgC;QAC7C,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACvG,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,aAAgC;QACtD,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,6BAA6B,CAAC,aAAgC;QAC5D,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC5E,CAAC;IAEO,WAAW,CACjB,KAAwB,EACxB,KAAyC;QAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC;gBACxD,IAAI,KAAK;oBAAE,OAAO,KAAK,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,MAAM,IAAI,iBAAiB,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,sBAAsB,EAAE,KAAK;YAC7B,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QAChB,KAAK,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC;QACvC,KAAK,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAA2B,EAC3B,OAAe,EACf,aAME,EACF,oBAAoD;IAEpD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,SAAS,GAAiB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,IAAI,UAAU,CACtB,UAAU,EACV,OAAO,EACP,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,IAAI,KAAK,KAAK,EACpB,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CACjD,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YACvC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;AAC9E,CAAC"}

package/dist/esm/models/TranscriptMetadata.d.ts

@@ -0,0 +1,10 @@
+import type { TranslationLanguage } from './TranslationLanguage.js';
+export interface TranscriptMetadata {
+    readonly videoId: string;
+    readonly languageName: string;
+    readonly languageCode: string;
+    readonly isGenerated: boolean;
+    readonly isTranslatable: boolean;
+    readonly translationLanguages: readonly TranslationLanguage[];
+}
+//# sourceMappingURL=TranscriptMetadata.d.ts.map

package/dist/esm/models/TranscriptMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranscriptMetadata.d.ts","sourceRoot":"","sources":["../../../src/models/TranscriptMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC/D"}

package/dist/esm/models/TranscriptMetadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TranscriptMetadata.js.map

package/dist/esm/models/TranscriptMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranscriptMetadata.js","sourceRoot":"","sources":["../../../src/models/TranscriptMetadata.ts"],"names":[],"mappings":""}

package/dist/esm/models/TranslationLanguage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A target language available for translation on a given track.
+ */
+export interface TranslationLanguage {
+    readonly languageCode: string;
+    readonly languageName: string;
+}
+//# sourceMappingURL=TranslationLanguage.d.ts.map

package/dist/esm/models/TranslationLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationLanguage.d.ts","sourceRoot":"","sources":["../../../src/models/TranslationLanguage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/dist/esm/models/TranslationLanguage.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TranslationLanguage.js.map

package/dist/esm/models/TranslationLanguage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationLanguage.js","sourceRoot":"","sources":["../../../src/models/TranslationLanguage.ts"],"names":[],"mappings":""}

package/dist/esm/models/index.d.ts

@@ -0,0 +1,8 @@
+export { FetchedTranscriptSnippet } from './FetchedTranscriptSnippet.js';
+export { FetchedTranscript } from './FetchedTranscript.js';
+export { Transcript } from './Transcript.js';
+export { TranscriptList, buildTranscriptList } from './TranscriptList.js';
+export type { TranslationLanguage } from './TranslationLanguage.js';
+export type { TranscriptMetadata } from './TranscriptMetadata.js';
+export type { FormattedTranscript } from './FormattedTranscript.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/models/index.js

@@ -0,0 +1,5 @@
+export { FetchedTranscriptSnippet } from './FetchedTranscriptSnippet.js';
+export { FetchedTranscript } from './FetchedTranscript.js';
+export { Transcript } from './Transcript.js';
+export { TranscriptList, buildTranscriptList } from './TranscriptList.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/parsers/captionTrackParser.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Parsed translation language entry.
+ */
+export interface TranslationLanguageJson {
+    readonly languageCode: string;
+    readonly languageName: string;
+}
+/**
+ * One caption track as returned by InnerTube.
+ */
+export interface CaptionTrackJson {
+    readonly baseUrl: string;
+    readonly languageCode: string;
+    readonly name: string;
+    readonly kind: '' | 'asr';
+    readonly isTranslatable: boolean;
+    readonly vssId: string;
+}
+/**
+ * The shape of `captions.playerCaptionsTracklistRenderer` we care about.
+ */
+export interface CaptionTracklistJson {
+    readonly captionTracks: readonly CaptionTrackJson[];
+    readonly translationLanguages?: readonly TranslationLanguageJson[];
+}
+export declare function parseCaptionTrack(node: unknown): CaptionTrackJson | null;
+export declare function parseTranslationLanguage(node: unknown): TranslationLanguageJson | null;
+export declare function parseCaptionTracklist(node: unknown): CaptionTracklistJson | null;
+//# sourceMappingURL=captionTrackParser.d.ts.map

package/dist/esm/parsers/captionTrackParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionTrackParser.d.ts","sourceRoot":"","sources":["../../../src/parsers/captionTrackParser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACpE;AA+BD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,GAAG,IAAI,CAqBxE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAStF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAuBhF"}

package/dist/esm/parsers/captionTrackParser.js

@@ -0,0 +1,91 @@
+/**
+ * Helpers to convert the InnerTube `playerCaptionsTracklistRenderer` JSON
+ * into clean JS values.
+ *
+ * Mirrors the Python library's `TranscriptList.build`.
+ */
+function readNameRuns(nameField) {
+    if (typeof nameField !== 'object' || nameField === null) {
+        return '';
+    }
+    const rec = nameField;
+    const runs = rec['runs'];
+    if (Array.isArray(runs) && runs.length > 0) {
+        const first = runs[0];
+        if (typeof first === 'object' && first !== null) {
+            const text = first['text'];
+            if (typeof text === 'string') {
+                return text;
+            }
+        }
+    }
+    const simpleText = rec['simpleText'];
+    if (typeof simpleText === 'string') {
+        return simpleText;
+    }
+    return '';
+}
+export function parseCaptionTrack(node) {
+    if (typeof node !== 'object' || node === null)
+        return null;
+    const rec = node;
+    const baseUrl = rec['baseUrl'];
+    const languageCode = rec['languageCode'];
+    const vssId = rec['vssId'];
+    if (typeof baseUrl !== 'string' || typeof languageCode !== 'string' || typeof vssId !== 'string') {
+        return null;
+    }
+    // Strip the &fmt=srv3 flag so the response defaults to XML (mirrors Python).
+    const cleanBaseUrl = baseUrl.replace(/&fmt=srv3/g, '');
+    const kindRaw = rec['kind'];
+    const kind = kindRaw === 'asr' ? 'asr' : '';
+    return {
+        baseUrl: cleanBaseUrl,
+        languageCode,
+        name: readNameRuns(rec['name']),
+        kind,
+        isTranslatable: rec['isTranslatable'] === true,
+        vssId,
+    };
+}
+export function parseTranslationLanguage(node) {
+    if (typeof node !== 'object' || node === null)
+        return null;
+    const rec = node;
+    const languageCode = rec['languageCode'];
+    if (typeof languageCode !== 'string')
+        return null;
+    return {
+        languageCode,
+        languageName: readNameRuns(rec['languageName']),
+    };
+}
+export function parseCaptionTracklist(node) {
+    if (typeof node !== 'object' || node === null)
+        return null;
+    const rec = node;
+    const captionTracksRaw = rec['captionTracks'];
+    if (!Array.isArray(captionTracksRaw))
+        return null;
+    const captionTracks = [];
+    for (const ct of captionTracksRaw) {
+        const parsed = parseCaptionTrack(ct);
+        if (parsed)
+            captionTracks.push(parsed);
+    }
+    if (captionTracks.length === 0)
+        return null;
+    const translationLanguagesRaw = rec['translationLanguages'];
+    let translationLanguages = [];
+    if (Array.isArray(translationLanguagesRaw)) {
+        const list = [];
+        for (const tl of translationLanguagesRaw) {
+            const parsed = parseTranslationLanguage(tl);
+            if (parsed)
+                list.push(parsed);
+        }
+        translationLanguages = list;
+    }
+    return { captionTracks, translationLanguages };
+}
+//# sourceMappingURL=captionTrackParser.js.map

package/dist/esm/parsers/captionTrackParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captionTrackParser.js","sourceRoot":"","sources":["../../../src/parsers/captionTrackParser.ts"],"names":[],"mappings":"AA4BA;;;;;GAKG;AAEH,SAAS,YAAY,CAAC,SAAkB;IACtC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACxD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAG,SAAoC,CAAC;IACjD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAI,KAAiC,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,6EAA6E;IAC7E,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAe,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,OAAO;QACL,OAAO,EAAE,YAAY;QACrB,YAAY;QACZ,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI;QACJ,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC,KAAK,IAAI;QAC9C,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,MAAM,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC;IACzC,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO;QACL,YAAY;QACZ,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,MAAM,gBAAgB,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,aAAa,GAAuB,EAAE,CAAC;IAC7C,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,uBAAuB,GAAG,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAC5D,IAAI,oBAAoB,GAAuC,EAAE,CAAC;IAClE,IAAI,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAA8B,EAAE,CAAC;QAC3C,KAAK,MAAM,EAAE,IAAI,uBAAuB,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,oBAAoB,GAAG,IAAI,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC;AACjD,CAAC"}

package/dist/esm/parsers/videoIdParser.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Try to extract a video id from `input`.
+ *
+ * @throws InvalidVideoId if `input` is not a valid YouTube id or URL.
+ */
+export declare function extractVideoId(input: string): string;
+/**
+ * Non-throwing variant of `extractVideoId`. Returns `null` on failure.
+ */
+export declare function tryExtractVideoId(input: string): string | null;
+//# sourceMappingURL=videoIdParser.d.ts.map

package/dist/esm/parsers/videoIdParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoIdParser.d.ts","sourceRoot":"","sources":["../../../src/parsers/videoIdParser.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D"}

package/dist/esm/parsers/videoIdParser.js

@@ -0,0 +1,61 @@
+import { VIDEO_ID_REGEX } from '../config/constants.js';
+import { InvalidVideoId } from '../errors/index.js';
+/**
+ * Extract a YouTube video id from a string that is either:
+ *  - a raw 11-character id
+ *  - any common YouTube URL form (watch?v=, youtu.be/, /shorts/, /embed/, etc.)
+ *
+ * Mirrors the Python library's regex set (added in PR #282 by Tesla2000).
+ */
+const URL_PATTERNS = [
+    // youtu.be/<id>
+    /(?:youtu\.be\/)([A-Za-z0-9_-]{11})/,
+    // youtube.com/shorts/<id>
+    /(?:youtube\.com\/shorts\/)([A-Za-z0-9_-]{11})/,
+    // youtube.com/embed/<id>
+    /(?:youtube\.com\/embed\/)([A-Za-z0-9_-]{11})/,
+    // youtube.com/v/<id>
+    /(?:youtube\.com\/v\/)([A-Za-z0-9_-]{11})/,
+    // music.youtube.com/watch?v=<id>
+    /(?:music\.youtube\.com\/watch\?v=)([A-Za-z0-9_-]{11})/,
+    // generic ?v=<id> or &v=<id>
+    /(?:\?v=|\&v=)([A-Za-z0-9_-]{11})/,
+];
+/**
+ * Try to extract a video id from `input`.
+ *
+ * @throws InvalidVideoId if `input` is not a valid YouTube id or URL.
+ */
+export function extractVideoId(input) {
+    if (typeof input !== 'string') {
+        throw new InvalidVideoId(String(input));
+    }
+    const trimmed = input.trim();
+    if (trimmed.length === 0) {
+        throw new InvalidVideoId(input);
+    }
+    // Fast path: already a canonical id.
+    if (VIDEO_ID_REGEX.test(trimmed)) {
+        return trimmed;
+    }
+    // Try URL patterns.
+    for (const re of URL_PATTERNS) {
+        const m = re.exec(trimmed);
+        if (m && m[1]) {
+            return m[1];
+        }
+    }
+    throw new InvalidVideoId(input);
+}
+/**
+ * Non-throwing variant of `extractVideoId`. Returns `null` on failure.
+ */
+export function tryExtractVideoId(input) {
+    try {
+        return extractVideoId(input);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=videoIdParser.js.map

package/dist/esm/parsers/videoIdParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoIdParser.js","sourceRoot":"","sources":["../../../src/parsers/videoIdParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,YAAY,GAAsB;IACtC,gBAAgB;IAChB,oCAAoC;IACpC,0BAA0B;IAC1B,+CAA+C;IAC/C,yBAAyB;IACzB,8CAA8C;IAC9C,qBAAqB;IACrB,0CAA0C;IAC1C,iCAAiC;IACjC,uDAAuD;IACvD,6BAA6B;IAC7B,kCAAkC;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,qCAAqC;IACrC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,oBAAoB;IACpB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC;QACH,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/parsers/watchHtmlParser.d.ts

@@ -0,0 +1,33 @@
+/** Marker that indicates the EU consent gate is present. */
+export declare const CONSENT_GATE_MARKER = "action=\"https://consent.youtube.com/s\"";
+/** Regex extracting the `v` form value used to mint the CONSENT cookie. */
+export declare const CONSENT_FORM_VALUE_REGEX: RegExp;
+/**
+ * Detect whether the watch HTML is the EU consent gate.
+ */
+export declare function isConsentGate(html: string): boolean;
+/**
+ * Detect whether the watch HTML is a CAPTCHA / bot-detect page.
+ *
+ * Python library checks for `class="g-recaptcha"`; we extend slightly.
+ */
+export declare function isCaptchaGate(html: string): boolean;
+/**
+ * Extract the `INNERTUBE_API_KEY` from watch HTML.
+ *
+ * @throws YouTubeDataUnparsable if no key is found.
+ * @throws IpBlocked (with statusCode undefined) if a CAPTCHA gate is detected.
+ */
+export declare function extractInnertubeApiKey(html: string, videoId: string): string;
+/**
+ * Extract the `v` parameter from the EU consent form.
+ *
+ * @returns the raw `v` value, or `null` if not found.
+ */
+export declare function extractConsentFormValue(html: string): string | null;
+/**
+ * Build a CONSENT cookie value in the format YouTube expects:
+ *   `YES+<v>`
+ */
+export declare function buildConsentCookieValue(v: string): string;
+//# sourceMappingURL=watchHtmlParser.d.ts.map

package/dist/esm/parsers/watchHtmlParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchHtmlParser.d.ts","sourceRoot":"","sources":["../../../src/parsers/watchHtmlParser.ts"],"names":[],"mappings":"AAoBA,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,6CAA2C,CAAC;AAE5E,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,QAA6B,CAAC;AAEnE;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAc5E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/esm/parsers/watchHtmlParser.js

@@ -0,0 +1,70 @@
+import { IpBlocked, YouTubeDataUnparsable } from '../errors/index.js';
+/**
+ * Parse the YouTube watch HTML to extract the `INNERTUBE_API_KEY` and
+ * (optionally) the EU-consent gate parameters.
+ *
+ * Mirrors the Python library's `_extract_innertube_api_key`:
+ *
+ *     pattern = r'"INNERTUBE_API_KEY":\s*"([a-zA-Z0-9_-]+)"'
+ *
+ * We also keep a couple of fallback patterns to make the parser resilient
+ * to YouTube's occasional A/B variations.
+ */
+const API_KEY_PATTERNS = [
+    /"INNERTUBE_API_KEY":\s*"([A-Za-z0-9_-]+)"/,
+    /"innertubeApiKey":\s*"([A-Za-z0-9_-]+)"/,
+    /"key":\s*"([A-Za-z0-9_-]{20,})"/,
+];
+/** Marker that indicates the EU consent gate is present. */
+export const CONSENT_GATE_MARKER = 'action="https://consent.youtube.com/s"';
+/** Regex extracting the `v` form value used to mint the CONSENT cookie. */
+export const CONSENT_FORM_VALUE_REGEX = /name="v" value="([^"]+)"/;
+/**
+ * Detect whether the watch HTML is the EU consent gate.
+ */
+export function isConsentGate(html) {
+    return html.includes(CONSENT_GATE_MARKER);
+}
+/**
+ * Detect whether the watch HTML is a CAPTCHA / bot-detect page.
+ *
+ * Python library checks for `class="g-recaptcha"`; we extend slightly.
+ */
+export function isCaptchaGate(html) {
+    return html.includes('class="g-recaptcha"') || html.includes('class="rc-imageselect"');
+}
+/**
+ * Extract the `INNERTUBE_API_KEY` from watch HTML.
+ *
+ * @throws YouTubeDataUnparsable if no key is found.
+ * @throws IpBlocked (with statusCode undefined) if a CAPTCHA gate is detected.
+ */
+export function extractInnertubeApiKey(html, videoId) {
+    if (isCaptchaGate(html)) {
+        throw new IpBlocked(videoId);
+    }
+    for (const re of API_KEY_PATTERNS) {
+        const m = re.exec(html);
+        if (m && m[1]) {
+            return m[1];
+        }
+    }
+    throw new YouTubeDataUnparsable(videoId, 'INNERTUBE_API_KEY not found in watch HTML (YouTube may have changed the page format).');
+}
+/**
+ * Extract the `v` parameter from the EU consent form.
+ *
+ * @returns the raw `v` value, or `null` if not found.
+ */
+export function extractConsentFormValue(html) {
+    const m = CONSENT_FORM_VALUE_REGEX.exec(html);
+    return m && m[1] ? m[1] : null;
+}
+/**
+ * Build a CONSENT cookie value in the format YouTube expects:
+ *   `YES+<v>`
+ */
+export function buildConsentCookieValue(v) {
+    return `YES+${v}`;
+}
+//# sourceMappingURL=watchHtmlParser.js.map

package/dist/esm/parsers/watchHtmlParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchHtmlParser.js","sourceRoot":"","sources":["../../../src/parsers/watchHtmlParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;;;;;;;;;GAUG;AAEH,MAAM,gBAAgB,GAAsB;IAC1C,2CAA2C;IAC3C,yCAAyC;IACzC,iCAAiC;CAClC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,wCAAwC,CAAC;AAE5E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AACzF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,OAAe;IAClE,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,gBAAgB,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,qBAAqB,CAC7B,OAAO,EACP,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,CAAS;IAC/C,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC"}

package/dist/esm/parsers/xmlTranscriptParser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * One timedtext XML cue, in its parsed form.
+ */
+export interface ParsedCue {
+    readonly text: string;
+    readonly start: number;
+    readonly duration: number;
+}
+/**
+ * Parse the timedtext XML response body.
+ *
+ * @throws Error if the input is not a string with at least one `<text>` element.
+ */
+export declare function parseTranscriptXml(rawXml: string, opts?: {
+    preserveFormatting?: boolean;
+}): readonly ParsedCue[];
+//# sourceMappingURL=xmlTranscriptParser.d.ts.map

package/dist/esm/parsers/xmlTranscriptParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlTranscriptParser.d.ts","sourceRoot":"","sources":["../../../src/parsers/xmlTranscriptParser.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAyBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,SAAS,SAAS,EAAE,CAmCtB"}

package/dist/esm/parsers/xmlTranscriptParser.js

@@ -0,0 +1,81 @@
+import { sanitizeTranscriptText } from '../util/htmlSanitizer.js';
+/**
+ * Parse timedtext XML into a list of cues.
+ *
+ * Note on parsing strategy: timedtext XML uses HTML-like markup INSIDE
+ * the `<text>` element (e.g. `<text><b>bold</b></text>`). A strict XML
+ * parser would treat the inner `<b>` as a nested element and lose the
+ * mixed-content ordering. The Python library uses defusedxml, which has
+ * the same limitation; the sanitizer layer below strips tags afterward.
+ *
+ * To avoid that pitfall, we extract `<text>` elements with a regex,
+ * which preserves the inner HTML verbatim for the sanitizer to handle.
+ *
+ * Expected input shape:
+ *
+ *     <transcript>
+ *       <text start="0.0" dur="1.54">Hello</text>
+ *       <text start="1.54" dur="2.0">With <b>bold</b></text>
+ *     </transcript>
+ */
+const TEXT_ELEMENT_REGEX = /<text\b([^>]*?)\/?>([\s\S]*?)<\/text>|<text\b([^>]*?)\/>/gi;
+const ATTR_REGEX = /([a-zA-Z_][\w:-]*)\s*=\s*"([^"]*)"/g;
+/**
+ * Parse the timedtext XML response body.
+ *
+ * @throws Error if the input is not a string with at least one `<text>` element.
+ */
+export function parseTranscriptXml(rawXml, opts = {}) {
+    if (typeof rawXml !== 'string' || rawXml.length === 0) {
+        throw new Error('Empty transcript XML');
+    }
+    // Sanity: must contain at least one <text tag; otherwise we treat as malformed.
+    if (!/<text\b/i.test(rawXml)) {
+        throw new Error('Transcript XML contains no <text> elements');
+    }
+    const preserveFormatting = opts.preserveFormatting === true;
+    const cues = [];
+    // Reset lastIndex to be safe.
+    TEXT_ELEMENT_REGEX.lastIndex = 0;
+    let match;
+    while ((match = TEXT_ELEMENT_REGEX.exec(rawXml)) !== null) {
+        // The regex captures either:
+        //   match[1] = attrs, match[2] = inner content (paired <text>...</text>)
+        // or:
+        //   match[3] = attrs (self-closing <text ... />)
+        const attrs = match[1] ?? match[3] ?? '';
+        const innerHtml = match[2] ?? '';
+        if (innerHtml.length === 0)
+            continue;
+        const { start, duration } = parseAttributes(attrs);
+        if (!Number.isFinite(start))
+            continue;
+        cues.push({
+            text: sanitizeTranscriptText(innerHtml, preserveFormatting),
+            start,
+            duration,
+        });
+    }
+    return cues;
+}
+function parseAttributes(attrString) {
+    const map = {};
+    ATTR_REGEX.lastIndex = 0;
+    let m;
+    while ((m = ATTR_REGEX.exec(attrString)) !== null) {
+        const name = m[1];
+        const value = m[2];
+        if (name && value !== undefined) {
+            map[name] = value;
+        }
+    }
+    const startStr = map['start'];
+    const durStr = map['dur'];
+    const start = startStr !== undefined ? Number.parseFloat(startStr) : 0;
+    const duration = durStr !== undefined ? Number.parseFloat(durStr) : 0;
+    return {
+        start: Number.isFinite(start) ? start : 0,
+        duration: Number.isFinite(duration) ? duration : 0,
+    };
+}
+//# sourceMappingURL=xmlTranscriptParser.js.map

package/dist/esm/parsers/xmlTranscriptParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmlTranscriptParser.js","sourceRoot":"","sources":["../../../src/parsers/xmlTranscriptParser.ts"],"names":[],"mappings":"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"}

package/dist/esm/potoken/AutoPoTokenProvider.d.ts

@@ -0,0 +1,28 @@
+import { type PoTokenProvider, type TokenResult } from './types.js';
+export interface AutoPoTokenProviderOptions {
+    /** Custom fetch implementation (for tests / SSR). */
+    fetchImpl?: typeof fetch;
+    /** Token TTL override (default 12h). */
+    ttlMs?: number;
+    /** Pre-set visitorData; otherwise the video id is used. */
+    visitorData?: string;
+    /** Cache TTL for the challenge script (default 5min). */
+    challengeTtlMs?: number;
+}
+export declare class AutoPoTokenProvider implements PoTokenProvider {
+    private readonly fetchImpl;
+    private readonly ttlMs;
+    private readonly challengeTtlMs;
+    private visitorData;
+    private cache;
+    constructor(opts?: AutoPoTokenProviderOptions);
+    setVisitorData(visitorData: string): void;
+    /**
+     * Whether bgutils-js is installed and the provider is usable.
+     */
+    isAvailable(): boolean;
+    generateForVideo(videoId: string): Promise<TokenResult>;
+    dispose(): Promise<void>;
+    private getOrLoadChallenge;
+}
+//# sourceMappingURL=AutoPoTokenProvider.d.ts.map

package/dist/esm/potoken/AutoPoTokenProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoPoTokenProvider.d.ts","sourceRoot":"","sources":["../../../src/potoken/AutoPoTokenProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAmBlF,MAAM,WAAW,0BAA0B;IACzC,qDAAqD;IACrD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkDD,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,KAAK,CAAoC;gBAErC,IAAI,GAAE,0BAA+B;IAWjD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAYhB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsDvD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAWhB,kBAAkB;CAkDjC"}