@brucesantos/design-space 0.8.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,93 @@ 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.0 (2026-09-29)
10
+
11
+ **Minor (compatível).** Fluxos agrupam telas, e as variações de uma tela passam a
12
+ ser controles por componente que se combinam. Tudo é opcional: um produto da 0.8
13
+ continua funcionando sem mudar nada. Ver
14
+ `docs/decisions/0013-fluxos-e-controles-por-componente.md`.
15
+
16
+ ### Adicionado
17
+
18
+ - **Tipos:** `ControlOption`, `Control` e `ControlGroup`.
19
+ - **`RouteDefinition`:** `group` (o fluxo da tela), `controls` (grupos de
20
+ controles por componente), `expected` (comportamento esperado da tela sem
21
+ cenário ativo) e `components` (ids do catálogo usados pela tela).
22
+ - **`Scenario.controls`:** a combinação que o cenário fixa. Abrir o cenário
23
+ aplica esses valores sobre os padrões da tela.
24
+ - **`ScenarioContext.controls`** (valor de cada controle, com os padrões
25
+ aplicados) e **`ScenarioContext.setControl(id, value)`**, que funciona dentro
26
+ do quadro: troca o endereço do quadro e avisa o chrome, que adota a URL.
27
+ - **URL:** `c.<id>=<value>` para cada controle fora do padrão (ou do que o
28
+ cenário fixa). Valor inválido cai no padrão e aparece como aviso no
29
+ diagnóstico; controle que a tela não tem também. Os `c.*` chegam ao quadro, e
30
+ mudar um controle atualiza o quadro por mensagem, sem recarregar. Ao navegar
31
+ para outra tela, os `c.*` da anterior ficam para trás.
32
+ `ControlsState.screenControls`, `CONTROL_PARAM_PREFIX`; `applyOverrides` (e
33
+ portanto `pathFor`/`scenarioUrl` com `overrides`) aceita `screenControls`.
34
+ - **Registry:** `flows()`, `flowOf(screen)`, `controlsOf(screen)`,
35
+ `resolveControls(screen, { scenario, requested })`; `ScreenNode.group` e
36
+ `ScreenNode.controls`. Tipos `FlowNode`, `ControlResolution`,
37
+ `InvalidControl`. `searchScreens` casa também o nome do fluxo.
38
+ - **Aba Telas** agrupada por fluxo, com seções recolhíveis e contagem; tela sem
39
+ `group` fica no topo, sem título.
40
+ - **Painel Variações** em três partes: **contexto** no topo (persona, rede, e
41
+ tema, idioma e fonte de dados quando declarados), **um bloco por grupo de
42
+ controles** (título, link para o componente do catálogo, `note`, e cada
43
+ controle como botões segmentados ou select) e **atalhos** (os cenários da tela,
44
+ compactos, com a intenção na dica). O filtro alcança grupos, controles e
45
+ opções.
46
+ - **Informações:** fluxo, controles com o valor atual, comportamento esperado do
47
+ cenário ativo ou da rota, e componentes de `route.components` mais os do
48
+ cenário.
49
+ - **Copiar para o PR por fluxo:** numa tela com `group`, o markdown traz o fluxo
50
+ inteiro — para cada tela, nome, rota, link absoluto (com os controles atuais na
51
+ tela aberta), controles disponíveis, atalhos, comportamento esperado e a tabela
52
+ componente → origem.
53
+ - **Validação:** ids de grupo e de controle únicos por tela, id de controle sem
54
+ espaço, opções não vazias e sem duplicata, `default` entre as opções e
55
+ `Scenario.controls` usando controles e valores da tela do cenário (erros);
56
+ `route.components` e `group.component` inexistentes (avisos).
57
+ - **Rótulos** novos, em pt-BR e en-US: `panel.context`, `panel.shortcuts`,
58
+ `panel.toggleGroup`, `panel.openComponent`, `info.flow`, `info.controls`,
59
+ `diagnostics.invalidControl`, `diagnostics.unknownControl`, `pr.open`,
60
+ `pr.controls`, `pr.shortcuts`, `pr.defaultOption`.
61
+
62
+ ### Alterado
63
+
64
+ - **Tela sem cenário respeita o estado de rede.** Antes, sem cenário, `network`
65
+ não tinha efeito; agora `loading`, `slow`, `empty` e `error` chegam à tela
66
+ (`isLoading`, `data: null`, `error`), como com cenário. `useScenarioData`
67
+ aceita `screen` para nomear o erro simulado.
68
+ - A lista de cenários do painel virou **Atalhos**, depois dos controles, em uma
69
+ linha cada; a intenção foi para a dica (`title`) do item.
70
+ - `parseControls(search, registry, path?)` e `serializeControls(state, registry,
71
+ path?)` aceitam o caminho aberto, para resolver os controles pela tela dele.
72
+ Sem ele, vale a tela do cenário, como antes.
73
+ - `componentsOfScreen(screen, scenario?)` inclui `route.components`, e aceita um
74
+ cenário para restringir aos componentes dele; `usagesOf` considera
75
+ `route.components`.
76
+
77
+ ### Guia de uso
78
+
79
+ 1. Dê um `group` às rotas de um mesmo fluxo:
80
+ `{ path: "/orders", screen: OrderList, name: "Lista de pedidos", group: "Pedidos" }`.
81
+ 2. Declare os controles da tela por componente, em `controls`: um `ControlGroup`
82
+ por componente (`id`, `title`, `component` opcional, `note` opcional) com os
83
+ `Control`s dele (`id`, `label`, `options`, `default` opcional).
84
+ 3. Na tela, leia `context.controls` e monte os dados sintéticos a partir deles.
85
+ Quando a UI do produto precisa mudar um controle (fechar um modal), chame
86
+ `context.setControl(id, value)`.
87
+ 4. Troque os cenários que eram só combinações por atalhos: `controls: { … }` no
88
+ cenário. Mantenha cenário para o que tem persona, fixture, regra ou
89
+ comportamento esperado próprios.
90
+ 5. Mova para `route.expected` e `route.components` o que vale para a tela
91
+ inteira, e rode a validação: ela aponta controle inexistente, valor fora das
92
+ opções e `default` inválido.
93
+ 6. Nos testes, um link com controles sai de
94
+ `pathFor(scenario, { screenControls: { rows: "none" } })`.
95
+
9
96
  ## 0.8.0 (2026-09-28)
10
97
 
11
98
  **Major (incompatível).** Chrome novo, modelo de organização novo e a UI do
package/README.md CHANGED
@@ -51,6 +51,111 @@ 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
+ ## Fluxos e controles (0.9)
55
+
56
+ Uma feature raramente é uma tela: é um **fluxo** de algumas telas, e cada tela
57
+ tem **componentes** que variam de forma independente. Desde a 0.9 as duas coisas
58
+ são declaradas na rota, e nada disso é obrigatório
59
+ ([decisão 0013](../../docs/decisions/0013-fluxos-e-controles-por-componente.md)).
60
+
61
+ ```ts
62
+ routes: [
63
+ {
64
+ path: "/orders",
65
+ screen: OrderList,
66
+ name: "Lista de pedidos",
67
+ group: "Pedidos", // o fluxo: agrupa as telas na aba Telas
68
+ expected: ["A lista mostra os pedidos do período."],
69
+ components: ["data.table"],
70
+ controls: [
71
+ {
72
+ id: "table",
73
+ title: "Tabela de pedidos · table",
74
+ component: "data.table", // link para o catálogo no painel
75
+ note: "Linhas e ordenação.",
76
+ controls: [
77
+ {
78
+ id: "rows",
79
+ label: "Linhas",
80
+ options: [
81
+ { value: "many", label: "Muitas" },
82
+ { value: "one", label: "Uma" },
83
+ { value: "none", label: "Nenhuma" },
84
+ ],
85
+ },
86
+ ],
87
+ },
88
+ {
89
+ id: "overlay",
90
+ title: "Sobreposição",
91
+ controls: [
92
+ {
93
+ id: "overlay",
94
+ label: "Aberta",
95
+ options: [
96
+ { value: "none", label: "Nenhuma" },
97
+ { value: "cancel", label: "Cancelar pedido" },
98
+ ],
99
+ },
100
+ ],
101
+ },
102
+ ],
103
+ },
104
+ { path: "/orders/:id", screen: OrderDetail, name: "Detalhe do pedido", group: "Pedidos" },
105
+ ],
106
+ ```
107
+
108
+ - **Aba Telas:** agrupada por `group`, em seções recolhíveis com contagem, como
109
+ os componentes. Tela sem `group` fica no topo, sem título. A busca casa também
110
+ o nome do fluxo.
111
+ - **Painel Variações:** o **contexto** no topo (persona, rede, e tema, idioma e
112
+ fonte de dados quando o produto declara), depois um bloco por `ControlGroup` e,
113
+ por fim, os cenários da tela como **atalhos**. Até quatro opções curtas viram
114
+ botões segmentados; o resto, um select. O filtro (`Cmd`/`Ctrl` + `F`) alcança
115
+ grupos, controles e opções.
116
+ - **Na URL:** cada controle fora do padrão vai como `c.<id>=<value>`. Valor
117
+ inválido cai no padrão e aparece como aviso no diagnóstico. Os `c.*` chegam ao
118
+ quadro, e mudar um controle atualiza o quadro por mensagem, sem recarregar.
119
+ - **Na tela:** `context.controls` traz o valor de cada controle, com os padrões
120
+ aplicados; `context.setControl(id, value)` muda um deles a partir da UI do
121
+ produto (fechar um modal volta a sobreposição para "nenhuma") e atualiza a URL.
122
+ Sem cenário, a tela monta os próprios dados sintéticos a partir dos controles —
123
+ é o caso normal agora —, e o estado de rede do contexto continua valendo.
124
+ - **Cenário como atalho:** `Scenario.controls` fixa uma combinação. Abrir o
125
+ cenário aplica esses valores sobre os padrões; mudar um controle depois não
126
+ troca de cenário, mas o atalho deixa de aparecer destacado quando a combinação
127
+ deixa de ser a dele.
128
+
129
+ ```ts
130
+ { id: "orders.cancel", title: "Cancelando um pedido", route: "/orders",
131
+ fixture: "orders", controls: { overlay: "cancel" }, expected: ["O modal pede confirmação."] }
132
+ ```
133
+
134
+ ```tsx
135
+ function OrderList({ context }: ScreenProps) {
136
+ const rows = buildRows(context.controls.rows); // dado sintético do produto
137
+ return (
138
+ <>
139
+ <Table rows={rows} />
140
+ {context.controls.overlay === "cancel" && (
141
+ <CancelModal onClose={() => context.setControl("overlay", "none")} />
142
+ )}
143
+ </>
144
+ );
145
+ }
146
+ ```
147
+
148
+ Informações mostra rota, fluxo, descrição, os controles com o valor atual, o
149
+ comportamento esperado (o do cenário ativo, senão `route.expected`) e os
150
+ componentes (`route.components` mais os do cenário). **Copiar para o PR**, numa
151
+ tela com fluxo, gera o markdown do fluxo inteiro: para cada tela, nome, rota,
152
+ link absoluto (com os controles atuais na tela aberta), controles disponíveis,
153
+ atalhos, comportamento esperado e a tabela componente → origem.
154
+
155
+ A validação checa ids de grupo e de controle únicos por tela, `default` entre as
156
+ opções e `Scenario.controls` usando controles e valores da tela do cenário; id de
157
+ componente inexistente em `route.components` ou `group.component` é aviso.
158
+
54
159
  ## O contrato de cenário
55
160
 
56
161
  Um cenário combina intenção, persona, permissões, pré-condições, dados, ações,
@@ -88,9 +193,9 @@ motor.
88
193
  | Região | Conteúdo |
89
194
  | --- | --- |
90
195
  | 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. |
196
+ | 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
197
  | 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. |
198
+ | 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
199
 
95
200
  Sem Home: a raiz abre a primeira tela na primeira variação ou, sem telas, o
96
201
  primeiro componente. O tema segue o sistema, e a troca é lembrada.
@@ -99,7 +204,8 @@ primeiro componente. O tema segue o sistema, e a troca é lembrada.
99
204
 
100
205
  Gera markdown com o nome da tela, um link absoluto por variação (com o link do
101
206
  deployment e o commit quando o produto informa), a tabela componente → origem e
102
- o comportamento esperado de cada variação.
207
+ o comportamento esperado de cada variação. Tela com fluxo gera o fluxo inteiro
208
+ (ver [Fluxos e controles](#fluxos-e-controles-09)).
103
209
 
104
210
  ### O quadro
105
211
 
@@ -124,6 +230,7 @@ rede declarados no cenário.
124
230
  | `persona` | Troca o papel e as permissões. |
125
231
  | `fixture` | Troca a fixture global do cenário ou a fixture local do componente ativo. |
126
232
  | `network` | `success`, `loading`, `empty`, `error`, `slow`. |
233
+ | `c.<id>` | Valor de um controle da tela. Omitido quando é o padrão (ou o que o cenário fixa). |
127
234
  | `viewport` | `fit`, `mobile`, `tablet`, `desktop`; `custom` para links antigos. |
128
235
  | `w` | Largura, quando `viewport=custom`. |
129
236
  | `rotate=1` | Troca largura e altura do viewport. |
@@ -246,8 +353,13 @@ tema, cor ou logo por produto.
246
353
  - `screensFor({ handoff })`, `activeScenarios()`, `search()`,
247
354
  `searchScreens()`, `searchComponents()`, `componentsFor(handoff)` — aplicam o
248
355
  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`.
356
+ - `componentsOfScreen(screen, scenario?)`, `usagesOf(componentId)` — componentes
357
+ de uma tela e telas de um componente, a partir de `route.components` e
358
+ `Scenario.components`.
359
+ - `flows(options)`, `flowOf(screen)` — telas agrupadas por fluxo (`FlowNode`).
360
+ `controlsOf(screen)` e `resolveControls(screen, { scenario, requested })` —
361
+ controles da tela e seus valores (padrão → cenário → URL), com os pedidos
362
+ inválidos em `invalid` (`ControlResolution`).
251
363
  - `validateProduct(product)` / `validateScenario(scenario)` — validação em runtime
252
364
  do contrato. Pega fixture, persona, regra ou rota inexistente, rota duplicada,
253
365
  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
  *
@@ -17,13 +17,16 @@ 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;
@@ -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}