@hyperframes/parsers 0.8.200 → 0.8.202

package/dist/composition.d.ts

@@ -1,5 +1,5 @@
-import { C as CompositionVariable } from './types-DhN8sPyL.js';
-export { A as AddElementData, b as Asset, B as BooleanVariable, c as CANVAS_DIMENSIONS, d as COMPOSITION_VARIABLE_TYPES, a as CanvasResolution, 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, K as Keyframe, l as KeyframeProperties, M as MediaElementType, m as MediaFile, N as NumberVariable, P as PlayerAPI, R as ResolvedResolutionFlag, n as StageZoom, S as StageZoomKeyframe, o as StringVariable, p as TIMELINE_COLORS, q as TimelineCompositionElement, T as TimelineElement, r as TimelineElementBase, s as TimelineElementType, t as TimelineMediaElement, u as TimelineTextElement, v as VALID_CANVAS_RESOLUTIONS, V as ValidationResult, 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-DhN8sPyL.js';
+import { C as CompositionVariable, F as FontValue, I as ImageValue } from './types-CdT7qqke.js';
+export { A as AddElementData, b as Asset, B as BooleanVariable, c as CANVAS_DIMENSIONS, d as COMPOSITION_VARIABLE_TYPES, a as CanvasResolution, 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, l as FontVariable, m as ImageVariable, K as Keyframe, n as KeyframeProperties, M as MediaElementType, o as MediaFile, N as NumberVariable, P as PlayerAPI, R as ResolvedResolutionFlag, p as StageZoom, S as StageZoomKeyframe, q as StringVariable, r as TIMELINE_COLORS, s as TimelineCompositionElement, T as TimelineElement, t as TimelineElementBase, u as TimelineElementType, v as TimelineMediaElement, w as TimelineTextElement, x as VALID_CANVAS_RESOLUTIONS, V as ValidationResult, W as WaveformData, y as getDefaultStageZoom, z as isAspectAgnosticResolutionAlias, G as isCompositionElement, H as isMediaElement, J as isTextElement, L as normalizeResolutionFlag, O as resolveResolutionFlagPair } from './types-CdT7qqke.js';
 export { c as decodeUrlPathVariants } from './urlPath-C_0f_-Hp.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';
 
@@ -17,6 +17,8 @@ export { CANONICAL_AUTHORED_TIMING_ATTRIBUTES, COMPOSITION_ATTRIBUTES, COMPOSITI
  * display logic can never disagree on what "scalar" means.
  */
 declare function isScalarVariableValue(value: unknown): value is string | number | boolean;
+declare function isFontValue(value: unknown): value is FontValue;
+declare function isImageValue(value: unknown): value is ImageValue;
 /**
  * True when the value is a structurally valid variable declaration: id, label,
  * a known type, a default matching that type, and options[] for enums. The
@@ -183,4 +185,4 @@ declare const CANONICAL_FONT_DISPLAY_NAMES: Readonly<Record<string, string>>;
  */
 declare function resolveAliasDisplayName(alias: string): string | undefined;
 
-export { CANONICAL_FONT_DISPLAY_NAMES, CompositionVariable, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, HTML_BODY_CSS_HEIGHT_FIRST_RE, HTML_BODY_CSS_WIDTH_FIRST_RE, type MediaSrcMutation, VIEWPORT_META_SIZE_RE, type VariableUsageScan, extractMediaSrcMutations, isCompositionVariable, isSafeMediaUrl, isScalarVariableValue, parseCompositionVariables, resolveAliasDisplayName, scanVariableUsage };
+export { CANONICAL_FONT_DISPLAY_NAMES, CompositionVariable, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, FontValue, HTML_BODY_CSS_HEIGHT_FIRST_RE, HTML_BODY_CSS_WIDTH_FIRST_RE, ImageValue, type MediaSrcMutation, VIEWPORT_META_SIZE_RE, type VariableUsageScan, extractMediaSrcMutations, isCompositionVariable, isFontValue, isImageValue, isSafeMediaUrl, isScalarVariableValue, parseCompositionVariables, resolveAliasDisplayName, scanVariableUsage };

package/dist/composition.js

@@ -237,7 +237,13 @@ function isScalarVariableValue(value) {
   return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
 }
 function isRecord(v) {
-  return typeof v === "object" && v !== null;
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isFontValue(value) {
+  return isRecord(value) && typeof value.name === "string" && typeof value.source === "string";
+}
+function isImageValue(value) {
+  return isRecord(value) && typeof value.url === "string" && (value.alt === void 0 || typeof value.alt === "string") && (value.fit === void 0 || value.fit === "cover" || value.fit === "contain" || value.fit === "fill" || value.fit === "none" || value.fit === "scale-down");
 }
 function isVariableType(t) {
   return typeof t === "string" && t in DEFAULT_TYPEOF;
@@ -246,6 +252,8 @@ function isCompositionVariable(v) {
   if (!isRecord(v)) return false;
   if (typeof v.id !== "string" || typeof v.label !== "string") return false;
   if (!isVariableType(v.type)) return false;
+  if (v.type === "font") return typeof v.default === "string" || isFontValue(v.default);
+  if (v.type === "image") return typeof v.default === "string" || isImageValue(v.default);
   if (typeof v.default !== DEFAULT_TYPEOF[v.type]) return false;
   if (v.type === "enum" && !Array.isArray(v.options)) return false;
   return true;
@@ -764,6 +772,8 @@ export {
   isAspectAgnosticResolutionAlias,
   isCompositionElement,
   isCompositionVariable,
+  isFontValue,
+  isImageValue,
   isMediaElement,
   isSafeMediaUrl,
   isScalarVariableValue,

package/dist/gsapConstants.d.ts

@@ -1,2 +1,2 @@
-export { B as BUILTIN_VAR_KEYS, D as DROPPED_VAR_KEYS, E as EXTRAS_KEYS, u as GSAP_DEFAULT_DURATION, H as HoldScope, f as PROPERTY_GROUPS, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, x as holdScope, y as isTweenConfigKey, z as isXYPositionWrite, C as keyframeHoldForAnimation } from './gsapSerialize-DmU7GIhl.js';
-import './types-DhN8sPyL.js';
+export { B as BUILTIN_VAR_KEYS, D as DROPPED_VAR_KEYS, E as EXTRAS_KEYS, u as GSAP_DEFAULT_DURATION, H as HoldScope, f as PROPERTY_GROUPS, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, x as holdScope, y as isTweenConfigKey, z as isXYPositionWrite, C as keyframeHoldForAnimation } from './gsapSerialize-DTDYI-MO.js';
+import './types-CdT7qqke.js';

package/dist/gsapParser.d.ts

@@ -1,7 +1,7 @@
-import { G as GsapAnimation, P as ParsedGsap, A as ArcPathConfig, a as ArcPathSegment } from './gsapSerialize-DmU7GIhl.js';
-export { b as GsapKeyframeFormat, c as GsapKeyframesData, d as GsapMethod, e as GsapPercentageKeyframe, f as PROPERTY_GROUPS, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, k as getAnimationsForElementId, l as gsapAnimationsToKeyframes, m as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-DmU7GIhl.js';
+import { G as GsapAnimation, P as ParsedGsap, A as ArcPathConfig, a as ArcPathSegment } from './gsapSerialize-DTDYI-MO.js';
+export { b as GsapKeyframeFormat, c as GsapKeyframesData, d as GsapMethod, e as GsapPercentageKeyframe, f as PROPERTY_GROUPS, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, k as getAnimationsForElementId, l as gsapAnimationsToKeyframes, m as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-DTDYI-MO.js';
 export { SPRING_PRESETS, SpringPreset, generateSpringEaseData } from './springEase.js';
-import './types-DhN8sPyL.js';
+import './types-CdT7qqke.js';
 
 declare function parseGsapScript(script: string): ParsedGsap;
 declare function updateAnimationInScript(script: string, animationId: string, updates: Partial<GsapAnimation> & {

package/dist/gsapParserAcorn.d.ts

@@ -1,6 +1,6 @@
-import { P as ParsedGsap, d as GsapMethod, G as GsapAnimation } from './gsapSerialize-DmU7GIhl.js';
-export { A as ArcPathConfig, a as ArcPathSegment, n as GsapProvenance, o as GsapProvenanceKind, K as KeyframeEditability, M as MotionPathShape, p as buildArcPath, q as editabilityForProvenance } from './gsapSerialize-DmU7GIhl.js';
-import './types-DhN8sPyL.js';
+import { P as ParsedGsap, d as GsapMethod, G as GsapAnimation } from './gsapSerialize-DTDYI-MO.js';
+export { A as ArcPathConfig, a as ArcPathSegment, n as GsapProvenance, o as GsapProvenanceKind, K as KeyframeEditability, M as MotionPathShape, p as buildArcPath, q as editabilityForProvenance } from './gsapSerialize-DTDYI-MO.js';
+import './types-CdT7qqke.js';
 
 /**
  * A script's syntax tree as one string, or null when it does not parse. Comments, layout, quote

package/dist/gsapParserExports.d.ts

@@ -1,8 +1,8 @@
-export { A as ArcPathConfig, a as ArcPathSegment, u as GSAP_DEFAULT_DURATION, G as GsapAnimation, c as GsapKeyframesData, d as GsapMethod, e as GsapPercentageKeyframe, n as GsapProvenance, o as GsapProvenanceKind, K as KeyframeEditability, f as PROPERTY_GROUPS, P as ParsedGsap, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, w as SourcedGsapPercentageKeyframe, r as SplitAnimationsOptions, t as SplitAnimationsResult, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, q as editabilityForProvenance, k as getAnimationsForElementId, l as gsapAnimationsToKeyframes, m as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-DmU7GIhl.js';
+export { A as ArcPathConfig, a as ArcPathSegment, u as GSAP_DEFAULT_DURATION, G as GsapAnimation, c as GsapKeyframesData, d as GsapMethod, e as GsapPercentageKeyframe, n as GsapProvenance, o as GsapProvenanceKind, K as KeyframeEditability, f as PROPERTY_GROUPS, P as ParsedGsap, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, w as SourcedGsapPercentageKeyframe, r as SplitAnimationsOptions, t as SplitAnimationsResult, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, q as editabilityForProvenance, k as getAnimationsForElementId, l as gsapAnimationsToKeyframes, m as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-DTDYI-MO.js';
 export { isStudioHoldSet } from './gsapParser.js';
 export { SPRING_PRESETS, SpringPreset, generateSpringEaseData } from './springEase.js';
 export { parseGsapScriptAcorn as parseGsapScript } from './gsapParserAcorn.js';
-import './types-DhN8sPyL.js';
+import './types-CdT7qqke.js';
 
 interface ObjectArrayKeyframeTiming {
     percentages: number[];

package/dist/{gsapSerialize-DmU7GIhl.d.ts → gsapSerialize-DTDYI-MO.d.ts}

@@ -1,4 +1,4 @@
-import { K as Keyframe, V as ValidationResult } from './types-DhN8sPyL.js';
+import { K as Keyframe, V as ValidationResult } from './types-CdT7qqke.js';
 
 /**
  * GSAP property and ease constants.

package/dist/gsapWriterAcorn.d.ts

@@ -1,5 +1,5 @@
-import { G as GsapAnimation, A as ArcPathConfig, r as SplitAnimationsOptions, t as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-DmU7GIhl.js';
-import './types-DhN8sPyL.js';
+import { G as GsapAnimation, A as ArcPathConfig, r as SplitAnimationsOptions, t as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-DTDYI-MO.js';
+import './types-CdT7qqke.js';
 
 type TweenTarget = Pick<GsapAnimation, "targetSelector" | "hasPartialSelector">;
 type TweenTime = Pick<GsapAnimation, "position" | "implicitPosition">;

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-DhN8sPyL.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-DhN8sPyL.js';
-export { A as ArcPathConfig, a as ArcPathSegment, u as GSAP_DEFAULT_DURATION, G as GsapAnimation, c as GsapKeyframesData, d as GsapMethod, e as GsapPercentageKeyframe, n as GsapProvenance, o as GsapProvenanceKind, K as KeyframeEditability, f as PROPERTY_GROUPS, P as ParsedGsap, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, w as SourcedGsapPercentageKeyframe, r as SplitAnimationsOptions, t as SplitAnimationsResult, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, q as editabilityForProvenance, k as getAnimationsForElementId, l as gsapAnimationsToKeyframes, m as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-DmU7GIhl.js';
+import { C as CompositionVariable, T as TimelineElement, a as CanvasResolution, K as Keyframe, S as StageZoomKeyframe, V as ValidationResult } from './types-CdT7qqke.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 FontValue, l as FontVariable, I as ImageValue, m as ImageVariable, n as KeyframeProperties, M as MediaElementType, o as MediaFile, N as NumberVariable, P as PlayerAPI, R as ResolvedResolutionFlag, p as StageZoom, q as StringVariable, r as TIMELINE_COLORS, s as TimelineCompositionElement, t as TimelineElementBase, u as TimelineElementType, v as TimelineMediaElement, w as TimelineTextElement, x as VALID_CANVAS_RESOLUTIONS, W as WaveformData, y as getDefaultStageZoom, z as isAspectAgnosticResolutionAlias, G as isCompositionElement, H as isMediaElement, J as isTextElement, L as normalizeResolutionFlag, O as resolveResolutionFlagPair } from './types-CdT7qqke.js';
+export { A as ArcPathConfig, a as ArcPathSegment, u as GSAP_DEFAULT_DURATION, G as GsapAnimation, c as GsapKeyframesData, d as GsapMethod, e as GsapPercentageKeyframe, n as GsapProvenance, o as GsapProvenanceKind, K as KeyframeEditability, f as PROPERTY_GROUPS, P as ParsedGsap, g as PropertyGroupName, S as SUPPORTED_EASES, h as SUPPORTED_PROPS, w as SourcedGsapPercentageKeyframe, r as SplitAnimationsOptions, t as SplitAnimationsResult, i as classifyPropertyGroup, j as classifyTweenPropertyGroup, q as editabilityForProvenance, k as getAnimationsForElementId, l as gsapAnimationsToKeyframes, m as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-DTDYI-MO.js';
 export { isStudioHoldSet } from './gsapParser.js';
 export { getObjectArrayKeyframeTiming } from './gsapParserExports.js';
 export { SPRING_PRESETS, SpringPreset, generateSpringEaseData } from './springEase.js';
@@ -130,6 +130,23 @@ declare function checkOutputResolutionCompatibility(input: {
     alphaRequested?: boolean;
     hdrRequested?: boolean;
 }): OutputResolutionCompatibility;
+type OutputSizeResolution = {
+    ok: true;
+    outputResolution: CanvasResolution | undefined;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * The preset a requested pixel size stands for on a composition: none when it is the composition's own size,
+ * else the preset of exactly that size when it is a whole-number multiple (3840×2160 on 1920×1080 is scale 2).
+ */
+declare function outputResolutionForSize(input: {
+    compositionWidth: number;
+    compositionHeight: number;
+    width: number;
+    height: number;
+}): OutputSizeResolution;
 
 /** Rewrite top-level helper calls and loops into literal tweens; unchanged when nothing can be unrolled. */
 declare function unrollComputedTimeline(script: string): string;
@@ -168,4 +185,4 @@ interface TimingMismatchReport {
  */
 declare function timingMismatches(html: string): TimingMismatchReport;
 
-export { CanvasResolution, CompositionHtmlParseError, type CompositionMetadata, CompositionVariable, Keyframe, type OutputResolutionCompatibility, type OutputResolutionIssueKind, type ParsedHtml, StageZoomKeyframe, TimelineElement, type TimingFinding, type TimingMismatchReport, type UnresolvedTiming, ValidationResult, addElementToHtml, checkOutputResolutionCompatibility, extractCompositionMetadata, parseHtml, queryByAttr, removeElementFromHtml, removeElementWithGsapCascade, suggestMatchingPreset, timingMismatches, unrollComputedTimeline, updateElementInHtml, validateCompositionHtml };
+export { CanvasResolution, CompositionHtmlParseError, type CompositionMetadata, CompositionVariable, Keyframe, type OutputResolutionCompatibility, type OutputResolutionIssueKind, type OutputSizeResolution, type ParsedHtml, StageZoomKeyframe, TimelineElement, type TimingFinding, type TimingMismatchReport, type UnresolvedTiming, ValidationResult, addElementToHtml, checkOutputResolutionCompatibility, extractCompositionMetadata, outputResolutionForSize, parseHtml, queryByAttr, removeElementFromHtml, removeElementWithGsapCascade, suggestMatchingPreset, timingMismatches, unrollComputedTimeline, updateElementInHtml, validateCompositionHtml };

package/dist/index.js

@@ -2376,7 +2376,13 @@ var DEFAULT_TYPEOF = {
   image: "string"
 };
 function isRecord(v) {
-  return typeof v === "object" && v !== null;
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isFontValue(value) {
+  return isRecord(value) && typeof value.name === "string" && typeof value.source === "string";
+}
+function isImageValue(value) {
+  return isRecord(value) && typeof value.url === "string" && (value.alt === void 0 || typeof value.alt === "string") && (value.fit === void 0 || value.fit === "cover" || value.fit === "contain" || value.fit === "fill" || value.fit === "none" || value.fit === "scale-down");
 }
 function isVariableType(t) {
   return typeof t === "string" && t in DEFAULT_TYPEOF;
@@ -2385,6 +2391,8 @@ function isCompositionVariable(v) {
   if (!isRecord(v)) return false;
   if (typeof v.id !== "string" || typeof v.label !== "string") return false;
   if (!isVariableType(v.type)) return false;
+  if (v.type === "font") return typeof v.default === "string" || isFontValue(v.default);
+  if (v.type === "image") return typeof v.default === "string" || isImageValue(v.default);
   if (typeof v.default !== DEFAULT_TYPEOF[v.type]) return false;
   if (v.type === "enum" && !Array.isArray(v.options)) return false;
   return true;
@@ -3730,6 +3738,34 @@ function checkOutputResolutionCompatibility(input) {
   }
   return OK;
 }
+function outputResolutionForSize(input) {
+  const { compositionWidth, compositionHeight, width, height } = input;
+  if (width === compositionWidth && height === compositionHeight) {
+    return { ok: true, outputResolution: void 0 };
+  }
+  const composition = `${compositionWidth}\xD7${compositionHeight}`;
+  const scale = width / compositionWidth;
+  if (width < compositionWidth || height < compositionHeight) {
+    return {
+      ok: false,
+      message: `${width}\xD7${height} is smaller than the composition (${composition}). Use the composition's size, or a whole-number multiple of it.`
+    };
+  }
+  const preset = VALID_CANVAS_RESOLUTIONS.find(
+    (name) => CANVAS_DIMENSIONS[name].width === width && CANVAS_DIMENSIONS[name].height === height
+  );
+  if (!Number.isInteger(scale) || height !== compositionHeight * scale || !preset || !checkOutputResolutionCompatibility({
+    compositionWidth,
+    compositionHeight,
+    outputResolution: preset
+  }).ok) {
+    return {
+      ok: false,
+      message: `${width}\xD7${height} is not a whole-number multiple of the composition (${composition}) at a supported size. Use ${composition}, or a multiple such as ${compositionWidth * 2}\xD7${compositionHeight * 2} when that is a preset size (${VALID_CANVAS_RESOLUTIONS.map((name) => `${CANVAS_DIMENSIONS[name].width}\xD7${CANVAS_DIMENSIONS[name].height}`).join(", ")}).`
+    };
+  }
+  return { ok: true, outputResolution: preset };
+}
 
 // src/gsapUnroll.ts
 import * as acorn2 from "acorn";
@@ -4635,6 +4671,7 @@ export {
   keyframesToGsapAnimations,
   mintHfId,
   normalizeResolutionFlag,
+  outputResolutionForSize,
   parseCompositionVariables,
   parseGsapScriptAcorn as parseGsapScript,
   parseHtml,

package/dist/{types-DhN8sPyL.d.ts → types-CdT7qqke.d.ts}

@@ -208,17 +208,19 @@ interface EnumVariable extends CompositionVariableBase {
         label: string;
     }[];
 }
-/**
- * Font variable — value is a `{name, source}` object (object-valued; LOCKED §7).
- * `default` is the fallback font-family name string.
- * `source` is the font stylesheet URL (e.g. Google Fonts CSS).
- * `default_name` / `default_source` are the CSS-level fallbacks when the
- * brand font is absent.
- */
+interface FontValue {
+    name: string;
+    source: string;
+}
+interface ImageValue {
+    url: string;
+    alt?: string;
+    fit?: "cover" | "contain" | "fill" | "none" | "scale-down";
+}
 interface FontVariable extends CompositionVariableBase {
     type: "font";
-    /** Fallback font-family name, e.g. "Inter". */
-    default: string;
+    /** Font-family fallback or a persisted font value. */
+    default: string | FontValue;
     /** Font stylesheet URL (e.g. Google Fonts CSS link). */
     source?: string;
     /** CSS font-family name to use when source is unavailable, e.g. "sans-serif". */
@@ -226,15 +228,10 @@ interface FontVariable extends CompositionVariableBase {
     /** Fallback font stylesheet URL (empty string = system font). */
     default_source?: string;
 }
-/**
- * Image variable — value is a `{url, …}` object (object-valued; LOCKED §7).
- * `default` is the fallback image URL string.
- * `brandRole` is an optional semantic label, e.g. "logo:primary".
- */
 interface ImageVariable extends CompositionVariableBase {
     type: "image";
-    /** Fallback image URL. */
-    default: string;
+    /** Image URL fallback or a persisted image value. */
+    default: string | ImageValue;
     /** Brand role identifier, e.g. "logo:primary". */
     brandRole?: string;
 }
@@ -438,4 +435,4 @@ interface StageZoomKeyframe {
 }
 declare function getDefaultStageZoom(resolution: CanvasResolution): StageZoom;
 
-export { type AddElementData as A, type BooleanVariable as B, type CompositionVariable as C, DEFAULT_DURATIONS as D, type ElementKeyframes as E, type FontVariable as F, isTextElement as G, normalizeResolutionFlag as H, type ImageVariable as I, resolveResolutionFlagPair as J, type Keyframe as K, type MediaElementType as M, type NumberVariable as N, type PlayerAPI as P, type ResolvedResolutionFlag as R, type StageZoomKeyframe as S, type TimelineElement as T, type ValidationResult as V, type WaveformData as W, type CanvasResolution as a, type Asset as b, CANVAS_DIMENSIONS as c, COMPOSITION_VARIABLE_TYPES as d, type ColorVariable as e, type CompositionAPI as f, type CompositionAsset as g, type CompositionSpec as h, type CompositionVariableBase as i, type CompositionVariableType as j, type EnumVariable as k, type KeyframeProperties as l, type MediaFile as m, type StageZoom as n, type StringVariable as o, TIMELINE_COLORS as p, type TimelineCompositionElement as q, type TimelineElementBase as r, type TimelineElementType as s, type TimelineMediaElement as t, type TimelineTextElement as u, VALID_CANVAS_RESOLUTIONS as v, getDefaultStageZoom as w, isAspectAgnosticResolutionAlias as x, isCompositionElement as y, isMediaElement as z };
+export { type AddElementData as A, type BooleanVariable as B, type CompositionVariable as C, DEFAULT_DURATIONS as D, type ElementKeyframes as E, type FontValue as F, isCompositionElement as G, isMediaElement as H, type ImageValue as I, isTextElement as J, type Keyframe as K, normalizeResolutionFlag as L, type MediaElementType as M, type NumberVariable as N, resolveResolutionFlagPair as O, type PlayerAPI as P, type ResolvedResolutionFlag as R, type StageZoomKeyframe as S, type TimelineElement as T, type ValidationResult as V, type WaveformData as W, type CanvasResolution as a, type Asset as b, CANVAS_DIMENSIONS as c, COMPOSITION_VARIABLE_TYPES as d, type ColorVariable as e, type CompositionAPI as f, type CompositionAsset as g, type CompositionSpec as h, type CompositionVariableBase as i, type CompositionVariableType as j, type EnumVariable as k, type FontVariable as l, type ImageVariable as m, type KeyframeProperties as n, type MediaFile as o, type StageZoom as p, type StringVariable as q, TIMELINE_COLORS as r, type TimelineCompositionElement as s, type TimelineElementBase as t, type TimelineElementType as u, type TimelineMediaElement as v, type TimelineTextElement as w, VALID_CANVAS_RESOLUTIONS as x, getDefaultStageZoom as y, isAspectAgnosticResolutionAlias as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.8.200",
+  "version": "0.8.202",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -135,7 +135,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^4.1.11",
-    "@hyperframes/core": "0.8.200"
+    "@hyperframes/core": "0.8.202"
   },
   "scripts": {
     "build": "tsup",