@hyperframes/studio-server 0.8.194 → 0.8.195

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,5 +1,5 @@
 import '@hyperframes/core';
-export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-C0DZX2Mo.js';
+export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-CdpmyC5i.js';
 import './mediaCodecMap.js';
 import 'sharp';
 import '@hyperframes/parsers';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-C0DZX2Mo.js';
-export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-C0DZX2Mo.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-CdpmyC5i.js';
+export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-CdpmyC5i.js';
 export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, S as HISTORY_START, H as HistoryClosedError, a as HistoryEntry, b as HistoryEntrySide, c as HistoryFileChange, d as HistoryListItem, e as HistoryRefusedError, f as HistoryResult, g as HistoryTarget, h as HistoryWho, i as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, j as ProjectHistoryOptions, k as ProjectHistoryView, U as UNDO_MODES, l as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-C18HDvac.js';
 export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, ReclaimedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';

package/dist/index.js

@@ -267,6 +267,53 @@ import {
 } from "@hyperframes/core/compiler";
 import { isFullHtmlDocument } from "@hyperframes/core/compiler/html-document";
 import { gsapCdnDist } from "@hyperframes/core/gsap-cdn";
+
+// src/helpers/gsapCoreScript.ts
+import { findStartTags, insertBeforeCloseTag } from "@hyperframes/core/compiler/html-document";
+var URL_BASE = "http://localhost/";
+function urlPath(src) {
+  return URL.canParse(src, URL_BASE) ? new URL(src, URL_BASE).pathname : null;
+}
+function isGsapCoreUrl(src) {
+  return /\/gsap(-\d+(\.\d+)*)?(\.min)?\.js$/i.test(urlPath(src) ?? "");
+}
+var GSAP_PLUGIN_FILE = /\/(\w+Plugin|CustomBounce|CustomEase|CustomWiggle|Draggable|EasePack|Flip|GSDevTools|MotionPathHelper|Observer|ScrollSmoother|ScrollTrigger|SplitText)(\.min)?\.js$/i;
+function isGsapPluginUrl(src) {
+  const path = urlPath(src);
+  if (!path || isGsapCoreUrl(src)) return false;
+  return GSAP_PLUGIN_FILE.test(path) || /\/gsap(@[^/]*)?\/(.+\/)?[^/]+\.js$/i.test(path);
+}
+var TEMPLATE_ELEMENT = /<template\b[^>]*>[\s\S]*?<\/template>/gi;
+var SCRIPT_SRC = /<script\b[^>]*?\ssrc\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi;
+var INLINED_MARKER = /\/\*\s*inlined:\s*(\S+)\s*\*\//gi;
+var CORE_LICENSE_BANNER = /\/\*!\s*\*\s*GSAP\s+\d/;
+var PLUGIN_LICENSE_BANNER = /\/\*!\s*\*\s*(?!GSAP\s)\w+\s+\d[^*]*\*\s*https:\/\/gsap\.com/;
+var CORE_BODY = /Missing plugin\? gsap\.registerPlugin\(\)/;
+function scriptUrls(html) {
+  const srcs = [...html.matchAll(SCRIPT_SRC)].map(
+    (m) => (m[1] ?? m[2] ?? m[3] ?? "").replace(/&amp;/gi, "&")
+  );
+  return [...srcs, ...[...html.matchAll(INLINED_MARKER)].map((m) => m[1] ?? "")];
+}
+function htmlHasGsapCore(html) {
+  const live = html.replace(TEMPLATE_ELEMENT, "");
+  return scriptUrls(live).some(isGsapCoreUrl) || CORE_LICENSE_BANNER.test(live) || CORE_BODY.test(live);
+}
+function isGsapPluginScript(script) {
+  return scriptUrls(script).some(isGsapPluginUrl) || PLUGIN_LICENSE_BANNER.test(script);
+}
+function insertGsapCoreBeforeHeadPlugin(html, coreTag) {
+  const lowered = html.toLowerCase();
+  const at = findStartTags(html, "script").find((start) => {
+    const close = lowered.indexOf("</script", start);
+    return isGsapPluginScript(html.slice(start, close === -1 ? void 0 : close));
+  });
+  if (at === void 0 || insertBeforeCloseTag(html.slice(0, at), "head", "") !== null) return null;
+  return `${html.slice(0, at)}${coreTag}
+${html.slice(at)}`;
+}
+
+// src/helpers/subComposition.ts
 function rewriteRelativePaths(root, compPath, projectDir) {
   const assetExists = (path) => existsSync(join2(projectDir, path));
   rewriteAssetPaths(
@@ -417,9 +464,10 @@ ${compHeadContent}`;
   headContent = stripEmbeddedRuntimeScripts(headContent);
   headContent += `
 <script ${RUNTIME_BOOTSTRAP_ATTR}="1" src="${runtimeUrl}"></script>`;
-  if (!headContent.includes("gsap")) {
-    headContent += `
-<script src="${gsapCdnDist(void 0, gsapBaseUrl).replace(/&/g, "&amp;")}gsap.min.js"></script>`;
+  if (!htmlHasGsapCore(headContent)) {
+    const core = `<script src="${gsapCdnDist(void 0, gsapBaseUrl).replace(/&/g, "&amp;")}gsap.min.js"></script>`;
+    headContent = insertGsapCoreBeforeHeadPlugin(headContent, core) ?? `${headContent}
+${core}`;
   }
   const htmlOpen = htmlAttrs ? `<html ${htmlAttrs}>` : "<html>";
   const bodyOpen = bodyAttrs ? `<body ${bodyAttrs}>` : "<body>";
@@ -1225,7 +1273,7 @@ function resolveGsapWriter(env) {
 // src/routes/files.ts
 import {
   hasCompositionOutsideTemplates,
-  insertBeforeCloseTag
+  insertBeforeCloseTag as insertBeforeCloseTag2
 } from "@hyperframes/core/compiler/html-document";
 async function loadGsapParser() {
   return import("@hyperframes/parsers/gsap-parser-recast");
@@ -2097,8 +2145,8 @@ async function prepareGsapMutationScript(c, res, firstMutation) {
       "</script>"
     ].join("\n");
     const [first, second] = hasCompositionOutsideTemplates(html) ? ["body", "template"] : ["template", "body"];
-    html = insertBeforeCloseTag(html, first, `${bootstrap}
-`) ?? insertBeforeCloseTag(html, second, `${bootstrap}
+    html = insertBeforeCloseTag2(html, first, `${bootstrap}
+`) ?? insertBeforeCloseTag2(html, second, `${bootstrap}
 `) ?? `${html}
 ${bootstrap}`;
     block = extractGsapScriptBlock(html);
@@ -3828,7 +3876,7 @@ import {
   AFTER_FONTS_SCRIPT_TYPE,
   addScenePartsManifest,
   RUNTIME_BOOTSTRAP_ATTR as RUNTIME_BOOTSTRAP_ATTR2,
-  insertBeforeCloseTag as insertBeforeCloseTag2,
+  insertBeforeCloseTag as insertBeforeCloseTag3,
   insertRuntimeTag,
   stripEmbeddedRuntimeScripts as stripEmbeddedRuntimeScripts2
 } from "@hyperframes/core/compiler";
@@ -3842,9 +3890,10 @@ import {
   GSAP_BASE_URL_META,
   gsapCdnDist as gsapCdnDist2,
   motionPathPluginUrl,
-  normalizeGsapBaseUrl
+  normalizeGsapBaseUrl,
+  normalizeGsapLocalRoot
 } from "@hyperframes/core/gsap-cdn";
-import { findStartTags as findStartTags2, injectTagsAtHeadStart } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags3, injectTagsAtHeadStart } from "@hyperframes/core/compiler/html-document";
 import { isWithinProjectRoot } from "@hyperframes/parsers/asset-resolution";
 import { ensureHfIds as ensureHfIds2 } from "@hyperframes/parsers/hf-ids";
 
@@ -3979,7 +4028,7 @@ function injectPreviewVariables(html, values) {
 }
 
 // src/helpers/lazyPreviewImages.ts
-import { findStartTags } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags2 } from "@hyperframes/core/compiler/html-document";
 import { parseHTML as parseHTML6 } from "linkedom";
 import { STUDIO_PREVIEW_LAZY_ATTR } from "@hyperframes/core/studio-preview-mark";
 function startsAfterZero(el) {
@@ -3992,7 +4041,7 @@ var hasLoading = (img) => Array.from(img.attributes).some((attr) => attr.name.to
 function lazyPreviewImages(html) {
   if (!/<!doctype|<html[\s>]/i.test(html)) return html;
   const images = [...parseHTML6(html).document.querySelectorAll("img")];
-  const tags = findStartTags(html, "img");
+  const tags = findStartTags2(html, "img");
   if (tags.length !== images.length) return html;
   const parts = [];
   let from = 0;
@@ -4022,7 +4071,7 @@ function injectProjectSignature(html, signature) {
       tag
     );
   }
-  return insertBeforeCloseTag2(html, "head", `${tag}
+  return insertBeforeCloseTag3(html, "head", `${tag}
 `) ?? `${tag}
 ${html}`;
 }
@@ -4052,14 +4101,10 @@ function withPreviewRuntime(html, runtimeUrl) {
   return insertRuntimeTag(stripEmbeddedRuntimeScripts2(html), tag);
 }
 function injectScriptTagIntoHead(html, scriptTag) {
-  return insertBeforeCloseTag2(html, "head", `${scriptTag}
+  return insertBeforeCloseTag3(html, "head", `${scriptTag}
 `) ?? `${scriptTag}
 ${html}`;
 }
-function htmlHasGsap(html) {
-  const outsideTemplates = html.replace(/<template\b[^>]*>[\s\S]*?<\/template>/gi, "");
-  return /<script\b[^>]*src=["'][^"']*gsap/i.test(outsideTemplates) || /\/\*\s*inlined:.*gsap/i.test(outsideTemplates) || /\b(GreenSock|_gsScope)\b/.test(outsideTemplates) || /\bgsap\.(config|defaults|registerPlugin|version)\b/.test(outsideTemplates);
-}
 function htmlHasCustomEase(html) {
   return /<script\b[^>]*src=["'][^"']*CustomEase/i.test(html) || /\bwindow\.CustomEase\b/.test(html) || /\bCustomEase\s*=\s*/.test(html);
 }
@@ -4080,13 +4125,9 @@ function injectMotionPathPluginIfNeeded(html, baseUrl) {
   }
   return injectScriptTagIntoHead(html, gsapScriptTag("MotionPathPlugin.min.js", baseUrl));
 }
-function isGsapCoreUrl(src) {
-  const base = "http://localhost/";
-  return URL.canParse(src, base) && /\/gsap(\.min)?\.js$/i.test(new URL(src, base).pathname);
-}
 function findGsapCoreScript(html) {
   const scripts = [...parseHTML7(html).document.querySelectorAll("script")];
-  const starts = findStartTags2(html, "script");
+  const starts = findStartTags3(html, "script");
   if (starts.length !== scripts.length) return null;
   const at = scripts.findIndex(
     (script) => isGsapCoreUrl(lowerCaseAttributes(script).get("src") ?? "")
@@ -4115,22 +4156,25 @@ function injectStudioMotionDependencies(html, manifestContent, baseUrl) {
   const manifest = parseStudioMotionManifestContent(manifestContent);
   if (!manifest.hasMotion) return html;
   let next = html;
-  if (!htmlHasGsap(next))
-    next = injectScriptTagIntoHead(next, gsapScriptTag("gsap.min.js", baseUrl));
+  if (!htmlHasGsapCore(next)) {
+    const core = gsapScriptTag("gsap.min.js", baseUrl);
+    next = insertGsapCoreBeforeHeadPlugin(next, core) ?? injectScriptTagIntoHead(next, core);
+  }
   if (manifest.hasCustomEase && !htmlHasCustomEase(next)) {
     next = injectScriptTagIntoHead(next, gsapScriptTag("CustomEase.min.js", baseUrl));
   }
   return next;
 }
-function injectStudioMotionScript(html, projectDir, activeCompositionPath, baseUrl) {
+function readStudioMotion(projectDir, activeCompositionPath) {
   const manifestContent = readStudioMotionManifestContent(projectDir);
   const script = createStudioMotionRenderBodyScript(manifestContent, {
     activeCompositionPath
   });
-  if (!script) return html;
-  const withDependencies = injectStudioMotionDependencies(html, manifestContent, baseUrl);
+  return script ? { manifestContent, script } : null;
+}
+function injectStudioMotionScript(html, script) {
   const tag = `<script type="${AFTER_FONTS_SCRIPT_TYPE}">${script.replace(/<\/script/gi, "<\\/script")}</script>`;
-  return insertBeforeCloseTag2(withDependencies, "body", tag) ?? `${withDependencies}${tag}`;
+  return insertBeforeCloseTag3(html, "body", tag) ?? `${html}${tag}`;
 }
 var GSAP_FALLBACK_ATTR = "data-hf-gsap-fallback";
 function gsapCdnFallbackScript(baseUrl) {
@@ -4196,24 +4240,24 @@ function injectStudioPreviewAugmentations(html, adapter, projectDir, activeCompo
     lazyPreviewImages(html),
     `<meta name="${STUDIO_PREVIEW_MARK_META}">${EARLY_ERRORS_SCRIPT}`
   );
-  return injectStudioMotionScript(
-    injectMotionPathPluginIfNeeded(
-      injectGsapCdnFallback(
-        injectProjectSignature(
-          injectTagsAtHeadStart(
-            marked,
-            `<meta name="${GSAP_BASE_URL_META}" content="${escapeGsapUrl(options.gsapBaseUrl)}">`
-          ),
-          resolveProjectSignature(adapter, projectDir)
-        ),
-        options.gsapBaseUrl
+  const withFallback = injectGsapCdnFallback(
+    injectProjectSignature(
+      injectTagsAtHeadStart(
+        marked,
+        `<meta name="${GSAP_BASE_URL_META}" content="${escapeGsapUrl(options.gsapBaseUrl)}">`
       ),
-      options.gsapBaseUrl
+      resolveProjectSignature(adapter, projectDir)
     ),
-    projectDir,
-    activeCompositionPath,
     options.gsapBaseUrl
   );
+  const studioMotion = readStudioMotion(projectDir, activeCompositionPath);
+  const withMotionDependencies = studioMotion ? injectStudioMotionDependencies(
+    withFallback,
+    studioMotion.manifestContent,
+    options.gsapBaseUrl
+  ) : withFallback;
+  const withPlugin = injectMotionPathPluginIfNeeded(withMotionDependencies, options.gsapBaseUrl);
+  return studioMotion ? injectStudioMotionScript(withPlugin, studioMotion.script) : withPlugin;
 }
 async function transformPreviewHtml(html, adapter, project, activeCompositionPath) {
   if (!adapter.transformPreviewHtml) return html;
@@ -4255,16 +4299,22 @@ var PREVIEW_BUNDLE_OPTIONS = {
 };
 var previewBaseHref = (projectId) => `/api/projects/${encodeURIComponent(projectId)}/preview/`;
 var withPreviewBase = (html, projectId) => hasBaseElement(html) ? html : injectTagsAtHeadStart(html, `<base href="${previewBaseHref(projectId)}">`);
-function registerPreviewRoutes(api, adapter) {
-  let gsapBaseUrl;
-  try {
-    gsapBaseUrl = normalizeGsapBaseUrl(process.env.HYPERFRAMES_GSAP_BASE_URL);
-  } catch (cause) {
-    throw new Error(
-      "Invalid HYPERFRAMES_GSAP_BASE_URL: use an absolute HTTP(S) npm mirror root without credentials, query, or fragment",
-      { cause }
-    );
+function resolvePreviewGsapBaseUrl(adapter) {
+  const configured = process.env.HYPERFRAMES_GSAP_BASE_URL;
+  if (configured?.trim() || !adapter.gsapLocalRoot) {
+    try {
+      return normalizeGsapBaseUrl(configured);
+    } catch (cause) {
+      throw new Error(
+        "Invalid HYPERFRAMES_GSAP_BASE_URL: use an absolute HTTPS npm mirror root (plain HTTP only for localhost) without credentials, query, or fragment",
+        { cause }
+      );
+    }
   }
+  return normalizeGsapLocalRoot(adapter.gsapLocalRoot);
+}
+function registerPreviewRoutes(api, adapter) {
+  const gsapBaseUrl = resolvePreviewGsapBaseUrl(adapter);
   const gsapEtagSalt = `:gsap:${createHash2("sha1").update(gsapBaseUrl).digest("hex").slice(0, 12)}`;
   const previewCacheHeaders = (etag) => ({
     "Cache-Control": "private, no-cache",

package/dist/{mediaProxyPreview-C0DZX2Mo.d.ts → mediaProxyPreview-CdpmyC5i.d.ts}

@@ -135,6 +135,7 @@ interface StudioApiAdapter {
     lintProject?: (projectDir: string) => Promise<ProjectLintResult> | ProjectLintResult;
     /** URL to the hyperframe runtime JS (injected into preview HTML). */
     runtimeUrl: string;
+    gsapLocalRoot?: `/${string}`;
     /**
      * Optional: post-process preview HTML before Studio augments it.
      * Useful when preview must mirror render-time compilation steps.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.8.194",
+  "version": "0.8.195",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -84,8 +84,8 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.2",
-    "@hyperframes/core": "0.8.194",
-    "@hyperframes/parsers": "0.8.194"
+    "@hyperframes/parsers": "0.8.195",
+    "@hyperframes/core": "0.8.195"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",