@ismail-elkorchi/bytefold 0.6.0

package/dist/compression/node-backend.js

@@ -0,0 +1,103 @@
+import { Duplex } from 'node:stream';
+import { createBrotliCompress, createBrotliDecompress, createDeflate, createDeflateRaw, createGunzip, createGzip, createInflate, createInflateRaw, createZstdCompress, createZstdDecompress, constants } from 'node:zlib';
+function toWebTransform(duplex, signal) {
+    if (signal) {
+        if (signal.aborted) {
+            duplex.destroy(signal.reason instanceof Error ? signal.reason : new Error('Aborted'));
+        }
+        else {
+            signal.addEventListener('abort', () => {
+                duplex.destroy(signal.reason instanceof Error ? signal.reason : new Error('Aborted'));
+            }, { once: true });
+        }
+    }
+    const { readable, writable } = Duplex.toWeb(duplex);
+    return {
+        readable: readable,
+        writable: writable
+    };
+}
+function supports(algorithm, mode) {
+    switch (algorithm) {
+        case 'gzip':
+            return true;
+        case 'deflate-raw':
+            return true;
+        case 'deflate':
+            return true;
+        case 'brotli':
+            return typeof createBrotliCompress === 'function' && typeof createBrotliDecompress === 'function';
+        case 'zstd':
+            if (mode === 'compress') {
+                return typeof createZstdCompress === 'function';
+            }
+            return typeof createZstdDecompress === 'function';
+        case 'bzip2':
+            return false;
+        case 'xz':
+            return false;
+        default: {
+            const exhaustive = algorithm;
+            return exhaustive;
+        }
+    }
+}
+function create(algorithm, mode, options) {
+    const signal = options?.signal;
+    switch (algorithm) {
+        case 'gzip': {
+            const stream = mode === 'compress'
+                ? createGzip(options?.level !== undefined ? { level: options.level } : undefined)
+                : createGunzip();
+            return toWebTransform(stream, signal);
+        }
+        case 'deflate': {
+            const stream = mode === 'compress'
+                ? createDeflate(options?.level !== undefined ? { level: options.level } : undefined)
+                : createInflate();
+            return toWebTransform(stream, signal);
+        }
+        case 'deflate-raw': {
+            const stream = mode === 'compress'
+                ? createDeflateRaw(options?.level !== undefined ? { level: options.level } : undefined)
+                : createInflateRaw();
+            return toWebTransform(stream, signal);
+        }
+        case 'brotli': {
+            if (!supports('brotli', mode)) {
+                throw new Error('Brotli not supported in this Node runtime');
+            }
+            const stream = mode === 'compress'
+                ? createBrotliCompress(options?.quality !== undefined
+                    ? { params: { [constants.BROTLI_PARAM_QUALITY]: options.quality } }
+                    : undefined)
+                : createBrotliDecompress();
+            return toWebTransform(stream, signal);
+        }
+        case 'zstd': {
+            if (!supports('zstd', mode)) {
+                throw new Error('Zstandard not supported in this Node runtime');
+            }
+            const params = options?.level !== undefined
+                ? { params: { [constants.ZSTD_c_compressionLevel]: options.level } }
+                : undefined;
+            const stream = mode === 'compress' ? createZstdCompress(params) : createZstdDecompress();
+            return toWebTransform(stream, signal);
+        }
+        case 'bzip2': {
+            throw new Error('BZip2 not supported in node:zlib backend');
+        }
+        case 'xz': {
+            throw new Error('XZ not supported in node:zlib backend');
+        }
+        default: {
+            const exhaustive = algorithm;
+            return exhaustive;
+        }
+    }
+}
+export const nodeBackend = {
+    supports,
+    create
+};
+//# sourceMappingURL=node-backend.js.map

package/dist/compression/node-backend.js.map

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

package/dist/compression/registry.d.ts

@@ -0,0 +1,10 @@
+import type { ZipCompressionCodec } from './types.js';
+/** Register a custom ZIP compression codec by method id. */
+export declare function registerCompressionCodec(codec: ZipCompressionCodec): void;
+/** Look up a registered ZIP compression codec by method id. */
+export declare function getCompressionCodec(methodId: number): ZipCompressionCodec | undefined;
+/** Check whether a ZIP compression codec is registered. */
+export declare function hasCompressionCodec(methodId: number): boolean;
+/** List all registered ZIP compression codecs. */
+export declare function listCompressionCodecs(): ZipCompressionCodec[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/compression/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/compression/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMtD,4DAA4D;AAC5D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAEzE;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAErF;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,kDAAkD;AAClD,wBAAgB,qBAAqB,IAAI,mBAAmB,EAAE,CAE7D"}

package/dist/compression/registry.js

@@ -0,0 +1,30 @@
+import { DEFLATE64_CODEC, DEFLATE_CODEC, STORE_CODEC, ZSTD_CODEC } from './codecs.js';
+const codecs = new Map();
+let builtinsRegistered = false;
+/** Register a custom ZIP compression codec by method id. */
+export function registerCompressionCodec(codec) {
+    codecs.set(codec.methodId, codec);
+}
+/** Look up a registered ZIP compression codec by method id. */
+export function getCompressionCodec(methodId) {
+    return codecs.get(methodId);
+}
+/** Check whether a ZIP compression codec is registered. */
+export function hasCompressionCodec(methodId) {
+    return codecs.has(methodId);
+}
+/** List all registered ZIP compression codecs. */
+export function listCompressionCodecs() {
+    return [...codecs.values()];
+}
+function registerBuiltins() {
+    if (builtinsRegistered)
+        return;
+    builtinsRegistered = true;
+    registerCompressionCodec(STORE_CODEC);
+    registerCompressionCodec(DEFLATE_CODEC);
+    registerCompressionCodec(ZSTD_CODEC);
+    registerCompressionCodec(DEFLATE64_CODEC);
+}
+registerBuiltins();
+//# sourceMappingURL=registry.js.map

package/dist/compression/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/compression/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtF,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;AACtD,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,UAAU,wBAAwB,CAAC,KAA0B;IACjE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,qBAAqB;IACnC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB;IACvB,IAAI,kBAAkB;QAAE,OAAO;IAC/B,kBAAkB,GAAG,IAAI,CAAC;IAC1B,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACtC,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACxC,wBAAwB,CAAC,UAAU,CAAC,CAAC;IACrC,wBAAwB,CAAC,eAAe,CAAC,CAAC;AAC5C,CAAC;AAED,gBAAgB,EAAE,CAAC"}

package/dist/compression/streams.d.ts

@@ -0,0 +1,31 @@
+import type { CompressionProfile } from '../compress/types.js';
+export type CompressionAlgorithm = 'gzip' | 'deflate' | 'deflate-raw' | 'brotli' | 'zstd' | 'bzip2' | 'xz';
+export type CompressionMode = 'compress' | 'decompress';
+export type CompressionProgress = {
+    bytesIn: bigint;
+    bytesOut: bigint;
+};
+export interface CompressionTransformOptions {
+    algorithm: CompressionAlgorithm;
+    signal?: AbortSignal;
+    onProgress?: (event: CompressionProgress) => void;
+    level?: number;
+    quality?: number;
+    maxOutputBytes?: bigint | number;
+    maxCompressionRatio?: number;
+    maxDictionaryBytes?: bigint | number;
+    maxBufferedInputBytes?: number;
+    maxBzip2BlockSize?: number;
+    /** @internal */
+    __xzDebug?: {
+        maxBufferedInputBytes?: number;
+        maxDictionaryBytesUsed?: number;
+        totalBytesIn?: number;
+        totalBytesOut?: number;
+    };
+    profile?: CompressionProfile;
+}
+export declare function createCompressTransform(options: CompressionTransformOptions): Promise<ReadableWritablePair<Uint8Array, Uint8Array>>;
+export declare function createDecompressTransform(options: CompressionTransformOptions): Promise<ReadableWritablePair<Uint8Array, Uint8Array>>;
+export declare function supportsCompressionAlgorithm(algorithm: CompressionAlgorithm, mode: CompressionMode): Promise<boolean>;
+//# sourceMappingURL=streams.d.ts.map

package/dist/compression/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/compression/streams.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC3G,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB;IAChB,SAAS,CAAC,EAAE;QACV,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAEvD;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAEvD;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,oBAAoB,EAC/B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/compression/streams.js

@@ -0,0 +1,147 @@
+import { ZipError } from '../errors.js';
+import { createBzip2DecompressStream } from './bzip2.js';
+import { createXzDecompressStream } from './xz.js';
+export async function createCompressTransform(options) {
+    return createTransform('compress', options);
+}
+export async function createDecompressTransform(options) {
+    return createTransform('decompress', options);
+}
+export async function supportsCompressionAlgorithm(algorithm, mode) {
+    if (algorithm === 'bzip2')
+        return mode === 'decompress';
+    if (algorithm === 'xz')
+        return mode === 'decompress';
+    if (await nodeSupports(algorithm, mode))
+        return true;
+    return supportsWebCompression(algorithm, mode);
+}
+async function createTransform(mode, options) {
+    const { algorithm } = options;
+    if (algorithm === 'bzip2') {
+        if (mode !== 'decompress') {
+            throw new ZipError('ZIP_UNSUPPORTED_METHOD', 'BZip2 compression is not supported');
+        }
+        const transform = createBzip2DecompressStream({
+            ...(options.signal ? { signal: options.signal } : {}),
+            ...(options.maxOutputBytes !== undefined ? { maxOutputBytes: options.maxOutputBytes } : {}),
+            ...(options.maxCompressionRatio !== undefined ? { maxCompressionRatio: options.maxCompressionRatio } : {}),
+            ...(options.maxBzip2BlockSize !== undefined ? { maxBlockSize: options.maxBzip2BlockSize } : {})
+        });
+        return attachProgress(transform, options.onProgress);
+    }
+    if (algorithm === 'xz') {
+        if (mode !== 'decompress') {
+            throw new ZipError('ZIP_UNSUPPORTED_METHOD', 'XZ compression is not supported');
+        }
+        const transform = createXzDecompressStream({
+            ...(options.signal ? { signal: options.signal } : {}),
+            ...(options.maxOutputBytes !== undefined ? { maxOutputBytes: options.maxOutputBytes } : {}),
+            ...(options.maxCompressionRatio !== undefined ? { maxCompressionRatio: options.maxCompressionRatio } : {}),
+            ...(options.maxDictionaryBytes !== undefined ? { maxDictionaryBytes: options.maxDictionaryBytes } : {}),
+            ...(options.maxBufferedInputBytes !== undefined ? { maxBufferedInputBytes: options.maxBufferedInputBytes } : {}),
+            ...(options.__xzDebug ? { __xzDebug: options.__xzDebug } : {}),
+            ...(options.profile ? { profile: options.profile } : {})
+        });
+        return attachProgress(transform, options.onProgress);
+    }
+    const nodeBackend = await getNodeBackend();
+    if (nodeBackend?.supports(algorithm, mode)) {
+        const transform = nodeBackend.create(algorithm, mode, options);
+        return attachProgress(transform, options.onProgress);
+    }
+    if (supportsWebCompression(algorithm, mode)) {
+        const transform = createWebCompressionTransform(algorithm, mode, options.signal);
+        return attachProgress(transform, options.onProgress);
+    }
+    throw new ZipError('ZIP_UNSUPPORTED_METHOD', `Compression algorithm ${algorithm} not supported`);
+}
+function isNodeRuntime() {
+    return typeof process !== 'undefined' && !!process.versions?.node;
+}
+let nodeBackendPromise = null;
+async function getNodeBackend() {
+    if (!isNodeRuntime())
+        return null;
+    if (!nodeBackendPromise) {
+        const moduleUrl = new URL('./node-backend.js', import.meta.url).href;
+        nodeBackendPromise = import(moduleUrl)
+            .then((mod) => mod.nodeBackend)
+            .catch(() => null);
+    }
+    return nodeBackendPromise;
+}
+async function nodeSupports(algorithm, mode) {
+    const backend = await getNodeBackend();
+    return backend ? backend.supports(algorithm, mode) : false;
+}
+const webSupportCache = new Map();
+function supportsWebCompression(algorithm, mode) {
+    const key = `${mode}:${algorithm}`;
+    const cached = webSupportCache.get(key);
+    if (cached !== undefined)
+        return cached;
+    let ok = false;
+    try {
+        if (mode === 'compress') {
+            const stream = new CompressionStream(algorithm);
+            void stream;
+        }
+        else {
+            const stream = new DecompressionStream(algorithm);
+            void stream;
+        }
+        ok = true;
+    }
+    catch {
+        ok = false;
+    }
+    webSupportCache.set(key, ok);
+    return ok;
+}
+function createWebCompressionTransform(algorithm, mode, signal) {
+    let transform;
+    try {
+        transform = (mode === 'compress'
+            ? new CompressionStream(algorithm)
+            : new DecompressionStream(algorithm));
+    }
+    catch {
+        throw new ZipError('ZIP_UNSUPPORTED_METHOD', `Compression algorithm ${algorithm} is not supported by Web streams`);
+    }
+    if (signal) {
+        if (signal.aborted) {
+            transform.writable.abort(signal.reason).catch(() => { });
+        }
+        else {
+            signal.addEventListener('abort', () => {
+                transform.writable.abort(signal.reason).catch(() => { });
+                transform.readable.cancel(signal.reason).catch(() => { });
+            }, { once: true });
+        }
+    }
+    return transform;
+}
+function attachProgress(transform, onProgress) {
+    if (!onProgress)
+        return transform;
+    let bytesIn = 0n;
+    let bytesOut = 0n;
+    const inTap = new TransformStream({
+        transform(chunk, controller) {
+            bytesIn += BigInt(chunk.length);
+            onProgress({ bytesIn, bytesOut });
+            controller.enqueue(chunk);
+        }
+    });
+    const outTap = new TransformStream({
+        transform(chunk, controller) {
+            bytesOut += BigInt(chunk.length);
+            onProgress({ bytesIn, bytesOut });
+            controller.enqueue(chunk);
+        }
+    });
+    const readable = inTap.readable.pipeThrough(transform).pipeThrough(outTap);
+    return { readable, writable: inTap.writable };
+}
+//# sourceMappingURL=streams.js.map

package/dist/compression/streams.js.map

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

package/dist/compression/types.d.ts

@@ -0,0 +1,19 @@
+/** Readable/writable pair used by ZIP compression codecs. */
+export type ZipCompressionStream = ReadableWritablePair<Uint8Array, Uint8Array>;
+/** Options for ZIP decompression streams. */
+export type ZipDecompressionOptions = {
+    signal?: AbortSignal;
+};
+/** Options for ZIP compression streams. */
+export type ZipCompressionOptions = {
+    signal?: AbortSignal;
+};
+/** Codec interface for ZIP compression methods. */
+export type ZipCompressionCodec = {
+    methodId: number;
+    name: string;
+    supportsStreaming: boolean;
+    createDecompressStream(options?: ZipDecompressionOptions): ZipCompressionStream | Promise<ZipCompressionStream>;
+    createCompressStream?(options?: ZipCompressionOptions): ZipCompressionStream | Promise<ZipCompressionStream>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/compression/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compression/types.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAEhF,6CAA6C;AAC7C,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAChH,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC9G,CAAC"}

package/dist/compression/types.js

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

package/dist/compression/types.js.map

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

package/dist/compression/xz.d.ts

@@ -0,0 +1,21 @@
+import type { CompressionProfile } from '../compress/types.js';
+export type XzDecompressOptions = {
+    signal?: AbortSignal;
+    maxOutputBytes?: bigint | number;
+    maxCompressionRatio?: number;
+    maxDictionaryBytes?: bigint | number;
+    maxBufferedInputBytes?: number;
+    profile?: CompressionProfile;
+};
+export type XzLimitOptions = {
+    maxDictionaryBytes?: bigint | number;
+    maxBufferedInputBytes?: number;
+    profile?: CompressionProfile;
+};
+export declare function createXzDecompressStream(options?: XzDecompressOptions): ReadableWritablePair<Uint8Array, Uint8Array>;
+export declare function resolveXzLimits(options?: XzLimitOptions): {
+    maxDictionaryBytes: bigint;
+    maxBufferedInputBytes: number;
+};
+export declare function readXzDictionarySize(data: Uint8Array): number | undefined;
+//# sourceMappingURL=xz.d.ts.map

package/dist/compression/xz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xz.d.ts","sourceRoot":"","sources":["../../src/compression/xz.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AA4BF,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,mBAAwB,GAChC,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,CAkC9C;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,cAAmB,GAAG;IAC7D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CASA;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAqDzE"}