@hyperframes/parsers 0.7.15 → 0.7.17

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

@@ -1051,6 +1051,34 @@ function objectExpressionToRecord(node, scope, source) {
 function isGsapTimelineCall(node) {
   return node?.type === "CallExpression" && node.callee?.type === "MemberExpression" && node.callee.object?.name === "gsap" && node.callee.property?.name === "timeline";
 }
+function staticMemberKey(node) {
+  if (!node || node.type !== "MemberExpression") return null;
+  if (node.computed) {
+    const p = node.property;
+    if (p?.type === "Literal" && typeof p.value === "string") return p.value;
+    return null;
+  }
+  return node.property?.type === "Identifier" ? node.property.name : null;
+}
+function isStaticMemberRef(node) {
+  return node?.type === "MemberExpression" && staticMemberKey(node) !== null;
+}
+function sameMemberAccess(a, b) {
+  if (a?.type !== "MemberExpression" || b?.type !== "MemberExpression") return false;
+  if (staticMemberKey(a) !== staticMemberKey(b) || staticMemberKey(a) === null) return false;
+  const ao = a.object;
+  const bo = b.object;
+  if (ao?.type === "Identifier" && bo?.type === "Identifier") return ao.name === bo.name;
+  if (ao?.type === "MemberExpression" && bo?.type === "MemberExpression")
+    return sameMemberAccess(ao, bo);
+  return false;
+}
+function timelineRootSource(ref, script) {
+  return ref.kind === "identifier" ? ref.name : script.slice(ref.node.start, ref.node.end);
+}
+function escapeRegExp(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 function extractTimelineDefaults(callNode, scope) {
   const arg = callNode.arguments?.[0];
   if (!arg || arg.type !== "ObjectExpression") return void 0;
@@ -1070,6 +1098,7 @@ function extractTimelineDefaults(callNode, scope) {
 }
 function findTimelineVar(ast, scope) {
   let timelineVar = null;
+  let ref = null;
   let timelineCount = 0;
   let defaults;
   const emptyScope = scope ?? /* @__PURE__ */ new Map();
@@ -1077,8 +1106,9 @@ function findTimelineVar(ast, scope) {
     VariableDeclarator(node) {
       if (isGsapTimelineCall(node.init)) {
         timelineCount += 1;
-        if (!timelineVar) {
-          timelineVar = node.id?.name ?? null;
+        if (!ref && node.id?.type === "Identifier") {
+          timelineVar = node.id.name;
+          ref = { kind: "identifier", name: node.id.name };
           defaults = extractTimelineDefaults(node.init, emptyScope);
         }
       }
@@ -1086,15 +1116,21 @@ function findTimelineVar(ast, scope) {
     AssignmentExpression(node) {
       if (isGsapTimelineCall(node.right)) {
         timelineCount += 1;
-        if (!timelineVar) {
+        if (!ref) {
           const left = node.left;
-          if (left?.type === "Identifier") timelineVar = left.name;
-          defaults = extractTimelineDefaults(node.right, emptyScope);
+          if (left?.type === "Identifier") {
+            timelineVar = left.name;
+            ref = { kind: "identifier", name: left.name };
+            defaults = extractTimelineDefaults(node.right, emptyScope);
+          } else if (isStaticMemberRef(left)) {
+            ref = { kind: "member", node: left };
+            defaults = extractTimelineDefaults(node.right, emptyScope);
+          }
         }
       }
     }
   });
-  return { timelineVar, timelineCount, defaults };
+  return { timelineVar, ref, timelineCount, defaults };
 }
 var BUILTIN_VAR_KEYS = /* @__PURE__ */ new Set(["duration", "ease", "delay"]);
 var DROPPED_VAR_KEYS = /* @__PURE__ */ new Set(["onComplete", "onStart", "onUpdate", "onRepeat"]);
@@ -1107,14 +1143,15 @@ var EXTRAS_KEYS = /* @__PURE__ */ new Set([
   "overwrite",
   "immediateRender"
 ]);
-function isTimelineRootedCall(callNode, timelineVar) {
+function isTimelineRootedCall(callNode, ref) {
   let obj = callNode.callee?.object;
   while (obj?.type === "CallExpression") {
     obj = obj.callee?.object;
   }
-  return obj?.type === "Identifier" && obj.name === timelineVar;
+  if (ref.kind === "identifier") return obj?.type === "Identifier" && obj.name === ref.name;
+  return sameMemberAccess(obj, ref.node);
 }
-function findAllTweenCalls(ast, timelineVar, scope, targetBindings) {
+function findAllTweenCalls(ast, ref, scope, targetBindings) {
   const results = [];
   function visit(node, ancestors) {
     if (!node || typeof node !== "object") return;
@@ -1123,7 +1160,7 @@ function findAllTweenCalls(ast, timelineVar, scope, targetBindings) {
       const callee = node.callee;
       const gsapSetArg = node.arguments?.[0];
       const isGlobalSet = callee?.type === "MemberExpression" && callee.object?.type === "Identifier" && callee.object.name === "gsap" && callee.property?.type === "Identifier" && callee.property.name === "set" && (gsapSetArg?.type === "StringLiteral" || gsapSetArg?.type === "Literal" && typeof gsapSetArg.value === "string");
-      if (callee?.type === "MemberExpression" && callee.property?.type === "Identifier" && (isTimelineRootedCall(node, timelineVar) || isGlobalSet) && GSAP_METHODS2.has(callee.property.name)) {
+      if (callee?.type === "MemberExpression" && callee.property?.type === "Identifier" && (isTimelineRootedCall(node, ref) || isGlobalSet) && GSAP_METHODS2.has(callee.property.name)) {
         const method = callee.property.name;
         const args = node.arguments;
         const selectorValue = args.length >= 1 ? resolveTargetSelector(args[0], nodeAncestors, scope, targetBindings) ?? "__unresolved__" : "__unresolved__";
@@ -1576,8 +1613,9 @@ function parseGsapScriptAcornForWrite(script) {
     const scope = collectScopeBindings(ast);
     const targetBindings = collectTargetBindings(ast, scope);
     const detection = findTimelineVar(ast, scope);
-    const timelineVar = detection.timelineVar ?? "tl";
-    const calls = findAllTweenCalls(ast, timelineVar, scope, targetBindings);
+    const ref = detection.ref ?? { kind: "identifier", name: "tl" };
+    const timelineVar = timelineRootSource(ref, script);
+    const calls = findAllTweenCalls(ast, ref, scope, targetBindings);
     sortBySourcePosition(calls);
     const rawAnims = calls.map((call) => tweenCallToAnimation(call, scope, script));
     applyTimelineDefaults(rawAnims, detection.defaults);
@@ -1588,7 +1626,7 @@ function parseGsapScriptAcornForWrite(script) {
       call,
       animation: animations[i]
     }));
-    return { ast, timelineVar, hasTimeline: detection.timelineVar !== null, located };
+    return { ast, timelineVar, hasTimeline: detection.ref !== null, located };
   } catch {
     return null;
   }
@@ -1602,24 +1640,25 @@ function parseGsapScriptAcorn(script) {
     });
     const scope = collectScopeBindings(ast);
     const detection = findTimelineVar(ast, scope);
-    const timelineVar = detection.timelineVar ?? "tl";
-    try {
-      inlineComputedTimelines(ast, timelineVar, (node) => resolveNode(node, scope));
-    } catch {
+    const ref = detection.ref ?? { kind: "identifier", name: "tl" };
+    const timelineVar = timelineRootSource(ref, script);
+    if (ref.kind === "identifier") {
+      try {
+        inlineComputedTimelines(ast, timelineVar, (node) => resolveNode(node, scope));
+      } catch {
+      }
     }
     const targetBindings = collectTargetBindings(ast, scope);
-    const calls = findAllTweenCalls(ast, timelineVar, scope, targetBindings);
+    const calls = findAllTweenCalls(ast, ref, scope, targetBindings);
     sortBySourcePosition(calls);
     const rawAnims = calls.map((call) => tweenCallToAnimation(call, scope, script));
     applyTimelineDefaults(rawAnims, detection.defaults);
     resolveTimelinePositions(rawAnims);
     const animations = assignStableIds(rawAnims);
-    const timelineMatch = script.match(
-      new RegExp(
-        `^[\\s\\S]*?(?:const|let|var)\\s+${timelineVar}\\s*=\\s*gsap\\.timeline\\s*\\([^)]*\\)\\s*;?`
-      )
-    );
-    const preamble = timelineMatch?.[0] ?? `const ${timelineVar} = gsap.timeline({ paused: true });`;
+    const declPattern = ref.kind === "identifier" ? `(?:const|let|var)\\s+${timelineVar}\\s*=\\s*gsap\\.timeline\\s*\\([^)]*\\)\\s*;?` : `${escapeRegExp(timelineVar)}\\s*=\\s*gsap\\.timeline\\s*\\([^)]*\\)\\s*;?`;
+    const timelineMatch = script.match(new RegExp(`^[\\s\\S]*?${declPattern}`));
+    const fallbackPreamble = ref.kind === "identifier" ? `const ${timelineVar} = gsap.timeline({ paused: true });` : `${timelineVar} = gsap.timeline({ paused: true });`;
+    const preamble = timelineMatch?.[0] ?? fallbackPreamble;
     const lastCallIdx = script.lastIndexOf(`${timelineVar}.`);
     let postamble = "";
     if (lastCallIdx !== -1) {
@@ -1631,7 +1670,7 @@ function parseGsapScriptAcorn(script) {
     }
     const result = { animations, timelineVar, preamble, postamble };
     if (detection.timelineCount > 1) result.multipleTimelines = true;
-    if (detection.timelineCount > 0 && detection.timelineVar === null)
+    if (detection.timelineCount > 0 && detection.ref === null)
       result.unsupportedTimelinePattern = true;
     return result;
   } catch {
@@ -2459,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,
@@ -2473,6 +2632,7 @@ export {
   addElementToHtml,
   classifyPropertyGroup,
   classifyTweenPropertyGroup,
+  decodeUrlPathVariants,
   editabilityForProvenance,
   ensureHfIds,
   extractCompositionMetadata,
@@ -2491,6 +2651,7 @@ export {
   parseHtml,
   queryByAttr,
   removeElementFromHtml,
+  resolveAliasDisplayName,
   serializeGsapAnimations,
   unrollComputedTimeline,
   updateElementInHtml,