@cueframe/kernel 0.1.1 → 0.1.2

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;

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

@@ -1,62 +1,25 @@
-/**
- * Auto-fit text for render primitives.
- *
- * Text slots used to render at a FIXED font size with no overflow handling, so each
- * carried a hard `maxLength` cap — natural agent copy overflowed it and the write-
- * boundary validation rejected it (guess-and-check churn). `<FitText>` measures the
- * text and shrinks-to-fit → wraps → ellipsizes so any length renders gracefully, which
- * lets the caps be raised to a generous legibility ceiling.
- *
- * `resolveFitFontSize` is the pure decision (unit-tested); the component wires
- * remotion's `fitText` (impure DOM measurement) to feed it.
- */
 import React from 'react';
 import { type TextTransform } from '@remotion/layout-utils';
 export interface ResolveFitInput {
-    /** Largest single-line font size that fits the text in the container, per remotion
-     *  `fitText`. `Infinity` for empty/whitespace text (nothing to shrink). */
     singleLineFitFontSize: number;
-    /** Floor below which we stop shrinking and wrap+ellipsize instead. */
     minFontSize: number;
-    /** The primitive's design font size — the ceiling; we never upscale past it. */
     maxFontSize: number;
 }
 export interface ResolveFitResult {
     fontSize: number;
-    /** True when the text can't fit on one line even at `minFontSize` — the caller
-     *  should wrap to `maxLines` and clip with an ellipsis. */
     overflow: boolean;
 }
-/** Clamp the measured single-line fit size into [min, max] and report floor overflow.
- *  Never upscales past the design size; a fit at/above the floor is clean. */
 export declare function resolveFitFontSize({ singleLineFitFontSize, minFontSize, maxFontSize, }: ResolveFitInput): ResolveFitResult;
 export interface FitTextProps {
-    /** The text to render (the single source that used to carry a maxLength cap). */
     children: string | null | undefined;
-    /** Available width of the text's box, in px (the primitive's own layout knows this). */
     maxWidth: number;
-    /** The primitive's design font size — the ceiling; text never renders larger. */
     maxFontSize: number;
-    /** Lines the text may wrap to before it clamps + ellipsizes. Default 1 (titles/labels);
-     *  use 2–3 for bodies. */
     maxLines?: number;
-    /** Floor below which we stop shrinking and clamp+ellipsize. Default 55% of maxFontSize. */
     minFontSize?: number;
     fontFamily: string;
     fontWeight?: number | string;
     letterSpacing?: string;
-    /** The measurer's CLOSED union, not csstype's open `string & {}` one — the
-     *  measurement must see exactly the value the DOM will render, so arbitrary
-     *  strings are refused at compile time (they'd measure as a no-op). */
     textTransform?: TextTransform;
-    /** Extra styles (color, textShadow, background, padding, …) merged last. */
     style?: React.CSSProperties;
 }
-/**
- * Render `children` at the largest size that fits `maxWidth` on `maxLines`, shrinking
- * from `maxFontSize` down to `minFontSize`; anything longer clamps to the floor and
- * ellipsizes. Replaces the raw `<div style={{fontSize}}>{text}</div>` in text primitives
- * so long copy degrades gracefully instead of overflowing — which is what lets the
- * `maxLength` caps be raised.
- */
 export declare const FitText: React.FC<FitTextProps>;

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

@@ -1,14 +1,4 @@
 import type { TextMarker } from './spec.js';
-/**
- * Hand-drawn marker scribble (a rough circle or underline) that draws itself on
- * as `progress` goes 0→1. Stretches to fill its positioned parent (an emphasis
- * plate / word group), so it always frames the word.
- *
- * The single implementation of the caption scribble — extracted verbatim from
- * Captions' private `MarkerAnnotation`. Pure: the caller samples the frame and
- * passes the scalar `progress`. The highlighter-BAR mechanism (marker-highlight's
- * `scaleX` span) is a structurally different surface and is intentionally NOT here.
- */
 export declare function Marker({ spec, progress }: {
     spec: TextMarker;
     progress: number;

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

@@ -1,57 +1,11 @@
-/**
- * The shared per-word entrance vocabulary. Three NAMED pure functions (not one
- * accreting switch): each is a faithful extraction of one surface's entrance
- * math, so migrating that surface to call it is provably byte-identical. A
- * surface whose transform doesn't reduce to one of these stays bespoke.
- *
- * Pure: the caller samples the frame and passes scalars in (no `useCurrentFrame`).
- */
-/**
- * `word-pop` (Captions): cubic-eased opacity + spring scale-settle, per word.
- * `restScale` is the pre-settle scale (Captions uses 0.86 emphasis / 0.92 plain).
- */
 export declare function wordPop(frame: number, fps: number, startFrame: number, durationFrames: number, restScale: number): {
     opacity: number;
     scale: number;
 };
-/**
- * `fade` (HeroText): per-word reveal fraction 0→1 over `windowMs`, from the
- * word's `revealAtMs`. The caller applies `opacity = k` and
- * `translateY((1 - k) * 0.25em)` while `k < 1`.
- */
 export declare function fadeProgress(tMs: number, revealAtMs: number, windowMs: number): number;
-/**
- * `stagger-up` (staggered-fade-up): per-word opacity 0→1 + translateY
- * `distance`px→0 over `windowFrames`, staggered by `index * staggerDelay`.
- */
 export declare function staggerUp(frame: number, index: number, staggerDelay: number, windowFrames: number, distance: number): {
     opacity: number;
     y: number;
 };
-/**
- * `stagger-up` vertical-rise companion to {@link staggerUp}: a word rises from
- * `distance`px to 0 as `progress` (the same 0→1 reveal `staggerUp` returns as
- * `opacity`) eases in:  `distance * (1 - ease(progress))`.
- *
- * Division-free on purpose. The schema permits `distance: 0` (`.min(0)`); the
- * earlier `distance - ease(1 - y / distance) * distance` form divided by
- * `distance`, so a 0-distance render computed 0/0 = NaN → `translateY(NaNpx)`.
- * This form collapses cleanly to 0 at distance 0 and is byte-identical for
- * distance > 0 (the old `y` satisfied `y = distance * (1 - progress)`, so
- * `1 - y/distance === progress`).
- */
 export declare function staggerRise(distance: number, progress: number, ease: (t: number) => number): number;
-/**
- * Map a brand `motion.easing` keyword to a Remotion easing function for the
- * `interpolate({ easing })` option. This is the bind target for
- * `$brand:motion.easing` on the text family: the brand cascade resolves the
- * keyword string into the surface's `easing` param, and the surface applies the
- * returned curve to its per-word reveal.
- *
- * The keywords mirror the brand `EasingValue` STRING form. The object
- * (cubic-bezier) form never reaches here — the brand-cascade `resolveTokenValue`
- * only materializes string values, so an object easing misses and the binding
- * falls to its keyword fallback. Unknown / absent → `linear` (the identity
- * curve), so an unset easing is a no-op and existing renders are unchanged.
- */
 export declare function resolveEasing(name?: string): (t: number) => number;

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

@@ -1,12 +1 @@
-/**
- * Recolor a token from `from` to `to` by `progress` (0..1).
- *
- * The single implementation of the per-word color swap that inline-highlight,
- * marker-highlight, and (the progress-ramped surfaces) duplicate today via
- * `interpolateColors(progress, [0, 1], [from, to])`. Pure: no `useCurrentFrame`
- * — the caller samples the frame and passes the scalar `progress` in.
- *
- * Note: Captions' emphasis recolor (Captions.tsx) is a plain CONDITIONAL color
- * assignment (no progress ramp), so it does NOT route through this function.
- */
 export declare function recolor(progress: number, from: string, to: string): string;

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

@@ -1,78 +1,39 @@
-/**
- * Shared text vocabulary — the one set of types every text-bearing render
- * surface speaks (Captions, HeroText, behind-subject text, the `text/*` effects).
- *
- * Seeded from the richest existing surface, `CaptionStyle`/`CaptionWord`
- * (`@cueframe/core/render/types`), lifted to surface-neutral names. These are the
- * VOCABULARY, not a base component: each surface maps its own props to/from these
- * groups and renders via the `lib/text/*` modules (recolor, marker, plate, fill,
- * motion, normalize, contrast, stage). They are deliberately DISTINCT exported
- * sub-interfaces — never one union — so a decorative effect can import
- * `TextTypography` alone and the type system FORBIDS it reaching emphasis fields.
- *
- * Design: internal spec 2026-06-14
- */
-/** Base typographic group. `fontSizePct` is font size as a % of composition height. */
 export interface TextTypography {
     fontFamily: string;
     fontSizePct: number;
     fontWeight: number;
     fontStyle?: 'normal' | 'italic';
-    /** px */
     letterSpacing?: number;
     textTransform?: 'none' | 'uppercase' | 'capitalize';
 }
-/** Per-word recolor axis — interpolate a token's color from `from` to `to`. */
 export interface TextRecolor {
     from: string;
     to: string;
 }
-/**
- * Hand-drawn marker annotation (scribble) over a word. The highlighter-BAR
- * (marker-highlight's `scaleX` span) is a structurally different mechanism and
- * is intentionally NOT part of this group — it stays its own surface.
- */
 export interface TextMarker {
     kind: 'circle' | 'underline';
     color: string;
 }
-/** Editorial highlighter plate behind a contiguous emphasis run; two-tone via the `alt*` pair. */
 export interface TextPlate {
     color: string;
     altColor?: string;
     textColor?: string;
     altTextColor?: string;
-    /** px */
     radius?: number;
-    /** fraction of emphasis font size */
     padX?: number;
-    /** fraction of emphasis font size */
     padY?: number;
 }
-/** Text fill — a solid color or a bg-clip-text gradient painted into the glyphs. */
 export interface TextFill {
     kind: 'solid' | 'gradient';
-    /** hex for `solid`; a CSS gradient string for `gradient` */
     value: string;
 }
-/**
- * Per-word entrance/exit motion. This is the single `$brand:motion` bind target:
- * a surface authors `durationMs`/`easing` as `$brand:motion.*` refs, which the
- * brand model resolves at PROJECTION time (no render-time resolver change).
- */
 export interface TextMotion {
     entrance: 'none' | 'fade' | 'word-pop' | 'stagger-up';
     durationMs: number;
-    /** min gap between consecutive word entrances so two never fire together */
     staggerMs?: number;
     easing?: string;
-    /** phrase fade-out over the page's last N ms before the next builds (0 = hard cut) */
     exitMs?: number;
 }
-/**
- * The per-word model. Timing is optional so untimed surfaces share the shape;
- * `startMs`/`endMs` are composition-absolute after `normalize.tokenize()`.
- */
 export interface TextWord {
     text: string;
     startMs?: number;

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

@@ -1,23 +1,6 @@
 import React from 'react';
 export interface TextStageProps {
-    /**
-     * Full-frame background. Default `'transparent'` — a text OVERLAY must not
-     * paint over the video. Pass a concrete/brand color only for a genuine
-     * full-frame card. (Fixes the white-card overlay bug: the surfaces this
-     * replaces hardcoded `background:"white"`. See
-     * Issues/hookstat-overlay-white-card-brand-bg.)
-     */
     background?: string;
     children: React.ReactNode;
 }
-/**
- * The shared anchored layout shell for text surfaces: an absolutely-positioned,
- * inset-0, centered container. Replaces the hand-rolled
- * `position:absolute; inset:0; flex-center; background:"white"` wrapper
- * duplicated across inline-highlight, marker-highlight, text-fade-replace, and
- * strikethrough-replace.
- *
- * This is a thin LAYOUT shell, not an assembly base — it has no word/emphasis/
- * motion opinion; surfaces render their own content inside it.
- */
 export declare const TextStage: React.FC<TextStageProps>;