@brucesantos/design-space 0.1.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 ADDED
@@ -0,0 +1,76 @@
1
+ # Changelog
2
+
3
+ Versionamento semântico. **Patch** para correção sem mudança de contrato,
4
+ **minor** para funcionalidade compatível, **major** para mudança incompatível.
5
+
6
+ Mudança estrutural — pasta obrigatória nova, schema de cenário alterado — exige
7
+ comando explícito e revisável, nunca merge silencioso.
8
+
9
+ ## 0.1.0 — não publicado
10
+
11
+ Primeira versão do motor. Fase 1 do roadmap.
12
+
13
+ ### Adicionado
14
+
15
+ - **Contratos** (`types/`): `Scenario`, `Persona`, `Rule`, `Fixture`, `Module`,
16
+ `Flow`, `ProductDefinition`, `ScenarioContext`, `A11yContract`. `a11y` é campo
17
+ obrigatório do cenário.
18
+ - **Registry** (`createRegistry`): árvore de módulos, busca por vocabulário de
19
+ negócio sem acento, cobertura por status, resolução de permissões efetivas.
20
+ - **Validação em runtime** (`validateProduct`, `validateScenario`): forma do
21
+ cenário e integridade de referências entre cenário, persona, fixture, regra e
22
+ rota.
23
+ - **Shell**: mapa de situações na raiz, navegação por módulo, painel de contexto
24
+ com abas de cenário, acessibilidade e diagnóstico, barra de controles e modo de
25
+ revisão limpa.
26
+ - **Roteamento declarativo** sem dependência externa, com casamento de
27
+ especificidade e parâmetros dinâmicos.
28
+ - **Deep links**: a URL é o estado. Todo controle é serializado, com precedência
29
+ de parâmetro explícito sobre valor declarado no cenário.
30
+ - **Contexto de deployment** (`getDeployContext`, `scenarioUrl`, `commitUrl`):
31
+ monta a URL absoluta de qualquer cenário sem domínio hardcoded.
32
+ - **Adapters**: `fixtureAdapter` como padrão, materializando os cinco estados de
33
+ rede; `createHttpAdapter` com fallback para fixture.
34
+ - **Acessibilidade**: razão de contraste do WCAG 2.x com composição de alfa,
35
+ `assertContrastPairs` para falhar o build, leitura da árvore acessível do
36
+ elemento em foco e modo teclado com ordem de tabulação evidenciada.
37
+ - **Entrypoint de testes** (`/testing`): `pathFor`, `testOrigin`,
38
+ `assertValidProduct`, recortes de cenário por status.
39
+ - 49 testes unitários cobrindo contraste, roteamento, registry, serialização de
40
+ controles e a fronteira visual do CSS.
41
+
42
+ ### Corrigido durante a construção do primeiro produto
43
+
44
+ - **Vazamento de estilo do chrome para a UI do produto.** `.ds-root` definia
45
+ `color`, `font-family`, `font-size` e `line-height`. Como o palco é descendente
46
+ dele, todo elemento do produto que não declarava cor própria herdava o
47
+ cinza-claro do chrome — e o axe do produto piloto reprovou as tabelas do
48
+ cliente por contraste de 1.21:1 contra uma cor que o cliente nunca escolheu.
49
+
50
+ As propriedades herdáveis passaram para uma classe `.ds-chrome`, aplicada
51
+ apenas nas regiões do chrome. `src/shell/boundary.test.ts` trava a regressão:
52
+ ele lê o CSS e falha se qualquer propriedade herdável voltar para `.ds-root`,
53
+ se algum seletor alcançar o palco, ou se aparecer regra em elemento nu.
54
+
55
+ - `checkContrastPair`, `checkContrastPairs` e `contrastRatio` passaram a ser
56
+ exportados por `/testing`. O produto valida os próprios tokens; o motor só sabe
57
+ medir.
58
+
59
+ ### Extraído por evidência, depois do segundo produto
60
+
61
+ - **`parseIsoDate`, `ageInYears` e `daysBetween`.** Primeira capacidade a entrar no
62
+ motor pela régua do Princípio 10 — apareceu em dois produtos independentes, não
63
+ carrega aparência e não carrega domínio.
64
+
65
+ O bug de origem: `new Date("2011-09-08")` é meia-noite **UTC** e, formatado em
66
+ qualquer fuso a oeste de Greenwich, exibe o dia anterior. No Bloomy isso
67
+ deslocava a data de nascimento, o cálculo de idade e portanto a regra do paciente
68
+ menor de idade; na Finaya, errava o vencimento da cobrança por um dia. Os dois
69
+ produtos escreveram a mesma correção separadamente, sem saber um do outro.
70
+
71
+ `ageInYears` exige a data de referência como parâmetro obrigatório de propósito:
72
+ um padrão `new Date()` faria fixture depender do relógio.
73
+
74
+ O que **não** foi extraído, e por quê, está em
75
+ `finaya-design-space/docs/decisions/0001`. A régua para a próxima extração:
76
+ **dois produtos, zero aparência, zero domínio.**
package/README.md ADDED
@@ -0,0 +1,146 @@
1
+ # @brucesantos/design-space
2
+
3
+ Motor neutro do Bananas Design Space. Fornece o ambiente — navegação por cenário,
4
+ deep links, controles de persona/dados/viewport/rede, painel de contexto e
5
+ ferramentas de acessibilidade — sem impor nenhum componente visual, token ou
6
+ identidade ao produto.
7
+
8
+ ```bash
9
+ pnpm add @brucesantos/design-space
10
+ ```
11
+
12
+ ## Uso
13
+
14
+ O produto entrega uma `ProductDefinition` e monta um único componente.
15
+
16
+ ```tsx
17
+ import { DesignSpace } from "@brucesantos/design-space";
18
+ import "@brucesantos/design-space/styles.css";
19
+ import { productDefinition } from "./product";
20
+
21
+ export function App() {
22
+ return <DesignSpace product={productDefinition} />;
23
+ }
24
+ ```
25
+
26
+ ## O contrato de cenário
27
+
28
+ Um cenário combina intenção, persona, permissões, pré-condições, dados, ações,
29
+ regras e resultado esperado. É a unidade central: não é uma tela com dados
30
+ diferentes.
31
+
32
+ ```ts
33
+ import type { Scenario } from "@brucesantos/design-space";
34
+
35
+ export const insuranceDenied: Scenario = {
36
+ id: "finance.insurance-denied",
37
+ title: "Convênio recusado",
38
+ route: "/finance/claims/CLM-1042",
39
+ persona: "financial-analyst",
40
+ permissions: ["claims.read", "claims.retry"],
41
+ fixture: "claim-denied-unimed",
42
+ rules: ["retry-after-document-review"],
43
+ a11y: {
44
+ keyboard: "full",
45
+ contrast: "AA",
46
+ announces: ["claim.status", "retry.result"],
47
+ },
48
+ status: "approved",
49
+ };
50
+ ```
51
+
52
+ `a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de
53
+ projeto: um cenário de convênio recusado em que a recusa não é anunciada para
54
+ leitor de tela está incompleto, não está pronto para aprovação.
55
+
56
+ ## A URL é o estado
57
+
58
+ Todo controle é serializado na query string, então a mesma URL sempre produz a
59
+ mesma situação. `?scenario=<id>` sozinho já herda persona, fixture e estado de
60
+ rede declarados no cenário.
61
+
62
+ | Parâmetro | Efeito |
63
+ | --- | --- |
64
+ | `scenario` | Cenário ativo. Define os padrões dos demais. |
65
+ | `persona` | Troca o papel e as permissões. |
66
+ | `fixture` | Troca o conjunto de dados. |
67
+ | `network` | `success`, `loading`, `empty`, `error`, `slow`. |
68
+ | `viewport` | `fit`, `mobile`, `tablet`, `desktop`, `custom`. |
69
+ | `w` | Largura, quando `viewport=custom`. |
70
+ | `theme`, `locale`, `source` | Variações declaradas pelo produto. |
71
+ | `chrome=0` | Revisão limpa: oculta o chrome do ambiente. |
72
+ | `kb=1` | Modo teclado, com ordem de tabulação evidenciada. |
73
+ | `motion=1` | Movimento reduzido no palco. |
74
+ | `scale` | Ampliação de texto: `1`, `1.25`, `1.5`, `2`. |
75
+ | `panel=0` | Oculta o painel de contexto. |
76
+
77
+ ## API
78
+
79
+ ### Shell
80
+
81
+ - `DesignSpace` — o ambiente completo.
82
+ - `Home` — mapa de situações, usado na raiz.
83
+ - `Stage`, `StageEmpty`, `TabOrderOverlay` — partes do palco, expostas para casos
84
+ fora do padrão.
85
+
86
+ ### Registry e validação
87
+
88
+ - `createRegistry(product)` — índice consultável: busca por vocabulário de
89
+ negócio, árvore de módulos, cobertura por status.
90
+ - `validateProduct(product)` / `validateScenario(scenario)` — validação em runtime
91
+ do contrato. Pega fixture, persona, regra ou rota inexistente, que o TypeScript
92
+ não alcança.
93
+
94
+ ### Deploy e deep links
95
+
96
+ - `getDeployContext()` — lê o contexto da Vercel: branch, commit, ambiente,
97
+ origem absoluta.
98
+ - `scenarioUrl(scenario, options)` — URL absoluta reproduzível.
99
+ - `commitUrl(scenario, options)` — URL imutável para registrar aprovação.
100
+
101
+ ### Dados
102
+
103
+ - `fixtureAdapter` — o padrão. Materializa os cinco estados de rede.
104
+ - `createHttpAdapter(options)` — adapter REST/GraphQL com fallback para fixture.
105
+ - `useScenarioData(...)` — resolução do cenário ativo pelo adapter selecionado.
106
+
107
+ ### Acessibilidade
108
+
109
+ - `contrastRatio(fg, bg)`, `checkContrastPairs(pairs)`, `assertContrastPairs(pairs)`
110
+ — razão de contraste do WCAG 2.x, com composição de alfa sobre o fundo.
111
+ `assertContrastPairs` falha o build a partir de um teste do produto.
112
+ - `describeElement(el)` — papel, nome acessível, origem do nome e estados.
113
+ - `tabbableElements(root)` — ordem de tabulação real.
114
+ - `useKeyboardMode(enabled, ref)` — foco observado e ordem de tabulação medida.
115
+
116
+ ### Testes
117
+
118
+ `@brucesantos/design-space/testing` — entrypoint separado, fora do bundle do
119
+ preview.
120
+
121
+ - `pathFor(scenario, overrides)` — caminho relativo para `page.goto`, deixando o
122
+ `baseURL` do Playwright decidir entre preview e dev server.
123
+ - `testOrigin(fallback)` — lê `PREVIEW_URL`, que o gatilho `deployment_status`
124
+ entrega pronto.
125
+ - `assertValidProduct(product)` — falha o teste quando o contrato tem erro.
126
+ - `scenariosUnderTest(product)`, `keyboardScenarios(product)` — recortes para
127
+ parametrizar jornadas.
128
+
129
+ ## Atalhos
130
+
131
+ | Atalho | Efeito |
132
+ | --- | --- |
133
+ | `Shift` + `C` | Chrome do ambiente |
134
+ | `Shift` + `K` | Modo teclado |
135
+ | `Shift` + `P` | Painel de contexto |
136
+
137
+ ## Fronteira
138
+
139
+ O motor **não** contém e não deve conter: componente visual, token, tipografia,
140
+ cor, ícone, persona de domínio, fixture, regra de negócio ou conteúdo de cliente.
141
+ Isso é exclusivo de cada produto — e é o que permite que Bloomy e Finaya
142
+ continuem parecendo produtos distintos.
143
+
144
+ ## Licença
145
+
146
+ MIT.
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Leitura da árvore acessível do elemento em foco (§6.1, "No painel").
3
+ *
4
+ * Não é um leitor de tela e não pretende ser. É a resposta rápida a "o que um
5
+ * leitor de tela anunciaria aqui?", disponível na hora em que a decisão de
6
+ * design está sendo tomada. O cálculo de nome acessível segue a ordem do
7
+ * accname, simplificada para o que aparece em UI de produto — o limite honesto
8
+ * é o mesmo do resto do capítulo: ferramenta é piso, não teto.
9
+ */
10
+ export type AccessibleNode = {
11
+ /** Papel explícito ou inferido do elemento. */
12
+ role: string;
13
+ /** Nome acessível calculado. */
14
+ name: string;
15
+ /** De onde o nome veio: útil quando o nome está tecnicamente presente e sem sentido. */
16
+ nameFrom: "aria-labelledby" | "aria-label" | "label" | "alt" | "title" | "value" | "content" | "none";
17
+ /** Descrição acessível, quando houver. */
18
+ description?: string;
19
+ /** Estados relevantes: `disabled`, `checked`, `expanded`, `invalid`… */
20
+ states: string[];
21
+ /** Seletor curto do elemento, para citar em backlog. */
22
+ selector: string;
23
+ /** `true` quando o elemento está fora da ordem de tabulação. */
24
+ hiddenFromTabOrder: boolean;
25
+ /** `true` quando o elemento é escondido de tecnologia assistiva. */
26
+ hiddenFromAssistiveTech: boolean;
27
+ };
28
+ export declare function describeElement(element: Element | null): AccessibleNode | undefined;
29
+ export declare function computeRole(element: HTMLElement): string;
30
+ /** Seletor curto e legível, para citar no backlog do coletor. */
31
+ export declare function shortSelector(element: HTMLElement): string;
32
+ /**
33
+ * Elementos focáveis na ordem em que o Tab os visita. Serve para evidenciar a
34
+ * ordem de tabulação — ordem de leitura confusa passa no axe e é exatamente o
35
+ * que o modo teclado existe para revelar.
36
+ */
37
+ export declare function tabbableElements(root?: ParentNode): HTMLElement[];
@@ -0,0 +1,62 @@
1
+ import { ContrastPair, ContrastTarget } from '../types/index.js';
2
+ export type Rgb = {
3
+ r: number;
4
+ g: number;
5
+ b: number;
6
+ a: number;
7
+ };
8
+ /** Limiares do WCAG 2.2: 1.4.3 (AA) e 1.4.6 (AAA). */
9
+ export declare const CONTRAST_THRESHOLDS: {
10
+ readonly AA: {
11
+ readonly normal: 4.5;
12
+ readonly large: 3;
13
+ };
14
+ readonly AAA: {
15
+ readonly normal: 7;
16
+ readonly large: 4.5;
17
+ };
18
+ };
19
+ /**
20
+ * Interpreta hex de 3, 4, 6 ou 8 dígitos, `rgb()`, `rgba()` e as três palavras
21
+ * que aparecem em token de verdade. Devolve `undefined` para o que não sabe ler
22
+ * — deliberadamente: um par que não pôde ser medido precisa aparecer como
23
+ * "não verificado" no painel, não como aprovado.
24
+ */
25
+ export declare function parseColor(input: string): Rgb | undefined;
26
+ /**
27
+ * Compõe uma cor semitransparente sobre um fundo opaco.
28
+ *
29
+ * Importa porque metade dos tokens semânticos de produto real é
30
+ * `rgba(43, 35, 91, 0.6)` — medir isso ignorando o alfa dá um resultado
31
+ * otimista e falso.
32
+ */
33
+ export declare function flatten(foreground: Rgb, background: Rgb): Rgb;
34
+ /** Luminância relativa (WCAG 2.x, definição de `relative luminance`). */
35
+ export declare function relativeLuminance({ r, g, b }: Rgb): number;
36
+ /** Razão de contraste entre 1 e 21. `undefined` quando alguma cor é ilegível. */
37
+ export declare function contrastRatio(foreground: string, background: string): number | undefined;
38
+ export type ContrastResult = {
39
+ pair: ContrastPair;
40
+ target: ContrastTarget;
41
+ /** `undefined` quando alguma das cores não pôde ser interpretada. */
42
+ ratio: number | undefined;
43
+ required: number;
44
+ /** `undefined` quando não foi possível medir. Nunca `true` por omissão. */
45
+ passes: boolean | undefined;
46
+ /** Razão arredondada para exibição: "4.62:1". */
47
+ label: string;
48
+ };
49
+ export declare function checkContrastPair(pair: ContrastPair): ContrastResult;
50
+ export declare function checkContrastPairs(pairs?: ContrastPair[]): ContrastResult[];
51
+ /**
52
+ * Falha o build quando algum par declarado não atinge o alvo.
53
+ *
54
+ * Chamado por um teste do produto (`tests/tokens.test.ts` no template), porque
55
+ * validar tokens é responsabilidade do produto — o motor só sabe medir.
56
+ */
57
+ export declare function assertContrastPairs(pairs: ContrastPair[]): void;
58
+ /**
59
+ * Lê o valor computado de uma custom property. Serve para o painel medir o que
60
+ * está realmente aplicado na tela, não o que o arquivo de token diz.
61
+ */
62
+ export declare function readCssVariable(name: string, element?: Element): string | undefined;
@@ -0,0 +1,23 @@
1
+ import { AccessibleNode } from './accessible-tree.js';
2
+ export type TabStop = {
3
+ index: number;
4
+ element: HTMLElement;
5
+ rect: DOMRect;
6
+ /** `true` quando o elemento tem `tabindex` positivo, que fura a ordem natural. */
7
+ forcedOrder: boolean;
8
+ };
9
+ export type KeyboardModeResult = {
10
+ /** Elemento em foco descrito como nó acessível. */
11
+ focused: AccessibleNode | undefined;
12
+ /** Ordem de tabulação do palco, recalculada a cada mudança de foco. */
13
+ tabStops: TabStop[];
14
+ /** Recalcula a ordem manualmente, após uma mudança de layout. */
15
+ refresh: () => void;
16
+ };
17
+ /**
18
+ * @param enabled Liga a observação. Desligado, o hook não instala listener
19
+ * nenhum — o motor não deve custar nada quando não está em uso.
20
+ * @param stageRef Contêiner da UI do produto. A ordem de tabulação medida é a do
21
+ * produto, não a do chrome do Design Space.
22
+ */
23
+ export declare function useKeyboardMode(enabled: boolean, stageRef: React.RefObject<HTMLElement | null>): KeyboardModeResult;
@@ -0,0 +1,37 @@
1
+ import { DataRequest, DataSourceAdapter, Fixture } from '../types/index.js';
2
+ /** Latência simulada do estado `slow`, em ms. Longa o bastante para revelar
3
+ * skeleton mal desenhado, curta o bastante para não irritar em revisão. */
4
+ export declare const SLOW_NETWORK_DELAY_MS = 2500;
5
+ /** Erro lançado quando o estado de rede é `error`. Nomeado para o produto poder
6
+ * distinguir falha simulada de bug real. */
7
+ export declare class SimulatedNetworkError extends Error {
8
+ constructor(scenarioId: string);
9
+ }
10
+ /** Resolve `data` de uma fixture, aceitando valor puro ou factory pura. */
11
+ export declare function resolveFixture<T>(fixture: Fixture<T> | undefined): T | undefined;
12
+ /**
13
+ * Adapter padrão. Materializa o estado de rede do cenário sem que o produto
14
+ * precise escrever `if (loading)` de mentira em cada tela:
15
+ *
16
+ * - `success` devolve a fixture;
17
+ * - `empty` devolve `null`, e a tela decide como é o seu vazio;
18
+ * - `error` rejeita com {@link SimulatedNetworkError};
19
+ * - `slow` atrasa e depois devolve a fixture;
20
+ * - `loading` nunca resolve, congelando a tela no estado de carregamento.
21
+ */
22
+ export declare const fixtureAdapter: DataSourceAdapter;
23
+ /**
24
+ * Constrói um adapter HTTP a partir de uma URL base. Entra apenas quando reduz
25
+ * trabalho real, nunca como pré-requisito de existência do ambiente — e a
26
+ * fixture continua como fallback para o preview seguir determinístico.
27
+ */
28
+ export declare function createHttpAdapter(options: {
29
+ id: string;
30
+ label: string;
31
+ baseUrl: string;
32
+ /** Caminho por cenário. Padrão: a própria `scenario.route`. */
33
+ path?: (request: DataRequest) => string;
34
+ init?: RequestInit;
35
+ /** Cai para a fixture quando a requisição falhar. Padrão: `true`. */
36
+ fallbackToFixture?: boolean;
37
+ }): DataSourceAdapter;
@@ -0,0 +1,12 @@
1
+ import { DataSourceAdapter, Fixture, NetworkState, Scenario } from '../types/index.js';
2
+ export type ScenarioData = {
3
+ data: unknown;
4
+ isLoading: boolean;
5
+ error: Error | undefined;
6
+ };
7
+ export declare function useScenarioData(options: {
8
+ scenario: Scenario | undefined;
9
+ fixture: Fixture | undefined;
10
+ network: NetworkState;
11
+ adapter: DataSourceAdapter | undefined;
12
+ }): ScenarioData;
@@ -0,0 +1,265 @@
1
+ const b = [
2
+ "proposed",
3
+ "in-review",
4
+ "approved",
5
+ "in-implementation",
6
+ "implemented",
7
+ "superseded"
8
+ ], w = [
9
+ "success",
10
+ "loading",
11
+ "empty",
12
+ "error",
13
+ "slow"
14
+ ], x = /^[a-z0-9]+([.\-][a-z0-9]+)*$/;
15
+ function p(e) {
16
+ return typeof e == "string" && e.trim().length > 0;
17
+ }
18
+ function S(e, o) {
19
+ const t = [], r = p(e?.id) ? `scenario:${e.id}` : `scenario[${o ?? "?"}]`, n = (d) => t.push({ level: "error", where: r, message: d }), i = (d) => t.push({ level: "warning", where: r, message: d });
20
+ p(e?.id) ? x.test(e.id) ? e.id.includes(".") || i("`id` sem prefixo de módulo dificulta a navegação e a busca do agente.") : n(
21
+ "`id` deve ser minúsculo em kebab-case, com o módulo como prefixo: `finance.insurance-denied`."
22
+ ) : 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)."), b.includes(e?.status) || n(`\`status\` deve ser um de: ${b.join(", ")}.`), e?.network && !w.includes(e.network) && n(`\`network\` deve ser um de: ${w.join(", ")}.`);
23
+ const a = e?.a11y;
24
+ return !a || typeof a != "object" ? n(
25
+ "`a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de projeto (D-15)."
26
+ ) : (["full", "partial", "not-applicable"].includes(a.keyboard) || n("`a11y.keyboard` deve ser `full`, `partial` ou `not-applicable`."), ["AA", "AAA"].includes(a.contrast) || n("`a11y.contrast` deve ser `AA` ou `AAA`. O padrão interno é WCAG 2.2 AA."), a.announces !== void 0 && !Array.isArray(a.announces) && n("`a11y.announces` deve ser uma lista de chaves de evento de domínio.")), e?.status === "approved" && a?.keyboard === "partial" && i(
27
+ 'Cenário aprovado com `a11y.keyboard: "partial"`. Confirme que esta jornada não é crítica.'
28
+ ), e?.status === "approved" && !e.approvedAt && i(
29
+ "Cenário aprovado sem `approvedAt`. A aprovação deve ser registrada por URL de commit (§10.2), senão muda de conteúdo debaixo de quem aprovou."
30
+ ), e?.expected?.length || i(
31
+ "Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater)."
32
+ ), t;
33
+ }
34
+ function M(e) {
35
+ const o = [], t = (c, s, l) => o.push({ level: c, where: s, message: l }), r = new Set(e.personas?.map((c) => c.id) ?? []), n = new Set(e.fixtures?.map((c) => c.id) ?? []), i = new Set(e.rules?.map((c) => c.id) ?? []), a = new Set(e.modules?.map((c) => c.id) ?? []), d = /* @__PURE__ */ new Set();
36
+ p(e.id) || t("error", "product", "`id` é obrigatório."), p(e.name) || t("error", "product", "`name` é obrigatório."), e.routes?.length || t("error", "product", "`routes` está vazio: nenhum cenário conseguirá renderizar.");
37
+ for (const [c, s] of (e.scenarios ?? []).entries()) {
38
+ o.push(...S(s, c));
39
+ const l = `scenario:${s?.id ?? c}`;
40
+ if (s?.id) {
41
+ d.has(s.id) && t("error", l, `\`id\` duplicado: ${s.id}.`), d.add(s.id);
42
+ const f = s.id.split(".")[0];
43
+ f && a.size > 0 && !a.has(f) && t(
44
+ "warning",
45
+ l,
46
+ `Prefixo \`${f}\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`
47
+ );
48
+ }
49
+ s?.persona && !r.has(s.persona) && t("error", l, `Persona não registrada: \`${s.persona}\`.`), s?.fixture && !n.has(s.fixture) && t("error", l, `Fixture não registrada: \`${s.fixture}\`.`);
50
+ for (const f of s?.rules ?? [])
51
+ i.has(f) || t("error", l, `Regra não registrada: \`${f}\`.`);
52
+ s?.route && !R(s.route, e) && t(
53
+ "error",
54
+ l,
55
+ `Rota \`${s.route}\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`
56
+ );
57
+ }
58
+ for (const c of e.modules ?? [])
59
+ for (const s of c.flows ?? []) {
60
+ const l = `flow:${c.id}/${s.id}`;
61
+ s.steps?.length || t("warning", l, "Jornada sem passos.");
62
+ for (const f of s.steps ?? []) {
63
+ d.has(f.scenario) || t("error", l, `Passo aponta para cenário inexistente: \`${f.scenario}\`.`);
64
+ for (const [_, g] of Object.entries(f.branches ?? {}))
65
+ d.has(g) || t(
66
+ "error",
67
+ l,
68
+ `Ramificação "${_}" aponta para cenário inexistente: \`${g}\`.`
69
+ );
70
+ }
71
+ }
72
+ const u = e.dataSources?.default;
73
+ return u && u !== "fixtures" && (new Set(e.dataSources?.adapters?.map((s) => s.id) ?? []).has(u) || t("error", "product", `\`dataSources.default\` aponta para adapter inexistente: \`${u}\`.`), t(
74
+ "warning",
75
+ "product",
76
+ "A fonte padrão não é `fixtures`. O padrão do ambiente é dado sintético e determinístico (D-05); API real entra como adapter opcional, com justificativa."
77
+ )), o;
78
+ }
79
+ function R(e, o) {
80
+ const t = e.split("?")[0] ?? e;
81
+ return (o.routes ?? []).some((r) => $(r.path, t));
82
+ }
83
+ function $(e, o) {
84
+ const t = e.split("/").filter(Boolean), r = o.split("/").filter(Boolean);
85
+ for (const [n, i] of t.entries()) {
86
+ if (i === "*") return !0;
87
+ const a = r[n];
88
+ if (a === void 0) return !1;
89
+ if (!i.startsWith(":") && i !== a)
90
+ return !1;
91
+ }
92
+ return t.length === r.length;
93
+ }
94
+ function j(e) {
95
+ return e.some((o) => o.level === "error");
96
+ }
97
+ function U(e) {
98
+ return e.length === 0 ? "Nenhum problema encontrado." : e.map((o) => `${o.level === "error" ? "✖" : "▲"} ${o.where}
99
+ ${o.message}`).join(`
100
+ `);
101
+ }
102
+ const m = {
103
+ scenario: "scenario",
104
+ persona: "persona",
105
+ fixture: "fixture",
106
+ network: "network",
107
+ viewport: "viewport",
108
+ customWidth: "w",
109
+ themeMode: "theme",
110
+ locale: "locale",
111
+ dataSource: "source",
112
+ chrome: "chrome",
113
+ keyboardMode: "kb",
114
+ reducedMotion: "motion",
115
+ textScale: "scale",
116
+ inspector: "panel"
117
+ };
118
+ function C(e) {
119
+ return typeof e == "boolean" ? e ? "1" : "0" : String(e);
120
+ }
121
+ function y(e, o = {}) {
122
+ for (const [t, r] of Object.entries(o)) {
123
+ if (r == null) continue;
124
+ const n = m[t];
125
+ n && e.set(n, C(r));
126
+ }
127
+ }
128
+ const I = { BASE_URL: "/", DEV: !1, MODE: "production", PROD: !0, SSR: !1 };
129
+ function T() {
130
+ const e = I;
131
+ return e || (typeof process < "u" && process.env ? process.env : {});
132
+ }
133
+ function A() {
134
+ const e = T(), o = e.VITE_VERCEL_BRANCH_URL || e.VERCEL_BRANCH_URL, t = e.VITE_VERCEL_URL || e.VERCEL_URL, r = e.VITE_VERCEL_ENV || e.VERCEL_ENV, n = e.VITE_VERCEL_GIT_COMMIT_SHA || e.VERCEL_GIT_COMMIT_SHA, i = o && `https://${o}` || t && `https://${t}` || (typeof window < "u" ? window.location.origin : "http://localhost:5173");
135
+ return {
136
+ env: r ?? "development",
137
+ origin: i.replace(/\/$/, ""),
138
+ branchUrl: o,
139
+ deploymentUrl: t,
140
+ branch: e.VITE_VERCEL_GIT_COMMIT_REF || e.VERCEL_GIT_COMMIT_REF,
141
+ commit: n,
142
+ shortCommit: n?.slice(0, 7),
143
+ isDeployed: r === "preview" || r === "production"
144
+ };
145
+ }
146
+ function N(e, o = {}) {
147
+ const t = o.origin ?? A().origin, r = new URL(e.route, t);
148
+ return r.searchParams.set(m.scenario, e.id), r.searchParams.set(m.persona, e.persona), r.searchParams.set(m.fixture, e.fixture), e.network && e.network !== "success" && r.searchParams.set(m.network, e.network), y(r.searchParams, o.overrides), r.toString();
149
+ }
150
+ function D(e, o) {
151
+ const t = o.commit ?? A().shortCommit;
152
+ if (!t) return;
153
+ const r = `https://${o.project}-${t}-${o.scope}.vercel.app`;
154
+ return N(e, { origin: r });
155
+ }
156
+ const E = {
157
+ AA: { normal: 4.5, large: 3 },
158
+ AAA: { normal: 7, large: 4.5 }
159
+ }, k = {
160
+ white: "#ffffff",
161
+ black: "#000000",
162
+ transparent: "#00000000"
163
+ };
164
+ function v(e) {
165
+ const o = e.trim().toLowerCase(), t = k[o];
166
+ if (t) return v(t);
167
+ if (o.startsWith("#")) {
168
+ const n = o.slice(1), i = (a) => Number.parseInt(a.repeat(2), 16);
169
+ if (n.length === 3 || n.length === 4) {
170
+ const [a, d, u, c] = [...n];
171
+ return !a || !d || !u ? void 0 : { r: i(a), g: i(d), b: i(u), a: c ? i(c) / 255 : 1 };
172
+ }
173
+ if (n.length === 6 || n.length === 8) {
174
+ const a = (u) => Number.parseInt(n.slice(u, u + 2), 16), d = [a(0), a(2), a(4)];
175
+ return d.some(Number.isNaN) ? void 0 : {
176
+ r: d[0],
177
+ g: d[1],
178
+ b: d[2],
179
+ a: n.length === 8 ? a(6) / 255 : 1
180
+ };
181
+ }
182
+ return;
183
+ }
184
+ const r = o.match(/^rgba?\(([^)]+)\)$/);
185
+ if (r?.[1]) {
186
+ const n = r[1].split(/[\s,/]+/).filter(Boolean), [i, a, d, u] = n.map(Number);
187
+ return [i, a, d].some((c) => c === void 0 || Number.isNaN(c)) ? void 0 : { r: i, g: a, b: d, a: u === void 0 || Number.isNaN(u) ? 1 : u };
188
+ }
189
+ }
190
+ function L(e, o) {
191
+ if (e.a >= 1) return e;
192
+ const t = (r, n) => r * e.a + n * (1 - e.a);
193
+ return {
194
+ r: t(e.r, o.r),
195
+ g: t(e.g, o.g),
196
+ b: t(e.b, o.b),
197
+ a: 1
198
+ };
199
+ }
200
+ function h({ r: e, g: o, b: t }) {
201
+ const r = (n) => {
202
+ const i = n / 255;
203
+ return i <= 0.03928 ? i / 12.92 : ((i + 0.055) / 1.055) ** 2.4;
204
+ };
205
+ return 0.2126 * r(e) + 0.7152 * r(o) + 0.0722 * r(t);
206
+ }
207
+ function P(e, o) {
208
+ const t = v(o), r = v(e);
209
+ if (!t || !r) return;
210
+ const n = L(r, t), i = Math.max(h(n), h(t)), a = Math.min(h(n), h(t));
211
+ return (i + 0.05) / (a + 0.05);
212
+ }
213
+ function V(e) {
214
+ const o = e.target ?? "AA", t = e.largeText ? E[o].large : E[o].normal, r = P(e.foreground, e.background);
215
+ return {
216
+ pair: e,
217
+ target: o,
218
+ ratio: r,
219
+ required: t,
220
+ passes: r === void 0 ? void 0 : r >= t,
221
+ label: r === void 0 ? "não medido" : `${r.toFixed(2)}:1`
222
+ };
223
+ }
224
+ function O(e = []) {
225
+ return e.map(V);
226
+ }
227
+ function z(e) {
228
+ const o = O(e).filter((r) => r.passes !== !0);
229
+ if (o.length === 0) return;
230
+ const t = o.map(
231
+ (r) => ` ✖ ${r.pair.name}: ${r.label} (mínimo ${r.required}:1 para ${r.target}${r.pair.largeText ? ", texto grande" : ""})`
232
+ ).join(`
233
+ `);
234
+ throw new Error(`Pares de contraste fora do alvo:
235
+ ${t}`);
236
+ }
237
+ function B(e, o) {
238
+ if (typeof window > "u") return;
239
+ const t = o ?? document.documentElement;
240
+ return window.getComputedStyle(t).getPropertyValue(e).trim() || void 0;
241
+ }
242
+ export {
243
+ E as C,
244
+ w as N,
245
+ m as P,
246
+ b as S,
247
+ y as a,
248
+ z as b,
249
+ O as c,
250
+ V as d,
251
+ D as e,
252
+ P as f,
253
+ A as g,
254
+ L as h,
255
+ U as i,
256
+ j,
257
+ h as k,
258
+ C as l,
259
+ S as m,
260
+ v as p,
261
+ B as r,
262
+ N as s,
263
+ M as v
264
+ };
265
+ //# sourceMappingURL=contrast-MPoK6VR1.js.map