@vosjs/studio-core 0.41.2 → 0.42.0

package/dist/index.d.ts

@@ -210,6 +210,12 @@ interface SpeedParams {
     scrollMin: number;
     /** Rate applied to scroll runs. */
     scrollRate: number;
+    /**
+     * Rate applied to a scripted `wait` or a hover's dwell in which nothing
+     * moved on screen: the flow's own pauses, read from the step timeline
+     * with the digest's activity as the witness.
+     */
+    stillRate: number;
 }
 /** Conservative defaults: only stretches nobody wants to watch in real time. */
 declare const DEFAULT_SPEED_PARAMS: SpeedParams;
@@ -227,6 +233,12 @@ declare function planAutoSpeed(track: readonly CursorEvent[], opts: {
     params?: Partial<SpeedParams>;
     /** Per-SOURCE-second motion bins (0..1) when a digest measured them. */
     activity?: readonly number[] | null;
+    /**
+     * The step timeline of a scripted take (`meta.steps`): the flow's own
+     * pauses become still spans when the activity witness says nothing
+     * moved in them.
+     */
+    steps?: readonly StepSpan[] | null;
 }): SpeedSpan[];
 /**
  * Scroll runs as [start, last] seconds — the same grouping the speed planner
@@ -560,6 +572,14 @@ interface StepSpan {
      * (a pin then reads the presses inside the step's window).
      */
     rect?: Rect;
+    /** The page the step left, origin and path only (never a query or a hash). */
+    url?: string;
+    /**
+     * The words of the element the step's `read` named, once the step had
+     * settled: trimmed, whitespace collapsed, at most 2 KB. The take's own
+     * payload, which a layer quotes instead of replaying the flow.
+     */
+    text?: string;
 }
 /** Everything the capture extension hands off to the studio. */
 interface RecordingArtifact {
@@ -2599,6 +2619,11 @@ interface PlanOptions {
     typingHold?: number;
     /** level floor for typing spans (a wide field still reads punchier). */
     typingMinLevel?: number;
+    /**
+     * The step timeline of a scripted take (`meta.steps`): one zoom per step
+     * where its presses share a window, never one per press.
+     */
+    steps?: readonly StepSpan[] | null;
 }
 /** One press (or ping) in seconds, with the target element when known. */
 interface Click {
@@ -2636,7 +2661,99 @@ interface PlanTiltOptions {
  */
 declare function planAutoTilt(zoom: readonly ZoomSpan[], segments: Segment[], options: PlanTiltOptions): TiltSpan[];
 
-type MomentKind = 'head' | 'tail' | 'click' | 'typing' | 'scroll' | 'dwell' | 'idle' | 'scene';
+/**
+ * The digest sees consequences: what a click or a typing run DID to the
+ * page. A press is one frame; the page's answer comes after it, a dialog
+ * opening, a 200 landing, a graph re-laying out, a card vanishing. The
+ * region that changed in the seconds after the step is a moment a cut can
+ * hold on, and a zoom can frame.
+ *
+ * Pure: the browser samples luma grids (the cli's digest page) at the
+ * step's end and a few beats after it; this module finds the changed
+ * region and keeps the sample that changed most. Two things keep it
+ * honest on a page that moves on its own. A sample a beat BEFORE the step
+ * gives each cell its own drift, and only what moved past that drift
+ * counts (`ambientDrift`). And a change is judged by the blocks it FILLS,
+ * not by the cells it touches: a silk or a shimmer flickers cells all over
+ * the frame and fills no block, while a dialog, a recoloured pane or a
+ * status line fills its own.
+ */
+
+/** A luma grid of the frame at one instant, row-major, `w × h` cells. */
+interface LumaGrid {
+    w: number;
+    h: number;
+    luma: ArrayLike<number>;
+}
+/** What changed between two grids: the largest cluster of blocks that filled, and its box. */
+interface ChangedRegion {
+    /** The cluster's share of the frame's blocks, 0..1. */
+    fraction: number;
+    /** The cluster's bounding box, normalized frame fractions. */
+    rect: NormRect;
+}
+/** The grid the browser samples: coarse enough that a cursor is one cell, a dialog a block. */
+declare const CHANGE_GRID: {
+    readonly w: 128;
+    readonly h: 72;
+};
+/** The floor a change must clear to be named: 2% of the frame's blocks. */
+declare const CHANGE_FLOOR = 0.02;
+/** How long after a seed the digest looks for its consequence, source seconds. */
+declare const CHANGE_OFFSETS: readonly [0.3, 0.8, 1.5, 2.5];
+/** How long before a seed the ambient sample is taken, source seconds. */
+declare const CHANGE_LEAD = 0.5;
+/**
+ * The changed region between two grids, or null when nothing (or fewer
+ * than `minBlocks`) filled. `delta` is the luma step a cell must move by,
+ * the digest's own motion delta. `ambient`, when given, is what each cell
+ * moves by on its own (see `ambientDrift`) and how long after `before`
+ * this grid was taken: a cell counts only when it moved past what its own
+ * drift explains over that time. A block is `block` cells a side (the
+ * grid's sixteenth by default: 16 × 9 blocks over the sampled grid).
+ */
+declare function changedRegion(before: LumaGrid, after: LumaGrid, delta: number, minBlocks?: number, ambient?: {
+    rate: ArrayLike<number>;
+    dt: number;
+} | null, block?: number): ChangedRegion | null;
+/**
+ * How much each cell moves on its own, per second: a page whose background
+ * animates (a silk, a video, a shimmer) changes everywhere every frame, and
+ * the consequence of a press would drown in it. Two grids taken BEFORE the
+ * seed, `lead` seconds apart, give each cell its drift; `changedRegion`
+ * then counts a cell only when it moved past what that drift explains.
+ */
+declare function ambientDrift(earlier: LumaGrid, before: LumaGrid, lead: number): number[] | null;
+/** One sample after a seed: when it was taken and what had changed by then. */
+interface ChangeSample {
+    /** Source seconds after the seed. */
+    dt: number;
+    region: ChangedRegion | null;
+}
+/** A consequence the digest will name: a moment's seed and the region it changed. */
+interface ChangeWitness {
+    /** The seed moment's id (a click or a typing run). */
+    seed: string;
+    /** Source second the seed ended at: the frame the change is measured from. */
+    at: number;
+    /** Source second of the sample that had changed most. */
+    peakAt: number;
+    fraction: number;
+    rect: NormRect;
+}
+/**
+ * The witness for one seed: the sample that changed most, when it clears
+ * the floor. A consequence that never clears it is no moment, and a seed
+ * that changed everything (a navigation) is the scene detector's.
+ */
+declare function pickChange(seed: {
+    id: string;
+    at: number;
+}, samples: readonly ChangeSample[], floor?: number): ChangeWitness | null;
+
+type MomentKind = 'head' | 'tail' | 'click' | 'typing'
+/** What a click or a typing run DID: the region of the page that answered it. */
+ | 'changed' | 'scroll' | 'dwell' | 'idle' | 'scene';
 /** A rect in normalized [0..1] frame fractions (the zoom cx/cy convention). */
 interface NormRect {
     x: number;
@@ -2686,6 +2803,8 @@ interface Moment {
     };
     /** Transcript text over the window, when a transcript was merged. */
     said: string | null;
+    /** A `changed` moment: the click or typing moment it answers. */
+    seed?: string;
 }
 interface DigestPlan {
     zoom: ZoomSpan[];
@@ -2706,6 +2825,11 @@ interface MomentsOptions {
     transcript?: readonly TranscriptSegment[] | null;
     /** Idle threshold (seconds); defaults to the speed planner's. */
     idleMin?: number;
+    /**
+     * What the clicks and typing runs did to the page, measured by the
+     * digest's decode pass (see changes.ts): each becomes a `changed` moment.
+     */
+    changes?: readonly ChangeWitness[];
 }
 /**
  * The three planners, run fresh under the doc's own style — the proposals.
@@ -3292,6 +3416,33 @@ interface DigestTakeFacts {
     /** Masks the script asked for, with how many elements each reached. */
     masks: NonNullable<RecordingMeta['masks']>;
 }
+/**
+ * One script step as the digest tells it: when it ran in the footage and
+ * in the cut, the page it left and the words its `read` kept, so an agent
+ * places a layer by the table and quotes the take by the text.
+ */
+interface DigestStep {
+    step: number;
+    id: string | null;
+    do: string;
+    selector: string | null;
+    /** Footage seconds the step occupied. */
+    source: {
+        in: number;
+        out: number;
+    };
+    /** The same window in the cut, null when trimmed away. */
+    output: {
+        in: number;
+        out: number;
+    } | null;
+    skipped: boolean;
+    navigated: boolean;
+    /** The page after the step, origin and path; null on a human recording. */
+    url: string | null;
+    /** The words the step's `read` kept, or null. */
+    text: string | null;
+}
 interface Digest {
     digestVersion: number;
     take: DigestTakeFacts;
@@ -3306,6 +3457,8 @@ interface Digest {
         crop: string | null;
         box: PxRect | null;
     })[];
+    /** The script's steps (a CLI take; empty for a human recording). */
+    steps: DigestStep[];
     activity: number[] | null;
     plan: DigestPlan;
     doc: {
@@ -5228,4 +5381,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 AnimSide, 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, CALLOUT_DEFAULT_BODY_PX, CALLOUT_SHAPES, CALLOUT_TYPE_RATIO, CAMERA_CENTRE_RAMP, CAMERA_COVER_MIN, 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_HOLD_MS, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, CLUSTER_FILL, 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 CalloutBox, type CalloutClipOptions, type CalloutLook, type CalloutRegister, type CalloutShape, type CalloutWords, type CamBubbleRect, type CamPoseSpan, type CamStyle, type CameraModel, 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, DESIGN_FRAME_WIDTH, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, DRAG_MIN_S, DRAG_MIN_TRAVEL_FRAC, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocSegment, type Drag, 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, FOOTAGE_FRAME_STYLE, 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, HOLD_DRIFT_MAX, HOUSE_GRADIENT, HOUSE_REGISTER, HTML_LAYER_FOREIGN_FIELDS, HTML_LAYER_MAX_BYTES, HTML_LAYER_SVG_CODE, HTML_LAYER_WARN_BYTES, HTML_STARTERS, type HtmlLayerFace, type HtmlLayerInlineFace, type HtmlLayerPayload, type HtmlLayerProblem, type HtmlLayerProblemCode, type HtmlLayerSource, type HtmlOverlayClip, type HtmlOverlayFont, type HtmlStarter, IDLE_KINDS, type IdleKind, type IngestOptions, LAYER_CARD_SHADOW, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayerCard, 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, MEDIA_KEY_PREFIX, 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 OverlayPin, type OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PIN_GAP, PIN_MARGIN, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, PROGRAM_RETIME, PUMP_REST, type PinCandidate, type PinCarry, type PinMark, type PinPlacement, type PinPlacementInput, type PinReferent, type PinSide, type PinSideResolved, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REST_TILT_ID, RETIRED_ZOOM_STYLES, type RecordingArtifact, type RecordingMeta, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, type Rgb, SCENE_MOTION, SCENE_QUIET, SEGMENT_ENTER_KINDS, SEGMENT_EXIT_KINDS, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STILL_DEFAULT, STUDIO_ENTRY_ID, STYLE_FIELDS, type SegmentExtent, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, type StyledText, 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_SECONDS, TRANSITION_SECONDS_MAX, TRANSITION_SECONDS_MIN, 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 TraceFileKind, type TraceOptions, type TraceResult, type TranscriptSegment, type Transition, type TransitionKind, type TransitionMove, type TransitionOut, 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 ZipEntry, type ZoomScreen, type ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomView, type ZoomWindow, anchorKindOf, anchorSourceDuration, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, boldWeightFor, buildDigest, calloutBox, calloutClip, calloutGroundOf, calloutLook, calloutSource, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cameraCentring, cameraModel, cardEnter, cardExit, cardFields, cardInset, cardPointToScreen, cardPoseTrack, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cssFamilies, cssWeights, cursorFromCsv, cursorFromPlaywrightTrace, cursorFromRecords, cursorFromTrace, cursorIdleFade, deltaE, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFreezes, docMediaList, docOutputDuration, docRestTime, docStillTime, docToCropSpace, docToFullSpace, docTransitions, docZoomTrack, dragsFromTrack, dropTemplate, duckCurve, effectiveSegments, endCardClips, enterKey, enterOf, entranceAt, entranceEnd, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, findStep, focusBounds, focusForViewportCentre, followFocusEvents, frameGeometry, freezeLane, freezeOutputExtents, hexToRgb, hexToRgbTriplet, houseLook, htmlLayerBleed, htmlLayerBleedFor, htmlLayerFaces, htmlLayerKey, htmlLayerLabel, htmlLayerPayload, htmlLayerPictureBox, htmlLayerProblems, htmlLayerSvg, htmlLayerText, htmlLayerUnhostedFamilies, htmlLayerWidth, htmlStarterClip, idleGaps, idleKey, isKeyedOverlay, isLookKind, isLoweredRecording, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layerMedia, layoutOf, levelForFocusFraction, liveZoomStyleName, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, marksEmphasis, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaRef, mediaRefId, mediaSource, micLane, migrateHostedDoc, migrateMotion, migrateText, migrateTextClip, migrateZoomStyle, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayPinPoseAt, overlayPlainText, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parseCssColour, parsePoseId, pickStyle, pinBox, pinCandidates, pinPlacement, pinRectOnScreen, pinReferent, pinReferentAt, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, playwrightTraceEntry, programDuration, programStillTime, projectFromArtifact, pumpFreeChainGap, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, relativeLuminance, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolvePins, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, rgbToHex, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, snapRunWeight, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, styledTextOf, textRunsOf, tiltLane, tiltTrackFromDoc, traceKindOf, transitionMult, transitionSeconds, unionFitLevel, unionRect, videoLane, voiceKey, wellFormedXml, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zipEntries, zipEntryBytes, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomView, zoomViewport, zoomWindow };
+export { ASPECT_RATIOS, AUDIO_PLAN_STEP, type AnchorKind, type Anim, type AnimKind, type AnimSide, 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, CALLOUT_DEFAULT_BODY_PX, CALLOUT_SHAPES, CALLOUT_TYPE_RATIO, CAMERA_CENTRE_RAMP, CAMERA_COVER_MIN, 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, CHANGE_FLOOR, CHANGE_GRID, CHANGE_LEAD, CHANGE_OFFSETS, CHANNEL_SPECS_HASH, CHANNEL_SPECS_VERIFIED, CLICK_FX_INTENSITY, CLICK_FX_PRE, CLICK_HIGHLIGHT_FADE, CLICK_HOLD_MS, CLICK_PAIR_MAX, CLICK_PULSE_DUR, CLICK_RECT_MAX_FRAC, CLICK_RIPPLE_DUR, CLICK_SYNTH_RELEASE, CLUSTER_FILL, 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 CalloutBox, type CalloutClipOptions, type CalloutLook, type CalloutRegister, type CalloutShape, type CalloutWords, type CamBubbleRect, type CamPoseSpan, type CamStyle, type CameraModel, type CaptureNormalization, type CardLayout, type ChangeSample, type ChangeWitness, type ChangedRegion, 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, DESIGN_FRAME_WIDTH, DESTINATIONS, DIGEST_CROP_MAX, DIGEST_FULL_MAX, DIGEST_VERSION, DOC_SCHEMA_VERSION, DRAG_FIT_LEVEL, DRAG_MIN_S, DRAG_MIN_TRAVEL_FRAC, type Destination, type Digest, type DigestImageRef, type DigestPlan, type DigestTakeFacts, type DocSegment, type Drag, 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, FOOTAGE_FRAME_STYLE, 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, HOLD_DRIFT_MAX, HOUSE_GRADIENT, HOUSE_REGISTER, HTML_LAYER_FOREIGN_FIELDS, HTML_LAYER_MAX_BYTES, HTML_LAYER_SVG_CODE, HTML_LAYER_WARN_BYTES, HTML_STARTERS, type HtmlLayerFace, type HtmlLayerInlineFace, type HtmlLayerPayload, type HtmlLayerProblem, type HtmlLayerProblemCode, type HtmlLayerSource, type HtmlOverlayClip, type HtmlOverlayFont, type HtmlStarter, IDLE_KINDS, type IdleKind, type IngestOptions, LAYER_CARD_SHADOW, LAYOUT_FRAME_FIELDS, LOOK_KINDS, type LayerCard, type LayoutParts, type Look, type LookBrand, type LookKind, type LookPlacement, type LowerProgramOptions, type LoweredAudioClip, type LoweredClick, type LoweredComposition, type LoweredZoomSpan, type LumaGrid, MEDIA_ENTER_KINDS, MEDIA_EXIT_KINDS, MEDIA_FRAME_KEYS, MEDIA_KEY_PREFIX, 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 OverlayPin, type OverlayPresetStyle, type OverlayRect, type OverlayTransform, type OverlayTransition, PIN_GAP, PIN_MARGIN, PLATE_GROUND, PLAYBACK_ACTIVITY, PRIMARY_MEDIA, PROGRAM_RETIME, PUMP_REST, type PinCandidate, type PinCarry, type PinMark, type PinPlacement, type PinPlacementInput, type PinReferent, type PinSide, type PinSideResolved, type PlanOptions, type PlanTiltOptions, type PlaneSize, type ProgramAnchorDoc, type ProgramTweenEdit, type ProjectDoc, type PxRect, REJECT_OVERLAP, REST_TILT_ID, RETIRED_ZOOM_STYLES, type RecordingArtifact, type RecordingMeta, type Rect, type RejectedLane, type RejectedSpan, type ResolvedOverlayBox, type ResolvedOverlayStyle, type Rgb, SCENE_MOTION, SCENE_QUIET, SEGMENT_ENTER_KINDS, SEGMENT_EXIT_KINDS, SPEED_RATE_MAX, SPEED_RATE_MIN, SPEED_SPAN_MIN, STAGE_CLIP_PREFIX, STILL_DEFAULT, STUDIO_ENTRY_ID, STYLE_FIELDS, type SegmentExtent, type SmoothOptions, type SmoothPoint, type SpeedParams, type SpeedSpan, type StepAnchor, type StepSpan, type StudioAudioPlan, type StudioDoc, type StudioEntry, type StyleField, type StyledText, 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_SECONDS, TRANSITION_SECONDS_MAX, TRANSITION_SECONDS_MIN, 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 TraceFileKind, type TraceOptions, type TraceResult, type TranscriptSegment, type Transition, type TransitionKind, type TransitionMove, type TransitionOut, 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 ZipEntry, type ZoomScreen, type ZoomSpan, type ZoomStyleName, type ZoomStyleParams, type ZoomView, type ZoomWindow, ambientDrift, anchorKindOf, anchorSourceDuration, animStep, applyLook, applyTemplate, aspectRatioValue, audioLane, backdropMedia, boldWeightFor, buildDigest, calloutBox, calloutClip, calloutGroundOf, calloutLook, calloutSource, camBubbleRect, camBubbleRectAt, camLane, camMoveLane, camRectFromPose, camRestPose, camTrackFromDoc, cameraCentring, cameraModel, cardEnter, cardExit, cardFields, cardInset, cardPointToScreen, cardPoseTrack, changedRegion, clampCamFrac, clampCamSize, clampFocus, clampFreezeSeconds, clampSpeedRate, clampTiltDeg, clampZoomLevel, clipEnvelope, clipLength, clipsFrom, computeCardLayout, computeMicRms, computePeaks, copyLayout, copyStyle, cropBox, cssFamilies, cssWeights, cursorFromCsv, cursorFromPlaywrightTrace, cursorFromRecords, cursorFromTrace, cursorIdleFade, deltaE, deriveViewportCrop, destinationById, destinationsForChannel, docCardLayout, docFreezes, docMediaList, docOutputDuration, docRestTime, docStillTime, docToCropSpace, docToFullSpace, docTransitions, docZoomTrack, dragsFromTrack, dropTemplate, duckCurve, effectiveSegments, endCardClips, enterKey, enterOf, entranceAt, entranceEnd, entranceSeconds, envelopeAt, envelopeValueAt, exitKey, exitOf, exitSeconds, expandEndCard, expectedFrameSize, exportSizeFor, extractClicks, findStep, focusBounds, focusForViewportCentre, followFocusEvents, frameGeometry, freezeLane, freezeOutputExtents, hexToRgb, hexToRgbTriplet, houseLook, htmlLayerBleed, htmlLayerBleedFor, htmlLayerFaces, htmlLayerKey, htmlLayerLabel, htmlLayerPayload, htmlLayerPictureBox, htmlLayerProblems, htmlLayerSvg, htmlLayerText, htmlLayerUnhostedFamilies, htmlLayerWidth, htmlStarterClip, idleGaps, idleKey, isKeyedOverlay, isLookKind, isLoweredRecording, isMusicBed, isPlayback, isProgramDoc, isRecordingDoc, isRejected, isStageClip, isUnitStep, lastLayerEnd, layerMedia, layoutOf, levelForFocusFraction, liveZoomStyleName, lookFromBrand, lookKindForGround, lowerProgramDoc, lowerStudioDoc, lowerToComposition, marksEmphasis, mediaAtOutput, mediaDuration, mediaFrame, mediaKey, mediaRef, mediaRefId, mediaSource, micLane, migrateHostedDoc, migrateMotion, migrateText, migrateTextClip, migrateZoomStyle, momentsFromDoc, motionTrack, musicBedClip, nextMediaId, normalizeCaptureSpace, objectMotionBase, objectMotionPoseAt, objectsLane, outputDurationOf, outputEnd, outputRangeToSource, overlapFraction, overlayFaceFor, overlayFontFaces, overlayFontString, overlayFxSpec, overlayHit, overlayLines, overlayMotionBase, overlayMotionPoseAt, overlayPinPoseAt, overlayPlainText, overlayRect, overlaysLane, ownFreezes, pageDisplayUrl, parseCssColour, parsePoseId, pickChange, pickStyle, pinBox, pinCandidates, pinPlacement, pinRectOnScreen, pinReferent, pinReferentAt, placeFreezes, planAutoSpeed, planAutoTilt, planAutoZoom, planForDigest, planeSizeAtDepth, platformBarKind, playwrightTraceEntry, programDuration, programStillTime, projectFromArtifact, pumpFreeChainGap, ratedSegments, recommendedExportResolution, refillAudioBeds, rejectSpan, relativeLuminance, removeSourceRange, removeSpeedInRange, resolveExportSize, resolveOverlayBox, resolveOverlayStyle, resolvePins, resolveText3dAsset, resolveZoomStyle, restLeanOf, restSpansThroughTransitions, rgbToHex, sameMedia, sceneChanges, scrollRuns, segmentOutputExtents, outputLen as segmentOutputLen, segmentStarts, setSpeedInRange, slideSide, smoothCursor, snapRunWeight, spanOutputExtent, speedLane, studioAudioPlan, studioEntry, studioLayerData, styledTextOf, textRunsOf, tiltLane, tiltTrackFromDoc, traceKindOf, transitionMult, transitionSeconds, unionFitLevel, unionRect, videoLane, voiceKey, wellFormedXml, withBackdrop, withFreezes, withHolds, withoutRejected, wrapProgramLength, zipEntries, zipEntryBytes, zoomCoversRect, zoomLane, zoomSpanForRange, zoomTrackFromDoc, zoomView, zoomViewport, zoomWindow };

package/dist/index.js

@@ -3403,6 +3403,13 @@ var TYPING_CLICK_ABSORB = 1.5;
 var TYPING_REFOCUS_FRAC = 0.08;
 function groupTrack(track, opts) {
   const { width, height, clusterGap, typingGap, typingZoom, targetFill } = opts;
+  const stepOf = (t) => opts.steps?.find(
+    (st) => st.do !== "wait" && !st.skipped && st.tStart <= t && t <= st.tEnd
+  ) ?? null;
+  const sameStep = (a, b) => {
+    const sa = stepOf(a.t);
+    return sa !== null && sa === stepOf(b.t);
+  };
   const minLevel = opts.minLevel ?? resolveZoomStyle().minLevel;
   const clicks = dedupePresses(
     track.filter((e) => e.type === "down")
@@ -3436,7 +3443,7 @@ function groupTrack(track, opts) {
     for (const c of list) {
       const last = clusters.at(-1);
       const prev = last?.at(-1);
-      const joins = last && prev && c.t - prev.t <= clusterGap && (!spatial || unionFitLevel(unionRect([...last, c]), width, height) >= minLevel);
+      const joins = last && prev && (c.t - prev.t <= clusterGap || sameStep(prev, c)) && (!spatial || unionFitLevel(unionRect([...last, c]), width, height) >= minLevel);
       if (joins) last.push(c);
       else clusters.push([c]);
     }
@@ -3515,7 +3522,8 @@ function planAutoZoom(track, options) {
     typingGap,
     typingZoom,
     targetFill,
-    minLevel
+    minLevel,
+    steps: options.steps
   });
   const { sessions } = grouped;
   const drags = dragsFromTrack(track, width, height);
@@ -3630,10 +3638,11 @@ function planAutoZoom(track, options) {
   const spans = within([...zSpans, ...kSpans, ...dragSpans]).sort(
     (a, b) => a.in - b.in
   );
+  const firstStep = options.steps?.find((st) => !st.skipped)?.tStart;
   const dwells = dwellSpans(track, width, height, maxLevel, [
     ...spans,
     ...dragReserved
-  ]);
+  ]).filter((d) => firstStep === void 0 || d.out > firstStep);
   return within([...spans, ...dwells]).sort((a, b) => a.in - b.in);
 }
 function typingSessions(track, width, height, typingGap) {
@@ -9238,13 +9247,15 @@ var DEFAULT_SPEED_PARAMS = {
   typingMin: 3,
   typingRate: 3,
   scrollMin: 2.5,
-  scrollRate: 2
+  scrollRate: 2,
+  stillRate: 2
 };
 var TYPING_GAP = 1.5;
 var SCROLL_GAP = 0.8;
 var IDLE_PAD = 0.6;
 var MIN_SPAN = 1;
 var PLAYBACK_ACTIVITY = 0.1;
+var STILL_ACTIVITY = 0.02;
 function planAutoSpeed(track, opts) {
   const p = { ...DEFAULT_SPEED_PARAMS, ...opts.params };
   const durS = opts.durationMs / 1e3;
@@ -9263,6 +9274,9 @@ function planAutoSpeed(track, opts) {
     p.scrollMin,
     (start, last) => cands.push({ in: start, out: last, rate: p.scrollRate })
   );
+  for (const [a, b] of stillSteps(opts.steps, opts.activity)) {
+    if (b - a >= MIN_SPAN) cands.push({ in: a, out: b, rate: p.stillRate });
+  }
   for (const [a, b] of idleGaps(evs, durS, p.idleMin)) {
     if (isPlayback(opts.activity, a, b)) continue;
     const start = a + IDLE_PAD;
@@ -9316,6 +9330,29 @@ function idleGaps(track, durationS, idleMin = DEFAULT_SPEED_PARAMS.idleMin) {
   if (durationS - prev >= idleMin) gaps.push([prev, durationS]);
   return gaps;
 }
+function stillSteps(steps, activity) {
+  if (!steps?.length || !activity?.length) return [];
+  const live = steps.filter((st) => !st.skipped);
+  const doing = live.map((st) => st.do !== "wait");
+  const first = doing.indexOf(true);
+  const last = doing.lastIndexOf(true);
+  const out = [];
+  for (const [i, st] of live.entries()) {
+    if (st.do !== "wait" && st.do !== "hover") continue;
+    if (st.do === "wait" && (first < 0 || i < first || i > last)) continue;
+    if (meanActivity(activity, st.tStart, st.tEnd) >= STILL_ACTIVITY) continue;
+    out.push([st.tStart, st.tEnd]);
+  }
+  return out;
+}
+function meanActivity(activity, a, b) {
+  const lo = Math.max(0, Math.floor(a));
+  const hi = Math.min(activity.length, Math.ceil(b));
+  if (hi <= lo) return 0;
+  let sum = 0;
+  for (let i = lo; i < hi; i++) sum += activity[i];
+  return sum / (hi - lo);
+}
 function isPlayback(activity, a, b) {
   if (!activity?.length) return false;
   const lo = Math.max(0, Math.floor(a));
@@ -9354,12 +9391,14 @@ function planForDigest(doc, activity) {
     width: meta.width,
     height: meta.height,
     style: doc.zoomStyle,
-    params: doc.zoomParams
+    params: doc.zoomParams,
+    steps: meta.steps
   });
   const speed = planAutoSpeed(cursor, {
     durationMs: meta.durationMs,
     params: doc.speedParams,
-    activity
+    activity,
+    steps: meta.steps
   });
   const style = resolveZoomStyle(doc.zoomStyle, doc.zoomParams);
   const intensity = doc.tiltStyle ?? style.tilt.intensity;
@@ -9399,7 +9438,8 @@ function momentsFromDoc(doc, plan, opts = {}) {
       typingGap: style.typingGap,
       typingZoom: style.typingZoom,
       targetFill: style.targetFill,
-      minLevel: style.minLevel
+      minLevel: style.minLevel,
+      steps: meta.steps
     });
     const pressed = (c, surface) => {
       const f = clusterFocus(c, width, height);
@@ -9495,15 +9535,30 @@ function momentsFromDoc(doc, plan, opts = {}) {
       rect: null
     });
   }
+  for (const c of opts.changes ?? []) {
+    if (!(c.at >= 0 && c.at < dur)) continue;
+    const peak = Math.min(dur, Math.max(c.at, c.peakAt));
+    drafts.push({
+      kind: "changed",
+      in: c.at,
+      out: peak,
+      at: peak,
+      focus: { cx: c.rect.x + c.rect.w / 2, cy: c.rect.y + c.rect.h / 2 },
+      rect: c.rect,
+      seedAt: c.at,
+      fraction: c.fraction
+    });
+  }
   const order = {
     head: 0,
     click: 1,
     typing: 2,
-    scroll: 3,
-    dwell: 4,
-    scene: 5,
-    idle: 6,
-    tail: 7
+    changed: 3,
+    scroll: 4,
+    dwell: 5,
+    scene: 6,
+    idle: 7,
+    tail: 8
   };
   drafts.sort((a, b) => a.in - b.in || order[a.kind] - order[b.kind]);
   const rated = ratedSegments(doc);
@@ -9512,8 +9567,17 @@ function momentsFromDoc(doc, plan, opts = {}) {
     return spanOutputExtent(rated, lo, Math.max(b, lo + 1e-3));
   };
   const covers = (s, d) => d.in === d.out ? s.in <= d.in && d.in < s.out : s.in < d.out && s.out > d.in;
+  const ids = drafts.map((_, i) => `m${String(i + 1).padStart(2, "0")}`);
+  const seedOf = (d) => {
+    if (d.kind !== "changed" || d.seedAt === void 0) return void 0;
+    const j = drafts.findIndex(
+      (x) => x.kind === "click" && x.at === d.seedAt || x.kind === "typing" && x.out === d.seedAt
+    );
+    return j >= 0 ? ids[j] : void 0;
+  };
   return drafts.map((d, i) => {
     const output = outputOf(d.in, d.out);
+    const seed = seedOf(d);
     const outAt = d.at === null ? null : outputOf(d.at, d.at);
     const proposed = {};
     const z = plan.zoom.find((s) => covers(s, d));
@@ -9523,7 +9587,7 @@ function momentsFromDoc(doc, plan, opts = {}) {
     const tl = plan.tilt.find((s) => covers(s, d));
     if (tl) proposed.tilt = tl.id;
     return {
-      id: `m${String(i + 1).padStart(2, "0")}`,
+      id: ids[i],
       kind: d.kind,
       source: { in: round10(d.in), out: round10(d.out) },
       output: output ? { in: round10(output.start), out: round10(output.end) } : null,
@@ -9539,9 +9603,10 @@ function momentsFromDoc(doc, plan, opts = {}) {
       ...d.clicks !== void 0 ? { clicks: d.clicks } : {},
       ...d.surface ? { surface: true } : {},
       ...d.pings !== void 0 ? { pings: d.pings } : {},
-      activity: activityOf(opts.bins, d),
+      activity: d.kind === "changed" && d.fraction !== void 0 ? round10(d.fraction) : activityOf(opts.bins, d),
       proposed,
-      said: saidOver(opts.transcript, d)
+      said: saidOver(opts.transcript, d),
+      ...seed ? { seed } : {}
     };
   });
 }
@@ -9568,6 +9633,105 @@ function round10(v) {
   return Math.round(v * 1e3) / 1e3;
 }
 
+// src/digest/changes.ts
+var CHANGE_GRID = { w: 128, h: 72 };
+var BLOCK_FILL = 0.5;
+var CHANGE_FLOOR = 0.02;
+var CHANGE_OFFSETS = [0.3, 0.8, 1.5, 2.5];
+var CHANGE_LEAD = 0.5;
+function changedRegion(before, after, delta, minBlocks = 1, ambient = null, block = Math.max(1, Math.round(before.w / 16))) {
+  const { w, h } = before;
+  if (after.w !== w || after.h !== h || w <= 0 || h <= 0) return null;
+  const cols = Math.ceil(w / block);
+  const rows = Math.ceil(h / block);
+  const moved = new Uint16Array(cols * rows);
+  const cells = new Uint16Array(cols * rows);
+  for (let y = 0; y < h; y++) {
+    const by = Math.floor(y / block);
+    for (let x = 0; x < w; x++) {
+      const i = y * w + x;
+      const b = by * cols + Math.floor(x / block);
+      cells[b]++;
+      const drift = ambient ? ambient.rate[i] * ambient.dt : 0;
+      if (Math.abs(after.luma[i] - before.luma[i]) - drift > delta) moved[b]++;
+    }
+  }
+  const filled = new Uint8Array(cols * rows);
+  for (let b = 0; b < filled.length; b++)
+    if (moved[b] >= cells[b] * BLOCK_FILL) filled[b] = 1;
+  const seen = new Uint8Array(cols * rows);
+  let best = null;
+  for (let start = 0; start < filled.length; start++) {
+    if (!filled[start] || seen[start]) continue;
+    const stack = [start];
+    seen[start] = 1;
+    let size = 0;
+    let minX = cols;
+    let minY = rows;
+    let maxX = -1;
+    let maxY = -1;
+    while (stack.length) {
+      const b = stack.pop();
+      size++;
+      const bx = b % cols;
+      const by = Math.floor(b / cols);
+      if (bx < minX) minX = bx;
+      if (bx > maxX) maxX = bx;
+      if (by < minY) minY = by;
+      if (by > maxY) maxY = by;
+      for (const [dx, dy] of [
+        [1, 0],
+        [-1, 0],
+        [0, 1],
+        [0, -1]
+      ]) {
+        const nx = bx + dx;
+        const ny = by + dy;
+        if (nx < 0 || ny < 0 || nx >= cols || ny >= rows) continue;
+        const n = ny * cols + nx;
+        if (filled[n] && !seen[n]) {
+          seen[n] = 1;
+          stack.push(n);
+        }
+      }
+    }
+    if (!best || size > best.size) best = { size, minX, minY, maxX, maxY };
+  }
+  if (!best || best.size < minBlocks) return null;
+  return {
+    fraction: best.size / (cols * rows),
+    rect: {
+      x: best.minX * block / w,
+      y: best.minY * block / h,
+      w: Math.min(w, (best.maxX + 1) * block) / w - best.minX * block / w,
+      h: Math.min(h, (best.maxY + 1) * block) / h - best.minY * block / h
+    }
+  };
+}
+function ambientDrift(earlier, before, lead) {
+  const { w, h } = before;
+  if (earlier.w !== w || earlier.h !== h || !(lead > 0)) return null;
+  const rate = new Array(w * h);
+  for (let i = 0; i < rate.length; i++)
+    rate[i] = Math.abs(before.luma[i] - earlier.luma[i]) / lead;
+  return rate;
+}
+function pickChange(seed, samples, floor = CHANGE_FLOOR) {
+  let best = null;
+  for (const s of samples) {
+    if (!s.region || s.region.fraction < floor) continue;
+    if (!best || s.region.fraction > (best.region?.fraction ?? 0)) best = s;
+  }
+  if (!best?.region) return null;
+  return {
+    seed: seed.id,
+    at: seed.at,
+    peakAt: seed.at + best.dt,
+    fraction: best.region.fraction,
+    rect: best.region.rect
+  };
+}
+
 // src/digest/scenes.ts
 var SCENE_MOTION = 0.25;
 var SCENE_QUIET = 0.1;
@@ -10099,6 +10263,7 @@ function buildDigest(input) {
       activity: "fraction of pixels that changed, per SOURCE second"
     },
     moments: withFiles,
+    steps: digestSteps(doc),
     activity: input.bins,
     plan: input.plan,
     doc: {
@@ -10122,6 +10287,26 @@ function buildDigest(input) {
     }
   };
 }
+function digestSteps(doc) {
+  const steps = doc.source.meta.steps ?? [];
+  if (!steps.length) return [];
+  const rated = ratedSegments(doc);
+  return steps.map((s) => {
+    const out = spanOutputExtent(rated, s.tStart, s.tEnd);
+    return {
+      step: s.step,
+      id: s.id ?? null,
+      do: s.do,
+      selector: s.selector ?? null,
+      source: { in: round11(s.tStart), out: round11(s.tEnd) },
+      output: out ? { in: round11(out.start), out: round11(out.end) } : null,
+      skipped: s.skipped === true,
+      navigated: s.navigated === true,
+      url: s.url ?? null,
+      text: s.text ?? null
+    };
+  });
+}
 function outputDurationOf(doc) {
   return docOutputDuration(doc);
 }
@@ -11956,6 +12141,10 @@ export {
   CARD_FADE_SECONDS,
   CARD_FOV,
   CARD_Z,
+  CHANGE_FLOOR,
+  CHANGE_GRID,
+  CHANGE_LEAD,
+  CHANGE_OFFSETS,
   CHANNEL_SPECS_HASH,
   CHANNEL_SPECS_VERIFIED,
   CLICK_FX_INTENSITY,
@@ -12105,6 +12294,7 @@ export {
   ZOOM_SPAN_MIN,
   ZOOM_STYLES,
   ZOOM_STYLE_OPTIONS,
+  ambientDrift,
   anchorKindOf,
   anchorSourceDuration,
   animStep,
@@ -12137,6 +12327,7 @@ export {
   cardPoseTrack,
   caretAt,
   caretStops,
+  changedRegion,
   clampCamFrac,
   clampCamSize,
   clampFocus,
@@ -12289,6 +12480,7 @@ export {
   pageDisplayUrl,
   parseCssColour,
   parsePoseId,
+  pickChange,
   pickStyle,
   pinBox,
   pinCandidates,