@brucesantos/design-space 0.2.0 → 0.4.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 +86 -0
- package/README.md +152 -2
- package/dist/contrast-B8I8gWGa.js +288 -0
- package/dist/contrast-B8I8gWGa.js.map +1 -0
- package/dist/controls/params.d.ts +3 -0
- package/dist/controls/state.d.ts +2 -0
- package/dist/deploy/index.d.ts +7 -1
- package/dist/design-space.css +1 -1
- package/dist/index.d.ts +4 -4
- package/dist/index.js +1353 -830
- package/dist/index.js.map +1 -1
- package/dist/registry/index.d.ts +25 -4
- package/dist/shell/Controls.d.ts +6 -3
- package/dist/shell/Home.d.ts +2 -1
- package/dist/shell/Inspector.d.ts +5 -3
- package/dist/shell/Sidebar.d.ts +9 -2
- package/dist/shell/Topbar.d.ts +7 -5
- package/dist/shell/labels.d.ts +26 -0
- package/dist/testing/index.d.ts +4 -4
- package/dist/testing.js +8 -8
- package/dist/testing.js.map +1 -1
- package/dist/types/index.d.ts +57 -1
- package/package.json +2 -2
- package/dist/contrast-BXd_acxo.js +0 -260
- package/dist/contrast-BXd_acxo.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,92 @@ 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.4.0 (2026-08-12)
|
|
10
|
+
|
|
11
|
+
### Adicionado
|
|
12
|
+
|
|
13
|
+
- **Fixtures próprias para previews de componentes.** `ComponentPreview<T>` aceita
|
|
14
|
+
`fixtures` e `defaultFixture`; cada `ComponentPreviewFixture<T>` tem id estável,
|
|
15
|
+
rótulo, descrição opcional e dados sintéticos como valor ou factory determinística.
|
|
16
|
+
- `ComponentPreviewProps<T>` entrega fixture resolvida, dados, viewport, tema,
|
|
17
|
+
idioma e preferências de acessibilidade ao preview. Previews 0.3.0 sem props e
|
|
18
|
+
componentes sem fixtures continuam válidos.
|
|
19
|
+
- O deep link de componente passa a incluir sua fixture:
|
|
20
|
+
`?component=actions.button&fixture=disabled`. `componentUrl()` monta esse link.
|
|
21
|
+
- O validador detecta ids inválidos ou duplicados dentro do componente e
|
|
22
|
+
`defaultFixture` inexistente. Uma fixture desconhecida na URL cai explicitamente
|
|
23
|
+
no default (ou na primeira) e mostra o fallback no painel.
|
|
24
|
+
- Opção discreta **Mostrar portados**, reproduzível como `showPorted=1`.
|
|
25
|
+
|
|
26
|
+
### Alterado
|
|
27
|
+
|
|
28
|
+
- Cenários `ported` deixam de aparecer por padrão na home, árvore de Fluxos,
|
|
29
|
+
busca, jornadas e contagens de trabalho ativo. Continuam em
|
|
30
|
+
`ProductDefinition`, `registry.tree`, `registry.issues`, `byStatus()`, diagnóstico,
|
|
31
|
+
deep links diretos e continuam fora de `scenariosUnderTest()`.
|
|
32
|
+
- `Registry.search()`, `coverage()` e `scenariosForRoute()` agora consultam trabalho
|
|
33
|
+
ativo por padrão; `{ includePorted: true }` restaura o catálogo completo.
|
|
34
|
+
`activeScenarios()`, `treeFor()` e `orphansFor()` tornam o recorte explícito.
|
|
35
|
+
- Um produto contendo somente portados mostra que não há trabalho ativo. Um
|
|
36
|
+
portado aberto por deep link continua visível como item ativo na navegação,
|
|
37
|
+
mesmo com a opção desligada.
|
|
38
|
+
- O painel de componente passa a mostrar nome, grupo, id, fixture ativa e as
|
|
39
|
+
descrições do componente e da fixture.
|
|
40
|
+
|
|
41
|
+
Migração: nenhuma obrigatória para consumidores 0.3.0. Para adotar dados por
|
|
42
|
+
componente, tipar o preview com `ComponentPreviewProps<T>` e declarar `fixtures`.
|
|
43
|
+
Fixtures globais de cenário não são usadas automaticamente por componentes.
|
|
44
|
+
|
|
45
|
+
## 0.3.0
|
|
46
|
+
|
|
47
|
+
### Adicionado
|
|
48
|
+
|
|
49
|
+
- **Estado de ciclo de vida `ported` (`Portado — não validado`).** Identifica um
|
|
50
|
+
cenário trazido do sistema existente que ainda não foi validado e não representa
|
|
51
|
+
proposta, aprovação ou compromisso de implementação. É uma adição compatível:
|
|
52
|
+
os seis estados anteriores preservam valor, rótulo e comportamento.
|
|
53
|
+
- `ported` passa a fazer parte de `ScenarioStatus` e `SCENARIO_STATUSES`, da
|
|
54
|
+
validação em runtime, de `Registry.byStatus()` e da cobertura por status. O mapa,
|
|
55
|
+
a navegação e o diagnóstico mostram o estado com rótulo, significado, chip
|
|
56
|
+
neutro e indicador visual próprio.
|
|
57
|
+
- `scenariosUnderTest()` não inclui cenários portados no recorte padrão. Um produto
|
|
58
|
+
ainda pode testá-los explicitamente com `scenariosUnderTest(product, ["ported"])`,
|
|
59
|
+
sem transformar a importação em compromisso de manutenção de jornada E2E.
|
|
60
|
+
- **Catálogo opcional de componentes.** `ProductDefinition.components` recebe
|
|
61
|
+
referências visuais implementadas pelo produto (`id`, nome, grupo, descrição e
|
|
62
|
+
componente React). O motor organiza a aba, busca, deep link `?component=…` e
|
|
63
|
+
painel de contexto sem incorporar UI, tokens ou domínio do produto.
|
|
64
|
+
- **Navegação por teclado na lateral.** `Command/Ctrl + K` e `Command/Ctrl + F`
|
|
65
|
+
focam a busca; setas percorrem os resultados filtrados.
|
|
66
|
+
- **Light mode do chrome.** A topbar alterna entre `dark` e `light`, e o estado
|
|
67
|
+
fica no deep link como `?appearance=light`. Os tokens claros preservam contraste
|
|
68
|
+
WCAG AA e não alcançam a UI do produto no palco.
|
|
69
|
+
- **Dicionário `EN_US_LABELS`.** Tradução integral do vocabulário do motor —
|
|
70
|
+
navegação, controles, status, significados, diagnóstico, acessibilidade e
|
|
71
|
+
estados vazios — pronta para uso em `theme.labels`.
|
|
72
|
+
|
|
73
|
+
### Alterado
|
|
74
|
+
|
|
75
|
+
- O botão que ocultava a lateral foi removido; a navegação permanece como parte
|
|
76
|
+
estrutural da mesa de revisão e se reorganiza acima do palco em telas estreitas.
|
|
77
|
+
- “Revisão limpa” abre uma nova aba com `chrome=0`, preservando a mesa de revisão
|
|
78
|
+
original. O controle invisível de retorno continua disponível em deep links
|
|
79
|
+
recebidos diretamente nesse modo.
|
|
80
|
+
- O seletor global de fixtures saiu da barra inferior. Dados, persona e rede do
|
|
81
|
+
cenário ativo aparecem juntos como escopo na lateral; overrides explícitos por
|
|
82
|
+
URL continuam compatíveis.
|
|
83
|
+
- A seção temporária de controles de acessibilidade saiu da barra inferior. O
|
|
84
|
+
contrato obrigatório, o painel de inspeção e os parâmetros de URL continuam
|
|
85
|
+
disponíveis.
|
|
86
|
+
- Presets de viewport usam ícones derivados do [Lucide](https://lucide.dev/), sob
|
|
87
|
+
licença MIT, incorporados como SVG para não adicionar dependência de runtime.
|
|
88
|
+
- O inspetor ganhou largura, espaçamento e cartões para separar situação,
|
|
89
|
+
reprodução, permissões, ações e critérios.
|
|
90
|
+
|
|
91
|
+
Migração: nenhuma para produtos que usam os seis estados anteriores. Ao trazer
|
|
92
|
+
cenários de um sistema existente sem validação, declare `status: "ported"` e só os
|
|
93
|
+
promova para outro estado quando houver a decisão correspondente.
|
|
94
|
+
|
|
9
95
|
## 0.2.0
|
|
10
96
|
|
|
11
97
|
Hospedagem deixa de ser suposição do motor. Um Design Space que roda só na
|
package/README.md
CHANGED
|
@@ -56,6 +56,32 @@ motor.
|
|
|
56
56
|
projeto: um cenário de ação bloqueada em que o bloqueio não é anunciado para leitor
|
|
57
57
|
de tela está incompleto, não está pronto para aprovação.
|
|
58
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.
|
|
77
|
+
|
|
78
|
+
Na interface, `ported` também fica fora do trabalho ativo por padrão: não aparece
|
|
79
|
+
na home, na árvore de Fluxos, na busca nem nas contagens ativas. A opção discreta
|
|
80
|
+
**Mostrar portados** inclui essas referências e grava `showPorted=1` na URL. Um
|
|
81
|
+
deep link direto continua abrindo um portado com a opção desligada e o mantém
|
|
82
|
+
identificável como item ativo na navegação. O diagnóstico sempre avalia o catálogo
|
|
83
|
+
completo.
|
|
84
|
+
|
|
59
85
|
## A URL é o estado
|
|
60
86
|
|
|
61
87
|
Todo controle é serializado na query string, então a mesma URL sempre produz a
|
|
@@ -65,12 +91,15 @@ rede declarados no cenário.
|
|
|
65
91
|
| Parâmetro | Efeito |
|
|
66
92
|
| --- | --- |
|
|
67
93
|
| `scenario` | Cenário ativo. Define os padrões dos demais. |
|
|
94
|
+
| `component` | Referência ativa no catálogo visual do produto. |
|
|
68
95
|
| `persona` | Troca o papel e as permissões. |
|
|
69
|
-
| `fixture` | Troca
|
|
96
|
+
| `fixture` | Troca a fixture global do cenário ou a fixture local do componente ativo. |
|
|
97
|
+
| `showPorted=1` | Inclui referências portadas na home, navegação, busca e contagens ativas. |
|
|
70
98
|
| `network` | `success`, `loading`, `empty`, `error`, `slow`. |
|
|
71
99
|
| `viewport` | `fit`, `mobile`, `tablet`, `desktop`, `custom`. |
|
|
72
100
|
| `w` | Largura, quando `viewport=custom`. |
|
|
73
101
|
| `theme`, `locale`, `source` | Variações declaradas pelo produto. |
|
|
102
|
+
| `appearance` | Aparência do chrome: omitido para dark, `light` para modo claro. |
|
|
74
103
|
| `chrome=0` | Revisão limpa: oculta o chrome do ambiente. |
|
|
75
104
|
| `kb=1` | Modo teclado, com ordem de tabulação evidenciada. |
|
|
76
105
|
| `motion=1` | Movimento reduzido no palco. |
|
|
@@ -102,6 +131,7 @@ theme: {
|
|
|
102
131
|
```
|
|
103
132
|
|
|
104
133
|
- `DEFAULT_LABELS` — o dicionário completo, em português.
|
|
134
|
+
- `EN_US_LABELS` — o dicionário completo em inglês dos Estados Unidos.
|
|
105
135
|
- `resolveLabels(override)` — mescla por grupo. Útil fora de React.
|
|
106
136
|
- `useLabels()` — os rótulos resolvidos, dentro do chrome.
|
|
107
137
|
- `Labels`, `LabelsOverride` — os tipos.
|
|
@@ -109,14 +139,125 @@ theme: {
|
|
|
109
139
|
Rótulo de **produto** continua vindo do produto: nome de módulo, título de cenário,
|
|
110
140
|
nome de persona, rótulo de fixture.
|
|
111
141
|
|
|
142
|
+
Para usar o chrome integralmente em en-US:
|
|
143
|
+
|
|
144
|
+
```ts
|
|
145
|
+
import { EN_US_LABELS } from "@brucesantos/design-space";
|
|
146
|
+
|
|
147
|
+
const product = {
|
|
148
|
+
// ...
|
|
149
|
+
theme: {
|
|
150
|
+
locales: ["en-US"],
|
|
151
|
+
labels: EN_US_LABELS,
|
|
152
|
+
},
|
|
153
|
+
};
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
### Aparência do chrome
|
|
157
|
+
|
|
158
|
+
O seletor na topbar alterna entre dark e light sem alterar tokens ou tema da UI
|
|
159
|
+
do produto. A escolha é serializada como `?appearance=light`, então links copiados
|
|
160
|
+
e a revisão limpa preservam a aparência escolhida.
|
|
161
|
+
|
|
112
162
|
### Registry e validação
|
|
113
163
|
|
|
114
164
|
- `createRegistry(product)` — índice consultável: busca por vocabulário de
|
|
115
165
|
negócio, árvore de módulos, cobertura por status.
|
|
166
|
+
- `activeScenarios()`, `treeFor()`, `orphansFor()`, `search()` e `coverage()` —
|
|
167
|
+
consultas de trabalho ativo; recebem `{ includePorted: true }` para incluir
|
|
168
|
+
material importado ainda não validado. `tree` e `issues` continuam completos.
|
|
116
169
|
- `validateProduct(product)` / `validateScenario(scenario)` — validação em runtime
|
|
117
170
|
do contrato. Pega fixture, persona, regra ou rota inexistente, que o TypeScript
|
|
118
171
|
não alcança.
|
|
119
172
|
|
|
173
|
+
### Catálogo de componentes
|
|
174
|
+
|
|
175
|
+
O catálogo é opcional. O motor fornece navegação, busca e deep link; cada preview
|
|
176
|
+
continua sendo UI do produto:
|
|
177
|
+
|
|
178
|
+
```tsx
|
|
179
|
+
type ButtonData = {
|
|
180
|
+
label: string;
|
|
181
|
+
disabled?: boolean;
|
|
182
|
+
};
|
|
183
|
+
|
|
184
|
+
function PrimaryButtonPreview({
|
|
185
|
+
fixture,
|
|
186
|
+
data,
|
|
187
|
+
viewport,
|
|
188
|
+
themeMode,
|
|
189
|
+
locale,
|
|
190
|
+
a11y,
|
|
191
|
+
}: ComponentPreviewProps<ButtonData>) {
|
|
192
|
+
return (
|
|
193
|
+
<button disabled={data?.disabled} data-viewport={viewport.id}>
|
|
194
|
+
{data?.label ?? fixture?.label ?? "Botão"}
|
|
195
|
+
</button>
|
|
196
|
+
);
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
const product: ProductDefinition = {
|
|
200
|
+
// ...
|
|
201
|
+
components: [
|
|
202
|
+
{
|
|
203
|
+
id: "actions.primary-button",
|
|
204
|
+
name: "Botão primário",
|
|
205
|
+
group: "Ações",
|
|
206
|
+
description: "Ação principal da página",
|
|
207
|
+
preview: PrimaryButtonPreview,
|
|
208
|
+
defaultFixture: "default",
|
|
209
|
+
fixtures: [
|
|
210
|
+
{
|
|
211
|
+
id: "default",
|
|
212
|
+
label: "Padrão",
|
|
213
|
+
description: "Ação pronta para uso.",
|
|
214
|
+
data: { label: "Continuar" },
|
|
215
|
+
},
|
|
216
|
+
{
|
|
217
|
+
id: "disabled",
|
|
218
|
+
label: "Desabilitado",
|
|
219
|
+
data: () => ({ label: "Continuar", disabled: true }),
|
|
220
|
+
},
|
|
221
|
+
{
|
|
222
|
+
id: "long-content",
|
|
223
|
+
label: "Conteúdo longo",
|
|
224
|
+
data: { label: "Continuar para a próxima etapa do processo" },
|
|
225
|
+
},
|
|
226
|
+
],
|
|
227
|
+
},
|
|
228
|
+
],
|
|
229
|
+
};
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
Abrir o exemplo produz
|
|
233
|
+
`?component=actions.primary-button&fixture=default`; trocar os dados para o
|
|
234
|
+
estado desabilitado produz
|
|
235
|
+
`?component=actions.primary-button&fixture=disabled`. O seletor só aparece quando
|
|
236
|
+
o componente declara fixtures. Se a URL pedir uma fixture inexistente, o preview
|
|
237
|
+
usa `defaultFixture` (ou a primeira fixture) e o painel nomeia o fallback; a URL
|
|
238
|
+
inválida não é descartada silenciosamente.
|
|
239
|
+
|
|
240
|
+
`ComponentPreview`, `ComponentPreviewFixture` e `ComponentPreviewProps` são os
|
|
241
|
+
tipos públicos. Um preview 0.3.0 sem props continua compatível:
|
|
242
|
+
|
|
243
|
+
```tsx
|
|
244
|
+
function StatusPreview() {
|
|
245
|
+
return <StatusBadge status="approved" />;
|
|
246
|
+
}
|
|
247
|
+
```
|
|
248
|
+
|
|
249
|
+
### Três tipos de estado
|
|
250
|
+
|
|
251
|
+
- **Fixture de cenário:** vive em `ProductDefinition.fixtures` e materializa uma
|
|
252
|
+
situação completa, com persona, permissões, regras e intenção.
|
|
253
|
+
- **Fixture de componente:** vive em `ComponentPreview.fixtures`, tem escopo
|
|
254
|
+
somente naquele componente e representa dados como padrão, preenchido, vazio,
|
|
255
|
+
carregando, erro, desabilitado ou conteúdo longo. Não recebe nem simula
|
|
256
|
+
`ScenarioContext`.
|
|
257
|
+
- **Estado interativo local:** modal aberto, checkbox marcado, hover ou foco
|
|
258
|
+
continuam no próprio preview. Não precisam de uma segunda abstração de
|
|
259
|
+
variants.
|
|
260
|
+
|
|
120
261
|
### Deploy e deep links
|
|
121
262
|
|
|
122
263
|
O motor não conhece provedor de hospedagem, e um Design Space que roda só local é
|
|
@@ -128,6 +269,7 @@ omite branch e commit.
|
|
|
128
269
|
ambiente: o motor é biblioteca compilada e não alcança o build de quem o
|
|
129
270
|
consome.
|
|
130
271
|
- `scenarioUrl(scenario, options)` — URL absoluta reproduzível.
|
|
272
|
+
- `componentUrl(component, options)` — URL absoluta do componente com sua fixture.
|
|
131
273
|
- `commitUrl(scenario, { template })` — URL imutável para registrar aprovação. O
|
|
132
274
|
template é do produto, com `{commit}` ou `{shortCommit}`.
|
|
133
275
|
|
|
@@ -163,10 +305,18 @@ preview.
|
|
|
163
305
|
|
|
164
306
|
| Atalho | Efeito |
|
|
165
307
|
| --- | --- |
|
|
166
|
-
| `
|
|
308
|
+
| `Command/Ctrl` + `K` ou `F` | Foco na busca da lateral |
|
|
309
|
+
| `↑` / `↓` | Percorrer resultados filtrados |
|
|
167
310
|
| `Shift` + `K` | Modo teclado |
|
|
168
311
|
| `Shift` + `P` | Painel de contexto |
|
|
169
312
|
|
|
313
|
+
## Créditos
|
|
314
|
+
|
|
315
|
+
Os ícones dos presets de viewport são derivados do
|
|
316
|
+
[Lucide](https://lucide.dev/), disponibilizado sob licença MIT. Obrigado às
|
|
317
|
+
pessoas mantenedoras e contribuidoras do projeto. Os SVGs necessários são
|
|
318
|
+
incorporados ao motor, portanto não existe dependência de runtime do Lucide.
|
|
319
|
+
|
|
170
320
|
## Fronteira
|
|
171
321
|
|
|
172
322
|
O motor **não** contém e não deve conter: componente visual, token, tipografia,
|
|
@@ -0,0 +1,288 @@
|
|
|
1
|
+
const S = [
|
|
2
|
+
"ported",
|
|
3
|
+
"proposed",
|
|
4
|
+
"in-review",
|
|
5
|
+
"approved",
|
|
6
|
+
"in-implementation",
|
|
7
|
+
"implemented",
|
|
8
|
+
"superseded"
|
|
9
|
+
], y = [
|
|
10
|
+
"success",
|
|
11
|
+
"loading",
|
|
12
|
+
"empty",
|
|
13
|
+
"error",
|
|
14
|
+
"slow"
|
|
15
|
+
], w = /^[a-z0-9]+([.\-][a-z0-9]+)*$/;
|
|
16
|
+
function p(e) {
|
|
17
|
+
return typeof e == "string" && e.trim().length > 0;
|
|
18
|
+
}
|
|
19
|
+
function N(e, o) {
|
|
20
|
+
const r = [], t = p(e?.id) ? `scenario:${e.id}` : `scenario[${o ?? "?"}]`, n = (c) => r.push({ level: "error", where: t, message: c }), i = (c) => r.push({ level: "warning", where: t, message: c });
|
|
21
|
+
p(e?.id) ? w.test(e.id) ? e.id.includes(".") || i("`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."), p(e?.title) || n("`title` é obrigatório e deve usar o vocabulário do negócio."), p(e?.route) ? e.route.startsWith("/") || n("`route` deve começar com `/`.") : n("`route` é obrigatório."), p(e?.persona) || n("`persona` é obrigatório."), p(e?.fixture) || n("`fixture` é obrigatório. O padrão do ambiente é dado sintético (D-05)."), S.includes(e?.status) || n(`\`status\` deve ser um de: ${S.join(", ")}.`), e?.network && !y.includes(e.network) && n(`\`network\` deve ser um de: ${y.join(", ")}.`);
|
|
24
|
+
const s = e?.a11y;
|
|
25
|
+
return !s || typeof s != "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(s.keyboard) || n("`a11y.keyboard` deve ser `full`, `partial` ou `not-applicable`."), ["AA", "AAA"].includes(s.contrast) || n("`a11y.contrast` deve ser `AA` ou `AAA`. O padrão interno é WCAG 2.2 AA."), s.announces !== void 0 && !Array.isArray(s.announces) && n("`a11y.announces` deve ser uma lista de chaves de evento de domínio.")), e?.status === "approved" && s?.keyboard === "partial" && i(
|
|
28
|
+
'Cenário aprovado com `a11y.keyboard: "partial"`. Confirme que esta jornada não é crítica.'
|
|
29
|
+
), e?.status === "approved" && !e.approvedAt && i(
|
|
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 || i(
|
|
32
|
+
"Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater)."
|
|
33
|
+
), r;
|
|
34
|
+
}
|
|
35
|
+
function F(e) {
|
|
36
|
+
const o = [], r = (u, a, d) => o.push({ level: u, where: a, message: d }), t = new Set(e.personas?.map((u) => u.id) ?? []), n = new Set(e.fixtures?.map((u) => u.id) ?? []), i = new Set(e.rules?.map((u) => u.id) ?? []), s = new Set(e.modules?.map((u) => u.id) ?? []), c = /* @__PURE__ */ new Set();
|
|
37
|
+
p(e.id) || r("error", "product", "`id` é obrigatório."), p(e.name) || r("error", "product", "`name` é obrigatório."), e.routes?.length || r("error", "product", "`routes` está vazio: nenhum cenário conseguirá renderizar.");
|
|
38
|
+
const m = /* @__PURE__ */ new Set();
|
|
39
|
+
for (const [u, a] of (e.components ?? []).entries()) {
|
|
40
|
+
const d = `component:${a?.id ?? u}`;
|
|
41
|
+
p(a?.id) ? w.test(a.id) ? m.has(a.id) ? r("error", d, `\`id\` duplicado: ${a.id}.`) : m.add(a.id) : r("error", d, "`id` deve ser minúsculo em kebab-case ou usar pontos para agrupamento.") : r("error", d, "`id` é obrigatório."), p(a?.name) || r("error", d, "`name` é obrigatório."), typeof a?.preview != "function" && r("error", d, "`preview` é obrigatório.");
|
|
42
|
+
const l = /* @__PURE__ */ new Set();
|
|
43
|
+
for (const [x, f] of (a?.fixtures ?? []).entries()) {
|
|
44
|
+
const v = `${d}/fixture:${f?.id ?? x}`;
|
|
45
|
+
p(f?.id) ? w.test(f.id) ? l.has(f.id) ? r("error", v, `Id de fixture do componente duplicado: \`${f.id}\`.`) : l.add(f.id) : r(
|
|
46
|
+
"error",
|
|
47
|
+
v,
|
|
48
|
+
`Id de fixture do componente inválido: \`${f.id}\`. Use minúsculas em kebab-case.`
|
|
49
|
+
) : r("error", v, "`id` da fixture do componente é obrigatório."), p(f?.label) || r("error", v, "`label` da fixture do componente é obrigatório."), (!f || !("data" in f)) && r("error", v, "`data` da fixture do componente é obrigatório.");
|
|
50
|
+
}
|
|
51
|
+
a?.defaultFixture && !l.has(a.defaultFixture) && r(
|
|
52
|
+
"error",
|
|
53
|
+
d,
|
|
54
|
+
`\`defaultFixture\` aponta para fixture inexistente: \`${a.defaultFixture}\`.`
|
|
55
|
+
);
|
|
56
|
+
}
|
|
57
|
+
for (const [u, a] of (e.scenarios ?? []).entries()) {
|
|
58
|
+
o.push(...N(a, u));
|
|
59
|
+
const d = `scenario:${a?.id ?? u}`;
|
|
60
|
+
if (a?.id) {
|
|
61
|
+
c.has(a.id) && r("error", d, `\`id\` duplicado: ${a.id}.`), c.add(a.id);
|
|
62
|
+
const l = a.id.split(".")[0];
|
|
63
|
+
l && s.size > 0 && !s.has(l) && r(
|
|
64
|
+
"warning",
|
|
65
|
+
d,
|
|
66
|
+
`Prefixo \`${l}\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
a?.persona && !t.has(a.persona) && r("error", d, `Persona não registrada: \`${a.persona}\`.`), a?.fixture && !n.has(a.fixture) && r("error", d, `Fixture não registrada: \`${a.fixture}\`.`);
|
|
70
|
+
for (const l of a?.rules ?? [])
|
|
71
|
+
i.has(l) || r("error", d, `Regra não registrada: \`${l}\`.`);
|
|
72
|
+
a?.route && !C(a.route, e) && r(
|
|
73
|
+
"error",
|
|
74
|
+
d,
|
|
75
|
+
`Rota \`${a.route}\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`
|
|
76
|
+
);
|
|
77
|
+
}
|
|
78
|
+
for (const u of e.modules ?? [])
|
|
79
|
+
for (const a of u.flows ?? []) {
|
|
80
|
+
const d = `flow:${u.id}/${a.id}`;
|
|
81
|
+
a.steps?.length || r("warning", d, "Jornada sem passos.");
|
|
82
|
+
for (const l of a.steps ?? []) {
|
|
83
|
+
c.has(l.scenario) || r("error", d, `Passo aponta para cenário inexistente: \`${l.scenario}\`.`);
|
|
84
|
+
for (const [x, f] of Object.entries(l.branches ?? {}))
|
|
85
|
+
c.has(f) || r(
|
|
86
|
+
"error",
|
|
87
|
+
d,
|
|
88
|
+
`Ramificação "${x}" aponta para cenário inexistente: \`${f}\`.`
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
const h = e.dataSources?.default;
|
|
93
|
+
return h && h !== "fixtures" && (new Set(e.dataSources?.adapters?.map((a) => a.id) ?? []).has(h) || r("error", "product", `\`dataSources.default\` aponta para adapter inexistente: \`${h}\`.`), r(
|
|
94
|
+
"warning",
|
|
95
|
+
"product",
|
|
96
|
+
"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."
|
|
97
|
+
)), o;
|
|
98
|
+
}
|
|
99
|
+
function C(e, o) {
|
|
100
|
+
const r = e.split("?")[0] ?? e;
|
|
101
|
+
return (o.routes ?? []).some((t) => I(t.path, r));
|
|
102
|
+
}
|
|
103
|
+
function I(e, o) {
|
|
104
|
+
const r = e.split("/").filter(Boolean), t = o.split("/").filter(Boolean);
|
|
105
|
+
for (const [n, i] of r.entries()) {
|
|
106
|
+
if (i === "*") return !0;
|
|
107
|
+
const s = t[n];
|
|
108
|
+
if (s === void 0) return !1;
|
|
109
|
+
if (!i.startsWith(":") && i !== s)
|
|
110
|
+
return !1;
|
|
111
|
+
}
|
|
112
|
+
return r.length === t.length;
|
|
113
|
+
}
|
|
114
|
+
function L(e) {
|
|
115
|
+
return e.some((o) => o.level === "error");
|
|
116
|
+
}
|
|
117
|
+
function M(e) {
|
|
118
|
+
return e.length === 0 ? "Nenhum problema encontrado." : e.map((o) => `${o.level === "error" ? "✖" : "▲"} ${o.where}
|
|
119
|
+
${o.message}`).join(`
|
|
120
|
+
`);
|
|
121
|
+
}
|
|
122
|
+
const g = {
|
|
123
|
+
scenario: "scenario",
|
|
124
|
+
showPorted: "showPorted",
|
|
125
|
+
component: "component",
|
|
126
|
+
persona: "persona",
|
|
127
|
+
fixture: "fixture",
|
|
128
|
+
network: "network",
|
|
129
|
+
viewport: "viewport",
|
|
130
|
+
customWidth: "w",
|
|
131
|
+
themeMode: "theme",
|
|
132
|
+
locale: "locale",
|
|
133
|
+
dataSource: "source",
|
|
134
|
+
chromeTheme: "appearance",
|
|
135
|
+
chrome: "chrome",
|
|
136
|
+
keyboardMode: "kb",
|
|
137
|
+
reducedMotion: "motion",
|
|
138
|
+
textScale: "scale",
|
|
139
|
+
inspector: "panel"
|
|
140
|
+
};
|
|
141
|
+
function R(e) {
|
|
142
|
+
return typeof e == "boolean" ? e ? "1" : "0" : String(e);
|
|
143
|
+
}
|
|
144
|
+
function P(e, o = {}) {
|
|
145
|
+
for (const [r, t] of Object.entries(o)) {
|
|
146
|
+
if (t == null) continue;
|
|
147
|
+
const n = g[r];
|
|
148
|
+
n && e.set(n, R(t));
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
function $(e = {}) {
|
|
152
|
+
const o = e.branchUrl || void 0, r = e.deploymentUrl || void 0, t = e.commit || void 0, n = e.env || "development", i = o && `https://${o}` || r && `https://${r}` || (typeof window < "u" ? window.location.origin : "http://localhost:5173");
|
|
153
|
+
return {
|
|
154
|
+
env: n,
|
|
155
|
+
origin: i.replace(/\/$/, ""),
|
|
156
|
+
branchUrl: o,
|
|
157
|
+
deploymentUrl: r,
|
|
158
|
+
branch: e.branch || void 0,
|
|
159
|
+
commit: t,
|
|
160
|
+
shortCommit: t?.slice(0, 7),
|
|
161
|
+
isDeployed: n === "preview" || n === "production"
|
|
162
|
+
};
|
|
163
|
+
}
|
|
164
|
+
function O(e, o = {}) {
|
|
165
|
+
const r = o.origin ?? $().origin, t = new URL(e.route, r);
|
|
166
|
+
return t.searchParams.set(g.scenario, e.id), t.searchParams.set(g.persona, e.persona), t.searchParams.set(g.fixture, e.fixture), e.network && e.network !== "success" && t.searchParams.set(g.network, e.network), P(t.searchParams, o.overrides), t.toString();
|
|
167
|
+
}
|
|
168
|
+
function W(e, o = {}) {
|
|
169
|
+
const r = o.origin ?? $().origin, t = new URL("/", r), n = o.fixture ?? e.fixtures?.find((i) => i.id === e.defaultFixture)?.id ?? e.fixtures?.[0]?.id;
|
|
170
|
+
return t.searchParams.set(g.component, e.id), n && t.searchParams.set(g.fixture, n), P(t.searchParams, o.overrides), t.toString();
|
|
171
|
+
}
|
|
172
|
+
function z(e, o) {
|
|
173
|
+
const r = o.commit ?? $().commit;
|
|
174
|
+
if (!r) return;
|
|
175
|
+
const t = o.template.replaceAll("{shortCommit}", r.slice(0, 7)).replaceAll("{commit}", r);
|
|
176
|
+
return O(e, { origin: t });
|
|
177
|
+
}
|
|
178
|
+
const k = {
|
|
179
|
+
AA: { normal: 4.5, large: 3 },
|
|
180
|
+
AAA: { normal: 7, large: 4.5 }
|
|
181
|
+
}, T = {
|
|
182
|
+
white: "#ffffff",
|
|
183
|
+
black: "#000000",
|
|
184
|
+
transparent: "#00000000"
|
|
185
|
+
};
|
|
186
|
+
function A(e) {
|
|
187
|
+
const o = e.trim().toLowerCase(), r = T[o];
|
|
188
|
+
if (r) return A(r);
|
|
189
|
+
if (o.startsWith("#")) {
|
|
190
|
+
const n = o.slice(1), i = (s) => Number.parseInt(s.repeat(2), 16);
|
|
191
|
+
if (n.length === 3 || n.length === 4) {
|
|
192
|
+
const [s, c, m, h] = [...n];
|
|
193
|
+
return !s || !c || !m ? void 0 : { r: i(s), g: i(c), b: i(m), a: h ? i(h) / 255 : 1 };
|
|
194
|
+
}
|
|
195
|
+
if (n.length === 6 || n.length === 8) {
|
|
196
|
+
const s = (m) => Number.parseInt(n.slice(m, m + 2), 16), c = [s(0), s(2), s(4)];
|
|
197
|
+
return c.some(Number.isNaN) ? void 0 : {
|
|
198
|
+
r: c[0],
|
|
199
|
+
g: c[1],
|
|
200
|
+
b: c[2],
|
|
201
|
+
a: n.length === 8 ? s(6) / 255 : 1
|
|
202
|
+
};
|
|
203
|
+
}
|
|
204
|
+
return;
|
|
205
|
+
}
|
|
206
|
+
const t = o.match(/^rgba?\(([^)]+)\)$/);
|
|
207
|
+
if (t?.[1]) {
|
|
208
|
+
const n = t[1].split(/[\s,/]+/).filter(Boolean), [i, s, c, m] = n.map(Number);
|
|
209
|
+
return [i, s, c].some((h) => h === void 0 || Number.isNaN(h)) ? void 0 : { r: i, g: s, b: c, a: m === void 0 || Number.isNaN(m) ? 1 : m };
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
function U(e, o) {
|
|
213
|
+
if (e.a >= 1) return e;
|
|
214
|
+
const r = (t, n) => t * e.a + n * (1 - e.a);
|
|
215
|
+
return {
|
|
216
|
+
r: r(e.r, o.r),
|
|
217
|
+
g: r(e.g, o.g),
|
|
218
|
+
b: r(e.b, o.b),
|
|
219
|
+
a: 1
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
function b({ r: e, g: o, b: r }) {
|
|
223
|
+
const t = (n) => {
|
|
224
|
+
const i = n / 255;
|
|
225
|
+
return i <= 0.03928 ? i / 12.92 : ((i + 0.055) / 1.055) ** 2.4;
|
|
226
|
+
};
|
|
227
|
+
return 0.2126 * t(e) + 0.7152 * t(o) + 0.0722 * t(r);
|
|
228
|
+
}
|
|
229
|
+
function j(e, o) {
|
|
230
|
+
const r = A(o), t = A(e);
|
|
231
|
+
if (!r || !t) return;
|
|
232
|
+
const n = U(t, r), i = Math.max(b(n), b(r)), s = Math.min(b(n), b(r));
|
|
233
|
+
return (i + 0.05) / (s + 0.05);
|
|
234
|
+
}
|
|
235
|
+
function E(e) {
|
|
236
|
+
const o = e.target ?? "AA", r = e.largeText ? k[o].large : k[o].normal, t = j(e.foreground, e.background);
|
|
237
|
+
return {
|
|
238
|
+
pair: e,
|
|
239
|
+
target: o,
|
|
240
|
+
ratio: t,
|
|
241
|
+
required: r,
|
|
242
|
+
passes: t === void 0 ? void 0 : t >= r,
|
|
243
|
+
label: t === void 0 ? "não medido" : `${t.toFixed(2)}:1`
|
|
244
|
+
};
|
|
245
|
+
}
|
|
246
|
+
function D(e = []) {
|
|
247
|
+
return e.map(E);
|
|
248
|
+
}
|
|
249
|
+
function q(e) {
|
|
250
|
+
const o = D(e).filter((t) => t.passes !== !0);
|
|
251
|
+
if (o.length === 0) return;
|
|
252
|
+
const r = o.map(
|
|
253
|
+
(t) => ` ✖ ${t.pair.name}: ${t.label} (mínimo ${t.required}:1 para ${t.target}${t.pair.largeText ? ", texto grande" : ""})`
|
|
254
|
+
).join(`
|
|
255
|
+
`);
|
|
256
|
+
throw new Error(`Pares de contraste fora do alvo:
|
|
257
|
+
${r}`);
|
|
258
|
+
}
|
|
259
|
+
function _(e, o) {
|
|
260
|
+
if (typeof window > "u") return;
|
|
261
|
+
const r = o ?? document.documentElement;
|
|
262
|
+
return window.getComputedStyle(r).getPropertyValue(e).trim() || void 0;
|
|
263
|
+
}
|
|
264
|
+
export {
|
|
265
|
+
k as C,
|
|
266
|
+
y as N,
|
|
267
|
+
g as P,
|
|
268
|
+
S,
|
|
269
|
+
P as a,
|
|
270
|
+
q as b,
|
|
271
|
+
D as c,
|
|
272
|
+
E as d,
|
|
273
|
+
z as e,
|
|
274
|
+
W as f,
|
|
275
|
+
$ as g,
|
|
276
|
+
j as h,
|
|
277
|
+
U as i,
|
|
278
|
+
M as j,
|
|
279
|
+
L as k,
|
|
280
|
+
b as l,
|
|
281
|
+
R as m,
|
|
282
|
+
N as n,
|
|
283
|
+
A as p,
|
|
284
|
+
_ as r,
|
|
285
|
+
O as s,
|
|
286
|
+
F as v
|
|
287
|
+
};
|
|
288
|
+
//# sourceMappingURL=contrast-B8I8gWGa.js.map
|