onda-engine 0.1.0 → 0.2.0

package/dist/components.d.ts

@@ -1954,6 +1954,11 @@ interface ResponsiveTransform {
     y: number;
     scale: number;
 }
+/** Whether an element is a full-bleed background plate: image/video content whose rendered size
+ *  (content size × scale) covers ≥{@link FULL_BLEED} of BOTH design axes. Such plates must COVER
+ *  the output (scale by the LARGER axis ratio), never FIT it (the smaller ratio) — fitting a
+ *  background on an aspect flip (16:9 → 9:16) shrinks it to a band with dead space top and bottom. */
+declare function isFullBleed(props: Record<string, unknown> | undefined, design: Box): boolean;
 /** The representative design-space point an element "lives at" — the mean of its
  *  position track, nudged to the visual CENTRE of image content (whose pivot defaults
  *  to a corner). Returns `null` for elements with NO absolute position: those already
@@ -1969,6 +1974,12 @@ declare function responsiveEntryTransform(anchor: {
     x: number;
     y: number;
 } | null, design: Box, out: Box): ResponsiveTransform;
+/** COVER re-frame for a full-bleed plate ({@link isFullBleed}): uniformly scale the WHOLE design
+ *  canvas by the LARGER axis ratio and centre it on the output, so the plate keeps filling the
+ *  frame (overflowing the long axis) instead of fitting into a band with dead space. The translate
+ *  is anchor-independent — it just centres the scaled design canvas, preserving every element's
+ *  relative position within that plate. Matching canvas ⇒ identity. */
+declare function responsiveCoverTransform(design: Box, out: Box): ResponsiveTransform;
 
 /** The per-glyph entrance presets. */
 type KineticTextPreset = 'rise' | 'fade' | 'scale' | 'blur' | 'wave';
@@ -3477,4 +3488,4 @@ interface WordStaggerProps extends TextStyleProps {
 }
 declare function WordStagger({ text: textProp, fontSize, color: colorProp, width, fontFamily: fontFamilyProp, fontWeight, italic, letterSpacing, uppercase, justify, delay: delayIn, stagger: staggerIn, }: WordStaggerProps): react.JSX.Element;
 
-export { type AudioAnalyzer, AudioClip, type AudioClipProps, AudioVisualizer, type AudioVisualizerProps, BarChart, type BarChartDatum, type BarChartProps, type Beats, type BeatsHandle, BentoGrid, type BentoGridProps, type BentoItem, BlurReveal, type BlurRevealProps, BoundingBox, type BoundingBoxProps, type Box, BrowserFrame, type BrowserFrameProps, Button, type ButtonProps, COMPONENT_SETTLE, Callout, type CalloutDirection, type CalloutProps, CameraShake, type CameraShakeProps, type CaptionEntry, Captions, type CaptionsProps, CardShowcase, type CardShowcaseProps, ChapterCard, type ChapterCardProps, CodeBlock, type CodeBlockProps, CodeDiff, type CodeDiffProps, Confetti, type ConfettiProps, CountUp, type CountUpProps, Cursor, type CursorProps, DURATION, DeviceFrame, type DeviceFrameProps, type DiffLine, type DiffLineType, type Divergence, type DivergenceOpts, DrawOn, type DrawOnProps, type DurationToken, DynamicGrid, type DynamicGridProps, type Ease, type ElementSize, EndCard, type EndCardProps, type EntranceOptions, type EntranceType, FadeIn, type FadeInProps, FadeOut, type FadeOutProps, FilmGrade, type FilmGradeProps, type FilmLook, type FitOpts, type FitToClipOpts, type FontMetrics, type FrameSize, type GlyphCell, type GlyphInfo, type GlyphLine, type GlyphLineOpts, GradientShift, type GradientShiftProps, GrainOverlay, type GrainOverlayProps, HOUSE_EASE, Highlight, type HighlightProps, IconPop, type IconPopProps, type IconShape, ImageReveal, type ImageRevealFit, type ImageRevealMotion, type ImageRevealProps, InputField, type InputFieldProps, KanbanBoard, type KanbanBoardProps, type KanbanColumn, KenBurns, type KenBurnsProps, type KeyframeTracks, Keyframes, type KeyframesImageContent, type KeyframesProps, type KeyframesTextContent, KineticText, type KineticTextPreset, type KineticTextProps, LINE_RATIO, LineChart, type LineChartProps, LogoReveal, type LogoRevealPreset, type LogoRevealProps, LogoSting, type LogoStingProps, type LookbookLayout, LookbookShot, type LookbookShotProps, LowerThird, type LowerThirdProps, Marquee, type MarqueeProps, MaskReveal, type MaskRevealProps, MatrixDecode, type MatrixDecodeProps, type MeasureOpts, MeshGradient, type MeshGradientProps, Moodboard, type MoodboardProps, type Motion, NodeGraph, type NodeGraphProps, OVERSHOOT, PLACEMENT_DESCRIPTION, PLACEMENT_REGIONS, Parallax, type ParallaxLayer, type ParallaxProps, PathMorph, type PathMorphProps, type PatternInput, PieReveal, type PieRevealProps, type PieRevealSlice, Placed, type PlacedProps, type Placement, type PlacementPoint, type PlacementRegion, PlacementShift, type PlacementShiftProps, type PosKey, PriceTag, type PriceTagProps, PricingCard, type PricingCardProps, ProductWall, type ProductWallProps, ProgressBar, type ProgressBarProps, ProgressSteps, type ProgressStepsProps, PulsingIndicator, type PulsingIndicatorProps, QuoteCard, type QuoteCardProps, type RenderBackend, type ResolvedBounds, type ResolvedPlacement, type ResponsiveTransform, RgbGlitch, type RgbGlitchProps, RotateIn, type RotateInProps, SAFE_MARGIN, SPRING_SMOOTH, SPRING_SNAPPY, STAGGER, type SampledKeyframes, type Satellite, ScaleIn, type ScaleInProps, Scrim, type ScrimProps, type SettleFn, ShimmerSweep, type ShimmerSweepProps, SiteReveal, type SiteRevealProps, SkeletonCard, type SkeletonCardProps, SlideIn, type SlideInProps, SlideOut, type SlideOutProps, SlotMachineRoll, type SlotMachineRollProps, SplitLockup, type SplitLockupProps, SplitScreen, type SplitScreenProps, Spotlight, SpotlightCard, type SpotlightCardProps, type SpotlightProps, StaggerGroup, type StaggerGroupProps, StatCard, type StatCardProps, TIME_DESCRIPTION, Terminal, type TerminalProps, type TextAnimate, TextAnimator, type TextAnimatorDirection, type TextAnimatorProps, type TextAnimatorUnit, TextFadeReplace, type TextFadeReplaceProps, type TextMetrics, type Theme, ThemeProvider, type ThemeProviderProps, type TimeInput, Timeline, type TimelineEvent, type TimelineProps, TitleCard, type TitleCardProps, TrackingIn, type TrackingInProps, Typewriter, type TypewriterProps, Underline, type UnderlineProps, type ValKey, VideoClip, type VideoClipProps, Vignette, type VignetteProps, WordRotate, type WordRotateProps, WordStagger, type WordStaggerProps, beatPulse, defaultTheme, divergenceReport, entryDesignAnchor, entryFade, entryFadeRise, entryScale, entrySlide, exitFade, exitFadeFall, exitScale, exitSlide, fitFontSize, fitMaxWidth, fontMetrics, framesOf, framesSinceBeat, glyphLayout, hasKeyframeTracks, heroReveal, isBeat, isPlacement, layoutGlyphLine, lineStartX, lineTopY, loadFont, matchesExport, measureText, placementSchema, preloadTextMetrics, resolvePlacement, responsiveEntryTransform, sampleKeyframes, sampleTrack, settleTime, staggerFrames, staggeredSettle, stateSwap, timeSchema, useAudioBeats, useAudioData, useEntrance, useFittedFontSize, useFontMetrics, useGlyphLayout, usePlacement, useResolvedBounds, useSceneProgress, useSpringValue, useStaggeredEntrance, useTextMetrics, useTextMetricsReady, useTextReveal, useTheme, useTimeScale };
+export { type AudioAnalyzer, AudioClip, type AudioClipProps, AudioVisualizer, type AudioVisualizerProps, BarChart, type BarChartDatum, type BarChartProps, type Beats, type BeatsHandle, BentoGrid, type BentoGridProps, type BentoItem, BlurReveal, type BlurRevealProps, BoundingBox, type BoundingBoxProps, type Box, BrowserFrame, type BrowserFrameProps, Button, type ButtonProps, COMPONENT_SETTLE, Callout, type CalloutDirection, type CalloutProps, CameraShake, type CameraShakeProps, type CaptionEntry, Captions, type CaptionsProps, CardShowcase, type CardShowcaseProps, ChapterCard, type ChapterCardProps, CodeBlock, type CodeBlockProps, CodeDiff, type CodeDiffProps, Confetti, type ConfettiProps, CountUp, type CountUpProps, Cursor, type CursorProps, DURATION, DeviceFrame, type DeviceFrameProps, type DiffLine, type DiffLineType, type Divergence, type DivergenceOpts, DrawOn, type DrawOnProps, type DurationToken, DynamicGrid, type DynamicGridProps, type Ease, type ElementSize, EndCard, type EndCardProps, type EntranceOptions, type EntranceType, FadeIn, type FadeInProps, FadeOut, type FadeOutProps, FilmGrade, type FilmGradeProps, type FilmLook, type FitOpts, type FitToClipOpts, type FontMetrics, type FrameSize, type GlyphCell, type GlyphInfo, type GlyphLine, type GlyphLineOpts, GradientShift, type GradientShiftProps, GrainOverlay, type GrainOverlayProps, HOUSE_EASE, Highlight, type HighlightProps, IconPop, type IconPopProps, type IconShape, ImageReveal, type ImageRevealFit, type ImageRevealMotion, type ImageRevealProps, InputField, type InputFieldProps, KanbanBoard, type KanbanBoardProps, type KanbanColumn, KenBurns, type KenBurnsProps, type KeyframeTracks, Keyframes, type KeyframesImageContent, type KeyframesProps, type KeyframesTextContent, KineticText, type KineticTextPreset, type KineticTextProps, LINE_RATIO, LineChart, type LineChartProps, LogoReveal, type LogoRevealPreset, type LogoRevealProps, LogoSting, type LogoStingProps, type LookbookLayout, LookbookShot, type LookbookShotProps, LowerThird, type LowerThirdProps, Marquee, type MarqueeProps, MaskReveal, type MaskRevealProps, MatrixDecode, type MatrixDecodeProps, type MeasureOpts, MeshGradient, type MeshGradientProps, Moodboard, type MoodboardProps, type Motion, NodeGraph, type NodeGraphProps, OVERSHOOT, PLACEMENT_DESCRIPTION, PLACEMENT_REGIONS, Parallax, type ParallaxLayer, type ParallaxProps, PathMorph, type PathMorphProps, type PatternInput, PieReveal, type PieRevealProps, type PieRevealSlice, Placed, type PlacedProps, type Placement, type PlacementPoint, type PlacementRegion, PlacementShift, type PlacementShiftProps, type PosKey, PriceTag, type PriceTagProps, PricingCard, type PricingCardProps, ProductWall, type ProductWallProps, ProgressBar, type ProgressBarProps, ProgressSteps, type ProgressStepsProps, PulsingIndicator, type PulsingIndicatorProps, QuoteCard, type QuoteCardProps, type RenderBackend, type ResolvedBounds, type ResolvedPlacement, type ResponsiveTransform, RgbGlitch, type RgbGlitchProps, RotateIn, type RotateInProps, SAFE_MARGIN, SPRING_SMOOTH, SPRING_SNAPPY, STAGGER, type SampledKeyframes, type Satellite, ScaleIn, type ScaleInProps, Scrim, type ScrimProps, type SettleFn, ShimmerSweep, type ShimmerSweepProps, SiteReveal, type SiteRevealProps, SkeletonCard, type SkeletonCardProps, SlideIn, type SlideInProps, SlideOut, type SlideOutProps, SlotMachineRoll, type SlotMachineRollProps, SplitLockup, type SplitLockupProps, SplitScreen, type SplitScreenProps, Spotlight, SpotlightCard, type SpotlightCardProps, type SpotlightProps, StaggerGroup, type StaggerGroupProps, StatCard, type StatCardProps, TIME_DESCRIPTION, Terminal, type TerminalProps, type TextAnimate, TextAnimator, type TextAnimatorDirection, type TextAnimatorProps, type TextAnimatorUnit, TextFadeReplace, type TextFadeReplaceProps, type TextMetrics, type Theme, ThemeProvider, type ThemeProviderProps, type TimeInput, Timeline, type TimelineEvent, type TimelineProps, TitleCard, type TitleCardProps, TrackingIn, type TrackingInProps, Typewriter, type TypewriterProps, Underline, type UnderlineProps, type ValKey, VideoClip, type VideoClipProps, Vignette, type VignetteProps, WordRotate, type WordRotateProps, WordStagger, type WordStaggerProps, beatPulse, defaultTheme, divergenceReport, entryDesignAnchor, entryFade, entryFadeRise, entryScale, entrySlide, exitFade, exitFadeFall, exitScale, exitSlide, fitFontSize, fitMaxWidth, fontMetrics, framesOf, framesSinceBeat, glyphLayout, hasKeyframeTracks, heroReveal, isBeat, isFullBleed, isPlacement, layoutGlyphLine, lineStartX, lineTopY, loadFont, matchesExport, measureText, placementSchema, preloadTextMetrics, resolvePlacement, responsiveCoverTransform, responsiveEntryTransform, sampleKeyframes, sampleTrack, settleTime, staggerFrames, staggeredSettle, stateSwap, timeSchema, useAudioBeats, useAudioData, useEntrance, useFittedFontSize, useFontMetrics, useGlyphLayout, usePlacement, useResolvedBounds, useSceneProgress, useSpringValue, useStaggeredEntrance, useTextMetrics, useTextMetricsReady, useTextReveal, useTheme, useTimeScale };

package/dist/components.js

@@ -4762,7 +4762,19 @@ function Keyframes({
 
 // ../components/src/responsive.ts
 var EDGE = 0.2;
+var FULL_BLEED = 0.9;
 var mean = (ns) => ns.length ? ns.reduce((a, b) => a + b, 0) / ns.length : 0;
+function meanScale(props) {
+  const scaleTrack = props?.scale;
+  return Array.isArray(scaleTrack) && scaleTrack.length ? mean(scaleTrack.map((k) => k.v)) : 1;
+}
+function isFullBleed(props, design) {
+  const content = props?.content;
+  if (!content || content.kind !== "image" && content.kind !== "video") return false;
+  if (!content.width || !content.height) return false;
+  const s = meanScale(props);
+  return content.width * s >= FULL_BLEED * design.width && content.height * s >= FULL_BLEED * design.height;
+}
 function entryDesignAnchor(props) {
   const position = props?.position;
   if (!Array.isArray(position) || position.length === 0) return null;
@@ -4792,6 +4804,17 @@ function responsiveEntryTransform(anchor, design, out) {
   const ay = pinAxis(anchor.y, design.height, out.height, s);
   return { x: ax - anchor.x * s, y: ay - anchor.y * s, scale: s };
 }
+function responsiveCoverTransform(design, out) {
+  if (design.width === out.width && design.height === out.height) {
+    return { x: 0, y: 0, scale: 1 };
+  }
+  const s = Math.max(out.width / design.width, out.height / design.height);
+  return {
+    x: (out.width - design.width * s) / 2,
+    y: (out.height - design.height * s) / 2,
+    scale: s
+  };
+}
 var CLAMP5 = { extrapolateLeft: "clamp", extrapolateRight: "clamp" };
 function orderOf(i, n, direction) {
   const mid = (n - 1) / 2;
@@ -11481,6 +11504,6 @@ function WordRotate({
 //! motion fingerprint comes from the closed token system (durations, the house
 //! spring, the house ease), shared by every component.
 
-export { AudioClip, AudioVisualizer, BarChart, BentoGrid, BlurReveal, BoundingBox, BrowserFrame, Button, COMPONENT_SETTLE, Callout, CameraShake, Captions, CardShowcase, ChapterCard, CodeBlock, CodeDiff, Confetti, CountUp, Cursor, DURATION, DeviceFrame, DrawOn, DynamicGrid, EndCard, FadeIn, FadeOut, FilmGrade, GradientShift, GrainOverlay, HOUSE_EASE, Highlight, IconPop, ImageReveal, InputField, KanbanBoard, KenBurns, Keyframes, KineticText, LINE_RATIO, LineChart, LogoReveal, LogoSting, LookbookShot, LowerThird, Marquee, MaskReveal, MatrixDecode, MeshGradient, Moodboard, NodeGraph, OVERSHOOT, Parallax, PathMorph, PieReveal, PriceTag, PricingCard, ProductWall, ProgressBar, ProgressSteps, PulsingIndicator, QuoteCard, RgbGlitch, RotateIn, SPRING_SMOOTH, SPRING_SNAPPY, STAGGER, ScaleIn, Scrim, ShimmerSweep, SiteReveal, SkeletonCard, SlideIn, SlideOut, SlotMachineRoll, SplitLockup, SplitScreen, Spotlight, SpotlightCard, StaggerGroup, StatCard, Terminal, TextAnimator, TextFadeReplace, ThemeProvider, Timeline, TitleCard, TrackingIn, Typewriter, Underline, VideoClip, Vignette, WordRotate, WordStagger, beatPulse, defaultTheme, divergenceReport, entryDesignAnchor, entryFade, entryFadeRise, entryScale, entrySlide, exitFade, exitFadeFall, exitScale, exitSlide, fitFontSize, fitMaxWidth, fontMetrics, framesSinceBeat, glyphLayout, hasKeyframeTracks, heroReveal, isBeat, layoutGlyphLine, lineStartX, lineTopY, loadFont, matchesExport, measureText, preloadTextMetrics, responsiveEntryTransform, sampleKeyframes, sampleTrack, settleTime, staggerFrames, staggeredSettle, stateSwap, useAudioBeats, useAudioData, useEntrance, useFittedFontSize, useFontMetrics, useGlyphLayout, useResolvedBounds, useSceneProgress, useSpringValue, useStaggeredEntrance, useTextMetrics, useTextMetricsReady, useTextReveal, useTheme, useTimeScale };
+export { AudioClip, AudioVisualizer, BarChart, BentoGrid, BlurReveal, BoundingBox, BrowserFrame, Button, COMPONENT_SETTLE, Callout, CameraShake, Captions, CardShowcase, ChapterCard, CodeBlock, CodeDiff, Confetti, CountUp, Cursor, DURATION, DeviceFrame, DrawOn, DynamicGrid, EndCard, FadeIn, FadeOut, FilmGrade, GradientShift, GrainOverlay, HOUSE_EASE, Highlight, IconPop, ImageReveal, InputField, KanbanBoard, KenBurns, Keyframes, KineticText, LINE_RATIO, LineChart, LogoReveal, LogoSting, LookbookShot, LowerThird, Marquee, MaskReveal, MatrixDecode, MeshGradient, Moodboard, NodeGraph, OVERSHOOT, Parallax, PathMorph, PieReveal, PriceTag, PricingCard, ProductWall, ProgressBar, ProgressSteps, PulsingIndicator, QuoteCard, RgbGlitch, RotateIn, SPRING_SMOOTH, SPRING_SNAPPY, STAGGER, ScaleIn, Scrim, ShimmerSweep, SiteReveal, SkeletonCard, SlideIn, SlideOut, SlotMachineRoll, SplitLockup, SplitScreen, Spotlight, SpotlightCard, StaggerGroup, StatCard, Terminal, TextAnimator, TextFadeReplace, ThemeProvider, Timeline, TitleCard, TrackingIn, Typewriter, Underline, VideoClip, Vignette, WordRotate, WordStagger, beatPulse, defaultTheme, divergenceReport, entryDesignAnchor, entryFade, entryFadeRise, entryScale, entrySlide, exitFade, exitFadeFall, exitScale, exitSlide, fitFontSize, fitMaxWidth, fontMetrics, framesSinceBeat, glyphLayout, hasKeyframeTracks, heroReveal, isBeat, isFullBleed, layoutGlyphLine, lineStartX, lineTopY, loadFont, matchesExport, measureText, preloadTextMetrics, responsiveCoverTransform, responsiveEntryTransform, sampleKeyframes, sampleTrack, settleTime, staggerFrames, staggeredSettle, stateSwap, useAudioBeats, useAudioData, useEntrance, useFittedFontSize, useFontMetrics, useGlyphLayout, useResolvedBounds, useSceneProgress, useSpringValue, useStaggeredEntrance, useTextMetrics, useTextMetricsReady, useTextReveal, useTheme, useTimeScale };
 //# sourceMappingURL=components.js.map
 //# sourceMappingURL=components.js.map