Taster

진단부품톤 고르기
부품 갤러리 / Thinking orb

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.

내 사이트에서 가져오기

색을 고르면 아래 부품이 그 색으로 바뀝니다.

실제로 돌아가는 부품입니다. 눌러 보고 입력해 보세요.

내 앱에 넣기

  1. 아직 npm 패키지가 없어서 Taster 리포를 받아 그 안의 명령을 씁니다. 내 앱 폴더가 들어 있는 폴더에서 한 번만 받습니다.

    git clone https://github.com/makim-414/taster.git && npm ci --prefix taster/packages/engine
  2. 내 앱 폴더에서 이 부품을 넣습니다. 부품 파일과 토큰 파일이 src/components/taster 에 들어갑니다.

    node ../taster/packages/engine/cli.mjs add motion/thinking-orb --from https://taster-six.vercel.app --dir src/components/taster
  3. 부품은 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)

정보

설치할 패키지
tailwindcss, thinking-orbs
라이선스
MIT
출처
thinking-orbs by Jakub Antalik, MIT, https://github.com/Jakubantalik/Libraries.dev
코드 보기
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>
  )
}