@hyperframes/studio-server 0.8.206 → 0.8.208

package/dist/{chunk-OSZE5WT3.js → chunk-WAMZ2Z5O.js}

@@ -20,7 +20,7 @@ import {
 } from "fs";
 import { homedir } from "os";
 import { dirname as dirname5, isAbsolute as isAbsolute5, join as join8, relative as relative5, resolve as resolve7, sep as sep5 } from "path";
-import { replaceFileAtomically as replaceFileAtomically5 } from "@hyperframes/core/atomic-file";
+import { replaceFileAtomically as replaceFileAtomically6 } from "@hyperframes/core/atomic-file";
 
 // src/helpers/fileVersion.ts
 import { createHash, randomUUID } from "crypto";
@@ -103,22 +103,15 @@ var consumeFileWriteReceipt = identifyFileWrite;
 // src/helpers/renderOutputs.ts
 import { readFileSync as readFileSync2 } from "fs";
 import { isAbsolute, relative, resolve, sep } from "path";
-import { replaceFileAtomically } from "@hyperframes/core/atomic-file";
+import { replaceFileAtomically as replaceFileAtomically2 } from "@hyperframes/core/atomic-file";
 
 // src/history/ownerLock.ts
 import { spawnSync } from "child_process";
 import { randomUUID as randomUUID2 } from "crypto";
-import {
-  linkSync,
-  mkdirSync,
-  readFileSync,
-  renameSync,
-  rmSync,
-  statSync,
-  writeFileSync
-} from "fs";
+import { linkSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "fs";
 import { uptime } from "os";
 import { join } from "path";
+import { replaceFileAtomically } from "@hyperframes/core/atomic-file";
 var HistoryBusyError = class extends Error {
   constructor(pid, url) {
     super(`This project's history is open in another process (pid ${pid}).`);
@@ -258,9 +251,7 @@ function evictDeadOwner(file) {
 }
 function advertise(urlFile, url) {
   if (!url) return rmSync(urlFile, { force: true });
-  const draft = `${urlFile}-${process.pid}-${randomUUID2()}.tmp`;
-  writeFileSync(draft, JSON.stringify({ pid: process.pid, url }));
-  renameSync(draft, urlFile);
+  replaceFileAtomically(urlFile, JSON.stringify({ pid: process.pid, url }));
 }
 function servedBy(file, urlFile, pid) {
   try {
@@ -294,7 +285,12 @@ async function takeHistoryOwnership(home, waitMs, url) {
     if (next === "claimed") break;
     if (next === "wait") await new Promise((settle) => setTimeout(settle, 50));
   }
-  advertise(urlFile, url);
+  try {
+    advertise(urlFile, url);
+  } catch (error) {
+    releaseOwn(file);
+    throw error;
+  }
   let held = true;
   return () => {
     if (held && servedBy(file, urlFile, process.pid)) rmSync(urlFile, { force: true });
@@ -344,7 +340,7 @@ async function registerRenderOutput(projectDir, output) {
   const release = await takeHistoryOwnership(lock, 5e3);
   try {
     const paths = [.../* @__PURE__ */ new Set([...readRenderOutputs(projectDir), path])].sort();
-    replaceFileAtomically(registry, JSON.stringify({ version: 1, paths }) + "\n", 420);
+    replaceFileAtomically2(registry, JSON.stringify({ version: 1, paths }) + "\n", 420);
   } finally {
     release();
   }
@@ -528,7 +524,7 @@ function createProjectSignature(projectDir, excluding = /* @__PURE__ */ new Set(
 
 // src/history/blobStore.ts
 import { createHash as createHash3, randomUUID as randomUUID3 } from "crypto";
-import { constants, createReadStream, createWriteStream, renameSync as renameSync2 } from "fs";
+import { constants, createReadStream, createWriteStream, renameSync } from "fs";
 import { copyFile, mkdir, readdir, readFile, rename, rm, stat } from "fs/promises";
 import { dirname, join as join2 } from "path";
 import { pipeline } from "stream/promises";
@@ -558,7 +554,7 @@ async function cloneOrCopy(from, to, beforeReplace) {
   try {
     await copyFile(from, temp, constants.COPYFILE_FICLONE);
     beforeReplace?.();
-    renameSync2(temp, to);
+    renameSync(temp, to);
   } catch (error) {
     await rm(temp, { force: true });
     throw error;
@@ -703,7 +699,7 @@ function uncopiedOnlyHashes(log, sizeOf) {
 
 // src/history/pruneHistories.ts
 import { randomUUID as randomUUID5 } from "crypto";
-import { readdirSync as readdirSync2, readFileSync as readFileSync5, renameSync as renameSync3, statSync as statSync3, writeFileSync as writeFileSync3 } from "fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync5, renameSync as renameSync2, statSync as statSync3, writeFileSync as writeFileSync3 } from "fs";
 import { lstat, readdir as readdir2, rm as rm2 } from "fs/promises";
 import { tmpdir } from "os";
 import { dirname as dirname2, join as join4 } from "path";
@@ -712,7 +708,7 @@ import { dirname as dirname2, join as join4 } from "path";
 import { randomUUID as randomUUID4 } from "crypto";
 import { existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync4, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
 import { basename, join as join3, resolve as resolve3 } from "path";
-import { replaceFileAtomically as replaceFileAtomically2 } from "@hyperframes/core/atomic-file";
+import { replaceFileAtomically as replaceFileAtomically3 } from "@hyperframes/core/atomic-file";
 var ID_PATH = join3(".hyperframes", "history-id");
 var ID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
 var isHistoryId = (name) => ID_SHAPE.test(name);
@@ -775,7 +771,7 @@ var HistoryIdError = class extends Error {
 function recordProject(historyDir, dir, folder) {
   const record = { dir, ino: folder.ino, born: folder.birthtimeMs, dev: folder.dev };
   mkdirSync2(historyDir, { recursive: true });
-  replaceFileAtomically2(join3(historyDir, "project.json"), JSON.stringify(record), 420);
+  replaceFileAtomically3(join3(historyDir, "project.json"), JSON.stringify(record), 420);
 }
 
 // src/history/pruneHistories.ts
@@ -867,7 +863,7 @@ function recheckAndMoveAway(historyRoot, id, { now, dryRun, tempDir }) {
   if (projectDir === null) return null;
   if (dryRun) return { projectDir, trash: null };
   const trash = join4(historyRoot, `${PRUNED_PREFIX}${id}-${randomUUID5()}`);
-  renameSync3(home, trash);
+  renameSync2(home, trash);
   return { projectDir, trash };
 }
 function abandonedProject(home, id, now, tempDir) {
@@ -926,9 +922,9 @@ function pruneGoneProjectHistoriesDaily(historyRoot, now, { onError, budgetMs }
 
 // src/history/videoState.ts
 import { createHash as createHash5, randomUUID as randomUUID6 } from "crypto";
-import { createReadStream as createReadStream2, existsSync as existsSync2, readFileSync as readFileSync8, renameSync as renameSync4, statSync as statSync4 } from "fs";
+import { createReadStream as createReadStream2, existsSync as existsSync2, readFileSync as readFileSync8, renameSync as renameSync3, statSync as statSync4 } from "fs";
 import { isAbsolute as isAbsolute4, join as join7, resolve as resolve6 } from "path";
-import { replaceFileAtomically as replaceFileAtomically3 } from "@hyperframes/core/atomic-file";
+import { replaceFileAtomically as replaceFileAtomically4 } from "@hyperframes/core/atomic-file";
 
 // src/history/artifactCleanup.ts
 import { createHash as createHash4 } from "crypto";
@@ -1327,11 +1323,11 @@ async function updateState(dir, update) {
       state = readState(dir);
     } catch (error) {
       if (!(error instanceof SyntaxError)) throw error;
-      renameSync4(statePath(dir), `${statePath(dir)}.invalid-${randomUUID6()}`);
+      renameSync3(statePath(dir), `${statePath(dir)}.invalid-${randomUUID6()}`);
       state = emptyState();
     }
     update(state);
-    replaceFileAtomically3(statePath(dir), JSON.stringify(state, null, 2) + "\n", 420);
+    replaceFileAtomically4(statePath(dir), JSON.stringify(state, null, 2) + "\n", 420);
   } finally {
     release();
   }
@@ -1534,7 +1530,7 @@ async function finishSnapshotRun(projectDir, path) {
 // src/history/historyLog.ts
 import { closeSync as closeSync3, constants as constants4, mkdirSync as mkdirSync4, openSync as openSync3, readFileSync as readFileSync9, writeSync as writeSync2 } from "fs";
 import { dirname as dirname4 } from "path";
-import { replaceFileAtomically as replaceFileAtomically4 } from "@hyperframes/core/atomic-file";
+import { replaceFileAtomically as replaceFileAtomically5 } from "@hyperframes/core/atomic-file";
 var START = "start";
 function parseRecord(line) {
   try {
@@ -1596,7 +1592,7 @@ function writeLog(file, log) {
     ...[...log.pins].map((id) => ({ type: "pin", id, pinned: true }))
   ];
   mkdirSync4(dirname4(file), { recursive: true });
-  replaceFileAtomically4(file, records2.map((r) => `${JSON.stringify(r)}
+  replaceFileAtomically5(file, records2.map((r) => `${JSON.stringify(r)}
 `).join(""), 420);
 }
 function applyEntry(manifest2, entry, side) {
@@ -1966,7 +1962,7 @@ var Engine = class {
     const file = join8(this.home, "adopting.json");
     if (!this.adopting.size) return rmSync3(file, { force: true });
     mkdirSync5(this.home, { recursive: true });
-    replaceFileAtomically5(file, JSON.stringify([...this.adopting.keys()]), 420);
+    replaceFileAtomically6(file, JSON.stringify([...this.adopting.keys()]), 420);
   }
   async adopt(file, sweptAt) {
     try {
@@ -2018,7 +2014,7 @@ var Engine = class {
   saveStatCache() {
     const files = JSON.stringify(Object.fromEntries(this.tracked));
     mkdirSync5(this.home, { recursive: true });
-    replaceFileAtomically5(join8(this.home, "stat.json"), files, 420);
+    replaceFileAtomically6(join8(this.home, "stat.json"), files, 420);
   }
   /**
    * Takes in every write since the last sweep and files each change to its writer. ponytail: always the whole

package/dist/{chunk-2GPN2OSU.js → chunk-ZR3T4TKU.js}

@@ -29,10 +29,46 @@ function parseRateControl(body, format) {
   if (isSet(body.videoBitrate)) return parseVideoBitrate(body.videoBitrate);
   return { ok: true, options: {} };
 }
+function parseKeyframeInterval(value) {
+  if (typeof value !== "number" || !(value > 0)) {
+    return { ok: false, error: "keyframeIntervalSeconds must be a positive number of seconds" };
+  }
+  return { ok: true, options: { keyframeIntervalSeconds: value } };
+}
+function parseBitrateField(name, value) {
+  if (typeof value !== "string" || !VIDEO_BITRATE.test(value)) {
+    return { ok: false, error: `${name} must look like "8M", "5000k" or "8000000"` };
+  }
+  return { ok: true, options: { [name]: value } };
+}
+var DELIVERY_FIELDS = [
+  ["keyframeIntervalSeconds", parseKeyframeInterval],
+  ["maxBitrate", (value) => parseBitrateField("maxBitrate", value)],
+  ["bufferSize", (value) => parseBitrateField("bufferSize", value)]
+];
+function parseDelivery(body, format) {
+  const present = DELIVERY_FIELDS.filter(([name]) => isSet(body[name]));
+  if (present.length === 0) return { ok: true, options: {} };
+  if (format !== "mp4") {
+    return { ok: false, error: "keyframeIntervalSeconds and maxBitrate apply to mp4 renders" };
+  }
+  if (isSet(body.bufferSize) && !isSet(body.maxBitrate)) {
+    return { ok: false, error: "bufferSize requires maxBitrate" };
+  }
+  const options = {};
+  for (const [name, parse] of present) {
+    const parsed = parse(body[name]);
+    if (!parsed.ok) return parsed;
+    Object.assign(options, parsed.options);
+  }
+  return { ok: true, options };
+}
 function parseEncoderOptions(body, format) {
   const rate = parseRateControl(body, format);
   if (!rate.ok) return rate;
-  const options = { ...rate.options };
+  const delivery = parseDelivery(body, format);
+  if (!delivery.ok) return delivery;
+  const options = { ...rate.options, ...delivery.options };
   if (isSet(body.gifLoop)) {
     if (typeof body.gifLoop !== "number" || !Number.isInteger(body.gifLoop) || body.gifLoop < 0 || body.gifLoop > 65535) {
       return { ok: false, error: "gifLoop must be an integer from 0 to 65535" };
@@ -56,7 +92,20 @@ function parseEncoderOptions(body, format) {
   }
   return { ok: true, options };
 }
+function encoderJobOptions(opts) {
+  const { crf, videoBitrate, keyframeIntervalSeconds, maxBitrate, bufferSize } = opts;
+  return {
+    ...crf !== void 0 ? { crf } : {},
+    ...videoBitrate ? { videoBitrate } : {},
+    ...keyframeIntervalSeconds !== void 0 ? { keyframeIntervalSeconds } : {},
+    ...maxBitrate ? { maxBitrate } : {},
+    ...bufferSize ? { bufferSize } : {},
+    ...opts.videoFrameFormat ? { videoFrameFormat: opts.videoFrameFormat } : {},
+    ...opts.hdrMode ? { hdrMode: opts.hdrMode } : {}
+  };
+}
 
 export {
-  parseEncoderOptions
+  parseEncoderOptions,
+  encoderJobOptions
 };

package/dist/helpers/encoderOptions.d.ts

@@ -6,6 +6,9 @@ interface EncoderOptions {
     videoBitrate?: string;
     videoFrameFormat?: (typeof VIDEO_FRAME_FORMATS)[number];
     hdrMode?: (typeof HDR_MODES)[number];
+    keyframeIntervalSeconds?: number;
+    maxBitrate?: string;
+    bufferSize?: string;
 }
 interface EncoderOptionsBody {
     gifLoop?: unknown;
@@ -13,6 +16,9 @@ interface EncoderOptionsBody {
     videoBitrate?: unknown;
     videoFrameFormat?: unknown;
     hdrMode?: unknown;
+    keyframeIntervalSeconds?: unknown;
+    maxBitrate?: unknown;
+    bufferSize?: unknown;
 }
 type Parsed = {
     ok: true;
@@ -23,5 +29,6 @@ type Parsed = {
 };
 /** Explicit encoder overrides from a render request. MOV (ProRes) takes no rate control. */
 declare function parseEncoderOptions(body: EncoderOptionsBody, format: string): Parsed;
+declare function encoderJobOptions(opts: EncoderOptions): Omit<EncoderOptions, "gifLoop">;
 
-export { type EncoderOptionsBody, parseEncoderOptions };
+export { type EncoderOptionsBody, encoderJobOptions, parseEncoderOptions };

package/dist/helpers/encoderOptions.js

@@ -1,6 +1,8 @@
 import {
+  encoderJobOptions,
   parseEncoderOptions
-} from "../chunk-2GPN2OSU.js";
+} from "../chunk-ZR3T4TKU.js";
 export {
+  encoderJobOptions,
   parseEncoderOptions
 };

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-DeICCYb5.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-DIEtpLJo.js';
 import './mediaCodecMap.js';
 import 'sharp';
 import '@hyperframes/parsers';

package/dist/history/index.js

@@ -22,7 +22,7 @@ import {
   recordRenderSuccess,
   registerRenderOutput,
   retainSnapshotOutput
-} from "../chunk-OSZE5WT3.js";
+} from "../chunk-WAMZ2Z5O.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

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-DeICCYb5.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-DeICCYb5.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-DIEtpLJo.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-DIEtpLJo.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

@@ -24,7 +24,7 @@ import {
 } from "./chunk-FJBJJURY.js";
 import {
   parseEncoderOptions
-} from "./chunk-2GPN2OSU.js";
+} from "./chunk-ZR3T4TKU.js";
 import {
   DEFAULT_HISTORY_ROOT,
   DELETED_VERSION,
@@ -62,7 +62,7 @@ import {
   resolveProjectSignature,
   retainSnapshotOutput,
   settledFileTag
-} from "./chunk-OSZE5WT3.js";
+} from "./chunk-WAMZ2Z5O.js";
 import {
   clearElementScreenshotIsolation,
   getElementScreenshotClip
@@ -3902,8 +3902,51 @@ import {
   normalizeGsapBaseUrl,
   normalizeGsapLocalRoot
 } from "@hyperframes/core/gsap-cdn";
-import { findStartTags as findStartTags3, injectTagsAtHeadStart } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags4, injectTagsAtHeadStart as injectTagsAtHeadStart2 } from "@hyperframes/core/compiler/html-document";
 import { isWithinProjectRoot } from "@hyperframes/parsers/asset-resolution";
+
+// src/helpers/rootImportMap.ts
+import { findStartTags as findStartTags2, injectTagsAtHeadStart } from "@hyperframes/core/compiler/html-document";
+var ROOT_PATH = /^\/(?!\/)/;
+var IMPORT_MAP_TYPE = /\btype\s*=\s*["']?importmap["']?(?=[\s/>])/i;
+function findImportMap(html) {
+  for (const at of findStartTags2(html, "script")) {
+    const open2 = /^<script\b[^>]*>/i.exec(html.slice(at));
+    if (!open2 || !IMPORT_MAP_TYPE.test(open2[0])) continue;
+    const start = at + open2[0].length;
+    const end = html.toLowerCase().indexOf("</script", start);
+    if (end !== -1) return { start, end, json: html.slice(start, end) };
+  }
+  return null;
+}
+function withRootImportMap(html, base) {
+  const ours = { "/": base, [base]: base };
+  const own = findImportMap(html);
+  if (!own)
+    return injectTagsAtHeadStart(
+      html,
+      `<script type="importmap">${JSON.stringify({ imports: ours })}</script>`
+    );
+  let map;
+  try {
+    map = JSON.parse(own.json);
+  } catch {
+    return html;
+  }
+  if (!map || typeof map !== "object") return html;
+  const under = (path) => ROOT_PATH.test(path) && !path.startsWith(base) ? base + path.slice(1) : path;
+  const moved = (entries = {}) => Object.fromEntries(
+    Object.entries(entries).map(([key, target]) => [key, under(String(target))])
+  );
+  const merged = { ...map, imports: { ...ours, ...moved(map.imports) } };
+  if (map.scopes)
+    merged.scopes = Object.fromEntries(
+      Object.entries(map.scopes).map(([scope, entries]) => [under(scope), moved(entries)])
+    );
+  return html.slice(0, own.start) + JSON.stringify(merged) + html.slice(own.end);
+}
+
+// src/routes/preview.ts
 import { ensureHfIds as ensureHfIds2 } from "@hyperframes/parsers/hf-ids";
 
 // src/helpers/previewReads.ts
@@ -4037,7 +4080,7 @@ function injectPreviewVariables(html, values) {
 }
 
 // src/helpers/lazyPreviewImages.ts
-import { findStartTags as findStartTags2 } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags3 } 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) {
@@ -4050,7 +4093,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 = findStartTags2(html, "img");
+  const tags = findStartTags3(html, "img");
   if (tags.length !== images.length) return html;
   const parts = [];
   let from = 0;
@@ -4136,7 +4179,7 @@ function injectMotionPathPluginIfNeeded(html, baseUrl) {
 }
 function findGsapCoreScript(html) {
   const scripts = [...parseHTML7(html).document.querySelectorAll("script")];
-  const starts = findStartTags3(html, "script");
+  const starts = findStartTags4(html, "script");
   if (starts.length !== scripts.length) return null;
   const at = scripts.findIndex(
     (script) => isGsapCoreUrl(lowerCaseAttributes(script).get("src") ?? "")
@@ -4242,16 +4285,16 @@ var PREVIEW_CAPTURE_PARAM = "hf-capture";
 var EARLY_ERRORS_SCRIPT = `<script>(function(){var seen=window.${STUDIO_PREVIEW_ERRORS}=[];
 addEventListener("error",function(e){seen.push(e.message||String(e))});})();</script>`;
 function injectStudioPreviewAugmentations(html, adapter, projectDir, activeCompositionPath, options) {
-  const marked = options.capture ? injectTagsAtHeadStart(
+  const marked = options.capture ? injectTagsAtHeadStart2(
     html,
     `<meta name="${STUDIO_PREVIEW_MARK_META}" content="${STUDIO_PREVIEW_CAPTURE_MODE}">`
-  ) : injectTagsAtHeadStart(
+  ) : injectTagsAtHeadStart2(
     lazyPreviewImages(html),
     `<meta name="${STUDIO_PREVIEW_MARK_META}">${EARLY_ERRORS_SCRIPT}`
   );
   const withFallback = injectGsapCdnFallback(
     injectProjectSignature(
-      injectTagsAtHeadStart(
+      injectTagsAtHeadStart2(
         marked,
         `<meta name="${GSAP_BASE_URL_META}" content="${escapeGsapUrl(options.gsapBaseUrl)}">`
       ),
@@ -4307,7 +4350,11 @@ var PREVIEW_BUNDLE_OPTIONS = {
   sceneParts: true
 };
 var previewBaseHref = (projectId) => `/api/projects/${encodeURIComponent(projectId)}/preview/`;
-var withPreviewBase = (html, projectId) => hasBaseElement(html) ? html : injectTagsAtHeadStart(html, `<base href="${previewBaseHref(projectId)}">`);
+var withPreviewBase = (html, projectId) => {
+  const base = previewBaseHref(projectId);
+  const mapped = withRootImportMap(html, base);
+  return hasBaseElement(mapped) ? mapped : injectTagsAtHeadStart2(mapped, `<base href="${base}">`);
+};
 function resolvePreviewGsapBaseUrl(adapter) {
   const configured = process.env.HYPERFRAMES_GSAP_BASE_URL;
   if (configured?.trim() || !adapter.gsapLocalRoot) {
@@ -4482,6 +4529,7 @@ ${etag}`;
       gsapBaseUrl
     );
     if (!html) return c.text("not found", 404);
+    html = withRootImportMap(html, baseHref);
     recordPreviewReferences(project.dir, html);
     html = ensureHfIds2(await transformPreviewHtml(html, adapter, project, compPath));
     html = injectStudioPreviewAugmentations(html, adapter, project.dir, compPath, {
@@ -6672,9 +6720,12 @@ function registerHistoryRoutes(api, adapter) {
 }
 
 // src/helpers/previewErrorPage.ts
-import { STUDIO_PREVIEW_ERRORS as STUDIO_PREVIEW_ERRORS2 } from "@hyperframes/core/studio-preview-mark";
+import {
+  refusedPreviewMessage,
+  STUDIO_PREVIEW_ERRORS as STUDIO_PREVIEW_ERRORS2
+} from "@hyperframes/core/studio-preview-mark";
 function previewErrorPage(status) {
-  const message = `The preview page could not be loaded (HTTP ${status}).`;
+  const message = refusedPreviewMessage(status);
   return `<!doctype html><meta charset="utf-8"><script>window.${STUDIO_PREVIEW_ERRORS2}=[${JSON.stringify(message)}]</script><p>${message}</p>`;
 }
 

package/dist/{mediaProxyPreview-DeICCYb5.d.ts → mediaProxyPreview-DIEtpLJo.d.ts}

@@ -167,6 +167,9 @@ interface StudioApiAdapter {
         gifLoop?: number;
         crf?: number;
         videoBitrate?: string;
+        keyframeIntervalSeconds?: number;
+        maxBitrate?: string;
+        bufferSize?: string;
         videoFrameFormat?: "auto" | "jpg" | "png";
         hdrMode?: "auto" | "force-hdr" | "force-sdr";
         jobId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.8.206",
+  "version": "0.8.208",
   "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/parsers": "0.8.206",
-    "@hyperframes/core": "0.8.206"
+    "@hyperframes/core": "0.8.208",
+    "@hyperframes/parsers": "0.8.208"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",