@brucesantos/design-space 0.1.1 → 0.2.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 +93 -7
- package/README.md +55 -18
- package/dist/contrast-BXd_acxo.js +260 -0
- package/dist/contrast-BXd_acxo.js.map +1 -0
- package/dist/deploy/index.d.ts +16 -11
- package/dist/index.d.ts +1 -1
- package/dist/index.js +864 -762
- package/dist/index.js.map +1 -1
- package/dist/registry/index.d.ts +1 -1
- package/dist/registry/validate.d.ts +1 -1
- package/dist/router/index.d.ts +2 -2
- package/dist/shell/labels.d.ts +135 -0
- package/dist/testing.js +2 -2
- package/dist/types/index.d.ts +36 -21
- package/dist/util/date.d.ts +3 -4
- package/package.json +2 -2
- package/dist/contrast-DsgJg12D.js +0 -265
- package/dist/contrast-DsgJg12D.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.2.0
|
|
10
|
+
|
|
11
|
+
Hospedagem deixa de ser suposição do motor. Um Design Space que roda só na
|
|
12
|
+
máquina de quem desenha passa a ser caso suportado e documentado, não um caso
|
|
13
|
+
degradado de um modelo que pressupõe um fornecedor.
|
|
14
|
+
|
|
15
|
+
### Alterado (incompatível)
|
|
16
|
+
|
|
17
|
+
- **`commitUrl` recebe um template de URL em vez de projeto e escopo.** O formato
|
|
18
|
+
do endereço é de quem hospeda, não do motor.
|
|
19
|
+
|
|
20
|
+
```ts
|
|
21
|
+
// 0.1.x
|
|
22
|
+
commitUrl(scenario, { project: "acme", scope: "time" });
|
|
23
|
+
|
|
24
|
+
// 0.2.0
|
|
25
|
+
commitUrl(scenario, { template: "https://acme-{shortCommit}-time.example.app" });
|
|
26
|
+
commitUrl(scenario, { template: "https://{commit}.review.acme.dev" });
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
`{commit}` e `{shortCommit}` são substituídos. Sem commit a função continua
|
|
30
|
+
devolvendo `undefined`, porque aprovação sem commit não é rastreável.
|
|
31
|
+
|
|
32
|
+
Migração: nenhum produto usava a função. Se o seu usa, monte o template com o
|
|
33
|
+
endereço que o seu host produz.
|
|
34
|
+
|
|
35
|
+
- **`getDeployContext` não lê mais variável de ambiente.** O contexto vem só de
|
|
36
|
+
`ProductDefinition.deploy`. A leitura anterior de `import.meta.env` e
|
|
37
|
+
`process.env` era inócua em produto real — o motor é biblioteca compilada, o
|
|
38
|
+
`import.meta.env` dele foi resolvido no build do pacote (ver 0.1.1) — então na
|
|
39
|
+
prática nada muda para quem já informava o campo `deploy`. Quem dependia da
|
|
40
|
+
detecção automática nunca teve detecção.
|
|
41
|
+
|
|
42
|
+
Campo vazio agora é tratado como ausente: `branch: ""`, que é o que um `define`
|
|
43
|
+
de bundler produz quando a variável não existe, deixa de virar um rótulo vazio
|
|
44
|
+
no cabeçalho da revisão.
|
|
45
|
+
|
|
46
|
+
### Adicionado
|
|
47
|
+
|
|
48
|
+
- **`theme.labels`: o chrome deixa de ser fixo em português.** Todo rótulo de
|
|
49
|
+
mecanismo — status, estado de rede, viewport, botão, aba, mensagem do painel —
|
|
50
|
+
vive em `DEFAULT_LABELS` e pode ser sobrescrito por grupo:
|
|
51
|
+
|
|
52
|
+
```ts
|
|
53
|
+
theme: {
|
|
54
|
+
labels: {
|
|
55
|
+
status: { approved: "Approved", "in-review": "In review" },
|
|
56
|
+
topbar: { copyLink: "Copy link" },
|
|
57
|
+
},
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
O que não for declarado fica no padrão. Novos exports: `DEFAULT_LABELS`,
|
|
62
|
+
`resolveLabels`, `useLabels`, `Labels`, `LabelsOverride`. `STATUS_LABELS`,
|
|
63
|
+
`STATUS_MEANING`, `NETWORK_LABELS` e `KEYBOARD_LABELS` continuam exportados,
|
|
64
|
+
agora como atalhos para os grupos de `DEFAULT_LABELS`.
|
|
65
|
+
|
|
66
|
+
O motivo: o chrome divide a tela com a UI do cliente. Um Design Space revisado
|
|
67
|
+
em inglês misturava "Em revisão" e "Copiar link" com a interface dele, e
|
|
68
|
+
traduzir só os status seria pior que não traduzir.
|
|
69
|
+
|
|
70
|
+
- **Trava de fronteira de hospedagem** (`src/deploy/hosting.test.ts`): reprova o
|
|
71
|
+
build se qualquer arquivo do motor citar um provedor, ou se `deploy/index.ts`
|
|
72
|
+
voltar a ler ambiente. No mesmo espírito da trava de fronteira visual.
|
|
73
|
+
|
|
74
|
+
- **Trava de idioma** (`src/shell/labels.test.ts`): reprova o build quando um
|
|
75
|
+
componente do chrome tem texto visível fixo — nó de texto, `aria-label`,
|
|
76
|
+
`title` ou `placeholder`. Sem ela, o próximo rótulo nasce no JSX e volta a ser
|
|
77
|
+
intraduzível.
|
|
78
|
+
|
|
79
|
+
- **Trava de vocabulário** (`src/shell/boundary.test.ts`): reprova o build se o
|
|
80
|
+
motor nomear um cliente.
|
|
81
|
+
|
|
82
|
+
### Corrigido
|
|
83
|
+
|
|
84
|
+
- **O motor não carrega mais o domínio dos primeiros clientes.** Comentários,
|
|
85
|
+
exemplos de JSDoc e fixtures de teste usavam o vocabulário do setor de um
|
|
86
|
+
cliente, inclusive o exemplo do README deste pacote. Nada disso tinha efeito em
|
|
87
|
+
runtime; o efeito era outro, e caro: um agente que lê esses arquivos conclui que
|
|
88
|
+
o motor serve a um setor e escreve como se fosse. Os exemplos passaram a usar
|
|
89
|
+
vocabulário genérico — solicitação, aprovação, cobrança.
|
|
90
|
+
|
|
91
|
+
- **Testes do módulo de deploy** (`src/deploy/deploy.test.ts`), que não existiam:
|
|
92
|
+
contexto local sem hospedagem, precedência do que o produto informa, string
|
|
93
|
+
vazia como ausente e substituição no template de aprovação.
|
|
94
|
+
|
|
9
95
|
## 0.1.1
|
|
10
96
|
|
|
11
97
|
### Corrigido
|
|
@@ -95,14 +181,14 @@ Primeira versão do motor. Fase 1 do roadmap.
|
|
|
95
181
|
carrega aparência e não carrega domínio.
|
|
96
182
|
|
|
97
183
|
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
|
-
|
|
184
|
+
qualquer fuso a oeste de Greenwich, exibe o dia anterior. Em um produto isso
|
|
185
|
+
deslocava uma data de nascimento e, com ela, a idade calculada e uma regra que
|
|
186
|
+
dependia da idade; em outro, errava um vencimento por um dia. Os dois produtos
|
|
187
|
+
escreveram a mesma correção separadamente, sem saber um do outro.
|
|
102
188
|
|
|
103
189
|
`ageInYears` exige a data de referência como parâmetro obrigatório de propósito:
|
|
104
190
|
um padrão `new Date()` faria fixture depender do relógio.
|
|
105
191
|
|
|
106
|
-
O que **não** foi extraído, e por quê, está
|
|
107
|
-
|
|
108
|
-
|
|
192
|
+
O que **não** foi extraído, e por quê, está registrado no repositório do segundo
|
|
193
|
+
produto. A régua para a próxima extração: **dois produtos, zero aparência, zero
|
|
194
|
+
domínio.**
|
package/README.md
CHANGED
|
@@ -32,26 +32,29 @@ 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.
|
|
55
58
|
|
|
56
59
|
## A URL é o estado
|
|
57
60
|
|
|
@@ -83,6 +86,29 @@ rede declarados no cenário.
|
|
|
83
86
|
- `Stage`, `StageEmpty`, `TabOrderOverlay` — partes do palco, expostas para casos
|
|
84
87
|
fora do padrão.
|
|
85
88
|
|
|
89
|
+
### Rótulos do chrome
|
|
90
|
+
|
|
91
|
+
O chrome vem em português por padrão e é traduzível pelo produto, por grupo. O que
|
|
92
|
+
não for declarado fica no padrão.
|
|
93
|
+
|
|
94
|
+
```ts
|
|
95
|
+
theme: {
|
|
96
|
+
labels: {
|
|
97
|
+
status: { approved: "Approved", "in-review": "In review" },
|
|
98
|
+
topbar: { copyLink: "Copy link" },
|
|
99
|
+
home: { lead: (total) => `${total} scenarios, each one a link.` },
|
|
100
|
+
},
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
- `DEFAULT_LABELS` — o dicionário completo, em português.
|
|
105
|
+
- `resolveLabels(override)` — mescla por grupo. Útil fora de React.
|
|
106
|
+
- `useLabels()` — os rótulos resolvidos, dentro do chrome.
|
|
107
|
+
- `Labels`, `LabelsOverride` — os tipos.
|
|
108
|
+
|
|
109
|
+
Rótulo de **produto** continua vindo do produto: nome de módulo, título de cenário,
|
|
110
|
+
nome de persona, rótulo de fixture.
|
|
111
|
+
|
|
86
112
|
### Registry e validação
|
|
87
113
|
|
|
88
114
|
- `createRegistry(product)` — índice consultável: busca por vocabulário de
|
|
@@ -93,10 +119,17 @@ rede declarados no cenário.
|
|
|
93
119
|
|
|
94
120
|
### Deploy e deep links
|
|
95
121
|
|
|
96
|
-
|
|
97
|
-
|
|
122
|
+
O motor não conhece provedor de hospedagem, e um Design Space que roda só local é
|
|
123
|
+
caso suportado: sem contexto, o ambiente é `development` e o cabeçalho da revisão
|
|
124
|
+
omite branch e commit.
|
|
125
|
+
|
|
126
|
+
- `getDeployContext(overrides)` — monta branch, commit, ambiente e origem absoluta
|
|
127
|
+
a partir do que o produto informou em `ProductDefinition.deploy`. Não lê
|
|
128
|
+
ambiente: o motor é biblioteca compilada e não alcança o build de quem o
|
|
129
|
+
consome.
|
|
98
130
|
- `scenarioUrl(scenario, options)` — URL absoluta reproduzível.
|
|
99
|
-
- `commitUrl(scenario,
|
|
131
|
+
- `commitUrl(scenario, { template })` — URL imutável para registrar aprovação. O
|
|
132
|
+
template é do produto, com `{commit}` ou `{shortCommit}`.
|
|
100
133
|
|
|
101
134
|
### Dados
|
|
102
135
|
|
|
@@ -120,8 +153,8 @@ preview.
|
|
|
120
153
|
|
|
121
154
|
- `pathFor(scenario, overrides)` — caminho relativo para `page.goto`, deixando o
|
|
122
155
|
`baseURL` do Playwright decidir entre preview e dev server.
|
|
123
|
-
- `testOrigin(fallback)` — lê `PREVIEW_URL
|
|
124
|
-
|
|
156
|
+
- `testOrigin(fallback)` — lê `PREVIEW_URL` quando existe um ambiente publicado
|
|
157
|
+
para testar; sem ela, o Playwright roda contra o dev server local.
|
|
125
158
|
- `assertValidProduct(product)` — falha o teste quando o contrato tem erro.
|
|
126
159
|
- `scenariosUnderTest(product)`, `keyboardScenarios(product)` — recortes para
|
|
127
160
|
parametrizar jornadas.
|
|
@@ -138,8 +171,12 @@ preview.
|
|
|
138
171
|
|
|
139
172
|
O motor **não** contém e não deve conter: componente visual, token, tipografia,
|
|
140
173
|
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.
|
|
174
|
+
Isso é exclusivo de cada produto — e é o que permite que dois produtos sobre o
|
|
175
|
+
mesmo motor continuem parecendo produtos distintos.
|
|
176
|
+
|
|
177
|
+
Três coisas que também não pertencem ao motor, cada uma travada por teste:
|
|
178
|
+
provedor de hospedagem, texto visível fixo em componente do chrome e nome de
|
|
179
|
+
cliente em exemplo.
|
|
143
180
|
|
|
144
181
|
## Licença
|
|
145
182
|
|
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
const b = [
|
|
2
|
+
"proposed",
|
|
3
|
+
"in-review",
|
|
4
|
+
"approved",
|
|
5
|
+
"in-implementation",
|
|
6
|
+
"implemented",
|
|
7
|
+
"superseded"
|
|
8
|
+
], w = [
|
|
9
|
+
"success",
|
|
10
|
+
"loading",
|
|
11
|
+
"empty",
|
|
12
|
+
"error",
|
|
13
|
+
"slow"
|
|
14
|
+
], $ = /^[a-z0-9]+([.\-][a-z0-9]+)*$/;
|
|
15
|
+
function m(e) {
|
|
16
|
+
return typeof e == "string" && e.trim().length > 0;
|
|
17
|
+
}
|
|
18
|
+
function y(e, o) {
|
|
19
|
+
const t = [], r = m(e?.id) ? `scenario:${e.id}` : `scenario[${o ?? "?"}]`, a = (d) => t.push({ level: "error", where: r, message: d }), i = (d) => t.push({ level: "warning", where: r, message: d });
|
|
20
|
+
m(e?.id) ? $.test(e.id) ? e.id.includes(".") || i("`id` sem prefixo de módulo dificulta a navegação e a busca do agente.") : a(
|
|
21
|
+
"`id` deve ser minúsculo em kebab-case, com o módulo como prefixo: `requests.approve-blocked`."
|
|
22
|
+
) : a("`id` é obrigatório."), m(e?.title) || a("`title` é obrigatório e deve usar o vocabulário do negócio."), m(e?.route) ? e.route.startsWith("/") || a("`route` deve começar com `/`.") : a("`route` é obrigatório."), m(e?.persona) || a("`persona` é obrigatório."), m(e?.fixture) || a("`fixture` é obrigatório. O padrão do ambiente é dado sintético (D-05)."), b.includes(e?.status) || a(`\`status\` deve ser um de: ${b.join(", ")}.`), e?.network && !w.includes(e.network) && a(`\`network\` deve ser um de: ${w.join(", ")}.`);
|
|
23
|
+
const n = e?.a11y;
|
|
24
|
+
return !n || typeof n != "object" ? a(
|
|
25
|
+
"`a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de projeto (D-15)."
|
|
26
|
+
) : (["full", "partial", "not-applicable"].includes(n.keyboard) || a("`a11y.keyboard` deve ser `full`, `partial` ou `not-applicable`."), ["AA", "AAA"].includes(n.contrast) || a("`a11y.contrast` deve ser `AA` ou `AAA`. O padrão interno é WCAG 2.2 AA."), n.announces !== void 0 && !Array.isArray(n.announces) && a("`a11y.announces` deve ser uma lista de chaves de evento de domínio.")), e?.status === "approved" && n?.keyboard === "partial" && i(
|
|
27
|
+
'Cenário aprovado com `a11y.keyboard: "partial"`. Confirme que esta jornada não é crítica.'
|
|
28
|
+
), e?.status === "approved" && !e.approvedAt && i(
|
|
29
|
+
"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."
|
|
30
|
+
), e?.expected?.length || i(
|
|
31
|
+
"Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater)."
|
|
32
|
+
), t;
|
|
33
|
+
}
|
|
34
|
+
function U(e) {
|
|
35
|
+
const o = [], t = (c, s, u) => o.push({ level: c, where: s, message: u }), r = new Set(e.personas?.map((c) => c.id) ?? []), a = new Set(e.fixtures?.map((c) => c.id) ?? []), i = new Set(e.rules?.map((c) => c.id) ?? []), n = new Set(e.modules?.map((c) => c.id) ?? []), d = /* @__PURE__ */ new Set();
|
|
36
|
+
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.");
|
|
37
|
+
for (const [c, s] of (e.scenarios ?? []).entries()) {
|
|
38
|
+
o.push(...y(s, c));
|
|
39
|
+
const u = `scenario:${s?.id ?? c}`;
|
|
40
|
+
if (s?.id) {
|
|
41
|
+
d.has(s.id) && t("error", u, `\`id\` duplicado: ${s.id}.`), d.add(s.id);
|
|
42
|
+
const f = s.id.split(".")[0];
|
|
43
|
+
f && n.size > 0 && !n.has(f) && t(
|
|
44
|
+
"warning",
|
|
45
|
+
u,
|
|
46
|
+
`Prefixo \`${f}\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`
|
|
47
|
+
);
|
|
48
|
+
}
|
|
49
|
+
s?.persona && !r.has(s.persona) && t("error", u, `Persona não registrada: \`${s.persona}\`.`), s?.fixture && !a.has(s.fixture) && t("error", u, `Fixture não registrada: \`${s.fixture}\`.`);
|
|
50
|
+
for (const f of s?.rules ?? [])
|
|
51
|
+
i.has(f) || t("error", u, `Regra não registrada: \`${f}\`.`);
|
|
52
|
+
s?.route && !k(s.route, e) && t(
|
|
53
|
+
"error",
|
|
54
|
+
u,
|
|
55
|
+
`Rota \`${s.route}\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`
|
|
56
|
+
);
|
|
57
|
+
}
|
|
58
|
+
for (const c of e.modules ?? [])
|
|
59
|
+
for (const s of c.flows ?? []) {
|
|
60
|
+
const u = `flow:${c.id}/${s.id}`;
|
|
61
|
+
s.steps?.length || t("warning", u, "Jornada sem passos.");
|
|
62
|
+
for (const f of s.steps ?? []) {
|
|
63
|
+
d.has(f.scenario) || t("error", u, `Passo aponta para cenário inexistente: \`${f.scenario}\`.`);
|
|
64
|
+
for (const [S, v] of Object.entries(f.branches ?? {}))
|
|
65
|
+
d.has(v) || t(
|
|
66
|
+
"error",
|
|
67
|
+
u,
|
|
68
|
+
`Ramificação "${S}" aponta para cenário inexistente: \`${v}\`.`
|
|
69
|
+
);
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
const l = e.dataSources?.default;
|
|
73
|
+
return l && l !== "fixtures" && (new Set(e.dataSources?.adapters?.map((s) => s.id) ?? []).has(l) || t("error", "product", `\`dataSources.default\` aponta para adapter inexistente: \`${l}\`.`), t(
|
|
74
|
+
"warning",
|
|
75
|
+
"product",
|
|
76
|
+
"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."
|
|
77
|
+
)), o;
|
|
78
|
+
}
|
|
79
|
+
function k(e, o) {
|
|
80
|
+
const t = e.split("?")[0] ?? e;
|
|
81
|
+
return (o.routes ?? []).some((r) => N(r.path, t));
|
|
82
|
+
}
|
|
83
|
+
function N(e, o) {
|
|
84
|
+
const t = e.split("/").filter(Boolean), r = o.split("/").filter(Boolean);
|
|
85
|
+
for (const [a, i] of t.entries()) {
|
|
86
|
+
if (i === "*") return !0;
|
|
87
|
+
const n = r[a];
|
|
88
|
+
if (n === void 0) return !1;
|
|
89
|
+
if (!i.startsWith(":") && i !== n)
|
|
90
|
+
return !1;
|
|
91
|
+
}
|
|
92
|
+
return t.length === r.length;
|
|
93
|
+
}
|
|
94
|
+
function D(e) {
|
|
95
|
+
return e.some((o) => o.level === "error");
|
|
96
|
+
}
|
|
97
|
+
function M(e) {
|
|
98
|
+
return e.length === 0 ? "Nenhum problema encontrado." : e.map((o) => `${o.level === "error" ? "✖" : "▲"} ${o.where}
|
|
99
|
+
${o.message}`).join(`
|
|
100
|
+
`);
|
|
101
|
+
}
|
|
102
|
+
const p = {
|
|
103
|
+
scenario: "scenario",
|
|
104
|
+
persona: "persona",
|
|
105
|
+
fixture: "fixture",
|
|
106
|
+
network: "network",
|
|
107
|
+
viewport: "viewport",
|
|
108
|
+
customWidth: "w",
|
|
109
|
+
themeMode: "theme",
|
|
110
|
+
locale: "locale",
|
|
111
|
+
dataSource: "source",
|
|
112
|
+
chrome: "chrome",
|
|
113
|
+
keyboardMode: "kb",
|
|
114
|
+
reducedMotion: "motion",
|
|
115
|
+
textScale: "scale",
|
|
116
|
+
inspector: "panel"
|
|
117
|
+
};
|
|
118
|
+
function P(e) {
|
|
119
|
+
return typeof e == "boolean" ? e ? "1" : "0" : String(e);
|
|
120
|
+
}
|
|
121
|
+
function C(e, o = {}) {
|
|
122
|
+
for (const [t, r] of Object.entries(o)) {
|
|
123
|
+
if (r == null) continue;
|
|
124
|
+
const a = p[t];
|
|
125
|
+
a && e.set(a, P(r));
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
function x(e = {}) {
|
|
129
|
+
const o = e.branchUrl || void 0, t = e.deploymentUrl || void 0, r = e.commit || void 0, a = e.env || "development", i = o && `https://${o}` || t && `https://${t}` || (typeof window < "u" ? window.location.origin : "http://localhost:5173");
|
|
130
|
+
return {
|
|
131
|
+
env: a,
|
|
132
|
+
origin: i.replace(/\/$/, ""),
|
|
133
|
+
branchUrl: o,
|
|
134
|
+
deploymentUrl: t,
|
|
135
|
+
branch: e.branch || void 0,
|
|
136
|
+
commit: r,
|
|
137
|
+
shortCommit: r?.slice(0, 7),
|
|
138
|
+
isDeployed: a === "preview" || a === "production"
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
function R(e, o = {}) {
|
|
142
|
+
const t = o.origin ?? x().origin, r = new URL(e.route, t);
|
|
143
|
+
return r.searchParams.set(p.scenario, e.id), r.searchParams.set(p.persona, e.persona), r.searchParams.set(p.fixture, e.fixture), e.network && e.network !== "success" && r.searchParams.set(p.network, e.network), C(r.searchParams, o.overrides), r.toString();
|
|
144
|
+
}
|
|
145
|
+
function z(e, o) {
|
|
146
|
+
const t = o.commit ?? x().commit;
|
|
147
|
+
if (!t) return;
|
|
148
|
+
const r = o.template.replaceAll("{shortCommit}", t.slice(0, 7)).replaceAll("{commit}", t);
|
|
149
|
+
return R(e, { origin: r });
|
|
150
|
+
}
|
|
151
|
+
const A = {
|
|
152
|
+
AA: { normal: 4.5, large: 3 },
|
|
153
|
+
AAA: { normal: 7, large: 4.5 }
|
|
154
|
+
}, O = {
|
|
155
|
+
white: "#ffffff",
|
|
156
|
+
black: "#000000",
|
|
157
|
+
transparent: "#00000000"
|
|
158
|
+
};
|
|
159
|
+
function g(e) {
|
|
160
|
+
const o = e.trim().toLowerCase(), t = O[o];
|
|
161
|
+
if (t) return g(t);
|
|
162
|
+
if (o.startsWith("#")) {
|
|
163
|
+
const a = o.slice(1), i = (n) => Number.parseInt(n.repeat(2), 16);
|
|
164
|
+
if (a.length === 3 || a.length === 4) {
|
|
165
|
+
const [n, d, l, c] = [...a];
|
|
166
|
+
return !n || !d || !l ? void 0 : { r: i(n), g: i(d), b: i(l), a: c ? i(c) / 255 : 1 };
|
|
167
|
+
}
|
|
168
|
+
if (a.length === 6 || a.length === 8) {
|
|
169
|
+
const n = (l) => Number.parseInt(a.slice(l, l + 2), 16), d = [n(0), n(2), n(4)];
|
|
170
|
+
return d.some(Number.isNaN) ? void 0 : {
|
|
171
|
+
r: d[0],
|
|
172
|
+
g: d[1],
|
|
173
|
+
b: d[2],
|
|
174
|
+
a: a.length === 8 ? n(6) / 255 : 1
|
|
175
|
+
};
|
|
176
|
+
}
|
|
177
|
+
return;
|
|
178
|
+
}
|
|
179
|
+
const r = o.match(/^rgba?\(([^)]+)\)$/);
|
|
180
|
+
if (r?.[1]) {
|
|
181
|
+
const a = r[1].split(/[\s,/]+/).filter(Boolean), [i, n, d, l] = a.map(Number);
|
|
182
|
+
return [i, n, d].some((c) => c === void 0 || Number.isNaN(c)) ? void 0 : { r: i, g: n, b: d, a: l === void 0 || Number.isNaN(l) ? 1 : l };
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
function I(e, o) {
|
|
186
|
+
if (e.a >= 1) return e;
|
|
187
|
+
const t = (r, a) => r * e.a + a * (1 - e.a);
|
|
188
|
+
return {
|
|
189
|
+
r: t(e.r, o.r),
|
|
190
|
+
g: t(e.g, o.g),
|
|
191
|
+
b: t(e.b, o.b),
|
|
192
|
+
a: 1
|
|
193
|
+
};
|
|
194
|
+
}
|
|
195
|
+
function h({ r: e, g: o, b: t }) {
|
|
196
|
+
const r = (a) => {
|
|
197
|
+
const i = a / 255;
|
|
198
|
+
return i <= 0.03928 ? i / 12.92 : ((i + 0.055) / 1.055) ** 2.4;
|
|
199
|
+
};
|
|
200
|
+
return 0.2126 * r(e) + 0.7152 * r(o) + 0.0722 * r(t);
|
|
201
|
+
}
|
|
202
|
+
function T(e, o) {
|
|
203
|
+
const t = g(o), r = g(e);
|
|
204
|
+
if (!t || !r) return;
|
|
205
|
+
const a = I(r, t), i = Math.max(h(a), h(t)), n = Math.min(h(a), h(t));
|
|
206
|
+
return (i + 0.05) / (n + 0.05);
|
|
207
|
+
}
|
|
208
|
+
function j(e) {
|
|
209
|
+
const o = e.target ?? "AA", t = e.largeText ? A[o].large : A[o].normal, r = T(e.foreground, e.background);
|
|
210
|
+
return {
|
|
211
|
+
pair: e,
|
|
212
|
+
target: o,
|
|
213
|
+
ratio: r,
|
|
214
|
+
required: t,
|
|
215
|
+
passes: r === void 0 ? void 0 : r >= t,
|
|
216
|
+
label: r === void 0 ? "não medido" : `${r.toFixed(2)}:1`
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
function E(e = []) {
|
|
220
|
+
return e.map(j);
|
|
221
|
+
}
|
|
222
|
+
function L(e) {
|
|
223
|
+
const o = E(e).filter((r) => r.passes !== !0);
|
|
224
|
+
if (o.length === 0) return;
|
|
225
|
+
const t = o.map(
|
|
226
|
+
(r) => ` ✖ ${r.pair.name}: ${r.label} (mínimo ${r.required}:1 para ${r.target}${r.pair.largeText ? ", texto grande" : ""})`
|
|
227
|
+
).join(`
|
|
228
|
+
`);
|
|
229
|
+
throw new Error(`Pares de contraste fora do alvo:
|
|
230
|
+
${t}`);
|
|
231
|
+
}
|
|
232
|
+
function W(e, o) {
|
|
233
|
+
if (typeof window > "u") return;
|
|
234
|
+
const t = o ?? document.documentElement;
|
|
235
|
+
return window.getComputedStyle(t).getPropertyValue(e).trim() || void 0;
|
|
236
|
+
}
|
|
237
|
+
export {
|
|
238
|
+
A as C,
|
|
239
|
+
w as N,
|
|
240
|
+
p as P,
|
|
241
|
+
b as S,
|
|
242
|
+
C as a,
|
|
243
|
+
L as b,
|
|
244
|
+
E as c,
|
|
245
|
+
j as d,
|
|
246
|
+
z as e,
|
|
247
|
+
T as f,
|
|
248
|
+
x as g,
|
|
249
|
+
I as h,
|
|
250
|
+
M as i,
|
|
251
|
+
D as j,
|
|
252
|
+
h as k,
|
|
253
|
+
P as l,
|
|
254
|
+
y as m,
|
|
255
|
+
g as p,
|
|
256
|
+
W as r,
|
|
257
|
+
R as s,
|
|
258
|
+
U as v
|
|
259
|
+
};
|
|
260
|
+
//# sourceMappingURL=contrast-BXd_acxo.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contrast-BXd_acxo.js","sources":["../src/types/index.ts","../src/registry/validate.ts","../src/controls/params.ts","../src/deploy/index.ts","../src/a11y/contrast.ts"],"sourcesContent":["/**\n * Contratos públicos do motor.\n *\n * Estes tipos são a fronteira entre o motor e o produto. O motor nunca conhece\n * um componente, um token ou uma persona concreta: conhece apenas a forma.\n *\n * Regra de fronteira (D-02): se aparece dentro da interface do cliente e\n * contribui para sua linguagem visual ou seu domínio, pertence ao repositório\n * daquele produto e não a este arquivo.\n */\n\nimport type { ComponentType, ReactNode } from \"react\";\n\n// Import de tipo, apagado no build: o dicionário de rótulos mora junto com os\n// valores padrão, em `shell/labels.ts`, e só a forma dele é contrato.\nimport type { LabelsOverride } from \"../shell/labels.js\";\n\n/* ------------------------------------------------------------------ *\n * Ciclo de vida\n * ------------------------------------------------------------------ */\n\n/**\n * Estado de ciclo de vida do cenário (§18.1). Existe para evitar que a\n * referência envelheça em silêncio quando o produto real muda.\n */\nexport type ScenarioStatus =\n | \"proposed\"\n | \"in-review\"\n | \"approved\"\n | \"in-implementation\"\n | \"implemented\"\n | \"superseded\";\n\nexport const SCENARIO_STATUSES: readonly ScenarioStatus[] = [\n \"proposed\",\n \"in-review\",\n \"approved\",\n \"in-implementation\",\n \"implemented\",\n \"superseded\",\n] as const;\n\n/* ------------------------------------------------------------------ *\n * Acessibilidade (§6.1) — dimensão de primeira classe, não auditoria final\n * ------------------------------------------------------------------ */\n\n/** Nível de conformidade alvo. O padrão interno é WCAG 2.2 AA. */\nexport type ContrastTarget = \"AA\" | \"AAA\";\n\n/** Quanto da jornada precisa ser completável só por teclado. */\nexport type KeyboardCoverage = \"full\" | \"partial\" | \"not-applicable\";\n\nexport type A11yContract = {\n /**\n * `full` significa: a jornada declarada por este cenário é completável do\n * início ao fim sem mouse, com foco visível em cada passo.\n */\n keyboard: KeyboardCoverage;\n /** Nível de contraste exigido para os tokens em uso nesta tela. */\n contrast: ContrastTarget;\n /**\n * Eventos que precisam ser anunciados para leitor de tela. São chaves de\n * domínio, não seletores: `request.status`, `retry.result`.\n *\n * Um cenário de aprovação bloqueada em que a recusa não é anunciada está\n * incompleto, não está pronto para aprovação.\n */\n announces?: string[];\n /** Observação de revisão humana. O automático é piso, não teto. */\n notes?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Persona\n * ------------------------------------------------------------------ */\n\nexport type Persona = {\n /** Identificador estável usado em URL e em cenário. */\n id: string;\n /** Nome no vocabulário do cliente: \"Aprovador\". */\n name: string;\n /** O que essa pessoa está tentando fazer. */\n goal?: string;\n /** Permissões concedidas por padrão a este papel. */\n permissions: string[];\n description?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Regra de negócio\n * ------------------------------------------------------------------ */\n\nexport type Rule = {\n /** Identificador citado por cenários: `retry-after-document-review`. */\n id: string;\n /** Enunciado curto, na linguagem do produto. */\n statement: string;\n /** Por que a regra existe. Contexto, não implementação. */\n rationale?: string;\n /** Onde a regra vive no código, quando existir: `src/rules/requests.ts`. */\n source?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Fixture\n * ------------------------------------------------------------------ */\n\n/**\n * Dado sintético e determinístico que materializa um cenário.\n *\n * O motor não conhece o formato de `data` — isso é contrato do produto. O que\n * o motor garante é que a mesma URL produz a mesma fixture (§15.1\n * \"Determinismo\"), então `data` precisa ser um valor puro ou uma factory pura.\n */\nexport type Fixture<T = unknown> = {\n id: string;\n /** Rótulo legível para o seletor de conjunto de dados. */\n label: string;\n description?: string;\n /** Valor determinístico, ou factory pura que devolve um valor determinístico. */\n data: T | (() => T);\n};\n\n/* ------------------------------------------------------------------ *\n * Estado de rede\n * ------------------------------------------------------------------ */\n\nexport type NetworkState = \"success\" | \"loading\" | \"empty\" | \"error\" | \"slow\";\n\nexport const NETWORK_STATES: readonly NetworkState[] = [\n \"success\",\n \"loading\",\n \"empty\",\n \"error\",\n \"slow\",\n] as const;\n\n/* ------------------------------------------------------------------ *\n * Cenário — a unidade central (D-06)\n * ------------------------------------------------------------------ */\n\n/**\n * Um cenário não é uma tela com dados diferentes. Ele combina intenção,\n * persona, permissões, pré-condições, dados, estado inicial, ações\n * disponíveis, regras e resultado esperado.\n */\nexport type Scenario = {\n /** `modulo.situacao` em kebab-case: `requests.approve-blocked`. */\n id: string;\n /** Título no vocabulário do negócio: \"Aprovação bloqueada por falta de documento\". */\n title: string;\n /** Rota que o cenário abre. Precisa casar com uma rota do produto. */\n route: string;\n /** Id de uma persona registrada no produto. */\n persona: string;\n /**\n * Permissões efetivas do cenário. Quando ausente, herda as da persona.\n * Declarar aqui permite representar \"solicitante sem permissão de aprovar\"\n * sem inventar uma segunda persona.\n */\n permissions?: string[];\n /** Id de uma fixture registrada no produto. */\n fixture: string;\n /** Ids de regras que governam esta situação. */\n rules?: string[];\n /** Contrato de acessibilidade da situação. */\n a11y: A11yContract;\n /** Estado de ciclo de vida. */\n status: ScenarioStatus;\n\n /** Intenção: o que se quer discutir ou verificar aqui. */\n intent?: string;\n /** Pré-condições em linguagem de negócio. */\n preconditions?: string[];\n /** Ações que a persona pode executar nesta situação. */\n actions?: string[];\n /** Resultado esperado — vira caso de teste no handoff. */\n expected?: string[];\n /** Estado de rede inicial. Padrão: `success`. */\n network?: NetworkState;\n /** Rótulos livres para busca: \"exceção\", \"permissão\", \"vazio\". */\n tags?: string[];\n /**\n * URL de commit que registra a aprovação (§10.2). Imutável por definição:\n * a aprovação não pode mudar de conteúdo debaixo de quem aprovou.\n */\n approvedAt?: { url: string; commit: string; date: string };\n /** Ticket de engenharia, quando o cenário estiver em implementação. */\n ticket?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Organização: módulo e jornada\n * ------------------------------------------------------------------ */\n\n/**\n * Uma jornada é uma sequência de passos com ramificações. Cada passo aponta\n * para um cenário, então uma jornada é navegável e testável sem duplicar\n * definição.\n */\nexport type Flow = {\n id: string;\n /** Título de negócio: \"Decidir uma solicitação\". */\n title: string;\n description?: string;\n steps: FlowStep[];\n};\n\nexport type FlowStep = {\n /** Cenário que materializa este passo. */\n scenario: string;\n /** Rótulo do passo, quando diferir do título do cenário. */\n label?: string;\n /** Decisão tomada aqui, quando o passo ramifica. */\n decision?: string;\n /** Saídas alternativas: rótulo → id de cenário. */\n branches?: Record<string, string>;\n};\n\nexport type Module = {\n /** `requests`, `catalog`, `billing`. */\n id: string;\n /** Nome no vocabulário do cliente: \"Solicitações\". */\n name: string;\n description?: string;\n /** Jornadas guiadas do módulo. Opcional: navegação livre é o padrão. */\n flows?: Flow[];\n};\n\n/* ------------------------------------------------------------------ *\n * Rotas declarativas\n * ------------------------------------------------------------------ */\n\n/**\n * Rota declarativa do produto. O motor casa `path` contra a URL e renderiza\n * `screen`, passando os parâmetros dinâmicos.\n *\n * Sintaxe de `path`: segmentos literais e `:param`. Um `*` final captura o\n * resto em `params[\"*\"]`.\n */\nexport type RouteDefinition = {\n path: string;\n screen: ComponentType<ScreenProps>;\n};\n\nexport type ScreenProps = {\n /** Parâmetros dinâmicos casados da rota. */\n params: Record<string, string>;\n /** Contexto do cenário ativo, resolvido pelo motor. */\n context: ScenarioContext;\n};\n\n/* ------------------------------------------------------------------ *\n * Adapters de dados (§7)\n * ------------------------------------------------------------------ */\n\n/**\n * A UI do produto nunca depende diretamente de um backend. A camada de\n * adapters permite alimentar o mesmo cenário por fixture, REST, GraphQL ou\n * staging sem alterar a composição visual.\n */\nexport type DataSourceAdapter<T = unknown> = {\n id: string;\n label: string;\n /**\n * Resolve os dados de um cenário. Recebe a fixture declarada para que um\n * adapter remoto possa usá-la como fallback ou como semente.\n */\n load: (request: DataRequest) => Promise<T> | T;\n};\n\nexport type DataRequest = {\n scenario: Scenario;\n fixture: Fixture | undefined;\n network: NetworkState;\n};\n\n/* ------------------------------------------------------------------ *\n * Tema do produto\n * ------------------------------------------------------------------ */\n\n/**\n * O motor não impõe aparência (D-02). Recebe do produto apenas o suficiente\n * para validar contraste e oferecer os controles de tema.\n */\nexport type ProductTheme = {\n /**\n * Pares de cores que precisam passar na validação de contraste.\n * Contraste é propriedade de par, então validar na definição do token\n * resolve na origem, uma vez, em vez de perseguir o problema em 30 telas.\n */\n contrastPairs?: ContrastPair[];\n /** Modos de tema disponíveis no produto, quando houver mais de um. */\n modes?: string[];\n /** Idiomas disponíveis, quando o produto tiver essa variação. */\n locales?: string[];\n /**\n * Rótulos do chrome do motor. Sobrescreve por grupo o que estiver em\n * `DEFAULT_LABELS`; o que não for declarado fica no padrão em português.\n *\n * Serve para o Design Space de um cliente que revisa em outro idioma: o chrome\n * divide a tela com a UI do produto, e chrome em português ao lado de interface\n * em inglês é ruído no meio da revisão.\n *\n * Isto é rótulo de **mecanismo**. Nome de módulo, título de cenário e nome de\n * persona continuam vindo do catálogo do produto.\n */\n labels?: LabelsOverride;\n};\n\nexport type ContrastPair = {\n /** Nome do par: `fg-1 sobre bg-app`. */\n name: string;\n /** Cor de frente em hex, rgb() ou rgba(). */\n foreground: string;\n /** Cor de fundo. Precisa ser opaca. */\n background: string;\n /** `AA` por padrão. */\n target?: ContrastTarget;\n /** Texto grande (>=24px, ou >=18.66px bold) tem limiar menor. */\n largeText?: boolean;\n};\n\n/* ------------------------------------------------------------------ *\n * Definição do produto — a única coisa que o produto entrega ao motor\n * ------------------------------------------------------------------ */\n\nexport type ProductDefinition = {\n /** `acme`. */\n id: string;\n /** \"Acme\". */\n name: string;\n /** Uma linha sobre o produto, exibida na entrada do Design Space. */\n tagline?: string;\n modules: Module[];\n scenarios: Scenario[];\n personas: Persona[];\n fixtures: Fixture[];\n rules?: Rule[];\n routes: RouteDefinition[];\n theme?: ProductTheme;\n /**\n * Adapters de dados disponíveis. `fixtures` é o padrão (D-05); qualquer\n * outro entra como opção explícita e justificada.\n */\n dataSources?: {\n default: string;\n adapters?: DataSourceAdapter[];\n };\n /**\n * Contexto do deployment, informado pelo produto. **Opcional**: um Design\n * Space que roda só local não precisa dele.\n *\n * O motor **não consegue** descobrir isso sozinho. Ele é uma biblioteca já\n * compilada: o `import.meta.env` do código dele foi resolvido no build do\n * pacote, não no build do produto, então não sobra nada para o bundler do\n * produto substituir. Quem tem acesso ao próprio ambiente de build é o produto.\n *\n * Passe os valores do bundler, com o nome que o seu build usar:\n *\n * ```ts\n * deploy: {\n * env: import.meta.env.VITE_DEPLOY_ENV,\n * branch: import.meta.env.VITE_DEPLOY_BRANCH,\n * commit: import.meta.env.VITE_DEPLOY_COMMIT,\n * }\n * ```\n *\n * Sem isso o cabeçalho da revisão mostra \"development\" e omite branch e\n * commit — e é o commit que torna uma aprovação rastreável.\n */\n deploy?: DeployOverrides;\n\n /** Renderizado quando nenhuma rota casa. Padrão: aviso neutro do motor. */\n notFound?: ComponentType<{ path: string }>;\n /** Envolve a UI do produto. Serve para providers de tema, i18n ou store. */\n wrapper?: ComponentType<{ children: ReactNode; context: ScenarioContext }>;\n};\n\n/**\n * Contexto do deployment informado pelo produto. Todos os campos são opcionais,\n * e é essa a fonte única: o motor não lê ambiente nem conhece provedor de\n * hospedagem. Campo ausente cai no padrão local.\n */\nexport type DeployOverrides = {\n /** `development`, `preview` ou `production`. */\n env?: string;\n /** Domínio da branch, sem protocolo. Quando ausente, usa a origem da janela. */\n branchUrl?: string;\n /** Domínio único deste deployment, sem protocolo. */\n deploymentUrl?: string;\n /** Nome da branch, para rotular a revisão. */\n branch?: string;\n /** Commit exato, gravado junto com o status de aprovação do cenário. */\n commit?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Contexto exposto à UI do produto\n * ------------------------------------------------------------------ */\n\n/**\n * O que a UI do produto recebe do motor. Deliberadamente pequeno: dados,\n * papel, permissões e estado de ambiente. Nada de componente, token ou\n * aparência.\n */\nexport type ScenarioContext = {\n scenario: Scenario | undefined;\n persona: Persona | undefined;\n /** Permissões efetivas: as do cenário, ou as da persona quando ausentes. */\n permissions: string[];\n /** `true` quando a permissão está nas permissões efetivas. */\n can: (permission: string) => boolean;\n /** Dados resolvidos pelo adapter ativo. `undefined` enquanto carrega. */\n data: unknown;\n fixture: Fixture | undefined;\n network: NetworkState;\n /** `true` enquanto o adapter resolve. Reflete também o estado `slow`. */\n isLoading: boolean;\n /** Preenchido quando `network` é `error` ou o adapter falhou. */\n error: Error | undefined;\n /** Regras resolvidas do cenário ativo. */\n rules: Rule[];\n viewport: ViewportSetting;\n themeMode: string | undefined;\n locale: string | undefined;\n /** Preferências de acessibilidade ativas no painel. */\n a11y: {\n keyboardMode: boolean;\n reducedMotion: boolean;\n /** Multiplicador de tamanho de texto: 1, 1.25, 1.5, 2. */\n textScale: number;\n };\n /** Navega dentro do Design Space preservando os controles ativos. */\n navigate: (to: string) => void;\n /** Abre outro cenário por id. */\n openScenario: (scenarioId: string) => void;\n};\n\nexport type ViewportSetting = {\n /** `mobile`, `tablet`, `desktop`, `fit` ou `custom`. */\n id: string;\n label: string;\n /** Largura em px. `undefined` em `fit` significa \"ocupa o disponível\". */\n width?: number;\n height?: number;\n};\n\n/* ------------------------------------------------------------------ *\n * Estado dos controles — serializado na URL (deep link)\n * ------------------------------------------------------------------ */\n\nexport type ControlsState = {\n scenario: string | undefined;\n persona: string | undefined;\n fixture: string | undefined;\n network: NetworkState;\n viewport: string;\n customWidth: number | undefined;\n themeMode: string | undefined;\n locale: string | undefined;\n dataSource: string | undefined;\n /** Chrome do Design Space oculto: revisão limpa e captura de tela. */\n chrome: boolean;\n keyboardMode: boolean;\n reducedMotion: boolean;\n textScale: number;\n /** Painel lateral direito aberto. */\n inspector: boolean;\n};\n","/**\n * Validação em runtime do contrato de cenário (E2).\n *\n * Existe porque tipo de TypeScript desaparece no build: uma fixture inexistente\n * ou uma persona escrita errada só apareceria como tela vazia no preview, que é\n * exatamente o tipo de erro que corrói a confiança no ambiente. Aqui ela\n * aparece como problema nomeado, no painel e no CI.\n *\n * Sem dependência de schema externo de propósito: o contrato é pequeno, e o\n * motor precisa ficar pequeno e neutro (Princípio 6).\n */\n\nimport {\n NETWORK_STATES,\n SCENARIO_STATUSES,\n type ProductDefinition,\n type Scenario,\n} from \"../types/index.js\";\n\nexport type ValidationIssue = {\n level: \"error\" | \"warning\";\n /** Onde o problema está: `scenario:requests.approve-blocked`. */\n where: string;\n message: string;\n};\n\nconst ID_PATTERN = /^[a-z0-9]+([.\\-][a-z0-9]+)*$/;\n\nfunction isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.trim().length > 0;\n}\n\n/**\n * Valida um cenário isolado: forma, não referências. Referências dependem do\n * produto inteiro e são checadas em {@link validateProduct}.\n */\nexport function validateScenario(scenario: Scenario, index?: number): ValidationIssue[] {\n const issues: ValidationIssue[] = [];\n const where = isNonEmptyString(scenario?.id)\n ? `scenario:${scenario.id}`\n : `scenario[${index ?? \"?\"}]`;\n\n const err = (message: string) => issues.push({ level: \"error\", where, message });\n const warn = (message: string) => issues.push({ level: \"warning\", where, message });\n\n if (!isNonEmptyString(scenario?.id)) {\n err(\"`id` é obrigatório.\");\n } else if (!ID_PATTERN.test(scenario.id)) {\n err(\n \"`id` deve ser minúsculo em kebab-case, com o módulo como prefixo: `requests.approve-blocked`.\",\n );\n } else if (!scenario.id.includes(\".\")) {\n warn(\"`id` sem prefixo de módulo dificulta a navegação e a busca do agente.\");\n }\n\n if (!isNonEmptyString(scenario?.title)) {\n err(\"`title` é obrigatório e deve usar o vocabulário do negócio.\");\n }\n\n if (!isNonEmptyString(scenario?.route)) {\n err(\"`route` é obrigatório.\");\n } else if (!scenario.route.startsWith(\"/\")) {\n err(\"`route` deve começar com `/`.\");\n }\n\n if (!isNonEmptyString(scenario?.persona)) err(\"`persona` é obrigatório.\");\n if (!isNonEmptyString(scenario?.fixture)) {\n err(\"`fixture` é obrigatório. O padrão do ambiente é dado sintético (D-05).\");\n }\n\n if (!SCENARIO_STATUSES.includes(scenario?.status)) {\n err(`\\`status\\` deve ser um de: ${SCENARIO_STATUSES.join(\", \")}.`);\n }\n\n if (scenario?.network && !NETWORK_STATES.includes(scenario.network)) {\n err(`\\`network\\` deve ser um de: ${NETWORK_STATES.join(\", \")}.`);\n }\n\n const a11y = scenario?.a11y;\n if (!a11y || typeof a11y !== \"object\") {\n err(\n \"`a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de projeto (D-15).\",\n );\n } else {\n if (![\"full\", \"partial\", \"not-applicable\"].includes(a11y.keyboard)) {\n err(\"`a11y.keyboard` deve ser `full`, `partial` ou `not-applicable`.\");\n }\n if (![\"AA\", \"AAA\"].includes(a11y.contrast)) {\n err(\"`a11y.contrast` deve ser `AA` ou `AAA`. O padrão interno é WCAG 2.2 AA.\");\n }\n if (a11y.announces !== undefined && !Array.isArray(a11y.announces)) {\n err(\"`a11y.announces` deve ser uma lista de chaves de evento de domínio.\");\n }\n }\n\n // Gate do roadmap: não aprovar cenário de jornada crítica sem acessibilidade\n // verificada. O motor não sabe o que é crítico, então checa o que dá:\n // aprovado com teclado parcial é sinal de aprovação apressada.\n if (scenario?.status === \"approved\" && a11y?.keyboard === \"partial\") {\n warn(\n \"Cenário aprovado com `a11y.keyboard: \\\"partial\\\"`. Confirme que esta jornada não é crítica.\",\n );\n }\n\n if (scenario?.status === \"approved\" && !scenario.approvedAt) {\n warn(\n \"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.\",\n );\n }\n\n if (!scenario?.expected?.length) {\n warn(\n \"Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater).\",\n );\n }\n\n return issues;\n}\n\n/**\n * Valida o produto inteiro: forma de cada cenário mais integridade das\n * referências entre cenário, persona, fixture, regra e rota.\n */\nexport function validateProduct(product: ProductDefinition): ValidationIssue[] {\n const issues: ValidationIssue[] = [];\n const push = (level: ValidationIssue[\"level\"], where: string, message: string) =>\n issues.push({ level, where, message });\n\n const personaIds = new Set(product.personas?.map((p) => p.id) ?? []);\n const fixtureIds = new Set(product.fixtures?.map((f) => f.id) ?? []);\n const ruleIds = new Set(product.rules?.map((r) => r.id) ?? []);\n const moduleIds = new Set(product.modules?.map((m) => m.id) ?? []);\n const scenarioIds = new Set<string>();\n\n if (!isNonEmptyString(product.id)) push(\"error\", \"product\", \"`id` é obrigatório.\");\n if (!isNonEmptyString(product.name)) push(\"error\", \"product\", \"`name` é obrigatório.\");\n if (!product.routes?.length) {\n push(\"error\", \"product\", \"`routes` está vazio: nenhum cenário conseguirá renderizar.\");\n }\n\n for (const [index, scenario] of (product.scenarios ?? []).entries()) {\n issues.push(...validateScenario(scenario, index));\n\n const where = `scenario:${scenario?.id ?? index}`;\n\n if (scenario?.id) {\n if (scenarioIds.has(scenario.id)) {\n push(\"error\", where, `\\`id\\` duplicado: ${scenario.id}.`);\n }\n scenarioIds.add(scenario.id);\n\n const modulePrefix = scenario.id.split(\".\")[0];\n if (modulePrefix && moduleIds.size > 0 && !moduleIds.has(modulePrefix)) {\n push(\n \"warning\",\n where,\n `Prefixo \\`${modulePrefix}\\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`,\n );\n }\n }\n\n if (scenario?.persona && !personaIds.has(scenario.persona)) {\n push(\"error\", where, `Persona não registrada: \\`${scenario.persona}\\`.`);\n }\n if (scenario?.fixture && !fixtureIds.has(scenario.fixture)) {\n push(\"error\", where, `Fixture não registrada: \\`${scenario.fixture}\\`.`);\n }\n for (const rule of scenario?.rules ?? []) {\n if (!ruleIds.has(rule)) {\n push(\"error\", where, `Regra não registrada: \\`${rule}\\`.`);\n }\n }\n if (scenario?.route && !matchesAnyRoute(scenario.route, product)) {\n push(\n \"error\",\n where,\n `Rota \\`${scenario.route}\\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`,\n );\n }\n }\n\n for (const module of product.modules ?? []) {\n for (const flow of module.flows ?? []) {\n const where = `flow:${module.id}/${flow.id}`;\n if (!flow.steps?.length) push(\"warning\", where, \"Jornada sem passos.\");\n for (const step of flow.steps ?? []) {\n if (!scenarioIds.has(step.scenario)) {\n push(\"error\", where, `Passo aponta para cenário inexistente: \\`${step.scenario}\\`.`);\n }\n for (const [label, target] of Object.entries(step.branches ?? {})) {\n if (!scenarioIds.has(target)) {\n push(\n \"error\",\n where,\n `Ramificação \"${label}\" aponta para cenário inexistente: \\`${target}\\`.`,\n );\n }\n }\n }\n }\n }\n\n const defaultSource = product.dataSources?.default;\n if (defaultSource && defaultSource !== \"fixtures\") {\n const adapterIds = new Set(product.dataSources?.adapters?.map((a) => a.id) ?? []);\n if (!adapterIds.has(defaultSource)) {\n push(\"error\", \"product\", `\\`dataSources.default\\` aponta para adapter inexistente: \\`${defaultSource}\\`.`);\n }\n push(\n \"warning\",\n \"product\",\n \"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.\",\n );\n }\n\n return issues;\n}\n\nfunction matchesAnyRoute(route: string, product: ProductDefinition): boolean {\n const path = route.split(\"?\")[0] ?? route;\n return (product.routes ?? []).some((definition) => matchPathShape(definition.path, path));\n}\n\n/**\n * Casamento de forma de rota, usado pela validação. O casamento com extração de\n * parâmetros vive em `router/`; aqui só interessa \"existe rota compatível\".\n */\nfunction matchPathShape(pattern: string, path: string): boolean {\n const patternSegments = pattern.split(\"/\").filter(Boolean);\n const pathSegments = path.split(\"/\").filter(Boolean);\n\n for (const [index, segment] of patternSegments.entries()) {\n if (segment === \"*\") return true;\n const actual = pathSegments[index];\n if (actual === undefined) return false;\n if (segment.startsWith(\":\")) continue;\n if (segment !== actual) return false;\n }\n\n return patternSegments.length === pathSegments.length;\n}\n\n/** `true` quando existe pelo menos uma violação de nível `error`. */\nexport function hasErrors(issues: ValidationIssue[]): boolean {\n return issues.some((issue) => issue.level === \"error\");\n}\n\n/** Formata as violações para saída de terminal, usada no CI e em testes. */\nexport function formatIssues(issues: ValidationIssue[]): string {\n if (issues.length === 0) return \"Nenhum problema encontrado.\";\n return issues\n .map((issue) => `${issue.level === \"error\" ? \"✖\" : \"▲\"} ${issue.where}\\n ${issue.message}`)\n .join(\"\\n\");\n}\n","/**\n * Nomes dos parâmetros de URL, em um módulo próprio.\n *\n * Separado de `state.ts` porque `deploy/` também precisa deste mapa para montar\n * deep links, e importar o estado inteiro criaria dependência circular. Mais\n * importante: com o mapa em um só lugar, é impossível um override de teste\n * escrever `keyboardMode=1` quando a URL real usa `kb=1`.\n */\n\nimport type { ControlsState } from \"../types/index.js\";\n\n/** Nomes curtos: a URL é colada em Slack, em ticket e em thread de revisão. */\nexport const PARAM = {\n scenario: \"scenario\",\n persona: \"persona\",\n fixture: \"fixture\",\n network: \"network\",\n viewport: \"viewport\",\n customWidth: \"w\",\n themeMode: \"theme\",\n locale: \"locale\",\n dataSource: \"source\",\n chrome: \"chrome\",\n keyboardMode: \"kb\",\n reducedMotion: \"motion\",\n textScale: \"scale\",\n inspector: \"panel\",\n} as const satisfies Record<keyof ControlsState, string>;\n\n/**\n * Serializa um valor de controle para a query string.\n *\n * Booleano vira `1`/`0` e não `true`/`false`: é o que o parser espera, e a URL\n * fica mais curta.\n */\nexport function serializeValue(value: unknown): string {\n if (typeof value === \"boolean\") return value ? \"1\" : \"0\";\n return String(value);\n}\n\n/**\n * Aplica overrides de {@link ControlsState} em uma `URLSearchParams`, traduzindo\n * as chaves do estado para os nomes de parâmetro.\n */\nexport function applyOverrides(\n params: URLSearchParams,\n overrides: Partial<ControlsState> = {},\n): void {\n for (const [key, value] of Object.entries(overrides)) {\n if (value === undefined || value === null) continue;\n const param = PARAM[key as keyof ControlsState];\n if (!param) continue;\n params.set(param, serializeValue(value));\n }\n}\n","/**\n * Contexto de deployment e deep links (§10.3).\n *\n * O motor não conhece provedor de hospedagem. Ele recebe o contexto do produto —\n * `ProductDefinition.deploy` — e monta a URL absoluta de qualquer cenário sem\n * domínio hardcoded, que é o que faz o botão \"copiar link\" funcionar igual em\n * localhost, em preview e em produção.\n *\n * Não existe detecção automática aqui, e a razão é concreta: o motor é uma\n * biblioteca já compilada, então o `import.meta.env` deste arquivo foi resolvido\n * no build do **pacote**, não no build do produto. Ler ambiente daqui nunca\n * funcionou em produto real — ver 0.1.1 no `CHANGELOG.md`. Quem tem acesso ao\n * próprio ambiente de build é o produto, então é ele quem informa.\n *\n * Design Space sem hospedagem nenhuma é caso suportado, não degradação: sem\n * contexto, `env` é `development`, a origem é a da janela e o cabeçalho da\n * revisão omite branch e commit.\n */\n\nimport type { ControlsState, DeployOverrides, Scenario } from \"../types/index.js\";\nimport { PARAM, applyOverrides } from \"../controls/params.js\";\n\nexport type DeployContext = {\n /** `development`, `preview` ou `production`. */\n env: string;\n /** Origem absoluta, com protocolo, sem barra final. */\n origin: string;\n /** Domínio estável da branch, quando em preview. */\n branchUrl: string | undefined;\n /** Domínio único deste deployment. Imutável. */\n deploymentUrl: string | undefined;\n /** Nome da branch, para rotular a revisão na interface. */\n branch: string | undefined;\n /** Commit exato, gravado junto com o status de aprovação do cenário. */\n commit: string | undefined;\n /** Primeiros 7 caracteres do commit. */\n shortCommit: string | undefined;\n /** `true` quando o produto informou preview ou produção. */\n isDeployed: boolean;\n};\n\n/**\n * Monta o contexto do deployment a partir do que o produto informou.\n *\n * Campo ausente ou vazio cai no padrão local — string vazia é o que um `define`\n * de bundler produz quando a variável não existe, e um cabeçalho de revisão com\n * branch vazia é pior que um sem branch.\n */\nexport function getDeployContext(overrides: DeployOverrides = {}): DeployContext {\n const branchUrl = overrides.branchUrl || undefined;\n const deploymentUrl = overrides.deploymentUrl || undefined;\n const commit = overrides.commit || undefined;\n const env = overrides.env || \"development\";\n\n // Preferência deliberada: a URL de branch é estável e sempre reflete o último\n // commit daquela branch, que é o que se quer ao circular um cenário em\n // revisão (§10.2). A URL de commit entra no registro de aprovação, não aqui.\n const origin =\n (branchUrl && `https://${branchUrl}`) ||\n (deploymentUrl && `https://${deploymentUrl}`) ||\n (typeof window !== \"undefined\" ? window.location.origin : \"http://localhost:5173\");\n\n return {\n env,\n origin: origin.replace(/\\/$/, \"\"),\n branchUrl,\n deploymentUrl,\n branch: overrides.branch || undefined,\n commit,\n shortCommit: commit?.slice(0, 7),\n isDeployed: env === \"preview\" || env === \"production\",\n };\n}\n\n/**\n * URL absoluta de um cenário: rota mais os controles necessários para\n * reproduzir a situação. É o link que um PO envia sem precisar explicar\n * nenhuma sequência manual anterior.\n */\nexport function scenarioUrl(\n scenario: Scenario,\n options: { origin?: string; overrides?: Partial<ControlsState> } = {},\n): string {\n const origin = options.origin ?? getDeployContext().origin;\n const url = new URL(scenario.route, origin);\n\n url.searchParams.set(PARAM.scenario, scenario.id);\n url.searchParams.set(PARAM.persona, scenario.persona);\n url.searchParams.set(PARAM.fixture, scenario.fixture);\n if (scenario.network && scenario.network !== \"success\") {\n url.searchParams.set(PARAM.network, scenario.network);\n }\n\n applyOverrides(url.searchParams, options.overrides);\n\n return url.toString();\n}\n\n/**\n * URL imutável de aprovação (§10.2). Aponta para o commit exato, então a\n * aprovação não muda de conteúdo debaixo de quem aprovou.\n *\n * O formato da URL é do provedor, não do motor, então vem do produto como\n * template com `{commit}` ou `{shortCommit}`:\n *\n * ```ts\n * commitUrl(scenario, { template: \"https://acme-{shortCommit}-time.example.app\" });\n * commitUrl(scenario, { template: \"https://{commit}.review.acme.dev\" });\n * ```\n *\n * Sem commit não há aprovação rastreável, e a função devolve `undefined` em vez\n * de um link que aponta para o lugar errado.\n */\nexport function commitUrl(\n scenario: Scenario,\n options: { template: string; commit?: string },\n): string | undefined {\n const commit = options.commit ?? getDeployContext().commit;\n if (!commit) return undefined;\n\n const origin = options.template\n .replaceAll(\"{shortCommit}\", commit.slice(0, 7))\n .replaceAll(\"{commit}\", commit);\n\n return scenarioUrl(scenario, { origin });\n}\n","/**\n * Contraste (§6.1, \"No token\").\n *\n * Contraste é propriedade de par de cores, não de componente. Validar na\n * definição do token resolve na origem, uma vez, em vez de perseguir o mesmo\n * problema em trinta telas — e é por isso que esta função roda junto do build do\n * produto, não só no painel.\n *\n * Implementa a razão de contraste do WCAG 2.x, que é a mesma em 2.2.\n */\n\nimport type { ContrastPair, ContrastTarget } from \"../types/index.js\";\n\nexport type Rgb = { r: number; g: number; b: number; a: number };\n\n/** Limiares do WCAG 2.2: 1.4.3 (AA) e 1.4.6 (AAA). */\nexport const CONTRAST_THRESHOLDS = {\n AA: { normal: 4.5, large: 3 },\n AAA: { normal: 7, large: 4.5 },\n} as const;\n\nconst NAMED_COLORS: Record<string, string> = {\n white: \"#ffffff\",\n black: \"#000000\",\n transparent: \"#00000000\",\n};\n\n/**\n * Interpreta hex de 3, 4, 6 ou 8 dígitos, `rgb()`, `rgba()` e as três palavras\n * que aparecem em token de verdade. Devolve `undefined` para o que não sabe ler\n * — deliberadamente: um par que não pôde ser medido precisa aparecer como\n * \"não verificado\" no painel, não como aprovado.\n */\nexport function parseColor(input: string): Rgb | undefined {\n const value = input.trim().toLowerCase();\n const named = NAMED_COLORS[value];\n if (named) return parseColor(named);\n\n if (value.startsWith(\"#\")) {\n const hex = value.slice(1);\n const expand = (chunk: string) => Number.parseInt(chunk.repeat(2), 16);\n\n if (hex.length === 3 || hex.length === 4) {\n const [r, g, b, a] = [...hex];\n if (!r || !g || !b) return undefined;\n return { r: expand(r), g: expand(g), b: expand(b), a: a ? expand(a) / 255 : 1 };\n }\n\n if (hex.length === 6 || hex.length === 8) {\n const pair = (index: number) => Number.parseInt(hex.slice(index, index + 2), 16);\n const values = [pair(0), pair(2), pair(4)];\n if (values.some(Number.isNaN)) return undefined;\n return {\n r: values[0]!,\n g: values[1]!,\n b: values[2]!,\n a: hex.length === 8 ? pair(6) / 255 : 1,\n };\n }\n\n return undefined;\n }\n\n const functional = value.match(/^rgba?\\(([^)]+)\\)$/);\n if (functional?.[1]) {\n const parts = functional[1].split(/[\\s,/]+/).filter(Boolean);\n const [r, g, b, a] = parts.map(Number);\n if ([r, g, b].some((n) => n === undefined || Number.isNaN(n))) return undefined;\n return { r: r!, g: g!, b: b!, a: a === undefined || Number.isNaN(a) ? 1 : a };\n }\n\n return undefined;\n}\n\n/**\n * Compõe uma cor semitransparente sobre um fundo opaco.\n *\n * Importa porque metade dos tokens semânticos de produto real é\n * `rgba(43, 35, 91, 0.6)` — medir isso ignorando o alfa dá um resultado\n * otimista e falso.\n */\nexport function flatten(foreground: Rgb, background: Rgb): Rgb {\n if (foreground.a >= 1) return foreground;\n const mix = (fg: number, bg: number) => fg * foreground.a + bg * (1 - foreground.a);\n return {\n r: mix(foreground.r, background.r),\n g: mix(foreground.g, background.g),\n b: mix(foreground.b, background.b),\n a: 1,\n };\n}\n\n/** Luminância relativa (WCAG 2.x, definição de `relative luminance`). */\nexport function relativeLuminance({ r, g, b }: Rgb): number {\n const channel = (raw: number) => {\n const value = raw / 255;\n return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;\n };\n return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);\n}\n\n/** Razão de contraste entre 1 e 21. `undefined` quando alguma cor é ilegível. */\nexport function contrastRatio(foreground: string, background: string): number | undefined {\n const bg = parseColor(background);\n const fgRaw = parseColor(foreground);\n if (!bg || !fgRaw) return undefined;\n\n const fg = flatten(fgRaw, bg);\n const lighter = Math.max(relativeLuminance(fg), relativeLuminance(bg));\n const darker = Math.min(relativeLuminance(fg), relativeLuminance(bg));\n return (lighter + 0.05) / (darker + 0.05);\n}\n\nexport type ContrastResult = {\n pair: ContrastPair;\n target: ContrastTarget;\n /** `undefined` quando alguma das cores não pôde ser interpretada. */\n ratio: number | undefined;\n required: number;\n /** `undefined` quando não foi possível medir. Nunca `true` por omissão. */\n passes: boolean | undefined;\n /** Razão arredondada para exibição: \"4.62:1\". */\n label: string;\n};\n\nexport function checkContrastPair(pair: ContrastPair): ContrastResult {\n const target = pair.target ?? \"AA\";\n const required = pair.largeText\n ? CONTRAST_THRESHOLDS[target].large\n : CONTRAST_THRESHOLDS[target].normal;\n const ratio = contrastRatio(pair.foreground, pair.background);\n\n return {\n pair,\n target,\n ratio,\n required,\n passes: ratio === undefined ? undefined : ratio >= required,\n label: ratio === undefined ? \"não medido\" : `${ratio.toFixed(2)}:1`,\n };\n}\n\nexport function checkContrastPairs(pairs: ContrastPair[] = []): ContrastResult[] {\n return pairs.map(checkContrastPair);\n}\n\n/**\n * Falha o build quando algum par declarado não atinge o alvo.\n *\n * Chamado por um teste do produto (`tests/tokens.test.ts` no template), porque\n * validar tokens é responsabilidade do produto — o motor só sabe medir.\n */\nexport function assertContrastPairs(pairs: ContrastPair[]): void {\n const failures = checkContrastPairs(pairs).filter((result) => result.passes !== true);\n if (failures.length === 0) return;\n\n const detail = failures\n .map(\n (f) =>\n ` ✖ ${f.pair.name}: ${f.label} (mínimo ${f.required}:1 para ${f.target}` +\n `${f.pair.largeText ? \", texto grande\" : \"\"})`,\n )\n .join(\"\\n\");\n\n throw new Error(`Pares de contraste fora do alvo:\\n${detail}`);\n}\n\n/**\n * Lê o valor computado de uma custom property. Serve para o painel medir o que\n * está realmente aplicado na tela, não o que o arquivo de token diz.\n */\nexport function readCssVariable(name: string, element?: Element): string | undefined {\n if (typeof window === \"undefined\") return undefined;\n const target = element ?? document.documentElement;\n const value = window.getComputedStyle(target).getPropertyValue(name).trim();\n return value || undefined;\n}\n"],"names":["SCENARIO_STATUSES","NETWORK_STATES","ID_PATTERN","isNonEmptyString","value","validateScenario","scenario","index","issues","where","err","message","warn","a11y","validateProduct","product","push","level","personaIds","p","fixtureIds","f","ruleIds","r","moduleIds","m","scenarioIds","modulePrefix","rule","matchesAnyRoute","module","flow","step","label","target","defaultSource","a","route","path","definition","matchPathShape","pattern","patternSegments","pathSegments","segment","actual","hasErrors","issue","formatIssues","PARAM","serializeValue","applyOverrides","params","overrides","key","param","getDeployContext","branchUrl","deploymentUrl","commit","env","origin","scenarioUrl","options","url","commitUrl","CONTRAST_THRESHOLDS","NAMED_COLORS","parseColor","input","named","hex","expand","chunk","g","b","pair","values","functional","parts","n","flatten","foreground","background","mix","fg","bg","relativeLuminance","channel","raw","contrastRatio","fgRaw","lighter","darker","checkContrastPair","required","ratio","checkContrastPairs","pairs","assertContrastPairs","failures","result","detail","readCssVariable","name","element"],"mappings":"AAiCO,MAAMA,IAA+C;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAyFaC,IAA0C;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GC7GMC,IAAa;AAEnB,SAASC,EAAiBC,GAAiC;AACzD,SAAO,OAAOA,KAAU,YAAYA,EAAM,KAAA,EAAO,SAAS;AAC5D;AAMO,SAASC,EAAiBC,GAAoBC,GAAmC;AACtF,QAAMC,IAA4B,CAAA,GAC5BC,IAAQN,EAAiBG,GAAU,EAAE,IACvC,YAAYA,EAAS,EAAE,KACvB,YAAYC,KAAS,GAAG,KAEtBG,IAAM,CAACC,MAAoBH,EAAO,KAAK,EAAE,OAAO,SAAS,OAAAC,GAAO,SAAAE,GAAS,GACzEC,IAAO,CAACD,MAAoBH,EAAO,KAAK,EAAE,OAAO,WAAW,OAAAC,GAAO,SAAAE,GAAS;AAElF,EAAKR,EAAiBG,GAAU,EAAE,IAEtBJ,EAAW,KAAKI,EAAS,EAAE,IAI3BA,EAAS,GAAG,SAAS,GAAG,KAClCM,EAAK,uEAAuE,IAJ5EF;AAAA,IACE;AAAA,EAAA,IAHFA,EAAI,qBAAqB,GAStBP,EAAiBG,GAAU,KAAK,KACnCI,EAAI,6DAA6D,GAG9DP,EAAiBG,GAAU,KAAK,IAEzBA,EAAS,MAAM,WAAW,GAAG,KACvCI,EAAI,+BAA+B,IAFnCA,EAAI,wBAAwB,GAKzBP,EAAiBG,GAAU,OAAO,OAAO,0BAA0B,GACnEH,EAAiBG,GAAU,OAAO,KACrCI,EAAI,wEAAwE,GAGzEV,EAAkB,SAASM,GAAU,MAAM,KAC9CI,EAAI,8BAA8BV,EAAkB,KAAK,IAAI,CAAC,GAAG,GAG/DM,GAAU,WAAW,CAACL,EAAe,SAASK,EAAS,OAAO,KAChEI,EAAI,+BAA+BT,EAAe,KAAK,IAAI,CAAC,GAAG;AAGjE,QAAMY,IAAOP,GAAU;AACvB,SAAI,CAACO,KAAQ,OAAOA,KAAS,WAC3BH;AAAA,IACE;AAAA,EAAA,KAGG,CAAC,QAAQ,WAAW,gBAAgB,EAAE,SAASG,EAAK,QAAQ,KAC/DH,EAAI,iEAAiE,GAElE,CAAC,MAAM,KAAK,EAAE,SAASG,EAAK,QAAQ,KACvCH,EAAI,yEAAyE,GAE3EG,EAAK,cAAc,UAAa,CAAC,MAAM,QAAQA,EAAK,SAAS,KAC/DH,EAAI,qEAAqE,IAOzEJ,GAAU,WAAW,cAAcO,GAAM,aAAa,aACxDD;AAAA,IACE;AAAA,EAAA,GAIAN,GAAU,WAAW,cAAc,CAACA,EAAS,cAC/CM;AAAA,IACE;AAAA,EAAA,GAICN,GAAU,UAAU,UACvBM;AAAA,IACE;AAAA,EAAA,GAIGJ;AACT;AAMO,SAASM,EAAgBC,GAA+C;AAC7E,QAAMP,IAA4B,CAAA,GAC5BQ,IAAO,CAACC,GAAiCR,GAAeE,MAC5DH,EAAO,KAAK,EAAE,OAAAS,GAAO,OAAAR,GAAO,SAAAE,EAAA,CAAS,GAEjCO,IAAa,IAAI,IAAIH,EAAQ,UAAU,IAAI,CAACI,MAAMA,EAAE,EAAE,KAAK,CAAA,CAAE,GAC7DC,IAAa,IAAI,IAAIL,EAAQ,UAAU,IAAI,CAACM,MAAMA,EAAE,EAAE,KAAK,CAAA,CAAE,GAC7DC,IAAU,IAAI,IAAIP,EAAQ,OAAO,IAAI,CAACQ,MAAMA,EAAE,EAAE,KAAK,CAAA,CAAE,GACvDC,IAAY,IAAI,IAAIT,EAAQ,SAAS,IAAI,CAACU,MAAMA,EAAE,EAAE,KAAK,CAAA,CAAE,GAC3DC,wBAAkB,IAAA;AAExB,EAAKvB,EAAiBY,EAAQ,EAAE,KAAGC,EAAK,SAAS,WAAW,qBAAqB,GAC5Eb,EAAiBY,EAAQ,IAAI,KAAGC,EAAK,SAAS,WAAW,uBAAuB,GAChFD,EAAQ,QAAQ,UACnBC,EAAK,SAAS,WAAW,4DAA4D;AAGvF,aAAW,CAACT,GAAOD,CAAQ,MAAMS,EAAQ,aAAa,IAAI,WAAW;AACnE,IAAAP,EAAO,KAAK,GAAGH,EAAiBC,GAAUC,CAAK,CAAC;AAEhD,UAAME,IAAQ,YAAYH,GAAU,MAAMC,CAAK;AAE/C,QAAID,GAAU,IAAI;AAChB,MAAIoB,EAAY,IAAIpB,EAAS,EAAE,KAC7BU,EAAK,SAASP,GAAO,qBAAqBH,EAAS,EAAE,GAAG,GAE1DoB,EAAY,IAAIpB,EAAS,EAAE;AAE3B,YAAMqB,IAAerB,EAAS,GAAG,MAAM,GAAG,EAAE,CAAC;AAC7C,MAAIqB,KAAgBH,EAAU,OAAO,KAAK,CAACA,EAAU,IAAIG,CAAY,KACnEX;AAAA,QACE;AAAA,QACAP;AAAA,QACA,aAAakB,CAAY;AAAA,MAAA;AAAA,IAG/B;AAEA,IAAIrB,GAAU,WAAW,CAACY,EAAW,IAAIZ,EAAS,OAAO,KACvDU,EAAK,SAASP,GAAO,6BAA6BH,EAAS,OAAO,KAAK,GAErEA,GAAU,WAAW,CAACc,EAAW,IAAId,EAAS,OAAO,KACvDU,EAAK,SAASP,GAAO,6BAA6BH,EAAS,OAAO,KAAK;AAEzE,eAAWsB,KAAQtB,GAAU,SAAS,CAAA;AACpC,MAAKgB,EAAQ,IAAIM,CAAI,KACnBZ,EAAK,SAASP,GAAO,2BAA2BmB,CAAI,KAAK;AAG7D,IAAItB,GAAU,SAAS,CAACuB,EAAgBvB,EAAS,OAAOS,CAAO,KAC7DC;AAAA,MACE;AAAA,MACAP;AAAA,MACA,UAAUH,EAAS,KAAK;AAAA,IAAA;AAAA,EAG9B;AAEA,aAAWwB,KAAUf,EAAQ,WAAW,CAAA;AACtC,eAAWgB,KAAQD,EAAO,SAAS,CAAA,GAAI;AACrC,YAAMrB,IAAQ,QAAQqB,EAAO,EAAE,IAAIC,EAAK,EAAE;AAC1C,MAAKA,EAAK,OAAO,UAAQf,EAAK,WAAWP,GAAO,qBAAqB;AACrE,iBAAWuB,KAAQD,EAAK,SAAS,CAAA,GAAI;AACnC,QAAKL,EAAY,IAAIM,EAAK,QAAQ,KAChChB,EAAK,SAASP,GAAO,4CAA4CuB,EAAK,QAAQ,KAAK;AAErF,mBAAW,CAACC,GAAOC,CAAM,KAAK,OAAO,QAAQF,EAAK,YAAY,CAAA,CAAE;AAC9D,UAAKN,EAAY,IAAIQ,CAAM,KACzBlB;AAAA,YACE;AAAA,YACAP;AAAA,YACA,gBAAgBwB,CAAK,wCAAwCC,CAAM;AAAA,UAAA;AAAA,MAI3E;AAAA,IACF;AAGF,QAAMC,IAAgBpB,EAAQ,aAAa;AAC3C,SAAIoB,KAAiBA,MAAkB,eAClB,IAAI,IAAIpB,EAAQ,aAAa,UAAU,IAAI,CAACqB,MAAMA,EAAE,EAAE,KAAK,CAAA,CAAE,EAChE,IAAID,CAAa,KAC/BnB,EAAK,SAAS,WAAW,8DAA8DmB,CAAa,KAAK,GAE3GnB;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IAIGR;AACT;AAEA,SAASqB,EAAgBQ,GAAetB,GAAqC;AAC3E,QAAMuB,IAAOD,EAAM,MAAM,GAAG,EAAE,CAAC,KAAKA;AACpC,UAAQtB,EAAQ,UAAU,CAAA,GAAI,KAAK,CAACwB,MAAeC,EAAeD,EAAW,MAAMD,CAAI,CAAC;AAC1F;AAMA,SAASE,EAAeC,GAAiBH,GAAuB;AAC9D,QAAMI,IAAkBD,EAAQ,MAAM,GAAG,EAAE,OAAO,OAAO,GACnDE,IAAeL,EAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAEnD,aAAW,CAAC/B,GAAOqC,CAAO,KAAKF,EAAgB,WAAW;AACxD,QAAIE,MAAY,IAAK,QAAO;AAC5B,UAAMC,IAASF,EAAapC,CAAK;AACjC,QAAIsC,MAAW,OAAW,QAAO;AACjC,QAAI,CAAAD,EAAQ,WAAW,GAAG,KACtBA,MAAYC;AAAQ,aAAO;AAAA,EACjC;AAEA,SAAOH,EAAgB,WAAWC,EAAa;AACjD;AAGO,SAASG,EAAUtC,GAAoC;AAC5D,SAAOA,EAAO,KAAK,CAACuC,MAAUA,EAAM,UAAU,OAAO;AACvD;AAGO,SAASC,EAAaxC,GAAmC;AAC9D,SAAIA,EAAO,WAAW,IAAU,gCACzBA,EACJ,IAAI,CAACuC,MAAU,GAAGA,EAAM,UAAU,UAAU,MAAM,GAAG,IAAIA,EAAM,KAAK;AAAA,IAAOA,EAAM,OAAO,EAAE,EAC1F,KAAK;AAAA,CAAI;AACd;ACjPO,MAAME,IAAQ;AAAA,EACnB,UAAU;AAAA,EACV,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,UAAU;AAAA,EACV,aAAa;AAAA,EACb,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,eAAe;AAAA,EACf,WAAW;AAAA,EACX,WAAW;AACb;AAQO,SAASC,EAAe9C,GAAwB;AACrD,SAAI,OAAOA,KAAU,YAAkBA,IAAQ,MAAM,MAC9C,OAAOA,CAAK;AACrB;AAMO,SAAS+C,EACdC,GACAC,IAAoC,IAC9B;AACN,aAAW,CAACC,GAAKlD,CAAK,KAAK,OAAO,QAAQiD,CAAS,GAAG;AACpD,QAA2BjD,KAAU,KAAM;AAC3C,UAAMmD,IAAQN,EAAMK,CAA0B;AAC9C,IAAKC,KACLH,EAAO,IAAIG,GAAOL,EAAe9C,CAAK,CAAC;AAAA,EACzC;AACF;ACNO,SAASoD,EAAiBH,IAA6B,IAAmB;AAC/E,QAAMI,IAAYJ,EAAU,aAAa,QACnCK,IAAgBL,EAAU,iBAAiB,QAC3CM,IAASN,EAAU,UAAU,QAC7BO,IAAMP,EAAU,OAAO,eAKvBQ,IACHJ,KAAa,WAAWA,CAAS,MACjCC,KAAiB,WAAWA,CAAa,OACzC,OAAO,SAAW,MAAc,OAAO,SAAS,SAAS;AAE5D,SAAO;AAAA,IACL,KAAAE;AAAA,IACA,QAAQC,EAAO,QAAQ,OAAO,EAAE;AAAA,IAChC,WAAAJ;AAAA,IACA,eAAAC;AAAA,IACA,QAAQL,EAAU,UAAU;AAAA,IAC5B,QAAAM;AAAA,IACA,aAAaA,GAAQ,MAAM,GAAG,CAAC;AAAA,IAC/B,YAAYC,MAAQ,aAAaA,MAAQ;AAAA,EAAA;AAE7C;AAOO,SAASE,EACdxD,GACAyD,IAAmE,IAC3D;AACR,QAAMF,IAASE,EAAQ,UAAUP,EAAA,EAAmB,QAC9CQ,IAAM,IAAI,IAAI1D,EAAS,OAAOuD,CAAM;AAE1C,SAAAG,EAAI,aAAa,IAAIf,EAAM,UAAU3C,EAAS,EAAE,GAChD0D,EAAI,aAAa,IAAIf,EAAM,SAAS3C,EAAS,OAAO,GACpD0D,EAAI,aAAa,IAAIf,EAAM,SAAS3C,EAAS,OAAO,GAChDA,EAAS,WAAWA,EAAS,YAAY,aAC3C0D,EAAI,aAAa,IAAIf,EAAM,SAAS3C,EAAS,OAAO,GAGtD6C,EAAea,EAAI,cAAcD,EAAQ,SAAS,GAE3CC,EAAI,SAAA;AACb;AAiBO,SAASC,EACd3D,GACAyD,GACoB;AACpB,QAAMJ,IAASI,EAAQ,UAAUP,EAAA,EAAmB;AACpD,MAAI,CAACG,EAAQ;AAEb,QAAME,IAASE,EAAQ,SACpB,WAAW,iBAAiBJ,EAAO,MAAM,GAAG,CAAC,CAAC,EAC9C,WAAW,YAAYA,CAAM;AAEhC,SAAOG,EAAYxD,GAAU,EAAE,QAAAuD,GAAQ;AACzC;AC7GO,MAAMK,IAAsB;AAAA,EACjC,IAAI,EAAE,QAAQ,KAAK,OAAO,EAAA;AAAA,EAC1B,KAAK,EAAE,QAAQ,GAAG,OAAO,IAAA;AAC3B,GAEMC,IAAuC;AAAA,EAC3C,OAAO;AAAA,EACP,OAAO;AAAA,EACP,aAAa;AACf;AAQO,SAASC,EAAWC,GAAgC;AACzD,QAAMjE,IAAQiE,EAAM,KAAA,EAAO,YAAA,GACrBC,IAAQH,EAAa/D,CAAK;AAChC,MAAIkE,EAAO,QAAOF,EAAWE,CAAK;AAElC,MAAIlE,EAAM,WAAW,GAAG,GAAG;AACzB,UAAMmE,IAAMnE,EAAM,MAAM,CAAC,GACnBoE,IAAS,CAACC,MAAkB,OAAO,SAASA,EAAM,OAAO,CAAC,GAAG,EAAE;AAErE,QAAIF,EAAI,WAAW,KAAKA,EAAI,WAAW,GAAG;AACxC,YAAM,CAAChD,GAAGmD,GAAGC,GAAGvC,CAAC,IAAI,CAAC,GAAGmC,CAAG;AAC5B,aAAI,CAAChD,KAAK,CAACmD,KAAK,CAACC,IAAG,SACb,EAAE,GAAGH,EAAOjD,CAAC,GAAG,GAAGiD,EAAOE,CAAC,GAAG,GAAGF,EAAOG,CAAC,GAAG,GAAGvC,IAAIoC,EAAOpC,CAAC,IAAI,MAAM,EAAA;AAAA,IAC9E;AAEA,QAAImC,EAAI,WAAW,KAAKA,EAAI,WAAW,GAAG;AACxC,YAAMK,IAAO,CAACrE,MAAkB,OAAO,SAASgE,EAAI,MAAMhE,GAAOA,IAAQ,CAAC,GAAG,EAAE,GACzEsE,IAAS,CAACD,EAAK,CAAC,GAAGA,EAAK,CAAC,GAAGA,EAAK,CAAC,CAAC;AACzC,aAAIC,EAAO,KAAK,OAAO,KAAK,IAAG,SACxB;AAAA,QACL,GAAGA,EAAO,CAAC;AAAA,QACX,GAAGA,EAAO,CAAC;AAAA,QACX,GAAGA,EAAO,CAAC;AAAA,QACX,GAAGN,EAAI,WAAW,IAAIK,EAAK,CAAC,IAAI,MAAM;AAAA,MAAA;AAAA,IAE1C;AAEA;AAAA,EACF;AAEA,QAAME,IAAa1E,EAAM,MAAM,oBAAoB;AACnD,MAAI0E,IAAa,CAAC,GAAG;AACnB,UAAMC,IAAQD,EAAW,CAAC,EAAE,MAAM,SAAS,EAAE,OAAO,OAAO,GACrD,CAACvD,GAAGmD,GAAGC,GAAGvC,CAAC,IAAI2C,EAAM,IAAI,MAAM;AACrC,WAAI,CAACxD,GAAGmD,GAAGC,CAAC,EAAE,KAAK,CAACK,MAAMA,MAAM,UAAa,OAAO,MAAMA,CAAC,CAAC,IAAG,SACxD,EAAE,GAAAzD,GAAO,GAAAmD,GAAO,GAAAC,GAAO,GAAGvC,MAAM,UAAa,OAAO,MAAMA,CAAC,IAAI,IAAIA,EAAA;AAAA,EAC5E;AAGF;AASO,SAAS6C,EAAQC,GAAiBC,GAAsB;AAC7D,MAAID,EAAW,KAAK,EAAG,QAAOA;AAC9B,QAAME,IAAM,CAACC,GAAYC,MAAeD,IAAKH,EAAW,IAAII,KAAM,IAAIJ,EAAW;AACjF,SAAO;AAAA,IACL,GAAGE,EAAIF,EAAW,GAAGC,EAAW,CAAC;AAAA,IACjC,GAAGC,EAAIF,EAAW,GAAGC,EAAW,CAAC;AAAA,IACjC,GAAGC,EAAIF,EAAW,GAAGC,EAAW,CAAC;AAAA,IACjC,GAAG;AAAA,EAAA;AAEP;AAGO,SAASI,EAAkB,EAAE,GAAAhE,GAAG,GAAAmD,GAAG,GAAAC,KAAkB;AAC1D,QAAMa,IAAU,CAACC,MAAgB;AAC/B,UAAMrF,IAAQqF,IAAM;AACpB,WAAOrF,KAAS,UAAUA,IAAQ,UAAUA,IAAQ,SAAS,UAAU;AAAA,EACzE;AACA,SAAO,SAASoF,EAAQjE,CAAC,IAAI,SAASiE,EAAQd,CAAC,IAAI,SAASc,EAAQb,CAAC;AACvE;AAGO,SAASe,EAAcR,GAAoBC,GAAwC;AACxF,QAAMG,IAAKlB,EAAWe,CAAU,GAC1BQ,IAAQvB,EAAWc,CAAU;AACnC,MAAI,CAACI,KAAM,CAACK,EAAO;AAEnB,QAAMN,IAAKJ,EAAQU,GAAOL,CAAE,GACtBM,IAAU,KAAK,IAAIL,EAAkBF,CAAE,GAAGE,EAAkBD,CAAE,CAAC,GAC/DO,IAAS,KAAK,IAAIN,EAAkBF,CAAE,GAAGE,EAAkBD,CAAE,CAAC;AACpE,UAAQM,IAAU,SAASC,IAAS;AACtC;AAcO,SAASC,EAAkBlB,GAAoC;AACpE,QAAM1C,IAAS0C,EAAK,UAAU,MACxBmB,IAAWnB,EAAK,YAClBV,EAAoBhC,CAAM,EAAE,QAC5BgC,EAAoBhC,CAAM,EAAE,QAC1B8D,IAAQN,EAAcd,EAAK,YAAYA,EAAK,UAAU;AAE5D,SAAO;AAAA,IACL,MAAAA;AAAA,IACA,QAAA1C;AAAA,IACA,OAAA8D;AAAA,IACA,UAAAD;AAAA,IACA,QAAQC,MAAU,SAAY,SAAYA,KAASD;AAAA,IACnD,OAAOC,MAAU,SAAY,eAAe,GAAGA,EAAM,QAAQ,CAAC,CAAC;AAAA,EAAA;AAEnE;AAEO,SAASC,EAAmBC,IAAwB,IAAsB;AAC/E,SAAOA,EAAM,IAAIJ,CAAiB;AACpC;AAQO,SAASK,EAAoBD,GAA6B;AAC/D,QAAME,IAAWH,EAAmBC,CAAK,EAAE,OAAO,CAACG,MAAWA,EAAO,WAAW,EAAI;AACpF,MAAID,EAAS,WAAW,EAAG;AAE3B,QAAME,IAASF,EACZ;AAAA,IACC,CAAC/E,MACC,OAAOA,EAAE,KAAK,IAAI,KAAKA,EAAE,KAAK,YAAYA,EAAE,QAAQ,WAAWA,EAAE,MAAM,GACpEA,EAAE,KAAK,YAAY,mBAAmB,EAAE;AAAA,EAAA,EAE9C,KAAK;AAAA,CAAI;AAEZ,QAAM,IAAI,MAAM;AAAA,EAAqCiF,CAAM,EAAE;AAC/D;AAMO,SAASC,EAAgBC,GAAcC,GAAuC;AACnF,MAAI,OAAO,SAAW,IAAa;AACnC,QAAMvE,IAASuE,KAAW,SAAS;AAEnC,SADc,OAAO,iBAAiBvE,CAAM,EAAE,iBAAiBsE,CAAI,EAAE,KAAA,KACrD;AAClB;"}
|