@zync/zync-screnplay-player 0.1.191 → 0.1.192

package/dist/screenplay/RemotionRenderer/components/LottieAnimationGlobal.js

@@ -8,9 +8,9 @@ import React, { useEffect, useState } from 'react';
 import { delayRender, continueRender, cancelRender } from 'remotion';
 import { Lottie } from '@remotion/lottie';
 
-/**
- * Convert a HEX color string (e.g. "#ff8800") to the RGBA float array that
- * Lottie expects: [r, g, b, a] where each component is 0‑1.
+/**
+ * Convert a HEX color string (e.g. "#ff8800") to the RGBA float array that
+ * Lottie expects: [r, g, b, a] where each component is 0‑1.
  */
 var hexToRGBA = function hexToRGBA(hex) {
   var clean = hex.replace('#', '');
@@ -25,9 +25,9 @@ var hexToRGBA = function hexToRGBA(hex) {
   ];
 };
 
-/**
- * Recursively walks through shape objects and overrides any fill (fl) or
- * stroke (st) color with the provided RGBA array.
+/**
+ * Recursively walks through shape objects and overrides any fill (fl) or
+ * stroke (st) color with the provided RGBA array.
  */
 var _applyColor = function applyColor(shapes, rgba) {
   shapes === null || shapes === void 0 ? void 0 : shapes.forEach(function (shape) {
@@ -40,11 +40,11 @@ var _applyColor = function applyColor(shapes, rgba) {
   });
 };
 
-/**
- * Traverses all layers (top‑level + asset layers) and applies the primary
- * color to every fill / stroke it encounters. This is useful for Lottie files
- * that were exported with a single static color (e.g. white) and do not use
- * layer naming conventions like "PrimaryColor".
+/**
+ * Traverses all layers (top‑level + asset layers) and applies the primary
+ * color to every fill / stroke it encounters. This is useful for Lottie files
+ * that were exported with a single static color (e.g. white) and do not use
+ * layer naming conventions like "PrimaryColor".
  */
 var replaceGlobalColor = function replaceGlobalColor(data, hex) {
   var _data$assets;
@@ -60,16 +60,16 @@ var replaceGlobalColor = function replaceGlobalColor(data, hex) {
   });
 };
 
-/**
- * LottieAnimationGlobal – specialised wrapper to render the provided Lottie
- * (e.g. text‑bubble‑animation.json) while dynamically replacing **all** stroke
- * and fill colors with the supplied `primaryColor`.
- *
- * Props:
- *  • animationPath – URL or local path to the json file.
- *  • primaryColor  – HEX string, defaults to "#ffffff".
- *  • autoplay      – boolean, whether to start playing immediately.
- *  • loop          – boolean, whether to loop the animation.
+/**
+ * LottieAnimationGlobal – specialised wrapper to render the provided Lottie
+ * (e.g. text‑bubble‑animation.json) while dynamically replacing **all** stroke
+ * and fill colors with the supplied `primaryColor`.
+ *
+ * Props:
+ *  • animationPath – URL or local path to the json file.
+ *  • primaryColor  – HEX string, defaults to "#ffffff".
+ *  • autoplay      – boolean, whether to start playing immediately.
+ *  • loop          – boolean, whether to loop the animation.
  */
 export var LottieAnimationGlobal = function LottieAnimationGlobal(_ref) {
   var animationPath = _ref.animationPath,

package/dist/screenplay/RemotionRenderer/components/layouts/BrollGreenScreen.js

@@ -402,7 +402,7 @@ var Portrait = function Portrait(_ref2) {
     }
   })) : null, /*#__PURE__*/React.createElement(AbsoluteFill, {
     style: {
-      zIndex: 3
+      zIndex: 10
     }
   }, children), logoUrl ? /*#__PURE__*/React.createElement("div", {
     style: {

package/dist/screenplay/RemotionRenderer/components/utils/FaceCenteredVideo.js

@@ -8,34 +8,34 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
-/**
- * Face-Centered Video Component
- *
- * A reusable component that wraps OffthreadVideo to ensure the video is always
- * centered on a person's face within a flexible container.
- *
- * The video maintains its source dimensions and is positioned using translateX/translateY
- * to center the face within the container, regardless of container size.
+/**
+ * Face-Centered Video Component
+ *
+ * A reusable component that wraps OffthreadVideo to ensure the video is always
+ * centered on a person's face within a flexible container.
+ *
+ * The video maintains its source dimensions and is positioned using translateX/translateY
+ * to center the face within the container, regardless of container size.
  */
 
 import React from "react";
 import { OffthreadVideo, useCurrentFrame } from "remotion";
 import { useOrientationBased } from "../../hooks/useOrientationBased.js";
 
-/**
- * Calculate face-centered translation for flexible container
- * @param {Object} params - Configuration object
- * @param {Object} params.faceMetadata - Face detection metadata
- * @param {number} params.containerWidth - Container width in pixels
- * @param {number} params.containerHeight - Container height in pixels
- * @param {number} params.currentFrame - Current frame number (optional)
- * @param {boolean} params.enableInterpolation - Whether to interpolate between frames
- * @param {boolean} params.useAveragePosition - Whether to use average face position
- * @param {boolean} params.centerHorizontally - Whether to only center horizontally
- * @param {number} params.translateX - Additional translateX offset
- * @param {number} params.translateY - Additional translateY offset
- * @param {string} params.orientation - Viewport orientation (portrait, square, landscape)
- * @returns {Object} Transform styles and debug info
+/**
+ * Calculate face-centered translation for flexible container
+ * @param {Object} params - Configuration object
+ * @param {Object} params.faceMetadata - Face detection metadata
+ * @param {number} params.containerWidth - Container width in pixels
+ * @param {number} params.containerHeight - Container height in pixels
+ * @param {number} params.currentFrame - Current frame number (optional)
+ * @param {boolean} params.enableInterpolation - Whether to interpolate between frames
+ * @param {boolean} params.useAveragePosition - Whether to use average face position
+ * @param {boolean} params.centerHorizontally - Whether to only center horizontally
+ * @param {number} params.translateX - Additional translateX offset
+ * @param {number} params.translateY - Additional translateY offset
+ * @param {string} params.orientation - Viewport orientation (portrait, square, landscape)
+ * @returns {Object} Transform styles and debug info
  */
 var calculateFaceCenteredTranslation = function calculateFaceCenteredTranslation(_ref) {
   var _faceMetadata$metadat, _faceMetadata$metadat2;
@@ -214,8 +214,8 @@ var calculateFaceCenteredTranslation = function calculateFaceCenteredTranslation
   };
 };
 
-/**
- * Get face data for a specific frame with optional interpolation
+/**
+ * Get face data for a specific frame with optional interpolation
  */
 function getFaceDataForFrame(frames, frameIndex, enableInterpolation) {
   var _prevFrame, _nextFrame;
@@ -274,8 +274,8 @@ function getFaceDataForFrame(frames, frameIndex, enableInterpolation) {
   return ((_prevFrame = prevFrame) === null || _prevFrame === void 0 ? void 0 : _prevFrame.data) || ((_nextFrame = nextFrame) === null || _nextFrame === void 0 ? void 0 : _nextFrame.data) || null;
 }
 
-/**
- * Calculate average face position from all frames with face data
+/**
+ * Calculate average face position from all frames with face data
  */
 function getAverageFaceData(frames) {
   if (!frames || frames.length === 0) return null;
@@ -310,14 +310,14 @@ function getAverageFaceData(frames) {
   };
 }
 
-/**
- * Calculate the negative space offset when face-centering a video
- *
- * @param {Object} faceMetadata - Face detection metadata object
- * @param {number} containerWidth - Container width in pixels
- * @param {number} containerHeight - Container height in pixels
- * @param {number} scale - Scale factor applied to the video
- * @returns {Object} Object containing horizontal and vertical offsets and which side has negative space
+/**
+ * Calculate the negative space offset when face-centering a video
+ *
+ * @param {Object} faceMetadata - Face detection metadata object
+ * @param {number} containerWidth - Container width in pixels
+ * @param {number} containerHeight - Container height in pixels
+ * @param {number} scale - Scale factor applied to the video
+ * @returns {Object} Object containing horizontal and vertical offsets and which side has negative space
  */
 export var calculateNegativeSpaceOffset = function calculateNegativeSpaceOffset(faceMetadata, containerWidth, containerHeight) {
   var _faceMetadata$metadat4, _faceMetadata$metadat5;
@@ -415,22 +415,22 @@ export var calculateNegativeSpaceOffset = function calculateNegativeSpaceOffset(
   };
 };
 
-/**
- * FaceCenteredVideo Component
- * @param {Object} props - Component props
- * @param {string} props.src - Video source URL
- * @param {Object} props.faceMetadata - Face detection metadata
- * @param {number} props.containerWidth - Container width in pixels (required)
- * @param {number} props.containerHeight - Container height in pixels (required)
- * @param {boolean} props.enableInterpolation - Whether to interpolate between frames
- * @param {boolean} props.useAveragePosition - Whether to use average face position for entire video duration
- * @param {boolean} props.centerHorizontally - Whether to only center horizontally (X axis), not vertically (Y axis)
- * @param {number} props.translateX - Additional translateX offset (optional)
- * @param {number} props.translateY - Additional translateY offset (optional)
- * @param {boolean} props.showDebugInfo - Whether to show debug information
- * @param {Object} props.style - Additional styles to apply to video
- * @param {string} props.className - CSS class name
- * @param {...Object} props.otherProps - Other props to pass to OffthreadVideo
+/**
+ * FaceCenteredVideo Component
+ * @param {Object} props - Component props
+ * @param {string} props.src - Video source URL
+ * @param {Object} props.faceMetadata - Face detection metadata
+ * @param {number} props.containerWidth - Container width in pixels (required)
+ * @param {number} props.containerHeight - Container height in pixels (required)
+ * @param {boolean} props.enableInterpolation - Whether to interpolate between frames
+ * @param {boolean} props.useAveragePosition - Whether to use average face position for entire video duration
+ * @param {boolean} props.centerHorizontally - Whether to only center horizontally (X axis), not vertically (Y axis)
+ * @param {number} props.translateX - Additional translateX offset (optional)
+ * @param {number} props.translateY - Additional translateY offset (optional)
+ * @param {boolean} props.showDebugInfo - Whether to show debug information
+ * @param {Object} props.style - Additional styles to apply to video
+ * @param {string} props.className - CSS class name
+ * @param {...Object} props.otherProps - Other props to pass to OffthreadVideo
  */
 export var FaceCenteredVideo = function FaceCenteredVideo(_ref2) {
   var _faceMetadata$metadat7, _faceMetadata$metadat8, _faceMetadata$metadat9, _faceMetadata$metadat10;

package/dist/screenplay/RemotionRenderer/components/utils/PausableImg.js

@@ -15,10 +15,10 @@ function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t =
 import React, { useEffect, useState } from "react";
 import { Img, delayRender, continueRender } from "remotion";
 
-/**
- * PausableImg component that extends Remotion's Img with fetch validation.
- * It delays rendering until the image source can be successfully fetched.
- * If there's an error fetching the image, it renders nothing.
+/**
+ * PausableImg component that extends Remotion's Img with fetch validation.
+ * It delays rendering until the image source can be successfully fetched.
+ * If there's an error fetching the image, it renders nothing.
  */
 export var PausableImg = /*#__PURE__*/React.memo(function (_ref) {
   var src = _ref.src,

package/dist/screenplay/RemotionRenderer/components/utils/README.md

@@ -1,80 +1,80 @@
-# StretchText Component
-
-A React component that renders text that stretches to fit the parent's width. Words with fewer characters will have a larger font size than words with more characters. The component uses SVG for rendering text, which ensures proper text-stroke rendering in headless mode.
-
-## Usage
-
-```jsx
-import StretchText from './StretchText';
-
-// Basic usage
-<StretchText text="Hello World" />
-
-// With custom styling
-<StretchText 
-  text="Contribution" 
-  color="#1a73e8" 
-  fontFamily="Arial" 
-  maxFontSize={200}
-  minFontSize={10}
-  style={{ fontWeight: 'bold' }}
-/>
-
-// With text stroke
-<StretchText 
-  text="Outlined Text" 
-  color="transparent"
-  textStrokeColor="white"
-  textStrokeWidth="2px"
-  style={{ fontWeight: 'bold' }}
-/>
-```
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `text` | string | required | The text to display |
-| `color` | string | '#000000' | Text color |
-| `fontFamily` | string | 'Arial' | Font family |
-| `maxFontSize` | number | 100 | Maximum font size in pixels |
-| `minFontSize` | number | 10 | Minimum font size in pixels |
-| `textStrokeColor` | string | undefined | Color of the text stroke |
-| `textStrokeWidth` | string | undefined | Width of the text stroke (e.g., '2px') |
-| `textFillColor` | string | undefined | Color of the text fill (overrides `color` if provided) |
-| `style` | object | {} | Additional style properties |
-
-## Examples
-
-The component automatically calculates the appropriate font size to make the text stretch to fit the parent width. For example:
-
-- "Work" (4 characters) will have a larger font size than "Contribution" (12 characters) when both are rendered in containers of the same width.
-- The text will always be contained within the parent container and will not overflow.
-- The component recalculates the font size when the window is resized.
-
-## Demo
-
-You can see a demo of the StretchText component by running the development environment and looking at the first segment in the video timeline.
-
-The demo shows several words of different lengths rendered in containers of the same width:
-
-- "Contribution" (longer word, smaller font)
-- "Work" (shorter word, larger font)
-- "Hello" (medium length word, medium font)
-- "Supercalifragilisticexpialidocious" (very long word, very small font)
-
-Each word stretches to fill the entire width of its container, demonstrating how the component automatically adjusts the font size based on the text length.
-
-## Implementation Details
-
-The component uses a binary search algorithm to find the optimal font size that makes the text fit the parent width. It uses a simple approximation for text width calculation (character count * fontSize * 0.75) which works well for most fonts.
-
-The component uses SVG for rendering text, which provides several advantages:
-- Proper text-stroke rendering in headless mode
-- Better control over text positioning and alignment
-- Consistent rendering across different browsers and environments
-- Support for advanced SVG features like filters for text shadows
-
-For text with stroke effects, the component uses SVG's native stroke and fill attributes, which are more reliable than CSS text-stroke properties, especially in headless rendering environments.
-
-The component also includes a resize listener to recalculate the font size when the window size changes.
+# StretchText Component
+
+A React component that renders text that stretches to fit the parent's width. Words with fewer characters will have a larger font size than words with more characters. The component uses SVG for rendering text, which ensures proper text-stroke rendering in headless mode.
+
+## Usage
+
+```jsx
+import StretchText from './StretchText';
+
+// Basic usage
+<StretchText text="Hello World" />
+
+// With custom styling
+<StretchText 
+  text="Contribution" 
+  color="#1a73e8" 
+  fontFamily="Arial" 
+  maxFontSize={200}
+  minFontSize={10}
+  style={{ fontWeight: 'bold' }}
+/>
+
+// With text stroke
+<StretchText 
+  text="Outlined Text" 
+  color="transparent"
+  textStrokeColor="white"
+  textStrokeWidth="2px"
+  style={{ fontWeight: 'bold' }}
+/>
+```
+
+## Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `text` | string | required | The text to display |
+| `color` | string | '#000000' | Text color |
+| `fontFamily` | string | 'Arial' | Font family |
+| `maxFontSize` | number | 100 | Maximum font size in pixels |
+| `minFontSize` | number | 10 | Minimum font size in pixels |
+| `textStrokeColor` | string | undefined | Color of the text stroke |
+| `textStrokeWidth` | string | undefined | Width of the text stroke (e.g., '2px') |
+| `textFillColor` | string | undefined | Color of the text fill (overrides `color` if provided) |
+| `style` | object | {} | Additional style properties |
+
+## Examples
+
+The component automatically calculates the appropriate font size to make the text stretch to fit the parent width. For example:
+
+- "Work" (4 characters) will have a larger font size than "Contribution" (12 characters) when both are rendered in containers of the same width.
+- The text will always be contained within the parent container and will not overflow.
+- The component recalculates the font size when the window is resized.
+
+## Demo
+
+You can see a demo of the StretchText component by running the development environment and looking at the first segment in the video timeline.
+
+The demo shows several words of different lengths rendered in containers of the same width:
+
+- "Contribution" (longer word, smaller font)
+- "Work" (shorter word, larger font)
+- "Hello" (medium length word, medium font)
+- "Supercalifragilisticexpialidocious" (very long word, very small font)
+
+Each word stretches to fill the entire width of its container, demonstrating how the component automatically adjusts the font size based on the text length.
+
+## Implementation Details
+
+The component uses a binary search algorithm to find the optimal font size that makes the text fit the parent width. It uses a simple approximation for text width calculation (character count * fontSize * 0.75) which works well for most fonts.
+
+The component uses SVG for rendering text, which provides several advantages:
+- Proper text-stroke rendering in headless mode
+- Better control over text positioning and alignment
+- Consistent rendering across different browsers and environments
+- Support for advanced SVG features like filters for text shadows
+
+For text with stroke effects, the component uses SVG's native stroke and fill attributes, which are more reliable than CSS text-stroke properties, especially in headless rendering environments.
+
+The component also includes a resize listener to recalculate the font size when the window size changes.

package/dist/screenplay/RemotionRenderer/components/utils/StretchTextDemo.js

@@ -2,9 +2,9 @@ import React from "react";
 import { AbsoluteFill } from "remotion";
 import StretchText from "./StretchText";
 
-/**
- * Demo component to showcase the StretchText component
- * Shows how different words stretch to the same width with different font sizes
+/**
+ * Demo component to showcase the StretchText component
+ * Shows how different words stretch to the same width with different font sizes
  */
 var StretchTextDemo = function StretchTextDemo() {
   var containerStyle = {

package/dist/screenplay/RemotionRenderer/helpers/convertToSeconds.js

@@ -1,11 +1,11 @@
-/**
- * Converts seconds and a portion of frames to a numeric value of seconds.
- *
- * @param {number} seconds - The number of full seconds.
- * @param {number} nthFrame - The current frame within the second.
- * @param {number} delayInSeconds - Optional delay that adds up to the calculation
- * @param {number} frameRate - The frame rate (frames per second).
- * @return {number} The total time in seconds (with decimals for frames).
+/**
+ * Converts seconds and a portion of frames to a numeric value of seconds.
+ *
+ * @param {number} seconds - The number of full seconds.
+ * @param {number} nthFrame - The current frame within the second.
+ * @param {number} delayInSeconds - Optional delay that adds up to the calculation
+ * @param {number} frameRate - The frame rate (frames per second).
+ * @return {number} The total time in seconds (with decimals for frames).
  */
 export var convertToSeconds = function convertToSeconds(seconds, nthFrame) {
   var delayInSeconds = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;

package/dist/screenplay/RemotionRenderer/helpers/faceBasedVideoStyles.js

@@ -4,10 +4,10 @@ function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r)
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
-/**
- * Calculate video styles based on face detection metadata
- * This helper adjusts video positioning and transform origin to center faces in the viewport
- * when zooming, accounting for objectFit: "cover" behavior
+/**
+ * Calculate video styles based on face detection metadata
+ * This helper adjusts video positioning and transform origin to center faces in the viewport
+ * when zooming, accounting for objectFit: "cover" behavior
  */
 export var getFaceBasedVideoStyles = function getFaceBasedVideoStyles(_ref) {
   var faceMetadata = _ref.faceMetadata,

package/dist/screenplay/RemotionRenderer/helpers/faceCenteredVideoTransforms.js

@@ -4,33 +4,33 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/**
- * Face-Centered Video Transform Calculator
- *
- * This helper calculates transform origin and positioning to ensure a video is ALWAYS
- * centered on a person's face, regardless of aspect ratio (landscape, square, portrait).
- *
- * Key features:
- * - Converts absolute face coordinates to relative values
- * - Handles different target aspect ratios (1920x1080, 1080x1080, 1080x1920)
- * - Provides smooth interpolation between frames
- * - Calculates optimal scale and positioning for face centering
+/**
+ * Face-Centered Video Transform Calculator
+ *
+ * This helper calculates transform origin and positioning to ensure a video is ALWAYS
+ * centered on a person's face, regardless of aspect ratio (landscape, square, portrait).
+ *
+ * Key features:
+ * - Converts absolute face coordinates to relative values
+ * - Handles different target aspect ratios (1920x1080, 1080x1080, 1080x1920)
+ * - Provides smooth interpolation between frames
+ * - Calculates optimal scale and positioning for face centering
  */
 
 import { useCurrentFrame } from "remotion";
 
-/**
- * Calculate face-centered video transforms
- * @param {Object} params - Configuration object
- * @param {Object} params.faceMetadata - Face detection metadata
- * @param {number} params.targetWidth - Target video width (1920 for landscape, 1080 for square/portrait)
- * @param {number} params.targetHeight - Target video height (1080 for landscape/square, 1920 for portrait)
- * @param {number} params.currentFrame - Current frame number (optional, will use useCurrentFrame if not provided)
- * @param {boolean} params.enableInterpolation - Whether to interpolate between frames
- * @param {number} params.faceScale - Scale factor for face area (1.0 = face fills frame, 0.5 = face takes half frame)
- * @param {boolean} params.useAveragePosition - Whether to use average face position for entire video duration
- * @param {boolean} params.centerHorizontally - Whether to only center horizontally (X axis), not vertically (Y axis)
- * @returns {Object} Transform styles and debug info
+/**
+ * Calculate face-centered video transforms
+ * @param {Object} params - Configuration object
+ * @param {Object} params.faceMetadata - Face detection metadata
+ * @param {number} params.targetWidth - Target video width (1920 for landscape, 1080 for square/portrait)
+ * @param {number} params.targetHeight - Target video height (1080 for landscape/square, 1920 for portrait)
+ * @param {number} params.currentFrame - Current frame number (optional, will use useCurrentFrame if not provided)
+ * @param {boolean} params.enableInterpolation - Whether to interpolate between frames
+ * @param {number} params.faceScale - Scale factor for face area (1.0 = face fills frame, 0.5 = face takes half frame)
+ * @param {boolean} params.useAveragePosition - Whether to use average face position for entire video duration
+ * @param {boolean} params.centerHorizontally - Whether to only center horizontally (X axis), not vertically (Y axis)
+ * @returns {Object} Transform styles and debug info
  */
 export var calculateFaceCenteredTransforms = function calculateFaceCenteredTransforms(_ref) {
   var _faceMetadata$metadat, _faceMetadata$metadat2;
@@ -173,10 +173,10 @@ export var calculateFaceCenteredTransforms = function calculateFaceCenteredTrans
   };
 };
 
-/**
- * Calculate average face position from all frames with face data
- * @param {Array} frames - Array of frame data
- * @returns {Object|null} Average face data or null if no face data available
+/**
+ * Calculate average face position from all frames with face data
+ * @param {Array} frames - Array of frame data
+ * @returns {Object|null} Average face data or null if no face data available
  */
 function getAverageFaceData(frames) {
   if (!frames || frames.length === 0) return null;
@@ -225,8 +225,8 @@ function getAverageFaceData(frames) {
   return averageFaceData;
 }
 
-/**
- * Get face data for a specific frame with optional interpolation
+/**
+ * Get face data for a specific frame with optional interpolation
  */
 function getFaceDataForFrame(frames, targetFrame, enableInterpolation) {
   if (!frames || frames.length === 0) return null;
@@ -285,8 +285,8 @@ function getFaceDataForFrame(frames, targetFrame, enableInterpolation) {
   };
 }
 
-/**
- * Preset configurations for common aspect ratios
+/**
+ * Preset configurations for common aspect ratios
  */
 export var ASPECT_RATIO_PRESETS = {
   LANDSCAPE: {
@@ -303,17 +303,17 @@ export var ASPECT_RATIO_PRESETS = {
   }
 };
 
-/**
- * Calculate face-centered object-position values
- * @param {Object} params - Configuration object
- * @param {Object} params.faceMetadata - Face detection metadata
- * @param {number} params.targetWidth - Target video width (1920 for landscape, 1080 for square/portrait)
- * @param {number} params.targetHeight - Target video height (1080 for landscape/square, 1920 for portrait)
- * @param {number} params.currentFrame - Current frame number (optional, will use useCurrentFrame if not provided)
- * @param {boolean} params.enableInterpolation - Whether to interpolate between frames
- * @param {boolean} params.useAveragePosition - Whether to use average face position for entire video duration
- * @param {boolean} params.centerHorizontally - Whether to only center horizontally (X axis), not vertically (Y axis)
- * @returns {Object} Object-position styles and debug info
+/**
+ * Calculate face-centered object-position values
+ * @param {Object} params - Configuration object
+ * @param {Object} params.faceMetadata - Face detection metadata
+ * @param {number} params.targetWidth - Target video width (1920 for landscape, 1080 for square/portrait)
+ * @param {number} params.targetHeight - Target video height (1080 for landscape/square, 1920 for portrait)
+ * @param {number} params.currentFrame - Current frame number (optional, will use useCurrentFrame if not provided)
+ * @param {boolean} params.enableInterpolation - Whether to interpolate between frames
+ * @param {boolean} params.useAveragePosition - Whether to use average face position for entire video duration
+ * @param {boolean} params.centerHorizontally - Whether to only center horizontally (X axis), not vertically (Y axis)
+ * @returns {Object} Object-position styles and debug info
  */
 export var calculateFaceCenteredObjectPosition = function calculateFaceCenteredObjectPosition(_ref2) {
   var _faceMetadata$metadat4, _faceMetadata$metadat5;
@@ -435,8 +435,8 @@ export var calculateFaceCenteredObjectPosition = function calculateFaceCenteredO
   };
 };
 
-/**
- * Helper function to get transforms for specific aspect ratios
+/**
+ * Helper function to get transforms for specific aspect ratios
  */
 export var getFaceCenteredTransformsForAspectRatio = function getFaceCenteredTransformsForAspectRatio(aspectRatio, faceMetadata) {
   var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
@@ -451,8 +451,8 @@ export var getFaceCenteredTransformsForAspectRatio = function getFaceCenteredTra
   }, options));
 };
 
-/**
- * Helper function to get object-position for specific aspect ratios
+/**
+ * Helper function to get object-position for specific aspect ratios
  */
 export var getFaceCenteredObjectPositionForAspectRatio = function getFaceCenteredObjectPositionForAspectRatio(aspectRatio, faceMetadata) {
   var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};