@brucesantos/design-space 0.6.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 +264 -0
- package/README.md +249 -122
- package/dist/adapters/useScenarioData.d.ts +2 -0
- package/dist/controls/params.d.ts +13 -5
- package/dist/controls/state.d.ts +44 -11
- package/dist/deploy/index.d.ts +4 -4
- package/dist/design-space.css +1 -1
- package/dist/frame/index.d.ts +93 -0
- package/dist/handoff/index.d.ts +3 -2
- package/dist/index-DxIx4GAk.js +439 -0
- package/dist/index-DxIx4GAk.js.map +1 -0
- package/dist/index.d.ts +7 -10
- package/dist/index.js +2107 -1993
- package/dist/index.js.map +1 -1
- package/dist/registry/index.d.ts +115 -27
- package/dist/shell/Canvas.d.ts +19 -0
- package/dist/shell/FrameView.d.ts +9 -0
- package/dist/shell/Panel.d.ts +38 -0
- package/dist/shell/Resizer.d.ts +14 -0
- package/dist/shell/Sidebar.d.ts +15 -7
- package/dist/shell/Stage.d.ts +0 -20
- package/dist/shell/Topbar.d.ts +20 -12
- package/dist/shell/icons.d.ts +9 -0
- package/dist/shell/labels.d.ts +85 -119
- package/dist/shell/prMarkdown.d.ts +43 -0
- package/dist/shell/storage.d.ts +14 -0
- package/dist/testing/index.d.ts +9 -11
- package/dist/testing.js +20 -31
- package/dist/testing.js.map +1 -1
- package/dist/types/index.d.ts +115 -119
- package/dist/version.d.ts +2 -0
- package/package.json +3 -3
- package/dist/a11y/accessible-tree.d.ts +0 -37
- package/dist/a11y/contrast.d.ts +0 -62
- package/dist/a11y/useKeyboardMode.d.ts +0 -23
- package/dist/contrast-B8xa1UIu.js +0 -389
- package/dist/contrast-B8xa1UIu.js.map +0 -1
- package/dist/shell/Controls.d.ts +0 -11
- package/dist/shell/Home.d.ts +0 -12
- package/dist/shell/Inspector.d.ts +0 -13
package/dist/controls/state.d.ts
CHANGED
|
@@ -1,7 +1,15 @@
|
|
|
1
|
-
import { ControlsState,
|
|
1
|
+
import { ControlsState, ViewportSetting } from '../types/index.js';
|
|
2
2
|
import { Registry } from '../registry/index.js';
|
|
3
|
+
/**
|
|
4
|
+
* Presets de viewport. A largura é a da janela que o produto enxerga dentro do
|
|
5
|
+
* quadro; a altura é a da janela e pode ser trocada com a largura (girar).
|
|
6
|
+
* `custom` só existe por URL (`viewport=custom&w=…`), para links antigos.
|
|
7
|
+
*/
|
|
3
8
|
export declare const VIEWPORTS: readonly ViewportSetting[];
|
|
4
|
-
|
|
9
|
+
/** Faixa do zoom da visualização, em porcentagem. */
|
|
10
|
+
export declare const ZOOM_MIN = 25;
|
|
11
|
+
export declare const ZOOM_MAX = 150;
|
|
12
|
+
export declare const ZOOM_DEFAULT = 100;
|
|
5
13
|
export type DesignSpaceLocation = {
|
|
6
14
|
path: string;
|
|
7
15
|
search: string;
|
|
@@ -9,41 +17,66 @@ export type DesignSpaceLocation = {
|
|
|
9
17
|
/**
|
|
10
18
|
* Lê os controles da query string, aplicando os padrões do cenário ativo.
|
|
11
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.
|
|
12
23
|
*/
|
|
13
|
-
export declare function parseControls(search: string, registry: Registry): ControlsState;
|
|
24
|
+
export declare function parseControls(search: string, registry: Registry, path?: string): ControlsState;
|
|
14
25
|
/**
|
|
15
26
|
* Serializa os controles de volta na query string, omitindo tudo que é padrão.
|
|
16
27
|
* URL curta é URL que sobrevive a ser colada em ticket e em thread.
|
|
17
28
|
*/
|
|
18
|
-
export declare function serializeControls(state: ControlsState, registry: Registry): string;
|
|
29
|
+
export declare function serializeControls(state: ControlsState, registry: Registry, path?: string): string;
|
|
19
30
|
export type DesignSpaceState = {
|
|
20
31
|
location: DesignSpaceLocation;
|
|
21
32
|
controls: ControlsState;
|
|
22
33
|
viewport: ViewportSetting;
|
|
23
34
|
/** Altera um ou mais controles, preservando a rota. */
|
|
24
35
|
setControls: (patch: Partial<ControlsState>) => void;
|
|
25
|
-
/** Troca entre trabalho ativo e referências portadas sem misturar coleções. */
|
|
26
|
-
setScenarioView: (view: ScenarioView) => void;
|
|
27
36
|
/** Navega para uma rota, preservando os controles ativos. */
|
|
28
37
|
navigate: (to: string, options?: {
|
|
29
38
|
replace?: boolean;
|
|
30
39
|
}) => void;
|
|
31
40
|
/**
|
|
32
41
|
* Abre um cenário: vai para a rota dele e reseta persona, fixture e rede para
|
|
33
|
-
* o que o cenário declara. Controles de ambiente (viewport, chrome,
|
|
42
|
+
* o que o cenário declara. Controles de ambiente (viewport, chrome, tema)
|
|
34
43
|
* são preservados de propósito — quem está revisando no celular não quer
|
|
35
44
|
* voltar ao desktop a cada troca de situação.
|
|
36
45
|
*/
|
|
37
46
|
openScenario: (scenarioId: string) => void;
|
|
38
47
|
/** Abre uma referência do catálogo de componentes. */
|
|
39
|
-
openComponent: (componentId: string
|
|
48
|
+
openComponent: (componentId: string, options?: {
|
|
49
|
+
replace?: boolean;
|
|
50
|
+
}) => void;
|
|
51
|
+
/**
|
|
52
|
+
* Abre uma tela: a primeira variação visível ou, sem variação, a rota crua,
|
|
53
|
+
* sem cenário, persona nem fixture.
|
|
54
|
+
*/
|
|
55
|
+
openScreen: (screenId: string, options?: {
|
|
56
|
+
replace?: boolean;
|
|
57
|
+
}) => void;
|
|
58
|
+
/**
|
|
59
|
+
* Vai para um endereço exato, sem herdar a query atual. É o que o chrome usa
|
|
60
|
+
* para adotar a navegação que aconteceu dentro do quadro.
|
|
61
|
+
*/
|
|
62
|
+
go: (path: string, search: string, options?: {
|
|
63
|
+
replace?: boolean;
|
|
64
|
+
}) => void;
|
|
65
|
+
};
|
|
66
|
+
export type DesignSpaceStateOptions = {
|
|
67
|
+
/**
|
|
68
|
+
* Modo quadro: o documento é o `<iframe>` do chrome. A navegação troca o
|
|
69
|
+
* endereço do próprio quadro sem criar entrada de histórico — o histórico é
|
|
70
|
+
* do pai — e avisa o pai; o pai manda o estado novo por mensagem.
|
|
71
|
+
*/
|
|
72
|
+
frame?: boolean;
|
|
40
73
|
};
|
|
41
74
|
/**
|
|
42
75
|
* Fonte única de verdade da navegação e dos controles. Usa a History API
|
|
43
76
|
* diretamente, sem router externo, e escuta `popstate` para que voltar e
|
|
44
77
|
* avançar no navegador funcionem como o usuário espera.
|
|
45
78
|
*/
|
|
46
|
-
export declare function useDesignSpaceState(registry: Registry): DesignSpaceState;
|
|
47
|
-
/** Resolve objetos 0.4.0 que ainda só carregam `showPorted`. */
|
|
48
|
-
export declare function scenarioView(state: Pick<ControlsState, "view" | "showPorted">): ScenarioView;
|
|
79
|
+
export declare function useDesignSpaceState(registry: Registry, options?: DesignSpaceStateOptions): DesignSpaceState;
|
|
49
80
|
export declare function resolveViewport(controls: ControlsState): ViewportSetting;
|
|
81
|
+
/** Zoom válido a partir do texto da URL: inteiro entre 25 e 150, ou 100. */
|
|
82
|
+
export declare function clampZoom(value: string | null): number;
|
package/dist/deploy/index.d.ts
CHANGED
|
@@ -10,7 +10,7 @@ export type DeployContext = {
|
|
|
10
10
|
deploymentUrl: string | undefined;
|
|
11
11
|
/** Nome da branch, para rotular a revisão na interface. */
|
|
12
12
|
branch: string | undefined;
|
|
13
|
-
/** Commit exato
|
|
13
|
+
/** Commit exato do deployment, para rastrear a versão revisada. */
|
|
14
14
|
commit: string | undefined;
|
|
15
15
|
/** Primeiros 7 caracteres do commit. */
|
|
16
16
|
shortCommit: string | undefined;
|
|
@@ -41,8 +41,8 @@ export declare function componentUrl(component: ComponentPreview, options?: {
|
|
|
41
41
|
overrides?: Partial<ControlsState>;
|
|
42
42
|
}): string;
|
|
43
43
|
/**
|
|
44
|
-
* URL imutável de
|
|
45
|
-
*
|
|
44
|
+
* URL imutável de um cenário num commit exato (§10.2). Serve para citar em
|
|
45
|
+
* ticket ou thread uma versão que não muda de conteúdo depois de discutida.
|
|
46
46
|
*
|
|
47
47
|
* O formato da URL é do provedor, não do motor, então vem do produto como
|
|
48
48
|
* template com `{commit}` ou `{shortCommit}`:
|
|
@@ -52,7 +52,7 @@ export declare function componentUrl(component: ComponentPreview, options?: {
|
|
|
52
52
|
* commitUrl(scenario, { template: "https://{commit}.review.acme.dev" });
|
|
53
53
|
* ```
|
|
54
54
|
*
|
|
55
|
-
* Sem commit não há
|
|
55
|
+
* Sem commit não há versão rastreável, e a função devolve `undefined` em vez
|
|
56
56
|
* de um link que aponta para o lugar errado.
|
|
57
57
|
*/
|
|
58
58
|
export declare function commitUrl(scenario: Scenario, options: {
|
package/dist/design-space.css
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
.ds-root{--ds-bg: #0f1117;--ds-bg-raised: #161923;--ds-bg-input: #1d212e;--ds-border: #262b3a;--ds-border-strong: #343a4d;--ds-fg: #e7e9ee;--ds-fg-dim: #9aa0b0;--ds-fg-faint: #6b7280;--ds-accent: #7c9cff;--ds-accent-fg: #0f1117;--ds-ok: #4ade80;--ds-warn: #fbbf24;--ds-err: #fb7185;--ds-focus: #a5b8ff;--ds-canvas-a: #12141c;--ds-canvas-b: #0f1117;--ds-status-ported: #a78bfa;--ds-status-proposed: #6b7280;--ds-status-implemented: #22d3ee;--ds-stage-shadow: 0 12px 32px rgb(0 0 0 / .4);--ds-drawer-shadow: -12px 0 32px rgb(0 0 0 / .45);--ds-card-hairline: rgb(255 255 255 / .02);--ds-r: 6px;--ds-r-lg: 10px;--ds-control-h: 32px;--ds-sidebar: 280px;--ds-inspector: 380px;--ds-topbar: 52px;--ds-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;--ds-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace;position:fixed;inset:0;display:grid;grid-template-rows:var(--ds-topbar) 1fr;grid-template-columns:var(--ds-sidebar) 1fr var(--ds-inspector);grid-template-areas:"topbar topbar topbar" "sidebar stage inspector";background:var(--ds-bg)}.ds-root[data-appearance=light]{--ds-bg: #eef1f6;--ds-bg-raised: #ffffff;--ds-bg-input: #f5f7fa;--ds-border: #dde2ea;--ds-border-strong: #c5ccd8;--ds-fg: #172033;--ds-fg-dim: #536078;--ds-fg-faint: #626d80;--ds-accent: #4f67d8;--ds-accent-fg: #ffffff;--ds-ok: #16784a;--ds-warn: #9a5700;--ds-err: #bd3650;--ds-focus: #405bd6;--ds-canvas-a: #e8ecf2;--ds-canvas-b: #f1f3f7;--ds-status-ported: #6d3bd1;--ds-status-proposed: #687386;--ds-status-implemented: #087d98;--ds-stage-shadow: 0 12px 32px rgb(23 32 51 / .16);--ds-drawer-shadow: -12px 0 32px rgb(23 32 51 / .18);--ds-card-hairline: rgb(0 0 0 / .05)}.ds-root[data-inspector=closed]{grid-template-columns:var(--ds-sidebar) 1fr 0}.ds-root[data-chrome=hidden]{grid-template-rows:1fr;grid-template-columns:1fr;grid-template-areas:"stage"}.ds-chrome,.ds-chrome *,.ds-chrome *:before,.ds-chrome *:after{box-sizing:border-box}.ds-chrome{color:var(--ds-fg);font-family:var(--ds-font);font-size:13px;line-height:1.45;-webkit-font-smoothing:antialiased}.ds-chrome :focus-visible{outline:2px solid var(--ds-focus);outline-offset:2px;border-radius:3px}.ds-topbar{grid-area:topbar;display:flex;align-items:center;gap:12px;padding:0 12px;border-bottom:1px solid var(--ds-border);background:var(--ds-bg-raised);min-width:0}.ds-topbar__product{display:flex;align-items:center;gap:8px;font-weight:600;white-space:nowrap}.ds-topbar__home{display:inline-flex;align-items:center;min-height:40px;border-radius:var(--ds-r);color:var(--ds-fg);text-decoration:none}.ds-topbar__home:hover{color:var(--ds-accent)}.ds-topbar__tagline{color:var(--ds-fg-faint);font-weight:400;font-size:12px}.ds-topbar__spacer{flex:1;min-width:8px}.ds-topbar__meta{display:flex;align-items:center;gap:6px;color:var(--ds-fg-dim);font-family:var(--ds-mono);font-size:11px;min-width:0}.ds-topbar__meta code{padding:2px 6px;border:1px solid var(--ds-border);border-radius:var(--ds-r);background:var(--ds-bg-input);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ds-sidebar{grid-area:sidebar;display:flex;flex-direction:column;border-right:1px solid var(--ds-border);background:var(--ds-bg-raised);min-height:0}.ds-sidebar__tabs{display:grid;grid-template-columns:1fr 1fr;padding:8px 8px 0;border-bottom:1px solid var(--ds-border)}.ds-sidebar__tabs button{min-height:40px;border:0;border-bottom:2px solid transparent;background:transparent;color:var(--ds-fg-faint);font:inherit;font-weight:600;cursor:pointer}.ds-sidebar__tabs button[aria-selected=true]{border-bottom-color:var(--ds-accent);color:var(--ds-fg)}.ds-sidebar__search{position:relative;padding:10px;border-bottom:1px solid var(--ds-border)}.ds-sidebar__search kbd{position:absolute;top:50%;right:17px;padding:1px 5px;border:1px solid var(--ds-border-strong);border-radius:4px;background:var(--ds-bg-raised);color:var(--ds-fg-faint);font-family:var(--ds-mono);font-size:10px;transform:translateY(-50%);pointer-events:none}.ds-sidebar__tree{flex:1;overflow-y:auto;padding:8px 6px 20px}.ds-sidebar__view-header{display:grid;gap:5px;padding:5px 8px 12px}.ds-sidebar__view-header h2{margin:0;color:var(--ds-fg-dim);font-size:11px;font-weight:700;letter-spacing:.04em;text-transform:uppercase}.ds-sidebar__view-empty{display:grid;gap:8px;padding:14px 10px;color:var(--ds-fg-faint)}.ds-sidebar__view-empty p{margin:0}.ds-sidebar__view-footer{flex:none;padding:10px 14px;border-top:1px solid var(--ds-border)}.ds-text-action{width:fit-content;padding:1px 0;border:0;background:transparent;color:var(--ds-accent);font:inherit;font-weight:600;text-align:left;text-decoration:underline;text-decoration-color:color-mix(in srgb,var(--ds-accent) 45%,transparent);text-underline-offset:3px;cursor:pointer}.ds-text-action:hover{color:var(--ds-fg);text-decoration-color:currentColor}.ds-module{margin-bottom:4px}.ds-module__header{display:flex;align-items:center;gap:6px;width:100%;padding:6px 8px;border:0;border-radius:var(--ds-r);background:transparent;color:var(--ds-fg);font:inherit;font-weight:600;text-align:left;cursor:pointer}.ds-module__header:hover{background:var(--ds-bg-input)}.ds-module__chevron{flex:none;width:10px;color:var(--ds-fg-faint);transition:transform .12s ease}.ds-module__header[aria-expanded=true] .ds-module__chevron{transform:rotate(90deg)}.ds-module__count{margin-left:auto;color:var(--ds-fg-faint);font-weight:400;font-size:11px;font-variant-numeric:tabular-nums}.ds-module__scenarios{margin:2px 0 6px;padding:0 0 0 14px;list-style:none;border-left:1px solid var(--ds-border)}.ds-scenario{display:flex;align-items:center;gap:8px;width:100%;min-height:38px;padding:7px 8px;border:0;border-radius:var(--ds-r);background:transparent;color:var(--ds-fg-dim);font:inherit;text-align:left;cursor:pointer}.ds-scenario:hover{background:var(--ds-bg-input);color:var(--ds-fg)}.ds-scenario[aria-current=true]{background:color-mix(in srgb,var(--ds-accent) 18%,transparent);color:var(--ds-fg);box-shadow:inset 2px 0 0 0 var(--ds-accent)}.ds-scenario__title{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ds-status-dot{flex:none;width:7px;height:7px;border-radius:50%;background:var(--ds-fg-faint)}.ds-status-dot[data-status=ported]{background:transparent;border:2px solid var(--ds-status-ported)}.ds-status-dot[data-status=proposed]{background:var(--ds-status-proposed)}.ds-status-dot[data-status=in-review]{background:var(--ds-warn)}.ds-status-dot[data-status=approved]{background:var(--ds-ok)}.ds-status-dot[data-status=approved][data-approval=incomplete]{background:var(--ds-warn);box-shadow:0 0 0 2px color-mix(in srgb,var(--ds-warn) 18%,transparent)}.ds-status-dot[data-status=in-implementation]{background:var(--ds-accent)}.ds-status-dot[data-status=implemented]{background:var(--ds-status-implemented)}.ds-status-dot[data-status=superseded]{background:transparent;border:1px solid var(--ds-fg-faint)}.ds-sidebar__empty{padding:16px 10px;color:var(--ds-fg-faint)}.ds-component-group{margin-bottom:16px}.ds-component-group h2,.ds-sidebar__scope h2{margin:0 0 7px;color:var(--ds-fg-faint);font-size:10px;font-weight:700;letter-spacing:.08em;text-transform:uppercase}.ds-component-group ul{margin:0;padding:0;list-style:none}.ds-component-item{display:grid;gap:2px;width:100%;min-height:44px;padding:7px 9px;border:0;border-radius:var(--ds-r);background:transparent;color:var(--ds-fg-dim);font:inherit;text-align:left;cursor:pointer}.ds-component-item:hover,.ds-component-item[aria-current=true]{background:color-mix(in srgb,var(--ds-accent) 16%,transparent);color:var(--ds-fg)}.ds-component-item[aria-current=true]{box-shadow:inset 2px 0 0 var(--ds-accent)}.ds-component-item small{color:var(--ds-fg-faint);font-size:11px;text-wrap:pretty}.ds-sidebar__scope{flex:none;padding:12px 14px 14px;border-top:1px solid var(--ds-border);background:color-mix(in srgb,var(--ds-bg-input) 60%,var(--ds-bg-raised))}.ds-sidebar__scope dl{display:grid;grid-template-columns:54px 1fr;gap:5px 8px;margin:0}.ds-sidebar__scope dt{color:var(--ds-fg-faint);font-size:11px}.ds-sidebar__scope dd{margin:0;overflow:hidden;color:var(--ds-fg-dim);font-size:11px;text-overflow:ellipsis;white-space:nowrap}.ds-stage-area{grid-area:stage;display:flex;flex-direction:column;min-width:0;min-height:0;background:linear-gradient(0deg,transparent 0,transparent) padding-box,repeating-conic-gradient(var(--ds-canvas-a) 0% 25%,var(--ds-canvas-b) 0% 50%) 0 0 / 16px 16px}.ds-stage-scroll{flex:1;display:flex;justify-content:center;overflow:auto;padding:0;min-height:0}.ds-root[data-viewport=fit] .ds-stage-scroll{padding:0}.ds-root:not([data-viewport=fit]) .ds-stage-scroll{padding:20px}.ds-stage{position:relative;flex:none;width:100%;max-width:100%;background:#fff;isolation:isolate;container-type:inline-size;overflow:auto}.ds-root:not([data-viewport=fit]) .ds-stage{border-radius:var(--ds-r-lg);box-shadow:var(--ds-stage-shadow);outline:1px solid var(--ds-border-strong)}.ds-root[data-viewport=fit] .ds-stage{height:100%}.ds-stage[data-reduced-motion=true] *,.ds-stage[data-reduced-motion=true] *:before,.ds-stage[data-reduced-motion=true] *:after{animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important;scroll-behavior:auto!important}.ds-stage[data-keyboard-mode=true] :focus{outline:3px solid #ff3d7f!important;outline-offset:2px!important}.ds-taborder{position:fixed;inset:0;z-index:40;pointer-events:none}.ds-taborder__badge{position:absolute;display:grid;place-items:center;min-width:18px;height:18px;padding:0 4px;border-radius:9px;background:#ff3d7f;color:#fff;font-family:var(--ds-mono);font-size:10px;font-weight:700;font-variant-numeric:tabular-nums;transform:translate(-50%,-50%)}.ds-taborder__badge[data-forced=true]{background:var(--ds-warn);color:#1a1400}.ds-stage-empty{display:grid;place-content:center;gap:10px;height:100%;padding:40px;color:var(--ds-fg-dim);text-align:center}.ds-stage-empty h2{margin:0;color:var(--ds-fg);font-size:15px}.ds-stage-empty p{max-width:46ch;margin:0 auto}.ds-controls{display:flex;flex-wrap:wrap;align-items:center;gap:8px 14px;padding:8px 12px;border-top:1px solid var(--ds-border);background:var(--ds-bg-raised)}.ds-controls:empty{display:none}.ds-field{display:flex;align-items:center;gap:6px;min-width:0}.ds-field>label,.ds-field__label{color:var(--ds-fg-faint);font-size:11px;text-transform:uppercase;letter-spacing:.04em;white-space:nowrap}.ds-select,.ds-input{height:var(--ds-control-h);max-width:200px;padding:4px 8px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-input);color:var(--ds-fg);font:inherit;font-size:12px}.ds-input--search{width:100%;max-width:none;padding-right:46px}.ds-segmented{display:flex;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);overflow:hidden}.ds-segmented button{height:var(--ds-control-h);padding:4px 9px;border:0;border-right:1px solid var(--ds-border-strong);background:var(--ds-bg-input);color:var(--ds-fg-dim);font:inherit;font-size:12px;cursor:pointer}.ds-segmented .ds-icon-button{display:grid;place-items:center;width:36px;padding:0}.ds-segmented button:last-child{border-right:0}.ds-segmented button[aria-pressed=true]{background:var(--ds-accent);color:var(--ds-accent-fg);font-weight:600}.ds-btn{display:inline-flex;align-items:center;justify-content:center;gap:6px;height:var(--ds-control-h);padding:4px 10px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-input);color:var(--ds-fg);font:inherit;font-size:12px;text-decoration:none;cursor:pointer;transition:border-color .12s ease,background-color .12s ease,transform 80ms ease}.ds-btn:hover{border-color:var(--ds-accent)}.ds-btn:active,.ds-segmented button:active,.ds-sidebar__tabs button:active,.ds-scenario:active,.ds-component-item:active{transform:scale(.96)}.ds-btn[aria-pressed=true]{border-color:var(--ds-accent);background:color-mix(in srgb,var(--ds-accent) 22%,transparent)}.ds-btn--icon{width:36px;padding:0}.ds-btn--ghost{border-color:transparent;background:transparent;color:var(--ds-fg-dim)}.ds-inspector{grid-area:inspector;display:flex;flex-direction:column;border-left:1px solid var(--ds-border);background:var(--ds-bg-raised);min-height:0;overflow:hidden}.ds-root[data-inspector=closed] .ds-inspector{display:none}.ds-inspector__tabs{display:flex;border-bottom:1px solid var(--ds-border)}.ds-inspector__tabs button{flex:1;padding:8px 6px;border:0;border-bottom:2px solid transparent;background:transparent;color:var(--ds-fg-faint);font:inherit;font-size:12px;cursor:pointer}.ds-inspector__tabs button[aria-selected=true]{border-bottom-color:var(--ds-accent);color:var(--ds-fg);font-weight:600}.ds-inspector__body{flex:1;overflow-y:auto;padding:16px}.ds-scope-group{margin-bottom:18px;padding-left:10px;border-left:2px solid var(--ds-border-strong)}.ds-scope-group[data-scope=task]{border-left-color:var(--ds-accent)}.ds-scope-group[data-scope=screen]{border-left-color:var(--ds-ok)}.ds-scope-group[data-scope=product]{border-left-style:dashed}.ds-scope-group__header{margin:0 0 10px;padding:0 2px}.ds-scope-group__header h2{margin:0 0 3px;color:var(--ds-fg);font-size:12px;font-weight:700;letter-spacing:.01em}.ds-scope-group__header p{margin:0;color:var(--ds-fg-faint);font-size:11px;line-height:1.45;text-wrap:pretty}.ds-block{margin-bottom:12px;padding:14px;border:1px solid var(--ds-border);border-radius:calc(var(--ds-r) + 2px);background:color-mix(in srgb,var(--ds-bg-input) 66%,transparent);box-shadow:0 1px 0 var(--ds-card-hairline)}.ds-inspector__body>.ds-block:first-child{padding:16px;border-color:color-mix(in srgb,var(--ds-accent) 30%,var(--ds-border));background:color-mix(in srgb,var(--ds-accent) 7%,var(--ds-bg-input))}.ds-block__title{margin:0 0 10px;color:var(--ds-fg-faint);font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.05em}.ds-block p{margin:0 0 9px;color:var(--ds-fg-dim);line-height:1.55;text-wrap:pretty}.ds-list{margin:0;padding:0;list-style:none;color:var(--ds-fg-dim)}.ds-list li{display:grid;grid-template-columns:12px minmax(0,1fr);gap:4px;margin-bottom:7px}.ds-list li:before{content:"•";color:var(--ds-fg-faint)}.ds-kv{display:grid;grid-template-columns:96px 1fr;gap:7px 12px;margin:0}.ds-kv dt{color:var(--ds-fg-faint);font-size:11px}.ds-kv dd{margin:0;overflow-wrap:anywhere}.ds-chips{display:flex;flex-wrap:wrap;gap:4px}.ds-chip{padding:2px 7px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-input);color:var(--ds-fg-dim);font-family:var(--ds-mono);font-size:11px}.ds-chip[data-tone=ok]{border-color:color-mix(in srgb,var(--ds-ok) 45%,transparent);color:var(--ds-ok)}.ds-chip[data-tone=warn]{border-color:color-mix(in srgb,var(--ds-warn) 45%,transparent);color:var(--ds-warn)}.ds-chip[data-tone=err]{border-color:color-mix(in srgb,var(--ds-err) 45%,transparent);color:var(--ds-err)}.ds-rule{margin-bottom:10px;padding:8px 10px;border:1px solid var(--ds-border);border-left:2px solid var(--ds-accent);border-radius:var(--ds-r);background:var(--ds-bg-input)}.ds-rule__id{display:block;margin-bottom:3px;color:var(--ds-fg-faint);font-family:var(--ds-mono);font-size:10px}.ds-rule__statement{color:var(--ds-fg)}.ds-rule__rationale{margin-top:4px;color:var(--ds-fg-dim);font-size:12px}.ds-contrast{width:100%;border-collapse:collapse;font-size:12px}.ds-contrast th,.ds-contrast td{padding:5px 6px;border-bottom:1px solid var(--ds-border);text-align:left}.ds-contrast th{color:var(--ds-fg-faint);font-size:10px;font-weight:600;text-transform:uppercase}.ds-contrast td:last-child{font-family:var(--ds-mono);font-variant-numeric:tabular-nums;text-align:right}.ds-swatch{display:inline-block;width:10px;height:10px;margin-right:5px;border:1px solid var(--ds-border-strong);border-radius:2px;vertical-align:-1px}.ds-note{padding:8px 10px;border:1px solid color-mix(in srgb,var(--ds-warn) 35%,transparent);border-radius:var(--ds-r);background:color-mix(in srgb,var(--ds-warn) 8%,transparent);color:var(--ds-fg-dim)}.ds-issue{margin-bottom:6px;padding:7px 9px;border-radius:var(--ds-r);background:var(--ds-bg-input);border-left:2px solid var(--ds-err)}.ds-issue[data-level=warning]{border-left-color:var(--ds-warn)}.ds-issue__where{display:block;color:var(--ds-fg-faint);font-family:var(--ds-mono);font-size:10px}@media(max-width:1100px){.ds-root,.ds-root[data-inspector=closed]{grid-template-columns:var(--ds-sidebar) 1fr;grid-template-areas:"topbar topbar" "sidebar stage"}.ds-root[data-inspector=open] .ds-inspector{position:fixed;top:var(--ds-topbar);right:0;bottom:0;z-index:30;width:min(var(--ds-inspector),90vw);box-shadow:var(--ds-drawer-shadow)}}@media(max-width:720px){.ds-root,.ds-root[data-inspector=closed],.ds-root[data-inspector=open]{grid-template-columns:1fr;grid-template-rows:var(--ds-topbar) minmax(160px,30vh) 1fr;grid-template-areas:"topbar" "sidebar" "stage"}.ds-sidebar{position:static;width:auto;border-right:0;border-bottom:1px solid var(--ds-border);box-shadow:none}}.ds-restore{position:fixed;right:10px;bottom:10px;z-index:50;padding:5px 10px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-raised);color:var(--ds-fg);font:inherit;font-size:12px;cursor:pointer;opacity:0;transition:opacity .12s ease}.ds-restore:hover,.ds-restore:focus-visible{opacity:1}.ds-visually-hidden{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}.ds-home{width:100%;max-width:980px;margin:0 auto;padding:32px 24px 56px;color:var(--ds-fg)}.ds-home__header h1{margin:0;font-size:24px;font-weight:700;letter-spacing:-.01em}.ds-home__view{margin:0 0 8px;color:var(--ds-fg-faint);font-size:11px;font-weight:700;letter-spacing:.06em;text-transform:uppercase}.ds-home__view-action{margin-top:4px}.ds-home__legend{margin-top:24px;padding-top:16px;border-top:1px solid var(--ds-border)}.ds-home__legend h2{margin:0 0 12px;color:var(--ds-fg-dim);font-size:12px;font-weight:700}.ds-home__legend ul{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px 24px;margin:0;padding:0;list-style:none}.ds-home__legend li{display:grid;grid-template-columns:8px 1fr;align-items:start;gap:9px;min-width:0}.ds-home__legend .ds-status-dot{margin-top:5px}.ds-home__legend li>span:last-child{display:grid;gap:2px}.ds-home__legend strong{color:var(--ds-fg);font-size:12px;font-weight:600}.ds-home__legend small{color:var(--ds-fg-faint);font-size:11px;line-height:1.45}.ds-home__tagline{margin:4px 0 0;color:var(--ds-fg-dim)}.ds-home__lead{max-width:68ch;margin:12px 0;color:var(--ds-fg-dim);font-size:14px}.ds-home__empty{max-width:68ch;margin:28px 0 0;padding:16px;border:1px dashed var(--ds-border-strong);border-radius:var(--ds-r-lg);color:var(--ds-fg-dim);font-size:14px}.ds-home__empty p{margin:0 0 8px}@media(max-width:720px){.ds-home__legend ul{grid-template-columns:1fr}}.ds-home__module{margin-top:36px;padding-top:20px;border-top:1px solid var(--ds-border)}.ds-home__module h2{margin:0 0 4px;font-size:16px;font-weight:600}.ds-home__hint{max-width:68ch;margin:0 0 14px;color:var(--ds-fg-faint);font-size:13px}.ds-home__grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(260px,1fr));gap:10px;margin:14px 0 0;padding:0;list-style:none}.ds-home__card{display:flex;flex-direction:column;gap:6px;width:100%;height:100%;padding:12px 14px;border:1px solid var(--ds-border);border-radius:var(--ds-r-lg);background:var(--ds-bg-raised);color:inherit;font:inherit;text-align:left;cursor:pointer;transition:border-color .12s ease,transform .12s ease}.ds-home__card:hover{border-color:var(--ds-accent);transform:translateY(-1px)}.ds-home__card-head{display:flex;align-items:center;gap:8px}.ds-home__card-title{font-weight:600}.ds-home__card-intent{color:var(--ds-fg-dim);font-size:12.5px}.ds-home__card-meta{margin-top:auto;color:var(--ds-fg-faint);font-size:11px}.ds-flow{margin:14px 0 6px;padding:14px 16px;border:1px solid var(--ds-border);border-left:2px solid var(--ds-accent);border-radius:var(--ds-r-lg);background:var(--ds-bg-input)}.ds-flow h3{margin:0 0 4px;font-size:13px;font-weight:600}.ds-flow__steps{margin:10px 0 0;padding-left:20px;color:var(--ds-fg-dim)}.ds-flow__steps>li{margin-bottom:10px}.ds-flow__step{padding:0;border:0;background:none;color:var(--ds-accent);font:inherit;text-align:left;text-decoration:underline;text-underline-offset:2px;cursor:pointer}.ds-flow__decision{margin:3px 0 0;color:var(--ds-fg-faint);font-size:12px;font-style:italic}.ds-flow__branches{margin:6px 0 0;padding-left:14px;list-style:none;border-left:1px dashed var(--ds-border-strong)}.ds-flow__branches li{margin-bottom:4px}.ds-flow__branch-label{margin-right:6px;color:var(--ds-fg-faint);font-size:11px}
|
|
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}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Protocolo entre o chrome e o quadro.
|
|
3
|
+
*
|
|
4
|
+
* A UI do produto roda dentro de um `<iframe>` da mesma origem e do mesmo
|
|
5
|
+
* bundle, aberto com `ds-frame=1`. Duas razões, as duas concretas:
|
|
6
|
+
*
|
|
7
|
+
* 1. **Isolamento de CSS nos dois sentidos.** O preflight e o `body` do produto
|
|
8
|
+
* não alcançam o chrome, e o chrome não alcança o produto.
|
|
9
|
+
* 2. **Viewport real.** A largura do quadro é a largura da janela que o produto
|
|
10
|
+
* enxerga, então `@media` funciona como em produção.
|
|
11
|
+
*
|
|
12
|
+
* Os dois documentos conversam só por `postMessage`, e cada lado só aceita
|
|
13
|
+
* mensagem da mesma origem **e** da janela esperada — o pai aceita do próprio
|
|
14
|
+
* quadro, o quadro aceita do próprio pai. Qualquer outra coisa é ignorada.
|
|
15
|
+
*/
|
|
16
|
+
/** Parâmetro que põe `<DesignSpace>` em modo quadro. */
|
|
17
|
+
export declare const FRAME_PARAM = "ds-frame";
|
|
18
|
+
/** Atributo do `<iframe>` do chrome. Serve de seletor para testes. */
|
|
19
|
+
export declare const FRAME_ATTRIBUTE = "data-ds-frame";
|
|
20
|
+
/**
|
|
21
|
+
* Parâmetros que só o chrome lê. Ficam fora do endereço do quadro: trocar zoom
|
|
22
|
+
* ou tema do chrome não é assunto da UI do produto.
|
|
23
|
+
*/
|
|
24
|
+
export declare const CHROME_ONLY_PARAMS: readonly string[];
|
|
25
|
+
/**
|
|
26
|
+
* Atalhos do chrome que o quadro repassa: revisão limpa (Shift+C), busca da
|
|
27
|
+
* lateral (Cmd/Ctrl+K) e filtro do painel (Cmd/Ctrl+F).
|
|
28
|
+
*/
|
|
29
|
+
export type FrameShortcut = "C" | "K" | "F";
|
|
30
|
+
export type FrameMessage =
|
|
31
|
+
/** Quadro → pai: montou, neste endereço. */
|
|
32
|
+
{
|
|
33
|
+
ds: 1;
|
|
34
|
+
type: "ready";
|
|
35
|
+
url: string;
|
|
36
|
+
}
|
|
37
|
+
/** Quadro → pai: a UI do produto navegou. */
|
|
38
|
+
| {
|
|
39
|
+
ds: 1;
|
|
40
|
+
type: "navigate";
|
|
41
|
+
url: string;
|
|
42
|
+
replace: boolean;
|
|
43
|
+
}
|
|
44
|
+
/** Quadro → pai: atalho do chrome pressionado com o foco dentro do quadro. */
|
|
45
|
+
| {
|
|
46
|
+
ds: 1;
|
|
47
|
+
type: "shortcut";
|
|
48
|
+
key: FrameShortcut;
|
|
49
|
+
}
|
|
50
|
+
/** Pai → quadro: novo estado, sem recarregar. */
|
|
51
|
+
| {
|
|
52
|
+
ds: 1;
|
|
53
|
+
type: "location";
|
|
54
|
+
url: string;
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Endereço do quadro para um estado do chrome: mesmo caminho, mesma query sem os
|
|
58
|
+
* parâmetros do chrome, e `ds-frame=1` no fim. Determinística: o pai e o quadro
|
|
59
|
+
* chegam à mesma string para o mesmo estado, e é isso que evita recarga à toa.
|
|
60
|
+
*/
|
|
61
|
+
export declare function toFrameUrl(path: string, search: string): string;
|
|
62
|
+
/** Caminho e query de um endereço do quadro, sem o parâmetro de modo. */
|
|
63
|
+
export declare function fromFrameUrl(url: string): {
|
|
64
|
+
path: string;
|
|
65
|
+
search: string;
|
|
66
|
+
};
|
|
67
|
+
/**
|
|
68
|
+
* O que obriga a trocar o `src` do quadro: outra tela (caminho) ou outro
|
|
69
|
+
* componente. O resto — variação, persona, rede, dados — vai por mensagem.
|
|
70
|
+
*/
|
|
71
|
+
export declare function frameKey(url: string): string;
|
|
72
|
+
/**
|
|
73
|
+
* Query do quadro com os parâmetros do chrome que estavam no pai. Uma navegação
|
|
74
|
+
* iniciada pelo produto não pode desligar o painel nem trocar o zoom.
|
|
75
|
+
*/
|
|
76
|
+
export declare function mergeChromeParams(frameSearch: string, parentSearch: string): string;
|
|
77
|
+
/**
|
|
78
|
+
* Aceita uma mensagem só quando vem da mesma origem e da janela esperada, e tem
|
|
79
|
+
* a forma do protocolo. Qualquer outra — extensão, outro iframe, outra aba —
|
|
80
|
+
* devolve `undefined`.
|
|
81
|
+
*/
|
|
82
|
+
export declare function acceptFrameMessage(event: Pick<MessageEvent, "origin" | "source" | "data">, expected: {
|
|
83
|
+
origin: string;
|
|
84
|
+
source: MessageEventSource | null | undefined;
|
|
85
|
+
}): FrameMessage | undefined;
|
|
86
|
+
/** Envia para a outra janela, sempre restrito à própria origem. */
|
|
87
|
+
export declare function postFrameMessage(target: Window | null | undefined, message: FrameMessage, origin: string): void;
|
|
88
|
+
/**
|
|
89
|
+
* `true` quando este documento é o quadro: pedido pela URL ou carregado dentro
|
|
90
|
+
* do `<iframe>` do chrome. O segundo caso cobre uma navegação completa dentro do
|
|
91
|
+
* quadro que perdeu o parâmetro — sem ele, o chrome renderizaria dentro de si.
|
|
92
|
+
*/
|
|
93
|
+
export declare function isFrameMode(win?: Window | undefined): boolean;
|
package/dist/handoff/index.d.ts
CHANGED
|
@@ -14,7 +14,8 @@ export declare function normalizeHandoffScope(scope: HandoffScope): HandoffScope
|
|
|
14
14
|
export declare function handoffAllowsScenario(scope: HandoffScope | undefined, scenarioId: string | undefined): boolean;
|
|
15
15
|
export declare function handoffAllowsComponent(scope: HandoffScope | undefined, componentId: string | undefined): boolean;
|
|
16
16
|
/**
|
|
17
|
-
* A raiz é sempre permitida
|
|
18
|
-
* uma rota precisa estar explícita ou pertencer a um
|
|
17
|
+
* A raiz é sempre permitida: o chrome a redireciona para o primeiro item do
|
|
18
|
+
* recorte. Fora dela, uma rota precisa estar explícita ou pertencer a um
|
|
19
|
+
* cenário permitido.
|
|
19
20
|
*/
|
|
20
21
|
export declare function handoffAllowsPath(scope: HandoffScope | undefined, path: string, scenarios?: readonly Scenario[]): boolean;
|