@brucesantos/design-space 0.6.0 → 0.8.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 +177 -0
- package/README.md +137 -122
- package/dist/controls/params.d.ts +3 -5
- package/dist/controls/state.d.ts +39 -9
- package/dist/deploy/index.d.ts +4 -4
- package/dist/design-space.css +1 -1
- package/dist/frame/index.d.ts +93 -0
- package/dist/handoff/index.d.ts +3 -2
- package/dist/index-FIzKHaWE.js +345 -0
- package/dist/index-FIzKHaWE.js.map +1 -0
- package/dist/index.d.ts +6 -9
- package/dist/index.js +1740 -1988
- package/dist/index.js.map +1 -1
- package/dist/registry/index.d.ts +52 -27
- package/dist/shell/Canvas.d.ts +19 -0
- package/dist/shell/FrameView.d.ts +9 -0
- package/dist/shell/Panel.d.ts +30 -0
- package/dist/shell/Resizer.d.ts +14 -0
- package/dist/shell/Sidebar.d.ts +15 -7
- package/dist/shell/Stage.d.ts +0 -20
- package/dist/shell/Topbar.d.ts +20 -12
- package/dist/shell/icons.d.ts +9 -0
- package/dist/shell/labels.d.ts +71 -119
- package/dist/shell/prMarkdown.d.ts +15 -0
- package/dist/shell/storage.d.ts +14 -0
- package/dist/testing/index.d.ts +9 -11
- package/dist/testing.js +20 -31
- package/dist/testing.js.map +1 -1
- package/dist/types/index.d.ts +58 -124
- package/dist/version.d.ts +2 -0
- package/package.json +3 -3
- package/dist/a11y/accessible-tree.d.ts +0 -37
- package/dist/a11y/contrast.d.ts +0 -62
- package/dist/a11y/useKeyboardMode.d.ts +0 -23
- package/dist/contrast-B8xa1UIu.js +0 -389
- package/dist/contrast-B8xa1UIu.js.map +0 -1
- package/dist/shell/Controls.d.ts +0 -11
- package/dist/shell/Home.d.ts +0 -12
- package/dist/shell/Inspector.d.ts +0 -13
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index-FIzKHaWE.js","sources":["../src/types/index.ts","../src/registry/validate.ts","../src/router/index.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\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\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 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 /** Navega dentro do Design Space preservando os controles ativos. */\n navigate: (to: string) => void;\n /** Abre outro cenário por id. */\n openScenario: (scenarioId: string) => void;\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\n/** Abas do painel direito do chrome. */\nexport type PanelTab = \"variations\" | \"info\";\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 ProductDefinition,\n type Scenario,\n} from \"../types/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\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 (\"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 }\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 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?.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\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 * 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 * 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 * 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 { 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} as const satisfies Record<Exclude<keyof ControlsState, \"handoff\">, string>;\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 const param = PARAM[key as Exclude<keyof ControlsState, \"handoff\">];\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 * 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","ID_PATTERN","isNonEmptyString","value","validateScenario","scenario","index","issues","where","err","message","warn","validateProduct","product","push","level","personaIds","p","fixtureIds","f","ruleIds","r","scenarioIds","routePaths","route","componentIds","component","componentFixtureIds","fixtureIndex","fixture","fixtureWhere","rule","matchesAnyRoute","defaultSource","a","path","definition","matchPathShape","pattern","patternSegments","pathSegments","segment","actual","hasErrors","issue","formatIssues","matchPath","decodePath","params","resolveRoute","routes","ranked","b","specificity","segments","score","withoutQuery","HANDOFF_PARAM","parseHandoffScope","normalizeHandoffScope","applyHandoffScope","scope","param","normalized","id","scenarios","normalizeList","components","handoffAllowsScenario","scenarioId","handoffAllowsComponent","componentId","handoffAllowsPath","values","PARAM","serializeValue","applyOverrides","overrides","key","FRAME_PARAM","FRAME_ATTRIBUTE","CHROME_ONLY_PARAMS","toFrameUrl","search","name","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","options","componentUrl","item","commitUrl"],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -7,20 +7,17 @@
|
|
|
7
7
|
* (Princípio 10).
|
|
8
8
|
*/
|
|
9
9
|
export { DesignSpace, type DesignSpaceProps } from './shell/DesignSpace.js';
|
|
10
|
-
export {
|
|
11
|
-
export {
|
|
12
|
-
export {
|
|
13
|
-
export { createRegistry, type ComponentFixtureResolution, type ModuleNode, type Registry, type ScenarioQueryOptions, } from './registry/index.js';
|
|
10
|
+
export { StageEmpty } from './shell/Stage.js';
|
|
11
|
+
export { DEFAULT_LABELS, EN_US_LABELS, NETWORK_LABELS, resolveLabels, useLabels, type Labels, type LabelsOverride, } from './shell/labels.js';
|
|
12
|
+
export { createRegistry, normalizeSearch, type ComponentFixtureResolution, type Registry, type ScenarioQueryOptions, type ScreenNode, } from './registry/index.js';
|
|
14
13
|
export { formatIssues, hasErrors, validateProduct, validateScenario, type ValidationIssue, } from './registry/validate.js';
|
|
15
14
|
export { matchPath, resolveRoute, type RouteMatch } from './router/index.js';
|
|
16
|
-
export {
|
|
15
|
+
export { VIEWPORTS, ZOOM_DEFAULT, ZOOM_MAX, ZOOM_MIN, clampZoom, parseControls, resolveViewport, serializeControls, useDesignSpaceState, type DesignSpaceState, type DesignSpaceStateOptions, type DesignSpaceLocation, } from './controls/state.js';
|
|
16
|
+
export { FRAME_ATTRIBUTE, FRAME_PARAM } from './frame/index.js';
|
|
17
17
|
export { PARAM, applyOverrides, serializeValue } from './controls/params.js';
|
|
18
18
|
export { HANDOFF_PARAM, applyHandoffScope, handoffAllowsComponent, handoffAllowsPath, handoffAllowsScenario, normalizeHandoffScope, parseHandoffScope, } from './handoff/index.js';
|
|
19
19
|
export { SLOW_NETWORK_DELAY_MS, SimulatedNetworkError, createHttpAdapter, fixtureAdapter, resolveFixture, } from './adapters/index.js';
|
|
20
20
|
export { useScenarioData, type ScenarioData } from './adapters/useScenarioData.js';
|
|
21
21
|
export { commitUrl, componentUrl, getDeployContext, scenarioUrl, type DeployContext, } from './deploy/index.js';
|
|
22
|
-
export { CONTRAST_THRESHOLDS, assertContrastPairs, checkContrastPair, checkContrastPairs, contrastRatio, flatten, parseColor, readCssVariable, relativeLuminance, type ContrastResult, type Rgb, } from './a11y/contrast.js';
|
|
23
|
-
export { computeRole, describeElement, shortSelector, tabbableElements, type AccessibleNode, } from './a11y/accessible-tree.js';
|
|
24
|
-
export { useKeyboardMode, type KeyboardModeResult, type TabStop, } from './a11y/useKeyboardMode.js';
|
|
25
22
|
export { ageInYears, daysBetween, parseIsoDate } from './util/date.js';
|
|
26
|
-
export { NETWORK_STATES,
|
|
23
|
+
export { NETWORK_STATES, type ComponentPreview, type ComponentPreviewFixture, type ComponentPreviewProps, type ChromeTheme, type ControlsState, type DeployOverrides, type DataRequest, type DataSourceAdapter, type Fixture, type HandoffScope, type NetworkState, type PanelTab, type Persona, type ProductDefinition, type ProductTheme, type Rule, type RouteDefinition, type Scenario, type ScenarioContext, type ScreenProps, type ViewportSetting, } from './types/index.js';
|