@make-pictures/kits 0.0.0-stage → 2.0.1

package/dist/kinetic-typography/ImpactKeywordCard.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+export interface ImpactKeywordCardProps {
+    /** Primary bold statement (keep concise: 2–4 words per AGENTS.md) */
+    keyword: string;
+    /** Optional small category eyebrow above the keyword */
+    eyebrow?: string;
+    /** Optional concise 2–4 word takeaway sublabel */
+    sublabel?: string;
+    /** Optional status pill badge (e.g. `"60 FPS"`, `"-14 LUFS"`) */
+    badge?: string;
+    /** Custom icon node (`lucide-react`); defaults to `<Sparkles />` unless `icon={null}` */
+    icon?: React.ReactNode;
+    /** Accent bar & glow color (default `STUDIO_THEME.colors.brand[600]`) */
+    accentColor?: string;
+    /** Theme surface mode (default `'dark'`) */
+    variant?: 'dark' | 'light';
+    /** Entrance frame (default `2`, obeying Frame 0 clean board rule) */
+    enterFrame?: number;
+    /** Alias for `enterFrame` */
+    startFrame?: number;
+    /** Optional exit frame for smooth spring dismissal */
+    exitFrame?: number;
+    /** Constrain max width cleanly inside `9:16 Golden Safe Box` when vertical (default `true`) */
+    safeBox9x16?: boolean;
+    style?: React.CSSProperties;
+}
+/**
+ * Bold 60 FPS Typographic Hero Card with glowing accent bar, icon badge,
+ * and high-damping (`damping: 200`) spring entrance.
+ */
+export declare const ImpactKeywordCard: React.FC<ImpactKeywordCardProps>;

package/dist/kinetic-typography/WordByWordStage.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+import type { SceneVoiceoverData, WordTimestamp } from '@make-pictures/core';
+export interface WordPhraseBeat {
+    words: WordTimestamp[];
+    startFrame: number;
+    endFrame: number;
+}
+export interface WordByWordStageProps {
+    /** Word-level timestamps (`WordTimestamp[]`) to drive rhythmic phrase beats */
+    words?: ReadonlyArray<WordTimestamp>;
+    /** Optional sceneId lookup into `voiceoverManifest` (used when `words` is omitted) */
+    sceneId?: string;
+    /** Optional isolated capsule voiceover manifest */
+    voiceoverManifest?: Record<string, SceneVoiceoverData>;
+    /** Optional fallback text if neither `words` nor `sceneId` has timestamps yet */
+    fallbackText?: string;
+    /** Composition frame offset when this scene starts (default `0`) */
+    sceneStartFrame?: number;
+    /** Target words per visual beat (`3..5` recommended, default `4`) */
+    wordsPerBeat?: number;
+    /** Highlight pill accent color (default `STUDIO_THEME.colors.brand[600]`) */
+    accentColor?: string;
+    /** Surface styling mode (`'transparent'` overlays 2D/3D stage cleanly) */
+    variant?: 'dark' | 'light' | 'transparent';
+    /** Optional top category pill */
+    eyebrow?: string;
+    /** Optional explicit headline font size in px */
+    fontSize?: number;
+    /** Constrain layout strictly inside `9:16 Golden Safe Box` when `height > width` (default `true`) */
+    safeBox9x16?: boolean;
+    /** Entrance start frame (clamped `>= 2` by default so Frame 0 stays clean) */
+    enterFrame?: number;
+    /** Alias for `enterFrame` */
+    startFrame?: number;
+    style?: React.CSSProperties;
+}
+/**
+ * Groups `WordTimestamp[]` into crisp rhythmic phrases of `3–5` words,
+ * breaking naturally on sentence-ending punctuation or vocal pauses.
+ */
+export declare function groupWordsIntoBeats(words: ReadonlyArray<WordTimestamp>, wordsPerBeat?: number, fps?: number): WordPhraseBeat[];
+/**
+ * Rhythmic 60 FPS Kinetic Typography spotlight synced to `WordTimestamp[]`.
+ * Features damped active-word scale pop, glowing pill highlight, smart 3–5 word phrase beats,
+ * and automatic `9:16 Golden Safe Box` (`x ∈ [40, 910], y ∈ [220, 1380]`) framing.
+ */
+export declare const WordByWordStage: React.FC<WordByWordStageProps>;