{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "measure-bar",
  "title": "Measure Bar",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Nenhum número sem régua: valor, qualificador, evidência e rótulo nessa ordem. Sem denominador a barra não desenha, e o estado desconhecido fica tracejado em vez de zerado.",
  "registryDependencies": [
    "utils"
  ],
  "files": [
    {
      "path": "registry/visant/ui/measure-bar.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\n\n/**\n * Measure Bar — nenhum número sem régua.\n *\n * A regra que a skill `visant-refine` põe em primeiro lugar, e que quase toda\n * dobra de prova quebra: **valor sem qualificador é trivia, e valor sem\n * evidência não tem contra o quê ser lido.** \"R$450k\" não diz nada; \"R$450k, em\n * 14 meses, de uma meta de 600k\" diz.\n *\n * Os quatro papéis, nesta ordem visual: o rótulo nomeia, o valor manda, o\n * qualificador transforma o valor em fato e a régua prova.\n *\n * ```\n * rótulo  →  valor  →  qualificador  →  evidência (a régua)\n * ```\n *\n * A régua ocupa a largura da coluna e tem escala desenhada embaixo (de 10 em\n * 10%, com a metade marcada). Uma barrinha de 88px sem escala era lida como\n * enfeite, e a peça parecia simples demais pra prova que carrega.\n *\n * ── A decisão que o componente força, e é o valor dele ─────────────────────\n *\n * `ratio` é **obrigatoriamente explícito ou ausente**. Não existe default 1, e\n * não existe régua derivada do valor. Se você não tem denominador honesto, a\n * régua não desenha — e é isso que está certo:\n *\n * · Um número com `+` (\"200+ na comunidade\") é **piso**, não proporção. Barra\n *   proporcional representaria mal o número por definição.\n * · Uma barra em zero afirma \"zero de N\", que é um fato — e afirmar um fato que\n *   ninguém mediu é pior que não desenhar nada.\n *\n * Por isso existe `state=\"unknown\"`: a trilha vira tracejado em vez de sumir. A\n * ausência fica **desenhada**, e quem olha entende que o dado não chegou, em\n * vez de ler zero.\n *\n * A régua cresce de `scaleX(0)` na entrada, mas o estado de repouso — sem JS,\n * sem observer, sem hidratação — é a régua CHEIA. Esconder a evidência pra\n * sempre porque um script não rodou é o modo de falha caro.\n */\n\nexport interface MeasureBarProps extends React.HTMLAttributes<HTMLDivElement> {\n  /** O número, já formatado. Combina com `@visant/count-up` como children. */\n  value: React.ReactNode;\n  /** O qualificador que transforma trivia em fato. \"em 14 meses\", \"de 600k\". */\n  qualifier?: React.ReactNode;\n  /** Nome do que está sendo medido. */\n  label?: React.ReactNode;\n  /**\n   * 0–1. **Sem default de propósito.** Omitir não desenha régua; é a saída\n   * honesta pra número que é piso, não proporção.\n   */\n  ratio?: number;\n  /** `unknown` desenha a trilha tracejada: o dado não chegou, e isso se vê. */\n  state?: \"ok\" | \"unknown\";\n  align?: \"start\" | \"center\";\n}\n\nexport function MeasureBar({\n  value,\n  qualifier,\n  label,\n  ratio,\n  state = \"ok\",\n  align = \"start\",\n  className,\n  ...props\n}: MeasureBarProps) {\n  const temRegua = state === \"unknown\" || typeof ratio === \"number\";\n  const v = typeof ratio === \"number\" ? Math.max(0, Math.min(1, ratio)) : 0;\n\n  return (\n    <div\n      className={cn(\n        \"measure-bar flex min-w-0 flex-col\",\n        align === \"center\" ? \"items-center text-center\" : \"items-start\",\n        className,\n      )}\n      {...props}\n    >\n      {label && (\n        <div className=\"text-[length:var(--text-apoio,0.8125rem)] font-medium text-muted-foreground\">\n          {label}\n        </div>\n      )}\n\n      <div className=\"mt-1 [font-family:var(--font-display,inherit)] text-[clamp(1.75rem,1.4rem+1.4vw,2.5rem)] font-semibold leading-none tracking-[-0.03em] tabular-nums text-foreground\">\n        {value}\n      </div>\n\n      {qualifier && (\n        <div className=\"mt-2 text-pretty text-[length:var(--text-apoio,0.8125rem)] leading-[1.45] text-muted-foreground\">\n          {qualifier}\n        </div>\n      )}\n\n      {temRegua && (\n        // A régua de verdade: trilha, preenchimento e escala embaixo. Os traços\n        // de 10 em 10 é que fazem a barra ser lida como medida e não como\n        // enfeite; o maior marca a metade, onde o olho ancora a leitura.\n        <div className=\"mt-4 w-full\">\n          <div\n            className=\"measure-bar-track h-1.5 w-full overflow-hidden rounded-[var(--r-pill,9999px)] bg-[var(--muted)]\"\n            data-state={state}\n            role={state === \"ok\" ? \"img\" : undefined}\n            aria-label={state === \"ok\" ? `${Math.round(v * 100)}%` : undefined}\n          >\n            {state === \"ok\" && (\n              <i\n                className=\"measure-bar-fill block h-full origin-left rounded-[var(--r-pill,9999px)] bg-[var(--brand,var(--foreground))]\"\n                style={{ [\"--v\" as string]: v }}\n              />\n            )}\n          </div>\n          <div aria-hidden=\"true\" className=\"mt-1.5 flex w-full items-start justify-between\">\n            {Array.from({ length: 11 }, (_, i) => (\n              <span\n                key={i}\n                className={cn(\"w-px bg-[var(--border)]\", i % 5 === 0 ? \"h-2\" : \"h-1\")}\n              />\n            ))}\n          </div>\n        </div>\n      )}\n    </div>\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "css": {
    "@layer components": {
      ".measure-bar-fill": {
        "width": "100%",
        "transform": "scaleX(var(--v, 1))",
        "transition": "transform var(--dur-slow, 700ms) var(--ease-out)"
      },
      ".visant-fold[data-armed]:not([data-in]) .measure-bar-fill": {
        "transform": "scaleX(0)"
      },
      ".measure-bar-track[data-state=\"unknown\"]": {
        "background": "repeating-linear-gradient(90deg, var(--border) 0 6px, transparent 6px 12px)"
      }
    },
    "@media (prefers-reduced-motion: reduce)": {
      ".measure-bar-fill": {
        "transition": "none"
      }
    }
  },
  "meta": {
    "uso": {
      "quando": "Mostrar métrica com régua, qualificador e evidência, em landing de prova ou relatório",
      "evite": "Medidor de cota em arco: gauge; número que só apura ao entrar, count-up"
    }
  },
  "categories": [
    "conteudo",
    "numero",
    "regua",
    "evidencia",
    "prova",
    "metrica"
  ],
  "type": "registry:ui"
}