@cueframe/kernel 0.1.0 → 0.1.2

package/dist/_members/perception/visualQuality.d.ts

@@ -1,86 +1,13 @@
-/**
- * @cueframe/perception — `visualQuality` signal provider (per-source image quality
- * FACT).
- *
- * A DECISION-FREE measurement (perception is a leaf — it produces a FACT, never a
- * choice): per-source image quality — SHARPNESS (focus) + EXPOSURE sanity — over a
- * window, calibrated to an ABSOLUTE [0,1] scalar so the Selector core can prefer the
- * cleanest angle (selector-abstraction spec §1.2, the `visualQuality` signal; §9.1
- * P6, the fancam/CrowdCut signal — don't cut to a blurry/blown-out angle).
- *
- * Perception NEVER imports the Selector core (the rot-guard direction): this module
- * emits a plain `{ value, rawScore, confidence, evidence }` envelope that STRUCTURALLY
- * matches `@cueframe/core`'s `Signal`, but the type lives here (a leaf owns its own
- * fact shape; the core projects it). Adding/upgrading the analysis = a version stamp
- * here; the core is untouched.
- *
- * LOCALLY COMPUTABLE — NO MODAL (spec §9.1 P6 scope-2, the CRITICAL constraint): the
- * raw measurement is CHEAP image statistics — SHARPNESS via the variance of the
- * Laplacian (a classic blur metric: a focused frame has a high Laplacian variance, a
- * blurred one a low variance) + EXPOSURE via mean luma / clipped-pixel fraction
- * (under/over-exposed frames are a quality DEFECT). Both are a single decode + a
- * convolution/histogram with NO GPU model — so the no-deploy CrowdCut validation can
- * derive them host-side (the local node helper `frameStats.ts`, like `audioAnalysis.ts`
- * for audioQuality). The pure CALIBRATION here is identical whether the metrics come
- * from the local frame harness or a future Modal skill — the interface, not a fork.
- *
- * This module is the PURE FACT CONTRACT (perception is a leaf — NO node I/O here):
- *  - `visualQualitySignal(metrics)` — PURE: maps the raw per-source image metrics
- *    (Laplacian-variance sharpness, mean luma, clipped fraction) to the absolute
- *    [0,1] value + reasons.
- *
- * `null` on an UNDECODABLE source (no frame to measure) — NEVER 0 (absence ≠ a bad
- * picture; a weight over an all-null visualQuality fails loud upstream, never reads
- * as "definitely low quality" — feedback_never_add_fallbacks).
- *
- * Pure + deterministic.
- */
-/** Bump when the metrics→value calibration changes (the 3-stamp lesson — a stale
- *  cached visualQuality is served if a consumer doesn't bump alongside). */
 export declare const VISUAL_QUALITY_VERSION = "visual-quality-v1-2026.06.21";
-/** The raw per-source image metrics — what BOTH the local frame-stats harness
- *  (`frameStats.ts`) and the future Modal skill measure (a representative/median
- *  frame, or a windowed mean). Source-independent absolutes, never normalized
- *  across angles (the cross-source comparison is the Selector's job). */
 export interface VisualQualityMetrics {
-    /** Variance of the Laplacian of the luma channel (luma normalized to [0,1]).
-     *  HIGH = sharp/in-focus; LOW = blurred/out-of-focus. The classic blur metric. */
     laplacianVariance: number;
-    /** Mean luma ∈ [0,1] (exposure level). ~0.45 is well-exposed; near 0 (crushed)
-     *  or near 1 (blown out) is under/over-exposed. */
     meanLuma: number;
-    /** Fraction ∈ [0,1] of pixels at the extremes (pure black or pure white) — a
-     *  clipping proxy. High = blown highlights / crushed blacks (a defect). Optional;
-     *  absent leans on `meanLuma` alone. */
     clippedFraction?: number;
 }
-/** Matches `@cueframe/core`'s `Signal` shape STRUCTURALLY (perception owns its
- *  fact; the core projects `value`/`confidence`). */
 export interface VisualQualitySignal {
-    /** ABSOLUTE, calibrated ∈ [0,1] — "how clean is this angle's image" (sharp +
-     *  well-exposed), source-independent. The crispest, best-exposed angle scores
-     *  highest. */
     value: number;
-    /** Pre-calibration raw (the Laplacian variance) for legibility + recalibration. */
     rawScore: number;
     confidence: number;
-    /** Reasons-only ("sharpness 0.81, exposure 0.93"); excluded from any hash. */
     evidence: string;
 }
-/**
- * Map raw image metrics → the absolute [0,1] visualQuality value (PURE).
- *
- * Returns `null` — NOT 0 — when the source is UNDECODABLE (no frame measured):
- * pass `undefined` for an angle whose frame the harness could not read. `null` is
- * "not measured" (absence); a weight over an all-null visualQuality is fail-loud
- * upstream (`selector_signal_absent`), never silently 0. A real measurement of a
- * blurry frame returns a genuine LOW value (e.g. 0.05) — that DOES suppress a cut.
- *
- * Calibration (absolute, NOT softmax-across-angles):
- *  - SHARPNESS: a piecewise-linear ramp from BLUR_VAR (→ 0) to SHARP_VAR (→ 1).
- *  - EXPOSURE: a sanity multiplier — full when `meanLuma` is near IDEAL_LUMA, falling
- *    off toward crushed/blown, with a hard clip-fraction penalty. A sharp-but-blown
- *    frame loses to a sharp well-exposed one.
- *  - value = sharpness · exposure (a blurry OR a blown frame both score low).
- */
 export declare function visualQualitySignal(m: VisualQualityMetrics | undefined): VisualQualitySignal | null;

package/dist/_members/plane/conformance.d.ts

@@ -1,75 +1,16 @@
-/**
- * THE LANE CONFORMANCE TABLE — one set of facts, executed by both lanes.
- *
- * WHY THIS FILE EXISTS. `preview_frame` is served twice: by the desktop plane
- * (`apps/studio/src/plane/handlers.ts`, drawing through the webview) and by the
- * cloud route (`the `/v1/evidence` routes`, rendering through
- * Modal). Nothing made them agree. The only mechanism was review discipline —
- * comments like *"ALLOWED_KEYS TRACKS THAT SCHEMA … Add server-side keys here in
- * the same change"* — and on 2026-08-15 that mechanism was observed failing:
- *
- *   asked for a still 6 seconds past the end of a 45s composition,
- *     cloud → 422 timestamp_out_of_bounds
- *     local → 200, silently returning the LAST frame
- *
- * The founder's agent read those identical-looking 200s as evidence about its
- * own composition, concluded the renderer was clamping, and abandoned a correct
- * line of work. A wrong pixel is worse than an error, and this is how they get
- * shipped: not by writing bad code, but by adding a rule to one lane.
- *
- * WHAT THIS IS. Fixtures + expectations as DATA, with no knowledge of either
- * lane. Each lane owns a thin runner that maps a row onto its own invocation
- * (`planeConformance.test.ts` in the app, `evidence.conformance.test.ts` in
- * convex). Deliberately not a shared test *runner*: the two suites live in
- * different vitest roots with different harnesses, and forcing one process to
- * host both would couple the desktop's test setup to Convex's.
- *
- * That split is the architecture in miniature — shared pure data, per-lane
- * adapters. See Projects/CueFrame/specs/2026-08-15-plane-lane-parity-design.
- *
- * ITS SIBLING, AND WHEN TO USE WHICH. Stateful STORES served by two lanes
- * (sqlite + Convex behind `DatabaseAdapter`) are held honest by a different
- * shape: a parameterised suite in
- * `packages/data-models/<domain>-model/src/testing/*Contract.ts`. A table like
- * this one cannot express them — a stateful fact reads "save this thrice, then
- * list, then count", and encoding that as data costs an op-script schema plus
- * an interpreter per lane. Rows work HERE because `preview_frame` is stateless:
- * the fixture travels in the request body. Same purpose, two shapes; CLAUDE.md
- * has the decision table.
- *
- * HOW A KNOWN DIVERGENCE IS RECORDED. `knownRed` names the lanes that fail the
- * row TODAY. A runner turns those into `test.fails()`, which asserts the test
- * does NOT pass — so the day someone fixes the lane, this row goes green,
- * `test.fails()` starts failing, and they are forced to delete the marker. A
- * skip would rot silently; this cannot.
- */
 import type { Composition } from "../composition/validators/index.js";
-/** Which implementation is answering. */
 export type Lane = "local" | "cloud";
 export interface ConformanceCase {
-    /** Test name. */
     readonly name: string;
-    /** Why this row is here — surfaced on failure, so a breakage explains itself. */
     readonly why: string;
-    /** The request body, verbatim. */
     readonly body: unknown;
-    /** What BOTH lanes must answer. */
     readonly expect: {
         readonly status: number;
-        /** For errors, the `error.code` both lanes must use. */
         readonly code?: string;
     };
-    /** Lanes known to fail this row today. Empty/absent ⇒ both must pass. */
     readonly knownRed?: readonly Lane[];
 }
-/**
- * ONE composition every row is judged against: 16:9 @ 30fps, five seconds of
- * media with a card over the first four. Duration is therefore 5s / 150 frames,
- * which is what makes the out-of-bounds row unambiguous.
- */
 export declare const CONFORMANCE_COMPOSITION: Composition;
-/** The composition's own duration, in seconds — derived once, used by the rows. */
 export declare const CONFORMANCE_DURATION_SEC = 5;
 export declare const PREVIEW_FRAME_CASES: readonly ConformanceCase[];
-/** Does this row currently fail on `lane`? */
 export declare function isKnownRed(c: ConformanceCase, lane: Lane): boolean;

package/dist/_members/plane/contract.d.ts

@@ -1,32 +1,3 @@
-/**
- * THE REQUEST CONTRACT — one definition, both servers.
- *
- * WHY THIS MOVED HERE. `preview_frame` had THREE definitions of its own body:
- * the Convex route's zod (what the cloud actually enforced), the orval-generated
- * `previewFrameBody` (what the SDK and every MCP client enforce), and a
- * hand-written imperative mirror in the desktop plane. Nothing made them agree,
- * and the only sync mechanism was review discipline — comments reading
- * "ALLOWED_KEYS TRACKS THAT SCHEMA … Add server-side keys here in the same
- * change". On 2026-08-15 that mechanism was observed failing in both directions
- * at once: the desktop silently ignored `imageFormat`/`jpegQuality` entirely,
- * while the PUBLISHED contract was `.strict()` and both servers were not — so
- * generated clients rejected keys that either server would have accepted.
- *
- * MOVED VERBATIM. Every `.describe()` string is preserved because the OpenAPI
- * spec — and therefore the generated SDK, the MCP tool schemas and the docs —
- * is built from this object (`requestBody: PreviewFrameRequest`). Rewording a
- * description here republishes the API.
- *
- * STRICTNESS IS DELIBERATELY UNCHANGED. This object ends `})`, not `}).strict()`,
- * exactly as the route defined it, so this extraction is a pure refactor with no
- * behaviour change on a live API. Whether the servers SHOULD be strict — and
- * match the contract they publish — is a product decision with outward-facing
- * consequences for existing callers, tracked as a red row in
- * `conformance.ts` rather than settled quietly here.
- *
- * PURE, because Convex runs this inside a V8 isolate and the desktop bundles it
- * into a webview. zod only; no I/O, no Node APIs.
- */
 import { z } from "zod";
 export declare const PreviewFrameRequest: z.ZodObject<{
     composition: z.ZodOptional<z.ZodUnknown>;

package/dist/_members/plane/index.d.ts

@@ -1,16 +1 @@
-/**
- * `@cueframe/plane` — the lane-agnostic core of the verb plane.
- *
- * TODAY this package holds only the conformance table (stage 0 of
- * Projects/CueFrame/specs/2026-08-15-plane-lane-parity-design): the shared facts
- * both the desktop plane and the Convex routes must agree on.
- *
- * IT IS DELIBERATELY PURE. Stage 2 adds the layers that belong here —
- * `preconditions` (is this request answerable against the composition) and
- * `describe` (assemble geometry / layers / etag) — both `f(request, state)` with
- * no I/O. Nothing effectful goes in this package: Convex runs it inside a V8
- * isolate, and the whole reason the pure layers can be shared while the
- * orchestration cannot is that pure functions degrade gracefully when the two
- * independently-deployed artifacts skew.
- */
 export * from "./conformance.js";

package/dist/_members/primitives/backgrounds/animated-bar-chart/index.d.ts

@@ -1,24 +1,11 @@
-/**
- * Adapted from remocn (https://github.com/kapishdima/remocn) — MIT
- * Copyright (c) 2026 KapishDima
- *
- * Modifications (0.2.0 rebuild — launch-video grade):
- *   - value labels count up with the bars; subtle horizontal gridlines
- *   - per-bar vertical gradient + peak-bar accent (the number that lands)
- *   - idle life after the entrance: gentle per-bar breathing on
- *     incommensurate frequencies (no more dead-after-entrance freeze)
- *   - refined defaults (indigo on blue-black, cyan peak) over neon-on-void
- */
 export interface AnimatedBarChartProps {
     data?: number[];
     labels?: string[];
     width?: number;
     height?: number;
     barColor?: string;
-    /** Accent for the peak (max value) bar. Same as barColor to disable. */
     accentColor?: string;
     background?: string;
-    /** Show counting value labels above bars (default true) */
     valueLabels?: boolean;
     gap?: number;
     staggerFrames?: number;

package/dist/_members/primitives/backgrounds/animated-line-chart/index.d.ts

@@ -1,26 +1,12 @@
-/**
- * Adapted from remocn (https://github.com/kapishdima/remocn) — MIT
- * Copyright (c) 2026 KapishDima
- *
- * Modifications (0.2.0 rebuild — launch-video grade):
- *   - gradient area fill under the line; horizontal-only grid (the full box
- *     grid read as graph paper)
- *   - endpoint value label counts up with the draw
- *   - idle life: the endpoint dot PULSES after the draw completes (it used to
- *     vanish at progress=1, freezing the chart dead)
- *   - refined defaults (indigo line, cyan endpoint on blue-black)
- */
 export interface AnimatedLineChartProps {
     data?: number[];
     width?: number;
     height?: number;
     strokeColor?: string;
-    /** Endpoint dot + value accent (default cyan) */
     accentColor?: string;
     strokeWidth?: number;
     background?: string;
     gridColor?: string;
-    /** Show the endpoint value counting up (default true) */
     endpointValue?: boolean;
     showDot?: boolean;
     speed?: number;

package/dist/_members/primitives/backgrounds/dither-gradient-bg/index.d.ts

@@ -1,25 +1,11 @@
 export interface DitherGradientBgProps {
-    /** Ink color of the dither dots. */
     color?: string;
-    /** Optional second ink — dots blend between the two along the field. */
     color2?: string;
-    /** Ground behind the dots. */
     background?: string;
-    /** Dither cell size in px at 1080p (default 8 — chunky, deliberate). */
     pixelSize?: number;
-    /** Base gradient direction in degrees (default -30). */
     angle?: number;
-    /** Drift speed multiplier. */
     speed?: number;
-    /** Field seed — different seeds give different dot layouts. */
     seed?: number;
     className?: string;
 }
-/**
- * Ordered-dither gradient — an animated luminance field quantized through a
- * Bayer 8×8 threshold matrix into hard pixel dots. The pixel-craft dev-tool
- * aesthetic: texture with intent, zero banding by construction, and the
- * anti-gradient-slop register between silk (organic) and mesh (soft).
- * Deterministic: pure function of (frame, params).
- */
 export declare function DitherGradientBg({ color, color2, background, pixelSize, angle, speed, seed, className, }: DitherGradientBgProps): import("react").JSX.Element;

package/dist/_members/primitives/backgrounds/dynamic-grid/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * 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 DynamicGridProps {
     cellSize?: number;
     lineColor?: string;

package/dist/_members/primitives/backgrounds/ecosystem-constellation/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * 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 EcosystemConstellationProps {
     satelliteCount?: number;
     centerLabel?: string;

package/dist/_members/primitives/backgrounds/infinite-marquee/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * 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 InfiniteMarqueeProps {
     text?: string;
     fontSize?: number;

package/dist/_members/primitives/backgrounds/mesh-gradient-bg/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * 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 MeshGradientBgProps {
     colors?: string[];
     speed?: number;

package/dist/_members/primitives/backgrounds/perspective-marquee/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * 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 PerspectiveMarqueeProps {
     items?: string[];
     fontSize?: number;

package/dist/_members/primitives/backgrounds/silk-flow-bg/index.d.ts

@@ -1,30 +1,13 @@
 export interface SilkFlowBgProps {
-    /** Thread hues. First = dominant (~70% of threads), rest = sparse accents. */
     colors?: string[];
-    /** Ground color (hex). Dark grounds get additive luminous threads; light grounds get ink-on-paper strokes. */
     background?: string;
-    /** Thread-count multiplier, 0.2–2 (default 1 ≈ 170 threads). */
     density?: number;
-    /** Motion speed multiplier — travelling light + silk sway. */
     speed?: number;
-    /** Bloom intensity 0–1. */
     glow?: number;
-    /** Film-grain opacity 0–0.3. */
     grain?: number;
-    /** Vignette strength 0–1. */
     vignette?: number;
-    /** Base flow direction in degrees (default -16 — a gentle up-right current). */
     angle?: number;
-    /** Field seed — different seeds give different silk layouts. */
     seed?: number;
     className?: string;
 }
-/**
- * Luminous flow-field silk. Fine threads are integrated as streamlines through
- * a seeded value-noise angle field; a slow time-varying sway bends the field so
- * the silk itself breathes, while a travelling shimmer moves light along each
- * thread. Bloom comes from re-blitting the scene through a blur — one scene
- * draw, two composites. Everything is a pure function of (frame, params):
- * deterministic across Lambda workers and preview.
- */
 export declare function SilkFlowBg({ colors, background, density, speed, glow, grain, vignette, angle, seed, className, }: SilkFlowBgProps): import("react").JSX.Element;

package/dist/_members/primitives/backgrounds/vector-field/index.d.ts

@@ -1,25 +1,11 @@
 export interface VectorFieldProps {
-    /** Number of embedding points (default 140). */
     pointCount?: number;
-    /** Base point color. */
     color?: string;
-    /** Query point + neighbor-edge accent. */
     accentColor?: string;
-    /** Ground. */
     background?: string;
-    /** Frame the query lands (default 40). */
     queryAt?: number;
-    /** Neighbors that light up (default 6). */
     neighbors?: number;
-    /** Layout seed. */
     seed?: number;
     className?: string;
 }
-/**
- * Embedding space, cinematized: a field of points drifts on incommensurate
- * frequencies; a query point drops in with a ring pulse, its k nearest
- * neighbors brighten and draw edges to it, and the local cluster leans
- * gently toward the query. Idle: edges shimmer, everything keeps drifting.
- * Deterministic canvas — a pure function of (frame, params).
- */
 export declare function VectorField({ pointCount, color, accentColor, background, queryAt, neighbors, seed, className, }: VectorFieldProps): import("react").JSX.Element;

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

@@ -1,11 +1,3 @@
-/**
- * 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;
@@ -17,14 +9,4 @@ export interface VolumetricRaysProps {
     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

@@ -1,31 +1,7 @@
 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;

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

@@ -1,17 +1,2 @@
-/**
- * @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/paginate.d.ts

@@ -1,29 +1,8 @@
 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;

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

@@ -1,34 +1,4 @@
-/**
- * Caption container PLACEMENT — pure, render-harness-free CSS math.
- *
- * The caption block is centred horizontally and anchored vertically (a floor-
- * resolved `region`'s bottom edge, else the `style.position` preset). Kept in its
- * own module (no React/Remotion imports beyond the CSSProperties type) so the
- * placement is unit-testable without a render harness — mirrors the cardMotion.ts
- * / CropFromTrajectory pure-helper precedent.
- *
- * WHY A FULL-WIDTH WRAPPER (not `left:50% + translateX(-50%)` on the content box):
- * the old approach positioned the CONTENT box itself with `left:50%` and no
- * `width`/`right`, so its shrink-to-fit *available* width was capped at `100% −
- * left = 50%` of the frame. An authored `maxWidthPercent` above 50 was therefore
- * silently clamped to 50% — the box (and its plate) came out NARROWER than
- * authored while pagination still MEASURED text at the full `maxWidthPercent`
- * (`maxTextWidth = width * maxWidthPercent/100`), so wide phrases overflowed the
- * plate and the centring depended on the content's own width. This wrapper makes
- * horizontal centring STRUCTURAL (`left:0; right:0; justifyContent:center`), so it
- * is independent of the content width, and the content box's `maxWidth` now binds
- * against the FULL frame — matching the pagination measurement exactly.
- */
 import type { CSSProperties } from 'react';
-/**
- * The absolutely-positioned, full-width, horizontally-centred band the caption
- * content box sits inside. Vertical anchor:
- *   - `region` (floor-resolved) WINS: the band's BOTTOM edge sits at
- *     `region.y + region.h` (clear of the platform bottom-UI strip).
- *   - else the `position` preset: 'top' → 8% from top, 'center' → vertical
- *     centre (translateY only — horizontal is structural), 'bottom'/default →
- *     10% from bottom.
- */
 export declare function resolveCaptionPlacement(position: 'top' | 'center' | 'bottom' | undefined, region: {
     y: number;
     h: number;

package/dist/_members/primitives/effects/blur/index.d.ts

@@ -1,29 +1,13 @@
 import React from 'react';
 type BlurType = 'gaussian' | 'motion';
 export interface BlurProps {
-    /** Blur type (default 'gaussian'). Motion blur adds directional stretching. */
     type?: BlurType;
-    /** Static blur radius in pixels (used when animateFrom/animateTo not set, default 4) */
     radius?: number;
-    /** Animate blur from this radius (in px) at frame 0 */
     animateFrom?: number;
-    /** Animate blur to this radius (in px) at the last frame */
     animateTo?: number;
-    /** Easing function for animation */
     easing?: (t: number) => number;
-    /** Content to apply blur to */
     children: React.ReactNode;
-    /** Additional wrapper style */
     style?: React.CSSProperties;
 }
-/**
- * Animatable blur effect.
- * Wraps children with CSS filter blur, optionally animating radius over time.
- *
- * Usage:
- *   <Blur animateFrom={10} animateTo={0}>
- *     <Img src="scene.jpg" />
- *   </Blur>
- */
 export declare const Blur: React.FC<BlurProps>;
 export {};

package/dist/_members/primitives/effects/color-grade/index.d.ts

@@ -1,35 +1,15 @@
 import React from 'react';
 type ColorGradePreset = 'vintage' | 'cinematic' | 'bleach-bypass' | 'sepia' | 'cool' | 'warm' | 'none';
 export interface ColorGradeProps {
-    /** Color grading preset (default 'none') */
     preset?: ColorGradePreset;
-    /** Brightness multiplier (default 1) */
     brightness?: number;
-    /** Contrast multiplier (default 1) */
     contrast?: number;
-    /** Saturation multiplier (default 1) */
     saturation?: number;
-    /** Hue rotation in degrees (default 0) */
     hue?: number;
-    /** Color temperature shift: positive = warm, negative = cool (default 0) */
     temperature?: number;
-    /** Grade strength 0..1 (default 1). Scales every filter delta toward neutral —
-     *  1 = the full preset, 0 = no grade. Use a mild value (~0.6) for an anchor
-     *  grade over a talking head so a strong preset doesn't shift skin tones. */
     intensity?: number;
-    /** Content to apply color grading to */
     children: React.ReactNode;
-    /** Additional wrapper style */
     style?: React.CSSProperties;
 }
-/**
- * CSS filter-based color grading.
- * Wraps children with preset or custom filter chain.
- *
- * Usage:
- *   <ColorGrade preset="cinematic">
- *     <Img src="scene.jpg" />
- *   </ColorGrade>
- */
 export declare const ColorGrade: React.FC<ColorGradeProps>;
 export {};

package/dist/_members/primitives/effects/grain/index.d.ts

@@ -1,21 +1,9 @@
 import React from 'react';
 export interface GrainProps {
-    /** Grain intensity 0-1 (default 0.3) */
     intensity?: number;
-    /** Animation speed multiplier (default 1). Higher = faster grain movement. */
     speed?: number;
-    /** CSS blend mode (default 'overlay') */
     blendMode?: React.CSSProperties['mixBlendMode'];
-    /** Monochrome grain (default true). When false, includes color noise. */
     monochrome?: boolean;
-    /** Additional wrapper style */
     style?: React.CSSProperties;
 }
-/**
- * Animated film grain overlay.
- * Canvas-based noise pattern with configurable intensity and blend mode.
- *
- * Usage:
- *   <Grain intensity={0.4} monochrome />
- */
 export declare const Grain: React.FC<GrainProps>;