@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 +76 -0
- package/README.md +146 -0
- package/dist/a11y/accessible-tree.d.ts +37 -0
- package/dist/a11y/contrast.d.ts +62 -0
- package/dist/a11y/useKeyboardMode.d.ts +23 -0
- package/dist/adapters/index.d.ts +37 -0
- package/dist/adapters/useScenarioData.d.ts +12 -0
- package/dist/contrast-MPoK6VR1.js +265 -0
- package/dist/contrast-MPoK6VR1.js.map +1 -0
- package/dist/controls/params.d.ts +30 -0
- package/dist/controls/state.d.ts +43 -0
- package/dist/deploy/index.d.ts +42 -0
- package/dist/design-space.css +1 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +1404 -0
- package/dist/index.js.map +1 -0
- package/dist/registry/index.d.ts +35 -0
- package/dist/registry/validate.d.ts +21 -0
- package/dist/router/index.d.ts +15 -0
- package/dist/shell/Controls.d.ts +8 -0
- package/dist/shell/DesignSpace.d.ts +5 -0
- package/dist/shell/Home.d.ts +6 -0
- package/dist/shell/Inspector.d.ts +11 -0
- package/dist/shell/Sidebar.d.ts +7 -0
- package/dist/shell/Stage.d.ts +25 -0
- package/dist/shell/Topbar.d.ts +13 -0
- package/dist/shell/labels.d.ts +5 -0
- package/dist/testing/index.d.ts +45 -0
- package/dist/testing.js +42 -0
- package/dist/testing.js.map +1 -0
- package/dist/types/index.d.ts +310 -0
- package/dist/util/date.d.ts +40 -0
- package/package.json +67 -0
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
|