@hyperframes/parsers 0.7.71 → 0.7.72

package/dist/colorGradingContract.js

@@ -122,6 +122,17 @@ function isRecord(value) {
 function isColorGradingVariableRef(value) {
   return typeof value === "string" && VARIABLE_REF.test(value.trim());
 }
+function unknownKeysHint(path, unknown) {
+  if (path !== "grading") return `Correct or remove the unsupported "${path}" keys.`;
+  const sections = new Set(
+    unknown.flatMap(
+      (key) => OBJECT_SECTIONS.filter(([, keys]) => keys.includes(key)).map(
+        ([section]) => section
+      )
+    )
+  );
+  return sections.size === 1 ? `Move those controls under "${[...sections][0]}".` : "Use only the documented media-treatment keys at the top level.";
+}
 function validateObject(value, path, keys, issues) {
   if (isColorGradingVariableRef(value)) return null;
   if (!isRecord(value)) {
@@ -131,7 +142,11 @@ function validateObject(value, path, keys, issues) {
   const allowed = new Set(keys);
   const unknown = Object.keys(value).filter((key) => !allowed.has(key));
   if (unknown.length > 0) {
-    issues.push({ path, message: `has unsupported key(s): ${unknown.join(", ")}` });
+    issues.push({
+      path,
+      message: `has unsupported key(s): ${unknown.join(", ")}`,
+      hint: unknownKeysHint(path, unknown)
+    });
   }
   return value;
 }
@@ -150,13 +165,18 @@ function validateNumericSection(value, path, keys, limitFor, issues) {
 }
 function validatePalette(value, issues) {
   if (value === void 0 || value === null || isColorGradingVariableRef(value)) return;
+  const hint = 'Use 2 to 6 colors in the intended mapping order, each written as exact "#RRGGBB", or use a project variable reference.';
   if (!Array.isArray(value) || value.length < 2 || value.length > 6) {
-    issues.push({ path: "palette", message: "must contain 2 to 6 hex colors" });
+    issues.push({ path: "palette", message: "must contain 2 to 6 hex colors", hint });
     return;
   }
   value.forEach((color, index) => {
     if (typeof color !== "string" || !PALETTE_COLOR.test(color)) {
-      issues.push({ path: `palette[${index}]`, message: "must be a six-digit hex color" });
+      issues.push({
+        path: `palette[${index}]`,
+        message: "must be a six-digit hex color",
+        hint
+      });
     }
   });
 }

package/dist/colorGradingContract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/colorGradingContract.ts"],"sourcesContent":["export const COLOR_GRADING_CONTRACT_VERSION = 1;\nexport const COLOR_GRADING_COLOR_SPACE = \"rec709\";\n\nexport const COLOR_GRADING_TOP_LEVEL_KEYS = [\n  \"enabled\",\n  \"preset\",\n  \"intensity\",\n  \"adjust\",\n  \"details\",\n  \"effects\",\n  \"palette\",\n  \"lut\",\n  \"colorSpace\",\n] as const;\n\nexport const COLOR_GRADING_ADJUST_KEYS = [\n  \"exposure\",\n  \"contrast\",\n  \"highlights\",\n  \"shadows\",\n  \"whites\",\n  \"blacks\",\n  \"temperature\",\n  \"tint\",\n  \"vibrance\",\n  \"saturation\",\n] as const;\n\nexport const COLOR_GRADING_DETAIL_KEYS = [\n  \"vignette\",\n  \"vignetteMidpoint\",\n  \"vignetteRoundness\",\n  \"vignetteFeather\",\n  \"grain\",\n  \"grainSize\",\n  \"grainRoughness\",\n] as const;\n\nexport const COLOR_GRADING_EFFECT_KEYS = [\n  \"blur\",\n  \"pixelate\",\n  \"chromaBleed\",\n  \"tapeDamage\",\n  \"tapeTracking\",\n  \"tapeNoise\",\n  \"tapeSpeed\",\n  \"filmArtifacts\",\n  \"halftone\",\n  \"halftoneSize\",\n  \"twoInkPrint\",\n  \"twoInkPrintSize\",\n  \"ascii\",\n  \"asciiSize\",\n  \"asciiInvert\",\n  \"asciiStyle\",\n  \"asciiColor\",\n  \"asciiRotation\",\n  \"dither\",\n  \"ditherSize\",\n  \"bloom\",\n  \"bloomRadius\",\n  \"monoScreen\",\n  \"monoScreenSize\",\n  \"monoScreenAngle\",\n  \"monoScreenSpread\",\n  \"monoScreenShape\",\n  \"monoScreenInvert\",\n  \"scanlines\",\n  \"scanlineCount\",\n  \"scanlineSoftness\",\n  \"chromaticAberration\",\n  \"chromaticAngle\",\n  \"crtCurvature\",\n  \"digitalGlitch\",\n  \"digitalGlitchColorSplit\",\n  \"digitalGlitchLineTear\",\n  \"digitalGlitchPixelate\",\n  \"digitalGlitchBlockAmount\",\n  \"digitalGlitchBlockDisplacement\",\n  \"digitalGlitchBlockOpacity\",\n  \"digitalGlitchSpeed\",\n  \"engraving\",\n  \"engravingSpacing\",\n  \"engravingMinThickness\",\n  \"engravingMaxThickness\",\n  \"engravingAngle\",\n  \"engravingContrast\",\n  \"engravingSharpness\",\n  \"engravingWave\",\n  \"engravingWaveFrequency\",\n  \"crosshatch\",\n  \"crosshatchSpacing\",\n  \"crosshatchThickness\",\n  \"crosshatchAngle\",\n  \"crosshatchContrast\",\n  \"crosshatchEdges\",\n  \"crosshatchLineWeight\",\n  \"crosshatchWave\",\n  \"crosshatchWaveFrequency\",\n  \"kuwahara\",\n  \"kuwaharaRadius\",\n  \"kuwaharaSharpness\",\n  \"kuwaharaSaturation\",\n] as const;\n\nexport const COLOR_GRADING_LUT_KEYS = [\"src\", \"intensity\"] as const;\n\ntype NumericLimit = Readonly<{ min: number; max: number }>;\n\nconst UNIT_LIMIT: NumericLimit = { min: 0, max: 1 };\nconst SIGNED_UNIT_LIMIT: NumericLimit = { min: -1, max: 1 };\nconst EFFECT_LIMIT_OVERRIDES: Readonly<Record<string, NumericLimit>> = {\n  asciiStyle: { min: 0, max: 7 },\n  bloom: { min: 0, max: 3 },\n  bloomRadius: { min: 1, max: 100 },\n  monoScreenShape: { min: 0, max: 4 },\n};\nconst VARIABLE_REF = /^\\$(?:\\{[A-Za-z0-9_.:-]+\\}|[A-Za-z0-9_.:-]+)$/;\nconst PALETTE_COLOR = /^#[0-9a-f]{6}$/i;\n\nconst OBJECT_SECTIONS = [\n  [\"adjust\", COLOR_GRADING_ADJUST_KEYS],\n  [\"details\", COLOR_GRADING_DETAIL_KEYS],\n  [\"effects\", COLOR_GRADING_EFFECT_KEYS],\n  [\"lut\", COLOR_GRADING_LUT_KEYS],\n] as const;\n\nexport interface ColorGradingContractIssue {\n  path: string;\n  message: string;\n  hint?: string;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function isColorGradingVariableRef(value: unknown): value is string {\n  return typeof value === \"string\" && VARIABLE_REF.test(value.trim());\n}\n\nfunction validateObject(\n  value: unknown,\n  path: string,\n  keys: readonly string[],\n  issues: ColorGradingContractIssue[],\n): Record<string, unknown> | null {\n  if (isColorGradingVariableRef(value)) return null;\n  if (!isRecord(value)) {\n    issues.push({ path, message: \"must be an object or variable reference\" });\n    return null;\n  }\n  const allowed = new Set(keys);\n  const unknown = Object.keys(value).filter((key) => !allowed.has(key));\n  if (unknown.length > 0) {\n    issues.push({ path, message: `has unsupported key(s): ${unknown.join(\", \")}` });\n  }\n  return value;\n}\n\nfunction validateNumericField(\n  value: Record<string, unknown>,\n  key: string,\n  path: string,\n  limit: NumericLimit,\n  issues: ColorGradingContractIssue[],\n): void {\n  const candidate = value[key];\n  if (candidate === undefined || isColorGradingVariableRef(candidate)) return;\n  if (\n    typeof candidate !== \"number\" ||\n    !Number.isFinite(candidate) ||\n    candidate < limit.min ||\n    candidate > limit.max\n  ) {\n    issues.push({\n      path: path ? `${path}.${key}` : key,\n      message: `must be a finite number from ${limit.min} through ${limit.max}`,\n    });\n  }\n}\n\nfunction validateNumericSection(\n  value: Record<string, unknown>,\n  path: string,\n  keys: readonly string[],\n  limitFor: (key: string) => NumericLimit,\n  issues: ColorGradingContractIssue[],\n): void {\n  for (const key of keys) validateNumericField(value, key, path, limitFor(key), issues);\n}\n\nfunction validatePalette(value: unknown, issues: ColorGradingContractIssue[]): void {\n  if (value === undefined || value === null || isColorGradingVariableRef(value)) return;\n  if (!Array.isArray(value) || value.length < 2 || value.length > 6) {\n    issues.push({ path: \"palette\", message: \"must contain 2 to 6 hex colors\" });\n    return;\n  }\n  value.forEach((color, index) => {\n    if (typeof color !== \"string\" || !PALETTE_COLOR.test(color)) {\n      issues.push({ path: `palette[${index}]`, message: \"must be a six-digit hex color\" });\n    }\n  });\n}\n\nfunction validateLut(\n  value: unknown,\n  object: Record<string, unknown> | null,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (typeof value === \"string\") {\n    if (!value.trim()) issues.push({ path: \"lut\", message: \"must not be empty\" });\n    return;\n  }\n  if (!object) return;\n  if (\n    !isColorGradingVariableRef(object.src) &&\n    (typeof object.src !== \"string\" || !object.src.trim())\n  ) {\n    issues.push({\n      path: \"lut.src\",\n      message: \"must be a non-empty string or variable reference\",\n    });\n  }\n  validateNumericField(object, \"intensity\", \"lut\", UNIT_LIMIT, issues);\n}\n\nfunction validateEnabled(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (\n    grading.enabled !== undefined &&\n    !isColorGradingVariableRef(grading.enabled) &&\n    typeof grading.enabled !== \"boolean\"\n  ) {\n    issues.push({ path: \"enabled\", message: \"must be a boolean or variable reference\" });\n  }\n}\n\nfunction validatePreset(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (\n    grading.preset !== undefined &&\n    grading.preset !== null &&\n    !isColorGradingVariableRef(grading.preset) &&\n    (typeof grading.preset !== \"string\" || !grading.preset.trim())\n  ) {\n    issues.push({\n      path: \"preset\",\n      message: \"must be a non-empty string, null, or variable reference\",\n    });\n  }\n}\n\nfunction validateColorSpace(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (\n    grading.colorSpace !== undefined &&\n    !isColorGradingVariableRef(grading.colorSpace) &&\n    grading.colorSpace !== COLOR_GRADING_COLOR_SPACE\n  ) {\n    issues.push({\n      path: \"colorSpace\",\n      message: `must be \"${COLOR_GRADING_COLOR_SPACE}\" or a variable reference`,\n    });\n  }\n}\n\nfunction validateTopLevel(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  validateEnabled(grading, issues);\n  validateNumericField(grading, \"intensity\", \"\", UNIT_LIMIT, issues);\n  validatePreset(grading, issues);\n  validateColorSpace(grading, issues);\n}\n\nfunction validateSection(\n  grading: Record<string, unknown>,\n  key: (typeof OBJECT_SECTIONS)[number][0],\n  keys: readonly string[],\n  issues: ColorGradingContractIssue[],\n): void {\n  const section = grading[key];\n  if (section === undefined || (key === \"lut\" && section === null)) return;\n  if (key === \"lut\" && typeof section === \"string\") {\n    validateLut(section, null, issues);\n    return;\n  }\n  const object = validateObject(section, key, keys, issues);\n  if (!object) return;\n  if (key === \"lut\") return validateLut(section, object, issues);\n\n  const limitFor = (control: string): NumericLimit => {\n    if (key === \"adjust\" && control === \"exposure\") return { min: -2, max: 2 };\n    if (key === \"adjust\" || (key === \"details\" && control === \"vignetteRoundness\")) {\n      return SIGNED_UNIT_LIMIT;\n    }\n    return key === \"effects\" ? (EFFECT_LIMIT_OVERRIDES[control] ?? UNIT_LIMIT) : UNIT_LIMIT;\n  };\n  validateNumericSection(object, key, keys, limitFor, issues);\n}\n\nfunction validateSections(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  for (const [key, keys] of OBJECT_SECTIONS) validateSection(grading, key, keys, issues);\n}\n\n/** Browser-safe structural validation shared by Lint, CLI, and Core consumers. */\nexport function validateColorGradingContract(value: unknown): ColorGradingContractIssue[] {\n  if (typeof value === \"string\") {\n    return value.trim() ? [] : [{ path: \"grading\", message: \"is empty\" }];\n  }\n\n  const issues: ColorGradingContractIssue[] = [];\n  const grading = validateObject(value, \"grading\", COLOR_GRADING_TOP_LEVEL_KEYS, issues);\n  if (!grading) return issues;\n\n  validateTopLevel(grading, issues);\n  validateSections(grading, issues);\n  validatePalette(grading.palette, issues);\n  return issues;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/colorGradingContract.ts"],"sourcesContent":["export const COLOR_GRADING_CONTRACT_VERSION = 1;\nexport const COLOR_GRADING_COLOR_SPACE = \"rec709\";\n\nexport const COLOR_GRADING_TOP_LEVEL_KEYS = [\n  \"enabled\",\n  \"preset\",\n  \"intensity\",\n  \"adjust\",\n  \"details\",\n  \"effects\",\n  \"palette\",\n  \"lut\",\n  \"colorSpace\",\n] as const;\n\nexport const COLOR_GRADING_ADJUST_KEYS = [\n  \"exposure\",\n  \"contrast\",\n  \"highlights\",\n  \"shadows\",\n  \"whites\",\n  \"blacks\",\n  \"temperature\",\n  \"tint\",\n  \"vibrance\",\n  \"saturation\",\n] as const;\n\nexport const COLOR_GRADING_DETAIL_KEYS = [\n  \"vignette\",\n  \"vignetteMidpoint\",\n  \"vignetteRoundness\",\n  \"vignetteFeather\",\n  \"grain\",\n  \"grainSize\",\n  \"grainRoughness\",\n] as const;\n\nexport const COLOR_GRADING_EFFECT_KEYS = [\n  \"blur\",\n  \"pixelate\",\n  \"chromaBleed\",\n  \"tapeDamage\",\n  \"tapeTracking\",\n  \"tapeNoise\",\n  \"tapeSpeed\",\n  \"filmArtifacts\",\n  \"halftone\",\n  \"halftoneSize\",\n  \"twoInkPrint\",\n  \"twoInkPrintSize\",\n  \"ascii\",\n  \"asciiSize\",\n  \"asciiInvert\",\n  \"asciiStyle\",\n  \"asciiColor\",\n  \"asciiRotation\",\n  \"dither\",\n  \"ditherSize\",\n  \"bloom\",\n  \"bloomRadius\",\n  \"monoScreen\",\n  \"monoScreenSize\",\n  \"monoScreenAngle\",\n  \"monoScreenSpread\",\n  \"monoScreenShape\",\n  \"monoScreenInvert\",\n  \"scanlines\",\n  \"scanlineCount\",\n  \"scanlineSoftness\",\n  \"chromaticAberration\",\n  \"chromaticAngle\",\n  \"crtCurvature\",\n  \"digitalGlitch\",\n  \"digitalGlitchColorSplit\",\n  \"digitalGlitchLineTear\",\n  \"digitalGlitchPixelate\",\n  \"digitalGlitchBlockAmount\",\n  \"digitalGlitchBlockDisplacement\",\n  \"digitalGlitchBlockOpacity\",\n  \"digitalGlitchSpeed\",\n  \"engraving\",\n  \"engravingSpacing\",\n  \"engravingMinThickness\",\n  \"engravingMaxThickness\",\n  \"engravingAngle\",\n  \"engravingContrast\",\n  \"engravingSharpness\",\n  \"engravingWave\",\n  \"engravingWaveFrequency\",\n  \"crosshatch\",\n  \"crosshatchSpacing\",\n  \"crosshatchThickness\",\n  \"crosshatchAngle\",\n  \"crosshatchContrast\",\n  \"crosshatchEdges\",\n  \"crosshatchLineWeight\",\n  \"crosshatchWave\",\n  \"crosshatchWaveFrequency\",\n  \"kuwahara\",\n  \"kuwaharaRadius\",\n  \"kuwaharaSharpness\",\n  \"kuwaharaSaturation\",\n] as const;\n\nexport const COLOR_GRADING_LUT_KEYS = [\"src\", \"intensity\"] as const;\n\ntype NumericLimit = Readonly<{ min: number; max: number }>;\n\nconst UNIT_LIMIT: NumericLimit = { min: 0, max: 1 };\nconst SIGNED_UNIT_LIMIT: NumericLimit = { min: -1, max: 1 };\nconst EFFECT_LIMIT_OVERRIDES: Readonly<Record<string, NumericLimit>> = {\n  asciiStyle: { min: 0, max: 7 },\n  bloom: { min: 0, max: 3 },\n  bloomRadius: { min: 1, max: 100 },\n  monoScreenShape: { min: 0, max: 4 },\n};\nconst VARIABLE_REF = /^\\$(?:\\{[A-Za-z0-9_.:-]+\\}|[A-Za-z0-9_.:-]+)$/;\nconst PALETTE_COLOR = /^#[0-9a-f]{6}$/i;\n\nconst OBJECT_SECTIONS = [\n  [\"adjust\", COLOR_GRADING_ADJUST_KEYS],\n  [\"details\", COLOR_GRADING_DETAIL_KEYS],\n  [\"effects\", COLOR_GRADING_EFFECT_KEYS],\n  [\"lut\", COLOR_GRADING_LUT_KEYS],\n] as const;\n\nexport interface ColorGradingContractIssue {\n  path: string;\n  message: string;\n  hint?: string;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function isColorGradingVariableRef(value: unknown): value is string {\n  return typeof value === \"string\" && VARIABLE_REF.test(value.trim());\n}\n\nfunction unknownKeysHint(path: string, unknown: readonly string[]): string {\n  if (path !== \"grading\") return `Correct or remove the unsupported \"${path}\" keys.`;\n  const sections = new Set(\n    unknown.flatMap((key) =>\n      OBJECT_SECTIONS.filter(([, keys]) => (keys as readonly string[]).includes(key)).map(\n        ([section]) => section,\n      ),\n    ),\n  );\n  return sections.size === 1\n    ? `Move those controls under \"${[...sections][0]}\".`\n    : \"Use only the documented media-treatment keys at the top level.\";\n}\n\nfunction validateObject(\n  value: unknown,\n  path: string,\n  keys: readonly string[],\n  issues: ColorGradingContractIssue[],\n): Record<string, unknown> | null {\n  if (isColorGradingVariableRef(value)) return null;\n  if (!isRecord(value)) {\n    issues.push({ path, message: \"must be an object or variable reference\" });\n    return null;\n  }\n  const allowed = new Set(keys);\n  const unknown = Object.keys(value).filter((key) => !allowed.has(key));\n  if (unknown.length > 0) {\n    issues.push({\n      path,\n      message: `has unsupported key(s): ${unknown.join(\", \")}`,\n      hint: unknownKeysHint(path, unknown),\n    });\n  }\n  return value;\n}\n\nfunction validateNumericField(\n  value: Record<string, unknown>,\n  key: string,\n  path: string,\n  limit: NumericLimit,\n  issues: ColorGradingContractIssue[],\n): void {\n  const candidate = value[key];\n  if (candidate === undefined || isColorGradingVariableRef(candidate)) return;\n  if (\n    typeof candidate !== \"number\" ||\n    !Number.isFinite(candidate) ||\n    candidate < limit.min ||\n    candidate > limit.max\n  ) {\n    issues.push({\n      path: path ? `${path}.${key}` : key,\n      message: `must be a finite number from ${limit.min} through ${limit.max}`,\n    });\n  }\n}\n\nfunction validateNumericSection(\n  value: Record<string, unknown>,\n  path: string,\n  keys: readonly string[],\n  limitFor: (key: string) => NumericLimit,\n  issues: ColorGradingContractIssue[],\n): void {\n  for (const key of keys) validateNumericField(value, key, path, limitFor(key), issues);\n}\n\nfunction validatePalette(value: unknown, issues: ColorGradingContractIssue[]): void {\n  if (value === undefined || value === null || isColorGradingVariableRef(value)) return;\n  const hint =\n    'Use 2 to 6 colors in the intended mapping order, each written as exact \"#RRGGBB\", or use a project variable reference.';\n  if (!Array.isArray(value) || value.length < 2 || value.length > 6) {\n    issues.push({ path: \"palette\", message: \"must contain 2 to 6 hex colors\", hint });\n    return;\n  }\n  value.forEach((color, index) => {\n    if (typeof color !== \"string\" || !PALETTE_COLOR.test(color)) {\n      issues.push({\n        path: `palette[${index}]`,\n        message: \"must be a six-digit hex color\",\n        hint,\n      });\n    }\n  });\n}\n\nfunction validateLut(\n  value: unknown,\n  object: Record<string, unknown> | null,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (typeof value === \"string\") {\n    if (!value.trim()) issues.push({ path: \"lut\", message: \"must not be empty\" });\n    return;\n  }\n  if (!object) return;\n  if (\n    !isColorGradingVariableRef(object.src) &&\n    (typeof object.src !== \"string\" || !object.src.trim())\n  ) {\n    issues.push({\n      path: \"lut.src\",\n      message: \"must be a non-empty string or variable reference\",\n    });\n  }\n  validateNumericField(object, \"intensity\", \"lut\", UNIT_LIMIT, issues);\n}\n\nfunction validateEnabled(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (\n    grading.enabled !== undefined &&\n    !isColorGradingVariableRef(grading.enabled) &&\n    typeof grading.enabled !== \"boolean\"\n  ) {\n    issues.push({ path: \"enabled\", message: \"must be a boolean or variable reference\" });\n  }\n}\n\nfunction validatePreset(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (\n    grading.preset !== undefined &&\n    grading.preset !== null &&\n    !isColorGradingVariableRef(grading.preset) &&\n    (typeof grading.preset !== \"string\" || !grading.preset.trim())\n  ) {\n    issues.push({\n      path: \"preset\",\n      message: \"must be a non-empty string, null, or variable reference\",\n    });\n  }\n}\n\nfunction validateColorSpace(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  if (\n    grading.colorSpace !== undefined &&\n    !isColorGradingVariableRef(grading.colorSpace) &&\n    grading.colorSpace !== COLOR_GRADING_COLOR_SPACE\n  ) {\n    issues.push({\n      path: \"colorSpace\",\n      message: `must be \"${COLOR_GRADING_COLOR_SPACE}\" or a variable reference`,\n    });\n  }\n}\n\nfunction validateTopLevel(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  validateEnabled(grading, issues);\n  validateNumericField(grading, \"intensity\", \"\", UNIT_LIMIT, issues);\n  validatePreset(grading, issues);\n  validateColorSpace(grading, issues);\n}\n\nfunction validateSection(\n  grading: Record<string, unknown>,\n  key: (typeof OBJECT_SECTIONS)[number][0],\n  keys: readonly string[],\n  issues: ColorGradingContractIssue[],\n): void {\n  const section = grading[key];\n  if (section === undefined || (key === \"lut\" && section === null)) return;\n  if (key === \"lut\" && typeof section === \"string\") {\n    validateLut(section, null, issues);\n    return;\n  }\n  const object = validateObject(section, key, keys, issues);\n  if (!object) return;\n  if (key === \"lut\") return validateLut(section, object, issues);\n\n  const limitFor = (control: string): NumericLimit => {\n    if (key === \"adjust\" && control === \"exposure\") return { min: -2, max: 2 };\n    if (key === \"adjust\" || (key === \"details\" && control === \"vignetteRoundness\")) {\n      return SIGNED_UNIT_LIMIT;\n    }\n    return key === \"effects\" ? (EFFECT_LIMIT_OVERRIDES[control] ?? UNIT_LIMIT) : UNIT_LIMIT;\n  };\n  validateNumericSection(object, key, keys, limitFor, issues);\n}\n\nfunction validateSections(\n  grading: Record<string, unknown>,\n  issues: ColorGradingContractIssue[],\n): void {\n  for (const [key, keys] of OBJECT_SECTIONS) validateSection(grading, key, keys, issues);\n}\n\n/** Browser-safe structural validation shared by Lint, CLI, and Core consumers. */\nexport function validateColorGradingContract(value: unknown): ColorGradingContractIssue[] {\n  if (typeof value === \"string\") {\n    return value.trim() ? [] : [{ path: \"grading\", message: \"is empty\" }];\n  }\n\n  const issues: ColorGradingContractIssue[] = [];\n  const grading = validateObject(value, \"grading\", COLOR_GRADING_TOP_LEVEL_KEYS, issues);\n  if (!grading) return issues;\n\n  validateTopLevel(grading, issues);\n  validateSections(grading, issues);\n  validatePalette(grading.palette, issues);\n  return issues;\n}\n"],"mappings":";AAAO,IAAM,iCAAiC;AACvC,IAAM,4BAA4B;AAElC,IAAM,+BAA+B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,4BAA4B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,yBAAyB,CAAC,OAAO,WAAW;AAIzD,IAAM,aAA2B,EAAE,KAAK,GAAG,KAAK,EAAE;AAClD,IAAM,oBAAkC,EAAE,KAAK,IAAI,KAAK,EAAE;AAC1D,IAAM,yBAAiE;AAAA,EACrE,YAAY,EAAE,KAAK,GAAG,KAAK,EAAE;AAAA,EAC7B,OAAO,EAAE,KAAK,GAAG,KAAK,EAAE;AAAA,EACxB,aAAa,EAAE,KAAK,GAAG,KAAK,IAAI;AAAA,EAChC,iBAAiB,EAAE,KAAK,GAAG,KAAK,EAAE;AACpC;AACA,IAAM,eAAe;AACrB,IAAM,gBAAgB;AAEtB,IAAM,kBAAkB;AAAA,EACtB,CAAC,UAAU,yBAAyB;AAAA,EACpC,CAAC,WAAW,yBAAyB;AAAA,EACrC,CAAC,WAAW,yBAAyB;AAAA,EACrC,CAAC,OAAO,sBAAsB;AAChC;AAQA,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEO,SAAS,0BAA0B,OAAiC;AACzE,SAAO,OAAO,UAAU,YAAY,aAAa,KAAK,MAAM,KAAK,CAAC;AACpE;AAEA,SAAS,gBAAgB,MAAc,SAAoC;AACzE,MAAI,SAAS,UAAW,QAAO,sCAAsC,IAAI;AACzE,QAAM,WAAW,IAAI;AAAA,IACnB,QAAQ;AAAA,MAAQ,CAAC,QACf,gBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,MAAO,KAA2B,SAAS,GAAG,CAAC,EAAE;AAAA,QAC9E,CAAC,CAAC,OAAO,MAAM;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AACA,SAAO,SAAS,SAAS,IACrB,8BAA8B,CAAC,GAAG,QAAQ,EAAE,CAAC,CAAC,OAC9C;AACN;AAEA,SAAS,eACP,OACA,MACA,MACA,QACgC;AAChC,MAAI,0BAA0B,KAAK,EAAG,QAAO;AAC7C,MAAI,CAAC,SAAS,KAAK,GAAG;AACpB,WAAO,KAAK,EAAE,MAAM,SAAS,0CAA0C,CAAC;AACxE,WAAO;AAAA,EACT;AACA,QAAM,UAAU,IAAI,IAAI,IAAI;AAC5B,QAAM,UAAU,OAAO,KAAK,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,IAAI,GAAG,CAAC;AACpE,MAAI,QAAQ,SAAS,GAAG;AACtB,WAAO,KAAK;AAAA,MACV;AAAA,MACA,SAAS,2BAA2B,QAAQ,KAAK,IAAI,CAAC;AAAA,MACtD,MAAM,gBAAgB,MAAM,OAAO;AAAA,IACrC,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,SAAS,qBACP,OACA,KACA,MACA,OACA,QACM;AACN,QAAM,YAAY,MAAM,GAAG;AAC3B,MAAI,cAAc,UAAa,0BAA0B,SAAS,EAAG;AACrE,MACE,OAAO,cAAc,YACrB,CAAC,OAAO,SAAS,SAAS,KAC1B,YAAY,MAAM,OAClB,YAAY,MAAM,KAClB;AACA,WAAO,KAAK;AAAA,MACV,MAAM,OAAO,GAAG,IAAI,IAAI,GAAG,KAAK;AAAA,MAChC,SAAS,gCAAgC,MAAM,GAAG,YAAY,MAAM,GAAG;AAAA,IACzE,CAAC;AAAA,EACH;AACF;AAEA,SAAS,uBACP,OACA,MACA,MACA,UACA,QACM;AACN,aAAW,OAAO,KAAM,sBAAqB,OAAO,KAAK,MAAM,SAAS,GAAG,GAAG,MAAM;AACtF;AAEA,SAAS,gBAAgB,OAAgB,QAA2C;AAClF,MAAI,UAAU,UAAa,UAAU,QAAQ,0BAA0B,KAAK,EAAG;AAC/E,QAAM,OACJ;AACF,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,KAAK,MAAM,SAAS,GAAG;AACjE,WAAO,KAAK,EAAE,MAAM,WAAW,SAAS,kCAAkC,KAAK,CAAC;AAChF;AAAA,EACF;AACA,QAAM,QAAQ,CAAC,OAAO,UAAU;AAC9B,QAAI,OAAO,UAAU,YAAY,CAAC,cAAc,KAAK,KAAK,GAAG;AAC3D,aAAO,KAAK;AAAA,QACV,MAAM,WAAW,KAAK;AAAA,QACtB,SAAS;AAAA,QACT;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;AAEA,SAAS,YACP,OACA,QACA,QACM;AACN,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,CAAC,MAAM,KAAK,EAAG,QAAO,KAAK,EAAE,MAAM,OAAO,SAAS,oBAAoB,CAAC;AAC5E;AAAA,EACF;AACA,MAAI,CAAC,OAAQ;AACb,MACE,CAAC,0BAA0B,OAAO,GAAG,MACpC,OAAO,OAAO,QAAQ,YAAY,CAAC,OAAO,IAAI,KAAK,IACpD;AACA,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,uBAAqB,QAAQ,aAAa,OAAO,YAAY,MAAM;AACrE;AAEA,SAAS,gBACP,SACA,QACM;AACN,MACE,QAAQ,YAAY,UACpB,CAAC,0BAA0B,QAAQ,OAAO,KAC1C,OAAO,QAAQ,YAAY,WAC3B;AACA,WAAO,KAAK,EAAE,MAAM,WAAW,SAAS,0CAA0C,CAAC;AAAA,EACrF;AACF;AAEA,SAAS,eACP,SACA,QACM;AACN,MACE,QAAQ,WAAW,UACnB,QAAQ,WAAW,QACnB,CAAC,0BAA0B,QAAQ,MAAM,MACxC,OAAO,QAAQ,WAAW,YAAY,CAAC,QAAQ,OAAO,KAAK,IAC5D;AACA,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF;AAEA,SAAS,mBACP,SACA,QACM;AACN,MACE,QAAQ,eAAe,UACvB,CAAC,0BAA0B,QAAQ,UAAU,KAC7C,QAAQ,eAAe,2BACvB;AACA,WAAO,KAAK;AAAA,MACV,MAAM;AAAA,MACN,SAAS,YAAY,yBAAyB;AAAA,IAChD,CAAC;AAAA,EACH;AACF;AAEA,SAAS,iBACP,SACA,QACM;AACN,kBAAgB,SAAS,MAAM;AAC/B,uBAAqB,SAAS,aAAa,IAAI,YAAY,MAAM;AACjE,iBAAe,SAAS,MAAM;AAC9B,qBAAmB,SAAS,MAAM;AACpC;AAEA,SAAS,gBACP,SACA,KACA,MACA,QACM;AACN,QAAM,UAAU,QAAQ,GAAG;AAC3B,MAAI,YAAY,UAAc,QAAQ,SAAS,YAAY,KAAO;AAClE,MAAI,QAAQ,SAAS,OAAO,YAAY,UAAU;AAChD,gBAAY,SAAS,MAAM,MAAM;AACjC;AAAA,EACF;AACA,QAAM,SAAS,eAAe,SAAS,KAAK,MAAM,MAAM;AACxD,MAAI,CAAC,OAAQ;AACb,MAAI,QAAQ,MAAO,QAAO,YAAY,SAAS,QAAQ,MAAM;AAE7D,QAAM,WAAW,CAAC,YAAkC;AAClD,QAAI,QAAQ,YAAY,YAAY,WAAY,QAAO,EAAE,KAAK,IAAI,KAAK,EAAE;AACzE,QAAI,QAAQ,YAAa,QAAQ,aAAa,YAAY,qBAAsB;AAC9E,aAAO;AAAA,IACT;AACA,WAAO,QAAQ,YAAa,uBAAuB,OAAO,KAAK,aAAc;AAAA,EAC/E;AACA,yBAAuB,QAAQ,KAAK,MAAM,UAAU,MAAM;AAC5D;AAEA,SAAS,iBACP,SACA,QACM;AACN,aAAW,CAAC,KAAK,IAAI,KAAK,gBAAiB,iBAAgB,SAAS,KAAK,MAAM,MAAM;AACvF;AAGO,SAAS,6BAA6B,OAA6C;AACxF,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,WAAW,SAAS,WAAW,CAAC;AAAA,EACtE;AAEA,QAAM,SAAsC,CAAC;AAC7C,QAAM,UAAU,eAAe,OAAO,WAAW,8BAA8B,MAAM;AACrF,MAAI,CAAC,QAAS,QAAO;AAErB,mBAAiB,SAAS,MAAM;AAChC,mBAAiB,SAAS,MAAM;AAChC,kBAAgB,QAAQ,SAAS,MAAM;AACvC,SAAO;AACT;","names":[]}

package/dist/gsapConstants.js

@@ -87,14 +87,18 @@ var SUPPORTED_EASES = [
   "bounce.in",
   "bounce.out",
   "bounce.inOut",
+  "circ.inOut",
   "expo.in",
   "expo.out",
   "expo.inOut",
+  "elastic.out(1,0.3)",
+  "elastic.inOut(1,0.3)",
   "spring-gentle",
   "spring-bouncy",
   "spring-stiff",
   "spring-wobbly",
   "spring-heavy",
+  "hold",
   "steps(1)"
 ];
 export {

package/dist/gsapConstants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/gsapConstants.ts"],"sourcesContent":["/**\n * GSAP property and ease constants.\n *\n * Extracted into a standalone module so browser code can import them\n * without pulling in gsapParser (which depends on recast / @babel/parser).\n */\n\nexport const SUPPORTED_PROPS = [\n  // 2D Transforms\n  \"x\",\n  \"y\",\n  \"scale\",\n  \"scaleX\",\n  \"scaleY\",\n  \"rotation\",\n  \"skewX\",\n  \"skewY\",\n  // 3D Transforms\n  \"z\",\n  \"rotationX\",\n  \"rotationY\",\n  \"rotationZ\",\n  \"perspective\",\n  \"transformPerspective\",\n  \"transformOrigin\",\n  // Visibility\n  \"opacity\",\n  \"visibility\",\n  \"autoAlpha\",\n  // Dimensions\n  \"width\",\n  \"height\",\n  // Colors\n  \"color\",\n  \"backgroundColor\",\n  \"borderColor\",\n  // Box model\n  \"borderRadius\",\n  // Typography\n  \"fontSize\",\n  \"letterSpacing\",\n  // Filter & Clipping\n  \"filter\",\n  \"clipPath\",\n  // DOM content (number counters, text roll-ups)\n  \"innerText\",\n];\n\n// ── Property Groups ─────────────────────────────────────────────────────────\n// Each group maps to an independent GSAP tween so editing one property\n// (e.g. drag → x/y) never contaminates another (e.g. scale, rotation).\n\nexport type PropertyGroupName = \"position\" | \"scale\" | \"size\" | \"rotation\" | \"visual\" | \"other\";\n\nexport const PROPERTY_GROUPS: Record<PropertyGroupName, ReadonlySet<string>> = {\n  position: new Set([\"x\", \"y\", \"xPercent\", \"yPercent\"]),\n  scale: new Set([\"scale\", \"scaleX\", \"scaleY\"]),\n  size: new Set([\"width\", \"height\"]),\n  rotation: new Set([\"rotation\", \"skewX\", \"skewY\"]),\n  visual: new Set([\"opacity\", \"autoAlpha\"]),\n  other: new Set<string>(),\n};\n\nconst PROP_TO_GROUP = new Map<string, PropertyGroupName>();\nfor (const [group, props] of Object.entries(PROPERTY_GROUPS) as [\n  PropertyGroupName,\n  ReadonlySet<string>,\n][]) {\n  for (const p of props) PROP_TO_GROUP.set(p, group);\n}\n\nexport function classifyPropertyGroup(prop: string): PropertyGroupName {\n  return PROP_TO_GROUP.get(prop) ?? \"other\";\n}\n\nexport function classifyTweenPropertyGroup(\n  properties: Record<string, unknown>,\n): PropertyGroupName | undefined {\n  const groups = new Set<PropertyGroupName>();\n  for (const key of Object.keys(properties)) {\n    // transformOrigin is a modifier; `_auto` is Studio's internal endpoint marker;\n    // `data` is GSAP-reserved (carries the Studio hold-set tag). None is an animated\n    // property, so none should affect the group.\n    if (key === \"transformOrigin\" || key === \"_auto\" || key === \"data\") continue;\n    const g = classifyPropertyGroup(key);\n    groups.add(g);\n  }\n  if (groups.size === 1) return groups.values().next().value;\n  return undefined;\n}\n\nexport const SUPPORTED_EASES = [\n  \"none\",\n  \"power1.in\",\n  \"power1.out\",\n  \"power1.inOut\",\n  \"power2.in\",\n  \"power2.out\",\n  \"power2.inOut\",\n  \"power3.in\",\n  \"power3.out\",\n  \"power3.inOut\",\n  \"power4.in\",\n  \"power4.out\",\n  \"power4.inOut\",\n  \"back.in\",\n  \"back.out\",\n  \"back.inOut\",\n  \"elastic.in\",\n  \"elastic.out\",\n  \"elastic.inOut\",\n  \"bounce.in\",\n  \"bounce.out\",\n  \"bounce.inOut\",\n  \"expo.in\",\n  \"expo.out\",\n  \"expo.inOut\",\n  \"spring-gentle\",\n  \"spring-bouncy\",\n  \"spring-stiff\",\n  \"spring-wobbly\",\n  \"spring-heavy\",\n  \"steps(1)\",\n];\n"],"mappings":";AAOO,IAAM,kBAAkB;AAAA;AAAA,EAE7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AACF;AAQO,IAAM,kBAAkE;AAAA,EAC7E,UAAU,oBAAI,IAAI,CAAC,KAAK,KAAK,YAAY,UAAU,CAAC;AAAA,EACpD,OAAO,oBAAI,IAAI,CAAC,SAAS,UAAU,QAAQ,CAAC;AAAA,EAC5C,MAAM,oBAAI,IAAI,CAAC,SAAS,QAAQ,CAAC;AAAA,EACjC,UAAU,oBAAI,IAAI,CAAC,YAAY,SAAS,OAAO,CAAC;AAAA,EAChD,QAAQ,oBAAI,IAAI,CAAC,WAAW,WAAW,CAAC;AAAA,EACxC,OAAO,oBAAI,IAAY;AACzB;AAEA,IAAM,gBAAgB,oBAAI,IAA+B;AACzD,WAAW,CAAC,OAAO,KAAK,KAAK,OAAO,QAAQ,eAAe,GAGtD;AACH,aAAW,KAAK,MAAO,eAAc,IAAI,GAAG,KAAK;AACnD;AAEO,SAAS,sBAAsB,MAAiC;AACrE,SAAO,cAAc,IAAI,IAAI,KAAK;AACpC;AAEO,SAAS,2BACd,YAC+B;AAC/B,QAAM,SAAS,oBAAI,IAAuB;AAC1C,aAAW,OAAO,OAAO,KAAK,UAAU,GAAG;AAIzC,QAAI,QAAQ,qBAAqB,QAAQ,WAAW,QAAQ,OAAQ;AACpE,UAAM,IAAI,sBAAsB,GAAG;AACnC,WAAO,IAAI,CAAC;AAAA,EACd;AACA,MAAI,OAAO,SAAS,EAAG,QAAO,OAAO,OAAO,EAAE,KAAK,EAAE;AACrD,SAAO;AACT;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}
+{"version":3,"sources":["../src/gsapConstants.ts"],"sourcesContent":["/**\n * GSAP property and ease constants.\n *\n * Extracted into a standalone module so browser code can import them\n * without pulling in gsapParser (which depends on recast / @babel/parser).\n */\n\nexport const SUPPORTED_PROPS = [\n  // 2D Transforms\n  \"x\",\n  \"y\",\n  \"scale\",\n  \"scaleX\",\n  \"scaleY\",\n  \"rotation\",\n  \"skewX\",\n  \"skewY\",\n  // 3D Transforms\n  \"z\",\n  \"rotationX\",\n  \"rotationY\",\n  \"rotationZ\",\n  \"perspective\",\n  \"transformPerspective\",\n  \"transformOrigin\",\n  // Visibility\n  \"opacity\",\n  \"visibility\",\n  \"autoAlpha\",\n  // Dimensions\n  \"width\",\n  \"height\",\n  // Colors\n  \"color\",\n  \"backgroundColor\",\n  \"borderColor\",\n  // Box model\n  \"borderRadius\",\n  // Typography\n  \"fontSize\",\n  \"letterSpacing\",\n  // Filter & Clipping\n  \"filter\",\n  \"clipPath\",\n  // DOM content (number counters, text roll-ups)\n  \"innerText\",\n];\n\n// ── Property Groups ─────────────────────────────────────────────────────────\n// Each group maps to an independent GSAP tween so editing one property\n// (e.g. drag → x/y) never contaminates another (e.g. scale, rotation).\n\nexport type PropertyGroupName = \"position\" | \"scale\" | \"size\" | \"rotation\" | \"visual\" | \"other\";\n\nexport const PROPERTY_GROUPS: Record<PropertyGroupName, ReadonlySet<string>> = {\n  position: new Set([\"x\", \"y\", \"xPercent\", \"yPercent\"]),\n  scale: new Set([\"scale\", \"scaleX\", \"scaleY\"]),\n  size: new Set([\"width\", \"height\"]),\n  rotation: new Set([\"rotation\", \"skewX\", \"skewY\"]),\n  visual: new Set([\"opacity\", \"autoAlpha\"]),\n  other: new Set<string>(),\n};\n\nconst PROP_TO_GROUP = new Map<string, PropertyGroupName>();\nfor (const [group, props] of Object.entries(PROPERTY_GROUPS) as [\n  PropertyGroupName,\n  ReadonlySet<string>,\n][]) {\n  for (const p of props) PROP_TO_GROUP.set(p, group);\n}\n\nexport function classifyPropertyGroup(prop: string): PropertyGroupName {\n  return PROP_TO_GROUP.get(prop) ?? \"other\";\n}\n\nexport function classifyTweenPropertyGroup(\n  properties: Record<string, unknown>,\n): PropertyGroupName | undefined {\n  const groups = new Set<PropertyGroupName>();\n  for (const key of Object.keys(properties)) {\n    // transformOrigin is a modifier; `_auto` is Studio's internal endpoint marker;\n    // `data` is GSAP-reserved (carries the Studio hold-set tag). None is an animated\n    // property, so none should affect the group.\n    if (key === \"transformOrigin\" || key === \"_auto\" || key === \"data\") continue;\n    const g = classifyPropertyGroup(key);\n    groups.add(g);\n  }\n  if (groups.size === 1) return groups.values().next().value;\n  return undefined;\n}\n\nexport const SUPPORTED_EASES = [\n  \"none\",\n  \"power1.in\",\n  \"power1.out\",\n  \"power1.inOut\",\n  \"power2.in\",\n  \"power2.out\",\n  \"power2.inOut\",\n  \"power3.in\",\n  \"power3.out\",\n  \"power3.inOut\",\n  \"power4.in\",\n  \"power4.out\",\n  \"power4.inOut\",\n  \"back.in\",\n  \"back.out\",\n  \"back.inOut\",\n  \"elastic.in\",\n  \"elastic.out\",\n  \"elastic.inOut\",\n  \"bounce.in\",\n  \"bounce.out\",\n  \"bounce.inOut\",\n  \"circ.inOut\",\n  \"expo.in\",\n  \"expo.out\",\n  \"expo.inOut\",\n  \"elastic.out(1,0.3)\",\n  \"elastic.inOut(1,0.3)\",\n  \"spring-gentle\",\n  \"spring-bouncy\",\n  \"spring-stiff\",\n  \"spring-wobbly\",\n  \"spring-heavy\",\n  \"hold\",\n  \"steps(1)\",\n];\n"],"mappings":";AAOO,IAAM,kBAAkB;AAAA;AAAA,EAE7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA;AAAA,EAEA;AACF;AAQO,IAAM,kBAAkE;AAAA,EAC7E,UAAU,oBAAI,IAAI,CAAC,KAAK,KAAK,YAAY,UAAU,CAAC;AAAA,EACpD,OAAO,oBAAI,IAAI,CAAC,SAAS,UAAU,QAAQ,CAAC;AAAA,EAC5C,MAAM,oBAAI,IAAI,CAAC,SAAS,QAAQ,CAAC;AAAA,EACjC,UAAU,oBAAI,IAAI,CAAC,YAAY,SAAS,OAAO,CAAC;AAAA,EAChD,QAAQ,oBAAI,IAAI,CAAC,WAAW,WAAW,CAAC;AAAA,EACxC,OAAO,oBAAI,IAAY;AACzB;AAEA,IAAM,gBAAgB,oBAAI,IAA+B;AACzD,WAAW,CAAC,OAAO,KAAK,KAAK,OAAO,QAAQ,eAAe,GAGtD;AACH,aAAW,KAAK,MAAO,eAAc,IAAI,GAAG,KAAK;AACnD;AAEO,SAAS,sBAAsB,MAAiC;AACrE,SAAO,cAAc,IAAI,IAAI,KAAK;AACpC;AAEO,SAAS,2BACd,YAC+B;AAC/B,QAAM,SAAS,oBAAI,IAAuB;AAC1C,aAAW,OAAO,OAAO,KAAK,UAAU,GAAG;AAIzC,QAAI,QAAQ,qBAAqB,QAAQ,WAAW,QAAQ,OAAQ;AACpE,UAAM,IAAI,sBAAsB,GAAG;AACnC,WAAO,IAAI,CAAC;AAAA,EACd;AACA,MAAI,OAAO,SAAS,EAAG,QAAO,OAAO,OAAO,EAAE,KAAK,EAAE;AACrD,SAAO;AACT;AAEO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/gsapParser.d.ts

@@ -77,10 +77,9 @@ declare function removeKeyframeFromScript(script: string, animationId: string, p
 /**
  * Retime a keyframe: move the keyframe at `fromPercentage` to `toPercentage`,
  * PRESERVING its properties and per-keyframe ease (the Studio "Move to Playhead"
- * gesture). Re-sorts keyframes by percentage. If a keyframe already exists at
- * `toPercentage`, it is overwritten by the moved one (no duplicate). No-op when
- * the animation/keyframe isn't found, the tween has no object-form keyframes, or
- * the move resolves onto the same keyframe. Acorn twin: moveKeyframeInScript.
+ * gesture). Re-sorts keyframes by percentage. No-op when the animation/keyframe
+ * isn't found, the tween has no object-form keyframes, the move resolves onto the
+ * same keyframe, or the destination is occupied. Acorn twin: moveKeyframeInScript.
  */
 declare function moveKeyframeInScript(script: string, animationId: string, fromPercentage: number, toPercentage: number): string;
 /**

package/dist/gsapParser.js

@@ -91,18 +91,39 @@ var SUPPORTED_EASES = [
   "bounce.in",
   "bounce.out",
   "bounce.inOut",
+  "circ.inOut",
   "expo.in",
   "expo.out",
   "expo.inOut",
+  "elastic.out(1,0.3)",
+  "elastic.inOut(1,0.3)",
   "spring-gentle",
   "spring-bouncy",
   "spring-stiff",
   "spring-wobbly",
   "spring-heavy",
+  "hold",
   "steps(1)"
 ];
 
 // src/gsapSerialize.ts
+function mergePercentageKeyframes(keyframes) {
+  const byPercentage = /* @__PURE__ */ new Map();
+  for (const keyframe of keyframes) {
+    const existing = byPercentage.get(keyframe.percentage);
+    if (!existing) {
+      byPercentage.set(keyframe.percentage, {
+        ...keyframe,
+        properties: { ...keyframe.properties }
+      });
+      continue;
+    }
+    existing.properties = { ...existing.properties, ...keyframe.properties };
+    if (keyframe.ease !== void 0) existing.ease = keyframe.ease;
+    if (keyframe.auto !== void 0) existing.auto = keyframe.auto;
+  }
+  return [...byPercentage.values()].sort((a, b) => a.percentage - b.percentage);
+}
 function serializeGsapAnimations(animations, timelineVar = "tl", options) {
   const sorted = [...animations].sort((a, b) => {
     const aNum = a.resolvedStart ?? (typeof a.position === "number" ? a.position : Number.MAX_SAFE_INTEGER);
@@ -330,6 +351,61 @@ function resolveConversionProps(anim, resolvedFromValues) {
   return { fromProps: { ...anim.fromProperties ?? {} }, toProps };
 }
 
+// src/gsapObjectArrayTiming.ts
+var roundPercentage = (percentage) => Math.round(percentage * 10) / 10;
+var OBJECT_ARRAY_PERCENTAGE_TOLERANCE = 2;
+function getObjectArrayKeyframeTiming(durations) {
+  const hasAuthoredDuration = durations.some((duration) => duration !== void 0);
+  if (hasAuthoredDuration) {
+    if (!durations.every(
+      (duration) => typeof duration === "number" && Number.isFinite(duration) && duration > 0
+    )) {
+      return null;
+    }
+    const totalDuration = durations.reduce((sum, duration) => sum + duration, 0);
+    let cumulative = 0;
+    return {
+      percentages: durations.map((duration) => {
+        cumulative += duration;
+        return roundPercentage(cumulative / totalDuration * 100);
+      }),
+      totalDuration
+    };
+  }
+  const lastIndex = durations.length - 1;
+  return {
+    percentages: durations.map(
+      (_, index) => lastIndex > 0 ? roundPercentage(index / lastIndex * 100) : 0
+    )
+  };
+}
+function getCompatibleObjectArrayKeyframeTiming(durations, outerDuration) {
+  const timing = getObjectArrayKeyframeTiming(durations);
+  if (!timing) return null;
+  if (timing.totalDuration === void 0 || outerDuration === void 0) return timing;
+  if (typeof outerDuration === "number" && Math.abs(outerDuration - timing.totalDuration) <= Number.EPSILON) {
+    return timing;
+  }
+  return null;
+}
+function findObjectArrayKeyframeIndex(durations, percentage, options) {
+  if (!Number.isFinite(percentage) || percentage < 0 || percentage > 100) return null;
+  const timing = getObjectArrayKeyframeTiming(durations);
+  if (!timing) return null;
+  const { percentages } = timing;
+  let match = null;
+  let bestDistance = Number.POSITIVE_INFINITY;
+  for (let index = 0; index < percentages.length; index++) {
+    const distance = Math.abs(percentages[index] - percentage);
+    if (distance < bestDistance) {
+      match = index;
+      bestDistance = distance;
+    }
+  }
+  const tolerance = options?.tolerance ?? OBJECT_ARRAY_PERCENTAGE_TOLERANCE;
+  return bestDistance <= tolerance || options?.fallbackToNearest ? match : null;
+}
+
 // src/springEase.ts
 var SPRING_PRESETS = [
   { name: "spring-gentle", label: "Gentle", mass: 1, stiffness: 100, damping: 15 },
@@ -776,6 +852,8 @@ function parsePercentageKeyframes(node, scope) {
       for (const [k, v] of Object.entries(record)) {
         if (k === "ease" && typeof v === "string") {
           kfEase = v;
+        } else if (k === "duration") {
+          continue;
         } else if (typeof v === "number" || typeof v === "string") {
           properties[k] = v;
         }
@@ -800,13 +878,13 @@ function computeKeyframesTotalDuration(varsNode, scope) {
     (p) => (p.key?.name ?? p.key?.value) === "keyframes"
   )?.value;
   if (!kfNode || kfNode.type !== "ArrayExpression") return void 0;
-  let total = 0;
+  const durations = [];
   for (const el of kfNode.elements ?? []) {
     if (!el || el.type !== "ObjectExpression") continue;
     const r = objectExpressionToRecord(el, scope);
-    if (typeof r.duration === "number") total += r.duration;
+    durations.push(r.duration);
   }
-  return total > 0 ? total : void 0;
+  return getObjectArrayKeyframeTiming(durations)?.totalDuration;
 }
 function parseObjectArrayKeyframes(node, scope) {
   const elements = node.elements ?? [];
@@ -820,7 +898,7 @@ function parseObjectArrayKeyframes(node, scope) {
     let duration;
     let ease;
     for (const [k, v] of Object.entries(record)) {
-      if (k === "duration" && typeof v === "number") {
+      if (k === "duration") {
         duration = v;
       } else if (k === "ease" && typeof v === "string") {
         ease = v;
@@ -830,30 +908,16 @@ function parseObjectArrayKeyframes(node, scope) {
     }
     raw.push({ properties, duration, ease });
   }
-  const totalDuration = raw.reduce((sum, r) => sum + (r.duration ?? 0), 0);
-  const keyframes = [];
-  if (totalDuration > 0) {
-    let cumulative = 0;
-    for (const entry of raw) {
-      cumulative += entry.duration ?? 0;
-      const percentage = Math.round(cumulative / totalDuration * 100);
-      keyframes.push({
-        percentage,
-        properties: entry.properties,
-        ...entry.ease ? { ease: entry.ease } : {}
-      });
-    }
-  } else {
-    for (let i = 0; i < raw.length; i++) {
-      const entry = raw[i];
-      const percentage = raw.length > 1 ? Math.round(i / (raw.length - 1) * 100) : 0;
-      keyframes.push({
-        percentage,
-        properties: entry.properties,
-        ...entry.ease ? { ease: entry.ease } : {}
-      });
-    }
-  }
+  const timing = getObjectArrayKeyframeTiming(raw.map((entry) => entry.duration));
+  if (!timing) return void 0;
+  const { percentages } = timing;
+  const keyframes = raw.map(
+    (entry, index) => ({
+      percentage: percentages[index],
+      properties: entry.properties,
+      ...entry.ease ? { ease: entry.ease } : {}
+    })
+  );
   return { format: "object-array", keyframes };
 }
 function parseSimpleArrayKeyframes(node, scope) {
@@ -1680,7 +1744,7 @@ function keyframePropsToCode(kf) {
   return Object.entries(kf.properties).map(([k, v]) => `${safeJsKey(k)}: ${serializeValue(v)}`);
 }
 function buildKeyframeObjectCode(keyframes, options) {
-  const entries = keyframes.map((kf) => {
+  const entries = mergePercentageKeyframes(keyframes).map((kf) => {
     const props = keyframePropsToCode(kf);
     if (kf.ease) props.push(`ease: ${JSON.stringify(kf.ease)}`);
     if (kf.auto) props.push(`_auto: 1`);
@@ -1719,6 +1783,17 @@ function buildKeyframeValueNode(properties, ease) {
   if (effectiveEase) entries.push(`ease: ${JSON.stringify(effectiveEase)}`);
   return parseExpr(`{ ${entries.join(", ")} }`);
 }
+function setObjectExpressionEase(node, ease) {
+  if (node?.type !== "ObjectExpression") return false;
+  const props = node.properties ?? [];
+  const easeIdx = props.findIndex(
+    (property) => isObjectProperty(property) && propKeyName(property) === "ease"
+  );
+  const easeNode = parseExpr(`({ ease: ${JSON.stringify(ease)} })`).properties[0];
+  if (easeIdx >= 0) props[easeIdx] = easeNode;
+  else props.push(easeNode);
+  return true;
+}
 function locateAnimation(script, animationId) {
   let parsed;
   try {
@@ -1765,7 +1840,7 @@ function findKeyframesObjectNode(varsArg) {
   const node = findPropertyNode(varsArg, "keyframes");
   return node?.type === "ObjectExpression" ? node : null;
 }
-function convertArrayKeyframesToObjectNode(varsArg) {
+function convertArrayKeyframesToObjectNode(varsArg, scope) {
   if (varsArg?.type !== "ObjectExpression") return null;
   const prop = (varsArg.properties ?? []).find(
     (p) => isObjectProperty(p) && propKeyName(p) === "keyframes"
@@ -1774,11 +1849,22 @@ function convertArrayKeyframesToObjectNode(varsArg) {
   const els = (prop.value.elements ?? []).filter(
     (e) => !!e && e.type === "ObjectExpression"
   );
-  const n = els.length;
-  if (n === 0) return null;
+  if (els.length === 0) return null;
+  const records = els.map((element) => objectExpressionToRecord(element, scope));
+  const outerDuration = objectExpressionToRecord(varsArg, scope).duration;
+  const timing = getCompatibleObjectArrayKeyframeTiming(
+    records.map((record) => record.duration),
+    outerDuration
+  );
+  if (!timing) return null;
+  if (timing.totalDuration !== void 0 && findPropertyNode(varsArg, "duration") === void 0) {
+    setVarsKey(varsArg, "duration", timing.totalDuration);
+  }
   const entries = els.map((el, i) => {
-    const pct = n > 1 ? Math.round(i / (n - 1) * 1e3) / 10 : 0;
-    return `${JSON.stringify(`${pct}%`)}: ${recast.print(el).code}`;
+    el.properties = (el.properties ?? []).filter(
+      (property) => !isObjectProperty(property) || propKeyName(property) !== "duration"
+    );
+    return `${JSON.stringify(`${timing.percentages[i]}%`)}: ${recast.print(el).code}`;
   });
   prop.value = parseExpr(`{ ${entries.join(", ")} }`);
   return prop.value;
@@ -1809,7 +1895,9 @@ function addKeyframeToScript(script, animationId, percentage, properties, ease,
   let loc = locateAnimationWithFallback(script, animationId);
   if (!loc) return script;
   let kfNode = findKeyframesObjectNode(loc.target.call.varsArg);
-  if (!kfNode) kfNode = convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
+  if (!kfNode) {
+    kfNode = convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
+  }
   if (!kfNode) {
     script = convertToKeyframesInScript(script, animationId);
     loc = locateAnimationWithFallback(script, animationId);
@@ -1894,19 +1982,12 @@ function removeKeyframeFromScript(script, animationId, percentage) {
     const elements = (arrVal.elements ?? []).filter(
       (e) => !!e && e.type === "ObjectExpression"
     );
-    const n = elements.length;
-    if (n === 0) return script;
-    let matchIdx = -1;
-    let bestDist = Number.POSITIVE_INFINITY;
-    for (let i = 0; i < n; i++) {
-      const pct = n > 1 ? i / (n - 1) * 100 : 0;
-      const dist = Math.abs(pct - percentage);
-      if (dist <= PCT_TOLERANCE && dist < bestDist) {
-        matchIdx = i;
-        bestDist = dist;
-      }
-    }
-    if (matchIdx === -1) return script;
+    if (elements.length === 0) return script;
+    const durations = elements.map(
+      (element) => objectExpressionToRecord(element, arrLoc.parsed.scope).duration
+    );
+    const matchIdx = findObjectArrayKeyframeIndex(durations, percentage);
+    if (matchIdx === null) return script;
     const remaining = elements.filter((_, i) => i !== matchIdx);
     if (remaining.length < 2) {
       const sole = remaining[0];
@@ -1935,18 +2016,17 @@ function removeKeyframeFromScript(script, animationId, percentage) {
 function moveKeyframeInScript(script, animationId, fromPercentage, toPercentage) {
   const loc = locateAnimationWithFallback(script, animationId);
   if (!loc) return script;
-  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg) ?? convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
+  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg) ?? convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
   if (!kfNode) return script;
   const match = findKeyframePropByPct(kfNode, fromPercentage);
   if (!match) return script;
   if (Math.abs(fromPercentage - toPercentage) < MOVE_NOOP_EPSILON_PCT) return script;
   const dest = findKeyframePropByPct(kfNode, toPercentage);
-  const collision = dest && dest.prop !== match.prop ? dest : null;
+  if (dest && dest.prop !== match.prop) return script;
   const movedValue = match.prop.value;
   const entries = [];
   for (const prop of filterPercentageProps(kfNode)) {
     if (prop === match.prop) continue;
-    if (collision && prop === collision.prop) continue;
     const pct = percentageFromKey(propKeyName(prop) ?? "");
     if (Number.isNaN(pct)) continue;
     entries.push({ pct, value: prop.value });
@@ -1963,7 +2043,7 @@ function moveKeyframeInScript(script, animationId, fromPercentage, toPercentage)
 function resizeKeyframedTweenInScript(script, animationId, newPosition, newDuration, pctRemap) {
   const loc = locateAnimationWithFallback(script, animationId);
   if (!loc) return script;
-  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg) ?? convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
+  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg) ?? convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
   if (!kfNode) return script;
   const seen = /* @__PURE__ */ new Set();
   for (const { from, to } of pctRemap) {
@@ -1972,7 +2052,12 @@ function resizeKeyframedTweenInScript(script, animationId, newPosition, newDurat
     seen.add(match.prop);
     match.prop.key = parseExpr(`{ ${JSON.stringify(`${to}%`)}: 0 }`).properties[0].key;
   }
-  applyUpdatesToCall(loc.target.call, { position: newPosition, duration: newDuration });
+  applyUpdatesToCall(loc.target.call, {
+    position: newPosition,
+    // Resizing is an explicit duration-authoring gesture. Promote GSAP's
+    // implicit default so the dragged window is the window that plays.
+    duration: newDuration
+  });
   return recast.print(loc.parsed.ast).code;
 }
 function updateKeyframeInScript(script, animationId, percentage, properties, ease) {
@@ -1982,41 +2067,63 @@ function updateKeyframeInScript(script, animationId, percentage, properties, eas
     const elements = (arrVal.elements ?? []).filter(
       (e) => !!e && e.type === "ObjectExpression"
     );
-    const n = elements.length;
-    if (n === 0) return script;
-    let matchIdx = -1;
-    let bestDist = Number.POSITIVE_INFINITY;
-    for (let i = 0; i < n; i++) {
-      const pct = n > 1 ? i / (n - 1) * 100 : 0;
-      const dist = Math.abs(pct - percentage);
-      if (dist <= PCT_TOLERANCE && dist < bestDist) {
-        matchIdx = i;
-        bestDist = dist;
-      }
-    }
-    if (matchIdx === -1) return script;
-    const realIdx = arrVal.elements.indexOf(elements[matchIdx]);
-    arrVal.elements[realIdx] = buildKeyframeValueNode(properties, ease);
+    if (elements.length === 0) return script;
+    const records = elements.map(
+      (element) => objectExpressionToRecord(element, arrLoc.parsed.scope)
+    );
+    const matchIdx = findObjectArrayKeyframeIndex(
+      records.map((record) => record.duration),
+      percentage,
+      { fallbackToNearest: true }
+    );
+    if (matchIdx === null) return script;
+    const matchEl = elements[matchIdx];
+    if (!matchEl) return script;
+    const realIdx = arrVal.elements.indexOf(matchEl);
+    if (Object.keys(properties).length === 0 && ease && setObjectExpressionEase(matchEl, ease)) {
+      return recast.print(arrLoc.parsed.ast).code;
+    }
+    const merged = {};
+    for (const [key, value] of Object.entries(records[matchIdx] ?? {})) {
+      if (typeof value === "number" || typeof value === "string") merged[key] = value;
+    }
+    Object.assign(merged, properties);
+    arrVal.elements[realIdx] = buildKeyframeValueNode(merged, ease);
     return recast.print(arrLoc.parsed.ast).code;
   }
+  if (arrLoc && !arrVal && arrLoc.target.animation.arcPath?.enabled) {
+    const propertyKeys = Object.keys(properties);
+    if (propertyKeys.some((key) => key !== "x" && key !== "y")) return script;
+    let next = script;
+    if (propertyKeys.length > 0) {
+      const waypoints = extractArcWaypoints(arrLoc.target.animation);
+      if (waypoints.length < 2) return script;
+      const pointIndex = Math.max(
+        0,
+        Math.min(waypoints.length - 1, Math.round(percentage / 100 * (waypoints.length - 1)))
+      );
+      const current = waypoints[pointIndex];
+      if (!current) return script;
+      const x = properties.x ?? current.x;
+      const y = properties.y ?? current.y;
+      if (typeof x !== "number" || typeof y !== "number") return script;
+      next = updateMotionPathPointInScript(next, animationId, pointIndex, { x, y });
+    }
+    if (ease !== void 0) {
+      const updated = locateAnimationWithFallback(next, animationId);
+      if (!updated) return script;
+      applyUpdatesToCall(updated.target.call, { ease });
+      next = recast.print(updated.parsed.ast).code;
+    }
+    return next;
+  }
   const ctx = locateKeyframeCtx(script, animationId, percentage);
   if (!ctx) return script;
   const { loc, kfNode } = ctx;
   const match = findKeyframePropByPct(kfNode, percentage);
   if (!match) return script;
   if (Object.keys(properties).length === 0 && ease) {
-    const existing2 = match.prop.value;
-    if (existing2?.type === "ObjectExpression") {
-      const props = existing2.properties ?? [];
-      const easeIdx = props.findIndex(
-        (p) => isObjectProperty(p) && propKeyName(p) === "ease"
-      );
-      const easeNode = parseExpr(`({ ease: ${JSON.stringify(ease)} })`).properties[0];
-      if (easeIdx >= 0) {
-        props[easeIdx] = easeNode;
-      } else {
-        props.push(easeNode);
-      }
+    if (setObjectExpressionEase(match.prop.value, ease)) {
       return recast.print(loc.parsed.ast).code;
     }
     return script;
@@ -2089,13 +2196,21 @@ function convertToKeyframesInScript(script, animationId, resolvedFromValues, set
 function removeAllKeyframesFromScript(script, animationId) {
   let loc = locateAnimationWithFallback(script, animationId);
   if (!loc) return script;
-  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg) ?? convertArrayKeyframesToObjectNode(loc.target.call.varsArg);
-  if (!kfNode) return script;
-  const kfEntries = filterPercentageProps(kfNode).map((p) => ({ pct: percentageFromKey(propKeyName(p)), prop: p })).filter((e) => !Number.isNaN(e.pct)).sort((a, b) => a.pct - b.pct);
-  if (kfEntries.length === 0) return script;
+  const kfNode = findKeyframesObjectNode(loc.target.call.varsArg) ?? convertArrayKeyframesToObjectNode(loc.target.call.varsArg, loc.parsed.scope);
   const method = loc.target.call.method;
-  const collapseEntry = method === "from" ? kfEntries[0] : kfEntries[kfEntries.length - 1];
-  const record = objectExpressionToRecord(collapseEntry.prop.value, loc.parsed.scope);
+  let record;
+  if (kfNode) {
+    const kfEntries = filterPercentageProps(kfNode).map((p) => ({ pct: percentageFromKey(propKeyName(p)), prop: p })).filter((e) => !Number.isNaN(e.pct)).sort((a, b) => a.pct - b.pct);
+    if (kfEntries.length === 0) return script;
+    const collapseEntry = method === "from" ? kfEntries[0] : kfEntries[kfEntries.length - 1];
+    record = objectExpressionToRecord(collapseEntry.prop.value, loc.parsed.scope);
+  } else {
+    const synthetic = loc.target.animation.arcPath?.enabled ? loc.target.animation.keyframes?.keyframes : void 0;
+    if (!synthetic?.length) return script;
+    const sorted = [...synthetic].sort((a, b) => a.percentage - b.percentage);
+    record = (method === "from" ? sorted[0] : sorted[sorted.length - 1]).properties;
+    removeVarsKey(loc.target.call.varsArg, "motionPath");
+  }
   collapseKeyframesToFlat(loc.target.call.varsArg, record);
   removeVarsKey(loc.target.call.varsArg, "ease");
   setVarsKey(loc.target.call.varsArg, "duration", 0);