@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 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 tem permissões vazias, a menos que
82
- declare `permissions`.
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`). Componentes agrupados por `group`. Aba vazia some. Redimensionável. |
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** (cenários da tela ou fixtures do componente, mais persona e rede) e **Informações** (rota, intenção, pré-condições, ações, comportamento esperado, regras, componentes usados e **Copiar para o PR**). Redimensionável. |
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 de uma
250
- tela e telas de um componente, a partir de `Scenario.components`.
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
@@ -9,4 +9,6 @@ export declare function useScenarioData(options: {
9
9
  fixture: Fixture | undefined;
10
10
  network: NetworkState;
11
11
  adapter: DataSourceAdapter | undefined;
12
+ /** Rota da tela, usada no erro simulado quando não há cenário. */
13
+ screen?: string;
12
14
  }): ScenarioData;
@@ -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
  *
@@ -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
- /** Altera um ou mais controles, preservando a rota. */
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
- /** Navega para uma rota, preservando os controles ativos. */
34
- navigate: (to: string, options?: {
35
- replace?: boolean;
36
- }) => void;
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;
@@ -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}