@cueframe/kernel 0.0.1

package/dist/_members/primitives/backgrounds/volumetric-rays/config.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import type { PrimitiveMeta } from '../../lib/types.js';
+declare const paramsSchema: z.ZodObject<{
+    text: z.ZodDefault<z.ZodString>;
+    fontSize: z.ZodDefault<z.ZodNumber>;
+    fontWeight: z.ZodDefault<z.ZodNumber>;
+    rayColor: z.ZodDefault<z.ZodString>;
+    background: z.ZodDefault<z.ZodString>;
+    textColor: z.ZodDefault<z.ZodString>;
+    intensity: z.ZodDefault<z.ZodNumber>;
+    speed: z.ZodDefault<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    text: z.ZodDefault<z.ZodString>;
+    fontSize: z.ZodDefault<z.ZodNumber>;
+    fontWeight: z.ZodDefault<z.ZodNumber>;
+    rayColor: z.ZodDefault<z.ZodString>;
+    background: z.ZodDefault<z.ZodString>;
+    textColor: z.ZodDefault<z.ZodString>;
+    intensity: z.ZodDefault<z.ZodNumber>;
+    speed: z.ZodDefault<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    text: z.ZodDefault<z.ZodString>;
+    fontSize: z.ZodDefault<z.ZodNumber>;
+    fontWeight: z.ZodDefault<z.ZodNumber>;
+    rayColor: z.ZodDefault<z.ZodString>;
+    background: z.ZodDefault<z.ZodString>;
+    textColor: z.ZodDefault<z.ZodString>;
+    intensity: z.ZodDefault<z.ZodNumber>;
+    speed: z.ZodDefault<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
+type Params = z.infer<typeof paramsSchema>;
+export declare const config: PrimitiveMeta<Params>;
+export {};

package/dist/_members/primitives/backgrounds/volumetric-rays/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Adapted from remocn (https://github.com/kapishdima/remocn) — MIT
+ * Copyright (c) 2026 KapishDima
+ *
+ * Modifications:
+ *   - hermetic-ize fontFamily (use inherit / monospace, not Geist CSS vars)
+ *   - strip "use client" directive (re-added at shadcn-registry export time)
+ */
+export interface VolumetricRaysProps {
+    text?: string;
+    fontSize?: number;
+    fontWeight?: number;
+    rayColor?: string;
+    background?: string;
+    textColor?: string;
+    intensity?: number;
+    speed?: number;
+    className?: string;
+}
+/**
+ * Layered "god rays" effect built entirely from CSS / SVG masks. The trick:
+ *
+ * 1. Render the same text twice. Back layer is scaled wider than tall and
+ *    heavily blurred — that's the "halo" the rays bloom out of.
+ * 2. Sweep an SVG conic-gradient mask above the text to look like rotating
+ *    light shafts pushing through the lettering.
+ * 3. The front layer is solid (silhouette) so the contrast reads as light
+ *    pushing AROUND the letters rather than ON them.
+ */
+export declare function VolumetricRays({ text, fontSize, fontWeight, rayColor, background, textColor, intensity, speed, className, }: VolumetricRaysProps): import("react").JSX.Element;

package/dist/_members/primitives/captions/Captions.d.ts

@@ -0,0 +1,33 @@
+import type { CaptionWord, CaptionStyle } from '../../core/render/index.js';
+/**
+ * TikTok/Hormozi-style word-level captions layer.
+ *
+ * Drives `@remotion/captions`'s `createTikTokStyleCaptions` with a
+ * pre-timed word stream, paginates ~1.5s at a time, highlights the
+ * active token, and applies per-token emphasis (separate font/scale/
+ * color/weight) when `CaptionWord.emphasis` is set.
+ *
+ * Fonts are NOT loaded by this component — the caller (editor's
+ * `Root.tsx` or the worker render bundle's bootstrap) is responsible
+ * for ensuring `style.fontFamily` is loaded before the bundle renders.
+ */
+export declare function Captions({ segments, style: userStyle, region, }: {
+    /**
+     * Authored caption SEGMENTS. Each segment is a hard caption-page boundary:
+     * pagination runs within a segment and never pools words across two, so
+     * sentence-bounded segments cut captions at sentence ends.
+     */
+    segments: CaptionWord[][];
+    style?: Partial<CaptionStyle>;
+    /**
+     * Floor-resolved caption band (output fractions). When set, the caption sits
+     * with its BOTTOM edge at `region.y + region.h` — i.e. clear of the platform's
+     * bottom-UI strip — instead of the fixed `style.position` offset. Horizontal
+     * stays centred (the short-form convention); only the vertical clearance is
+     * taken from the floor. See composition-model `resolveCaptionRegion`.
+     */
+    region?: {
+        y: number;
+        h: number;
+    };
+}): import("react").JSX.Element | null;

package/dist/_members/primitives/captions/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @cueframe/primitives/captions — TikTok/Hormozi-style word-level
+ * caption layer. Exposed as a top-level layer (sibling of overlays /
+ * effects), not an overlay primitive in the registry, because it spans
+ * the whole composition with consistent style rather than being placed
+ * per-clip.
+ *
+ * Consumed by:
+ *   - cueframe editor's `MainComposition` (preview)
+ *   - the worker render bundle (export)
+ *
+ * Wire shape: a Composition with `captions: { words, style? }` lights
+ * up this layer. Words are millisecond-timed and aligned to the
+ * composition's timeline (NOT source-relative).
+ */
+export { Captions } from './Captions.js';
+export type { CaptionWord, CaptionStyle, EmphasisWord } from '../../core/render/index.js';

package/dist/_members/primitives/captions/index.js

@@ -0,0 +1,398 @@
+import {
+  fillStyle
+} from "../chunk-HIWVFZVH.js";
+import {
+  Marker
+} from "../chunk-XHU3WBEI.js";
+import {
+  wordPop
+} from "../chunk-G2B3G4HK.js";
+import {
+  TEXT_HI,
+  VIOLET
+} from "../chunk-3OMURV6Q.js";
+import "../chunk-UVKRO5ER.js";
+
+// src/captions/Captions.tsx
+import { useMemo } from "react";
+import { AbsoluteFill, useCurrentFrame, useVideoConfig, interpolate, Easing } from "remotion";
+import { fillTextBox } from "@remotion/layout-utils";
+
+// src/captions/paginate.ts
+import { createTikTokStyleCaptions } from "@remotion/captions";
+function paginateCaptionSegments(segments, opts) {
+  const raw = [];
+  for (const words of segments) {
+    if (words.length === 0) continue;
+    const rc = words.map((word, i) => ({
+      text: i === 0 ? word.text : ` ${word.text}`,
+      startMs: word.startMs,
+      endMs: word.endMs,
+      timestampMs: null,
+      confidence: null
+    }));
+    const { pages } = createTikTokStyleCaptions({
+      captions: rc,
+      combineTokensWithinMilliseconds: opts.combineMs
+    });
+    for (const page of pages) raw.push(...splitPageToFit(page, opts.makeBox));
+  }
+  return assignTimeline(raw, opts.lingerMs);
+}
+function splitPageToFit(page, makeBox) {
+  const probe = makeBox();
+  if (page.tokens.every((t) => probe.add(t))) {
+    return [{ startMs: page.startMs, tokens: page.tokens }];
+  }
+  const groups = [];
+  let box = makeBox();
+  let cur = [];
+  for (const token of page.tokens) {
+    if (cur.length === 0) {
+      cur.push(token);
+      box.add(token);
+    } else if (box.add(token)) {
+      cur.push(token);
+    } else {
+      groups.push(cur);
+      box = makeBox();
+      cur = [token];
+      box.add(token);
+    }
+  }
+  if (cur.length > 0) groups.push(cur);
+  return groups.map((tokens, i) => ({
+    startMs: i === 0 ? page.startMs : tokens[0].fromMs,
+    tokens
+  }));
+}
+function assignTimeline(raw, lingerMs) {
+  const merged = [];
+  for (const p of raw) {
+    const prev = merged[merged.length - 1];
+    if (prev && p.startMs <= prev.startMs) {
+      prev.tokens.push(...p.tokens);
+    } else {
+      merged.push({ startMs: p.startMs, tokens: [...p.tokens] });
+    }
+  }
+  return merged.map((p, i) => {
+    const lastWordEnd = Math.max(...p.tokens.map((t) => t.toMs));
+    const cleared = lastWordEnd + lingerMs;
+    const endMs = i < merged.length - 1 ? Math.min(merged[i + 1].startMs, cleared) : cleared;
+    return {
+      text: p.tokens.map((t) => t.text).join(""),
+      startMs: p.startMs,
+      durationMs: Math.max(1, endMs - p.startMs),
+      tokens: p.tokens
+    };
+  });
+}
+
+// src/captions/placement.ts
+function resolveCaptionPlacement(position, region) {
+  const vertical = region ? { bottom: `${Math.max(0, (1 - (region.y + region.h)) * 100)}%` } : position === "top" ? { top: "8%" } : position === "center" ? { top: "50%", transform: "translateY(-50%)" } : { bottom: "10%" };
+  return {
+    position: "absolute",
+    left: 0,
+    right: 0,
+    display: "flex",
+    justifyContent: "center",
+    ...vertical
+  };
+}
+
+// src/captions/Captions.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+var DEFAULT_HIGHLIGHT_COLOR = TEXT_HI;
+var DEFAULT_STYLE = {
+  // Fallback STACK, not a bare family: when the vendored Inter face fails to
+  // register (the loader swallows failures by design), the browser default is
+  // a SERIF — captions must never degrade past a system grotesk.
+  fontFamily: "Inter, 'Helvetica Neue', Helvetica, Arial, sans-serif",
+  fontSize: 5,
+  fontWeight: 600,
+  color: TEXT_HI,
+  highlightColor: DEFAULT_HIGHLIGHT_COLOR,
+  backgroundColor: "transparent",
+  position: "bottom",
+  textTransform: "none",
+  plate: "none",
+  entrance: "fade",
+  entranceMs: 220,
+  exitMs: 180
+};
+function plateStyleFor(kind, backgroundColor) {
+  if (kind === "glass") {
+    const glass = "blur(28px) saturate(135%)";
+    return {
+      backgroundColor: "rgba(20,23,31,0.13)",
+      backdropFilter: glass,
+      WebkitBackdropFilter: glass,
+      border: "1px solid rgba(255,255,255,0.32)"
+    };
+  }
+  if (kind === "solid") {
+    return {
+      // warm espresso scrim (palette.BG = #14100c → rgb 20,16,12) at plate alpha,
+      // not a cold pure-black — keeps the legibility opacity, drops the cold cast.
+      backgroundColor: backgroundColor && backgroundColor !== "transparent" ? backgroundColor : "rgba(20,16,12,0.62)"
+    };
+  }
+  return { backgroundColor: backgroundColor ?? "transparent" };
+}
+var COMBINE_TOKENS_MS = 1500;
+var CAPTION_LINGER_MS = 600;
+function addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis) {
+  const isEmp = emphasis?.emphasisSet.has(token.fromMs) ?? false;
+  const tokenSize = isEmp ? Math.round(fontSize * (emphasis?.emphasisScale ?? 1.2)) : fontSize;
+  const tokenWeight = isEmp ? emphasis?.emphasisFontWeight ?? 900 : fontWeight;
+  const tokenFamily = isEmp ? emphasis?.emphasisFontFamily ?? fontFamily : fontFamily;
+  return box.add({
+    text: token.text,
+    fontFamily: tokenFamily,
+    fontSize: tokenSize,
+    fontWeight: String(tokenWeight)
+  });
+}
+function makeBoxFactory(maxWidth, fontFamily, fontSize, fontWeight, emphasis) {
+  return () => {
+    const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });
+    return {
+      add: (token) => !addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis).exceedsBox
+    };
+  };
+}
+function layoutTokensIntoLines(tokens, maxWidth, fontFamily, fontSize, fontWeight, emphasis) {
+  const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });
+  const lines = [[]];
+  for (const token of tokens) {
+    const result = addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis);
+    if (result.newLine) {
+      lines.push([token]);
+    } else {
+      lines[lines.length - 1].push(token);
+    }
+  }
+  return lines.filter((line) => line.length > 0);
+}
+function Captions({
+  segments,
+  style: userStyle,
+  region
+}) {
+  const frame = useCurrentFrame();
+  const { fps, width, height } = useVideoConfig();
+  const style = { ...DEFAULT_STYLE, ...userStyle };
+  const emphasisScale = style.emphasisScale ?? 1.08;
+  const emphasisColor = style.emphasisColor ?? style.highlightColor;
+  const emphasisFontFamily = style.emphasisFontFamily;
+  const emphasisFontWeight = style.emphasisFontWeight ?? 800;
+  const emphasisTextTransform = style.emphasisTextTransform ?? style.textTransform;
+  const emphasisLetterSpacing = style.emphasisLetterSpacing ?? 0;
+  const emphasisFontStyle = style.emphasisFontStyle ?? "normal";
+  const entrance = style.entrance ?? "none";
+  const entranceFrames = Math.max(1, Math.round((style.entranceMs ?? 160) / 1e3 * fps));
+  const staggerFrames = Math.max(0, Math.round((style.entranceStaggerMs ?? 90) / 1e3 * fps));
+  const exitMs = style.exitMs ?? 0;
+  const emphasisPlate = style.emphasisPlate ?? false;
+  const plateColor = style.emphasisPlateColor ?? emphasisColor;
+  const plateTextColor = style.emphasisPlateTextColor ?? TEXT_HI;
+  const plateAltColor = style.emphasisPlateAltColor ?? plateColor;
+  const plateAltTextColor = style.emphasisPlateAltTextColor ?? plateTextColor;
+  const plateRadius = style.emphasisPlateRadius ?? 6;
+  const platePadX = style.emphasisPlatePadX ?? 0.16;
+  const platePadY = style.emphasisPlatePadY ?? 0.04;
+  const annotationColor = style.annotationColor ?? VIOLET;
+  const maxWidthPercent = style.maxWidthPercent ?? 80;
+  const plateStyle = plateStyleFor(style.plate ?? "glass", style.backgroundColor);
+  const fontSize = Math.round(height * (style.fontSize / 100));
+  const maxTextWidth = width * (maxWidthPercent / 100);
+  const { emphasisStartMs, annotateKind } = useMemo(() => {
+    const emph = /* @__PURE__ */ new Set();
+    const ann = /* @__PURE__ */ new Map();
+    for (const w of segments.flat()) {
+      if (w.emphasis) emph.add(w.startMs);
+      if (w.annotate) ann.set(w.startMs, w.annotate);
+    }
+    return { emphasisStartMs: emph, annotateKind: ann };
+  }, [segments]);
+  const emphasisLayout = useMemo(
+    () => emphasisStartMs.size > 0 ? { emphasisSet: emphasisStartMs, emphasisScale, emphasisFontFamily, emphasisFontWeight } : void 0,
+    [emphasisStartMs, emphasisScale, emphasisFontFamily, emphasisFontWeight]
+  );
+  const pages = useMemo(
+    () => paginateCaptionSegments(segments, {
+      combineMs: COMBINE_TOKENS_MS,
+      makeBox: makeBoxFactory(maxTextWidth, style.fontFamily, fontSize, style.fontWeight, emphasisLayout),
+      lingerMs: CAPTION_LINGER_MS
+    }),
+    [segments, maxTextWidth, fontSize, style.fontFamily, style.fontWeight, emphasisLayout]
+  );
+  if (pages.length === 0) return null;
+  const currentTimeMs = frame / fps * 1e3;
+  const currentPage = pages.find(
+    (p) => currentTimeMs >= p.startMs && currentTimeMs < p.startMs + p.durationMs
+  );
+  if (!currentPage) return null;
+  const activeToken = currentPage.tokens.find(
+    (t) => currentTimeMs >= t.fromMs && currentTimeMs < t.toMs
+  );
+  const tokenStartFrame = /* @__PURE__ */ new Map();
+  if (entrance !== "none") {
+    let minNext = -Infinity;
+    for (const t of currentPage.tokens) {
+      const s = Math.max(Math.round(t.fromMs / 1e3 * fps), minNext);
+      tokenStartFrame.set(t, s);
+      minNext = s + staggerFrames;
+    }
+  }
+  const pageEnd = currentPage.startMs + currentPage.durationMs;
+  const groupOpacity = exitMs > 0 ? interpolate(currentTimeMs, [pageEnd - exitMs, pageEnd], [1, 0], {
+    extrapolateLeft: "clamp",
+    extrapolateRight: "clamp"
+  }) : 1;
+  const lines = layoutTokensIntoLines(
+    currentPage.tokens,
+    maxTextWidth,
+    style.fontFamily,
+    fontSize,
+    style.fontWeight,
+    emphasisLayout
+  );
+  const wrapperStyle = resolveCaptionPlacement(style.position, region);
+  return /* @__PURE__ */ jsx(AbsoluteFill, { style: { pointerEvents: "none" }, children: /* @__PURE__ */ jsx("div", { style: wrapperStyle, children: /* @__PURE__ */ jsx(
+    "div",
+    {
+      style: {
+        opacity: groupOpacity,
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        gap: `${fontSize * 0.25}px`,
+        padding: `${fontSize * 0.4}px ${fontSize * 0.8}px`,
+        borderRadius: fontSize * 0.5,
+        ...plateStyle,
+        maxWidth: `${maxWidthPercent}%`,
+        boxSizing: "border-box"
+      },
+      children: (() => {
+        let plateIdx = 0;
+        const RISE_PX = fontSize * 0.4;
+        const easeOpacity = (start) => interpolate(frame, [start, start + entranceFrames], [0, 1], {
+          extrapolateLeft: "clamp",
+          extrapolateRight: "clamp",
+          easing: Easing.out(Easing.cubic)
+        });
+        const entranceOf = (first, isEmph) => {
+          if (entrance === "none") return { opacity: 1, scale: 1, y: 0 };
+          const start = tokenStartFrame.get(first) ?? 0;
+          if (entrance === "word-pop") {
+            const { opacity, scale } = wordPop(frame, fps, start, entranceFrames, isEmph ? 0.86 : 0.92);
+            return { opacity, scale, y: 0 };
+          }
+          if (entrance === "stagger-up") {
+            const y = interpolate(frame, [start, start + entranceFrames], [RISE_PX, 0], {
+              extrapolateLeft: "clamp",
+              extrapolateRight: "clamp",
+              easing: Easing.out(Easing.cubic)
+            });
+            return { opacity: easeOpacity(start), scale: 1, y };
+          }
+          if (entrance === "fade") {
+            return { opacity: easeOpacity(start), scale: 1, y: 0 };
+          }
+          return { opacity: 1, scale: 1, y: 0 };
+        };
+        return lines.map((line, lineIdx) => {
+          const segs = [];
+          for (const t of line) {
+            const e = emphasisStartMs.has(t.fromMs);
+            const last = segs[segs.length - 1];
+            if (emphasisPlate && e && last && last.emph) last.tokens.push(t);
+            else segs.push({ tokens: [t], emph: e });
+          }
+          return /* @__PURE__ */ jsx("div", { style: { display: "flex", justifyContent: "center", alignItems: "baseline", gap: `${fontSize * 0.35}px` }, children: segs.map((seg, si) => {
+            const first = seg.tokens[0];
+            const { opacity, scale, y } = entranceOf(first, seg.emph);
+            const entranceTransform = `translateY(${y}px) scale(${scale})`;
+            const annKind = seg.tokens.map((t) => annotateKind.get(t.fromMs)).find(Boolean);
+            let markerP = 1;
+            if (annKind && entrance !== "none") {
+              const ms = (tokenStartFrame.get(first) ?? 0) + Math.round(fps * 0.14);
+              markerP = interpolate(frame, [ms, ms + Math.round(fps * 0.32)], [0, 1], { extrapolateLeft: "clamp", extrapolateRight: "clamp" });
+            }
+            if (seg.emph && emphasisPlate) {
+              const idx = plateIdx++;
+              const bg = idx % 2 === 0 ? plateColor : plateAltColor;
+              const fg = idx % 2 === 0 ? plateTextColor : plateAltTextColor;
+              const efs = Math.round(fontSize * emphasisScale);
+              return /* @__PURE__ */ jsxs("span", { style: { position: "relative", display: "inline-block", opacity, transform: entranceTransform, transformOrigin: "center" }, children: [
+                /* @__PURE__ */ jsx(
+                  "span",
+                  {
+                    style: {
+                      display: "inline-block",
+                      background: bg,
+                      color: fg,
+                      borderRadius: plateRadius,
+                      padding: `${Math.round(efs * platePadY)}px ${Math.round(efs * platePadX)}px`,
+                      fontFamily: emphasisFontFamily ?? style.fontFamily,
+                      fontSize: efs,
+                      fontWeight: emphasisFontWeight,
+                      fontStyle: emphasisFontStyle,
+                      textTransform: emphasisTextTransform,
+                      letterSpacing: emphasisLetterSpacing ? `${emphasisLetterSpacing}px` : void 0,
+                      lineHeight: 1,
+                      whiteSpace: "nowrap"
+                    },
+                    children: seg.tokens.map((t) => t.text.trim()).join(" ")
+                  }
+                ),
+                annKind ? /* @__PURE__ */ jsx(Marker, { spec: { kind: annKind, color: annotationColor }, progress: markerP }) : null
+              ] }, si);
+            }
+            const token = first;
+            const isActive = token === activeToken;
+            const isEmphasis = seg.emph;
+            const tokenFontSize = isEmphasis ? Math.round(fontSize * emphasisScale) : fontSize;
+            const tokenWeight = isEmphasis ? emphasisFontWeight : style.fontWeight;
+            const tokenFamily = isEmphasis ? emphasisFontFamily ?? style.fontFamily : style.fontFamily;
+            const tokenTransform = isEmphasis ? emphasisTextTransform : style.textTransform;
+            const tokenLetterSpacing = isEmphasis && emphasisLetterSpacing ? `${emphasisLetterSpacing}px` : void 0;
+            const tokenFontStyle = isEmphasis ? emphasisFontStyle : "normal";
+            let tokenColor = style.color;
+            if (isActive && !emphasisPlate) tokenColor = style.highlightColor;
+            else if (isEmphasis) tokenColor = emphasisColor;
+            const gradientFill = isEmphasis && style.emphasisGradient ? fillStyle({ kind: "gradient", value: style.emphasisGradient }) : {};
+            const inner = /* @__PURE__ */ jsx(
+              "span",
+              {
+                style: {
+                  fontFamily: tokenFamily,
+                  fontSize: tokenFontSize,
+                  fontWeight: tokenWeight,
+                  fontStyle: tokenFontStyle,
+                  color: tokenColor,
+                  textTransform: tokenTransform,
+                  letterSpacing: tokenLetterSpacing,
+                  display: "inline-block",
+                  ...gradientFill
+                },
+                children: emphasisPlate ? token.text.trim() : token.text
+              }
+            );
+            return /* @__PURE__ */ jsxs("span", { style: { position: "relative", display: "inline-block", opacity, transform: entranceTransform, transformOrigin: "center" }, children: [
+              inner,
+              annKind ? /* @__PURE__ */ jsx(Marker, { spec: { kind: annKind, color: annotationColor }, progress: markerP }) : null
+            ] }, si);
+          }) }, lineIdx);
+        });
+      })()
+    }
+  ) }) });
+}
+export {
+  Captions
+};
+//# sourceMappingURL=index.js.map

package/dist/_members/primitives/captions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/captions/Captions.tsx","../../src/captions/paginate.ts","../../src/captions/placement.ts"],"sourcesContent":["import { useMemo } from 'react';\nimport { AbsoluteFill, useCurrentFrame, useVideoConfig, interpolate, Easing } from 'remotion';\nimport { fillTextBox } from '@remotion/layout-utils';\nimport type { TikTokToken } from '@remotion/captions';\nimport type { CaptionWord, CaptionStyle } from '@cueframe/core/render';\nimport { paginateCaptionSegments, type FitBox } from './paginate';\nimport { resolveCaptionPlacement } from './placement';\nimport { Marker } from '../lib/text/marker';\nimport { fillStyle } from '../lib/text/fill';\nimport { wordPop } from '../lib/text/motion';\nimport * as palette from '../lib/palette';\n\n/**\n * Default highlight color for the active word. A warm off-white — the default\n * look does not karaoke-color the spoken word; the word-fade entrance already\n * carries the sync signal. A brand kit's `captionStyle.highlightColor` overrides\n * it (the gold `#E6B450` treatment is now a kit choice, not the floor).\n */\nconst DEFAULT_HIGHLIGHT_COLOR = palette.TEXT_HI;\n\n// Default-look change 2026-07-15: the launch-film clean default replaced the\n// TikTok/Hormozi glass+gold default — plateless white, word-fade entrance,\n// NO text shadow. Captions carry legibility through size and weight;\n// the ONE opt-in legibility device is `plate: 'glass' | 'solid'` (a style /\n// brand-captionProfile choice), never a baked-in shadow. Brand captionProfiles\n// override everything here.\nconst DEFAULT_STYLE: CaptionStyle = {\n  // Fallback STACK, not a bare family: when the vendored Inter face fails to\n  // register (the loader swallows failures by design), the browser default is\n  // a SERIF — captions must never degrade past a system grotesk.\n  fontFamily: \"Inter, 'Helvetica Neue', Helvetica, Arial, sans-serif\",\n  fontSize: 5,\n  fontWeight: 600,\n  color: palette.TEXT_HI,\n  highlightColor: DEFAULT_HIGHLIGHT_COLOR,\n  backgroundColor: 'transparent',\n  position: 'bottom',\n  textTransform: 'none',\n  plate: 'none',\n  entrance: 'fade',\n  entranceMs: 220,\n  exitMs: 180,\n};\n\n/** Caption backdrop-plate treatments. The plate is the caption block's OWN\n *  background, so it renders ONLY while a caption is on-screen — it cannot paint\n *  during caption-less moments (a title-card open, an inter-sentence pause). This\n *  replaces the retired per-frame legibility scrim.\n *  - glass: a frosted backdrop-blur pill; footage reads through (tint 0.13 +\n *    28px blur + a hairline light edge). The blur + the text shadow\n *    do the legibility work, so the tint stays light.\n *  - solid: an opaque dark plate (uses a custom backgroundColor if set).\n *  - none:  transparent; captions rely on the text shadow (a deliberate opt-out —\n *    legible only on controlled/dark backdrops). */\nfunction plateStyleFor(kind: 'glass' | 'solid' | 'none', backgroundColor: string): React.CSSProperties {\n  if (kind === 'glass') {\n    const glass = 'blur(28px) saturate(135%)';\n    return {\n      backgroundColor: 'rgba(20,23,31,0.13)',\n      backdropFilter: glass,\n      WebkitBackdropFilter: glass,\n      border: '1px solid rgba(255,255,255,0.32)',\n    };\n  }\n  if (kind === 'solid') {\n    return {\n      // warm espresso scrim (palette.BG = #14100c → rgb 20,16,12) at plate alpha,\n      // not a cold pure-black — keeps the legibility opacity, drops the cold cast.\n      backgroundColor: backgroundColor && backgroundColor !== 'transparent' ? backgroundColor : 'rgba(20,16,12,0.62)',\n    };\n  }\n  // 'none' — honor an explicit custom backgroundColor, else fully transparent.\n  return { backgroundColor: backgroundColor ?? 'transparent' };\n}\n\n// Group words into pages of ~1.5s each — long enough to read comfortably,\n// short enough to stay in sync with speech.\nconst COMBINE_TOKENS_MS = 1500;\n\n// How long a caption lingers past its last spoken word before clearing. Bridges\n// the sub-second gaps between pages WITHIN speech (no blink) while still clearing\n// during the multi-second silences between sentences (no frozen fragment).\nconst CAPTION_LINGER_MS = 600;\n\n/** Per-token emphasis info for accurate layout measurement. */\ninterface EmphasisLayout {\n  emphasisSet: Set<number>;\n  emphasisScale: number;\n  emphasisFontFamily?: string;\n  emphasisFontWeight: number;\n}\n\n/** Add one token to a fillTextBox with emphasis-aware sizing — the single\n *  measurement both line-wrapping (`layoutTokensIntoLines`) and page-fit\n *  testing (`makeBoxFactory`) share, so pagination and layout never disagree. */\nfunction addTokenToBox(\n  box: ReturnType<typeof fillTextBox>,\n  token: TikTokToken,\n  fontFamily: string,\n  fontSize: number,\n  fontWeight: number,\n  emphasis?: EmphasisLayout,\n): ReturnType<ReturnType<typeof fillTextBox>['add']> {\n  const isEmp = emphasis?.emphasisSet.has(token.fromMs) ?? false;\n  const tokenSize = isEmp ? Math.round(fontSize * (emphasis?.emphasisScale ?? 1.2)) : fontSize;\n  const tokenWeight = isEmp ? (emphasis?.emphasisFontWeight ?? 900) : fontWeight;\n  const tokenFamily = isEmp ? (emphasis?.emphasisFontFamily ?? fontFamily) : fontFamily;\n  return box.add({\n    text: token.text,\n    fontFamily: tokenFamily,\n    fontSize: tokenSize,\n    fontWeight: String(tokenWeight),\n  });\n}\n\n/** A `FitBox` factory for `paginateCaptionSegments`: each call returns a fresh\n *  incremental 3-line box whose `add(token)` reports whether the box still fits\n *  with that token appended. Sharing `addTokenToBox` keeps pagination's fit\n *  decision identical to `layoutTokensIntoLines`' wrapping. */\nfunction makeBoxFactory(\n  maxWidth: number,\n  fontFamily: string,\n  fontSize: number,\n  fontWeight: number,\n  emphasis?: EmphasisLayout,\n): () => FitBox {\n  return () => {\n    const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });\n    return {\n      add: (token: TikTokToken) =>\n        !addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis).exceedsBox,\n    };\n  };\n}\n\n/** Split tokens into measured lines using fillTextBox for proper word wrapping.\n *  Pagination guarantees the page fits 3 lines, so no token is dropped here. */\nfunction layoutTokensIntoLines(\n  tokens: TikTokToken[],\n  maxWidth: number,\n  fontFamily: string,\n  fontSize: number,\n  fontWeight: number,\n  emphasis?: EmphasisLayout,\n): TikTokToken[][] {\n  const box = fillTextBox({ maxBoxWidth: maxWidth, maxLines: 3 });\n  const lines: TikTokToken[][] = [[]];\n\n  for (const token of tokens) {\n    const result = addTokenToBox(box, token, fontFamily, fontSize, fontWeight, emphasis);\n\n    if (result.newLine) {\n      lines.push([token]);\n    } else {\n      lines[lines.length - 1].push(token);\n    }\n  }\n\n  return lines.filter((line) => line.length > 0);\n}\n\n/**\n * TikTok/Hormozi-style word-level captions layer.\n *\n * Drives `@remotion/captions`'s `createTikTokStyleCaptions` with a\n * pre-timed word stream, paginates ~1.5s at a time, highlights the\n * active token, and applies per-token emphasis (separate font/scale/\n * color/weight) when `CaptionWord.emphasis` is set.\n *\n * Fonts are NOT loaded by this component — the caller (editor's\n * `Root.tsx` or the worker render bundle's bootstrap) is responsible\n * for ensuring `style.fontFamily` is loaded before the bundle renders.\n */\nexport function Captions({\n  segments,\n  style: userStyle,\n  region,\n}: {\n  /**\n   * Authored caption SEGMENTS. Each segment is a hard caption-page boundary:\n   * pagination runs within a segment and never pools words across two, so\n   * sentence-bounded segments cut captions at sentence ends.\n   */\n  segments: CaptionWord[][];\n  style?: Partial<CaptionStyle>;\n  /**\n   * Floor-resolved caption band (output fractions). When set, the caption sits\n   * with its BOTTOM edge at `region.y + region.h` — i.e. clear of the platform's\n   * bottom-UI strip — instead of the fixed `style.position` offset. Horizontal\n   * stays centred (the short-form convention); only the vertical clearance is\n   * taken from the floor. See composition-model `resolveCaptionRegion`.\n   */\n  region?: { y: number; h: number };\n}) {\n  const frame = useCurrentFrame();\n  const { fps, width, height } = useVideoConfig();\n  const style = { ...DEFAULT_STYLE, ...userStyle };\n  // Emphasis defaults punch by WEIGHT, barely by size (launch-film default —\n  // the 900/1.2 pop is a kit choice via captionProfile, not the floor).\n  const emphasisScale = style.emphasisScale ?? 1.08;\n  const emphasisColor = style.emphasisColor ?? style.highlightColor;\n  const emphasisFontFamily = style.emphasisFontFamily;\n  const emphasisFontWeight = style.emphasisFontWeight ?? 800;\n  const emphasisTextTransform = style.emphasisTextTransform ?? style.textTransform;\n  const emphasisLetterSpacing = style.emphasisLetterSpacing ?? 0;\n  const emphasisFontStyle = style.emphasisFontStyle ?? 'normal';\n  const entrance = style.entrance ?? 'none';\n  const entranceFrames = Math.max(1, Math.round(((style.entranceMs ?? 160) / 1000) * fps));\n  const staggerFrames = Math.max(0, Math.round(((style.entranceStaggerMs ?? 90) / 1000) * fps));\n  const exitMs = style.exitMs ?? 0;\n  const emphasisPlate = style.emphasisPlate ?? false;\n  const plateColor = style.emphasisPlateColor ?? emphasisColor;\n  const plateTextColor = style.emphasisPlateTextColor ?? palette.TEXT_HI;\n  const plateAltColor = style.emphasisPlateAltColor ?? plateColor;\n  const plateAltTextColor = style.emphasisPlateAltTextColor ?? plateTextColor;\n  const plateRadius = style.emphasisPlateRadius ?? 6;\n  const platePadX = style.emphasisPlatePadX ?? 0.16;\n  const platePadY = style.emphasisPlatePadY ?? 0.04;\n  const annotationColor = style.annotationColor ?? palette.VIOLET;\n  const maxWidthPercent = style.maxWidthPercent ?? 80;\n  const plateStyle = plateStyleFor(style.plate ?? 'glass', style.backgroundColor);\n\n  const fontSize = Math.round(height * (style.fontSize / 100));\n  const maxTextWidth = width * (maxWidthPercent / 100);\n\n  // Emphasis / annotation lookup maps (keyed by startMs === token.fromMs).\n  // Frame-independent → memoized on `segments` so it runs once per render.\n  const { emphasisStartMs, annotateKind } = useMemo(() => {\n    const emph = new Set<number>();\n    const ann = new Map<number, 'circle' | 'underline'>();\n    for (const w of segments.flat()) {\n      if (w.emphasis) emph.add(w.startMs);\n      if (w.annotate) ann.set(w.startMs, w.annotate);\n    }\n    return { emphasisStartMs: emph, annotateKind: ann };\n  }, [segments]);\n\n  const emphasisLayout: EmphasisLayout | undefined = useMemo(\n    () =>\n      emphasisStartMs.size > 0\n        ? { emphasisSet: emphasisStartMs, emphasisScale, emphasisFontFamily, emphasisFontWeight }\n        : undefined,\n    [emphasisStartMs, emphasisScale, emphasisFontFamily, emphasisFontWeight],\n  );\n\n  // Paginate PER SEGMENT (segment = hard page break) into TikTok-style pages,\n  // splitting an over-dense page into sub-pages (never dropping words) and\n  // stitching the track contiguous so captions linger through inter-sentence\n  // pauses. Memoized on the frame-independent inputs so the fillTextBox\n  // measurement runs ONCE per render instead of on every frame.\n  const pages = useMemo(\n    () =>\n      paginateCaptionSegments(segments, {\n        combineMs: COMBINE_TOKENS_MS,\n        makeBox: makeBoxFactory(maxTextWidth, style.fontFamily, fontSize, style.fontWeight, emphasisLayout),\n        lingerMs: CAPTION_LINGER_MS,\n      }),\n    [segments, maxTextWidth, fontSize, style.fontFamily, style.fontWeight, emphasisLayout],\n  );\n\n  if (pages.length === 0) return null;\n\n  // Find the current page based on frame time\n  const currentTimeMs = (frame / fps) * 1000;\n  const currentPage = pages.find(\n    (p) => currentTimeMs >= p.startMs && currentTimeMs < p.startMs + p.durationMs\n  );\n  if (!currentPage) return null;\n\n  // Find active token\n  const activeToken = currentPage.tokens.find(\n    (t) => currentTimeMs >= t.fromMs && currentTimeMs < t.toMs\n  );\n\n  // Per-word entrance: each token enters on its own spoken beat, with a minimum\n  // stagger so two words never pop together. Map token → global start frame.\n  const tokenStartFrame = new Map<TikTokToken, number>();\n  if (entrance !== 'none') {\n    let minNext = -Infinity;\n    for (const t of currentPage.tokens) {\n      const s = Math.max(Math.round((t.fromMs / 1000) * fps), minNext);\n      tokenStartFrame.set(t, s);\n      minNext = s + staggerFrames;\n    }\n  }\n\n  // Phrase exit: fade the whole group over the page's last `exitMs` before the\n  // next page builds fresh (a clean cut when exitMs is 0).\n  const pageEnd = currentPage.startMs + currentPage.durationMs;\n  const groupOpacity =\n    exitMs > 0\n      ? interpolate(currentTimeMs, [pageEnd - exitMs, pageEnd], [1, 0], {\n          extrapolateLeft: 'clamp',\n          extrapolateRight: 'clamp',\n        })\n      : 1;\n\n  // Wrap tokens into measured lines (emphasis-aware sizing). Pagination already\n  // guaranteed this page fits 3 lines, so no token is dropped.\n  const lines = layoutTokensIntoLines(\n    currentPage.tokens,\n    maxTextWidth,\n    style.fontFamily,\n    fontSize,\n    style.fontWeight,\n    emphasisLayout,\n  );\n\n  // Placement. A full-width, structurally-centred band anchored vertically by the\n  // floor-resolved `region` (else the style.position preset) — see\n  // resolveCaptionPlacement. Horizontal centring lives on the WRAPPER\n  // (justifyContent), NOT on the content box, so it can never depend on the\n  // content's shrink-to-fit width and the content box's `maxWidth` binds against\n  // the FULL frame (matching the pagination measurement, `maxTextWidth`).\n  const wrapperStyle = resolveCaptionPlacement(style.position, region);\n\n  return (\n    <AbsoluteFill style={{ pointerEvents: 'none' }}>\n      <div style={wrapperStyle}>\n        <div\n          style={{\n            opacity: groupOpacity,\n            display: 'flex',\n            flexDirection: 'column',\n            alignItems: 'center',\n            gap: `${fontSize * 0.25}px`,\n            padding: `${fontSize * 0.4}px ${fontSize * 0.8}px`,\n            borderRadius: fontSize * 0.5,\n            ...plateStyle,\n            maxWidth: `${maxWidthPercent}%`,\n            boxSizing: 'border-box',\n          }}\n        >\n        {(() => {\n          // plate colour alternates per emphasis run across the whole caption\n          let plateIdx = 0;\n          // Per-run entrance on the run's first spoken beat. The brand's motion\n          // identity selects the treatment; all three share the per-word stagger\n          // scaffold above (tokenStartFrame), differing only in the transform:\n          //   'word-pop'   — cubic-fade opacity + spring scale-settle.\n          //   'fade'       — cubic-fade opacity only.\n          //   'stagger-up' — cubic-fade opacity + upward translate.\n          //   'none'       — static (handled by the `entrance === 'none'` guard).\n          // SOFT: an unknown entrance falls through to the calibrated default\n          // (static), never throws.\n          const RISE_PX = fontSize * 0.4;\n          const easeOpacity = (start: number) =>\n            interpolate(frame, [start, start + entranceFrames], [0, 1], {\n              extrapolateLeft: 'clamp',\n              extrapolateRight: 'clamp',\n              easing: Easing.out(Easing.cubic),\n            });\n          const entranceOf = (\n            first: TikTokToken,\n            isEmph: boolean,\n          ): { opacity: number; scale: number; y: number } => {\n            if (entrance === 'none') return { opacity: 1, scale: 1, y: 0 };\n            const start = tokenStartFrame.get(first) ?? 0;\n            if (entrance === 'word-pop') {\n              const { opacity, scale } = wordPop(frame, fps, start, entranceFrames, isEmph ? 0.86 : 0.92);\n              return { opacity, scale, y: 0 };\n            }\n            if (entrance === 'stagger-up') {\n              const y = interpolate(frame, [start, start + entranceFrames], [RISE_PX, 0], {\n                extrapolateLeft: 'clamp',\n                extrapolateRight: 'clamp',\n                easing: Easing.out(Easing.cubic),\n              });\n              return { opacity: easeOpacity(start), scale: 1, y };\n            }\n            if (entrance === 'fade') {\n              return { opacity: easeOpacity(start), scale: 1, y: 0 };\n            }\n            // Unknown entrance → calibrated default (no animation).\n            return { opacity: 1, scale: 1, y: 0 };\n          };\n          return lines.map((line, lineIdx) => {\n            // group contiguous emphasis tokens into one plated run (so e.g.\n            // \"One Zuck\" shares a single plate); everything else is its own run.\n            const segs: { tokens: TikTokToken[]; emph: boolean }[] = [];\n            for (const t of line) {\n              const e = emphasisStartMs.has(t.fromMs);\n              const last = segs[segs.length - 1];\n              if (emphasisPlate && e && last && last.emph) last.tokens.push(t);\n              else segs.push({ tokens: [t], emph: e });\n            }\n            return (\n              <div key={lineIdx} style={{ display: 'flex', justifyContent: 'center', alignItems: 'baseline', gap: `${fontSize * 0.35}px` }}>\n                {segs.map((seg, si) => {\n                  const first = seg.tokens[0];\n                  const { opacity, scale, y } = entranceOf(first, seg.emph);\n                  const entranceTransform = `translateY(${y}px) scale(${scale})`;\n                  const annKind = seg.tokens.map((t) => annotateKind.get(t.fromMs)).find(Boolean);\n                  let markerP = 1;\n                  if (annKind && entrance !== 'none') {\n                    const ms = (tokenStartFrame.get(first) ?? 0) + Math.round(fps * 0.14);\n                    markerP = interpolate(frame, [ms, ms + Math.round(fps * 0.32)], [0, 1], { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });\n                  }\n\n                  // emphasis run on a highlighter plate\n                  if (seg.emph && emphasisPlate) {\n                    const idx = plateIdx++;\n                    const bg = idx % 2 === 0 ? plateColor : plateAltColor;\n                    const fg = idx % 2 === 0 ? plateTextColor : plateAltTextColor;\n                    const efs = Math.round(fontSize * emphasisScale);\n                    return (\n                      <span key={si} style={{ position: 'relative', display: 'inline-block', opacity, transform: entranceTransform, transformOrigin: 'center' }}>\n                        <span\n                          style={{\n                            display: 'inline-block',\n                            background: bg,\n                            color: fg,\n                            borderRadius: plateRadius,\n                            padding: `${Math.round(efs * platePadY)}px ${Math.round(efs * platePadX)}px`,\n                            fontFamily: emphasisFontFamily ?? style.fontFamily,\n                            fontSize: efs,\n                            fontWeight: emphasisFontWeight,\n                            fontStyle: emphasisFontStyle,\n                            textTransform: emphasisTextTransform,\n                            letterSpacing: emphasisLetterSpacing ? `${emphasisLetterSpacing}px` : undefined,\n                            lineHeight: 1.0,\n                            whiteSpace: 'nowrap',\n                          }}\n                        >\n                          {seg.tokens.map((t) => t.text.trim()).join(' ')}\n                        </span>\n                        {annKind ? <Marker spec={{ kind: annKind, color: annotationColor }} progress={markerP} /> : null}\n                      </span>\n                    );\n                  }\n\n                  // plain token (connective, or emphasis when plates are off)\n                  const token = first;\n                  const isActive = token === activeToken;\n                  const isEmphasis = seg.emph;\n                  const tokenFontSize = isEmphasis ? Math.round(fontSize * emphasisScale) : fontSize;\n                  const tokenWeight = isEmphasis ? emphasisFontWeight : style.fontWeight;\n                  const tokenFamily = isEmphasis ? (emphasisFontFamily ?? style.fontFamily) : style.fontFamily;\n                  const tokenTransform = isEmphasis ? emphasisTextTransform : style.textTransform;\n                  const tokenLetterSpacing = isEmphasis && emphasisLetterSpacing ? `${emphasisLetterSpacing}px` : undefined;\n                  const tokenFontStyle = isEmphasis ? emphasisFontStyle : 'normal';\n                  let tokenColor = style.color;\n                  if (isActive && !emphasisPlate) tokenColor = style.highlightColor;\n                  else if (isEmphasis) tokenColor = emphasisColor;\n                  // 'gradient' fill axis: emphasis text painted with a CSS gradient (bg-clip-text)\n                  const gradientFill: React.CSSProperties =\n                    isEmphasis && style.emphasisGradient\n                      ? fillStyle({ kind: 'gradient', value: style.emphasisGradient })\n                      : {};\n                  const inner = (\n                    <span\n                      style={{\n                        fontFamily: tokenFamily,\n                        fontSize: tokenFontSize,\n                        fontWeight: tokenWeight,\n                        fontStyle: tokenFontStyle,\n                        color: tokenColor,\n                        textTransform: tokenTransform,\n                        letterSpacing: tokenLetterSpacing,\n                        display: 'inline-block',\n                        ...gradientFill,\n                      }}\n                    >\n                      {emphasisPlate ? token.text.trim() : token.text}\n                    </span>\n                  );\n                  return (\n                    <span key={si} style={{ position: 'relative', display: 'inline-block', opacity, transform: entranceTransform, transformOrigin: 'center' }}>\n                      {inner}\n                      {annKind ? <Marker spec={{ kind: annKind, color: annotationColor }} progress={markerP} /> : null}\n                    </span>\n                  );\n                })}\n              </div>\n            );\n          });\n        })()}\n        </div>\n      </div>\n    </AbsoluteFill>\n  );\n}\n","import { createTikTokStyleCaptions } from '@remotion/captions';\nimport type { Caption, TikTokPage, TikTokToken } from '@remotion/captions';\nimport type { CaptionWord } from '@cueframe/core/render';\n\n/** An incremental, stateful fit measurer: `add(token)` returns whether the\n *  caption box still fits with that token appended. A fresh box starts empty.\n *  Injected so the component measures with real `fillTextBox` font metrics while\n *  tests stay deterministic — and so splitting measures each token ONCE\n *  (O(n)) instead of re-measuring the whole prefix per token (O(n²)). */\nexport interface FitBox {\n  add: (token: TikTokToken) => boolean;\n}\n\n/**\n * Turn authored caption SEGMENTS into renderable pages.\n *\n * Guarantees the old flat-paginate didn't make:\n *   1. **Segment boundaries are hard page breaks.** `createTikTokStyleCaptions`\n *      runs PER SEGMENT, so a page never pools words across two segments.\n *      Author sentence-bounded segments (`splitIntoSentences`) → captions cut at\n *      sentence ends.\n *   2. **No word is dropped, no blank gaps.** A page too dense for the box is\n *      split into sub-pages (not truncated), and the whole track is stitched\n *      contiguous — each page lingers until the next begins, so captions don't\n *      blink off during the pause between sentences (per-segment paging would\n *      otherwise end each sentence at its last word). The final page ends at its\n *      last word. Pages that would share a start time fold together rather than\n *      producing a zero-duration (invisible) page.\n */\nexport function paginateCaptionSegments(\n  segments: CaptionWord[][],\n  opts: { combineMs: number; makeBox: () => FitBox; lingerMs: number },\n): TikTokPage[] {\n  const raw: Array<{ startMs: number; tokens: TikTokToken[] }> = [];\n  for (const words of segments) {\n    if (words.length === 0) continue;\n    // Prepend a space to every word but the segment's first so\n    // createTikTokStyleCaptions detects word boundaries (it keys on\n    // text.startsWith(' ')).\n    const rc: Caption[] = words.map((word, i) => ({\n      text: i === 0 ? word.text : ` ${word.text}`,\n      startMs: word.startMs,\n      endMs: word.endMs,\n      timestampMs: null,\n      confidence: null,\n    }));\n    const { pages } = createTikTokStyleCaptions({\n      captions: rc,\n      combineTokensWithinMilliseconds: opts.combineMs,\n    });\n    for (const page of pages) raw.push(...splitPageToFit(page, opts.makeBox));\n  }\n  return assignTimeline(raw, opts.lingerMs);\n}\n\n/**\n * Split one page into groups each satisfying the box, greedily and in O(n): one\n * incremental box is fed token-by-token; when a token would overflow, the group\n * closes and a fresh box starts with it. A single token that cannot fit on its\n * own is still emitted (a word is indivisible). Returns groups with only their\n * start time; durations are assigned globally in `assignTimeline`.\n */\nfunction splitPageToFit(\n  page: TikTokPage,\n  makeBox: () => FitBox,\n): Array<{ startMs: number; tokens: TikTokToken[] }> {\n  // Fast path: the whole page fits.\n  const probe = makeBox();\n  if (page.tokens.every((t) => probe.add(t))) {\n    return [{ startMs: page.startMs, tokens: page.tokens }];\n  }\n\n  const groups: TikTokToken[][] = [];\n  let box = makeBox();\n  let cur: TikTokToken[] = [];\n  for (const token of page.tokens) {\n    if (cur.length === 0) {\n      cur.push(token);\n      box.add(token); // place at least one token — a word is indivisible\n    } else if (box.add(token)) {\n      cur.push(token);\n    } else {\n      groups.push(cur);\n      box = makeBox();\n      cur = [token];\n      box.add(token);\n    }\n  }\n  if (cur.length > 0) groups.push(cur);\n\n  return groups.map((tokens, i) => ({\n    startMs: i === 0 ? page.startMs : tokens[0].fromMs,\n    tokens,\n  }));\n}\n\n/**\n * Lay raw pages onto a strictly-increasing timeline. Each page shows until\n * `lingerMs` after its last spoken word, capped at the next page's start:\n *   - within speech (next page sooner than lastWord+lingerMs) → contiguous, no\n *     blink between consecutive pages;\n *   - across a long silent gap (next page later than lastWord+lingerMs) → the\n *     caption CLEARS lingerMs after the last word instead of freezing the\n *     fragment on screen for the whole multi-second pause;\n *   - the final caption lingers lingerMs past its last word (no instant snap).\n * Pages that would share a start time fold together (two words at the same time\n * can't be shown sequentially) so no page is ever zero-duration.\n */\nfunction assignTimeline(\n  raw: Array<{ startMs: number; tokens: TikTokToken[] }>,\n  lingerMs: number,\n): TikTokPage[] {\n  const merged: Array<{ startMs: number; tokens: TikTokToken[] }> = [];\n  for (const p of raw) {\n    const prev = merged[merged.length - 1];\n    if (prev && p.startMs <= prev.startMs) {\n      prev.tokens.push(...p.tokens);\n    } else {\n      merged.push({ startMs: p.startMs, tokens: [...p.tokens] });\n    }\n  }\n\n  return merged.map((p, i) => {\n    const lastWordEnd = Math.max(...p.tokens.map((t) => t.toMs));\n    const cleared = lastWordEnd + lingerMs;\n    const endMs = i < merged.length - 1 ? Math.min(merged[i + 1].startMs, cleared) : cleared;\n    return {\n      text: p.tokens.map((t) => t.text).join(''),\n      startMs: p.startMs,\n      durationMs: Math.max(1, endMs - p.startMs),\n      tokens: p.tokens,\n    };\n  });\n}\n","/**\n * Caption container PLACEMENT — pure, render-harness-free CSS math.\n *\n * The caption block is centred horizontally and anchored vertically (a floor-\n * resolved `region`'s bottom edge, else the `style.position` preset). Kept in its\n * own module (no React/Remotion imports beyond the CSSProperties type) so the\n * placement is unit-testable without a render harness — mirrors the cardMotion.ts\n * / CropFromTrajectory pure-helper precedent.\n *\n * WHY A FULL-WIDTH WRAPPER (not `left:50% + translateX(-50%)` on the content box):\n * the old approach positioned the CONTENT box itself with `left:50%` and no\n * `width`/`right`, so its shrink-to-fit *available* width was capped at `100% −\n * left = 50%` of the frame. An authored `maxWidthPercent` above 50 was therefore\n * silently clamped to 50% — the box (and its plate) came out NARROWER than\n * authored while pagination still MEASURED text at the full `maxWidthPercent`\n * (`maxTextWidth = width * maxWidthPercent/100`), so wide phrases overflowed the\n * plate and the centring depended on the content's own width. This wrapper makes\n * horizontal centring STRUCTURAL (`left:0; right:0; justifyContent:center`), so it\n * is independent of the content width, and the content box's `maxWidth` now binds\n * against the FULL frame — matching the pagination measurement exactly.\n */\n\nimport type { CSSProperties } from 'react';\n\n/**\n * The absolutely-positioned, full-width, horizontally-centred band the caption\n * content box sits inside. Vertical anchor:\n *   - `region` (floor-resolved) WINS: the band's BOTTOM edge sits at\n *     `region.y + region.h` (clear of the platform bottom-UI strip).\n *   - else the `position` preset: 'top' → 8% from top, 'center' → vertical\n *     centre (translateY only — horizontal is structural), 'bottom'/default →\n *     10% from bottom.\n */\nexport function resolveCaptionPlacement(\n  position: 'top' | 'center' | 'bottom' | undefined,\n  region: { y: number; h: number } | undefined,\n): CSSProperties {\n  const vertical: CSSProperties = region\n    ? { bottom: `${Math.max(0, (1 - (region.y + region.h)) * 100)}%` }\n    : position === 'top'\n      ? { top: '8%' }\n      : position === 'center'\n        ? { top: '50%', transform: 'translateY(-50%)' }\n        : { bottom: '10%' };\n  return {\n    position: 'absolute',\n    left: 0,\n    right: 0,\n    display: 'flex',\n    justifyContent: 'center',\n    ...vertical,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/_members/primitives/captions/paginate.d.ts

@@ -0,0 +1,31 @@
+import type { TikTokPage, TikTokToken } from '@remotion/captions';
+import type { CaptionWord } from '../../core/render/index.js';
+/** An incremental, stateful fit measurer: `add(token)` returns whether the
+ *  caption box still fits with that token appended. A fresh box starts empty.
+ *  Injected so the component measures with real `fillTextBox` font metrics while
+ *  tests stay deterministic — and so splitting measures each token ONCE
+ *  (O(n)) instead of re-measuring the whole prefix per token (O(n²)). */
+export interface FitBox {
+    add: (token: TikTokToken) => boolean;
+}
+/**
+ * Turn authored caption SEGMENTS into renderable pages.
+ *
+ * Guarantees the old flat-paginate didn't make:
+ *   1. **Segment boundaries are hard page breaks.** `createTikTokStyleCaptions`
+ *      runs PER SEGMENT, so a page never pools words across two segments.
+ *      Author sentence-bounded segments (`splitIntoSentences`) → captions cut at
+ *      sentence ends.
+ *   2. **No word is dropped, no blank gaps.** A page too dense for the box is
+ *      split into sub-pages (not truncated), and the whole track is stitched
+ *      contiguous — each page lingers until the next begins, so captions don't
+ *      blink off during the pause between sentences (per-segment paging would
+ *      otherwise end each sentence at its last word). The final page ends at its
+ *      last word. Pages that would share a start time fold together rather than
+ *      producing a zero-duration (invisible) page.
+ */
+export declare function paginateCaptionSegments(segments: CaptionWord[][], opts: {
+    combineMs: number;
+    makeBox: () => FitBox;
+    lingerMs: number;
+}): TikTokPage[];