@hyperframes/parsers 0.7.45 → 0.7.47

package/dist/composition.d.ts

@@ -1,7 +1,64 @@
-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, C as CompositionVariable, 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, 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 isCompositionElement, y as isMediaElement, z as isTextElement, G as normalizeResolutionFlag } from './types-CaeOJXdW.js';
+import { C as CompositionVariable } from './types-CaeOJXdW.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, 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 isCompositionElement, y as isMediaElement, z as isTextElement, G as normalizeResolutionFlag } from './types-CaeOJXdW.js';
+
+/**
+ * Browser-safe parser for the `data-composition-variables` schema attribute.
+ * Lives outside htmlParser.ts so browser consumers (SDK, Studio, lint) can
+ * import it via `@hyperframes/parsers/composition` without pulling the
+ * linkedom/Node HTML-parser machinery from the main entry.
+ */
+
+/**
+ * Scalar variable values (string/number/boolean) are the ones that flow into
+ * CSS custom props and text bindings; font/image values are object-shaped.
+ * Shared so the SDK's CSS-compat writes, the runtime bindings, and Studio's
+ * display logic can never disagree on what "scalar" means.
+ */
+declare function isScalarVariableValue(value: unknown): value is string | number | boolean;
+/**
+ * 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
+ * same predicate parseCompositionVariables filters with — exported so writers
+ * (SDK declaration ops, Studio forms) can validate before persisting.
+ */
+declare function isCompositionVariable(v: unknown): v is CompositionVariable;
+/**
+ * Parse the typed variable declarations from an element's
+ * `data-composition-variables` attribute. Malformed entries (wrong shape,
+ * unknown type, default not matching the declared type) are dropped; an
+ * absent attribute, invalid JSON, or a non-array payload yields `[]`.
+ */
+declare function parseCompositionVariables(htmlEl: Element): CompositionVariable[];
 
 declare function decodeUrlPathVariants(path: string): string[];
 
+/**
+ * Browser-safe static scan for composition-variable reads in script text.
+ *
+ * Compositions read variables by calling the runtime API — `getVariables()`
+ * bare (sub-comp scoped shadow) or via `__hyperframes.getVariables()` /
+ * `window.__hyperframes.getVariables()` — and there is no DOM-attribute
+ * binding to scan, so "which variables does this composition use" can only be
+ * derived from the scripts. This is a best-effort static analysis: the
+ * patterns agents actually write (destructuring, member access, a single
+ * alias variable) resolve to ids; anything opaque flips `scanIncomplete`
+ * so consumers can present usage as a lower bound instead of a fact.
+ *
+ * AST nodes are handled untyped (same convention as gsapParserAcorn.ts) —
+ * acorn's structural types don't survive acorn-walk's visitor signatures.
+ */
+interface VariableUsageScan {
+    /** Variable ids statically read by the script, in first-seen order. */
+    usedIds: string[];
+    /**
+     * True when the script accesses variables in a way the scan cannot resolve
+     * (computed keys, rest spreads, the values object escaping into a call…) or
+     * when the script fails to parse — usedIds is then a lower bound.
+     */
+    scanIncomplete: boolean;
+}
+declare function scanVariableUsage(scriptText: string): VariableUsageScan;
+
 /**
  * Single source of truth for the deterministic font alias map. Both the
  * producer's @font-face injector and the core lint rules import from here,
@@ -93,4 +150,4 @@ declare const CANONICAL_FONT_DISPLAY_NAMES: Readonly<Record<string, string>>;
  */
 declare function resolveAliasDisplayName(alias: string): string | undefined;
 
-export { CANONICAL_FONT_DISPLAY_NAMES, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, decodeUrlPathVariants, resolveAliasDisplayName };
+export { CANONICAL_FONT_DISPLAY_NAMES, CompositionVariable, FONT_ALIAS_KEYS, FONT_ALIAS_MAP, type VariableUsageScan, decodeUrlPathVariants, isCompositionVariable, isScalarVariableValue, parseCompositionVariables, resolveAliasDisplayName, scanVariableUsage };

package/dist/composition.js

@@ -187,6 +187,153 @@ function decodeUrlPathVariants(path) {
   }
   return variants;
 }
+
+// src/compositionVariables.ts
+var DEFAULT_TYPEOF = {
+  string: "string",
+  number: "number",
+  color: "string",
+  boolean: "boolean",
+  enum: "string",
+  font: "string",
+  image: "string"
+};
+function isScalarVariableValue(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function isRecord(v) {
+  return typeof v === "object" && v !== null;
+}
+function isVariableType(t) {
+  return typeof t === "string" && t in DEFAULT_TYPEOF;
+}
+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 (typeof v.default !== DEFAULT_TYPEOF[v.type]) return false;
+  if (v.type === "enum" && !Array.isArray(v.options)) return false;
+  return true;
+}
+function parseCompositionVariables(htmlEl) {
+  const variablesAttr = htmlEl.getAttribute("data-composition-variables");
+  if (!variablesAttr) {
+    return [];
+  }
+  try {
+    const parsed = JSON.parse(variablesAttr);
+    if (!Array.isArray(parsed)) {
+      return [];
+    }
+    return parsed.filter(isCompositionVariable);
+  } catch {
+    return [];
+  }
+}
+
+// src/variableUsage.ts
+import * as acorn from "acorn";
+import * as acornWalk from "acorn-walk";
+function isGetVariablesCallee(callee) {
+  if (callee?.type === "Identifier") return callee.name === "getVariables";
+  if (callee?.type === "MemberExpression" && !callee.computed) {
+    return callee.property?.type === "Identifier" && callee.property.name === "getVariables";
+  }
+  return false;
+}
+function collectFromObjectPattern(pattern, out) {
+  for (const prop of pattern.properties ?? []) {
+    if (prop?.type === "RestElement") {
+      out.incomplete();
+      continue;
+    }
+    if (prop?.type !== "Property") continue;
+    if (prop.computed === true) {
+      out.incomplete();
+    } else if (prop.key?.type === "Identifier") {
+      out.use(String(prop.key.name));
+    } else if (prop.key?.type === "Literal" && typeof prop.key.value === "string") {
+      out.use(prop.key.value);
+    } else {
+      out.incomplete();
+    }
+  }
+}
+function collectFromMemberAccess(member, out) {
+  if (member.computed !== true && member.property?.type === "Identifier") {
+    out.use(String(member.property.name));
+  } else if (member.computed === true && member.property?.type === "Literal" && typeof member.property.value === "string") {
+    out.use(member.property.value);
+  } else {
+    out.incomplete();
+  }
+}
+function classifyValueRead(parent, valueNode, out) {
+  if (!parent || parent.type === "ExpressionStatement") {
+    return null;
+  }
+  if (parent.type === "MemberExpression" && parent.object === valueNode) {
+    collectFromMemberAccess(parent, out);
+    return null;
+  }
+  if (parent.type === "VariableDeclarator" && parent.init === valueNode) {
+    if (parent.id?.type === "ObjectPattern") {
+      collectFromObjectPattern(parent.id, out);
+      return null;
+    }
+    if (parent.id?.type === "Identifier") return String(parent.id.name);
+    out.incomplete();
+    return null;
+  }
+  out.incomplete();
+  return null;
+}
+function scanVariableUsage(scriptText) {
+  const usedIds = [];
+  const seen = /* @__PURE__ */ new Set();
+  let scanIncomplete = false;
+  const sink = {
+    use(id) {
+      if (!seen.has(id)) {
+        seen.add(id);
+        usedIds.push(id);
+      }
+    },
+    incomplete() {
+      scanIncomplete = true;
+    }
+  };
+  let ast;
+  try {
+    ast = acorn.parse(scriptText, { ecmaVersion: "latest", sourceType: "script" });
+  } catch {
+    return { usedIds: [], scanIncomplete: true };
+  }
+  const aliases = /* @__PURE__ */ new Set();
+  acornWalk.ancestor(ast, {
+    CallExpression(node, _, ancestors) {
+      if (!isGetVariablesCallee(node.callee)) return;
+      const parent = ancestors[ancestors.length - 2];
+      const alias = classifyValueRead(parent, node, sink);
+      if (alias) aliases.add(alias);
+    }
+  });
+  if (aliases.size > 0) {
+    acornWalk.ancestor(ast, {
+      // fallow-ignore-next-line complexity
+      Identifier(node, _, ancestors) {
+        if (!aliases.has(String(node.name))) return;
+        const parent = ancestors[ancestors.length - 2];
+        if (!parent) return;
+        if (parent.type === "VariableDeclarator" && parent.id === node) return;
+        if (parent.type === "MemberExpression" && parent.property === node) return;
+        if (parent.type === "Property" && parent.key === node && parent.computed !== true) return;
+        if (classifyValueRead(parent, node, sink)) sink.incomplete();
+      }
+    });
+  }
+  return { usedIds, scanIncomplete };
+}
 export {
   CANONICAL_FONT_DISPLAY_NAMES,
   CANVAS_DIMENSIONS,
@@ -199,9 +346,13 @@ export {
   decodeUrlPathVariants,
   getDefaultStageZoom,
   isCompositionElement,
+  isCompositionVariable,
   isMediaElement,
+  isScalarVariableValue,
   isTextElement,
   normalizeResolutionFlag,
-  resolveAliasDisplayName
+  parseCompositionVariables,
+  resolveAliasDisplayName,
+  scanVariableUsage
 };
 //# sourceMappingURL=composition.js.map

package/dist/composition.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/fontAliases.ts","../src/utils/urlPath.ts"],"sourcesContent":["// ── Composition data types ───────────────────────────────────────────────────\n// Moved from @hyperframes/core/core.types in the parsers extraction refactor.\n// These are the types produced and consumed by the parser pipeline.\n\nexport interface Asset {\n  id: string;\n  url: string;\n  type: string;\n  is_reference?: boolean;\n  /** Duration in seconds for video/audio assets */\n  duration?: number;\n}\n\n// ── Timeline types ──────────────────────────────────────────────────────────\n\nexport type TimelineElementType = \"video\" | \"image\" | \"text\" | \"audio\" | \"composition\";\nexport type MediaElementType = \"video\" | \"image\" | \"audio\";\n\nexport const CANVAS_DIMENSIONS = {\n  landscape: { width: 1920, height: 1080 },\n  portrait: { width: 1080, height: 1920 },\n  \"landscape-4k\": { width: 3840, height: 2160 },\n  \"portrait-4k\": { width: 2160, height: 3840 },\n  square: { width: 1080, height: 1080 },\n  \"square-4k\": { width: 2160, height: 2160 },\n} as const;\n\n// Single source of truth: derive the type from the table so adding a preset\n// extends the union automatically. Avoids the prior `as readonly CanvasResolution[]`\n// cast on `VALID_CANVAS_RESOLUTIONS` quietly drifting if the table grew but\n// the union didn't.\nexport type CanvasResolution = keyof typeof CANVAS_DIMENSIONS;\n\n// `Object.keys` ordering matches insertion order in `CANVAS_DIMENSIONS` on\n// every supported JS engine; tests pin the order in `index.test.ts`. Reorder\n// the table above with care.\nexport const VALID_CANVAS_RESOLUTIONS = Object.keys(\n  CANVAS_DIMENSIONS,\n) as readonly CanvasResolution[];\n\nconst RESOLUTION_ALIASES: Record<string, CanvasResolution> = {\n  \"1080p\": \"landscape\",\n  hd: \"landscape\",\n  \"1080p-portrait\": \"portrait\",\n  \"portrait-1080p\": \"portrait\",\n  \"4k\": \"landscape-4k\",\n  uhd: \"landscape-4k\",\n  \"4k-portrait\": \"portrait-4k\",\n  \"1080p-square\": \"square\",\n  \"square-1080p\": \"square\",\n  \"4k-square\": \"square-4k\",\n};\n\n/**\n * Map a user-facing resolution string (canonical name or alias) to a\n * `CanvasResolution`. Returns undefined for unknown values so callers\n * can produce their own \"invalid\" UX (CLI exit, route validation, etc.).\n */\nexport function normalizeResolutionFlag(input: string | undefined): CanvasResolution | undefined {\n  if (!input) return undefined;\n  const lowered = input.toLowerCase();\n  if ((VALID_CANVAS_RESOLUTIONS as readonly string[]).includes(lowered)) {\n    return lowered as CanvasResolution;\n  }\n  return RESOLUTION_ALIASES[lowered];\n}\n\nexport interface TimelineElementBase {\n  id: string;\n  type: TimelineElementType;\n  name: string;\n  startTime: number;\n  duration: number;\n  zIndex: number;\n  x?: number;\n  y?: number;\n  scale?: number;\n  opacity?: number;\n}\n\nexport interface TimelineMediaElement extends TimelineElementBase {\n  type: MediaElementType;\n  src: string;\n  mediaStartTime?: number;\n  sourceDuration?: number;\n  isAroll?: boolean;\n  sourceWidth?: number;\n  sourceHeight?: number;\n  volume?: number; // 0-1 (0% to 100%), default 1.0\n  hasAudio?: boolean; // For videos - indicates if video has audio track\n}\n\nexport interface WaveformData {\n  peaks: number[];\n  duration: number;\n  sampleRate?: number;\n}\n\nexport interface TimelineTextElement extends TimelineElementBase {\n  type: \"text\";\n  content: string;\n  color?: string;\n  fontSize?: number;\n  textShadow?: boolean;\n  fontFamily?: string;\n  fontWeight?: number;\n  textOutline?: boolean;\n  textOutlineColor?: string;\n  textOutlineWidth?: number;\n  textHighlight?: boolean;\n  textHighlightColor?: string;\n  textHighlightPadding?: number;\n  textHighlightRadius?: number;\n}\n\nexport interface TimelineCompositionElement extends TimelineElementBase {\n  type: \"composition\";\n  src: string;\n  compositionId: string;\n  scale?: number;\n  sourceDuration?: number;\n  variableValues?: Record<string, string | number | boolean>;\n  sourceWidth?: number;\n  sourceHeight?: number;\n}\n\n// Composition Variable Types\nexport type CompositionVariableType =\n  | \"string\"\n  | \"number\"\n  | \"color\"\n  | \"boolean\"\n  | \"enum\"\n  | \"font\"\n  | \"image\";\n\n/**\n * Runtime list of every valid `CompositionVariableType`. Use this anywhere\n * a Set/array of valid type strings is needed (lint rules, validators).\n * The `satisfies` guard turns adding a new variant to the union without\n * also adding it here into a compile error.\n */\nexport const COMPOSITION_VARIABLE_TYPES = [\n  \"string\",\n  \"number\",\n  \"color\",\n  \"boolean\",\n  \"enum\",\n  \"font\",\n  \"image\",\n] as const satisfies readonly CompositionVariableType[];\n\nexport interface CompositionVariableBase {\n  id: string;\n  type: CompositionVariableType;\n  label: string;\n  description?: string;\n}\n\nexport interface StringVariable extends CompositionVariableBase {\n  type: \"string\";\n  default: string;\n  placeholder?: string;\n  maxLength?: number;\n}\n\nexport interface NumberVariable extends CompositionVariableBase {\n  type: \"number\";\n  default: number;\n  min?: number;\n  max?: number;\n  step?: number;\n  unit?: string;\n}\n\nexport interface ColorVariable extends CompositionVariableBase {\n  type: \"color\";\n  default: string;\n  /** Brand role identifier, e.g. \"color:primary\". */\n  brandRole?: string;\n}\n\nexport interface BooleanVariable extends CompositionVariableBase {\n  type: \"boolean\";\n  default: boolean;\n}\n\nexport interface EnumVariable extends CompositionVariableBase {\n  type: \"enum\";\n  default: string;\n  options: { value: string; label: string }[];\n}\n\n/**\n * Font variable — value is a `{name, source}` object (object-valued; LOCKED §7).\n * `default` is the fallback font-family name string.\n * `source` is the font stylesheet URL (e.g. Google Fonts CSS).\n * `default_name` / `default_source` are the CSS-level fallbacks when the\n * brand font is absent.\n */\nexport interface FontVariable extends CompositionVariableBase {\n  type: \"font\";\n  /** Fallback font-family name, e.g. \"Inter\". */\n  default: string;\n  /** Font stylesheet URL (e.g. Google Fonts CSS link). */\n  source?: string;\n  /** CSS font-family name to use when source is unavailable, e.g. \"sans-serif\". */\n  default_name?: string;\n  /** Fallback font stylesheet URL (empty string = system font). */\n  default_source?: string;\n}\n\n/**\n * Image variable — value is a `{url, …}` object (object-valued; LOCKED §7).\n * `default` is the fallback image URL string.\n * `brandRole` is an optional semantic label, e.g. \"logo:primary\".\n */\nexport interface ImageVariable extends CompositionVariableBase {\n  type: \"image\";\n  /** Fallback image URL. */\n  default: string;\n  /** Brand role identifier, e.g. \"logo:primary\". */\n  brandRole?: string;\n}\n\nexport type CompositionVariable =\n  | StringVariable\n  | NumberVariable\n  | ColorVariable\n  | BooleanVariable\n  | EnumVariable\n  | FontVariable\n  | ImageVariable;\n\nexport interface CompositionSpec {\n  id: string;\n  duration: number;\n  variables: CompositionVariable[];\n}\n\nexport type TimelineElement =\n  | TimelineMediaElement\n  | TimelineTextElement\n  | TimelineCompositionElement;\n\nexport function isTextElement(el: TimelineElement): el is TimelineTextElement {\n  return el.type === \"text\";\n}\n\nexport function isMediaElement(el: TimelineElement): el is TimelineMediaElement {\n  return el.type === \"video\" || el.type === \"image\" || el.type === \"audio\";\n}\n\nexport function isCompositionElement(el: TimelineElement): el is TimelineCompositionElement {\n  return el.type === \"composition\";\n}\n\nexport interface MediaFile {\n  id: string;\n  name: string;\n  type: TimelineElementType;\n  src: string;\n  file?: File;\n  duration?: number;\n  compositionId?: string;\n  sourceWidth?: number; // Intrinsic width for compositions\n  sourceHeight?: number; // Intrinsic height for compositions\n}\n\nexport const TIMELINE_COLORS: Record<TimelineElementType, string> = {\n  video: \"#ec4899\",\n  image: \"#3b82f6\",\n  text: \"#06b6d4\",\n  audio: \"#10b981\",\n  composition: \"#f97316\",\n};\n\nexport const DEFAULT_DURATIONS: Record<TimelineElementType, number> = {\n  video: 5,\n  image: 5,\n  text: 2,\n  audio: 5,\n  composition: 5,\n};\n\nexport interface CompositionAPI {\n  id: string;\n  duration: number;\n  seek(time: number): void;\n  getTime(): number;\n  getDuration(): number;\n}\n\n// ── Player API types (used by runtime) ────────────────────────────────────\n\nexport interface PlayerAPI {\n  play(): void;\n  pause(): void;\n  seek(time: number, options?: { keepPlaying?: boolean }): void;\n  getTime(): number;\n  getDuration(): number;\n  isPlaying(): boolean;\n  getMainTimeline(): unknown;\n  getElementBounds(elementId: string): void;\n  getElementsAtPoint(x: number, y: number): void;\n  setElementPosition(elementId: string, x: number, y: number): void;\n  previewElementPosition(elementId: string, x: number, y: number): void;\n  setElementKeyframes(\n    elementId: string,\n    keyframes: Array<{\n      id: string;\n      time: number;\n      properties: { x?: number; y?: number };\n    }> | null,\n  ): void;\n  setElementScale(elementId: string, scale: number): void;\n  setElementFontSize(elementId: string, fontSize: number): void;\n  setElementTextContent(elementId: string, content: string): void;\n  setElementTextColor(elementId: string, color: string): void;\n  setElementTextShadow(elementId: string, enabled: boolean): void;\n  setElementTextFontWeight(elementId: string, weight: number): void;\n  setElementTextFontFamily(elementId: string, fontFamily: string): void;\n  setElementTextOutline(elementId: string, enabled: boolean, color?: string, width?: number): void;\n  setElementTextHighlight(\n    elementId: string,\n    enabled: boolean,\n    color?: string,\n    padding?: number,\n    radius?: number,\n  ): void;\n  setElementVolume(elementId: string, volume: number): void;\n  setStageZoom(scale: number, focusX: number, focusY: number): void;\n  getStageZoom(): { scale: number; focusX: number; focusY: number };\n  setStageZoomKeyframes(\n    keyframes: Array<{\n      id: string;\n      time: number;\n      zoom: { scale: number; focusX: number; focusY: number };\n      ease?: string;\n    }> | null,\n  ): void;\n  getStageZoomKeyframes(): Array<{\n    id: string;\n    time: number;\n    zoom: { scale: number; focusX: number; focusY: number };\n    ease?: string;\n  }>;\n  addElement(data: AddElementData): boolean;\n  removeElement(elementId: string): boolean;\n  updateElementTiming(elementId: string, start?: number, end?: number): boolean;\n  setElementTiming(\n    elementId: string,\n    startTime: number,\n    duration: number,\n    mediaStartTime?: number,\n  ): void;\n  updateElementSrc(elementId: string, src: string): boolean;\n  updateElementLayer(elementId: string, zIndex: number): boolean;\n  updateElementBasePosition(elementId: string, x?: number, y?: number, scale?: number): boolean;\n  markTimelineDirty(): void;\n  isTimelineDirty(): boolean;\n  rebuildTimeline(): void;\n  ensureTimeline(): void;\n  enableRenderMode(): void;\n  disableRenderMode(): void;\n  renderSeek(time: number, options?: { suppressEvents?: boolean }): void;\n  getElementVisibility(elementId: string): { visible: boolean; opacity?: number };\n  getVisibleElements(): Array<{ id: string; tagName: string; start: number; end: number }>;\n  getRenderState(): {\n    time: number;\n    duration: number;\n    isPlaying: boolean;\n    renderMode: boolean;\n    timelineDirty: boolean;\n  };\n}\n\nexport interface AddElementData {\n  id: string;\n  type: \"video\" | \"image\" | \"text\" | \"audio\" | \"composition\";\n  name?: string;\n  src?: string;\n  content?: string;\n  start: number;\n  end: number;\n  zIndex?: number;\n  x?: number;\n  y?: number;\n  scale?: number;\n  fontSize?: number;\n  color?: string;\n  textShadow?: boolean;\n  fontWeight?: number;\n  textOutline?: boolean;\n  textOutlineColor?: string;\n  textOutlineWidth?: number;\n  textHighlight?: boolean;\n  textHighlightColor?: string;\n  textHighlightPadding?: number;\n  textHighlightRadius?: number;\n  compositionId?: string;\n  sourceWidth?: number;\n  sourceHeight?: number;\n  isAroll?: boolean;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n\nexport interface CompositionAsset {\n  id: string;\n  name: string;\n  type: \"composition\";\n  src: string;\n  duration: number;\n  compositionId: string;\n  thumbnail?: string;\n}\n\nexport interface Keyframe {\n  id: string;\n  time: number;\n  properties: Partial<KeyframeProperties>;\n  ease?: string;\n}\n\nexport interface KeyframeProperties {\n  x: number;\n  y: number;\n  opacity: number;\n  scale: number;\n  scaleX: number;\n  scaleY: number;\n  rotation: number;\n  width: number;\n  height: number;\n}\n\nexport interface ElementKeyframes {\n  elementId: string;\n  keyframes: Keyframe[];\n}\n\nexport interface StageZoom {\n  scale: number;\n  focusX: number;\n  focusY: number;\n}\n\nexport interface StageZoomKeyframe {\n  id: string;\n  time: number;\n  zoom: StageZoom;\n  ease?: string;\n}\n\nexport function getDefaultStageZoom(resolution: CanvasResolution): StageZoom {\n  const { width, height } = CANVAS_DIMENSIONS[resolution];\n  return {\n    scale: 1,\n    focusX: width / 2,\n    focusY: height / 2,\n  };\n}\n","/**\n * Single source of truth for the deterministic font alias map. Both the\n * producer's @font-face injector and the core lint rules import from here,\n * eliminating manual drift between the two.\n *\n * Keys are lowercase font family names. Values are canonical font slugs\n * matching CANONICAL_FONTS keys in the producer's deterministicFonts module.\n */\nexport const FONT_ALIAS_MAP = {\n  // ── Canonical bundled fonts (self-referencing) ────────────────────────\n  inter: \"inter\",\n  montserrat: \"montserrat\",\n  outfit: \"outfit\",\n  nunito: \"nunito\",\n  oswald: \"oswald\",\n  \"league gothic\": \"league-gothic\",\n  \"archivo black\": \"archivo-black\",\n  \"space mono\": \"space-mono\",\n  \"ibm plex mono\": \"ibm-plex-mono\",\n  \"jetbrains mono\": \"jetbrains-mono\",\n  \"eb garamond\": \"eb-garamond\",\n  \"playfair display\": \"playfair-display\",\n  \"source code pro\": \"source-code-pro\",\n  \"noto sans jp\": \"noto-sans-jp\",\n  roboto: \"roboto\",\n  \"open sans\": \"open-sans\",\n  lato: \"lato\",\n  poppins: \"poppins\",\n\n  // ── Common aliases → nearest canonical ────────────────────────────────\n  \"helvetica neue\": \"inter\",\n  helvetica: \"inter\",\n  arial: \"inter\",\n  \"helvetica bold\": \"inter\",\n  futura: \"montserrat\",\n  \"din alternate\": \"montserrat\",\n  \"arial black\": \"montserrat\",\n  \"bebas neue\": \"league-gothic\",\n  \"courier new\": \"jetbrains-mono\",\n  courier: \"jetbrains-mono\",\n  garamond: \"eb-garamond\",\n  \"noto sans japanese\": \"noto-sans-jp\",\n  \"segoe ui\": \"roboto\",\n\n  // ── macOS sans-serif system fonts → inter ─────────────────────────────\n  \"sf pro\": \"inter\",\n  \"sf pro display\": \"inter\",\n  \"sf pro text\": \"inter\",\n  \"sf pro rounded\": \"inter\",\n  avenir: \"inter\",\n  \"avenir next\": \"inter\",\n  \"lucida grande\": \"inter\",\n  geneva: \"inter\",\n  optima: \"inter\",\n\n  // ── Windows sans-serif system fonts → inter ───────────────────────────\n  verdana: \"inter\",\n  tahoma: \"inter\",\n  \"trebuchet ms\": \"inter\",\n  calibri: \"inter\",\n  candara: \"inter\",\n  corbel: \"inter\",\n  \"lucida sans\": \"inter\",\n  \"lucida sans unicode\": \"inter\",\n\n  // ── Linux sans-serif system fonts → inter ─────────────────────────────\n  \"noto sans\": \"inter\",\n  \"dejavu sans\": \"inter\",\n  \"liberation sans\": \"inter\",\n\n  // ── Monospace system fonts → jetbrains-mono ───────────────────────────\n  \"sf mono\": \"jetbrains-mono\",\n  menlo: \"jetbrains-mono\",\n  monaco: \"jetbrains-mono\",\n  consolas: \"jetbrains-mono\",\n  \"lucida console\": \"jetbrains-mono\",\n  \"lucida sans typewriter\": \"jetbrains-mono\",\n  \"andale mono\": \"jetbrains-mono\",\n  \"dejavu sans mono\": \"jetbrains-mono\",\n  \"liberation mono\": \"jetbrains-mono\",\n\n  // ── Serif system fonts → eb-garamond ──────────────────────────────────\n  georgia: \"eb-garamond\",\n  palatino: \"eb-garamond\",\n  \"palatino linotype\": \"eb-garamond\",\n  \"book antiqua\": \"eb-garamond\",\n  cambria: \"eb-garamond\",\n  times: \"eb-garamond\",\n  \"times new roman\": \"eb-garamond\",\n  \"dejavu serif\": \"eb-garamond\",\n  \"liberation serif\": \"eb-garamond\",\n} satisfies Readonly<Record<string, string>>;\n\nexport const FONT_ALIAS_KEYS: ReadonlySet<string> = new Set(Object.keys(FONT_ALIAS_MAP));\n\n/**\n * Human-readable display names for canonical font slugs. Used by the lint\n * rule to tell authors what their aliased font will render as.\n */\nexport const CANONICAL_FONT_DISPLAY_NAMES: Readonly<Record<string, string>> = {\n  inter: \"Inter\",\n  montserrat: \"Montserrat\",\n  outfit: \"Outfit\",\n  nunito: \"Nunito\",\n  oswald: \"Oswald\",\n  \"league-gothic\": \"League Gothic\",\n  \"archivo-black\": \"Archivo Black\",\n  \"space-mono\": \"Space Mono\",\n  \"ibm-plex-mono\": \"IBM Plex Mono\",\n  \"jetbrains-mono\": \"JetBrains Mono\",\n  \"eb-garamond\": \"EB Garamond\",\n  \"playfair-display\": \"Playfair Display\",\n  \"source-code-pro\": \"Source Code Pro\",\n  \"noto-sans-jp\": \"Noto Sans JP\",\n  roboto: \"Roboto\",\n  \"open-sans\": \"Open Sans\",\n  lato: \"Lato\",\n  poppins: \"Poppins\",\n};\n\n/**\n * Resolve a font alias to its canonical display name, or undefined if the\n * alias is not in the map.\n */\nexport function resolveAliasDisplayName(alias: string): string | undefined {\n  const slug = (FONT_ALIAS_MAP as Record<string, string>)[alias.toLowerCase()];\n  if (!slug) return undefined;\n  return CANONICAL_FONT_DISPLAY_NAMES[slug];\n}\n","export function decodeUrlPathVariants(path: string): string[] {\n  const variants = [path];\n  try {\n    const decoded = decodeURIComponent(path);\n    if (decoded !== path) variants.unshift(decoded);\n  } catch {\n    // Malformed percent sequences may be literal filesystem names.\n  }\n\n  return variants;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types.ts","../src/fontAliases.ts","../src/utils/urlPath.ts","../src/compositionVariables.ts","../src/variableUsage.ts"],"sourcesContent":["// ── Composition data types ───────────────────────────────────────────────────\n// Moved from @hyperframes/core/core.types in the parsers extraction refactor.\n// These are the types produced and consumed by the parser pipeline.\n\nexport interface Asset {\n  id: string;\n  url: string;\n  type: string;\n  is_reference?: boolean;\n  /** Duration in seconds for video/audio assets */\n  duration?: number;\n}\n\n// ── Timeline types ──────────────────────────────────────────────────────────\n\nexport type TimelineElementType = \"video\" | \"image\" | \"text\" | \"audio\" | \"composition\";\nexport type MediaElementType = \"video\" | \"image\" | \"audio\";\n\nexport const CANVAS_DIMENSIONS = {\n  landscape: { width: 1920, height: 1080 },\n  portrait: { width: 1080, height: 1920 },\n  \"landscape-4k\": { width: 3840, height: 2160 },\n  \"portrait-4k\": { width: 2160, height: 3840 },\n  square: { width: 1080, height: 1080 },\n  \"square-4k\": { width: 2160, height: 2160 },\n} as const;\n\n// Single source of truth: derive the type from the table so adding a preset\n// extends the union automatically. Avoids the prior `as readonly CanvasResolution[]`\n// cast on `VALID_CANVAS_RESOLUTIONS` quietly drifting if the table grew but\n// the union didn't.\nexport type CanvasResolution = keyof typeof CANVAS_DIMENSIONS;\n\n// `Object.keys` ordering matches insertion order in `CANVAS_DIMENSIONS` on\n// every supported JS engine; tests pin the order in `index.test.ts`. Reorder\n// the table above with care.\nexport const VALID_CANVAS_RESOLUTIONS = Object.keys(\n  CANVAS_DIMENSIONS,\n) as readonly CanvasResolution[];\n\nconst RESOLUTION_ALIASES: Record<string, CanvasResolution> = {\n  \"1080p\": \"landscape\",\n  hd: \"landscape\",\n  \"1080p-portrait\": \"portrait\",\n  \"portrait-1080p\": \"portrait\",\n  \"4k\": \"landscape-4k\",\n  uhd: \"landscape-4k\",\n  \"4k-portrait\": \"portrait-4k\",\n  \"1080p-square\": \"square\",\n  \"square-1080p\": \"square\",\n  \"4k-square\": \"square-4k\",\n};\n\n/**\n * Map a user-facing resolution string (canonical name or alias) to a\n * `CanvasResolution`. Returns undefined for unknown values so callers\n * can produce their own \"invalid\" UX (CLI exit, route validation, etc.).\n */\nexport function normalizeResolutionFlag(input: string | undefined): CanvasResolution | undefined {\n  if (!input) return undefined;\n  const lowered = input.toLowerCase();\n  if ((VALID_CANVAS_RESOLUTIONS as readonly string[]).includes(lowered)) {\n    return lowered as CanvasResolution;\n  }\n  return RESOLUTION_ALIASES[lowered];\n}\n\nexport interface TimelineElementBase {\n  id: string;\n  type: TimelineElementType;\n  name: string;\n  startTime: number;\n  duration: number;\n  zIndex: number;\n  x?: number;\n  y?: number;\n  scale?: number;\n  opacity?: number;\n}\n\nexport interface TimelineMediaElement extends TimelineElementBase {\n  type: MediaElementType;\n  src: string;\n  mediaStartTime?: number;\n  sourceDuration?: number;\n  isAroll?: boolean;\n  sourceWidth?: number;\n  sourceHeight?: number;\n  volume?: number; // 0-1 (0% to 100%), default 1.0\n  hasAudio?: boolean; // For videos - indicates if video has audio track\n}\n\nexport interface WaveformData {\n  peaks: number[];\n  duration: number;\n  sampleRate?: number;\n}\n\nexport interface TimelineTextElement extends TimelineElementBase {\n  type: \"text\";\n  content: string;\n  color?: string;\n  fontSize?: number;\n  textShadow?: boolean;\n  fontFamily?: string;\n  fontWeight?: number;\n  textOutline?: boolean;\n  textOutlineColor?: string;\n  textOutlineWidth?: number;\n  textHighlight?: boolean;\n  textHighlightColor?: string;\n  textHighlightPadding?: number;\n  textHighlightRadius?: number;\n}\n\nexport interface TimelineCompositionElement extends TimelineElementBase {\n  type: \"composition\";\n  src: string;\n  compositionId: string;\n  scale?: number;\n  sourceDuration?: number;\n  variableValues?: Record<string, string | number | boolean>;\n  sourceWidth?: number;\n  sourceHeight?: number;\n}\n\n// Composition Variable Types\nexport type CompositionVariableType =\n  | \"string\"\n  | \"number\"\n  | \"color\"\n  | \"boolean\"\n  | \"enum\"\n  | \"font\"\n  | \"image\";\n\n/**\n * Runtime list of every valid `CompositionVariableType`. Use this anywhere\n * a Set/array of valid type strings is needed (lint rules, validators).\n * The `satisfies` guard turns adding a new variant to the union without\n * also adding it here into a compile error.\n */\nexport const COMPOSITION_VARIABLE_TYPES = [\n  \"string\",\n  \"number\",\n  \"color\",\n  \"boolean\",\n  \"enum\",\n  \"font\",\n  \"image\",\n] as const satisfies readonly CompositionVariableType[];\n\nexport interface CompositionVariableBase {\n  id: string;\n  type: CompositionVariableType;\n  label: string;\n  description?: string;\n}\n\nexport interface StringVariable extends CompositionVariableBase {\n  type: \"string\";\n  default: string;\n  placeholder?: string;\n  maxLength?: number;\n}\n\nexport interface NumberVariable extends CompositionVariableBase {\n  type: \"number\";\n  default: number;\n  min?: number;\n  max?: number;\n  step?: number;\n  unit?: string;\n}\n\nexport interface ColorVariable extends CompositionVariableBase {\n  type: \"color\";\n  default: string;\n  /** Brand role identifier, e.g. \"color:primary\". */\n  brandRole?: string;\n}\n\nexport interface BooleanVariable extends CompositionVariableBase {\n  type: \"boolean\";\n  default: boolean;\n}\n\nexport interface EnumVariable extends CompositionVariableBase {\n  type: \"enum\";\n  default: string;\n  options: { value: string; label: string }[];\n}\n\n/**\n * Font variable — value is a `{name, source}` object (object-valued; LOCKED §7).\n * `default` is the fallback font-family name string.\n * `source` is the font stylesheet URL (e.g. Google Fonts CSS).\n * `default_name` / `default_source` are the CSS-level fallbacks when the\n * brand font is absent.\n */\nexport interface FontVariable extends CompositionVariableBase {\n  type: \"font\";\n  /** Fallback font-family name, e.g. \"Inter\". */\n  default: string;\n  /** Font stylesheet URL (e.g. Google Fonts CSS link). */\n  source?: string;\n  /** CSS font-family name to use when source is unavailable, e.g. \"sans-serif\". */\n  default_name?: string;\n  /** Fallback font stylesheet URL (empty string = system font). */\n  default_source?: string;\n}\n\n/**\n * Image variable — value is a `{url, …}` object (object-valued; LOCKED §7).\n * `default` is the fallback image URL string.\n * `brandRole` is an optional semantic label, e.g. \"logo:primary\".\n */\nexport interface ImageVariable extends CompositionVariableBase {\n  type: \"image\";\n  /** Fallback image URL. */\n  default: string;\n  /** Brand role identifier, e.g. \"logo:primary\". */\n  brandRole?: string;\n}\n\nexport type CompositionVariable =\n  | StringVariable\n  | NumberVariable\n  | ColorVariable\n  | BooleanVariable\n  | EnumVariable\n  | FontVariable\n  | ImageVariable;\n\nexport interface CompositionSpec {\n  id: string;\n  duration: number;\n  variables: CompositionVariable[];\n}\n\nexport type TimelineElement =\n  | TimelineMediaElement\n  | TimelineTextElement\n  | TimelineCompositionElement;\n\nexport function isTextElement(el: TimelineElement): el is TimelineTextElement {\n  return el.type === \"text\";\n}\n\nexport function isMediaElement(el: TimelineElement): el is TimelineMediaElement {\n  return el.type === \"video\" || el.type === \"image\" || el.type === \"audio\";\n}\n\nexport function isCompositionElement(el: TimelineElement): el is TimelineCompositionElement {\n  return el.type === \"composition\";\n}\n\nexport interface MediaFile {\n  id: string;\n  name: string;\n  type: TimelineElementType;\n  src: string;\n  file?: File;\n  duration?: number;\n  compositionId?: string;\n  sourceWidth?: number; // Intrinsic width for compositions\n  sourceHeight?: number; // Intrinsic height for compositions\n}\n\nexport const TIMELINE_COLORS: Record<TimelineElementType, string> = {\n  video: \"#ec4899\",\n  image: \"#3b82f6\",\n  text: \"#06b6d4\",\n  audio: \"#10b981\",\n  composition: \"#f97316\",\n};\n\nexport const DEFAULT_DURATIONS: Record<TimelineElementType, number> = {\n  video: 5,\n  image: 5,\n  text: 2,\n  audio: 5,\n  composition: 5,\n};\n\nexport interface CompositionAPI {\n  id: string;\n  duration: number;\n  seek(time: number): void;\n  getTime(): number;\n  getDuration(): number;\n}\n\n// ── Player API types (used by runtime) ────────────────────────────────────\n\nexport interface PlayerAPI {\n  play(): void;\n  pause(): void;\n  seek(time: number, options?: { keepPlaying?: boolean }): void;\n  getTime(): number;\n  getDuration(): number;\n  isPlaying(): boolean;\n  getMainTimeline(): unknown;\n  getElementBounds(elementId: string): void;\n  getElementsAtPoint(x: number, y: number): void;\n  setElementPosition(elementId: string, x: number, y: number): void;\n  previewElementPosition(elementId: string, x: number, y: number): void;\n  setElementKeyframes(\n    elementId: string,\n    keyframes: Array<{\n      id: string;\n      time: number;\n      properties: { x?: number; y?: number };\n    }> | null,\n  ): void;\n  setElementScale(elementId: string, scale: number): void;\n  setElementFontSize(elementId: string, fontSize: number): void;\n  setElementTextContent(elementId: string, content: string): void;\n  setElementTextColor(elementId: string, color: string): void;\n  setElementTextShadow(elementId: string, enabled: boolean): void;\n  setElementTextFontWeight(elementId: string, weight: number): void;\n  setElementTextFontFamily(elementId: string, fontFamily: string): void;\n  setElementTextOutline(elementId: string, enabled: boolean, color?: string, width?: number): void;\n  setElementTextHighlight(\n    elementId: string,\n    enabled: boolean,\n    color?: string,\n    padding?: number,\n    radius?: number,\n  ): void;\n  setElementVolume(elementId: string, volume: number): void;\n  setStageZoom(scale: number, focusX: number, focusY: number): void;\n  getStageZoom(): { scale: number; focusX: number; focusY: number };\n  setStageZoomKeyframes(\n    keyframes: Array<{\n      id: string;\n      time: number;\n      zoom: { scale: number; focusX: number; focusY: number };\n      ease?: string;\n    }> | null,\n  ): void;\n  getStageZoomKeyframes(): Array<{\n    id: string;\n    time: number;\n    zoom: { scale: number; focusX: number; focusY: number };\n    ease?: string;\n  }>;\n  addElement(data: AddElementData): boolean;\n  removeElement(elementId: string): boolean;\n  updateElementTiming(elementId: string, start?: number, end?: number): boolean;\n  setElementTiming(\n    elementId: string,\n    startTime: number,\n    duration: number,\n    mediaStartTime?: number,\n  ): void;\n  updateElementSrc(elementId: string, src: string): boolean;\n  updateElementLayer(elementId: string, zIndex: number): boolean;\n  updateElementBasePosition(elementId: string, x?: number, y?: number, scale?: number): boolean;\n  markTimelineDirty(): void;\n  isTimelineDirty(): boolean;\n  rebuildTimeline(): void;\n  ensureTimeline(): void;\n  enableRenderMode(): void;\n  disableRenderMode(): void;\n  renderSeek(time: number, options?: { suppressEvents?: boolean }): void;\n  getElementVisibility(elementId: string): { visible: boolean; opacity?: number };\n  getVisibleElements(): Array<{ id: string; tagName: string; start: number; end: number }>;\n  getRenderState(): {\n    time: number;\n    duration: number;\n    isPlaying: boolean;\n    renderMode: boolean;\n    timelineDirty: boolean;\n  };\n}\n\nexport interface AddElementData {\n  id: string;\n  type: \"video\" | \"image\" | \"text\" | \"audio\" | \"composition\";\n  name?: string;\n  src?: string;\n  content?: string;\n  start: number;\n  end: number;\n  zIndex?: number;\n  x?: number;\n  y?: number;\n  scale?: number;\n  fontSize?: number;\n  color?: string;\n  textShadow?: boolean;\n  fontWeight?: number;\n  textOutline?: boolean;\n  textOutlineColor?: string;\n  textOutlineWidth?: number;\n  textHighlight?: boolean;\n  textHighlightColor?: string;\n  textHighlightPadding?: number;\n  textHighlightRadius?: number;\n  compositionId?: string;\n  sourceWidth?: number;\n  sourceHeight?: number;\n  isAroll?: boolean;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n\nexport interface CompositionAsset {\n  id: string;\n  name: string;\n  type: \"composition\";\n  src: string;\n  duration: number;\n  compositionId: string;\n  thumbnail?: string;\n}\n\nexport interface Keyframe {\n  id: string;\n  time: number;\n  properties: Partial<KeyframeProperties>;\n  ease?: string;\n}\n\nexport interface KeyframeProperties {\n  x: number;\n  y: number;\n  opacity: number;\n  scale: number;\n  scaleX: number;\n  scaleY: number;\n  rotation: number;\n  width: number;\n  height: number;\n}\n\nexport interface ElementKeyframes {\n  elementId: string;\n  keyframes: Keyframe[];\n}\n\nexport interface StageZoom {\n  scale: number;\n  focusX: number;\n  focusY: number;\n}\n\nexport interface StageZoomKeyframe {\n  id: string;\n  time: number;\n  zoom: StageZoom;\n  ease?: string;\n}\n\nexport function getDefaultStageZoom(resolution: CanvasResolution): StageZoom {\n  const { width, height } = CANVAS_DIMENSIONS[resolution];\n  return {\n    scale: 1,\n    focusX: width / 2,\n    focusY: height / 2,\n  };\n}\n","/**\n * Single source of truth for the deterministic font alias map. Both the\n * producer's @font-face injector and the core lint rules import from here,\n * eliminating manual drift between the two.\n *\n * Keys are lowercase font family names. Values are canonical font slugs\n * matching CANONICAL_FONTS keys in the producer's deterministicFonts module.\n */\nexport const FONT_ALIAS_MAP = {\n  // ── Canonical bundled fonts (self-referencing) ────────────────────────\n  inter: \"inter\",\n  montserrat: \"montserrat\",\n  outfit: \"outfit\",\n  nunito: \"nunito\",\n  oswald: \"oswald\",\n  \"league gothic\": \"league-gothic\",\n  \"archivo black\": \"archivo-black\",\n  \"space mono\": \"space-mono\",\n  \"ibm plex mono\": \"ibm-plex-mono\",\n  \"jetbrains mono\": \"jetbrains-mono\",\n  \"eb garamond\": \"eb-garamond\",\n  \"playfair display\": \"playfair-display\",\n  \"source code pro\": \"source-code-pro\",\n  \"noto sans jp\": \"noto-sans-jp\",\n  roboto: \"roboto\",\n  \"open sans\": \"open-sans\",\n  lato: \"lato\",\n  poppins: \"poppins\",\n\n  // ── Common aliases → nearest canonical ────────────────────────────────\n  \"helvetica neue\": \"inter\",\n  helvetica: \"inter\",\n  arial: \"inter\",\n  \"helvetica bold\": \"inter\",\n  futura: \"montserrat\",\n  \"din alternate\": \"montserrat\",\n  \"arial black\": \"montserrat\",\n  \"bebas neue\": \"league-gothic\",\n  \"courier new\": \"jetbrains-mono\",\n  courier: \"jetbrains-mono\",\n  garamond: \"eb-garamond\",\n  \"noto sans japanese\": \"noto-sans-jp\",\n  \"segoe ui\": \"roboto\",\n\n  // ── macOS sans-serif system fonts → inter ─────────────────────────────\n  \"sf pro\": \"inter\",\n  \"sf pro display\": \"inter\",\n  \"sf pro text\": \"inter\",\n  \"sf pro rounded\": \"inter\",\n  avenir: \"inter\",\n  \"avenir next\": \"inter\",\n  \"lucida grande\": \"inter\",\n  geneva: \"inter\",\n  optima: \"inter\",\n\n  // ── Windows sans-serif system fonts → inter ───────────────────────────\n  verdana: \"inter\",\n  tahoma: \"inter\",\n  \"trebuchet ms\": \"inter\",\n  calibri: \"inter\",\n  candara: \"inter\",\n  corbel: \"inter\",\n  \"lucida sans\": \"inter\",\n  \"lucida sans unicode\": \"inter\",\n\n  // ── Linux sans-serif system fonts → inter ─────────────────────────────\n  \"noto sans\": \"inter\",\n  \"dejavu sans\": \"inter\",\n  \"liberation sans\": \"inter\",\n\n  // ── Monospace system fonts → jetbrains-mono ───────────────────────────\n  \"sf mono\": \"jetbrains-mono\",\n  menlo: \"jetbrains-mono\",\n  monaco: \"jetbrains-mono\",\n  consolas: \"jetbrains-mono\",\n  \"lucida console\": \"jetbrains-mono\",\n  \"lucida sans typewriter\": \"jetbrains-mono\",\n  \"andale mono\": \"jetbrains-mono\",\n  \"dejavu sans mono\": \"jetbrains-mono\",\n  \"liberation mono\": \"jetbrains-mono\",\n\n  // ── Serif system fonts → eb-garamond ──────────────────────────────────\n  georgia: \"eb-garamond\",\n  palatino: \"eb-garamond\",\n  \"palatino linotype\": \"eb-garamond\",\n  \"book antiqua\": \"eb-garamond\",\n  cambria: \"eb-garamond\",\n  times: \"eb-garamond\",\n  \"times new roman\": \"eb-garamond\",\n  \"dejavu serif\": \"eb-garamond\",\n  \"liberation serif\": \"eb-garamond\",\n} satisfies Readonly<Record<string, string>>;\n\nexport const FONT_ALIAS_KEYS: ReadonlySet<string> = new Set(Object.keys(FONT_ALIAS_MAP));\n\n/**\n * Human-readable display names for canonical font slugs. Used by the lint\n * rule to tell authors what their aliased font will render as.\n */\nexport const CANONICAL_FONT_DISPLAY_NAMES: Readonly<Record<string, string>> = {\n  inter: \"Inter\",\n  montserrat: \"Montserrat\",\n  outfit: \"Outfit\",\n  nunito: \"Nunito\",\n  oswald: \"Oswald\",\n  \"league-gothic\": \"League Gothic\",\n  \"archivo-black\": \"Archivo Black\",\n  \"space-mono\": \"Space Mono\",\n  \"ibm-plex-mono\": \"IBM Plex Mono\",\n  \"jetbrains-mono\": \"JetBrains Mono\",\n  \"eb-garamond\": \"EB Garamond\",\n  \"playfair-display\": \"Playfair Display\",\n  \"source-code-pro\": \"Source Code Pro\",\n  \"noto-sans-jp\": \"Noto Sans JP\",\n  roboto: \"Roboto\",\n  \"open-sans\": \"Open Sans\",\n  lato: \"Lato\",\n  poppins: \"Poppins\",\n};\n\n/**\n * Resolve a font alias to its canonical display name, or undefined if the\n * alias is not in the map.\n */\nexport function resolveAliasDisplayName(alias: string): string | undefined {\n  const slug = (FONT_ALIAS_MAP as Record<string, string>)[alias.toLowerCase()];\n  if (!slug) return undefined;\n  return CANONICAL_FONT_DISPLAY_NAMES[slug];\n}\n","export function decodeUrlPathVariants(path: string): string[] {\n  const variants = [path];\n  try {\n    const decoded = decodeURIComponent(path);\n    if (decoded !== path) variants.unshift(decoded);\n  } catch {\n    // Malformed percent sequences may be literal filesystem names.\n  }\n\n  return variants;\n}\n","/**\n * Browser-safe parser for the `data-composition-variables` schema attribute.\n * Lives outside htmlParser.ts so browser consumers (SDK, Studio, lint) can\n * import it via `@hyperframes/parsers/composition` without pulling the\n * linkedom/Node HTML-parser machinery from the main entry.\n */\n\nimport type { CompositionVariable, CompositionVariableType } from \"./types.js\";\n\n/**\n * Required typeof for each variable type's `default`. For font the default is\n * the font-family name string; for image it is the fallback URL string —\n * extra metadata fields on both are optional and not validated here.\n */\nconst DEFAULT_TYPEOF: Record<CompositionVariableType, \"string\" | \"number\" | \"boolean\"> = {\n  string: \"string\",\n  number: \"number\",\n  color: \"string\",\n  boolean: \"boolean\",\n  enum: \"string\",\n  font: \"string\",\n  image: \"string\",\n};\n\n/**\n * Scalar variable values (string/number/boolean) are the ones that flow into\n * CSS custom props and text bindings; font/image values are object-shaped.\n * Shared so the SDK's CSS-compat writes, the runtime bindings, and Studio's\n * display logic can never disagree on what \"scalar\" means.\n */\nexport function isScalarVariableValue(value: unknown): value is string | number | boolean {\n  return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\";\n}\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null;\n}\n\nfunction isVariableType(t: unknown): t is CompositionVariableType {\n  return typeof t === \"string\" && t in DEFAULT_TYPEOF;\n}\n\n/**\n * True when the value is a structurally valid variable declaration: id, label,\n * a known type, a default matching that type, and options[] for enums. The\n * same predicate parseCompositionVariables filters with — exported so writers\n * (SDK declaration ops, Studio forms) can validate before persisting.\n */\nexport function isCompositionVariable(v: unknown): v is CompositionVariable {\n  if (!isRecord(v)) return false;\n  if (typeof v.id !== \"string\" || typeof v.label !== \"string\") return false;\n  if (!isVariableType(v.type)) return false;\n  if (typeof v.default !== DEFAULT_TYPEOF[v.type]) return false;\n  if (v.type === \"enum\" && !Array.isArray(v.options)) return false;\n  return true;\n}\n\n/**\n * Parse the typed variable declarations from an element's\n * `data-composition-variables` attribute. Malformed entries (wrong shape,\n * unknown type, default not matching the declared type) are dropped; an\n * absent attribute, invalid JSON, or a non-array payload yields `[]`.\n */\nexport function parseCompositionVariables(htmlEl: Element): CompositionVariable[] {\n  const variablesAttr = htmlEl.getAttribute(\"data-composition-variables\");\n  if (!variablesAttr) {\n    return [];\n  }\n\n  try {\n    const parsed = JSON.parse(variablesAttr);\n    if (!Array.isArray(parsed)) {\n      return [];\n    }\n    return parsed.filter(isCompositionVariable);\n  } catch {\n    return [];\n  }\n}\n","/**\n * Browser-safe static scan for composition-variable reads in script text.\n *\n * Compositions read variables by calling the runtime API — `getVariables()`\n * bare (sub-comp scoped shadow) or via `__hyperframes.getVariables()` /\n * `window.__hyperframes.getVariables()` — and there is no DOM-attribute\n * binding to scan, so \"which variables does this composition use\" can only be\n * derived from the scripts. This is a best-effort static analysis: the\n * patterns agents actually write (destructuring, member access, a single\n * alias variable) resolve to ids; anything opaque flips `scanIncomplete`\n * so consumers can present usage as a lower bound instead of a fact.\n *\n * AST nodes are handled untyped (same convention as gsapParserAcorn.ts) —\n * acorn's structural types don't survive acorn-walk's visitor signatures.\n */\n\nimport * as acorn from \"acorn\";\nimport * as acornWalk from \"acorn-walk\";\n\nexport interface VariableUsageScan {\n  /** Variable ids statically read by the script, in first-seen order. */\n  usedIds: string[];\n  /**\n   * True when the script accesses variables in a way the scan cannot resolve\n   * (computed keys, rest spreads, the values object escaping into a call…) or\n   * when the script fails to parse — usedIds is then a lower bound.\n   */\n  scanIncomplete: boolean;\n}\n\ninterface Sink {\n  use(id: string): void;\n  incomplete(): void;\n}\n\n// oxlint-disable no-explicit-any -- untyped acorn AST traversal, see header\n\nfunction isGetVariablesCallee(callee: any): boolean {\n  if (callee?.type === \"Identifier\") return callee.name === \"getVariables\";\n  if (callee?.type === \"MemberExpression\" && !callee.computed) {\n    return callee.property?.type === \"Identifier\" && callee.property.name === \"getVariables\";\n  }\n  return false;\n}\n\n/** Collect ids from an ObjectPattern destructuring of the values object. */\n// Exhaustive AST-node classification — branchy by nature, same as gsapParserAcorn.\n// fallow-ignore-next-line complexity\nfunction collectFromObjectPattern(pattern: any, out: Sink): void {\n  for (const prop of pattern.properties ?? []) {\n    if (prop?.type === \"RestElement\") {\n      out.incomplete();\n      continue;\n    }\n    if (prop?.type !== \"Property\") continue;\n    if (prop.computed === true) {\n      out.incomplete();\n    } else if (prop.key?.type === \"Identifier\") {\n      out.use(String(prop.key.name));\n    } else if (prop.key?.type === \"Literal\" && typeof prop.key.value === \"string\") {\n      out.use(prop.key.value);\n    } else {\n      out.incomplete();\n    }\n  }\n}\n\n/** Collect an id from a MemberExpression reading the values object. */\nfunction collectFromMemberAccess(member: any, out: Sink): void {\n  if (member.computed !== true && member.property?.type === \"Identifier\") {\n    out.use(String(member.property.name));\n  } else if (\n    member.computed === true &&\n    member.property?.type === \"Literal\" &&\n    typeof member.property.value === \"string\"\n  ) {\n    out.use(member.property.value);\n  } else {\n    out.incomplete();\n  }\n}\n\n/**\n * Classify one read of the values object (a getVariables() call result or an\n * alias holding it) by its immediate syntactic context. Returns the alias\n * name when the value is bound to a plain variable (`const vars = …`).\n */\n// fallow-ignore-next-line complexity\nfunction classifyValueRead(parent: any, valueNode: any, out: Sink): string | null {\n  if (!parent || parent.type === \"ExpressionStatement\") {\n    // Bare statement — value unused, nothing read.\n    return null;\n  }\n  if (parent.type === \"MemberExpression\" && parent.object === valueNode) {\n    collectFromMemberAccess(parent, out);\n    return null;\n  }\n  if (parent.type === \"VariableDeclarator\" && parent.init === valueNode) {\n    if (parent.id?.type === \"ObjectPattern\") {\n      collectFromObjectPattern(parent.id, out);\n      return null;\n    }\n    if (parent.id?.type === \"Identifier\") return String(parent.id.name);\n    out.incomplete();\n    return null;\n  }\n  // The values object escapes (argument, return, spread, assignment…) —\n  // reads beyond this point are invisible to the scan.\n  out.incomplete();\n  return null;\n}\n\nexport function scanVariableUsage(scriptText: string): VariableUsageScan {\n  const usedIds: string[] = [];\n  const seen = new Set<string>();\n  let scanIncomplete = false;\n\n  const sink: Sink = {\n    use(id: string) {\n      if (!seen.has(id)) {\n        seen.add(id);\n        usedIds.push(id);\n      }\n    },\n    incomplete() {\n      scanIncomplete = true;\n    },\n  };\n\n  let ast: any;\n  try {\n    ast = acorn.parse(scriptText, { ecmaVersion: \"latest\", sourceType: \"script\" });\n  } catch {\n    return { usedIds: [], scanIncomplete: true };\n  }\n\n  const aliases = new Set<string>();\n\n  // Pass 1: classify every getVariables() call by its parent context.\n  acornWalk.ancestor(ast, {\n    CallExpression(node: any, _: unknown, ancestors: any[]) {\n      if (!isGetVariablesCallee(node.callee)) return;\n      const parent = ancestors[ancestors.length - 2];\n      const alias = classifyValueRead(parent, node, sink);\n      if (alias) aliases.add(alias);\n    },\n  } as any);\n\n  // Pass 2: classify every reference to an alias of the values object.\n  // Scope-naive by design: an unrelated same-named identifier can only make\n  // the scan report extra ids or flip scanIncomplete, never miss a read.\n  if (aliases.size > 0) {\n    acornWalk.ancestor(ast, {\n      // fallow-ignore-next-line complexity\n      Identifier(node: any, _: unknown, ancestors: any[]) {\n        if (!aliases.has(String(node.name))) return;\n        const parent = ancestors[ancestors.length - 2];\n        if (!parent) return;\n        // Skip the declarator that introduced the alias and property-position\n        // identifiers that merely share the name.\n        if (parent.type === \"VariableDeclarator\" && parent.id === node) return;\n        if (parent.type === \"MemberExpression\" && parent.property === node) return;\n        if (parent.type === \"Property\" && parent.key === node && parent.computed !== true) return;\n        // Chained aliases (const v2 = vars) are not followed — flag instead\n        // of silently missing reads through the second name.\n        if (classifyValueRead(parent, node, sink)) sink.incomplete();\n      },\n    } as any);\n  }\n\n  return { usedIds, scanIncomplete };\n}\n"],"mappings":";AAkBO,IAAM,oBAAoB;AAAA,EAC/B,WAAW,EAAE,OAAO,MAAM,QAAQ,KAAK;AAAA,EACvC,UAAU,EAAE,OAAO,MAAM,QAAQ,KAAK;AAAA,EACtC,gBAAgB,EAAE,OAAO,MAAM,QAAQ,KAAK;AAAA,EAC5C,eAAe,EAAE,OAAO,MAAM,QAAQ,KAAK;AAAA,EAC3C,QAAQ,EAAE,OAAO,MAAM,QAAQ,KAAK;AAAA,EACpC,aAAa,EAAE,OAAO,MAAM,QAAQ,KAAK;AAC3C;AAWO,IAAM,2BAA2B,OAAO;AAAA,EAC7C;AACF;AAEA,IAAM,qBAAuD;AAAA,EAC3D,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,MAAM;AAAA,EACN,KAAK;AAAA,EACL,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,gBAAgB;AAAA,EAChB,aAAa;AACf;AAOO,SAAS,wBAAwB,OAAyD;AAC/F,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,UAAU,MAAM,YAAY;AAClC,MAAK,yBAA+C,SAAS,OAAO,GAAG;AACrE,WAAO;AAAA,EACT;AACA,SAAO,mBAAmB,OAAO;AACnC;AA6EO,IAAM,6BAA6B;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AA+FO,SAAS,cAAc,IAAgD;AAC5E,SAAO,GAAG,SAAS;AACrB;AAEO,SAAS,eAAe,IAAiD;AAC9E,SAAO,GAAG,SAAS,WAAW,GAAG,SAAS,WAAW,GAAG,SAAS;AACnE;AAEO,SAAS,qBAAqB,IAAuD;AAC1F,SAAO,GAAG,SAAS;AACrB;AAcO,IAAM,kBAAuD;AAAA,EAClE,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,aAAa;AACf;AAEO,IAAM,oBAAyD;AAAA,EACpE,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,OAAO;AAAA,EACP,aAAa;AACf;AAgLO,SAAS,oBAAoB,YAAyC;AAC3E,QAAM,EAAE,OAAO,OAAO,IAAI,kBAAkB,UAAU;AACtD,SAAO;AAAA,IACL,OAAO;AAAA,IACP,QAAQ,QAAQ;AAAA,IAChB,QAAQ,SAAS;AAAA,EACnB;AACF;;;AC1cO,IAAM,iBAAiB;AAAA;AAAA,EAE5B,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,MAAM;AAAA,EACN,SAAS;AAAA;AAAA,EAGT,kBAAkB;AAAA,EAClB,WAAW;AAAA,EACX,OAAO;AAAA,EACP,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,eAAe;AAAA,EACf,SAAS;AAAA,EACT,UAAU;AAAA,EACV,sBAAsB;AAAA,EACtB,YAAY;AAAA;AAAA,EAGZ,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,kBAAkB;AAAA,EAClB,QAAQ;AAAA,EACR,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,QAAQ;AAAA;AAAA,EAGR,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,eAAe;AAAA,EACf,uBAAuB;AAAA;AAAA,EAGvB,aAAa;AAAA,EACb,eAAe;AAAA,EACf,mBAAmB;AAAA;AAAA,EAGnB,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,0BAA0B;AAAA,EAC1B,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,mBAAmB;AAAA;AAAA,EAGnB,SAAS;AAAA,EACT,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,oBAAoB;AACtB;AAEO,IAAM,kBAAuC,IAAI,IAAI,OAAO,KAAK,cAAc,CAAC;AAMhF,IAAM,+BAAiE;AAAA,EAC5E,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,MAAM;AAAA,EACN,SAAS;AACX;AAMO,SAAS,wBAAwB,OAAmC;AACzE,QAAM,OAAQ,eAA0C,MAAM,YAAY,CAAC;AAC3E,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,6BAA6B,IAAI;AAC1C;;;AChIO,SAAS,sBAAsB,MAAwB;AAC5D,QAAM,WAAW,CAAC,IAAI;AACtB,MAAI;AACF,UAAM,UAAU,mBAAmB,IAAI;AACvC,QAAI,YAAY,KAAM,UAAS,QAAQ,OAAO;AAAA,EAChD,QAAQ;AAAA,EAER;AAEA,SAAO;AACT;;;ACIA,IAAM,iBAAmF;AAAA,EACvF,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AAQO,SAAS,sBAAsB,OAAoD;AACxF,SAAO,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU;AACpF;AAEA,SAAS,SAAS,GAA0C;AAC1D,SAAO,OAAO,MAAM,YAAY,MAAM;AACxC;AAEA,SAAS,eAAe,GAA0C;AAChE,SAAO,OAAO,MAAM,YAAY,KAAK;AACvC;AAQO,SAAS,sBAAsB,GAAsC;AAC1E,MAAI,CAAC,SAAS,CAAC,EAAG,QAAO;AACzB,MAAI,OAAO,EAAE,OAAO,YAAY,OAAO,EAAE,UAAU,SAAU,QAAO;AACpE,MAAI,CAAC,eAAe,EAAE,IAAI,EAAG,QAAO;AACpC,MAAI,OAAO,EAAE,YAAY,eAAe,EAAE,IAAI,EAAG,QAAO;AACxD,MAAI,EAAE,SAAS,UAAU,CAAC,MAAM,QAAQ,EAAE,OAAO,EAAG,QAAO;AAC3D,SAAO;AACT;AAQO,SAAS,0BAA0B,QAAwC;AAChF,QAAM,gBAAgB,OAAO,aAAa,4BAA4B;AACtE,MAAI,CAAC,eAAe;AAClB,WAAO,CAAC;AAAA,EACV;AAEA,MAAI;AACF,UAAM,SAAS,KAAK,MAAM,aAAa;AACvC,QAAI,CAAC,MAAM,QAAQ,MAAM,GAAG;AAC1B,aAAO,CAAC;AAAA,IACV;AACA,WAAO,OAAO,OAAO,qBAAqB;AAAA,EAC5C,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;;;AC9DA,YAAY,WAAW;AACvB,YAAY,eAAe;AAoB3B,SAAS,qBAAqB,QAAsB;AAClD,MAAI,QAAQ,SAAS,aAAc,QAAO,OAAO,SAAS;AAC1D,MAAI,QAAQ,SAAS,sBAAsB,CAAC,OAAO,UAAU;AAC3D,WAAO,OAAO,UAAU,SAAS,gBAAgB,OAAO,SAAS,SAAS;AAAA,EAC5E;AACA,SAAO;AACT;AAKA,SAAS,yBAAyB,SAAc,KAAiB;AAC/D,aAAW,QAAQ,QAAQ,cAAc,CAAC,GAAG;AAC3C,QAAI,MAAM,SAAS,eAAe;AAChC,UAAI,WAAW;AACf;AAAA,IACF;AACA,QAAI,MAAM,SAAS,WAAY;AAC/B,QAAI,KAAK,aAAa,MAAM;AAC1B,UAAI,WAAW;AAAA,IACjB,WAAW,KAAK,KAAK,SAAS,cAAc;AAC1C,UAAI,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC;AAAA,IAC/B,WAAW,KAAK,KAAK,SAAS,aAAa,OAAO,KAAK,IAAI,UAAU,UAAU;AAC7E,UAAI,IAAI,KAAK,IAAI,KAAK;AAAA,IACxB,OAAO;AACL,UAAI,WAAW;AAAA,IACjB;AAAA,EACF;AACF;AAGA,SAAS,wBAAwB,QAAa,KAAiB;AAC7D,MAAI,OAAO,aAAa,QAAQ,OAAO,UAAU,SAAS,cAAc;AACtE,QAAI,IAAI,OAAO,OAAO,SAAS,IAAI,CAAC;AAAA,EACtC,WACE,OAAO,aAAa,QACpB,OAAO,UAAU,SAAS,aAC1B,OAAO,OAAO,SAAS,UAAU,UACjC;AACA,QAAI,IAAI,OAAO,SAAS,KAAK;AAAA,EAC/B,OAAO;AACL,QAAI,WAAW;AAAA,EACjB;AACF;AAQA,SAAS,kBAAkB,QAAa,WAAgB,KAA0B;AAChF,MAAI,CAAC,UAAU,OAAO,SAAS,uBAAuB;AAEpD,WAAO;AAAA,EACT;AACA,MAAI,OAAO,SAAS,sBAAsB,OAAO,WAAW,WAAW;AACrE,4BAAwB,QAAQ,GAAG;AACnC,WAAO;AAAA,EACT;AACA,MAAI,OAAO,SAAS,wBAAwB,OAAO,SAAS,WAAW;AACrE,QAAI,OAAO,IAAI,SAAS,iBAAiB;AACvC,+BAAyB,OAAO,IAAI,GAAG;AACvC,aAAO;AAAA,IACT;AACA,QAAI,OAAO,IAAI,SAAS,aAAc,QAAO,OAAO,OAAO,GAAG,IAAI;AAClE,QAAI,WAAW;AACf,WAAO;AAAA,EACT;AAGA,MAAI,WAAW;AACf,SAAO;AACT;AAEO,SAAS,kBAAkB,YAAuC;AACvE,QAAM,UAAoB,CAAC;AAC3B,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,iBAAiB;AAErB,QAAM,OAAa;AAAA,IACjB,IAAI,IAAY;AACd,UAAI,CAAC,KAAK,IAAI,EAAE,GAAG;AACjB,aAAK,IAAI,EAAE;AACX,gBAAQ,KAAK,EAAE;AAAA,MACjB;AAAA,IACF;AAAA,IACA,aAAa;AACX,uBAAiB;AAAA,IACnB;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACF,UAAY,YAAM,YAAY,EAAE,aAAa,UAAU,YAAY,SAAS,CAAC;AAAA,EAC/E,QAAQ;AACN,WAAO,EAAE,SAAS,CAAC,GAAG,gBAAgB,KAAK;AAAA,EAC7C;AAEA,QAAM,UAAU,oBAAI,IAAY;AAGhC,EAAU,mBAAS,KAAK;AAAA,IACtB,eAAe,MAAW,GAAY,WAAkB;AACtD,UAAI,CAAC,qBAAqB,KAAK,MAAM,EAAG;AACxC,YAAM,SAAS,UAAU,UAAU,SAAS,CAAC;AAC7C,YAAM,QAAQ,kBAAkB,QAAQ,MAAM,IAAI;AAClD,UAAI,MAAO,SAAQ,IAAI,KAAK;AAAA,IAC9B;AAAA,EACF,CAAQ;AAKR,MAAI,QAAQ,OAAO,GAAG;AACpB,IAAU,mBAAS,KAAK;AAAA;AAAA,MAEtB,WAAW,MAAW,GAAY,WAAkB;AAClD,YAAI,CAAC,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,EAAG;AACrC,cAAM,SAAS,UAAU,UAAU,SAAS,CAAC;AAC7C,YAAI,CAAC,OAAQ;AAGb,YAAI,OAAO,SAAS,wBAAwB,OAAO,OAAO,KAAM;AAChE,YAAI,OAAO,SAAS,sBAAsB,OAAO,aAAa,KAAM;AACpE,YAAI,OAAO,SAAS,cAAc,OAAO,QAAQ,QAAQ,OAAO,aAAa,KAAM;AAGnF,YAAI,kBAAkB,QAAQ,MAAM,IAAI,EAAG,MAAK,WAAW;AAAA,MAC7D;AAAA,IACF,CAAQ;AAAA,EACV;AAEA,SAAO,EAAE,SAAS,eAAe;AACnC;","names":[]}

package/dist/gsapWriterAcorn.js

@@ -1253,6 +1253,11 @@ function findInsertionPoint(parsed) {
   const tlDecl = findTimelineDeclarationStatement(parsed.ast, parsed.timelineVar);
   return tlDecl?.end ?? parsed.ast.end;
 }
+function findGlobalSetInsertionPoint(parsed, script) {
+  const tlDecl = findTimelineDeclarationStatement(parsed.ast, parsed.timelineVar);
+  if (!tlDecl) return null;
+  return script.lastIndexOf("\n", tlDecl.start) + 1;
+}
 function updateAnimationInScript(script, animationId, updates) {
   if (!Object.keys(updates).length) return script;
   const parsed = parseGsapScriptAcornForWrite(script);
@@ -1301,6 +1306,16 @@ function updateAnimationInScript(script, animationId, updates) {
   if (updates.position !== void 0) {
     overwritePosition(ms, call, updates.position);
   }
+  if (target.animation.method === "set" && target.animation.global) {
+    const globalSetPoint = findGlobalSetInsertionPoint(parsed, script);
+    const exprStmt = findEnclosingExpressionStatement(call.ancestors);
+    if (globalSetPoint !== null && exprStmt && exprStmt.start > globalSetPoint) {
+      const lineStart = script.lastIndexOf("\n", exprStmt.start) + 1;
+      const moveStart = /^\s*$/.test(script.slice(lineStart, exprStmt.start)) ? lineStart : exprStmt.start;
+      const moveEnd = exprStmt.end < script.length && script[exprStmt.end] === "\n" ? exprStmt.end + 1 : exprStmt.end;
+      ms.move(moveStart, moveEnd, globalSetPoint);
+    }
+  }
   return ms.toString();
 }
 function overwritePosition(ms, call, position) {
@@ -1350,14 +1365,31 @@ function scalePositionsInScript(script, targetSelector, oldStart, oldDuration, n
 function addAnimationToScript(script, animation) {
   const parsed = parseGsapScriptAcornForWrite(script);
   if (!parsed) return { script, id: "" };
-  const insertionPoint = findInsertionPoint(parsed);
-  if (insertionPoint === null) return { script, id: "" };
   const ms = new MagicString(script);
   const statementCode = buildTweenStatementCode(parsed.timelineVar, animation);
-  ms.appendLeft(insertionPoint, "\n" + statementCode);
+  const globalSetPoint = animation.method === "set" && animation.global ? findGlobalSetInsertionPoint(parsed, script) : null;
+  if (globalSetPoint !== null) {
+    ms.appendLeft(globalSetPoint, statementCode + "\n");
+  } else {
+    const insertionPoint = findInsertionPoint(parsed);
+    if (insertionPoint === null) return { script, id: "" };
+    ms.appendLeft(insertionPoint, "\n" + statementCode);
+  }
   const result = ms.toString();
   const reParsed = parseGsapScriptAcornForWrite(result);
-  const newId = reParsed?.located[reParsed.located.length - 1]?.id ?? "";
+  const oldIdCounts = /* @__PURE__ */ new Map();
+  for (const entry of parsed.located) {
+    oldIdCounts.set(entry.id, (oldIdCounts.get(entry.id) ?? 0) + 1);
+  }
+  let newId = "";
+  for (const entry of reParsed?.located ?? []) {
+    const remaining = oldIdCounts.get(entry.id) ?? 0;
+    if (remaining === 0) {
+      newId = entry.id;
+      break;
+    }
+    oldIdCounts.set(entry.id, remaining - 1);
+  }
   return { script: result, id: newId };
 }
 function removeCallFromMagicString(ms, call, script) {