@cueframe/kernel 0.1.0 → 0.1.2

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

@@ -1,25 +1,12 @@
 import React from 'react';
 type PanDirection = 'left' | 'right' | 'up' | 'down' | 'none';
 export interface ParallaxProps {
-    /** Image source URL */
     src: string;
-    /** Zoom level (default 1.2, 1 = no zoom) */
     zoom?: number;
-    /** Pan direction for Ken Burns movement (default 'left') */
     pan?: PanDirection;
-    /** Speed multiplier (default 1) */
     speed?: number;
-    /** Easing function (default linear) */
     easing?: (t: number) => number;
-    /** Additional wrapper style */
     style?: React.CSSProperties;
 }
-/**
- * Ken Burns / 2.5D depth movement effect.
- * Applies slow zoom and pan to an image for cinematic parallax.
- *
- * Usage:
- *   <Parallax src="landscape.jpg" zoom={1.3} pan="left" />
- */
 export declare const Parallax: React.FC<ParallaxProps>;
 export {};

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

@@ -1,31 +1,15 @@
 import React from 'react';
 type ParticlePreset = 'dust' | 'bokeh' | 'snow' | 'sparks' | 'embers' | 'fireflies';
 export interface ParticlesProps {
-    /** Particle visual preset (default 'dust') */
     preset?: ParticlePreset;
-    /** Number of particles (default 60) */
     count?: number;
-    /** Movement speed multiplier (default 1) */
     speed?: number;
-    /** Base particle size in pixels (default preset-dependent) */
     size?: number;
-    /** Particle color (default preset-dependent) */
     color?: string;
-    /** Overall opacity (default 0.6) */
     opacity?: number;
-    /** Horizontal wind force, -1 to 1 (default 0) */
     wind?: number;
-    /** Downward gravity force (default 0) */
     gravity?: number;
-    /** Additional wrapper style */
     style?: React.CSSProperties;
 }
-/**
- * Configurable particle system rendered via Canvas API.
- * Uses seeded randomness for frame-deterministic output.
- *
- * Usage:
- *   <Particles preset="bokeh" count={40} opacity={0.5} />
- */
 export declare const Particles: React.FC<ParticlesProps>;
 export {};

package/dist/_members/primitives/effects/pulsing-indicator/index.d.ts

@@ -1,17 +1,7 @@
-/**
- * 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 PulsingIndicatorProps {
     color?: string;
     size?: number;
-    /** Wavelength of the base pulse, in frames. Higher = longer one cycle. */
     period?: number;
-    /** Playback speed multiplier (1 = normal, 2 = twice as fast). */
     speed?: number;
     background?: string;
     className?: string;

package/dist/_members/primitives/effects/spotlight-card/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)
- */
 import type { ReactNode } from "react";
 export interface SpotlightCardProps {
     title?: string;

package/dist/_members/primitives/effects/spring-pop-in/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)
- */
 import type { ReactNode } from "react";
 export interface SpringPopInProps {
     children?: ReactNode;
@@ -14,8 +6,6 @@ export interface SpringPopInProps {
     stiffness?: number;
     delayInFrames?: number;
     speed?: number;
-    /** Stage color behind the popping child. Default transparent — a wrapper
-     *  effect must not paint over the scene it's composited into. */
     background?: string;
     className?: string;
 }

package/dist/_members/primitives/effects/success-confetti/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 SuccessConfettiProps {
     count?: number;
     colors?: string[];

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

@@ -1,23 +1,11 @@
 import React from 'react';
 type VignetteShape = 'circle' | 'ellipse';
 export interface VignetteProps {
-    /** Darkness intensity 0-1 (default 0.5) */
     intensity?: number;
-    /** How far the vignette spreads inward 0-1 (default 0.5) */
     spread?: number;
-    /** Shape of the vignette (default 'ellipse') */
     shape?: VignetteShape;
-    /** Vignette color (default 'black') */
     color?: string;
-    /** Additional wrapper style */
     style?: React.CSSProperties;
 }
-/**
- * Edge-darkening vignette overlay.
- * Pure CSS radial-gradient — no canvas needed.
- *
- * Usage:
- *   <Vignette intensity={0.6} spread={0.4} />
- */
 export declare const Vignette: React.FC<VignetteProps>;
 export {};

package/dist/_members/primitives/hero-text/HeroText.d.ts

@@ -1,27 +1,10 @@
-/** Launch-grade hero text (spec §5): display weight, negative tracking at display
- *  sizes, per-word staggered entrance from params.revealAtMs (ms, authored upstream
- *  from word timings / beats). Renders inside the behind host's anchored wrapper —
- *  no positioning of its own. Fonts: caller-loaded (caption convention). */
 export interface HeroTextProps {
     text: string;
-    /** Font size as % of composition height. Default 14 (display scale). */
     fontSizePct?: number;
-    /** Per-word reveal offsets in ms, relative to THIS overlay's start (the
-     *  component is mounted inside a Sequence at the overlay's startFrame, so
-     *  frame 0 here = overlay start). Missing entries default to 0. Absent /
-     *  empty → fully visible (static). */
     revealAtMs?: number[];
-    /** Per-word reveal window in ms (0→1 fade). Default 240. Brand-bindable via
-     *  `$brand:motion.duration` so a brand drives the entrance speed. */
     durationMs?: number;
-    /** Easing keyword applied to the per-word reveal. Brand-bindable via
-     *  `$brand:motion.easing`. Absent → linear (the original reveal). */
     easing?: string;
-    /** Per-word entrance treatment. Brand-bindable via `$brand:motion.entrance`.
-     *  Absent → 'fade' (the original hero reveal). 'none' = static. */
     entrance?: 'none' | 'fade' | 'word-pop' | 'stagger-up';
-    /** Brand-bindable via `$brand:colors.*`. Param name `textColor` matches the
-     *  registry token binding (was `color` when heroText was an explicit dispatch case). */
     textColor?: string;
     fontFamily?: string;
     fontWeight?: number;

package/dist/_members/primitives/hero-text/config.d.ts

@@ -32,15 +32,5 @@ declare const paramsSchema: z.ZodObject<{
     fontFamily: z.ZodDefault<z.ZodString>;
 }, z.ZodTypeAny, "passthrough">>;
 type Params = z.infer<typeof paramsSchema>;
-/**
- * Launch-grade hero text — the text-behind-subject depth grammar's display phrase.
- *
- * Registered under the camelCase id `heroText` (NOT kebab) ON PURPOSE: the wire id
- * is referenced by the behind-placement text-bearing gate
- * (resolve-behind-placement.ts) and the agent prompts. Folding it into the registry
- * (this config) lets it dispatch through `resolvePrimitive` + `inflatePrimitiveProps`
- * like every other primitive — deleting the explicit `OverlayContent` case + its
- * second brand resolver — while keeping that id stable.
- */
 export declare const config: PrimitiveMeta<Params>;
 export {};

package/dist/_members/primitives/hero-text/index.d.ts

@@ -1,17 +1,3 @@
-/**
- * @cueframe/primitives/hero-text — launch-grade hero text for the
- * text-behind-subject depth grammar (Phase 3 §3.4).
- *
- * Registered in the master catalog under id `heroText` (camelCase wire id —
- * referenced by the behind-placement text-bearing gate in
- * resolve-behind-placement.ts and by the agent prompts, so it stays stable).
- * It dispatches through `resolvePrimitive` + `inflatePrimitiveProps` like any
- * other primitive (no explicit `OverlayContent` case).
- *
- * Consumed by the cueframe renderer's shared overlay dispatch (`OverlayContent`
- * default branch), for both the behind host (world-locked, atmosphere-treated)
- * and the degraded front path.
- */
 import type { Catalog } from '../lib/types.js';
 export { HeroText } from './HeroText.js';
 export type { HeroTextProps } from './HeroText.js';

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

@@ -1,8 +1,5 @@
 import type { Catalog, PrimitiveMeta } from './lib/types.js';
-/** Aggregated master catalog: the seven categories + the hero-text subpath
- *  (registered under id `heroText`; see ./hero-text). */
 export declare const allPrimitives: Catalog;
-/** Per-category catalogs. Use these when you only need one category. */
 export declare const catalogs: {
     readonly text: Catalog;
     readonly effects: Catalog;
@@ -12,10 +9,5 @@ export declare const catalogs: {
     readonly 'ui-blocks': Catalog;
     readonly scenes: Catalog;
 };
-/**
- * Resolve a primitive by id. Returns `undefined` if not found.
- * Used by the renderer (`<TransitionSeries>` factory lookup) and the
- * drawer (drag-and-drop apply).
- */
 export declare function resolvePrimitive(id: string): PrimitiveMeta | undefined;
 export type { Catalog, PrimitiveMeta } from './lib/types.js';

package/dist/_members/primitives/layouts/chat-to-preview-layout/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)
- */
 import type { ReactNode } from "react";
 export interface ChatToPreviewLayoutProps {
     chat?: ReactNode;

package/dist/_members/primitives/layouts/infinite-bento-pan/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 InfiniteBentoPanProps {
     panSpeed?: number;
     accentColor?: string;

package/dist/_members/primitives/layouts/letterbox/index.d.ts

@@ -1,23 +1,8 @@
 import React from 'react';
 export interface LetterboxProps {
-    /** Target aspect ratio for the cinematic bars (e.g. 2.35 for cinemascope) */
     ratio?: number;
-    /** Bar color (default '#000000') */
     color?: string;
-    /** Animate bars opening with spring physics (default true) */
     animated?: boolean;
-    /** Content rendered behind the bars */
     children: React.ReactNode;
 }
-/**
- * Cinematic letterbox bars overlay.
- *
- * Calculates bar height from the current video dimensions vs target aspect ratio.
- * Bars spring-animate into view when `animated` is true.
- *
- * Usage:
- *   <Letterbox ratio={2.35}>
- *     <Img src="wide-shot.jpg" />
- *   </Letterbox>
- */
 export declare const Letterbox: React.FC<LetterboxProps>;

package/dist/_members/primitives/layouts/photo-grid/index.d.ts

@@ -1,25 +1,8 @@
 import React from 'react';
 export interface PhotoGridProps {
-    /** Array of image URLs to display */
     images: string[];
-    /** Number of grid columns (default 2) */
     columns?: number;
-    /** Gap between grid cells in pixels (default 8) */
     gap?: number;
-    /** Seconds between each image reveal (default 0.15) */
     stagger?: number;
 }
-/**
- * Animated photo grid reveal.
- *
- * Displays images in a CSS grid with spring-animated staggered entry.
- * Each cell fades in, scales up, and lifts from a slight offset.
- *
- * Usage:
- *   <PhotoGrid
- *     images={['a.jpg', 'b.jpg', 'c.jpg', 'd.jpg']}
- *     columns={2}
- *     stagger={0.15}
- *   />
- */
 export declare const PhotoGrid: React.FC<PhotoGridProps>;

package/dist/_members/primitives/layouts/picture-in-picture/index.d.ts

@@ -1,32 +1,11 @@
 import React from 'react';
 export type PipPosition = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 export interface PictureInPictureProps {
-    /** Corner for the PiP overlay (default 'bottom-right') */
     position?: PipPosition;
-    /** PiP size as fraction of video width (0-1, default 0.3) */
     size?: number;
-    /** Border radius in pixels (default 12) */
     borderRadius?: number;
-    /** Box shadow CSS value (default 'none' — a hairline border provides separation) */
     shadow?: string;
-    /** PiP overlay content */
     children: React.ReactNode;
-    /** Main background content */
     main: React.ReactNode;
 }
-/**
- * Picture-in-picture floating overlay layout.
- *
- * Renders `main` content full-screen with a spring-animated PiP window
- * containing `children` in the specified corner.
- *
- * Usage:
- *   <PictureInPicture
- *     position="bottom-right"
- *     size={0.25}
- *     main={<Video src="presentation.mp4" />}
- *   >
- *     <Video src="speaker.mp4" />
- *   </PictureInPicture>
- */
 export declare const PictureInPicture: React.FC<PictureInPictureProps>;

package/dist/_members/primitives/layouts/split-screen/index.d.ts

@@ -1,22 +1,7 @@
 import React from 'react';
 export interface SplitScreenProps {
-    /** Number of columns (default 2) */
     columns?: number;
-    /** Gap between panels in pixels (default 4) */
     gap?: number;
-    /** Panel contents — each child becomes one panel */
     children: React.ReactNode;
 }
-/**
- * Multi-panel split screen layout.
- *
- * Arranges children into equal-width columns with spring-animated
- * opacity + scale per panel with stagger.
- *
- * Usage:
- *   <SplitScreen columns={2} gap={4}>
- *     <Video src="interview-a.mp4" />
- *     <Video src="interview-b.mp4" />
- *   </SplitScreen>
- */
 export declare const SplitScreen: React.FC<SplitScreenProps>;

package/dist/_members/primitives/layouts/staggered-bento-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 BentoItem {
     title: string;
     body?: string;

package/dist/_members/primitives/lib/easings.d.ts

@@ -1,40 +1,13 @@
-/**
- * Shared easing curves.
- *
- * Centralized so primitives don't redeclare `Easing.bezier(...)` inline
- * (remocn's mistake — the SOFT curve is redeclared in 12+ files there).
- *
- * Curves use Remotion's `Easing.bezier(x1, y1, x2, y2)` so they integrate
- * with `interpolate(..., { easing })` directly.
- *
- * Usage:
- *
- *   import { SOFT, OUT_EXPO } from './easings.js';
- *   const v = interpolate(frame, [0, 30], [0, 1], { easing: SOFT });
- */
 import { Easing } from 'remotion';
-/** Soft, expressive ease-out. The most useful all-purpose curve for entrances. */
 export declare const SOFT: (t: number) => number;
-/** Tight, exponential ease-out. Snappier than SOFT, good for emphasis. */
 export declare const OUT_EXPO: (t: number) => number;
-/** Spring-like ease-out with overshoot. Use sparingly — feels playful. */
 export declare const OUT_BACK: (t: number) => number;
-/** Clean cubic ease-out. The CSS default-ish curve for "ease-out". */
 export declare const OUT_CUBIC: (t: number) => number;
-/** Smooth in-and-out, cubic. Universal "ease-in-out" replacement. */
 export declare const IN_OUT_CUBIC: (t: number) => number;
-/** Stronger in-and-out, quartic. More dramatic than cubic. */
 export declare const IN_OUT_QUART: (t: number) => number;
-/** Aggressive ease-in. Use for exits where deceleration is wrong. */
 export declare const IN_QUART: (t: number) => number;
-/** Linear (identity). Mostly used as an explicit override. */
 export declare const LINEAR: typeof Easing.linear;
-/** Step-based easing — jumps at midpoint. Useful for staggered/ratcheted feels. */
 export declare const STEP: typeof Easing.step1;
-/**
- * Intent → curve map. Use when picking a curve from agent metadata
- * rather than committing to a specific name.
- */
 export declare const EASING_BY_INTENT: {
     readonly entrance: (t: number) => number;
     readonly emphasis: (t: number) => number;

package/dist/_members/primitives/lib/palette.d.ts

@@ -1,20 +1,3 @@
-/**
- * Refined primitive palette — the single source of truth for the *fallback*
- * colors every primitive ships with.
- *
- * These are only fallbacks: the brand cascade (`lib/tokens.ts`) resolves the
- * real brand kit at apply-time and overrides anything token-bound. But the
- * fallbacks are what an agent sees with no brand kit, and what the catalog
- * previews render — so they must read as one deliberate, modern system, not a
- * grab-bag of vivid Tailwind defaults.
- *
- * Direction (matches DESIGN.md): **warm espresso neutrals + mandarin as the one
- * accent**, with a small *desaturated* support set for charts, syntax, and
- * semantic states. No fluorescent color — every hue is muted and sits on the
- * warm base. Elevation is expressed with hairline BORDERs, never drop shadows.
- *
- * Tune the whole primitive look from here — it's one edit.
- */
 export declare const BG_DEEP = "#0f0b07";
 export declare const BG = "#14100c";
 export declare const SURFACE = "#1c1611";
@@ -37,11 +20,6 @@ export declare const WARNING = "#e0a355";
 export declare const BLUE = "#7b93b0";
 export declare const VIOLET = "#9b8bb0";
 export declare const TEAL = "#5fa5a0";
-/**
- * Ordered categorical series for multi-series charts / multi-item UI. Harmonised
- * around the warm base — mandarin leads, cool + muted hues follow. Read left to
- * right; wrap for >6 series.
- */
 export declare const SERIES: readonly ["#f2913c", "#5fa5a0", "#7b93b0", "#9b8bb0", "#7fae7a", "#e0a355"];
 export declare const SYN_TEXT = "#e4dccf";
 export declare const SYN_COMMENT = "#7a6f63";

package/dist/_members/primitives/lib/preview.d.ts

@@ -1,36 +1,14 @@
-/**
- * <PrimitivePreview> — drawer-side wrapper around `@remotion/player`.
- *
- * Mounts any primitive in a Remotion Player using metadata from the
- * primitive's `config.ts`. The drawer doesn't reach into Remotion; it
- * passes a `PrimitiveMeta` and an optional `exampleName` and gets a
- * working preview.
- *
- * Transitions are special — they only make sense between two scenes,
- * so this component renders the underlying presentation component at
- * a fixed progress for static thumbnails. A future enhancement is a
- * mini `<TransitionSeries>` between two `DefaultPanel`-style placeholders.
- */
 import * as React from 'react';
 import type { PrimitiveMeta } from './types.js';
 export interface PrimitivePreviewProps {
-    /** The primitive to render. */
     primitive: PrimitiveMeta;
-    /** Example to use. Defaults to `preview.defaultExample` or `examples[0]`. */
     exampleName?: string;
-    /** Override params (deep-merged onto the example's params). */
     paramsOverride?: Record<string, unknown>;
-    /** Override Player width. Falls back to `primitive.preview.width ?? primitive.width`. */
     width?: number;
-    /** Override Player height. Falls back to `primitive.preview.height ?? primitive.height`. */
     height?: number;
-    /** Whether to autoplay. Defaults to `true` for `mode: 'loop'`. */
     autoPlay?: boolean;
-    /** Show Remotion controls overlay. Defaults to `false`. */
     controls?: boolean;
-    /** Additional className for the Player wrapper. */
     className?: string;
-    /** Additional style for the Player wrapper. */
     style?: React.CSSProperties;
 }
 export declare const PrimitivePreview: React.FC<PrimitivePreviewProps>;

package/dist/_members/primitives/lib/schema.d.ts

@@ -1,53 +1,17 @@
-/**
- * Zod → JSON Schema → controls / defaults.
- *
- * One canonical zod schema per primitive (declared in `config.ts`); this
- * module derives:
- *   - JSON Schema for the agent's `apply_template` validation (Ajv).
- *   - Prop defaults (materialized from `.default()` calls).
- *   - Customizer controls for the drawer UI.
- *
- * No drift: all three derive from the same source.
- */
 import { z } from 'zod';
 export declare function zodToJsonSchemaFor(schema: z.ZodTypeAny, name: string): Record<string, unknown>;
-/**
- * Walk a zod schema and extract all `.default()` values into a flat object.
- *
- * Supports `ZodObject` at the top level. Nested objects are walked
- * recursively; arrays / unions / records are skipped (their defaults must
- * be declared at the array level via `.default([...])`).
- */
 export declare function zodToDefaults(schema: z.ZodTypeAny): Record<string, unknown>;
 export type ControlType = 'string' | 'number' | 'boolean' | 'select' | 'color';
 export interface ControlConfig {
-    /** Field name in the params object (top-level only — nested not supported). */
     name: string;
-    /** Display label (defaults to humanized field name). */
     label?: string;
-    /** Description for tooltip / hover (from zod `.describe()`). */
     description?: string;
-    /** Control widget type. */
     type: ControlType;
-    /** Default value (from zod `.default()`). */
     defaultValue?: unknown;
-    /** For type='number': min/max/step. */
     min?: number;
     max?: number;
     step?: number;
-    /** For type='select': allowed values. */
     options?: readonly string[];
-    /** Whether the field is required. */
     required: boolean;
 }
-/**
- * Derive controls from a zod schema for the drawer customizer UI.
- *
- * Heuristics:
- *   - `z.string()` → `'string'` (or `'color'` if name matches /color|colour|hex/i)
- *   - `z.number()` → `'number'` with min/max from `.min()`/`.max()`
- *   - `z.boolean()` → `'boolean'`
- *   - `z.enum([...])` → `'select'` with options
- *   - Wrapped in `.optional()` / `.default()` → unwrapped, defaultValue extracted
- */
 export declare function zodToControls(schema: z.ZodTypeAny): ControlConfig[];

package/dist/_members/primitives/lib/seeded-random.d.ts

@@ -1,29 +1,6 @@
-/**
- * Seeded random helpers.
- *
- * Wraps Remotion's deterministic `random(seed)` with helpers commonly
- * needed by primitives: `pick`, `range`, `gauss`, plus a small PRNG class
- * for primitives that want a stateful sequence (Particles, Grain).
- *
- * Why centralized:
- *   - Several primitives reimplement the same xorshift / linear
- *     congruential generator inline. One source of truth.
- *   - Determinism across renders (Lambda + local) requires every random
- *     call to derive from a stable seed.
- */
-/** Pick one element from `arr` deterministically using `seed`. */
 export declare function pick<T>(seed: number | string, arr: readonly T[]): T;
-/** Uniform random in `[min, max)` using `seed`. */
 export declare function range(seed: number | string, min: number, max: number): number;
-/**
- * Approximate Gaussian sample using the Box-Muller method, deterministic per seed.
- * Returns a value with mean=0, stddev=1 by default.
- */
 export declare function gauss(seed: number | string, mean?: number, stddev?: number): number;
-/**
- * Linear congruential generator. Same algorithm cueframe's existing
- * Particles/Grain primitives use inline; promoted here so they share one impl.
- */
 export declare class SeededPRNG {
     private state;
     constructor(seed: number);

package/dist/_members/primitives/lib/text/contrast.d.ts

@@ -1,24 +1,7 @@
-/**
- * Legibility floor for text-on-video surfaces.
- *
- * Only Captions/Karaoke baked a contrast shadow before this; every other text
- * primitive shipped raw `#171717`-on-transparent with no shadow and vanished on
- * real footage. This is the shared module the consolidation spec named but never
- * built. Default text color is an off-white (#F7F2EA) — softer than pure white,
- * resolved through the brand `colors.textOnMedia` first — plus the proven
- * two-layer drop shadow (lifted from Captions) so white text survives on any
- * video. behind-subject hosts (HeroText) opt out of the shadow because the
- * subject silhouette supplies the depth, but still get a real off-white color.
- */
 export interface ContrastResult {
     textColor: string;
     textShadow: string;
 }
-/**
- * Single source of truth for the legibility floor. Every text primitive's
- * default color + baked shadow derive from these — import them rather than
- * re-typing the literals, so the floor changes in exactly one place.
- */
 export declare const FLOOR_TEXT = "#F7F2EA";
 export declare const FLOOR_SHADOW = "0 1px 6px rgba(0,0,0,0.55)";
 export declare function resolveContrast(opts?: {

package/dist/_members/primitives/lib/text/fill.d.ts

@@ -1,8 +1,3 @@
 import type { CSSProperties } from 'react';
 import type { TextFill } from './spec.js';
-/**
- * CSS for a text fill. `solid` → a plain text color; `gradient` → a CSS gradient
- * painted INTO the glyphs via bg-clip-text (the emphasis-gradient axis, extracted
- * verbatim from Captions). Pure.
- */
 export declare function fillStyle(fill: TextFill): CSSProperties;