@vosjs/studio-core 0.47.0 → 0.49.0

package/dist/index.d.ts

@@ -397,6 +397,13 @@ interface RecordingMeta {
      * whole take, so Chrome letterboxes the resized content — surface a notice.
      */
     resizedDuringTake?: boolean;
+    /**
+     * How round the footage's own corners are, in cursor-space units (a recorded
+     * window's points). Outside them the footage is opaque: a window recorded
+     * alone is black there. A card drawn around the footage is at least this
+     * round, or those corners show as notches. Absent or 0 = square footage.
+     */
+    cornerRadius?: number;
     /**
      * Page URL/title at record start (seeds the browser-bar mock's address pill).
      * Query/hash are stripped at capture for privacy.
@@ -404,12 +411,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.
+     */
+    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';
+    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 +484,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 +3728,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 = {
@@ -8565,6 +8567,11 @@ var ON_FRAME = `(ctx, content, dt) => {
     cardX = dx; cardY = dy - barH; cardW = dw; cardH = dh + barH
   }
   var radius = (cfr.radius || 0) * s2
+  // Footage of a window is round at its own corners and opaque outside them.
+  // The card is at least as round, or those corners show as notches. Under
+  // cover the card crops the footage and its corners are not the card's.
+  var ftR = (actM ? actM.footageRadius : d.footageRadius) || 0
+  if (ftR > 0 && !fitCover) radius = Math.max(radius, ftR * dw)
   var shadow = cfr.shadow || 0
   // The shadow's colour (a #rrggbb; the strengths are its alpha) and the
   // optional tight CONTACT layer that makes a light card sit on a light
@@ -9562,6 +9569,7 @@ function lowerToComposition(input) {
     })),
     cursorStyle: doc.cursor,
     cursorSpace: { w: doc.source.meta.width, h: doc.source.meta.height },
+    ...footageRadiusData(doc.source.meta, doc.source.crop),
     // The other media (concat): each with its element's source, its crop
     // and its own cursor in its own capture space; absent = one media.
     ...doc.media && doc.media.length ? {
@@ -9586,6 +9594,7 @@ function lowerToComposition(input) {
             y: round9(p.y)
           })),
           cursorSpace: { w: m.meta.width, h: m.meta.height },
+          ...footageRadiusData(m.meta, m.crop),
           // The card this media wears (its own placement, bar, corner,
           // shadow, border, fit and focus over the take's), resolved
           // here so ON_FRAME swaps one object and reads no document.
@@ -9860,6 +9869,11 @@ function pinsDataOf(doc, pins) {
 function round42(v) {
   return Math.round(v * 1e5) / 1e5;
 }
+function footageRadiusData(meta, crop) {
+  const r = meta.cornerRadius;
+  if (!r || !(r > 0) || crop || !(meta.width > 0)) return {};
+  return { footageRadius: round42(r / meta.width) };
+}
 function clickFxData(doc, rated) {
   const fx = doc.cursor.clickFx;
   const on = fx.style !== "none" || fx.press;
@@ -10774,6 +10788,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,