@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 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. No Bloomy isso
99
- deslocava a data de nascimento, o cálculo de idade e portanto a regra do paciente
100
- menor de idade; na Finaya, errava o vencimento da cobrança por um dia. Os dois
101
- produtos escreveram a mesma correção separadamente, sem saber um do outro.
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á em
107
- `finaya-design-space/docs/decisions/0001`. A régua para a próxima extração:
108
- **dois produtos, zero aparência, zero domínio.**
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 insuranceDenied: Scenario = {
36
- id: "finance.insurance-denied",
37
- title: "Convênio recusado",
38
- route: "/finance/claims/CLM-1042",
39
- persona: "financial-analyst",
40
- permissions: ["claims.read", "claims.retry"],
41
- fixture: "claim-denied-unimed",
42
- rules: ["retry-after-document-review"],
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: ["claim.status", "retry.result"],
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 convênio recusado em que a recusa não é anunciada para
54
- leitor de tela está incompleto, não está pronto para aprovação.
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
- - `getDeployContext()` — lê o contexto da Vercel: branch, commit, ambiente,
97
- origem absoluta.
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, options)` — URL imutável para registrar aprovação.
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`, que o gatilho `deployment_status`
124
- entrega pronto.
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
- | `Shift` + `C` | Chrome do ambiente |
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 Bloomy e Finaya
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