Thinking orb
Motion effect and particles
A dotted orb whose state matches what the agent is doing, made your own with a recipe of plain data, with the step named in words beside it.
실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.
내 앱에 넣기
아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.
git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이
src/components/taster에 들어갑니다.node ../taster/packages/engine/cli.mjs add motion/thinking-orb --from https://taster-six.vercel.app --dir src/components/taster부품은 Tailwind 클래스로 그리고, Taster 프리셋이 그 클래스를 토큰에 연결합니다. Tailwind CSS 를 설치하고,
tokens.css를 앱 루트에서 한 번 불러온 뒤, 앱 루트에 이 설정을 둡니다. 프리셋이 없으면 빌드는 되어도 부품이 스타일 없이 나옵니다.// tailwind.config.cjs module.exports = { presets: [require('./src/components/taster/tailwind-preset.cjs')], content: ['./index.html', './src/**/*.{ts,tsx}'], };Tailwind v3 는 이 파일을 그대로 읽습니다. v4 는 Tailwind 를 불러오는
src/의 스타일시트 맨 위에 이 두 줄을 넣습니다.@import "tailwindcss"; @config "../tailwind.config.cjs";tokens.css는:root에--bg,--text,--border,--accent를 정의합니다. 내 앱의 스타일시트가 같은 이름을 뒤에서 다시 정의하면 그쪽 색이 이깁니다. 새 Vite 앱의 스타터 CSS 처럼 그런 변수가 있으면 지우거나 이름을 바꾸세요.
언제 쓰나요
- Agent thinking orbA dotted orb whose state matches what the agent is doing, made your own with a recipe of plain data, with the step named in words beside it.
대신 없애 주는 AI 티
- Orange 'processing' pill with a glow (AC-07)
정보
코드 보기
import * as React from 'react'
import { ThinkingOrb as Orb, type ThinkingOrbProps as OrbProps } from 'thinking-orbs'
import { luminance, resolveColor } from './_color'
import { sanitizeRecipe, type OrbRecipe } from './_orb-recipe'
export { ORB_KNOBS, ORB_STATES, sanitizeRecipe } from './_orb-recipe'
export type { NamedOrbRecipe, OrbKnob, OrbRecipe, OrbRecipeState } from './_orb-recipe'
export { ORB_RECIPES } from './orb-recipes'
// Thinking orb: a dotted orb that shows what an agent is doing, for a chat avatar or inline status. The drawing is the
// thinking-orbs package by Jakub Antalik, used as a dependency (https://github.com/Jakubantalik/Libraries.dev). This
// wrapper adds what a registry needs: a `recipe` so a variation is plain data, `tint` that takes a token, and a theme read
// from the --bg token rather than the OS, so the ink stays right when the OS and the page disagree.
// Upstream license: MIT, Copyright (c) 2026 Jakub Antalik. Full text in THIRD_PARTY_NOTICES.md.
//
// Do not ship the same default orb as everyone else: pick or make a recipe and match the state to what the agent is doing. See patterns/agent-thinking-orb.md.
export interface ThinkingOrbProps extends Omit<OrbProps, 'color' | 'opts'> {
/** A variation as data. Explicit props win over it. */
recipe?: OrbRecipe
/** ink follows the theme (default), brand reads --brand, or any CSS color or token. */
tint?: string
opts?: OrbProps['opts']
}
function toRgb(tint: string | undefined, el: Element | null): string | undefined {
if (!tint || tint === 'ink') return undefined
const [r, g, b] = resolveColor(tint === 'brand' ? 'var(--brand)' : tint, el)
return `rgb(${Math.round(r * 255)}, ${Math.round(g * 255)}, ${Math.round(b * 255)})`
}
export function ThinkingOrb({ recipe, tint, state, speed, dots, dotSize, opts, theme, ...props }: ThinkingOrbProps) {
const safe = recipe ? sanitizeRecipe(recipe) : null
const hostRef = React.useRef<HTMLSpanElement>(null)
const [color, setColor] = React.useState<string>()
const [tokenTheme, setTokenTheme] = React.useState<'dark' | 'light' | 'auto'>('auto')
const wanted = tint ?? safe?.tint
// Tokens resolve only in the browser, and again when the theme changes.
React.useEffect(() => {
const read = () => {
const el = hostRef.current
setColor(toRgb(wanted, el))
const hasBg = el && getComputedStyle(el).getPropertyValue('--bg').trim()
setTokenTheme(hasBg ? (luminance(resolveColor('var(--bg)', el)) > 0.5 ? 'light' : 'dark') : 'auto')
}
read()
const watch = new MutationObserver(read)
watch.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'data-theme', 'style'] })
return () => watch.disconnect()
}, [wanted])
return (
<span ref={hostRef} style={{ display: 'inline-flex' }}>
<Orb
state={state ?? safe?.state}
speed={speed ?? safe?.speed}
dots={dots ?? safe?.dots}
dotSize={dotSize ?? safe?.dotSize}
opts={opts ?? safe?.opts}
color={color}
theme={theme ?? tokenTheme}
{...props}
/>
</span>
)
}