@vosjs/studio-core 0.9.1 → 0.10.0

package/dist/index.d.ts

@@ -2013,23 +2013,78 @@ declare function zoomCoversRect(span: {
     cy: number;
 }, rect: NormRect, layout: CardLayout, tol?: number): boolean;
 
-/**
- * Style as DATA: the fields of a signed-off take's doc that ARE its
- * style — camera, speed, tilt personality, frame, cursor, cam bubble, export.
- * `copyStyle` carries them onto another take deterministically, so a series
- * shares them by construction and the recipe (CUT.md) only has to say what a
- * number cannot. Never the spans, overlays or audio: those are the cut.
- */
-
 declare const STYLE_FIELDS: readonly ["zoomStyle", "zoomParams", "speedParams", "tiltStyle", "frame", "cursor", "cam", "export"];
 type StyleField = (typeof STYLE_FIELDS)[number];
 /** The style fields present on a doc, deep-cloned. */
 declare function pickStyle(doc: ProjectDoc): Partial<Pick<ProjectDoc, StyleField>>;
+interface CopyStyleOptions {
+    /**
+     * Carry the seed's LAYOUT too (`copyLayout`): its stage clips by id, its
+     * rest lean and its trailing hold. Off by default, so a series cut keeps
+     * copying style alone.
+     */
+    layout?: boolean;
+    /** Passed through to `copyLayout`. */
+    keys?: Record<string, string>;
+}
 /**
  * A new doc: `to` with `from`'s style fields. A field absent on `from` is
  * removed from the result (the seed's absence is a choice — the default).
  */
-declare function copyStyle(from: ProjectDoc, to: ProjectDoc): ProjectDoc;
+declare function copyStyle(from: ProjectDoc, to: ProjectDoc, opts?: CopyStyleOptions): ProjectDoc;
+/** The frame fields a layout owns. Never `aspectRatio` or `browserBar`. */
+declare const LAYOUT_FRAME_FIELDS: readonly ["background", "padding", "radius", "shadow", "shadowContact", "shadowColor", "inset", "border", "borderWidth", "borderColor", "fit", "focus", "focusFollow", "parallax", "entrance"];
+/**
+ * The id prefix an exemplar reserves for the clips that ARE its layout:
+ * the words and the mark a poster places (`stage-title`, `stage-kicker`,
+ * `stage-brand`, `stage-mark`). Every other clip is the take's own.
+ */
+declare const STAGE_CLIP_PREFIX = "stage-";
+/** The id of the whole-take lean a layout or a canvas gesture writes. */
+declare const REST_TILT_ID = "rest";
+declare const isStageClip: (clip: Pick<OverlayClip, "id">) => boolean;
+/** The exemplar's rest lean: its `rest`/`stage` span, or a span covering (nearly) the whole source. */
+declare function restLeanOf(doc: ProjectDoc): {
+    rx: number;
+    ry: number;
+} | null;
+/** What a document carries of a layout, for a report. */
+interface LayoutParts {
+    /** The layout-owned frame fields present on the document. */
+    frame: string[];
+    /** The stage clips' ids. */
+    clips: string[];
+    lean: boolean;
+    hold: boolean;
+}
+declare function layoutOf(doc: ProjectDoc): LayoutParts;
+interface CopyLayoutOptions {
+    /**
+     * Media keys this document should show in the exemplar's image clips,
+     * by clip id (`{ 'stage-mark': 'brand/mark.svg' }`): an exemplar's mark
+     * is its brand's, so without a key of its own (here, or already on the
+     * document) an image stage clip is left out and said in `notes`.
+     */
+    keys?: Record<string, string>;
+}
+interface CopiedLayout {
+    doc: ProjectDoc;
+    /** What the copy left alone, in plain words (empty when nothing was). */
+    notes: string[];
+}
+/**
+ * `to` with `from`'s layout. Pure: returns a new document; never mutates
+ * either input.
+ *
+ * Copied: the layout-owned frame fields (present on the exemplar ⇒ copied,
+ * absent ⇒ removed; the animated ground rides along only when the exemplar
+ * has one), the stage clips by id (a same-id text clip keeps the words this
+ * document already has; an image clip keeps this document's key, or takes
+ * one from `keys`), the rest lean as one whole-take span where this
+ * document has no tilt spans of its own, and the trailing hold. Kept: the
+ * aspect, the browser chrome, every clip that is not a stage clip, the cut.
+ */
+declare function copyLayout(from: ProjectDoc, to: ProjectDoc, opts?: CopyLayoutOptions): CopiedLayout;
 
 /**
  * The digest's crop geometry, pure and shared by the CLI's page and
@@ -2750,6 +2805,17 @@ declare function applyLook(frame: FrameStyle, look: Look, size: {
     h: number;
 }, placement: LookPlacement): FrameStyle;
 
+/**
+ * THE REST of a take: the one output time its still is taken at. A poster
+ * ends on a trailing `hold` (its last segment freezes on its last frame),
+ * and the rest is where that hold BEGINS — the composed frame before
+ * nothing moves. Null when the take has no trailing hold, and null with an
+ * end card: the end card grows that hold at lowering and its words rise
+ * over the receding card during it, so the frame where it begins is
+ * footage under a fading title, not a poster. One convention for every
+ * still-taking surface (an export, a thumbnail, a kit), so they agree.
+ */
+declare function docRestTime(doc: ProjectDoc): number | null;
 /** The entrance's default length, seconds. */
 declare const ENTRANCE_SECONDS = 1.2;
 /** The end card's default length, seconds. */
@@ -3344,4 +3410,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_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 };
+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 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_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, 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, 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, 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_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, copyLayout, copyStyle, cropBox, cursorIdleFade, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docOutputDuration, docRestTime, docToCropSpace, docToFullSpace, duckCurve, effectiveSegments, entranceSeconds, envelopeAt, envelopeValueAt, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, focusBounds, followFocusEvents, frameGeometry, hexToRgbTriplet, houseLook, idleGaps, isLookKind, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, layoutOf, 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, restLeanOf, 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

@@ -1102,8 +1102,8 @@ import {
   segmentRate as segmentRate2,
   sortKeyframes as sortKeyframes2,
   sourceToTimeline as sourceToTimeline2,
-  splitBySpeed,
-  totalDuration
+  splitBySpeed as splitBySpeed2,
+  totalDuration as totalDuration2
 } from "@vosjs/timeline";
 import { timelineRuntimeCode as timelineRuntimeCode2 } from "@vosjs/timeline/bundle";
 
@@ -2774,6 +2774,20 @@ var STUDIO_FRAME = `(ctx, content, dt) => {
 
 // src/lower/motion.ts
 import { sortKeyframes } from "@vosjs/timeline";
+import { splitBySpeed, totalDuration } from "@vosjs/timeline";
+function docRestTime(doc) {
+  if (doc.endCard) return null;
+  const last = doc.segments.at(-1);
+  const hold = last?.hold;
+  if (typeof hold !== "number" || !(hold > 0)) return null;
+  const segs = doc.segments.length ? doc.segments : [{ in: 0, out: doc.source.meta.durationMs / 1e3 }];
+  const total = totalDuration(
+    withHolds(segs, splitBySpeed(segs, doc.speed ?? []))
+  );
+  const rest = total - hold;
+  if (!(rest >= 0)) return null;
+  return Math.round(rest * 1e3) / 1e3;
+}
 var ENTRANCE_SECONDS = 1.2;
 var END_CARD_SECONDS = 2.5;
 var END_CARD_RECEDE = 0.7;
@@ -3020,10 +3034,10 @@ var CAM_PAN_EASE = ZOOM_PAN_EASE;
 var PROGRAM_DURATION = 1;
 function ratedSegments(doc) {
   const segs = isRecordingDoc(doc) ? doc.segments.length ? doc.segments : [{ in: 0, out: doc.source.meta.durationMs / 1e3 }] : [{ in: 0, out: programDuration(doc) }];
-  return withHolds(segs, splitBySpeed(segs, doc.speed ?? []));
+  return withHolds(segs, splitBySpeed2(segs, doc.speed ?? []));
 }
 function durationSec(doc, rated) {
-  const trimmed = totalDuration(rated);
+  const trimmed = totalDuration2(rated);
   return trimmed > 0 ? trimmed : doc.source.meta.durationMs / 1e3;
 }
 function spanOutputExtent(segments, sIn, sOut) {
@@ -5278,6 +5292,88 @@ function zoomCoversRect(span, rect, layout, tol = 0.02) {
   return rect.x >= w.x0 - tol && rect.x + rect.w <= w.x1 + tol && rect.y >= w.y0 - tol && rect.y + rect.h <= w.y1 + tol;
 }
 
+// src/audioBeds.ts
+import { totalDuration as totalDuration3 } from "@vosjs/timeline";
+var round32 = (v) => Math.round(v * 1e3) / 1e3;
+function docOutputDuration(doc) {
+  return totalDuration3(ratedSegments(doc));
+}
+function musicBedClip(input) {
+  const track = round32(input.trackDuration);
+  const output = round32(input.outputDuration);
+  const clip = {
+    id: input.id,
+    key: input.key,
+    name: input.name,
+    start: 0,
+    in: 0,
+    out: track,
+    duration: track,
+    // Under speech, not over it; catalog tracks are loudness-normalized so
+    // one default means the same thing across the library.
+    gain: 0.5,
+    fadeIn: 0,
+    // A bed that just stops reads as a glitch; clamp so a very short cut
+    // still spends most of its time at full level.
+    fadeOut: output > 0 ? Math.min(1.5, round32(output / 4)) : 1.5,
+    duck: input.hasMic || void 0
+  };
+  if (output <= 0) return clip;
+  if (track >= output) {
+    clip.out = output;
+  } else {
+    clip.loop = true;
+    clip.loopLen = output;
+  }
+  return clip;
+}
+function isMusicBed(clip, outputDuration) {
+  if (clip.start > 0.05) return false;
+  if (clip.loop) return true;
+  const placed = clip.out - clip.in;
+  return Math.abs(placed - outputDuration) <= 1;
+}
+function refillAudioBeds(doc, prevDuration, nextDuration) {
+  const EPS2 = 0.05;
+  if (Math.abs(nextDuration - prevDuration) <= EPS2 || nextDuration <= 0) {
+    return false;
+  }
+  let changed = false;
+  for (const clip of doc.audio) {
+    if (clip.start >= nextDuration) continue;
+    const placed = clip.loop ? Math.max(clip.out - clip.in, clip.loopLen ?? clip.out - clip.in) : clip.out - clip.in;
+    if (Math.abs(clip.start + placed - prevDuration) > EPS2) continue;
+    const span = clip.out - clip.in;
+    const nextLen = round32(nextDuration - clip.start);
+    if (clip.loop) {
+      if (nextLen >= span) {
+        clip.loopLen = nextLen;
+      } else {
+        clip.loop = void 0;
+        clip.loopLen = void 0;
+        clip.out = round32(clip.in + nextLen);
+      }
+    } else {
+      if (clip.in + nextLen <= clip.duration) {
+        clip.out = round32(clip.in + nextLen);
+      } else {
+        clip.out = clip.duration;
+        clip.loop = true;
+        clip.loopLen = nextLen;
+      }
+    }
+    changed = true;
+  }
+  return changed;
+}
+function voiceKey(doc) {
+  if (!("source" in doc)) return null;
+  const src = doc.source;
+  if (src.micKey) return src.micKey;
+  if (src.meta.hasAudio && !src.meta.hasMic) return src.videoKey;
+  return null;
+}
+
 // src/digest/style.ts
 var STYLE_FIELDS = [
   "zoomStyle",
@@ -5297,14 +5393,116 @@ function pickStyle(doc) {
   }
   return out;
 }
-function copyStyle(from, to) {
+function copyStyle(from, to, opts = {}) {
   const next = structuredClone(to);
   const style = pickStyle(from);
   for (const k of STYLE_FIELDS) {
     if (k in style) next[k] = style[k];
     else delete next[k];
   }
-  return next;
+  const styled = next;
+  return opts.layout ? copyLayout(from, styled, { keys: opts.keys }).doc : styled;
+}
+var LAYOUT_FRAME_FIELDS = [
+  "background",
+  "padding",
+  "radius",
+  "shadow",
+  "shadowContact",
+  "shadowColor",
+  "inset",
+  "border",
+  "borderWidth",
+  "borderColor",
+  "fit",
+  "focus",
+  "focusFollow",
+  "parallax",
+  "entrance"
+];
+var STAGE_CLIP_PREFIX = "stage-";
+var REST_TILT_ID = "rest";
+var isStageClip = (clip) => clip.id.startsWith(STAGE_CLIP_PREFIX);
+function restLeanOf(doc) {
+  const spans = doc.tilt ?? [];
+  const named = spans.find((z) => z.id === REST_TILT_ID || z.id === "stage");
+  if (named) return { rx: named.rx, ry: named.ry };
+  const total = anchorSourceDuration(doc);
+  const whole = spans.find((z) => z.out - z.in >= total * 0.9);
+  return whole ? { rx: whole.rx, ry: whole.ry } : null;
+}
+function layoutOf(doc) {
+  const frame = doc.frame;
+  return {
+    frame: LAYOUT_FRAME_FIELDS.filter((k) => frame[k] !== void 0),
+    clips: (doc.overlays ?? []).filter(isStageClip).map((o) => o.id),
+    lean: restLeanOf(doc) !== null,
+    hold: (doc.segments.at(-1)?.hold ?? 0) > 0
+  };
+}
+function copyLayout(from, to, opts = {}) {
+  const doc = structuredClone(to);
+  const notes = [];
+  const frame = doc.frame;
+  const src = from.frame;
+  for (const k of LAYOUT_FRAME_FIELDS) {
+    if (src[k] !== void 0) frame[k] = structuredClone(src[k]);
+    else delete frame[k];
+  }
+  if (from.frame.backgroundMedia)
+    doc.frame.backgroundMedia = structuredClone(from.frame.backgroundMedia);
+  const outDur = docOutputDuration(doc);
+  const own = new Map((doc.overlays ?? []).map((o) => [o.id, o]));
+  const merged = (doc.overlays ?? []).filter(
+    (o) => !isStageClip(o)
+  );
+  const skippedMarks = [];
+  for (const clip of (from.overlays ?? []).filter(isStageClip)) {
+    const mine = own.get(clip.id);
+    const next = structuredClone(clip);
+    next.start = 0;
+    next.duration = Math.max(0.3, Math.round(outDur * 1e3) / 1e3);
+    if (next.kind === "text") {
+      if (mine?.kind === "text") next.text = mine.text;
+    } else if (opts.keys?.[clip.id]) {
+      next.key = opts.keys[clip.id];
+    } else if (mine && mine.kind !== "text") {
+      next.key = mine.key;
+    } else {
+      skippedMarks.push(clip.id);
+      continue;
+    }
+    merged.push(next);
+  }
+  for (const o of doc.overlays ?? []) {
+    if (isStageClip(o) && !merged.some((m) => m.id === o.id)) merged.push(o);
+  }
+  doc.overlays = merged.length ? merged : void 0;
+  if (skippedMarks.length)
+    notes.push(
+      `${skippedMarks.join(", ")} left out: the layout's image is its own brand's; add yours`
+    );
+  const lean = restLeanOf(from);
+  if (lean) {
+    if (!doc.tilt?.length) {
+      doc.tilt = [
+        {
+          id: REST_TILT_ID,
+          in: 0,
+          out: Math.round(anchorSourceDuration(doc) * 1e3) / 1e3,
+          rx: lean.rx,
+          ry: lean.ry,
+          source: "manual"
+        }
+      ];
+    } else {
+      notes.push("lean kept: this take has tilt spans of its own");
+    }
+  }
+  const hold = from.segments.at(-1)?.hold;
+  const last = doc.segments.at(-1);
+  if (typeof hold === "number" && hold > 0 && last) last.hold = hold;
+  return { doc, notes };
 }
 
 // src/digest/geometry.ts
@@ -5382,7 +5580,7 @@ function cropBox(m, geo, meta) {
 }
 
 // src/digest/build.ts
-import { totalDuration as totalDuration2 } from "@vosjs/timeline";
+import { totalDuration as totalDuration4 } from "@vosjs/timeline";
 var DIGEST_VERSION = 1;
 function buildDigest(input) {
   const { doc, meta } = { doc: input.doc, meta: input.doc.source.meta };
@@ -5450,7 +5648,7 @@ function buildDigest(input) {
   };
 }
 function outputDurationOf(doc) {
-  return totalDuration2(ratedSegments(doc));
+  return totalDuration4(ratedSegments(doc));
 }
 function round8(v) {
   return Math.round(v * 1e3) / 1e3;
@@ -5548,7 +5746,7 @@ function round9(v) {
 
 // src/lower/lowerStudioDoc.ts
 import { applyTimelineEdits } from "@vosjs/shared/timelineEdits";
-import { totalDuration as totalDuration3 } from "@vosjs/timeline";
+import { totalDuration as totalDuration5 } from "@vosjs/timeline";
 function lowerStudioDoc(doc, opts = {}) {
   return isRecordingDoc(doc) ? lowerToComposition(doc) : lowerProgramDoc(doc, opts);
 }
@@ -5579,7 +5777,7 @@ function lowerProgramDoc(doc, opts = {}) {
   ) : doc.program.config;
   const own = programDuration(doc);
   const rated = ratedSegments(doc);
-  const duration = own > 0 ? totalDuration3(rated) : 0;
+  const duration = own > 0 ? totalDuration5(rated) : 0;
   const entryData = studioLayerData(doc, duration);
   const baseData = anchor.data && typeof anchor.data === "object" ? anchor.data : {};
   const retimed = !!doc.speed?.length && own > 0;
@@ -6177,99 +6375,15 @@ import {
   removeSegment,
   segmentRate as segmentRate3,
   sourceToTimeline as sourceToTimeline3,
-  splitBySpeed as splitBySpeed2,
-  totalDuration as totalDuration5,
+  splitBySpeed as splitBySpeed3,
+  totalDuration as totalDuration6,
   trimSegment
 } from "@vosjs/timeline";
-
-// src/audioBeds.ts
-import { totalDuration as totalDuration4 } from "@vosjs/timeline";
-var round32 = (v) => Math.round(v * 1e3) / 1e3;
-function docOutputDuration(doc) {
-  return totalDuration4(ratedSegments(doc));
-}
-function musicBedClip(input) {
-  const track = round32(input.trackDuration);
-  const output = round32(input.outputDuration);
-  const clip = {
-    id: input.id,
-    key: input.key,
-    name: input.name,
-    start: 0,
-    in: 0,
-    out: track,
-    duration: track,
-    // Under speech, not over it; catalog tracks are loudness-normalized so
-    // one default means the same thing across the library.
-    gain: 0.5,
-    fadeIn: 0,
-    // A bed that just stops reads as a glitch; clamp so a very short cut
-    // still spends most of its time at full level.
-    fadeOut: output > 0 ? Math.min(1.5, round32(output / 4)) : 1.5,
-    duck: input.hasMic || void 0
-  };
-  if (output <= 0) return clip;
-  if (track >= output) {
-    clip.out = output;
-  } else {
-    clip.loop = true;
-    clip.loopLen = output;
-  }
-  return clip;
-}
-function isMusicBed(clip, outputDuration) {
-  if (clip.start > 0.05) return false;
-  if (clip.loop) return true;
-  const placed = clip.out - clip.in;
-  return Math.abs(placed - outputDuration) <= 1;
-}
-function refillAudioBeds(doc, prevDuration, nextDuration) {
-  const EPS2 = 0.05;
-  if (Math.abs(nextDuration - prevDuration) <= EPS2 || nextDuration <= 0) {
-    return false;
-  }
-  let changed = false;
-  for (const clip of doc.audio) {
-    if (clip.start >= nextDuration) continue;
-    const placed = clip.loop ? Math.max(clip.out - clip.in, clip.loopLen ?? clip.out - clip.in) : clip.out - clip.in;
-    if (Math.abs(clip.start + placed - prevDuration) > EPS2) continue;
-    const span = clip.out - clip.in;
-    const nextLen = round32(nextDuration - clip.start);
-    if (clip.loop) {
-      if (nextLen >= span) {
-        clip.loopLen = nextLen;
-      } else {
-        clip.loop = void 0;
-        clip.loopLen = void 0;
-        clip.out = round32(clip.in + nextLen);
-      }
-    } else {
-      if (clip.in + nextLen <= clip.duration) {
-        clip.out = round32(clip.in + nextLen);
-      } else {
-        clip.out = clip.duration;
-        clip.loop = true;
-        clip.loopLen = nextLen;
-      }
-    }
-    changed = true;
-  }
-  return changed;
-}
-function voiceKey(doc) {
-  if (!("source" in doc)) return null;
-  const src = doc.source;
-  if (src.micKey) return src.micKey;
-  if (src.meta.hasAudio && !src.meta.hasMic) return src.videoKey;
-  return null;
-}
-
-// src/timeline/lanes.ts
 function effectiveSegments(doc) {
   if (isRecordingDoc(doc) && doc.segments.length) return doc.segments;
   return [{ in: 0, out: anchorSourceDuration(doc) }];
 }
-var outputLen = (seg, speeds) => totalDuration5(splitBySpeed2([seg], speeds));
+var outputLen = (seg, speeds) => totalDuration6(splitBySpeed3([seg], speeds));
 var segmentStarts = (segments, speeds) => {
   const starts = [];
   let acc = 0;
@@ -6326,7 +6440,7 @@ var videoLane = {
         if (index < 0 || index >= segments.length) return null;
         const seg = segments[index];
         const starts = segmentStarts(segments, speeds);
-        const fullMap = splitBySpeed2([{ in: 0, out: sourceDuration }], speeds);
+        const fullMap = splitBySpeed3([{ in: 0, out: sourceDuration }], speeds);
         const edgeSrc = g.edge === "start" ? seg.in : seg.out;
         const edgeOutNow = g.edge === "start" ? starts[index] : starts[index] + outputLen(seg, speeds);
         const anchorOut = sourceToTimeline3(fullMap, Math.min(edgeSrc, sourceDuration)) ?? edgeSrc;
@@ -6349,7 +6463,7 @@ var videoLane = {
         );
         if (index < 0) return null;
         const s = segments[index];
-        const sourceT = mapTime2(splitBySpeed2([s], speeds), g.t - starts[index]);
+        const sourceT = mapTime2(splitBySpeed3([s], speeds), g.t - starts[index]);
         if (sourceT - s.in < 0.05 || s.out - sourceT < 0.05) return null;
         const next = [
           ...segments.slice(0, index),
@@ -6901,7 +7015,7 @@ var speedLane = {
     const sp = spans.find((s) => s.id === g.id);
     if (!sp) return null;
     const others = spans.filter((o) => o.id !== g.id);
-    const base = splitBySpeed2(effectiveSegments(doc), others);
+    const base = splitBySpeed3(effectiveSegments(doc), others);
     if (g.type === "move") {
       const len = sp.out - sp.in;
       let newIn = clampToKept(
@@ -7475,6 +7589,7 @@ export {
   FRAME_BORDER_DEFAULT,
   FRAME_BORDER_WIDTH_DEFAULT,
   HOUSE_GRADIENT,
+  LAYOUT_FRAME_FIELDS,
   LOOK_KINDS,
   MINIMAL_BAR_THEMES,
   MOTION_DELTA,
@@ -7494,11 +7609,13 @@ export {
   PLAYBACK_ACTIVITY,
   PROGRAM_RETIME,
   REJECT_OVERLAP,
+  REST_TILT_ID,
   SCENE_MOTION,
   SCENE_QUIET,
   SPEED_RATE_MAX,
   SPEED_RATE_MIN,
   SPEED_SPAN_MIN,
+  STAGE_CLIP_PREFIX,
   STUDIO_ENTRY_ID,
   STYLE_FIELDS,
   TEXT3D_DEPTH_DEFAULT,
@@ -7560,6 +7677,7 @@ export {
   computeCardLayout,
   computeMicRms,
   computePeaks,
+  copyLayout,
   copyStyle,
   cropBox,
   cursorIdleFade,
@@ -7568,6 +7686,7 @@ export {
   destinationsForChannel,
   docCardLayout,
   docOutputDuration,
+  docRestTime,
   docToCropSpace,
   docToFullSpace,
   duckCurve,
@@ -7591,6 +7710,8 @@ export {
   isProgramDoc,
   isRecordingDoc,
   isRejected,
+  isStageClip,
+  layoutOf,
   levelForFocusFraction,
   lookFromBrand,
   lookKindForGround,
@@ -7640,6 +7761,7 @@ export {
   resolveOverlayStyle,
   resolveText3dAsset,
   resolveZoomStyle,
+  restLeanOf,
   sceneChanges,
   scrollRuns,
   setSpeedInRange,