@hyperframes/parsers 0.7.15 → 0.7.17

package/dist/slideshow.d.ts

@@ -0,0 +1,92 @@
+/** Current manifest schema version. Stamped on persist so future schema
+ *  changes can detect and migrate older islands. */
+declare const SLIDESHOW_MANIFEST_VERSION = 1;
+/** Raw author-facing shapes parsed from the JSON island. */
+interface SlideshowManifest {
+    /** Schema version (absent on pre-versioning islands → treat as 1). */
+    version?: number;
+    slides: SlideRef[];
+    slideSequences?: SlideSequence[];
+}
+interface SlideRef {
+    sceneId: string;
+    startTime?: number;
+    endTime?: number;
+    notes?: string;
+    fragments?: number[];
+    hotspots?: SlideHotspot[];
+    /**
+     * When true, the slide's first `<video>` plays automatically on enter (the
+     * presenter lands on the slide and the clip plays). The slideshow still holds
+     * — it never auto-advances — so the presenter clicks Next when ready.
+     * Defaults to false. Use it when the video is the slide's primary content and
+     * its natural end is the cue to advance, not for background/ambient clips.
+     */
+    autoplay?: boolean;
+    ttsScript?: string;
+    ttsAudioUrl?: string;
+    ttsDurationMs?: number;
+}
+interface SlideHotspot {
+    id: string;
+    label: string;
+    target: string;
+    region?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}
+interface SlideSequence {
+    id: string;
+    label: string;
+    slides: SlideRef[];
+}
+/** A slide with its time range resolved from the matching scene. */
+interface ResolvedSlide extends SlideRef {
+    start: number;
+    end: number;
+    fragments: number[];
+    hotspots: SlideHotspot[];
+}
+interface ResolvedSlideSequence {
+    id: string;
+    label: string;
+    slides: ResolvedSlide[];
+}
+interface ResolvedSlideshow {
+    slides: ResolvedSlide[];
+    sequences: Record<string, ResolvedSlideSequence>;
+}
+
+declare const SLIDESHOW_ISLAND_TYPE = "application/hyperframes-slideshow+json";
+/**
+ * Builds the island <script> matcher. Capture group 1 = inner JSON.
+ *
+ * Factory (fresh RegExp per call) on purpose: a RegExp with the `g` flag carries
+ * a mutable `lastIndex`, so callers that need `g` must call this each time rather
+ * than caching a shared instance.
+ */
+declare function slideshowIslandRegex(flags?: string): RegExp;
+interface SceneRange {
+    id: string;
+    start: number;
+    duration: number;
+}
+/** Extract the JSON island from composition HTML. Returns null if absent. */
+declare function parseSlideshowManifest(html: string): SlideshowManifest | null;
+declare function resolveSlideshow(manifest: SlideshowManifest, scenes: SceneRange[]): {
+    resolved: ResolvedSlideshow;
+    errors: string[];
+};
+
+/**
+ * Whether a composition id names a "scene-like" composition — i.e. a real slide
+ * scene, not the root timeline (`main`) or a non-scene overlay (captions, ambient
+ * layers). Shared by the runtime scene-window computation and the slideshow lint
+ * rule so the two can never drift.
+ */
+declare function isSceneLikeCompositionId(compositionId: string): boolean;
+
+export { type ResolvedSlide, type ResolvedSlideSequence, type ResolvedSlideshow, SLIDESHOW_ISLAND_TYPE, SLIDESHOW_MANIFEST_VERSION, type SlideHotspot, type SlideRef, type SlideSequence, type SlideshowManifest, isSceneLikeCompositionId, parseSlideshowManifest, resolveSlideshow, slideshowIslandRegex };

package/dist/slideshow.js

@@ -0,0 +1,149 @@
+// src/slideshow/slideshow.types.ts
+var SLIDESHOW_MANIFEST_VERSION = 1;
+
+// src/slideshow/parseSlideshow.ts
+var SLIDESHOW_ISLAND_TYPE = "application/hyperframes-slideshow+json";
+function slideshowIslandRegex(flags = "i") {
+  const escaped = SLIDESHOW_ISLAND_TYPE.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`<script[^>]*type=["']${escaped}["'][^>]*>([\\s\\S]*?)<\\/script>`, flags);
+}
+function parseSlideshowManifest(html) {
+  const re = slideshowIslandRegex("i");
+  const match = re.exec(html);
+  if (!match || match[1] === void 0) return null;
+  const raw = match[1].trim();
+  if (raw.length === 0) return null;
+  const parsed = JSON.parse(raw);
+  if (!isManifest(parsed)) {
+    throw new Error("slideshow island is not a valid SlideshowManifest");
+  }
+  return parsed;
+}
+function isOptionalNumberArray(v) {
+  return v === void 0 || Array.isArray(v) && v.every((n) => typeof n === "number");
+}
+function isOptionalBoolean(v) {
+  return v === void 0 || typeof v === "boolean";
+}
+function isSlideRef(v) {
+  if (typeof v !== "object" || v === null) return false;
+  const r = v;
+  if (typeof r["sceneId"] !== "string") return false;
+  if (!isOptionalNumberArray(r["fragments"])) return false;
+  if (r["hotspots"] !== void 0 && !Array.isArray(r["hotspots"])) return false;
+  if (!isOptionalBoolean(r["autoplay"])) return false;
+  return true;
+}
+function isSlideSequence(v) {
+  if (typeof v !== "object" || v === null) return false;
+  const s = v;
+  return typeof s["id"] === "string" && typeof s["label"] === "string" && Array.isArray(s["slides"]) && s["slides"].every(isSlideRef);
+}
+function isManifest(v) {
+  if (typeof v !== "object" || v === null || Array.isArray(v)) return false;
+  const o = v;
+  if (!Array.isArray(o["slides"]) || !o["slides"].every(isSlideRef)) return false;
+  if (o["slideSequences"] !== void 0) {
+    if (!Array.isArray(o["slideSequences"]) || !o["slideSequences"].every(isSlideSequence))
+      return false;
+  }
+  return true;
+}
+function missingBoundError(sceneId, missing) {
+  const present = missing === "startTime" ? "endTime" : "startTime";
+  return `slide "${sceneId}" sets ${present} but ${missing} cannot be resolved (no scene "${sceneId}")`;
+}
+function resolveTimeRange(ref, scene, errors) {
+  const { startTime, endTime, sceneId } = ref;
+  if (startTime !== void 0 && endTime !== void 0) {
+    return { start: startTime, end: endTime };
+  }
+  if (startTime === void 0 && endTime === void 0) {
+    if (!scene) {
+      errors.push(`slide references unresolved sceneId "${sceneId}"`);
+      return { start: 0, end: 0 };
+    }
+    return { start: scene.start, end: scene.start + scene.duration };
+  }
+  if (!scene) {
+    const missing = startTime === void 0 ? "startTime" : "endTime";
+    errors.push(missingBoundError(sceneId, missing));
+    const bound = startTime ?? endTime ?? 0;
+    return { start: bound, end: bound };
+  }
+  return {
+    start: startTime ?? scene.start,
+    end: endTime ?? scene.start + scene.duration
+  };
+}
+function validateFragments(sceneId, fragments, start, end, errors) {
+  for (const f of fragments) {
+    if (f < start || f > end) {
+      errors.push(`slide "${sceneId}" fragment ${f} is outside range [${start}, ${end}]`);
+    }
+  }
+}
+function resolveSlide(ref, sceneById, errors) {
+  const scene = sceneById.get(ref.sceneId);
+  const { start, end } = resolveTimeRange(ref, scene, errors);
+  if (ref.startTime !== void 0 && ref.endTime !== void 0 && end <= start) {
+    errors.push(`slide "${ref.sceneId}" has endTime (${end}) <= startTime (${start})`);
+  }
+  const fragments = [...new Set(ref.fragments ?? [])].sort((a, b) => a - b);
+  validateFragments(ref.sceneId, fragments, start, end, errors);
+  return { ...ref, start, end, fragments, hotspots: ref.hotspots ?? [] };
+}
+function resolveSlideshow(manifest, scenes) {
+  const errors = [];
+  const sceneById = new Map(scenes.map((s) => [s.id, s]));
+  const sequences = {};
+  for (const seq of manifest.slideSequences ?? []) {
+    if (Object.prototype.hasOwnProperty.call(sequences, seq.id)) {
+      errors.push(`duplicate slideSequence id "${seq.id}" \u2014 only the last definition is kept`);
+    }
+    sequences[seq.id] = {
+      id: seq.id,
+      label: seq.label,
+      slides: seq.slides.map((s) => resolveSlide(s, sceneById, errors))
+    };
+  }
+  const slides = manifest.slides.map((s) => resolveSlide(s, sceneById, errors));
+  const allSlides = [...slides, ...Object.values(sequences).flatMap((s) => s.slides)];
+  for (const slide of allSlides) {
+    for (const h of slide.hotspots) {
+      const seq = sequences[h.target];
+      if (!seq) {
+        errors.push(`hotspot "${h.id}" targets unknown sequence "${h.target}"`);
+      } else if (seq.slides.length === 0) {
+        errors.push(`hotspot "${h.id}" targets empty sequence "${h.target}"`);
+      }
+    }
+  }
+  const ordered = [...slides].sort((a, b) => a.start - b.start);
+  for (let i = 1; i < ordered.length; i++) {
+    const prev = ordered[i - 1];
+    const curr = ordered[i];
+    if (prev !== void 0 && curr !== void 0 && curr.start < prev.end) {
+      errors.push(`main-line slides "${prev.sceneId}" and "${curr.sceneId}" overlap`);
+    }
+  }
+  return { resolved: { slides, sequences }, errors };
+}
+
+// src/slideshow/sceneId.ts
+function isSceneLikeCompositionId(compositionId) {
+  const normalized = compositionId.trim().toLowerCase();
+  if (!normalized || normalized === "main") return false;
+  if (normalized.includes("caption")) return false;
+  if (normalized.includes("ambient")) return false;
+  return true;
+}
+export {
+  SLIDESHOW_ISLAND_TYPE,
+  SLIDESHOW_MANIFEST_VERSION,
+  isSceneLikeCompositionId,
+  parseSlideshowManifest,
+  resolveSlideshow,
+  slideshowIslandRegex
+};
+//# sourceMappingURL=slideshow.js.map

package/dist/slideshow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/slideshow/slideshow.types.ts","../src/slideshow/parseSlideshow.ts","../src/slideshow/sceneId.ts"],"sourcesContent":["// packages/core/src/slideshow/slideshow.types.ts\n\n/** Current manifest schema version. Stamped on persist so future schema\n *  changes can detect and migrate older islands. */\nexport const SLIDESHOW_MANIFEST_VERSION = 1;\n\n/** Raw author-facing shapes parsed from the JSON island. */\nexport interface SlideshowManifest {\n  /** Schema version (absent on pre-versioning islands → treat as 1). */\n  version?: number;\n  slides: SlideRef[];\n  slideSequences?: SlideSequence[];\n}\n\nexport interface SlideRef {\n  sceneId: string;\n  startTime?: number;\n  endTime?: number;\n  notes?: string;\n  fragments?: number[];\n  hotspots?: SlideHotspot[];\n  /**\n   * When true, the slide's first `<video>` plays automatically on enter (the\n   * presenter lands on the slide and the clip plays). The slideshow still holds\n   * — it never auto-advances — so the presenter clicks Next when ready.\n   * Defaults to false. Use it when the video is the slide's primary content and\n   * its natural end is the cue to advance, not for background/ambient clips.\n   */\n  autoplay?: boolean;\n  // Reserved — TTS deferred. Parsed and carried, never consumed.\n  ttsScript?: string;\n  ttsAudioUrl?: string;\n  ttsDurationMs?: number;\n}\n\nexport interface SlideHotspot {\n  id: string;\n  label: string;\n  target: string; // references a SlideSequence.id\n  region?: { x: number; y: number; w: number; h: number }; // % of slide\n}\n\nexport interface SlideSequence {\n  id: string;\n  label: string;\n  slides: SlideRef[];\n}\n\n/** A slide with its time range resolved from the matching scene. */\nexport interface ResolvedSlide extends SlideRef {\n  start: number;\n  end: number;\n  fragments: number[]; // always present, sorted, defaulted to []\n  hotspots: SlideHotspot[]; // always present, defaulted to []\n}\n\nexport interface ResolvedSlideSequence {\n  id: string;\n  label: string;\n  slides: ResolvedSlide[];\n}\n\nexport interface ResolvedSlideshow {\n  slides: ResolvedSlide[];\n  sequences: Record<string, ResolvedSlideSequence>; // keyed by sequence id\n}\n","// packages/core/src/slideshow/parseSlideshow.ts\nimport type {\n  SlideshowManifest,\n  SlideRef,\n  ResolvedSlide,\n  ResolvedSlideshow,\n  ResolvedSlideSequence,\n} from \"./slideshow.types\";\n\nexport const SLIDESHOW_ISLAND_TYPE = \"application/hyperframes-slideshow+json\";\n\n/**\n * Builds the island <script> matcher. Capture group 1 = inner JSON.\n *\n * Factory (fresh RegExp per call) on purpose: a RegExp with the `g` flag carries\n * a mutable `lastIndex`, so callers that need `g` must call this each time rather\n * than caching a shared instance.\n */\nexport function slideshowIslandRegex(flags = \"i\"): RegExp {\n  // Escape ALL regex metacharacters in the constant (CodeQL flags the incomplete\n  // `\\` escape). The constant has none today, but a complete escape is correct.\n  const escaped = SLIDESHOW_ISLAND_TYPE.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  return new RegExp(`<script[^>]*type=[\"']${escaped}[\"'][^>]*>([\\\\s\\\\S]*?)<\\\\/script>`, flags);\n}\n\ninterface SceneRange {\n  id: string;\n  start: number;\n  duration: number;\n}\n\n/** Extract the JSON island from composition HTML. Returns null if absent. */\nexport function parseSlideshowManifest(html: string): SlideshowManifest | null {\n  // Match <script type=\"application/hyperframes-slideshow+json\"> ... </script>\n  const re = slideshowIslandRegex(\"i\");\n  const match = re.exec(html);\n  if (!match || match[1] === undefined) return null;\n  const raw = match[1].trim();\n  if (raw.length === 0) return null;\n  const parsed: unknown = JSON.parse(raw);\n  if (!isManifest(parsed)) {\n    throw new Error(\"slideshow island is not a valid SlideshowManifest\");\n  }\n  return parsed;\n}\n\nfunction isOptionalNumberArray(v: unknown): boolean {\n  return v === undefined || (Array.isArray(v) && v.every((n) => typeof n === \"number\"));\n}\n\nfunction isOptionalBoolean(v: unknown): v is boolean | undefined {\n  return v === undefined || typeof v === \"boolean\";\n}\n\nfunction isSlideRef(v: unknown): v is SlideRef {\n  if (typeof v !== \"object\" || v === null) return false;\n  const r = v as Record<string, unknown>;\n  if (typeof r[\"sceneId\"] !== \"string\") return false;\n  if (!isOptionalNumberArray(r[\"fragments\"])) return false;\n  if (r[\"hotspots\"] !== undefined && !Array.isArray(r[\"hotspots\"])) return false;\n  if (!isOptionalBoolean(r[\"autoplay\"])) return false;\n  return true;\n}\n\nfunction isSlideSequence(v: unknown): boolean {\n  if (typeof v !== \"object\" || v === null) return false;\n  const s = v as Record<string, unknown>;\n  return (\n    typeof s[\"id\"] === \"string\" &&\n    typeof s[\"label\"] === \"string\" &&\n    Array.isArray(s[\"slides\"]) &&\n    s[\"slides\"].every(isSlideRef)\n  );\n}\n\nfunction isManifest(v: unknown): v is SlideshowManifest {\n  if (typeof v !== \"object\" || v === null || Array.isArray(v)) return false;\n  const o = v as Record<string, unknown>;\n  if (!Array.isArray(o[\"slides\"]) || !o[\"slides\"].every(isSlideRef)) return false;\n  if (o[\"slideSequences\"] !== undefined) {\n    if (!Array.isArray(o[\"slideSequences\"]) || !o[\"slideSequences\"].every(isSlideSequence))\n      return false;\n  }\n  return true;\n}\n\nfunction missingBoundError(sceneId: string, missing: \"startTime\" | \"endTime\"): string {\n  const present = missing === \"startTime\" ? \"endTime\" : \"startTime\";\n  return `slide \"${sceneId}\" sets ${present} but ${missing} cannot be resolved (no scene \"${sceneId}\")`;\n}\n\n// fallow-ignore-next-line complexity\nfunction resolveTimeRange(\n  ref: SlideRef,\n  scene: SceneRange | undefined,\n  errors: string[],\n): { start: number; end: number } {\n  const { startTime, endTime, sceneId } = ref;\n\n  // Both explicit — use them directly, no scene needed.\n  if (startTime !== undefined && endTime !== undefined) {\n    return { start: startTime, end: endTime };\n  }\n\n  // Neither explicit — resolve both from scene.\n  if (startTime === undefined && endTime === undefined) {\n    if (!scene) {\n      errors.push(`slide references unresolved sceneId \"${sceneId}\"`);\n      return { start: 0, end: 0 };\n    }\n    return { start: scene.start, end: scene.start + scene.duration };\n  }\n\n  // Exactly one bound explicit — fill from scene, or report a clear error.\n  if (!scene) {\n    const missing = startTime === undefined ? \"startTime\" : \"endTime\";\n    errors.push(missingBoundError(sceneId, missing));\n    const bound = startTime ?? endTime ?? 0;\n    return { start: bound, end: bound };\n  }\n\n  return {\n    start: startTime ?? scene.start,\n    end: endTime ?? scene.start + scene.duration,\n  };\n}\n\nfunction validateFragments(\n  sceneId: string,\n  fragments: number[],\n  start: number,\n  end: number,\n  errors: string[],\n): void {\n  for (const f of fragments) {\n    if (f < start || f > end) {\n      errors.push(`slide \"${sceneId}\" fragment ${f} is outside range [${start}, ${end}]`);\n    }\n  }\n}\n\nfunction resolveSlide(\n  ref: SlideRef,\n  sceneById: Map<string, SceneRange>,\n  errors: string[],\n): ResolvedSlide {\n  const scene = sceneById.get(ref.sceneId);\n  const { start, end } = resolveTimeRange(ref, scene, errors);\n  if (ref.startTime !== undefined && ref.endTime !== undefined && end <= start) {\n    errors.push(`slide \"${ref.sceneId}\" has endTime (${end}) <= startTime (${start})`);\n  }\n  const fragments = [...new Set(ref.fragments ?? [])].sort((a, b) => a - b);\n  validateFragments(ref.sceneId, fragments, start, end, errors);\n  return { ...ref, start, end, fragments, hotspots: ref.hotspots ?? [] };\n}\n\nexport function resolveSlideshow(\n  manifest: SlideshowManifest,\n  scenes: SceneRange[],\n): { resolved: ResolvedSlideshow; errors: string[] } {\n  const errors: string[] = [];\n  const sceneById = new Map(scenes.map((s) => [s.id, s]));\n\n  const sequences: Record<string, ResolvedSlideSequence> = {};\n  for (const seq of manifest.slideSequences ?? []) {\n    // Flag duplicate sequence ids rather than silently overwriting the earlier one.\n    if (Object.prototype.hasOwnProperty.call(sequences, seq.id)) {\n      errors.push(`duplicate slideSequence id \"${seq.id}\" — only the last definition is kept`);\n    }\n    sequences[seq.id] = {\n      id: seq.id,\n      label: seq.label,\n      slides: seq.slides.map((s) => resolveSlide(s, sceneById, errors)),\n    };\n  }\n\n  const slides = manifest.slides.map((s) => resolveSlide(s, sceneById, errors));\n\n  // Validate hotspot targets.\n  const allSlides = [...slides, ...Object.values(sequences).flatMap((s) => s.slides)];\n  for (const slide of allSlides) {\n    for (const h of slide.hotspots) {\n      const seq = sequences[h.target];\n      if (!seq) {\n        errors.push(`hotspot \"${h.id}\" targets unknown sequence \"${h.target}\"`);\n      } else if (seq.slides.length === 0) {\n        errors.push(`hotspot \"${h.id}\" targets empty sequence \"${h.target}\"`);\n      }\n    }\n  }\n\n  // Validate no main-line overlap (sorted by start; adjacent compare).\n  const ordered = [...slides].sort((a, b) => a.start - b.start);\n  for (let i = 1; i < ordered.length; i++) {\n    const prev = ordered[i - 1];\n    const curr = ordered[i];\n    if (prev !== undefined && curr !== undefined && curr.start < prev.end) {\n      errors.push(`main-line slides \"${prev.sceneId}\" and \"${curr.sceneId}\" overlap`);\n    }\n  }\n\n  return { resolved: { slides, sequences }, errors };\n}\n","// packages/core/src/slideshow/sceneId.ts\n\n/**\n * Whether a composition id names a \"scene-like\" composition — i.e. a real slide\n * scene, not the root timeline (`main`) or a non-scene overlay (captions, ambient\n * layers). Shared by the runtime scene-window computation and the slideshow lint\n * rule so the two can never drift.\n */\nexport function isSceneLikeCompositionId(compositionId: string): boolean {\n  const normalized = compositionId.trim().toLowerCase();\n  if (!normalized || normalized === \"main\") return false;\n  if (normalized.includes(\"caption\")) return false;\n  if (normalized.includes(\"ambient\")) return false;\n  return true;\n}\n"],"mappings":"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","names":[]}

package/dist/{gsapSerialize-B_JRTCeV.d.ts → types-Cg0ZTXEf.d.ts}

@@ -1,5 +1,3 @@
-import { PropertyGroupName } from './gsapConstants.js';
-
 interface Asset {
     id: string;
     url: string;
@@ -370,166 +368,4 @@ interface StageZoomKeyframe {
 }
 declare function getDefaultStageZoom(resolution: CanvasResolution): StageZoom;
 
-/**
- * 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 TimelineElementType as $, type ArcPathConfig as A, type BooleanVariable as B, type CompositionVariable as C, type CompositionVariableBase as D, type CompositionVariableType as E, DEFAULT_DURATIONS as F, type GsapAnimation as G, type ElementKeyframes as H, type EnumVariable as I, type FontVariable as J, type KeyframeEditability as K, type ImageVariable as L, type MotionPathShape as M, type KeyframeProperties as N, type MediaElementType as O, type ParsedGsap as P, type MediaFile as Q, type NumberVariable as R, type SplitAnimationsOptions as S, type TimelineElement as T, type PlayerAPI as U, type ValidationResult as V, type StageZoom as W, type StringVariable as X, TIMELINE_COLORS as Y, type TimelineCompositionElement as Z, type TimelineElementBase as _, type ArcPathSegment as a, type TimelineMediaElement as a0, type TimelineTextElement as a1, VALID_CANVAS_RESOLUTIONS as a2, type WaveformData as a3, getDefaultStageZoom as a4, isCompositionElement as a5, isMediaElement as a6, isTextElement as a7, normalizeResolutionFlag as a8, 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, type CanvasResolution as n, type Keyframe as o, type StageZoomKeyframe as p, type AddElementData as q, type Asset as r, serializeGsapAnimations as s, CANVAS_DIMENSIONS as t, COMPOSITION_VARIABLE_TYPES as u, validateCompositionGsap as v, type ColorVariable as w, type CompositionAPI as x, type CompositionAsset as y, type CompositionSpec as z };
+export { type AddElementData as A, type BooleanVariable as B, type CompositionVariable as C, DEFAULT_DURATIONS as D, type ElementKeyframes as E, type FontVariable as F, normalizeResolutionFlag as G, type ImageVariable as I, type Keyframe as K, type MediaElementType as M, type NumberVariable as N, type PlayerAPI as P, type StageZoomKeyframe as S, type TimelineElement as T, type ValidationResult as V, type WaveformData as W, type CanvasResolution as a, type Asset as b, CANVAS_DIMENSIONS as c, COMPOSITION_VARIABLE_TYPES as d, type ColorVariable as e, type CompositionAPI as f, type CompositionAsset as g, type CompositionSpec as h, type CompositionVariableBase as i, type CompositionVariableType as j, type EnumVariable as k, type KeyframeProperties as l, type MediaFile as m, type StageZoom as n, type StringVariable as o, TIMELINE_COLORS as p, type TimelineCompositionElement as q, type TimelineElementBase as r, type TimelineElementType as s, type TimelineMediaElement as t, type TimelineTextElement as u, VALID_CANVAS_RESOLUTIONS as v, getDefaultStageZoom as w, isCompositionElement as x, isMediaElement as y, isTextElement as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/parsers",
-  "version": "0.7.15",
+  "version": "0.7.17",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -11,6 +11,7 @@
     "README.md"
   ],
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -46,6 +47,18 @@
     "./gsap-parser-recast": {
       "import": "./dist/gsapParser.js",
       "types": "./dist/gsapParser.d.ts"
+    },
+    "./slideshow": {
+      "import": "./dist/slideshow.js",
+      "types": "./dist/slideshow.d.ts"
+    },
+    "./asset-paths": {
+      "import": "./dist/assets.js",
+      "types": "./dist/assets.d.ts"
+    },
+    "./composition": {
+      "import": "./dist/composition.js",
+      "types": "./dist/composition.d.ts"
     }
   },
   "publishConfig": {
@@ -65,7 +78,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.0.0",
     "vitest": "^3.2.4",
-    "@hyperframes/core": "0.7.15"
+    "@hyperframes/core": "0.7.17"
   },
   "scripts": {
     "build": "tsup",