pup-recorder 0.3.0 → 0.3.2

package/dist/_tsup-dts-rollup.d.ts

@@ -1,8 +1,10 @@
 import { AV_SAMPLE_FMT_FLT } from 'node-av/constants';
 import { AV_SAMPLE_FMT_FLTP } from 'node-av/constants';
+import { AVColorRange } from 'node-av/constants';
 import { AVPixelFormat } from 'node-av/constants';
 import { BrowserWindow } from 'electron';
 import { ChildProcess } from 'child_process';
+import { Codec } from 'node-av';
 import { CodecContext } from 'node-av';
 import type { Debugger } from 'electron';
 import { EventEmitter } from 'events';
@@ -20,6 +22,9 @@ import { SpawnOptions } from 'child_process';
 import { Stream } from 'node-av';
 import z from 'zod';
 
+/** Insert emulation prevention bytes (00 00 03) for Annex B compliance. */
+export declare function addEmulationPrevention(nal: Buffer): Buffer;
+
 export declare function advanceVirtualTime(cdp: Debugger, budget: number): Promise<void>;
 
 export declare const ANNEX_B_START_CODE: Buffer<ArrayBuffer>;
@@ -67,31 +72,40 @@ export declare interface AudioEncoderOptions {
     muxer: FormatMuxer;
 }
 
+export declare class BitReader {
+    private _bits;
+    pos: number;
+    constructor(data: Buffer);
+    get bits(): number[];
+    read(n: number): number;
+    readUe(): number;
+}
+
+export declare class BitWriter {
+    bits: number[];
+    w(val: number, n: number): void;
+    flag(val: boolean | number): void;
+    ue(val: number): void;
+    align(pad: number): void;
+    copy(src: number[], start: number, len: number): void;
+}
+
+export declare function buildAlphaChannelInfoSEI(): Buffer;
+
 /**
- * Build alpha_channel_info SEI message (payloadType=165).
- * Layout from x265 SEIAlphaChannelInfo::writeSEI.
+ * Build a complete alpha VPS from scratch, using the original NVENC VPS
+ * only as a source for the PTL (profile/tier/level) bytes.
+ * Matches x265 4.1 ENABLE_ALPHA VPS structure.
  */
-export declare function buildAlphaChannelInfoSEI(): Buffer;
+export declare function buildAlphaVPS(vpsData: Buffer, width: number, height: number): Buffer;
 
 export declare function buildRust(): Promise<void>;
 
 export declare function buildStegoHTML(targetURL: string, size: Size): string;
 
-/**
- * Builds the JS injector that hooks all time-related globals in the target frame.
- * In Electron/stego mode (default), guards against running in the top-level frame.
- * In Puppeteer mode (skipFrameGuard: true), injects directly into the main document.
- * Must be injected via Page.addScriptToEvaluateOnNewDocument AND directly into
- * already-loaded frames.
- */
-export declare function buildTickInjector(opts?: TickInjectorOptions): string;
+export declare function buildTickInjector(): string;
 
-/**
- * Build unified extradata: base VPS (patched for alpha) + interleaved SPS/PPS.
- * Alpha SPS/PPS follow their base counterparts so the HVCC serializer
- * groups them into the same NAL array (required for multi-layer).
- */
-export declare function buildUnifiedExtradata(baseExtradata: Buffer, alphaExtradata: Buffer): Buffer;
+export declare function buildUnifiedExtradata(opts: UnifiedExtradataOptions): Buffer;
 
 export declare const canIUseGPU: Promise<boolean>;
 
@@ -183,8 +197,6 @@ export declare function doEject(): string;
 
 export declare function doProcess(timestampMs: number): string;
 
-export declare function doPuppeteer(source: string, options: RenderOptions, onProgress?: (p: number) => void): Promise<IpcDonePayload>;
-
 export declare function drainPackets(ctx: CodecContext, pkt: Packet, stream: Stream, muxer: FormatMuxer): Promise<void>;
 
 export declare function electronOpts(disableGpu: boolean): Promise<string[]>;
@@ -214,7 +226,7 @@ declare interface EncoderPipelineOptions {
     fps: number;
     outFile: string;
     withAudio?: boolean;
-    disableGpu?: boolean;
+    disableHwCodec?: boolean;
 }
 export { EncoderPipelineOptions }
 export { EncoderPipelineOptions as EncoderPipelineOptions_alias_1 }
@@ -294,7 +306,6 @@ export declare interface HwVideoEncoderOptions {
     muxer: FormatMuxer;
 }
 
-/** Interleave base and alpha NALs for a single frame. */
 export declare function interleaveAccessUnits(baseNals: NalUnit[], alphaNals: NalUnit[]): Buffer;
 
 export declare interface IpcDonePayload {
@@ -426,6 +437,8 @@ export declare class NvencDualLayerEncoder implements Disposable {
     private drainInterleaved;
 }
 
+export declare function openVideoCtx(opts: VideoCtxOptions, label: string): Promise<CodecContext>;
+
 export declare function packBits(bits: number[]): Buffer;
 
 declare function pargs(): string[];
@@ -455,6 +468,7 @@ export { periodical as periodical_alias_1 }
 declare interface ProcessHandle {
     process: ChildProcess;
     wait: Promise<void>;
+    kill(): void;
 }
 export { ProcessHandle }
 export { ProcessHandle as ProcessHandle_alias_1 }
@@ -481,9 +495,9 @@ declare const pupDisableGPU: boolean;
 export { pupDisableGPU }
 export { pupDisableGPU as pupDisableGPU_alias_1 }
 
-declare const pupExperimentalPuppeteer: boolean;
-export { pupExperimentalPuppeteer }
-export { pupExperimentalPuppeteer as pupExperimentalPuppeteer_alias_1 }
+declare const pupDisableHwCodec: boolean;
+export { pupDisableHwCodec }
+export { pupDisableHwCodec as pupDisableHwCodec_alias_1 }
 
 declare const pupIpcSocket: string | undefined;
 export { pupIpcSocket }
@@ -517,6 +531,13 @@ declare const pupUseInnerProxy: boolean;
 export { pupUseInnerProxy }
 export { pupUseInnerProxy as pupUseInnerProxy_alias_1 }
 
+declare const pupWindowTolerant: boolean;
+export { pupWindowTolerant }
+export { pupWindowTolerant as pupWindowTolerant_alias_1 }
+
+/** Remove emulation prevention bytes (00 00 03 → 00 00) from RBSP. */
+export declare function removeEmulationPrevention(data: Buffer): Buffer;
+
 export declare function render(writer: IpcWriter, source: string, options: RenderOptions): Promise<IpcDonePayload>;
 
 declare type RenderOptions = z.infer<typeof RenderSchema>;
@@ -542,6 +563,8 @@ declare const RenderSchema: z.ZodObject<{
     useInnerProxy: z.ZodBoolean;
     deterministic: z.ZodBoolean;
     disableGpu: z.ZodBoolean;
+    disableHwCodec: z.ZodBoolean;
+    windowTolerant: z.ZodBoolean;
 }, z.core.$strip>;
 export { RenderSchema }
 export { RenderSchema as RenderSchema_alias_1 }
@@ -576,17 +599,19 @@ export declare function splitNalUnits(bitstream: Buffer): NalUnit[];
 
 export declare function startStego(cdp: Debugger): Promise<any>;
 
+export declare const STEGO_TICK_CHANNEL = "stego-tick";
+
 export declare function stopStego(cdp: Debugger): Promise<any>;
 
 export declare const TICK_SYMBOL = "__pup_tick__";
 
-export declare interface TickInjectorOptions {
-    /**
-     * When true, skips the top-frame guard so the injector runs in the main document.
-     * Required for Puppeteer mode where the page is loaded directly (no stego iframe wrapper).
-     * Default: false (Electron/stego mode — only inject in iframes).
-     */
-    skipFrameGuard?: boolean;
+export declare function tickStego(cdp: Debugger, ms: number): Promise<any>;
+
+export declare interface UnifiedExtradataOptions {
+    baseExtradata: Buffer;
+    alphaExtradata: Buffer;
+    width: number;
+    height: number;
 }
 
 export declare function unsetInterceptor(window: BrowserWindow): void;
@@ -595,6 +620,18 @@ declare function useRetry<Args extends any[], Ret>({ fn, maxAttempts, timeout }:
 export { useRetry }
 export { useRetry as useRetry_alias_1 }
 
+export declare interface VideoCtxOptions {
+    codec: Codec;
+    width: number;
+    height: number;
+    fps: number;
+    bitrate: number;
+    pixelFormat: AVPixelFormat;
+    codecTag?: string;
+    colorRange?: AVColorRange;
+    options?: Record<string, string>;
+}
+
 declare class VideoEncoder_2 implements Disposable {
     private readonly _ctx;
     private readonly _pkt;
@@ -615,7 +652,6 @@ export declare interface VideoEncoderOptions {
     fps: number;
     codecName: FFVideoEncoder;
     codecTag?: string;
-    globalHeader: boolean;
     codecOpts: Record<string, string>;
     bitrate: number;
     pixelFormat: AVPixelFormat;
@@ -627,7 +663,7 @@ export declare interface VideoFactoryOptions {
     height: number;
     fps: number;
     bitrate?: number;
-    disableGpu?: boolean;
+    disableHwCodec?: boolean;
 }
 
 export declare interface VideoSetup {
@@ -668,6 +704,7 @@ export declare interface WindowOptions {
     onCreated?: (window: BrowserWindow) => Promise<void>;
     renderer: RenderOptions;
     warmup?: boolean;
+    tolerant?: boolean;
 }
 
 export { }