@brucesantos/design-space 0.1.1 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +143 -7
- package/README.md +129 -19
- package/dist/contrast-87-ijttm.js +268 -0
- package/dist/contrast-87-ijttm.js.map +1 -0
- package/dist/controls/params.d.ts +2 -0
- package/dist/controls/state.d.ts +2 -0
- package/dist/deploy/index.d.ts +16 -11
- package/dist/design-space.css +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.js +1313 -862
- package/dist/index.js.map +1 -1
- package/dist/registry/index.d.ts +3 -2
- package/dist/registry/validate.d.ts +1 -1
- package/dist/router/index.d.ts +2 -2
- package/dist/shell/Controls.d.ts +2 -1
- package/dist/shell/Inspector.d.ts +3 -2
- package/dist/shell/Sidebar.d.ts +8 -2
- package/dist/shell/Topbar.d.ts +6 -5
- package/dist/shell/labels.d.ts +154 -0
- package/dist/testing/index.d.ts +4 -4
- package/dist/testing.js +2 -2
- package/dist/testing.js.map +1 -1
- package/dist/types/index.d.ts +62 -22
- package/dist/util/date.d.ts +3 -4
- package/package.json +1 -1
- package/dist/contrast-DsgJg12D.js +0 -265
- package/dist/contrast-DsgJg12D.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,142 @@ Versionamento semântico. **Patch** para correção sem mudança de contrato,
|
|
|
6
6
|
Mudança estrutural — pasta obrigatória nova, schema de cenário alterado — exige
|
|
7
7
|
comando explícito e revisável, nunca merge silencioso.
|
|
8
8
|
|
|
9
|
+
## 0.3.0 (não publicado)
|
|
10
|
+
|
|
11
|
+
### Adicionado
|
|
12
|
+
|
|
13
|
+
- **Estado de ciclo de vida `ported` (`Portado — não validado`).** Identifica um
|
|
14
|
+
cenário trazido do sistema existente que ainda não foi validado e não representa
|
|
15
|
+
proposta, aprovação ou compromisso de implementação. É uma adição compatível:
|
|
16
|
+
os seis estados anteriores preservam valor, rótulo e comportamento.
|
|
17
|
+
- `ported` passa a fazer parte de `ScenarioStatus` e `SCENARIO_STATUSES`, da
|
|
18
|
+
validação em runtime, de `Registry.byStatus()` e da cobertura por status. O mapa,
|
|
19
|
+
a navegação e o diagnóstico mostram o estado com rótulo, significado, chip
|
|
20
|
+
neutro e indicador visual próprio.
|
|
21
|
+
- `scenariosUnderTest()` não inclui cenários portados no recorte padrão. Um produto
|
|
22
|
+
ainda pode testá-los explicitamente com `scenariosUnderTest(product, ["ported"])`,
|
|
23
|
+
sem transformar a importação em compromisso de manutenção de jornada E2E.
|
|
24
|
+
- **Catálogo opcional de componentes.** `ProductDefinition.components` recebe
|
|
25
|
+
referências visuais implementadas pelo produto (`id`, nome, grupo, descrição e
|
|
26
|
+
componente React). O motor organiza a aba, busca, deep link `?component=…` e
|
|
27
|
+
painel de contexto sem incorporar UI, tokens ou domínio do produto.
|
|
28
|
+
- **Navegação por teclado na lateral.** `Command/Ctrl + K` e `Command/Ctrl + F`
|
|
29
|
+
focam a busca; setas percorrem os resultados filtrados.
|
|
30
|
+
- **Light mode do chrome.** A topbar alterna entre `dark` e `light`, e o estado
|
|
31
|
+
fica no deep link como `?appearance=light`. Os tokens claros preservam contraste
|
|
32
|
+
WCAG AA e não alcançam a UI do produto no palco.
|
|
33
|
+
- **Dicionário `EN_US_LABELS`.** Tradução integral do vocabulário do motor —
|
|
34
|
+
navegação, controles, status, significados, diagnóstico, acessibilidade e
|
|
35
|
+
estados vazios — pronta para uso em `theme.labels`.
|
|
36
|
+
|
|
37
|
+
### Alterado
|
|
38
|
+
|
|
39
|
+
- O botão que ocultava a lateral foi removido; a navegação permanece como parte
|
|
40
|
+
estrutural da mesa de revisão e se reorganiza acima do palco em telas estreitas.
|
|
41
|
+
- “Revisão limpa” abre uma nova aba com `chrome=0`, preservando a mesa de revisão
|
|
42
|
+
original. O controle invisível de retorno continua disponível em deep links
|
|
43
|
+
recebidos diretamente nesse modo.
|
|
44
|
+
- O seletor global de fixtures saiu da barra inferior. Dados, persona e rede do
|
|
45
|
+
cenário ativo aparecem juntos como escopo na lateral; overrides explícitos por
|
|
46
|
+
URL continuam compatíveis.
|
|
47
|
+
- A seção temporária de controles de acessibilidade saiu da barra inferior. O
|
|
48
|
+
contrato obrigatório, o painel de inspeção e os parâmetros de URL continuam
|
|
49
|
+
disponíveis.
|
|
50
|
+
- Presets de viewport usam ícones derivados do [Lucide](https://lucide.dev/), sob
|
|
51
|
+
licença MIT, incorporados como SVG para não adicionar dependência de runtime.
|
|
52
|
+
- O inspetor ganhou largura, espaçamento e cartões para separar situação,
|
|
53
|
+
reprodução, permissões, ações e critérios.
|
|
54
|
+
|
|
55
|
+
Migração: nenhuma para produtos que usam os seis estados anteriores. Ao trazer
|
|
56
|
+
cenários de um sistema existente sem validação, declare `status: "ported"` e só os
|
|
57
|
+
promova para outro estado quando houver a decisão correspondente.
|
|
58
|
+
|
|
59
|
+
## 0.2.0
|
|
60
|
+
|
|
61
|
+
Hospedagem deixa de ser suposição do motor. Um Design Space que roda só na
|
|
62
|
+
máquina de quem desenha passa a ser caso suportado e documentado, não um caso
|
|
63
|
+
degradado de um modelo que pressupõe um fornecedor.
|
|
64
|
+
|
|
65
|
+
### Alterado (incompatível)
|
|
66
|
+
|
|
67
|
+
- **`commitUrl` recebe um template de URL em vez de projeto e escopo.** O formato
|
|
68
|
+
do endereço é de quem hospeda, não do motor.
|
|
69
|
+
|
|
70
|
+
```ts
|
|
71
|
+
// 0.1.x
|
|
72
|
+
commitUrl(scenario, { project: "acme", scope: "time" });
|
|
73
|
+
|
|
74
|
+
// 0.2.0
|
|
75
|
+
commitUrl(scenario, { template: "https://acme-{shortCommit}-time.example.app" });
|
|
76
|
+
commitUrl(scenario, { template: "https://{commit}.review.acme.dev" });
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
`{commit}` e `{shortCommit}` são substituídos. Sem commit a função continua
|
|
80
|
+
devolvendo `undefined`, porque aprovação sem commit não é rastreável.
|
|
81
|
+
|
|
82
|
+
Migração: nenhum produto usava a função. Se o seu usa, monte o template com o
|
|
83
|
+
endereço que o seu host produz.
|
|
84
|
+
|
|
85
|
+
- **`getDeployContext` não lê mais variável de ambiente.** O contexto vem só de
|
|
86
|
+
`ProductDefinition.deploy`. A leitura anterior de `import.meta.env` e
|
|
87
|
+
`process.env` era inócua em produto real — o motor é biblioteca compilada, o
|
|
88
|
+
`import.meta.env` dele foi resolvido no build do pacote (ver 0.1.1) — então na
|
|
89
|
+
prática nada muda para quem já informava o campo `deploy`. Quem dependia da
|
|
90
|
+
detecção automática nunca teve detecção.
|
|
91
|
+
|
|
92
|
+
Campo vazio agora é tratado como ausente: `branch: ""`, que é o que um `define`
|
|
93
|
+
de bundler produz quando a variável não existe, deixa de virar um rótulo vazio
|
|
94
|
+
no cabeçalho da revisão.
|
|
95
|
+
|
|
96
|
+
### Adicionado
|
|
97
|
+
|
|
98
|
+
- **`theme.labels`: o chrome deixa de ser fixo em português.** Todo rótulo de
|
|
99
|
+
mecanismo — status, estado de rede, viewport, botão, aba, mensagem do painel —
|
|
100
|
+
vive em `DEFAULT_LABELS` e pode ser sobrescrito por grupo:
|
|
101
|
+
|
|
102
|
+
```ts
|
|
103
|
+
theme: {
|
|
104
|
+
labels: {
|
|
105
|
+
status: { approved: "Approved", "in-review": "In review" },
|
|
106
|
+
topbar: { copyLink: "Copy link" },
|
|
107
|
+
},
|
|
108
|
+
}
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
O que não for declarado fica no padrão. Novos exports: `DEFAULT_LABELS`,
|
|
112
|
+
`resolveLabels`, `useLabels`, `Labels`, `LabelsOverride`. `STATUS_LABELS`,
|
|
113
|
+
`STATUS_MEANING`, `NETWORK_LABELS` e `KEYBOARD_LABELS` continuam exportados,
|
|
114
|
+
agora como atalhos para os grupos de `DEFAULT_LABELS`.
|
|
115
|
+
|
|
116
|
+
O motivo: o chrome divide a tela com a UI do cliente. Um Design Space revisado
|
|
117
|
+
em inglês misturava "Em revisão" e "Copiar link" com a interface dele, e
|
|
118
|
+
traduzir só os status seria pior que não traduzir.
|
|
119
|
+
|
|
120
|
+
- **Trava de fronteira de hospedagem** (`src/deploy/hosting.test.ts`): reprova o
|
|
121
|
+
build se qualquer arquivo do motor citar um provedor, ou se `deploy/index.ts`
|
|
122
|
+
voltar a ler ambiente. No mesmo espírito da trava de fronteira visual.
|
|
123
|
+
|
|
124
|
+
- **Trava de idioma** (`src/shell/labels.test.ts`): reprova o build quando um
|
|
125
|
+
componente do chrome tem texto visível fixo — nó de texto, `aria-label`,
|
|
126
|
+
`title` ou `placeholder`. Sem ela, o próximo rótulo nasce no JSX e volta a ser
|
|
127
|
+
intraduzível.
|
|
128
|
+
|
|
129
|
+
- **Trava de vocabulário** (`src/shell/boundary.test.ts`): reprova o build se o
|
|
130
|
+
motor nomear um cliente.
|
|
131
|
+
|
|
132
|
+
### Corrigido
|
|
133
|
+
|
|
134
|
+
- **O motor não carrega mais o domínio dos primeiros clientes.** Comentários,
|
|
135
|
+
exemplos de JSDoc e fixtures de teste usavam o vocabulário do setor de um
|
|
136
|
+
cliente, inclusive o exemplo do README deste pacote. Nada disso tinha efeito em
|
|
137
|
+
runtime; o efeito era outro, e caro: um agente que lê esses arquivos conclui que
|
|
138
|
+
o motor serve a um setor e escreve como se fosse. Os exemplos passaram a usar
|
|
139
|
+
vocabulário genérico — solicitação, aprovação, cobrança.
|
|
140
|
+
|
|
141
|
+
- **Testes do módulo de deploy** (`src/deploy/deploy.test.ts`), que não existiam:
|
|
142
|
+
contexto local sem hospedagem, precedência do que o produto informa, string
|
|
143
|
+
vazia como ausente e substituição no template de aprovação.
|
|
144
|
+
|
|
9
145
|
## 0.1.1
|
|
10
146
|
|
|
11
147
|
### Corrigido
|
|
@@ -95,14 +231,14 @@ Primeira versão do motor. Fase 1 do roadmap.
|
|
|
95
231
|
carrega aparência e não carrega domínio.
|
|
96
232
|
|
|
97
233
|
O bug de origem: `new Date("2011-09-08")` é meia-noite **UTC** e, formatado em
|
|
98
|
-
qualquer fuso a oeste de Greenwich, exibe o dia anterior.
|
|
99
|
-
deslocava
|
|
100
|
-
|
|
101
|
-
|
|
234
|
+
qualquer fuso a oeste de Greenwich, exibe o dia anterior. Em um produto isso
|
|
235
|
+
deslocava uma data de nascimento e, com ela, a idade calculada e uma regra que
|
|
236
|
+
dependia da idade; em outro, errava um vencimento por um dia. Os dois produtos
|
|
237
|
+
escreveram a mesma correção separadamente, sem saber um do outro.
|
|
102
238
|
|
|
103
239
|
`ageInYears` exige a data de referência como parâmetro obrigatório de propósito:
|
|
104
240
|
um padrão `new Date()` faria fixture depender do relógio.
|
|
105
241
|
|
|
106
|
-
O que **não** foi extraído, e por quê, está
|
|
107
|
-
|
|
108
|
-
|
|
242
|
+
O que **não** foi extraído, e por quê, está registrado no repositório do segundo
|
|
243
|
+
produto. A régua para a próxima extração: **dois produtos, zero aparência, zero
|
|
244
|
+
domínio.**
|
package/README.md
CHANGED
|
@@ -32,26 +32,48 @@ diferentes.
|
|
|
32
32
|
```ts
|
|
33
33
|
import type { Scenario } from "@brucesantos/design-space";
|
|
34
34
|
|
|
35
|
-
export const
|
|
36
|
-
id: "
|
|
37
|
-
title: "
|
|
38
|
-
route: "/
|
|
39
|
-
persona: "
|
|
40
|
-
permissions: ["
|
|
41
|
-
fixture: "
|
|
42
|
-
rules: ["
|
|
35
|
+
export const approveBlocked: Scenario = {
|
|
36
|
+
id: "requests.approve-blocked",
|
|
37
|
+
title: "Aprovação bloqueada por falta de documento",
|
|
38
|
+
route: "/requests/REQ-2043",
|
|
39
|
+
persona: "approver",
|
|
40
|
+
permissions: ["requests.read", "requests.approve"],
|
|
41
|
+
fixture: "request-without-document",
|
|
42
|
+
rules: ["approval-needs-document"],
|
|
43
43
|
a11y: {
|
|
44
44
|
keyboard: "full",
|
|
45
45
|
contrast: "AA",
|
|
46
|
-
announces: ["
|
|
46
|
+
announces: ["request.status", "approval.result"],
|
|
47
47
|
},
|
|
48
48
|
status: "approved",
|
|
49
49
|
};
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
+
O vocabulário do exemplo é genérico de propósito: o domínio é do produto, nunca do
|
|
53
|
+
motor.
|
|
54
|
+
|
|
52
55
|
`a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de
|
|
53
|
-
projeto: um cenário de
|
|
54
|
-
|
|
56
|
+
projeto: um cenário de ação bloqueada em que o bloqueio não é anunciado para leitor
|
|
57
|
+
de tela está incompleto, não está pronto para aprovação.
|
|
58
|
+
|
|
59
|
+
### Ciclo de vida
|
|
60
|
+
|
|
61
|
+
O estado diz o que o cenário representa; importar uma tela existente não a torna
|
|
62
|
+
proposta nem compromisso de implementação.
|
|
63
|
+
|
|
64
|
+
| Valor | Rótulo padrão | Significado |
|
|
65
|
+
| --- | --- | --- |
|
|
66
|
+
| `ported` | Portado — não validado | Veio do sistema existente, mas não foi validado e não representa compromisso de implementação. |
|
|
67
|
+
| `proposed` | Proposta | Exploração ainda não aprovada. |
|
|
68
|
+
| `in-review` | Em revisão | Aberto para validação de design, negócio ou cliente. |
|
|
69
|
+
| `approved` | Aprovado | Referência autorizada, registrada por URL de commit. |
|
|
70
|
+
| `in-implementation` | Em implementação | Ligado a um trabalho ativo de engenharia. |
|
|
71
|
+
| `implemented` | Implementado | Disponível no produto real e validado. |
|
|
72
|
+
| `superseded` | Superado | Mantido para histórico ou substituído por outra decisão. |
|
|
73
|
+
|
|
74
|
+
`scenariosUnderTest()` inclui por padrão apenas `approved`, `in-implementation` e
|
|
75
|
+
`implemented`. Cenários `ported` ficam fora até serem promovidos, mas podem ser
|
|
76
|
+
selecionados explicitamente pelo segundo argumento.
|
|
55
77
|
|
|
56
78
|
## A URL é o estado
|
|
57
79
|
|
|
@@ -62,12 +84,14 @@ rede declarados no cenário.
|
|
|
62
84
|
| Parâmetro | Efeito |
|
|
63
85
|
| --- | --- |
|
|
64
86
|
| `scenario` | Cenário ativo. Define os padrões dos demais. |
|
|
87
|
+
| `component` | Referência ativa no catálogo visual do produto. |
|
|
65
88
|
| `persona` | Troca o papel e as permissões. |
|
|
66
89
|
| `fixture` | Troca o conjunto de dados. |
|
|
67
90
|
| `network` | `success`, `loading`, `empty`, `error`, `slow`. |
|
|
68
91
|
| `viewport` | `fit`, `mobile`, `tablet`, `desktop`, `custom`. |
|
|
69
92
|
| `w` | Largura, quando `viewport=custom`. |
|
|
70
93
|
| `theme`, `locale`, `source` | Variações declaradas pelo produto. |
|
|
94
|
+
| `appearance` | Aparência do chrome: omitido para dark, `light` para modo claro. |
|
|
71
95
|
| `chrome=0` | Revisão limpa: oculta o chrome do ambiente. |
|
|
72
96
|
| `kb=1` | Modo teclado, com ordem de tabulação evidenciada. |
|
|
73
97
|
| `motion=1` | Movimento reduzido no palco. |
|
|
@@ -83,6 +107,50 @@ rede declarados no cenário.
|
|
|
83
107
|
- `Stage`, `StageEmpty`, `TabOrderOverlay` — partes do palco, expostas para casos
|
|
84
108
|
fora do padrão.
|
|
85
109
|
|
|
110
|
+
### Rótulos do chrome
|
|
111
|
+
|
|
112
|
+
O chrome vem em português por padrão e é traduzível pelo produto, por grupo. O que
|
|
113
|
+
não for declarado fica no padrão.
|
|
114
|
+
|
|
115
|
+
```ts
|
|
116
|
+
theme: {
|
|
117
|
+
labels: {
|
|
118
|
+
status: { approved: "Approved", "in-review": "In review" },
|
|
119
|
+
topbar: { copyLink: "Copy link" },
|
|
120
|
+
home: { lead: (total) => `${total} scenarios, each one a link.` },
|
|
121
|
+
},
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
- `DEFAULT_LABELS` — o dicionário completo, em português.
|
|
126
|
+
- `EN_US_LABELS` — o dicionário completo em inglês dos Estados Unidos.
|
|
127
|
+
- `resolveLabels(override)` — mescla por grupo. Útil fora de React.
|
|
128
|
+
- `useLabels()` — os rótulos resolvidos, dentro do chrome.
|
|
129
|
+
- `Labels`, `LabelsOverride` — os tipos.
|
|
130
|
+
|
|
131
|
+
Rótulo de **produto** continua vindo do produto: nome de módulo, título de cenário,
|
|
132
|
+
nome de persona, rótulo de fixture.
|
|
133
|
+
|
|
134
|
+
Para usar o chrome integralmente em en-US:
|
|
135
|
+
|
|
136
|
+
```ts
|
|
137
|
+
import { EN_US_LABELS } from "@brucesantos/design-space";
|
|
138
|
+
|
|
139
|
+
const product = {
|
|
140
|
+
// ...
|
|
141
|
+
theme: {
|
|
142
|
+
locales: ["en-US"],
|
|
143
|
+
labels: EN_US_LABELS,
|
|
144
|
+
},
|
|
145
|
+
};
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
### Aparência do chrome
|
|
149
|
+
|
|
150
|
+
O seletor na topbar alterna entre dark e light sem alterar tokens ou tema da UI
|
|
151
|
+
do produto. A escolha é serializada como `?appearance=light`, então links copiados
|
|
152
|
+
e a revisão limpa preservam a aparência escolhida.
|
|
153
|
+
|
|
86
154
|
### Registry e validação
|
|
87
155
|
|
|
88
156
|
- `createRegistry(product)` — índice consultável: busca por vocabulário de
|
|
@@ -91,12 +159,42 @@ rede declarados no cenário.
|
|
|
91
159
|
do contrato. Pega fixture, persona, regra ou rota inexistente, que o TypeScript
|
|
92
160
|
não alcança.
|
|
93
161
|
|
|
162
|
+
### Catálogo de componentes
|
|
163
|
+
|
|
164
|
+
O catálogo é opcional. O motor fornece navegação, busca e deep link; cada preview
|
|
165
|
+
continua sendo UI do produto:
|
|
166
|
+
|
|
167
|
+
```tsx
|
|
168
|
+
const product: ProductDefinition = {
|
|
169
|
+
// ...
|
|
170
|
+
components: [
|
|
171
|
+
{
|
|
172
|
+
id: "actions.primary-button",
|
|
173
|
+
name: "Botão primário",
|
|
174
|
+
group: "Ações",
|
|
175
|
+
description: "Ação principal da página",
|
|
176
|
+
preview: PrimaryButtonPreview,
|
|
177
|
+
},
|
|
178
|
+
],
|
|
179
|
+
};
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
Abrir um item produz `?component=actions.primary-button`, compartilhável como os
|
|
183
|
+
deep links de cenário. `ComponentPreview` é o tipo público desse contrato.
|
|
184
|
+
|
|
94
185
|
### Deploy e deep links
|
|
95
186
|
|
|
96
|
-
|
|
97
|
-
|
|
187
|
+
O motor não conhece provedor de hospedagem, e um Design Space que roda só local é
|
|
188
|
+
caso suportado: sem contexto, o ambiente é `development` e o cabeçalho da revisão
|
|
189
|
+
omite branch e commit.
|
|
190
|
+
|
|
191
|
+
- `getDeployContext(overrides)` — monta branch, commit, ambiente e origem absoluta
|
|
192
|
+
a partir do que o produto informou em `ProductDefinition.deploy`. Não lê
|
|
193
|
+
ambiente: o motor é biblioteca compilada e não alcança o build de quem o
|
|
194
|
+
consome.
|
|
98
195
|
- `scenarioUrl(scenario, options)` — URL absoluta reproduzível.
|
|
99
|
-
- `commitUrl(scenario,
|
|
196
|
+
- `commitUrl(scenario, { template })` — URL imutável para registrar aprovação. O
|
|
197
|
+
template é do produto, com `{commit}` ou `{shortCommit}`.
|
|
100
198
|
|
|
101
199
|
### Dados
|
|
102
200
|
|
|
@@ -120,8 +218,8 @@ preview.
|
|
|
120
218
|
|
|
121
219
|
- `pathFor(scenario, overrides)` — caminho relativo para `page.goto`, deixando o
|
|
122
220
|
`baseURL` do Playwright decidir entre preview e dev server.
|
|
123
|
-
- `testOrigin(fallback)` — lê `PREVIEW_URL
|
|
124
|
-
|
|
221
|
+
- `testOrigin(fallback)` — lê `PREVIEW_URL` quando existe um ambiente publicado
|
|
222
|
+
para testar; sem ela, o Playwright roda contra o dev server local.
|
|
125
223
|
- `assertValidProduct(product)` — falha o teste quando o contrato tem erro.
|
|
126
224
|
- `scenariosUnderTest(product)`, `keyboardScenarios(product)` — recortes para
|
|
127
225
|
parametrizar jornadas.
|
|
@@ -130,16 +228,28 @@ preview.
|
|
|
130
228
|
|
|
131
229
|
| Atalho | Efeito |
|
|
132
230
|
| --- | --- |
|
|
133
|
-
| `
|
|
231
|
+
| `Command/Ctrl` + `K` ou `F` | Foco na busca da lateral |
|
|
232
|
+
| `↑` / `↓` | Percorrer resultados filtrados |
|
|
134
233
|
| `Shift` + `K` | Modo teclado |
|
|
135
234
|
| `Shift` + `P` | Painel de contexto |
|
|
136
235
|
|
|
236
|
+
## Créditos
|
|
237
|
+
|
|
238
|
+
Os ícones dos presets de viewport são derivados do
|
|
239
|
+
[Lucide](https://lucide.dev/), disponibilizado sob licença MIT. Obrigado às
|
|
240
|
+
pessoas mantenedoras e contribuidoras do projeto. Os SVGs necessários são
|
|
241
|
+
incorporados ao motor, portanto não existe dependência de runtime do Lucide.
|
|
242
|
+
|
|
137
243
|
## Fronteira
|
|
138
244
|
|
|
139
245
|
O motor **não** contém e não deve conter: componente visual, token, tipografia,
|
|
140
246
|
cor, ícone, persona de domínio, fixture, regra de negócio ou conteúdo de cliente.
|
|
141
|
-
Isso é exclusivo de cada produto — e é o que permite que
|
|
142
|
-
continuem parecendo produtos distintos.
|
|
247
|
+
Isso é exclusivo de cada produto — e é o que permite que dois produtos sobre o
|
|
248
|
+
mesmo motor continuem parecendo produtos distintos.
|
|
249
|
+
|
|
250
|
+
Três coisas que também não pertencem ao motor, cada uma travada por teste:
|
|
251
|
+
provedor de hospedagem, texto visível fixo em componente do chrome e nome de
|
|
252
|
+
cliente em exemplo.
|
|
143
253
|
|
|
144
254
|
## Licença
|
|
145
255
|
|
|
@@ -0,0 +1,268 @@
|
|
|
1
|
+
const w = [
|
|
2
|
+
"ported",
|
|
3
|
+
"proposed",
|
|
4
|
+
"in-review",
|
|
5
|
+
"approved",
|
|
6
|
+
"in-implementation",
|
|
7
|
+
"implemented",
|
|
8
|
+
"superseded"
|
|
9
|
+
], A = [
|
|
10
|
+
"success",
|
|
11
|
+
"loading",
|
|
12
|
+
"empty",
|
|
13
|
+
"error",
|
|
14
|
+
"slow"
|
|
15
|
+
], $ = /^[a-z0-9]+([.\-][a-z0-9]+)*$/;
|
|
16
|
+
function m(e) {
|
|
17
|
+
return typeof e == "string" && e.trim().length > 0;
|
|
18
|
+
}
|
|
19
|
+
function k(e, o) {
|
|
20
|
+
const t = [], r = m(e?.id) ? `scenario:${e.id}` : `scenario[${o ?? "?"}]`, n = (c) => t.push({ level: "error", where: r, message: c }), s = (c) => t.push({ level: "warning", where: r, message: c });
|
|
21
|
+
m(e?.id) ? $.test(e.id) ? e.id.includes(".") || s("`id` sem prefixo de módulo dificulta a navegação e a busca do agente.") : n(
|
|
22
|
+
"`id` deve ser minúsculo em kebab-case, com o módulo como prefixo: `requests.approve-blocked`."
|
|
23
|
+
) : n("`id` é obrigatório."), m(e?.title) || n("`title` é obrigatório e deve usar o vocabulário do negócio."), m(e?.route) ? e.route.startsWith("/") || n("`route` deve começar com `/`.") : n("`route` é obrigatório."), m(e?.persona) || n("`persona` é obrigatório."), m(e?.fixture) || n("`fixture` é obrigatório. O padrão do ambiente é dado sintético (D-05)."), w.includes(e?.status) || n(`\`status\` deve ser um de: ${w.join(", ")}.`), e?.network && !A.includes(e.network) && n(`\`network\` deve ser um de: ${A.join(", ")}.`);
|
|
24
|
+
const i = e?.a11y;
|
|
25
|
+
return !i || typeof i != "object" ? n(
|
|
26
|
+
"`a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de projeto (D-15)."
|
|
27
|
+
) : (["full", "partial", "not-applicable"].includes(i.keyboard) || n("`a11y.keyboard` deve ser `full`, `partial` ou `not-applicable`."), ["AA", "AAA"].includes(i.contrast) || n("`a11y.contrast` deve ser `AA` ou `AAA`. O padrão interno é WCAG 2.2 AA."), i.announces !== void 0 && !Array.isArray(i.announces) && n("`a11y.announces` deve ser uma lista de chaves de evento de domínio.")), e?.status === "approved" && i?.keyboard === "partial" && s(
|
|
28
|
+
'Cenário aprovado com `a11y.keyboard: "partial"`. Confirme que esta jornada não é crítica.'
|
|
29
|
+
), e?.status === "approved" && !e.approvedAt && s(
|
|
30
|
+
"Cenário aprovado sem `approvedAt`. A aprovação deve ser registrada por URL de commit (§10.2), senão muda de conteúdo debaixo de quem aprovou."
|
|
31
|
+
), e?.expected?.length || s(
|
|
32
|
+
"Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater)."
|
|
33
|
+
), t;
|
|
34
|
+
}
|
|
35
|
+
function D(e) {
|
|
36
|
+
const o = [], t = (d, a, l) => o.push({ level: d, where: a, message: l }), r = new Set(e.personas?.map((d) => d.id) ?? []), n = new Set(e.fixtures?.map((d) => d.id) ?? []), s = new Set(e.rules?.map((d) => d.id) ?? []), i = new Set(e.modules?.map((d) => d.id) ?? []), c = /* @__PURE__ */ new Set();
|
|
37
|
+
m(e.id) || t("error", "product", "`id` é obrigatório."), m(e.name) || t("error", "product", "`name` é obrigatório."), e.routes?.length || t("error", "product", "`routes` está vazio: nenhum cenário conseguirá renderizar.");
|
|
38
|
+
const u = /* @__PURE__ */ new Set();
|
|
39
|
+
for (const [d, a] of (e.components ?? []).entries()) {
|
|
40
|
+
const l = `component:${a?.id ?? d}`;
|
|
41
|
+
m(a?.id) ? $.test(a.id) ? u.has(a.id) ? t("error", l, `\`id\` duplicado: ${a.id}.`) : u.add(a.id) : t("error", l, "`id` deve ser minúsculo em kebab-case ou usar pontos para agrupamento.") : t("error", l, "`id` é obrigatório."), m(a?.name) || t("error", l, "`name` é obrigatório."), typeof a?.preview != "function" && t("error", l, "`preview` é obrigatório.");
|
|
42
|
+
}
|
|
43
|
+
for (const [d, a] of (e.scenarios ?? []).entries()) {
|
|
44
|
+
o.push(...k(a, d));
|
|
45
|
+
const l = `scenario:${a?.id ?? d}`;
|
|
46
|
+
if (a?.id) {
|
|
47
|
+
c.has(a.id) && t("error", l, `\`id\` duplicado: ${a.id}.`), c.add(a.id);
|
|
48
|
+
const p = a.id.split(".")[0];
|
|
49
|
+
p && i.size > 0 && !i.has(p) && t(
|
|
50
|
+
"warning",
|
|
51
|
+
l,
|
|
52
|
+
`Prefixo \`${p}\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`
|
|
53
|
+
);
|
|
54
|
+
}
|
|
55
|
+
a?.persona && !r.has(a.persona) && t("error", l, `Persona não registrada: \`${a.persona}\`.`), a?.fixture && !n.has(a.fixture) && t("error", l, `Fixture não registrada: \`${a.fixture}\`.`);
|
|
56
|
+
for (const p of a?.rules ?? [])
|
|
57
|
+
s.has(p) || t("error", l, `Regra não registrada: \`${p}\`.`);
|
|
58
|
+
a?.route && !N(a.route, e) && t(
|
|
59
|
+
"error",
|
|
60
|
+
l,
|
|
61
|
+
`Rota \`${a.route}\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`
|
|
62
|
+
);
|
|
63
|
+
}
|
|
64
|
+
for (const d of e.modules ?? [])
|
|
65
|
+
for (const a of d.flows ?? []) {
|
|
66
|
+
const l = `flow:${d.id}/${a.id}`;
|
|
67
|
+
a.steps?.length || t("warning", l, "Jornada sem passos.");
|
|
68
|
+
for (const p of a.steps ?? []) {
|
|
69
|
+
c.has(p.scenario) || t("error", l, `Passo aponta para cenário inexistente: \`${p.scenario}\`.`);
|
|
70
|
+
for (const [y, b] of Object.entries(p.branches ?? {}))
|
|
71
|
+
c.has(b) || t(
|
|
72
|
+
"error",
|
|
73
|
+
l,
|
|
74
|
+
`Ramificação "${y}" aponta para cenário inexistente: \`${b}\`.`
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
const f = e.dataSources?.default;
|
|
79
|
+
return f && f !== "fixtures" && (new Set(e.dataSources?.adapters?.map((a) => a.id) ?? []).has(f) || t("error", "product", `\`dataSources.default\` aponta para adapter inexistente: \`${f}\`.`), t(
|
|
80
|
+
"warning",
|
|
81
|
+
"product",
|
|
82
|
+
"A fonte padrão não é `fixtures`. O padrão do ambiente é dado sintético e determinístico (D-05); API real entra como adapter opcional, com justificativa."
|
|
83
|
+
)), o;
|
|
84
|
+
}
|
|
85
|
+
function N(e, o) {
|
|
86
|
+
const t = e.split("?")[0] ?? e;
|
|
87
|
+
return (o.routes ?? []).some((r) => P(r.path, t));
|
|
88
|
+
}
|
|
89
|
+
function P(e, o) {
|
|
90
|
+
const t = e.split("/").filter(Boolean), r = o.split("/").filter(Boolean);
|
|
91
|
+
for (const [n, s] of t.entries()) {
|
|
92
|
+
if (s === "*") return !0;
|
|
93
|
+
const i = r[n];
|
|
94
|
+
if (i === void 0) return !1;
|
|
95
|
+
if (!s.startsWith(":") && s !== i)
|
|
96
|
+
return !1;
|
|
97
|
+
}
|
|
98
|
+
return t.length === r.length;
|
|
99
|
+
}
|
|
100
|
+
function M(e) {
|
|
101
|
+
return e.some((o) => o.level === "error");
|
|
102
|
+
}
|
|
103
|
+
function z(e) {
|
|
104
|
+
return e.length === 0 ? "Nenhum problema encontrado." : e.map((o) => `${o.level === "error" ? "✖" : "▲"} ${o.where}
|
|
105
|
+
${o.message}`).join(`
|
|
106
|
+
`);
|
|
107
|
+
}
|
|
108
|
+
const h = {
|
|
109
|
+
scenario: "scenario",
|
|
110
|
+
component: "component",
|
|
111
|
+
persona: "persona",
|
|
112
|
+
fixture: "fixture",
|
|
113
|
+
network: "network",
|
|
114
|
+
viewport: "viewport",
|
|
115
|
+
customWidth: "w",
|
|
116
|
+
themeMode: "theme",
|
|
117
|
+
locale: "locale",
|
|
118
|
+
dataSource: "source",
|
|
119
|
+
chromeTheme: "appearance",
|
|
120
|
+
chrome: "chrome",
|
|
121
|
+
keyboardMode: "kb",
|
|
122
|
+
reducedMotion: "motion",
|
|
123
|
+
textScale: "scale",
|
|
124
|
+
inspector: "panel"
|
|
125
|
+
};
|
|
126
|
+
function C(e) {
|
|
127
|
+
return typeof e == "boolean" ? e ? "1" : "0" : String(e);
|
|
128
|
+
}
|
|
129
|
+
function R(e, o = {}) {
|
|
130
|
+
for (const [t, r] of Object.entries(o)) {
|
|
131
|
+
if (r == null) continue;
|
|
132
|
+
const n = h[t];
|
|
133
|
+
n && e.set(n, C(r));
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
function S(e = {}) {
|
|
137
|
+
const o = e.branchUrl || void 0, t = e.deploymentUrl || void 0, r = e.commit || void 0, n = e.env || "development", s = o && `https://${o}` || t && `https://${t}` || (typeof window < "u" ? window.location.origin : "http://localhost:5173");
|
|
138
|
+
return {
|
|
139
|
+
env: n,
|
|
140
|
+
origin: s.replace(/\/$/, ""),
|
|
141
|
+
branchUrl: o,
|
|
142
|
+
deploymentUrl: t,
|
|
143
|
+
branch: e.branch || void 0,
|
|
144
|
+
commit: r,
|
|
145
|
+
shortCommit: r?.slice(0, 7),
|
|
146
|
+
isDeployed: n === "preview" || n === "production"
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
function I(e, o = {}) {
|
|
150
|
+
const t = o.origin ?? S().origin, r = new URL(e.route, t);
|
|
151
|
+
return r.searchParams.set(h.scenario, e.id), r.searchParams.set(h.persona, e.persona), r.searchParams.set(h.fixture, e.fixture), e.network && e.network !== "success" && r.searchParams.set(h.network, e.network), R(r.searchParams, o.overrides), r.toString();
|
|
152
|
+
}
|
|
153
|
+
function L(e, o) {
|
|
154
|
+
const t = o.commit ?? S().commit;
|
|
155
|
+
if (!t) return;
|
|
156
|
+
const r = o.template.replaceAll("{shortCommit}", t.slice(0, 7)).replaceAll("{commit}", t);
|
|
157
|
+
return I(e, { origin: r });
|
|
158
|
+
}
|
|
159
|
+
const x = {
|
|
160
|
+
AA: { normal: 4.5, large: 3 },
|
|
161
|
+
AAA: { normal: 7, large: 4.5 }
|
|
162
|
+
}, O = {
|
|
163
|
+
white: "#ffffff",
|
|
164
|
+
black: "#000000",
|
|
165
|
+
transparent: "#00000000"
|
|
166
|
+
};
|
|
167
|
+
function v(e) {
|
|
168
|
+
const o = e.trim().toLowerCase(), t = O[o];
|
|
169
|
+
if (t) return v(t);
|
|
170
|
+
if (o.startsWith("#")) {
|
|
171
|
+
const n = o.slice(1), s = (i) => Number.parseInt(i.repeat(2), 16);
|
|
172
|
+
if (n.length === 3 || n.length === 4) {
|
|
173
|
+
const [i, c, u, f] = [...n];
|
|
174
|
+
return !i || !c || !u ? void 0 : { r: s(i), g: s(c), b: s(u), a: f ? s(f) / 255 : 1 };
|
|
175
|
+
}
|
|
176
|
+
if (n.length === 6 || n.length === 8) {
|
|
177
|
+
const i = (u) => Number.parseInt(n.slice(u, u + 2), 16), c = [i(0), i(2), i(4)];
|
|
178
|
+
return c.some(Number.isNaN) ? void 0 : {
|
|
179
|
+
r: c[0],
|
|
180
|
+
g: c[1],
|
|
181
|
+
b: c[2],
|
|
182
|
+
a: n.length === 8 ? i(6) / 255 : 1
|
|
183
|
+
};
|
|
184
|
+
}
|
|
185
|
+
return;
|
|
186
|
+
}
|
|
187
|
+
const r = o.match(/^rgba?\(([^)]+)\)$/);
|
|
188
|
+
if (r?.[1]) {
|
|
189
|
+
const n = r[1].split(/[\s,/]+/).filter(Boolean), [s, i, c, u] = n.map(Number);
|
|
190
|
+
return [s, i, c].some((f) => f === void 0 || Number.isNaN(f)) ? void 0 : { r: s, g: i, b: c, a: u === void 0 || Number.isNaN(u) ? 1 : u };
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
function T(e, o) {
|
|
194
|
+
if (e.a >= 1) return e;
|
|
195
|
+
const t = (r, n) => r * e.a + n * (1 - e.a);
|
|
196
|
+
return {
|
|
197
|
+
r: t(e.r, o.r),
|
|
198
|
+
g: t(e.g, o.g),
|
|
199
|
+
b: t(e.b, o.b),
|
|
200
|
+
a: 1
|
|
201
|
+
};
|
|
202
|
+
}
|
|
203
|
+
function g({ r: e, g: o, b: t }) {
|
|
204
|
+
const r = (n) => {
|
|
205
|
+
const s = n / 255;
|
|
206
|
+
return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
|
|
207
|
+
};
|
|
208
|
+
return 0.2126 * r(e) + 0.7152 * r(o) + 0.0722 * r(t);
|
|
209
|
+
}
|
|
210
|
+
function j(e, o) {
|
|
211
|
+
const t = v(o), r = v(e);
|
|
212
|
+
if (!t || !r) return;
|
|
213
|
+
const n = T(r, t), s = Math.max(g(n), g(t)), i = Math.min(g(n), g(t));
|
|
214
|
+
return (s + 0.05) / (i + 0.05);
|
|
215
|
+
}
|
|
216
|
+
function E(e) {
|
|
217
|
+
const o = e.target ?? "AA", t = e.largeText ? x[o].large : x[o].normal, r = j(e.foreground, e.background);
|
|
218
|
+
return {
|
|
219
|
+
pair: e,
|
|
220
|
+
target: o,
|
|
221
|
+
ratio: r,
|
|
222
|
+
required: t,
|
|
223
|
+
passes: r === void 0 ? void 0 : r >= t,
|
|
224
|
+
label: r === void 0 ? "não medido" : `${r.toFixed(2)}:1`
|
|
225
|
+
};
|
|
226
|
+
}
|
|
227
|
+
function U(e = []) {
|
|
228
|
+
return e.map(E);
|
|
229
|
+
}
|
|
230
|
+
function W(e) {
|
|
231
|
+
const o = U(e).filter((r) => r.passes !== !0);
|
|
232
|
+
if (o.length === 0) return;
|
|
233
|
+
const t = o.map(
|
|
234
|
+
(r) => ` ✖ ${r.pair.name}: ${r.label} (mínimo ${r.required}:1 para ${r.target}${r.pair.largeText ? ", texto grande" : ""})`
|
|
235
|
+
).join(`
|
|
236
|
+
`);
|
|
237
|
+
throw new Error(`Pares de contraste fora do alvo:
|
|
238
|
+
${t}`);
|
|
239
|
+
}
|
|
240
|
+
function q(e, o) {
|
|
241
|
+
if (typeof window > "u") return;
|
|
242
|
+
const t = o ?? document.documentElement;
|
|
243
|
+
return window.getComputedStyle(t).getPropertyValue(e).trim() || void 0;
|
|
244
|
+
}
|
|
245
|
+
export {
|
|
246
|
+
x as C,
|
|
247
|
+
A as N,
|
|
248
|
+
h as P,
|
|
249
|
+
w as S,
|
|
250
|
+
R as a,
|
|
251
|
+
W as b,
|
|
252
|
+
U as c,
|
|
253
|
+
E as d,
|
|
254
|
+
L as e,
|
|
255
|
+
j as f,
|
|
256
|
+
S as g,
|
|
257
|
+
T as h,
|
|
258
|
+
z as i,
|
|
259
|
+
M as j,
|
|
260
|
+
g as k,
|
|
261
|
+
C as l,
|
|
262
|
+
k as m,
|
|
263
|
+
v as p,
|
|
264
|
+
q as r,
|
|
265
|
+
I as s,
|
|
266
|
+
D as v
|
|
267
|
+
};
|
|
268
|
+
//# sourceMappingURL=contrast-87-ijttm.js.map
|