wissive 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -12,6 +12,8 @@ export declare const ALL_STATES: InteractionState[];
  */
 export declare const ALL_WANDERABLE_STATES: InteractionState[];
 
+export declare const ANGLES: number[];
+
 declare class AnimationLoop {
     private callbacks;
     private handle;
@@ -52,6 +54,11 @@ export declare const AUTONOMOUS_STATES: InteractionState[];
  */
 export declare function blendColors(colorA: string, colorB: string, factor: number): string;
 
+/**
+ * Interpola linealmente entre dos conjuntos de 64 radios
+ */
+export declare function blendProfiles(a: number[], b: number[], t: number): number[];
+
 /**
  * Construye una definición de emoji personalizado: base neutra (Cota),
  * silueta a elección (circle por default), con ojos/boca/animación tomados
@@ -69,8 +76,17 @@ export declare function checkContrast(bgColor: string, fgColor: string, minRatio
     passes: boolean;
 };
 
+export declare const clamp: (v: number, lo?: number, hi?: number) => number;
+
+/**
+ * Convierte polilínea cerrada de 64 puntos en curva Bézier cúbica Catmull-Rom cerrada continua
+ */
+export declare function closedCatmullRomPath(pts: Point[], tension?: number): string;
+
 export declare type CoreInteractionState = 'idle' | 'near' | 'hover' | 'click';
 
+export declare const COS: number[];
+
 /**
  * Construye (o reconstruye) un emoji personalizado, lo persiste en localStorage
  * y lo registra en LIB para poder usarlo directamente con createEmoji(name, ...).
@@ -95,6 +111,8 @@ export declare function createSequencePlayer(hooks: {
     applyStep: (params: Partial<FaceParameters>) => void;
 }): SequencePlayer;
 
+export declare function createStateManager(initialState?: InteractionState): StateManager;
+
 export declare type CueSoundType = 'chime' | 'sparkle' | 'droplet' | 'bloom' | 'whisper' | 'tick' | 'press' | 'release' | 'toggle' | 'success' | 'error' | 'page' | 'loading' | 'ready' | 'pulse' | 'scan' | 'arrival';
 
 export declare interface CustomEmojiOptions {
@@ -329,6 +347,8 @@ export declare interface FaceParameters {
      * 24: cat-cup-smirk]
      */
     mouthType: number;
+    /** Eyebrows visible toggle (0: hidden, 1: visible) */
+    showBrows: number;
     /** Eyebrow Y offset */
     browY: number;
     /** Eyebrow tilt angle in degrees (+ is angry \ /, - is sad / \) */
@@ -361,6 +381,11 @@ export declare interface FaceParameters {
 
 export declare type FrameCallback = (dt: number) => void;
 
+/**
+ * Genera el SVG `<path d="..." />` suave a partir de cualquier perfil de 64 radios
+ */
+export declare function generateSilhouettePath(radii: number[], cx?: number, cy?: number, radius?: number): string;
+
 /**
  * Calcula el ratio de contraste entre dos colores (e.g. 3:1, 4.5:1).
  */
@@ -380,11 +405,21 @@ export declare function getLuminance(color: string): number;
 
 export declare function getSilhouettePath(silhouette: SilhouetteType): string;
 
+/**
+ * Devuelve el perfil radial de 64 muestras para una silueta dada
+ */
+export declare function getSilhouetteProfile(type: SilhouetteType): number[];
+
 /**
  * Obtiene el tema sugerido para un estado dado, con fallback a la paleta predeterminada del emoji.
  */
 export declare function getThemeForState(_state: InteractionState, defaultBaseColor: string): EmojiTheme;
 
+/**
+ * Envolvente convexa de dos círculos (utilizado para cápsulas, gotas y peras)
+ */
+export declare function hullOfCircles(x1: number, y1: number, r1: number, x2: number, y2: number, r2v: number, steps?: number): Point[];
+
 export declare const IDLE_MOTIONS: Record<MotionType, IdleMotionFn>;
 
 /**
@@ -422,6 +457,8 @@ export declare function isReducedMotionPreferred(): boolean;
  */
 export declare function isTouchDevice(): boolean;
 
+export declare const lerp: (a: number, b: number, t: number) => number;
+
 export declare const LIB: Record<string, EmojiDefinition>;
 
 export declare type LifecycleState = 'sleeping' | 'waking' | 'idle' | 'listening' | 'thinking' | 'searching' | 'working';
@@ -451,11 +488,17 @@ export declare type MotionType = 'bouncy' | 'flutter' | 'serene' | 'float' | 'ca
 
 export declare interface MultiSpring<T extends Record<string, number>> {
     getValues: () => T;
+    setConfig: (config: Partial<SpringConfig> | TransitionProfile) => void;
     setTargets: (targets: Partial<T>) => void;
     setValues: (values: Partial<T>) => void;
     update: (dt: number) => boolean;
 }
 
+/**
+ * Normaliza los radios para que el radio máximo o medio sea consistente
+ */
+export declare function normalizeRadii(radii: number[], targetMax?: number): number[];
+
 export declare class ParticleEmitter {
     private particles;
     private canvas;
@@ -482,13 +525,29 @@ export declare const PERSONALITY_DRIVEN_STATES: InteractionState[];
 /** Elige uno al azar de `pool`, evitando repetir `previous` cuando hay más de una opción */
 export declare function pickWithoutRepeat<T>(pool: T[], previous: T | null): T;
 
+export declare interface Point {
+    x: number;
+    y: number;
+}
+
 export declare type ProductCycleState = 'spawning' | 'humming' | 'loading' | 'dictating' | 'writing' | 'sending' | 'receiving' | 'uploading' | 'notifying' | 'alerting' | 'dragging' | 'bouncing' | 'powering-down';
 
+export declare const PROFILE_SAMPLES = 64;
+
+/**
+ * Perfil radial a partir de polígono 2D por raycasting desde el centro
+ */
+export declare function profileFromPolygon(poly: Point[], cx?: number, cy?: number): number[];
+
+/** Round number to 2 decimals to keep SVG path string light & fast */
+export declare const r2: (v: number) => number;
+
 export declare type ReactionState = 'excited' | 'surprised' | 'suspicious' | 'angry' | 'drowsy' | 'happy' | 'curious' | 'confused' | 'bored' | 'proud' | 'shy' | 'sad' | 'laughing' | 'scared' | 'playful' | 'celebrate';
 
 export declare interface RenderOptions {
     flipX?: boolean;
     emphasis?: boolean;
+    radii?: number[];
 }
 
 export declare function renderSvgElement(silhouette: SilhouetteType, baseColor: string, params: FaceParameters, size: number, renderOptions?: RenderOptions): string;
@@ -539,8 +598,15 @@ export declare function setGlobalVolume(volume: number): void;
 
 export declare const sharedLoop: AnimationLoop;
 
+/**
+ * Perfiles radiales precalculados (64 muestras cada uno)
+ */
+export declare const SILHOUETTE_PROFILES: Record<SilhouetteType, number[]>;
+
 export declare type SilhouetteType = 'circle' | 'capsule' | 'rounded-squircle' | 'pear-blob' | 'egg-oval' | 'starburst-puff' | 'pill-vertical' | 'heart' | 'round-blob' | 'ghost-blob' | 'oval' | 'elongated-oval' | 'teardrop-blob' | 'flame-blob' | 'droopy-blob' | 'bear-blob' | 'spiky-blob' | 'cloud-blob' | 'wide-oval' | 'soft-round' | 'octopus-blob' | 'wave-blob';
 
+export declare const SIN: number[];
+
 export declare const SIZE_PRESETS: Record<WissivePresetSize, number>;
 
 export declare class SoundEngine {
@@ -559,6 +625,8 @@ export declare class SoundEngine {
 
 export declare const soundEngine: SoundEngine;
 
+export declare const SPRING_PRESETS: Record<TransitionProfile, SpringConfig>;
+
 export declare interface SpringConfig {
     stiffness: number;
     damping: number;
@@ -567,6 +635,7 @@ export declare interface SpringConfig {
 
 export declare interface SpringInstance {
     state: SpringState;
+    setConfig: (config: Partial<SpringConfig>) => void;
     setTarget: (target: number) => void;
     setCurrent: (value: number) => void;
     update: (dt: number) => boolean;
@@ -602,6 +671,7 @@ export declare interface StateGroup {
 export declare class StateManager {
     private currentState;
     private lastIndices;
+    constructor(initialState?: InteractionState);
     getState(): InteractionState;
     setState(newState: InteractionState): boolean;
     resolvePool(expressions: Record<string, FaceParameters[]>, state?: InteractionState): FaceParameters[];
@@ -613,14 +683,28 @@ export declare class StateManager {
  */
 export declare function subscribeToReducedMotion(onChange: (reduced: boolean) => void): () => void;
 
+/**
+ * Superellipse formula: |x/sx|^n + |y/sy|^n = 1
+ */
+export declare function superellipseProfile(n: number, sx?: number, sy?: number): number[];
+
 /**
  * Detecta si el dispositivo actual soporta hover real (puntero fino como mouse o trackpad).
  * Devuelve false en dispositivos táctiles primarios (smartphones, tablets sin mouse).
  */
 export declare function supportsHover(): boolean;
 
+export declare const TAU: number;
+
 export declare type ThemeOption = 'auto' | EmojiTheme;
 
+/**
+ * Convierte un perfil de 64 radios en 64 puntos 2D en coordenadas de SVG (cx, cy, radio base)
+ */
+export declare function toPoints(radii: number[], cx?: number, cy?: number, baseRadius?: number, scaleX?: number, scaleY?: number): Point[];
+
+export declare type TransitionProfile = 'smooth' | 'bouncy' | 'snappy' | 'gentle' | 'instant';
+
 declare const Wissive: {
     create: typeof createEmoji;
     createGroup: typeof createEmojiGroup;
@@ -662,6 +746,8 @@ export declare interface WissiveInstance {
     setReducedMotion: (setting: 'auto' | boolean) => void;
     setTheme: (theme: ThemeOption) => void;
     setSize: (size: WissiveSize) => void;
+    setSilhouette: (silhouette: SilhouetteType, duration?: number) => void;
+    setSpringConfig: (config: Partial<SpringConfig> | TransitionProfile) => void;
     triggerParticles: (count?: number) => void;
     playSequence: (steps: SequenceStep[], options?: SequenceOptions) => void;
     stopSequence: () => void;