@brucesantos/design-space 0.11.0 → 0.13.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 +70 -0
- package/README.md +57 -1
- package/dist/devtools-hook.d.ts +9 -0
- package/dist/devtools-hook.js +3 -0
- package/dist/devtools-hook.js.map +1 -0
- package/dist/fiber/hook.d.ts +38 -0
- package/dist/fiber/read.d.ts +8 -0
- package/dist/fiber/tree.d.ts +33 -0
- package/dist/frame/index.d.ts +23 -3
- package/dist/hook-CeXcli-1.js +64 -0
- package/dist/hook-CeXcli-1.js.map +1 -0
- package/dist/{index-Dv-W-bL0.js → index-CLox5DuH.js} +231 -215
- package/dist/index-CLox5DuH.js.map +1 -0
- package/dist/index.js +1421 -1283
- package/dist/index.js.map +1 -1
- package/dist/shell/Canvas.d.ts +4 -1
- package/dist/shell/Highlight.d.ts +5 -3
- package/dist/shell/Topbar.d.ts +3 -1
- package/dist/shell/icons.d.ts +1 -1
- package/dist/shell/labels.d.ts +2 -0
- package/dist/testing.js +1 -1
- package/dist/types/index.d.ts +11 -1
- package/package.json +7 -2
- package/dist/index-Dv-W-bL0.js.map +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,76 @@ 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.13.0 (2026-10-15)
|
|
10
|
+
|
|
11
|
+
**Minor.** Um campo opcional em `ComponentPreview` e um entrypoint novo; nenhum
|
|
12
|
+
export, parâmetro ou comportamento existente muda. Ver
|
|
13
|
+
[0017](../../docs/decisions/0017-destaque-automatico-pela-arvore-do-react.md),
|
|
14
|
+
que emenda a [0016](../../docs/decisions/0016-destaque-de-componentes.md).
|
|
15
|
+
|
|
16
|
+
### Adicionado
|
|
17
|
+
|
|
18
|
+
- **Destaque automático.** "Destacar componentes" acha sozinho, pela árvore do
|
|
19
|
+
React, as instâncias dos componentes do catálogo, sem marcação no JSX. O
|
|
20
|
+
casamento é pela referência da função (desembrulhando `memo` e `forwardRef`;
|
|
21
|
+
`lazy` casa pelo original), então vale no build minificado. Contorna o
|
|
22
|
+
primeiro nó de DOM do componente, ou a união dos nós de topo num fragment;
|
|
23
|
+
aninhados aparecem os dois; componentes que caem nos mesmos nós viram um
|
|
24
|
+
contorno com os nomes juntos (`Primário · Botão`).
|
|
25
|
+
- **`ComponentPreview.implementation`**: o componente React real que a entrada
|
|
26
|
+
cataloga, ou uma lista deles. A validação acusa erro quando o valor não é
|
|
27
|
+
componente (um nome em texto, por exemplo).
|
|
28
|
+
- **`@brucesantos/design-space/devtools-hook`**: entrypoint sem React que
|
|
29
|
+
instala o gancho do React DevTools, ou encadeia no da extensão quando ela está
|
|
30
|
+
aberta. Precisa ser o primeiro import do ponto de entrada.
|
|
31
|
+
|
|
32
|
+
### Sem mudança
|
|
33
|
+
|
|
34
|
+
- `data-ds-component` continua valendo, como marcação manual para o que a
|
|
35
|
+
árvore não resolve. No mesmo nó que a árvore achou, junta-se ao contorno
|
|
36
|
+
existente em vez de duplicá-lo.
|
|
37
|
+
- Sem o import do gancho, ou com uma árvore que o motor não reconhece, o
|
|
38
|
+
destaque se comporta como na 0.11 — só a marcação manual — e avisa uma vez no
|
|
39
|
+
console.
|
|
40
|
+
|
|
41
|
+
### Migração
|
|
42
|
+
|
|
43
|
+
Nenhuma obrigatória. Para o destaque automático:
|
|
44
|
+
|
|
45
|
+
1. Na primeira linha do ponto de entrada (`src/main.tsx`), antes de qualquer
|
|
46
|
+
import de React: `import "@brucesantos/design-space/devtools-hook";`.
|
|
47
|
+
2. Em cada entrada do catálogo, `implementation: <componente real>`.
|
|
48
|
+
3. Opcional: remover os `data-ds-component` que o catálogo agora cobre.
|
|
49
|
+
|
|
50
|
+
## 0.12.0 (2026-10-11)
|
|
51
|
+
|
|
52
|
+
**Minor.** Botão novo no chrome e um rótulo novo em `Labels`; nenhum export,
|
|
53
|
+
parâmetro ou comportamento existente muda.
|
|
54
|
+
|
|
55
|
+
### Adicionado
|
|
56
|
+
|
|
57
|
+
- **"Abrir em nova janela" na barra superior**, ao lado da revisão limpa. Abre
|
|
58
|
+
numa aba nova o quadro sozinho (`ds-frame=1`), sem chrome e sem `<iframe>`, no
|
|
59
|
+
endereço que o quadro está mostrando — inclusive depois de a UI do produto
|
|
60
|
+
navegar dentro dele. Os parâmetros só do chrome e o viewport ficam de fora
|
|
61
|
+
(a largura é a da janela nova, em "Ajustar"); cenário, persona, fixture,
|
|
62
|
+
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,
|
|
63
|
+
como as extensões que levam HTML para o Figma: com `chrome=0` a UI continua
|
|
64
|
+
dentro do `<iframe>`, e a captura vê um bloco só.
|
|
65
|
+
- Rótulo `topbar.openFrame` ("Abrir em nova janela" / "Open in new window"),
|
|
66
|
+
sobrescrevível por `theme.labels` como os demais.
|
|
67
|
+
|
|
68
|
+
### Sem mudança
|
|
69
|
+
|
|
70
|
+
- `chrome=0` continua escondendo o chrome com a UI dentro do
|
|
71
|
+
`<iframe data-ds-frame>`.
|
|
72
|
+
|
|
73
|
+
### Migração
|
|
74
|
+
|
|
75
|
+
- Produto que declara `Labels` inteiro (em vez de override parcial) precisa
|
|
76
|
+
incluir `topbar.openFrame`. Quem usa `theme.labels` parcial ou
|
|
77
|
+
`EN_US_LABELS` não faz nada.
|
|
78
|
+
|
|
9
79
|
## 0.11.0 (2026-10-09)
|
|
10
80
|
|
|
11
81
|
**Minor.** Funcionalidade compatível: um parâmetro de URL, um campo opcional em
|
package/README.md
CHANGED
|
@@ -18,6 +18,12 @@ pnpm add @brucesantos/design-space
|
|
|
18
18
|
|
|
19
19
|
O produto entrega uma `ProductDefinition` e monta um único componente.
|
|
20
20
|
|
|
21
|
+
```tsx
|
|
22
|
+
// main.tsx — primeira linha, antes de qualquer import de React (ver
|
|
23
|
+
// "Destacar componentes").
|
|
24
|
+
import "@brucesantos/design-space/devtools-hook";
|
|
25
|
+
```
|
|
26
|
+
|
|
21
27
|
```tsx
|
|
22
28
|
import { DesignSpace } from "@brucesantos/design-space";
|
|
23
29
|
import "@brucesantos/design-space/styles.css";
|
|
@@ -230,7 +236,7 @@ painel continuam vencendo. Id inexistente é erro de validação. Sem
|
|
|
230
236
|
|
|
231
237
|
| Região | Conteúdo |
|
|
232
238
|
| --- | --- |
|
|
233
|
-
| Barra superior | Nome do produto; viewport (Celular 375, Tablet 768, Desktop 1280, Ajustar), girar, zoom 25–150%,
|
|
239
|
+
| 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
240
|
| 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
241
|
| Centro | O quadro do produto no tamanho do viewport, com zoom só de visualização. |
|
|
236
242
|
| 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 +261,49 @@ entrada no histórico. Navegação feita pela UI do produto (`context.navigate`,
|
|
|
255
261
|
`openScenario` ou um link comum) volta para a URL do chrome. Os dois lados só
|
|
256
262
|
aceitam mensagem da mesma origem e da janela esperada.
|
|
257
263
|
|
|
264
|
+
### Abrir em nova janela
|
|
265
|
+
|
|
266
|
+
O botão ao lado da revisão limpa abre o quadro sozinho, numa aba nova: o mesmo
|
|
267
|
+
endereço com `ds-frame=1`, sem chrome e sem `<iframe>`. É o caminho para
|
|
268
|
+
ferramenta de captura que lê só o documento de cima — como as extensões que
|
|
269
|
+
levam HTML para o Figma. `chrome=0` não serve para isso: ele esconde o chrome,
|
|
270
|
+
mas a UI continua dentro do `<iframe>`, e a ferramenta enxerga um bloco só.
|
|
271
|
+
|
|
272
|
+
O endereço é o que o quadro está mostrando, inclusive depois de o produto
|
|
273
|
+
navegar dentro dele. Cenário, persona, fixture, rede, controles e query da tela,
|
|
274
|
+
tema, idioma e handoff vão junto; os parâmetros só do chrome (`appearance`,
|
|
275
|
+
`chrome`, `panel`, `tab`, `zoom`, `rotate`) ficam de fora. O viewport (`viewport`,
|
|
276
|
+
`w`) também fica: a largura é a da janela nova, e o quadro abre em "Ajustar",
|
|
277
|
+
então `context.viewport` e `@media` concordam. Para capturar a tela de celular,
|
|
278
|
+
estreite a janela. Sem janela pai, o quadro funciona sozinho; só os atalhos do
|
|
279
|
+
chrome deixam de existir.
|
|
280
|
+
|
|
281
|
+
### Destacar componentes
|
|
282
|
+
|
|
283
|
+
O botão no centro da barra (`?highlight=1`) contorna, dentro do quadro, cada
|
|
284
|
+
componente do catálogo que aparece na tela, com o nome dele. Serve à avaliação
|
|
285
|
+
de design: o que fica sem contorno ainda não é componente.
|
|
286
|
+
|
|
287
|
+
O motor acha os componentes sozinho, pela árvore do React, casando cada
|
|
288
|
+
instância com o `implementation` das entradas do catálogo — pela referência da
|
|
289
|
+
função, não pelo nome, então vale no build minificado. Para isso, o ponto de
|
|
290
|
+
entrada importa `@brucesantos/design-space/devtools-hook` **antes** de qualquer
|
|
291
|
+
import de React: o React só procura o gancho do DevTools quando o `react-dom`
|
|
292
|
+
carrega. Com o React DevTools aberto, o gancho dele é respeitado.
|
|
293
|
+
|
|
294
|
+
- Contorna o primeiro nó de DOM que o componente renderiza, ou a união dos nós
|
|
295
|
+
de topo quando ele devolve fragment. Aninhados aparecem os dois.
|
|
296
|
+
- Componentes que caem nos mesmos nós — um wrapper que só repassa — viram um
|
|
297
|
+
contorno só, com os nomes juntos.
|
|
298
|
+
- `data-ds-component="<id do catálogo>"` (`COMPONENT_ATTRIBUTE`) continua
|
|
299
|
+
valendo como marcação manual, para o que a árvore não resolve. No mesmo nó
|
|
300
|
+
que a árvore já achou, não duplica: o id se junta ao contorno existente. Id
|
|
301
|
+
fora do catálogo aparece tracejado.
|
|
302
|
+
- Sem o import, ou se uma versão do React mudar a forma da árvore, o destaque
|
|
303
|
+
fica só com a marcação manual e avisa uma vez no console.
|
|
304
|
+
|
|
305
|
+
Ver [0017](../../docs/decisions/0017-destaque-automatico-pela-arvore-do-react.md).
|
|
306
|
+
|
|
258
307
|
### Navegação
|
|
259
308
|
|
|
260
309
|
`context.navigate(to, options?)` — e um link comum dentro do quadro — segue duas
|
|
@@ -304,6 +353,7 @@ rede declarados no cenário.
|
|
|
304
353
|
| `theme`, `locale`, `source` | Variações declaradas pelo produto. |
|
|
305
354
|
| `appearance` | Tema do chrome, `light` ou `dark`. Omitido: última escolha ou o sistema. |
|
|
306
355
|
| `chrome=0` | Revisão limpa: oculta o chrome do ambiente. |
|
|
356
|
+
| `highlight=1` | Destaca os componentes do catálogo na tela. |
|
|
307
357
|
| `panel=0` | Oculta o painel direito. |
|
|
308
358
|
| `tab=info` | Abre o painel direito em Informações. |
|
|
309
359
|
| `handoff=1` | Ativa um recorte explícito de revisão/handoff. |
|
|
@@ -474,6 +524,9 @@ um componente são as `fixtures` dele; `source` diz de onde ele vem no sistema
|
|
|
474
524
|
real.
|
|
475
525
|
|
|
476
526
|
```tsx
|
|
527
|
+
// O mesmo componente que as telas importam.
|
|
528
|
+
import { PrimaryButton } from "./components/PrimaryButton";
|
|
529
|
+
|
|
477
530
|
type ButtonData = {
|
|
478
531
|
label: string;
|
|
479
532
|
disabled?: boolean;
|
|
@@ -502,6 +555,9 @@ const product: ProductDefinition = {
|
|
|
502
555
|
group: "Ações",
|
|
503
556
|
description: "Ação principal da página",
|
|
504
557
|
source: "components/button.ex → button/1",
|
|
558
|
+
// O componente real que as telas usam; é por ele que o destaque acha
|
|
559
|
+
// cada instância na tela. Aceita memo, forwardRef, lazy ou uma lista.
|
|
560
|
+
implementation: PrimaryButton,
|
|
505
561
|
preview: PrimaryButtonPreview,
|
|
506
562
|
defaultFixture: "default",
|
|
507
563
|
fixtures: [
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Entrypoint `@brucesantos/design-space/devtools-hook`.
|
|
3
|
+
*
|
|
4
|
+
* Instala o gancho do React DevTools antes de o `react-dom` carregar, para o
|
|
5
|
+
* "Destacar componentes" encontrar sozinho os componentes do catálogo. Precisa
|
|
6
|
+
* ser o primeiro `import` do ponto de entrada do produto; sem ele, o destaque
|
|
7
|
+
* contorna só a marcação manual `data-ds-component`. Ver a decisão 0017.
|
|
8
|
+
*/
|
|
9
|
+
export {};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"devtools-hook.js","sources":["../src/devtools-hook.ts"],"sourcesContent":["/**\n * Entrypoint `@brucesantos/design-space/devtools-hook`.\n *\n * Instala o gancho do React DevTools antes de o `react-dom` carregar, para o\n * \"Destacar componentes\" encontrar sozinho os componentes do catálogo. Precisa\n * ser o primeiro `import` do ponto de entrada do produto; sem ele, o destaque\n * contorna só a marcação manual `data-ds-component`. Ver a decisão 0017.\n */\n\nimport { installDevtoolsHook } from \"./fiber/hook.js\";\n\ninstallDevtoolsHook();\n"],"names":["installDevtoolsHook"],"mappings":";AAWAA,EAAA;"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Gancho do React DevTools, reduzido ao que o destaque de componentes precisa:
|
|
3
|
+
* saber quais raízes de React existem nesta janela e quando elas fazem commit.
|
|
4
|
+
*
|
|
5
|
+
* O React procura `__REACT_DEVTOOLS_GLOBAL_HOOK__` **uma vez**, quando o
|
|
6
|
+
* `react-dom` é avaliado. Gancho instalado depois disso não recebe nada. Por
|
|
7
|
+
* isso a instalação mora num entrypoint próprio, sem nenhum `import` de React,
|
|
8
|
+
* que o produto importa na primeira linha do ponto de entrada:
|
|
9
|
+
*
|
|
10
|
+
* ```ts
|
|
11
|
+
* import "@brucesantos/design-space/devtools-hook";
|
|
12
|
+
* ```
|
|
13
|
+
*
|
|
14
|
+
* Com o React DevTools aberto, o gancho já existe — a extensão instala antes de
|
|
15
|
+
* qualquer script da página. Nesse caso nada é trocado: o callback de commit da
|
|
16
|
+
* extensão é encadeado, chamado primeiro, e o destaque só observa.
|
|
17
|
+
*
|
|
18
|
+
* Este arquivo não pode importar React nem nada que importe React.
|
|
19
|
+
*/
|
|
20
|
+
/** Raiz de React como o gancho a recebe (`FiberRoot`). Forma não contratual. */
|
|
21
|
+
export type FiberRoot = {
|
|
22
|
+
current?: unknown;
|
|
23
|
+
containerInfo?: unknown;
|
|
24
|
+
};
|
|
25
|
+
/**
|
|
26
|
+
* Instala o gancho mínimo, ou encadeia no que já existe. Idempotente: o estado
|
|
27
|
+
* fica na própria janela, porque este entrypoint e o bundle principal são
|
|
28
|
+
* arquivos diferentes e cada um teria a sua cópia do módulo.
|
|
29
|
+
*/
|
|
30
|
+
export declare function installDevtoolsHook(win?: Window | undefined): void;
|
|
31
|
+
/**
|
|
32
|
+
* Raízes de React conhecidas nesta janela, ou `undefined` quando nenhuma chegou
|
|
33
|
+
* por gancho — o `react-dom` carregou antes da instalação. Quem chama já está
|
|
34
|
+
* dentro de uma árvore de React, então "nenhuma raiz" quer dizer isso.
|
|
35
|
+
*/
|
|
36
|
+
export declare function readFiberRoots(win?: Window): FiberRoot[] | undefined;
|
|
37
|
+
/** Avisa a cada commit de qualquer raiz. Devolve a função que desinscreve. */
|
|
38
|
+
export declare function subscribeCommits(listener: () => void, win?: Window): () => void;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { CataloguedNode, ImplementationIndex } from './tree.js';
|
|
2
|
+
/** Para testes: permite ver o aviso de novo. */
|
|
3
|
+
export declare function resetReadWarning(): void;
|
|
4
|
+
/**
|
|
5
|
+
* Instâncias catalogadas pela árvore do React. Vazio — com aviso — quando o
|
|
6
|
+
* catálogo declara `implementation` e a árvore não pode ser lida.
|
|
7
|
+
*/
|
|
8
|
+
export declare function readCatalogued(index: ImplementationIndex, win: Window): CataloguedNode[];
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { FiberRoot } from './hook.js';
|
|
2
|
+
/** A árvore não tem a forma que este arquivo conhece. */
|
|
3
|
+
export declare class FiberShapeError extends Error {
|
|
4
|
+
}
|
|
5
|
+
/**
|
|
6
|
+
* A referência e tudo o que ela embrulha: `memo(forwardRef(render))` devolve o
|
|
7
|
+
* `memo`, o `forwardRef` e `render`. `lazy` fica como está: depois de
|
|
8
|
+
* resolvido, o fiber guarda o componente em `type` e o `lazy` em `elementType`,
|
|
9
|
+
* e os dois lados são consultados.
|
|
10
|
+
*/
|
|
11
|
+
export declare function unwrapComponent(reference: unknown): unknown[];
|
|
12
|
+
/** Referência de componente → ids do catálogo que a declaram. */
|
|
13
|
+
export type ImplementationIndex = Map<unknown, string[]>;
|
|
14
|
+
export declare function indexImplementations(components: readonly {
|
|
15
|
+
id: string;
|
|
16
|
+
implementation?: unknown;
|
|
17
|
+
}[]): ImplementationIndex;
|
|
18
|
+
/** Ids do catálogo a que o fiber corresponde, na ordem do catálogo. */
|
|
19
|
+
export declare function matchFiber(fiber: {
|
|
20
|
+
type?: unknown;
|
|
21
|
+
elementType?: unknown;
|
|
22
|
+
}, index: ImplementationIndex): string[];
|
|
23
|
+
/** Uma instância de componente catalogado na tela. */
|
|
24
|
+
export type CataloguedNode = {
|
|
25
|
+
ids: string[];
|
|
26
|
+
/** Nós de DOM de topo que a instância renderiza; mais de um em fragment. */
|
|
27
|
+
elements: Element[];
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* Instâncias de componente catalogado, em ordem de árvore — o de fora antes do
|
|
31
|
+
* de dentro. Lança {@link FiberShapeError} se a árvore não for reconhecida.
|
|
32
|
+
*/
|
|
33
|
+
export declare function findCatalogued(roots: readonly FiberRoot[], index: ImplementationIndex): CataloguedNode[];
|
package/dist/frame/index.d.ts
CHANGED
|
@@ -18,9 +18,10 @@ 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
20
|
/**
|
|
21
|
-
*
|
|
22
|
-
* `data-ds-component="<id do catálogo>"`.
|
|
23
|
-
*
|
|
21
|
+
* Marcação manual da raiz de um componente na UI:
|
|
22
|
+
* `data-ds-component="<id do catálogo>"`. O destaque de componentes acha
|
|
23
|
+
* sozinho o que o catálogo declara em `implementation`; este atributo fica para
|
|
24
|
+
* o que a árvore do React não resolve (decisão 0017).
|
|
24
25
|
*/
|
|
25
26
|
export declare const COMPONENT_ATTRIBUTE = "data-ds-component";
|
|
26
27
|
/**
|
|
@@ -65,6 +66,25 @@ export type FrameMessage =
|
|
|
65
66
|
* chegam à mesma string para o mesmo estado, e é isso que evita recarga à toa.
|
|
66
67
|
*/
|
|
67
68
|
export declare function toFrameUrl(path: string, search: string): string;
|
|
69
|
+
/**
|
|
70
|
+
* Endereço para abrir o quadro sozinho, numa janela própria. É o caminho para
|
|
71
|
+
* ferramenta de captura que lê só o documento de cima e não entra no `<iframe>`.
|
|
72
|
+
*
|
|
73
|
+
* Parte do endereço que o quadro está mostrando de fato (`frameHref`), porque a
|
|
74
|
+
* UI do produto pode ter navegado dentro dele; sem esse endereço — quadro ainda
|
|
75
|
+
* em `about:blank`, em outra origem ou inacessível —, parte do estado do pai.
|
|
76
|
+
* Nos dois casos sai pelo `toFrameUrl`: sem os parâmetros do chrome e com
|
|
77
|
+
* `ds-frame=1`, mesmo que uma navegação completa do quadro o tenha perdido.
|
|
78
|
+
*
|
|
79
|
+
* O viewport também fica de fora. Na janela própria a largura é a da janela, e
|
|
80
|
+
* sem o parâmetro o quadro cai em "Ajustar": `context.viewport` e `@media`
|
|
81
|
+
* contam a mesma história. Com `viewport=mobile` numa janela larga, a tela que
|
|
82
|
+
* decide pelo contexto mostraria celular esticado.
|
|
83
|
+
*/
|
|
84
|
+
export declare function standaloneFrameUrl(frameHref: string | undefined, origin: string, fallback: {
|
|
85
|
+
path: string;
|
|
86
|
+
search: string;
|
|
87
|
+
}): string;
|
|
68
88
|
/** Caminho e query de um endereço do quadro, sem o parâmetro de modo. */
|
|
69
89
|
export declare function fromFrameUrl(url: string): {
|
|
70
90
|
path: string;
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
function d(n = typeof window > "u" ? void 0 : window) {
|
|
2
|
+
const t = n;
|
|
3
|
+
if (!t || t.__DS_REACT_TREE__) return;
|
|
4
|
+
const o = { roots: /* @__PURE__ */ new Set(), listeners: /* @__PURE__ */ new Set() };
|
|
5
|
+
t.__DS_REACT_TREE__ = o;
|
|
6
|
+
let e = t.__REACT_DEVTOOLS_GLOBAL_HOOK__;
|
|
7
|
+
if (!e) {
|
|
8
|
+
const r = /* @__PURE__ */ new Map();
|
|
9
|
+
e = {
|
|
10
|
+
renderers: r,
|
|
11
|
+
supportsFiber: !0,
|
|
12
|
+
inject(s) {
|
|
13
|
+
const i = r.size + 1;
|
|
14
|
+
return r.set(i, s), i;
|
|
15
|
+
},
|
|
16
|
+
onCommitFiberUnmount() {
|
|
17
|
+
},
|
|
18
|
+
onPostCommitFiberRoot() {
|
|
19
|
+
},
|
|
20
|
+
// O `react-dom` de produção chama `checkDCE(fn)` para o DevTools avisar de
|
|
21
|
+
// build sem eliminação de código morto. Aqui não há o que avisar.
|
|
22
|
+
checkDCE() {
|
|
23
|
+
},
|
|
24
|
+
getFiberRoots: () => o.roots
|
|
25
|
+
}, t.__REACT_DEVTOOLS_GLOBAL_HOOK__ = e;
|
|
26
|
+
}
|
|
27
|
+
const _ = e.onCommitFiberRoot;
|
|
28
|
+
try {
|
|
29
|
+
e.onCommitFiberRoot = function(r, s, ...i) {
|
|
30
|
+
try {
|
|
31
|
+
_?.call(this, r, s, ...i);
|
|
32
|
+
} finally {
|
|
33
|
+
try {
|
|
34
|
+
c(o, s);
|
|
35
|
+
} catch {
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
} catch {
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
function c(n, t) {
|
|
43
|
+
const o = t?.current;
|
|
44
|
+
o && o.child == null ? n.roots.delete(t) : n.roots.add(t);
|
|
45
|
+
for (const e of n.listeners) e();
|
|
46
|
+
}
|
|
47
|
+
function f(n = window) {
|
|
48
|
+
const t = n, o = t.__REACT_DEVTOOLS_GLOBAL_HOOK__, e = new Set(t.__DS_REACT_TREE__?.roots ?? []);
|
|
49
|
+
if (o && o.renderers instanceof Map && typeof o.getFiberRoots == "function")
|
|
50
|
+
for (const _ of o.renderers.keys())
|
|
51
|
+
for (const r of o.getFiberRoots(_) ?? []) e.add(r);
|
|
52
|
+
return e.size > 0 ? [...e] : void 0;
|
|
53
|
+
}
|
|
54
|
+
function u(n, t = window) {
|
|
55
|
+
const o = t.__DS_REACT_TREE__;
|
|
56
|
+
return o ? (o.listeners.add(n), () => o.listeners.delete(n)) : () => {
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
export {
|
|
60
|
+
d as i,
|
|
61
|
+
f as r,
|
|
62
|
+
u as s
|
|
63
|
+
};
|
|
64
|
+
//# sourceMappingURL=hook-CeXcli-1.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hook-CeXcli-1.js","sources":["../src/fiber/hook.ts"],"sourcesContent":["/**\n * Gancho do React DevTools, reduzido ao que o destaque de componentes precisa:\n * saber quais raízes de React existem nesta janela e quando elas fazem commit.\n *\n * O React procura `__REACT_DEVTOOLS_GLOBAL_HOOK__` **uma vez**, quando o\n * `react-dom` é avaliado. Gancho instalado depois disso não recebe nada. Por\n * isso a instalação mora num entrypoint próprio, sem nenhum `import` de React,\n * que o produto importa na primeira linha do ponto de entrada:\n *\n * ```ts\n * import \"@brucesantos/design-space/devtools-hook\";\n * ```\n *\n * Com o React DevTools aberto, o gancho já existe — a extensão instala antes de\n * qualquer script da página. Nesse caso nada é trocado: o callback de commit da\n * extensão é encadeado, chamado primeiro, e o destaque só observa.\n *\n * Este arquivo não pode importar React nem nada que importe React.\n */\n\n/** Raiz de React como o gancho a recebe (`FiberRoot`). Forma não contratual. */\nexport type FiberRoot = { current?: unknown; containerInfo?: unknown };\n\ntype DevtoolsHook = {\n renderers?: Map<number, unknown>;\n supportsFiber?: boolean;\n inject?: (renderer: unknown) => number;\n onCommitFiberRoot?: (rendererId: number, root: FiberRoot, ...rest: unknown[]) => void;\n onCommitFiberUnmount?: (...args: unknown[]) => void;\n onPostCommitFiberRoot?: (...args: unknown[]) => void;\n checkDCE?: (...args: unknown[]) => void;\n getFiberRoots?: (rendererId: number) => Set<FiberRoot>;\n};\n\ntype Tracker = {\n roots: Set<FiberRoot>;\n listeners: Set<() => void>;\n};\n\ntype HookWindow = Window & {\n __REACT_DEVTOOLS_GLOBAL_HOOK__?: DevtoolsHook;\n __DS_REACT_TREE__?: Tracker;\n};\n\n/**\n * Instala o gancho mínimo, ou encadeia no que já existe. Idempotente: o estado\n * fica na própria janela, porque este entrypoint e o bundle principal são\n * arquivos diferentes e cada um teria a sua cópia do módulo.\n */\nexport function installDevtoolsHook(win: Window | undefined = typeof window === \"undefined\" ? undefined : window): void {\n const target = win as HookWindow | undefined;\n if (!target || target.__DS_REACT_TREE__) return;\n const tracker: Tracker = { roots: new Set(), listeners: new Set() };\n target.__DS_REACT_TREE__ = tracker;\n\n let hook = target.__REACT_DEVTOOLS_GLOBAL_HOOK__;\n if (!hook) {\n const renderers = new Map<number, unknown>();\n hook = {\n renderers,\n supportsFiber: true,\n inject(renderer) {\n const id = renderers.size + 1;\n renderers.set(id, renderer);\n return id;\n },\n onCommitFiberUnmount() {},\n onPostCommitFiberRoot() {},\n // O `react-dom` de produção chama `checkDCE(fn)` para o DevTools avisar de\n // build sem eliminação de código morto. Aqui não há o que avisar.\n checkDCE() {},\n getFiberRoots: () => tracker.roots,\n };\n target.__REACT_DEVTOOLS_GLOBAL_HOOK__ = hook;\n }\n\n const previous = hook.onCommitFiberRoot;\n try {\n hook.onCommitFiberRoot = function (this: unknown, rendererId, root, ...rest) {\n // O DevTools primeiro; o destaque nunca pode quebrar o commit dele.\n try {\n previous?.call(this, rendererId, root, ...rest);\n } finally {\n try {\n track(tracker, root);\n } catch {\n // Forma de raiz desconhecida: quem lê decide o que fazer.\n }\n }\n };\n } catch {\n // Gancho congelado: sem notificação de commit, as raízes ainda vêm de\n // `getFiberRoots` quando o gancho as expõe.\n }\n}\n\nfunction track(tracker: Tracker, root: FiberRoot): void {\n // Raiz desmontada faz um último commit sem filhos.\n const current = root?.current as { child?: unknown } | undefined;\n if (current && current.child == null) tracker.roots.delete(root);\n else tracker.roots.add(root);\n for (const listener of tracker.listeners) listener();\n}\n\n/**\n * Raízes de React conhecidas nesta janela, ou `undefined` quando nenhuma chegou\n * por gancho — o `react-dom` carregou antes da instalação. Quem chama já está\n * dentro de uma árvore de React, então \"nenhuma raiz\" quer dizer isso.\n */\nexport function readFiberRoots(win: Window = window): FiberRoot[] | undefined {\n const target = win as HookWindow;\n const hook = target.__REACT_DEVTOOLS_GLOBAL_HOOK__;\n const roots = new Set<FiberRoot>(target.__DS_REACT_TREE__?.roots ?? []);\n // Com o DevTools real, as raízes que fizeram commit antes de o destaque\n // encadear o callback só existem no registro dele. O gancho do React Refresh\n // (Vite e afins em desenvolvimento) não preenche `renderers` nem tem\n // `getFiberRoots`; ali as raízes vêm só do callback encadeado.\n if (hook && hook.renderers instanceof Map && typeof hook.getFiberRoots === \"function\") {\n for (const id of hook.renderers.keys()) {\n for (const root of hook.getFiberRoots(id) ?? []) roots.add(root);\n }\n }\n return roots.size > 0 ? [...roots] : undefined;\n}\n\n/** Avisa a cada commit de qualquer raiz. Devolve a função que desinscreve. */\nexport function subscribeCommits(listener: () => void, win: Window = window): () => void {\n const tracker = (win as HookWindow).__DS_REACT_TREE__;\n if (!tracker) return () => {};\n tracker.listeners.add(listener);\n return () => tracker.listeners.delete(listener);\n}\n"],"names":["installDevtoolsHook","win","target","tracker","hook","renderers","renderer","id","previous","rendererId","root","rest","track","current","listener","readFiberRoots","roots","subscribeCommits"],"mappings":"AAiDO,SAASA,EAAoBC,IAA0B,OAAO,SAAW,MAAc,SAAY,QAAc;AACtH,QAAMC,IAASD;AACf,MAAI,CAACC,KAAUA,EAAO,kBAAmB;AACzC,QAAMC,IAAmB,EAAE,OAAO,oBAAI,OAAO,WAAW,oBAAI,MAAI;AAChE,EAAAD,EAAO,oBAAoBC;AAE3B,MAAIC,IAAOF,EAAO;AAClB,MAAI,CAACE,GAAM;AACT,UAAMC,wBAAgB,IAAA;AACtB,IAAAD,IAAO;AAAA,MACL,WAAAC;AAAA,MACA,eAAe;AAAA,MACf,OAAOC,GAAU;AACf,cAAMC,IAAKF,EAAU,OAAO;AAC5B,eAAAA,EAAU,IAAIE,GAAID,CAAQ,GACnBC;AAAA,MACT;AAAA,MACA,uBAAuB;AAAA,MAAC;AAAA,MACxB,wBAAwB;AAAA,MAAC;AAAA;AAAA;AAAA,MAGzB,WAAW;AAAA,MAAC;AAAA,MACZ,eAAe,MAAMJ,EAAQ;AAAA,IAAA,GAE/BD,EAAO,iCAAiCE;AAAA,EAC1C;AAEA,QAAMI,IAAWJ,EAAK;AACtB,MAAI;AACF,IAAAA,EAAK,oBAAoB,SAAyBK,GAAYC,MAASC,GAAM;AAE3E,UAAI;AACF,QAAAH,GAAU,KAAK,MAAMC,GAAYC,GAAM,GAAGC,CAAI;AAAA,MAChD,UAAA;AACE,YAAI;AACF,UAAAC,EAAMT,GAASO,CAAI;AAAA,QACrB,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AAAA,EACF,QAAQ;AAAA,EAGR;AACF;AAEA,SAASE,EAAMT,GAAkBO,GAAuB;AAEtD,QAAMG,IAAUH,GAAM;AACtB,EAAIG,KAAWA,EAAQ,SAAS,OAAMV,EAAQ,MAAM,OAAOO,CAAI,IAC1DP,EAAQ,MAAM,IAAIO,CAAI;AAC3B,aAAWI,KAAYX,EAAQ,UAAW,CAAAW,EAAA;AAC5C;AAOO,SAASC,EAAed,IAAc,QAAiC;AAC5E,QAAMC,IAASD,GACTG,IAAOF,EAAO,gCACdc,IAAQ,IAAI,IAAed,EAAO,mBAAmB,SAAS,EAAE;AAKtE,MAAIE,KAAQA,EAAK,qBAAqB,OAAO,OAAOA,EAAK,iBAAkB;AACzE,eAAWG,KAAMH,EAAK,UAAU,KAAA;AAC9B,iBAAWM,KAAQN,EAAK,cAAcG,CAAE,KAAK,GAAI,CAAAS,EAAM,IAAIN,CAAI;AAGnE,SAAOM,EAAM,OAAO,IAAI,CAAC,GAAGA,CAAK,IAAI;AACvC;AAGO,SAASC,EAAiBH,GAAsBb,IAAc,QAAoB;AACvF,QAAME,IAAWF,EAAmB;AACpC,SAAKE,KACLA,EAAQ,UAAU,IAAIW,CAAQ,GACvB,MAAMX,EAAQ,UAAU,OAAOW,CAAQ,KAFzB,MAAM;AAAA,EAAC;AAG9B;"}
|