@vosjs/studio-core 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -1050,6 +1050,12 @@ interface TextOverlayClip extends OverlayClipBase {
     letterSpacing?: number;
     /** Line height multiplier (default OVERLAY_LINE_HEIGHT). */
     lineHeight?: number;
+    /**
+     * Legibility shadow strength 0..1 (the preset's when absent; 0 = none).
+     * Words on a plate ground carry none: the shadow exists for words over
+     * footage.
+     */
+    shadow?: number;
     /** Text outline, drawn under the fill. */
     stroke?: TextOverlayStroke;
     /** Background pill behind the text block (absent = none). */
@@ -1426,6 +1432,19 @@ declare const FRAME_BORDER_DEFAULT = 0.35;
  */
 declare const FRAME_BORDER_WIDTH_DEFAULT = 1.5;
 declare const FRAME_BORDER_COLOR_DEFAULT = "#ffffff";
+/**
+ * How far past the card's rounded clip the footage and the browser-bar fill
+ * are drawn, in device pixels, so the clip is the ONE edge the eye sees.
+ * A clipped drawImage whose destination rect lands exactly on the clip path
+ * anti-aliases that edge twice wherever it falls on a fractional device
+ * pixel (the studio canvas is the fitted box at device pixel ratio, and any
+ * zoom rescales everything about its focus), leaving a partially covered
+ * seam pixel along every straight edge that the arc, drawn by the clip
+ * alone, never has. One pixel covers the seam and changes the footage scale
+ * by less than a part in a thousand. Read by ON_FRAME; the layout tests
+ * expect the destination rect to be the mirror's grown by this much.
+ */
+declare const CARD_EDGE_OVERDRAW = 1;
 /**
  * The realistic browser-bar kind matching the recorder's OS — seeds Default
  * mode so the synthetic chrome looks native to where the take was recorded
@@ -3316,4 +3335,4 @@ declare function rejectSpan(rejected: RejectedSpan[] | undefined, lane: Rejected
     anchor?: StepAnchor;
 }, note?: string): RejectedSpan;
 
-export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, 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_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 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_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, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, HOUSE_GRADIENT, type IngestOptions, LOOK_KINDS, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type MediaOverlayClip, 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, PROGRAM_RETIME, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, 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, 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_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 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, applyLook, aspectRatioValue, audioLane, backdropMedia, buildDigest, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, computeCardLayout, computeMicRms, computePeaks, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docOutputDuration, docToCropSpace, docToFullSpace, duckCurve, effectiveSegments, entranceSeconds, envelopeAt, envelopeValueAt, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, hexToRgbTriplet, houseLook, idleGaps, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, levelForFocusFraction, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, micLane, migrateHostedDoc, momentsFromDoc, motionTrack, musicBedClip, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, pageDisplayUrl, parsePoseId, pickStyle, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, sceneChanges, scrollRuns, setSpeedInRange, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, videoLane, voiceKey, withBackdrop, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomWindow };
+export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, 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_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 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_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, type FocusBounds, type FollowEvent, type FollowOptions, type FrameEntrance, type FrameGeometry, type FrameStyle, HOUSE_GRADIENT, type IngestOptions, LOOK_KINDS, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, MINIMAL_BAR_THEMES, MOTION_DELTA, MOTION_EASE, type MediaOverlayClip, 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, PROGRAM_RETIME, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, 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, 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_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 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, applyLook, aspectRatioValue, audioLane, backdropMedia, buildDigest, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, computeCardLayout, computeMicRms, computePeaks, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docOutputDuration, docToCropSpace, docToFullSpace, duckCurve, effectiveSegments, entranceSeconds, envelopeAt, envelopeValueAt, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, hexToRgbTriplet, houseLook, idleGaps, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, levelForFocusFraction, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, micLane, migrateHostedDoc, momentsFromDoc, motionTrack, musicBedClip, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayRect, overlaysLane, pageDisplayUrl, parsePoseId, pickStyle, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, programDuration, projectFromArtifact, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolveText3dAsset, resolveZoomStyle, sceneChanges, scrollRuns, setSpeedInRange, smoothCursor, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, tiltLane, tiltTrackFromDoc, transitionMult, videoLane, voiceKey, withBackdrop, withHolds, withoutRejected, wrapProgramLength, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomWindow };

package/dist/index.js

@@ -153,6 +153,7 @@ var DEFAULT_FRAME_STYLE = BASE_FRAME_STYLE;
 var FRAME_BORDER_DEFAULT = 0.35;
 var FRAME_BORDER_WIDTH_DEFAULT = 1.5;
 var FRAME_BORDER_COLOR_DEFAULT = "#ffffff";
+var CARD_EDGE_OVERDRAW = 1;
 function platformBarKind(platform) {
   return platform === "windows" || platform === "linux" ? "windows-light" : "mac-light";
 }
@@ -1265,6 +1266,7 @@ var CARD_FOV = 30;
 var OVERLAY_Z = -2;
 var CARD_Z = -4;
 var BACKGROUND_Z = -6;
+var CARD_OVERSCAN = 1.25;
 var CAMERA_NEAR = 0.1;
 var CAMERA_FAR = 100;
 function planeSizeAtDepth(distance, fovDeg, aspect) {
@@ -1360,6 +1362,7 @@ function resolveOverlayStyle(clip) {
       )
     } : {},
     ...clip.color ? { color: clip.color } : {},
+    ...clip.shadow !== void 0 ? { shadow: Math.min(1, Math.max(0, clip.shadow)) } : {},
     fontStyle: clip.italic ? "italic" : "normal",
     align: clip.align ?? "center",
     letterSpacing: clip.letterSpacing ?? 0,
@@ -2849,11 +2852,15 @@ function expandEndCard(doc, outputDuration) {
     enter: "rise",
     exit: "none",
     align: "center",
-    ...card.ink ? { color: card.ink } : {}
+    ...card.ink ? { color: card.ink } : {},
+    shadow: 0
   });
-  if (card.headline?.trim()) clips.push(text("endcard-title", card.headline.trim(), "title", 0.44, 0.35));
-  if (card.sub?.trim()) clips.push(text("endcard-sub", card.sub.trim(), "caption", 0.57, 0.5));
-  if (card.wordmark?.trim()) clips.push(text("endcard-mark", card.wordmark.trim(), "label", 0.88, 0.65));
+  if (card.headline?.trim())
+    clips.push(text("endcard-title", card.headline.trim(), "title", 0.44, 0.35));
+  if (card.sub?.trim())
+    clips.push(text("endcard-sub", card.sub.trim(), "caption", 0.57, 0.5));
+  if (card.wordmark?.trim())
+    clips.push(text("endcard-mark", card.wordmark.trim(), "label", 0.88, 0.65));
   const overlays = [...doc.overlays ?? [], ...clips];
   return { doc: { ...doc, segments, overlays }, endStart, seconds };
 }
@@ -3525,24 +3532,33 @@ var ON_FRAME = `(ctx, content, dt) => {
   // the GPU texture allocated at the original dims and re-uploads the new canvas
   // against stale dims \u2192 stretch/duplicate; dispose() forces a full realloc) and
   // rebuilding each frustum-filling plane at the new aspect + syncing the camera.
-  if (cv.width !== W || cv.height !== H) {
+  // Card OVERSCAN (stage.ts CARD_OVERSCAN): a frame whose inset bleeds the
+  // card past an edge paints it on a canvas and a plane larger than the
+  // frame by ck about the centre, so a tilt that turns the bled edge back
+  // toward the viewer shows card there, not the texture's edge. Every doc
+  // that keeps its card inside the frame (and the flat stub, which has no
+  // card layer) stays at 1: byte- and pixel-identical.
+  var d = ctx.data || {}
+  var ckIns = (d.frame && d.frame.inset) || {}
+  var ck = r.card && (ckIns.left < 0 || ckIns.right < 0 || ckIns.top < 0 || ckIns.bottom < 0) ? ${CARD_OVERSCAN} : 1
+  var cW = Math.round(W * ck), cH = Math.round(H * ck)
+  if (cv.width !== cW || cv.height !== cH) {
     var THREE = ctx.THREE
     var aspect = W / H
     var cm = ctx.camera
     if (cm && cm.isPerspectiveCamera) { cm.aspect = aspect; cm.updateProjectionMatrix() }
-    var lyr = [[bg, ${BACKGROUND_Z}], [card, ${CARD_Z}], [ov, ${OVERLAY_Z}]]
+    var lyr = [[bg, ${BACKGROUND_Z}, 1], [card, ${CARD_Z}, ck], [ov, ${OVERLAY_Z}, 1]]
     for (var Li = 0; Li < lyr.length; Li++) {
-      var Ly = lyr[Li][0], Lz = lyr[Li][1]
-      if (Ly.canvas) { Ly.canvas.width = W; Ly.canvas.height = H }
+      var Ly = lyr[Li][0], Lz = lyr[Li][1], Lk = lyr[Li][2]
+      if (Ly.canvas) { Ly.canvas.width = Math.round(W * Lk); Ly.canvas.height = Math.round(H * Lk) }
       if (Ly.texture && Ly.texture.dispose) Ly.texture.dispose()
       if (Ly.mesh && THREE) {
         if (Ly.mesh.geometry && Ly.mesh.geometry.dispose) Ly.mesh.geometry.dispose()
-        var Lh = 2 * Math.abs(Lz) * Math.tan(${CARD_FOV} * Math.PI / 180 / 2)
+        var Lh = 2 * Math.abs(Lz) * Math.tan(${CARD_FOV} * Math.PI / 180 / 2) * Lk
         Ly.mesh.geometry = new THREE.PlaneGeometry(Lh * aspect, Lh)
       }
     }
   }
-  var d = ctx.data || {}
   var frame = d.frame || {}
   var TL = globalThis.__vosTimeline
   // Output-timeline seconds (engine-fed master clock) \u2192 source seconds on screen.
@@ -3861,7 +3877,15 @@ var ON_FRAME = `(ctx, content, dt) => {
 
   // The CARD layer canvas starts transparent each frame \u2014 the padding around
   // the contain-fit card shows the background layer through the plane's alpha.
-  c.clearRect(0, 0, W, H)
+  // Under overscan the canvas is larger than the frame and every frame-space
+  // draw below rides a base translation to its centre.
+  if (ck !== 1) c.setTransform(1, 0, 0, 1, 0, 0)
+  c.clearRect(0, 0, cv.width, cv.height)
+  if (ck !== 1) c.setTransform(1, 0, 0, 1, (cW - W) / 2, (cH - H) / 2)
+  // Footage is nearly always drawn SMALLER than it was recorded (a 1920
+  // recording in a padded 1080 card, or a 440-wide tile): the default
+  // bilinear tap aliases and blurs a large downscale; 'high' resamples.
+  c.imageSmoothingQuality = 'high'
 
   // video destination rect (contain within the padded area). The optional browser-bar
   // strip is part of the card: it takes barH from the available height and the video
@@ -3953,28 +3977,56 @@ var ON_FRAME = `(ctx, content, dt) => {
   c.save()
   // d.zoomSuppressed = editor aiming mode: the host merges it into ctx.data
   // while the focus overlay is up so the full frame renders. Never persisted.
+  // ceZs = the zoom transform's device scale, for the two values below that
+  // are sized in DEVICE pixels inside a scaled user space.
+  var ceZs = 1
   if (lvl > 1.001 && !d.zoomSuppressed) {
     var fx = dx + zx * dw, fy = dy + zy * dh
     c.translate(fx, fy); c.scale(lvl, lvl); c.translate(-fx, -fy)
-  }
-  // soft shadow behind the card (bar strip + video)
+    ceZs = lvl
+  }
+  // The card's shadows are cast by a body drawn OFF-CANVAS and brought back
+  // by shadowOffsetX alone. Shadow offsets are device space, untouched by
+  // the transform, so the body moves by shD / ceZs in user space and the
+  // offset is shD; shD clears the canvas by the card's own device size, so
+  // no part of the body lands on it at any zoom. Painting the body in place
+  // (opaque black under the footage) left a 1px dark seam along every
+  // straight card edge at a fractional coordinate: the fill's anti-aliased
+  // rim showed through where the clipped footage did not cover it, and the
+  // corners, drawn by the clip alone, hid theirs inside the arc.
+  var shD = ceZs * (cardW + cardH) + 2 * (W + H)
+  var shX = cardX - shD / ceZs
+  // The card shadow is LAYERED: three shadows whose blur and offset grow
+  // while each stays at a low alpha (shadow is the strength they share),
+  // so the card reads as lifted a little off the ground. One wide layer at
+  // the full strength was the old paint, and at the default 0.4 it read as
+  // a dark pool under the card.
   if (shadow > 0) {
-    c.save()
-    c.shadowColor = 'rgba(' + shRgb + ',' + shadow + ')'
-    c.shadowBlur = 60 * s2; c.shadowOffsetY = 24 * s2
-    c.fillStyle = '#000'
-    rr(cardX, cardY, cardW, cardH, radius); c.fill()
-    c.restore()
+    var shL = [[3, 1, 0.2], [14, 6, 0.22], [48, 22, 0.3]]
+    for (var shI = 0; shI < shL.length; shI++) {
+      c.save()
+      c.shadowColor = 'rgba(' + shRgb + ',' + +(shadow * shL[shI][2]).toFixed(3) + ')'
+      c.shadowBlur = shL[shI][0] * s2; c.shadowOffsetX = shD; c.shadowOffsetY = shL[shI][1] * s2
+      c.fillStyle = '#000'
+      rr(shX, cardY, cardW, cardH, radius); c.fill()
+      c.restore()
+    }
   }
   // contact shadow: tight and close, over the ambient layer
   if (shC > 0) {
     c.save()
     c.shadowColor = 'rgba(' + shRgb + ',' + shC + ')'
-    c.shadowBlur = 10 * s2; c.shadowOffsetY = 3 * s2
+    c.shadowBlur = 10 * s2; c.shadowOffsetX = shD; c.shadowOffsetY = 3 * s2
     c.fillStyle = '#000'
-    rr(cardX, cardY, cardW, cardH, radius); c.fill()
+    rr(shX, cardY, cardW, cardH, radius); c.fill()
     c.restore()
   }
+  // The footage and the bar fill overdraw the clip by one device pixel
+  // (CARD_EDGE_OVERDRAW) so the clip is the only edge: a destination rect
+  // that lands exactly on the clip path anti-aliases the edge twice at a
+  // fractional coordinate and leaves a half-covered seam pixel.
+  var ceOv = ${CARD_EDGE_OVERDRAW} / ceZs
+  var ceX = dx - ceOv, ceY = dy - ceOv, ceW = dw + 2 * ceOv, ceH = dh + 2 * ceOv
   // video, then bar, clipped to the card's rounded corners. The bar draws
   // AFTER the footage: under cover the video rect can overflow ABOVE the
   // bar strip (a vertical crop), and bar-first let the footage paint over
@@ -3987,9 +4039,9 @@ var ON_FRAME = `(ctx, content, dt) => {
     // dimension-checked at attach); false \u21D2 element path (pre-first-seek,
     // or the provider never attached).
     var wcp3 = video.__voilaWc
-    if (!(wcp3 && wcp3.draw(c, crp, dx, dy, dw, dh))) {
-      if (crp) c.drawImage(video, crp.x, crp.y, crp.w, crp.h, dx, dy, dw, dh)
-      else c.drawImage(video, dx, dy, dw, dh)
+    if (!(wcp3 && wcp3.draw(c, crp, ceX, ceY, ceW, ceH))) {
+      if (crp) c.drawImage(video, crp.x, crp.y, crp.w, crp.h, ceX, ceY, ceW, ceH)
+      else c.drawImage(video, ceX, ceY, ceW, ceH)
     }
   } catch (e) {}
   if (barH > 0) {
@@ -3999,7 +4051,7 @@ var ON_FRAME = `(ctx, content, dt) => {
     // absent = the built-in graphite look
     var thm = (minimal && bar.theme) || null
     c.fillStyle = minimal ? (thm ? thm.bar : '#141417') : dark ? '#2a2a2e' : '#e9e9eb'
-    c.fillRect(cardX, cardY, cardW, barH)
+    c.fillRect(cardX - ceOv, cardY - ceOv, cardW + 2 * ceOv, barH + ceOv)
     c.fillStyle = dark || (minimal && !(thm && thm.light)) ? 'rgba(255,255,255,0.08)' : 'rgba(0,0,0,0.08)'
     c.fillRect(cardX, cardY + barH - s2, cardW, s2) // hairline above the video
     var midY = cardY + barH / 2
@@ -5862,8 +5914,8 @@ var LOOKS = {
     cardWidth: 0.84,
     headroom: 0.16,
     radius: 12,
-    shadow: 0.22,
-    shadowContact: 0.16,
+    shadow: 0.42,
+    shadowContact: 0,
     border: 0.08,
     borderColor: "#000000"
   },
@@ -5873,8 +5925,8 @@ var LOOKS = {
     cardWidth: 0.84,
     headroom: 0.16,
     radius: 12,
-    shadow: 0.35,
-    shadowContact: 0.2,
+    shadow: 0.5,
+    shadowContact: 0,
     border: 0
   },
   dark: {
@@ -5883,8 +5935,8 @@ var LOOKS = {
     cardWidth: 0.86,
     headroom: 0.14,
     radius: 12,
-    shadow: 0.5,
-    shadowContact: 0.3,
+    shadow: 0.7,
+    shadowContact: 0,
     shadowColor: "#000000",
     border: 0.12,
     borderColor: "#ffffff"
@@ -7231,6 +7283,7 @@ export {
   CAM_SIZE_MIN,
   CAM_SPAN_MIN,
   CAPTURE_COVERAGE_MIN,
+  CARD_EDGE_OVERDRAW,
   CARD_FOV,
   CARD_Z,
   CHANNEL_SPECS_HASH,