@hyperframes/studio-server 0.8.150 → 0.8.152

package/dist/{chunk-EJC7TX3O.js → chunk-FKJBNFWA.js}

@@ -1,6 +1,6 @@
 import {
   realpath
-} from "./chunk-M62HDRLX.js";
+} from "./chunk-K56J3CL7.js";
 
 // src/helpers/mediaCodecMap.ts
 import { scanHtmlOpeningTags, decodeAuthoredAttribute } from "@hyperframes/parsers";

package/dist/{chunk-Z5UJMFO4.js → chunk-JBFOY5SI.js}

@@ -307,11 +307,20 @@ function setElementDuration(el, start, duration, trackIndex) {
     ...trackIndex != null ? { trackIndex } : {}
   });
 }
+function isWindowOf(media, row) {
+  if (media.duration <= 0) return false;
+  const near = (a, b) => Math.abs(a - b) < 1e-3;
+  return !row || near(media.start, row.start) && near(media.duration, row.duration);
+}
 function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
   const { document, wrappedFragment } = parseSourceDocument(source);
   const el = findTargetElement(document, target);
   if (!el || !isHTMLElement(el)) return { html: source, matched: false, newId: null };
-  const timing = resolveElementTiming(el);
+  const timedMediaSelector = "video[data-start], audio[data-start]";
+  const innerMedia = el.hasAttribute("data-start") || resolveElementTiming(el).duration > 0 || el.matches("[data-composition-src], [data-composition-id]") ? null : el.querySelector(timedMediaSelector);
+  const timedMedia = innerMedia && isWindowOf(resolveElementTiming(innerMedia), fallbackTiming) ? innerMedia : null;
+  const timed = timedMedia ?? el;
+  const timing = resolveElementTiming(timed);
   let { start, duration } = timing;
   if (duration <= 0 && fallbackTiming && fallbackTiming.duration > 0) {
     start = fallbackTiming.start;
@@ -329,16 +338,22 @@ function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
   dedupeClonedCompositionId(document, clone);
   clone.removeAttribute("data-hf-id");
   for (const node of clone.querySelectorAll("[data-hf-id]")) node.removeAttribute("data-hf-id");
-  setElementDuration(clone, splitTime, secondDuration, fallbackTiming?.track);
-  const playbackStartAttr = el.hasAttribute("data-playback-start") ? "data-playback-start" : el.hasAttribute("data-media-start") ? "data-media-start" : el.matches("[data-composition-src], [data-composition-id]") ? "data-playback-start" : el.matches("audio, video") ? "data-media-start" : null;
+  const clonedTimed = timedMedia ? clone.querySelector(timedMediaSelector) : clone;
+  if (timedMedia?.id) {
+    const mediaId = nextUniqueId(document, `${timedMedia.id}-split`, /* @__PURE__ */ new Set([newId]));
+    duplicateCssRulesForId(document, timedMedia.id, mediaId);
+    clonedTimed.setAttribute("id", mediaId);
+  }
+  setElementDuration(clonedTimed, splitTime, secondDuration, fallbackTiming?.track);
+  const playbackStartAttr = timed.hasAttribute("data-playback-start") ? "data-playback-start" : timed.hasAttribute("data-media-start") ? "data-media-start" : timed.matches("[data-composition-src], [data-composition-id]") ? "data-playback-start" : timed.matches("audio, video") ? "data-media-start" : null;
   if (playbackStartAttr) {
-    const readAttr = (name) => el.getAttribute(name);
-    const authoredTrim = el.getAttribute(playbackStartAttr);
+    const readAttr = (name) => timed.getAttribute(name);
+    const authoredTrim = timed.getAttribute(playbackStartAttr);
     const currentTrim = authoredTrim !== null ? readMediaOffsetSeconds(readAttr) : fallbackTiming?.playbackStart ?? 0;
     const rate = readPlaybackRate(readAttr, fallbackTiming?.playbackRate);
     if (authoredTrim === null || Number(authoredTrim) !== currentTrim)
-      el.setAttribute(playbackStartAttr, String(Math.round(currentTrim * 1e3) / 1e3));
-    clone.setAttribute(
+      timed.setAttribute(playbackStartAttr, String(Math.round(currentTrim * 1e3) / 1e3));
+    clonedTimed.setAttribute(
       playbackStartAttr,
       String(Math.round((currentTrim + firstDuration * rate) * 1e3) / 1e3)
     );
@@ -347,7 +362,7 @@ function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
   if (originalId) {
     duplicateCssRulesForId(document, originalId, newId);
   }
-  setElementDuration(el, start, firstDuration, fallbackTiming?.track);
+  setElementDuration(timed, start, firstDuration, fallbackTiming?.track);
   if (el.nextSibling) {
     el.parentElement.insertBefore(clone, el.nextSibling);
   } else {

package/dist/{chunk-XKBQOQFZ.js → chunk-JTPV2T3F.js}

@@ -2,12 +2,12 @@ import {
   PROXY_VARIANT_CONFIG,
   probeFirstFrameColour,
   probeMediaMetadata
-} from "./chunk-EJC7TX3O.js";
+} from "./chunk-FKJBNFWA.js";
 import {
   mkdirWithinProject,
   realProjectRoot,
   realpath
-} from "./chunk-M62HDRLX.js";
+} from "./chunk-K56J3CL7.js";
 
 // src/helpers/proxyTranscoder.ts
 import { spawn } from "child_process";

package/dist/{chunk-M62HDRLX.js → chunk-K56J3CL7.js}

@@ -42,7 +42,12 @@ function isPrivateProjectFile(projectDir, filePath) {
   );
 }
 function pinWithinProject(base, relativePath) {
-  const checked = resolveWithinProject(base, relativePath);
+  return pinResolved(base, resolveWithinProject(base, relativePath));
+}
+function pinProjectRecord(base, relativePath) {
+  return pinResolved(base, resolveInProject(base, relativePath));
+}
+function pinResolved(base, checked) {
   if (!checked) return null;
   const inside = relative(realFilePath(base), realFilePath(checked));
   const escapes = inside === ".." || inside.startsWith(`..${sep}`) || isAbsolute(inside);
@@ -91,6 +96,7 @@ export {
   isPrivateProjectPath,
   isPrivateProjectFile,
   pinWithinProject,
+  pinProjectRecord,
   isInHiddenOrVendorDir,
   walkDir,
   folderGone,

package/dist/{chunk-VMT4OC5B.js → chunk-KR3B6IJC.js}

@@ -1,6 +1,6 @@
 import {
   resolveWithinProject
-} from "./chunk-M62HDRLX.js";
+} from "./chunk-K56J3CL7.js";
 
 // src/helpers/loudness.ts
 import { execFile } from "child_process";

package/dist/{chunk-ZNRTEXK2.js → chunk-RHYH6YOX.js}

@@ -1,14 +1,14 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-XKBQOQFZ.js";
+} from "./chunk-JTPV2T3F.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,
   recordProxyPrewarm,
   scanProjectMediaCodecMap,
   shouldPrewarmProxy
-} from "./chunk-EJC7TX3O.js";
+} from "./chunk-FKJBNFWA.js";
 
 // src/helpers/mediaProxyPreview.ts
 import { resolve } from "path";

package/dist/helpers/hfIdPersist.js

@@ -2,8 +2,8 @@ import {
   isCompositionSource,
   stampFileHfIds,
   stampProjectHfIds
-} from "../chunk-3RUFN2CK.js";
-import "../chunk-M62HDRLX.js";
+} from "../chunk-6RICWA3B.js";
+import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {

package/dist/helpers/loudness.js

@@ -11,8 +11,8 @@ import {
   requiredFfmpeg,
   resolveLocalAudioPath,
   updateAudioVolume
-} from "../chunk-VMT4OC5B.js";
-import "../chunk-M62HDRLX.js";
+} from "../chunk-KR3B6IJC.js";
+import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {

package/dist/helpers/mediaCodecMap.js

@@ -13,8 +13,8 @@ import {
   resolveProxyVariantRequest,
   scanProjectMediaCodecMap,
   shouldPrewarmProxy
-} from "../chunk-EJC7TX3O.js";
-import "../chunk-M62HDRLX.js";
+} from "../chunk-FKJBNFWA.js";
+import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,6 +1,6 @@
 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-BR7yXz2M.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-DB1EEdxc.js';
 import './mediaCodecMap.js';
 import '@hyperframes/parsers';
 import '@hyperframes/core/compiler';
-import '../projectHistory-CyTVYz2y.js';
+import '../projectHistory-C5dpCjPU.js';

package/dist/helpers/mediaProxyPreview.js

@@ -4,10 +4,10 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-ZNRTEXK2.js";
-import "../chunk-XKBQOQFZ.js";
-import "../chunk-EJC7TX3O.js";
-import "../chunk-M62HDRLX.js";
+} from "../chunk-RHYH6YOX.js";
+import "../chunk-JTPV2T3F.js";
+import "../chunk-FKJBNFWA.js";
+import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {

package/dist/helpers/proxyTranscoder.js

@@ -16,9 +16,9 @@ import {
   resolveProxies,
   resolveProxy,
   waitForProxy
-} from "../chunk-XKBQOQFZ.js";
-import "../chunk-EJC7TX3O.js";
-import "../chunk-M62HDRLX.js";
+} from "../chunk-JTPV2T3F.js";
+import "../chunk-FKJBNFWA.js";
+import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {

package/dist/helpers/safePath.d.ts

@@ -12,6 +12,8 @@ declare function isPrivateProjectFile(projectDir: string, filePath: string): boo
  * file checked here even if a link on the way is retargeted before the write.
  */
 declare function pinWithinProject(base: string, relativePath: string): string | null;
+/** `pinWithinProject` for the app's and the CLI's own records under `.hyperframes/`, which no route serves. */
+declare function pinProjectRecord(base: string, relativePath: string): string | null;
 /**
  * True when any directory segment of a relative path is a dot-directory or
  * node_modules. Projects that vendor tooling assets under dot-directories
@@ -24,4 +26,4 @@ declare function isInHiddenOrVendorDir(relPath: string): boolean;
  * or removed mid-walk is skipped; any other failure, or an unreadable `dir` itself, throws. */
 declare function walkDir(dir: string, prefix?: string): string[];
 
-export { isInHiddenOrVendorDir, isPrivateProjectFile, isPrivateProjectPath, pinWithinProject, realFilePath, resolveWithinProject, walkDir };
+export { isInHiddenOrVendorDir, isPrivateProjectFile, isPrivateProjectPath, pinProjectRecord, pinWithinProject, realFilePath, resolveWithinProject, walkDir };

package/dist/helpers/safePath.js

@@ -6,13 +6,14 @@ import {
   isProjectRootMissing,
   isSafePath,
   mkdirWithinProject,
+  pinProjectRecord,
   pinWithinProject,
   realFilePath,
   realProjectRoot,
   realpath,
   resolveWithinProject,
   walkDir
-} from "../chunk-M62HDRLX.js";
+} from "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {
@@ -23,6 +24,7 @@ export {
   isProjectRootMissing,
   isSafePath,
   mkdirWithinProject,
+  pinProjectRecord,
   pinWithinProject,
   realFilePath,
   realProjectRoot,

package/dist/helpers/sourceMutation.js

@@ -13,7 +13,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "../chunk-Z5UJMFO4.js";
+} from "../chunk-JBFOY5SI.js";
 export {
   dedupeClonedCompositionId,
   findTargetElement,

package/dist/history/index.d.ts

@@ -1,5 +1,5 @@
-import { P as ProjectHistory } from '../projectHistory-CyTVYz2y.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 HistoryResult, f as HistoryWho, g as HistoryWindow, M as MAX_WINDOW_IDLE_MS, h as ProjectHistoryOptions, i as ProjectHistoryView, U as UNDO_MODES, j as UndoMode, o as openProjectHistory, r as readProjectHistory } from '../projectHistory-CyTVYz2y.js';
+import { P as ProjectHistory, f as HistoryTarget, g as HistoryWho } from '../projectHistory-C5dpCjPU.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 HistoryResult, h as HistoryWindow, M as MAX_WINDOW_IDLE_MS, i as ProjectHistoryOptions, j as ProjectHistoryView, U as UNDO_MODES, k as UndoMode, o as openProjectHistory, r as readProjectHistory } from '../projectHistory-C5dpCjPU.js';
 
 declare class HistoryBusyError extends Error {
     readonly pid: number;
@@ -46,4 +46,91 @@ interface PrunedHistory {
 /** Removes the histories whose project is gone and that no live process holds. */
 declare function pruneGoneProjectHistories(historyRoot: string, options?: PruneOptions): Promise<PrunedHistory[]>;
 
-export { HistoryBusyError, HistoryIdError, ProjectHistory, type ProjectHistoryRecord, type PrunedHistory, historyCache, listProjectHistories, pruneGoneProjectHistories };
+interface PendingArtifactCleanup {
+    path: string;
+    hash: string;
+    revision: string;
+    id: string;
+    kind: "checks" | "snapshots";
+}
+
+interface FileVersion {
+    hash: string;
+    content: string;
+}
+interface RevisionState {
+    targets?: HistoryTarget[];
+    actor: HistoryWho;
+    label: string;
+    startedAt: number;
+    endedAt: number;
+    undoes?: string;
+    restoredTo?: string;
+    files: Record<string, {
+        before: string | null;
+        after: string | null;
+    }>;
+}
+interface ArtifactInput {
+    kind: "check" | "snapshot";
+    id: string;
+    scope: string;
+    report?: string;
+    image?: string;
+    time?: number;
+    metadata?: Record<string, unknown>;
+}
+interface ArtifactRecord extends Omit<ArtifactInput, "kind"> {
+    status?: "cleaned";
+    cleanedAfterRender?: string;
+    createdAt: number;
+    contentHash: string;
+    revision: string | null;
+    inputFingerprint: string;
+    inputScope: "local-project-files";
+    attribution: "recorded-revision" | "unversioned" | "inputs-changed";
+}
+interface ArtifactCollection {
+    latest: {
+        revision: string | null;
+        id: string;
+    } | null;
+    revisions: Record<string, ArtifactRecord[]>;
+    unversioned: ArtifactRecord[];
+}
+interface RenderRecord {
+    revision?: string | null;
+    id: string;
+    completedAt: number;
+    output: string;
+    status: "completed" | "completed_with_warnings";
+}
+interface VideoState {
+    version: 1;
+    historyId: string | null;
+    currentRevision: string | null;
+    pendingChanges: boolean;
+    files: Record<string, FileVersion>;
+    revisions: Record<string, RevisionState>;
+    checks: ArtifactCollection;
+    snapshots: ArtifactCollection;
+    renders?: {
+        latest: RenderRecord | null;
+        retainedRevisions?: string[];
+    };
+    pendingArtifactCleanup?: PendingArtifactCleanup[];
+}
+interface ArtifactCapture {
+    revision: string | null;
+    fingerprint: string;
+}
+declare function beginArtifactCapture(projectDir: string): Promise<ArtifactCapture>;
+declare function recordArtifact(projectDir: string, capture: ArtifactCapture, artifact: ArtifactInput): Promise<ArtifactRecord[]>;
+declare function recordArtifacts(projectDir: string, capture: ArtifactCapture, artifactsToRecord: readonly ArtifactInput[]): Promise<ArtifactRecord[]>;
+declare function forgetRecordedArtifacts(projectDir: string, paths: readonly string[]): Promise<void>;
+declare function artifactDirectory(projectDir: string, kind: "checks" | "snapshots"): string;
+declare function recordRenderSuccess(projectDir: string, output: string, status?: RenderRecord["status"], capture?: ArtifactCapture): Promise<RenderRecord>;
+
+declare function registerRenderOutput(projectDir: string, output: string): Promise<void>;
+
+export { type ArtifactCapture, type ArtifactInput, type ArtifactRecord, HistoryBusyError, HistoryIdError, HistoryTarget, HistoryWho, ProjectHistory, type ProjectHistoryRecord, type PrunedHistory, type RenderRecord, type VideoState, artifactDirectory, beginArtifactCapture, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput };

package/dist/history/index.js

@@ -6,13 +6,20 @@ import {
   MAX_WINDOW_IDLE_MS,
   START,
   UNDO_MODES,
+  artifactDirectory,
+  beginArtifactCapture,
+  forgetRecordedArtifacts,
   historyCache,
   listProjectHistories,
   openProjectHistory,
   pruneGoneProjectHistories,
-  readProjectHistory
-} from "../chunk-Y7V6FJHS.js";
-import "../chunk-M62HDRLX.js";
+  readProjectHistory,
+  recordArtifact,
+  recordArtifacts,
+  recordRenderSuccess,
+  registerRenderOutput
+} from "../chunk-CW5G6XXR.js";
+import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {
@@ -23,9 +30,16 @@ export {
   HistoryIdError,
   MAX_WINDOW_IDLE_MS,
   UNDO_MODES,
+  artifactDirectory,
+  beginArtifactCapture,
+  forgetRecordedArtifacts,
   historyCache,
   listProjectHistories,
   openProjectHistory,
   pruneGoneProjectHistories,
-  readProjectHistory
+  readProjectHistory,
+  recordArtifact,
+  recordArtifacts,
+  recordRenderSuccess,
+  registerRenderOutput
 };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-BR7yXz2M.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-BR7yXz2M.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 HistoryResult, f as HistoryWho, g as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, h as ProjectHistoryOptions, i as ProjectHistoryView, U as UNDO_MODES, j as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-CyTVYz2y.js';
-export { HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, historyCache, listProjectHistories, pruneGoneProjectHistories } from './history/index.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-DB1EEdxc.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-DB1EEdxc.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 HistoryResult, f as HistoryTarget, g as HistoryWho, h as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, i as ProjectHistoryOptions, j as ProjectHistoryView, U as UNDO_MODES, k as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-C5dpCjPU.js';
+export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';
 export { walkDir } from './helpers/safePath.js';
 export { stampProjectHfIds } from './helpers/hfIdPersist.js';

package/dist/index.js

@@ -17,11 +17,11 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "./chunk-Z5UJMFO4.js";
+} from "./chunk-JBFOY5SI.js";
 import {
   isCompositionSource,
   stampProjectHfIds
-} from "./chunk-3RUFN2CK.js";
+} from "./chunk-6RICWA3B.js";
 import {
   DEFAULT_HISTORY_ROOT,
   DELETED_VERSION,
@@ -33,22 +33,29 @@ import {
   STUDIO_SIGNATURE_MANIFEST_PATHS,
   UNDO_MODES,
   affectsProjectSignature,
+  artifactDirectory,
+  beginArtifactCapture,
   clearFileWriteReceipt,
   consumeFileWriteReceipt,
   createProjectSignature,
   createWriteToken,
   fileContentVersion,
+  forgetRecordedArtifacts,
   historyCache,
   identifyFileWrite,
   listProjectHistories,
   openProjectHistory,
   pruneGoneProjectHistories,
   readProjectHistory,
+  recordArtifact,
+  recordArtifacts,
   recordFileWriteReceipt,
+  recordRenderSuccess,
+  registerRenderOutput,
   resolveProjectAndSignature,
   resolveProjectSignature,
   settledFileTag
-} from "./chunk-Y7V6FJHS.js";
+} from "./chunk-CW5G6XXR.js";
 import {
   clearElementScreenshotIsolation,
   getElementScreenshotClip
@@ -62,13 +69,13 @@ import {
   requestedProjectPath,
   requiredFfmpeg,
   resolveLocalAudioPath
-} from "./chunk-VMT4OC5B.js";
+} from "./chunk-KR3B6IJC.js";
 import {
   injectMediaCodecMap,
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-ZNRTEXK2.js";
+} from "./chunk-RHYH6YOX.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -79,7 +86,7 @@ import {
   proxyActivityMark,
   resolveProxy,
   waitForProxy
-} from "./chunk-XKBQOQFZ.js";
+} from "./chunk-JTPV2T3F.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
@@ -88,7 +95,7 @@ import {
   probeMediaMetadata,
   recordProxyRequest,
   resolveProxyVariantRequest
-} from "./chunk-EJC7TX3O.js";
+} from "./chunk-FKJBNFWA.js";
 import {
   folderGone,
   isInHiddenOrVendorDir,
@@ -102,7 +109,7 @@ import {
   realpath,
   resolveWithinProject,
   walkDir
-} from "./chunk-M62HDRLX.js";
+} from "./chunk-K56J3CL7.js";
 import {
   STUDIO_MANUAL_EDITS_PATH,
   createStudioManualEditsRenderBodyScript,
@@ -6368,6 +6375,29 @@ function versionsOf(value) {
   );
   return pairs.length ? Object.fromEntries(pairs) : void 0;
 }
+function targetsOf(value) {
+  if (!Array.isArray(value)) return void 0;
+  const targets = value.flatMap((item) => targetOf2(item) ?? []);
+  return targets.length ? targets : void 0;
+}
+function targetOf2(item) {
+  if (!item || typeof item !== "object") return null;
+  const fields = item;
+  if (typeof fields.file !== "string") return null;
+  const target = { file: fields.file, ...identityOf(fields) };
+  if (!target.id && !target.hfId && !target.selector) return null;
+  if (isSelectorIndex(fields.selectorIndex)) target.selectorIndex = fields.selectorIndex;
+  return target;
+}
+function identityOf(fields) {
+  const identity = {};
+  for (const key of ["id", "hfId", "selector"]) {
+    const field = fields[key];
+    if (typeof field === "string" && field) identity[key] = field;
+  }
+  return identity;
+}
+var isSelectorIndex = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
 function nextStep(history, direction) {
   const target = history.next(direction, YOU);
   if (!target) return null;
@@ -6393,6 +6423,13 @@ function registerHistoryRoutes(api, adapter) {
       return { entries, back: nextStep(history, "back"), forward: nextStep(history, "forward") };
     })
   );
+  api.post(
+    `${base}/checkpoint`,
+    (c) => withHistory(adapter, c, async (history) => {
+      await history.checkpoint();
+      return { ok: true };
+    })
+  );
   api.post(
     `${base}/step`,
     (c) => withHistory(
@@ -6441,9 +6478,11 @@ function registerHistoryRoutes(api, adapter) {
       const paths = Array.isArray(body.paths) ? body.paths.filter((path) => text(path)) : [];
       const coalesceKey = text(body.coalesceKey) ?? void 0;
       const overwrote = versionsOf(body.overwrote);
+      const targets = targetsOf(body.targets);
       const claimed = await history.claim(YOU, text(body.label) ?? "Edited in Studio", paths, {
         ...coalesceKey && { coalesceKey, idleMs: idleOf(body) ?? Infinity },
-        ...overwrote && { overwrote }
+        ...overwrote && { overwrote },
+        ...targets && { targets }
       });
       return { claimed };
     })
@@ -6455,7 +6494,10 @@ function registerHistoryRoutes(api, adapter) {
       const window = await history.beginWindow(
         whoOf(body),
         text(body.label) ?? "Edited in Studio",
-        idleMs ? { idleMs } : void 0
+        {
+          ...idleMs ? { idleMs } : {},
+          ...body.exclusive === true && { exclusive: true }
+        }
       );
       windows.set(window.id, { history, window });
       return { windowId: window.id, startedAt: window.startedAt };
@@ -6687,6 +6729,8 @@ export {
   affectsPreview,
   affectsProjectSignature,
   applyFileMutations,
+  artifactDirectory,
+  beginArtifactCapture,
   buildSubCompositionHtml,
   cleanupProxyCache,
   clearElementScreenshotIsolation,
@@ -6704,6 +6748,7 @@ export {
   duplicateElementInHtml,
   fileContentVersion,
   findTargetElement,
+  forgetRecordedArtifacts,
   getElementScreenshotClip,
   getMimeType,
   historyCache,
@@ -6715,6 +6760,10 @@ export {
   patchElementInHtml,
   pruneGoneProjectHistories,
   readProjectHistory,
+  recordArtifact,
+  recordArtifacts,
+  recordRenderSuccess,
+  registerRenderOutput,
   removeElementFromHtml,
   requestSubPath,
   settledFileTag,

package/dist/{mediaProxyPreview-BR7yXz2M.d.ts → mediaProxyPreview-DB1EEdxc.d.ts}

@@ -2,7 +2,7 @@ import * as _hyperframes_core from '@hyperframes/core';
 import { RegistryItem, PreviewProxyBox } from '@hyperframes/core';
 import { CanvasResolution } from '@hyperframes/parsers';
 import { BundleOptions } from '@hyperframes/core/compiler';
-import { P as ProjectHistory } from './projectHistory-CyTVYz2y.js';
+import { P as ProjectHistory } from './projectHistory-C5dpCjPU.js';
 import { MediaCodecProbeCache, HtmlSourceLike } from './helpers/mediaCodecMap.js';
 
 /** Resolved info about a single project. */

package/dist/{projectHistory-CyTVYz2y.d.ts → projectHistory-C5dpCjPU.d.ts}

@@ -10,7 +10,15 @@ interface HistoryFileChange {
     after: string | null;
 }
 type HistoryEntrySide = "before" | "after";
+interface HistoryTarget {
+    file: string;
+    id?: string;
+    hfId?: string;
+    selector?: string;
+    selectorIndex?: number;
+}
 interface HistoryEntry {
+    targets?: HistoryTarget[];
     id: string;
     who: HistoryWho;
     label: string;
@@ -44,10 +52,12 @@ interface ProjectHistoryOptions {
     ownerWaitMs?: number;
     /** A CLI turn's window from an earlier open: writes since, within its idle limit, become the entry with its id. */
     closedWindow?: ClosedWindow;
+    closedWindowAfterOwnership?: () => ClosedWindow | undefined;
     undoScope?: "own" | "everyone";
     pruneGoneProjectsBudgetMs?: number;
 }
 interface ClaimOptions {
+    targets?: readonly HistoryTarget[];
     coalesceKey?: string;
     idleMs?: number;
     /** Per path, the version (fileContentVersion) the claimer overwrote: earlier changes stay their writer's. */
@@ -94,6 +104,7 @@ interface ProjectHistory {
      * part so far first (fresh id), returned by close() if nothing else remained. Overlaps go to the newest. */
     beginWindow(who: HistoryWho, label: string, options?: {
         idleMs?: number;
+        exclusive?: boolean;
     }): Promise<HistoryWindow>;
     /**
      * For a writer that records after writing (Studio): moves the uncommitted changes to `paths` into one entry of
@@ -124,6 +135,7 @@ interface ProjectHistory {
     pin(id: string, pinned: boolean): void;
     onEntry(listener: (entry: HistoryEntry) => void): () => void;
     /** Takes in every pending write and commits every open window and the outside group. */
+    checkpoint(): Promise<void>;
     flush(): Promise<void>;
     /** True once another project stands at the folder's path: open that one's history instead. */
     replacedAtPath(): boolean;
@@ -144,4 +156,4 @@ interface ProjectHistoryView {
 /** Reads only: takes no lock and files, prunes or writes nothing; an owner's half-appended last line is skipped. */
 declare function readProjectHistory(options: Pick<ProjectHistoryOptions, "projectDir" | "historyRoot">): ProjectHistoryView;
 
-export { type ClosedWindow as C, DEFAULT_HISTORY_ROOT as D, HistoryClosedError as H, MAX_WINDOW_IDLE_MS as M, type ProjectHistory as P, START as S, UNDO_MODES as U, type HistoryEntry as a, type HistoryEntrySide as b, type HistoryFileChange as c, type HistoryListItem as d, type HistoryResult as e, type HistoryWho as f, type HistoryWindow as g, type ProjectHistoryOptions as h, type ProjectHistoryView as i, type UndoMode as j, openProjectHistory as o, readProjectHistory as r };
+export { type ClosedWindow as C, DEFAULT_HISTORY_ROOT as D, HistoryClosedError as H, MAX_WINDOW_IDLE_MS as M, type ProjectHistory as P, START as S, UNDO_MODES as U, type HistoryEntry as a, type HistoryEntrySide as b, type HistoryFileChange as c, type HistoryListItem as d, type HistoryResult as e, type HistoryTarget as f, type HistoryWho as g, type HistoryWindow as h, type ProjectHistoryOptions as i, type ProjectHistoryView as j, type UndoMode as k, openProjectHistory as o, readProjectHistory as r };