@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/dist/testing.js
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { v as n, j as o, i, s as t } from "./contrast-MPoK6VR1.js";
|
|
2
|
+
import { b as v, d as P, c as g, f as E } from "./contrast-MPoK6VR1.js";
|
|
3
|
+
function a(e = "http://localhost:5173") {
|
|
4
|
+
const r = typeof process < "u" ? process.env : {};
|
|
5
|
+
return (r.PREVIEW_URL || r.BASE_URL || e).replace(/\/$/, "");
|
|
6
|
+
}
|
|
7
|
+
function u(e, r = {}) {
|
|
8
|
+
return t(e, { origin: r.origin ?? a(), overrides: r.overrides });
|
|
9
|
+
}
|
|
10
|
+
function d(e, r = {}) {
|
|
11
|
+
const s = new URL(t(e, { origin: "http://design-space.invalid", overrides: r }));
|
|
12
|
+
return `${s.pathname}${s.search}`;
|
|
13
|
+
}
|
|
14
|
+
function l(e, r = ["approved", "in-implementation", "implemented"]) {
|
|
15
|
+
return e.scenarios.filter((s) => r.includes(s.status));
|
|
16
|
+
}
|
|
17
|
+
function f(e) {
|
|
18
|
+
return e.scenarios.filter((r) => r.a11y.keyboard === "full");
|
|
19
|
+
}
|
|
20
|
+
function p(e) {
|
|
21
|
+
const r = n(e);
|
|
22
|
+
if (o(r))
|
|
23
|
+
throw new Error(`Contrato de cenário inválido:
|
|
24
|
+
${i(r)}`);
|
|
25
|
+
}
|
|
26
|
+
export {
|
|
27
|
+
v as assertContrastPairs,
|
|
28
|
+
p as assertValidProduct,
|
|
29
|
+
P as checkContrastPair,
|
|
30
|
+
g as checkContrastPairs,
|
|
31
|
+
E as contrastRatio,
|
|
32
|
+
i as formatIssues,
|
|
33
|
+
o as hasErrors,
|
|
34
|
+
f as keyboardScenarios,
|
|
35
|
+
d as pathFor,
|
|
36
|
+
t as scenarioUrl,
|
|
37
|
+
l as scenariosUnderTest,
|
|
38
|
+
a as testOrigin,
|
|
39
|
+
u as urlFor,
|
|
40
|
+
n as validateProduct
|
|
41
|
+
};
|
|
42
|
+
//# sourceMappingURL=testing.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.js","sources":["../src/testing/index.ts"],"sourcesContent":["/**\n * `@brucesantos/design-space/testing`\n *\n * Utilitários para os testes do produto. Vive num entrypoint separado porque\n * nada aqui deve chegar ao bundle do preview.\n *\n * O que este módulo assume: o preview é público, sem proteção de acesso (D-11).\n * Como não há segredo de bypass nem header de automação a emitir, o Playwright\n * aponta direto para a URL do preview — e é por isso que estas funções só\n * precisam de uma origem.\n */\n\nimport { scenarioUrl } from \"../deploy/index.js\";\nimport { validateProduct, hasErrors, formatIssues } from \"../registry/validate.js\";\nimport {\n assertContrastPairs,\n checkContrastPair,\n checkContrastPairs,\n contrastRatio,\n} from \"../a11y/contrast.js\";\nimport type { ControlsState, ProductDefinition, Scenario, ScenarioStatus } from \"../types/index.js\";\n\n/**\n * Origem contra a qual os testes rodam.\n *\n * `PREVIEW_URL` é o que o gatilho `deployment_status` do GitHub Actions entrega\n * pronto (§10.6), o que dispensa qualquer lógica de descobrir onde o preview foi\n * publicado. Sem ela, cai no dev server local.\n */\nexport function testOrigin(fallback = \"http://localhost:5173\"): string {\n const env = typeof process !== \"undefined\" ? process.env : {};\n const url = env.PREVIEW_URL || env.BASE_URL || fallback;\n return url.replace(/\\/$/, \"\");\n}\n\n/** URL absoluta de um cenário para uso em `page.goto`. */\nexport function urlFor(\n scenario: Scenario,\n options: { origin?: string; overrides?: Partial<ControlsState> } = {},\n): string {\n return scenarioUrl(scenario, { origin: options.origin ?? testOrigin(), overrides: options.overrides });\n}\n\n/**\n * Caminho relativo de um cenário: `/rota?scenario=…`.\n *\n * É a forma preferida em Playwright, porque deixa o `baseURL` da configuração\n * decidir se o teste roda contra o preview ou contra o dev server. Um teste que\n * embute a origem passa a existir em duas versões, e a versão local é a que\n * ninguém roda.\n */\nexport function pathFor(\n scenario: Scenario,\n overrides: Partial<ControlsState> = {},\n): string {\n const url = new URL(scenarioUrl(scenario, { origin: \"http://design-space.invalid\", overrides }));\n return `${url.pathname}${url.search}`;\n}\n\n/**\n * Cenários que valem uma jornada automatizada.\n *\n * Deliberadamente não é \"todos\": rodar Playwright em cenário `proposed`\n * transforma exploração em trabalho de manutenção de teste, que é o oposto de\n * \"governança proporcional\" (Princípio 9). O piso é o cenário que já foi\n * aprovado ou já existe em produção.\n */\nexport function scenariosUnderTest(\n product: ProductDefinition,\n statuses: ScenarioStatus[] = [\"approved\", \"in-implementation\", \"implemented\"],\n): Scenario[] {\n return product.scenarios.filter((scenario) => statuses.includes(scenario.status));\n}\n\n/** Cenários que declaram jornada completável só por teclado. */\nexport function keyboardScenarios(product: ProductDefinition): Scenario[] {\n return product.scenarios.filter((scenario) => scenario.a11y.keyboard === \"full\");\n}\n\n/**\n * Falha o teste quando o contrato de cenário do produto tem erro.\n *\n * É o equivalente do typecheck para o que o TypeScript não alcança: fixture\n * inexistente, persona escrita errada, rota que não casa com nada.\n */\nexport function assertValidProduct(product: ProductDefinition): void {\n const issues = validateProduct(product);\n if (hasErrors(issues)) {\n throw new Error(`Contrato de cenário inválido:\\n${formatIssues(issues)}`);\n }\n}\n\n// Medição de contraste também é ferramenta de teste: o produto valida os\n// próprios tokens, e o motor só sabe medir.\nexport {\n assertContrastPairs,\n checkContrastPair,\n checkContrastPairs,\n contrastRatio,\n formatIssues,\n hasErrors,\n validateProduct,\n};\nexport { scenarioUrl } from \"../deploy/index.js\";\n"],"names":["testOrigin","fallback","env","urlFor","scenario","options","scenarioUrl","pathFor","overrides","url","scenariosUnderTest","product","statuses","keyboardScenarios","assertValidProduct","issues","validateProduct","hasErrors","formatIssues"],"mappings":";;AA6BO,SAASA,EAAWC,IAAW,yBAAiC;AACrE,QAAMC,IAAM,OAAO,UAAY,MAAc,QAAQ,MAAM,CAAA;AAE3D,UADYA,EAAI,eAAeA,EAAI,YAAYD,GACpC,QAAQ,OAAO,EAAE;AAC9B;AAGO,SAASE,EACdC,GACAC,IAAmE,IAC3D;AACR,SAAOC,EAAYF,GAAU,EAAE,QAAQC,EAAQ,UAAUL,KAAc,WAAWK,EAAQ,UAAA,CAAW;AACvG;AAUO,SAASE,EACdH,GACAI,IAAoC,IAC5B;AACR,QAAMC,IAAM,IAAI,IAAIH,EAAYF,GAAU,EAAE,QAAQ,+BAA+B,WAAAI,EAAA,CAAW,CAAC;AAC/F,SAAO,GAAGC,EAAI,QAAQ,GAAGA,EAAI,MAAM;AACrC;AAUO,SAASC,EACdC,GACAC,IAA6B,CAAC,YAAY,qBAAqB,aAAa,GAChE;AACZ,SAAOD,EAAQ,UAAU,OAAO,CAACP,MAAaQ,EAAS,SAASR,EAAS,MAAM,CAAC;AAClF;AAGO,SAASS,EAAkBF,GAAwC;AACxE,SAAOA,EAAQ,UAAU,OAAO,CAACP,MAAaA,EAAS,KAAK,aAAa,MAAM;AACjF;AAQO,SAASU,EAAmBH,GAAkC;AACnE,QAAMI,IAASC,EAAgBL,CAAO;AACtC,MAAIM,EAAUF,CAAM;AAClB,UAAM,IAAI,MAAM;AAAA,EAAkCG,EAAaH,CAAM,CAAC,EAAE;AAE5E;"}
|
|
@@ -0,0 +1,310 @@
|
|
|
1
|
+
import { ComponentType, ReactNode } from 'react';
|
|
2
|
+
/**
|
|
3
|
+
* Estado de ciclo de vida do cenário (§18.1). Existe para evitar que a
|
|
4
|
+
* referência envelheça em silêncio quando o produto real muda.
|
|
5
|
+
*/
|
|
6
|
+
export type ScenarioStatus = "proposed" | "in-review" | "approved" | "in-implementation" | "implemented" | "superseded";
|
|
7
|
+
export declare const SCENARIO_STATUSES: readonly ScenarioStatus[];
|
|
8
|
+
/** Nível de conformidade alvo. O padrão interno é WCAG 2.2 AA. */
|
|
9
|
+
export type ContrastTarget = "AA" | "AAA";
|
|
10
|
+
/** Quanto da jornada precisa ser completável só por teclado. */
|
|
11
|
+
export type KeyboardCoverage = "full" | "partial" | "not-applicable";
|
|
12
|
+
export type A11yContract = {
|
|
13
|
+
/**
|
|
14
|
+
* `full` significa: a jornada declarada por este cenário é completável do
|
|
15
|
+
* início ao fim sem mouse, com foco visível em cada passo.
|
|
16
|
+
*/
|
|
17
|
+
keyboard: KeyboardCoverage;
|
|
18
|
+
/** Nível de contraste exigido para os tokens em uso nesta tela. */
|
|
19
|
+
contrast: ContrastTarget;
|
|
20
|
+
/**
|
|
21
|
+
* Eventos que precisam ser anunciados para leitor de tela. São chaves de
|
|
22
|
+
* domínio, não seletores: `claim.status`, `retry.result`.
|
|
23
|
+
*
|
|
24
|
+
* Um cenário de convênio recusado em que a recusa não é anunciada está
|
|
25
|
+
* incompleto, não está pronto para aprovação.
|
|
26
|
+
*/
|
|
27
|
+
announces?: string[];
|
|
28
|
+
/** Observação de revisão humana. O automático é piso, não teto. */
|
|
29
|
+
notes?: string;
|
|
30
|
+
};
|
|
31
|
+
export type Persona = {
|
|
32
|
+
/** Identificador estável usado em URL e em cenário. */
|
|
33
|
+
id: string;
|
|
34
|
+
/** Nome no vocabulário do cliente: "Recepcionista". */
|
|
35
|
+
name: string;
|
|
36
|
+
/** O que essa pessoa está tentando fazer. */
|
|
37
|
+
goal?: string;
|
|
38
|
+
/** Permissões concedidas por padrão a este papel. */
|
|
39
|
+
permissions: string[];
|
|
40
|
+
description?: string;
|
|
41
|
+
};
|
|
42
|
+
export type Rule = {
|
|
43
|
+
/** Identificador citado por cenários: `retry-after-document-review`. */
|
|
44
|
+
id: string;
|
|
45
|
+
/** Enunciado curto, na linguagem do produto. */
|
|
46
|
+
statement: string;
|
|
47
|
+
/** Por que a regra existe. Contexto, não implementação. */
|
|
48
|
+
rationale?: string;
|
|
49
|
+
/** Onde a regra vive no código, quando existir: `src/rules/claims.ts`. */
|
|
50
|
+
source?: string;
|
|
51
|
+
};
|
|
52
|
+
/**
|
|
53
|
+
* Dado sintético e determinístico que materializa um cenário.
|
|
54
|
+
*
|
|
55
|
+
* O motor não conhece o formato de `data` — isso é contrato do produto. O que
|
|
56
|
+
* o motor garante é que a mesma URL produz a mesma fixture (§15.1
|
|
57
|
+
* "Determinismo"), então `data` precisa ser um valor puro ou uma factory pura.
|
|
58
|
+
*/
|
|
59
|
+
export type Fixture<T = unknown> = {
|
|
60
|
+
id: string;
|
|
61
|
+
/** Rótulo legível para o seletor de conjunto de dados. */
|
|
62
|
+
label: string;
|
|
63
|
+
description?: string;
|
|
64
|
+
/** Valor determinístico, ou factory pura que devolve um valor determinístico. */
|
|
65
|
+
data: T | (() => T);
|
|
66
|
+
};
|
|
67
|
+
export type NetworkState = "success" | "loading" | "empty" | "error" | "slow";
|
|
68
|
+
export declare const NETWORK_STATES: readonly NetworkState[];
|
|
69
|
+
/**
|
|
70
|
+
* Um cenário não é uma tela com dados diferentes. Ele combina intenção,
|
|
71
|
+
* persona, permissões, pré-condições, dados, estado inicial, ações
|
|
72
|
+
* disponíveis, regras e resultado esperado.
|
|
73
|
+
*/
|
|
74
|
+
export type Scenario = {
|
|
75
|
+
/** `modulo.situacao` em kebab-case: `finance.insurance-denied`. */
|
|
76
|
+
id: string;
|
|
77
|
+
/** Título no vocabulário do negócio: "Convênio recusado". */
|
|
78
|
+
title: string;
|
|
79
|
+
/** Rota que o cenário abre. Precisa casar com uma rota do produto. */
|
|
80
|
+
route: string;
|
|
81
|
+
/** Id de uma persona registrada no produto. */
|
|
82
|
+
persona: string;
|
|
83
|
+
/**
|
|
84
|
+
* Permissões efetivas do cenário. Quando ausente, herda as da persona.
|
|
85
|
+
* Declarar aqui permite representar "recepcionista sem permissão de
|
|
86
|
+
* cancelamento" sem inventar uma segunda persona.
|
|
87
|
+
*/
|
|
88
|
+
permissions?: string[];
|
|
89
|
+
/** Id de uma fixture registrada no produto. */
|
|
90
|
+
fixture: string;
|
|
91
|
+
/** Ids de regras que governam esta situação. */
|
|
92
|
+
rules?: string[];
|
|
93
|
+
/** Contrato de acessibilidade da situação. */
|
|
94
|
+
a11y: A11yContract;
|
|
95
|
+
/** Estado de ciclo de vida. */
|
|
96
|
+
status: ScenarioStatus;
|
|
97
|
+
/** Intenção: o que se quer discutir ou verificar aqui. */
|
|
98
|
+
intent?: string;
|
|
99
|
+
/** Pré-condições em linguagem de negócio. */
|
|
100
|
+
preconditions?: string[];
|
|
101
|
+
/** Ações que a persona pode executar nesta situação. */
|
|
102
|
+
actions?: string[];
|
|
103
|
+
/** Resultado esperado — vira caso de teste no handoff. */
|
|
104
|
+
expected?: string[];
|
|
105
|
+
/** Estado de rede inicial. Padrão: `success`. */
|
|
106
|
+
network?: NetworkState;
|
|
107
|
+
/** Rótulos livres para busca: "exceção", "permissão", "vazio". */
|
|
108
|
+
tags?: string[];
|
|
109
|
+
/**
|
|
110
|
+
* URL de commit que registra a aprovação (§10.2). Imutável por definição:
|
|
111
|
+
* a aprovação não pode mudar de conteúdo debaixo de quem aprovou.
|
|
112
|
+
*/
|
|
113
|
+
approvedAt?: {
|
|
114
|
+
url: string;
|
|
115
|
+
commit: string;
|
|
116
|
+
date: string;
|
|
117
|
+
};
|
|
118
|
+
/** Ticket de engenharia, quando o cenário estiver em implementação. */
|
|
119
|
+
ticket?: string;
|
|
120
|
+
};
|
|
121
|
+
/**
|
|
122
|
+
* Uma jornada é uma sequência de passos com ramificações. Cada passo aponta
|
|
123
|
+
* para um cenário, então uma jornada é navegável e testável sem duplicar
|
|
124
|
+
* definição.
|
|
125
|
+
*/
|
|
126
|
+
export type Flow = {
|
|
127
|
+
id: string;
|
|
128
|
+
/** Título de negócio: "Agendar uma consulta". */
|
|
129
|
+
title: string;
|
|
130
|
+
description?: string;
|
|
131
|
+
steps: FlowStep[];
|
|
132
|
+
};
|
|
133
|
+
export type FlowStep = {
|
|
134
|
+
/** Cenário que materializa este passo. */
|
|
135
|
+
scenario: string;
|
|
136
|
+
/** Rótulo do passo, quando diferir do título do cenário. */
|
|
137
|
+
label?: string;
|
|
138
|
+
/** Decisão tomada aqui, quando o passo ramifica. */
|
|
139
|
+
decision?: string;
|
|
140
|
+
/** Saídas alternativas: rótulo → id de cenário. */
|
|
141
|
+
branches?: Record<string, string>;
|
|
142
|
+
};
|
|
143
|
+
export type Module = {
|
|
144
|
+
/** `agenda`, `patients`, `finance`. */
|
|
145
|
+
id: string;
|
|
146
|
+
/** Nome no vocabulário do cliente: "Agenda". */
|
|
147
|
+
name: string;
|
|
148
|
+
description?: string;
|
|
149
|
+
/** Jornadas guiadas do módulo. Opcional: navegação livre é o padrão. */
|
|
150
|
+
flows?: Flow[];
|
|
151
|
+
};
|
|
152
|
+
/**
|
|
153
|
+
* Rota declarativa do produto. O motor casa `path` contra a URL e renderiza
|
|
154
|
+
* `screen`, passando os parâmetros dinâmicos.
|
|
155
|
+
*
|
|
156
|
+
* Sintaxe de `path`: segmentos literais e `:param`. Um `*` final captura o
|
|
157
|
+
* resto em `params["*"]`.
|
|
158
|
+
*/
|
|
159
|
+
export type RouteDefinition = {
|
|
160
|
+
path: string;
|
|
161
|
+
screen: ComponentType<ScreenProps>;
|
|
162
|
+
};
|
|
163
|
+
export type ScreenProps = {
|
|
164
|
+
/** Parâmetros dinâmicos casados da rota. */
|
|
165
|
+
params: Record<string, string>;
|
|
166
|
+
/** Contexto do cenário ativo, resolvido pelo motor. */
|
|
167
|
+
context: ScenarioContext;
|
|
168
|
+
};
|
|
169
|
+
/**
|
|
170
|
+
* A UI do produto nunca depende diretamente de um backend. A camada de
|
|
171
|
+
* adapters permite alimentar o mesmo cenário por fixture, REST, GraphQL ou
|
|
172
|
+
* staging sem alterar a composição visual.
|
|
173
|
+
*/
|
|
174
|
+
export type DataSourceAdapter<T = unknown> = {
|
|
175
|
+
id: string;
|
|
176
|
+
label: string;
|
|
177
|
+
/**
|
|
178
|
+
* Resolve os dados de um cenário. Recebe a fixture declarada para que um
|
|
179
|
+
* adapter remoto possa usá-la como fallback ou como semente.
|
|
180
|
+
*/
|
|
181
|
+
load: (request: DataRequest) => Promise<T> | T;
|
|
182
|
+
};
|
|
183
|
+
export type DataRequest = {
|
|
184
|
+
scenario: Scenario;
|
|
185
|
+
fixture: Fixture | undefined;
|
|
186
|
+
network: NetworkState;
|
|
187
|
+
};
|
|
188
|
+
/**
|
|
189
|
+
* O motor não impõe aparência (D-02). Recebe do produto apenas o suficiente
|
|
190
|
+
* para validar contraste e oferecer os controles de tema.
|
|
191
|
+
*/
|
|
192
|
+
export type ProductTheme = {
|
|
193
|
+
/**
|
|
194
|
+
* Pares de cores que precisam passar na validação de contraste.
|
|
195
|
+
* Contraste é propriedade de par, então validar na definição do token
|
|
196
|
+
* resolve na origem, uma vez, em vez de perseguir o problema em 30 telas.
|
|
197
|
+
*/
|
|
198
|
+
contrastPairs?: ContrastPair[];
|
|
199
|
+
/** Modos de tema disponíveis no produto, quando houver mais de um. */
|
|
200
|
+
modes?: string[];
|
|
201
|
+
/** Idiomas disponíveis, quando o produto tiver essa variação. */
|
|
202
|
+
locales?: string[];
|
|
203
|
+
};
|
|
204
|
+
export type ContrastPair = {
|
|
205
|
+
/** Nome do par: `fg-1 sobre bg-app`. */
|
|
206
|
+
name: string;
|
|
207
|
+
/** Cor de frente em hex, rgb() ou rgba(). */
|
|
208
|
+
foreground: string;
|
|
209
|
+
/** Cor de fundo. Precisa ser opaca. */
|
|
210
|
+
background: string;
|
|
211
|
+
/** `AA` por padrão. */
|
|
212
|
+
target?: ContrastTarget;
|
|
213
|
+
/** Texto grande (>=24px, ou >=18.66px bold) tem limiar menor. */
|
|
214
|
+
largeText?: boolean;
|
|
215
|
+
};
|
|
216
|
+
export type ProductDefinition = {
|
|
217
|
+
/** `bloomy`. */
|
|
218
|
+
id: string;
|
|
219
|
+
/** "Bloomy". */
|
|
220
|
+
name: string;
|
|
221
|
+
/** Uma linha sobre o produto, exibida na entrada do Design Space. */
|
|
222
|
+
tagline?: string;
|
|
223
|
+
modules: Module[];
|
|
224
|
+
scenarios: Scenario[];
|
|
225
|
+
personas: Persona[];
|
|
226
|
+
fixtures: Fixture[];
|
|
227
|
+
rules?: Rule[];
|
|
228
|
+
routes: RouteDefinition[];
|
|
229
|
+
theme?: ProductTheme;
|
|
230
|
+
/**
|
|
231
|
+
* Adapters de dados disponíveis. `fixtures` é o padrão (D-05); qualquer
|
|
232
|
+
* outro entra como opção explícita e justificada.
|
|
233
|
+
*/
|
|
234
|
+
dataSources?: {
|
|
235
|
+
default: string;
|
|
236
|
+
adapters?: DataSourceAdapter[];
|
|
237
|
+
};
|
|
238
|
+
/** Renderizado quando nenhuma rota casa. Padrão: aviso neutro do motor. */
|
|
239
|
+
notFound?: ComponentType<{
|
|
240
|
+
path: string;
|
|
241
|
+
}>;
|
|
242
|
+
/** Envolve a UI do produto. Serve para providers de tema, i18n ou store. */
|
|
243
|
+
wrapper?: ComponentType<{
|
|
244
|
+
children: ReactNode;
|
|
245
|
+
context: ScenarioContext;
|
|
246
|
+
}>;
|
|
247
|
+
};
|
|
248
|
+
/**
|
|
249
|
+
* O que a UI do produto recebe do motor. Deliberadamente pequeno: dados,
|
|
250
|
+
* papel, permissões e estado de ambiente. Nada de componente, token ou
|
|
251
|
+
* aparência.
|
|
252
|
+
*/
|
|
253
|
+
export type ScenarioContext = {
|
|
254
|
+
scenario: Scenario | undefined;
|
|
255
|
+
persona: Persona | undefined;
|
|
256
|
+
/** Permissões efetivas: as do cenário, ou as da persona quando ausentes. */
|
|
257
|
+
permissions: string[];
|
|
258
|
+
/** `true` quando a permissão está nas permissões efetivas. */
|
|
259
|
+
can: (permission: string) => boolean;
|
|
260
|
+
/** Dados resolvidos pelo adapter ativo. `undefined` enquanto carrega. */
|
|
261
|
+
data: unknown;
|
|
262
|
+
fixture: Fixture | undefined;
|
|
263
|
+
network: NetworkState;
|
|
264
|
+
/** `true` enquanto o adapter resolve. Reflete também o estado `slow`. */
|
|
265
|
+
isLoading: boolean;
|
|
266
|
+
/** Preenchido quando `network` é `error` ou o adapter falhou. */
|
|
267
|
+
error: Error | undefined;
|
|
268
|
+
/** Regras resolvidas do cenário ativo. */
|
|
269
|
+
rules: Rule[];
|
|
270
|
+
viewport: ViewportSetting;
|
|
271
|
+
themeMode: string | undefined;
|
|
272
|
+
locale: string | undefined;
|
|
273
|
+
/** Preferências de acessibilidade ativas no painel. */
|
|
274
|
+
a11y: {
|
|
275
|
+
keyboardMode: boolean;
|
|
276
|
+
reducedMotion: boolean;
|
|
277
|
+
/** Multiplicador de tamanho de texto: 1, 1.25, 1.5, 2. */
|
|
278
|
+
textScale: number;
|
|
279
|
+
};
|
|
280
|
+
/** Navega dentro do Design Space preservando os controles ativos. */
|
|
281
|
+
navigate: (to: string) => void;
|
|
282
|
+
/** Abre outro cenário por id. */
|
|
283
|
+
openScenario: (scenarioId: string) => void;
|
|
284
|
+
};
|
|
285
|
+
export type ViewportSetting = {
|
|
286
|
+
/** `mobile`, `tablet`, `desktop`, `fit` ou `custom`. */
|
|
287
|
+
id: string;
|
|
288
|
+
label: string;
|
|
289
|
+
/** Largura em px. `undefined` em `fit` significa "ocupa o disponível". */
|
|
290
|
+
width?: number;
|
|
291
|
+
height?: number;
|
|
292
|
+
};
|
|
293
|
+
export type ControlsState = {
|
|
294
|
+
scenario: string | undefined;
|
|
295
|
+
persona: string | undefined;
|
|
296
|
+
fixture: string | undefined;
|
|
297
|
+
network: NetworkState;
|
|
298
|
+
viewport: string;
|
|
299
|
+
customWidth: number | undefined;
|
|
300
|
+
themeMode: string | undefined;
|
|
301
|
+
locale: string | undefined;
|
|
302
|
+
dataSource: string | undefined;
|
|
303
|
+
/** Chrome do Design Space oculto: revisão limpa e captura de tela. */
|
|
304
|
+
chrome: boolean;
|
|
305
|
+
keyboardMode: boolean;
|
|
306
|
+
reducedMotion: boolean;
|
|
307
|
+
textScale: number;
|
|
308
|
+
/** Painel lateral direito aberto. */
|
|
309
|
+
inspector: boolean;
|
|
310
|
+
};
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Interpretação de data ISO.
|
|
3
|
+
*
|
|
4
|
+
* Esta é a **primeira** capacidade extraída para o motor por evidência, e não por
|
|
5
|
+
* antecipação (Princípio 10). A régua aplicada foi: apareceu em dois produtos
|
|
6
|
+
* independentes, não carrega nenhuma decisão de aparência e não carrega nenhum
|
|
7
|
+
* conceito de domínio.
|
|
8
|
+
*
|
|
9
|
+
* O bug que a originou: `new Date("2011-09-08")` é parseado como meia-noite
|
|
10
|
+
* **UTC**. Formatado em qualquer fuso a oeste de Greenwich — o Brasil inteiro —
|
|
11
|
+
* exibe o dia anterior. No Bloomy isso apareceu como data de nascimento com um dia
|
|
12
|
+
* de atraso, o que também deslocava o cálculo de idade e portanto a regra do
|
|
13
|
+
* paciente menor de idade. Na Finaya, como vencimento de cobrança errado por um
|
|
14
|
+
* dia.
|
|
15
|
+
*
|
|
16
|
+
* Os dois produtos escreveram a mesma correção separadamente. Quando isso
|
|
17
|
+
* acontece, o lugar da correção é o motor — senão o terceiro produto reescreve o
|
|
18
|
+
* bug.
|
|
19
|
+
*/
|
|
20
|
+
/**
|
|
21
|
+
* Converte uma string ISO em `Date`, lendo data sem horário como **local**.
|
|
22
|
+
*
|
|
23
|
+
* - `"2026-07-30"` → meia-noite no fuso local.
|
|
24
|
+
* - `"2026-07-30T09:00:00-03:00"` → exatamente o instante indicado.
|
|
25
|
+
*
|
|
26
|
+
* A regra é a do próprio padrão: data sem horário não tem fuso, então tratá-la
|
|
27
|
+
* como UTC é uma escolha arbitrária que produz erro de um dia.
|
|
28
|
+
*/
|
|
29
|
+
export declare function parseIsoDate(iso: string): Date;
|
|
30
|
+
/**
|
|
31
|
+
* Idade em anos completos, medida contra uma referência explícita.
|
|
32
|
+
*
|
|
33
|
+
* A referência é obrigatória de propósito. Um valor padrão `new Date()` faria
|
|
34
|
+
* fixture depender do relógio, e o efeito é traiçoeiro: um cenário de "menor sem
|
|
35
|
+
* responsável" deixaria de existir no aniversário de 18 anos da fixture, meses
|
|
36
|
+
* depois de alguém tê-lo aprovado.
|
|
37
|
+
*/
|
|
38
|
+
export declare function ageInYears(birthDate: string, reference: string): number;
|
|
39
|
+
/** Diferença em dias completos entre duas datas, positiva quando `to` é depois. */
|
|
40
|
+
export declare function daysBetween(from: string, to: string): number;
|
package/package.json
ADDED
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@brucesantos/design-space",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Motor neutro do Bananas Design Space: registry de cenários, shell, deep links, controles de persona/viewport/rede, inspetor de regras e ferramentas de acessibilidade. Não contém UI de cliente.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"license": "MIT",
|
|
7
|
+
"author": "Bruno Santos (https://github.com/brucesantos)",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "git+https://github.com/bananas-global/design-space.git",
|
|
11
|
+
"directory": "packages/core"
|
|
12
|
+
},
|
|
13
|
+
"homepage": "https://github.com/bananas-global/design-space#readme",
|
|
14
|
+
"keywords": [
|
|
15
|
+
"design-space",
|
|
16
|
+
"executable-specification",
|
|
17
|
+
"scenarios",
|
|
18
|
+
"design-engineering",
|
|
19
|
+
"react",
|
|
20
|
+
"a11y"
|
|
21
|
+
],
|
|
22
|
+
"sideEffects": [
|
|
23
|
+
"**/*.css"
|
|
24
|
+
],
|
|
25
|
+
"main": "./dist/index.js",
|
|
26
|
+
"module": "./dist/index.js",
|
|
27
|
+
"types": "./dist/index.d.ts",
|
|
28
|
+
"exports": {
|
|
29
|
+
".": {
|
|
30
|
+
"types": "./dist/index.d.ts",
|
|
31
|
+
"default": "./dist/index.js"
|
|
32
|
+
},
|
|
33
|
+
"./testing": {
|
|
34
|
+
"types": "./dist/testing/index.d.ts",
|
|
35
|
+
"default": "./dist/testing.js"
|
|
36
|
+
},
|
|
37
|
+
"./styles.css": "./dist/design-space.css"
|
|
38
|
+
},
|
|
39
|
+
"files": [
|
|
40
|
+
"dist",
|
|
41
|
+
"README.md",
|
|
42
|
+
"CHANGELOG.md"
|
|
43
|
+
],
|
|
44
|
+
"peerDependencies": {
|
|
45
|
+
"react": ">=18",
|
|
46
|
+
"react-dom": ">=18"
|
|
47
|
+
},
|
|
48
|
+
"devDependencies": {
|
|
49
|
+
"@types/node": "^26.1.2",
|
|
50
|
+
"@types/react": "^19.1.8",
|
|
51
|
+
"@types/react-dom": "^19.1.6",
|
|
52
|
+
"@vitejs/plugin-react": "^5.0.0",
|
|
53
|
+
"jsdom": "^26.1.0",
|
|
54
|
+
"react": "^19.1.0",
|
|
55
|
+
"react-dom": "^19.1.0",
|
|
56
|
+
"typescript": "^5.8.3",
|
|
57
|
+
"vite": "^7.0.0",
|
|
58
|
+
"vite-plugin-dts": "^4.5.4",
|
|
59
|
+
"vitest": "^3.2.4"
|
|
60
|
+
},
|
|
61
|
+
"scripts": {
|
|
62
|
+
"build": "vite build",
|
|
63
|
+
"dev": "vite build --watch",
|
|
64
|
+
"typecheck": "tsc --noEmit",
|
|
65
|
+
"test": "vitest run"
|
|
66
|
+
}
|
|
67
|
+
}
|