@pixerate/flair 0.24.0 → 0.26.0

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { C as ControlValue, a as ControlDef } from './controls-Ec6P0Vpy.js';
-export { c as ControlCheck, b as ControlType, T as TextureSettings, d as checkControlValue, e as coerceControlValue, f as componentCount, g as controlValue, h as describeValue, i as hexToRgb, j as humanise, k as imageUrls, l as isImageUrl, p as parseColor, m as parseControls, r as rgbToHex } from './controls-Ec6P0Vpy.js';
-import { L as LiveSource } from './renderer-C2P1qGzP.js';
-export { B as BUILTIN_UNIFORMS, C as CompileError, b as CompileResult, a as CompileStatus, c as CompiledShader, F as FrameState, I as ImageLoadError, R as RendererStats, S as SVG_EDGE, d as ShaderCompileError, e as ShaderRenderer, f as ShaderRendererOptions, T as TextureCache, g as TextureSource, V as VERTEX_SOURCE, h as applyTextureSettings, i as compileShader, j as createContext, k as drawFrame, l as formatCompileError, m as isSvgUrl, n as loadImage, p as parseCompileLog, o as preloadImages, r as releaseImages, q as resetGlCaches, s as seekVideo, t as sizeSvg, w as wrapSource } from './renderer-C2P1qGzP.js';
+import { C as ControlValue } from './controls-Ec6P0Vpy.js';
+export { c as ControlCheck, a as ControlDef, b as ControlType, T as TextureSettings, d as checkControlValue, e as coerceControlValue, f as componentCount, g as controlValue, h as describeValue, i as hexToRgb, j as humanise, k as imageUrls, l as isImageUrl, p as parseColor, m as parseControls, r as rgbToHex } from './controls-Ec6P0Vpy.js';
+export { B as BUILTIN_UNIFORMS, C as CompileError, b as CompileResult, a as CompileStatus, c as CompiledShader, F as FrameState, I as ImageLoadError, L as LiveSource, R as RendererStats, d as SVG_EDGE, e as ShaderCompileError, S as ShaderRenderer, f as ShaderRendererOptions, T as TextureCache, g as TextureSource, V as VERTEX_SOURCE, h as applyTextureSettings, i as compileShader, j as createContext, k as drawFrame, l as formatCompileError, m as isSvgUrl, n as loadImage, p as parseCompileLog, o as preloadImages, r as releaseImages, q as resetGlCaches, s as seekVideo, t as sizeSvg, w as wrapSource } from './renderer-teaa98RE.js';
+export { H as HOVER_SECONDS, M as MAX_CLICKS, a as MAX_TRAIL, P as PointerTracker, R as RenderOptions, S as ShaderClick, b as ShaderFrames, c as ShaderFramesOptions, T as TRAIL_SECONDS, d as clicksUniform, t as trailUniform } from './frames-VEcqa40g.js';
 import { C as Clock } from './svg-BhRboN9q.js';
 export { A as AnimateCountOptions, D as DataKey, E as EASES, c as EaseName, M as ManualClock, d as SCRAMBLE_MS, e as STEP_MS, f as SVG_PICTURE, g as SvgAnimation, h as SvgBox, i as SvgElementFrame, S as SvgMotion, b as SvgPlayer, j as SvgPlayerOptions, a as SvgTrigger, k as SvgView, l as SvgViewOptions, m as animateCount, n as defaultDataKey, o as formatCount, p as jitter, q as lerpAttr, r as lerpData, s as pageHidden, t as parseSvg, u as realClock, v as stepData, w as stepProgress, x as stepStart, y as svgDuration, z as svgFrame, B as svgMotionIssues, F as svgOpeningTag, G as svgView, H as writtenText } from './svg-BhRboN9q.js';
-export { BoxAlignment, BoxFit, FittedBoxResult, FormatUnitOptions, MorphOptions, StackLayoutOptions, SvgFrameMarkupOptions, SvgInlineLayout, UnitFormat, computeBoxFit, formatUnit, layoutStack, morphPaths, morphSequence, parseViewBox, remap, stepVariant, svgFrameMarkup, svgInlineLayout, svgViewBox } from './vector/index.js';
+export { AnimatedSvgOptions, BoxAlignment, BoxFit, FittedBoxResult, FormatUnitOptions, MorphOptions, StackLayoutOptions, SvgFrameMarkupOptions, SvgInlineLayout, UnitFormat, computeBoxFit, formatUnit, layoutStack, morphPaths, morphSequence, parseViewBox, remap, stepVariant, svgAnimatedMarkup, svgFrameMarkup, svgInlineLayout, svgViewBox } from './vector/index.js';
 
 /** Controls a registered thumbnail. */
 interface ThumbnailHandle {
@@ -84,163 +84,6 @@ declare function sharedThumbnailPool(): ThumbnailPool;
 /** Registers a thumbnail with the shared pool. See {@link ThumbnailPool.register}. */
 declare function registerThumbnail(canvas: HTMLCanvasElement, source: string, values?: Record<string, ControlValue>, onStatus?: (ok: boolean) => void): ThumbnailHandle;
 
-/**
- * The pointer as shaders see it, beyond Shadertoy's `iMouse`: where it is
- * while it is over the canvas, how hovered the canvas is (eased in and out),
- * how long it has been pressed, the last few clicks, and where it has just
- * been (its trail), so effects can answer hovers, presses, taps and moves.
- * Times are in `iTime` seconds, so a recording can script them (see
- * `ShaderFrames`' `pointer`, `clicks` and `trail`).
- */
-/** How many clicks `iClicks` holds; older ones drop off. */
-declare const MAX_CLICKS = 8;
-/** How many of the pointer's recent positions `iTrail` holds; older ones drop off. */
-declare const MAX_TRAIL = 32;
-/**
- * The least time between two positions in the trail, in seconds: moves in
- * between update the newest. With {@link MAX_TRAIL}, about a second of path.
- */
-declare const TRAIL_SECONDS: number;
-/** How long hovering eases in or out, in seconds. */
-declare const HOVER_SECONDS = 0.25;
-/** A click, or a point of the trail: where (pixels from the bottom left, like `iMouse`) and when (`iTime` seconds). */
-interface ShaderClick {
-    x: number;
-    y: number;
-    time: number;
-}
-/**
- * `iClicks` from a list of clicks, newest first: `vec4(x, y, time, 1)` for
- * each click at or before `time`, zeros for the rest.
- */
-declare function clicksUniform(clicks: readonly ShaderClick[], time: number): Float32Array;
-/**
- * `iTrail` from the pointer's positions, oldest first in the list: the
- * newest {@link MAX_TRAIL} at or before `time`, newest first, as
- * `vec4(x, y, time, 1)`, zeros for the rest.
- */
-declare function trailUniform(trail: readonly ShaderClick[], time: number): Float32Array;
-/**
- * Follows one canvas's pointer for `iPointer` and `iClicks`: feed it pointer
- * events with the `iTime` they happen at, and read the uniforms for a frame.
- */
-declare class PointerTracker {
-    private x;
-    private y;
-    private over;
-    private hoverFrom;
-    private changedAt;
-    private pressedAt;
-    private releasedAt;
-    private clicks;
-    private trail;
-    /**
-     * The pointer moved to (x, y), in pixels from the bottom left. With a
-     * `time`, the move joins the trail: a new point at most every
-     * {@link TRAIL_SECONDS}, the newest point following the pointer between.
-     */
-    move(x: number, y: number, time?: number): void;
-    /** The pointer came over the canvas (`true`) or left it. */
-    hover(over: boolean, time: number): void;
-    /** A press at (x, y): counts as a click. */
-    down(x: number, y: number, time: number): void;
-    up(time: number): void;
-    /** Forgets clicks, presses and the trail (when time jumps back, say). */
-    clear(): void;
-    /** How hovered the canvas is at `time`, 0–1, eased. */
-    hovered(time: number): number;
-    /**
-     * `iPointer` at `time`: x, y, how hovered (0–1), and the press: seconds
-     * held while pressed, minus the seconds since it was let go after, 0
-     * before the first press.
-     */
-    pointer(time: number): [number, number, number, number];
-    /** `iClicks` at `time` (see {@link clicksUniform}). */
-    clicksAt(time: number): Float32Array;
-    /** `iTrail` at `time` (see {@link trailUniform}). */
-    trailAt(time: number): Float32Array;
-}
-
-interface ShaderFramesOptions {
-    source: string;
-    values?: Record<string, ControlValue>;
-    width: number;
-    height: number;
-    /** Draw on this canvas instead of a new, detached one. It is resized to `width` × `height`. */
-    canvas?: HTMLCanvasElement;
-    /** Keep the shader's alpha (`fragColor.a`) in the frames, for transparent recordings (default false: opaque). */
-    alpha?: boolean;
-}
-interface RenderOptions {
-    /** `iFrame` (default: the number of frames rendered so far). */
-    frame?: number;
-    /** `iTimeDelta` in seconds (default: the time since the previous `render`, else 0). */
-    delta?: number;
-    /** `iMouse` (default: all zero, as on a page nobody has touched). */
-    mouse?: [number, number, number, number];
-    /** `iPointer`: x, y, how hovered (0–1), the press (seconds held, or minus seconds since release; default all zero). */
-    pointer?: [number, number, number, number];
-    /** Clicks so far, for `iClicks` (the latest `MAX_CLICKS` at or before the frame's time count). */
-    clicks?: readonly ShaderClick[];
-    /** Where the pointer has been, oldest first, for `iTrail` (the latest `MAX_TRAIL` at or before the frame's time count). */
-    trail?: readonly ShaderClick[];
-}
-/**
- * Renders a shader at exact times you choose, off screen. There is no
- * animation loop and no clock: frame `n` of a recording at `fps` is
- * `render(start + n / fps)`, so the output is the same on any machine. It
- * suits recorders, video pipelines and anything else stepped by its own
- * clock. The constructor throws a {@link ShaderCompileError} when the source
- * does not compile.
- *
- * Image controls load in the background: `await frames.ready()` before the
- * first `render`, or the frames show black where the images go.
- *
- * A video in an image control (see `setLiveSource`) is drawn at whatever
- * frame it is on. To step it with the shader, seek it first: `await
- * seekVideo(video, t); frames.render(t)`.
- */
-declare class ShaderFrames {
-    readonly canvas: HTMLCanvasElement;
-    readonly width: number;
-    readonly height: number;
-    readonly controls: ControlDef[];
-    private gl;
-    private shader;
-    private textures;
-    private values;
-    private rendered;
-    private lastTime;
-    private pixels;
-    constructor(options: ShaderFramesOptions);
-    /** Changes control values for the frames that follow. */
-    setValues(values: Record<string, ControlValue> | undefined): void;
-    /**
-     * Draws a `<video>` (or a canvas) in the image control `name` instead of
-     * its URL, at the frame it is on when `render` runs; `null` goes back to
-     * the URL. See `ShaderRenderer.setLiveSource`.
-     */
-    setLiveSource(name: string, source: LiveSource | null): void;
-    /**
-     * Settles once every image the controls show has loaded, and every live
-     * video has a frame. Rejects with an {@link ImageLoadError} when one
-     * cannot be.
-     */
-    ready(): Promise<void>;
-    /** Draws the frame at `time` seconds onto `canvas`. */
-    render(time: number, options?: RenderOptions): void;
-    /**
-     * The last rendered frame as RGBA bytes, rows top down (as in `ImageData`;
-     * WebGL itself reads bottom up). Pass `out` to reuse a buffer of
-     * `width * height * 4` bytes.
-     */
-    readPixels(out?: Uint8Array | Uint8ClampedArray): Uint8Array | Uint8ClampedArray;
-    /** Releases the GL context now rather than at garbage collection (browsers cap live contexts). */
-    dispose(): void;
-    private syncTextures;
-    private context;
-}
-
 interface GifOptions {
     source: string;
     values?: Record<string, ControlValue>;
@@ -859,6 +702,32 @@ declare function motionBlur(from: View, to: View, stage: Stage, strength: number
 declare function motionBlurAngle(from: View, to: View, stage: Stage): number | undefined;
 /** The blur fields of a step of a camera move with this strength: `{ blur, blurAngle }`, or nothing when still. */
 declare function moveBlur(from: View, to: View, stage: Stage, strength: number): Pick<View, 'blur' | 'blurAngle'>;
+/**
+ * How the camera gets into a shot (`ShotCamera.transition`):
+ * - `move` (the default) eases from the last framing to the new one.
+ * - `whip` whips off the last framing toward the new one in a streak of
+ *   motion blur and whips in onto it, cutting at the blurriest moment.
+ * - `zoom` punches into the last framing, blurring every way, and settles
+ *   out of a punched-in new one, cutting halfway.
+ * - `cut` jumps straight to the new framing, taking no time.
+ */
+type CameraTransition = 'move' | 'whip' | 'zoom' | 'cut';
+declare const CAMERA_TRANSITIONS: readonly CameraTransition[];
+/** The motion blur a whip or zoom uses when the shot does not set `motionBlur`. */
+declare const TRANSITION_BLUR = 2;
+/** The blur strength a transition plays with: the shot's `motionBlur`, or {@link TRANSITION_BLUR} for a whip or zoom without one. */
+declare function transitionStrength(kind: CameraTransition, motionBlur: number | undefined): number;
+/** The steps a camera move is played in; its blur is measured over one. */
+declare const CAMERA_STEPS = 15;
+/**
+ * The camera `u` (0 to 1) of the way through a transition from one view to
+ * another (see {@link CameraTransition}), with its motion blur measured over
+ * the step before (1/{@link CAMERA_STEPS} of the move). `strength` is the
+ * blur (`ShotCamera.motionBlur`; see {@link transitionStrength}) and, for a
+ * zoom, how far it punches in: to (1 + strength) × at the cut. Settled on
+ * `to`, with no blur, from `u` = 1 (and at once for a cut).
+ */
+declare function transitionView(kind: CameraTransition, from: View, to: View, u: number, stage: Stage, strength: number): View;
 /** The part of the scene the camera currently shows. */
 declare function visibleRect(view: View, stage: Stage): Rect;
 /** Smooth cubic ease in / ease out. */
@@ -1143,6 +1012,14 @@ interface CameraLens extends CameraAngle {
      * speed, so it peaks mid-move and is gone when the camera settles.
      */
     motionBlur?: number;
+    /**
+     * How the camera gets into this shot: `move` (the default) eases across,
+     * `whip` whip-pans off the last framing and onto this one, `zoom` punches
+     * in and cuts to this one settling out, and `cut` jumps straight here
+     * (see `CameraTransition`). A whip or zoom blurs at `motionBlur` 2 unless
+     * the shot sets one; a zoom punches in to (1 + motionBlur) ×.
+     */
+    transition?: CameraTransition;
 }
 /**
  * Where the camera goes for a shot: a framing box, a dynamic framing, or
@@ -1196,11 +1073,15 @@ interface CameraShot {
     holdMs: number;
     from: View;
     to: View;
-    /** The shot's `camera.motionBlur` (0 for none). */
+    /** How the camera gets into the shot (`camera.transition`, `move` by default). */
+    transition: CameraTransition;
+    /** The blur strength the move plays with: `camera.motionBlur`, or 2 for a whip or zoom without one (0 for none). */
     motionBlur: number;
     /** The elements on stage once the shot's commands have run. */
     elements: SceneElement[];
 }
+/** How long the camera moves at the start of a shot, in ms: none for the first shot, a shot without a camera, or a cut. */
+declare function shotMoveMs(shot: Shot, index: number): number;
 /** The scene's stage with defaults filled in. */
 declare function sceneStage(scene: Scene): Stage;
 /**
@@ -1216,6 +1097,8 @@ declare const CAMERA_STEP_MS: number;
  * motion blur) or settled.
  */
 declare function cameraAt(entry: CameraShot, ms: number, stage: Stage): View;
+/** Whether the shot's move jumps from one framing to the other halfway (a whip or zoom). */
+declare const cutsHalfway: (entry: CameraShot) => boolean;
 /** The camera at one frame of a scene's timeline. */
 interface CameraSample {
     frame: number;
@@ -1726,4 +1609,4 @@ declare function exportFcp7Xml(scene: Scene, options?: Fcp7ExportOptions): strin
  */
 declare function exportCmx3600Edl(scene: Scene, options?: EdlExportOptions): string;
 
-export { ALL_BLEND_MODES, ALL_TRANSITION_TYPES, type AgentToolDefinition, type AscCdl, type BatchCommand, type BatchExecutionResult, type BatchExecutionStepResult, type Behavior, type BehaviorBase, type BlendMode, type BlockDissolveOptions, type BlurEffect, type BurstEffect, CAMERA_MS, CAMERA_STEP_MS, COMMON_FRAME_RATES, type CameraAngle, type CameraLens, type CameraSample, type CameraShot, type ClearCommand, Clock, type ColorRGB, type ColorRGBA, type ColorRgba, type ColorSpace, ControlDef, ControlValue, type CounterEffect, type CrossZoomOptions, type CustomCommand, DEFAULT_PERSPECTIVE, DEFAULT_STAGE, type DeleteCommand, type DynamicFraming, EASY_EASE, EFFECT_FADE_MS, EFFECT_TYPES, type EasingCurve, type EdlExportOptions, type Effect, type EffectBase, type ElementCommand, FLAIR_AGENT_TOOLS, type Fcp7ExportOptions, type FlowEffect, type FramingOptions, type GifOptions, type GlassWipeOptions, type GlowEffect, type GradientEffect, type GridWipeOptions, HOVER_SECONDS, type HighlightEffect, type KeyframeEase, type LiftGammaGain, type LightLeakOptions, type LinearWipeOptions, LiveSource, type LottieAnimatable, type LottieAnimation, type LottieExportOptions, type LottieKeyframe, type LottieLayer, type LottieShapeItem, type LottieTransform, MAX_CLICKS, MAX_TILT, MAX_TRAIL, type MediaEffect, MemorySceneBoard, type MotnExportOptions, NO_CHECK, type OscillateBehavior, type OvershootBehavior, type PathWaypoint, type PlayOptions, type PlayResult, type Point, PointerTracker, type PopupWidget, type RadialIrisOptions, type RampBehavior, type RateBehavior, type RationalFrameRate, type Rect, type RenderOptions, type ReplicatorConfig, type ReplicatorPattern, type ReplicatorSequence, type Review, type ReviewOptions, type RigWidget, type RippleEffect, type RunningEffect, SMALL_TEXT_PX, type SMPTEFields, type Scene, type SceneBoard, type SceneCommand, type SceneElement, type SceneIssue, type SceneMedia, type SceneOutline, type SceneOutlineShot, type SceneRig, type SceneToolResult, type ShaderClick, ShaderFrames, type ShaderFramesOptions, type ShimmerEffect, type Shot, type ShotCamera, type ShotCheck, type ShotLog, type ShotTiming, type SliderSnapshot, type SliderWidget, type SpatialMotionPath, type SpatialPathSample, type SpotlightEffect, type Stage, type StandaloneOptions, type StandardFrameRateKey, TRAIL_SECONDS, type ThrowBehavior, type ThumbnailHandle, ThumbnailPool, type ThumbnailPoolOptions, type TimerEffect, type ToggleWidget, type TransitionOptions, type TransitionSample, type TransitionType, type TwisterOptions, type UpdateCommand, type Vec2, type Vec3, type View, type WriggleBehavior, applyAscCdl, applyLiftGammaGain, applyRig, applySceneBatch, applySceneTool, applyVibrance, areaOf, between, bez1d, bez1dDerivative, blendRgba, blendTransitionPixel, boardHeight, boundsOf, calculateFramingRect, calculateShotTimings, cameraAngle, cameraAt, cameraBlur, cameraFilter, cameraSamples, cameraTrack, cameraTransform, centreOf, checkShot, clicksUniform, convertColorSpace, createFrameRate, createLottieEase, createMotionPath, easeInOutCubic, easeProgress, effectGone, effectOpacity, evaluateBehavior, evaluateKeyframeSegment, expandReplicator, exportCmx3600Edl, exportFcp7Xml, exportLottie, exportMotn, formatTimecode, fractalWiggle, frame, framesToSMPTE, framesToTimecode, getColorGradingGLSL, getDropFrameCount, getGlslBlendFunction, getOklabGLSL, getTimecodeBase, getTransitionGLSL, getWhiteBalanceGains, hash64, holdTime, interpolateOklab, interpolateOklch, isAngled, isDeleteCommand, isElementCommand, isUpdateCommand, linearRgbToSrgb, linearSrgbToOklab, linearToSrgb, loopTime, mixSeeds, motionBlur, motionBlurAngle, moveBlur, noise1d, noise3d, oklabToLinearSrgb, oklabToOklch, oklabToSrgb, oklchToOklab, overlapArea, parseTimecode, pingPongTime, playScene, projectPoint, quinticFade, recordGif, registerThumbnail, reviewScene, sampleMotionPath, sampleMotionPathAtTime, sampleTransition, sceneStage, screenBox, setRigWidget, sharedThumbnailPool, shotView, simulateScene, smpteToFrames, solveBezierU, speedRampTime, srgbToLinear, srgbToLinearRgb, srgbToOklab, standaloneHtml, standaloneSceneHtml, strobeTime, substituteVariables, supportsDropFrame, timecodeToFrames, titleBox, touchedIds, trailUniform, unitFloat, validateScene, viewAt, visibleRect };
+export { ALL_BLEND_MODES, ALL_TRANSITION_TYPES, type AgentToolDefinition, type AscCdl, type BatchCommand, type BatchExecutionResult, type BatchExecutionStepResult, type Behavior, type BehaviorBase, type BlendMode, type BlockDissolveOptions, type BlurEffect, type BurstEffect, CAMERA_MS, CAMERA_STEPS, CAMERA_STEP_MS, CAMERA_TRANSITIONS, COMMON_FRAME_RATES, type CameraAngle, type CameraLens, type CameraSample, type CameraShot, type CameraTransition, type ClearCommand, Clock, type ColorRGB, type ColorRGBA, type ColorRgba, type ColorSpace, ControlValue, type CounterEffect, type CrossZoomOptions, type CustomCommand, DEFAULT_PERSPECTIVE, DEFAULT_STAGE, type DeleteCommand, type DynamicFraming, EASY_EASE, EFFECT_FADE_MS, EFFECT_TYPES, type EasingCurve, type EdlExportOptions, type Effect, type EffectBase, type ElementCommand, FLAIR_AGENT_TOOLS, type Fcp7ExportOptions, type FlowEffect, type FramingOptions, type GifOptions, type GlassWipeOptions, type GlowEffect, type GradientEffect, type GridWipeOptions, type HighlightEffect, type KeyframeEase, type LiftGammaGain, type LightLeakOptions, type LinearWipeOptions, type LottieAnimatable, type LottieAnimation, type LottieExportOptions, type LottieKeyframe, type LottieLayer, type LottieShapeItem, type LottieTransform, MAX_TILT, type MediaEffect, MemorySceneBoard, type MotnExportOptions, NO_CHECK, type OscillateBehavior, type OvershootBehavior, type PathWaypoint, type PlayOptions, type PlayResult, type Point, type PopupWidget, type RadialIrisOptions, type RampBehavior, type RateBehavior, type RationalFrameRate, type Rect, type ReplicatorConfig, type ReplicatorPattern, type ReplicatorSequence, type Review, type ReviewOptions, type RigWidget, type RippleEffect, type RunningEffect, SMALL_TEXT_PX, type SMPTEFields, type Scene, type SceneBoard, type SceneCommand, type SceneElement, type SceneIssue, type SceneMedia, type SceneOutline, type SceneOutlineShot, type SceneRig, type SceneToolResult, type ShimmerEffect, type Shot, type ShotCamera, type ShotCheck, type ShotLog, type ShotTiming, type SliderSnapshot, type SliderWidget, type SpatialMotionPath, type SpatialPathSample, type SpotlightEffect, type Stage, type StandaloneOptions, type StandardFrameRateKey, TRANSITION_BLUR, type ThrowBehavior, type ThumbnailHandle, ThumbnailPool, type ThumbnailPoolOptions, type TimerEffect, type ToggleWidget, type TransitionOptions, type TransitionSample, type TransitionType, type TwisterOptions, type UpdateCommand, type Vec2, type Vec3, type View, type WriggleBehavior, applyAscCdl, applyLiftGammaGain, applyRig, applySceneBatch, applySceneTool, applyVibrance, areaOf, between, bez1d, bez1dDerivative, blendRgba, blendTransitionPixel, boardHeight, boundsOf, calculateFramingRect, calculateShotTimings, cameraAngle, cameraAt, cameraBlur, cameraFilter, cameraSamples, cameraTrack, cameraTransform, centreOf, checkShot, convertColorSpace, createFrameRate, createLottieEase, createMotionPath, cutsHalfway, easeInOutCubic, easeProgress, effectGone, effectOpacity, evaluateBehavior, evaluateKeyframeSegment, expandReplicator, exportCmx3600Edl, exportFcp7Xml, exportLottie, exportMotn, formatTimecode, fractalWiggle, frame, framesToSMPTE, framesToTimecode, getColorGradingGLSL, getDropFrameCount, getGlslBlendFunction, getOklabGLSL, getTimecodeBase, getTransitionGLSL, getWhiteBalanceGains, hash64, holdTime, interpolateOklab, interpolateOklch, isAngled, isDeleteCommand, isElementCommand, isUpdateCommand, linearRgbToSrgb, linearSrgbToOklab, linearToSrgb, loopTime, mixSeeds, motionBlur, motionBlurAngle, moveBlur, noise1d, noise3d, oklabToLinearSrgb, oklabToOklch, oklabToSrgb, oklchToOklab, overlapArea, parseTimecode, pingPongTime, playScene, projectPoint, quinticFade, recordGif, registerThumbnail, reviewScene, sampleMotionPath, sampleMotionPathAtTime, sampleTransition, sceneStage, screenBox, setRigWidget, sharedThumbnailPool, shotMoveMs, shotView, simulateScene, smpteToFrames, solveBezierU, speedRampTime, srgbToLinear, srgbToLinearRgb, srgbToOklab, standaloneHtml, standaloneSceneHtml, strobeTime, substituteVariables, supportsDropFrame, timecodeToFrames, titleBox, touchedIds, transitionStrength, transitionView, unitFloat, validateScene, viewAt, visibleRect };

package/dist/index.js

@@ -1,56 +1,5 @@
-import {
-  calculateShotTimings,
-  createLottieEase,
-  exportCmx3600Edl,
-  exportFcp7Xml,
-  exportLottie,
-  exportMotn,
-  framesToTimecode,
-  timecodeToFrames
-} from "./chunk-GTIAOYOK.js";
-import {
-  computeBoxFit,
-  formatUnit,
-  layoutStack,
-  remap,
-  stepVariant
-} from "./chunk-VP6IEWIK.js";
-import {
-  parseViewBox,
-  svgFrameMarkup,
-  svgInlineLayout,
-  svgViewBox
-} from "./chunk-LVPIIWPP.js";
-import {
-  EASES,
-  SCRAMBLE_MS,
-  STEP_MS,
-  SVG_PICTURE,
-  SvgPlayer,
-  animateCount,
-  defaultDataKey,
-  formatCount,
-  lerpAttr,
-  lerpData,
-  parseSvg,
-  stepData,
-  stepProgress,
-  stepStart,
-  svgDuration,
-  svgFrame,
-  svgMotionIssues,
-  svgOpeningTag,
-  svgView,
-  writtenText
-} from "./chunk-PFGGPIMT.js";
-import {
-  morphPaths,
-  morphSequence
-} from "./chunk-OHW7UG6D.js";
 import {
   ALL_BLEND_MODES,
-  ShaderFrames,
-  ShaderRenderer,
   ThumbnailPool,
   blendRgba,
   getGlslBlendFunction,
@@ -60,10 +9,22 @@ import {
   standaloneHtml,
   standaloneSceneHtml,
   validateScene
-} from "./chunk-NGKNI3QX.js";
+} from "./chunk-CK6EV37I.js";
+import {
+  calculateShotTimings,
+  createLottieEase,
+  exportCmx3600Edl,
+  exportFcp7Xml,
+  exportLottie,
+  exportMotn,
+  framesToTimecode,
+  timecodeToFrames
+} from "./chunk-74ZLCZOG.js";
 import {
   CAMERA_MS,
+  CAMERA_STEPS,
   CAMERA_STEP_MS,
+  CAMERA_TRANSITIONS,
   DEFAULT_PERSPECTIVE,
   DEFAULT_STAGE,
   EFFECT_FADE_MS,
@@ -72,6 +33,7 @@ import {
   MemorySceneBoard,
   NO_CHECK,
   SMALL_TEXT_PX,
+  TRANSITION_BLUR,
   areaOf,
   between,
   boardHeight,
@@ -86,6 +48,7 @@ import {
   cameraTransform,
   centreOf,
   checkShot,
+  cutsHalfway,
   easeInOutCubic,
   effectGone,
   effectOpacity,
@@ -110,14 +73,58 @@ import {
   reviewScene,
   sceneStage,
   screenBox,
+  shotMoveMs,
   shotView,
   simulateScene,
   titleBox,
   touchedIds,
+  transitionStrength,
+  transitionView,
   unitFloat,
   viewAt,
   visibleRect
-} from "./chunk-WAMA45G3.js";
+} from "./chunk-5USSDEQL.js";
+import {
+  applyAscCdl,
+  applyLiftGammaGain,
+  applyVibrance,
+  convertColorSpace,
+  getColorGradingGLSL,
+  getOklabGLSL,
+  getWhiteBalanceGains,
+  interpolateOklab,
+  interpolateOklch,
+  linearRgbToSrgb,
+  linearSrgbToOklab,
+  linearToSrgb,
+  oklabToLinearSrgb,
+  oklabToOklch,
+  oklabToSrgb,
+  oklchToOklab,
+  srgbToLinear,
+  srgbToLinearRgb,
+  srgbToOklab
+} from "./chunk-DBTLCXKY.js";
+import {
+  computeBoxFit,
+  formatUnit,
+  layoutStack,
+  remap,
+  stepVariant
+} from "./chunk-H6L67KHI.js";
+import {
+  svgAnimatedMarkup
+} from "./chunk-YBGRXVAE.js";
+import {
+  parseViewBox,
+  svgFrameMarkup,
+  svgInlineLayout,
+  svgViewBox
+} from "./chunk-STKEKXCK.js";
+import {
+  ShaderFrames,
+  ShaderRenderer
+} from "./chunk-H6VDFBIO.js";
 import {
   BUILTIN_UNIFORMS,
   HOVER_SECONDS,
@@ -130,54 +137,29 @@ import {
   TRAIL_SECONDS,
   TextureCache,
   VERTEX_SOURCE,
-  applyAscCdl,
-  applyLiftGammaGain,
   applyTextureSettings,
-  applyVibrance,
   clicksUniform,
   compileShader,
-  convertColorSpace,
   createContext,
   drawFrame,
   formatCompileError,
-  getColorGradingGLSL,
-  getOklabGLSL,
-  getWhiteBalanceGains,
-  interpolateOklab,
-  interpolateOklch,
   isSvgUrl,
-  linearRgbToSrgb,
-  linearSrgbToOklab,
-  linearToSrgb,
   loadImage,
-  oklabToLinearSrgb,
-  oklabToOklch,
-  oklabToSrgb,
-  oklchToOklab,
   parseCompileLog,
   preloadImages,
   releaseImages,
   resetGlCaches,
   seekVideo,
   sizeSvg,
-  srgbToLinear,
-  srgbToLinearRgb,
-  srgbToOklab,
   trailUniform,
   wrapSource
-} from "./chunk-ARKC7LDW.js";
+} from "./chunk-RDU63CDO.js";
 import {
   ALL_TRANSITION_TYPES,
   blendTransitionPixel,
   getTransitionGLSL,
   sampleTransition
 } from "./chunk-EHDJ3CPJ.js";
-import {
-  ManualClock,
-  jitter,
-  pageHidden,
-  realClock
-} from "./chunk-WMZQCUFJ.js";
 import {
   checkControlValue,
   coerceControlValue,
@@ -192,6 +174,38 @@ import {
   parseControls,
   rgbToHex
 } from "./chunk-VYOMXE6I.js";
+import {
+  EASES,
+  SCRAMBLE_MS,
+  STEP_MS,
+  SVG_PICTURE,
+  SvgPlayer,
+  animateCount,
+  defaultDataKey,
+  formatCount,
+  lerpAttr,
+  lerpData,
+  parseSvg,
+  stepData,
+  stepProgress,
+  stepStart,
+  svgDuration,
+  svgFrame,
+  svgMotionIssues,
+  svgOpeningTag,
+  svgView,
+  writtenText
+} from "./chunk-PFGGPIMT.js";
+import {
+  ManualClock,
+  jitter,
+  pageHidden,
+  realClock
+} from "./chunk-WMZQCUFJ.js";
+import {
+  morphPaths,
+  morphSequence
+} from "./chunk-ORAFCHX3.js";
 
 // src/time/retiming.ts
 function loopTime(t, duration, start = 0) {
@@ -867,7 +881,7 @@ var FLAIR_AGENT_TOOLS = [
       properties: {
         scene: {
           type: "object",
-          description: "Full Scene object with name, stage, media, and shots. A shot camera frames a box {x, y, width, height} or elements {frame: [ids]}, and may add tilt, turn, roll (degrees, tilt/turn up to 75), perspective (default 1.2) and motionBlur (0-3, 1 natural); angles persist until changed."
+          description: 'Full Scene object with name, stage, media, and shots. A shot camera frames a box {x, y, width, height} or elements {frame: [ids]}, and may add tilt, turn, roll (degrees, tilt/turn up to 75), perspective (default 1.2), motionBlur (0-3, 1 natural) and transition ("move" eases across, the default; "whip" whip-pans in; "zoom" punches through; "cut" jumps); angles persist until changed.'
         }
       },
       required: ["scene"],
@@ -1177,7 +1191,9 @@ export {
   ALL_TRANSITION_TYPES,
   BUILTIN_UNIFORMS,
   CAMERA_MS,
+  CAMERA_STEPS,
   CAMERA_STEP_MS,
+  CAMERA_TRANSITIONS,
   COMMON_FRAME_RATES,
   DEFAULT_PERSPECTIVE,
   DEFAULT_STAGE,
@@ -1205,6 +1221,7 @@ export {
   ShaderRenderer,
   SvgPlayer,
   TRAIL_SECONDS,
+  TRANSITION_BLUR,
   TextureCache,
   ThumbnailPool,
   VERTEX_SOURCE,
@@ -1247,6 +1264,7 @@ export {
   createFrameRate,
   createLottieEase,
   createMotionPath,
+  cutsHalfway,
   defaultDataKey,
   describeValue,
   drawFrame,
@@ -1339,6 +1357,7 @@ export {
   seekVideo,
   setRigWidget,
   sharedThumbnailPool,
+  shotMoveMs,
   shotView,
   simulateScene,
   sizeSvg,
@@ -1357,6 +1376,7 @@ export {
   strobeTime,
   substituteVariables,
   supportsDropFrame,
+  svgAnimatedMarkup,
   svgDuration,
   svgFrame,
   svgFrameMarkup,
@@ -1369,6 +1389,8 @@ export {
   titleBox,
   touchedIds,
   trailUniform,
+  transitionStrength,
+  transitionView,
   unitFloat,
   validateScene,
   viewAt,