@brucesantos/design-space 0.2.0 → 0.4.0

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