@brucesantos/design-space 0.2.0 → 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 +50 -0
- package/README.md +74 -1
- package/dist/contrast-87-ijttm.js +268 -0
- package/dist/contrast-87-ijttm.js.map +1 -0
- package/dist/controls/params.d.ts +2 -0
- package/dist/controls/state.d.ts +2 -0
- package/dist/design-space.css +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.js +1151 -802
- package/dist/index.js.map +1 -1
- package/dist/registry/index.d.ts +2 -1
- package/dist/shell/Controls.d.ts +2 -1
- package/dist/shell/Inspector.d.ts +3 -2
- package/dist/shell/Sidebar.d.ts +8 -2
- package/dist/shell/Topbar.d.ts +6 -5
- package/dist/shell/labels.d.ts +19 -0
- package/dist/testing/index.d.ts +4 -4
- package/dist/testing.js +2 -2
- package/dist/testing.js.map +1 -1
- package/dist/types/index.d.ts +26 -1
- package/package.json +2 -2
- package/dist/contrast-BXd_acxo.js +0 -260
- package/dist/contrast-BXd_acxo.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,56 @@ 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
|
+
|
|
9
59
|
## 0.2.0
|
|
10
60
|
|
|
11
61
|
Hospedagem deixa de ser suposição do motor. Um Design Space que roda só na
|
package/README.md
CHANGED
|
@@ -56,6 +56,25 @@ motor.
|
|
|
56
56
|
projeto: um cenário de ação bloqueada em que o bloqueio não é anunciado para leitor
|
|
57
57
|
de tela está incompleto, não está pronto para aprovação.
|
|
58
58
|
|
|
59
|
+
### Ciclo de vida
|
|
60
|
+
|
|
61
|
+
O estado diz o que o cenário representa; importar uma tela existente não a torna
|
|
62
|
+
proposta nem compromisso de implementação.
|
|
63
|
+
|
|
64
|
+
| Valor | Rótulo padrão | Significado |
|
|
65
|
+
| --- | --- | --- |
|
|
66
|
+
| `ported` | Portado — não validado | Veio do sistema existente, mas não foi validado e não representa compromisso de implementação. |
|
|
67
|
+
| `proposed` | Proposta | Exploração ainda não aprovada. |
|
|
68
|
+
| `in-review` | Em revisão | Aberto para validação de design, negócio ou cliente. |
|
|
69
|
+
| `approved` | Aprovado | Referência autorizada, registrada por URL de commit. |
|
|
70
|
+
| `in-implementation` | Em implementação | Ligado a um trabalho ativo de engenharia. |
|
|
71
|
+
| `implemented` | Implementado | Disponível no produto real e validado. |
|
|
72
|
+
| `superseded` | Superado | Mantido para histórico ou substituído por outra decisão. |
|
|
73
|
+
|
|
74
|
+
`scenariosUnderTest()` inclui por padrão apenas `approved`, `in-implementation` e
|
|
75
|
+
`implemented`. Cenários `ported` ficam fora até serem promovidos, mas podem ser
|
|
76
|
+
selecionados explicitamente pelo segundo argumento.
|
|
77
|
+
|
|
59
78
|
## A URL é o estado
|
|
60
79
|
|
|
61
80
|
Todo controle é serializado na query string, então a mesma URL sempre produz a
|
|
@@ -65,12 +84,14 @@ rede declarados no cenário.
|
|
|
65
84
|
| Parâmetro | Efeito |
|
|
66
85
|
| --- | --- |
|
|
67
86
|
| `scenario` | Cenário ativo. Define os padrões dos demais. |
|
|
87
|
+
| `component` | Referência ativa no catálogo visual do produto. |
|
|
68
88
|
| `persona` | Troca o papel e as permissões. |
|
|
69
89
|
| `fixture` | Troca o conjunto de dados. |
|
|
70
90
|
| `network` | `success`, `loading`, `empty`, `error`, `slow`. |
|
|
71
91
|
| `viewport` | `fit`, `mobile`, `tablet`, `desktop`, `custom`. |
|
|
72
92
|
| `w` | Largura, quando `viewport=custom`. |
|
|
73
93
|
| `theme`, `locale`, `source` | Variações declaradas pelo produto. |
|
|
94
|
+
| `appearance` | Aparência do chrome: omitido para dark, `light` para modo claro. |
|
|
74
95
|
| `chrome=0` | Revisão limpa: oculta o chrome do ambiente. |
|
|
75
96
|
| `kb=1` | Modo teclado, com ordem de tabulação evidenciada. |
|
|
76
97
|
| `motion=1` | Movimento reduzido no palco. |
|
|
@@ -102,6 +123,7 @@ theme: {
|
|
|
102
123
|
```
|
|
103
124
|
|
|
104
125
|
- `DEFAULT_LABELS` — o dicionário completo, em português.
|
|
126
|
+
- `EN_US_LABELS` — o dicionário completo em inglês dos Estados Unidos.
|
|
105
127
|
- `resolveLabels(override)` — mescla por grupo. Útil fora de React.
|
|
106
128
|
- `useLabels()` — os rótulos resolvidos, dentro do chrome.
|
|
107
129
|
- `Labels`, `LabelsOverride` — os tipos.
|
|
@@ -109,6 +131,26 @@ theme: {
|
|
|
109
131
|
Rótulo de **produto** continua vindo do produto: nome de módulo, título de cenário,
|
|
110
132
|
nome de persona, rótulo de fixture.
|
|
111
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
|
+
|
|
112
154
|
### Registry e validação
|
|
113
155
|
|
|
114
156
|
- `createRegistry(product)` — índice consultável: busca por vocabulário de
|
|
@@ -117,6 +159,29 @@ nome de persona, rótulo de fixture.
|
|
|
117
159
|
do contrato. Pega fixture, persona, regra ou rota inexistente, que o TypeScript
|
|
118
160
|
não alcança.
|
|
119
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
|
+
|
|
120
185
|
### Deploy e deep links
|
|
121
186
|
|
|
122
187
|
O motor não conhece provedor de hospedagem, e um Design Space que roda só local é
|
|
@@ -163,10 +228,18 @@ preview.
|
|
|
163
228
|
|
|
164
229
|
| Atalho | Efeito |
|
|
165
230
|
| --- | --- |
|
|
166
|
-
| `
|
|
231
|
+
| `Command/Ctrl` + `K` ou `F` | Foco na busca da lateral |
|
|
232
|
+
| `↑` / `↓` | Percorrer resultados filtrados |
|
|
167
233
|
| `Shift` + `K` | Modo teclado |
|
|
168
234
|
| `Shift` + `P` | Painel de contexto |
|
|
169
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
|
+
|
|
170
243
|
## Fronteira
|
|
171
244
|
|
|
172
245
|
O motor **não** contém e não deve conter: componente visual, token, tipografia,
|
|
@@ -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
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contrast-87-ijttm.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 | \"ported\"\n | \"proposed\"\n | \"in-review\"\n | \"approved\"\n | \"in-implementation\"\n | \"implemented\"\n | \"superseded\";\n\nexport const SCENARIO_STATUSES: readonly ScenarioStatus[] = [\n \"ported\",\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 * Componente do produto exposto no catálogo do Design Space.\n *\n * O motor só organiza e renderiza a referência. Implementação, aparência e\n * conteúdo continuam no repositório do produto.\n */\nexport type ComponentPreview = {\n /** Identificador estável usado no deep link: `button.primary`. */\n id: string;\n /** Nome legível no vocabulário do produto. */\n name: string;\n /** Grupo de navegação: `Ações`, `Formulários`, `Feedback`. */\n group?: string;\n description?: string;\n /** Composição visual fornecida e mantida pelo produto. */\n preview: ComponentType;\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 /** Catálogo visual opcional, implementado integralmente pelo produto. */\n components?: ComponentPreview[];\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/** Aparência do chrome do Design Space. Não altera o tema da UI do produto. */\nexport type ChromeTheme = \"dark\" | \"light\";\n\n/* ------------------------------------------------------------------ *\n * Estado dos controles — serializado na URL (deep link)\n * ------------------------------------------------------------------ */\n\nexport type ControlsState = {\n scenario: string | undefined;\n /** Referência visual ativa. Opcional para preservar objetos do contrato anterior. */\n component?: string;\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 /** Tema visual do chrome; independente de `themeMode` do produto. */\n chromeTheme?: ChromeTheme;\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 const componentIds = new Set<string>();\n for (const [index, component] of (product.components ?? []).entries()) {\n const where = `component:${component?.id ?? index}`;\n if (!isNonEmptyString(component?.id)) {\n push(\"error\", where, \"`id` é obrigatório.\");\n } else if (!ID_PATTERN.test(component.id)) {\n push(\"error\", where, \"`id` deve ser minúsculo em kebab-case ou usar pontos para agrupamento.\");\n } else if (componentIds.has(component.id)) {\n push(\"error\", where, `\\`id\\` duplicado: ${component.id}.`);\n } else {\n componentIds.add(component.id);\n }\n if (!isNonEmptyString(component?.name)) push(\"error\", where, \"`name` é obrigatório.\");\n if (typeof component?.preview !== \"function\") push(\"error\", where, \"`preview` é obrigatório.\");\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 component: \"component\",\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 chromeTheme: \"appearance\",\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","componentIds","component","modulePrefix","rule","matchesAnyRoute","module","flow","step","label","target","defaultSource","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","a","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":"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"}
|
|
@@ -2,6 +2,7 @@ import { ControlsState } from '../types/index.js';
|
|
|
2
2
|
/** Nomes curtos: a URL é colada em Slack, em ticket e em thread de revisão. */
|
|
3
3
|
export declare const PARAM: {
|
|
4
4
|
readonly scenario: "scenario";
|
|
5
|
+
readonly component: "component";
|
|
5
6
|
readonly persona: "persona";
|
|
6
7
|
readonly fixture: "fixture";
|
|
7
8
|
readonly network: "network";
|
|
@@ -10,6 +11,7 @@ export declare const PARAM: {
|
|
|
10
11
|
readonly themeMode: "theme";
|
|
11
12
|
readonly locale: "locale";
|
|
12
13
|
readonly dataSource: "source";
|
|
14
|
+
readonly chromeTheme: "appearance";
|
|
13
15
|
readonly chrome: "chrome";
|
|
14
16
|
readonly keyboardMode: "kb";
|
|
15
17
|
readonly reducedMotion: "motion";
|
package/dist/controls/state.d.ts
CHANGED
|
@@ -33,6 +33,8 @@ export type DesignSpaceState = {
|
|
|
33
33
|
* voltar ao desktop a cada troca de situação.
|
|
34
34
|
*/
|
|
35
35
|
openScenario: (scenarioId: string) => void;
|
|
36
|
+
/** Abre uma referência do catálogo de componentes. */
|
|
37
|
+
openComponent: (componentId: string) => void;
|
|
36
38
|
};
|
|
37
39
|
/**
|
|
38
40
|
* Fonte única de verdade da navegação e dos controles. Usa a History API
|