Ai Core

1"use client";
2 
3import {
4  type MotionValue,
5  useAnimationFrame,
6  useMotionValue,
7} from "motion/react";
8import { useCallback, useEffect, useRef, useState } from "react";
9 
10/**
11 * The single state contract shared by every SmoothUI AI component.
12 *
13 * Passing the same value to an orb, a prompt input and a tool card makes the
14 * whole surface move as one organism instead of a set of independent widgets.
15 */
16export type AIState =
17  | "idle"
18  | "listening"
19  | "thinking"
20  | "streaming"
21  | "done"
22  | "error";
23 
24/**
25 * A behavioural hint each component expresses **in its own material**.
26 *
27 * Deliberately not an overlay. Bolting one shared graphic onto every orb makes
28 * four different materials look like the same widget wearing a costume, and it
29 * pushes literal iconography (a checkmark, a warning ring) onto pieces that are
30 * decorative by nature. Instead: a shader warps, a canvas ring loses harmonics,
31 * a character changes expression. Same vocabulary, different flesh.
32 */
33export type AIStateMotif =
34  | "breathe"
35  | "receive"
36  | "scan"
37  | "pulse"
38  | "ping"
39  | "fault";
40 
41/** Semantic accent applied on top of the component's own palette. */
42export type AIStateAccent = "success" | "danger" | null;
43 
44/** Motion parameters a component reads to render a given {@link AIState}. */
45export type AIStateMotion = {
46  /** Semantic colour override, so status is carried by hue and not only motion. */
47  accent: AIStateAccent;
48  /** Outer bloom strength, 0–1. */
49  glow: number;
50  /** Palette hue rotation in degrees. Small shifts read as a mood change. */
51  hueRotate: number;
52  /** Overall motion energy, 0–1. Scales ambient loops and displacement. */
53  intensity: number;
54  /** Behavioural hint; each component expresses it in its own material. */
55  motif: AIStateMotif;
56  /** Seconds between discrete pulses, for rhythmic behaviour. */
57  pulseSeconds: number;
58  /**
59   * How far a shader's domain warp pushes the field, 0–1. Low values read as a
60   * calm surface; high values churn without the silhouette growing.
61   */
62  turbulence: number;
63  /** Revolutions per second of the noise field — the slow tumble. */
64  tumble: number;
65  /** How much external amplitude reaches the surface, 0 = ignore it. */
66  reactivity: number;
67  /** Chroma multiplier. Below 1 desaturates. */
68  saturation: number;
69  /** Resting scale of the surface, 1 = no change. */
70  scale: number;
71  /** Ambient loop speed multiplier, 1 = the component's base tempo. */
72  speed: number;
73};
74 
75/**
76// … truncated