@vosjs/studio-core 0.47.0 → 0.48.0

package/dist/index.d.ts

@@ -404,12 +404,26 @@ interface RecordingMeta {
     pageUrl?: string;
     pageTitle?: string;
     /**
-     * What the frame contains. Absent = 'tab' (back-compat). Non-tab surfaces use
-     * CursorEvent.sx/sy + the geometry rects below to map cursor → capture px
-     * (see normalizeCaptureSpace); tab-only studio features (browser-bar mock,
-     * letterbox notice) are gated off for them.
+     * The application an `'app'` take recorded, where a page take says
+     * `pageUrl`: its name as the OS shows it, and its bundle id or executable
+     * name. Never a window title, which carries document and account names.
      */
-    captureSurface?: 'tab' | 'window' | 'monitor';
+    app?: {
+        name: string;
+        id?: string;
+    };
+    /**
+     * What the frame contains. Absent = 'tab' (back-compat). `'window'` and
+     * `'monitor'` are a BROWSER's display captures: they use CursorEvent.sx/sy +
+     * the geometry rects below to map cursor → capture px (see
+     * normalizeCaptureSpace), and tab-only studio features (browser-bar mock,
+     * letterbox notice) are gated off for them. `'app'` is one application's
+     * window recorded by a desktop producer: the frame IS the window, the cursor
+     * is already in the frame's own space (`width × height` are the window's
+     * points, `captureWidth × captureHeight` its pixels), and the footage
+     * carries the window's own title bar, so no bar is drawn over it.
+     */
+    captureSurface?: 'tab' | 'window' | 'monitor' | 'app';
     /**
      * Target-tab browser-window bounds at record start, screen-coord CSS px
      * (window.screenX/Y + outerWidth/Height). Anchor for 'window' captures.
@@ -463,10 +477,12 @@ interface RecordingMeta {
      * track from automation (exact coords, fresh rects, coverage 1 by
      * construction) and encode WebM; `ingest` is someone else's recording
      * brought in as a take (`vos ingest`, or a file dropped on the studio),
-     * whose cursor track, if any, came from a trace beside it; absent means
+     * whose cursor track, if any, came from a trace beside it; `desktop` is a
+     * capture helper recording an application's window, its cursor either
+     * sampled from the real pointer or synthesized from a script; absent means
      * the extension.
      */
-    producer?: 'extension' | 'cli' | 'ingest';
+    producer?: 'extension' | 'cli' | 'ingest' | 'desktop';
     /**
      * The step timeline: when each actions.json step ran, in SOURCE
      * seconds. This is what makes a cut re-anchorable across re-records — a
@@ -3705,6 +3721,8 @@ interface DigestTakeFacts {
     producer: string;
     pageUrl: string | null;
     pageTitle: string | null;
+    /** The recorded application's name, on an `'app'` take. */
+    app: string | null;
     hasMic: boolean;
     hasSystemAudio: boolean;
     hasCursor: boolean;

package/dist/index.js

@@ -506,7 +506,8 @@ function deriveViewportCrop(cursor, meta) {
 }
 function normalizeCaptureSpace(cursor, meta) {
   const surface = meta.captureSurface ?? "tab";
-  if (surface === "tab") return { cursor, meta, coverage: 1 };
+  if (surface === "tab" || surface === "app")
+    return { cursor, meta, coverage: 1 };
   const anchor = surface === "window" ? meta.windowRect : meta.screenRect;
   const capW = meta.captureWidth ?? 0;
   const capH = meta.captureHeight ?? 0;
@@ -620,11 +621,12 @@ function projectFromArtifact(artifact, videoUrl, opts = {}) {
   const norm = normalizeCaptureSpace(artifact.cursor, artifact.meta);
   const { cursor, meta } = norm;
   const unfocused = surface === "window" && (artifact.meta.windowFocusedFrac ?? 1) < WINDOW_FOCUS_MIN;
-  const coverage = surface === "monitor" || artifact.meta.windowMovedDuringTake || unfocused ? 0 : norm.coverage;
+  const movedAnchor = surface !== "app" && artifact.meta.windowMovedDuringTake === true;
+  const coverage = surface === "monitor" || movedAnchor || unfocused ? 0 : norm.coverage;
   if (artifact.cursor.length > 0 && coverage < CAPTURE_COVERAGE_MIN) {
     console.warn(
       "[studio] dropping cursor track \u2014",
-      surface === "monitor" ? "entire-screen takes have no cursor effects (untrackable outside browser pages)" : artifact.meta.windowMovedDuringTake ? "window moved/resized during the take" : unfocused ? `browser window focused only ${Math.round((artifact.meta.windowFocusedFrac ?? 0) * 100)}% of the take \u2014 a different window was likely shared` : `coverage ${norm.coverage.toFixed(2)} (wrong surface shared, or unusable capture geometry)`
+      surface === "monitor" ? "entire-screen takes have no cursor effects (untrackable outside browser pages)" : movedAnchor ? "window moved/resized during the take" : unfocused ? `browser window focused only ${Math.round((artifact.meta.windowFocusedFrac ?? 0) * 100)}% of the take \u2014 a different window was likely shared` : `coverage ${norm.coverage.toFixed(2)} (wrong surface shared, or unusable capture geometry)`
     );
   }
   const doc = {
@@ -10774,6 +10776,7 @@ function buildDigest(input) {
       producer: meta.producer ?? "extension",
       pageUrl: meta.pageUrl ?? null,
       pageTitle: meta.pageTitle ?? null,
+      app: meta.app?.name ?? null,
       hasMic: Boolean(doc.source.micKey) || meta.hasMic === true,
       hasSystemAudio: meta.hasAudio === true,
       hasCursor: doc.source.cursor.length > 0,