@hyperframes/core 0.7.70 → 0.7.72

package/dist/colorGrading.js

@@ -1,3 +1,5 @@
+import { DEFAULT_MAX_CUBE_LUT_SIZE } from "./colorLuts.js";
+import { COLOR_GRADING_ADJUST_KEYS, COLOR_GRADING_COLOR_SPACE, COLOR_GRADING_DETAIL_KEYS, COLOR_GRADING_EFFECT_KEYS, COLOR_GRADING_LUT_KEYS, COLOR_GRADING_TOP_LEVEL_KEYS, } from "@hyperframes/parsers/color-grading-contract";
 export const HF_COLOR_GRADING_ATTR = "data-color-grading";
 // Runtime <-> studio contract attributes. The runtime grading engine writes
 // them; studio editing/soft-reload code reads them. Single owner — never
@@ -11,7 +13,7 @@ export const COLOR_GRADING_SOURCE_HIDDEN_ATTR = "data-hf-color-grading-source-hi
  */
 export const COLOR_GRADING_AUTHORED_OPACITY_ATTR = "data-hf-authored-opacity";
 export const HF_COLOR_GRADING_CANVAS_ID_PREFIX = "__hf_color_grading_";
-export const HF_COLOR_GRADING_COLOR_SPACE = "rec709";
+export const HF_COLOR_GRADING_COLOR_SPACE = COLOR_GRADING_COLOR_SPACE;
 const ADJUST_ZERO = {
     exposure: 0,
     contrast: 0,
@@ -24,9 +26,7 @@ const ADJUST_ZERO = {
     vibrance: 0,
     saturation: 0,
 };
-// Detail sub-controls keep identity-state defaults so enabling vignette/grain starts from useful
-// perceptual settings instead of raw mathematical zeroes.
-const DETAIL_ZERO = {
+const DETAIL_DEFAULTS = {
     vignette: 0,
     vignetteMidpoint: 0.5,
     vignetteRoundness: 0,
@@ -35,40 +35,188 @@ const DETAIL_ZERO = {
     grainSize: 0.25,
     grainRoughness: 0.5,
 };
-const EFFECT_ZERO = {
+const EFFECT_DEFAULTS = {
     blur: 0,
     pixelate: 0,
+    chromaBleed: 0,
+    tapeDamage: 0,
+    tapeTracking: 0,
+    tapeNoise: 1,
+    tapeSpeed: 0.5,
+    filmArtifacts: 0,
+    halftone: 0,
+    halftoneSize: 0,
+    twoInkPrint: 0,
+    twoInkPrintSize: 0,
+    ascii: 0,
+    asciiSize: 5 / 76,
+    asciiInvert: 0,
+    asciiStyle: 0,
+    asciiColor: 1,
+    asciiRotation: 0,
+    dither: 0,
+    ditherSize: 0,
+    bloom: 0,
+    bloomRadius: 8,
+    monoScreen: 0,
+    monoScreenSize: 0,
+    monoScreenAngle: 0,
+    monoScreenSpread: 0,
+    monoScreenShape: 0,
+    monoScreenInvert: 0,
+    scanlines: 0,
+    scanlineCount: 0,
+    scanlineSoftness: 0,
+    chromaticAberration: 0,
+    chromaticAngle: 0,
+    crtCurvature: 0,
+    digitalGlitch: 0,
+    digitalGlitchColorSplit: 0,
+    digitalGlitchLineTear: 0,
+    digitalGlitchPixelate: 0,
+    digitalGlitchBlockAmount: 0,
+    digitalGlitchBlockDisplacement: 0,
+    digitalGlitchBlockOpacity: 0,
+    digitalGlitchSpeed: 0,
+    engraving: 0,
+    engravingSpacing: 7 / 17,
+    engravingMinThickness: 0.2,
+    engravingMaxThickness: 3.2 / 7,
+    engravingAngle: 0.25,
+    engravingContrast: 7 / 15,
+    engravingSharpness: 0.59,
+    engravingWave: 0.2,
+    engravingWaveFrequency: 2 / 9,
+    crosshatch: 0,
+    crosshatchSpacing: 7 / 25,
+    crosshatchThickness: 0.25,
+    crosshatchAngle: 0.25,
+    crosshatchContrast: 1 / 3,
+    crosshatchEdges: 0.5,
+    crosshatchLineWeight: 0,
+    crosshatchWave: 0.33,
+    crosshatchWaveFrequency: 2 / 9,
+    kuwahara: 0,
+    kuwaharaRadius: 1 / 7,
+    kuwaharaSharpness: 5 / 16,
+    kuwaharaSaturation: 0.5,
 };
-export const HF_COLOR_GRADING_ADJUST_KEYS = Object.keys(ADJUST_ZERO);
-export const HF_COLOR_GRADING_DETAIL_KEYS = Object.keys(DETAIL_ZERO);
-export const HF_COLOR_GRADING_EFFECT_KEYS = Object.keys(EFFECT_ZERO);
-function preset(id, label, adjust = {}, details = {}) {
+export const HF_COLOR_GRADING_TOP_LEVEL_KEYS = COLOR_GRADING_TOP_LEVEL_KEYS;
+export const HF_COLOR_GRADING_LUT_KEYS = COLOR_GRADING_LUT_KEYS;
+export const HF_COLOR_GRADING_PALETTES = [
+    { id: "noir", label: "Noir", group: "Classic", colors: ["#000000", "#ffffff"] },
+    {
+        id: "ink-paper",
+        label: "Ink & Paper",
+        group: "Classic",
+        colors: ["#1a1a2e", "#f5f5dc"],
+    },
+    {
+        id: "terminal",
+        label: "Terminal",
+        group: "Classic",
+        colors: ["#001100", "#00ff00"],
+    },
+    {
+        id: "amber-glow",
+        label: "Amber Glow",
+        group: "Classic",
+        colors: ["#1a0f00", "#ffcc00"],
+    },
+    {
+        id: "handheld-green",
+        label: "Handheld Green",
+        group: "Classic",
+        colors: ["#0f380f", "#306230", "#8bac0f", "#9bbc0f"],
+    },
+    {
+        id: "golden-hour",
+        label: "Golden Hour",
+        group: "Mood",
+        colors: ["#1a1205", "#4a3510", "#8b6914", "#d4a017", "#fff8dc"],
+    },
+    {
+        id: "deep-sea",
+        label: "Deep Sea",
+        group: "Mood",
+        colors: ["#0a1628", "#1a3a5c", "#2d6187", "#5ba4c9", "#a8dce8"],
+    },
+    {
+        id: "arctic-night",
+        label: "Arctic Night",
+        group: "Mood",
+        colors: ["#0a0a14", "#1a2a4a", "#3a5a8a", "#6a9aca", "#cae8ff"],
+    },
+    {
+        id: "synthwave",
+        label: "Synthwave",
+        group: "Mood",
+        colors: ["#120458", "#7b2cbf", "#e040fb", "#ff6ec7", "#fff59d"],
+    },
+    {
+        id: "vaporwave",
+        label: "Vaporwave",
+        group: "Mood",
+        colors: ["#1a0a2e", "#3d1a5c", "#ff71ce", "#01cdfe", "#fffb96"],
+    },
+    {
+        id: "forest",
+        label: "Forest",
+        group: "Mood",
+        colors: ["#1a2e1a", "#2d4a2d", "#4a7c4a", "#7ab37a", "#c8e6c8"],
+    },
+    {
+        id: "sepia",
+        label: "Sepia",
+        group: "Mono",
+        colors: ["#1a1610", "#3d3020", "#6b5a40", "#a89070", "#e8dcc8"],
+    },
+    {
+        id: "blueprint",
+        label: "Blueprint",
+        group: "Mono",
+        colors: ["#001830", "#003060", "#0050a0", "#0080e0", "#e0f0ff"],
+    },
+    {
+        id: "warm-print",
+        label: "Warm Print",
+        group: "HyperFrames",
+        colors: ["#17121a", "#824c50", "#e09873", "#f7ddb1"],
+    },
+    {
+        id: "electric-ink",
+        label: "Electric Ink",
+        group: "HyperFrames",
+        colors: ["#080717", "#3c185f", "#7e2278", "#d9339f", "#ff6b66", "#aafae0"],
+    },
+];
+export const HF_COLOR_GRADING_ADJUST_KEYS = COLOR_GRADING_ADJUST_KEYS;
+export const HF_COLOR_GRADING_DETAIL_KEYS = COLOR_GRADING_DETAIL_KEYS;
+export const HF_COLOR_GRADING_EFFECT_KEYS = COLOR_GRADING_EFFECT_KEYS;
+const VINTAGE_WASH_ADJUST = {
+    exposure: 0.03,
+    contrast: -0.12,
+    highlights: -0.1,
+    shadows: 0.16,
+    whites: -0.04,
+    blacks: 0.08,
+    temperature: 0.13,
+    vibrance: -0.08,
+    saturation: -0.08,
+};
+const VINTAGE_WASH_DETAILS = { vignette: 0.18 };
+function preset(id, label, adjust = {}, details = {}, effects = {}, intensity = 1) {
     return {
         id,
         label,
+        intensity,
         adjust: { ...ADJUST_ZERO, ...adjust },
-        details: { ...DETAIL_ZERO, ...details },
-        effects: { ...EFFECT_ZERO },
+        details: { ...DETAIL_DEFAULTS, ...details },
+        effects: { ...EFFECT_DEFAULTS, ...effects },
     };
 }
 export const HF_COLOR_GRADING_PRESETS = [
     preset("neutral", "Neutral"),
-    preset("natural-lift", "Natural Lift", {
-        exposure: 0.04,
-        contrast: 0.06,
-        highlights: -0.06,
-        shadows: 0.08,
-        saturation: 0.05,
-    }),
-    preset("fresh-pop", "Fresh Pop", {
-        exposure: 0.08,
-        contrast: 0.12,
-        whites: 0.06,
-        shadows: 0.04,
-        temperature: -0.02,
-        vibrance: 0.08,
-        saturation: 0.16,
-    }),
     preset("warm-daylight", "Warm Daylight", {
         exposure: 0.06,
         contrast: 0.07,
@@ -123,19 +271,7 @@ export const HF_COLOR_GRADING_PRESETS = [
     }, {
         vignette: 0.1,
     }),
-    preset("vintage-wash", "Vintage Wash", {
-        exposure: 0.03,
-        contrast: -0.12,
-        highlights: -0.1,
-        shadows: 0.16,
-        whites: -0.04,
-        blacks: 0.08,
-        temperature: 0.13,
-        vibrance: -0.08,
-        saturation: -0.08,
-    }, {
-        vignette: 0.18,
-    }),
+    preset("vintage-wash", "Vintage Wash", VINTAGE_WASH_ADJUST, VINTAGE_WASH_DETAILS),
     preset("mono-clean", "Mono Clean", {
         contrast: 0.12,
         highlights: -0.04,
@@ -152,23 +288,6 @@ export const HF_COLOR_GRADING_PRESETS = [
     }, {
         vignette: 0.08,
     }),
-    preset("warm-clean", "Warm Clean", {
-        exposure: 0.05,
-        contrast: 0.08,
-        highlights: -0.08,
-        shadows: 0.08,
-        temperature: 0.16,
-        vibrance: 0.04,
-        saturation: 0.06,
-    }),
-    preset("cool-clean", "Cool Clean", {
-        contrast: 0.06,
-        highlights: -0.06,
-        shadows: 0.06,
-        temperature: -0.12,
-        tint: 0.04,
-        saturation: 0.04,
-    }),
     preset("soft-boost", "Soft Boost", {
         exposure: 0.06,
         contrast: -0.04,
@@ -193,6 +312,42 @@ export const HF_COLOR_GRADING_PRESETS = [
         blacks: -0.12,
         saturation: 0.06,
     }),
+    preset("creator-camcorder", "Creator Camcorder", {
+        contrast: 0.08,
+        highlights: -0.05,
+        shadows: 0.02,
+        whites: 0.03,
+        blacks: -0.04,
+        temperature: -0.03,
+        tint: -0.015,
+        vibrance: -0.03,
+        saturation: -0.06,
+    }, { vignette: 0.06, grain: 0.08, grainSize: 0.18, grainRoughness: 0.58 }, { chromaBleed: 0.55 }, 0.72),
+    preset("vhs-playback", "VHS Playback", { contrast: -0.04, saturation: -0.08 }, { grain: 0.16, grainSize: 0.12, grainRoughness: 0.72 }, {
+        tapeDamage: 0.82,
+        tapeTracking: 0.85,
+        tapeNoise: 0.3,
+        tapeSpeed: 0.5,
+        chromaBleed: 0.5,
+        chromaticAberration: 0.18,
+        scanlines: 0.35,
+        scanlineCount: 0.17,
+        scanlineSoftness: 1,
+        digitalGlitch: 0.32,
+        digitalGlitchLineTear: 0.08,
+        digitalGlitchSpeed: 0.5,
+    }),
+    preset("home-movie-8mm", "8mm Home Movie", VINTAGE_WASH_ADJUST, {
+        ...VINTAGE_WASH_DETAILS,
+        vignette: 0.28,
+        vignetteMidpoint: 0.54,
+        vignetteFeather: 0.72,
+        grain: 0.34,
+        grainSize: 0.18,
+        grainRoughness: 0.72,
+    }, { filmArtifacts: 0.62 }, 0.72),
+    preset("editorial-halftone", "Editorial Halftone", { contrast: 0.04, saturation: 0.04 }, {}, { halftone: 0.94, halftoneSize: 0.36 }),
+    preset("two-ink-print", "Two-Ink Print", { contrast: 0.08, highlights: -0.06, shadows: 0.04 }, {}, { twoInkPrint: 1, twoInkPrintSize: 0.42 }),
 ];
 const PRESETS_BY_ID = new Map(HF_COLOR_GRADING_PRESETS.map((preset) => [preset.id, preset]));
 const VARIABLE_REF_RE = /^\$(?:\{([A-Za-z0-9_.:-]+)\}|([A-Za-z0-9_.:-]+))$/;
@@ -217,10 +372,308 @@ const DETAIL_LIMITS = {
     grainSize: { min: 0, max: 1 },
     grainRoughness: { min: 0, max: 1 },
 };
-const EFFECT_LIMITS = {
-    blur: { min: 0, max: 1 },
-    pixelate: { min: 0, max: 1 },
+const UNIT_LIMIT = { min: 0, max: 1 };
+const EFFECT_LIMIT_OVERRIDES = {
+    asciiStyle: { min: 0, max: 7 },
+    bloom: { min: 0, max: 3 },
+    bloomRadius: { min: 1, max: 100 },
+    monoScreenShape: { min: 0, max: 4 },
 };
+export const HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS = [
+    "blur",
+    "pixelate",
+    "chromaBleed",
+    "tapeDamage",
+    "filmArtifacts",
+    "halftone",
+    "twoInkPrint",
+    "ascii",
+    "dither",
+    "bloom",
+    "monoScreen",
+    "scanlines",
+    "chromaticAberration",
+    "crtCurvature",
+    "digitalGlitch",
+    "engraving",
+    "crosshatch",
+    "kuwahara",
+];
+const EFFECT_FAMILIES = [
+    {
+        id: "essentials",
+        label: "Essentials",
+        description: "Common optical, focus, and privacy-oriented primitives.",
+    },
+    {
+        id: "retro-glitch",
+        label: "Retro & Glitch",
+        description: "Tape, film, CRT, channel separation, and digital disruption.",
+    },
+    {
+        id: "print",
+        label: "Print",
+        description: "Halftone, limited-ink, dither, and screen-print rendering.",
+    },
+    {
+        id: "art",
+        label: "Art",
+        description: "ASCII, engraved, crosshatched, and painterly rendering.",
+    },
+];
+const EFFECT_METADATA = {
+    blur: {
+        family: "essentials",
+        label: "Blur",
+        description: "Defocus or soften a full media layer.",
+    },
+    pixelate: {
+        family: "essentials",
+        label: "Pixelate",
+        description: "Turn a media layer into a block mosaic.",
+    },
+    bloom: {
+        family: "essentials",
+        label: "Bloom",
+        description: "Add thresholded glow around bright image regions.",
+    },
+    chromaBleed: {
+        family: "retro-glitch",
+        label: "Chroma Softening",
+        description: "Smear color like low-bandwidth video.",
+    },
+    tapeDamage: {
+        family: "retro-glitch",
+        label: "Tape Damage",
+        description: "Add moving tracking errors and tape noise.",
+    },
+    filmArtifacts: {
+        family: "retro-glitch",
+        label: "Film Artifacts",
+        description: "Add deterministic dust and film wear.",
+    },
+    scanlines: {
+        family: "retro-glitch",
+        label: "Scanlines",
+        description: "Overlay configurable horizontal display lines.",
+    },
+    crtCurvature: {
+        family: "retro-glitch",
+        label: "CRT Curvature",
+        description: "Warp media toward curved CRT geometry.",
+    },
+    chromaticAberration: {
+        family: "retro-glitch",
+        label: "Channel Separation",
+        description: "Offset color channels by angle.",
+    },
+    digitalGlitch: {
+        family: "retro-glitch",
+        label: "Digital Glitch",
+        description: "Compose tears, blocks, and color splits.",
+    },
+    halftone: {
+        family: "print",
+        label: "Halftone",
+        description: "Render source color through a print-dot raster.",
+    },
+    twoInkPrint: {
+        family: "print",
+        label: "Two-Ink Print",
+        description: "Reduce media to a two-ink print treatment.",
+    },
+    dither: {
+        family: "print",
+        label: "Ordered Dither",
+        description: "Quantize media into an ordered limited palette.",
+    },
+    monoScreen: {
+        family: "print",
+        label: "Mono Screen",
+        description: "Build monochrome dot, shape, or line artwork.",
+    },
+    ascii: {
+        family: "art",
+        label: "ASCII",
+        description: "Render media as configurable procedural glyph cells.",
+    },
+    engraving: {
+        family: "art",
+        label: "Engraving",
+        description: "Translate luminance into directional engraved lines.",
+    },
+    crosshatch: {
+        family: "art",
+        label: "Crosshatch",
+        description: "Translate media into layered hand-hatched lines.",
+    },
+    kuwahara: {
+        family: "art",
+        label: "Kuwahara Paint",
+        description: "Apply edge-preserving painterly smoothing.",
+    },
+};
+export const HF_COLOR_GRADING_EFFECT_PRESETS = HF_COLOR_GRADING_PRESETS.filter((preset) => HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS.some((key) => preset.effects[key] > 0.0001));
+export const HF_COLOR_GRADING_GRADE_PRESETS = HF_COLOR_GRADING_PRESETS.filter((preset) => !HF_COLOR_GRADING_EFFECT_PRESETS.includes(preset));
+/** Useful one-click values. Sub-controls not listed here keep their normalized defaults. */
+export const HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS = {
+    blur: { blur: 0.45 },
+    pixelate: { pixelate: 0.55 },
+    bloom: { bloom: 0.55, bloomRadius: 8 },
+    chromaBleed: { chromaBleed: 0.55 },
+    tapeDamage: {
+        tapeDamage: 0.65,
+        tapeTracking: 0.55,
+        tapeNoise: 0.25,
+        tapeSpeed: 0.5,
+    },
+    filmArtifacts: { filmArtifacts: 0.55 },
+    scanlines: { scanlines: 0.35, scanlineCount: 0.17, scanlineSoftness: 1 },
+    chromaticAberration: { chromaticAberration: 0.15, chromaticAngle: 0 },
+    crtCurvature: { crtCurvature: 0.2 },
+    digitalGlitch: {
+        digitalGlitch: 0.55,
+        digitalGlitchColorSplit: 0.25,
+        digitalGlitchLineTear: 0.25,
+        digitalGlitchPixelate: 0.15,
+        digitalGlitchBlockAmount: 0.5,
+        digitalGlitchBlockDisplacement: 0.25,
+        digitalGlitchBlockOpacity: 0,
+        digitalGlitchSpeed: 0.5,
+    },
+    halftone: { halftone: 0.94, halftoneSize: 0.36 },
+    twoInkPrint: { twoInkPrint: 1, twoInkPrintSize: 0.42 },
+    ascii: {
+        ascii: 1,
+        asciiSize: 5 / 76,
+        asciiInvert: 0,
+        asciiStyle: 0,
+        asciiColor: 1,
+        asciiRotation: 0,
+    },
+    dither: { dither: 1, ditherSize: 0.5 },
+    monoScreen: {
+        monoScreen: 1,
+        monoScreenSize: 0.35,
+        monoScreenAngle: 0.25,
+        monoScreenSpread: 0.3,
+        monoScreenShape: 0,
+        monoScreenInvert: 0,
+    },
+    engraving: {
+        engraving: 1,
+        engravingSpacing: 7 / 17,
+        engravingMinThickness: 0.2,
+        engravingMaxThickness: 3.2 / 7,
+        engravingAngle: 0.25,
+        engravingContrast: 7 / 15,
+        engravingSharpness: 0.59,
+        engravingWave: 0.2,
+        engravingWaveFrequency: 2 / 9,
+    },
+    crosshatch: {
+        crosshatch: 1,
+        crosshatchSpacing: 7 / 25,
+        crosshatchThickness: 0.25,
+        crosshatchAngle: 0.25,
+        crosshatchContrast: 1 / 3,
+        crosshatchEdges: 0.5,
+        crosshatchLineWeight: 0,
+        crosshatchWave: 0.33,
+        crosshatchWaveFrequency: 2 / 9,
+    },
+    kuwahara: {
+        kuwahara: 1,
+        kuwaharaRadius: 1 / 7,
+        kuwaharaSharpness: 5 / 16,
+        kuwaharaSaturation: 0.5,
+    },
+};
+export const HF_COLOR_GRADING_ANIMATABLE_PROPERTIES = [
+    { path: "intensity", name: "--hf-color-grading-intensity", min: 0, max: 1 },
+    { path: "lut.intensity", name: "--hf-color-grading-lut-intensity", min: 0, max: 1 },
+    { path: "adjust.exposure", name: "--hf-color-grading-exposure", min: -2, max: 2 },
+    { path: "effects.blur", name: "--hf-color-grading-blur", min: 0, max: 1 },
+    { path: "effects.bloom", name: "--hf-color-grading-bloom", min: 0, max: 3 },
+    { path: "effects.kuwahara", name: "--hf-color-grading-kuwahara", min: 0, max: 1 },
+    { path: "effects.pixelate", name: "--hf-color-grading-pixelate", min: 0, max: 1 },
+    { path: "effects.ascii", name: "--hf-color-grading-ascii", min: 0, max: 1 },
+    { path: "effects.dither", name: "--hf-color-grading-dither", min: 0, max: 1 },
+];
+function effectLimit(key) {
+    return EFFECT_LIMIT_OVERRIDES[key] ?? UNIT_LIMIT;
+}
+const PALETTE_EFFECT_KEYS = new Set([
+    "ascii",
+    "dither",
+    "monoScreen",
+    "engraving",
+    "crosshatch",
+]);
+const MULTIPASS_EFFECT_KEYS = new Set(["blur", "bloom", "kuwahara"]);
+/** Agent-readable view of the canonical grading and effect contracts. */
+export function getHfColorGradingCapabilities() {
+    return {
+        version: 1,
+        targetTags: ["img", "video"],
+        colorSpace: HF_COLOR_GRADING_COLOR_SPACE,
+        intensity: { identity: 1, min: 0, max: 1 },
+        palette: { minColors: 2, maxColors: 6, colorFormat: "#rrggbb" },
+        lut: {
+            format: "3d-cube",
+            maxCubeSize: DEFAULT_MAX_CUBE_LUT_SIZE,
+            intensity: { ...UNIT_LIMIT },
+        },
+        presets: [...HF_COLOR_GRADING_GRADE_PRESETS, ...HF_COLOR_GRADING_EFFECT_PRESETS].map((preset) => ({
+            id: preset.id,
+            label: preset.label,
+            intensity: preset.intensity,
+        })),
+        adjustments: HF_COLOR_GRADING_ADJUST_KEYS.map((key) => ({
+            key,
+            identity: ADJUST_ZERO[key],
+            ...ADJUST_LIMITS[key],
+        })),
+        effectFamilies: EFFECT_FAMILIES,
+        finishing: HF_COLOR_GRADING_DETAIL_KEYS.map((key) => ({
+            key,
+            identity: DETAIL_DEFAULTS[key],
+            ...DETAIL_LIMITS[key],
+        })),
+        effects: HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS.map((key) => {
+            const apply = HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS[key];
+            return {
+                key,
+                ...EFFECT_METADATA[key],
+                apply: { ...apply },
+                supportsPalette: PALETTE_EFFECT_KEYS.has(key),
+                renderLane: MULTIPASS_EFFECT_KEYS.has(key) ? "multipass" : "single-pass",
+                controls: HF_COLOR_GRADING_EFFECT_KEYS.filter((control) => Object.hasOwn(apply, control)).map((control) => ({
+                    key: control,
+                    identity: EFFECT_DEFAULTS[control],
+                    recommended: apply[control] ?? EFFECT_DEFAULTS[control],
+                    ...effectLimit(control),
+                })),
+            };
+        }),
+        palettes: HF_COLOR_GRADING_PALETTES.map(({ id, label, group, colors }) => ({
+            id,
+            label,
+            group,
+            colors,
+        })),
+        animatable: HF_COLOR_GRADING_ANIMATABLE_PROPERTIES,
+    };
+}
+const EFFECT_PALETTE_COLOR = /^#[0-9a-f]{6}$/i;
+function normalizePalette(value) {
+    if (!Array.isArray(value) || value.length < 2 || value.length > 6)
+        return null;
+    if (!value.every((color) => typeof color === "string" && EFFECT_PALETTE_COLOR.test(color))) {
+        return null;
+    }
+    return value.map((color) => color.toLowerCase());
+}
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -278,7 +731,7 @@ function readColorGradingObject(raw) {
                 return null;
             }
         }
-        return { preset: trimmed, intensity: 1 };
+        return { preset: trimmed };
     }
     return isRecord(raw) ? raw : null;
 }
@@ -326,8 +779,8 @@ export function normalizeHfColorGrading(raw) {
     const presetId = normalizePresetId(grading.preset);
     const preset = getHfColorGradingPreset(presetId);
     const presetAdjust = preset?.adjust ?? ADJUST_ZERO;
-    const presetDetails = preset?.details ?? DETAIL_ZERO;
-    const presetEffects = preset?.effects ?? EFFECT_ZERO;
+    const presetDetails = preset?.details ?? DETAIL_DEFAULTS;
+    const presetEffects = preset?.effects ?? EFFECT_DEFAULTS;
     const rawAdjust = isRecord(grading.adjust) ? grading.adjust : {};
     const rawDetails = isRecord(grading.details) ? grading.details : {};
     const rawEffects = isRecord(grading.effects) ? grading.effects : {};
@@ -338,18 +791,19 @@ export function normalizeHfColorGrading(raw) {
     const details = HF_COLOR_GRADING_DETAIL_KEYS.reduce((result, key) => {
         result[key] = readLimitedValue(rawDetails[key] ?? presetDetails[key], DETAIL_LIMITS[key]);
         return result;
-    }, { ...DETAIL_ZERO });
+    }, { ...DETAIL_DEFAULTS });
     const effects = HF_COLOR_GRADING_EFFECT_KEYS.reduce((result, key) => {
-        result[key] = readLimitedValue(rawEffects[key] ?? presetEffects[key], EFFECT_LIMITS[key]);
+        result[key] = readLimitedValue(rawEffects[key] ?? presetEffects[key], EFFECT_LIMIT_OVERRIDES[key] ?? UNIT_LIMIT);
         return result;
-    }, { ...EFFECT_ZERO });
+    }, { ...EFFECT_DEFAULTS });
     return {
         enabled: true,
         preset: presetId,
-        intensity: clampUnit(grading.intensity, 1),
+        intensity: clampUnit(grading.intensity, preset?.intensity ?? 1),
         adjust,
         details,
         effects,
+        palette: normalizePalette(grading.palette),
         lut: normalizeLut(grading.lut),
         colorSpace: typeof grading.colorSpace === "string" && grading.colorSpace.trim()
             ? grading.colorSpace.trim()
@@ -363,19 +817,21 @@ export function serializeHfColorGrading(grading) {
     const normalized = normalizeHfColorGrading(grading);
     if (!normalized)
         return "";
-    const { enabled: _enabled, ...serializable } = normalized;
-    return JSON.stringify(serializable);
+    const { enabled: _enabled, palette, ...serializable } = normalized;
+    return JSON.stringify(palette ? { ...serializable, palette } : serializable);
 }
 export function isHfColorGradingActive(grading) {
     if (!grading?.enabled)
         return false;
+    const hasIndependentTreatment = Math.abs(grading.details.vignette) > 0.0001 ||
+        Math.abs(grading.details.grain) > 0.0001 ||
+        HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS.some((key) => Math.abs(grading.effects[key]) > 0.0001);
+    if (hasIndependentTreatment)
+        return true;
     if (grading.intensity === 0)
         return false;
     if (grading.lut && grading.lut.intensity !== 0)
         return true;
-    return (HF_COLOR_GRADING_ADJUST_KEYS.some((key) => Math.abs(grading.adjust[key]) > 0.0001) ||
-        Math.abs(grading.details.vignette) > 0.0001 ||
-        Math.abs(grading.details.grain) > 0.0001 ||
-        HF_COLOR_GRADING_EFFECT_KEYS.some((key) => Math.abs(grading.effects[key]) > 0.0001));
+    return HF_COLOR_GRADING_ADJUST_KEYS.some((key) => Math.abs(grading.adjust[key]) > 0.0001);
 }
 //# sourceMappingURL=colorGrading.js.map