@brucesantos/design-space 0.1.0 → 0.1.1
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 +33 -1
- package/dist/{contrast-MPoK6VR1.js → contrast-DsgJg12D.js} +88 -88
- package/dist/contrast-DsgJg12D.js.map +1 -0
- package/dist/deploy/index.d.ts +11 -3
- package/dist/index.d.ts +1 -1
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/dist/testing.js +2 -2
- package/dist/types/index.d.ts +38 -0
- package/package.json +1 -1
- package/dist/contrast-MPoK6VR1.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,7 +6,39 @@ 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.1.
|
|
9
|
+
## 0.1.1
|
|
10
|
+
|
|
11
|
+
### Corrigido
|
|
12
|
+
|
|
13
|
+
- **O motor não conseguia detectar o contexto do deployment.** `getDeployContext`
|
|
14
|
+
lia `import.meta.env`, mas o motor é uma biblioteca já compilada: esse
|
|
15
|
+
`import.meta.env` foi resolvido no build do **pacote**, não no build do produto,
|
|
16
|
+
então não sobrava nada para o bundler do produto substituir. O resultado era o
|
|
17
|
+
cabeçalho da revisão sempre em "development", sem branch nem commit — e é o
|
|
18
|
+
commit que torna uma aprovação rastreável.
|
|
19
|
+
|
|
20
|
+
Uma biblioteca publicada não tem como ler o ambiente de build de quem a consome.
|
|
21
|
+
Quem tem acesso a ele é o produto.
|
|
22
|
+
|
|
23
|
+
### Adicionado
|
|
24
|
+
|
|
25
|
+
- **`ProductDefinition.deploy`** (`DeployOverrides`): o produto informa `env`,
|
|
26
|
+
`branch`, `commit`, `branchUrl` e `deploymentUrl`. O que vier preenchido tem
|
|
27
|
+
precedência sobre a detecção por ambiente, que continua funcionando quando o
|
|
28
|
+
motor roda a partir do código-fonte.
|
|
29
|
+
|
|
30
|
+
```ts
|
|
31
|
+
deploy: {
|
|
32
|
+
env: import.meta.env.VITE_VERCEL_ENV,
|
|
33
|
+
branch: import.meta.env.VITE_VERCEL_GIT_COMMIT_REF,
|
|
34
|
+
commit: import.meta.env.VITE_VERCEL_GIT_COMMIT_SHA,
|
|
35
|
+
}
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Compatível com 0.1.0: o campo é opcional e quem não passar continua no
|
|
39
|
+
comportamento anterior — que, na prática, nunca detectou nada em produto real.
|
|
40
|
+
|
|
41
|
+
## 0.1.0
|
|
10
42
|
|
|
11
43
|
Primeira versão do motor. Fase 1 do roadmap.
|
|
12
44
|
|
|
@@ -15,8 +15,8 @@ const b = [
|
|
|
15
15
|
function p(e) {
|
|
16
16
|
return typeof e == "string" && e.trim().length > 0;
|
|
17
17
|
}
|
|
18
|
-
function S(e,
|
|
19
|
-
const
|
|
18
|
+
function S(e, t) {
|
|
19
|
+
const r = [], o = p(e?.id) ? `scenario:${e.id}` : `scenario[${t ?? "?"}]`, n = (d) => r.push({ level: "error", where: o, message: d }), i = (d) => r.push({ level: "warning", where: o, message: d });
|
|
20
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
21
|
"`id` deve ser minúsculo em kebab-case, com o módulo como prefixo: `finance.insurance-denied`."
|
|
22
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(", ")}.`);
|
|
@@ -29,27 +29,27 @@ function S(e, o) {
|
|
|
29
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
30
|
), e?.expected?.length || i(
|
|
31
31
|
"Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater)."
|
|
32
|
-
),
|
|
32
|
+
), r;
|
|
33
33
|
}
|
|
34
34
|
function M(e) {
|
|
35
|
-
const
|
|
36
|
-
p(e.id) ||
|
|
35
|
+
const t = [], r = (c, s, l) => t.push({ level: c, where: s, message: l }), o = 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) || 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.");
|
|
37
37
|
for (const [c, s] of (e.scenarios ?? []).entries()) {
|
|
38
|
-
|
|
38
|
+
t.push(...S(s, c));
|
|
39
39
|
const l = `scenario:${s?.id ?? c}`;
|
|
40
40
|
if (s?.id) {
|
|
41
|
-
d.has(s.id) &&
|
|
41
|
+
d.has(s.id) && r("error", l, `\`id\` duplicado: ${s.id}.`), d.add(s.id);
|
|
42
42
|
const f = s.id.split(".")[0];
|
|
43
|
-
f && a.size > 0 && !a.has(f) &&
|
|
43
|
+
f && a.size > 0 && !a.has(f) && r(
|
|
44
44
|
"warning",
|
|
45
45
|
l,
|
|
46
46
|
`Prefixo \`${f}\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`
|
|
47
47
|
);
|
|
48
48
|
}
|
|
49
|
-
s?.persona && !
|
|
49
|
+
s?.persona && !o.has(s.persona) && r("error", l, `Persona não registrada: \`${s.persona}\`.`), s?.fixture && !n.has(s.fixture) && r("error", l, `Fixture não registrada: \`${s.fixture}\`.`);
|
|
50
50
|
for (const f of s?.rules ?? [])
|
|
51
|
-
i.has(f) ||
|
|
52
|
-
s?.route && !R(s.route, e) &&
|
|
51
|
+
i.has(f) || r("error", l, `Regra não registrada: \`${f}\`.`);
|
|
52
|
+
s?.route && !R(s.route, e) && r(
|
|
53
53
|
"error",
|
|
54
54
|
l,
|
|
55
55
|
`Rota \`${s.route}\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`
|
|
@@ -58,11 +58,11 @@ function M(e) {
|
|
|
58
58
|
for (const c of e.modules ?? [])
|
|
59
59
|
for (const s of c.flows ?? []) {
|
|
60
60
|
const l = `flow:${c.id}/${s.id}`;
|
|
61
|
-
s.steps?.length ||
|
|
61
|
+
s.steps?.length || r("warning", l, "Jornada sem passos.");
|
|
62
62
|
for (const f of s.steps ?? []) {
|
|
63
|
-
d.has(f.scenario) ||
|
|
63
|
+
d.has(f.scenario) || r("error", l, `Passo aponta para cenário inexistente: \`${f.scenario}\`.`);
|
|
64
64
|
for (const [_, g] of Object.entries(f.branches ?? {}))
|
|
65
|
-
d.has(g) ||
|
|
65
|
+
d.has(g) || r(
|
|
66
66
|
"error",
|
|
67
67
|
l,
|
|
68
68
|
`Ramificação "${_}" aponta para cenário inexistente: \`${g}\`.`
|
|
@@ -70,33 +70,33 @@ function M(e) {
|
|
|
70
70
|
}
|
|
71
71
|
}
|
|
72
72
|
const u = e.dataSources?.default;
|
|
73
|
-
return u && u !== "fixtures" && (new Set(e.dataSources?.adapters?.map((s) => s.id) ?? []).has(u) ||
|
|
73
|
+
return u && u !== "fixtures" && (new Set(e.dataSources?.adapters?.map((s) => s.id) ?? []).has(u) || r("error", "product", `\`dataSources.default\` aponta para adapter inexistente: \`${u}\`.`), r(
|
|
74
74
|
"warning",
|
|
75
75
|
"product",
|
|
76
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
|
-
)),
|
|
77
|
+
)), t;
|
|
78
78
|
}
|
|
79
|
-
function R(e,
|
|
80
|
-
const
|
|
81
|
-
return (
|
|
79
|
+
function R(e, t) {
|
|
80
|
+
const r = e.split("?")[0] ?? e;
|
|
81
|
+
return (t.routes ?? []).some((o) => $(o.path, r));
|
|
82
82
|
}
|
|
83
|
-
function $(e,
|
|
84
|
-
const
|
|
85
|
-
for (const [n, i] of
|
|
83
|
+
function $(e, t) {
|
|
84
|
+
const r = e.split("/").filter(Boolean), o = t.split("/").filter(Boolean);
|
|
85
|
+
for (const [n, i] of r.entries()) {
|
|
86
86
|
if (i === "*") return !0;
|
|
87
|
-
const a =
|
|
87
|
+
const a = o[n];
|
|
88
88
|
if (a === void 0) return !1;
|
|
89
89
|
if (!i.startsWith(":") && i !== a)
|
|
90
90
|
return !1;
|
|
91
91
|
}
|
|
92
|
-
return
|
|
93
|
-
}
|
|
94
|
-
function j(e) {
|
|
95
|
-
return e.some((o) => o.level === "error");
|
|
92
|
+
return r.length === o.length;
|
|
96
93
|
}
|
|
97
94
|
function U(e) {
|
|
98
|
-
return e.
|
|
99
|
-
|
|
95
|
+
return e.some((t) => t.level === "error");
|
|
96
|
+
}
|
|
97
|
+
function j(e) {
|
|
98
|
+
return e.length === 0 ? "Nenhum problema encontrado." : e.map((t) => `${t.level === "error" ? "✖" : "▲"} ${t.where}
|
|
99
|
+
${t.message}`).join(`
|
|
100
100
|
`);
|
|
101
101
|
}
|
|
102
102
|
const m = {
|
|
@@ -118,11 +118,11 @@ const m = {
|
|
|
118
118
|
function C(e) {
|
|
119
119
|
return typeof e == "boolean" ? e ? "1" : "0" : String(e);
|
|
120
120
|
}
|
|
121
|
-
function y(e,
|
|
122
|
-
for (const [
|
|
123
|
-
if (
|
|
124
|
-
const n = m[
|
|
125
|
-
n && e.set(n, C(
|
|
121
|
+
function y(e, t = {}) {
|
|
122
|
+
for (const [r, o] of Object.entries(t)) {
|
|
123
|
+
if (o == null) continue;
|
|
124
|
+
const n = m[r];
|
|
125
|
+
n && e.set(n, C(o));
|
|
126
126
|
}
|
|
127
127
|
}
|
|
128
128
|
const I = { BASE_URL: "/", DEV: !1, MODE: "production", PROD: !0, SSR: !1 };
|
|
@@ -130,28 +130,28 @@ function T() {
|
|
|
130
130
|
const e = I;
|
|
131
131
|
return e || (typeof process < "u" && process.env ? process.env : {});
|
|
132
132
|
}
|
|
133
|
-
function A() {
|
|
134
|
-
const
|
|
133
|
+
function A(e = {}) {
|
|
134
|
+
const t = T(), r = e.branchUrl || t.VITE_VERCEL_BRANCH_URL || t.VERCEL_BRANCH_URL, o = e.deploymentUrl || t.VITE_VERCEL_URL || t.VERCEL_URL, n = e.env || t.VITE_VERCEL_ENV || t.VERCEL_ENV, i = e.commit || t.VITE_VERCEL_GIT_COMMIT_SHA || t.VERCEL_GIT_COMMIT_SHA, a = r && `https://${r}` || o && `https://${o}` || (typeof window < "u" ? window.location.origin : "http://localhost:5173");
|
|
135
135
|
return {
|
|
136
|
-
env:
|
|
137
|
-
origin:
|
|
138
|
-
branchUrl:
|
|
139
|
-
deploymentUrl:
|
|
140
|
-
branch: e.VITE_VERCEL_GIT_COMMIT_REF ||
|
|
141
|
-
commit:
|
|
142
|
-
shortCommit:
|
|
143
|
-
isDeployed:
|
|
136
|
+
env: n ?? "development",
|
|
137
|
+
origin: a.replace(/\/$/, ""),
|
|
138
|
+
branchUrl: r,
|
|
139
|
+
deploymentUrl: o,
|
|
140
|
+
branch: e.branch || t.VITE_VERCEL_GIT_COMMIT_REF || t.VERCEL_GIT_COMMIT_REF,
|
|
141
|
+
commit: i,
|
|
142
|
+
shortCommit: i?.slice(0, 7),
|
|
143
|
+
isDeployed: n === "preview" || n === "production"
|
|
144
144
|
};
|
|
145
145
|
}
|
|
146
|
-
function N(e,
|
|
147
|
-
const
|
|
148
|
-
return
|
|
146
|
+
function N(e, t = {}) {
|
|
147
|
+
const r = t.origin ?? A().origin, o = new URL(e.route, r);
|
|
148
|
+
return o.searchParams.set(m.scenario, e.id), o.searchParams.set(m.persona, e.persona), o.searchParams.set(m.fixture, e.fixture), e.network && e.network !== "success" && o.searchParams.set(m.network, e.network), y(o.searchParams, t.overrides), o.toString();
|
|
149
149
|
}
|
|
150
|
-
function D(e,
|
|
151
|
-
const
|
|
152
|
-
if (!
|
|
153
|
-
const
|
|
154
|
-
return N(e, { origin:
|
|
150
|
+
function D(e, t) {
|
|
151
|
+
const r = t.commit ?? A().shortCommit;
|
|
152
|
+
if (!r) return;
|
|
153
|
+
const o = `https://${t.project}-${r}-${t.scope}.vercel.app`;
|
|
154
|
+
return N(e, { origin: o });
|
|
155
155
|
}
|
|
156
156
|
const E = {
|
|
157
157
|
AA: { normal: 4.5, large: 3 },
|
|
@@ -162,10 +162,10 @@ const E = {
|
|
|
162
162
|
transparent: "#00000000"
|
|
163
163
|
};
|
|
164
164
|
function v(e) {
|
|
165
|
-
const
|
|
166
|
-
if (
|
|
167
|
-
if (
|
|
168
|
-
const n =
|
|
165
|
+
const t = e.trim().toLowerCase(), r = k[t];
|
|
166
|
+
if (r) return v(r);
|
|
167
|
+
if (t.startsWith("#")) {
|
|
168
|
+
const n = t.slice(1), i = (a) => Number.parseInt(a.repeat(2), 16);
|
|
169
169
|
if (n.length === 3 || n.length === 4) {
|
|
170
170
|
const [a, d, u, c] = [...n];
|
|
171
171
|
return !a || !d || !u ? void 0 : { r: i(a), g: i(d), b: i(u), a: c ? i(c) / 255 : 1 };
|
|
@@ -181,63 +181,63 @@ function v(e) {
|
|
|
181
181
|
}
|
|
182
182
|
return;
|
|
183
183
|
}
|
|
184
|
-
const
|
|
185
|
-
if (
|
|
186
|
-
const n =
|
|
184
|
+
const o = t.match(/^rgba?\(([^)]+)\)$/);
|
|
185
|
+
if (o?.[1]) {
|
|
186
|
+
const n = o[1].split(/[\s,/]+/).filter(Boolean), [i, a, d, u] = n.map(Number);
|
|
187
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
188
|
}
|
|
189
189
|
}
|
|
190
|
-
function L(e,
|
|
190
|
+
function L(e, t) {
|
|
191
191
|
if (e.a >= 1) return e;
|
|
192
|
-
const
|
|
192
|
+
const r = (o, n) => o * e.a + n * (1 - e.a);
|
|
193
193
|
return {
|
|
194
|
-
r:
|
|
195
|
-
g:
|
|
196
|
-
b:
|
|
194
|
+
r: r(e.r, t.r),
|
|
195
|
+
g: r(e.g, t.g),
|
|
196
|
+
b: r(e.b, t.b),
|
|
197
197
|
a: 1
|
|
198
198
|
};
|
|
199
199
|
}
|
|
200
|
-
function h({ r: e, g:
|
|
201
|
-
const
|
|
200
|
+
function h({ r: e, g: t, b: r }) {
|
|
201
|
+
const o = (n) => {
|
|
202
202
|
const i = n / 255;
|
|
203
203
|
return i <= 0.03928 ? i / 12.92 : ((i + 0.055) / 1.055) ** 2.4;
|
|
204
204
|
};
|
|
205
|
-
return 0.2126 *
|
|
205
|
+
return 0.2126 * o(e) + 0.7152 * o(t) + 0.0722 * o(r);
|
|
206
206
|
}
|
|
207
|
-
function P(e,
|
|
208
|
-
const
|
|
209
|
-
if (!
|
|
210
|
-
const n = L(
|
|
207
|
+
function P(e, t) {
|
|
208
|
+
const r = v(t), o = v(e);
|
|
209
|
+
if (!r || !o) return;
|
|
210
|
+
const n = L(o, r), i = Math.max(h(n), h(r)), a = Math.min(h(n), h(r));
|
|
211
211
|
return (i + 0.05) / (a + 0.05);
|
|
212
212
|
}
|
|
213
213
|
function V(e) {
|
|
214
|
-
const
|
|
214
|
+
const t = e.target ?? "AA", r = e.largeText ? E[t].large : E[t].normal, o = P(e.foreground, e.background);
|
|
215
215
|
return {
|
|
216
216
|
pair: e,
|
|
217
|
-
target:
|
|
218
|
-
ratio:
|
|
219
|
-
required:
|
|
220
|
-
passes:
|
|
221
|
-
label:
|
|
217
|
+
target: t,
|
|
218
|
+
ratio: o,
|
|
219
|
+
required: r,
|
|
220
|
+
passes: o === void 0 ? void 0 : o >= r,
|
|
221
|
+
label: o === void 0 ? "não medido" : `${o.toFixed(2)}:1`
|
|
222
222
|
};
|
|
223
223
|
}
|
|
224
224
|
function O(e = []) {
|
|
225
225
|
return e.map(V);
|
|
226
226
|
}
|
|
227
227
|
function z(e) {
|
|
228
|
-
const
|
|
229
|
-
if (
|
|
230
|
-
const
|
|
231
|
-
(
|
|
228
|
+
const t = O(e).filter((o) => o.passes !== !0);
|
|
229
|
+
if (t.length === 0) return;
|
|
230
|
+
const r = t.map(
|
|
231
|
+
(o) => ` ✖ ${o.pair.name}: ${o.label} (mínimo ${o.required}:1 para ${o.target}${o.pair.largeText ? ", texto grande" : ""})`
|
|
232
232
|
).join(`
|
|
233
233
|
`);
|
|
234
234
|
throw new Error(`Pares de contraste fora do alvo:
|
|
235
|
-
${
|
|
235
|
+
${r}`);
|
|
236
236
|
}
|
|
237
|
-
function B(e,
|
|
237
|
+
function B(e, t) {
|
|
238
238
|
if (typeof window > "u") return;
|
|
239
|
-
const
|
|
240
|
-
return window.getComputedStyle(
|
|
239
|
+
const r = t ?? document.documentElement;
|
|
240
|
+
return window.getComputedStyle(r).getPropertyValue(e).trim() || void 0;
|
|
241
241
|
}
|
|
242
242
|
export {
|
|
243
243
|
E as C,
|
|
@@ -252,8 +252,8 @@ export {
|
|
|
252
252
|
P as f,
|
|
253
253
|
A as g,
|
|
254
254
|
L as h,
|
|
255
|
-
|
|
256
|
-
j,
|
|
255
|
+
j as i,
|
|
256
|
+
U as j,
|
|
257
257
|
h as k,
|
|
258
258
|
C as l,
|
|
259
259
|
S as m,
|
|
@@ -262,4 +262,4 @@ export {
|
|
|
262
262
|
N as s,
|
|
263
263
|
M as v
|
|
264
264
|
};
|
|
265
|
-
//# sourceMappingURL=contrast-
|
|
265
|
+
//# sourceMappingURL=contrast-DsgJg12D.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contrast-DsgJg12D.js","sources":["../src/types/index.ts","../src/registry/validate.ts","../src/controls/params.ts","../src/deploy/index.ts","../src/a11y/contrast.ts"],"sourcesContent":["/**\n * Contratos públicos do motor.\n *\n * Estes tipos são a fronteira entre o motor e o produto. O motor nunca conhece\n * um componente, um token ou uma persona concreta: conhece apenas a forma.\n *\n * Regra de fronteira (D-02): se aparece dentro da interface do cliente e\n * contribui para sua linguagem visual ou seu domínio, pertence ao repositório\n * daquele produto e não a este arquivo.\n */\n\nimport type { ComponentType, ReactNode } from \"react\";\n\n/* ------------------------------------------------------------------ *\n * Ciclo de vida\n * ------------------------------------------------------------------ */\n\n/**\n * Estado de ciclo de vida do cenário (§18.1). Existe para evitar que a\n * referência envelheça em silêncio quando o produto real muda.\n */\nexport type ScenarioStatus =\n | \"proposed\"\n | \"in-review\"\n | \"approved\"\n | \"in-implementation\"\n | \"implemented\"\n | \"superseded\";\n\nexport const SCENARIO_STATUSES: readonly ScenarioStatus[] = [\n \"proposed\",\n \"in-review\",\n \"approved\",\n \"in-implementation\",\n \"implemented\",\n \"superseded\",\n] as const;\n\n/* ------------------------------------------------------------------ *\n * Acessibilidade (§6.1) — dimensão de primeira classe, não auditoria final\n * ------------------------------------------------------------------ */\n\n/** Nível de conformidade alvo. O padrão interno é WCAG 2.2 AA. */\nexport type ContrastTarget = \"AA\" | \"AAA\";\n\n/** Quanto da jornada precisa ser completável só por teclado. */\nexport type KeyboardCoverage = \"full\" | \"partial\" | \"not-applicable\";\n\nexport type A11yContract = {\n /**\n * `full` significa: a jornada declarada por este cenário é completável do\n * início ao fim sem mouse, com foco visível em cada passo.\n */\n keyboard: KeyboardCoverage;\n /** Nível de contraste exigido para os tokens em uso nesta tela. */\n contrast: ContrastTarget;\n /**\n * Eventos que precisam ser anunciados para leitor de tela. São chaves de\n * domínio, não seletores: `claim.status`, `retry.result`.\n *\n * Um cenário de convênio recusado em que a recusa não é anunciada está\n * incompleto, não está pronto para aprovação.\n */\n announces?: string[];\n /** Observação de revisão humana. O automático é piso, não teto. */\n notes?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Persona\n * ------------------------------------------------------------------ */\n\nexport type Persona = {\n /** Identificador estável usado em URL e em cenário. */\n id: string;\n /** Nome no vocabulário do cliente: \"Recepcionista\". */\n name: string;\n /** O que essa pessoa está tentando fazer. */\n goal?: string;\n /** Permissões concedidas por padrão a este papel. */\n permissions: string[];\n description?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Regra de negócio\n * ------------------------------------------------------------------ */\n\nexport type Rule = {\n /** Identificador citado por cenários: `retry-after-document-review`. */\n id: string;\n /** Enunciado curto, na linguagem do produto. */\n statement: string;\n /** Por que a regra existe. Contexto, não implementação. */\n rationale?: string;\n /** Onde a regra vive no código, quando existir: `src/rules/claims.ts`. */\n source?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Fixture\n * ------------------------------------------------------------------ */\n\n/**\n * Dado sintético e determinístico que materializa um cenário.\n *\n * O motor não conhece o formato de `data` — isso é contrato do produto. O que\n * o motor garante é que a mesma URL produz a mesma fixture (§15.1\n * \"Determinismo\"), então `data` precisa ser um valor puro ou uma factory pura.\n */\nexport type Fixture<T = unknown> = {\n id: string;\n /** Rótulo legível para o seletor de conjunto de dados. */\n label: string;\n description?: string;\n /** Valor determinístico, ou factory pura que devolve um valor determinístico. */\n data: T | (() => T);\n};\n\n/* ------------------------------------------------------------------ *\n * Estado de rede\n * ------------------------------------------------------------------ */\n\nexport type NetworkState = \"success\" | \"loading\" | \"empty\" | \"error\" | \"slow\";\n\nexport const NETWORK_STATES: readonly NetworkState[] = [\n \"success\",\n \"loading\",\n \"empty\",\n \"error\",\n \"slow\",\n] as const;\n\n/* ------------------------------------------------------------------ *\n * Cenário — a unidade central (D-06)\n * ------------------------------------------------------------------ */\n\n/**\n * Um cenário não é uma tela com dados diferentes. Ele combina intenção,\n * persona, permissões, pré-condições, dados, estado inicial, ações\n * disponíveis, regras e resultado esperado.\n */\nexport type Scenario = {\n /** `modulo.situacao` em kebab-case: `finance.insurance-denied`. */\n id: string;\n /** Título no vocabulário do negócio: \"Convênio recusado\". */\n title: string;\n /** Rota que o cenário abre. Precisa casar com uma rota do produto. */\n route: string;\n /** Id de uma persona registrada no produto. */\n persona: string;\n /**\n * Permissões efetivas do cenário. Quando ausente, herda as da persona.\n * Declarar aqui permite representar \"recepcionista sem permissão de\n * cancelamento\" sem inventar uma segunda persona.\n */\n permissions?: string[];\n /** Id de uma fixture registrada no produto. */\n fixture: string;\n /** Ids de regras que governam esta situação. */\n rules?: string[];\n /** Contrato de acessibilidade da situação. */\n a11y: A11yContract;\n /** Estado de ciclo de vida. */\n status: ScenarioStatus;\n\n /** Intenção: o que se quer discutir ou verificar aqui. */\n intent?: string;\n /** Pré-condições em linguagem de negócio. */\n preconditions?: string[];\n /** Ações que a persona pode executar nesta situação. */\n actions?: string[];\n /** Resultado esperado — vira caso de teste no handoff. */\n expected?: string[];\n /** Estado de rede inicial. Padrão: `success`. */\n network?: NetworkState;\n /** Rótulos livres para busca: \"exceção\", \"permissão\", \"vazio\". */\n tags?: string[];\n /**\n * URL de commit que registra a aprovação (§10.2). Imutável por definição:\n * a aprovação não pode mudar de conteúdo debaixo de quem aprovou.\n */\n approvedAt?: { url: string; commit: string; date: string };\n /** Ticket de engenharia, quando o cenário estiver em implementação. */\n ticket?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Organização: módulo e jornada\n * ------------------------------------------------------------------ */\n\n/**\n * Uma jornada é uma sequência de passos com ramificações. Cada passo aponta\n * para um cenário, então uma jornada é navegável e testável sem duplicar\n * definição.\n */\nexport type Flow = {\n id: string;\n /** Título de negócio: \"Agendar uma consulta\". */\n title: string;\n description?: string;\n steps: FlowStep[];\n};\n\nexport type FlowStep = {\n /** Cenário que materializa este passo. */\n scenario: string;\n /** Rótulo do passo, quando diferir do título do cenário. */\n label?: string;\n /** Decisão tomada aqui, quando o passo ramifica. */\n decision?: string;\n /** Saídas alternativas: rótulo → id de cenário. */\n branches?: Record<string, string>;\n};\n\nexport type Module = {\n /** `agenda`, `patients`, `finance`. */\n id: string;\n /** Nome no vocabulário do cliente: \"Agenda\". */\n name: string;\n description?: string;\n /** Jornadas guiadas do módulo. Opcional: navegação livre é o padrão. */\n flows?: Flow[];\n};\n\n/* ------------------------------------------------------------------ *\n * Rotas declarativas\n * ------------------------------------------------------------------ */\n\n/**\n * Rota declarativa do produto. O motor casa `path` contra a URL e renderiza\n * `screen`, passando os parâmetros dinâmicos.\n *\n * Sintaxe de `path`: segmentos literais e `:param`. Um `*` final captura o\n * resto em `params[\"*\"]`.\n */\nexport type RouteDefinition = {\n path: string;\n screen: ComponentType<ScreenProps>;\n};\n\nexport type ScreenProps = {\n /** Parâmetros dinâmicos casados da rota. */\n params: Record<string, string>;\n /** Contexto do cenário ativo, resolvido pelo motor. */\n context: ScenarioContext;\n};\n\n/* ------------------------------------------------------------------ *\n * Adapters de dados (§7)\n * ------------------------------------------------------------------ */\n\n/**\n * A UI do produto nunca depende diretamente de um backend. A camada de\n * adapters permite alimentar o mesmo cenário por fixture, REST, GraphQL ou\n * staging sem alterar a composição visual.\n */\nexport type DataSourceAdapter<T = unknown> = {\n id: string;\n label: string;\n /**\n * Resolve os dados de um cenário. Recebe a fixture declarada para que um\n * adapter remoto possa usá-la como fallback ou como semente.\n */\n load: (request: DataRequest) => Promise<T> | T;\n};\n\nexport type DataRequest = {\n scenario: Scenario;\n fixture: Fixture | undefined;\n network: NetworkState;\n};\n\n/* ------------------------------------------------------------------ *\n * Tema do produto\n * ------------------------------------------------------------------ */\n\n/**\n * O motor não impõe aparência (D-02). Recebe do produto apenas o suficiente\n * para validar contraste e oferecer os controles de tema.\n */\nexport type ProductTheme = {\n /**\n * Pares de cores que precisam passar na validação de contraste.\n * Contraste é propriedade de par, então validar na definição do token\n * resolve na origem, uma vez, em vez de perseguir o problema em 30 telas.\n */\n contrastPairs?: ContrastPair[];\n /** Modos de tema disponíveis no produto, quando houver mais de um. */\n modes?: string[];\n /** Idiomas disponíveis, quando o produto tiver essa variação. */\n locales?: string[];\n};\n\nexport type ContrastPair = {\n /** Nome do par: `fg-1 sobre bg-app`. */\n name: string;\n /** Cor de frente em hex, rgb() ou rgba(). */\n foreground: string;\n /** Cor de fundo. Precisa ser opaca. */\n background: string;\n /** `AA` por padrão. */\n target?: ContrastTarget;\n /** Texto grande (>=24px, ou >=18.66px bold) tem limiar menor. */\n largeText?: boolean;\n};\n\n/* ------------------------------------------------------------------ *\n * Definição do produto — a única coisa que o produto entrega ao motor\n * ------------------------------------------------------------------ */\n\nexport type ProductDefinition = {\n /** `bloomy`. */\n id: string;\n /** \"Bloomy\". */\n name: string;\n /** Uma linha sobre o produto, exibida na entrada do Design Space. */\n tagline?: string;\n modules: Module[];\n scenarios: Scenario[];\n personas: Persona[];\n fixtures: Fixture[];\n rules?: Rule[];\n routes: RouteDefinition[];\n theme?: ProductTheme;\n /**\n * Adapters de dados disponíveis. `fixtures` é o padrão (D-05); qualquer\n * outro entra como opção explícita e justificada.\n */\n dataSources?: {\n default: string;\n adapters?: DataSourceAdapter[];\n };\n /**\n * Contexto do deployment, informado pelo produto.\n *\n * O motor **não consegue** descobrir isso sozinho. Ele é uma biblioteca já\n * compilada: o `import.meta.env` do código dele foi resolvido no build do\n * pacote, não no build do produto, então não sobra nada para o bundler do\n * produto substituir. Quem tem acesso ao próprio ambiente de build é o produto.\n *\n * Passe os valores do bundler:\n *\n * ```ts\n * deploy: {\n * env: import.meta.env.VITE_VERCEL_ENV,\n * branch: import.meta.env.VITE_VERCEL_GIT_COMMIT_REF,\n * commit: import.meta.env.VITE_VERCEL_GIT_COMMIT_SHA,\n * }\n * ```\n *\n * Sem isso o cabeçalho da revisão mostra \"development\" e fica sem branch nem\n * commit — e é o commit que torna uma aprovação rastreável.\n */\n deploy?: DeployOverrides;\n\n /** Renderizado quando nenhuma rota casa. Padrão: aviso neutro do motor. */\n notFound?: ComponentType<{ path: string }>;\n /** Envolve a UI do produto. Serve para providers de tema, i18n ou store. */\n wrapper?: ComponentType<{ children: ReactNode; context: ScenarioContext }>;\n};\n\n/**\n * Contexto do deployment informado pelo produto. Todos os campos são opcionais:\n * o que vier preenchido substitui a detecção do motor.\n */\nexport type DeployOverrides = {\n /** `development`, `preview` ou `production`. */\n env?: string;\n /** Domínio da branch, sem protocolo. Quando ausente, usa a origem da janela. */\n branchUrl?: string;\n /** Domínio único deste deployment, sem protocolo. */\n deploymentUrl?: string;\n /** Nome da branch, para rotular a revisão. */\n branch?: string;\n /** Commit exato, gravado junto com o status de aprovação do cenário. */\n commit?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Contexto exposto à UI do produto\n * ------------------------------------------------------------------ */\n\n/**\n * O que a UI do produto recebe do motor. Deliberadamente pequeno: dados,\n * papel, permissões e estado de ambiente. Nada de componente, token ou\n * aparência.\n */\nexport type ScenarioContext = {\n scenario: Scenario | undefined;\n persona: Persona | undefined;\n /** Permissões efetivas: as do cenário, ou as da persona quando ausentes. */\n permissions: string[];\n /** `true` quando a permissão está nas permissões efetivas. */\n can: (permission: string) => boolean;\n /** Dados resolvidos pelo adapter ativo. `undefined` enquanto carrega. */\n data: unknown;\n fixture: Fixture | undefined;\n network: NetworkState;\n /** `true` enquanto o adapter resolve. Reflete também o estado `slow`. */\n isLoading: boolean;\n /** Preenchido quando `network` é `error` ou o adapter falhou. */\n error: Error | undefined;\n /** Regras resolvidas do cenário ativo. */\n rules: Rule[];\n viewport: ViewportSetting;\n themeMode: string | undefined;\n locale: string | undefined;\n /** Preferências de acessibilidade ativas no painel. */\n a11y: {\n keyboardMode: boolean;\n reducedMotion: boolean;\n /** Multiplicador de tamanho de texto: 1, 1.25, 1.5, 2. */\n textScale: number;\n };\n /** Navega dentro do Design Space preservando os controles ativos. */\n navigate: (to: string) => void;\n /** Abre outro cenário por id. */\n openScenario: (scenarioId: string) => void;\n};\n\nexport type ViewportSetting = {\n /** `mobile`, `tablet`, `desktop`, `fit` ou `custom`. */\n id: string;\n label: string;\n /** Largura em px. `undefined` em `fit` significa \"ocupa o disponível\". */\n width?: number;\n height?: number;\n};\n\n/* ------------------------------------------------------------------ *\n * Estado dos controles — serializado na URL (deep link)\n * ------------------------------------------------------------------ */\n\nexport type ControlsState = {\n scenario: string | undefined;\n persona: string | undefined;\n fixture: string | undefined;\n network: NetworkState;\n viewport: string;\n customWidth: number | undefined;\n themeMode: string | undefined;\n locale: string | undefined;\n dataSource: string | undefined;\n /** Chrome do Design Space oculto: revisão limpa e captura de tela. */\n chrome: boolean;\n keyboardMode: boolean;\n reducedMotion: boolean;\n textScale: number;\n /** Painel lateral direito aberto. */\n inspector: boolean;\n};\n","/**\n * Validação em runtime do contrato de cenário (E2).\n *\n * Existe porque tipo de TypeScript desaparece no build: uma fixture inexistente\n * ou uma persona escrita errada só apareceria como tela vazia no preview, que é\n * exatamente o tipo de erro que corrói a confiança no ambiente. Aqui ela\n * aparece como problema nomeado, no painel e no CI.\n *\n * Sem dependência de schema externo de propósito: o contrato é pequeno, e o\n * motor precisa ficar pequeno e neutro (Princípio 6).\n */\n\nimport {\n NETWORK_STATES,\n SCENARIO_STATUSES,\n type ProductDefinition,\n type Scenario,\n} from \"../types/index.js\";\n\nexport type ValidationIssue = {\n level: \"error\" | \"warning\";\n /** Onde o problema está: `scenario:finance.insurance-denied`. */\n where: string;\n message: string;\n};\n\nconst ID_PATTERN = /^[a-z0-9]+([.\\-][a-z0-9]+)*$/;\n\nfunction isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.trim().length > 0;\n}\n\n/**\n * Valida um cenário isolado: forma, não referências. Referências dependem do\n * produto inteiro e são checadas em {@link validateProduct}.\n */\nexport function validateScenario(scenario: Scenario, index?: number): ValidationIssue[] {\n const issues: ValidationIssue[] = [];\n const where = isNonEmptyString(scenario?.id)\n ? `scenario:${scenario.id}`\n : `scenario[${index ?? \"?\"}]`;\n\n const err = (message: string) => issues.push({ level: \"error\", where, message });\n const warn = (message: string) => issues.push({ level: \"warning\", where, message });\n\n if (!isNonEmptyString(scenario?.id)) {\n err(\"`id` é obrigatório.\");\n } else if (!ID_PATTERN.test(scenario.id)) {\n err(\n \"`id` deve ser minúsculo em kebab-case, com o módulo como prefixo: `finance.insurance-denied`.\",\n );\n } else if (!scenario.id.includes(\".\")) {\n warn(\"`id` sem prefixo de módulo dificulta a navegação e a busca do agente.\");\n }\n\n if (!isNonEmptyString(scenario?.title)) {\n err(\"`title` é obrigatório e deve usar o vocabulário do negócio.\");\n }\n\n if (!isNonEmptyString(scenario?.route)) {\n err(\"`route` é obrigatório.\");\n } else if (!scenario.route.startsWith(\"/\")) {\n err(\"`route` deve começar com `/`.\");\n }\n\n if (!isNonEmptyString(scenario?.persona)) err(\"`persona` é obrigatório.\");\n if (!isNonEmptyString(scenario?.fixture)) {\n err(\"`fixture` é obrigatório. O padrão do ambiente é dado sintético (D-05).\");\n }\n\n if (!SCENARIO_STATUSES.includes(scenario?.status)) {\n err(`\\`status\\` deve ser um de: ${SCENARIO_STATUSES.join(\", \")}.`);\n }\n\n if (scenario?.network && !NETWORK_STATES.includes(scenario.network)) {\n err(`\\`network\\` deve ser um de: ${NETWORK_STATES.join(\", \")}.`);\n }\n\n const a11y = scenario?.a11y;\n if (!a11y || typeof a11y !== \"object\") {\n err(\n \"`a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de projeto (D-15).\",\n );\n } else {\n if (![\"full\", \"partial\", \"not-applicable\"].includes(a11y.keyboard)) {\n err(\"`a11y.keyboard` deve ser `full`, `partial` ou `not-applicable`.\");\n }\n if (![\"AA\", \"AAA\"].includes(a11y.contrast)) {\n err(\"`a11y.contrast` deve ser `AA` ou `AAA`. O padrão interno é WCAG 2.2 AA.\");\n }\n if (a11y.announces !== undefined && !Array.isArray(a11y.announces)) {\n err(\"`a11y.announces` deve ser uma lista de chaves de evento de domínio.\");\n }\n }\n\n // Gate do roadmap: não aprovar cenário de jornada crítica sem acessibilidade\n // verificada. O motor não sabe o que é crítico, então checa o que dá:\n // aprovado com teclado parcial é sinal de aprovação apressada.\n if (scenario?.status === \"approved\" && a11y?.keyboard === \"partial\") {\n warn(\n \"Cenário aprovado com `a11y.keyboard: \\\"partial\\\"`. Confirme que esta jornada não é crítica.\",\n );\n }\n\n if (scenario?.status === \"approved\" && !scenario.approvedAt) {\n warn(\n \"Cenário aprovado sem `approvedAt`. A aprovação deve ser registrada por URL de commit (§10.2), senão muda de conteúdo debaixo de quem aprovou.\",\n );\n }\n\n if (!scenario?.expected?.length) {\n warn(\n \"Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater).\",\n );\n }\n\n return issues;\n}\n\n/**\n * Valida o produto inteiro: forma de cada cenário mais integridade das\n * referências entre cenário, persona, fixture, regra e rota.\n */\nexport function validateProduct(product: ProductDefinition): ValidationIssue[] {\n const issues: ValidationIssue[] = [];\n const push = (level: ValidationIssue[\"level\"], where: string, message: string) =>\n issues.push({ level, where, message });\n\n const personaIds = new Set(product.personas?.map((p) => p.id) ?? []);\n const fixtureIds = new Set(product.fixtures?.map((f) => f.id) ?? []);\n const ruleIds = new Set(product.rules?.map((r) => r.id) ?? []);\n const moduleIds = new Set(product.modules?.map((m) => m.id) ?? []);\n const scenarioIds = new Set<string>();\n\n if (!isNonEmptyString(product.id)) push(\"error\", \"product\", \"`id` é obrigatório.\");\n if (!isNonEmptyString(product.name)) push(\"error\", \"product\", \"`name` é obrigatório.\");\n if (!product.routes?.length) {\n push(\"error\", \"product\", \"`routes` está vazio: nenhum cenário conseguirá renderizar.\");\n }\n\n for (const [index, scenario] of (product.scenarios ?? []).entries()) {\n issues.push(...validateScenario(scenario, index));\n\n const where = `scenario:${scenario?.id ?? index}`;\n\n if (scenario?.id) {\n if (scenarioIds.has(scenario.id)) {\n push(\"error\", where, `\\`id\\` duplicado: ${scenario.id}.`);\n }\n scenarioIds.add(scenario.id);\n\n const modulePrefix = scenario.id.split(\".\")[0];\n if (modulePrefix && moduleIds.size > 0 && !moduleIds.has(modulePrefix)) {\n push(\n \"warning\",\n where,\n `Prefixo \\`${modulePrefix}\\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`,\n );\n }\n }\n\n if (scenario?.persona && !personaIds.has(scenario.persona)) {\n push(\"error\", where, `Persona não registrada: \\`${scenario.persona}\\`.`);\n }\n if (scenario?.fixture && !fixtureIds.has(scenario.fixture)) {\n push(\"error\", where, `Fixture não registrada: \\`${scenario.fixture}\\`.`);\n }\n for (const rule of scenario?.rules ?? []) {\n if (!ruleIds.has(rule)) {\n push(\"error\", where, `Regra não registrada: \\`${rule}\\`.`);\n }\n }\n if (scenario?.route && !matchesAnyRoute(scenario.route, product)) {\n push(\n \"error\",\n where,\n `Rota \\`${scenario.route}\\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`,\n );\n }\n }\n\n for (const module of product.modules ?? []) {\n for (const flow of module.flows ?? []) {\n const where = `flow:${module.id}/${flow.id}`;\n if (!flow.steps?.length) push(\"warning\", where, \"Jornada sem passos.\");\n for (const step of flow.steps ?? []) {\n if (!scenarioIds.has(step.scenario)) {\n push(\"error\", where, `Passo aponta para cenário inexistente: \\`${step.scenario}\\`.`);\n }\n for (const [label, target] of Object.entries(step.branches ?? {})) {\n if (!scenarioIds.has(target)) {\n push(\n \"error\",\n where,\n `Ramificação \"${label}\" aponta para cenário inexistente: \\`${target}\\`.`,\n );\n }\n }\n }\n }\n }\n\n const defaultSource = product.dataSources?.default;\n if (defaultSource && defaultSource !== \"fixtures\") {\n const adapterIds = new Set(product.dataSources?.adapters?.map((a) => a.id) ?? []);\n if (!adapterIds.has(defaultSource)) {\n push(\"error\", \"product\", `\\`dataSources.default\\` aponta para adapter inexistente: \\`${defaultSource}\\`.`);\n }\n push(\n \"warning\",\n \"product\",\n \"A fonte padrão não é `fixtures`. O padrão do ambiente é dado sintético e determinístico (D-05); API real entra como adapter opcional, com justificativa.\",\n );\n }\n\n return issues;\n}\n\nfunction matchesAnyRoute(route: string, product: ProductDefinition): boolean {\n const path = route.split(\"?\")[0] ?? route;\n return (product.routes ?? []).some((definition) => matchPathShape(definition.path, path));\n}\n\n/**\n * Casamento de forma de rota, usado pela validação. O casamento com extração de\n * parâmetros vive em `router/`; aqui só interessa \"existe rota compatível\".\n */\nfunction matchPathShape(pattern: string, path: string): boolean {\n const patternSegments = pattern.split(\"/\").filter(Boolean);\n const pathSegments = path.split(\"/\").filter(Boolean);\n\n for (const [index, segment] of patternSegments.entries()) {\n if (segment === \"*\") return true;\n const actual = pathSegments[index];\n if (actual === undefined) return false;\n if (segment.startsWith(\":\")) continue;\n if (segment !== actual) return false;\n }\n\n return patternSegments.length === pathSegments.length;\n}\n\n/** `true` quando existe pelo menos uma violação de nível `error`. */\nexport function hasErrors(issues: ValidationIssue[]): boolean {\n return issues.some((issue) => issue.level === \"error\");\n}\n\n/** Formata as violações para saída de terminal, usada no CI e em testes. */\nexport function formatIssues(issues: ValidationIssue[]): string {\n if (issues.length === 0) return \"Nenhum problema encontrado.\";\n return issues\n .map((issue) => `${issue.level === \"error\" ? \"✖\" : \"▲\"} ${issue.where}\\n ${issue.message}`)\n .join(\"\\n\");\n}\n","/**\n * Nomes dos parâmetros de URL, em um módulo próprio.\n *\n * Separado de `state.ts` porque `deploy/` também precisa deste mapa para montar\n * deep links, e importar o estado inteiro criaria dependência circular. Mais\n * importante: com o mapa em um só lugar, é impossível um override de teste\n * escrever `keyboardMode=1` quando a URL real usa `kb=1`.\n */\n\nimport type { ControlsState } from \"../types/index.js\";\n\n/** Nomes curtos: a URL é colada em Slack, em ticket e em thread de revisão. */\nexport const PARAM = {\n scenario: \"scenario\",\n persona: \"persona\",\n fixture: \"fixture\",\n network: \"network\",\n viewport: \"viewport\",\n customWidth: \"w\",\n themeMode: \"theme\",\n locale: \"locale\",\n dataSource: \"source\",\n chrome: \"chrome\",\n keyboardMode: \"kb\",\n reducedMotion: \"motion\",\n textScale: \"scale\",\n inspector: \"panel\",\n} as const satisfies Record<keyof ControlsState, string>;\n\n/**\n * Serializa um valor de controle para a query string.\n *\n * Booleano vira `1`/`0` e não `true`/`false`: é o que o parser espera, e a URL\n * fica mais curta.\n */\nexport function serializeValue(value: unknown): string {\n if (typeof value === \"boolean\") return value ? \"1\" : \"0\";\n return String(value);\n}\n\n/**\n * Aplica overrides de {@link ControlsState} em uma `URLSearchParams`, traduzindo\n * as chaves do estado para os nomes de parâmetro.\n */\nexport function applyOverrides(\n params: URLSearchParams,\n overrides: Partial<ControlsState> = {},\n): void {\n for (const [key, value] of Object.entries(overrides)) {\n if (value === undefined || value === null) continue;\n const param = PARAM[key as keyof ControlsState];\n if (!param) continue;\n params.set(param, serializeValue(value));\n }\n}\n","/**\n * Contexto de deployment e deep links (§10.3).\n *\n * A Vercel expõe o contexto do deployment como variável de ambiente. O motor lê\n * esse contexto e monta a URL absoluta de qualquer cenário sem nenhum domínio\n * hardcoded — que é o que permite o botão \"copiar link\" funcionar igual em\n * localhost, em preview de branch e em produção.\n *\n * As variáveis precisam do prefixo `VITE_` para chegar ao cliente. O template já\n * nasce com o mapeamento no `vite.config.ts`.\n */\n\nimport type { ControlsState, DeployOverrides, Scenario } from \"../types/index.js\";\nimport { PARAM, applyOverrides } from \"../controls/params.js\";\n\nexport type DeployContext = {\n /** `development`, `preview` ou `production`. */\n env: string;\n /** Origem absoluta, com protocolo, sem barra final. */\n origin: string;\n /** Domínio estável da branch, quando em preview. */\n branchUrl: string | undefined;\n /** Domínio único deste deployment. Imutável. */\n deploymentUrl: string | undefined;\n /** Nome da branch, para rotular a revisão na interface. */\n branch: string | undefined;\n /** Commit exato, gravado junto com o status de aprovação do cenário. */\n commit: string | undefined;\n /** Primeiros 7 caracteres do commit. */\n shortCommit: string | undefined;\n /** `true` quando roda em preview ou produção na Vercel. */\n isDeployed: boolean;\n};\n\ntype EnvRecord = Record<string, string | undefined>;\n\nfunction readEnv(): EnvRecord {\n // `import.meta.env` só existe sob um bundler. Em Node (testes, scripts de CI)\n // cai para `process.env`, que é onde a Vercel também publica as variáveis.\n const viteEnv = (import.meta as unknown as { env?: EnvRecord }).env;\n if (viteEnv) return viteEnv;\n if (typeof process !== \"undefined\" && process.env) return process.env as EnvRecord;\n return {};\n}\n\n/**\n * Lê o contexto do deployment.\n *\n * `overrides` vem do produto e tem precedência. Ele existe porque o motor é uma\n * biblioteca já compilada: o `import.meta.env` deste arquivo foi resolvido no\n * build do pacote, não no build do produto. A leitura de ambiente abaixo só\n * funciona quando o motor roda a partir do código-fonte — em testes e no\n * workspace — e por isso não pode ser a única fonte.\n */\nexport function getDeployContext(overrides: DeployOverrides = {}): DeployContext {\n const env = readEnv();\n\n const branchUrl = overrides.branchUrl || env.VITE_VERCEL_BRANCH_URL || env.VERCEL_BRANCH_URL;\n const deploymentUrl = overrides.deploymentUrl || env.VITE_VERCEL_URL || env.VERCEL_URL;\n const vercelEnv = overrides.env || env.VITE_VERCEL_ENV || env.VERCEL_ENV;\n const commit = overrides.commit || env.VITE_VERCEL_GIT_COMMIT_SHA || env.VERCEL_GIT_COMMIT_SHA;\n\n // Preferência deliberada: a URL de branch é estável e sempre reflete o último\n // commit daquela branch, que é o que se quer ao circular um cenário em\n // revisão (§10.2). A URL de commit entra no registro de aprovação, não aqui.\n const origin =\n (branchUrl && `https://${branchUrl}`) ||\n (deploymentUrl && `https://${deploymentUrl}`) ||\n (typeof window !== \"undefined\" ? window.location.origin : \"http://localhost:5173\");\n\n return {\n env: vercelEnv ?? \"development\",\n origin: origin.replace(/\\/$/, \"\"),\n branchUrl,\n deploymentUrl,\n branch: overrides.branch || env.VITE_VERCEL_GIT_COMMIT_REF || env.VERCEL_GIT_COMMIT_REF,\n commit,\n shortCommit: commit?.slice(0, 7),\n isDeployed: vercelEnv === \"preview\" || vercelEnv === \"production\",\n };\n}\n\n/**\n * URL absoluta de um cenário: rota mais os controles necessários para\n * reproduzir a situação. É o link que um PO envia sem precisar explicar\n * nenhuma sequência manual anterior.\n */\nexport function scenarioUrl(\n scenario: Scenario,\n options: { origin?: string; overrides?: Partial<ControlsState> } = {},\n): string {\n const origin = options.origin ?? getDeployContext().origin;\n const url = new URL(scenario.route, origin);\n\n url.searchParams.set(PARAM.scenario, scenario.id);\n url.searchParams.set(PARAM.persona, scenario.persona);\n url.searchParams.set(PARAM.fixture, scenario.fixture);\n if (scenario.network && scenario.network !== \"success\") {\n url.searchParams.set(PARAM.network, scenario.network);\n }\n\n applyOverrides(url.searchParams, options.overrides);\n\n return url.toString();\n}\n\n/**\n * URL imutável de aprovação (§10.2). Aponta para o commit exato, então a\n * aprovação não muda de conteúdo debaixo de quem aprovou.\n *\n * Requer o escopo do projeto na Vercel, que é a parte do domínio depois do\n * hash e não está exposta como variável — por isso vem do produto.\n */\nexport function commitUrl(\n scenario: Scenario,\n options: { project: string; scope: string; commit?: string },\n): string | undefined {\n const commit = options.commit ?? getDeployContext().shortCommit;\n if (!commit) return undefined;\n const origin = `https://${options.project}-${commit}-${options.scope}.vercel.app`;\n return scenarioUrl(scenario, { origin });\n}\n","/**\n * Contraste (§6.1, \"No token\").\n *\n * Contraste é propriedade de par de cores, não de componente. Validar na\n * definição do token resolve na origem, uma vez, em vez de perseguir o mesmo\n * problema em trinta telas — e é por isso que esta função roda junto do build do\n * produto, não só no painel.\n *\n * Implementa a razão de contraste do WCAG 2.x, que é a mesma em 2.2.\n */\n\nimport type { ContrastPair, ContrastTarget } from \"../types/index.js\";\n\nexport type Rgb = { r: number; g: number; b: number; a: number };\n\n/** Limiares do WCAG 2.2: 1.4.3 (AA) e 1.4.6 (AAA). */\nexport const CONTRAST_THRESHOLDS = {\n AA: { normal: 4.5, large: 3 },\n AAA: { normal: 7, large: 4.5 },\n} as const;\n\nconst NAMED_COLORS: Record<string, string> = {\n white: \"#ffffff\",\n black: \"#000000\",\n transparent: \"#00000000\",\n};\n\n/**\n * Interpreta hex de 3, 4, 6 ou 8 dígitos, `rgb()`, `rgba()` e as três palavras\n * que aparecem em token de verdade. Devolve `undefined` para o que não sabe ler\n * — deliberadamente: um par que não pôde ser medido precisa aparecer como\n * \"não verificado\" no painel, não como aprovado.\n */\nexport function parseColor(input: string): Rgb | undefined {\n const value = input.trim().toLowerCase();\n const named = NAMED_COLORS[value];\n if (named) return parseColor(named);\n\n if (value.startsWith(\"#\")) {\n const hex = value.slice(1);\n const expand = (chunk: string) => Number.parseInt(chunk.repeat(2), 16);\n\n if (hex.length === 3 || hex.length === 4) {\n const [r, g, b, a] = [...hex];\n if (!r || !g || !b) return undefined;\n return { r: expand(r), g: expand(g), b: expand(b), a: a ? expand(a) / 255 : 1 };\n }\n\n if (hex.length === 6 || hex.length === 8) {\n const pair = (index: number) => Number.parseInt(hex.slice(index, index + 2), 16);\n const values = [pair(0), pair(2), pair(4)];\n if (values.some(Number.isNaN)) return undefined;\n return {\n r: values[0]!,\n g: values[1]!,\n b: values[2]!,\n a: hex.length === 8 ? pair(6) / 255 : 1,\n };\n }\n\n return undefined;\n }\n\n const functional = value.match(/^rgba?\\(([^)]+)\\)$/);\n if (functional?.[1]) {\n const parts = functional[1].split(/[\\s,/]+/).filter(Boolean);\n const [r, g, b, a] = parts.map(Number);\n if ([r, g, b].some((n) => n === undefined || Number.isNaN(n))) return undefined;\n return { r: r!, g: g!, b: b!, a: a === undefined || Number.isNaN(a) ? 1 : a };\n }\n\n return undefined;\n}\n\n/**\n * Compõe uma cor semitransparente sobre um fundo opaco.\n *\n * Importa porque metade dos tokens semânticos de produto real é\n * `rgba(43, 35, 91, 0.6)` — medir isso ignorando o alfa dá um resultado\n * otimista e falso.\n */\nexport function flatten(foreground: Rgb, background: Rgb): Rgb {\n if (foreground.a >= 1) return foreground;\n const mix = (fg: number, bg: number) => fg * foreground.a + bg * (1 - foreground.a);\n return {\n r: mix(foreground.r, background.r),\n g: mix(foreground.g, background.g),\n b: mix(foreground.b, background.b),\n a: 1,\n };\n}\n\n/** Luminância relativa (WCAG 2.x, definição de `relative luminance`). */\nexport function relativeLuminance({ r, g, b }: Rgb): number {\n const channel = (raw: number) => {\n const value = raw / 255;\n return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;\n };\n return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);\n}\n\n/** Razão de contraste entre 1 e 21. `undefined` quando alguma cor é ilegível. */\nexport function contrastRatio(foreground: string, background: string): number | undefined {\n const bg = parseColor(background);\n const fgRaw = parseColor(foreground);\n if (!bg || !fgRaw) return undefined;\n\n const fg = flatten(fgRaw, bg);\n const lighter = Math.max(relativeLuminance(fg), relativeLuminance(bg));\n const darker = Math.min(relativeLuminance(fg), relativeLuminance(bg));\n return (lighter + 0.05) / (darker + 0.05);\n}\n\nexport type ContrastResult = {\n pair: ContrastPair;\n target: ContrastTarget;\n /** `undefined` quando alguma das cores não pôde ser interpretada. */\n ratio: number | undefined;\n required: number;\n /** `undefined` quando não foi possível medir. Nunca `true` por omissão. */\n passes: boolean | undefined;\n /** Razão arredondada para exibição: \"4.62:1\". */\n label: string;\n};\n\nexport function checkContrastPair(pair: ContrastPair): ContrastResult {\n const target = pair.target ?? \"AA\";\n const required = pair.largeText\n ? CONTRAST_THRESHOLDS[target].large\n : CONTRAST_THRESHOLDS[target].normal;\n const ratio = contrastRatio(pair.foreground, pair.background);\n\n return {\n pair,\n target,\n ratio,\n required,\n passes: ratio === undefined ? undefined : ratio >= required,\n label: ratio === undefined ? \"não medido\" : `${ratio.toFixed(2)}:1`,\n };\n}\n\nexport function checkContrastPairs(pairs: ContrastPair[] = []): ContrastResult[] {\n return pairs.map(checkContrastPair);\n}\n\n/**\n * Falha o build quando algum par declarado não atinge o alvo.\n *\n * Chamado por um teste do produto (`tests/tokens.test.ts` no template), porque\n * validar tokens é responsabilidade do produto — o motor só sabe medir.\n */\nexport function assertContrastPairs(pairs: ContrastPair[]): void {\n const failures = checkContrastPairs(pairs).filter((result) => result.passes !== true);\n if (failures.length === 0) return;\n\n const detail = failures\n .map(\n (f) =>\n ` ✖ ${f.pair.name}: ${f.label} (mínimo ${f.required}:1 para ${f.target}` +\n `${f.pair.largeText ? \", texto grande\" : \"\"})`,\n )\n .join(\"\\n\");\n\n throw new Error(`Pares de contraste fora do alvo:\\n${detail}`);\n}\n\n/**\n * Lê o valor computado de uma custom property. Serve para o painel medir o que\n * está realmente aplicado na tela, não o que o arquivo de token diz.\n */\nexport function readCssVariable(name: string, element?: Element): string | undefined {\n if (typeof window === \"undefined\") return undefined;\n const target = element ?? document.documentElement;\n const value = window.getComputedStyle(target).getPropertyValue(name).trim();\n return value || undefined;\n}\n"],"names":["SCENARIO_STATUSES","NETWORK_STATES","ID_PATTERN","isNonEmptyString","value","validateScenario","scenario","index","issues","where","err","message","warn","a11y","validateProduct","product","push","level","personaIds","p","fixtureIds","f","ruleIds","r","moduleIds","m","scenarioIds","modulePrefix","rule","matchesAnyRoute","module","flow","step","label","target","defaultSource","a","route","path","definition","matchPathShape","pattern","patternSegments","pathSegments","segment","actual","hasErrors","issue","formatIssues","PARAM","serializeValue","applyOverrides","params","overrides","key","param","readEnv","viteEnv","__vite_import_meta_env__","getDeployContext","env","branchUrl","deploymentUrl","vercelEnv","commit","origin","scenarioUrl","options","url","commitUrl","CONTRAST_THRESHOLDS","NAMED_COLORS","parseColor","input","named","hex","expand","chunk","g","b","pair","values","functional","parts","n","flatten","foreground","background","mix","fg","bg","relativeLuminance","channel","raw","contrastRatio","fgRaw","lighter","darker","checkContrastPair","required","ratio","checkContrastPairs","pairs","assertContrastPairs","failures","result","detail","readCssVariable","name","element"],"mappings":"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"}
|
package/dist/deploy/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ControlsState, Scenario } from '../types/index.js';
|
|
1
|
+
import { ControlsState, DeployOverrides, Scenario } from '../types/index.js';
|
|
2
2
|
export type DeployContext = {
|
|
3
3
|
/** `development`, `preview` ou `production`. */
|
|
4
4
|
env: string;
|
|
@@ -17,8 +17,16 @@ export type DeployContext = {
|
|
|
17
17
|
/** `true` quando roda em preview ou produção na Vercel. */
|
|
18
18
|
isDeployed: boolean;
|
|
19
19
|
};
|
|
20
|
-
/**
|
|
21
|
-
|
|
20
|
+
/**
|
|
21
|
+
* Lê o contexto do deployment.
|
|
22
|
+
*
|
|
23
|
+
* `overrides` vem do produto e tem precedência. Ele existe porque o motor é uma
|
|
24
|
+
* biblioteca já compilada: o `import.meta.env` deste arquivo foi resolvido no
|
|
25
|
+
* build do pacote, não no build do produto. A leitura de ambiente abaixo só
|
|
26
|
+
* funciona quando o motor roda a partir do código-fonte — em testes e no
|
|
27
|
+
* workspace — e por isso não pode ser a única fonte.
|
|
28
|
+
*/
|
|
29
|
+
export declare function getDeployContext(overrides?: DeployOverrides): DeployContext;
|
|
22
30
|
/**
|
|
23
31
|
* URL absoluta de um cenário: rota mais os controles necessários para
|
|
24
32
|
* reproduzir a situação. É o link que um PO envia sem precisar explicar
|
package/dist/index.d.ts
CHANGED
|
@@ -22,4 +22,4 @@ export { CONTRAST_THRESHOLDS, assertContrastPairs, checkContrastPair, checkContr
|
|
|
22
22
|
export { computeRole, describeElement, shortSelector, tabbableElements, type AccessibleNode, } from './a11y/accessible-tree.js';
|
|
23
23
|
export { useKeyboardMode, type KeyboardModeResult, type TabStop, } from './a11y/useKeyboardMode.js';
|
|
24
24
|
export { ageInYears, daysBetween, parseIsoDate } from './util/date.js';
|
|
25
|
-
export { NETWORK_STATES, SCENARIO_STATUSES, type A11yContract, type ContrastPair, type ContrastTarget, type ControlsState, type DataRequest, type DataSourceAdapter, type Fixture, type Flow, type FlowStep, type KeyboardCoverage, type Module, type NetworkState, type Persona, type ProductDefinition, type ProductTheme, type Rule, type RouteDefinition, type Scenario, type ScenarioContext, type ScenarioStatus, type ScreenProps, type ViewportSetting, } from './types/index.js';
|
|
25
|
+
export { NETWORK_STATES, SCENARIO_STATUSES, type A11yContract, type ContrastPair, type ContrastTarget, type ControlsState, type DeployOverrides, type DataRequest, type DataSourceAdapter, type Fixture, type Flow, type FlowStep, type KeyboardCoverage, type Module, type NetworkState, type Persona, type ProductDefinition, type ProductTheme, type Rule, type RouteDefinition, type Scenario, type ScenarioContext, type ScenarioStatus, type ScreenProps, type ViewportSetting, } from './types/index.js';
|
package/dist/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { jsxs as d, jsx as a, Fragment as x } from "react/jsx-runtime";
|
|
2
2
|
import { useState as _, useEffect as E, useMemo as k, useCallback as M, forwardRef as ee, useRef as te } from "react";
|
|
3
|
-
import { v as ae, P as p, N as q, s as re, c as ne, g as se } from "./contrast-
|
|
4
|
-
import { C as rt, S as nt, a as st, b as ot, d as it, e as dt, f as ct, h as lt, i as ut, j as ht, p as mt, r as pt, k as ft, l as bt, m as vt } from "./contrast-
|
|
3
|
+
import { v as ae, P as p, N as q, s as re, c as ne, g as se } from "./contrast-DsgJg12D.js";
|
|
4
|
+
import { C as rt, S as nt, a as st, b as ot, d as it, e as dt, f as ct, h as lt, i as ut, j as ht, p as mt, r as pt, k as ft, l as bt, m as vt } from "./contrast-DsgJg12D.js";
|
|
5
5
|
function oe(e) {
|
|
6
6
|
const t = new Map(e.scenarios.map((i) => [i.id, i])), r = new Map(e.personas.map((i) => [i.id, i])), n = new Map(e.fixtures.map((i) => [i.id, i])), s = new Map((e.rules ?? []).map((i) => [i.id, i])), l = new Map(e.modules.map((i) => [i.id, i])), c = new Map(
|
|
7
7
|
e.modules.flatMap((i) => (i.flows ?? []).map((h) => [h.id, h]))
|
|
@@ -1191,7 +1191,7 @@ function J({
|
|
|
1191
1191
|
] }) }, n.id)) });
|
|
1192
1192
|
}
|
|
1193
1193
|
function Xe({ product: e }) {
|
|
1194
|
-
const t = k(() => oe(e), [e]), r = k(() => se(), []), { location: n, controls: s, viewport: l, setControls: c, navigate: o, openScenario: u } = de(t), [m, f] = _(!0), v = te(null), { focused: g, tabStops: i } = Ae(s.keyboardMode, v), h = t.scenario(s.scenario), b = t.persona(s.persona ?? h?.persona), y = t.fixture(s.fixture ?? h?.fixture), $ = k(() => {
|
|
1194
|
+
const t = k(() => oe(e), [e]), r = k(() => se(e.deploy), [e.deploy]), { location: n, controls: s, viewport: l, setControls: c, navigate: o, openScenario: u } = de(t), [m, f] = _(!0), v = te(null), { focused: g, tabStops: i } = Ae(s.keyboardMode, v), h = t.scenario(s.scenario), b = t.persona(s.persona ?? h?.persona), y = t.fixture(s.fixture ?? h?.fixture), $ = k(() => {
|
|
1195
1195
|
const N = s.dataSource ?? "fixtures";
|
|
1196
1196
|
return N === "fixtures" ? O : e.dataSources?.adapters?.find((w) => w.id === N) ?? O;
|
|
1197
1197
|
}, [s.dataSource, e.dataSources?.adapters]), { data: P, isLoading: R, error: D } = ge({ scenario: h, fixture: y, network: s.network, adapter: $ });
|