@vosjs/studio-core 0.14.0 → 0.15.0

package/dist/index.d.ts

@@ -1629,8 +1629,22 @@ declare function exportSizeFor(ratio: number, resolution: ExportResolution): {
  * plus the facts only a capture has) with the `id` a segment or a span
  * names. The primary media has no id; it is `doc.source`.
  */
+/**
+ * The CARD-owned frame fields, what a media may carry of its own: its
+ * placement and size (`inset`, per-side fractions of the frame), the bar,
+ * the corner, the shadow, the border, the cover fit and its focus. The
+ * frame-wide fields (the aspect, the padding, the ground, the backdrop, the
+ * card's animation) stay the take's: one frame, many cards.
+ */
+declare const MEDIA_FRAME_KEYS: readonly ["browserBar", "radius", "shadow", "shadowContact", "shadowColor", "inset", "border", "borderWidth", "borderColor", "fit", "focus", "focusFollow"];
+type MediaFrameKey = (typeof MEDIA_FRAME_KEYS)[number];
+/** What a media says about its own card; absent fields fall to the take's frame. */
+type MediaFrame = Partial<Omit<Pick<FrameStyle, MediaFrameKey>, 'browserBar'>> & {
+    browserBar?: Partial<BrowserBarStyle>;
+};
 type Media = ProjectDoc['source'] & {
     id: string;
+    frame?: MediaFrame;
 };
 
 /**
@@ -2052,7 +2066,9 @@ zoomFocus?: {
  * ON_FRAME uses as source dims when `d.crop` is set (crp.w/crp.h) — the
  * golden contract holds through the crop.
  */
-declare function docCardLayout(doc: Pick<ProjectDoc, 'frame' | 'source'>): CardLayout;
+declare function docCardLayout(doc: Pick<ProjectDoc, 'frame' | 'source' | 'media'>, 
+/** The media whose card to lay out; absent or `''` = the primary. */
+media?: string | null): CardLayout;
 /**
  * Largest export preset whose footage card still gets ≥1 captured px per output
  * px. The composited chrome (background, bar, cursor, effects) is vector-drawn
@@ -3224,6 +3240,15 @@ declare function mediaDuration(source: Pick<ProjectDoc['source'], 'meta'>): numb
  * for an empty list.
  */
 declare function mediaAtOutput(rated: readonly MediaSegment[], t: number): string;
+/**
+ * The card a media wears: the take's frame with the media's own card
+ * fields over it. Facts first: a media with a recorded page names it in
+ * the bar, and one with no page (an upload) wears no bar, unless its own
+ * `frame.browserBar` says otherwise. The primary wears the take's frame.
+ */
+declare function mediaFrame(doc: Pick<ProjectDoc, 'source' | 'media' | 'frame'>, id: string | undefined | null): FrameStyle;
+/** The card-owned fields of a frame, alone (what a media's card is made of). */
+declare function cardFields(frame: FrameStyle): Pick<FrameStyle, MediaFrameKey>;
 /** The next free media id (`m1`, `m2`, …). */
 declare function nextMediaId(doc: Pick<ProjectDoc, 'media'>): string;
 
@@ -3807,4 +3832,4 @@ declare function rejectSpan(rejected: RejectedSpan[] | undefined, lane: Rejected
     anchor?: StepAnchor;
 }, note?: string): RejectedSpan;
 
-export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, type Anim, type AnimKind, type AnimStep, type AppliedTemplate, type ApplyTemplateOptions, type AspectRatioOption, type AudioClip, type AudioPlanPoint, type AudioPlanTrack, BACKGROUND_Z, BASE_FRAME_STYLE, type Backdrop, type BackgroundMedia, type BakedText3dAsset, type BakedText3dMaterial, type BrowserBarStyle, type BuildDigestInput, CAMERA_FAR, CAMERA_NEAR, CAM_CHAIN_GAP, CAM_EASE, CAM_PAN, CAM_PAN_EASE, CAM_RAMP_IN, CAM_RAMP_OUT, CAM_SIZE_MAX, CAM_SIZE_MIN, CAM_SPAN_MIN, CAPTURE_COVERAGE_MIN, CARD_EDGE_OVERDRAW, CARD_ENTER_KINDS, CARD_EXIT_KINDS, CARD_FADE_SECONDS, CARD_FOV, CARD_Z, CHANNEL_SPECS_HASH, CHANNEL_SPECS_VERIFIED, CLICK_FX_INTENSITY, CLICK_FX_PRE, CLICK_HIGHLIGHT_FADE, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, CROP_MAX_PX, CROP_MIN_FRAC, CROP_MIN_PX, CROP_PAD, CURSOR_IDLE_EPS_FRAC, CURSOR_IDLE_FADE_IN, CURSOR_IDLE_FADE_OUT, CURSOR_IDLE_HOLD, type CamBubbleRect, type CamPoseSpan, type CamStyle, type CaptureNormalization, type CardLayout, type ClickFxStyle, type CopiedLayout, type CopyLayoutOptions, type CopyStyleOptions, type CursorEvent, type CursorFadeKey, type CursorIdleOptions, type CursorStyle, type CursorTrack, DARK_GROUND, DEFAULT_BROWSER_BAR, DEFAULT_CAM_POSE, DEFAULT_CAM_STYLE, DEFAULT_CLICK_FX, DEFAULT_CURSOR_STYLE, DEFAULT_DUCK, DEFAULT_FRAME_STYLE, DEFAULT_SPEED_PARAMS, DEFAULT_TILT_POSE, DEFAULT_ZOOM_LEVEL, DEFAULT_ZOOM_STYLE, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocSegment, type DuckOptions, END_CARD_FROM, END_CARD_RECEDE, END_CARD_SECONDS, ENTRANCE_SECONDS, EXPORT_RESOLUTION_OPTIONS, EXPORT_SHORT_EDGE, type EndCard, type EnvelopePoint, type ExportResolution, type ExtractClickOptions, FOLLOW_RECENTER, FOLLOW_SAFE_RATIO, FRAME_BORDER_COLOR_DEFAULT, FRAME_BORDER_DEFAULT, FRAME_BORDER_WIDTH_DEFAULT, FREEZE_DEFAULT_SECONDS, FREEZE_SECONDS_MAX, FREEZE_SECONDS_MIN, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, type FreezeExtent, type FreezeSpan, HOUSE_GRADIENT, IDLE_KINDS, type IdleKind, type IngestOptions, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayoutParts, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, MEDIA_ENTER_KINDS, MEDIA_EXIT_KINDS, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type Media, type MediaOverlayClip, type MediaSegment, type MicRms, type MinimalBarTheme, type Moment, type MomentKind, type MomentsOptions, type MotionKey, type MotionPose, type MotionPose3D, type MusicBedInput, type NormRect, OBJECT_DEFAULT_SCALE, OVERLAY_FONT_FACES, OVERLAY_LINE_HEIGHT, OVERLAY_MEDIA_DEFAULT_RADIUS, OVERLAY_MEDIA_DEFAULT_WIDTH, OVERLAY_MIN_DURATION, OVERLAY_SCALE_MAX, OVERLAY_SIZE_MAX, OVERLAY_SIZE_MIN, OVERLAY_TRANSITION_DUR, OVERLAY_Z, type ObjectAnimation, type ObjectAsset, type ObjectClip, type ObjectPrimitiveShape, type OverlayClip, type OverlayFontFace, type OverlayKind, type OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, PROGRAM_RETIME, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REST_TILT_ID, type RecordingArtifact, type RecordingMeta, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, SCENE_MOTION, SCENE_QUIET, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STUDIO_ENTRY_ID, STYLE_FIELDS, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, TEXT3D_DEPTH_DEFAULT, TEXT3D_DEPTH_MAX, TEXT3D_DEPTH_MIN, TEXT_ENTER_KINDS, TEXT_EXIT_KINDS, TEXT_PRESETS, TILT_AUTO_DEAD_ZONE, TILT_AUTO_MIN, TILT_CHAIN_GAP, TILT_DEG_MAX, TILT_EASE, TILT_INTENSITY_MAX, TILT_PAN, TILT_PAN_EASE, TILT_RAMP_IN, TILT_RAMP_OUT, TILT_SPAN_MIN, TILT_UI_DEG_MAX, TRANSITION_SPEED_MULT, type TemplateAnchor, type Text3dMaterial, type TextFxDirection, type TextFxKind, type TextFxSpec, type TextFxUnit, type TextOverlayBox, type TextOverlayClip, type TextOverlayPreset, type TextOverlayStroke, type TiltPersonality, type TiltSpan, type TiltStyleName, type TranscriptSegment, type TransitionSpeed, WINDOW_FOCUS_MIN, ZOOM_CHAIN_GAP, ZOOM_EASE, ZOOM_LEVELS, ZOOM_LEVEL_MAX, ZOOM_LEVEL_MIN, ZOOM_PAN, ZOOM_PAN_EASE, ZOOM_RAMP_IN, ZOOM_RAMP_IN_OVERLAP, ZOOM_RAMP_OUT, ZOOM_SPAN_MIN, ZOOM_STYLES, ZOOM_STYLE_OPTIONS, type ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomWindow, anchorKindOf, anchorSourceDuration, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, buildDigest, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cardEnter, cardExit, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFreezes, docMediaList, docOutputDuration, docRestTime, docToCropSpace, docToFullSpace, dropTemplate, duckCurve, effectiveSegments, endCardClips, enterKey, enterOf, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, freezeLane, freezeOutputExtents, hexToRgbTriplet, houseLook, idleGaps, idleKey, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layoutOf, levelForFocusFraction, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, mediaAtOutput, mediaDuration, mediaKey, mediaSource, micLane, migrateHostedDoc, migrateMotion, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, pageDisplayUrl, parsePoseId, pickStyle, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, restLeanOf, sameMedia, sceneChanges, scrollRuns, setSpeedInRange, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, videoLane, voiceKey, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomWindow };
+export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, type Anim, type AnimKind, type AnimStep, type AppliedTemplate, type ApplyTemplateOptions, type AspectRatioOption, type AudioClip, type AudioPlanPoint, type AudioPlanTrack, BACKGROUND_Z, BASE_FRAME_STYLE, type Backdrop, type BackgroundMedia, type BakedText3dAsset, type BakedText3dMaterial, type BrowserBarStyle, type BuildDigestInput, CAMERA_FAR, CAMERA_NEAR, CAM_CHAIN_GAP, CAM_EASE, CAM_PAN, CAM_PAN_EASE, CAM_RAMP_IN, CAM_RAMP_OUT, CAM_SIZE_MAX, CAM_SIZE_MIN, CAM_SPAN_MIN, CAPTURE_COVERAGE_MIN, CARD_EDGE_OVERDRAW, CARD_ENTER_KINDS, CARD_EXIT_KINDS, CARD_FADE_SECONDS, CARD_FOV, CARD_Z, CHANNEL_SPECS_HASH, CHANNEL_SPECS_VERIFIED, CLICK_FX_INTENSITY, CLICK_FX_PRE, CLICK_HIGHLIGHT_FADE, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, CROP_MAX_PX, CROP_MIN_FRAC, CROP_MIN_PX, CROP_PAD, CURSOR_IDLE_EPS_FRAC, CURSOR_IDLE_FADE_IN, CURSOR_IDLE_FADE_OUT, CURSOR_IDLE_HOLD, type CamBubbleRect, type CamPoseSpan, type CamStyle, type CaptureNormalization, type CardLayout, type ClickFxStyle, type CopiedLayout, type CopyLayoutOptions, type CopyStyleOptions, type CursorEvent, type CursorFadeKey, type CursorIdleOptions, type CursorStyle, type CursorTrack, DARK_GROUND, DEFAULT_BROWSER_BAR, DEFAULT_CAM_POSE, DEFAULT_CAM_STYLE, DEFAULT_CLICK_FX, DEFAULT_CURSOR_STYLE, DEFAULT_DUCK, DEFAULT_FRAME_STYLE, DEFAULT_SPEED_PARAMS, DEFAULT_TILT_POSE, DEFAULT_ZOOM_LEVEL, DEFAULT_ZOOM_STYLE, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocSegment, type DuckOptions, END_CARD_FROM, END_CARD_RECEDE, END_CARD_SECONDS, ENTRANCE_SECONDS, EXPORT_RESOLUTION_OPTIONS, EXPORT_SHORT_EDGE, type EndCard, type EnvelopePoint, type ExportResolution, type ExtractClickOptions, FOLLOW_RECENTER, FOLLOW_SAFE_RATIO, FRAME_BORDER_COLOR_DEFAULT, FRAME_BORDER_DEFAULT, FRAME_BORDER_WIDTH_DEFAULT, FREEZE_DEFAULT_SECONDS, FREEZE_SECONDS_MAX, FREEZE_SECONDS_MIN, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, type FreezeExtent, type FreezeSpan, HOUSE_GRADIENT, IDLE_KINDS, type IdleKind, type IngestOptions, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayoutParts, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, MEDIA_ENTER_KINDS, MEDIA_EXIT_KINDS, MEDIA_FRAME_KEYS, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type Media, type MediaFrame, type MediaFrameKey, type MediaOverlayClip, type MediaSegment, type MicRms, type MinimalBarTheme, type Moment, type MomentKind, type MomentsOptions, type MotionKey, type MotionPose, type MotionPose3D, type MusicBedInput, type NormRect, OBJECT_DEFAULT_SCALE, OVERLAY_FONT_FACES, OVERLAY_LINE_HEIGHT, OVERLAY_MEDIA_DEFAULT_RADIUS, OVERLAY_MEDIA_DEFAULT_WIDTH, OVERLAY_MIN_DURATION, OVERLAY_SCALE_MAX, OVERLAY_SIZE_MAX, OVERLAY_SIZE_MIN, OVERLAY_TRANSITION_DUR, OVERLAY_Z, type ObjectAnimation, type ObjectAsset, type ObjectClip, type ObjectPrimitiveShape, type OverlayClip, type OverlayFontFace, type OverlayKind, type OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, PROGRAM_RETIME, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REST_TILT_ID, type RecordingArtifact, type RecordingMeta, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, SCENE_MOTION, SCENE_QUIET, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STUDIO_ENTRY_ID, STYLE_FIELDS, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, TEXT3D_DEPTH_DEFAULT, TEXT3D_DEPTH_MAX, TEXT3D_DEPTH_MIN, TEXT_ENTER_KINDS, TEXT_EXIT_KINDS, TEXT_PRESETS, TILT_AUTO_DEAD_ZONE, TILT_AUTO_MIN, TILT_CHAIN_GAP, TILT_DEG_MAX, TILT_EASE, TILT_INTENSITY_MAX, TILT_PAN, TILT_PAN_EASE, TILT_RAMP_IN, TILT_RAMP_OUT, TILT_SPAN_MIN, TILT_UI_DEG_MAX, TRANSITION_SPEED_MULT, type TemplateAnchor, type Text3dMaterial, type TextFxDirection, type TextFxKind, type TextFxSpec, type TextFxUnit, type TextOverlayBox, type TextOverlayClip, type TextOverlayPreset, type TextOverlayStroke, type TiltPersonality, type TiltSpan, type TiltStyleName, type TranscriptSegment, type TransitionSpeed, WINDOW_FOCUS_MIN, ZOOM_CHAIN_GAP, ZOOM_EASE, ZOOM_LEVELS, ZOOM_LEVEL_MAX, ZOOM_LEVEL_MIN, ZOOM_PAN, ZOOM_PAN_EASE, ZOOM_RAMP_IN, ZOOM_RAMP_IN_OVERLAP, ZOOM_RAMP_OUT, ZOOM_SPAN_MIN, ZOOM_STYLES, ZOOM_STYLE_OPTIONS, type ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomWindow, anchorKindOf, anchorSourceDuration, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, buildDigest, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cardEnter, cardExit, cardFields, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFreezes, docMediaList, docOutputDuration, docRestTime, docToCropSpace, docToFullSpace, dropTemplate, duckCurve, effectiveSegments, endCardClips, enterKey, enterOf, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, freezeLane, freezeOutputExtents, hexToRgbTriplet, houseLook, idleGaps, idleKey, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layoutOf, levelForFocusFraction, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaSource, micLane, migrateHostedDoc, migrateMotion, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, pageDisplayUrl, parsePoseId, pickStyle, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, restLeanOf, sameMedia, sceneChanges, scrollRuns, setSpeedInRange, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, videoLane, voiceKey, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomWindow };

package/dist/index.js

@@ -209,6 +209,20 @@ function exportSizeFor(ratio, resolution) {
   const safe = ratio > 0 && Number.isFinite(ratio) ? ratio : 16 / 9;
   return safe >= 1 ? { width: even(short * safe), height: even(short) } : { width: even(short), height: even(short / safe) };
 }
+var MEDIA_FRAME_KEYS = [
+  "browserBar",
+  "radius",
+  "shadow",
+  "shadowContact",
+  "shadowColor",
+  "inset",
+  "border",
+  "borderWidth",
+  "borderColor",
+  "fit",
+  "focus",
+  "focusFollow"
+];
 
 // src/capture.ts
 var CHROME_TOP_MIN = 20;
@@ -541,6 +555,33 @@ function mediaAtOutput(rated, t) {
   }
   return last ? mediaKey(last.media) : PRIMARY_MEDIA;
 }
+function mediaFrame(doc, id) {
+  const key = mediaKey(id);
+  if (key === PRIMARY_MEDIA) return doc.frame;
+  const m = (doc.media ?? []).find((x) => x.id === key);
+  if (!m) return doc.frame;
+  const over = m.frame ?? {};
+  const out = { ...doc.frame };
+  for (const k of MEDIA_FRAME_KEYS) {
+    if (k === "browserBar") continue;
+    const v = over[k];
+    if (v !== void 0) out[k] = v;
+  }
+  const bar = { ...doc.frame.browserBar };
+  const page = pageDisplayUrl(m.meta.pageUrl);
+  if (page) bar.url = page;
+  if (!m.meta.pageUrl) bar.kind = "none";
+  out.browserBar = { ...bar, ...over.browserBar ?? {} };
+  return out;
+}
+function cardFields(frame) {
+  const out = {};
+  for (const k of MEDIA_FRAME_KEYS) {
+    const v = frame[k];
+    if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
 function nextMediaId(doc) {
   const taken = new Set((doc.media ?? []).map((m) => m.id));
   let n = 1;
@@ -1671,18 +1712,20 @@ function computeCardLayout(frame, video, W, H, zoomFocus) {
     cardH: dh + barH
   };
 }
-function docCardLayout(doc) {
+function docCardLayout(doc, media) {
   const meta = doc.source.meta;
   const H = 1080;
   const W = Math.max(
     2,
     Math.round(H * aspectRatioValue(doc.frame.aspectRatio, meta))
   );
+  const src = mediaSource(doc, media) ?? doc.source;
+  const sm = src.meta;
   return computeCardLayout(
-    doc.frame,
+    mediaFrame(doc, media),
     {
-      width: meta.captureWidth ?? meta.width,
-      height: meta.captureHeight ?? meta.height
+      width: sm.captureWidth ?? sm.width,
+      height: sm.captureHeight ?? sm.height
     },
     W,
     H
@@ -4181,6 +4224,9 @@ var ON_FRAME = `(ctx, content, dt) => {
   if (amId && d.media) for (var amJ = 0; amJ < d.media.length; amJ++) if (d.media[amJ].id === amId) actM = d.media[amJ]
   if (actM && r.media && r.media[amId]) video = r.media[amId]
   else amId = ''
+  // The card under the playhead: another media's own card fields over the
+  // take's frame (resolved at lowering), the take's frame for the primary.
+  var cfr = amId && actM && actM.frame ? actM.frame : frame
   if (r.media) for (var amK in r.media) { var amE = r.media[amK]; if (amK !== amId && amE && amE.pause && amE.paused === false) amE.pause() }
   if (amId) {
     if (r.video && r.video.pause && r.video.paused === false) r.video.pause()
@@ -4483,15 +4529,15 @@ var ON_FRAME = `(ctx, content, dt) => {
   // strip is part of the card: it takes barH from the available height and the video
   // sits below it \u2014 bar + video share the rounded clip and zoom together.
   var pad = (frame.padding || 0) * s
-  // Per-side placement (frame.inset: fractions of the frame, a negative side
+  // Per-side placement (cfr.inset: fractions of the frame, a negative side
   // bleeds the card past the edge) overrides the symmetric padding on the
   // sides it names; absent sides keep pad, so the old math falls out.
-  var ipIns = frame.inset || {}
+  var ipIns = cfr.inset || {}
   var ipL = ipIns.left == null ? pad : ipIns.left * W
   var ipR = ipIns.right == null ? pad : ipIns.right * W
   var ipT = ipIns.top == null ? pad : ipIns.top * H
   var ipB = ipIns.bottom == null ? pad : ipIns.bottom * H
-  var bar = frame.browserBar || {}
+  var bar = cfr.browserBar || {}
   // Window takes carry a viewport crop (drawImage source rect, capture px) that
   // removes the real browser chrome \u2014 the card's source dims are then the CROP
   // dims (meta/cursor were rewritten into crop space at doc build).
@@ -4509,11 +4555,11 @@ var ON_FRAME = `(ctx, content, dt) => {
   // Cover fit: the CARD rect and the VIDEO rect separate. Under
   // contain (default, byte-identical for every existing doc) the card IS the
   // fitted video; under cover the card is the padded area itself and the
-  // footage cover-fills it, cropped around frame.focus (normalized video
+  // footage cover-fills it, cropped around cfr.focus (normalized video
   // fractions, the zoom cx/cy convention; clamped so no gap ever shows).
   // Chrome under cover scales by s alone (cf = 1): the card is as wide as
   // the frame allows, which is the case cf existed to protect against.
-  var fitCover = frame.fit === 'cover'
+  var fitCover = cfr.fit === 'cover'
   var cf = fitCover ? 1 : Math.min(1, (W / H) / (vw / vh))
   var s2 = s * cf
   // current zoom \u2014 a standard keyframe track in OUTPUT time (hold + arrival pairs
@@ -4532,11 +4578,11 @@ var ON_FRAME = `(ctx, content, dt) => {
     sc = Math.max(availW / vw, availH / vh)
     dw = vw * sc; dh = vh * sc
     cardX = ipL; cardY = ipT; cardW = availW; cardH = availH + barH
-    var fcv = frame.focus || {}
+    var fcv = cfr.focus || {}
     var fcx = fcv.cx == null ? 0.5 : Math.max(0, Math.min(1, fcv.cx))
     var fcy = fcv.cy == null ? 0.5 : Math.max(0, Math.min(1, fcv.cy))
     // focusFollow: the crop keeps the camera's focus in frame (a 9:16 cut).
-    if (frame.focusFollow === 'camera' && zt && zt.keyframes && zt.keyframes.length) { fcx = zx; fcy = zy }
+    if (cfr.focusFollow === 'camera' && zt && zt.keyframes && zt.keyframes.length) { fcx = zx; fcy = zy }
     var vTop = ipT + barH
     dx = Math.min(cardX, Math.max(cardX + availW - dw, cardX + availW / 2 - fcx * dw))
     dy = Math.min(vTop, Math.max(vTop + availH - dh, vTop + availH / 2 - fcy * dh))
@@ -4548,14 +4594,14 @@ var ON_FRAME = `(ctx, content, dt) => {
     dx = ipL + (availW - dw) / 2; dy = ipT + barH + (availH - dh) / 2
     cardX = dx; cardY = dy - barH; cardW = dw; cardH = dh + barH
   }
-  var radius = (frame.radius || 0) * s2
-  var shadow = frame.shadow || 0
+  var radius = (cfr.radius || 0) * s2
+  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
   // ground.
-  var shC = frame.shadowContact || 0
+  var shC = cfr.shadowContact || 0
   var shRgb = '0,0,0'
-  var shHex = frame.shadowColor
+  var shHex = cfr.shadowColor
   if (typeof shHex === 'string' && /^#[0-9a-fA-F]{6}$/.test(shHex)) {
     shRgb = parseInt(shHex.slice(1, 3), 16) + ',' + parseInt(shHex.slice(3, 5), 16) + ',' + parseInt(shHex.slice(5, 7), 16)
   }
@@ -4695,15 +4741,15 @@ var ON_FRAME = `(ctx, content, dt) => {
   // expanded by half the width so the stroke's inner edge lands on the card's
   // own edge and never covers footage (inset, a 24px width ate 24px of the
   // recording). Outer corner radius grows with the width, the CSS-border rule;
-  // a square card stays square. frame.border is the ALPHA (0 = off) and rides
+  // a square card stays square. cfr.border is the ALPHA (0 = off) and rides
   // globalAlpha, so borderColor takes any CSS colour notation without this
   // having to parse one. Card chrome, so it scales by s2.
-  if (frame.border) {
-    var bdW = (frame.borderWidth > 0 ? frame.borderWidth : ${FRAME_BORDER_WIDTH_DEFAULT}) * s2
+  if (cfr.border) {
+    var bdW = (cfr.borderWidth > 0 ? cfr.borderWidth : ${FRAME_BORDER_WIDTH_DEFAULT}) * s2
     var bdH = bdW / 2
     c.save()
-    c.globalAlpha = Math.min(1, frame.border)
-    c.strokeStyle = frame.borderColor || '${FRAME_BORDER_COLOR_DEFAULT}'
+    c.globalAlpha = Math.min(1, cfr.border)
+    c.strokeStyle = cfr.borderColor || '${FRAME_BORDER_COLOR_DEFAULT}'
     c.lineWidth = bdW
     rr(cardX - bdH, cardY - bdH, cardW + bdW, cardH + bdW, radius > 0 ? radius + bdH : 0)
     c.stroke()
@@ -5281,6 +5327,10 @@ function lowerToComposition(input) {
             y: round6(p.y)
           })),
           cursorSpace: { w: m.meta.width, h: m.meta.height },
+          // 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.
+          frame: cardFields(mediaFrame(doc, m.id)),
           ...fade.length ? { cursorFade: fade } : {}
         };
       })
@@ -8421,6 +8471,7 @@ export {
   LOOK_KINDS,
   MEDIA_ENTER_KINDS,
   MEDIA_EXIT_KINDS,
+  MEDIA_FRAME_KEYS,
   MINIMAL_BAR_THEMES,
   MOTION_DELTA,
   MOTION_EASE,
@@ -8500,6 +8551,7 @@ export {
   camTrackFromDoc,
   cardEnter,
   cardExit,
+  cardFields,
   cardInset,
   cardPointToScreen,
   cardPoseTrack,
@@ -8573,6 +8625,7 @@ export {
   lowerToComposition,
   mediaAtOutput,
   mediaDuration,
+  mediaFrame,
   mediaKey,
   mediaSource,
   micLane,