@make-pictures/kits 0.0.0-stage → 2.0.1

package/dist/vfx/CinematicLensOverlay.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+export interface CinematicLensOverlayProps {
+    /** Radial vignette edge darkening in [0, 1] (default `0.36`) */
+    vignetteIntensity?: number;
+    /** Deterministic 35mm film grain opacity in [0, 0.18] (default `0.045`) */
+    grainOpacity?: number;
+    /**
+     * Lateral red/cyan chromatic aberration in [0, 1].
+     * When omitted, automatically reads `velocity` from `DirectorCameraTelemetryContext`
+     * so edge fringe appears organically during whip-pans and drops to `0` when still.
+     */
+    chromaticAberration?: number;
+    /** Multiplier applied when reading camera `velocity` automatically (default `0.85`) */
+    velocityAberrationScale?: number;
+    /** Slow organic warm anamorphic corner glow in [0, 1] (default `0.16`) */
+    warmLightLeak?: number;
+    /** Tint color for the warm corner light leak (default `'#F59E0B'`) */
+    lightLeakColor?: string;
+    /** Deterministic PRNG seed (default `77`) */
+    seed?: number;
+    /** Layer z-index (default `60`) */
+    zIndex?: number;
+}
+/**
+ * Deterministic 60 FPS Cinema Optical Lens Overlay (`pointerEvents: 'none'`).
+ * Combines radial optical vignette, velocity-reactive red/cyan chromatic fringe,
+ * organic corner light-leak breathe, and seeded `<feTurbulence>` film grain.
+ */
+export declare const CinematicLensOverlay: React.FC<CinematicLensOverlayProps>;

package/dist/vfx/ParticleField.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+export type ParticlePreset = 'dust-motes' | 'snow' | 'rain' | 'sparks' | 'confetti' | 'speed-lines';
+export interface ParticleFieldProps {
+    preset?: ParticlePreset;
+    count?: number;
+    color?: string;
+    seed?: number;
+    intensity?: number;
+    /** Respects Frame 0 clean-board invariant (`opacity = 0` at `frame === 0`, default `true`) */
+    cleanFrameZero?: boolean;
+    zIndex?: number;
+}
+/**
+ * 100% Analytical Deterministic 60 FPS 2D Particle Layer.
+ * Every particle's `(x, y, rotation, opacity, scale)` is evaluated as a pure
+ * closed-form function `f(frame, index, seed)` — safe under multi-core out-of-order renders.
+ */
+export declare const ParticleField: React.FC<ParticleFieldProps>;

package/dist/vfx/SceneTransition.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+export type SceneTransitionType = 'iris-wipe' | 'whip-pan' | 'paper-curtain' | 'flash-cut' | 'ink-wash';
+export interface SceneTransitionProps {
+    /** Frame where the transition reaches 100% coverage (place your underlying scene cut here) */
+    atFrame: number;
+    /** Total transition duration centered around `atFrame` (default `28` frames @ 60 FPS) */
+    durationInFrames?: number;
+    /** Visual transition choreography style (default `'iris-wipe'`) */
+    type?: SceneTransitionType;
+    /** Primary brand / trim color (default `STUDIO_THEME.colors.brand[600]`) */
+    accentColor?: string;
+    /** Deep backdrop curtain/wipe color (default `'#0F172A'`) */
+    backdropColor?: string;
+    /** Wipe travel direction for `'whip-pan'` (default `'left'`) */
+    direction?: 'left' | 'right' | 'up' | 'down';
+    /** Deterministic SVG displacement seed for `'ink-wash'` (default `51`) */
+    seed?: number;
+    zIndex?: number;
+}
+/**
+ * Declarative 60 FPS Scene Transition Overlay centered around `atFrame`.
+ * Renders `null` outside its `[atFrame - duration/2, atFrame + duration/2]` window.
+ */
+export declare const SceneTransition: React.FC<SceneTransitionProps>;

package/dist/vfx/StagePostProcessing3D.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+export interface ContactShadowDisc3DProps {
+    position?: [number, number, number];
+    radius?: number;
+    opacity?: number;
+    color?: string;
+    scaleX?: number;
+    scaleZ?: number;
+}
+/**
+ * Grounded radial soft contact shadow disc for 3D props and characters.
+ * Uses `polygonOffset` and `depthWrite={false}` to guarantee zero Z-fighting.
+ */
+export declare const ContactShadowDisc3D: React.FC<ContactShadowDisc3DProps>;
+export interface StagePostProcessing3DProps {
+    /** Exponential atmospheric fog color (default `'#F8F9FF'`) */
+    fogColor?: string;
+    /** Exponential fog density (`0` disables scene fog, default `0.02`) */
+    fogDensity?: number;
+    /** Enable volumetric spotlight cones (`true` = 2 beams, `false` = 0, or explicit count) */
+    spotlightBeams?: boolean | number;
+    /** Spotlight volumetric tint color (default `'#FFF7ED'`) */
+    beamColor?: string;
+    /** Peak volumetric beam opacity (default `0.075`) */
+    beamOpacity?: number;
+    /** Primary emitter world position (default `[-4.2, 8.2, 2.8]`) */
+    beamOrigin?: [number, number, number];
+    /** Primary spotlight target on floor (default `[0, 0, 0]`) */
+    beamTarget?: [number, number, number];
+    /** Render soft atmospheric depth-haze planes behind the stage (default `true`) */
+    depthHaze?: boolean;
+    /** Depth-haze tint color (default `'#E0E7FF'`) */
+    hazeColor?: string;
+    /** Depth-haze opacity (default `0.16`) */
+    hazeOpacity?: number;
+    /** Deterministic PRNG seed for volumetric motes & beam phases (default `303`) */
+    seed?: number;
+}
+/**
+ * Drop-in 3D Atmospheric & Volumetric Stage Post-Processing child for `<ThreeCanvas>`.
+ * Attaches `THREE.FogExp2`, renders deterministic additive volumetric spotlight dust-beams,
+ * floating 3D dust motes, and subtle background depth-haze planes using zero external post-fx packages.
+ */
+export declare const StagePostProcessing3D: React.FC<StagePostProcessing3DProps>;