@softize/opus 12.0.1 → 12.2.0

package/CHANGELOG.md

@@ -7,6 +7,29 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 12.2.0 — 2026-08-23
+
+A escala de arredondamento ganha uma base mais presente sem transformar todo componente em uma
+superfície principal. `--radius` passa de `0.625rem` para `0.75rem`; os degraus de
+`rounded-xs` a `rounded-2xl` derivam dessa base e permanecem crescentes. Cards e modais continuam
+em `rounded-xl`, enquanto controles compactos e molduras estruturais preservam seus degraus.
+
+A mudança é visual e não exige migração de código. Aplicações que já sobrescrevem `--radius`
+mantêm sua própria identidade; as demais recebem automaticamente a nova escala. A documentação e
+a skill de UI explicam aninhamento, grupos conectados e a separação entre tamanho e forma.
+
+## 12.1.0 — 2026-08-22
+
+Interfaces que combinam copy fixa com nomes, contagens ou opções vindas da aplicação não
+precisam mais excluir o arquivo inteiro do inventário. `base.json.copy.dynamic` classifica um
+diagnóstico exato como `runtime-data` ou `message-template`, com motivo e referência
+auditáveis. Dados de runtime ficam fora da política editorial; o texto-modelo de mensagens
+interpoladas entra no inventário com seu papel semântico, sem alterar o conteúdo renderizado.
+
+Cada declaração precisa corresponder a um único caminho, linha e campo. Quando o código muda
+e o seletor fica órfão ou ambíguo, `opus copy` reprova e orienta a revisão. O inventário expõe
+essas classificações em `dynamicSurfaces`, e o resumo do CLI informa sua quantidade.
+
 ## 12.0.1 — 2026-08-22
 
 `Split` volta a atender layouts que precisam preservar uma medida física e a preferência da

package/bin/cli.mjs

@@ -254,7 +254,8 @@ async function cmdCopy(dir, flags) {
   const coverage = result.inventory.coverage
   const summary =
     `${coverage.analyzedFiles} arquivo(s) analisado(s), ` +
-    `${coverage.coveredSources} fonte(s) com copy, ${coverage.extractedEntries} texto(s)`
+    `${coverage.coveredSources} fonte(s) com copy, ${coverage.extractedEntries} texto(s), ` +
+    `${result.inventory.dynamicSurfaces.length} superfície(s) dinâmica(s) declarada(s)`
   if (flags.check) log('success', `✓ opus copy: ${location} está atualizado (${summary}).`)
   else if (result.changed) log('success', `✓ opus copy: ${location} gerado atomicamente (${summary}).`)
   else log('success', `✓ opus copy: ${location} já estava atualizado (${summary}).`)

package/bin/lib/copy.mjs

@@ -52,6 +52,13 @@ const IGNORED_FILE = /(?:\.d|\.spec|\.test|\.stories)\.[cm]?[jt]sx?$/u
 // O Opus garante somente o namespace e o shape do identificador. O catálogo de regras,
 // inclusive adições futuras, pertence à versão instalada da Base.
 const COPY_RULE_ID = /^COPY\d{3}$/u
+const COPY_DYNAMIC_KINDS = new Set(['message-template', 'runtime-data'])
+const COPY_ROLES = new Set([
+  'badge', 'breadcrumb', 'button', 'description', 'dialog-body', 'empty-state', 'error',
+  'heading', 'helper-text', 'kicker', 'label', 'menu-item', 'message', 'notification',
+  'placeholder', 'success', 'tab', 'title', 'warning',
+])
+const AUDIT_REFERENCE = /^(?:https?:\/\/\S+|[a-z][a-z0-9-]*:\S+|(?:[A-Za-z0-9._-]+\/)+[A-Za-z0-9._#/-]+|[A-Za-z0-9._-]+\.(?:md|json|ya?ml)(?:#[^\s]+)?)$/u
 const CONTRACT_MODULES = new Set(['@softize/opus', '@softize/opus/core'])
 const CONTRACT_FACTORIES = new Set(['defineAction', 'defineContract'])
 const ACTION_BINDING_KEYS = new Set(['authorize', 'background', 'emits', 'handler', 'idempotency', 'loads'])
@@ -839,10 +846,12 @@ function lineOf(sourceFile, node) {
   return sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1
 }
 
-function diagnostic(file, sourceFile, node, field) {
+function diagnostic(file, sourceFile, node, field, category = 'content') {
   return {
     source: file,
     line: lineOf(sourceFile, node),
+    field,
+    category,
     message:
       `não foi possível extrair \`${field}\` estaticamente; use texto literal, concatenação ` +
       'de literais, constante local ou I18nRef com `default` literal.',
@@ -929,13 +938,13 @@ export function extractCopyFromSource(file, sourceText) {
   const optionItems = (object, prefix) => {
     const kind = property(object, 'kind', sourceFile, checker)
     if (kind.opaque !== undefined) {
-      diagnostics.push(diagnostic(file, sourceFile, kind.opaque, `${prefix}kind`))
+      diagnostics.push(diagnostic(file, sourceFile, kind.opaque, `${prefix}kind`, 'structure'))
       return
     }
     if (kind.candidate === undefined) return
     const kindText = staticText(propertyValue(kind.candidate), checker)?.text
     if (kindText === undefined) {
-      diagnostics.push(diagnostic(file, sourceFile, propertyValue(kind.candidate), `${prefix}kind`))
+      diagnostics.push(diagnostic(file, sourceFile, propertyValue(kind.candidate), `${prefix}kind`, 'structure'))
       return
     }
     if (kindText !== 'static') return
@@ -1075,7 +1084,7 @@ export function extractCopyFromSource(file, sourceText) {
     const key = `${node.pos}:${node.end}:${field}`
     if (transformDiagnostics.has(key)) return
     transformDiagnostics.add(key)
-    diagnostics.push(diagnostic(file, sourceFile, node, field))
+    diagnostics.push(diagnostic(file, sourceFile, node, field, 'transform'))
   }
 
   function tailwindTransform(token) {
@@ -1502,13 +1511,13 @@ export function extractCopyFromSource(file, sourceText) {
     if (component !== 'Select') return null
     const native = attribute(opening.attributes, 'native')
     if (native.opaque !== undefined) {
-      diagnostics.push(diagnostic(file, sourceFile, native.opaque, '<Select>.native'))
+      diagnostics.push(diagnostic(file, sourceFile, native.opaque, '<Select>.native', 'structure'))
       return 'opaque'
     }
     if (native.candidate === undefined) return 'custom'
     const value = attributeBoolean(native)
     if (value === null) {
-      diagnostics.push(diagnostic(file, sourceFile, attributeValue(native) ?? opening, '<Select>.native'))
+      diagnostics.push(diagnostic(file, sourceFile, attributeValue(native) ?? opening, '<Select>.native', 'structure'))
       return 'opaque'
     }
     return value ? 'native' : 'custom'
@@ -1547,7 +1556,15 @@ export function extractCopyFromSource(file, sourceText) {
       if (slot.opaque !== undefined) diagnostics.push(diagnostic(file, sourceFile, slot.opaque, `<${component}>.${name}`))
       else if (slot.candidate !== undefined) {
         const raw = attributeValue(slot)
-        if (raw === null || !noRenderedValue(raw)) diagnostics.push(diagnostic(file, sourceFile, raw ?? opening, `<${component}>.${name}`))
+        if (raw === null || !noRenderedValue(raw)) {
+          diagnostics.push(diagnostic(
+            file,
+            sourceFile,
+            raw ?? opening,
+            `<${component}>.${name}`,
+            raw === null ? 'missing-content' : 'content',
+          ))
+        }
       }
     }
 
@@ -1594,8 +1611,16 @@ export function extractCopyFromSource(file, sourceText) {
             }
           }
         } else {
-          const value = attributeText(item)
-          if (value === null) diagnostics.push(diagnostic(file, sourceFile, raw ?? opening, `<${component}>.${name}`))
+          const value = raw === null ? null : attributeText(item)
+          if (value === null) {
+            diagnostics.push(diagnostic(
+              file,
+              sourceFile,
+              raw ?? opening,
+              `<${component}>.${name}`,
+              raw === null ? 'missing-content' : 'content',
+            ))
+          }
           else {
             const entry = { source: file, line: lineOf(sourceFile, value.node), role, text: value.text }
             if (transformed.uppercase) entry.transform = 'uppercase'
@@ -1613,7 +1638,7 @@ export function extractCopyFromSource(file, sourceText) {
           inheritedFor('className', 'style'),
         )
         if (transformed.uppercase) {
-          diagnostics.push(diagnostic(file, sourceFile, opening, '<ActionTrigger>.label herdado do contrato sob uppercase'))
+          diagnostics.push(diagnostic(file, sourceFile, opening, '<ActionTrigger>.label herdado do contrato sob uppercase', 'transform'))
         }
       }
     }
@@ -1625,7 +1650,15 @@ export function extractCopyFromSource(file, sourceText) {
         const raw = attributeValue(item)
         const object = raw === null ? null : resolveBinding(raw, checker)
         if (object?.kind === ts.SyntaxKind.NullKeyword || (ts.isIdentifier(object) && object.text === 'undefined')) continue
-        if (!ts.isObjectLiteralExpression(object)) diagnostics.push(diagnostic(file, sourceFile, raw ?? opening, `<${component}>.${name}`))
+        if (!ts.isObjectLiteralExpression(object)) {
+          diagnostics.push(diagnostic(
+            file,
+            sourceFile,
+            raw ?? opening,
+            `<${component}>.${name}`,
+            raw === null ? 'structure' : 'content',
+          ))
+        }
         else for (const [nestedName, role] of nestedRoles) addProperty(object, nestedName, role, `<${component}>.${name}.`)
       }
     }
@@ -1636,7 +1669,15 @@ export function extractCopyFromSource(file, sourceText) {
       else if (item.candidate !== undefined) {
         const raw = attributeValue(item)
         const listed = raw === null ? { values: [], opaque: [opening] } : objects(raw, checker)
-        for (const opaque of listed.opaque) diagnostics.push(diagnostic(file, sourceFile, opaque, `<${component}>.${name}`))
+        for (const opaque of listed.opaque) {
+          diagnostics.push(diagnostic(
+            file,
+            sourceFile,
+            opaque,
+            `<${component}>.${name}`,
+            raw === null ? 'structure' : 'content',
+          ))
+        }
         for (const [index, option] of listed.values.entries()) {
           for (const [optionName, role] of optionRoles) {
             if (mode === 'native' && !['label', 'group'].includes(optionName)) continue
@@ -1668,8 +1709,17 @@ export function extractCopyFromSource(file, sourceText) {
     if (ariaLabelAttribute.opaque !== undefined) {
       diagnostics.push(diagnostic(file, sourceFile, ariaLabelAttribute.opaque, `<${component}>.aria-label`))
     } else if (ariaLabelAttribute.candidate !== undefined) {
-      const ariaLabel = attributeText(ariaLabelAttribute)
-      if (ariaLabel === null) diagnostics.push(diagnostic(file, sourceFile, attributeValue(ariaLabelAttribute) ?? opening, `<${component}>.aria-label`))
+      const raw = attributeValue(ariaLabelAttribute)
+      const ariaLabel = raw === null ? null : attributeText(ariaLabelAttribute)
+      if (ariaLabel === null) {
+        diagnostics.push(diagnostic(
+          file,
+          sourceFile,
+          raw ?? opening,
+          `<${component}>.aria-label`,
+          raw === null ? 'missing-content' : 'content',
+        ))
+      }
       if (ariaLabel !== null) {
         hasStaticAriaLabel = true
         entries.push({ source: file, line: lineOf(sourceFile, ariaLabel.node), role: 'label', text: ariaLabel.text })
@@ -1692,7 +1742,7 @@ export function extractCopyFromSource(file, sourceText) {
         if (children.opaque !== undefined) return { kind: 'opaque', node: children.opaque }
         if (children.candidate === undefined) return { kind: 'decorative' }
         const raw = attributeValue(children)
-        return raw === null ? { kind: 'opaque', node: opening } : childExpression(raw, inheritedUppercase)
+        return raw === null ? { kind: 'decorative' } : childExpression(raw, inheritedUppercase)
       }
       const inheritedUppercase = component === 'ActionFormDialog'
         ? false
@@ -1710,7 +1760,9 @@ export function extractCopyFromSource(file, sourceText) {
       }
       if (value.kind === 'opaque') diagnostics.push(diagnostic(file, sourceFile, value.node, `<${component}> children`))
       else if (value.kind === 'decorative') {
-        if (!hasStaticAriaLabel && !OPTIONAL_CHILD_COMPONENTS.has(component)) diagnostics.push(diagnostic(file, sourceFile, element, `<${component}> children`))
+        if (!hasStaticAriaLabel && !OPTIONAL_CHILD_COMPONENTS.has(component)) {
+          diagnostics.push(diagnostic(file, sourceFile, element, `<${component}> children`, 'missing-content'))
+        }
       } else {
         const texts = value.kind === 'text' ? [value] : value.values
         for (const text of texts) {
@@ -1727,11 +1779,11 @@ export function extractCopyFromSource(file, sourceText) {
     if (ts.isCallExpression(node) && factory !== null && node.arguments.length > 0) {
       hasContract = true
       if (!stableFactoryResult(node, checker, new Set())) {
-        diagnostics.push(diagnostic(file, sourceFile, node, `${factory}(...) result`))
+        diagnostics.push(diagnostic(file, sourceFile, node, `${factory}(...) result`, 'structure'))
       } else {
         const object = resolveBinding(node.arguments[0], checker)
         if (ts.isObjectLiteralExpression(object)) extractContract(object)
-        else diagnostics.push(diagnostic(file, sourceFile, node.arguments[0], `${factory}(...)`))
+        else diagnostics.push(diagnostic(file, sourceFile, node.arguments[0], `${factory}(...)`, 'structure'))
       }
     }
     if (ts.isJsxElement(node) || ts.isJsxSelfClosingElement(node)) extractJsx(node)
@@ -1834,6 +1886,7 @@ function copyConfiguration(root) {
       inventoryPath,
       exemptions: [],
       transforms: [],
+      dynamic: [],
       exclude: [],
     }
   }
@@ -1854,6 +1907,7 @@ function copyConfiguration(root) {
     inventoryPath: target,
     exemptions: config?.exemptions ?? [],
     transforms: config?.transforms ?? [],
+    dynamic: config?.dynamic ?? [],
     exclude: config?.exclude ?? [],
   }
 }
@@ -1914,7 +1968,118 @@ function findEntry(entries, selector) {
     )
 }
 
+function canonicalSource(value) {
+  return (
+    typeof value === 'string' &&
+    value !== '' &&
+    value.trim() === value &&
+    value === value.normalize('NFC') &&
+    !value.includes('\\') &&
+    !path.posix.isAbsolute(value) &&
+    !path.win32.isAbsolute(value) &&
+    !/^[A-Za-z]:/u.test(value) &&
+    value !== '.' &&
+    value !== '..' &&
+    path.posix.normalize(value) === value &&
+    value.split('/').every((part) => part !== '' && part !== '.' && part !== '..')
+  )
+}
+
+function applyDynamicMetadata(config, entries, diagnostics) {
+  const surfaces = []
+  if (!Array.isArray(config.dynamic)) {
+    diagnostics.push(selectorDiagnostic('copy.dynamic deve ser uma lista.'))
+    return surfaces
+  }
+  const consumed = new Set()
+  for (const [index, declaration] of config.dynamic.entries()) {
+    const template = declaration?.kind === 'message-template'
+    const allowedFields = new Set([
+      'source', 'line', 'field', 'kind', 'reason', 'reference',
+      ...(template ? ['role', 'text'] : []),
+    ])
+    const normalizedReason = typeof declaration?.reason === 'string' ? declaration.reason.trim() : ''
+    const normalizedReference = typeof declaration?.reference === 'string' ? declaration.reference.trim() : ''
+    if (
+      declaration === null ||
+      typeof declaration !== 'object' ||
+      Array.isArray(declaration) ||
+      Object.keys(declaration).some((field) => !allowedFields.has(field)) ||
+      !canonicalSource(declaration.source) ||
+      !Number.isInteger(declaration.line) ||
+      declaration.line < 1 ||
+      typeof declaration.field !== 'string' ||
+      declaration.field.trim() === '' ||
+      !COPY_DYNAMIC_KINDS.has(declaration.kind) ||
+      typeof declaration.reason !== 'string' ||
+      normalizedReason.length < 12 ||
+      normalizedReason.length > 500 ||
+      /[\r\n]/u.test(declaration.reason) ||
+      typeof declaration.reference !== 'string' ||
+      normalizedReference.length < 8 ||
+      normalizedReference.length > 500 ||
+      !AUDIT_REFERENCE.test(normalizedReference) ||
+      (template && (
+        typeof declaration.text !== 'string' ||
+        declaration.text.trim() === '' ||
+        declaration.text !== declaration.text.trim() ||
+        /[\r\n]/u.test(declaration.text) ||
+        !COPY_ROLES.has(declaration.role)
+      )) ||
+      (!template && (declaration.text !== undefined || declaration.role !== undefined))
+    ) {
+      diagnostics.push(selectorDiagnostic(
+        `copy.dynamic[${index}] exige seletor, kind, reason e reference válidos` +
+        (template ? ', além de text e role para message-template.' : '.'),
+      ))
+      continue
+    }
+    const matches = diagnostics
+      .map((item, diagnosticIndex) => ({ item, diagnosticIndex }))
+      .filter(({ item, diagnosticIndex }) =>
+        !consumed.has(diagnosticIndex) &&
+        item.category === 'content' &&
+        item.source === declaration.source &&
+        item.line === declaration.line &&
+        item.field === declaration.field,
+      )
+    if (matches.length !== 1) {
+      diagnostics.push(selectorDiagnostic(
+        `copy.dynamic[${index}] deve selecionar exatamente um diagnóstico de extração; encontrou ${matches.length}.`,
+      ))
+      continue
+    }
+    consumed.add(matches[0].diagnosticIndex)
+    const surface = {
+      source: declaration.source,
+      line: declaration.line,
+      field: declaration.field,
+      kind: declaration.kind,
+      reason: normalizedReason,
+      reference: normalizedReference,
+    }
+    if (template) {
+      surface.role = declaration.role
+      surface.text = declaration.text
+      entries.push({
+        source: declaration.source,
+        line: declaration.line,
+        role: declaration.role,
+        text: declaration.text,
+        dynamic: { kind: declaration.kind, field: declaration.field, reference: normalizedReference },
+      })
+    }
+    surfaces.push(surface)
+  }
+  if (consumed.size > 0) {
+    const remaining = diagnostics.filter((_, index) => !consumed.has(index))
+    diagnostics.splice(0, diagnostics.length, ...remaining)
+  }
+  return surfaces
+}
+
 function applyProjectMetadata(config, entries, diagnostics) {
+  const dynamicSurfaces = applyDynamicMetadata(config, entries, diagnostics)
   if (!Array.isArray(config.exemptions)) {
     diagnostics.push(selectorDiagnostic('copy.exemptions deve ser uma lista.'))
   } else {
@@ -1993,6 +2158,7 @@ function applyProjectMetadata(config, entries, diagnostics) {
       entries[entryIndex].transform = transform.transform
     }
   }
+  return dynamicSurfaces
 }
 
 export function extractCopyInventory(root) {
@@ -2050,7 +2216,7 @@ export function extractCopyInventory(root) {
       'nenhum arquivo JavaScript/TypeScript elegível foi analisado; o inventário v2 exige ao menos uma fonte rastreável.',
     ))
   }
-  applyProjectMetadata(config, entries, diagnostics)
+  const dynamicSurfaces = applyProjectMetadata(config, entries, diagnostics)
 
   const coveredSources = new Set(entries.map((entry) => entry.source)).size
 
@@ -2066,6 +2232,7 @@ export function extractCopyInventory(root) {
       },
       sources,
       entries,
+      dynamicSurfaces,
     },
     diagnostics,
   }

package/docs/code-style.md

@@ -131,6 +131,23 @@ autoral da interface. Arrays, objetos ou discriminadores dinâmicos falham visiv
 inequívoca; entidades JSX são decodificadas antes do inventário. Fragmentos cuja concatenação
 exigiria adivinhar espaços continuam reprovando.
 
+Quando o diagnóstico corresponde a dados reais da aplicação ou a uma mensagem interpolada,
+`copy.dynamic` permite classificar somente aquela superfície sem excluir o arquivo. Cada item
+seleciona exatamente um diagnóstico por `source`, `line` e `field`, registra `reason` e
+`reference` auditáveis e usa um destes contratos:
+
+- `runtime-data` reconhece nomes, contagens, status ou opções fornecidos em runtime. Nenhuma
+  entrada editorial é fabricada;
+- `message-template` exige `role` e `text`. O texto-modelo entra no inventário e passa pela
+  política da Base, mas não substitui nem altera o conteúdo renderizado.
+
+As declarações aparecem em `dynamicSurfaces` no inventário. Se o source mudar e o seletor não
+encontrar exatamente um diagnóstico, `opus copy` falha. Assim, a classificação permanece
+estreita e revisável, sem transformar metadata em uma exclusão silenciosa. O mecanismo aceita
+somente diagnósticos de conteúdo; incerteza estrutural, `className`, `style`, transformação ou
+modo de renderização continua bloqueante. Superfície vazia também não pode ser reclassificada
+como dado de runtime.
+
 Um `opus copy --check` verde **não significa que toda a copy do produto foi coberta**. Ficam
 fora, deliberadamente:
 
@@ -138,7 +155,7 @@ fora, deliberadamente:
   seu papel semântico;
 - texto vindo de API, banco, catálogo i18n importado ou variável de runtime em superfícies
   que o Opus não classifica. Quando esse conteúdo ocupa uma prop ou filho mapeado, a extração
-  falha e pede um fallback estático;
+  falha e pede copy estática ou uma declaração estreita em `copy.dynamic`;
 - props ou componentes de terceiros sem contrato Opus;
 - copy escondida em CSS ou pseudo-elemento. Para uma transformação conhecida que o AST não
   enxerga globalmente, use `copy.transforms`; em componente Opus mapeado, `className` opaco

package/docs/radius-scale.md

@@ -0,0 +1,66 @@
+# Escala de arredondamento
+
+> **Status: decidido (ago/2026).** A forma usa uma escala contínua do Tailwind; o nome do
+> componente não cria um segundo conjunto de tokens.
+
+## Contexto
+
+Cards e modais precisam ter presença suficiente para organizar a página sem parecerem caixas
+rígidas. Controles, itens internos e superfícies compactas precisam continuar menores para que a
+interface preserve hierarquia. A base anterior de `0.625rem` deixava o primeiro grupo adequado,
+mas mantinha os demais degraus visualmente mais retos do que a identidade desejada.
+
+Alterar cada componente isoladamente resolveria exemplos visíveis, mas deixaria consumidores e
+novos componentes sem uma referência comum. Reintroduzir tokens como `--radius-card` também
+voltaria a acoplar forma e tipo de componente, problema removido na versão 10.0.0.
+
+## Decisão
+
+- `--radius` passa a `0.75rem`. Aplicações podem sobrescrever essa base para ajustar a identidade
+  inteira sem forkar componentes.
+- `rounded-xs` até `rounded-2xl` formam uma progressão derivada da mesma base. `rounded-full`
+  continua reservado a círculos e variantes explicitamente pill.
+- Componentes escolhem o degrau pela escala visual. Em geral, detalhes e itens internos usam
+  `xs` ou `sm`; controles e superfícies compactas usam `md`; molduras estruturais usam `lg`; e
+  superfícies principais ou modais usam `xl`. Essa associação orienta o default, mas não cria um
+  token semântico por componente.
+- Superfícies aninhadas evitam moldura dupla e normalmente usam um degrau menor que o contêiner.
+  Elementos conectados removem os raios nas arestas internas.
+- Card, Dialog e AlertDialog permanecem em `xl`. Molduras estruturais com cantos, como a tabela
+  standalone, permanecem em `lg`; Page, Split e Sidebar não ganham uma moldura por essa regra.
+- Calendar e Command preservam a geometria embutível. Um consumidor standalone pode ajustar o
+  contêiner por `className` quando a composição pedir mais presença.
+- Tamanho e forma continuam eixos separados nos controles. Variantes `sm`, `default` e `lg` não
+  mudam o radius automaticamente; `shape="pill"` continua sendo a escolha explícita para pílulas.
+
+## Consequências
+
+- A mudança da base afeta todos os consumidores que não sobrescrevem `--radius`. O efeito é
+  visual e intencional; nenhuma migração de código é necessária.
+- A progressão derivada evita que `rounded-xl` ultrapasse `rounded-2xl` e faz a customização por
+  `--radius` alcançar também os extremos usados pelo Opus. `rounded-3xl` continua nativo do
+  Tailwind; aplicações que usam esse degrau precisam revisar a fronteira ao alterar a base.
+- Novos componentes podem escolher uma utility da escala sem inventar vocabulário próprio.
+- Drawer e outras superfícies presas à viewport não mudam neste entregável. Arredondar somente os
+  cantos expostos exige validar clipping, scroll e conteúdo full-bleed em uma mudança própria.
+
+## Alternativas descartadas
+
+- **Aplicar `rounded-xl` a toda superfície:** aproxima os componentes do Card, mas elimina a
+  diferença entre controles compactos, molduras estruturais e superfícies principais.
+- **Editar cada componente sem mudar a base:** oferece controle pontual, mas espalha a decisão e
+  não beneficia consumidores que usam diretamente a escala do Tailwind.
+- **Restaurar tokens por papel:** fixa defaults, mas volta a criar uma taxonomia paralela para a
+  mesma propriedade.
+- **Escalar radius junto com o tamanho de cada controle:** parece proporcional isoladamente, mas
+  quebra grupos conectados e mistura o eixo de forma com o eixo de densidade.
+
+## Verificação
+
+- Um teste de contrato lê o tema canônico e confirma a base, as fórmulas e a ordem crescente de
+  `rounded-xs` até `rounded-2xl`.
+- A documentação de tokens demonstra a escala completa e explica como uma aplicação altera a
+  identidade pelo token base.
+- A skill `build-opus-ui` orienta o uso da escala, o aninhamento e as junções sem prescrever tokens
+  por componente.
+- Os testes e o build da UI confirmam que as utilities continuam materializadas pelo Tailwind.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "12.0.1",
+  "version": "12.2.0",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/registry/skills/build-opus-ui/SKILL.md

@@ -24,15 +24,23 @@ existentes, mantendo navegação observável e componentes reutilizáveis sem la
    `bg-card text-card-foreground` e `bg-popover text-popover-foreground`. Não depender da
    igualdade atual com `--foreground`, porque o app pode sobrescrever cada par.
 7. Usar diretamente a escala `rounded-*`; não criar radius por nome de componente quando
-   `rounded-sm` a `rounded-xl` já expressam a forma.
+   `rounded-xs` a `rounded-2xl` já expressam a forma. Escolher o degrau pela escala visual:
+   detalhes e itens internos tendem a `xs`/`sm`, controles e flutuantes compactos a `md`,
+   molduras estruturais a `lg`, e superfícies principais ou modais a `xl`. Essa associação
+   orienta o default, não cria uma restrição semântica. Em aninhamento, evitar moldura dupla e
+   reduzir o raio interno; em grupos conectados, remover os raios das arestas internas. Tamanho
+   e forma permanecem eixos separados; usar `shape="pill"` quando a pílula for intencional.
 8. Testar estados de loading, vazio, erro, sucesso, permissão e interação relevante.
 
 ## Verificação
 
 Rodar `opus check`, testes focados, typecheck e build da superfície. Se a interface alterou
 copy em contrato ou componente Opus mapeado, regenerar com `opus copy` e executar
-`base copy check`. Copy dinâmica numa superfície mapeada precisa de fallback estático ou de
-uma decisão explícita de arquitetura; não contorne o diagnóstico com `aria-label` paralelo.
+`base copy check`. Quando uma superfície mapeada recebe dados da aplicação, usar
+`copy.dynamic` com seletor exato, motivo e referência: `runtime-data` para valores sem autoria
+editorial; `message-template` com `role` e texto-modelo para mensagens interpoladas. Não excluir
+o arquivo inteiro nem contornar o diagnóstico com `aria-label` paralelo. Revisar cada declaração
+dinâmica como fronteira de cobertura, mesmo com os gates verdes.
 Inspecionar visualmente a rota real e validar navegação por URL quando aplicável.
 
 ## Limites

package/registry/skills/build-opus-ui/references/evaluations.md

@@ -3,5 +3,9 @@
 - Dispara: “Monte a tela de edição usando a form action do Opus.”
 - Não dispara: “Ajuste o CSS de um e-mail estático.”
 - Execução: implementar uma lista com modal roteável e provar loading, erro, vazio e back.
+- Execução de forma: compor uma tabela dentro de Card sem moldura duplicada, manter a moldura
+  estrutural standalone em `rounded-lg` e os controles internos em `rounded-md`.
 - Reprova: criar uma casca `bg-card` que herda o texto global ou introduzir `rounded-widget`
   quando a escala `rounded-*` atende ao papel.
+- Reprova: trocar automaticamente o radius de um controle quando apenas seu tamanho muda ou
+  manter cantos arredondados nas arestas internas de um grupo conectado.

package/registry/skills/build-opus-ui/references/ui-patterns.md

@@ -8,4 +8,10 @@
 - Superfície semântica e foreground são um par local (`bg-card text-card-foreground`,
   `bg-popover text-popover-foreground`); herança do foreground global não substitui o par.
 - Forma usa a escala `rounded-*`; nome de componente não cria uma segunda escala de radius.
+  Detalhes e itens internos tendem a `xs`/`sm`, controles e flutuantes compactos a `md`,
+  molduras estruturais a `lg`, e superfícies principais ou modais a `xl`. Essa associação é
+  um default visual, não uma restrição semântica.
+- Superfície aninhada evita moldura dupla e normalmente usa um degrau abaixo do contêiner.
+  Grupos conectados removem os raios internos. O tamanho do controle não muda sua forma;
+  `shape="pill"` declara a pílula quando ela for intencional.
 - Catálogo e API efetivos vêm dos exports da versão instalada, não de memória ou exemplo antigo.

package/src/ui/docs/content/communication.md

@@ -60,6 +60,43 @@ visual que o protocolo não representa com segurança.
 `ActionTrigger.itemLabel` é conteúdo de domínio em runtime (o nome do registro alvo), não
 é copy editorial estável; `label` e `confirm.*` são as superfícies editoriais cobertas.
 
+Quando uma prop mapeada recebe dados da aplicação, declare a superfície em
+`base.json.copy.dynamic` em vez de excluir o arquivo inteiro. O seletor usa o caminho, a
+linha e o campo exibido pelo diagnóstico. `runtime-data` registra valores como nomes,
+contagens e opções vindas de API sem transformá-los em copy editorial. `message-template`
+acrescenta ao inventário um texto-modelo com papel semântico, para que a parte autoral de uma
+mensagem interpolada continue passando pela política da Base. As declarações não alteram o
+que o React renderiza; um seletor que deixa de corresponder a um único diagnóstico reprova o
+gate e precisa ser revisto. Diagnósticos estruturais ou de transformação visual não podem ser
+dispensados por `copy.dynamic`; ausência de conteúdo também continua bloqueante.
+
+```json
+{
+  "copy": {
+    "dynamic": [
+      {
+        "source": "src/sessions.tsx",
+        "line": 42,
+        "field": "<Select>.options",
+        "kind": "runtime-data",
+        "reason": "As opções são nomes de sessões retornados pela aplicação.",
+        "reference": "domain:sessions"
+      },
+      {
+        "source": "src/sessions.tsx",
+        "line": 58,
+        "field": "<DialogDescription> children",
+        "kind": "message-template",
+        "role": "dialog-body",
+        "text": "Excluir {nome}?",
+        "reason": "O nome identifica a sessão selecionada na confirmação.",
+        "reference": "domain:sessions"
+      }
+    ]
+  }
+}
+```
+
 O mapeamento completo, o limite de cobertura e os comandos do gate estão em
 `docs/code-style.md` do pacote.
 

package/src/ui/docs/content/customization.md

@@ -21,10 +21,13 @@ divergência declarada), pra valer pra casa toda.
 :root {
   --primary: hsl(262 83% 58%); /* A cor da marca do projeto. */
   --ring: hsl(262 83% 58%);
-  --radius: 0.5rem;            /* Cantos mais retos, se for a praia do projeto. */
+  --radius: 0.5rem;            /* Uma base menor deixa toda a escala mais contida. */
 }
 ```
 
+O Opus deriva de `rounded-xs` a `rounded-2xl` dessa base. Assim, a marca muda a presença dos
+cantos sem substituir as utilities escolhidas pelos componentes nem criar tokens por papel.
+
 ## 2 · className em tudo
 
 > Todo componente termina em `cn(base, className)` com tailwind-merge: o utilitário do consumidor

package/src/ui/docs/content/tokens.md

@@ -109,19 +109,21 @@ render(
 
 ## Radius
 
-> Escala mapeada no `@theme inline` preservando o sentido pré-v4 dos utilitários `rounded-*`
-> (neutraliza o rename do Tailwind v4). Componentes e superfícies usam diretamente essa
-> escala: a forma não cria uma segunda taxonomia por componente. A identidade por app
-> sobrescreve `--radius` e escala tudo junto.
+> A escala mapeada no `@theme inline` preserva o sentido pré-v4 dos utilitários `rounded-*`
+> e mantém uma progressão contínua de `xs` a `2xl`. Componentes e superfícies escolhem um
+> degrau pela escala visual; a forma não cria uma segunda taxonomia por componente. A
+> identidade por app sobrescreve `--radius` e move esses degraus em conjunto.
 
 ```tsx preview
 render(
   <div className="flex flex-wrap gap-4">
     {[
+      ['rounded-xs', 'radius − 6px'],
       ['rounded-sm', 'radius − 4px'],
       ['rounded-md', 'radius − 2px'],
-      ['rounded-lg', 'radius (0.625rem)'],
+      ['rounded-lg', 'radius (0.75rem)'],
       ['rounded-xl', 'radius + 4px'],
+      ['rounded-2xl', 'radius + 8px'],
     ].map(([cls, calc]) => (
       <div key={cls} className="flex items-center gap-3">
         <div className={'h-12 w-12 border-2 border-foreground/30 bg-muted ' + cls} />
@@ -144,7 +146,9 @@ render(
    valores acompanham o upstream, só o formato difere.
 2. Elevação no dark: `--card`/`--popover` ficam ACIMA de `--background` (10% vs 3.9%) — identidade
    da casa; dialog e card "sobem" da página de verdade.
-3. Radius mapeado (sm/md/lg/xl) preservando o sentido pré-v4 dos utilitários `rounded-*`.
+3. Radius mapeado (`xs` a `2xl`) preservando o sentido pré-v4 dos utilitários `rounded-*`. Esse
+   trecho derivado permanece monotônico quando a base muda; aplicações que também usam `3xl`
+   precisam revisar a transição para esse degrau nativo ao customizar `--radius`.
 
 4. Escala `shadow-*` recomposta em duas camadas claras e difusas — preserva os degraus do
    Tailwind e troca somente o peso visual. Os aliases antigos por papel foram removidos;
@@ -153,6 +157,11 @@ render(
 5. Bordas mais leves no light: `--border`/`--input` em 92.5% (upstream 89.8%) — par do canvas
    quase-branco do body; superfícies elevadas usam essa mesma borda real.
 
+6. Radius base em `0.75rem` — superfícies principais ganham cantos mais presentes sem aproximar
+   controles compactos de modais. A decisão detalhada acompanha o pacote em
+   `docs/radius-scale.md`, com os defaults, o comportamento de superfícies aninhadas e as
+   alternativas descartadas.
+
 ## Identidade por app
 
 > O tema do Opus é a base; cada app sobrescreve as vars pra ter a própria identidade sem forkar componente.

package/src/ui/theme.css

@@ -10,13 +10,15 @@
  *    nossas; os VALORES acompanham o upstream, só o formato difere.
  * 2. Elevação dark: --card/--popover ACIMA de --background (10% vs 3.9%) — identidade
  *    da casa (upstream v4 também elevou; calibramos pelo site deles em 2026-06).
- * 3. Radius mapeado (sm/md/lg/xl em @theme inline) preservando o sentido pré-v4 dos
- *    utilitários `rounded-*` — neutraliza o rename do v4.
+ * 3. Radius mapeado (xs a 2xl em @theme inline) preservando o sentido pré-v4 dos
+ *    utilitários `rounded-*` — neutraliza o rename do v4 e mantém a escala monotônica.
  * 4. Escala shadow-* recomposta diretamente em duas camadas claras, difusas e com spread
  *    negativo — preserva inclusive modifiers como `shadow-lg/30` (ver docs/elevation-scale.md).
  * 5. Bordas mais leves no light: --border/--input em 92.5% (upstream 89.8%) — par do
  *    canvas quase-branco; superfícies elevadas usam a mesma borda real dos demais papéis.
- * Tudo o mais (escala neutra, radius base 0.625rem, semânticas) segue o upstream.
+ * 6. Radius base em 0.75rem — identidade mais arredondada; os componentes continuam usando
+ *    diretamente a escala Tailwind, sem tokens por papel (ver docs/radius-scale.md).
+ * Tudo o mais (escala neutra, semânticas) segue o upstream.
  */
 @import 'tailwindcss';
 @import 'tw-animate-css';
@@ -50,7 +52,7 @@
   /* Ring de foco LEVE (pedido da casa): aro sutil, não um halo. Com ring-[3px] + /50,
      ~86% encosta na borda (89.8%) — um sussurro de foco. */
   --ring: hsl(0 0% 86%);
-  --radius: 0.625rem;
+  --radius: 0.75rem;
 }
 
 .dark {
@@ -132,10 +134,12 @@
   --color-input: var(--input);
   --color-ring: var(--ring);
 
+  --radius-xs: calc(var(--radius) - 6px);
   --radius-sm: calc(var(--radius) - 4px);
   --radius-md: calc(var(--radius) - 2px);
   --radius-lg: var(--radius);
   --radius-xl: calc(var(--radius) + 4px);
+  --radius-2xl: calc(var(--radius) + 8px);
 
   /* Escala Tailwind, com receita direta para o compilador preservar modifiers `/opacity`.
      `light-dark()` mantém o peso adequado em cada tema sem uma variável intermediária. */