@aurea-uds/contracts 0.10.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # @aurea-uds/contracts
 
-The **Aurea UDS** project contract, as machine-readable JSON.
+O contrato do projeto **Aurea UDS**, em JSON legível por máquina.
 
 ```bash
 pnpm add @aurea-uds/contracts
@@ -10,35 +10,33 @@ pnpm add @aurea-uds/contracts
 import contract from "@aurea-uds/contracts/contract" with {type: "json"};
 ```
 
-It states what the design system promises — identity, the vocabulary of the catalogue, the
-enumerations that component records are validated against — in a form a tool can read instead
-of a paragraph a person has to interpret.
+Ele diz o que o design system promete — identidade, o vocabulário do catálogo, as listas de
+valores contra as quais as fichas dos componentes são conferidas — numa forma que uma ferramenta
+lê, em vez de um parágrafo que uma pessoa tem de interpretar.
 
-## The API surface
+## A superfície da API
 
 ```js
 import surface from "@aurea-uds/contracts/api-surface" with {type: "json"};
 ```
 
-Every component `@aurea-uds/react` exports, with its props, and — where the type is a union of
-string literals — the values those props accept. It is **derived**, not written: the build reads
-the declaration output of the TypeScript compiler, so inheritance, `Omit`, `Pick` and chained
-aliases are resolved by the compiler rather than by a guess. Editing it by hand is the defect it
-exists to prevent.
+Todo componente que o `@aurea-uds/react` exporta, com as props e — quando o tipo é uma união de
+textos fixos — os valores que cada prop aceita. Ela é **derivada**, não escrita: o build lê as
+declarações que o compilador do TypeScript gera, então herança, `Omit`, `Pick` e apelidos em
+cadeia são resolvidos pelo compilador, e não por palpite. Editá-la à mão é justamente o defeito
+que ela existe para evitar.
 
-It is what lets a tool answer "which variants does this component take?" without parsing our
-source or trusting our prose — and it is what the validator checks the per-component records
-against, so the two cannot drift.
+É ela que deixa uma ferramenta responder "que variantes este componente aceita?" sem ler o nosso
+código nem confiar na nossa prosa — e é contra ela que o validador confere as fichas de cada
+componente, para as duas não divergirem.
 
-## What is not in here
+## O que não está aqui
 
-The per-component records live in the repository, not in this package. They are how the
-catalogue is generated and how the validator checks the library against itself; nothing
-outside the build consumes them, and a package should not ship files that exist only to
-answer a question nobody is asking. If you need them, say so in an issue and they get an
-entry point. The API surface above is the part of that answer a tool actually needs, and it
-ships for exactly that reason.
+As fichas de cada componente moram no repositório, não neste pacote. Elas geram o catálogo e
+deixam o validador conferir a biblioteca contra ela mesma; nada fora do build as usa. Se você
+precisar delas, abra uma issue pedindo, e elas ganham uma entrada. A superfície da API acima é a
+parte dessa resposta de que uma ferramenta precisa, e é por isso que ela vai no pacote.
 
-## Licence
+## Licença
 
 Apache-2.0.

package/aurea.contract.json

@@ -1,6 +1,6 @@
 {
   "name": "Aurea — Universal Design System",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "status": "organized-source-of-truth",
   "language": "pt-BR",
   "fonts": {
@@ -200,7 +200,7 @@
       "@aurea-uds/react",
       "@aurea-uds/native"
     ],
-    "rule": "Artefatos derivam de legacy-reference.html e dos pacotes do monorepo; não editar manualmente fora deles.",
+    "rule": "Artefatos derivam dos pacotes do monorepo; não editar manualmente fora deles.",
     "mode": "workspace-packages",
     "commands": {
       "verify": "pnpm validate"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aurea-uds/contracts",
-  "version": "0.10.0",
-  "description": "The Aurea UDS project contract as machine-readable JSON.",
+  "version": "0.11.0",
+  "description": "O contrato do projeto Aurea UDS, em JSON legível por máquina.",
   "keywords": [
     "aurea",
     "design-system",
@@ -13,6 +13,10 @@
     "url": "git+https://github.com/victor1mor/aurea-uds.git",
     "directory": "packages/contracts"
   },
+  "homepage": "https://github.com/victor1mor/aurea-uds/tree/main/packages/contracts#readme",
+  "bugs": {
+    "url": "https://github.com/victor1mor/aurea-uds/issues"
+  },
   "publishConfig": {
     "access": "public"
   },