@brucesantos/design-space 0.1.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 +76 -0
- package/README.md +146 -0
- package/dist/a11y/accessible-tree.d.ts +37 -0
- package/dist/a11y/contrast.d.ts +62 -0
- package/dist/a11y/useKeyboardMode.d.ts +23 -0
- package/dist/adapters/index.d.ts +37 -0
- package/dist/adapters/useScenarioData.d.ts +12 -0
- package/dist/contrast-MPoK6VR1.js +265 -0
- package/dist/contrast-MPoK6VR1.js.map +1 -0
- package/dist/controls/params.d.ts +30 -0
- package/dist/controls/state.d.ts +43 -0
- package/dist/deploy/index.d.ts +42 -0
- package/dist/design-space.css +1 -0
- package/dist/index.d.ts +25 -0
- package/dist/index.js +1404 -0
- package/dist/index.js.map +1 -0
- package/dist/registry/index.d.ts +35 -0
- package/dist/registry/validate.d.ts +21 -0
- package/dist/router/index.d.ts +15 -0
- package/dist/shell/Controls.d.ts +8 -0
- package/dist/shell/DesignSpace.d.ts +5 -0
- package/dist/shell/Home.d.ts +6 -0
- package/dist/shell/Inspector.d.ts +11 -0
- package/dist/shell/Sidebar.d.ts +7 -0
- package/dist/shell/Stage.d.ts +25 -0
- package/dist/shell/Topbar.d.ts +13 -0
- package/dist/shell/labels.d.ts +5 -0
- package/dist/testing/index.d.ts +45 -0
- package/dist/testing.js +42 -0
- package/dist/testing.js.map +1 -0
- package/dist/types/index.d.ts +310 -0
- package/dist/util/date.d.ts +40 -0
- package/package.json +67 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contrast-MPoK6VR1.js","sources":["../src/types/index.ts","../src/registry/validate.ts","../src/controls/params.ts","../src/deploy/index.ts","../src/a11y/contrast.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/* ------------------------------------------------------------------ *\n * Ciclo de vida\n * ------------------------------------------------------------------ */\n\n/**\n * Estado de ciclo de vida do cenário (§18.1). Existe para evitar que a\n * referência envelheça em silêncio quando o produto real muda.\n */\nexport type ScenarioStatus =\n | \"proposed\"\n | \"in-review\"\n | \"approved\"\n | \"in-implementation\"\n | \"implemented\"\n | \"superseded\";\n\nexport const SCENARIO_STATUSES: readonly ScenarioStatus[] = [\n \"proposed\",\n \"in-review\",\n \"approved\",\n \"in-implementation\",\n \"implemented\",\n \"superseded\",\n] as const;\n\n/* ------------------------------------------------------------------ *\n * Acessibilidade (§6.1) — dimensão de primeira classe, não auditoria final\n * ------------------------------------------------------------------ */\n\n/** Nível de conformidade alvo. O padrão interno é WCAG 2.2 AA. */\nexport type ContrastTarget = \"AA\" | \"AAA\";\n\n/** Quanto da jornada precisa ser completável só por teclado. */\nexport type KeyboardCoverage = \"full\" | \"partial\" | \"not-applicable\";\n\nexport type A11yContract = {\n /**\n * `full` significa: a jornada declarada por este cenário é completável do\n * início ao fim sem mouse, com foco visível em cada passo.\n */\n keyboard: KeyboardCoverage;\n /** Nível de contraste exigido para os tokens em uso nesta tela. */\n contrast: ContrastTarget;\n /**\n * Eventos que precisam ser anunciados para leitor de tela. São chaves de\n * domínio, não seletores: `claim.status`, `retry.result`.\n *\n * Um cenário de convênio recusado em que a recusa não é anunciada está\n * incompleto, não está pronto para aprovação.\n */\n announces?: string[];\n /** Observação de revisão humana. O automático é piso, não teto. */\n notes?: string;\n};\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: \"Recepcionista\". */\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/claims.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 /** `modulo.situacao` em kebab-case: `finance.insurance-denied`. */\n id: string;\n /** Título no vocabulário do negócio: \"Convênio recusado\". */\n title: string;\n /** Rota que o cenário abre. Precisa casar com uma rota do produto. */\n route: string;\n /** Id de uma persona registrada no produto. */\n persona: string;\n /**\n * Permissões efetivas do cenário. Quando ausente, herda as da persona.\n * Declarar aqui permite representar \"recepcionista sem permissão de\n * cancelamento\" 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 /** Contrato de acessibilidade da situação. */\n a11y: A11yContract;\n /** Estado de ciclo de vida. */\n status: ScenarioStatus;\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 /**\n * URL de commit que registra a aprovação (§10.2). Imutável por definição:\n * a aprovação não pode mudar de conteúdo debaixo de quem aprovou.\n */\n approvedAt?: { url: string; commit: string; date: string };\n /** Ticket de engenharia, quando o cenário estiver em implementação. */\n ticket?: string;\n};\n\n/* ------------------------------------------------------------------ *\n * Organização: módulo e jornada\n * ------------------------------------------------------------------ */\n\n/**\n * Uma jornada é uma sequência de passos com ramificações. Cada passo aponta\n * para um cenário, então uma jornada é navegável e testável sem duplicar\n * definição.\n */\nexport type Flow = {\n id: string;\n /** Título de negócio: \"Agendar uma consulta\". */\n title: string;\n description?: string;\n steps: FlowStep[];\n};\n\nexport type FlowStep = {\n /** Cenário que materializa este passo. */\n scenario: string;\n /** Rótulo do passo, quando diferir do título do cenário. */\n label?: string;\n /** Decisão tomada aqui, quando o passo ramifica. */\n decision?: string;\n /** Saídas alternativas: rótulo → id de cenário. */\n branches?: Record<string, string>;\n};\n\nexport type Module = {\n /** `agenda`, `patients`, `finance`. */\n id: string;\n /** Nome no vocabulário do cliente: \"Agenda\". */\n name: string;\n description?: string;\n /** Jornadas guiadas do módulo. Opcional: navegação livre é o padrão. */\n flows?: Flow[];\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\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 * 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 validar contraste e oferecer os controles de tema.\n */\nexport type ProductTheme = {\n /**\n * Pares de cores que precisam passar na validação de contraste.\n * Contraste é propriedade de par, então validar na definição do token\n * resolve na origem, uma vez, em vez de perseguir o problema em 30 telas.\n */\n contrastPairs?: ContrastPair[];\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\nexport type ContrastPair = {\n /** Nome do par: `fg-1 sobre bg-app`. */\n name: string;\n /** Cor de frente em hex, rgb() ou rgba(). */\n foreground: string;\n /** Cor de fundo. Precisa ser opaca. */\n background: string;\n /** `AA` por padrão. */\n target?: ContrastTarget;\n /** Texto grande (>=24px, ou >=18.66px bold) tem limiar menor. */\n largeText?: boolean;\n};\n\n/* ------------------------------------------------------------------ *\n * Definição do produto — a única coisa que o produto entrega ao motor\n * ------------------------------------------------------------------ */\n\nexport type ProductDefinition = {\n /** `bloomy`. */\n id: string;\n /** \"Bloomy\". */\n name: string;\n /** Uma linha sobre o produto, exibida na entrada do Design Space. */\n tagline?: string;\n modules: Module[];\n scenarios: Scenario[];\n personas: Persona[];\n fixtures: Fixture[];\n rules?: Rule[];\n routes: RouteDefinition[];\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 /** 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 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 /** Preferências de acessibilidade ativas no painel. */\n a11y: {\n keyboardMode: boolean;\n reducedMotion: boolean;\n /** Multiplicador de tamanho de texto: 1, 1.25, 1.5, 2. */\n textScale: number;\n };\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`. */\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/* ------------------------------------------------------------------ *\n * Estado dos controles — serializado na URL (deep link)\n * ------------------------------------------------------------------ */\n\nexport type ControlsState = {\n scenario: string | undefined;\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 /** Chrome do Design Space oculto: revisão limpa e captura de tela. */\n chrome: boolean;\n keyboardMode: boolean;\n reducedMotion: boolean;\n textScale: number;\n /** Painel lateral direito aberto. */\n inspector: boolean;\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 SCENARIO_STATUSES,\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:finance.insurance-denied`. */\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 o módulo como prefixo: `finance.insurance-denied`.\",\n );\n } else if (!scenario.id.includes(\".\")) {\n warn(\"`id` sem prefixo de módulo dificulta a navegação e a busca do agente.\");\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 (!isNonEmptyString(scenario?.persona)) err(\"`persona` é obrigatório.\");\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_STATUSES.includes(scenario?.status)) {\n err(`\\`status\\` deve ser um de: ${SCENARIO_STATUSES.join(\", \")}.`);\n }\n\n if (scenario?.network && !NETWORK_STATES.includes(scenario.network)) {\n err(`\\`network\\` deve ser um de: ${NETWORK_STATES.join(\", \")}.`);\n }\n\n const a11y = scenario?.a11y;\n if (!a11y || typeof a11y !== \"object\") {\n err(\n \"`a11y` é obrigatório. Acessibilidade é campo do contrato, não auditoria de fim de projeto (D-15).\",\n );\n } else {\n if (![\"full\", \"partial\", \"not-applicable\"].includes(a11y.keyboard)) {\n err(\"`a11y.keyboard` deve ser `full`, `partial` ou `not-applicable`.\");\n }\n if (![\"AA\", \"AAA\"].includes(a11y.contrast)) {\n err(\"`a11y.contrast` deve ser `AA` ou `AAA`. O padrão interno é WCAG 2.2 AA.\");\n }\n if (a11y.announces !== undefined && !Array.isArray(a11y.announces)) {\n err(\"`a11y.announces` deve ser uma lista de chaves de evento de domínio.\");\n }\n }\n\n // Gate do roadmap: não aprovar cenário de jornada crítica sem acessibilidade\n // verificada. O motor não sabe o que é crítico, então checa o que dá:\n // aprovado com teclado parcial é sinal de aprovação apressada.\n if (scenario?.status === \"approved\" && a11y?.keyboard === \"partial\") {\n warn(\n \"Cenário aprovado com `a11y.keyboard: \\\"partial\\\"`. Confirme que esta jornada não é crítica.\",\n );\n }\n\n if (scenario?.status === \"approved\" && !scenario.approvedAt) {\n warn(\n \"Cenário aprovado sem `approvedAt`. A aprovação deve ser registrada por URL de commit (§10.2), senão muda de conteúdo debaixo de quem aprovou.\",\n );\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 moduleIds = new Set(product.modules?.map((m) => m.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 if (!product.routes?.length) {\n push(\"error\", \"product\", \"`routes` está vazio: nenhum cenário conseguirá renderizar.\");\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 const modulePrefix = scenario.id.split(\".\")[0];\n if (modulePrefix && moduleIds.size > 0 && !moduleIds.has(modulePrefix)) {\n push(\n \"warning\",\n where,\n `Prefixo \\`${modulePrefix}\\` não corresponde a nenhum módulo registrado. O cenário não vai aparecer na navegação.`,\n );\n }\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 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 for (const module of product.modules ?? []) {\n for (const flow of module.flows ?? []) {\n const where = `flow:${module.id}/${flow.id}`;\n if (!flow.steps?.length) push(\"warning\", where, \"Jornada sem passos.\");\n for (const step of flow.steps ?? []) {\n if (!scenarioIds.has(step.scenario)) {\n push(\"error\", where, `Passo aponta para cenário inexistente: \\`${step.scenario}\\`.`);\n }\n for (const [label, target] of Object.entries(step.branches ?? {})) {\n if (!scenarioIds.has(target)) {\n push(\n \"error\",\n where,\n `Ramificação \"${label}\" aponta para cenário inexistente: \\`${target}\\`.`,\n );\n }\n }\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 * 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 `keyboardMode=1` quando a URL real usa `kb=1`.\n */\n\nimport type { ControlsState } from \"../types/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 persona: \"persona\",\n fixture: \"fixture\",\n network: \"network\",\n viewport: \"viewport\",\n customWidth: \"w\",\n themeMode: \"theme\",\n locale: \"locale\",\n dataSource: \"source\",\n chrome: \"chrome\",\n keyboardMode: \"kb\",\n reducedMotion: \"motion\",\n textScale: \"scale\",\n inspector: \"panel\",\n} as const satisfies Record<keyof ControlsState, 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 const param = PARAM[key as keyof ControlsState];\n if (!param) continue;\n params.set(param, serializeValue(value));\n }\n}\n","/**\n * Contexto de deployment e deep links (§10.3).\n *\n * A Vercel expõe o contexto do deployment como variável de ambiente. O motor lê\n * esse contexto e monta a URL absoluta de qualquer cenário sem nenhum domínio\n * hardcoded — que é o que permite o botão \"copiar link\" funcionar igual em\n * localhost, em preview de branch e em produção.\n *\n * As variáveis precisam do prefixo `VITE_` para chegar ao cliente. O template já\n * nasce com o mapeamento no `vite.config.ts`.\n */\n\nimport type { ControlsState, Scenario } 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, gravado junto com o status de aprovação do cenário. */\n commit: string | undefined;\n /** Primeiros 7 caracteres do commit. */\n shortCommit: string | undefined;\n /** `true` quando roda em preview ou produção na Vercel. */\n isDeployed: boolean;\n};\n\ntype EnvRecord = Record<string, string | undefined>;\n\nfunction readEnv(): EnvRecord {\n // `import.meta.env` só existe sob um bundler. Em Node (testes, scripts de CI)\n // cai para `process.env`, que é onde a Vercel também publica as variáveis.\n const viteEnv = (import.meta as unknown as { env?: EnvRecord }).env;\n if (viteEnv) return viteEnv;\n if (typeof process !== \"undefined\" && process.env) return process.env as EnvRecord;\n return {};\n}\n\n/** Lê o contexto do deployment. Seguro em SSR, em Node e no browser. */\nexport function getDeployContext(): DeployContext {\n const env = readEnv();\n\n const branchUrl = env.VITE_VERCEL_BRANCH_URL || env.VERCEL_BRANCH_URL;\n const deploymentUrl = env.VITE_VERCEL_URL || env.VERCEL_URL;\n const vercelEnv = env.VITE_VERCEL_ENV || env.VERCEL_ENV;\n const commit = env.VITE_VERCEL_GIT_COMMIT_SHA || env.VERCEL_GIT_COMMIT_SHA;\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 entra no registro de aprovação, 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: vercelEnv ?? \"development\",\n origin: origin.replace(/\\/$/, \"\"),\n branchUrl,\n deploymentUrl,\n branch: env.VITE_VERCEL_GIT_COMMIT_REF || env.VERCEL_GIT_COMMIT_REF,\n commit,\n shortCommit: commit?.slice(0, 7),\n isDeployed: vercelEnv === \"preview\" || vercelEnv === \"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 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/**\n * URL imutável de aprovação (§10.2). Aponta para o commit exato, então a\n * aprovação não muda de conteúdo debaixo de quem aprovou.\n *\n * Requer o escopo do projeto na Vercel, que é a parte do domínio depois do\n * hash e não está exposta como variável — por isso vem do produto.\n */\nexport function commitUrl(\n scenario: Scenario,\n options: { project: string; scope: string; commit?: string },\n): string | undefined {\n const commit = options.commit ?? getDeployContext().shortCommit;\n if (!commit) return undefined;\n const origin = `https://${options.project}-${commit}-${options.scope}.vercel.app`;\n return scenarioUrl(scenario, { origin });\n}\n","/**\n * Contraste (§6.1, \"No token\").\n *\n * Contraste é propriedade de par de cores, não de componente. Validar na\n * definição do token resolve na origem, uma vez, em vez de perseguir o mesmo\n * problema em trinta telas — e é por isso que esta função roda junto do build do\n * produto, não só no painel.\n *\n * Implementa a razão de contraste do WCAG 2.x, que é a mesma em 2.2.\n */\n\nimport type { ContrastPair, ContrastTarget } from \"../types/index.js\";\n\nexport type Rgb = { r: number; g: number; b: number; a: number };\n\n/** Limiares do WCAG 2.2: 1.4.3 (AA) e 1.4.6 (AAA). */\nexport const CONTRAST_THRESHOLDS = {\n AA: { normal: 4.5, large: 3 },\n AAA: { normal: 7, large: 4.5 },\n} as const;\n\nconst NAMED_COLORS: Record<string, string> = {\n white: \"#ffffff\",\n black: \"#000000\",\n transparent: \"#00000000\",\n};\n\n/**\n * Interpreta hex de 3, 4, 6 ou 8 dígitos, `rgb()`, `rgba()` e as três palavras\n * que aparecem em token de verdade. Devolve `undefined` para o que não sabe ler\n * — deliberadamente: um par que não pôde ser medido precisa aparecer como\n * \"não verificado\" no painel, não como aprovado.\n */\nexport function parseColor(input: string): Rgb | undefined {\n const value = input.trim().toLowerCase();\n const named = NAMED_COLORS[value];\n if (named) return parseColor(named);\n\n if (value.startsWith(\"#\")) {\n const hex = value.slice(1);\n const expand = (chunk: string) => Number.parseInt(chunk.repeat(2), 16);\n\n if (hex.length === 3 || hex.length === 4) {\n const [r, g, b, a] = [...hex];\n if (!r || !g || !b) return undefined;\n return { r: expand(r), g: expand(g), b: expand(b), a: a ? expand(a) / 255 : 1 };\n }\n\n if (hex.length === 6 || hex.length === 8) {\n const pair = (index: number) => Number.parseInt(hex.slice(index, index + 2), 16);\n const values = [pair(0), pair(2), pair(4)];\n if (values.some(Number.isNaN)) return undefined;\n return {\n r: values[0]!,\n g: values[1]!,\n b: values[2]!,\n a: hex.length === 8 ? pair(6) / 255 : 1,\n };\n }\n\n return undefined;\n }\n\n const functional = value.match(/^rgba?\\(([^)]+)\\)$/);\n if (functional?.[1]) {\n const parts = functional[1].split(/[\\s,/]+/).filter(Boolean);\n const [r, g, b, a] = parts.map(Number);\n if ([r, g, b].some((n) => n === undefined || Number.isNaN(n))) return undefined;\n return { r: r!, g: g!, b: b!, a: a === undefined || Number.isNaN(a) ? 1 : a };\n }\n\n return undefined;\n}\n\n/**\n * Compõe uma cor semitransparente sobre um fundo opaco.\n *\n * Importa porque metade dos tokens semânticos de produto real é\n * `rgba(43, 35, 91, 0.6)` — medir isso ignorando o alfa dá um resultado\n * otimista e falso.\n */\nexport function flatten(foreground: Rgb, background: Rgb): Rgb {\n if (foreground.a >= 1) return foreground;\n const mix = (fg: number, bg: number) => fg * foreground.a + bg * (1 - foreground.a);\n return {\n r: mix(foreground.r, background.r),\n g: mix(foreground.g, background.g),\n b: mix(foreground.b, background.b),\n a: 1,\n };\n}\n\n/** Luminância relativa (WCAG 2.x, definição de `relative luminance`). */\nexport function relativeLuminance({ r, g, b }: Rgb): number {\n const channel = (raw: number) => {\n const value = raw / 255;\n return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;\n };\n return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);\n}\n\n/** Razão de contraste entre 1 e 21. `undefined` quando alguma cor é ilegível. */\nexport function contrastRatio(foreground: string, background: string): number | undefined {\n const bg = parseColor(background);\n const fgRaw = parseColor(foreground);\n if (!bg || !fgRaw) return undefined;\n\n const fg = flatten(fgRaw, bg);\n const lighter = Math.max(relativeLuminance(fg), relativeLuminance(bg));\n const darker = Math.min(relativeLuminance(fg), relativeLuminance(bg));\n return (lighter + 0.05) / (darker + 0.05);\n}\n\nexport type ContrastResult = {\n pair: ContrastPair;\n target: ContrastTarget;\n /** `undefined` quando alguma das cores não pôde ser interpretada. */\n ratio: number | undefined;\n required: number;\n /** `undefined` quando não foi possível medir. Nunca `true` por omissão. */\n passes: boolean | undefined;\n /** Razão arredondada para exibição: \"4.62:1\". */\n label: string;\n};\n\nexport function checkContrastPair(pair: ContrastPair): ContrastResult {\n const target = pair.target ?? \"AA\";\n const required = pair.largeText\n ? CONTRAST_THRESHOLDS[target].large\n : CONTRAST_THRESHOLDS[target].normal;\n const ratio = contrastRatio(pair.foreground, pair.background);\n\n return {\n pair,\n target,\n ratio,\n required,\n passes: ratio === undefined ? undefined : ratio >= required,\n label: ratio === undefined ? \"não medido\" : `${ratio.toFixed(2)}:1`,\n };\n}\n\nexport function checkContrastPairs(pairs: ContrastPair[] = []): ContrastResult[] {\n return pairs.map(checkContrastPair);\n}\n\n/**\n * Falha o build quando algum par declarado não atinge o alvo.\n *\n * Chamado por um teste do produto (`tests/tokens.test.ts` no template), porque\n * validar tokens é responsabilidade do produto — o motor só sabe medir.\n */\nexport function assertContrastPairs(pairs: ContrastPair[]): void {\n const failures = checkContrastPairs(pairs).filter((result) => result.passes !== true);\n if (failures.length === 0) return;\n\n const detail = failures\n .map(\n (f) =>\n ` ✖ ${f.pair.name}: ${f.label} (mínimo ${f.required}:1 para ${f.target}` +\n `${f.pair.largeText ? \", texto grande\" : \"\"})`,\n )\n .join(\"\\n\");\n\n throw new Error(`Pares de contraste fora do alvo:\\n${detail}`);\n}\n\n/**\n * Lê o valor computado de uma custom property. Serve para o painel medir o que\n * está realmente aplicado na tela, não o que o arquivo de token diz.\n */\nexport function readCssVariable(name: string, element?: Element): string | undefined {\n if (typeof window === \"undefined\") return undefined;\n const target = element ?? document.documentElement;\n const value = window.getComputedStyle(target).getPropertyValue(name).trim();\n return value || undefined;\n}\n"],"names":["SCENARIO_STATUSES","NETWORK_STATES","ID_PATTERN","isNonEmptyString","value","validateScenario","scenario","index","issues","where","err","message","warn","a11y","validateProduct","product","push","level","personaIds","p","fixtureIds","f","ruleIds","r","moduleIds","m","scenarioIds","modulePrefix","rule","matchesAnyRoute","module","flow","step","label","target","defaultSource","a","route","path","definition","matchPathShape","pattern","patternSegments","pathSegments","segment","actual","hasErrors","issue","formatIssues","PARAM","serializeValue","applyOverrides","params","overrides","key","param","readEnv","viteEnv","__vite_import_meta_env__","getDeployContext","env","branchUrl","deploymentUrl","vercelEnv","commit","origin","scenarioUrl","options","url","commitUrl","CONTRAST_THRESHOLDS","NAMED_COLORS","parseColor","input","named","hex","expand","chunk","g","b","pair","values","functional","parts","n","flatten","foreground","background","mix","fg","bg","relativeLuminance","channel","raw","contrastRatio","fgRaw","lighter","darker","checkContrastPair","required","ratio","checkContrastPairs","pairs","assertContrastPairs","failures","result","detail","readCssVariable","name","element"],"mappings":"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"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { ControlsState } from '../types/index.js';
|
|
2
|
+
/** Nomes curtos: a URL é colada em Slack, em ticket e em thread de revisão. */
|
|
3
|
+
export declare const PARAM: {
|
|
4
|
+
readonly scenario: "scenario";
|
|
5
|
+
readonly persona: "persona";
|
|
6
|
+
readonly fixture: "fixture";
|
|
7
|
+
readonly network: "network";
|
|
8
|
+
readonly viewport: "viewport";
|
|
9
|
+
readonly customWidth: "w";
|
|
10
|
+
readonly themeMode: "theme";
|
|
11
|
+
readonly locale: "locale";
|
|
12
|
+
readonly dataSource: "source";
|
|
13
|
+
readonly chrome: "chrome";
|
|
14
|
+
readonly keyboardMode: "kb";
|
|
15
|
+
readonly reducedMotion: "motion";
|
|
16
|
+
readonly textScale: "scale";
|
|
17
|
+
readonly inspector: "panel";
|
|
18
|
+
};
|
|
19
|
+
/**
|
|
20
|
+
* Serializa um valor de controle para a query string.
|
|
21
|
+
*
|
|
22
|
+
* Booleano vira `1`/`0` e não `true`/`false`: é o que o parser espera, e a URL
|
|
23
|
+
* fica mais curta.
|
|
24
|
+
*/
|
|
25
|
+
export declare function serializeValue(value: unknown): string;
|
|
26
|
+
/**
|
|
27
|
+
* Aplica overrides de {@link ControlsState} em uma `URLSearchParams`, traduzindo
|
|
28
|
+
* as chaves do estado para os nomes de parâmetro.
|
|
29
|
+
*/
|
|
30
|
+
export declare function applyOverrides(params: URLSearchParams, overrides?: Partial<ControlsState>): void;
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { ControlsState, ViewportSetting } from '../types/index.js';
|
|
2
|
+
import { Registry } from '../registry/index.js';
|
|
3
|
+
export declare const VIEWPORTS: readonly ViewportSetting[];
|
|
4
|
+
export declare const TEXT_SCALES: readonly [1, 1.25, 1.5, 2];
|
|
5
|
+
export type DesignSpaceLocation = {
|
|
6
|
+
path: string;
|
|
7
|
+
search: string;
|
|
8
|
+
};
|
|
9
|
+
/**
|
|
10
|
+
* Lê os controles da query string, aplicando os padrões do cenário ativo.
|
|
11
|
+
* Pura e testável: não toca em `window`.
|
|
12
|
+
*/
|
|
13
|
+
export declare function parseControls(search: string, registry: Registry): ControlsState;
|
|
14
|
+
/**
|
|
15
|
+
* Serializa os controles de volta na query string, omitindo tudo que é padrão.
|
|
16
|
+
* URL curta é URL que sobrevive a ser colada em ticket e em thread.
|
|
17
|
+
*/
|
|
18
|
+
export declare function serializeControls(state: ControlsState, registry: Registry): string;
|
|
19
|
+
export type DesignSpaceState = {
|
|
20
|
+
location: DesignSpaceLocation;
|
|
21
|
+
controls: ControlsState;
|
|
22
|
+
viewport: ViewportSetting;
|
|
23
|
+
/** Altera um ou mais controles, preservando a rota. */
|
|
24
|
+
setControls: (patch: Partial<ControlsState>) => void;
|
|
25
|
+
/** Navega para uma rota, preservando os controles ativos. */
|
|
26
|
+
navigate: (to: string, options?: {
|
|
27
|
+
replace?: boolean;
|
|
28
|
+
}) => void;
|
|
29
|
+
/**
|
|
30
|
+
* Abre um cenário: vai para a rota dele e reseta persona, fixture e rede para
|
|
31
|
+
* o que o cenário declara. Controles de ambiente (viewport, chrome, texto)
|
|
32
|
+
* são preservados de propósito — quem está revisando no celular não quer
|
|
33
|
+
* voltar ao desktop a cada troca de situação.
|
|
34
|
+
*/
|
|
35
|
+
openScenario: (scenarioId: string) => void;
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* Fonte única de verdade da navegação e dos controles. Usa a History API
|
|
39
|
+
* diretamente, sem router externo, e escuta `popstate` para que voltar e
|
|
40
|
+
* avançar no navegador funcionem como o usuário espera.
|
|
41
|
+
*/
|
|
42
|
+
export declare function useDesignSpaceState(registry: Registry): DesignSpaceState;
|
|
43
|
+
export declare function resolveViewport(controls: ControlsState): ViewportSetting;
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { ControlsState, Scenario } from '../types/index.js';
|
|
2
|
+
export type DeployContext = {
|
|
3
|
+
/** `development`, `preview` ou `production`. */
|
|
4
|
+
env: string;
|
|
5
|
+
/** Origem absoluta, com protocolo, sem barra final. */
|
|
6
|
+
origin: string;
|
|
7
|
+
/** Domínio estável da branch, quando em preview. */
|
|
8
|
+
branchUrl: string | undefined;
|
|
9
|
+
/** Domínio único deste deployment. Imutável. */
|
|
10
|
+
deploymentUrl: string | undefined;
|
|
11
|
+
/** Nome da branch, para rotular a revisão na interface. */
|
|
12
|
+
branch: string | undefined;
|
|
13
|
+
/** Commit exato, gravado junto com o status de aprovação do cenário. */
|
|
14
|
+
commit: string | undefined;
|
|
15
|
+
/** Primeiros 7 caracteres do commit. */
|
|
16
|
+
shortCommit: string | undefined;
|
|
17
|
+
/** `true` quando roda em preview ou produção na Vercel. */
|
|
18
|
+
isDeployed: boolean;
|
|
19
|
+
};
|
|
20
|
+
/** Lê o contexto do deployment. Seguro em SSR, em Node e no browser. */
|
|
21
|
+
export declare function getDeployContext(): DeployContext;
|
|
22
|
+
/**
|
|
23
|
+
* URL absoluta de um cenário: rota mais os controles necessários para
|
|
24
|
+
* reproduzir a situação. É o link que um PO envia sem precisar explicar
|
|
25
|
+
* nenhuma sequência manual anterior.
|
|
26
|
+
*/
|
|
27
|
+
export declare function scenarioUrl(scenario: Scenario, options?: {
|
|
28
|
+
origin?: string;
|
|
29
|
+
overrides?: Partial<ControlsState>;
|
|
30
|
+
}): string;
|
|
31
|
+
/**
|
|
32
|
+
* URL imutável de aprovação (§10.2). Aponta para o commit exato, então a
|
|
33
|
+
* aprovação não muda de conteúdo debaixo de quem aprovou.
|
|
34
|
+
*
|
|
35
|
+
* Requer o escopo do projeto na Vercel, que é a parte do domínio depois do
|
|
36
|
+
* hash e não está exposta como variável — por isso vem do produto.
|
|
37
|
+
*/
|
|
38
|
+
export declare function commitUrl(scenario: Scenario, options: {
|
|
39
|
+
project: string;
|
|
40
|
+
scope: string;
|
|
41
|
+
commit?: string;
|
|
42
|
+
}): string | undefined;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
.ds-root{--ds-bg: #0f1117;--ds-bg-raised: #161923;--ds-bg-input: #1d212e;--ds-border: #262b3a;--ds-border-strong: #343a4d;--ds-fg: #e7e9ee;--ds-fg-dim: #9aa0b0;--ds-fg-faint: #6b7280;--ds-accent: #7c9cff;--ds-accent-fg: #0f1117;--ds-ok: #4ade80;--ds-warn: #fbbf24;--ds-err: #fb7185;--ds-focus: #a5b8ff;--ds-r: 6px;--ds-r-lg: 10px;--ds-sidebar: 280px;--ds-inspector: 340px;--ds-topbar: 44px;--ds-font: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;--ds-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace;position:fixed;inset:0;display:grid;grid-template-rows:var(--ds-topbar) 1fr;grid-template-columns:var(--ds-sidebar) 1fr var(--ds-inspector);grid-template-areas:"topbar topbar topbar" "sidebar stage inspector";background:var(--ds-bg)}.ds-root[data-inspector=closed]{grid-template-columns:var(--ds-sidebar) 1fr 0}.ds-root[data-chrome=hidden]{grid-template-rows:1fr;grid-template-columns:1fr;grid-template-areas:"stage"}.ds-chrome,.ds-chrome *,.ds-chrome *:before,.ds-chrome *:after{box-sizing:border-box}.ds-chrome{color:var(--ds-fg);font-family:var(--ds-font);font-size:13px;line-height:1.45;-webkit-font-smoothing:antialiased}.ds-chrome :focus-visible{outline:2px solid var(--ds-focus);outline-offset:2px;border-radius:3px}.ds-topbar{grid-area:topbar;display:flex;align-items:center;gap:12px;padding:0 12px;border-bottom:1px solid var(--ds-border);background:var(--ds-bg-raised);min-width:0}.ds-topbar__product{display:flex;align-items:baseline;gap:8px;font-weight:600;white-space:nowrap}.ds-topbar__tagline{color:var(--ds-fg-faint);font-weight:400;font-size:12px}.ds-topbar__spacer{flex:1;min-width:8px}.ds-topbar__meta{display:flex;align-items:center;gap:6px;color:var(--ds-fg-dim);font-family:var(--ds-mono);font-size:11px;min-width:0}.ds-topbar__meta code{padding:2px 6px;border:1px solid var(--ds-border);border-radius:var(--ds-r);background:var(--ds-bg-input);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ds-sidebar{grid-area:sidebar;display:flex;flex-direction:column;border-right:1px solid var(--ds-border);background:var(--ds-bg-raised);min-height:0}.ds-sidebar__search{padding:10px;border-bottom:1px solid var(--ds-border)}.ds-sidebar__tree{flex:1;overflow-y:auto;padding:8px 6px 20px}.ds-module{margin-bottom:4px}.ds-module__header{display:flex;align-items:center;gap:6px;width:100%;padding:6px 8px;border:0;border-radius:var(--ds-r);background:transparent;color:var(--ds-fg);font:inherit;font-weight:600;text-align:left;cursor:pointer}.ds-module__header:hover{background:var(--ds-bg-input)}.ds-module__chevron{flex:none;width:10px;color:var(--ds-fg-faint);transition:transform .12s ease}.ds-module__header[aria-expanded=true] .ds-module__chevron{transform:rotate(90deg)}.ds-module__count{margin-left:auto;color:var(--ds-fg-faint);font-weight:400;font-size:11px;font-variant-numeric:tabular-nums}.ds-module__scenarios{margin:2px 0 6px;padding:0 0 0 14px;list-style:none;border-left:1px solid var(--ds-border)}.ds-scenario{display:flex;align-items:center;gap:8px;width:100%;padding:5px 8px;border:0;border-radius:var(--ds-r);background:transparent;color:var(--ds-fg-dim);font:inherit;text-align:left;cursor:pointer}.ds-scenario:hover{background:var(--ds-bg-input);color:var(--ds-fg)}.ds-scenario[aria-current=true]{background:color-mix(in srgb,var(--ds-accent) 18%,transparent);color:var(--ds-fg);box-shadow:inset 2px 0 0 0 var(--ds-accent)}.ds-scenario__title{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ds-status-dot{flex:none;width:7px;height:7px;border-radius:50%;background:var(--ds-fg-faint)}.ds-status-dot[data-status=proposed]{background:#6b7280}.ds-status-dot[data-status=in-review]{background:var(--ds-warn)}.ds-status-dot[data-status=approved]{background:var(--ds-ok)}.ds-status-dot[data-status=in-implementation]{background:var(--ds-accent)}.ds-status-dot[data-status=implemented]{background:#22d3ee}.ds-status-dot[data-status=superseded]{background:transparent;border:1px solid var(--ds-fg-faint)}.ds-sidebar__empty{padding:16px 10px;color:var(--ds-fg-faint)}.ds-stage-area{grid-area:stage;display:flex;flex-direction:column;min-width:0;min-height:0;background:linear-gradient(0deg,transparent 0,transparent) padding-box,repeating-conic-gradient(#12141c 0% 25%,#0f1117 0% 50%) 0 0 / 16px 16px}.ds-stage-scroll{flex:1;display:flex;justify-content:center;overflow:auto;padding:0;min-height:0}.ds-root[data-viewport=fit] .ds-stage-scroll{padding:0}.ds-root:not([data-viewport=fit]) .ds-stage-scroll{padding:20px}.ds-stage{position:relative;flex:none;width:100%;max-width:100%;background:#fff;isolation:isolate;container-type:inline-size;overflow:auto}.ds-root:not([data-viewport=fit]) .ds-stage{border-radius:var(--ds-r-lg);box-shadow:0 12px 32px #0006;outline:1px solid var(--ds-border-strong)}.ds-root[data-viewport=fit] .ds-stage{height:100%}.ds-stage[data-reduced-motion=true] *,.ds-stage[data-reduced-motion=true] *:before,.ds-stage[data-reduced-motion=true] *:after{animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important;scroll-behavior:auto!important}.ds-stage[data-keyboard-mode=true] :focus{outline:3px solid #ff3d7f!important;outline-offset:2px!important}.ds-taborder{position:fixed;inset:0;z-index:40;pointer-events:none}.ds-taborder__badge{position:absolute;display:grid;place-items:center;min-width:18px;height:18px;padding:0 4px;border-radius:9px;background:#ff3d7f;color:#fff;font-family:var(--ds-mono);font-size:10px;font-weight:700;font-variant-numeric:tabular-nums;transform:translate(-50%,-50%)}.ds-taborder__badge[data-forced=true]{background:var(--ds-warn);color:#1a1400}.ds-stage-empty{display:grid;place-content:center;gap:10px;height:100%;padding:40px;color:var(--ds-fg-dim);text-align:center}.ds-stage-empty h2{margin:0;color:var(--ds-fg);font-size:15px}.ds-stage-empty p{max-width:46ch;margin:0 auto}.ds-controls{display:flex;flex-wrap:wrap;align-items:center;gap:8px 14px;padding:8px 12px;border-top:1px solid var(--ds-border);background:var(--ds-bg-raised)}.ds-field{display:flex;align-items:center;gap:6px;min-width:0}.ds-field>label,.ds-field__label{color:var(--ds-fg-faint);font-size:11px;text-transform:uppercase;letter-spacing:.04em;white-space:nowrap}.ds-select,.ds-input{max-width:200px;padding:4px 8px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-input);color:var(--ds-fg);font:inherit;font-size:12px}.ds-input--search{width:100%;max-width:none}.ds-segmented{display:flex;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);overflow:hidden}.ds-segmented button{padding:4px 9px;border:0;border-right:1px solid var(--ds-border-strong);background:var(--ds-bg-input);color:var(--ds-fg-dim);font:inherit;font-size:12px;cursor:pointer}.ds-segmented button:last-child{border-right:0}.ds-segmented button[aria-pressed=true]{background:var(--ds-accent);color:var(--ds-accent-fg);font-weight:600}.ds-btn{display:inline-flex;align-items:center;gap:6px;padding:4px 10px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-input);color:var(--ds-fg);font:inherit;font-size:12px;cursor:pointer}.ds-btn:hover{border-color:var(--ds-accent)}.ds-btn[aria-pressed=true]{border-color:var(--ds-accent);background:color-mix(in srgb,var(--ds-accent) 22%,transparent)}.ds-btn--ghost{border-color:transparent;background:transparent;color:var(--ds-fg-dim)}.ds-inspector{grid-area:inspector;display:flex;flex-direction:column;border-left:1px solid var(--ds-border);background:var(--ds-bg-raised);min-height:0;overflow:hidden}.ds-root[data-inspector=closed] .ds-inspector{display:none}.ds-inspector__tabs{display:flex;border-bottom:1px solid var(--ds-border)}.ds-inspector__tabs button{flex:1;padding:8px 6px;border:0;border-bottom:2px solid transparent;background:transparent;color:var(--ds-fg-faint);font:inherit;font-size:12px;cursor:pointer}.ds-inspector__tabs button[aria-selected=true]{border-bottom-color:var(--ds-accent);color:var(--ds-fg);font-weight:600}.ds-inspector__body{flex:1;overflow-y:auto;padding:12px}.ds-block{margin-bottom:18px}.ds-block__title{margin:0 0 6px;color:var(--ds-fg-faint);font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.05em}.ds-block p{margin:0 0 6px;color:var(--ds-fg-dim)}.ds-list{margin:0;padding-left:16px;color:var(--ds-fg-dim)}.ds-list li{margin-bottom:4px}.ds-kv{display:grid;grid-template-columns:96px 1fr;gap:4px 10px;margin:0}.ds-kv dt{color:var(--ds-fg-faint);font-size:11px}.ds-kv dd{margin:0;overflow-wrap:anywhere}.ds-chips{display:flex;flex-wrap:wrap;gap:4px}.ds-chip{padding:2px 7px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-input);color:var(--ds-fg-dim);font-family:var(--ds-mono);font-size:11px}.ds-chip[data-tone=ok]{border-color:color-mix(in srgb,var(--ds-ok) 45%,transparent);color:var(--ds-ok)}.ds-chip[data-tone=warn]{border-color:color-mix(in srgb,var(--ds-warn) 45%,transparent);color:var(--ds-warn)}.ds-chip[data-tone=err]{border-color:color-mix(in srgb,var(--ds-err) 45%,transparent);color:var(--ds-err)}.ds-rule{margin-bottom:10px;padding:8px 10px;border:1px solid var(--ds-border);border-left:2px solid var(--ds-accent);border-radius:var(--ds-r);background:var(--ds-bg-input)}.ds-rule__id{display:block;margin-bottom:3px;color:var(--ds-fg-faint);font-family:var(--ds-mono);font-size:10px}.ds-rule__statement{color:var(--ds-fg)}.ds-rule__rationale{margin-top:4px;color:var(--ds-fg-dim);font-size:12px}.ds-contrast{width:100%;border-collapse:collapse;font-size:12px}.ds-contrast th,.ds-contrast td{padding:5px 6px;border-bottom:1px solid var(--ds-border);text-align:left}.ds-contrast th{color:var(--ds-fg-faint);font-size:10px;font-weight:600;text-transform:uppercase}.ds-contrast td:last-child{font-family:var(--ds-mono);font-variant-numeric:tabular-nums;text-align:right}.ds-swatch{display:inline-block;width:10px;height:10px;margin-right:5px;border:1px solid var(--ds-border-strong);border-radius:2px;vertical-align:-1px}.ds-note{padding:8px 10px;border:1px solid color-mix(in srgb,var(--ds-warn) 35%,transparent);border-radius:var(--ds-r);background:color-mix(in srgb,var(--ds-warn) 8%,transparent);color:var(--ds-fg-dim)}.ds-issue{margin-bottom:6px;padding:7px 9px;border-radius:var(--ds-r);background:var(--ds-bg-input);border-left:2px solid var(--ds-err)}.ds-issue[data-level=warning]{border-left-color:var(--ds-warn)}.ds-issue__where{display:block;color:var(--ds-fg-faint);font-family:var(--ds-mono);font-size:10px}@media(max-width:1100px){.ds-root,.ds-root[data-inspector=closed]{grid-template-columns:var(--ds-sidebar) 1fr;grid-template-areas:"topbar topbar" "sidebar stage"}.ds-root[data-inspector=open] .ds-inspector{position:fixed;top:var(--ds-topbar);right:0;bottom:0;z-index:30;width:min(var(--ds-inspector),90vw);box-shadow:-12px 0 32px #00000073}}@media(max-width:720px){.ds-root,.ds-root[data-inspector=closed],.ds-root[data-inspector=open]{grid-template-columns:1fr;grid-template-areas:"topbar" "stage"}.ds-sidebar{position:fixed;top:var(--ds-topbar);left:0;bottom:0;z-index:30;width:min(var(--ds-sidebar),88vw);box-shadow:12px 0 32px #00000073}.ds-root[data-sidebar=closed] .ds-sidebar{display:none}}.ds-root[data-sidebar=closed] .ds-sidebar{display:none}.ds-restore{position:fixed;right:10px;bottom:10px;z-index:50;padding:5px 10px;border:1px solid var(--ds-border-strong);border-radius:var(--ds-r);background:var(--ds-bg-raised);color:var(--ds-fg);font:inherit;font-size:12px;cursor:pointer;opacity:0;transition:opacity .12s ease}.ds-restore:hover,.ds-restore:focus-visible{opacity:1}.ds-visually-hidden{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap}.ds-home{width:100%;max-width:980px;margin:0 auto;padding:32px 24px 56px;color:var(--ds-fg)}.ds-home__header h1{margin:0;font-size:24px;font-weight:700;letter-spacing:-.01em}.ds-home__tagline{margin:4px 0 0;color:var(--ds-fg-dim)}.ds-home__lead{max-width:68ch;margin:12px 0;color:var(--ds-fg-dim);font-size:14px}.ds-home__module{margin-top:36px;padding-top:20px;border-top:1px solid var(--ds-border)}.ds-home__module h2{margin:0 0 4px;font-size:16px;font-weight:600}.ds-home__hint{max-width:68ch;margin:0 0 14px;color:var(--ds-fg-faint);font-size:13px}.ds-home__grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(260px,1fr));gap:10px;margin:14px 0 0;padding:0;list-style:none}.ds-home__card{display:flex;flex-direction:column;gap:6px;width:100%;height:100%;padding:12px 14px;border:1px solid var(--ds-border);border-radius:var(--ds-r-lg);background:var(--ds-bg-raised);color:inherit;font:inherit;text-align:left;cursor:pointer;transition:border-color .12s ease,transform .12s ease}.ds-home__card:hover{border-color:var(--ds-accent);transform:translateY(-1px)}.ds-home__card-head{display:flex;align-items:center;gap:8px}.ds-home__card-title{font-weight:600}.ds-home__card-intent{color:var(--ds-fg-dim);font-size:12.5px}.ds-home__card-meta{margin-top:auto;color:var(--ds-fg-faint);font-size:11px}.ds-flow{margin:14px 0 6px;padding:14px 16px;border:1px solid var(--ds-border);border-left:2px solid var(--ds-accent);border-radius:var(--ds-r-lg);background:var(--ds-bg-input)}.ds-flow h3{margin:0 0 4px;font-size:13px;font-weight:600}.ds-flow__steps{margin:10px 0 0;padding-left:20px;color:var(--ds-fg-dim)}.ds-flow__steps>li{margin-bottom:10px}.ds-flow__step{padding:0;border:0;background:none;color:var(--ds-accent);font:inherit;text-align:left;text-decoration:underline;text-underline-offset:2px;cursor:pointer}.ds-flow__decision{margin:3px 0 0;color:var(--ds-fg-faint);font-size:12px;font-style:italic}.ds-flow__branches{margin:6px 0 0;padding-left:14px;list-style:none;border-left:1px dashed var(--ds-border-strong)}.ds-flow__branches li{margin-bottom:4px}.ds-flow__branch-label{margin-right:6px;color:var(--ds-fg-faint);font-size:11px}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* API pública de `@brucesantos/design-space`.
|
|
3
|
+
*
|
|
4
|
+
* Esta lista é a fronteira do motor. Adicionar algo aqui é um compromisso de
|
|
5
|
+
* versionamento semântico com todos os produtos, então vale a regra do
|
|
6
|
+
* documento: só entra o que já provou ser neutro e útil em mais de um produto
|
|
7
|
+
* (Princípio 10).
|
|
8
|
+
*/
|
|
9
|
+
export { DesignSpace, type DesignSpaceProps } from './shell/DesignSpace.js';
|
|
10
|
+
export { Stage, StageEmpty, TabOrderOverlay, type StageProps } from './shell/Stage.js';
|
|
11
|
+
export { Home, type HomeProps } from './shell/Home.js';
|
|
12
|
+
export { KEYBOARD_LABELS, NETWORK_LABELS, STATUS_LABELS, STATUS_MEANING, } from './shell/labels.js';
|
|
13
|
+
export { createRegistry, type ModuleNode, type Registry } from './registry/index.js';
|
|
14
|
+
export { formatIssues, hasErrors, validateProduct, validateScenario, type ValidationIssue, } from './registry/validate.js';
|
|
15
|
+
export { matchPath, resolveRoute, type RouteMatch } from './router/index.js';
|
|
16
|
+
export { TEXT_SCALES, VIEWPORTS, parseControls, resolveViewport, serializeControls, useDesignSpaceState, type DesignSpaceState, type DesignSpaceLocation, } from './controls/state.js';
|
|
17
|
+
export { PARAM, applyOverrides, serializeValue } from './controls/params.js';
|
|
18
|
+
export { SLOW_NETWORK_DELAY_MS, SimulatedNetworkError, createHttpAdapter, fixtureAdapter, resolveFixture, } from './adapters/index.js';
|
|
19
|
+
export { useScenarioData, type ScenarioData } from './adapters/useScenarioData.js';
|
|
20
|
+
export { commitUrl, getDeployContext, scenarioUrl, type DeployContext, } from './deploy/index.js';
|
|
21
|
+
export { CONTRAST_THRESHOLDS, assertContrastPairs, checkContrastPair, checkContrastPairs, contrastRatio, flatten, parseColor, readCssVariable, relativeLuminance, type ContrastResult, type Rgb, } from './a11y/contrast.js';
|
|
22
|
+
export { computeRole, describeElement, shortSelector, tabbableElements, type AccessibleNode, } from './a11y/accessible-tree.js';
|
|
23
|
+
export { useKeyboardMode, type KeyboardModeResult, type TabStop, } from './a11y/useKeyboardMode.js';
|
|
24
|
+
export { ageInYears, daysBetween, parseIsoDate } from './util/date.js';
|
|
25
|
+
export { NETWORK_STATES, SCENARIO_STATUSES, type A11yContract, type ContrastPair, type ContrastTarget, type ControlsState, type DataRequest, type DataSourceAdapter, type Fixture, type Flow, type FlowStep, type KeyboardCoverage, type Module, type NetworkState, type Persona, type ProductDefinition, type ProductTheme, type Rule, type RouteDefinition, type Scenario, type ScenarioContext, type ScenarioStatus, type ScreenProps, type ViewportSetting, } from './types/index.js';
|