@hyperframes/parsers 0.8.27 → 0.8.29

package/dist/index.d.ts

@@ -38,6 +38,8 @@ declare function addElementToHtml(html: string, element: Omit<TimelineElement, "
     html: string;
     id: string;
 };
+/** Remove a source subtree and its unambiguous, directly targeted GSAP tweens. */
+declare function removeElementWithGsapCascade(doc: Document, element: Element): void;
 declare function removeElementFromHtml(html: string, elementId: string): string;
 interface CompositionMetadata {
     compositionId: string | null;
@@ -73,7 +75,7 @@ declare function validateCompositionHtml(html: string): ValidationResult;
  * `core`. The geometry it needs (`CANVAS_DIMENSIONS`) already lives here.
  */
 
-type OutputResolutionIssueKind = "hdr-incompatible" | "alpha-incompatible" | "aspect-mismatch" | "downsampling" | "non-integer-scale";
+type OutputResolutionIssueKind = "hdr-incompatible" | "aspect-mismatch" | "downsampling" | "non-integer-scale";
 interface OutputResolutionCompatibility {
     ok: boolean;
     /** Present when `ok` is false. */
@@ -107,7 +109,7 @@ interface OutputResolutionCompatibility {
 declare function suggestMatchingPreset(compositionWidth: number, compositionHeight: number, chosen: CanvasResolution): CanvasResolution | undefined;
 /**
  * Check whether rendering a composition of the given dimensions with the given
- * `outputResolution` preset (and alpha/HDR modes) is supported.
+ * `outputResolution` preset (and HDR mode) is supported.
  *
  * Pure and dependency-free — the single source of truth for the constraints
  * `resolveDeviceScaleFactor` enforces, so the CLI can run the exact same check
@@ -133,4 +135,4 @@ declare function unrollComputedTimeline(script: string): string;
 
 declare function queryByAttr(root: ParentNode, attr: string, value: string, tag?: string): Element | null;
 
-export { CanvasResolution, CompositionHtmlParseError, type CompositionMetadata, CompositionVariable, Keyframe, type OutputResolutionCompatibility, type OutputResolutionIssueKind, type ParsedHtml, StageZoomKeyframe, TimelineElement, ValidationResult, addElementToHtml, checkOutputResolutionCompatibility, extractCompositionMetadata, parseHtml, queryByAttr, removeElementFromHtml, suggestMatchingPreset, unrollComputedTimeline, updateElementInHtml, validateCompositionHtml };
+export { CanvasResolution, CompositionHtmlParseError, type CompositionMetadata, CompositionVariable, Keyframe, type OutputResolutionCompatibility, type OutputResolutionIssueKind, type ParsedHtml, StageZoomKeyframe, TimelineElement, ValidationResult, addElementToHtml, checkOutputResolutionCompatibility, extractCompositionMetadata, parseHtml, queryByAttr, removeElementFromHtml, removeElementWithGsapCascade, suggestMatchingPreset, unrollComputedTimeline, updateElementInHtml, validateCompositionHtml };

package/dist/index.js

@@ -3179,29 +3179,38 @@ function addElementToHtml(html, element) {
     id
   };
 }
-function selectorTargetsId(selector, id) {
-  return selector === `#${id}` || selector === `[data-hf-id="${id}"]` || selector === `[data-hf-id='${id}']`;
-}
-function stripGsapForId(script, elementId) {
-  let current = script;
-  for (; ; ) {
-    const parsed = parseGsapScriptAcornForWrite(current);
-    if (!parsed) return current;
-    const match = parsed.located.find(
-      (l) => selectorTargetsId(l.animation.targetSelector, elementId)
-    );
-    if (!match) return current;
-    const updated = removeAnimationFromScript(current, match.id);
-    if (updated === current) return current;
-    current = updated;
-  }
-}
-function cascadeRemoveGsapById(doc, elementId) {
+function elementSelectors(element) {
+  const selectors = [];
+  const id = element.getAttribute("id");
+  const hfId = element.getAttribute("data-hf-id");
+  if (id) selectors.push(`#${id}`);
+  if (hfId) selectors.push(`[data-hf-id="${hfId}"]`, `[data-hf-id='${hfId}']`);
+  return selectors;
+}
+function removeElementWithGsapCascade(doc, element) {
+  const removedSelectors = new Set(elementSelectors(element));
+  walkCompositionDescendants(element, (child) => {
+    for (const selector of elementSelectors(child)) removedSelectors.add(selector);
+  });
+  element.remove();
+  walkCompositionDescendants(doc, (survivor) => {
+    for (const selector of elementSelectors(survivor)) removedSelectors.delete(selector);
+  });
+  if (removedSelectors.size === 0) return;
   for (const script of findScriptElementsDeep(doc)) {
-    const text = script.textContent ?? "";
-    if (!text.includes("gsap") && !text.includes("ScrollTrigger")) continue;
-    const updated = stripGsapForId(text, elementId);
-    if (updated !== text) script.textContent = updated;
+    let current = script.textContent ?? "";
+    if (!current.includes("gsap") && !current.includes("ScrollTrigger")) continue;
+    for (; ; ) {
+      const parsed = parseGsapScriptAcornForWrite(current);
+      const match = parsed?.located.find(
+        (located) => removedSelectors.has(located.animation.targetSelector)
+      );
+      if (!match) break;
+      const updated = removeAnimationFromScript(current, match.id);
+      if (updated === current) break;
+      current = updated;
+    }
+    if (current !== script.textContent) script.textContent = current;
   }
 }
 function removeElementFromHtml(html, elementId) {
@@ -3212,8 +3221,8 @@ function removeElementFromHtml(html, elementId) {
       "removeElementFromHtml: input HTML is empty or could not be parsed"
     );
   }
-  doc.getElementById(elementId)?.remove();
-  cascadeRemoveGsapById(doc, elementId);
+  const element = doc.getElementById(elementId);
+  if (element) removeElementWithGsapCascade(doc, element);
   return "<!DOCTYPE html>\n" + doc.documentElement.outerHTML;
 }
 function extractCompositionMetadata(html) {
@@ -3390,13 +3399,6 @@ function checkOutputResolutionCompatibility(input) {
       message: `outputResolution cannot be combined with hdrMode='force-hdr'. HDR rendering composites at composition dimensions and does not yet support supersampling. Pick one or render in two passes.`
     };
   }
-  if (input.alphaRequested) {
-    return {
-      ok: false,
-      kind: "alpha-incompatible",
-      message: `outputResolution cannot be combined with alpha output (--format webm|mov|png-sequence). The alpha screenshot path does not yet apply deviceScaleFactor and would silently produce composition-resolution frames. Render alpha at composition resolution and upscale separately, or use --format mp4.`
-    };
-  }
   const target = CANVAS_DIMENSIONS[outputResolution];
   if (target.width * compositionHeight !== target.height * compositionWidth) {
     return buildAspectMismatch(compositionWidth, compositionHeight, outputResolution, target);
@@ -3785,6 +3787,7 @@ export {
   queryByAttr,
   readClipTiming,
   removeElementFromHtml,
+  removeElementWithGsapCascade,
   resolveAliasDisplayName,
   resolveResolutionFlagPair,
   scanVariableUsage,