@hyperframes/parsers 0.8.49 → 0.8.51

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { C as CompositionVariable, T as TimelineElement, a as CanvasResolution, K as Keyframe, S as StageZoomKeyframe, V as ValidationResult } from './types-Y0NXTiVo.js';
 export { A as AddElementData, b as Asset, B as BooleanVariable, c as CANVAS_DIMENSIONS, d as COMPOSITION_VARIABLE_TYPES, e as ColorVariable, f as CompositionAPI, g as CompositionAsset, h as CompositionSpec, i as CompositionVariableBase, j as CompositionVariableType, D as DEFAULT_DURATIONS, E as ElementKeyframes, k as EnumVariable, F as FontVariable, I as ImageVariable, l as KeyframeProperties, M as MediaElementType, m as MediaFile, N as NumberVariable, P as PlayerAPI, R as ResolvedResolutionFlag, n as StageZoom, o as StringVariable, p as TIMELINE_COLORS, q as TimelineCompositionElement, r as TimelineElementBase, s as TimelineElementType, t as TimelineMediaElement, u as TimelineTextElement, v as VALID_CANVAS_RESOLUTIONS, W as WaveformData, w as getDefaultStageZoom, x as isAspectAgnosticResolutionAlias, y as isCompositionElement, z as isMediaElement, G as isTextElement, H as normalizeResolutionFlag, J as resolveResolutionFlagPair } from './types-Y0NXTiVo.js';
-export { A as ArcPathConfig, a as ArcPathSegment, G as GsapAnimation, b as GsapKeyframesData, c as GsapMethod, d as GsapPercentageKeyframe, e as GsapProvenance, f as GsapProvenanceKind, K as KeyframeEditability, P as ParsedGsap, S as SourcedGsapPercentageKeyframe, g as SplitAnimationsOptions, h as SplitAnimationsResult, i as editabilityForProvenance, j as getAnimationsForElementId, k as gsapAnimationsToKeyframes, l as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-QZcXUoVf.js';
+export { A as ArcPathConfig, a as ArcPathSegment, G as GsapAnimation, b as GsapKeyframesData, c as GsapMethod, d as GsapPercentageKeyframe, e as GsapProvenance, f as GsapProvenanceKind, K as KeyframeEditability, P as ParsedGsap, S as SourcedGsapPercentageKeyframe, g as SplitAnimationsOptions, h as SplitAnimationsResult, i as editabilityForProvenance, j as getAnimationsForElementId, k as gsapAnimationsToKeyframes, l as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-b8lNzSbI.js';
 export { isStudioHoldSet } from './gsapParser.js';
 export { PROPERTY_GROUPS, PropertyGroupName, SUPPORTED_EASES, SUPPORTED_PROPS, classifyPropertyGroup, classifyTweenPropertyGroup } from './gsapConstants.js';
 export { SPRING_PRESETS, SpringPreset, generateSpringEaseData } from './springEase.js';
@@ -8,6 +8,9 @@ export { parseGsapScriptAcorn as parseGsapScript } from './gsapParserAcorn.js';
 export { EXCLUDED_TAGS, ensureHfIds, isCompositionTemplate, mintHfId, walkCompositionDescendants } from './hfIds.js';
 export { ParsableDocumentLike, SubCompositionValidity, SubCompositionValidityReason, checkSubCompositionUsability } from './subCompositionValidity.js';
 export { CANONICAL_AUTHORED_TIMING_ATTRIBUTES, COMPOSITION_ATTRIBUTES, COMPOSITION_CONTRACT_VERSION, ClipAttributeReader, ClipAttributeWriter, ClipTiming, ClipTimingDiagnostic, ClipTimingDiagnosticCode, ClipTimingUpdate, ClipTimingWriteError, DERIVED_TIMING_ATTRIBUTES, LEGACY_TIMING_ATTRIBUTES, ReadClipTimingOptions, ReferenceExpression, parseNumeric, parseStartExpression, readClipTiming, writeClipTiming } from './compositionContract.js';
+export { StructureNode, TrackKind, TrackKindSource, isSubCompositionHost, isTimedElement, topLevelElements, trackKindOf } from './topLevelElements.js';
+export { AttrReader, DEFAULT_IMAGE_TIMELINE_DURATION_SECONDS, MAX_PLAYBACK_RATE, MIN_PLAYBACK_RATE, MediaDurationResult, MediaDurationSource, MediaTag, PENDING_MEDIA_DURATION_READERS, ResolveMediaDurationInput, clampPlaybackRate, readAuthoredDurationSeconds, readDataDurationSeconds, readMediaOffsetSeconds, readPlaybackRate, resolveMediaDuration, resolveNaturalDurationSeconds } from './mediaDuration.js';
+export { CompositionDurationResult, CompositionDurationSource, ResolveCompositionDurationInput, resolveCompositionDuration } from './compositionDuration.js';
 export { CANONICAL_FONT_DISPLAY_NAMES, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, VariableUsageScan, decodeUrlPathVariants, parseCompositionVariables, resolveAliasDisplayName, scanVariableUsage } from './composition.js';
 
 /**
@@ -126,11 +129,7 @@ declare function checkOutputResolutionCompatibility(input: {
     hdrRequested?: boolean;
 }): OutputResolutionCompatibility;
 
-/**
- * Rewrite `script` so top-level helper calls / loops that build the timeline
- * become explicit literal tweens. Returns the original script unchanged when
- * there is nothing statically-resolvable to unroll.
- */
+/** Rewrite top-level helper calls and loops into literal tweens; unchanged when nothing can be unrolled. */
 declare function unrollComputedTimeline(script: string): string;
 
 declare function queryByAttr(root: ParentNode, attr: string, value: string, tag?: string): Element | null;
@@ -146,6 +145,38 @@ declare const HTML_BODY_CSS_HEIGHT_FIRST_RE: RegExp;
 /** Viewport meta content. Shared by lint (reads groups 2/4) and cli (replaces via 1/3). */
 declare const VIEWPORT_META_SIZE_RE: RegExp;
 
+type TimingFinding = {
+    kind: "tween-outside-window";
+    selector: string;
+    elementId: string | null;
+    dataStart: number;
+    dataEnd: number | null;
+    tweenStart: number;
+    tweenEnd: number;
+} | {
+    kind: "animated-without-timing";
+    selector: string;
+    elementId: string | null;
+} | {
+    kind: "timeline-exceeds-root-duration";
+    rootDuration: number;
+    timelineEnd: number;
+};
+/** Timing that could not be read statically. Reported, never flagged. */
+interface UnresolvedTiming {
+    selector: string;
+    reason: "duration" | "position" | "stagger" | "start-attribute";
+}
+interface TimingMismatchReport {
+    findings: TimingFinding[];
+    unresolved: UnresolvedTiming[];
+}
+/**
+ * Compares the GSAP timeline in a composition file with the timing attributes of its elements.
+ * Attributes are authoritative: a tween that places an element outside its window is a finding.
+ */
+declare function timingMismatches(html: string): TimingMismatchReport;
+
 interface MediaSrcMutation {
     selector: string;
     operation: "src_assignment" | "set_attribute";
@@ -154,4 +185,4 @@ interface MediaSrcMutation {
 /** Find literal source writes whose target is a statically resolvable DOM lookup. */
 declare function extractMediaSrcMutations(script: string): MediaSrcMutation[];
 
-export { CanvasResolution, CompositionHtmlParseError, type CompositionMetadata, CompositionVariable, HTML_BODY_CSS_HEIGHT_FIRST_RE, HTML_BODY_CSS_WIDTH_FIRST_RE, Keyframe, type MediaSrcMutation, type OutputResolutionCompatibility, type OutputResolutionIssueKind, type ParsedHtml, StageZoomKeyframe, TimelineElement, VIEWPORT_META_SIZE_RE, ValidationResult, addElementToHtml, checkOutputResolutionCompatibility, extractCompositionMetadata, extractMediaSrcMutations, parseHtml, queryByAttr, removeElementFromHtml, removeElementWithGsapCascade, suggestMatchingPreset, unrollComputedTimeline, updateElementInHtml, validateCompositionHtml };
+export { CanvasResolution, CompositionHtmlParseError, type CompositionMetadata, CompositionVariable, HTML_BODY_CSS_HEIGHT_FIRST_RE, HTML_BODY_CSS_WIDTH_FIRST_RE, Keyframe, type MediaSrcMutation, type OutputResolutionCompatibility, type OutputResolutionIssueKind, type ParsedHtml, StageZoomKeyframe, TimelineElement, type TimingFinding, type TimingMismatchReport, type UnresolvedTiming, VIEWPORT_META_SIZE_RE, ValidationResult, addElementToHtml, checkOutputResolutionCompatibility, extractCompositionMetadata, extractMediaSrcMutations, parseHtml, queryByAttr, removeElementFromHtml, removeElementWithGsapCascade, suggestMatchingPreset, timingMismatches, unrollComputedTimeline, updateElementInHtml, validateCompositionHtml };