@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.
@@ -1,3 +1,4 @@
1
+ import { RefObject } from 'react';
1
2
  import { DesignSpaceLocation } from '../controls/state.js';
2
3
  import { FrameShortcut } from '../frame/index.js';
3
4
  import { ViewportSetting } from '../types/index.js';
@@ -15,5 +16,7 @@ export type CanvasProps = {
15
16
  resizing: boolean;
16
17
  onFrameNavigate: (url: string, replace: boolean) => void;
17
18
  onShortcut: (key: FrameShortcut) => void;
19
+ /** O `<iframe>`, com o dono no chrome: "Abrir em nova janela" lê o endereço dele. */
20
+ frameRef: RefObject<HTMLIFrameElement | null>;
18
21
  };
19
- export declare function Canvas({ location, viewport, zoom, title, resizing, onFrameNavigate, onShortcut, onEffectiveZoom, }: CanvasProps): import("react").JSX.Element;
22
+ export declare function Canvas({ location, viewport, zoom, title, resizing, onFrameNavigate, onShortcut, onEffectiveZoom, frameRef, }: CanvasProps): import("react").JSX.Element;
@@ -1,14 +1,16 @@
1
1
  import { Registry } from '../registry/index.js';
2
+ import { ImplementationIndex } from '../fiber/tree.js';
2
3
  type Box = {
3
4
  key: string;
4
- id: string;
5
+ /** Ids do catálogo, o de fora antes do de dentro; a marcação manual por último. */
6
+ ids: string[];
5
7
  top: number;
6
8
  left: number;
7
9
  width: number;
8
10
  height: number;
9
11
  };
10
- /** Caixas dos componentes marcados e visíveis, em coordenadas da janela. */
11
- export declare function measureComponents(doc: Document): Box[];
12
+ /** Caixas dos componentes visíveis, em coordenadas da janela. */
13
+ export declare function measureComponents(doc: Document, index?: ImplementationIndex): Box[];
12
14
  export declare function Highlight({ registry }: {
13
15
  registry: Registry;
14
16
  }): import('react').ReactPortal;
@@ -21,6 +21,8 @@ export type TopbarProps = {
21
21
  onZoom: (zoom: number) => void;
22
22
  onHighlight: () => void;
23
23
  onCleanReview: () => void;
24
+ /** Abre o quadro sozinho numa janela própria, para ferramenta de captura. */
25
+ onOpenFrame: () => void;
24
26
  onToggleTheme: () => void;
25
27
  };
26
- export declare function Topbar({ productName, viewportId, viewport, zoom, rotated, highlight, theme, issues, linkUrl, onViewport, onRotate, onZoom, onHighlight, onCleanReview, onToggleTheme, }: TopbarProps): import("react").JSX.Element;
28
+ export declare function Topbar({ productName, viewportId, viewport, zoom, rotated, highlight, theme, issues, linkUrl, onViewport, onRotate, onZoom, onHighlight, onCleanReview, onOpenFrame, onToggleTheme, }: TopbarProps): import("react").JSX.Element;
@@ -2,7 +2,7 @@
2
2
  * Ícones do chrome: traço simples, `currentColor`, 16px. Sem texto, sem cor.
3
3
  * Todo ícone é decorativo; o nome acessível fica no botão que o contém.
4
4
  */
5
- export type IconName = "mobile" | "tablet" | "desktop" | "fit" | "rotate" | "minus" | "plus" | "link" | "arrow-up-right" | "check" | "fullscreen" | "components" | "sun" | "moon" | "panel" | "alert" | "chevron" | "search" | "copy";
5
+ export type IconName = "mobile" | "tablet" | "desktop" | "fit" | "rotate" | "minus" | "plus" | "link" | "arrow-up-right" | "check" | "fullscreen" | "components" | "external" | "sun" | "moon" | "panel" | "alert" | "chevron" | "search" | "copy";
6
6
  export declare function Icon({ name, size }: {
7
7
  name: IconName;
8
8
  size?: number;
@@ -16,6 +16,8 @@ export type Labels = {
16
16
  copyPrompt: string;
17
17
  cleanReview: string;
18
18
  highlight: string;
19
+ /** Abre o quadro sozinho, sem o chrome, numa janela própria. */
20
+ openFrame: string;
19
21
  lightMode: string;
20
22
  darkMode: string;
21
23
  engineVersion: (version: string) => string;
package/dist/testing.js CHANGED
@@ -1,4 +1,4 @@
1
- import { o as s, v as t, B as i, A as a, k as n } from "./index-Dv-W-bL0.js";
1
+ import { o as s, v as t, D as i, B as a, k as n } from "./index-CLox5DuH.js";
2
2
  function c(o = "http://localhost:5173") {
3
3
  const r = typeof process < "u" ? process.env : {};
4
4
  return (r.PREVIEW_URL || r.BASE_URL || o).replace(/\/$/, "");
@@ -1,4 +1,4 @@
1
- import { ComponentType, ReactNode } from 'react';
1
+ import { ComponentType, ExoticComponent, ReactNode } from 'react';
2
2
  import { LabelsOverride } from '../shell/labels.js';
3
3
  export type Persona = {
4
4
  /** Identificador estável usado em URL e em cenário. */
@@ -198,6 +198,8 @@ export type ComponentPreviewProps<T = unknown> = {
198
198
  /** `default` quando o produto não declara idiomas. */
199
199
  locale: string;
200
200
  };
201
+ /** Referência a um componente React do produto: função, classe, `memo`, `forwardRef` ou `lazy`. */
202
+ export type ComponentReference = ComponentType<any> | ExoticComponent<any>;
201
203
  export type ComponentPreview<T = unknown> = {
202
204
  /** Identificador estável usado no deep link: `button.primary`. */
203
205
  id: string;
@@ -213,6 +215,14 @@ export type ComponentPreview<T = unknown> = {
213
215
  source?: string;
214
216
  /** Composição visual fornecida e mantida pelo produto. */
215
217
  preview: ComponentType<ComponentPreviewProps<T>>;
218
+ /**
219
+ * O componente React real que esta entrada cataloga — o mesmo que as telas
220
+ * importam —, ou a lista deles quando a entrada cobre mais de um. É o que o
221
+ * "Destacar componentes" procura na árvore do React: o casamento é pela
222
+ * referência da função, não pelo nome, então vale no build minificado. Aceita
223
+ * `memo`, `forwardRef` e `lazy`. Ver a decisão 0017.
224
+ */
225
+ implementation?: ComponentReference | readonly ComponentReference[];
216
226
  /** Dados sintéticos exclusivos deste componente; não usam o catálogo de cenários. */
217
227
  fixtures?: ComponentPreviewFixture<T>[];
218
228
  /** Id da fixture selecionada quando o deep link não informa outra. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@brucesantos/design-space",
3
- "version": "0.11.0",
3
+ "version": "0.13.0",
4
4
  "description": "Motor neutro do Bananas Design Space: telas como rotas com variações, catálogo de componentes, chrome em preto e branco com a UI do produto num iframe, deep links e controles de persona/viewport/rede. Não contém UI de cliente.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -20,7 +20,8 @@
20
20
  "component-catalog"
21
21
  ],
22
22
  "sideEffects": [
23
- "**/*.css"
23
+ "**/*.css",
24
+ "./dist/devtools-hook.js"
24
25
  ],
25
26
  "main": "./dist/index.js",
26
27
  "module": "./dist/index.js",
@@ -34,6 +35,10 @@
34
35
  "types": "./dist/testing/index.d.ts",
35
36
  "default": "./dist/testing.js"
36
37
  },
38
+ "./devtools-hook": {
39
+ "types": "./dist/devtools-hook.d.ts",
40
+ "default": "./dist/devtools-hook.js"
41
+ },
37
42
  "./styles.css": "./dist/design-space.css"
38
43
  },
39
44
  "files": [
@@ -1 +0,0 @@
1
- {"version":3,"file":"index-Dv-W-bL0.js","sources":["../src/types/index.ts","../src/router/index.ts","../src/registry/validate.ts","../src/handoff/index.ts","../src/controls/params.ts","../src/frame/index.ts","../src/deploy/index.ts"],"sourcesContent":["/**\n * Contratos públicos do motor.\n *\n * Estes tipos são a fronteira entre o motor e o produto. O motor nunca conhece\n * um componente, um token ou uma persona concreta: conhece apenas a forma.\n *\n * Regra de fronteira (D-02): se aparece dentro da interface do cliente e\n * contribui para sua linguagem visual ou seu domínio, pertence ao repositório\n * daquele produto e não a este arquivo.\n */\n\nimport type { ComponentType, ReactNode } from \"react\";\n\n// Import de tipo, apagado no build: o dicionário de rótulos mora junto com os\n// valores padrão, em `shell/labels.ts`, e só a forma dele é contrato.\nimport type { LabelsOverride } from \"../shell/labels.js\";\n\n/* ------------------------------------------------------------------ *\n * Persona\n * ------------------------------------------------------------------ */\n\nexport type Persona = {\n /** Identificador estável usado em URL e em cenário. */\n id: string;\n /** Nome no vocabulário do cliente: \"Aprovador\". */\n name: string;\n /** O que essa pessoa está tentando fazer. */\n goal?: string;\n /** Permissões concedidas por padrão a este papel. */\n permissions: string[];\n description?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Regra de negócio\n * ------------------------------------------------------------------ */\n\nexport type Rule = {\n /** Identificador citado por cenários: `retry-after-document-review`. */\n id: string;\n /** Enunciado curto, na linguagem do produto. */\n statement: string;\n /** Por que a regra existe. Contexto, não implementação. */\n rationale?: string;\n /** Onde a regra vive no código, quando existir: `src/rules/requests.ts`. */\n source?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Fixture\n * ------------------------------------------------------------------ */\n\n/**\n * Dado sintético e determinístico que materializa um cenário.\n *\n * O motor não conhece o formato de `data` — isso é contrato do produto. O que\n * o motor garante é que a mesma URL produz a mesma fixture (§15.1\n * \"Determinismo\"), então `data` precisa ser um valor puro ou uma factory pura.\n */\nexport type Fixture<T = unknown> = {\n id: string;\n /** Rótulo legível para o seletor de conjunto de dados. */\n label: string;\n description?: string;\n /** Valor determinístico, ou factory pura que devolve um valor determinístico. */\n data: T | (() => T);\n};\n\n/* ------------------------------------------------------------------ *\n * Estado de rede\n * ------------------------------------------------------------------ */\n\nexport type NetworkState = \"success\" | \"loading\" | \"empty\" | \"error\" | \"slow\";\n\nexport const NETWORK_STATES: readonly NetworkState[] = [\n \"success\",\n \"loading\",\n \"empty\",\n \"error\",\n \"slow\",\n] as const;\n\n/* ------------------------------------------------------------------ *\n * Cenário — a unidade central (D-06)\n * ------------------------------------------------------------------ */\n\n/**\n * Um cenário não é uma tela com dados diferentes. Ele combina intenção,\n * persona, permissões, pré-condições, dados, estado inicial, ações\n * disponíveis, regras e resultado esperado.\n */\nexport type Scenario = {\n /**\n * Identificador estável, minúsculo, em kebab-case e com pontos opcionais:\n * `requests.approve-blocked`. Só precisa ser único no produto.\n */\n id: string;\n /**\n * Nome da variação na lista da tela, no vocabulário do negócio: \"Aprovação\n * bloqueada por falta de documento\".\n */\n title: string;\n /**\n * Rota que o cenário abre. Precisa casar com uma rota do produto: é essa rota\n * que define de qual tela o cenário é variação.\n */\n route: string;\n /**\n * Id de uma persona registrada no produto. Opcional: cenário sem persona tem\n * permissões vazias, a menos que declare `permissions`.\n */\n persona?: string;\n /**\n * Permissões efetivas do cenário. Quando ausente, herda as da persona.\n * Declarar aqui permite representar \"solicitante sem permissão de aprovar\"\n * sem inventar uma segunda persona.\n */\n permissions?: string[];\n /** Id de uma fixture registrada no produto. */\n fixture: string;\n /** Ids de regras que governam esta situação. */\n rules?: string[];\n\n /** Intenção: o que se quer discutir ou verificar aqui. */\n intent?: string;\n /** Pré-condições em linguagem de negócio. */\n preconditions?: string[];\n /** Ações que a persona pode executar nesta situação. */\n actions?: string[];\n /** Resultado esperado — vira caso de teste no handoff. */\n expected?: string[];\n /** Estado de rede inicial. Padrão: `success`. */\n network?: NetworkState;\n /** Rótulos livres para busca: \"exceção\", \"permissão\", \"vazio\". */\n tags?: string[];\n /** Ticket de engenharia, quando o cenário estiver em implementação. */\n ticket?: string;\n /**\n * Ids de `ComponentPreview` usados na tela. Alimentam \"Componentes usados\" no\n * painel de informações, o \"Usado em\" de cada componente e a tabela do\n * \"Copiar para o PR\".\n */\n components?: string[];\n /**\n * Valores de controle que este cenário fixa: um atalho para uma combinação.\n * Abrir o cenário aplica estes valores sobre os padrões da tela. Chave é o id\n * de um `Control` da tela do cenário; valor, o `value` de uma das opções.\n */\n controls?: Record<string, string>;\n};\n\n/* ------------------------------------------------------------------ *\n * Controles por componente\n * ------------------------------------------------------------------ */\n\n/** Uma opção de um controle. */\nexport type ControlOption = { value: string; label: string };\n\n/** Um controle: uma dimensão de variação de um componente da tela. */\nexport type Control = {\n /** Id estável, único dentro da tela; vira parâmetro de URL `c.<id>`. */\n id: string;\n label: string;\n options: ControlOption[];\n /** Valor inicial; padrão = primeira opção. */\n default?: string;\n description?: string;\n};\n\n/** Grupo de controles de um componente da tela, como no painel Variações. */\nexport type ControlGroup = {\n /** Id estável, único dentro da tela. */\n id: string;\n /** \"Tabela de pedidos · table\". */\n title: string;\n /** Id de um ComponentPreview do catálogo, quando o grupo é de um componente dele. */\n component?: string;\n controls: Control[];\n /** Uma linha de contexto, exibida sob o título. */\n note?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Rotas declarativas\n * ------------------------------------------------------------------ */\n\n/**\n * Rota declarativa do produto. O motor casa `path` contra a URL e renderiza\n * `screen`, passando os parâmetros dinâmicos.\n *\n * Sintaxe de `path`: segmentos literais e `:param`. Um `*` final captura o\n * resto em `params[\"*\"]`.\n */\nexport type RouteDefinition = {\n path: string;\n screen: ComponentType<ScreenProps>;\n /**\n * Nome da tela na lista. Uma rota é uma tela; sem `name`, o motor usa o\n * título do primeiro cenário da rota e, na falta dele, o próprio `path`.\n */\n name?: string;\n /** Uma linha sobre a tela, exibida em Informações e usada na busca. */\n description?: string;\n /**\n * Fluxo a que a tela pertence: agrupa as telas na aba Telas, como `group`\n * agrupa componentes. Tela sem fluxo fica num grupo sem título, no topo.\n */\n group?: string;\n /** Controles por componente, exibidos no painel Variações. */\n controls?: ControlGroup[];\n /**\n * Comportamento esperado da tela, para Informações e \"Copiar para o PR\"\n * quando não há cenário ativo.\n */\n expected?: string[];\n /** Ids do catálogo usados pela tela (mesmo papel de `Scenario.components`). */\n components?: string[];\n /**\n * Valores de exemplo dos parâmetros do `path` (`{ id: \"REQ-1\" }` para\n * `/requests/:id`), e de `*` quando houver. O motor usa sempre que precisa\n * abrir a tela sem cenário — lateral, variação padrão, links de Informações e\n * \"Copiar para o PR\". Sem eles, o caminho abre literal (`/requests/:id`).\n */\n params?: Record<string, string>;\n};\n\nexport type ScreenProps = {\n /** Parâmetros dinâmicos casados da rota. */\n params: Record<string, string>;\n /** Contexto do cenário ativo, resolvido pelo motor. */\n context: ScenarioContext;\n};\n\n/**\n * Componente do produto exposto no catálogo do Design Space.\n *\n * O motor só organiza e renderiza a referência. Implementação, aparência e\n * conteúdo continuam no repositório do produto.\n */\nexport type ComponentPreviewFixture<T = unknown> = {\n /** Identificador estável, com escopo apenas dentro deste componente. */\n id: string;\n /** Rótulo legível para o seletor de dados do componente. */\n label: string;\n description?: string;\n /** Valor sintético determinístico, ou factory pura que o produz. */\n data: T | (() => T);\n};\n\n/** Controles e dados que o motor entrega a um preview isolado. */\nexport type ComponentPreviewProps<T = unknown> = {\n fixture?: ComponentPreviewFixture<T>;\n data: T | undefined;\n viewport: ViewportSetting;\n /** `default` quando o produto não declara modos de tema. */\n themeMode: string;\n /** `default` quando o produto não declara idiomas. */\n locale: string;\n};\n\nexport type ComponentPreview<T = unknown> = {\n /** Identificador estável usado no deep link: `button.primary`. */\n id: string;\n /** Nome legível no vocabulário do produto. */\n name: string;\n /** Grupo de navegação: `Ações`, `Formulários`, `Feedback`. */\n group?: string;\n description?: string;\n /**\n * Origem no sistema real, em texto livre: `components/button.ex → button/1`.\n * Aparece em Informações e na tabela do \"Copiar para o PR\".\n */\n source?: string;\n /** Composição visual fornecida e mantida pelo produto. */\n preview: ComponentType<ComponentPreviewProps<T>>;\n /** Dados sintéticos exclusivos deste componente; não usam o catálogo de cenários. */\n fixtures?: ComponentPreviewFixture<T>[];\n /** Id da fixture selecionada quando o deep link não informa outra. */\n defaultFixture?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Adapters de dados (§7)\n * ------------------------------------------------------------------ */\n\n/**\n * A UI do produto nunca depende diretamente de um backend. A camada de\n * adapters permite alimentar o mesmo cenário por fixture, REST, GraphQL ou\n * staging sem alterar a composição visual.\n */\nexport type DataSourceAdapter<T = unknown> = {\n id: string;\n label: string;\n /**\n * Resolve os dados de um cenário. Recebe a fixture declarada para que um\n * adapter remoto possa usá-la como fallback ou como semente.\n */\n load: (request: DataRequest) => Promise<T> | T;\n};\n\nexport type DataRequest = {\n scenario: Scenario;\n fixture: Fixture | undefined;\n network: NetworkState;\n};\n\n/* ------------------------------------------------------------------ *\n * Tema do produto\n * ------------------------------------------------------------------ */\n\n/**\n * O motor não impõe aparência (D-02). Recebe do produto apenas o suficiente\n * para oferecer os controles de tema.\n */\nexport type ProductTheme = {\n /** Modos de tema disponíveis no produto, quando houver mais de um. */\n modes?: string[];\n /** Idiomas disponíveis, quando o produto tiver essa variação. */\n locales?: string[];\n /**\n * Rótulos do chrome do motor. Sobrescreve por grupo o que estiver em\n * `DEFAULT_LABELS`; o que não for declarado fica no padrão em português.\n *\n * Serve para o Design Space de um cliente que revisa em outro idioma: o chrome\n * divide a tela com a UI do produto, e chrome em português ao lado de interface\n * em inglês é ruído no meio da revisão.\n *\n * Isto é rótulo de **mecanismo**. Nome de tela, título de cenário e nome de\n * persona continuam vindo do catálogo do produto.\n */\n labels?: LabelsOverride;\n};\n\n/* ------------------------------------------------------------------ *\n * Definição do produto — a única coisa que o produto entrega ao motor\n * ------------------------------------------------------------------ */\n\nexport type ProductDefinition = {\n /** `acme`. */\n id: string;\n /** \"Acme\". */\n name: string;\n /** Uma linha sobre o produto, exibida na entrada do Design Space. */\n tagline?: string;\n /**\n * Situações do produto. Cada uma é uma **variação** da tela cuja rota casa\n * com `route`; a ordem de `routes` define a ordem das telas e a ordem deste\n * array, a das variações dentro de cada tela.\n */\n scenarios: Scenario[];\n personas: Persona[];\n /**\n * Persona efetiva de toda tela e todo cenário sem persona própria. Sem ela, a\n * tela sem cenário abre sem persona (e sem permissões). Persona do cenário e\n * a escolhida no painel continuam vencendo.\n */\n defaultPersona?: string;\n fixtures: Fixture[];\n rules?: Rule[];\n /** Rotas declarativas. Cada rota é uma tela na lista de Telas. */\n routes: RouteDefinition[];\n /** Catálogo visual opcional, implementado integralmente pelo produto. */\n /** Cada item pode ter seu próprio tipo de dados; o registry os trata como opacos. */\n components?: ComponentPreview<any>[];\n theme?: ProductTheme;\n /**\n * Adapters de dados disponíveis. `fixtures` é o padrão (D-05); qualquer\n * outro entra como opção explícita e justificada.\n */\n dataSources?: {\n default: string;\n adapters?: DataSourceAdapter[];\n };\n /**\n * Contexto do deployment, informado pelo produto. **Opcional**: um Design\n * Space que roda só local não precisa dele.\n *\n * O motor **não consegue** descobrir isso sozinho. Ele é uma biblioteca já\n * compilada: o `import.meta.env` do código dele foi resolvido no build do\n * pacote, não no build do produto, então não sobra nada para o bundler do\n * produto substituir. Quem tem acesso ao próprio ambiente de build é o produto.\n *\n * Passe os valores do bundler, com o nome que o seu build usar:\n *\n * ```ts\n * deploy: {\n * env: import.meta.env.VITE_DEPLOY_ENV,\n * branch: import.meta.env.VITE_DEPLOY_BRANCH,\n * commit: import.meta.env.VITE_DEPLOY_COMMIT,\n * }\n * ```\n *\n * Sem isso o cabeçalho da revisão mostra \"development\" e omite branch e\n * commit — e é o commit que torna uma aprovação rastreável.\n */\n deploy?: DeployOverrides;\n\n /** Renderizado quando nenhuma rota casa. Padrão: aviso neutro do motor. */\n notFound?: ComponentType<{ path: string }>;\n /** Envolve a UI do produto. Serve para providers de tema, i18n ou store. */\n wrapper?: ComponentType<{ children: ReactNode; context: ScenarioContext }>;\n};\n\n/**\n * Contexto do deployment informado pelo produto. Todos os campos são opcionais,\n * e é essa a fonte única: o motor não lê ambiente nem conhece provedor de\n * hospedagem. Campo ausente cai no padrão local.\n */\nexport type DeployOverrides = {\n /** `development`, `preview` ou `production`. */\n env?: string;\n /** Domínio da branch, sem protocolo. Quando ausente, usa a origem da janela. */\n branchUrl?: string;\n /** Domínio único deste deployment, sem protocolo. */\n deploymentUrl?: string;\n /** Nome da branch, para rotular a revisão. */\n branch?: string;\n /** Commit exato do deployment, usado para rastrear a revisão. */\n commit?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Contexto exposto à UI do produto\n * ------------------------------------------------------------------ */\n\n/**\n * O que a UI do produto recebe do motor. Deliberadamente pequeno: dados,\n * papel, permissões e estado de ambiente. Nada de componente, token ou\n * aparência.\n */\nexport type ScenarioContext = {\n scenario: Scenario | undefined;\n persona: Persona | undefined;\n /** Permissões efetivas: as do cenário, ou as da persona quando ausentes. */\n permissions: string[];\n /** `true` quando a permissão está nas permissões efetivas. */\n can: (permission: string) => boolean;\n /** Dados resolvidos pelo adapter ativo. `undefined` enquanto carrega. */\n data: unknown;\n fixture: Fixture | undefined;\n network: NetworkState;\n /** `true` enquanto o adapter resolve. Reflete também o estado `slow`. */\n isLoading: boolean;\n /** Preenchido quando `network` é `error` ou o adapter falhou. */\n error: Error | undefined;\n /** Regras resolvidas do cenário ativo. */\n rules: Rule[];\n viewport: ViewportSetting;\n themeMode: string | undefined;\n locale: string | undefined;\n /**\n * Navega dentro do Design Space, também de dentro do quadro.\n *\n * - `navigate(\"/x\")`, sem query: a query atual segue inteira; numa tela\n * diferente, os `c.*` da anterior ficam para trás.\n * - `navigate(\"/x?a=1\")` ou com `options.controls`: o destino manda na query.\n * O contexto do motor (persona, rede, viewport, tema, idioma, fonte de\n * dados, handoff…) é preservado quando o destino não o traz; `scenario`,\n * `fixture`, `component` e os `c.*` da tela anterior não. A persona que vinha\n * do cenário deixado para trás vira parâmetro explícito.\n * - `options.controls` vira `c.*` do destino; valor igual ao padrão da tela\n * de destino não entra na URL.\n */\n navigate: (to: string, options?: NavigateOptions) => void;\n /** Abre outro cenário por id. */\n openScenario: (scenarioId: string) => void;\n /**\n * Valor atual de cada controle da tela (id → value), com os padrões\n * aplicados. Vazio quando a tela não declara controles.\n */\n controls: Record<string, string>;\n /**\n * Muda um controle a partir da UI do produto (ex.: fechar um modal volta o\n * controle de sobreposição para \"nenhuma\"). Atualiza a URL.\n */\n setControl: (id: string, value: string) => void;\n /**\n * Muda vários controles numa única atualização de URL. Chamadas seguidas de\n * `setControl`/`setControls` no mesmo ciclo se acumulam: cada uma parte do\n * estado mais recente, não do valor da última renderização.\n */\n setControls: (patch: Record<string, string>) => void;\n};\n\n/** Opções de {@link ScenarioContext.navigate}. */\nexport type NavigateOptions = {\n /** Controles da tela de destino (id → value), escritos como `c.<id>`. */\n controls?: Record<string, string>;\n /** Substitui a entrada atual do histórico em vez de criar uma nova. */\n replace?: boolean;\n};\n\nexport type ViewportSetting = {\n /** `mobile`, `tablet`, `desktop`, `fit` ou `custom` (só por URL). */\n id: string;\n label: string;\n /** Largura em px. `undefined` em `fit` significa \"ocupa o disponível\". */\n width?: number;\n height?: number;\n};\n\n/** Aparência do chrome do Design Space. Não altera o tema da UI do produto. */\nexport type ChromeTheme = \"dark\" | \"light\";\n\n/**\n * Recorte de revisão/handoff transportado pela URL.\n *\n * As três listas são allowlists independentes. Um cenário permitido autoriza\n * também a própria rota; `routes` cobre páginas que não têm cenário; componentes\n * precisam ser autorizados explicitamente.\n *\n * Este recorte reduz distração no preview. Não é controle de acesso: isolamento\n * real exige build separado ou autenticação no produto que publica o preview.\n */\nexport type HandoffScope = {\n scenarios?: string[];\n routes?: string[];\n components?: string[];\n};\n\n/* ------------------------------------------------------------------ *\n * Estado dos controles — serializado na URL (deep link)\n * ------------------------------------------------------------------ */\n\nexport type ControlsState = {\n scenario: string | undefined;\n /** Allowlist de foco ativa, serializada na URL quando presente. */\n handoff?: HandoffScope;\n /** Referência visual ativa. Opcional para preservar objetos do contrato anterior. */\n component?: string;\n persona: string | undefined;\n fixture: string | undefined;\n network: NetworkState;\n viewport: string;\n customWidth: number | undefined;\n themeMode: string | undefined;\n locale: string | undefined;\n dataSource: string | undefined;\n /**\n * Tema visual do chrome; independente de `themeMode` do produto. Ausente\n * significa \"o que a pessoa escolheu por último, ou o do sistema\".\n */\n chromeTheme?: ChromeTheme;\n /** Chrome do Design Space oculto: revisão limpa e captura de tela. */\n chrome: boolean;\n /** Painel lateral direito (Variações e Informações) aberto. `panel=0` fecha. */\n inspector: boolean;\n /** Aba do painel direito. Padrão: `variations`. */\n panelTab?: PanelTab;\n /** Zoom da visualização, em porcentagem (25–150). Padrão: 100. */\n zoom?: number;\n /** Viewport girado: largura e altura trocadas quando o preset tem altura. */\n rotated?: boolean;\n /**\n * Destaque de componentes: o quadro contorna cada elemento marcado com\n * `data-ds-component`, para avaliar o que na tela é componente e o que não é.\n */\n highlight?: boolean;\n /**\n * Valores dos controles da tela aberta (id → value), já com os padrões e o\n * cenário aplicados. Na URL, só o que difere vai como `c.<id>=<value>`.\n */\n screenControls?: Record<string, string>;\n};\n\n/** Abas do painel direito do chrome. */\nexport type PanelTab = \"variations\" | \"info\";\n","/**\n * Roteamento declarativo mínimo.\n *\n * Não usa uma biblioteca de rotas de propósito: o motor precisa ficar pequeno e\n * neutro (Princípio 6), e o que o Design Space exige de roteamento é pequeno —\n * casar um path contra uma lista declarada e extrair parâmetros. Em troca, o\n * produto não herda a versão nem as convenções de um router externo.\n *\n * Em desenvolvimento o dev server já serve qualquer rota. Publicado, o que faz\n * isso continuar funcionando é o rewrite de SPA de quem hospeda (§10.4): sem ele,\n * abrir uma rota profunda direto pela URL devolve 404 no primeiro carregamento e\n * quebra a promessa central do produto. A configuração é do host, e por isso vive\n * no produto — não aqui.\n */\n\nimport type { RouteDefinition } from \"../types/index.js\";\n\nexport type RouteMatch = {\n definition: RouteDefinition;\n params: Record<string, string>;\n};\n\n/**\n * Casa um path contra um padrão com segmentos `:param` e `*` final.\n * Devolve os parâmetros extraídos, ou `null` quando não casa.\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n const patternSegments = pattern.split(\"/\").filter(Boolean);\n const pathSegments = decodePath(path).split(\"/\").filter(Boolean);\n const params: Record<string, string> = {};\n\n for (const [index, segment] of patternSegments.entries()) {\n if (segment === \"*\") {\n params[\"*\"] = pathSegments.slice(index).join(\"/\");\n return params;\n }\n\n const actual = pathSegments[index];\n if (actual === undefined) return null;\n\n if (segment.startsWith(\":\")) {\n params[segment.slice(1)] = actual;\n continue;\n }\n\n if (segment !== actual) return null;\n }\n\n if (patternSegments.length !== pathSegments.length) return null;\n return params;\n}\n\n/**\n * Resolve a rota ativa. Rotas mais específicas primeiro: entre `/requests/new`\n * e `/requests/:id`, a literal ganha, independente da ordem de declaração.\n */\nexport function resolveRoute(routes: RouteDefinition[], path: string): RouteMatch | undefined {\n const ranked = [...routes].sort((a, b) => specificity(b.path) - specificity(a.path));\n\n for (const definition of ranked) {\n const params = matchPath(definition.path, path);\n if (params) return { definition, params };\n }\n\n return undefined;\n}\n\n/**\n * Caminho concreto de uma rota sem cenário: cada `:param` com exemplo em\n * `params` recebe o exemplo, e o curinga final recebe `params[\"*\"]` ou some.\n */\nexport function screenHref(path: string, params: Record<string, string> = {}): string {\n const example = (name: string): string | undefined => {\n const value = params[name];\n return typeof value === \"string\" && value.length > 0 ? value : undefined;\n };\n const segments: string[] = [];\n for (const segment of path.split(\"/\").filter(Boolean)) {\n if (segment === \"*\") {\n const rest = example(\"*\");\n if (rest) segments.push(...rest.split(\"/\").filter(Boolean).map(encodeURIComponent));\n continue;\n }\n const value = segment.startsWith(\":\") ? example(segment.slice(1)) : undefined;\n segments.push(value === undefined ? segment : encodeURIComponent(value));\n }\n return `/${segments.join(\"/\")}`;\n}\n\n/**\n * Pontuação de especificidade: segmento literal vale mais que parâmetro, que\n * vale mais que curinga. Rotas mais longas desempatam.\n */\nfunction specificity(pattern: string): number {\n const segments = pattern.split(\"/\").filter(Boolean);\n let score = segments.length;\n for (const segment of segments) {\n if (segment === \"*\") score -= 2;\n else if (segment.startsWith(\":\")) score += 1;\n else score += 4;\n }\n return score;\n}\n\nfunction decodePath(path: string): string {\n const withoutQuery = path.split(\"?\")[0] ?? path;\n try {\n return decodeURI(withoutQuery);\n } catch {\n return withoutQuery;\n }\n}\n","/**\n * Validação em runtime do contrato de cenário (E2).\n *\n * Existe porque tipo de TypeScript desaparece no build: uma fixture inexistente\n * ou uma persona escrita errada só apareceria como tela vazia no preview, que é\n * exatamente o tipo de erro que corrói a confiança no ambiente. Aqui ela\n * aparece como problema nomeado, no painel e no CI.\n *\n * Sem dependência de schema externo de propósito: o contrato é pequeno, e o\n * motor precisa ficar pequeno e neutro (Princípio 6).\n */\n\nimport {\n NETWORK_STATES,\n type ControlGroup,\n type ProductDefinition,\n type RouteDefinition,\n type Scenario,\n} from \"../types/index.js\";\nimport { resolveRoute, screenHref } from \"../router/index.js\";\n\nexport type ValidationIssue = {\n level: \"error\" | \"warning\";\n /** Onde o problema está: `scenario:requests.approve-blocked`. */\n where: string;\n message: string;\n};\n\nconst ID_PATTERN = /^[a-z0-9]+([.\\-][a-z0-9]+)*$/;\n/** Id de controle: vai para a URL como `c.<id>`, então sem espaço nem `=`/`&`. */\nconst CONTROL_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_.-]*$/;\n\nfunction isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.trim().length > 0;\n}\n\n/**\n * Valida um cenário isolado: forma, não referências. Referências dependem do\n * produto inteiro e são checadas em {@link validateProduct}.\n */\nexport function validateScenario(scenario: Scenario, index?: number): ValidationIssue[] {\n const issues: ValidationIssue[] = [];\n const where = isNonEmptyString(scenario?.id)\n ? `scenario:${scenario.id}`\n : `scenario[${index ?? \"?\"}]`;\n\n const err = (message: string) => issues.push({ level: \"error\", where, message });\n const warn = (message: string) => issues.push({ level: \"warning\", where, message });\n\n if (!isNonEmptyString(scenario?.id)) {\n err(\"`id` é obrigatório.\");\n } else if (!ID_PATTERN.test(scenario.id)) {\n err(\n \"`id` deve ser minúsculo, em kebab-case, com pontos opcionais: `requests.approve-blocked` ou `approve-blocked`.\",\n );\n }\n\n if (!isNonEmptyString(scenario?.title)) {\n err(\"`title` é obrigatório e deve usar o vocabulário do negócio.\");\n }\n\n if (!isNonEmptyString(scenario?.route)) {\n err(\"`route` é obrigatório.\");\n } else if (!scenario.route.startsWith(\"/\")) {\n err(\"`route` deve começar com `/`.\");\n }\n\n if (scenario?.persona !== undefined && !isNonEmptyString(scenario.persona)) {\n err(\"`persona`, quando informada, deve ser o id de uma persona registrada.\");\n }\n if (!isNonEmptyString(scenario?.fixture)) {\n err(\"`fixture` é obrigatório. O padrão do ambiente é dado sintético (D-05).\");\n }\n\n if (scenario?.components !== undefined && !Array.isArray(scenario.components)) {\n err(\"`components`, quando informado, deve ser uma lista de ids de componente.\");\n }\n\n if (scenario?.network && !NETWORK_STATES.includes(scenario.network)) {\n err(`\\`network\\` deve ser um de: ${NETWORK_STATES.join(\", \")}.`);\n }\n\n if (!scenario?.expected?.length) {\n warn(\n \"Sem `expected`, o cenário não vira caso verificável no handoff — é tela bonita sem critério (risco: prototype theater).\",\n );\n }\n\n return issues;\n}\n\n/**\n * Valida o produto inteiro: forma de cada cenário mais integridade das\n * referências entre cenário, persona, fixture, regra e rota.\n */\nexport function validateProduct(product: ProductDefinition): ValidationIssue[] {\n const issues: ValidationIssue[] = [];\n const push = (level: ValidationIssue[\"level\"], where: string, message: string) =>\n issues.push({ level, where, message });\n\n const personaIds = new Set(product.personas?.map((p) => p.id) ?? []);\n const fixtureIds = new Set(product.fixtures?.map((f) => f.id) ?? []);\n const ruleIds = new Set(product.rules?.map((r) => r.id) ?? []);\n const scenarioIds = new Set<string>();\n\n if (!isNonEmptyString(product.id)) push(\"error\", \"product\", \"`id` é obrigatório.\");\n if (!isNonEmptyString(product.name)) push(\"error\", \"product\", \"`name` é obrigatório.\");\n // Um produto que é só catálogo de componentes e layouts não precisa de rota:\n // o preview de componente renderiza sem roteamento. Sem rota, o problema só\n // existe quando há cenário que precisa abrir uma tela.\n if (!product.routes?.length && product.scenarios?.length) {\n push(\"error\", \"product\", \"`routes` está vazio: nenhum cenário conseguirá renderizar.\");\n }\n\n if (product.defaultPersona !== undefined && !personaIds.has(product.defaultPersona)) {\n push(\n \"error\",\n \"product\",\n `\\`defaultPersona\\` aponta para persona não registrada: \\`${product.defaultPersona}\\`.`,\n );\n }\n\n if (\"modules\" in (product as object)) {\n push(\n \"warning\",\n \"product\",\n \"`modules` foi removido na 0.8.0 e é ignorado: cada rota é uma tela, e os cenários da rota são as variações dela.\",\n );\n }\n\n const routePaths = new Set<string>();\n for (const [index, route] of (product.routes ?? []).entries()) {\n const where = `route:${route?.path ?? index}`;\n if (!isNonEmptyString(route?.path)) {\n push(\"error\", where, \"`path` é obrigatório.\");\n continue;\n }\n if (!route.path.startsWith(\"/\")) push(\"error\", where, \"`path` deve começar com `/`.\");\n if (routePaths.has(route.path)) {\n push(\"error\", where, `\\`path\\` duplicado: ${route.path}. Cada rota é uma tela.`);\n }\n routePaths.add(route.path);\n if (typeof route.screen !== \"function\" && typeof route.screen !== \"object\") {\n push(\"error\", where, \"`screen` é obrigatório.\");\n }\n if (route.name !== undefined && !isNonEmptyString(route.name)) {\n push(\"warning\", where, \"`name` vazio: a tela aparece com o título do primeiro cenário.\");\n }\n if (route.group !== undefined && !isNonEmptyString(route.group)) {\n push(\"warning\", where, \"`group` vazio: a tela aparece fora de qualquer fluxo.\");\n }\n if (route.expected !== undefined && !Array.isArray(route.expected)) {\n push(\"error\", where, \"`expected`, quando informado, deve ser uma lista de frases.\");\n }\n if (route.components !== undefined && !Array.isArray(route.components)) {\n push(\"error\", where, \"`components`, quando informado, deve ser uma lista de ids de componente.\");\n }\n if (route.controls !== undefined) {\n if (!Array.isArray(route.controls)) {\n push(\"error\", where, \"`controls`, quando informado, deve ser uma lista de grupos de controles.\");\n } else {\n validateControlGroups(route.controls, where, push);\n }\n }\n }\n\n const componentIds = new Set<string>();\n for (const [index, component] of (product.components ?? []).entries()) {\n const where = `component:${component?.id ?? index}`;\n if (!isNonEmptyString(component?.id)) {\n push(\"error\", where, \"`id` é obrigatório.\");\n } else if (!ID_PATTERN.test(component.id)) {\n push(\"error\", where, \"`id` deve ser minúsculo em kebab-case ou usar pontos para agrupamento.\");\n } else if (componentIds.has(component.id)) {\n push(\"error\", where, `\\`id\\` duplicado: ${component.id}.`);\n } else {\n componentIds.add(component.id);\n }\n if (!isNonEmptyString(component?.name)) push(\"error\", where, \"`name` é obrigatório.\");\n if (typeof component?.preview !== \"function\" && typeof component?.preview !== \"object\") {\n push(\"error\", where, \"`preview` é obrigatório.\");\n }\n if (component?.source !== undefined && typeof component.source !== \"string\") {\n push(\"error\", where, \"`source`, quando informado, é texto livre.\");\n }\n\n const componentFixtureIds = new Set<string>();\n for (const [fixtureIndex, fixture] of (component?.fixtures ?? []).entries()) {\n const fixtureWhere = `${where}/fixture:${fixture?.id ?? fixtureIndex}`;\n if (!isNonEmptyString(fixture?.id)) {\n push(\"error\", fixtureWhere, \"`id` da fixture do componente é obrigatório.\");\n } else if (!ID_PATTERN.test(fixture.id)) {\n push(\n \"error\",\n fixtureWhere,\n `Id de fixture do componente inválido: \\`${fixture.id}\\`. Use minúsculas em kebab-case.`,\n );\n } else if (componentFixtureIds.has(fixture.id)) {\n push(\"error\", fixtureWhere, `Id de fixture do componente duplicado: \\`${fixture.id}\\`.`);\n } else {\n componentFixtureIds.add(fixture.id);\n }\n if (!isNonEmptyString(fixture?.label)) {\n push(\"error\", fixtureWhere, \"`label` da fixture do componente é obrigatório.\");\n }\n if (!fixture || !(\"data\" in fixture)) {\n push(\"error\", fixtureWhere, \"`data` da fixture do componente é obrigatório.\");\n }\n }\n if (component?.defaultFixture && !componentFixtureIds.has(component.defaultFixture)) {\n push(\n \"error\",\n where,\n `\\`defaultFixture\\` aponta para fixture inexistente: \\`${component.defaultFixture}\\`.`,\n );\n }\n }\n\n // Referências das rotas ao catálogo: só aviso, como em `Scenario.components`.\n for (const route of product.routes ?? []) {\n if (!isNonEmptyString(route?.path)) continue;\n const where = `route:${route.path}`;\n validateRouteParams(product, route, where, push);\n for (const component of Array.isArray(route.components) ? route.components : []) {\n if (!componentIds.has(component)) {\n push(\n \"warning\",\n where,\n `Componente não registrado: \\`${component}\\`. Ele não aparece em \"Componentes usados\".`,\n );\n }\n }\n for (const group of Array.isArray(route.controls) ? route.controls : []) {\n if (group?.component !== undefined && !componentIds.has(group.component)) {\n push(\n \"warning\",\n `${where}/group:${group.id}`,\n `Componente não registrado: \\`${group.component}\\`. O grupo aparece sem link para o catálogo.`,\n );\n }\n }\n }\n\n for (const [index, scenario] of (product.scenarios ?? []).entries()) {\n issues.push(...validateScenario(scenario, index));\n\n const where = `scenario:${scenario?.id ?? index}`;\n\n if (scenario?.id) {\n if (scenarioIds.has(scenario.id)) {\n push(\"error\", where, `\\`id\\` duplicado: ${scenario.id}.`);\n }\n scenarioIds.add(scenario.id);\n }\n\n if (scenario?.persona && !personaIds.has(scenario.persona)) {\n push(\"error\", where, `Persona não registrada: \\`${scenario.persona}\\`.`);\n }\n if (scenario?.fixture && !fixtureIds.has(scenario.fixture)) {\n push(\"error\", where, `Fixture não registrada: \\`${scenario.fixture}\\`.`);\n }\n for (const rule of scenario?.rules ?? []) {\n if (!ruleIds.has(rule)) {\n push(\"error\", where, `Regra não registrada: \\`${rule}\\`.`);\n }\n }\n for (const component of Array.isArray(scenario?.components) ? scenario.components : []) {\n if (!componentIds.has(component)) {\n push(\n \"warning\",\n where,\n `Componente não registrado: \\`${component}\\`. Ele não aparece em \"Componentes usados\".`,\n );\n }\n }\n if (scenario?.controls !== undefined) {\n if (!scenario.controls || typeof scenario.controls !== \"object\" || Array.isArray(scenario.controls)) {\n push(\"error\", where, \"`controls`, quando informado, é um objeto de id do controle → valor.\");\n } else if (scenario.route) {\n const match = resolveRoute(product.routes ?? [], scenario.route.split(\"?\")[0] ?? scenario.route);\n const groups = Array.isArray(match?.definition.controls) ? match!.definition.controls : [];\n const controls = new Map(\n groups.flatMap((group) => (Array.isArray(group?.controls) ? group.controls : [])).map((control) => [\n control?.id,\n control,\n ]),\n );\n for (const [id, value] of Object.entries(scenario.controls)) {\n const control = controls.get(id);\n if (!control) {\n push(\n \"error\",\n where,\n `Controle \\`${id}\\` não existe na tela \\`${match?.definition.path ?? scenario.route}\\`.`,\n );\n } else if (!(control.options ?? []).some((option) => option?.value === value)) {\n push(\n \"error\",\n where,\n `Valor \\`${value}\\` não é opção do controle \\`${id}\\`. Opções: ${(control.options ?? [])\n .map((option) => `\\`${option?.value}\\``)\n .join(\", \")}.`,\n );\n }\n }\n }\n }\n if (scenario?.route && !matchesAnyRoute(scenario.route, product)) {\n push(\n \"error\",\n where,\n `Rota \\`${scenario.route}\\` não casa com nenhuma rota declarada. O deep link abriria a tela de rota inexistente.`,\n );\n }\n }\n\n const defaultSource = product.dataSources?.default;\n if (defaultSource && defaultSource !== \"fixtures\") {\n const adapterIds = new Set(product.dataSources?.adapters?.map((a) => a.id) ?? []);\n if (!adapterIds.has(defaultSource)) {\n push(\"error\", \"product\", `\\`dataSources.default\\` aponta para adapter inexistente: \\`${defaultSource}\\`.`);\n }\n push(\n \"warning\",\n \"product\",\n \"A fonte padrão não é `fixtures`. O padrão do ambiente é dado sintético e determinístico (D-05); API real entra como adapter opcional, com justificativa.\",\n );\n }\n\n return issues;\n}\n\n/**\n * Forma dos grupos de controles de uma rota. Ids de grupo e de controle são\n * únicos na tela — o id do controle vira `c.<id>` na URL, e dois controles com o\n * mesmo id disputariam o mesmo parâmetro.\n */\nfunction validateControlGroups(\n groups: ControlGroup[],\n routeWhere: string,\n push: (level: ValidationIssue[\"level\"], where: string, message: string) => void,\n): void {\n const groupIds = new Set<string>();\n const controlIds = new Set<string>();\n for (const [index, group] of groups.entries()) {\n const where = `${routeWhere}/group:${group?.id ?? index}`;\n if (!isNonEmptyString(group?.id)) {\n push(\"error\", where, \"`id` do grupo de controles é obrigatório.\");\n } else if (groupIds.has(group.id)) {\n push(\"error\", where, `\\`id\\` de grupo duplicado na tela: \\`${group.id}\\`.`);\n } else {\n groupIds.add(group.id);\n }\n if (!isNonEmptyString(group?.title)) push(\"error\", where, \"`title` do grupo é obrigatório.\");\n if (!Array.isArray(group?.controls)) {\n push(\"error\", where, \"`controls` do grupo deve ser uma lista.\");\n continue;\n }\n for (const [controlIndex, control] of group.controls.entries()) {\n const controlWhere = `${where}/control:${control?.id ?? controlIndex}`;\n if (!isNonEmptyString(control?.id)) {\n push(\"error\", controlWhere, \"`id` do controle é obrigatório.\");\n } else if (!CONTROL_ID_PATTERN.test(control.id)) {\n push(\n \"error\",\n controlWhere,\n `Id de controle inválido: \\`${control.id}\\`. Use letras, números, \\`-\\`, \\`_\\` ou \\`.\\`, sem espaço: ele vira \\`c.<id>\\` na URL.`,\n );\n } else if (controlIds.has(control.id)) {\n push(\"error\", controlWhere, `\\`id\\` de controle duplicado na tela: \\`${control.id}\\`.`);\n } else {\n controlIds.add(control.id);\n }\n if (!isNonEmptyString(control?.label)) push(\"error\", controlWhere, \"`label` do controle é obrigatório.\");\n const options = Array.isArray(control?.options) ? control.options : [];\n if (options.length === 0) {\n push(\"error\", controlWhere, \"`options` precisa de ao menos uma opção.\");\n continue;\n }\n const values = new Set<string>();\n for (const option of options) {\n if (!isNonEmptyString(option?.value)) {\n push(\"error\", controlWhere, \"Toda opção precisa de `value`.\");\n } else if (values.has(option.value)) {\n push(\"error\", controlWhere, `Opção duplicada: \\`${option.value}\\`.`);\n } else {\n values.add(option.value);\n }\n if (!isNonEmptyString(option?.label)) {\n push(\"error\", controlWhere, `A opção \\`${option?.value ?? \"?\"}\\` precisa de \\`label\\`.`);\n }\n }\n if (control.default !== undefined && !values.has(control.default)) {\n push(\n \"error\",\n controlWhere,\n `\\`default\\` não é uma das opções: \\`${control.default}\\`. Opções: ${[...values]\n .map((value) => `\\`${value}\\``)\n .join(\", \")}.`,\n );\n }\n }\n }\n}\n\n/**\n * Exemplos de parâmetro de uma rota. O motor abre a tela sem cenário no `href`\n * montado com eles; sem exemplo e sem cenário que cubra a rota, a tela abriria\n * no caminho literal (`/requests/:id`), e isso é aviso.\n */\nfunction validateRouteParams(\n product: ProductDefinition,\n route: RouteDefinition,\n where: string,\n push: (level: ValidationIssue[\"level\"], where: string, message: string) => void,\n): void {\n const names = route.path\n .split(\"/\")\n .filter((segment) => segment.startsWith(\":\") || segment === \"*\")\n .map((segment) => (segment === \"*\" ? \"*\" : segment.slice(1)));\n const params = route.params;\n if (params !== undefined && (!params || typeof params !== \"object\" || Array.isArray(params))) {\n push(\"error\", where, \"`params`, quando informado, é um objeto de nome do parâmetro → valor de exemplo.\");\n return;\n }\n const examples = params ?? {};\n for (const [name, value] of Object.entries(examples)) {\n if (!names.includes(name)) {\n push(\"warning\", where, `\\`params.${name}\\` não é parâmetro de \\`${route.path}\\` e é ignorado.`);\n } else if (!isNonEmptyString(value)) {\n push(\"warning\", where, `\\`params.${name}\\` vazio: a tela abre com \\`:${name}\\` literal.`);\n }\n }\n\n const missing = names.filter((name) => name !== \"*\" && !isNonEmptyString(examples[name]));\n if (missing.length > 0) {\n const covered = (product.scenarios ?? []).some(\n (scenario) =>\n isNonEmptyString(scenario?.route) &&\n resolveRoute(product.routes ?? [], scenario.route.split(\"?\")[0] ?? scenario.route)?.definition.path ===\n route.path,\n );\n if (!covered) {\n push(\n \"warning\",\n where,\n `Sem exemplo para ${missing.map((name) => `\\`:${name}\\``).join(\", \")} e sem cenário na rota: a tela abre no caminho literal \\`${route.path}\\`. Declare \\`params: { ${missing.map((name) => `${name}: \"…\"`).join(\", \")} }\\`.`,\n );\n }\n return;\n }\n\n // Com todos os exemplos, o caminho montado precisa cair nesta mesma rota — um\n // exemplo igual a um segmento literal de outra rota abriria a outra tela.\n if (names.length > 0) {\n const href = screenHref(route.path, examples);\n const match = resolveRoute(product.routes ?? [], href);\n if (match && match.definition.path !== route.path) {\n push(\n \"warning\",\n where,\n `Os exemplos de \\`params\\` montam \\`${href}\\`, que abre a rota \\`${match.definition.path}\\`, não esta.`,\n );\n }\n }\n}\n\nfunction matchesAnyRoute(route: string, product: ProductDefinition): boolean {\n const path = route.split(\"?\")[0] ?? route;\n return (product.routes ?? []).some((definition) => matchPathShape(definition.path, path));\n}\n\n/**\n * Casamento de forma de rota, usado pela validação. O casamento com extração de\n * parâmetros vive em `router/`; aqui só interessa \"existe rota compatível\".\n */\nfunction matchPathShape(pattern: string, path: string): boolean {\n const patternSegments = pattern.split(\"/\").filter(Boolean);\n const pathSegments = path.split(\"/\").filter(Boolean);\n\n for (const [index, segment] of patternSegments.entries()) {\n if (segment === \"*\") return true;\n const actual = pathSegments[index];\n if (actual === undefined) return false;\n if (segment.startsWith(\":\")) continue;\n if (segment !== actual) return false;\n }\n\n return patternSegments.length === pathSegments.length;\n}\n\n/** `true` quando existe pelo menos uma violação de nível `error`. */\nexport function hasErrors(issues: ValidationIssue[]): boolean {\n return issues.some((issue) => issue.level === \"error\");\n}\n\n/** Formata as violações para saída de terminal, usada no CI e em testes. */\nexport function formatIssues(issues: ValidationIssue[]): string {\n if (issues.length === 0) return \"Nenhum problema encontrado.\";\n return issues\n .map((issue) => `${issue.level === \"error\" ? \"✖\" : \"▲\"} ${issue.where}\\n ${issue.message}`)\n .join(\"\\n\");\n}\n","/**\n * Escopo de foco para revisão e handoff.\n *\n * O formato usa parâmetros repetíveis e legíveis em vez de um payload opaco:\n * `handoff=1&allowScenario=...&allowRoute=...&allowComponent=...`.\n */\n\nimport { matchPath } from \"../router/index.js\";\nimport type { HandoffScope, Scenario } from \"../types/index.js\";\n\nexport const HANDOFF_PARAM = {\n enabled: \"handoff\",\n scenario: \"allowScenario\",\n route: \"allowRoute\",\n component: \"allowComponent\",\n} as const;\n\n/** Lê a allowlist. Ausência de `handoff=1` significa catálogo sem recorte. */\nexport function parseHandoffScope(params: URLSearchParams): HandoffScope | undefined {\n if (params.get(HANDOFF_PARAM.enabled) !== \"1\") return undefined;\n return normalizeHandoffScope({\n scenarios: params.getAll(HANDOFF_PARAM.scenario),\n routes: params.getAll(HANDOFF_PARAM.route),\n components: params.getAll(HANDOFF_PARAM.component),\n });\n}\n\n/** Escreve a allowlist de forma determinística, preservando um escopo vazio. */\nexport function applyHandoffScope(\n params: URLSearchParams,\n scope: HandoffScope | undefined,\n): void {\n for (const param of Object.values(HANDOFF_PARAM)) params.delete(param);\n if (!scope) return;\n\n params.set(HANDOFF_PARAM.enabled, \"1\");\n const normalized = normalizeHandoffScope(scope);\n for (const id of normalized.scenarios ?? []) params.append(HANDOFF_PARAM.scenario, id);\n for (const route of normalized.routes ?? []) params.append(HANDOFF_PARAM.route, route);\n for (const id of normalized.components ?? []) params.append(HANDOFF_PARAM.component, id);\n}\n\n/** Remove duplicatas, vazios e diferenças de ordem que tornariam a URL instável. */\nexport function normalizeHandoffScope(scope: HandoffScope): HandoffScope {\n const scenarios = normalizeList(scope.scenarios);\n const routes = normalizeList(scope.routes);\n const components = normalizeList(scope.components);\n return {\n ...(scenarios.length ? { scenarios } : {}),\n ...(routes.length ? { routes } : {}),\n ...(components.length ? { components } : {}),\n };\n}\n\nexport function handoffAllowsScenario(\n scope: HandoffScope | undefined,\n scenarioId: string | undefined,\n): boolean {\n return !scope || Boolean(scenarioId && scope.scenarios?.includes(scenarioId));\n}\n\nexport function handoffAllowsComponent(\n scope: HandoffScope | undefined,\n componentId: string | undefined,\n): boolean {\n return !scope || Boolean(componentId && scope.components?.includes(componentId));\n}\n\n/**\n * A raiz é sempre permitida: o chrome a redireciona para o primeiro item do\n * recorte. Fora dela, uma rota precisa estar explícita ou pertencer a um\n * cenário permitido.\n */\nexport function handoffAllowsPath(\n scope: HandoffScope | undefined,\n path: string,\n scenarios: readonly Scenario[] = [],\n): boolean {\n if (!scope || path === \"/\") return true;\n const patterns = [\n ...(scope.routes ?? []),\n ...scenarios\n .filter((scenario) => handoffAllowsScenario(scope, scenario.id))\n .map((scenario) => scenario.route),\n ];\n return patterns.some((pattern) => matchPath(pattern, path) !== null);\n}\n\nfunction normalizeList(values: readonly string[] | undefined): string[] {\n return [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))].sort();\n}\n","/**\n * Nomes dos parâmetros de URL, em um módulo próprio.\n *\n * Separado de `state.ts` porque `deploy/` também precisa deste mapa para montar\n * deep links, e importar o estado inteiro criaria dependência circular. Mais\n * importante: com o mapa em um só lugar, é impossível um override de teste\n * escrever `inspector=0` quando a URL real usa `panel=0`.\n */\n\nimport type { ControlsState } from \"../types/index.js\";\nimport { HANDOFF_PARAM, applyHandoffScope } from \"../handoff/index.js\";\n\n/** Nomes curtos: a URL é colada em Slack, em ticket e em thread de revisão. */\nexport const PARAM = {\n scenario: \"scenario\",\n component: \"component\",\n persona: \"persona\",\n fixture: \"fixture\",\n network: \"network\",\n viewport: \"viewport\",\n customWidth: \"w\",\n themeMode: \"theme\",\n locale: \"locale\",\n dataSource: \"source\",\n chromeTheme: \"appearance\",\n chrome: \"chrome\",\n inspector: \"panel\",\n panelTab: \"tab\",\n zoom: \"zoom\",\n rotated: \"rotate\",\n highlight: \"highlight\",\n} as const satisfies Record<Exclude<keyof ControlsState, \"handoff\" | \"screenControls\">, string>;\n\n/**\n * Prefixo dos controles da tela na URL: `c.<id>=<value>`. O prefixo separa os\n * controles declarados pelo produto dos parâmetros do motor, então um controle\n * chamado `persona` não colide com a persona.\n */\nexport const CONTROL_PARAM_PREFIX = \"c.\";\n\nconst ENGINE_PARAMS: ReadonlySet<string> = new Set([\n ...Object.values(PARAM),\n ...Object.values(HANDOFF_PARAM),\n]);\n\n/**\n * Parâmetro que o motor lê: os de {@link PARAM}, os do handoff e os `c.*`. O\n * resto da query é da tela do produto, e o motor só o carrega.\n */\nexport function isEngineParam(key: string): boolean {\n return key.startsWith(CONTROL_PARAM_PREFIX) || ENGINE_PARAMS.has(key);\n}\n\n/** Os `c.<id>` de uma query string, como id → value. */\nexport function readControlParams(search: string | URLSearchParams): Record<string, string> {\n const params = typeof search === \"string\" ? new URLSearchParams(search) : search;\n const values: Record<string, string> = {};\n for (const [key, value] of params) {\n if (!key.startsWith(CONTROL_PARAM_PREFIX)) continue;\n const id = key.slice(CONTROL_PARAM_PREFIX.length);\n if (id) values[id] = value;\n }\n return values;\n}\n\n/** Remove todos os `c.<id>` de uma query. */\nexport function deleteControlParams(params: URLSearchParams): void {\n for (const key of [...params.keys()]) {\n if (key.startsWith(CONTROL_PARAM_PREFIX)) params.delete(key);\n }\n}\n\n/**\n * Serializa um valor de controle para a query string.\n *\n * Booleano vira `1`/`0` e não `true`/`false`: é o que o parser espera, e a URL\n * fica mais curta.\n */\nexport function serializeValue(value: unknown): string {\n if (typeof value === \"boolean\") return value ? \"1\" : \"0\";\n return String(value);\n}\n\n/**\n * Aplica overrides de {@link ControlsState} em uma `URLSearchParams`, traduzindo\n * as chaves do estado para os nomes de parâmetro.\n */\nexport function applyOverrides(\n params: URLSearchParams,\n overrides: Partial<ControlsState> = {},\n): void {\n for (const [key, value] of Object.entries(overrides)) {\n if (value === undefined || value === null) continue;\n if (key === \"handoff\") {\n applyHandoffScope(params, value as ControlsState[\"handoff\"]);\n continue;\n }\n if (key === \"screenControls\") {\n for (const [id, control] of Object.entries(value as Record<string, string>)) {\n params.set(`${CONTROL_PARAM_PREFIX}${id}`, control);\n }\n continue;\n }\n const param = PARAM[key as Exclude<keyof ControlsState, \"handoff\" | \"screenControls\">];\n if (!param) continue;\n params.set(param, serializeValue(value));\n }\n}\n","/**\n * Protocolo entre o chrome e o quadro.\n *\n * A UI do produto roda dentro de um `<iframe>` da mesma origem e do mesmo\n * bundle, aberto com `ds-frame=1`. Duas razões, as duas concretas:\n *\n * 1. **Isolamento de CSS nos dois sentidos.** O preflight e o `body` do produto\n * não alcançam o chrome, e o chrome não alcança o produto.\n * 2. **Viewport real.** A largura do quadro é a largura da janela que o produto\n * enxerga, então `@media` funciona como em produção.\n *\n * Os dois documentos conversam só por `postMessage`, e cada lado só aceita\n * mensagem da mesma origem **e** da janela esperada — o pai aceita do próprio\n * quadro, o quadro aceita do próprio pai. Qualquer outra coisa é ignorada.\n */\n\nimport { PARAM } from \"../controls/params.js\";\n\n/** Parâmetro que põe `<DesignSpace>` em modo quadro. */\nexport const FRAME_PARAM = \"ds-frame\";\n\n/** Atributo do `<iframe>` do chrome. Serve de seletor para testes. */\nexport const FRAME_ATTRIBUTE = \"data-ds-frame\";\n\n/**\n * Atributo com que o produto marca a raiz de um componente na UI:\n * `data-ds-component=\"<id do catálogo>\"`. É o que o destaque de componentes\n * contorna; o motor não adivinha o que é componente.\n */\nexport const COMPONENT_ATTRIBUTE = \"data-ds-component\";\n\n/**\n * Parâmetros que só o chrome lê. Ficam fora do endereço do quadro: trocar zoom\n * ou tema do chrome não é assunto da UI do produto.\n */\nexport const CHROME_ONLY_PARAMS: readonly string[] = [\n PARAM.chromeTheme,\n PARAM.chrome,\n PARAM.inspector,\n PARAM.panelTab,\n PARAM.zoom,\n PARAM.rotated,\n];\n\n/**\n * Atalhos do chrome que o quadro repassa: revisão limpa (Shift+C), busca da\n * lateral (Cmd/Ctrl+K) e filtro do painel (Cmd/Ctrl+F).\n */\nexport type FrameShortcut = \"C\" | \"K\" | \"F\";\n\nexport type FrameMessage =\n /** Quadro → pai: montou, neste endereço. */\n | { ds: 1; type: \"ready\"; url: string }\n /** Quadro → pai: a UI do produto navegou. */\n | { ds: 1; type: \"navigate\"; url: string; replace: boolean }\n /** Quadro → pai: atalho do chrome pressionado com o foco dentro do quadro. */\n | { ds: 1; type: \"shortcut\"; key: FrameShortcut }\n /** Pai → quadro: novo estado, sem recarregar. */\n | { ds: 1; type: \"location\"; url: string };\n\n/**\n * Endereço do quadro para um estado do chrome: mesmo caminho, mesma query sem os\n * parâmetros do chrome, e `ds-frame=1` no fim. Determinística: o pai e o quadro\n * chegam à mesma string para o mesmo estado, e é isso que evita recarga à toa.\n */\nexport function toFrameUrl(path: string, search: string): string {\n const params = new URLSearchParams(search);\n for (const name of CHROME_ONLY_PARAMS) params.delete(name);\n params.delete(FRAME_PARAM);\n params.set(FRAME_PARAM, \"1\");\n return `${path || \"/\"}?${params.toString()}`;\n}\n\n/** Caminho e query de um endereço do quadro, sem o parâmetro de modo. */\nexport function fromFrameUrl(url: string): { path: string; search: string } {\n const parsed = new URL(url, \"http://design-space.invalid\");\n parsed.searchParams.delete(FRAME_PARAM);\n const query = parsed.searchParams.toString();\n return { path: parsed.pathname || \"/\", search: query ? `?${query}` : \"\" };\n}\n\n/**\n * O que obriga a trocar o `src` do quadro: outra tela (caminho) ou outro\n * componente. O resto — variação, persona, rede, dados — vai por mensagem.\n */\nexport function frameKey(url: string): string {\n const parsed = new URL(url, \"http://design-space.invalid\");\n return `${parsed.pathname}|${parsed.searchParams.get(PARAM.component) ?? \"\"}`;\n}\n\n/**\n * Query do quadro com os parâmetros do chrome que estavam no pai. Uma navegação\n * iniciada pelo produto não pode desligar o painel nem trocar o zoom.\n */\nexport function mergeChromeParams(frameSearch: string, parentSearch: string): string {\n const next = new URLSearchParams(frameSearch);\n const parent = new URLSearchParams(parentSearch);\n next.delete(FRAME_PARAM);\n for (const name of CHROME_ONLY_PARAMS) {\n next.delete(name);\n const value = parent.get(name);\n if (value !== null) next.set(name, value);\n }\n const query = next.toString();\n return query ? `?${query}` : \"\";\n}\n\nfunction isFrameMessage(data: unknown): data is FrameMessage {\n if (!data || typeof data !== \"object\") return false;\n const message = data as Partial<FrameMessage>;\n if (message.ds !== 1 || typeof message.type !== \"string\") return false;\n switch (message.type) {\n case \"ready\":\n case \"location\":\n return typeof (message as { url?: unknown }).url === \"string\";\n case \"navigate\":\n return typeof (message as { url?: unknown }).url === \"string\";\n case \"shortcut\":\n return [\"C\", \"K\", \"F\"].includes((message as { key?: unknown }).key as string);\n default:\n return false;\n }\n}\n\n/**\n * Aceita uma mensagem só quando vem da mesma origem e da janela esperada, e tem\n * a forma do protocolo. Qualquer outra — extensão, outro iframe, outra aba —\n * devolve `undefined`.\n */\nexport function acceptFrameMessage(\n event: Pick<MessageEvent, \"origin\" | \"source\" | \"data\">,\n expected: { origin: string; source: MessageEventSource | null | undefined },\n): FrameMessage | undefined {\n if (event.origin !== expected.origin) return undefined;\n if (!expected.source || event.source !== expected.source) return undefined;\n return isFrameMessage(event.data) ? event.data : undefined;\n}\n\n/** Envia para a outra janela, sempre restrito à própria origem. */\nexport function postFrameMessage(\n target: Window | null | undefined,\n message: FrameMessage,\n origin: string,\n): void {\n try {\n target?.postMessage(message, origin);\n } catch {\n // Janela fechada ou em outra origem: nada a sincronizar.\n }\n}\n\n/**\n * `true` quando este documento é o quadro: pedido pela URL ou carregado dentro\n * do `<iframe>` do chrome. O segundo caso cobre uma navegação completa dentro do\n * quadro que perdeu o parâmetro — sem ele, o chrome renderizaria dentro de si.\n */\nexport function isFrameMode(win: Window | undefined = typeof window === \"undefined\" ? undefined : window): boolean {\n if (!win) return false;\n if (new URLSearchParams(win.location.search).get(FRAME_PARAM) === \"1\") return true;\n try {\n return Boolean(win.frameElement?.hasAttribute(FRAME_ATTRIBUTE));\n } catch {\n return false;\n }\n}\n","/**\n * Contexto de deployment e deep links (§10.3).\n *\n * O motor não conhece provedor de hospedagem. Ele recebe o contexto do produto —\n * `ProductDefinition.deploy` — e monta a URL absoluta de qualquer cenário sem\n * domínio hardcoded, que é o que faz o botão \"copiar link\" funcionar igual em\n * localhost, em preview e em produção.\n *\n * Não existe detecção automática aqui, e a razão é concreta: o motor é uma\n * biblioteca já compilada, então o `import.meta.env` deste arquivo foi resolvido\n * no build do **pacote**, não no build do produto. Ler ambiente daqui nunca\n * funcionou em produto real — ver 0.1.1 no `CHANGELOG.md`. Quem tem acesso ao\n * próprio ambiente de build é o produto, então é ele quem informa.\n *\n * Design Space sem hospedagem nenhuma é caso suportado, não degradação: sem\n * contexto, `env` é `development`, a origem é a da janela e o cabeçalho da\n * revisão omite branch e commit.\n */\n\nimport type {\n ComponentPreview,\n ControlsState,\n DeployOverrides,\n Scenario,\n} from \"../types/index.js\";\nimport { PARAM, applyOverrides } from \"../controls/params.js\";\n\nexport type DeployContext = {\n /** `development`, `preview` ou `production`. */\n env: string;\n /** Origem absoluta, com protocolo, sem barra final. */\n origin: string;\n /** Domínio estável da branch, quando em preview. */\n branchUrl: string | undefined;\n /** Domínio único deste deployment. Imutável. */\n deploymentUrl: string | undefined;\n /** Nome da branch, para rotular a revisão na interface. */\n branch: string | undefined;\n /** Commit exato do deployment, para rastrear a versão revisada. */\n commit: string | undefined;\n /** Primeiros 7 caracteres do commit. */\n shortCommit: string | undefined;\n /** `true` quando o produto informou preview ou produção. */\n isDeployed: boolean;\n};\n\n/**\n * Monta o contexto do deployment a partir do que o produto informou.\n *\n * Campo ausente ou vazio cai no padrão local — string vazia é o que um `define`\n * de bundler produz quando a variável não existe, e um cabeçalho de revisão com\n * branch vazia é pior que um sem branch.\n */\nexport function getDeployContext(overrides: DeployOverrides = {}): DeployContext {\n const branchUrl = overrides.branchUrl || undefined;\n const deploymentUrl = overrides.deploymentUrl || undefined;\n const commit = overrides.commit || undefined;\n const env = overrides.env || \"development\";\n\n // Preferência deliberada: a URL de branch é estável e sempre reflete o último\n // commit daquela branch, que é o que se quer ao circular um cenário em\n // revisão (§10.2). A URL de commit é montada por `commitUrl`, não aqui.\n const origin =\n (branchUrl && `https://${branchUrl}`) ||\n (deploymentUrl && `https://${deploymentUrl}`) ||\n (typeof window !== \"undefined\" ? window.location.origin : \"http://localhost:5173\");\n\n return {\n env,\n origin: origin.replace(/\\/$/, \"\"),\n branchUrl,\n deploymentUrl,\n branch: overrides.branch || undefined,\n commit,\n shortCommit: commit?.slice(0, 7),\n isDeployed: env === \"preview\" || env === \"production\",\n };\n}\n\n/**\n * URL absoluta de um cenário: rota mais os controles necessários para\n * reproduzir a situação. É o link que um PO envia sem precisar explicar\n * nenhuma sequência manual anterior.\n */\nexport function scenarioUrl(\n scenario: Scenario,\n options: { origin?: string; overrides?: Partial<ControlsState> } = {},\n): string {\n const origin = options.origin ?? getDeployContext().origin;\n const url = new URL(scenario.route, origin);\n\n url.searchParams.set(PARAM.scenario, scenario.id);\n if (scenario.persona) url.searchParams.set(PARAM.persona, scenario.persona);\n url.searchParams.set(PARAM.fixture, scenario.fixture);\n if (scenario.network && scenario.network !== \"success\") {\n url.searchParams.set(PARAM.network, scenario.network);\n }\n\n applyOverrides(url.searchParams, options.overrides);\n\n return url.toString();\n}\n\n/** URL absoluta de um preview de componente, incluindo sua fixture isolada. */\nexport function componentUrl(\n component: ComponentPreview,\n options: {\n origin?: string;\n fixture?: string;\n overrides?: Partial<ControlsState>;\n } = {},\n): string {\n const origin = options.origin ?? getDeployContext().origin;\n const url = new URL(\"/\", origin);\n const fixture =\n options.fixture ??\n component.fixtures?.find((item) => item.id === component.defaultFixture)?.id ??\n component.fixtures?.[0]?.id;\n\n url.searchParams.set(PARAM.component, component.id);\n if (fixture) url.searchParams.set(PARAM.fixture, fixture);\n applyOverrides(url.searchParams, options.overrides);\n\n return url.toString();\n}\n\n/**\n * URL imutável de um cenário num commit exato (§10.2). Serve para citar em\n * ticket ou thread uma versão que não muda de conteúdo depois de discutida.\n *\n * O formato da URL é do provedor, não do motor, então vem do produto como\n * template com `{commit}` ou `{shortCommit}`:\n *\n * ```ts\n * commitUrl(scenario, { template: \"https://acme-{shortCommit}-time.example.app\" });\n * commitUrl(scenario, { template: \"https://{commit}.review.acme.dev\" });\n * ```\n *\n * Sem commit não há versão rastreável, e a função devolve `undefined` em vez\n * de um link que aponta para o lugar errado.\n */\nexport function commitUrl(\n scenario: Scenario,\n options: { template: string; commit?: string },\n): string | undefined {\n const commit = options.commit ?? getDeployContext().commit;\n if (!commit) return undefined;\n\n const origin = options.template\n .replaceAll(\"{shortCommit}\", commit.slice(0, 7))\n .replaceAll(\"{commit}\", commit);\n\n return scenarioUrl(scenario, { origin });\n}\n"],"names":["NETWORK_STATES","matchPath","pattern","path","patternSegments","pathSegments","decodePath","params","index","segment","actual","resolveRoute","routes","ranked","a","b","specificity","definition","screenHref","example","name","value","segments","rest","score","withoutQuery","ID_PATTERN","CONTROL_ID_PATTERN","isNonEmptyString","validateScenario","scenario","issues","where","err","message","warn","validateProduct","product","push","level","personaIds","p","fixtureIds","f","ruleIds","r","scenarioIds","routePaths","route","validateControlGroups","componentIds","component","componentFixtureIds","fixtureIndex","fixture","fixtureWhere","validateRouteParams","group","rule","match","groups","controls","control","id","option","matchesAnyRoute","defaultSource","routeWhere","groupIds","controlIds","controlIndex","controlWhere","options","values","names","examples","missing","href","matchPathShape","hasErrors","issue","formatIssues","HANDOFF_PARAM","parseHandoffScope","normalizeHandoffScope","applyHandoffScope","scope","param","normalized","scenarios","normalizeList","components","handoffAllowsScenario","scenarioId","handoffAllowsComponent","componentId","handoffAllowsPath","PARAM","CONTROL_PARAM_PREFIX","ENGINE_PARAMS","isEngineParam","key","readControlParams","search","deleteControlParams","serializeValue","applyOverrides","overrides","FRAME_PARAM","FRAME_ATTRIBUTE","COMPONENT_ATTRIBUTE","CHROME_ONLY_PARAMS","toFrameUrl","fromFrameUrl","url","parsed","query","frameKey","mergeChromeParams","frameSearch","parentSearch","next","parent","isFrameMessage","data","acceptFrameMessage","event","expected","postFrameMessage","target","origin","isFrameMode","win","getDeployContext","branchUrl","deploymentUrl","commit","env","scenarioUrl","componentUrl","item","commitUrl"],"mappings":"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"}