@hyperframes/parsers 0.7.16 → 0.7.17

package/dist/gsapSerialize-Bei7m7M7.d.ts

@@ -0,0 +1,166 @@
+import { K as Keyframe, V as ValidationResult } from './types-Cg0ZTXEf.js';
+import { PropertyGroupName } from './gsapConstants.js';
+
+/**
+ * Recast-free GSAP helpers: serialization, keyframe<->animation conversion,
+ * validation, and shared types.
+ *
+ * This module MUST NOT import recast / @babel/parser. It is part of the
+ * isomorphic core layer that the barrel and browser code depend on. AST
+ * parsing of GSAP source lives in the Node-only `./gsapParser` module.
+ */
+
+type GsapMethod = "set" | "to" | "from" | "fromTo";
+/** How a tween was constructed in source — drives display classification and editability. */
+type GsapProvenanceKind = "literal" | "helper" | "loop" | "runtime-dynamic";
+/**
+ * Origin of a parsed tween. `literal` tweens map 1:1 to a source call and edit
+ * directly; `helper`/`loop` tweens are expanded from a reused construct (unroll
+ * to edit); `runtime-dynamic` tweens come from live introspection (override to
+ * edit). Absent provenance is treated as `literal`.
+ */
+interface GsapProvenance {
+    kind: GsapProvenanceKind;
+    /** Helper function name (kind === "helper"). */
+    fn?: string;
+    /** 1-based ordinal of the originating call site / loop construct in source order. */
+    callSite?: number;
+    /** 0-based iteration index (kind === "loop"). */
+    iteration?: number;
+    /** Source offset [start, end] of the originating call/loop, when known. */
+    sourceRange?: [number, number];
+}
+/** How a tween's keyframes can be edited, derived from its provenance. */
+type KeyframeEditability = "direct" | "unroll" | "source";
+/**
+ * Map provenance to an editing strategy:
+ * - `direct` — literal tween, maps 1:1 to source; edit in place.
+ * - `unroll` — helper/loop expansion; unroll to literal tweens, then edit.
+ * - `source` — runtime-dynamic value; not statically editable, edit the code.
+ */
+declare function editabilityForProvenance(provenance?: GsapProvenance): KeyframeEditability;
+interface GsapAnimation {
+    id: string;
+    targetSelector: string;
+    method: GsapMethod;
+    position: number | string;
+    properties: Record<string, number | string>;
+    fromProperties?: Record<string, number | string>;
+    duration?: number;
+    ease?: string;
+    /** Non-editable GSAP config (stagger, yoyo, repeat, etc.) preserved for round-trips. */
+    extras?: Record<string, unknown>;
+    /** Native GSAP keyframes data — present when the tween uses keyframes: { ... }. */
+    keyframes?: GsapKeyframesData;
+    /** Arc motion path config — present when the tween uses motionPath for curved position interpolation. */
+    arcPath?: ArcPathConfig;
+    /** True when the tween has a `keyframes` property that couldn't be statically resolved (dynamic). */
+    hasUnresolvedKeyframes?: boolean;
+    /** True when the tween's target selector couldn't be statically resolved (dynamic). */
+    hasUnresolvedSelector?: boolean;
+    /** Absolute start time computed by walking the timeline chain (handles +=, -=, <, >, labels). */
+    resolvedStart?: number;
+    /** True when no position arg was authored — the tween is sequentially placed by GSAP. */
+    implicitPosition?: boolean;
+    /** Which property group this tween belongs to (position, scale, size, rotation, visual, other).
+     *  Undefined for legacy mixed tweens that bundle multiple groups. */
+    propertyGroup?: PropertyGroupName;
+    /** True for a base `gsap.set(...)` (a static hold that runs immediately, OFF the
+     *  timeline) rather than `tl.set(...)`. Carries no timeline position and shows no
+     *  keyframe marker — used to persist a static value (e.g. a 3D transform) without
+     *  introducing a 0% keyframe. */
+    global?: boolean;
+    /** How this tween was constructed in source. Absent ⇒ literal. */
+    provenance?: GsapProvenance;
+}
+interface GsapPercentageKeyframe {
+    percentage: number;
+    properties: Record<string, number | string>;
+    ease?: string;
+}
+type GsapKeyframeFormat = "percentage" | "object-array" | "simple-array";
+interface GsapKeyframesData {
+    format: GsapKeyframeFormat;
+    keyframes: GsapPercentageKeyframe[];
+    ease?: string;
+    easeEach?: string;
+}
+interface ArcPathSegment {
+    curviness: number;
+    cp1?: {
+        x: number;
+        y: number;
+    };
+    cp2?: {
+        x: number;
+        y: number;
+    };
+}
+interface ArcPathConfig {
+    enabled: boolean;
+    autoRotate: boolean | number;
+    segments: ArcPathSegment[];
+}
+interface MotionPathShape {
+    arcPath: ArcPathConfig;
+    waypoints: Array<{
+        x: number;
+        y: number;
+    }>;
+}
+/**
+ * Build arcPath segments + waypoints from resolved path coordinates. Shared by
+ * the AST parser (coords from literal nodes) and the runtime scanner (coords
+ * from a live `vars.motionPath`), so both produce identical arc config.
+ */
+declare function buildArcPath(coords: Array<{
+    x: number;
+    y: number;
+}>, curviness: number, autoRotate: boolean | number, isCubic: boolean): MotionPathShape | undefined;
+interface ParsedGsap {
+    animations: GsapAnimation[];
+    timelineVar: string;
+    preamble: string;
+    postamble: string;
+    multipleTimelines?: boolean;
+    unsupportedTimelinePattern?: boolean;
+}
+
+interface SplitAnimationsOptions {
+    originalId: string;
+    newId: string;
+    splitTime: number;
+    elementStart: number;
+    elementDuration: number;
+}
+interface SplitAnimationsResult {
+    script: string;
+    /** Non-ID-selector animations that the engine cannot safely retarget. */
+    skippedSelectors: string[];
+}
+declare function serializeGsapAnimations(animations: GsapAnimation[], timelineVar?: string, options?: {
+    includeMediaSync?: boolean;
+    preamble?: string;
+    postamble?: string;
+}): string;
+/**
+ * Filter animations to those targeting `#<elementId>` (id-only match). For the
+ * studio panel's id-OR-selector matching, see `getAnimationsForElement` in
+ * `useGsapTweenCache.ts` — distinct on purpose, hence the distinct name.
+ */
+declare function getAnimationsForElementId(animations: GsapAnimation[], elementId: string): GsapAnimation[];
+declare function validateCompositionGsap(script: string): ValidationResult;
+declare function keyframesToGsapAnimations(elementId: string, keyframes: Keyframe[], elementStartTime: number, base?: {
+    x?: number;
+    y?: number;
+    scale?: number;
+}): GsapAnimation[];
+declare function gsapAnimationsToKeyframes(animations: GsapAnimation[], elementStartTime: number, options?: {
+    baseX?: number;
+    baseY?: number;
+    baseScale?: number;
+    clampTimeToZero?: boolean;
+    skipBaseSet?: boolean;
+}): Keyframe[];
+
+export { type ArcPathConfig as A, type GsapAnimation as G, type KeyframeEditability as K, type MotionPathShape as M, type ParsedGsap as P, type SplitAnimationsOptions as S, type ArcPathSegment as a, type GsapKeyframesData as b, type GsapMethod as c, type GsapPercentageKeyframe as d, type GsapProvenance as e, type GsapProvenanceKind as f, type SplitAnimationsResult as g, editabilityForProvenance as h, getAnimationsForElementId as i, gsapAnimationsToKeyframes as j, keyframesToGsapAnimations as k, buildArcPath as l, type GsapKeyframeFormat as m, serializeGsapAnimations as s, validateCompositionGsap as v };

package/dist/gsapWriterAcorn.d.ts

@@ -1,4 +1,5 @@
-import { G as GsapAnimation, A as ArcPathConfig, S as SplitAnimationsOptions, g as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-B_JRTCeV.js';
+import { G as GsapAnimation, A as ArcPathConfig, S as SplitAnimationsOptions, g as SplitAnimationsResult, a as ArcPathSegment } from './gsapSerialize-Bei7m7M7.js';
+import './types-Cg0ZTXEf.js';
 import './gsapConstants.js';
 
 declare function updateAnimationInScript(script: string, animationId: string, updates: Partial<GsapAnimation> & {

package/dist/index.d.ts

@@ -1,10 +1,12 @@
-import { C as CompositionVariable, T as TimelineElement, n as CanvasResolution, o as Keyframe, p as StageZoomKeyframe, V as ValidationResult } from './gsapSerialize-B_JRTCeV.js';
-export { q as AddElementData, A as ArcPathConfig, a as ArcPathSegment, r as Asset, B as BooleanVariable, t as CANVAS_DIMENSIONS, u as COMPOSITION_VARIABLE_TYPES, w as ColorVariable, x as CompositionAPI, y as CompositionAsset, z as CompositionSpec, D as CompositionVariableBase, E as CompositionVariableType, F as DEFAULT_DURATIONS, H as ElementKeyframes, I as EnumVariable, J as FontVariable, G as GsapAnimation, b as GsapKeyframesData, c as GsapMethod, d as GsapPercentageKeyframe, e as GsapProvenance, f as GsapProvenanceKind, L as ImageVariable, K as KeyframeEditability, N as KeyframeProperties, O as MediaElementType, Q as MediaFile, R as NumberVariable, P as ParsedGsap, U as PlayerAPI, S as SplitAnimationsOptions, g as SplitAnimationsResult, W as StageZoom, X as StringVariable, Y as TIMELINE_COLORS, Z as TimelineCompositionElement, _ as TimelineElementBase, $ as TimelineElementType, a0 as TimelineMediaElement, a1 as TimelineTextElement, a2 as VALID_CANVAS_RESOLUTIONS, a3 as WaveformData, h as editabilityForProvenance, i as getAnimationsForElementId, a4 as getDefaultStageZoom, j as gsapAnimationsToKeyframes, a5 as isCompositionElement, a6 as isMediaElement, a7 as isTextElement, k as keyframesToGsapAnimations, a8 as normalizeResolutionFlag, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-B_JRTCeV.js';
+import { C as CompositionVariable, T as TimelineElement, a as CanvasResolution, K as Keyframe, S as StageZoomKeyframe, V as ValidationResult } from './types-Cg0ZTXEf.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, 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 isCompositionElement, y as isMediaElement, z as isTextElement, G as normalizeResolutionFlag } from './types-Cg0ZTXEf.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 SplitAnimationsOptions, g as SplitAnimationsResult, h as editabilityForProvenance, i as getAnimationsForElementId, j as gsapAnimationsToKeyframes, k as keyframesToGsapAnimations, s as serializeGsapAnimations, v as validateCompositionGsap } from './gsapSerialize-Bei7m7M7.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';
 export { parseGsapScriptAcorn as parseGsapScript } from './gsapParserAcorn.js';
 export { EXCLUDED_TAGS, ensureHfIds, mintHfId } from './hfIds.js';
+export { CANONICAL_FONT_DISPLAY_NAMES, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, decodeUrlPathVariants, resolveAliasDisplayName } from './composition.js';
 
 interface ParsedHtml {
     elements: TimelineElement[];

package/dist/index.js

@@ -2498,11 +2498,131 @@ function unrollComputedTimeline(script) {
   }
   return ms.toString();
 }
+
+// src/utils/urlPath.ts
+function decodeUrlPathVariants(path) {
+  const variants = [path];
+  try {
+    const decoded = decodeURIComponent(path);
+    if (decoded !== path) variants.unshift(decoded);
+  } catch {
+  }
+  return variants;
+}
+
+// src/fontAliases.ts
+var FONT_ALIAS_MAP = {
+  // ── Canonical bundled fonts (self-referencing) ────────────────────────
+  inter: "inter",
+  montserrat: "montserrat",
+  outfit: "outfit",
+  nunito: "nunito",
+  oswald: "oswald",
+  "league gothic": "league-gothic",
+  "archivo black": "archivo-black",
+  "space mono": "space-mono",
+  "ibm plex mono": "ibm-plex-mono",
+  "jetbrains mono": "jetbrains-mono",
+  "eb garamond": "eb-garamond",
+  "playfair display": "playfair-display",
+  "source code pro": "source-code-pro",
+  "noto sans jp": "noto-sans-jp",
+  roboto: "roboto",
+  "open sans": "open-sans",
+  lato: "lato",
+  poppins: "poppins",
+  // ── Common aliases → nearest canonical ────────────────────────────────
+  "helvetica neue": "inter",
+  helvetica: "inter",
+  arial: "inter",
+  "helvetica bold": "inter",
+  futura: "montserrat",
+  "din alternate": "montserrat",
+  "arial black": "montserrat",
+  "bebas neue": "league-gothic",
+  "courier new": "jetbrains-mono",
+  courier: "jetbrains-mono",
+  garamond: "eb-garamond",
+  "noto sans japanese": "noto-sans-jp",
+  "segoe ui": "roboto",
+  // ── macOS sans-serif system fonts → inter ─────────────────────────────
+  "sf pro": "inter",
+  "sf pro display": "inter",
+  "sf pro text": "inter",
+  "sf pro rounded": "inter",
+  avenir: "inter",
+  "avenir next": "inter",
+  "lucida grande": "inter",
+  geneva: "inter",
+  optima: "inter",
+  // ── Windows sans-serif system fonts → inter ───────────────────────────
+  verdana: "inter",
+  tahoma: "inter",
+  "trebuchet ms": "inter",
+  calibri: "inter",
+  candara: "inter",
+  corbel: "inter",
+  "lucida sans": "inter",
+  "lucida sans unicode": "inter",
+  // ── Linux sans-serif system fonts → inter ─────────────────────────────
+  "noto sans": "inter",
+  "dejavu sans": "inter",
+  "liberation sans": "inter",
+  // ── Monospace system fonts → jetbrains-mono ───────────────────────────
+  "sf mono": "jetbrains-mono",
+  menlo: "jetbrains-mono",
+  monaco: "jetbrains-mono",
+  consolas: "jetbrains-mono",
+  "lucida console": "jetbrains-mono",
+  "lucida sans typewriter": "jetbrains-mono",
+  "andale mono": "jetbrains-mono",
+  "dejavu sans mono": "jetbrains-mono",
+  "liberation mono": "jetbrains-mono",
+  // ── Serif system fonts → eb-garamond ──────────────────────────────────
+  georgia: "eb-garamond",
+  palatino: "eb-garamond",
+  "palatino linotype": "eb-garamond",
+  "book antiqua": "eb-garamond",
+  cambria: "eb-garamond",
+  times: "eb-garamond",
+  "times new roman": "eb-garamond",
+  "dejavu serif": "eb-garamond",
+  "liberation serif": "eb-garamond"
+};
+var FONT_ALIAS_KEYS = new Set(Object.keys(FONT_ALIAS_MAP));
+var CANONICAL_FONT_DISPLAY_NAMES = {
+  inter: "Inter",
+  montserrat: "Montserrat",
+  outfit: "Outfit",
+  nunito: "Nunito",
+  oswald: "Oswald",
+  "league-gothic": "League Gothic",
+  "archivo-black": "Archivo Black",
+  "space-mono": "Space Mono",
+  "ibm-plex-mono": "IBM Plex Mono",
+  "jetbrains-mono": "JetBrains Mono",
+  "eb-garamond": "EB Garamond",
+  "playfair-display": "Playfair Display",
+  "source-code-pro": "Source Code Pro",
+  "noto-sans-jp": "Noto Sans JP",
+  roboto: "Roboto",
+  "open-sans": "Open Sans",
+  lato: "Lato",
+  poppins: "Poppins"
+};
+function resolveAliasDisplayName(alias) {
+  const slug = FONT_ALIAS_MAP[alias.toLowerCase()];
+  if (!slug) return void 0;
+  return CANONICAL_FONT_DISPLAY_NAMES[slug];
+}
 export {
+  CANONICAL_FONT_DISPLAY_NAMES,
   CANVAS_DIMENSIONS,
   COMPOSITION_VARIABLE_TYPES,
   DEFAULT_DURATIONS,
   EXCLUDED_TAGS,
+  FONT_ALIAS_KEYS,
+  FONT_ALIAS_MAP,
   PROPERTY_GROUPS,
   SPRING_PRESETS,
   SUPPORTED_EASES,
@@ -2512,6 +2632,7 @@ export {
   addElementToHtml,
   classifyPropertyGroup,
   classifyTweenPropertyGroup,
+  decodeUrlPathVariants,
   editabilityForProvenance,
   ensureHfIds,
   extractCompositionMetadata,
@@ -2530,6 +2651,7 @@ export {
   parseHtml,
   queryByAttr,
   removeElementFromHtml,
+  resolveAliasDisplayName,
   serializeGsapAnimations,
   unrollComputedTimeline,
   updateElementInHtml,