{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "working-glyph",
  "title": "Working Glyph",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Ícone que trabalha enquanto o sistema trabalha: picareta, martelo, engrenagem, pincel ou faísca, e o brilho corre só no traço.",
  "dependencies": [
    "lucide-react"
  ],
  "registryDependencies": [
    "utils",
    "https://visant-ui.vercel.app/r/glitch-chars.json",
    "@visant/glitch-chars",
    "@visant/motion"
  ],
  "files": [
    {
      "path": "registry/visant/ui/working-glyph.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\nimport { Cog, Hammer, Paintbrush, Pickaxe, Sparkles, type LucideIcon } from \"lucide-react\";\n\nimport { EASE_ASSENTA_CSS, EASE_SAIDA_CSS } from \"@/lib/motion\";\nimport { cn } from \"@/lib/utils\";\nimport { GlitchChars } from \"@/components/ui/glitch-chars\";\n\n/**\n * Um ícone trabalhando: o sistema mostrando esforço em vez de pedir paciência.\n *\n * A diferença para um spinner é de narrativa: spinner é o sistema pedindo\n * paciência, isto é o sistema mostrando esforço. Em geração de imagem (20–60s)\n * essa leitura é o que segura o usuário na tela.\n *\n * ── Cinco ofícios, cada um com o gesto dele ────────────────────────────────\n *\n * | `variant` | ícone | gesto |\n * |---|---|---|\n * | `picareta` | Pickaxe | balanço com pivô no cabo, faísca na ponta |\n * | `martelo` | Hammer | golpe seco e volta lenta, faísca no impacto |\n * | `engrenagem` | Cog | giro contínuo, sem faísca (máquina, não mão) |\n * | `pincel` | Paintbrush | pincelada curta indo e voltando |\n * | `faisca` | Sparkles | respiro de escala, pra espera de \"mágica\" |\n *\n * O `icon` continua aberto: passe outro glifo e ele herda o gesto da variante.\n *\n * ── O brilho mora no traço, não na caixa ───────────────────────────────────\n *\n * A versão anterior varria um gradiente por cima da caixa inteira, e com a\n * moldura ligada o brilho atravessava o quadrado todo em vez do ícone. Agora o\n * brilho é uma CÓPIA do próprio ícone em tom cheio sobre a base um tom abaixo,\n * revelada por uma faixa inclinada em `clip-path`. Só os pixels do traço acendem.\n *\n * Toda animação é Web Animations API, sem bloco `css` a instalar à parte. Sob\n * `prefers-reduced-motion` o ícone fica parado e sem brilho.\n */\n\n// Um ciclo de cada gesto, em laço: é o ritmo da ferramenta, não transição de UI.\nconst CICLO_MS = { picareta: 900, martelo: 1000, engrenagem: 2800, pincel: 1100, faisca: 1600, brilho: 2600 } as const;\n\nexport type WorkingGlyphVariant = \"picareta\" | \"martelo\" | \"engrenagem\" | \"pincel\" | \"faisca\";\n\ntype Gesto = {\n  icone: LucideIcon;\n  quadros: Keyframe[];\n  opcoes: KeyframeAnimationOptions;\n  origem: string;\n  faisca: boolean;\n};\n\nconst GESTOS: Record<WorkingGlyphVariant, Gesto> = {\n  picareta: {\n    icone: Pickaxe,\n    // Pivô em 60%/80%: onde a mão seguraria o cabo. Centralizar mata o gesto.\n    quadros: [\n      { transform: \"rotate(-8deg) translateY(0)\" },\n      { transform: \"rotate(6deg) translateY(1px)\", offset: 0.4 },\n      { transform: \"rotate(3deg) translateY(2px)\", offset: 0.6 },\n      { transform: \"rotate(-8deg) translateY(0)\" },\n    ],\n    opcoes: { duration: CICLO_MS.picareta, iterations: Infinity, easing: \"ease-in-out\" },\n    origem: \"60% 80%\",\n    faisca: true,\n  },\n  martelo: {\n    icone: Hammer,\n    // Golpe em 25% do ciclo, volta no resto: a assimetria é o peso do martelo.\n    quadros: [\n      { transform: \"rotate(-28deg)\", easing: EASE_SAIDA_CSS },\n      { transform: \"rotate(6deg)\", offset: 0.25, easing: \"ease-out\" },\n      { transform: \"rotate(2deg)\", offset: 0.35, easing: EASE_ASSENTA_CSS },\n      { transform: \"rotate(-28deg)\" },\n    ],\n    opcoes: { duration: CICLO_MS.martelo, iterations: Infinity },\n    origem: \"20% 85%\",\n    faisca: true,\n  },\n  engrenagem: {\n    icone: Cog,\n    quadros: [{ transform: \"rotate(0deg)\" }, { transform: \"rotate(360deg)\" }],\n    opcoes: { duration: CICLO_MS.engrenagem, iterations: Infinity, easing: \"linear\" },\n    origem: \"50% 50%\",\n    faisca: false,\n  },\n  pincel: {\n    icone: Paintbrush,\n    quadros: [\n      { transform: \"translate(-2px, 1px) rotate(-6deg)\" },\n      { transform: \"translate(2px, -1px) rotate(4deg)\", offset: 0.5 },\n      { transform: \"translate(-2px, 1px) rotate(-6deg)\" },\n    ],\n    opcoes: { duration: CICLO_MS.pincel, iterations: Infinity, easing: \"ease-in-out\" },\n    origem: \"80% 20%\",\n    faisca: false,\n  },\n  faisca: {\n    icone: Sparkles,\n    quadros: [\n      { transform: \"scale(0.9) rotate(-4deg)\", opacity: 0.75 },\n      { transform: \"scale(1.08) rotate(4deg)\", opacity: 1, offset: 0.5 },\n      { transform: \"scale(0.9) rotate(-4deg)\", opacity: 0.75 },\n    ],\n    opcoes: { duration: CICLO_MS.faisca, iterations: Infinity, easing: \"ease-in-out\" },\n    origem: \"50% 50%\",\n    faisca: false,\n  },\n};\n\n/** Faixa inclinada atravessando o glifo, e depois pausa: brilho, não estrobo. */\nconst BRILHO: Keyframe[] = [\n  { clipPath: \"polygon(-40% 0%, -10% 0%, -30% 100%, -60% 100%)\" },\n  { clipPath: \"polygon(110% 0%, 140% 0%, 120% 100%, 90% 100%)\", offset: 0.45 },\n  { clipPath: \"polygon(110% 0%, 140% 0%, 120% 100%, 90% 100%)\" },\n];\n\nfunction useAnimacao(\n  ref: React.RefObject<HTMLElement | null>,\n  quadros: Keyframe[] | null,\n  opcoes: KeyframeAnimationOptions,\n  chave: string,\n) {\n  React.useEffect(() => {\n    const el = ref.current;\n    if (!el || !quadros || typeof el.animate !== \"function\") return;\n    const media = window.matchMedia?.(\"(prefers-reduced-motion: reduce)\");\n    let anim: Animation | null = null;\n    const aplicar = () => {\n      anim?.cancel();\n      anim = media?.matches ? null : el.animate(quadros, opcoes);\n    };\n    aplicar();\n    media?.addEventListener?.(\"change\", aplicar);\n    return () => {\n      anim?.cancel();\n      media?.removeEventListener?.(\"change\", aplicar);\n    };\n    // `chave` resume quadros + opções: os objetos vêm de uma tabela estável.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [chave]);\n}\n\nexport function WorkingGlyph({\n  variant = \"picareta\",\n  icon,\n  size = 20,\n  framed = true,\n  shine = true,\n  className,\n}: {\n  /** O ofício: ícone + gesto. Ver a tabela acima. */\n  variant?: WorkingGlyphVariant;\n  /** Troca o glifo e mantém o gesto da variante. */\n  icon?: React.ReactNode;\n  size?: number;\n  /** Moldura discreta atrás do ícone. Desligue ao usar sobre imagem. */\n  framed?: boolean;\n  /** Faixa de luz passando pelo traço do ícone. */\n  shine?: boolean;\n  className?: string;\n}) {\n  const gesto = GESTOS[variant] ?? GESTOS.picareta;\n  const Icone = gesto.icone;\n  const glifo = icon ?? <Icone size={size} />;\n\n  const corpo = React.useRef<HTMLSpanElement>(null);\n  const luz = React.useRef<HTMLSpanElement>(null);\n  useAnimacao(corpo, gesto.quadros, gesto.opcoes, variant);\n  useAnimacao(\n    luz,\n    shine ? BRILHO : null,\n    { duration: CICLO_MS.brilho, iterations: Infinity, easing: \"ease-in-out\", delay: 300 },\n    `${variant}-${shine}`,\n  );\n\n  return (\n    <div\n      className={cn(\n        \"relative inline-flex items-center justify-center overflow-visible text-foreground\",\n        framed && \"rounded-[var(--r-control)] border border-border bg-background/30 px-3 py-2\",\n        className,\n      )}\n      aria-hidden=\"true\"\n    >\n      <span ref={corpo} className=\"relative inline-grid\" style={{ transformOrigin: gesto.origem }}>\n        {/* Com brilho, o glifo de base descansa um tom abaixo e a faixa devolve\n            o tom cheio: a luz aparece em qualquer cor de marca e em qualquer\n            tema, porque é contraste com o próprio ícone, não uma cor nova. */}\n        <span className={cn(\"col-start-1 row-start-1 inline-flex\", shine && \"opacity-70\")}>{glifo}</span>\n        {shine ? (\n          // A cópia que acende. Começa fora do quadro (clip vazio), então sem\n          // animação, ou com movimento reduzido, ela simplesmente não aparece.\n          <span\n            ref={luz}\n            className=\"col-start-1 row-start-1 inline-flex [filter:brightness(1.35)]\"\n            style={{ clipPath: \"polygon(-40% 0%, -10% 0%, -30% 100%, -60% 100%)\" }}\n          >\n            {glifo}\n          </span>\n        ) : null}\n      </span>\n\n      {/* Faísca só nos ofícios de impacto. Sem moldura a caixa é do tamanho do\n          ícone, então a faísca sai pra fora dela; dentro, cairia em cima do\n          próprio glifo e viraria sujeira. */}\n      {gesto.faisca ? (\n        <GlitchChars\n          length={1}\n          intervalMs={120}\n          className={cn(\n            \"absolute text-[10px] font-bold leading-none opacity-80\",\n            framed ? \"bottom-1 right-1.5\" : \"-bottom-1.5 -right-1.5\",\n          )}\n        />\n      ) : null}\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Ícone pequeno mostrando que algo trabalha, ao lado de rótulo ou botão, numa espera curta",
      "evite": "Espera longa que pede explicação: status-ticker; transferência de arquivo, paper-shuttle"
    }
  },
  "categories": [
    "feedback",
    "espera",
    "icone"
  ],
  "type": "registry:ui"
}