ugcinc-render 1.5.32 → 1.6.1

package/dist/index.d.mts

@@ -782,6 +782,291 @@ interface EditorSegment {
     volume?: number;
 }
 
+/**
+ * Video Deduplication Configuration
+ *
+ * Two ways to configure deduplication:
+ * 1. Use a preset level: 'level1' | 'level2' | 'level3' | 'level4' | 'level5'
+ * 2. Provide a custom DeduplicationConfig object
+ *
+ * @example
+ * // Using a preset level
+ * const dedup: DeduplicationInput = 'level3';
+ *
+ * @example
+ * // Using custom config
+ * const dedup: DeduplicationInput = {
+ *   phone_config: { phone: 'iphone', phone_model: 'iphone', inject_exif: true },
+ *   lens_correction: { k1: -0.05, k2: 0.01 },
+ * };
+ */
+type DeduplicationLevel = 'level1' | 'level2' | 'level3' | 'level4' | 'level5';
+type DeduplicationInput = DeduplicationLevel | DeduplicationConfig;
+type PhoneType = 'iphone' | 'android';
+type PhoneModel = 'iphone' | 'samsung' | 'pixel';
+interface PhoneConfig {
+    /** Phone platform type */
+    phone: PhoneType;
+    /** Specific phone model to mimic */
+    phone_model: PhoneModel;
+    /** Inject EXIF metadata */
+    inject_exif: boolean;
+    /** Region code (e.g., "US") */
+    region?: string;
+}
+type VideoCodec = 'H264' | 'H265';
+type VideoExtension = 'MP4' | 'MOV';
+type Acceleration = 'nvidia' | 'cpu';
+interface TraceRemovalConfig {
+    /** Output codec */
+    codec: VideoCodec;
+    /** Output container format (H265 should use MOV) */
+    video_extension: VideoExtension;
+    /** Hardware acceleration type */
+    acceleration?: Acceleration;
+    /** Remove FFmpeg signatures from binary */
+    remove_ffmpeg_signatures: boolean;
+    /** Remove encoder metadata */
+    remove_encoder_metadata: boolean;
+}
+interface MobileEncodingConfig {
+    /** Use GOP of 60 (typical for mobile cameras) */
+    use_gop: boolean;
+    /** Delete B-frames (typical for mobile) */
+    delete_b_frames: boolean;
+    /** Adjust keyframe intervals */
+    change_keyframes: boolean;
+    /** Change pixel format to mobile-typical */
+    change_pixel_format: boolean;
+    /** Use mobile color palette */
+    mobile_palette: boolean;
+}
+interface VisualAdjustmentsConfig {
+    /** Brightness adjustment range (random value within +-range) */
+    brightness?: number;
+    /** Gamma adjustment range */
+    gamma?: number;
+    /** Saturation adjustment range */
+    saturation?: number;
+    /** Contrast adjustment range */
+    contrast?: number;
+    /** Horizontal flip */
+    horizontal_flip?: boolean;
+    /** Rotation in degrees (clockwise) */
+    rotate_right?: number;
+    /** Rotation in degrees (counter-clockwise) */
+    rotate_left?: number;
+}
+interface CropConfig {
+    /** Pixels to crop from top */
+    crop_top?: number;
+    /** Pixels to crop from bottom */
+    crop_bottom?: number;
+    /** Pixels to crop from left */
+    crop_left?: number;
+    /** Pixels to crop from right */
+    crop_right?: number;
+}
+interface SpeedConfig {
+    /** Speed multiplier (e.g., 1.2 for 20% faster) */
+    speed_up?: number;
+    /** Slow down multiplier (e.g., 0.8 for 20% slower) */
+    slow_down?: number;
+}
+interface CuttingConfig {
+    /** Cut from beginning in milliseconds */
+    cut_begin_ms?: number;
+    /** Cut from end in milliseconds */
+    cut_end_ms?: number;
+    /** Cut from middle in milliseconds */
+    cut_middle_ms?: number;
+}
+interface LensCorrectionConfig {
+    /** Barrel/pincushion distortion coefficient (-0.1 to 0.1 typical) */
+    k1: number;
+    /** Secondary distortion coefficient */
+    k2: number;
+}
+interface ColorShiftConfig {
+    /** Enable dynamic color shifting over time */
+    enabled: boolean;
+    /** Opacity of the effect (0-100) */
+    color_shift_opacity?: number;
+    /** Speed of color shifting */
+    color_shift_speed?: number;
+    /** Custom hue expression (e.g., "sin(t)*4.0") */
+    hue_expression?: string;
+    /** Custom saturation expression (e.g., "1+sin(t)*0.2") */
+    saturation_expression?: string;
+}
+interface FrameManipulationConfig {
+    /** Skip random frames */
+    random_skip_frames?: boolean;
+    /** Temporal transition (WARNING: can desync audio) */
+    temporal_transition?: boolean;
+    /** Time warp effect (WARNING: can cause artifacts) */
+    time_warp?: boolean;
+    /** Temporal blend between frames */
+    tblend?: boolean;
+    /** RGBA channel shift */
+    rgba_shift?: boolean;
+}
+type BlendMode = 'overlay' | 'multiply' | 'screen';
+interface GradientOverlayConfig {
+    /** Enable animated gradient overlay */
+    enabled: boolean;
+    /** Blend mode */
+    blend_mode?: BlendMode;
+    /** Opacity (0.01 to 0.1 typical) */
+    opacity?: number;
+}
+type DiagonalFilterType = 'hexagonal_grid' | 'diagonal_square_grid' | 'scan_lines' | 'scan_lines_green' | 'scan_lines_red' | 'scan_lines_blue';
+interface DiagonalFilterConfig {
+    /** Enable diagonal/scanline filter */
+    enabled: boolean;
+    /** Filter type */
+    scan_line_filter: DiagonalFilterType;
+}
+interface ColorFilterConfig {
+    /** Vintage effect */
+    vintage?: boolean;
+    /** Black and white */
+    blackwhite?: boolean;
+    /** Sepia tone */
+    sepia?: boolean;
+    /** Blur effect */
+    blur?: boolean;
+    /** Sharpen effect */
+    sharpen?: boolean;
+    /** Pink overlay */
+    pink_overlay?: boolean;
+    /** Green color tint */
+    green_color?: boolean;
+    /** Red color tint */
+    red_color?: boolean;
+    /** Blue color tint */
+    blue_color?: boolean;
+}
+type EnhanceLevel = '2k' | '4k';
+interface EnhancementConfig {
+    /** Upscale video using Lanczos + noise reduction */
+    enhance_video?: EnhanceLevel;
+}
+interface AudioConfig {
+    /** Mute all audio */
+    mute_audio?: boolean;
+    /** Apply random pitch shift */
+    random_pitch?: boolean;
+    /** Add white noise */
+    white_noise?: boolean;
+}
+interface GifSource {
+    /** URL to the GIF file */
+    url: string;
+    /** Enable this GIF */
+    enabled: boolean;
+}
+interface GifOverlayConfig {
+    /** Enable GIF overlay */
+    animated_gif: boolean;
+    /** Height of GIF strip in pixels */
+    height?: number;
+    /** Header GIF configuration */
+    header?: GifSource;
+    /** Footer GIF configuration */
+    footer?: GifSource;
+}
+interface ParticleOverlayConfig {
+    /** Enable particle overlay */
+    enabled: boolean;
+    /** Particle video URL or filename */
+    particle_file?: string;
+    /** Blend opacity */
+    opacity?: number;
+}
+interface DeduplicationConfig {
+    /** Phone metadata configuration */
+    phone_config?: PhoneConfig;
+    /** FFmpeg trace removal configuration */
+    trace_removal?: TraceRemovalConfig;
+    /** Mobile-typical encoding settings */
+    mobile_encoding?: MobileEncodingConfig;
+    /** Visual adjustments (brightness, contrast, etc.) */
+    visual_adjustments?: VisualAdjustmentsConfig;
+    /** Crop configuration */
+    crop?: CropConfig;
+    /** Speed adjustments */
+    speed?: SpeedConfig;
+    /** Cutting/trimming */
+    cutting?: CuttingConfig;
+    /** Lens correction (critical for hash breaking) */
+    lens_correction?: LensCorrectionConfig;
+    /** Dynamic color shift (critical for hash breaking) */
+    color_shift?: ColorShiftConfig;
+    /** Frame manipulation */
+    frame_manipulation?: FrameManipulationConfig;
+    /** Animated gradient overlay */
+    gradient_overlay?: GradientOverlayConfig;
+    /** Diagonal/scanline filter */
+    diagonal_filter?: DiagonalFilterConfig;
+    /** Color filter presets */
+    color_filter?: ColorFilterConfig;
+    /** Video enhancement/upscaling */
+    enhancement?: EnhancementConfig;
+    /** Audio manipulation */
+    audio?: AudioConfig;
+    /** GIF overlay */
+    gif_overlay?: GifOverlayConfig;
+    /** Particle overlay */
+    particle_overlay?: ParticleOverlayConfig;
+}
+/**
+ * Level 1: Minimal
+ * - Phone metadata injection only
+ */
+declare const LEVEL_1_CONFIG: DeduplicationConfig;
+/**
+ * Level 2: Basic
+ * - Phone metadata
+ * - FFmpeg trace removal
+ */
+declare const LEVEL_2_CONFIG: DeduplicationConfig;
+/**
+ * Level 3: Standard
+ * - Phone metadata
+ * - FFmpeg trace removal
+ * - Mobile encoding settings
+ * - Subtle visual adjustments
+ */
+declare const LEVEL_3_CONFIG: DeduplicationConfig;
+/**
+ * Level 4: Aggressive
+ * - Everything in Level 3
+ * - Lens correction (geometry distortion)
+ * - Dynamic color shift
+ * - Random frame skips
+ */
+declare const LEVEL_4_CONFIG: DeduplicationConfig;
+/**
+ * Level 5: Maximum
+ * - All modifications enabled
+ * - Strongest settings
+ * - Audio muted (recommended for TikTok)
+ */
+declare const LEVEL_5_CONFIG: DeduplicationConfig;
+/**
+ * Map of level names to configs
+ */
+declare const DEDUPLICATION_LEVELS: Record<DeduplicationLevel, DeduplicationConfig>;
+/**
+ * Helper function to check if input is a level string
+ */
+declare function isDeduplicationLevel(input: DeduplicationInput): input is DeduplicationLevel;
+/**
+ * Helper function to resolve input to config
+ */
+declare function resolveDeduplicationConfig(input: DeduplicationInput): DeduplicationConfig;
+
 interface ImageEditorCompositionProps {
     /** The editor configuration to render (legacy format with pre-resolved segments) */
     config?: ImageEditorConfig;
@@ -1365,4 +1650,4 @@ declare function useResolvedPositions(elements: ImageEditorElement[], textValues
 
 declare const RenderRoot: React.FC;
 
-export { APPLE_EMOJI_FONT, type AudioSegment, type BaseEditorConfig, type BaseSegment, type BorderRadiusConfig, type Channel, type CropAxisConfig, type CropBoundary, type CropBounds, DIMENSION_PRESETS, type DimensionPreset, type DimensionPresetKey, type DynamicCropConfig, type EditorConfig, type EditorSegment, FONT_FAMILIES, FONT_URLS, type FitDimensions, type FitMode, type FontType, type FontWeight, type HorizontalAnchor, type HorizontalSelfAnchor, type Hyphenation, IMAGE_DEFAULTS, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, type ImageEditorElement, type ImageEditorNodeConfig, ImageElement, type ImageElementProps, type ImageSegment, type PictureSegment, type PositionResolutionError, type PositionResolutionResult, type RelativePositionConfigX, type RelativePositionConfigY, RenderRoot, type Segment, type SegmentTimelinePosition, type SegmentType, type StaticSegment, TEXT_DEFAULTS, type TextAlignment, type TextDirection, TextElement, type TextElementProps, type TextOverflow, type TextSegment, type TextStyleProperties, type TextWrap, type TimeMode, type TimeValue, VIDEO_DEFAULTS, VISUAL_DEFAULTS, type VerticalAlignment, type VerticalAnchor, type VerticalSelfAnchor, type VideoEditorAudioSegment, type VideoEditorBaseSegment, type VideoEditorChannel, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, type VideoEditorImageSegment, type VideoEditorNodeConfig, type VideoEditorSegment, type VideoEditorTextSegment, type VideoEditorVideoSegment, type VideoEditorVisualSegment, VideoElement, type VideoElementProps, type VideoSegment, type VisualSegment, type VisualSegmentUnion, type WordBreak, applyImageDefaults, applyTextDefaults, applyVideoDefaults, areFontsLoaded, buildFontString, calculateAutoWidthDimensions, calculateCropBounds, calculateEstimatedDuration, calculateFitDimensions, calculateLineWidth, calculateTimelineContentEnd, canSetAsReference, debugFontStatus, defaultOffset, formatTime, generateOverlayId, generateSegmentId, getBaseSegments, getBorderRadii, getDependentElements, getFontFamily, getOverlays, getReferenceElementX, getReferenceElementY, getSegmentTimelinePosition, hexToRgba, isDynamicCropEnabled, isSegmentVisibleAtTime, parseHexColor, parseTime, preloadFonts, resolveElementPositions, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions, wrapText };
+export { APPLE_EMOJI_FONT, type Acceleration, type AudioConfig, type AudioSegment, type BaseEditorConfig, type BaseSegment, type BlendMode, type BorderRadiusConfig, type Channel, type ColorFilterConfig, type ColorShiftConfig, type CropAxisConfig, type CropBoundary, type CropBounds, type CropConfig, type CuttingConfig, DEDUPLICATION_LEVELS, DIMENSION_PRESETS, type DeduplicationConfig, type DeduplicationInput, type DeduplicationLevel, type DiagonalFilterConfig, type DiagonalFilterType, type DimensionPreset, type DimensionPresetKey, type DynamicCropConfig, type EditorConfig, type EditorSegment, type EnhanceLevel, type EnhancementConfig, FONT_FAMILIES, FONT_URLS, type FitDimensions, type FitMode, type FontType, type FontWeight, type FrameManipulationConfig, type GifOverlayConfig, type GifSource, type GradientOverlayConfig, type HorizontalAnchor, type HorizontalSelfAnchor, type Hyphenation, IMAGE_DEFAULTS, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, type ImageEditorElement, type ImageEditorNodeConfig, ImageElement, type ImageElementProps, type ImageSegment, LEVEL_1_CONFIG, LEVEL_2_CONFIG, LEVEL_3_CONFIG, LEVEL_4_CONFIG, LEVEL_5_CONFIG, type LensCorrectionConfig, type MobileEncodingConfig, type ParticleOverlayConfig, type PhoneConfig, type PhoneModel, type PhoneType, type PictureSegment, type PositionResolutionError, type PositionResolutionResult, type RelativePositionConfigX, type RelativePositionConfigY, RenderRoot, type Segment, type SegmentTimelinePosition, type SegmentType, type SpeedConfig, type StaticSegment, TEXT_DEFAULTS, type TextAlignment, type TextDirection, TextElement, type TextElementProps, type TextOverflow, type TextSegment, type TextStyleProperties, type TextWrap, type TimeMode, type TimeValue, type TraceRemovalConfig, VIDEO_DEFAULTS, VISUAL_DEFAULTS, type VerticalAlignment, type VerticalAnchor, type VerticalSelfAnchor, type VideoCodec, type VideoEditorAudioSegment, type VideoEditorBaseSegment, type VideoEditorChannel, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, type VideoEditorImageSegment, type VideoEditorNodeConfig, type VideoEditorSegment, type VideoEditorTextSegment, type VideoEditorVideoSegment, type VideoEditorVisualSegment, VideoElement, type VideoElementProps, type VideoExtension, type VideoSegment, type VisualAdjustmentsConfig, type VisualSegment, type VisualSegmentUnion, type WordBreak, applyImageDefaults, applyTextDefaults, applyVideoDefaults, areFontsLoaded, buildFontString, calculateAutoWidthDimensions, calculateCropBounds, calculateEstimatedDuration, calculateFitDimensions, calculateLineWidth, calculateTimelineContentEnd, canSetAsReference, debugFontStatus, defaultOffset, formatTime, generateOverlayId, generateSegmentId, getBaseSegments, getBorderRadii, getDependentElements, getFontFamily, getOverlays, getReferenceElementX, getReferenceElementY, getSegmentTimelinePosition, hexToRgba, isDeduplicationLevel, isDynamicCropEnabled, isSegmentVisibleAtTime, parseHexColor, parseTime, preloadFonts, resolveDeduplicationConfig, resolveElementPositions, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions, wrapText };

package/dist/index.d.ts

@@ -782,6 +782,291 @@ interface EditorSegment {
     volume?: number;
 }
 
+/**
+ * Video Deduplication Configuration
+ *
+ * Two ways to configure deduplication:
+ * 1. Use a preset level: 'level1' | 'level2' | 'level3' | 'level4' | 'level5'
+ * 2. Provide a custom DeduplicationConfig object
+ *
+ * @example
+ * // Using a preset level
+ * const dedup: DeduplicationInput = 'level3';
+ *
+ * @example
+ * // Using custom config
+ * const dedup: DeduplicationInput = {
+ *   phone_config: { phone: 'iphone', phone_model: 'iphone', inject_exif: true },
+ *   lens_correction: { k1: -0.05, k2: 0.01 },
+ * };
+ */
+type DeduplicationLevel = 'level1' | 'level2' | 'level3' | 'level4' | 'level5';
+type DeduplicationInput = DeduplicationLevel | DeduplicationConfig;
+type PhoneType = 'iphone' | 'android';
+type PhoneModel = 'iphone' | 'samsung' | 'pixel';
+interface PhoneConfig {
+    /** Phone platform type */
+    phone: PhoneType;
+    /** Specific phone model to mimic */
+    phone_model: PhoneModel;
+    /** Inject EXIF metadata */
+    inject_exif: boolean;
+    /** Region code (e.g., "US") */
+    region?: string;
+}
+type VideoCodec = 'H264' | 'H265';
+type VideoExtension = 'MP4' | 'MOV';
+type Acceleration = 'nvidia' | 'cpu';
+interface TraceRemovalConfig {
+    /** Output codec */
+    codec: VideoCodec;
+    /** Output container format (H265 should use MOV) */
+    video_extension: VideoExtension;
+    /** Hardware acceleration type */
+    acceleration?: Acceleration;
+    /** Remove FFmpeg signatures from binary */
+    remove_ffmpeg_signatures: boolean;
+    /** Remove encoder metadata */
+    remove_encoder_metadata: boolean;
+}
+interface MobileEncodingConfig {
+    /** Use GOP of 60 (typical for mobile cameras) */
+    use_gop: boolean;
+    /** Delete B-frames (typical for mobile) */
+    delete_b_frames: boolean;
+    /** Adjust keyframe intervals */
+    change_keyframes: boolean;
+    /** Change pixel format to mobile-typical */
+    change_pixel_format: boolean;
+    /** Use mobile color palette */
+    mobile_palette: boolean;
+}
+interface VisualAdjustmentsConfig {
+    /** Brightness adjustment range (random value within +-range) */
+    brightness?: number;
+    /** Gamma adjustment range */
+    gamma?: number;
+    /** Saturation adjustment range */
+    saturation?: number;
+    /** Contrast adjustment range */
+    contrast?: number;
+    /** Horizontal flip */
+    horizontal_flip?: boolean;
+    /** Rotation in degrees (clockwise) */
+    rotate_right?: number;
+    /** Rotation in degrees (counter-clockwise) */
+    rotate_left?: number;
+}
+interface CropConfig {
+    /** Pixels to crop from top */
+    crop_top?: number;
+    /** Pixels to crop from bottom */
+    crop_bottom?: number;
+    /** Pixels to crop from left */
+    crop_left?: number;
+    /** Pixels to crop from right */
+    crop_right?: number;
+}
+interface SpeedConfig {
+    /** Speed multiplier (e.g., 1.2 for 20% faster) */
+    speed_up?: number;
+    /** Slow down multiplier (e.g., 0.8 for 20% slower) */
+    slow_down?: number;
+}
+interface CuttingConfig {
+    /** Cut from beginning in milliseconds */
+    cut_begin_ms?: number;
+    /** Cut from end in milliseconds */
+    cut_end_ms?: number;
+    /** Cut from middle in milliseconds */
+    cut_middle_ms?: number;
+}
+interface LensCorrectionConfig {
+    /** Barrel/pincushion distortion coefficient (-0.1 to 0.1 typical) */
+    k1: number;
+    /** Secondary distortion coefficient */
+    k2: number;
+}
+interface ColorShiftConfig {
+    /** Enable dynamic color shifting over time */
+    enabled: boolean;
+    /** Opacity of the effect (0-100) */
+    color_shift_opacity?: number;
+    /** Speed of color shifting */
+    color_shift_speed?: number;
+    /** Custom hue expression (e.g., "sin(t)*4.0") */
+    hue_expression?: string;
+    /** Custom saturation expression (e.g., "1+sin(t)*0.2") */
+    saturation_expression?: string;
+}
+interface FrameManipulationConfig {
+    /** Skip random frames */
+    random_skip_frames?: boolean;
+    /** Temporal transition (WARNING: can desync audio) */
+    temporal_transition?: boolean;
+    /** Time warp effect (WARNING: can cause artifacts) */
+    time_warp?: boolean;
+    /** Temporal blend between frames */
+    tblend?: boolean;
+    /** RGBA channel shift */
+    rgba_shift?: boolean;
+}
+type BlendMode = 'overlay' | 'multiply' | 'screen';
+interface GradientOverlayConfig {
+    /** Enable animated gradient overlay */
+    enabled: boolean;
+    /** Blend mode */
+    blend_mode?: BlendMode;
+    /** Opacity (0.01 to 0.1 typical) */
+    opacity?: number;
+}
+type DiagonalFilterType = 'hexagonal_grid' | 'diagonal_square_grid' | 'scan_lines' | 'scan_lines_green' | 'scan_lines_red' | 'scan_lines_blue';
+interface DiagonalFilterConfig {
+    /** Enable diagonal/scanline filter */
+    enabled: boolean;
+    /** Filter type */
+    scan_line_filter: DiagonalFilterType;
+}
+interface ColorFilterConfig {
+    /** Vintage effect */
+    vintage?: boolean;
+    /** Black and white */
+    blackwhite?: boolean;
+    /** Sepia tone */
+    sepia?: boolean;
+    /** Blur effect */
+    blur?: boolean;
+    /** Sharpen effect */
+    sharpen?: boolean;
+    /** Pink overlay */
+    pink_overlay?: boolean;
+    /** Green color tint */
+    green_color?: boolean;
+    /** Red color tint */
+    red_color?: boolean;
+    /** Blue color tint */
+    blue_color?: boolean;
+}
+type EnhanceLevel = '2k' | '4k';
+interface EnhancementConfig {
+    /** Upscale video using Lanczos + noise reduction */
+    enhance_video?: EnhanceLevel;
+}
+interface AudioConfig {
+    /** Mute all audio */
+    mute_audio?: boolean;
+    /** Apply random pitch shift */
+    random_pitch?: boolean;
+    /** Add white noise */
+    white_noise?: boolean;
+}
+interface GifSource {
+    /** URL to the GIF file */
+    url: string;
+    /** Enable this GIF */
+    enabled: boolean;
+}
+interface GifOverlayConfig {
+    /** Enable GIF overlay */
+    animated_gif: boolean;
+    /** Height of GIF strip in pixels */
+    height?: number;
+    /** Header GIF configuration */
+    header?: GifSource;
+    /** Footer GIF configuration */
+    footer?: GifSource;
+}
+interface ParticleOverlayConfig {
+    /** Enable particle overlay */
+    enabled: boolean;
+    /** Particle video URL or filename */
+    particle_file?: string;
+    /** Blend opacity */
+    opacity?: number;
+}
+interface DeduplicationConfig {
+    /** Phone metadata configuration */
+    phone_config?: PhoneConfig;
+    /** FFmpeg trace removal configuration */
+    trace_removal?: TraceRemovalConfig;
+    /** Mobile-typical encoding settings */
+    mobile_encoding?: MobileEncodingConfig;
+    /** Visual adjustments (brightness, contrast, etc.) */
+    visual_adjustments?: VisualAdjustmentsConfig;
+    /** Crop configuration */
+    crop?: CropConfig;
+    /** Speed adjustments */
+    speed?: SpeedConfig;
+    /** Cutting/trimming */
+    cutting?: CuttingConfig;
+    /** Lens correction (critical for hash breaking) */
+    lens_correction?: LensCorrectionConfig;
+    /** Dynamic color shift (critical for hash breaking) */
+    color_shift?: ColorShiftConfig;
+    /** Frame manipulation */
+    frame_manipulation?: FrameManipulationConfig;
+    /** Animated gradient overlay */
+    gradient_overlay?: GradientOverlayConfig;
+    /** Diagonal/scanline filter */
+    diagonal_filter?: DiagonalFilterConfig;
+    /** Color filter presets */
+    color_filter?: ColorFilterConfig;
+    /** Video enhancement/upscaling */
+    enhancement?: EnhancementConfig;
+    /** Audio manipulation */
+    audio?: AudioConfig;
+    /** GIF overlay */
+    gif_overlay?: GifOverlayConfig;
+    /** Particle overlay */
+    particle_overlay?: ParticleOverlayConfig;
+}
+/**
+ * Level 1: Minimal
+ * - Phone metadata injection only
+ */
+declare const LEVEL_1_CONFIG: DeduplicationConfig;
+/**
+ * Level 2: Basic
+ * - Phone metadata
+ * - FFmpeg trace removal
+ */
+declare const LEVEL_2_CONFIG: DeduplicationConfig;
+/**
+ * Level 3: Standard
+ * - Phone metadata
+ * - FFmpeg trace removal
+ * - Mobile encoding settings
+ * - Subtle visual adjustments
+ */
+declare const LEVEL_3_CONFIG: DeduplicationConfig;
+/**
+ * Level 4: Aggressive
+ * - Everything in Level 3
+ * - Lens correction (geometry distortion)
+ * - Dynamic color shift
+ * - Random frame skips
+ */
+declare const LEVEL_4_CONFIG: DeduplicationConfig;
+/**
+ * Level 5: Maximum
+ * - All modifications enabled
+ * - Strongest settings
+ * - Audio muted (recommended for TikTok)
+ */
+declare const LEVEL_5_CONFIG: DeduplicationConfig;
+/**
+ * Map of level names to configs
+ */
+declare const DEDUPLICATION_LEVELS: Record<DeduplicationLevel, DeduplicationConfig>;
+/**
+ * Helper function to check if input is a level string
+ */
+declare function isDeduplicationLevel(input: DeduplicationInput): input is DeduplicationLevel;
+/**
+ * Helper function to resolve input to config
+ */
+declare function resolveDeduplicationConfig(input: DeduplicationInput): DeduplicationConfig;
+
 interface ImageEditorCompositionProps {
     /** The editor configuration to render (legacy format with pre-resolved segments) */
     config?: ImageEditorConfig;
@@ -1365,4 +1650,4 @@ declare function useResolvedPositions(elements: ImageEditorElement[], textValues
 
 declare const RenderRoot: React.FC;
 
-export { APPLE_EMOJI_FONT, type AudioSegment, type BaseEditorConfig, type BaseSegment, type BorderRadiusConfig, type Channel, type CropAxisConfig, type CropBoundary, type CropBounds, DIMENSION_PRESETS, type DimensionPreset, type DimensionPresetKey, type DynamicCropConfig, type EditorConfig, type EditorSegment, FONT_FAMILIES, FONT_URLS, type FitDimensions, type FitMode, type FontType, type FontWeight, type HorizontalAnchor, type HorizontalSelfAnchor, type Hyphenation, IMAGE_DEFAULTS, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, type ImageEditorElement, type ImageEditorNodeConfig, ImageElement, type ImageElementProps, type ImageSegment, type PictureSegment, type PositionResolutionError, type PositionResolutionResult, type RelativePositionConfigX, type RelativePositionConfigY, RenderRoot, type Segment, type SegmentTimelinePosition, type SegmentType, type StaticSegment, TEXT_DEFAULTS, type TextAlignment, type TextDirection, TextElement, type TextElementProps, type TextOverflow, type TextSegment, type TextStyleProperties, type TextWrap, type TimeMode, type TimeValue, VIDEO_DEFAULTS, VISUAL_DEFAULTS, type VerticalAlignment, type VerticalAnchor, type VerticalSelfAnchor, type VideoEditorAudioSegment, type VideoEditorBaseSegment, type VideoEditorChannel, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, type VideoEditorImageSegment, type VideoEditorNodeConfig, type VideoEditorSegment, type VideoEditorTextSegment, type VideoEditorVideoSegment, type VideoEditorVisualSegment, VideoElement, type VideoElementProps, type VideoSegment, type VisualSegment, type VisualSegmentUnion, type WordBreak, applyImageDefaults, applyTextDefaults, applyVideoDefaults, areFontsLoaded, buildFontString, calculateAutoWidthDimensions, calculateCropBounds, calculateEstimatedDuration, calculateFitDimensions, calculateLineWidth, calculateTimelineContentEnd, canSetAsReference, debugFontStatus, defaultOffset, formatTime, generateOverlayId, generateSegmentId, getBaseSegments, getBorderRadii, getDependentElements, getFontFamily, getOverlays, getReferenceElementX, getReferenceElementY, getSegmentTimelinePosition, hexToRgba, isDynamicCropEnabled, isSegmentVisibleAtTime, parseHexColor, parseTime, preloadFonts, resolveElementPositions, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions, wrapText };
+export { APPLE_EMOJI_FONT, type Acceleration, type AudioConfig, type AudioSegment, type BaseEditorConfig, type BaseSegment, type BlendMode, type BorderRadiusConfig, type Channel, type ColorFilterConfig, type ColorShiftConfig, type CropAxisConfig, type CropBoundary, type CropBounds, type CropConfig, type CuttingConfig, DEDUPLICATION_LEVELS, DIMENSION_PRESETS, type DeduplicationConfig, type DeduplicationInput, type DeduplicationLevel, type DiagonalFilterConfig, type DiagonalFilterType, type DimensionPreset, type DimensionPresetKey, type DynamicCropConfig, type EditorConfig, type EditorSegment, type EnhanceLevel, type EnhancementConfig, FONT_FAMILIES, FONT_URLS, type FitDimensions, type FitMode, type FontType, type FontWeight, type FrameManipulationConfig, type GifOverlayConfig, type GifSource, type GradientOverlayConfig, type HorizontalAnchor, type HorizontalSelfAnchor, type Hyphenation, IMAGE_DEFAULTS, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, type ImageEditorElement, type ImageEditorNodeConfig, ImageElement, type ImageElementProps, type ImageSegment, LEVEL_1_CONFIG, LEVEL_2_CONFIG, LEVEL_3_CONFIG, LEVEL_4_CONFIG, LEVEL_5_CONFIG, type LensCorrectionConfig, type MobileEncodingConfig, type ParticleOverlayConfig, type PhoneConfig, type PhoneModel, type PhoneType, type PictureSegment, type PositionResolutionError, type PositionResolutionResult, type RelativePositionConfigX, type RelativePositionConfigY, RenderRoot, type Segment, type SegmentTimelinePosition, type SegmentType, type SpeedConfig, type StaticSegment, TEXT_DEFAULTS, type TextAlignment, type TextDirection, TextElement, type TextElementProps, type TextOverflow, type TextSegment, type TextStyleProperties, type TextWrap, type TimeMode, type TimeValue, type TraceRemovalConfig, VIDEO_DEFAULTS, VISUAL_DEFAULTS, type VerticalAlignment, type VerticalAnchor, type VerticalSelfAnchor, type VideoCodec, type VideoEditorAudioSegment, type VideoEditorBaseSegment, type VideoEditorChannel, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, type VideoEditorImageSegment, type VideoEditorNodeConfig, type VideoEditorSegment, type VideoEditorTextSegment, type VideoEditorVideoSegment, type VideoEditorVisualSegment, VideoElement, type VideoElementProps, type VideoExtension, type VideoSegment, type VisualAdjustmentsConfig, type VisualSegment, type VisualSegmentUnion, type WordBreak, applyImageDefaults, applyTextDefaults, applyVideoDefaults, areFontsLoaded, buildFontString, calculateAutoWidthDimensions, calculateCropBounds, calculateEstimatedDuration, calculateFitDimensions, calculateLineWidth, calculateTimelineContentEnd, canSetAsReference, debugFontStatus, defaultOffset, formatTime, generateOverlayId, generateSegmentId, getBaseSegments, getBorderRadii, getDependentElements, getFontFamily, getOverlays, getReferenceElementX, getReferenceElementY, getSegmentTimelinePosition, hexToRgba, isDeduplicationLevel, isDynamicCropEnabled, isSegmentVisibleAtTime, parseHexColor, parseTime, preloadFonts, resolveDeduplicationConfig, resolveElementPositions, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions, wrapText };

package/dist/index.js

@@ -31,12 +31,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   APPLE_EMOJI_FONT: () => APPLE_EMOJI_FONT,
+  DEDUPLICATION_LEVELS: () => DEDUPLICATION_LEVELS,
   DIMENSION_PRESETS: () => DIMENSION_PRESETS,
   FONT_FAMILIES: () => FONT_FAMILIES,
   FONT_URLS: () => FONT_URLS,
   IMAGE_DEFAULTS: () => IMAGE_DEFAULTS,
   ImageEditorComposition: () => ImageEditorComposition,
   ImageElement: () => ImageElement,
+  LEVEL_1_CONFIG: () => LEVEL_1_CONFIG,
+  LEVEL_2_CONFIG: () => LEVEL_2_CONFIG,
+  LEVEL_3_CONFIG: () => LEVEL_3_CONFIG,
+  LEVEL_4_CONFIG: () => LEVEL_4_CONFIG,
+  LEVEL_5_CONFIG: () => LEVEL_5_CONFIG,
   RenderRoot: () => RenderRoot,
   TEXT_DEFAULTS: () => TEXT_DEFAULTS,
   TextElement: () => TextElement,
@@ -70,11 +76,13 @@ __export(index_exports, {
   getReferenceElementY: () => getReferenceElementY,
   getSegmentTimelinePosition: () => getSegmentTimelinePosition,
   hexToRgba: () => hexToRgba,
+  isDeduplicationLevel: () => isDeduplicationLevel,
   isDynamicCropEnabled: () => isDynamicCropEnabled,
   isSegmentVisibleAtTime: () => isSegmentVisibleAtTime,
   parseHexColor: () => parseHexColor,
   parseTime: () => parseTime,
   preloadFonts: () => preloadFonts,
+  resolveDeduplicationConfig: () => resolveDeduplicationConfig,
   resolveElementPositions: () => resolveElementPositions,
   useFontsLoaded: () => useFontsLoaded,
   useImageLoader: () => useImageLoader,
@@ -93,6 +101,184 @@ var DIMENSION_PRESETS = {
   "twitter": { width: 1200, height: 675, label: "Twitter/X (1200\xD7675)", ratio: "16:9" }
 };
 
+// src/types/deduplication.ts
+var LEVEL_1_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  }
+};
+var LEVEL_2_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  }
+};
+var LEVEL_3_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  },
+  mobile_encoding: {
+    use_gop: true,
+    delete_b_frames: false,
+    change_keyframes: true,
+    change_pixel_format: true,
+    mobile_palette: false
+  },
+  visual_adjustments: {
+    brightness: 5,
+    contrast: 3,
+    saturation: 3
+  },
+  cutting: {
+    cut_begin_ms: 100,
+    cut_end_ms: 100
+  }
+};
+var LEVEL_4_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  },
+  mobile_encoding: {
+    use_gop: true,
+    delete_b_frames: true,
+    change_keyframes: true,
+    change_pixel_format: true,
+    mobile_palette: false
+  },
+  visual_adjustments: {
+    brightness: 8,
+    contrast: 5,
+    saturation: 5,
+    horizontal_flip: true
+  },
+  cutting: {
+    cut_begin_ms: 200,
+    cut_end_ms: 100
+  },
+  lens_correction: {
+    k1: -0.03,
+    k2: 0.01
+  },
+  color_shift: {
+    enabled: true,
+    color_shift_opacity: 30,
+    color_shift_speed: 1
+  },
+  frame_manipulation: {
+    random_skip_frames: true
+  }
+};
+var LEVEL_5_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  },
+  mobile_encoding: {
+    use_gop: true,
+    delete_b_frames: true,
+    change_keyframes: true,
+    change_pixel_format: true,
+    mobile_palette: true
+  },
+  visual_adjustments: {
+    brightness: 10,
+    contrast: 5,
+    saturation: 5,
+    gamma: 5,
+    horizontal_flip: true,
+    rotate_right: 0.5
+  },
+  cutting: {
+    cut_begin_ms: 512,
+    cut_end_ms: 100,
+    cut_middle_ms: 200
+  },
+  speed: {
+    speed_up: 1.02
+  },
+  lens_correction: {
+    k1: -0.05,
+    k2: 0.01
+  },
+  color_shift: {
+    enabled: true,
+    color_shift_opacity: 50,
+    color_shift_speed: 1,
+    hue_expression: "sin(t)*4.0",
+    saturation_expression: "1+sin(t)*0.2"
+  },
+  frame_manipulation: {
+    random_skip_frames: true,
+    tblend: false,
+    temporal_transition: false
+  },
+  gradient_overlay: {
+    enabled: true,
+    blend_mode: "overlay",
+    opacity: 0.05
+  },
+  audio: {
+    mute_audio: true
+  }
+};
+var DEDUPLICATION_LEVELS = {
+  level1: LEVEL_1_CONFIG,
+  level2: LEVEL_2_CONFIG,
+  level3: LEVEL_3_CONFIG,
+  level4: LEVEL_4_CONFIG,
+  level5: LEVEL_5_CONFIG
+};
+function isDeduplicationLevel(input) {
+  return typeof input === "string" && input in DEDUPLICATION_LEVELS;
+}
+function resolveDeduplicationConfig(input) {
+  if (isDeduplicationLevel(input)) {
+    return DEDUPLICATION_LEVELS[input];
+  }
+  return input;
+}
+
 // src/compositions/ImageEditorComposition.tsx
 var import_react3 = require("react");
 var import_remotion2 = require("remotion");
@@ -2206,12 +2392,18 @@ var RenderRoot = () => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   APPLE_EMOJI_FONT,
+  DEDUPLICATION_LEVELS,
   DIMENSION_PRESETS,
   FONT_FAMILIES,
   FONT_URLS,
   IMAGE_DEFAULTS,
   ImageEditorComposition,
   ImageElement,
+  LEVEL_1_CONFIG,
+  LEVEL_2_CONFIG,
+  LEVEL_3_CONFIG,
+  LEVEL_4_CONFIG,
+  LEVEL_5_CONFIG,
   RenderRoot,
   TEXT_DEFAULTS,
   TextElement,
@@ -2245,11 +2437,13 @@ var RenderRoot = () => {
   getReferenceElementY,
   getSegmentTimelinePosition,
   hexToRgba,
+  isDeduplicationLevel,
   isDynamicCropEnabled,
   isSegmentVisibleAtTime,
   parseHexColor,
   parseTime,
   preloadFonts,
+  resolveDeduplicationConfig,
   resolveElementPositions,
   useFontsLoaded,
   useImageLoader,

package/dist/index.mjs

@@ -7,6 +7,184 @@ var DIMENSION_PRESETS = {
   "twitter": { width: 1200, height: 675, label: "Twitter/X (1200\xD7675)", ratio: "16:9" }
 };
 
+// src/types/deduplication.ts
+var LEVEL_1_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  }
+};
+var LEVEL_2_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  }
+};
+var LEVEL_3_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  },
+  mobile_encoding: {
+    use_gop: true,
+    delete_b_frames: false,
+    change_keyframes: true,
+    change_pixel_format: true,
+    mobile_palette: false
+  },
+  visual_adjustments: {
+    brightness: 5,
+    contrast: 3,
+    saturation: 3
+  },
+  cutting: {
+    cut_begin_ms: 100,
+    cut_end_ms: 100
+  }
+};
+var LEVEL_4_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  },
+  mobile_encoding: {
+    use_gop: true,
+    delete_b_frames: true,
+    change_keyframes: true,
+    change_pixel_format: true,
+    mobile_palette: false
+  },
+  visual_adjustments: {
+    brightness: 8,
+    contrast: 5,
+    saturation: 5,
+    horizontal_flip: true
+  },
+  cutting: {
+    cut_begin_ms: 200,
+    cut_end_ms: 100
+  },
+  lens_correction: {
+    k1: -0.03,
+    k2: 0.01
+  },
+  color_shift: {
+    enabled: true,
+    color_shift_opacity: 30,
+    color_shift_speed: 1
+  },
+  frame_manipulation: {
+    random_skip_frames: true
+  }
+};
+var LEVEL_5_CONFIG = {
+  phone_config: {
+    phone: "iphone",
+    phone_model: "iphone",
+    inject_exif: true,
+    region: "US"
+  },
+  trace_removal: {
+    codec: "H265",
+    video_extension: "MOV",
+    acceleration: "nvidia",
+    remove_ffmpeg_signatures: true,
+    remove_encoder_metadata: true
+  },
+  mobile_encoding: {
+    use_gop: true,
+    delete_b_frames: true,
+    change_keyframes: true,
+    change_pixel_format: true,
+    mobile_palette: true
+  },
+  visual_adjustments: {
+    brightness: 10,
+    contrast: 5,
+    saturation: 5,
+    gamma: 5,
+    horizontal_flip: true,
+    rotate_right: 0.5
+  },
+  cutting: {
+    cut_begin_ms: 512,
+    cut_end_ms: 100,
+    cut_middle_ms: 200
+  },
+  speed: {
+    speed_up: 1.02
+  },
+  lens_correction: {
+    k1: -0.05,
+    k2: 0.01
+  },
+  color_shift: {
+    enabled: true,
+    color_shift_opacity: 50,
+    color_shift_speed: 1,
+    hue_expression: "sin(t)*4.0",
+    saturation_expression: "1+sin(t)*0.2"
+  },
+  frame_manipulation: {
+    random_skip_frames: true,
+    tblend: false,
+    temporal_transition: false
+  },
+  gradient_overlay: {
+    enabled: true,
+    blend_mode: "overlay",
+    opacity: 0.05
+  },
+  audio: {
+    mute_audio: true
+  }
+};
+var DEDUPLICATION_LEVELS = {
+  level1: LEVEL_1_CONFIG,
+  level2: LEVEL_2_CONFIG,
+  level3: LEVEL_3_CONFIG,
+  level4: LEVEL_4_CONFIG,
+  level5: LEVEL_5_CONFIG
+};
+function isDeduplicationLevel(input) {
+  return typeof input === "string" && input in DEDUPLICATION_LEVELS;
+}
+function resolveDeduplicationConfig(input) {
+  if (isDeduplicationLevel(input)) {
+    return DEDUPLICATION_LEVELS[input];
+  }
+  return input;
+}
+
 // src/compositions/ImageEditorComposition.tsx
 import { useMemo as useMemo3, useState, useEffect } from "react";
 import { AbsoluteFill, Img as Img2, delayRender, continueRender } from "remotion";
@@ -2119,12 +2297,18 @@ var RenderRoot = () => {
 };
 export {
   APPLE_EMOJI_FONT,
+  DEDUPLICATION_LEVELS,
   DIMENSION_PRESETS,
   FONT_FAMILIES,
   FONT_URLS,
   IMAGE_DEFAULTS,
   ImageEditorComposition,
   ImageElement,
+  LEVEL_1_CONFIG,
+  LEVEL_2_CONFIG,
+  LEVEL_3_CONFIG,
+  LEVEL_4_CONFIG,
+  LEVEL_5_CONFIG,
   RenderRoot,
   TEXT_DEFAULTS,
   TextElement,
@@ -2158,11 +2342,13 @@ export {
   getReferenceElementY,
   getSegmentTimelinePosition,
   hexToRgba,
+  isDeduplicationLevel,
   isDynamicCropEnabled,
   isSegmentVisibleAtTime,
   parseHexColor,
   parseTime,
   preloadFonts,
+  resolveDeduplicationConfig,
   resolveElementPositions,
   useFontsLoaded,
   useImageLoader,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc-render",
-  "version": "1.5.32",
+  "version": "1.6.1",
   "description": "Unified rendering package for UGC Inc - shared types, components, and compositions for pixel-perfect client/server rendering",
   "main": "dist/index.js",
   "module": "dist/index.mjs",