@hyperframes/studio-server 0.7.63 → 0.7.65

package/dist/helpers/draftMarkers.d.ts

@@ -1,12 +1 @@
-/**
- * Draft-marker constants shared between core's PreviewAdapter and Studio's
- * manual-edits code. CSS custom properties written during a drag gesture, plus
- * the gesture marker attribute. Exported from @hyperframes/core/studio-api/draft-markers.
- */
-declare const STUDIO_OFFSET_X_PROP = "--hf-studio-offset-x";
-declare const STUDIO_OFFSET_Y_PROP = "--hf-studio-offset-y";
-declare const STUDIO_WIDTH_PROP = "--hf-studio-width";
-declare const STUDIO_HEIGHT_PROP = "--hf-studio-height";
-declare const STUDIO_MANUAL_EDIT_GESTURE_ATTR = "data-hf-studio-manual-edit-gesture";
-
-export { STUDIO_HEIGHT_PROP, STUDIO_MANUAL_EDIT_GESTURE_ATTR, STUDIO_OFFSET_X_PROP, STUDIO_OFFSET_Y_PROP, STUDIO_WIDTH_PROP };
+export * from '@hyperframes/core/editing/draft-markers';

package/dist/helpers/draftMarkers.js

@@ -1,14 +1,3 @@
 // src/helpers/draftMarkers.ts
-var STUDIO_OFFSET_X_PROP = "--hf-studio-offset-x";
-var STUDIO_OFFSET_Y_PROP = "--hf-studio-offset-y";
-var STUDIO_WIDTH_PROP = "--hf-studio-width";
-var STUDIO_HEIGHT_PROP = "--hf-studio-height";
-var STUDIO_MANUAL_EDIT_GESTURE_ATTR = "data-hf-studio-manual-edit-gesture";
-export {
-  STUDIO_HEIGHT_PROP,
-  STUDIO_MANUAL_EDIT_GESTURE_ATTR,
-  STUDIO_OFFSET_X_PROP,
-  STUDIO_OFFSET_Y_PROP,
-  STUDIO_WIDTH_PROP
-};
+export * from "@hyperframes/core/editing/draft-markers";
 //# sourceMappingURL=draftMarkers.js.map

package/dist/helpers/draftMarkers.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/helpers/draftMarkers.ts"],"sourcesContent":["/**\n * Draft-marker constants shared between core's PreviewAdapter and Studio's\n * manual-edits code. CSS custom properties written during a drag gesture, plus\n * the gesture marker attribute. Exported from @hyperframes/core/studio-api/draft-markers.\n */\nexport const STUDIO_OFFSET_X_PROP = \"--hf-studio-offset-x\";\nexport const STUDIO_OFFSET_Y_PROP = \"--hf-studio-offset-y\";\nexport const STUDIO_WIDTH_PROP = \"--hf-studio-width\";\nexport const STUDIO_HEIGHT_PROP = \"--hf-studio-height\";\nexport const STUDIO_MANUAL_EDIT_GESTURE_ATTR = \"data-hf-studio-manual-edit-gesture\";\n"],"mappings":";AAKO,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAC7B,IAAM,oBAAoB;AAC1B,IAAM,qBAAqB;AAC3B,IAAM,kCAAkC;","names":[]}
+{"version":3,"sources":["../../src/helpers/draftMarkers.ts"],"sourcesContent":["/**\n * Compatibility export for server consumers. The edit-protocol constants are\n * owned by core's dependency-free browser contract.\n */\nexport * from \"@hyperframes/core/editing/draft-markers\";\n"],"mappings":";AAIA,cAAc;","names":[]}

package/dist/index.js

@@ -646,13 +646,18 @@ import {
   unrollDynamicAnimations,
   setArcPathInScript,
   updateArcSegmentInScript,
+  updateMotionPathPointInScript,
+  addMotionPathPointInScript,
+  removeMotionPathPointInScript,
+  addMotionPathToScript,
   removeArcPathFromScript,
   addAnimationWithKeyframesToScript,
   splitAnimationsInScript,
   splitIntoPropertyGroupsFromScript,
   shiftPositionsInScript,
   scalePositionsInScript,
-  dedupePositionWritesInScript
+  dedupePositionWritesInScript,
+  syncPositionHoldsBeforeKeyframes
 } from "@hyperframes/parsers/gsap-writer-acorn";
 import { parseHTML as parseHTML2 } from "linkedom";
 
@@ -843,11 +848,69 @@ function insertCompositionIntoSource(input) {
   return { html: document.toString(), hostId, track, duration };
 }
 
-// src/routes/files.ts
-function isAcornGsapWriterEnabled() {
-  const val = process.env["STUDIO_SDK_CUTOVER_ENABLED"];
-  return val === "true" || val === "1";
+// src/routes/gsapMutationCapabilities.ts
+var differential = (family) => ({
+  family,
+  acorn: "supported",
+  recast: "supported",
+  parity: "differential"
+});
+var behavioral = (family) => ({
+  family,
+  acorn: "supported",
+  recast: "supported",
+  parity: "behavioral"
+});
+var GSAP_MUTATION_CAPABILITIES = {
+  "update-property": differential("animation"),
+  "update-properties": differential("animation"),
+  "update-from-property": differential("animation"),
+  "update-meta": differential("animation"),
+  add: differential("animation"),
+  delete: differential("animation"),
+  "add-property": differential("animation"),
+  "add-from-property": differential("animation"),
+  "remove-property": differential("animation"),
+  "remove-from-property": differential("animation"),
+  "add-keyframe": differential("keyframe"),
+  "remove-keyframe": differential("keyframe"),
+  "move-keyframe": behavioral("keyframe"),
+  "resize-keyframed-tween": behavioral("keyframe"),
+  "update-keyframe": differential("keyframe"),
+  "convert-to-keyframes": behavioral("keyframe"),
+  "remove-all-keyframes": behavioral("keyframe"),
+  "materialize-keyframes": behavioral("keyframe"),
+  "set-arc-path": behavioral("motion_path"),
+  "update-arc-segment": behavioral("motion_path"),
+  "update-motion-path-point": differential("motion_path"),
+  "add-motion-path-point": differential("motion_path"),
+  "remove-motion-path-point": differential("motion_path"),
+  "add-motion-path": differential("motion_path"),
+  "remove-arc-path": behavioral("motion_path"),
+  "add-with-keyframes": behavioral("keyframe"),
+  "replace-with-keyframes": behavioral("keyframe"),
+  "split-animations": behavioral("structure"),
+  "split-into-property-groups": behavioral("structure"),
+  "delete-all-for-selector": behavioral("structure"),
+  "consolidate-position-writes": behavioral("structure"),
+  "unroll-timeline": behavioral("structure"),
+  "shift-positions": behavioral("timing"),
+  "shift-positions-batch": behavioral("timing"),
+  "scale-positions": behavioral("timing")
+};
+var GSAP_WRITER_MIGRATION = Object.freeze({
+  flag: "HYPERFRAMES_GSAP_WRITER",
+  owner: "studio-foundations",
+  deadline: "2026-09-30",
+  graduationCriteria: "Every operation has differential parity, the Acorn path imports no Recast runtime, and canary divergence is zero for the agreed soak window."
+});
+function resolveGsapWriter(env) {
+  const configured = env.HYPERFRAMES_GSAP_WRITER ?? "recast";
+  if (configured === "recast" || configured === "acorn") return configured;
+  throw new Error(`Invalid ${GSAP_WRITER_MIGRATION.flag}=${configured}; expected recast or acorn`);
 }
+
+// src/routes/files.ts
 async function loadGsapParser() {
   return import("@hyperframes/parsers/gsap-parser-recast");
 }
@@ -1318,8 +1381,8 @@ var HOLD_SYNC_MUTATION_TYPES = /* @__PURE__ */ new Set([
   "delete",
   "delete-all-for-selector"
 ]);
-async function executeGsapMutation(body, block, respond) {
-  if (!isAcornGsapWriterEnabled()) {
+async function executeGsapMutation(body, block, respond, writer) {
+  if (writer === "recast") {
     return executeGsapMutationRecast(body, block, respond);
   }
   return executeGsapMutationAcorn(body, block, respond);
@@ -1380,16 +1443,23 @@ async function applyGsapMutations(c, res, mutations) {
   const initialScript = block.scriptText;
   const skippedSelectors = /* @__PURE__ */ new Set();
   const respond = (data, status) => status ? c.json(data, status) : c.json(data);
+  let writer;
+  try {
+    writer = resolveGsapWriter({
+      HYPERFRAMES_GSAP_WRITER: process.env["HYPERFRAMES_GSAP_WRITER"]
+    });
+  } catch (error) {
+    return c.json({ error: error instanceof Error ? error.message : String(error) }, 400);
+  }
   for (const mutation of mutations) {
-    const result = await executeGsapMutation(mutation, block, respond);
+    const result = await executeGsapMutation(mutation, block, respond, writer);
     if (result instanceof Response) return result;
     let newScript = typeof result === "string" ? result : result.script;
     if (typeof result !== "string") {
       for (const selector of result.skippedSelectors) skippedSelectors.add(selector);
     }
     if (HOLD_SYNC_MUTATION_TYPES.has(mutation.type)) {
-      const parser = await loadGsapParser();
-      newScript = parser.syncPositionHoldsBeforeKeyframes(newScript);
+      newScript = writer === "acorn" ? syncPositionHoldsBeforeKeyframes(newScript) : (await loadGsapParser()).syncPositionHoldsBeforeKeyframes(newScript);
     }
     block.scriptText = newScript;
   }
@@ -1468,6 +1538,12 @@ function executeGsapMutationAcorn(body, block, respond) {
       if (body.fromProperties && body.method !== "fromTo") {
         return respond({ error: "fromProperties is only valid for method=fromTo" }, 400);
       }
+      if (Object.keys(body.properties).some((key) => {
+        const group = classifyPropertyGroup(key);
+        return group === "position" || group === "rotation";
+      })) {
+        stripStudioEditsFromTarget(block.document, body.targetSelector);
+      }
       const result = addAnimationToScript(block.scriptText, {
         targetSelector: body.targetSelector,
         method: body.method,
@@ -1605,10 +1681,38 @@ function executeGsapMutationAcorn(body, block, respond) {
         ...body.cp2 ? { cp2: body.cp2 } : {}
       });
     }
+    case "update-motion-path-point": {
+      return updateMotionPathPointInScript(block.scriptText, body.animationId, body.pointIndex, {
+        x: body.x,
+        y: body.y
+      });
+    }
+    case "add-motion-path-point": {
+      return addMotionPathPointInScript(block.scriptText, body.animationId, body.index, {
+        x: body.x,
+        y: body.y
+      });
+    }
+    case "remove-motion-path-point": {
+      return removeMotionPathPointInScript(block.scriptText, body.animationId, body.index);
+    }
+    case "add-motion-path": {
+      return addMotionPathToScript(
+        block.scriptText,
+        body.targetSelector,
+        body.position,
+        body.duration,
+        { x: body.x, y: body.y },
+        body.ease
+      ).script;
+    }
     case "remove-arc-path": {
       return removeArcPathFromScript(block.scriptText, body.animationId);
     }
     case "add-with-keyframes": {
+      if (keyframesWritePosition(body.keyframes) || keyframesWriteRotation(body.keyframes)) {
+        stripStudioEditsFromTarget(block.document, body.targetSelector);
+      }
       const result = addAnimationWithKeyframesToScript(
         block.scriptText,
         body.targetSelector,
@@ -1621,6 +1725,9 @@ function executeGsapMutationAcorn(body, block, respond) {
       return result.script;
     }
     case "replace-with-keyframes": {
+      if (keyframesWritePosition(body.keyframes) || keyframesWriteRotation(body.keyframes)) {
+        stripStudioEditsFromTarget(block.document, body.targetSelector);
+      }
       const script = removeAnimationFromScript(block.scriptText, body.animationId);
       const added = addAnimationWithKeyframesToScript(
         script,
@@ -1704,10 +1811,10 @@ async function executeGsapMutationRecast(body, block, respond) {
     unrollDynamicAnimations: unrollDynamicAnimations2,
     setArcPathInScript: setArcPathInScript2,
     updateArcSegmentInScript: updateArcSegmentInScript2,
-    updateMotionPathPointInScript,
-    addMotionPathPointInScript,
-    removeMotionPathPointInScript,
-    addMotionPathToScript,
+    updateMotionPathPointInScript: updateMotionPathPointInScript2,
+    addMotionPathPointInScript: addMotionPathPointInScript2,
+    removeMotionPathPointInScript: removeMotionPathPointInScript2,
+    addMotionPathToScript: addMotionPathToScript2,
     removeArcPathFromScript: removeArcPathFromScript2,
     addAnimationWithKeyframesToScript: addAnimationWithKeyframesToScript2,
     splitAnimationsInScript: splitAnimationsInScript2,
@@ -1904,22 +2011,22 @@ async function executeGsapMutationRecast(body, block, respond) {
       });
     }
     case "update-motion-path-point": {
-      return updateMotionPathPointInScript(block.scriptText, body.animationId, body.pointIndex, {
+      return updateMotionPathPointInScript2(block.scriptText, body.animationId, body.pointIndex, {
         x: body.x,
         y: body.y
       });
     }
     case "add-motion-path-point": {
-      return addMotionPathPointInScript(block.scriptText, body.animationId, body.index, {
+      return addMotionPathPointInScript2(block.scriptText, body.animationId, body.index, {
         x: body.x,
         y: body.y
       });
     }
     case "remove-motion-path-point": {
-      return removeMotionPathPointInScript(block.scriptText, body.animationId, body.index);
+      return removeMotionPathPointInScript2(block.scriptText, body.animationId, body.index);
     }
     case "add-motion-path": {
-      const result = addMotionPathToScript(
+      const result = addMotionPathToScript2(
         block.scriptText,
         body.targetSelector,
         body.position,
@@ -1942,7 +2049,8 @@ async function executeGsapMutationRecast(body, block, respond) {
         body.position,
         body.duration,
         body.keyframes,
-        body.ease
+        body.ease,
+        body.easeEach
       );
       return result.script;
     }
@@ -2019,7 +2127,7 @@ async function executeGsapMutationRecast(body, block, respond) {
       return respond({ error: `unknown mutation type: ${body.type}` }, 400);
   }
 }
-async function foldAtomicCutFile(c, file, absPath, before) {
+async function foldAtomicCutFile(c, file, absPath, before, writer) {
   let after = before;
   let splitCount = 0;
   const skippedSelectors = /* @__PURE__ */ new Set();
@@ -2065,7 +2173,8 @@ async function foldAtomicCutFile(c, file, absPath, before) {
         elementDuration: cut.elementDuration
       },
       block,
-      respond
+      respond,
+      writer
     );
     if (result instanceof Response) return result;
     let script = typeof result === "string" ? result : result.script;
@@ -2073,8 +2182,7 @@ async function foldAtomicCutFile(c, file, absPath, before) {
       for (const selector of result.skippedSelectors) skippedSelectors.add(selector);
     }
     if (script !== block.scriptText) {
-      const parser = await loadGsapParser();
-      script = parser.syncPositionHoldsBeforeKeyframes(script);
+      script = writer === "acorn" ? syncPositionHoldsBeforeKeyframes(script) : (await loadGsapParser()).syncPositionHoldsBeforeKeyframes(script);
       after = block.replaceScript(script);
     }
   }
@@ -2364,6 +2472,14 @@ function registerFileRoutes(api, adapter) {
     const files = body.files;
     const project = await adapter.resolveProject(c.req.param("id"));
     if (!project) return c.json({ error: "not found" }, 404);
+    let writer;
+    try {
+      writer = resolveGsapWriter({
+        HYPERFRAMES_GSAP_WRITER: process.env["HYPERFRAMES_GSAP_WRITER"]
+      });
+    } catch (error) {
+      return c.json({ error: error instanceof Error ? error.message : String(error) }, 400);
+    }
     return serializeAtomicCut(async () => {
       const seen = /* @__PURE__ */ new Set();
       const prepared = [];
@@ -2392,7 +2508,7 @@ function registerFileRoutes(api, adapter) {
         }
         let folded;
         try {
-          folded = await foldAtomicCutFile(c, file, absPath, before);
+          folded = await foldAtomicCutFile(c, file, absPath, before, writer);
         } catch (error) {
           const message = error instanceof Error ? error.message : "Cut transform failed";
           return c.json({ error: message }, 400);