/** * MVHEVCCompiler — Generates an MV-HEVC spatial-video export plan for Apple Vision Pro. * * This compiler does not encode video bytes. It produces stereo rig metadata, * Swift/RealityKit scaffold source, and an advisory mux command that a real * encoder pipeline can consume. * * Output includes: * - Camera rig parameters for stereo pair rendering * - MV-HEVC muxing configuration (ISO/IEC 23008-2 Annex G) * - Swift code for AVFoundation spatial video playback * - RealityKit VideoPlayerComponent integration * * @see W.156: MV-HEVC is Apple's standard for spatial video on Vision Pro * @see P.156.01: Stereo Camera Rig pattern (65mm IPD baseline) */ export interface HoloComposition { name?: string; objects: Array<{ traits?: Array<{ name: string; config?: Record; }>; }>; } export interface MVHEVCConfig { /** Inter-pupillary distance in meters. Default: 0.065 (65mm human average) */ ipd: number; /** Video resolution per eye [width, height]. Default: [1920, 1080] */ resolution: [number, number]; /** Frames per second. Default: 30 */ fps: number; /** Focus/convergence distance in meters. Default: 2.0 */ convergenceDistance: number; /** Horizontal field of view in degrees. Default: 90 */ fovDegrees: number; /** HEVC encoding quality. Default: 'high' */ quality: 'low' | 'medium' | 'high'; /** Output container format. Default: 'mov' */ container: 'mov' | 'mp4'; /** Disparity adjustment for depth comfort. Default: 1.0 */ disparityScale: number; } export interface MVHEVCStereoView { /** Eye identifier */ eye: 'left' | 'right'; /** Camera offset from center (negative = left, positive = right) */ cameraOffset: number; /** View shear for toe-in-free convergence */ viewShear: number; /** HEVC layer index (0 = base layer, 1 = enhancement layer) */ layerIndex: number; } export interface MVHEVCCompilationResult { /** Truthful artifact class: this is an export plan/scaffold, not encoded video bytes. */ artifactKind: 'mvhevc-plan'; /** Stereo rig configuration */ config: MVHEVCConfig; /** Left and right eye view parameters */ views: MVHEVCStereoView[]; /** Swift code for spatial video playback on Vision Pro */ swiftCode: string; /** Advisory mux command string. It is not executed by this compiler. */ muxCommand: string; /** Concrete limitations that keep the compiler honest at call sites. */ limitations: string[]; /** ISOBMFF metadata for spatial video signaling */ metadata: { stereoMode: 'side-by-side' | 'multiview-hevc'; baseline: number; convergence: number; horizontalFOV: number; }; } export declare class MVHEVCCompiler { compile(composition: HoloComposition, agentToken: string, outputPath?: string): string; /** * MV-HEVC planning result with stereo rig metadata, Swift scaffold, and mux command. */ compileMVHEVC(composition: HoloComposition, overrides?: Partial): MVHEVCCompilationResult; /** * Generate left/right stereo view parameters. * Uses half-IPD offset with view shearing for convergence. */ private generateStereoViews; /** * Extract MV-HEVC config from composition @spatial_video traits. */ private resolveConfig; /** * Generate Swift scaffold code for spatial video playback on Apple Vision Pro. */ private generateSwiftCode; /** * Generate an advisory FFmpeg command string for muxing separate L/R HEVC streams. */ private generateMuxCommand; } //# sourceMappingURL=MVHEVCCompiler.d.ts.map