@cueframe/kernel 0.1.0 → 0.1.2

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>;

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

@@ -1,14 +1,3 @@
-/**
- * Typeface resolution for text primitives.
- *
- * Every text-on-video surface resolves its font by ROLE through this module:
- * brand kit first, then a deliberately chosen designed fallback — NEVER
- * `inherit` / `sans-serif` / `monospace` (the generic system face is the #1
- * "AI-default" tell, and the remocn fork stripped the real faces). The floor
- * pairing is Bricolage Grotesque (display) + Schibsted Grotesk (caption), both
- * OFL and bundled in the render harness; mono reuses the already-bundled
- * Space Mono.
- */
 export type TextRole = 'display' | 'caption' | 'mono';
 export interface TypefaceBrandKit {
     fonts?: Partial<Record<'heading' | 'caption' | 'mono', string>>;

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

@@ -1,107 +1,20 @@
-/**
- * Brand cascade resolution.
- *
- * Resolves token-bound params at apply-time:
- *
- *   code default → propDefaults → brand cascade → user param
- *
- * Each layer overrides the previous. The resolved params are materialized
- * into the wire-shape and frozen — the renderer never re-resolves.
- */
 import type { TokenBinding } from './types.js';
-/**
- * Brand-kit paths that drive a TEXT or CAPTION color — the contrast-critical
- * surface. When one of these cannot resolve (kit absent or path missing) the
- * author's hardcoded `fallback` hex is brand-blind and may be illegible over
- * the real background, so it falls to a neutral-ramp pole instead (the floor's
- * "garbage brand still legible" guarantee). DECORATIVE paths (backgrounds,
- * borders, accents, surfaces) keep their author fallback.
- *
- * Every path here is a frozen Tier-2 core path (see FROZEN_CORE_PATHS) that
- * materializes a foreground/caption color on the `ResolvedBrandKit`. The
- * earlier old-vocabulary synonyms (`colors.fg` / `colors.foreground` /
- * `colors.muted`) were retired in the C3b repoint — no binding references them
- * and the registry lint now rejects them — so they are gone from this set.
- */
 export declare const CONTRAST_CRITICAL_PATHS: ReadonlySet<string>;
 export declare function isContrastCritical(brandKitPath: string): boolean;
-/**
- * The frozen Tier-2 core: the brand-kit paths a primitive binding may reference
- * that map 1:1 onto a materialized `ResolvedBrandKit` field. This vocabulary is
- * frozen — adding to it means extending `ResolvedBrandKit` (its validator and
- * projection), not just listing a new string here.
- */
 export declare const FROZEN_CORE_PATHS: readonly ["colors.background", "colors.surface", "colors.card", "colors.text", "colors.textMuted", "colors.textOnMedia", "colors.border", "colors.gridLine", "colors.accent", "colors.accentMuted", "colors.textOnAccent", "colors.textOnSurface", "caption.fg", "caption.scrim", "fonts.heading", "fonts.body", "fonts.caption", "motion.duration", "motion.easing", "motion.entrance", "motion.staggerMs", "motion.exitMs", "spacing.base", "spacing.lg", "spacing.sm", "sizing.fontSizeHeading", "sizing.fontSizeBody", "sizing.fontSizeLabel", "sizing.borderRadius"];
-/**
- * Tier-2b extension namespace: pure-function-of-core one-offs a binding may
- * reference but which are NOT yet derived onto the `ResolvedBrandKit`. They
- * miss at resolve time and fall to the binding's author fallback (decorative,
- * so the legibility floor doesn't apply). Declaring them here keeps the lint
- * from rejecting an intentional extension while still rejecting typos and
- * retired synonyms.
- */
 export declare const TIER2B_EXTENSION_PATHS: readonly ["colors.terminal", "colors.chrome", "colors.overlay", "colors.accentHue"];
-/**
- * The complete allowlist a primitive's `brandKitPath` may reference:
- * the frozen Tier-2 core ∪ the declared Tier-2b extension namespace.
- */
 export declare const ALLOWED_BRAND_PATHS: readonly string[];
 export declare function lintBrandPath(p: string): boolean;
-/**
- * Resolve a single token binding against a brand kit.
- *
- * Returns the brand-kit value if found, otherwise the binding's `fallback`.
- * CSS-var resolution happens at render time inside the component (via
- * `getComputedStyle`); this function is for the brand-kit cascade only.
- *
- * When a binding declares a `brandKitPath` but it does NOT resolve (kit absent
- * or path missing), the miss is LOUD, not silent — `opts.onUnresolved` is
- * invoked (or `console.warn` if no callback is supplied) before a fallback is
- * returned. A silent fallback here is exactly the failure mode that produces
- * off-brand renders (a brand-bound accent collapsing to its hardcoded
- * `#FFD60A`), so it must be observable in render logs.
- *
- * The unresolved fallback itself depends on what the binding controls:
- *
- *   - CONTRAST-CRITICAL (a text/caption color — `brandKitPath` in
- *     CONTRAST_CRITICAL_PATHS): the author's hardcoded hex is brand-blind and
- *     may be illegible over the real background, so it falls to a neutral-ramp
- *     pole (`NEUTRAL_RAMP.onDark` — white, the safe default when the background
- *     is unknown) rather than `binding.fallback`. This is the floor's
- *     "garbage brand still legible" guarantee.
- *   - DECORATIVE (a background, border, accent, surface, …): the author
- *     `fallback` is kept — a legibility floor doesn't apply to it.
- *
- * `onUnresolved` fires in BOTH cases; only the returned value differs.
- */
 export declare function resolveTokenValue(binding: TokenBinding, brandKit: Record<string, unknown> | undefined, opts?: {
     onUnresolved?: (info: {
         path: string;
     }) => void;
 }): string;
-/**
- * Apply brand-cascade defaults to params.
- *
- * For each token binding: if the user hasn't set the bound prop explicitly,
- * fill it from the brand kit (or the binding's fallback).
- *
- * Pure function — returns a new object, doesn't mutate inputs.
- */
 export declare function applyBrandCascade<P extends Record<string, unknown>>(params: Partial<P>, tokens: TokenBinding[], brandKit: Record<string, unknown> | undefined, opts?: {
     onUnresolved?: (info: {
         path: string;
     }) => void;
 }): P;
-/**
- * Full four-layer resolution.
- *
- *   final = userParams ∘ brandCascade(tokens) ∘ propDefaults ∘ codeDefaults
- *
- * `codeDefaults` come from the React component's parameter defaults and
- * are NOT applied here — they're the renderer's last-line fallback. This
- * function applies the three resolvable layers. The renderer trusts the
- * output and reapplies code defaults for any field still undefined.
- */
 export declare function resolveParams<P extends Record<string, unknown>>(userParams: Partial<P>, propDefaults: Partial<P>, tokens: TokenBinding[], brandKit: Record<string, unknown> | undefined, opts?: {
     onUnresolved?: (info: {
         path: string;

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

@@ -1,194 +1,54 @@
-/**
- * Agent-first primitive metadata contract.
- *
- * Every primitive's `config.ts` exports a `config: PrimitiveMeta`. The
- * registry, the agent's `apply_template` chokepoint, the customizer
- * controls, and the app's PrimitivesDrawer all read from this single shape.
- *
- * Design tenets:
- *   - Schema is canonical (zod). JSON Schema and prop defaults derive from it.
- *   - Field descriptions are prompt-quality. The agent's tool surface
- *     surfaces them to the LLM.
- *   - Examples are vibe-tagged few-shot, not single-sample demos.
- *   - Validation is normative. zod constraints fail loudly.
- */
 import type * as React from 'react';
 import type { z } from 'zod';
 export type PrimitiveCategory = 'text' | 'effects' | 'transitions' | 'layouts' | 'backgrounds' | 'ui-blocks' | 'scenes';
-/**
- * What the renderer does with this primitive.
- *
- * - `component`: mount as a React component with validated params.
- * - `transition`: call `createPresentation(params)` for `<TransitionSeries>`.
- *   The `component` field still references the underlying presentation
- *   component for static drawer preview at a fixed progress.
- * - `scene`: same as `component`, but declares `primitivesUsed[]` as an
- *   ABI manifest the workflow asserts at start.
- */
 export type PrimitiveKind = 'component' | 'transition' | 'scene';
-/**
- * Curation tier — ranks craft + general applicability for a driving agent.
- * `recommended` = lead with it; `standard` = solid, on-demand; `niche` = special-case.
- */
 export type Tier = 'recommended' | 'standard' | 'niche';
-/**
- * Editorial use-case — the edit-role(s) a driving agent filters the catalog by.
- */
 export type UseCase = 'intro' | 'outro' | 'full-scene' | 'title-over-footage' | 'transition' | 'background' | 'grade' | 'emphasis' | 'explainer' | 'social-cut';
 export type Mood = 'editorial' | 'cinematic' | 'tech-demo' | 'breaking-news' | 'playful' | 'minimal' | 'aggressive' | 'soft' | 'glitchy' | 'corporate';
 export interface Example<P = any> {
-    /** kebab-case slug, unique within a primitive's examples[]. */
     name: string;
-    /** Mood tags. Drives drawer filtering and agent vibe-matching. */
     mood: Mood[];
-    /**
-     * Param values for this example. May be partial — missing fields fall back
-     * to `propDefaults` and the four-layer brand-cascade resolver at apply time.
-     */
     params: Partial<P>;
-    /** When the agent should pick this example. */
     description?: string;
 }
 export interface TokenBinding {
-    /**
-     * Dotted path into the params object this token controls.
-     *
-     * Examples: `'textColor'`, `'tokens.accentColor'`, `'fontFamily'`.
-     */
     propPath: string;
-    /**
-     * CSS custom property in the host theme. The drawer/renderer reads
-     * `getComputedStyle(host).getPropertyValue(cssVar)` and falls back to
-     * `fallback` if undefined.
-     */
     cssVar: `--cf-${string}`;
-    /** Fallback value if neither brand kit nor CSS var resolves. */
     fallback: string;
-    /**
-     * Path into the org's brand kit for this token. The apply-time
-     * resolver reads `org.brandKit[brandKitPath]` to fill the param if
-     * the user hasn't set it explicitly.
-     */
     brandKitPath?: string;
 }
 export interface PrimitivePreview {
-    /** Frame to render as the static thumbnail. */
     thumbnailFrame: number;
-    /** Loop the preview or play once. */
     mode: 'loop' | 'oneshot';
-    /** Override `width` for preview only. Defaults to the primitive's `width`. */
     width?: number;
-    /** Override `height` for preview only. Defaults to the primitive's `height`. */
     height?: number;
-    /** `Example.name` to seed the drawer with. Defaults to `examples[0]`. */
     defaultExample?: string;
 }
 export interface PrimitiveMeta<P = any> {
-    /** Stable, kebab-case, globally unique within the cueframe registry. */
     id: string;
-    /**
-     * The React component reference.
-     *
-     * For `kind: 'component' | 'scene'`, this is the primitive itself.
-     * For `kind: 'transition'`, this is the underlying presentation component
-     * (mountable for static preview at a fixed progress).
-     */
     component: React.ComponentType<any>;
-    /** Human-readable display name for drawer surfaces. */
     name: string;
     category: PrimitiveCategory;
     kind: PrimitiveKind;
-    /** Semver. Bumped when `paramsSchema` changes shape. */
     version: string;
-    /**
-     * How an EFFECT primitive reaches pixels when the render mounts it.
-     *
-     * `'overlay'` (the default) — the component PAINTS ITS OWN content (grain,
-     * vignette, particles) and is mounted as a layer stacked above the footage.
-     *
-     * `'wrap'` — the component is a FILTER WRAPPER (color-grade, blur): it
-     * renders `<div style={{filter}}>{children}</div>` and changes nothing it is
-     * not an ancestor of. The render mounts it AROUND the footage stack
-     * (`WrapEffects` in render-entry), never as a stacked sibling — a childless
-     * mount is a filter over an empty div, which grades zero pixels while
-     * reporting success (the 2026-08-25 inert-grade bug). A `'wrap'` component
-     * MUST accept a `style` prop spread LAST on its wrapper element, so the
-     * mount can neutralize it outside its active window
-     * (`{filter:'none', transform:'none'}`) without unmounting the footage.
-     */
     effectPlacement?: 'wrap' | 'overlay';
-    /**
-     * Verb describing what this primitive accomplishes.
-     *
-     * Examples: `'reveal-text'`, `'transition-scenes'`, `'fill-background'`,
-     * `'overlay-grain'`, `'compose-trailer'`.
-     */
     intent: string;
-    /** One-paragraph description, prompt-quality. Surfaces to the agent. */
     description: string;
-    /**
-     * When to use this primitive — and when not to. Specific guidance,
-     * not generic. Negative guidance is what stops bad agent choices.
-     */
     useWhen: string;
-    /** Other primitive ids that complement this one. */
     pairsWith: string[];
-    /** Other primitive ids that conflict with this one. */
     avoidWith: string[];
-    /** Curation tier — craft + general applicability ranking for a driving agent. */
     tier: Tier;
-    /** Editorial use-case(s) — the edit-role(s) a driving agent filters by. ≥1. */
     useCase: UseCase[];
-    /** Search keywords. Drives drawer search ranking. */
     tags: string[];
-    /** Mood tags for drawer filtering and agent vibe-matching. */
     mood: Mood[];
-    /**
-     * Zod schema for the primitive's params. Every field should have
-     * `.describe()` so the generated JSON Schema carries LLM documentation.
-     * Use `.default()` to declare propDefaults inline.
-     */
     paramsSchema: z.ZodTypeAny;
-    /** Materialized defaults. Derived from zod via `lib/schema.ts:zodToDefaults`. */
     propDefaults: Partial<P>;
-    /** ≥1 example. The first is the drawer default unless `preview.defaultExample` overrides. */
     examples: Example<P>[];
-    /**
-     * Param field that accepts the primitive's primary text payload.
-     * `null` means the primitive has no canonical text slot (e.g. backgrounds).
-     * Used by `apply_template` to fill the layer's text variable.
-     *
-     * ABI SCOPE — textParam + subtextParam are the TWO single-string title/subtitle
-     * slots only. MULTI-ELEMENT / STRUCTURED scene copy (tiers, feature lines,
-     * code lines, beats) is NOT carried here; expose it as a typed param in the
-     * primitive's OWN `paramsSchema` (e.g. changelog-bite `oldLines`/`newLines:
-     * string[]`) and document any still-baked copy in `fixedCopy`. A genuinely
-     * GLOBAL structured-content slot on this ABI is intentionally deferred — see
-     * the agent-surface-gap plan (EXPRESSIVENESS: canonical text ABI).
-     */
     textParam: string | null;
-    /** Same contract for a secondary text payload (subtitle, byline, role). See textParam's ABI-scope note. */
     subtextParam: string | null;
-    /**
-     * On-screen strings this primitive BAKES into the render — the read-side
-     * counterpart to `paramsSchema`. List the literal copy (titles, faux-code,
-     * labels, faux-data) that renders REGARDLESS of params, so the agent surface
-     * can warn at author time that this text is fixed and only forking the source
-     * (get_component_source) can change it. Omit for primitives that bake no copy.
-     */
     fixedCopy?: string[];
-    /** Token bindings declared by this primitive. Empty array if no theme params. */
     tokens: TokenBinding[];
-    /**
-     * `kind === 'transition'`: factory returning a Remotion TransitionPresentation.
-     * Consumed by the render path's `<TransitionSeries.Transition presentation={...} />`.
-     */
     createPresentation?: (params: P) => unknown;
-    /**
-     * `kind === 'scene'`: ABI manifest of dependent primitive ids. Asserted
-     * at workflow start; missing primitives throw non-retryable
-     * `PrimitiveMissing` so the worker rebuild surface is gated cleanly.
-     */
     primitivesUsed?: string[];
     durationInFrames: number;
     fps: number;
@@ -196,5 +56,4 @@ export interface PrimitiveMeta<P = any> {
     height: number;
     preview: PrimitivePreview;
 }
-/** A category catalog: the ordered list of all primitives in one subpath. */
 export type Catalog = PrimitiveMeta[];

package/dist/_members/primitives/scenes/changelog-bite/index.d.ts

@@ -1,22 +1,10 @@
-/**
- * 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 ChangelogBiteProps {
     label?: string;
     title?: string;
-    /** ReactNode escape hatch (host-only; NOT expressible over the JSON params bag). */
     oldContent?: ReactNode;
-    /** ReactNode escape hatch (host-only; NOT expressible over the JSON params bag). */
     newContent?: ReactNode;
-    /** BEFORE-panel content as plain lines — the JSON-serializable comparison slot. */
     oldLines?: string[];
-    /** AFTER-panel content as plain lines — the JSON-serializable comparison slot. */
     newLines?: string[];
     format?: "square" | "portrait";
     background?: string;

package/dist/_members/primitives/scenes/hero-device-assemble/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 HeroDeviceAssembleProps {
     assembleStart?: number;
     device?: "laptop" | "phone";

package/dist/_members/primitives/scenes/landing-code-showcase/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 { LANDING_CODE_SHOWCASE_DURATION } from "./timeline.js";
 export interface LandingCodeShowcaseProps {
     accentColor?: string;

package/dist/_members/primitives/scenes/live-code-compilation/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 LiveCodeCompilationProps {
     accentColor?: string;
     speed?: number;

package/dist/_members/primitives/scenes/pricing-tier-focus/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 PricingTierFocusProps {
     focusedTier?: 0 | 1 | 2 | "0" | "1" | "2";
     accentColor?: string;