@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 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%, copiar link, revisão limpa, tema, painel e — quando a validação tem algo a dizer — o indicador de diagnóstico. |
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,3 @@
1
+ import { i as o } from "./hook-CeXcli-1.js";
2
+ o();
3
+ //# sourceMappingURL=devtools-hook.js.map
@@ -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[];
@@ -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
- * 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.
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;"}