@meframe/core 0.0.1

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+export type { LoadBackpressure, VideoDecodeBackpressure, MeframeConfig, ResolvedConfig, ConfigLoaderOptions, } from './types';
+export { validateConfig, validateBackpressureValue } from './validation';
+export type { ValidationResult } from './validation';
+export { DEFAULT_CONFIG, TUNING_PRESETS } from './defaults';
+export { ConfigLoader, getConfigLoader, loadConfig, getConfig } from './ConfigLoader';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/config/presets.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Predefined canvas size presets for common use cases
+ */
+export declare const CANVAS_PRESETS: {
+    readonly MOBILE_PORTRAIT: {
+        readonly width: 720;
+        readonly height: 1280;
+        readonly description: "Mobile vertical video (720p)";
+    };
+    readonly HD_PORTRAIT: {
+        readonly width: 1080;
+        readonly height: 1920;
+        readonly description: "HD vertical video (TikTok, Instagram Reels)";
+    };
+    readonly HD_LANDSCAPE: {
+        readonly width: 1920;
+        readonly height: 1080;
+        readonly description: "HD horizontal video (YouTube, standard HD)";
+    };
+    readonly UHD_LANDSCAPE: {
+        readonly width: 3840;
+        readonly height: 2160;
+        readonly description: "4K horizontal video (Ultra HD)";
+    };
+    readonly SQUARE_HD: {
+        readonly width: 1080;
+        readonly height: 1080;
+        readonly description: "Square HD (Instagram post)";
+    };
+};
+export type CanvasPreset = keyof typeof CANVAS_PRESETS;
+//# sourceMappingURL=presets.d.ts.map

package/dist/config/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/config/presets.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC"}

package/dist/config/presets.js

@@ -0,0 +1,11 @@
+const CANVAS_PRESETS = {
+  // Mobile vertical (default)
+  MOBILE_PORTRAIT: {
+    width: 720,
+    height: 1280
+  }
+};
+export {
+  CANVAS_PRESETS
+};
+//# sourceMappingURL=presets.js.map

package/dist/config/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sources":["../../src/config/presets.ts"],"sourcesContent":["/**\n * Predefined canvas size presets for common use cases\n */\n\nexport const CANVAS_PRESETS = {\n  // Mobile vertical (default)\n  MOBILE_PORTRAIT: {\n    width: 720,\n    height: 1280,\n    description: 'Mobile vertical video (720p)',\n  },\n\n  // HD vertical (social media)\n  HD_PORTRAIT: {\n    width: 1080,\n    height: 1920,\n    description: 'HD vertical video (TikTok, Instagram Reels)',\n  },\n\n  // HD horizontal (YouTube)\n  HD_LANDSCAPE: {\n    width: 1920,\n    height: 1080,\n    description: 'HD horizontal video (YouTube, standard HD)',\n  },\n\n  // 4K horizontal\n  UHD_LANDSCAPE: {\n    width: 3840,\n    height: 2160,\n    description: '4K horizontal video (Ultra HD)',\n  },\n\n  // Square (Instagram post)\n  SQUARE_HD: {\n    width: 1080,\n    height: 1080,\n    description: 'Square HD (Instagram post)',\n  },\n} as const;\n\nexport type CanvasPreset = keyof typeof CANVAS_PRESETS;\n"],"names":[],"mappings":"AAIO,MAAM,iBAAiB;AAAA;AAAA,EAE5B,iBAAiB;AAAA,IACf,OAAO;AAAA,IACP,QAAQ;AAAA,EAEV;AA6BF;"}

package/dist/config/types.d.ts

@@ -0,0 +1,199 @@
+/**
+ * load backpressure configuration
+ */
+export interface LoadBackpressure {
+    /** High-water mark of ReadableStreamDefaultController queue (bytes) */
+    highWaterMark?: number;
+    /** Timeout (ms) before failing when backpressure persists */
+    stallTimeoutMs?: number;
+}
+/**
+ * Video decode backpressure configuration
+ */
+export interface VideoDecodeBackpressure {
+    /** TransformStream queue size (EncodedVideoChunk) */
+    highWaterMark?: number;
+    /** Pause when VideoDecoder.decodeQueueSize ≥ threshold */
+    decodeQueueThreshold?: number;
+}
+/**
+ * Main Meframe configuration schema (stage-first architecture)
+ */
+export interface MeframeConfig {
+    /** Global cross-stage options */
+    global?: {
+        logLevel?: 'verbose' | 'info' | 'warn' | 'error';
+        workerBaseUrl?: string;
+        workerExtension?: string;
+        enablePerfMonitor?: boolean;
+        defaultCanvasWidth?: number;
+        defaultCanvasHeight?: number;
+        defaultFps?: number;
+    };
+    /** Resource loading stage - fetch → ReadableStream */
+    load?: {
+        backpressure?: LoadBackpressure;
+        retry?: {
+            maxAttempts?: number;
+            baseDelayMs?: number;
+        };
+        window?: {
+            maxInflightPerClip?: number;
+            maxInflight?: number;
+            chunkSize?: number;
+        };
+    };
+    /** Container demux stage - Uint8Array → EncodedChunk */
+    demux?: {
+        backpressure?: {
+            highWaterMark?: number;
+        };
+        preferredContainer?: 'mp4' | 'webm';
+    };
+    /** Decode stage - EncodedChunk → VideoFrame / AudioData */
+    decode?: {
+        video?: {
+            backpressure?: VideoDecodeBackpressure;
+            codecHints?: ('h264' | 'hevc' | 'vp9')[];
+            maxGOPs?: number;
+        };
+        audio?: {
+            backpressure?: {
+                highWaterMark?: number;
+            };
+            sampleRate?: number;
+        };
+    };
+    /** Compose stage */
+    compose?: {
+        canvas?: {
+            width?: number;
+            height?: number;
+            backgroundColor?: string;
+        };
+        visual?: {
+            gpuAdapter?: 'webgl' | 'webgpu';
+            enableSmoothing?: boolean;
+            enableHardwareAcceleration?: boolean;
+        };
+        audio?: {
+            enableDucking?: boolean;
+        };
+    };
+    /** Encode stage */
+    encode?: {
+        video?: {
+            bitrateKbps?: number;
+            keyIntervalS?: number;
+            codec?: string;
+            width?: number;
+            height?: number;
+            framerate?: number;
+            bitrateMode?: 'constant' | 'variable';
+            latencyMode?: 'quality' | 'realtime';
+            hardwareAcceleration?: 'no-preference' | 'prefer-hardware' | 'prefer-software';
+        };
+        audio?: {
+            bitrateKbps?: number;
+            codec?: string;
+            sampleRate?: number;
+            numberOfChannels?: number;
+        };
+    };
+    /** Cache configuration */
+    cache?: {
+        l1?: {
+            maxFrames?: number;
+        };
+        l2?: {
+            quotaGb?: number;
+        };
+    };
+    /** Mux/export stage */
+    mux?: {
+        defaultContainer?: 'mp4' | 'webm' | 'gif';
+    };
+}
+/**
+ * Configuration loader options
+ */
+export interface ConfigLoaderOptions {
+    /** Custom configuration file path (for testing) */
+    configPath?: string;
+    /** Override configuration (takes precedence over file) */
+    override?: MeframeConfig;
+}
+/**
+ * Resolved configuration with all defaults applied
+ */
+export interface ResolvedConfig {
+    global: {
+        logLevel: 'verbose' | 'info' | 'warn' | 'error';
+        workerBaseUrl?: string;
+        workerExtension?: string;
+        enablePerfMonitor: boolean;
+        defaultCanvasWidth: number;
+        defaultCanvasHeight: number;
+        defaultFps: number;
+    };
+    load: {
+        backpressure: Required<LoadBackpressure>;
+        retry: {
+            maxAttempts: number;
+            baseDelayMs: number;
+        };
+        window?: {
+            maxInflightPerClip?: number;
+            maxInflight?: number;
+            chunkSize?: number;
+        };
+    };
+    demux: {
+        backpressure: {
+            highWaterMark: number;
+        };
+        preferredContainer?: 'mp4' | 'webm';
+    };
+    decode: {
+        video: {
+            backpressure: Required<VideoDecodeBackpressure>;
+            codecHints?: ('h264' | 'hevc' | 'vp9')[];
+            maxGOPs?: number;
+        };
+        audio: {
+            backpressure: {
+                highWaterMark: number;
+            };
+            sampleRate?: number;
+        };
+    };
+    compose: {
+        visual: {
+            gpuAdapter?: 'webgl' | 'webgpu';
+        };
+        audio: {
+            enableDucking: boolean;
+        };
+    };
+    encode: {
+        video: {
+            bitrateKbps?: number;
+            keyIntervalS?: number;
+        };
+        audio: {
+            bitrateKbps?: number;
+        };
+    };
+    cache: {
+        l1: {
+            maxFrames?: number;
+        };
+        l2: {
+            quotaGb?: number;
+        };
+    };
+    mux: {
+        defaultContainer?: 'mp4' | 'webm' | 'gif';
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/config/validation.d.ts

@@ -0,0 +1,19 @@
+import { MeframeConfig } from './types';
+
+/**
+ * Validation result for configuration
+ */
+export interface ValidationResult {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+}
+/**
+ * Validate Meframe configuration
+ */
+export declare function validateConfig(config: MeframeConfig): ValidationResult;
+/**
+ * Validate a single backpressure value
+ */
+export declare function validateBackpressureValue(value: number, name: string, min?: number, max?: number): string | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/config/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CA8NtE;AA8DD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAU,EACf,GAAG,GAAE,MAAgC,GACpC,MAAM,GAAG,IAAI,CAWf"}

package/dist/config/validation.js

@@ -0,0 +1,232 @@
+function validateConfig(config) {
+  const result = {
+    valid: true,
+    warnings: [],
+    errors: []
+  };
+  if (config.global) {
+    if (config.global.logLevel && !["verbose", "info", "warn", "error"].includes(config.global.logLevel)) {
+      result.errors.push(`Invalid log level: ${config.global.logLevel}`);
+    }
+    if (config.global.defaultCanvasWidth !== void 0) {
+      validatePositiveNumber(
+        config.global.defaultCanvasWidth,
+        "global.defaultCanvasWidth",
+        result,
+        { min: 8, max: 16384 }
+      );
+    }
+    if (config.global.defaultCanvasHeight !== void 0) {
+      validatePositiveNumber(
+        config.global.defaultCanvasHeight,
+        "global.defaultCanvasHeight",
+        result,
+        { min: 8, max: 16384 }
+      );
+    }
+    if (config.global.defaultFps !== void 0) {
+      validatePositiveNumber(config.global.defaultFps, "global.defaultFps", result, {
+        min: 1,
+        max: 240
+      });
+    }
+  }
+  if (config.load) {
+    if (config.load.backpressure?.highWaterMark !== void 0) {
+      validatePositiveNumber(
+        config.load.backpressure.highWaterMark,
+        "load.backpressure.highWaterMark",
+        result,
+        { min: 1024, max: 10 * 1024 * 1024 }
+      );
+    }
+    if (config.load.retry) {
+      if (config.load.retry.maxAttempts !== void 0) {
+        validatePositiveNumber(config.load.retry.maxAttempts, "load.retry.maxAttempts", result, {
+          min: 1,
+          max: 10
+        });
+      }
+      if (config.load.retry.baseDelayMs !== void 0) {
+        validatePositiveNumber(config.load.retry.baseDelayMs, "load.retry.baseDelayMs", result, {
+          min: 100,
+          max: 1e4
+        });
+      }
+    }
+  }
+  if (config.demux) {
+    if (config.demux.backpressure?.highWaterMark !== void 0) {
+      validatePositiveNumber(
+        config.demux.backpressure.highWaterMark,
+        "demux.backpressure.highWaterMark",
+        result,
+        { min: 2, max: 100 }
+      );
+    }
+    if (config.demux.preferredContainer && !["mp4", "webm"].includes(config.demux.preferredContainer)) {
+      result.errors.push(`Invalid container format: ${config.demux.preferredContainer}`);
+    }
+  }
+  if (config.decode) {
+    if (config.decode.video) {
+      if (config.decode.video.backpressure) {
+        const bp = config.decode.video.backpressure;
+        if (bp.highWaterMark !== void 0) {
+          validatePositiveNumber(
+            bp.highWaterMark,
+            "decode.video.backpressure.highWaterMark",
+            result,
+            { min: 2, max: 100 }
+          );
+        }
+        if (bp.decodeQueueThreshold !== void 0) {
+          validatePositiveNumber(
+            bp.decodeQueueThreshold,
+            "decode.video.backpressure.decodeQueueThreshold",
+            result,
+            { min: 4, max: 64 }
+          );
+          if (bp.highWaterMark !== void 0 && bp.decodeQueueThreshold < bp.highWaterMark) {
+            result.warnings.push(
+              `decode.video.backpressure.decodeQueueThreshold (${bp.decodeQueueThreshold}) is less than highWaterMark (${bp.highWaterMark}), this may cause unnecessary backpressure`
+            );
+          }
+        }
+      }
+      if (config.decode.video.codecHints) {
+        const validCodecs = ["h264", "hevc", "vp9"];
+        for (const codec of config.decode.video.codecHints) {
+          if (!validCodecs.includes(codec)) {
+            result.warnings.push(`Unsupported codec hint: ${codec}`);
+          }
+        }
+      }
+      if (config.decode.video.maxGOPs !== void 0) {
+        validatePositiveNumber(config.decode.video.maxGOPs, "decode.video.maxGOPs", result, {
+          min: 1,
+          max: 10
+        });
+      }
+    }
+    if (config.decode.audio) {
+      if (config.decode.audio.backpressure?.highWaterMark !== void 0) {
+        validatePositiveNumber(
+          config.decode.audio.backpressure.highWaterMark,
+          "decode.audio.backpressure.highWaterMark",
+          result,
+          { min: 2, max: 100 }
+        );
+      }
+      if (config.decode.audio.sampleRate !== void 0) {
+        const validRates = [8e3, 16e3, 22050, 44100, 48e3, 96e3, 192e3];
+        if (!validRates.includes(config.decode.audio.sampleRate)) {
+          result.warnings.push(`Non-standard sample rate: ${config.decode.audio.sampleRate}`);
+        }
+      }
+    }
+  }
+  if (config.compose) {
+    if (config.compose.visual?.gpuAdapter && !["webgl", "webgpu"].includes(config.compose.visual.gpuAdapter)) {
+      result.errors.push(`Invalid GPU adapter: ${config.compose.visual.gpuAdapter}`);
+    }
+  }
+  if (config.encode) {
+    if (config.encode.video) {
+      if (config.encode.video.bitrateKbps !== void 0) {
+        validatePositiveNumber(
+          config.encode.video.bitrateKbps,
+          "encode.video.bitrateKbps",
+          result,
+          { min: 100, max: 5e4 }
+        );
+      }
+      if (config.encode.video.keyIntervalS !== void 0) {
+        validatePositiveNumber(
+          config.encode.video.keyIntervalS,
+          "encode.video.keyIntervalS",
+          result,
+          { min: 0.5, max: 10 }
+        );
+      }
+    }
+    if (config.encode.audio?.bitrateKbps !== void 0) {
+      validatePositiveNumber(config.encode.audio.bitrateKbps, "encode.audio.bitrateKbps", result, {
+        min: 32,
+        max: 320
+      });
+    }
+  }
+  if (config.cache) {
+    if (config.cache.l1?.maxFrames !== void 0) {
+      validatePositiveNumber(config.cache.l1.maxFrames, "cache.l1.maxFrames", result, {
+        min: 1,
+        max: 1e3
+      });
+    }
+    if (config.cache.l2?.quotaGb !== void 0) {
+      validatePositiveNumber(config.cache.l2.quotaGb, "cache.l2.quotaGb", result, {
+        min: 0.1,
+        max: 100
+      });
+    }
+  }
+  if (config.mux) {
+    if (config.mux.defaultContainer && !["mp4", "webm", "gif"].includes(config.mux.defaultContainer)) {
+      result.errors.push(`Invalid container format: ${config.mux.defaultContainer}`);
+    }
+  }
+  if (result.errors.length > 0) {
+    result.valid = false;
+  }
+  return result;
+}
+function validatePositiveNumber(value, path, result, options = {}) {
+  if (!Number.isFinite(value)) {
+    result.errors.push(`${path} must be a finite number`);
+    return;
+  }
+  if (value <= 0) {
+    result.errors.push(`${path} must be positive`);
+    return;
+  }
+  const { min, max } = options;
+  if (min !== void 0 && value < min) {
+    if (path.includes("load.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very small, may cause poor network performance`);
+    } else if (path.includes("demux.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very small, may cause stuttering`);
+    } else if (path.includes("decode.video.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very small, may cause stuttering`);
+    } else if (path.includes("decode.video.backpressure.decodeQueueThreshold")) {
+      result.warnings.push(`${path} (${value}) is very small, may limit decoder efficiency`);
+    } else if (path.includes("decode.audio.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very small, may cause stuttering`);
+    } else if (path.includes("decode.audio.backpressure.decodeQueueThreshold")) {
+      result.warnings.push(`${path} (${value}) is very small, may limit decoder efficiency`);
+    } else {
+      result.warnings.push(`${path} (${value}) is below recommended minimum (${min})`);
+    }
+  }
+  if (max !== void 0 && value > max) {
+    if (path.includes("load.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);
+    } else if (path.includes("demux.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);
+    } else if (path.includes("decode.video.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);
+    } else if (path.includes("decode.video.backpressure.decodeQueueThreshold")) {
+      result.warnings.push(`${path} (${value}) is very large, may cause decoder overload`);
+    } else if (path.includes("decode.audio.backpressure.highWaterMark")) {
+      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);
+    } else if (path.includes("decode.audio.backpressure.decodeQueueThreshold")) {
+      result.warnings.push(`${path} (${value}) is very large, may cause decoder overload`);
+    } else {
+      result.warnings.push(`${path} (${value}) exceeds recommended maximum (${max})`);
+    }
+  }
+}
+export {
+  validateConfig
+};
+//# sourceMappingURL=validation.js.map

package/dist/config/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sources":["../../src/config/validation.ts"],"sourcesContent":["import type { MeframeConfig } from './types';\n\n/**\n * Validation result for configuration\n */\nexport interface ValidationResult {\n  valid: boolean;\n  warnings: string[];\n  errors: string[];\n}\n\n/**\n * Validate Meframe configuration\n */\nexport function validateConfig(config: MeframeConfig): ValidationResult {\n  const result: ValidationResult = {\n    valid: true,\n    warnings: [],\n    errors: [],\n  };\n\n  // Validate global config\n  if (config.global) {\n    if (\n      config.global.logLevel &&\n      !['verbose', 'info', 'warn', 'error'].includes(config.global.logLevel)\n    ) {\n      result.errors.push(`Invalid log level: ${config.global.logLevel}`);\n    }\n\n    if (config.global.defaultCanvasWidth !== undefined) {\n      validatePositiveNumber(\n        config.global.defaultCanvasWidth,\n        'global.defaultCanvasWidth',\n        result,\n        { min: 8, max: 16_384 }\n      );\n    }\n\n    if (config.global.defaultCanvasHeight !== undefined) {\n      validatePositiveNumber(\n        config.global.defaultCanvasHeight,\n        'global.defaultCanvasHeight',\n        result,\n        { min: 8, max: 16_384 }\n      );\n    }\n\n    if (config.global.defaultFps !== undefined) {\n      validatePositiveNumber(config.global.defaultFps, 'global.defaultFps', result, {\n        min: 1,\n        max: 240,\n      });\n    }\n  }\n\n  // Validate load stage\n  if (config.load) {\n    if (config.load.backpressure?.highWaterMark !== undefined) {\n      validatePositiveNumber(\n        config.load.backpressure.highWaterMark,\n        'load.backpressure.highWaterMark',\n        result,\n        { min: 1024, max: 10 * 1024 * 1024 }\n      );\n    }\n    if (config.load.retry) {\n      if (config.load.retry.maxAttempts !== undefined) {\n        validatePositiveNumber(config.load.retry.maxAttempts, 'load.retry.maxAttempts', result, {\n          min: 1,\n          max: 10,\n        });\n      }\n      if (config.load.retry.baseDelayMs !== undefined) {\n        validatePositiveNumber(config.load.retry.baseDelayMs, 'load.retry.baseDelayMs', result, {\n          min: 100,\n          max: 10000,\n        });\n      }\n    }\n  }\n\n  // Validate demux stage\n  if (config.demux) {\n    if (config.demux.backpressure?.highWaterMark !== undefined) {\n      validatePositiveNumber(\n        config.demux.backpressure.highWaterMark,\n        'demux.backpressure.highWaterMark',\n        result,\n        { min: 2, max: 100 }\n      );\n    }\n    if (\n      config.demux.preferredContainer &&\n      !['mp4', 'webm'].includes(config.demux.preferredContainer)\n    ) {\n      result.errors.push(`Invalid container format: ${config.demux.preferredContainer}`);\n    }\n  }\n\n  // Validate decode stage\n  if (config.decode) {\n    // Video decode\n    if (config.decode.video) {\n      if (config.decode.video.backpressure) {\n        const bp = config.decode.video.backpressure;\n        if (bp.highWaterMark !== undefined) {\n          validatePositiveNumber(\n            bp.highWaterMark,\n            'decode.video.backpressure.highWaterMark',\n            result,\n            { min: 2, max: 100 }\n          );\n        }\n        if (bp.decodeQueueThreshold !== undefined) {\n          validatePositiveNumber(\n            bp.decodeQueueThreshold,\n            'decode.video.backpressure.decodeQueueThreshold',\n            result,\n            { min: 4, max: 64 }\n          );\n\n          // Check relationship\n          if (bp.highWaterMark !== undefined && bp.decodeQueueThreshold < bp.highWaterMark) {\n            result.warnings.push(\n              `decode.video.backpressure.decodeQueueThreshold (${bp.decodeQueueThreshold}) is less than highWaterMark (${bp.highWaterMark}), ` +\n                'this may cause unnecessary backpressure'\n            );\n          }\n        }\n      }\n      if (config.decode.video.codecHints) {\n        const validCodecs = ['h264', 'hevc', 'vp9'];\n        for (const codec of config.decode.video.codecHints) {\n          if (!validCodecs.includes(codec)) {\n            result.warnings.push(`Unsupported codec hint: ${codec}`);\n          }\n        }\n      }\n      if (config.decode.video.maxGOPs !== undefined) {\n        validatePositiveNumber(config.decode.video.maxGOPs, 'decode.video.maxGOPs', result, {\n          min: 1,\n          max: 10,\n        });\n      }\n    }\n\n    // Audio decode\n    if (config.decode.audio) {\n      if (config.decode.audio.backpressure?.highWaterMark !== undefined) {\n        validatePositiveNumber(\n          config.decode.audio.backpressure.highWaterMark,\n          'decode.audio.backpressure.highWaterMark',\n          result,\n          { min: 2, max: 100 }\n        );\n      }\n      if (config.decode.audio.sampleRate !== undefined) {\n        const validRates = [8000, 16000, 22050, 44100, 48000, 96000, 192000];\n        if (!validRates.includes(config.decode.audio.sampleRate)) {\n          result.warnings.push(`Non-standard sample rate: ${config.decode.audio.sampleRate}`);\n        }\n      }\n    }\n  }\n\n  // Validate compose stage\n  if (config.compose) {\n    if (\n      config.compose.visual?.gpuAdapter &&\n      !['webgl', 'webgpu'].includes(config.compose.visual.gpuAdapter)\n    ) {\n      result.errors.push(`Invalid GPU adapter: ${config.compose.visual.gpuAdapter}`);\n    }\n  }\n\n  // Validate encode stage\n  if (config.encode) {\n    if (config.encode.video) {\n      if (config.encode.video.bitrateKbps !== undefined) {\n        validatePositiveNumber(\n          config.encode.video.bitrateKbps,\n          'encode.video.bitrateKbps',\n          result,\n          { min: 100, max: 50000 }\n        );\n      }\n      if (config.encode.video.keyIntervalS !== undefined) {\n        validatePositiveNumber(\n          config.encode.video.keyIntervalS,\n          'encode.video.keyIntervalS',\n          result,\n          { min: 0.5, max: 10 }\n        );\n      }\n    }\n    if (config.encode.audio?.bitrateKbps !== undefined) {\n      validatePositiveNumber(config.encode.audio.bitrateKbps, 'encode.audio.bitrateKbps', result, {\n        min: 32,\n        max: 320,\n      });\n    }\n  }\n\n  // Validate cache stage\n  if (config.cache) {\n    if (config.cache.l1?.maxFrames !== undefined) {\n      validatePositiveNumber(config.cache.l1.maxFrames, 'cache.l1.maxFrames', result, {\n        min: 1,\n        max: 1000,\n      });\n    }\n    if (config.cache.l2?.quotaGb !== undefined) {\n      validatePositiveNumber(config.cache.l2.quotaGb, 'cache.l2.quotaGb', result, {\n        min: 0.1,\n        max: 100,\n      });\n    }\n  }\n\n  // Validate mux stage\n  if (config.mux) {\n    if (\n      config.mux.defaultContainer &&\n      !['mp4', 'webm', 'gif'].includes(config.mux.defaultContainer)\n    ) {\n      result.errors.push(`Invalid container format: ${config.mux.defaultContainer}`);\n    }\n  }\n\n  // Mark as invalid if there are errors\n  if (result.errors.length > 0) {\n    result.valid = false;\n  }\n\n  return result;\n}\n\n/**\n * Validate a positive number within range\n */\nfunction validatePositiveNumber(\n  value: number,\n  path: string,\n  result: ValidationResult,\n  options: { min?: number; max?: number } = {}\n): void {\n  if (!Number.isFinite(value)) {\n    result.errors.push(`${path} must be a finite number`);\n    return;\n  }\n\n  if (value <= 0) {\n    result.errors.push(`${path} must be positive`);\n    return;\n  }\n\n  const { min, max } = options;\n\n  if (min !== undefined && value < min) {\n    // Specific warning messages based on the path\n    if (path.includes('load.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very small, may cause poor network performance`);\n    } else if (path.includes('demux.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very small, may cause stuttering`);\n    } else if (path.includes('decode.video.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very small, may cause stuttering`);\n    } else if (path.includes('decode.video.backpressure.decodeQueueThreshold')) {\n      result.warnings.push(`${path} (${value}) is very small, may limit decoder efficiency`);\n    } else if (path.includes('decode.audio.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very small, may cause stuttering`);\n    } else if (path.includes('decode.audio.backpressure.decodeQueueThreshold')) {\n      result.warnings.push(`${path} (${value}) is very small, may limit decoder efficiency`);\n    } else {\n      result.warnings.push(`${path} (${value}) is below recommended minimum (${min})`);\n    }\n  }\n\n  if (max !== undefined && value > max) {\n    // Specific warning messages based on the path\n    if (path.includes('load.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);\n    } else if (path.includes('demux.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);\n    } else if (path.includes('decode.video.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);\n    } else if (path.includes('decode.video.backpressure.decodeQueueThreshold')) {\n      result.warnings.push(`${path} (${value}) is very large, may cause decoder overload`);\n    } else if (path.includes('decode.audio.backpressure.highWaterMark')) {\n      result.warnings.push(`${path} (${value}) is very large, may cause memory issues`);\n    } else if (path.includes('decode.audio.backpressure.decodeQueueThreshold')) {\n      result.warnings.push(`${path} (${value}) is very large, may cause decoder overload`);\n    } else {\n      result.warnings.push(`${path} (${value}) exceeds recommended maximum (${max})`);\n    }\n  }\n}\n\n/**\n * Validate a single backpressure value\n */\nexport function validateBackpressureValue(\n  value: number,\n  name: string,\n  min: number = 1,\n  max: number = Number.MAX_SAFE_INTEGER\n): string | null {\n  if (!Number.isFinite(value)) {\n    return `${name} must be a finite number`;\n  }\n  if (value < min) {\n    return `${name} must be at least ${min}`;\n  }\n  if (value > max) {\n    return `${name} must be at most ${max}`;\n  }\n  return null;\n}\n"],"names":[],"mappings":"AAcO,SAAS,eAAe,QAAyC;AACtE,QAAM,SAA2B;AAAA,IAC/B,OAAO;AAAA,IACP,UAAU,CAAA;AAAA,IACV,QAAQ,CAAA;AAAA,EAAC;AAIX,MAAI,OAAO,QAAQ;AACjB,QACE,OAAO,OAAO,YACd,CAAC,CAAC,WAAW,QAAQ,QAAQ,OAAO,EAAE,SAAS,OAAO,OAAO,QAAQ,GACrE;AACA,aAAO,OAAO,KAAK,sBAAsB,OAAO,OAAO,QAAQ,EAAE;AAAA,IACnE;AAEA,QAAI,OAAO,OAAO,uBAAuB,QAAW;AAClD;AAAA,QACE,OAAO,OAAO;AAAA,QACd;AAAA,QACA;AAAA,QACA,EAAE,KAAK,GAAG,KAAK,MAAA;AAAA,MAAO;AAAA,IAE1B;AAEA,QAAI,OAAO,OAAO,wBAAwB,QAAW;AACnD;AAAA,QACE,OAAO,OAAO;AAAA,QACd;AAAA,QACA;AAAA,QACA,EAAE,KAAK,GAAG,KAAK,MAAA;AAAA,MAAO;AAAA,IAE1B;AAEA,QAAI,OAAO,OAAO,eAAe,QAAW;AAC1C,6BAAuB,OAAO,OAAO,YAAY,qBAAqB,QAAQ;AAAA,QAC5E,KAAK;AAAA,QACL,KAAK;AAAA,MAAA,CACN;AAAA,IACH;AAAA,EACF;AAGA,MAAI,OAAO,MAAM;AACf,QAAI,OAAO,KAAK,cAAc,kBAAkB,QAAW;AACzD;AAAA,QACE,OAAO,KAAK,aAAa;AAAA,QACzB;AAAA,QACA;AAAA,QACA,EAAE,KAAK,MAAM,KAAK,KAAK,OAAO,KAAA;AAAA,MAAK;AAAA,IAEvC;AACA,QAAI,OAAO,KAAK,OAAO;AACrB,UAAI,OAAO,KAAK,MAAM,gBAAgB,QAAW;AAC/C,+BAAuB,OAAO,KAAK,MAAM,aAAa,0BAA0B,QAAQ;AAAA,UACtF,KAAK;AAAA,UACL,KAAK;AAAA,QAAA,CACN;AAAA,MACH;AACA,UAAI,OAAO,KAAK,MAAM,gBAAgB,QAAW;AAC/C,+BAAuB,OAAO,KAAK,MAAM,aAAa,0BAA0B,QAAQ;AAAA,UACtF,KAAK;AAAA,UACL,KAAK;AAAA,QAAA,CACN;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAGA,MAAI,OAAO,OAAO;AAChB,QAAI,OAAO,MAAM,cAAc,kBAAkB,QAAW;AAC1D;AAAA,QACE,OAAO,MAAM,aAAa;AAAA,QAC1B;AAAA,QACA;AAAA,QACA,EAAE,KAAK,GAAG,KAAK,IAAA;AAAA,MAAI;AAAA,IAEvB;AACA,QACE,OAAO,MAAM,sBACb,CAAC,CAAC,OAAO,MAAM,EAAE,SAAS,OAAO,MAAM,kBAAkB,GACzD;AACA,aAAO,OAAO,KAAK,6BAA6B,OAAO,MAAM,kBAAkB,EAAE;AAAA,IACnF;AAAA,EACF;AAGA,MAAI,OAAO,QAAQ;AAEjB,QAAI,OAAO,OAAO,OAAO;AACvB,UAAI,OAAO,OAAO,MAAM,cAAc;AACpC,cAAM,KAAK,OAAO,OAAO,MAAM;AAC/B,YAAI,GAAG,kBAAkB,QAAW;AAClC;AAAA,YACE,GAAG;AAAA,YACH;AAAA,YACA;AAAA,YACA,EAAE,KAAK,GAAG,KAAK,IAAA;AAAA,UAAI;AAAA,QAEvB;AACA,YAAI,GAAG,yBAAyB,QAAW;AACzC;AAAA,YACE,GAAG;AAAA,YACH;AAAA,YACA;AAAA,YACA,EAAE,KAAK,GAAG,KAAK,GAAA;AAAA,UAAG;AAIpB,cAAI,GAAG,kBAAkB,UAAa,GAAG,uBAAuB,GAAG,eAAe;AAChF,mBAAO,SAAS;AAAA,cACd,mDAAmD,GAAG,oBAAoB,iCAAiC,GAAG,aAAa;AAAA,YAAA;AAAA,UAG/H;AAAA,QACF;AAAA,MACF;AACA,UAAI,OAAO,OAAO,MAAM,YAAY;AAClC,cAAM,cAAc,CAAC,QAAQ,QAAQ,KAAK;AAC1C,mBAAW,SAAS,OAAO,OAAO,MAAM,YAAY;AAClD,cAAI,CAAC,YAAY,SAAS,KAAK,GAAG;AAChC,mBAAO,SAAS,KAAK,2BAA2B,KAAK,EAAE;AAAA,UACzD;AAAA,QACF;AAAA,MACF;AACA,UAAI,OAAO,OAAO,MAAM,YAAY,QAAW;AAC7C,+BAAuB,OAAO,OAAO,MAAM,SAAS,wBAAwB,QAAQ;AAAA,UAClF,KAAK;AAAA,UACL,KAAK;AAAA,QAAA,CACN;AAAA,MACH;AAAA,IACF;AAGA,QAAI,OAAO,OAAO,OAAO;AACvB,UAAI,OAAO,OAAO,MAAM,cAAc,kBAAkB,QAAW;AACjE;AAAA,UACE,OAAO,OAAO,MAAM,aAAa;AAAA,UACjC;AAAA,UACA;AAAA,UACA,EAAE,KAAK,GAAG,KAAK,IAAA;AAAA,QAAI;AAAA,MAEvB;AACA,UAAI,OAAO,OAAO,MAAM,eAAe,QAAW;AAChD,cAAM,aAAa,CAAC,KAAM,MAAO,OAAO,OAAO,MAAO,MAAO,KAAM;AACnE,YAAI,CAAC,WAAW,SAAS,OAAO,OAAO,MAAM,UAAU,GAAG;AACxD,iBAAO,SAAS,KAAK,6BAA6B,OAAO,OAAO,MAAM,UAAU,EAAE;AAAA,QACpF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAGA,MAAI,OAAO,SAAS;AAClB,QACE,OAAO,QAAQ,QAAQ,cACvB,CAAC,CAAC,SAAS,QAAQ,EAAE,SAAS,OAAO,QAAQ,OAAO,UAAU,GAC9D;AACA,aAAO,OAAO,KAAK,wBAAwB,OAAO,QAAQ,OAAO,UAAU,EAAE;AAAA,IAC/E;AAAA,EACF;AAGA,MAAI,OAAO,QAAQ;AACjB,QAAI,OAAO,OAAO,OAAO;AACvB,UAAI,OAAO,OAAO,MAAM,gBAAgB,QAAW;AACjD;AAAA,UACE,OAAO,OAAO,MAAM;AAAA,UACpB;AAAA,UACA;AAAA,UACA,EAAE,KAAK,KAAK,KAAK,IAAA;AAAA,QAAM;AAAA,MAE3B;AACA,UAAI,OAAO,OAAO,MAAM,iBAAiB,QAAW;AAClD;AAAA,UACE,OAAO,OAAO,MAAM;AAAA,UACpB;AAAA,UACA;AAAA,UACA,EAAE,KAAK,KAAK,KAAK,GAAA;AAAA,QAAG;AAAA,MAExB;AAAA,IACF;AACA,QAAI,OAAO,OAAO,OAAO,gBAAgB,QAAW;AAClD,6BAAuB,OAAO,OAAO,MAAM,aAAa,4BAA4B,QAAQ;AAAA,QAC1F,KAAK;AAAA,QACL,KAAK;AAAA,MAAA,CACN;AAAA,IACH;AAAA,EACF;AAGA,MAAI,OAAO,OAAO;AAChB,QAAI,OAAO,MAAM,IAAI,cAAc,QAAW;AAC5C,6BAAuB,OAAO,MAAM,GAAG,WAAW,sBAAsB,QAAQ;AAAA,QAC9E,KAAK;AAAA,QACL,KAAK;AAAA,MAAA,CACN;AAAA,IACH;AACA,QAAI,OAAO,MAAM,IAAI,YAAY,QAAW;AAC1C,6BAAuB,OAAO,MAAM,GAAG,SAAS,oBAAoB,QAAQ;AAAA,QAC1E,KAAK;AAAA,QACL,KAAK;AAAA,MAAA,CACN;AAAA,IACH;AAAA,EACF;AAGA,MAAI,OAAO,KAAK;AACd,QACE,OAAO,IAAI,oBACX,CAAC,CAAC,OAAO,QAAQ,KAAK,EAAE,SAAS,OAAO,IAAI,gBAAgB,GAC5D;AACA,aAAO,OAAO,KAAK,6BAA6B,OAAO,IAAI,gBAAgB,EAAE;AAAA,IAC/E;AAAA,EACF;AAGA,MAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,WAAO,QAAQ;AAAA,EACjB;AAEA,SAAO;AACT;AAKA,SAAS,uBACP,OACA,MACA,QACA,UAA0C,CAAA,GACpC;AACN,MAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,WAAO,OAAO,KAAK,GAAG,IAAI,0BAA0B;AACpD;AAAA,EACF;AAEA,MAAI,SAAS,GAAG;AACd,WAAO,OAAO,KAAK,GAAG,IAAI,mBAAmB;AAC7C;AAAA,EACF;AAEA,QAAM,EAAE,KAAK,IAAA,IAAQ;AAErB,MAAI,QAAQ,UAAa,QAAQ,KAAK;AAEpC,QAAI,KAAK,SAAS,iCAAiC,GAAG;AACpD,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,qDAAqD;AAAA,IAC7F,WAAW,KAAK,SAAS,kCAAkC,GAAG;AAC5D,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,uCAAuC;AAAA,IAC/E,WAAW,KAAK,SAAS,yCAAyC,GAAG;AACnE,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,uCAAuC;AAAA,IAC/E,WAAW,KAAK,SAAS,gDAAgD,GAAG;AAC1E,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,+CAA+C;AAAA,IACvF,WAAW,KAAK,SAAS,yCAAyC,GAAG;AACnE,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,uCAAuC;AAAA,IAC/E,WAAW,KAAK,SAAS,gDAAgD,GAAG;AAC1E,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,+CAA+C;AAAA,IACvF,OAAO;AACL,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,mCAAmC,GAAG,GAAG;AAAA,IACjF;AAAA,EACF;AAEA,MAAI,QAAQ,UAAa,QAAQ,KAAK;AAEpC,QAAI,KAAK,SAAS,iCAAiC,GAAG;AACpD,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,0CAA0C;AAAA,IAClF,WAAW,KAAK,SAAS,kCAAkC,GAAG;AAC5D,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,0CAA0C;AAAA,IAClF,WAAW,KAAK,SAAS,yCAAyC,GAAG;AACnE,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,0CAA0C;AAAA,IAClF,WAAW,KAAK,SAAS,gDAAgD,GAAG;AAC1E,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,6CAA6C;AAAA,IACrF,WAAW,KAAK,SAAS,yCAAyC,GAAG;AACnE,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,0CAA0C;AAAA,IAClF,WAAW,KAAK,SAAS,gDAAgD,GAAG;AAC1E,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,6CAA6C;AAAA,IACrF,OAAO;AACL,aAAO,SAAS,KAAK,GAAG,IAAI,KAAK,KAAK,kCAAkC,GAAG,GAAG;AAAA,IAChF;AAAA,EACF;AACF;"}

package/dist/controllers/PlaybackController.d.ts

@@ -0,0 +1,55 @@
+import { IPlaybackController, PlaybackState, PlaybackOptions, IOrchestratorForControl, IEventBus } from './types';
+import { TimeUs } from '../model/types';
+import { GlobalAudioSession } from '../stages/compose/GlobalAudioSession';
+
+/**
+ * Playback controller for preview
+ * Internal implementation - not exposed directly to external consumers
+ */
+export declare class PlaybackController implements IPlaybackController {
+    private orchestrator;
+    private eventBus;
+    private canvas;
+    private ctx;
+    private _currentTimeUs;
+    private _state;
+    private playbackRate;
+    private volume;
+    private loop;
+    private rafId;
+    private startTime;
+    private frameCount;
+    private lastFrameTime;
+    private fps;
+    private audioContext;
+    private audioSource;
+    private audioGainNode;
+    private audioSession;
+    private isBuffering;
+    constructor(orchestrator: IOrchestratorForControl, eventBus: IEventBus, options: PlaybackOptions);
+    play(): void;
+    private startPlayback;
+    pause(): void;
+    stop(): void;
+    seek(timeUs: TimeUs): Promise<void>;
+    setRate(rate: number): void;
+    setVolume(volume: number): void;
+    setMute(muted: boolean): void;
+    setLoop(loop: boolean): void;
+    get currentTime(): TimeUs;
+    get duration(): TimeUs;
+    get state(): PlaybackState;
+    get playing(): boolean;
+    setAudioSession(session: GlobalAudioSession): void;
+    resume(): void;
+    private playbackLoop;
+    private updateTime;
+    private renderCurrentFrame;
+    private handlePlaybackBuffering;
+    private clampTime;
+    dispose(): void;
+    private ensureAudioContext;
+    private startAudioPlayback;
+    private stopAudioPlayback;
+}
+//# sourceMappingURL=PlaybackController.d.ts.map

package/dist/controllers/PlaybackController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaybackController.d.ts","sourceRoot":"","sources":["../../src/controllers/PlaybackController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,SAAS,EACV,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,GAAG,CAA+D;IAG1E,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,IAAI,CAAS;IAGrB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAAK;IAGtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,YAAY,CAAmC;IAGvD,OAAO,CAAC,WAAW,CAAS;gBAG1B,YAAY,EAAE,uBAAuB,EACrC,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,eAAe;IAwC1B,IAAI,IAAI,IAAI;YAME,aAAa;IAgC3B,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAiBN,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CzC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS/B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ7B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK5B,IAAI,WAAW,IAAI,MAAM,CAMxB;IAED,IAAI,QAAQ,IAAI,MAAM,CAOrB;IAED,IAAI,KAAK,IAAI,aAAa,CAEzB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAKlD,MAAM,IAAI,IAAI;IAKd,OAAO,CAAC,YAAY;IAsDpB,OAAO,CAAC,UAAU;YAuBJ,kBAAkB;YAyBlB,uBAAuB;IAgDrC,OAAO,CAAC,SAAS;IAKjB,OAAO,IAAI,IAAI;YAID,kBAAkB;IAWhC,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,iBAAiB;CAW1B"}