Skip to content

feat(ds): MSCS DS V5.2 — sistema de dois modos Tradutor/Veredicto - #14

Draft
1marcelserrano wants to merge 1 commit into
mainfrom
claude/design-system-mscs-v5-2-3n213g
Draft

feat(ds): MSCS DS V5.2 — sistema de dois modos Tradutor/Veredicto#14
1marcelserrano wants to merge 1 commit into
mainfrom
claude/design-system-mscs-v5-2-3n213g

Conversation

@1marcelserrano

Copy link
Copy Markdown
Owner

Resumo

Entra a spec do MSCS DS V5.2 — sistema de dois modos, Tradutor (papel com contorno, default) e Veredicto (preto elétrico, raro) — como camada paralela ao V3.0 da Era Midnight, com implementação em CSS/JS e verificação automatizada dos hex.

Tipo

  • feat — nova feature
  • fix — correção de bug
  • tokens — alteração em css/tokens.css (requer bump)
  • docs — documentação
  • refactor — refator sem mudança funcional
  • chore — manutenção/infra

Escopo afetado

  • css/tokens.css (canônico — bump obrigatório) — intocado
  • docs/CANONICAL_REFERENCE.md
  • governance.html (regras visuais normativas)
  • Superfícies HTML (index/formats/products/studies) — intocadas
  • js/ (novo rabisco.js; nav e wireframe-engine intocados)
  • Templates / Studies

Arquivos novos: DESIGN_SYSTEM.md, css/ms-v5.css, js/rabisco.js, tools/contrast.mjs.

Breaking change?

  • Sim
  • Não

O V5.2 usa prefixo próprio --ms-*, que não colide com --ds-*/--p-*. Nenhum token existente foi alterado ou removido, nenhuma superfície pública muda de aparência, e nada é importado por padrão — css/ms-v5.css só age em quem o incluir. Consumo downstream via submódulo segue idêntico.

Decisão em aberto: qual dos dois sistemas governa o site. Registrada em DESIGN_SYSTEM.md §10.4 e em docs/CANONICAL_REFERENCE.md, com a regra de não migrar superfície pública para --ms-* sem DEC dedicado.

O que entra

Arquivo Papel
DESIGN_SYSTEM.md Spec normativa V5.2, consolidando V3.1/V3.2/V4.0/V5.0/V5.1 daquela linha
css/ms-v5.css Tokens dos dois modos, escala tipográfica §6, contorno de 3px, sombra tingida, termo-chave em guilhemés
js/rabisco.js Textura primária — gerador determinístico, semente 20260805, zona de texto rejeitada no gerador
tools/contrast.mjs Lê os hex direto do CSS e falha se algum par divergir do documentado ou reprovar no piso WCAG do papel

Troca de modo é um atributo no raiz: <body data-modo="veredicto">.

Correção incluída

A tabela de função de cor do §4 citava o cobalto do Veredicto em #3A3FA8 — o valor reprovado na calibragem V5.1 — enquanto o token do §3 já trazia o #4B53E0 corrigido. Duas fontes, uma delas errada.

Medido: #3A3FA82.19:1 sobre a superfície do modo, abaixo do piso de 3.0 para elemento não-textual. Prevalece o token #4B53E0 (3.21:1). tools/contrast.mjs cobre o par, então a regressão não volta em silêncio.

Declarada também a base de medição das razões do documento: --ms-surface do modo, não --ms-bg. Contra o bg os números deslocam de fração e nenhuma conclusão de aprovação muda.

Verificação

Toda razão WCAG do documento foi recalculada, não assumida. 21 pares conferem exatamente com o declarado, incluindo as três colisões do §9.5 (laranja M4 × legado 1.14:1, M4 × coral 1.04:1, cream × papel 1.01:1).

O verificador foi testado contra o falso-positivo: injetando o #3A3FA8 reprovado, ele acusa e sai com código 1.

Gerador de rabisco conferido contra o §5 — determinístico entre chamadas, 152 traços (faixa 120–210), 3 segmentos por traço, stroke-width 0.50–0.95, opacity 0.10–0.42. Regra de zona: 608 pontos verificados, zero dentro da zona de texto. Zona impossível encerra em 7ms sem laço infinito.

Checklist

  • CI verde (HTML check, CSS balance, secret scan, markdown, contrast) — suíte equivalente rodada local
  • CHANGELOG.md atualizado
  • Preview Vercel conferido — sem mudança visual nas superfícies existentes; a camada V5.2 ainda não tem superfície própria
  • Docs alinhados com a mudança
  • Consumo downstream testado (não breaking — aditivo, prefixo isolado)

Novo job contrast-check no validate.yml: o DESIGN_SYSTEM.md afirma que toda razão é medida e não estimada, e o job é o que mantém a afirmação verdadeira ao longo do tempo.

Pendências que seguem abertas

Herdadas da spec, não introduzidas aqui: fidelidade de pigmento dos hex (§10.1 — leitura de fotografia, não medição de parede), colisão de nome M4 mascote × Mecanismo 4 (§10.2), divergência tipográfica dos sheets do Mascot Lab (§10.3). Somada a nova §10.4, a coexistência com o V3.0.


Generated by Claude Code

Entra a spec do sistema de dois modos como camada paralela ao V3.0 da
Era Midnight, com implementação e verificação.

- DESIGN_SYSTEM.md — spec normativa V5.2, consolidando V3.1/V3.2/V4.0/V5.0/V5.1
- css/ms-v5.css — tokens dos dois modos, escala tipográfica, contorno de 3px,
  sombra tingida, termo-chave em guilhemés
- js/rabisco.js — textura primária, gerador determinístico, semente 20260805,
  zona de texto rejeitada no gerador (não coberta por tarja)
- tools/contrast.mjs — lê os hex direto do CSS e falha se algum par divergir
  do documentado ou reprovar no piso WCAG do papel; roda no CI

Camada paralela: prefixo --ms-* não colide com --ds-*/--p-*, e nenhuma
superfície pública muda de aparência. Qual dos dois sistemas governa o site
segue em aberto (DESIGN_SYSTEM.md §10.4).

Correção: a tabela do §4 citava o cobalto em #3A3FA8, valor reprovado na
calibragem V5.1 (2.19:1, abaixo do piso de 3.0), enquanto o token do §3 já
trazia o #4B53E0 corrigido. Prevalece o token. Base de medição das razões
declarada: --ms-surface do modo.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0155xnWMdTNZutjWAE7skNF1
@vercel

vercel Bot commented Aug 5, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
design-system Ready Ready Preview Aug 5, 2026 8:38am

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants