@brucesantos/design-space 0.8.0 → 0.9.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 +144 -0
- package/README.md +178 -9
- package/dist/adapters/useScenarioData.d.ts +2 -0
- package/dist/controls/params.d.ts +10 -0
- package/dist/controls/state.d.ts +38 -8
- package/dist/design-space.css +1 -1
- package/dist/index-Bj69Oe2X.js +490 -0
- package/dist/index-Bj69Oe2X.js.map +1 -0
- package/dist/index.d.ts +3 -3
- package/dist/index.js +1583 -1181
- package/dist/index.js.map +1 -1
- package/dist/registry/index.d.ts +81 -9
- package/dist/router/index.d.ts +5 -0
- package/dist/shell/Panel.d.ts +11 -1
- package/dist/shell/labels.d.ts +14 -0
- package/dist/shell/prMarkdown.d.ts +29 -1
- package/dist/testing.js +1 -1
- package/dist/types/index.d.ts +102 -2
- package/package.json +1 -1
- package/dist/index-FIzKHaWE.js +0 -345
- package/dist/index-FIzKHaWE.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,150 @@ 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.9.1 (2026-09-29)
|
|
10
|
+
|
|
11
|
+
**Patch/minor compatível.** Três limitações que um produto real encontrou na
|
|
12
|
+
0.9.0, mais a persona padrão do produto. Nada muda para quem não usa o que é
|
|
13
|
+
novo; `navigate(to)` sem query nem opções se comporta como antes.
|
|
14
|
+
|
|
15
|
+
### Corrigido
|
|
16
|
+
|
|
17
|
+
- **`context.navigate` com query própria não perde mais o contexto.** Antes, a
|
|
18
|
+
query do destino substituía a atual inteira, e persona, rede, viewport, tema,
|
|
19
|
+
idioma, fonte de dados e handoff precisavam ser remontados à mão. Agora os
|
|
20
|
+
parâmetros de contexto do motor — tudo que não é `scenario`, `fixture`,
|
|
21
|
+
`component` nem `c.*` — seguem, a menos que o destino traga o mesmo parâmetro.
|
|
22
|
+
Os `c.*` da tela anterior continuam descartados. A persona que vinha do cenário
|
|
23
|
+
deixado para trás vira `persona=` explícito (salvo quando é a persona padrão);
|
|
24
|
+
a rede e a fixture do cenário ficam com ele. Vale também para navegação que
|
|
25
|
+
nasce dentro do quadro e para link comum com query no quadro.
|
|
26
|
+
- **`setControl` chamado várias vezes no mesmo ciclo acumula.** Antes, cada
|
|
27
|
+
chamada partia do valor da última renderização, e só a última sobrevivia. Agora
|
|
28
|
+
cada chamada parte do endereço mais recente (atualização funcional), dentro e
|
|
29
|
+
fora do quadro; chamada sem mudança efetiva não toca no histórico nem avisa o
|
|
30
|
+
pai. `DesignSpaceState.setControls` também parte do endereço mais recente.
|
|
31
|
+
- **Tela com parâmetro aberta sem cenário** não precisa mais ir para o caminho
|
|
32
|
+
literal (`/x/:id`): ver `RouteDefinition.params` abaixo. Sem `params`, o
|
|
33
|
+
comportamento é o de antes, agora com aviso de validação.
|
|
34
|
+
|
|
35
|
+
### Adicionado
|
|
36
|
+
|
|
37
|
+
- **`navigate(to, options?)`** em `ScenarioContext` e `DesignSpaceState`, com
|
|
38
|
+
`NavigateOptions` (tipo exportado): `controls` (id → value) vira `c.*` do
|
|
39
|
+
destino, sem os valores iguais ao padrão da tela de destino (ou ao que o
|
|
40
|
+
cenário de destino fixa); `replace` substitui a entrada do histórico. Passar
|
|
41
|
+
`controls` já faz a navegação ser explícita, como uma query própria.
|
|
42
|
+
- **`ScenarioContext.setControls(patch)`** — vários controles numa única
|
|
43
|
+
atualização de URL e uma só mensagem ao pai. **Obrigatório** no tipo: o motor é
|
|
44
|
+
quem monta o contexto e sempre o entrega. Só quebra typecheck de quem monta um
|
|
45
|
+
`ScenarioContext` à mão (um mock de teste, por exemplo): acrescente
|
|
46
|
+
`setControls: () => {}`.
|
|
47
|
+
- **`DesignSpaceState.setScreenControls(patch)`** — o mesmo, para quem usa
|
|
48
|
+
`useDesignSpaceState` diretamente.
|
|
49
|
+
- **`RouteDefinition.params`** — valores de exemplo dos parâmetros do `path` (e
|
|
50
|
+
de `*`). Usados sempre que o motor abre a tela sem cenário: lateral, variação
|
|
51
|
+
padrão, "Usado em" em Informações (que agora abre também tela sem
|
|
52
|
+
variação) e "Copiar para o PR". `ScreenNode.href` passa a trazer o caminho com
|
|
53
|
+
os exemplos, codificados.
|
|
54
|
+
- **`ProductDefinition.defaultPersona`** — persona efetiva de toda tela e todo
|
|
55
|
+
cenário sem persona própria: `context.persona`, `context.permissions` e
|
|
56
|
+
`context.can` refletem ela, também no quadro. O seletor do painel deixa de
|
|
57
|
+
oferecer "—" e mostra o padrão; `persona=` só vai para a URL quando difere do
|
|
58
|
+
padrão efetivo. Persona do cenário e a escolhida no painel continuam vencendo.
|
|
59
|
+
`Registry.defaultPersona`; `permissionsOf` usa a persona padrão para cenário
|
|
60
|
+
sem persona. Sem `defaultPersona`, nada muda.
|
|
61
|
+
- **Validação:** rota com `:param` sem exemplo e sem cenário que a cubra
|
|
62
|
+
(aviso); `params` com nome que a rota não tem, vazio, ou que monta caminho de
|
|
63
|
+
outra rota (aviso); `params` que não é objeto (erro); `defaultPersona` que não
|
|
64
|
+
é persona registrada (erro).
|
|
65
|
+
|
|
66
|
+
## 0.9.0 (2026-09-29)
|
|
67
|
+
|
|
68
|
+
**Minor (compatível).** Fluxos agrupam telas, e as variações de uma tela passam a
|
|
69
|
+
ser controles por componente que se combinam. Tudo é opcional: um produto da 0.8
|
|
70
|
+
continua funcionando sem mudar nada. Ver
|
|
71
|
+
`docs/decisions/0013-fluxos-e-controles-por-componente.md`.
|
|
72
|
+
|
|
73
|
+
### Adicionado
|
|
74
|
+
|
|
75
|
+
- **Tipos:** `ControlOption`, `Control` e `ControlGroup`.
|
|
76
|
+
- **`RouteDefinition`:** `group` (o fluxo da tela), `controls` (grupos de
|
|
77
|
+
controles por componente), `expected` (comportamento esperado da tela sem
|
|
78
|
+
cenário ativo) e `components` (ids do catálogo usados pela tela).
|
|
79
|
+
- **`Scenario.controls`:** a combinação que o cenário fixa. Abrir o cenário
|
|
80
|
+
aplica esses valores sobre os padrões da tela.
|
|
81
|
+
- **`ScenarioContext.controls`** (valor de cada controle, com os padrões
|
|
82
|
+
aplicados) e **`ScenarioContext.setControl(id, value)`**, que funciona dentro
|
|
83
|
+
do quadro: troca o endereço do quadro e avisa o chrome, que adota a URL.
|
|
84
|
+
- **URL:** `c.<id>=<value>` para cada controle fora do padrão (ou do que o
|
|
85
|
+
cenário fixa). Valor inválido cai no padrão e aparece como aviso no
|
|
86
|
+
diagnóstico; controle que a tela não tem também. Os `c.*` chegam ao quadro, e
|
|
87
|
+
mudar um controle atualiza o quadro por mensagem, sem recarregar. Ao navegar
|
|
88
|
+
para outra tela, os `c.*` da anterior ficam para trás.
|
|
89
|
+
`ControlsState.screenControls`, `CONTROL_PARAM_PREFIX`; `applyOverrides` (e
|
|
90
|
+
portanto `pathFor`/`scenarioUrl` com `overrides`) aceita `screenControls`.
|
|
91
|
+
- **Registry:** `flows()`, `flowOf(screen)`, `controlsOf(screen)`,
|
|
92
|
+
`resolveControls(screen, { scenario, requested })`; `ScreenNode.group` e
|
|
93
|
+
`ScreenNode.controls`. Tipos `FlowNode`, `ControlResolution`,
|
|
94
|
+
`InvalidControl`. `searchScreens` casa também o nome do fluxo.
|
|
95
|
+
- **Aba Telas** agrupada por fluxo, com seções recolhíveis e contagem; tela sem
|
|
96
|
+
`group` fica no topo, sem título.
|
|
97
|
+
- **Painel Variações** em três partes: **contexto** no topo (persona, rede, e
|
|
98
|
+
tema, idioma e fonte de dados quando declarados), **um bloco por grupo de
|
|
99
|
+
controles** (título, link para o componente do catálogo, `note`, e cada
|
|
100
|
+
controle como botões segmentados ou select) e **atalhos** (os cenários da tela,
|
|
101
|
+
compactos, com a intenção na dica). O filtro alcança grupos, controles e
|
|
102
|
+
opções.
|
|
103
|
+
- **Informações:** fluxo, controles com o valor atual, comportamento esperado do
|
|
104
|
+
cenário ativo ou da rota, e componentes de `route.components` mais os do
|
|
105
|
+
cenário.
|
|
106
|
+
- **Copiar para o PR por fluxo:** numa tela com `group`, o markdown traz o fluxo
|
|
107
|
+
inteiro — para cada tela, nome, rota, link absoluto (com os controles atuais na
|
|
108
|
+
tela aberta), controles disponíveis, atalhos, comportamento esperado e a tabela
|
|
109
|
+
componente → origem.
|
|
110
|
+
- **Validação:** ids de grupo e de controle únicos por tela, id de controle sem
|
|
111
|
+
espaço, opções não vazias e sem duplicata, `default` entre as opções e
|
|
112
|
+
`Scenario.controls` usando controles e valores da tela do cenário (erros);
|
|
113
|
+
`route.components` e `group.component` inexistentes (avisos).
|
|
114
|
+
- **Rótulos** novos, em pt-BR e en-US: `panel.context`, `panel.shortcuts`,
|
|
115
|
+
`panel.toggleGroup`, `panel.openComponent`, `info.flow`, `info.controls`,
|
|
116
|
+
`diagnostics.invalidControl`, `diagnostics.unknownControl`, `pr.open`,
|
|
117
|
+
`pr.controls`, `pr.shortcuts`, `pr.defaultOption`.
|
|
118
|
+
|
|
119
|
+
### Alterado
|
|
120
|
+
|
|
121
|
+
- **Tela sem cenário respeita o estado de rede.** Antes, sem cenário, `network`
|
|
122
|
+
não tinha efeito; agora `loading`, `slow`, `empty` e `error` chegam à tela
|
|
123
|
+
(`isLoading`, `data: null`, `error`), como com cenário. `useScenarioData`
|
|
124
|
+
aceita `screen` para nomear o erro simulado.
|
|
125
|
+
- A lista de cenários do painel virou **Atalhos**, depois dos controles, em uma
|
|
126
|
+
linha cada; a intenção foi para a dica (`title`) do item.
|
|
127
|
+
- `parseControls(search, registry, path?)` e `serializeControls(state, registry,
|
|
128
|
+
path?)` aceitam o caminho aberto, para resolver os controles pela tela dele.
|
|
129
|
+
Sem ele, vale a tela do cenário, como antes.
|
|
130
|
+
- `componentsOfScreen(screen, scenario?)` inclui `route.components`, e aceita um
|
|
131
|
+
cenário para restringir aos componentes dele; `usagesOf` considera
|
|
132
|
+
`route.components`.
|
|
133
|
+
|
|
134
|
+
### Guia de uso
|
|
135
|
+
|
|
136
|
+
1. Dê um `group` às rotas de um mesmo fluxo:
|
|
137
|
+
`{ path: "/orders", screen: OrderList, name: "Lista de pedidos", group: "Pedidos" }`.
|
|
138
|
+
2. Declare os controles da tela por componente, em `controls`: um `ControlGroup`
|
|
139
|
+
por componente (`id`, `title`, `component` opcional, `note` opcional) com os
|
|
140
|
+
`Control`s dele (`id`, `label`, `options`, `default` opcional).
|
|
141
|
+
3. Na tela, leia `context.controls` e monte os dados sintéticos a partir deles.
|
|
142
|
+
Quando a UI do produto precisa mudar um controle (fechar um modal), chame
|
|
143
|
+
`context.setControl(id, value)`.
|
|
144
|
+
4. Troque os cenários que eram só combinações por atalhos: `controls: { … }` no
|
|
145
|
+
cenário. Mantenha cenário para o que tem persona, fixture, regra ou
|
|
146
|
+
comportamento esperado próprios.
|
|
147
|
+
5. Mova para `route.expected` e `route.components` o que vale para a tela
|
|
148
|
+
inteira, e rode a validação: ela aponta controle inexistente, valor fora das
|
|
149
|
+
opções e `default` inválido.
|
|
150
|
+
6. Nos testes, um link com controles sai de
|
|
151
|
+
`pathFor(scenario, { screenControls: { rows: "none" } })`.
|
|
152
|
+
|
|
9
153
|
## 0.8.0 (2026-09-28)
|
|
10
154
|
|
|
11
155
|
**Major (incompatível).** Chrome novo, modelo de organização novo e a UI do
|
package/README.md
CHANGED
|
@@ -51,6 +51,133 @@ routes: [
|
|
|
51
51
|
Sem `name`, a tela usa o título do primeiro cenário da rota e, na falta dele, o
|
|
52
52
|
`path`. Não existe módulo nem jornada (decisão 0012).
|
|
53
53
|
|
|
54
|
+
**Rota com parâmetro** (desde a 0.9.1): `params` dá um valor de exemplo para cada
|
|
55
|
+
`:param` (e para `*`, se houver). O motor usa o exemplo sempre que abre a tela
|
|
56
|
+
sem cenário — na lateral, na variação padrão, no "Usado em" de Informações e
|
|
57
|
+
no "Copiar para o PR":
|
|
58
|
+
|
|
59
|
+
```ts
|
|
60
|
+
{ path: "/orders/:id", screen: OrderDetail, name: "Detalhe do pedido", params: { id: "1042" } }
|
|
61
|
+
// abre em /orders/1042, não em /orders/:id
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
Sem `params`, o caminho continua literal, e a validação avisa quando nenhum
|
|
65
|
+
cenário cobre a rota. Exemplo que a rota não tem, ou que monta um caminho de
|
|
66
|
+
outra rota (`/orders/new`), também é aviso.
|
|
67
|
+
|
|
68
|
+
## Fluxos e controles (0.9)
|
|
69
|
+
|
|
70
|
+
Uma feature raramente é uma tela: é um **fluxo** de algumas telas, e cada tela
|
|
71
|
+
tem **componentes** que variam de forma independente. Desde a 0.9 as duas coisas
|
|
72
|
+
são declaradas na rota, e nada disso é obrigatório
|
|
73
|
+
([decisão 0013](../../docs/decisions/0013-fluxos-e-controles-por-componente.md)).
|
|
74
|
+
|
|
75
|
+
```ts
|
|
76
|
+
routes: [
|
|
77
|
+
{
|
|
78
|
+
path: "/orders",
|
|
79
|
+
screen: OrderList,
|
|
80
|
+
name: "Lista de pedidos",
|
|
81
|
+
group: "Pedidos", // o fluxo: agrupa as telas na aba Telas
|
|
82
|
+
expected: ["A lista mostra os pedidos do período."],
|
|
83
|
+
components: ["data.table"],
|
|
84
|
+
controls: [
|
|
85
|
+
{
|
|
86
|
+
id: "table",
|
|
87
|
+
title: "Tabela de pedidos · table",
|
|
88
|
+
component: "data.table", // link para o catálogo no painel
|
|
89
|
+
note: "Linhas e ordenação.",
|
|
90
|
+
controls: [
|
|
91
|
+
{
|
|
92
|
+
id: "rows",
|
|
93
|
+
label: "Linhas",
|
|
94
|
+
options: [
|
|
95
|
+
{ value: "many", label: "Muitas" },
|
|
96
|
+
{ value: "one", label: "Uma" },
|
|
97
|
+
{ value: "none", label: "Nenhuma" },
|
|
98
|
+
],
|
|
99
|
+
},
|
|
100
|
+
],
|
|
101
|
+
},
|
|
102
|
+
{
|
|
103
|
+
id: "overlay",
|
|
104
|
+
title: "Sobreposição",
|
|
105
|
+
controls: [
|
|
106
|
+
{
|
|
107
|
+
id: "overlay",
|
|
108
|
+
label: "Aberta",
|
|
109
|
+
options: [
|
|
110
|
+
{ value: "none", label: "Nenhuma" },
|
|
111
|
+
{ value: "cancel", label: "Cancelar pedido" },
|
|
112
|
+
],
|
|
113
|
+
},
|
|
114
|
+
],
|
|
115
|
+
},
|
|
116
|
+
],
|
|
117
|
+
},
|
|
118
|
+
{ path: "/orders/:id", screen: OrderDetail, name: "Detalhe do pedido", group: "Pedidos" },
|
|
119
|
+
],
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
- **Aba Telas:** agrupada por `group`, em seções recolhíveis com contagem, como
|
|
123
|
+
os componentes. Tela sem `group` fica no topo, sem título. A busca casa também
|
|
124
|
+
o nome do fluxo.
|
|
125
|
+
- **Painel Variações:** o **contexto** no topo (persona, rede, e tema, idioma e
|
|
126
|
+
fonte de dados quando o produto declara), depois um bloco por `ControlGroup` e,
|
|
127
|
+
por fim, os cenários da tela como **atalhos**. Até quatro opções curtas viram
|
|
128
|
+
botões segmentados; o resto, um select. O filtro (`Cmd`/`Ctrl` + `F`) alcança
|
|
129
|
+
grupos, controles e opções.
|
|
130
|
+
- **Na URL:** cada controle fora do padrão vai como `c.<id>=<value>`. Valor
|
|
131
|
+
inválido cai no padrão e aparece como aviso no diagnóstico. Os `c.*` chegam ao
|
|
132
|
+
quadro, e mudar um controle atualiza o quadro por mensagem, sem recarregar.
|
|
133
|
+
- **Na tela:** `context.controls` traz o valor de cada controle, com os padrões
|
|
134
|
+
aplicados; `context.setControl(id, value)` muda um deles a partir da UI do
|
|
135
|
+
produto (fechar um modal volta a sobreposição para "nenhuma") e atualiza a URL,
|
|
136
|
+
e `context.setControls({ … })` muda vários numa única atualização. Desde a
|
|
137
|
+
0.9.1, chamadas seguidas no mesmo handler se acumulam — cada uma parte do
|
|
138
|
+
endereço mais recente, não do valor da última renderização —, inclusive dentro
|
|
139
|
+
do quadro.
|
|
140
|
+
Sem cenário, a tela monta os próprios dados sintéticos a partir dos controles —
|
|
141
|
+
é o caso normal agora —, e o estado de rede do contexto continua valendo.
|
|
142
|
+
- **Navegando com controles:** `context.navigate("/orders", { controls: { rows:
|
|
143
|
+
"one" } })` abre a tela de destino com esses controles (valor igual ao padrão
|
|
144
|
+
da tela de destino não entra na URL). Ver [Navegação](#navegação).
|
|
145
|
+
- **Cenário como atalho:** `Scenario.controls` fixa uma combinação. Abrir o
|
|
146
|
+
cenário aplica esses valores sobre os padrões; mudar um controle depois não
|
|
147
|
+
troca de cenário, mas o atalho deixa de aparecer destacado quando a combinação
|
|
148
|
+
deixa de ser a dele.
|
|
149
|
+
|
|
150
|
+
```ts
|
|
151
|
+
{ id: "orders.cancel", title: "Cancelando um pedido", route: "/orders",
|
|
152
|
+
fixture: "orders", controls: { overlay: "cancel" }, expected: ["O modal pede confirmação."] }
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
```tsx
|
|
156
|
+
function OrderList({ context }: ScreenProps) {
|
|
157
|
+
const rows = buildRows(context.controls.rows); // dado sintético do produto
|
|
158
|
+
return (
|
|
159
|
+
<>
|
|
160
|
+
<Table rows={rows} />
|
|
161
|
+
{context.controls.overlay === "cancel" && (
|
|
162
|
+
<CancelModal onClose={() => context.setControl("overlay", "none")} />
|
|
163
|
+
)}
|
|
164
|
+
<button onClick={() => context.setControls({ rows: "many", overlay: "none" })}>Limpar</button>
|
|
165
|
+
</>
|
|
166
|
+
);
|
|
167
|
+
}
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
Informações mostra rota, fluxo, descrição, os controles com o valor atual, o
|
|
171
|
+
comportamento esperado (o do cenário ativo, senão `route.expected`) e os
|
|
172
|
+
componentes (`route.components` mais os do cenário). **Copiar para o PR**, numa
|
|
173
|
+
tela com fluxo, gera o markdown do fluxo inteiro: para cada tela, nome, rota,
|
|
174
|
+
link absoluto (com os controles atuais na tela aberta), controles disponíveis,
|
|
175
|
+
atalhos, comportamento esperado e a tabela componente → origem.
|
|
176
|
+
|
|
177
|
+
A validação checa ids de grupo e de controle únicos por tela, `default` entre as
|
|
178
|
+
opções e `Scenario.controls` usando controles e valores da tela do cenário; id de
|
|
179
|
+
componente inexistente em `route.components` ou `group.component` é aviso.
|
|
180
|
+
|
|
54
181
|
## O contrato de cenário
|
|
55
182
|
|
|
56
183
|
Um cenário combina intenção, persona, permissões, pré-condições, dados, ações,
|
|
@@ -78,8 +205,19 @@ motor.
|
|
|
78
205
|
|
|
79
206
|
- `id` é qualquer id estável, minúsculo, em kebab-case com pontos opcionais.
|
|
80
207
|
Precisa ser único; não precisa de prefixo.
|
|
81
|
-
- `persona` é opcional. Cenário sem persona
|
|
82
|
-
|
|
208
|
+
- `persona` é opcional. Cenário sem persona usa a persona padrão do produto
|
|
209
|
+
(`ProductDefinition.defaultPersona`, desde a 0.9.1) e, sem ela, tem permissões
|
|
210
|
+
vazias, a menos que declare `permissions`.
|
|
211
|
+
|
|
212
|
+
### Persona padrão
|
|
213
|
+
|
|
214
|
+
`defaultPersona: "<id>"` na `ProductDefinition` é a persona efetiva de toda tela
|
|
215
|
+
e todo cenário sem persona própria: `context.persona`, `context.permissions` e
|
|
216
|
+
`context.can` refletem ela, também dentro do quadro. O seletor de persona do
|
|
217
|
+
painel deixa de oferecer "—" e mostra o padrão selecionado, e `persona=` só vai
|
|
218
|
+
para a URL quando difere do padrão efetivo. Persona do cenário e a escolhida no
|
|
219
|
+
painel continuam vencendo. Id inexistente é erro de validação. Sem
|
|
220
|
+
`defaultPersona`, nada muda.
|
|
83
221
|
- `components` lista os ids de `ComponentPreview` usados na tela. Alimenta
|
|
84
222
|
"Componentes usados", o "Usado em" de cada componente e o "Copiar para o PR".
|
|
85
223
|
|
|
@@ -88,9 +226,9 @@ motor.
|
|
|
88
226
|
| Região | Conteúdo |
|
|
89
227
|
| --- | --- |
|
|
90
228
|
| Barra superior | Nome do produto; viewport (Celular 375, Tablet 768, Desktop 1280, Ajustar), girar, zoom 25–150%, copiar link, revisão limpa, tema, painel e — quando a validação tem algo a dizer — o indicador de diagnóstico. |
|
|
91
|
-
| Esquerda | **Telas** e **Componentes**, com contagem e busca sem acento nem caixa (nome, descrição, grupo, id e `source`).
|
|
229
|
+
| Esquerda | **Telas** e **Componentes**, com contagem e busca sem acento nem caixa (nome, descrição, fluxo ou grupo, id e `source`). Telas agrupadas por fluxo (`route.group`), componentes por `group`. Redimensionável. |
|
|
92
230
|
| Centro | O quadro do produto no tamanho do viewport, com zoom só de visualização. |
|
|
93
|
-
| Direita | **Variações** (
|
|
231
|
+
| Direita | **Variações** (contexto no topo, controles da tela por componente e os cenários como atalhos; ou as fixtures do componente) e **Informações** (rota, fluxo, controles, intenção, pré-condições, ações, comportamento esperado, regras, componentes usados e **Copiar para o PR**). Redimensionável. |
|
|
94
232
|
|
|
95
233
|
Sem Home: a raiz abre a primeira tela na primeira variação ou, sem telas, o
|
|
96
234
|
primeiro componente. O tema segue o sistema, e a troca é lembrada.
|
|
@@ -99,7 +237,8 @@ primeiro componente. O tema segue o sistema, e a troca é lembrada.
|
|
|
99
237
|
|
|
100
238
|
Gera markdown com o nome da tela, um link absoluto por variação (com o link do
|
|
101
239
|
deployment e o commit quando o produto informa), a tabela componente → origem e
|
|
102
|
-
o comportamento esperado de cada variação.
|
|
240
|
+
o comportamento esperado de cada variação. Tela com fluxo gera o fluxo inteiro
|
|
241
|
+
(ver [Fluxos e controles](#fluxos-e-controles-09)).
|
|
103
242
|
|
|
104
243
|
### O quadro
|
|
105
244
|
|
|
@@ -111,6 +250,27 @@ entrada no histórico. Navegação feita pela UI do produto (`context.navigate`,
|
|
|
111
250
|
`openScenario` ou um link comum) volta para a URL do chrome. Os dois lados só
|
|
112
251
|
aceitam mensagem da mesma origem e da janela esperada.
|
|
113
252
|
|
|
253
|
+
### Navegação
|
|
254
|
+
|
|
255
|
+
`context.navigate(to, options?)` — e um link comum dentro do quadro — segue duas
|
|
256
|
+
regras, conforme o destino:
|
|
257
|
+
|
|
258
|
+
- **Sem query e sem `controls`** (`navigate("/orders/1042")`): a query atual
|
|
259
|
+
segue inteira; numa tela diferente, os `c.*` da anterior ficam para trás.
|
|
260
|
+
- **Com query própria ou com `controls`** (`navigate("/orders?c.rows=one")`,
|
|
261
|
+
`navigate("/orders", { controls: { rows: "one" } })`): o destino manda. Desde a
|
|
262
|
+
0.9.1, o contexto do motor — tudo que não é `scenario`, `fixture`, `component`
|
|
263
|
+
nem `c.*`: persona, rede, viewport, tema, idioma, fonte de dados, handoff e os
|
|
264
|
+
parâmetros do chrome — é preservado, a menos que o destino traga o mesmo
|
|
265
|
+
parâmetro. Os `c.*` da tela anterior são descartados. A persona que vinha do
|
|
266
|
+
cenário deixado para trás vira `persona=` explícito (quando difere da persona
|
|
267
|
+
padrão), para quem está olhando não mudar; a rede e a fixture do cenário ficam
|
|
268
|
+
com ele. `controls` vira `c.*` do destino, sem os valores que já são o padrão
|
|
269
|
+
da tela de destino (ou o que o cenário de destino fixa).
|
|
270
|
+
|
|
271
|
+
`options.replace` substitui a entrada do histórico em vez de criar outra. O
|
|
272
|
+
recorte de handoff atual é sempre reaplicado.
|
|
273
|
+
|
|
114
274
|
## A URL é o estado
|
|
115
275
|
|
|
116
276
|
Todo controle é serializado na query string, então a mesma URL sempre produz a
|
|
@@ -121,9 +281,10 @@ rede declarados no cenário.
|
|
|
121
281
|
| --- | --- |
|
|
122
282
|
| `scenario` | Cenário ativo. Define os padrões dos demais. |
|
|
123
283
|
| `component` | Referência ativa no catálogo visual do produto. |
|
|
124
|
-
| `persona` | Troca o papel e as permissões. |
|
|
284
|
+
| `persona` | Troca o papel e as permissões. Omitido quando é o do cenário ou a persona padrão do produto. |
|
|
125
285
|
| `fixture` | Troca a fixture global do cenário ou a fixture local do componente ativo. |
|
|
126
286
|
| `network` | `success`, `loading`, `empty`, `error`, `slow`. |
|
|
287
|
+
| `c.<id>` | Valor de um controle da tela. Omitido quando é o padrão (ou o que o cenário fixa). |
|
|
127
288
|
| `viewport` | `fit`, `mobile`, `tablet`, `desktop`; `custom` para links antigos. |
|
|
128
289
|
| `w` | Largura, quando `viewport=custom`. |
|
|
129
290
|
| `rotate=1` | Troca largura e altura do viewport. |
|
|
@@ -242,12 +403,20 @@ tema, cor ou logo por produto.
|
|
|
242
403
|
|
|
243
404
|
- `createRegistry(product)` — índice consultável.
|
|
244
405
|
- `screens`, `screen(id)`, `screenForPath(path)`, `screenOf(scenario)` — telas
|
|
245
|
-
(`ScreenNode`) e suas variações.
|
|
406
|
+
(`ScreenNode`) e suas variações. `ScreenNode.href` é o caminho da tela sem
|
|
407
|
+
cenário, com os exemplos de `route.params`.
|
|
408
|
+
- `defaultPersona` — a persona padrão do produto, quando registrada; entra em
|
|
409
|
+
`permissionsOf(scenario)` para cenário sem persona.
|
|
246
410
|
- `screensFor({ handoff })`, `activeScenarios()`, `search()`,
|
|
247
411
|
`searchScreens()`, `searchComponents()`, `componentsFor(handoff)` — aplicam o
|
|
248
412
|
recorte; a busca não diferencia acento nem caixa (`normalizeSearch`).
|
|
249
|
-
- `componentsOfScreen(screen)`, `usagesOf(componentId)` — componentes
|
|
250
|
-
tela e telas de um componente, a partir de `
|
|
413
|
+
- `componentsOfScreen(screen, scenario?)`, `usagesOf(componentId)` — componentes
|
|
414
|
+
de uma tela e telas de um componente, a partir de `route.components` e
|
|
415
|
+
`Scenario.components`.
|
|
416
|
+
- `flows(options)`, `flowOf(screen)` — telas agrupadas por fluxo (`FlowNode`).
|
|
417
|
+
`controlsOf(screen)` e `resolveControls(screen, { scenario, requested })` —
|
|
418
|
+
controles da tela e seus valores (padrão → cenário → URL), com os pedidos
|
|
419
|
+
inválidos em `invalid` (`ControlResolution`).
|
|
251
420
|
- `validateProduct(product)` / `validateScenario(scenario)` — validação em runtime
|
|
252
421
|
do contrato. Pega fixture, persona, regra ou rota inexistente, rota duplicada,
|
|
253
422
|
id duplicado e componente citado sem registro — o que o TypeScript não
|
|
@@ -18,6 +18,16 @@ export declare const PARAM: {
|
|
|
18
18
|
readonly zoom: "zoom";
|
|
19
19
|
readonly rotated: "rotate";
|
|
20
20
|
};
|
|
21
|
+
/**
|
|
22
|
+
* Prefixo dos controles da tela na URL: `c.<id>=<value>`. O prefixo separa os
|
|
23
|
+
* controles declarados pelo produto dos parâmetros do motor, então um controle
|
|
24
|
+
* chamado `persona` não colide com a persona.
|
|
25
|
+
*/
|
|
26
|
+
export declare const CONTROL_PARAM_PREFIX = "c.";
|
|
27
|
+
/** Os `c.<id>` de uma query string, como id → value. */
|
|
28
|
+
export declare function readControlParams(search: string | URLSearchParams): Record<string, string>;
|
|
29
|
+
/** Remove todos os `c.<id>` de uma query. */
|
|
30
|
+
export declare function deleteControlParams(params: URLSearchParams): void;
|
|
21
31
|
/**
|
|
22
32
|
* Serializa um valor de controle para a query string.
|
|
23
33
|
*
|
package/dist/controls/state.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ControlsState, ViewportSetting } from '../types/index.js';
|
|
1
|
+
import { ControlsState, NavigateOptions, ViewportSetting } from '../types/index.js';
|
|
2
2
|
import { Registry } from '../registry/index.js';
|
|
3
3
|
/**
|
|
4
4
|
* Presets de viewport. A largura é a da janela que o produto enxerga dentro do
|
|
@@ -17,23 +17,32 @@ export type DesignSpaceLocation = {
|
|
|
17
17
|
/**
|
|
18
18
|
* Lê os controles da query string, aplicando os padrões do cenário ativo.
|
|
19
19
|
* Pura e testável: não toca em `window`.
|
|
20
|
+
*
|
|
21
|
+
* `path` é o caminho aberto. Com ele, os controles da tela (`c.<id>`) são
|
|
22
|
+
* resolvidos contra a tela daquele caminho; sem ele, contra a tela do cenário.
|
|
20
23
|
*/
|
|
21
|
-
export declare function parseControls(search: string, registry: Registry): ControlsState;
|
|
24
|
+
export declare function parseControls(search: string, registry: Registry, path?: string): ControlsState;
|
|
22
25
|
/**
|
|
23
26
|
* Serializa os controles de volta na query string, omitindo tudo que é padrão.
|
|
24
27
|
* URL curta é URL que sobrevive a ser colada em ticket e em thread.
|
|
25
28
|
*/
|
|
26
|
-
export declare function serializeControls(state: ControlsState, registry: Registry): string;
|
|
29
|
+
export declare function serializeControls(state: ControlsState, registry: Registry, path?: string): string;
|
|
27
30
|
export type DesignSpaceState = {
|
|
28
31
|
location: DesignSpaceLocation;
|
|
29
32
|
controls: ControlsState;
|
|
30
33
|
viewport: ViewportSetting;
|
|
31
|
-
/**
|
|
34
|
+
/**
|
|
35
|
+
* Altera um ou mais controles, preservando a rota. Parte sempre do endereço
|
|
36
|
+
* mais recente: chamadas seguidas no mesmo ciclo se acumulam.
|
|
37
|
+
*/
|
|
32
38
|
setControls: (patch: Partial<ControlsState>) => void;
|
|
33
|
-
/**
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
39
|
+
/**
|
|
40
|
+
* Muda controles da tela (id → value) sobre os valores mais recentes, numa só
|
|
41
|
+
* atualização de URL. Sem mudança efetiva, não toca no histórico.
|
|
42
|
+
*/
|
|
43
|
+
setScreenControls: (patch: Record<string, string>) => void;
|
|
44
|
+
/** Navega para uma rota. Ver {@link navigationTarget} para o que a query leva. */
|
|
45
|
+
navigate: (to: string, options?: NavigateOptions) => void;
|
|
37
46
|
/**
|
|
38
47
|
* Abre um cenário: vai para a rota dele e reseta persona, fixture e rede para
|
|
39
48
|
* o que o cenário declara. Controles de ambiente (viewport, chrome, tema)
|
|
@@ -74,6 +83,27 @@ export type DesignSpaceStateOptions = {
|
|
|
74
83
|
* avançar no navegador funcionem como o usuário espera.
|
|
75
84
|
*/
|
|
76
85
|
export declare function useDesignSpaceState(registry: Registry, options?: DesignSpaceStateOptions): DesignSpaceState;
|
|
86
|
+
/**
|
|
87
|
+
* Para onde vai uma navegação: caminho e query do destino. Pura e testável.
|
|
88
|
+
*
|
|
89
|
+
* - **Sem query e sem `controls`** (`navigate("/x")`): a query atual segue
|
|
90
|
+
* inteira, como sempre foi; numa tela diferente, os `c.*` da anterior ficam
|
|
91
|
+
* para trás.
|
|
92
|
+
* - **Com query própria ou com `controls`**: o destino manda. O contexto do
|
|
93
|
+
* motor — tudo que não é `scenario`, `fixture`, `component` nem `c.*`:
|
|
94
|
+
* persona, rede, viewport, tema, idioma, fonte de dados, handoff e os
|
|
95
|
+
* parâmetros do chrome — segue, a menos que o destino traga o mesmo
|
|
96
|
+
* parâmetro. A persona que vinha do cenário deixado para trás vira parâmetro
|
|
97
|
+
* explícito, para quem está olhando não mudar só porque o cenário saiu.
|
|
98
|
+
* `controls` vira `c.*` do destino, sem os valores que já são o padrão da
|
|
99
|
+
* tela de destino.
|
|
100
|
+
*
|
|
101
|
+
* Em qualquer caso, o recorte de handoff atual é reaplicado: a UI do produto não
|
|
102
|
+
* consegue apagá-lo escrevendo a própria query.
|
|
103
|
+
*/
|
|
104
|
+
export declare function navigationTarget(to: string, current: DesignSpaceLocation, registry: Registry, options?: {
|
|
105
|
+
controls?: Record<string, string>;
|
|
106
|
+
}): DesignSpaceLocation;
|
|
77
107
|
export declare function resolveViewport(controls: ControlsState): ViewportSetting;
|
|
78
108
|
/** Zoom válido a partir do texto da URL: inteiro entre 25 e 150, ou 100. */
|
|
79
109
|
export declare function clampZoom(value: string | null): number;
|
package/dist/design-space.css
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
.ds-root{--ds-bg: #ffffff;--ds-fg: #0a0a0a;--ds-muted: #737373;--ds-border: #e5e5e5;--ds-surface: #fafafa;--ds-canvas: #f5f5f5;--ds-hover: #f0f0f0;--ds-danger: #dc2626;--ds-frame-bg: #ffffff;--ds-tint: rgb(10 10 10 / .1);--ds-tint-hover: rgb(10 10 10 / .05);--ds-soft: rgb(10 10 10 / .6);--ds-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;--ds-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;--ds-fs: 13px;--ds-fs-sm: 12px;--ds-radius: 8px;--ds-control-h: 36px;--ds-row-h: var(--ds-control-h);--ds-topbar-h: 56px;position:fixed;inset:0;z-index:2147483000;display:flex;flex-direction:column;overflow:hidden;margin:0;padding:0;background:var(--ds-bg);color:var(--ds-fg);font-family:var(--ds-font);font-size:var(--ds-fs);font-weight:400;line-height:1.45;letter-spacing:normal;text-align:left;color-scheme:light;-webkit-font-smoothing:antialiased}.ds-root[data-appearance=dark]{--ds-bg: #0a0a0a;--ds-fg: #fafafa;--ds-muted: #a3a3a3;--ds-border: #262626;--ds-surface: #171717;--ds-canvas: #121212;--ds-hover: #1f1f1f;--ds-danger: #f87171;--ds-tint: rgb(250 250 250 / .12);--ds-tint-hover: rgb(250 250 250 / .06);--ds-soft: rgb(250 250 250 / .6);color-scheme:dark}.ds-root :where(*:not(svg,svg *)){all:revert}.ds-root,.ds-root *,.ds-root *:before,.ds-root *:after{box-sizing:border-box}.ds-root :where(button,input,select,textarea){font:inherit;color:inherit;margin:0}.ds-root :where(h1,h2,h3,p,ul,ol,dl,dd,figure){margin:0}.ds-root :where(ul,ol){padding:0;list-style:none}.ds-root :where(code,kbd){font-family:var(--ds-mono);font-size:.92em}.ds-root :focus-visible{outline:2px solid var(--ds-fg);outline-offset:1px}.ds-icon{display:block;flex:none}.ds-muted{color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-body{display:flex;flex:1;min-height:0}.ds-main{position:relative;display:flex;flex:1;min-width:0;background:var(--ds-canvas)}.ds-root[data-resizing=true]{cursor:col-resize;-webkit-user-select:none;user-select:none}.ds-topbar{display:grid;grid-template-columns:1fr auto 1fr;align-items:center;gap:12px;height:var(--ds-topbar-h);padding:0 12px 0 16px;border-bottom:1px solid var(--ds-border);background:var(--ds-bg);flex:none}.ds-topbar__product{display:flex;flex-direction:column;justify-content:center;gap:1px;min-width:0}.ds-topbar__name{font-size:15px;font-weight:700;line-height:1.2;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.ds-topbar__version{width:fit-content;color:var(--ds-muted);font-size:var(--ds-fs-sm);line-height:1.2;text-decoration:none;white-space:nowrap}.ds-topbar__version:hover{color:var(--ds-fg);text-decoration:underline}.ds-topbar__view,.ds-topbar__tools{display:flex;align-items:center;gap:6px}.ds-topbar__tools{justify-self:end}.ds-group{display:flex;align-items:center;gap:0;padding:2px;border:1px solid var(--ds-tint);border-radius:calc(var(--ds-radius) + 2px)}.ds-group .ds-btn{height:var(--ds-control-h);border:0;border-radius:var(--ds-radius);background:none;color:var(--ds-soft)}.ds-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;height:var(--ds-control-h);padding:0 10px;border:1px solid var(--ds-tint);border-radius:var(--ds-radius);background:none;color:var(--ds-fg);font-size:var(--ds-fs);line-height:1;white-space:nowrap;cursor:pointer}.ds-btn:hover:not(:disabled){background:var(--ds-tint-hover);color:var(--ds-fg)}.ds-btn:disabled{color:var(--ds-muted);cursor:default;opacity:.5}.ds-btn--icon{width:var(--ds-control-h);padding:0}.ds-group .ds-btn--icon{width:var(--ds-control-h)}.ds-btn--zoom{min-width:46px;padding:0 4px;font-variant-numeric:tabular-nums;font-size:var(--ds-fs-sm)}.ds-btn--block{width:100%;margin-top:4px}.ds-btn[aria-pressed=true],.ds-btn[aria-pressed=true]:hover:not(:disabled),.ds-item[aria-current=true],.ds-item[aria-current=true]:hover,.ds-tab[aria-selected=true]{background:var(--ds-tint);color:var(--ds-fg)}.ds-link{padding:0;border:0;background:none;color:var(--ds-fg);font-size:var(--ds-fs);text-align:left;text-decoration:underline;text-decoration-color:var(--ds-border);text-underline-offset:3px;cursor:pointer}.ds-link:hover{text-decoration-color:currentColor}.ds-diagnostics{position:relative}.ds-diagnostics__trigger{padding:0 8px;gap:4px;font-size:var(--ds-fs-sm);font-variant-numeric:tabular-nums}.ds-diagnostics__trigger[data-level=error]{color:var(--ds-danger);border-color:var(--ds-danger)}.ds-diagnostics__popover{position:absolute;top:calc(100% + 6px);right:0;z-index:10;width:380px;max-height:60vh;overflow:auto;border:1px solid var(--ds-border);border-radius:var(--ds-radius);background:var(--ds-bg);box-shadow:0 6px 24px #00000014}.ds-diagnostics__head{display:flex;flex-direction:column;gap:2px;padding:10px 12px;border-bottom:1px solid var(--ds-border)}.ds-diagnostics__item{display:grid;gap:2px;padding:8px 12px;border-bottom:1px solid var(--ds-border)}.ds-diagnostics__item:last-child{border-bottom:0}.ds-diagnostics__level{font-size:var(--ds-fs-sm);font-weight:600}.ds-diagnostics__item[data-level=error] .ds-diagnostics__level{color:var(--ds-danger)}.ds-diagnostics__where{color:var(--ds-muted);font-size:var(--ds-fs-sm);word-break:break-all}.ds-diagnostics__message{font-size:var(--ds-fs-sm)}.ds-sidebar,.ds-panel{position:relative;display:flex;flex-direction:column;flex:none;min-height:0;background:var(--ds-bg)}.ds-sidebar{border-right:1px solid var(--ds-border)}.ds-panel{border-left:1px solid var(--ds-border)}.ds-search{position:relative;display:flex;align-items:center;margin:10px 10px 0;color:var(--ds-muted);flex:none}.ds-search>.ds-icon{position:absolute;left:12px;pointer-events:none}.ds-input.ds-search__input{height:var(--ds-row-h);padding-left:34px;padding-right:44px;border-color:var(--ds-tint);background:var(--ds-tint)}.ds-kbd{position:absolute;right:12px;color:var(--ds-muted);font-family:var(--ds-mono);font-size:11px;letter-spacing:2px;line-height:1;pointer-events:none}.ds-input,.ds-select{display:block;width:100%;height:var(--ds-control-h);padding:0 8px;border:1px solid var(--ds-tint);border-radius:var(--ds-radius);background:var(--ds-bg);color:var(--ds-fg);font-size:var(--ds-fs)}.ds-panel .ds-select{height:var(--ds-row-h);padding:0 10px;border-color:var(--ds-tint);background-color:var(--ds-tint)}.ds-input:focus,.ds-select:focus{border-color:var(--ds-soft);outline:none}.ds-input::placeholder{color:var(--ds-muted)}.ds-input[type=search]::-webkit-search-cancel-button{display:none}.ds-sidebar__list,.ds-panel__body{flex:1;min-height:0;overflow:auto;padding:6px 8px 16px}.ds-panel__body{padding:10px 12px 20px}.ds-tabs{display:flex;gap:0;margin:6px 10px 0;padding:2px;border:1px solid var(--ds-tint);border-radius:calc(var(--ds-radius) + 2px);flex:none}.ds-tab{display:flex;flex:1;align-items:center;justify-content:center;gap:6px;height:var(--ds-row-h);padding:0 12px;border:0;border-radius:var(--ds-radius);background:none;color:var(--ds-soft);font-size:var(--ds-fs);font-weight:500;letter-spacing:1px;line-height:1;text-transform:uppercase;cursor:pointer}.ds-tab:hover{color:var(--ds-fg)}.ds-tab .ds-count{letter-spacing:normal}.ds-count{color:inherit;opacity:.7}.ds-count{color:var(--ds-muted);font-size:var(--ds-fs-sm);font-variant-numeric:tabular-nums}.ds-items{display:flex;flex-direction:column;gap:1px}.ds-item{position:relative;display:flex;align-items:center;justify-content:space-between;gap:8px;width:100%;min-height:var(--ds-row-h);padding:8px 8px 8px 26px;border:0;border-radius:var(--ds-radius);background:none;color:var(--ds-soft);font-size:var(--ds-fs);line-height:1.45;text-align:left;cursor:pointer}.ds-item:before{content:"";position:absolute;top:calc(var(--ds-row-h) / 2);left:10px;width:8px;height:1px;background:var(--ds-fg);opacity:.2}.ds-item:hover{background:var(--ds-tint-hover);color:var(--ds-fg)}.ds-item[aria-current=true] .ds-count,.ds-item[aria-current=true] .ds-item__hint{color:inherit;opacity:.75}.ds-item--stacked{flex-direction:column;align-items:flex-start;gap:1px}.ds-item--stacked:before{top:17px}.ds-item__title{min-width:0;overflow-wrap:anywhere}.ds-item__hint{display:-webkit-box;overflow:hidden;color:var(--ds-muted);font-size:var(--ds-fs-sm);-webkit-line-clamp:1;-webkit-box-orient:vertical}.ds-group-section+.ds-group-section{margin-top:6px}.ds-group-section__head{display:flex;align-items:center;gap:6px;width:100%;height:var(--ds-row-h);padding:6px 8px 4px;border:0;background:none;color:var(--ds-muted);font-size:var(--ds-fs-sm);font-weight:500;text-align:left;cursor:pointer}.ds-group-section__head>span:first-of-type{letter-spacing:1px;line-height:1;text-transform:uppercase;opacity:.6}.ds-group-section__head:hover{color:var(--ds-fg)}.ds-group-section__head>span:first-of-type{flex:1}.ds-group-section__head .ds-icon{transition:transform .12s ease}.ds-group-section__head[aria-expanded=true] .ds-icon{transform:rotate(90deg)}.ds-empty{padding:12px 8px;color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-notice{margin-bottom:8px;padding:8px 10px;border:1px solid var(--ds-border);border-radius:var(--ds-radius);background:var(--ds-surface);font-size:var(--ds-fs-sm)}.ds-resizer{position:absolute;top:0;bottom:0;z-index:5;width:7px;cursor:col-resize;touch-action:none}.ds-resizer[data-side=left]{right:-4px}.ds-resizer[data-side=right]{left:-4px}.ds-resizer:hover,.ds-resizer:focus-visible,.ds-root[data-resizing=true] .ds-resizer{background:linear-gradient(var(--ds-fg),var(--ds-fg)) center / 1px 100% no-repeat;outline:none}.ds-fields{display:grid;gap:10px;margin-top:14px;padding-top:14px;border-top:1px solid var(--ds-border)}.ds-field{display:grid;gap:4px}.ds-field__label{color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-info{display:grid;gap:24px;padding-top:4px}.ds-section{display:grid;gap:4px}.ds-section__title{padding:0 0 6px;color:var(--ds-muted);font-size:var(--ds-fs-sm);font-weight:500;letter-spacing:1px;line-height:1;text-transform:uppercase;opacity:.6}.ds-defs{display:grid}.ds-def{display:grid;grid-template-columns:84px minmax(0,1fr);align-items:start;gap:12px;padding:10px 0;border-top:1px solid var(--ds-tint)}.ds-def:last-child{border-bottom:1px solid var(--ds-tint)}.ds-def dt{color:var(--ds-muted);font-size:var(--ds-fs-sm);line-height:19.5px}.ds-def dd{line-height:1.5;overflow-wrap:anywhere}.ds-def dd code,.ds-links code{display:inline-block;max-width:100%;padding:0 6px;border-radius:6px;background:var(--ds-tint);font-family:var(--ds-mono);font-size:var(--ds-fs-sm);line-height:19.5px;overflow-wrap:anywhere}.ds-defs>.ds-muted{padding:10px 0;border-top:1px solid var(--ds-tint);border-bottom:1px solid var(--ds-tint);font-size:var(--ds-fs-sm)}.ds-list{display:grid;gap:6px}.ds-list li{position:relative;padding-left:14px}.ds-list li:before{content:"";position:absolute;top:.75em;left:0;width:8px;height:1px;background:var(--ds-fg);opacity:.2}.ds-links{display:grid}.ds-links li{display:grid;gap:6px;justify-items:start;padding:10px 0;border-top:1px solid var(--ds-tint)}.ds-links li:last-child{border-bottom:1px solid var(--ds-tint)}.ds-canvas{display:flex;flex:1;min-width:0;min-height:0;overflow:auto;padding:24px}.ds-canvas[data-fit=true]{padding:0;overflow:hidden}.ds-canvas__box{position:relative;flex:none;margin:auto;overflow:hidden}.ds-canvas:not([data-fit]) .ds-canvas__box{outline:1px solid var(--ds-border)}.ds-frame{display:block;border:0;margin:0;padding:0;background:var(--ds-frame-bg);color-scheme:normal;transform-origin:0 0}.ds-chrome-empty{display:grid;gap:6px;margin:auto;padding:24px;text-align:center}.ds-chrome-empty__title{font-size:15px;font-weight:600}.ds-root[data-chrome=hidden] .ds-main{background:var(--ds-frame-bg)}.ds-restore{position:fixed;right:10px;bottom:10px;z-index:20;display:grid;place-items:center;width:22px;height:22px;padding:0;border:1px solid transparent;border-radius:999px;background:transparent;cursor:pointer;opacity:.35}.ds-restore:hover,.ds-restore:focus-visible{border-color:var(--ds-border);background:var(--ds-bg);opacity:1}.ds-restore__dot{width:6px;height:6px;border-radius:999px;background:var(--ds-muted)}.ds-stage-empty{box-sizing:border-box;max-width:520px;margin:48px auto;padding:20px 24px;border:1px solid #e5e5e5;border-radius:6px;background:#fff;color:#0a0a0a;font-family:ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;font-size:13px;line-height:1.5}.ds-stage-empty__title{margin:0 0 6px;font-size:15px;font-weight:600}.ds-stage-empty p{margin:0;color:#737373}
|
|
1
|
+
.ds-root{--ds-bg: #ffffff;--ds-fg: #0a0a0a;--ds-muted: #737373;--ds-border: #e5e5e5;--ds-surface: #fafafa;--ds-canvas: #f5f5f5;--ds-hover: #f0f0f0;--ds-danger: #dc2626;--ds-frame-bg: #ffffff;--ds-tint: rgb(10 10 10 / .1);--ds-tint-hover: rgb(10 10 10 / .05);--ds-soft: rgb(10 10 10 / .6);--ds-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;--ds-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;--ds-fs: 13px;--ds-fs-sm: 12px;--ds-radius: 8px;--ds-control-h: 36px;--ds-row-h: var(--ds-control-h);--ds-topbar-h: 56px;position:fixed;inset:0;z-index:2147483000;display:flex;flex-direction:column;overflow:hidden;margin:0;padding:0;background:var(--ds-bg);color:var(--ds-fg);font-family:var(--ds-font);font-size:var(--ds-fs);font-weight:400;line-height:1.45;letter-spacing:normal;text-align:left;color-scheme:light;-webkit-font-smoothing:antialiased}.ds-root[data-appearance=dark]{--ds-bg: #0a0a0a;--ds-fg: #fafafa;--ds-muted: #a3a3a3;--ds-border: #262626;--ds-surface: #171717;--ds-canvas: #121212;--ds-hover: #1f1f1f;--ds-danger: #f87171;--ds-tint: rgb(250 250 250 / .12);--ds-tint-hover: rgb(250 250 250 / .06);--ds-soft: rgb(250 250 250 / .6);color-scheme:dark}.ds-root :where(*:not(svg,svg *)){all:revert}.ds-root,.ds-root *,.ds-root *:before,.ds-root *:after{box-sizing:border-box}.ds-root :where(button,input,select,textarea){font:inherit;color:inherit;margin:0}.ds-root :where(h1,h2,h3,p,ul,ol,dl,dd,figure){margin:0}.ds-root :where(ul,ol){padding:0;list-style:none}.ds-root :where(code,kbd){font-family:var(--ds-mono);font-size:.92em}.ds-root :focus-visible{outline:2px solid var(--ds-fg);outline-offset:1px}.ds-icon{display:block;flex:none}.ds-muted{color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-body{display:flex;flex:1;min-height:0}.ds-main{position:relative;display:flex;flex:1;min-width:0;background:var(--ds-canvas)}.ds-root[data-resizing=true]{cursor:col-resize;-webkit-user-select:none;user-select:none}.ds-topbar{display:grid;grid-template-columns:1fr auto 1fr;align-items:center;gap:12px;height:var(--ds-topbar-h);padding:0 12px 0 16px;border-bottom:1px solid var(--ds-border);background:var(--ds-bg);flex:none}.ds-topbar__product{display:flex;flex-direction:column;justify-content:center;gap:1px;min-width:0}.ds-topbar__name{font-size:15px;font-weight:700;line-height:1.2;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.ds-topbar__version{width:fit-content;color:var(--ds-muted);font-size:var(--ds-fs-sm);line-height:1.2;text-decoration:none;white-space:nowrap}.ds-topbar__version:hover{color:var(--ds-fg);text-decoration:underline}.ds-topbar__view,.ds-topbar__tools{display:flex;align-items:center;gap:6px}.ds-topbar__tools{justify-self:end}.ds-group{display:flex;align-items:center;gap:0;padding:2px;border:1px solid var(--ds-tint);border-radius:calc(var(--ds-radius) + 2px)}.ds-group .ds-btn{height:var(--ds-control-h);border:0;border-radius:var(--ds-radius);background:none;color:var(--ds-soft)}.ds-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;height:var(--ds-control-h);padding:0 10px;border:1px solid var(--ds-tint);border-radius:var(--ds-radius);background:none;color:var(--ds-fg);font-size:var(--ds-fs);line-height:1;white-space:nowrap;cursor:pointer}.ds-btn:hover:not(:disabled){background:var(--ds-tint-hover);color:var(--ds-fg)}.ds-btn:disabled{color:var(--ds-muted);cursor:default;opacity:.5}.ds-btn--icon{width:var(--ds-control-h);padding:0}.ds-group .ds-btn--icon{width:var(--ds-control-h)}.ds-btn--zoom{min-width:46px;padding:0 4px;font-variant-numeric:tabular-nums;font-size:var(--ds-fs-sm)}.ds-btn--block{width:100%;margin-top:4px}.ds-btn[aria-pressed=true],.ds-btn[aria-pressed=true]:hover:not(:disabled),.ds-item[aria-current=true],.ds-item[aria-current=true]:hover,.ds-tab[aria-checked=true],.ds-tab[aria-selected=true]{background:var(--ds-tint);color:var(--ds-fg)}.ds-link{padding:0;border:0;background:none;color:var(--ds-fg);font-size:var(--ds-fs);text-align:left;text-decoration:underline;text-decoration-color:var(--ds-border);text-underline-offset:3px;cursor:pointer}.ds-link:hover{text-decoration-color:currentColor}.ds-diagnostics{position:relative}.ds-diagnostics__trigger{padding:0 8px;gap:4px;font-size:var(--ds-fs-sm);font-variant-numeric:tabular-nums}.ds-diagnostics__trigger[data-level=error]{color:var(--ds-danger);border-color:var(--ds-danger)}.ds-diagnostics__popover{position:absolute;top:calc(100% + 6px);right:0;z-index:10;width:380px;max-height:60vh;overflow:auto;border:1px solid var(--ds-border);border-radius:var(--ds-radius);background:var(--ds-bg);box-shadow:0 6px 24px #00000014}.ds-diagnostics__head{display:flex;flex-direction:column;gap:2px;padding:10px 12px;border-bottom:1px solid var(--ds-border)}.ds-diagnostics__item{display:grid;gap:2px;padding:8px 12px;border-bottom:1px solid var(--ds-border)}.ds-diagnostics__item:last-child{border-bottom:0}.ds-diagnostics__level{font-size:var(--ds-fs-sm);font-weight:600}.ds-diagnostics__item[data-level=error] .ds-diagnostics__level{color:var(--ds-danger)}.ds-diagnostics__where{color:var(--ds-muted);font-size:var(--ds-fs-sm);word-break:break-all}.ds-diagnostics__message{font-size:var(--ds-fs-sm)}.ds-sidebar,.ds-panel{position:relative;display:flex;flex-direction:column;flex:none;min-height:0;background:var(--ds-bg)}.ds-sidebar{border-right:1px solid var(--ds-border)}.ds-panel{border-left:1px solid var(--ds-border)}.ds-search{position:relative;display:flex;align-items:center;margin:10px 10px 0;color:var(--ds-muted);flex:none}.ds-search>.ds-icon{position:absolute;left:12px;pointer-events:none}.ds-input.ds-search__input{height:var(--ds-row-h);padding-left:34px;padding-right:44px;border-color:var(--ds-tint);background:var(--ds-tint)}.ds-kbd{position:absolute;right:12px;color:var(--ds-muted);font-family:var(--ds-mono);font-size:11px;letter-spacing:2px;line-height:1;pointer-events:none}.ds-input,.ds-select{display:block;width:100%;height:var(--ds-control-h);padding:0 8px;border:1px solid var(--ds-tint);border-radius:var(--ds-radius);background:var(--ds-bg);color:var(--ds-fg);font-size:var(--ds-fs)}.ds-panel .ds-select{height:var(--ds-row-h);padding:0 10px;border-color:var(--ds-tint);background-color:var(--ds-tint)}.ds-input:focus,.ds-select:focus{border-color:var(--ds-soft);outline:none}.ds-input::placeholder{color:var(--ds-muted)}.ds-input[type=search]::-webkit-search-cancel-button{display:none}.ds-sidebar__list,.ds-panel__body{flex:1;min-height:0;overflow:auto;padding:6px 8px 16px}.ds-panel__body{padding:10px 12px 20px}.ds-tabs{display:flex;gap:0;margin:6px 10px 0;padding:2px;border:1px solid var(--ds-tint);border-radius:calc(var(--ds-radius) + 2px);flex:none}.ds-tab{display:flex;flex:1;align-items:center;justify-content:center;gap:6px;height:var(--ds-row-h);padding:0 12px;border:0;border-radius:var(--ds-radius);background:none;color:var(--ds-soft);font-size:var(--ds-fs);font-weight:500;letter-spacing:1px;line-height:1;text-transform:uppercase;cursor:pointer}.ds-tab:hover{color:var(--ds-fg)}.ds-tab .ds-count{letter-spacing:normal}.ds-count{color:inherit;opacity:.7}.ds-count{color:var(--ds-muted);font-size:var(--ds-fs-sm);font-variant-numeric:tabular-nums}.ds-items{display:flex;flex-direction:column;gap:1px}.ds-item{position:relative;display:flex;align-items:center;justify-content:space-between;gap:8px;width:100%;min-height:var(--ds-row-h);padding:8px 8px 8px 26px;border:0;border-radius:var(--ds-radius);background:none;color:var(--ds-soft);font-size:var(--ds-fs);line-height:1.45;text-align:left;cursor:pointer}.ds-item:before{content:"";position:absolute;top:calc(var(--ds-row-h) / 2);left:10px;width:8px;height:1px;background:var(--ds-fg);opacity:.2}.ds-item:hover{background:var(--ds-tint-hover);color:var(--ds-fg)}.ds-item[aria-current=true] .ds-count,.ds-item[aria-current=true] .ds-item__hint{color:inherit;opacity:.75}.ds-item--stacked{flex-direction:column;align-items:flex-start;gap:1px}.ds-item--stacked:before{top:17px}.ds-item__title{min-width:0;overflow-wrap:anywhere}.ds-item__hint{display:-webkit-box;overflow:hidden;color:var(--ds-muted);font-size:var(--ds-fs-sm);-webkit-line-clamp:1;-webkit-box-orient:vertical}.ds-group-section+.ds-group-section{margin-top:6px}.ds-group-section__head{display:flex;align-items:center;gap:6px;width:100%;height:var(--ds-row-h);padding:6px 8px 4px;border:0;background:none;color:var(--ds-muted);font-size:var(--ds-fs-sm);font-weight:500;text-align:left;cursor:pointer}.ds-group-section__head>span:first-of-type{letter-spacing:1px;line-height:1;text-transform:uppercase;opacity:.6}.ds-group-section__head:hover{color:var(--ds-fg)}.ds-group-section__head>span:first-of-type{flex:1}.ds-group-section__head .ds-icon{transition:transform .12s ease}.ds-group-section__head[aria-expanded=true] .ds-icon{transform:rotate(90deg)}.ds-empty{padding:12px 8px;color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-notice{margin-bottom:8px;padding:8px 10px;border:1px solid var(--ds-border);border-radius:var(--ds-radius);background:var(--ds-surface);font-size:var(--ds-fs-sm)}.ds-resizer{position:absolute;top:0;bottom:0;z-index:5;width:7px;cursor:col-resize;touch-action:none}.ds-resizer[data-side=left]{right:-4px}.ds-resizer[data-side=right]{left:-4px}.ds-resizer:hover,.ds-resizer:focus-visible,.ds-root[data-resizing=true] .ds-resizer{background:linear-gradient(var(--ds-fg),var(--ds-fg)) center / 1px 100% no-repeat;outline:none}.ds-fields{display:grid;gap:10px;margin-top:14px;padding-top:14px;border-top:1px solid var(--ds-border)}.ds-field{display:grid;gap:4px}.ds-field__label,.ds-field__hint{color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-fields--flush{margin-top:0;padding:2px 8px 10px;border-top:0}.ds-group-section__note{display:grid;gap:4px;justify-items:start;padding:0 8px 8px;color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-tabs--segmented{margin:0}.ds-tabs--segmented .ds-tab{padding:0 6px;letter-spacing:normal;text-transform:none}.ds-info{display:grid;gap:24px;padding-top:4px}.ds-section{display:grid;gap:4px}.ds-section__title{padding:0 0 6px;color:var(--ds-muted);font-size:var(--ds-fs-sm);font-weight:500;letter-spacing:1px;line-height:1;text-transform:uppercase;opacity:.6}.ds-defs{display:grid}.ds-def{display:grid;grid-template-columns:84px minmax(0,1fr);align-items:start;gap:12px;padding:10px 0;border-top:1px solid var(--ds-tint)}.ds-def:last-child{border-bottom:1px solid var(--ds-tint)}.ds-def dt{color:var(--ds-muted);font-size:var(--ds-fs-sm);line-height:19.5px}.ds-def dd{line-height:1.5;overflow-wrap:anywhere}.ds-def dd code,.ds-links code{display:inline-block;max-width:100%;padding:0 6px;border-radius:6px;background:var(--ds-tint);font-family:var(--ds-mono);font-size:var(--ds-fs-sm);line-height:19.5px;overflow-wrap:anywhere}.ds-defs>.ds-muted{padding:10px 0;border-top:1px solid var(--ds-tint);border-bottom:1px solid var(--ds-tint);font-size:var(--ds-fs-sm)}.ds-list{display:grid;gap:6px}.ds-list li{position:relative;padding-left:14px}.ds-list li:before{content:"";position:absolute;top:.75em;left:0;width:8px;height:1px;background:var(--ds-fg);opacity:.2}.ds-links{display:grid}.ds-links li{display:grid;gap:6px;justify-items:start;padding:10px 0;border-top:1px solid var(--ds-tint)}.ds-links li:last-child{border-bottom:1px solid var(--ds-tint)}.ds-canvas{display:flex;flex:1;min-width:0;min-height:0;overflow:auto;padding:24px}.ds-canvas[data-fit=true]{padding:0;overflow:hidden}.ds-canvas__box{position:relative;flex:none;margin:auto;overflow:hidden}.ds-canvas:not([data-fit]) .ds-canvas__box{outline:1px solid var(--ds-border)}.ds-frame{display:block;border:0;margin:0;padding:0;background:var(--ds-frame-bg);color-scheme:normal;transform-origin:0 0}.ds-chrome-empty{display:grid;gap:6px;margin:auto;padding:24px;text-align:center}.ds-chrome-empty__title{font-size:15px;font-weight:600}.ds-root[data-chrome=hidden] .ds-main{background:var(--ds-frame-bg)}.ds-restore{position:fixed;right:10px;bottom:10px;z-index:20;display:grid;place-items:center;width:22px;height:22px;padding:0;border:1px solid transparent;border-radius:999px;background:transparent;cursor:pointer;opacity:.35}.ds-restore:hover,.ds-restore:focus-visible{border-color:var(--ds-border);background:var(--ds-bg);opacity:1}.ds-restore__dot{width:6px;height:6px;border-radius:999px;background:var(--ds-muted)}.ds-stage-empty{box-sizing:border-box;max-width:520px;margin:48px auto;padding:20px 24px;border:1px solid #e5e5e5;border-radius:6px;background:#fff;color:#0a0a0a;font-family:ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;font-size:13px;line-height:1.5}.ds-stage-empty__title{margin:0 0 6px;font-size:15px;font-weight:600}.ds-stage-empty p{margin:0;color:#737373}
|