@brucesantos/design-space 0.10.0 → 0.12.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 +61 -0
- package/README.md +18 -1
- package/dist/controls/params.d.ts +1 -0
- package/dist/design-space.css +1 -1
- package/dist/frame/index.d.ts +25 -0
- package/dist/{index-BnTStnNk.js → index-rWBjjVMg.js} +132 -118
- package/dist/index-rWBjjVMg.js.map +1 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1163 -1052
- package/dist/index.js.map +1 -1
- package/dist/shell/Canvas.d.ts +4 -1
- package/dist/shell/Highlight.d.ts +15 -0
- package/dist/shell/Topbar.d.ts +5 -1
- package/dist/shell/icons.d.ts +1 -1
- package/dist/shell/labels.d.ts +7 -0
- package/dist/testing.js +1 -1
- package/dist/types/index.d.ts +5 -0
- package/package.json +1 -1
- package/dist/index-BnTStnNk.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,67 @@ 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.12.0 (2026-10-11)
|
|
10
|
+
|
|
11
|
+
**Minor.** Botão novo no chrome e um rótulo novo em `Labels`; nenhum export,
|
|
12
|
+
parâmetro ou comportamento existente muda.
|
|
13
|
+
|
|
14
|
+
### Adicionado
|
|
15
|
+
|
|
16
|
+
- **"Abrir em nova janela" na barra superior**, ao lado da revisão limpa. Abre
|
|
17
|
+
numa aba nova o quadro sozinho (`ds-frame=1`), sem chrome e sem `<iframe>`, no
|
|
18
|
+
endereço que o quadro está mostrando — inclusive depois de a UI do produto
|
|
19
|
+
navegar dentro dele. Os parâmetros só do chrome e o viewport ficam de fora
|
|
20
|
+
(a largura é a da janela nova, em "Ajustar"); cenário, persona, fixture,
|
|
21
|
+
rede, controles, query da tela, tema, idioma e handoff vão junto. É o caminho para ferramenta de captura que lê só o documento de cima,
|
|
22
|
+
como as extensões que levam HTML para o Figma: com `chrome=0` a UI continua
|
|
23
|
+
dentro do `<iframe>`, e a captura vê um bloco só.
|
|
24
|
+
- Rótulo `topbar.openFrame` ("Abrir em nova janela" / "Open in new window"),
|
|
25
|
+
sobrescrevível por `theme.labels` como os demais.
|
|
26
|
+
|
|
27
|
+
### Sem mudança
|
|
28
|
+
|
|
29
|
+
- `chrome=0` continua escondendo o chrome com a UI dentro do
|
|
30
|
+
`<iframe data-ds-frame>`.
|
|
31
|
+
|
|
32
|
+
### Migração
|
|
33
|
+
|
|
34
|
+
- Produto que declara `Labels` inteiro (em vez de override parcial) precisa
|
|
35
|
+
incluir `topbar.openFrame`. Quem usa `theme.labels` parcial ou
|
|
36
|
+
`EN_US_LABELS` não faz nada.
|
|
37
|
+
|
|
38
|
+
## 0.11.0 (2026-10-09)
|
|
39
|
+
|
|
40
|
+
**Minor.** Funcionalidade compatível: um parâmetro de URL, um campo opcional em
|
|
41
|
+
`ControlsState`, um export e um grupo de rótulos. Nenhum produto precisa mudar
|
|
42
|
+
para atualizar. Ver
|
|
43
|
+
[0016](../../docs/decisions/0016-destaque-de-componentes.md).
|
|
44
|
+
|
|
45
|
+
### Adicionado
|
|
46
|
+
|
|
47
|
+
- **Destacar componentes.** Botão no centro da barra, ao lado da revisão limpa,
|
|
48
|
+
que contorna na UI do produto cada elemento marcado com
|
|
49
|
+
`data-ds-component="<id do catálogo>"`, com o nome do componente no catálogo.
|
|
50
|
+
Serve à avaliação de design: o que fica sem contorno ainda não é componente.
|
|
51
|
+
Id que o catálogo não conhece aparece tracejado, com o rótulo
|
|
52
|
+
`highlight.notInCatalog`. Os contornos são uma camada por cima da UI, no
|
|
53
|
+
`body` do quadro, sem receber ponteiro e sem tocar nos elementos do produto.
|
|
54
|
+
- **`?highlight=1`.** O destaque vai para a URL, então um link pode abrir com
|
|
55
|
+
ele ligado. Ligar e desligar chega ao quadro por mensagem, sem recarregar.
|
|
56
|
+
- **`COMPONENT_ATTRIBUTE`** (`"data-ds-component"`), exportado ao lado de
|
|
57
|
+
`FRAME_ATTRIBUTE`, para marcar componente e para seletor de teste.
|
|
58
|
+
- **Rótulos.** `topbar.highlight` e `highlight.notInCatalog`, sobrescrevíveis por
|
|
59
|
+
`theme.labels`.
|
|
60
|
+
|
|
61
|
+
### Para aproveitar
|
|
62
|
+
|
|
63
|
+
Sem marcação, o destaque não contorna nada. Para usar, marque a raiz de cada
|
|
64
|
+
componente do catálogo:
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
<span data-ds-component="actions.buttons" className="…">…</span>
|
|
68
|
+
```
|
|
69
|
+
|
|
9
70
|
## 0.10.0 (2026-10-04)
|
|
10
71
|
|
|
11
72
|
**Minor.** Nenhum tipo, export ou parâmetro novo, mas muda um comportamento
|
package/README.md
CHANGED
|
@@ -230,7 +230,7 @@ painel continuam vencendo. Id inexistente é erro de validação. Sem
|
|
|
230
230
|
|
|
231
231
|
| Região | Conteúdo |
|
|
232
232
|
| --- | --- |
|
|
233
|
-
| Barra superior | Nome do produto; viewport (Celular 375, Tablet 768, Desktop 1280, Ajustar), girar, zoom 25–150%,
|
|
233
|
+
| Barra superior | Nome do produto; viewport (Celular 375, Tablet 768, Desktop 1280, Ajustar), girar, zoom 25–150%, revisão limpa, abrir em nova janela, copiar link, tema, painel e — quando a validação tem algo a dizer — o indicador de diagnóstico. |
|
|
234
234
|
| 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. |
|
|
235
235
|
| Centro | O quadro do produto no tamanho do viewport, com zoom só de visualização. |
|
|
236
236
|
| 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. |
|
|
@@ -255,6 +255,23 @@ entrada no histórico. Navegação feita pela UI do produto (`context.navigate`,
|
|
|
255
255
|
`openScenario` ou um link comum) volta para a URL do chrome. Os dois lados só
|
|
256
256
|
aceitam mensagem da mesma origem e da janela esperada.
|
|
257
257
|
|
|
258
|
+
### Abrir em nova janela
|
|
259
|
+
|
|
260
|
+
O botão ao lado da revisão limpa abre o quadro sozinho, numa aba nova: o mesmo
|
|
261
|
+
endereço com `ds-frame=1`, sem chrome e sem `<iframe>`. É o caminho para
|
|
262
|
+
ferramenta de captura que lê só o documento de cima — como as extensões que
|
|
263
|
+
levam HTML para o Figma. `chrome=0` não serve para isso: ele esconde o chrome,
|
|
264
|
+
mas a UI continua dentro do `<iframe>`, e a ferramenta enxerga um bloco só.
|
|
265
|
+
|
|
266
|
+
O endereço é o que o quadro está mostrando, inclusive depois de o produto
|
|
267
|
+
navegar dentro dele. Cenário, persona, fixture, rede, controles e query da tela,
|
|
268
|
+
tema, idioma e handoff vão junto; os parâmetros só do chrome (`appearance`,
|
|
269
|
+
`chrome`, `panel`, `tab`, `zoom`, `rotate`) ficam de fora. O viewport (`viewport`,
|
|
270
|
+
`w`) também fica: a largura é a da janela nova, e o quadro abre em "Ajustar",
|
|
271
|
+
então `context.viewport` e `@media` concordam. Para capturar a tela de celular,
|
|
272
|
+
estreite a janela. Sem janela pai, o quadro funciona sozinho; só os atalhos do
|
|
273
|
+
chrome deixam de existir.
|
|
274
|
+
|
|
258
275
|
### Navegação
|
|
259
276
|
|
|
260
277
|
`context.navigate(to, options?)` — e um link comum dentro do quadro — segue duas
|
package/dist/design-space.css
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
.ds-root{--ds-bg: #ffffff;--ds-fg: #0a0a0a;--ds-muted: #737373;--ds-border: #e5e5e5;--ds-surface: #fafafa;--ds-canvas: #f5f5f5;--ds-hover: #f0f0f0;--ds-danger: #dc2626;--ds-frame-bg: #ffffff;--ds-tint: rgb(10 10 10 / .1);--ds-tint-hover: rgb(10 10 10 / .05);--ds-soft: rgb(10 10 10 / .6);--ds-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;--ds-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;--ds-fs: 13px;--ds-fs-sm: 12px;--ds-radius: 8px;--ds-control-h: 36px;--ds-row-h: var(--ds-control-h);--ds-topbar-h: 56px;position:fixed;inset:0;z-index:2147483000;display:flex;flex-direction:column;overflow:hidden;margin:0;padding:0;background:var(--ds-bg);color:var(--ds-fg);font-family:var(--ds-font);font-size:var(--ds-fs);font-weight:400;line-height:1.45;letter-spacing:normal;text-align:left;color-scheme:light;-webkit-font-smoothing:antialiased}.ds-root[data-appearance=dark]{--ds-bg: #0a0a0a;--ds-fg: #fafafa;--ds-muted: #a3a3a3;--ds-border: #262626;--ds-surface: #171717;--ds-canvas: #121212;--ds-hover: #1f1f1f;--ds-danger: #f87171;--ds-tint: rgb(250 250 250 / .12);--ds-tint-hover: rgb(250 250 250 / .06);--ds-soft: rgb(250 250 250 / .6);color-scheme:dark}.ds-root :where(*:not(svg,svg *)){all:revert}.ds-root,.ds-root *,.ds-root *:before,.ds-root *:after{box-sizing:border-box}.ds-root :where(button,input,select,textarea){font:inherit;color:inherit;margin:0}.ds-root :where(h1,h2,h3,p,ul,ol,dl,dd,figure){margin:0}.ds-root :where(ul,ol){padding:0;list-style:none}.ds-root :where(code,kbd){font-family:var(--ds-mono);font-size:.92em}.ds-root :focus-visible{outline:2px solid var(--ds-fg);outline-offset:1px}.ds-icon{display:block;flex:none}.ds-muted{color:var(--ds-muted);font-size:var(--ds-fs-sm)}.ds-body{display:flex;flex:1;min-height:0}.ds-main{position:relative;display:flex;flex:1;min-width:0;background:var(--ds-canvas)}.ds-root[data-resizing=true]{cursor:col-resize;-webkit-user-select:none;user-select:none}.ds-topbar{display:grid;grid-template-columns:1fr auto 1fr;align-items:center;gap:12px;height:var(--ds-topbar-h);padding:0 12px 0 16px;border-bottom:1px solid var(--ds-border);background:var(--ds-bg);flex:none}.ds-topbar__product{display:flex;flex-direction:column;justify-content:center;gap:1px;min-width:0}.ds-topbar__name{font-size:15px;font-weight:700;line-height:1.2;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.ds-topbar__version{width:fit-content;color:var(--ds-muted);font-size:var(--ds-fs-sm);line-height:1.2;text-decoration:none;white-space:nowrap}.ds-topbar__version:hover{color:var(--ds-fg);text-decoration:underline}.ds-topbar__view,.ds-topbar__tools{display:flex;align-items:center;gap:6px}.ds-topbar__tools{justify-self:end}.ds-group{display:flex;align-items:center;gap:0;padding:2px;border:1px solid var(--ds-tint);border-radius:calc(var(--ds-radius) + 2px)}.ds-group .ds-btn{height:var(--ds-control-h);border:0;border-radius:var(--ds-radius);background:none;color:var(--ds-soft)}.ds-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;height:var(--ds-control-h);padding:0 10px;border:1px solid var(--ds-tint);border-radius:var(--ds-radius);background:none;color:var(--ds-fg);font-size:var(--ds-fs);line-height:1;white-space:nowrap;cursor:pointer}.ds-btn:hover:not(:disabled){background:var(--ds-tint-hover);color:var(--ds-fg)}.ds-btn:disabled{color:var(--ds-muted);cursor:default;opacity:.5}.ds-btn--icon{width:var(--ds-control-h);padding:0}.ds-group .ds-btn--icon{width:var(--ds-control-h)}.ds-btn--zoom{min-width:46px;padding:0 4px;font-variant-numeric:tabular-nums;font-size:var(--ds-fs-sm)}.ds-btn--block{width:100%;margin-top:4px}.ds-btn[aria-pressed=true],.ds-btn[aria-pressed=true]:hover:not(:disabled),.ds-item[aria-current=true],.ds-item[aria-current=true]:hover,.ds-tab[aria-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-vcards{display:grid;grid-template-columns:minmax(0,1fr);gap:10px}.ds-vcard{display:grid;grid-template-columns:minmax(0,1fr);min-width:0;gap:10px;padding:12px;border:1px solid var(--ds-tint);border-radius:calc(var(--ds-radius) + 2px)}.ds-vcard__head{display:flex;align-items:center;gap:6px;min-width:0;min-height:20px}.ds-vcard__title{flex:1;min-width:0;padding:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ds-vcard__link.ds-btn{width:24px;height:24px;margin:-4px -4px -4px 0;border-color:transparent;color:var(--ds-muted)}.ds-vcard__link.ds-btn:hover:not(:disabled){color:var(--ds-fg)}.ds-vcard__body{display:grid;gap:8px}.ds-vcard__field{display:block;min-width:0}.ds-vcard__field .ds-select{width:100%;min-width:0}.ds-vcard .ds-items{margin:0 -4px}.ds-visually-hidden{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}.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-vcards{display:grid;grid-template-columns:minmax(0,1fr);gap:10px}.ds-vcard{display:grid;grid-template-columns:minmax(0,1fr);min-width:0;gap:10px;padding:12px;border:1px solid var(--ds-tint);border-radius:calc(var(--ds-radius) + 2px)}.ds-vcard__head{display:flex;align-items:center;gap:6px;min-width:0;min-height:20px}.ds-vcard__title{flex:1;min-width:0;padding:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ds-vcard__link.ds-btn{width:24px;height:24px;margin:-4px -4px -4px 0;border-color:transparent;color:var(--ds-muted)}.ds-vcard__link.ds-btn:hover:not(:disabled){color:var(--ds-fg)}.ds-vcard__body{display:grid;gap:8px}.ds-vcard__field{display:block;min-width:0}.ds-vcard__field .ds-select{width:100%;min-width:0}.ds-vcard .ds-items{margin:0 -4px}.ds-visually-hidden{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}.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}.ds-highlight{position:fixed;inset:0;z-index:2147483647;overflow:hidden;pointer-events:none}.ds-highlight__box{position:fixed;box-sizing:border-box;border:1px solid #0a0a0a;outline:1px solid #ffffff;background:#0a0a0a0f}.ds-highlight__box[data-known=false]{border-style:dashed;background:none}.ds-highlight__label{position:absolute;bottom:100%;left:-1px;max-width:100%;overflow:hidden;padding:1px 4px;background:#0a0a0a;color:#fff;font-family:ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;font-size:10px;font-weight:500;line-height:14px;white-space:nowrap;text-overflow:ellipsis}.ds-highlight__box[data-label=inside] .ds-highlight__label{top:0;bottom:auto;left:0}
|
package/dist/frame/index.d.ts
CHANGED
|
@@ -17,6 +17,12 @@
|
|
|
17
17
|
export declare const FRAME_PARAM = "ds-frame";
|
|
18
18
|
/** Atributo do `<iframe>` do chrome. Serve de seletor para testes. */
|
|
19
19
|
export declare const FRAME_ATTRIBUTE = "data-ds-frame";
|
|
20
|
+
/**
|
|
21
|
+
* Atributo com que o produto marca a raiz de um componente na UI:
|
|
22
|
+
* `data-ds-component="<id do catálogo>"`. É o que o destaque de componentes
|
|
23
|
+
* contorna; o motor não adivinha o que é componente.
|
|
24
|
+
*/
|
|
25
|
+
export declare const COMPONENT_ATTRIBUTE = "data-ds-component";
|
|
20
26
|
/**
|
|
21
27
|
* Parâmetros que só o chrome lê. Ficam fora do endereço do quadro: trocar zoom
|
|
22
28
|
* ou tema do chrome não é assunto da UI do produto.
|
|
@@ -59,6 +65,25 @@ export type FrameMessage =
|
|
|
59
65
|
* chegam à mesma string para o mesmo estado, e é isso que evita recarga à toa.
|
|
60
66
|
*/
|
|
61
67
|
export declare function toFrameUrl(path: string, search: string): string;
|
|
68
|
+
/**
|
|
69
|
+
* Endereço para abrir o quadro sozinho, numa janela própria. É o caminho para
|
|
70
|
+
* ferramenta de captura que lê só o documento de cima e não entra no `<iframe>`.
|
|
71
|
+
*
|
|
72
|
+
* Parte do endereço que o quadro está mostrando de fato (`frameHref`), porque a
|
|
73
|
+
* UI do produto pode ter navegado dentro dele; sem esse endereço — quadro ainda
|
|
74
|
+
* em `about:blank`, em outra origem ou inacessível —, parte do estado do pai.
|
|
75
|
+
* Nos dois casos sai pelo `toFrameUrl`: sem os parâmetros do chrome e com
|
|
76
|
+
* `ds-frame=1`, mesmo que uma navegação completa do quadro o tenha perdido.
|
|
77
|
+
*
|
|
78
|
+
* O viewport também fica de fora. Na janela própria a largura é a da janela, e
|
|
79
|
+
* sem o parâmetro o quadro cai em "Ajustar": `context.viewport` e `@media`
|
|
80
|
+
* contam a mesma história. Com `viewport=mobile` numa janela larga, a tela que
|
|
81
|
+
* decide pelo contexto mostraria celular esticado.
|
|
82
|
+
*/
|
|
83
|
+
export declare function standaloneFrameUrl(frameHref: string | undefined, origin: string, fallback: {
|
|
84
|
+
path: string;
|
|
85
|
+
search: string;
|
|
86
|
+
}): string;
|
|
62
87
|
/** Caminho e query de um endereço do quadro, sem o parâmetro de modo. */
|
|
63
88
|
export declare function fromFrameUrl(url: string): {
|
|
64
89
|
path: string;
|