@softize/opus 11.1.0 → 11.1.1

package/CHANGELOG.md

@@ -6,6 +6,14 @@ Este arquivo viaja no pacote: num projeto, leia `node_modules/@softize/opus/CHAN
 Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `manifest:check`) — eles apontam o que a mudança cobra do seu código.
 
+## 11.1.1 — 2026-08-21
+
+A referência canônica passa a usar `communication.md` como nome do arquivo e `communication`
+como slug. Assim, o nome interno e a URL acompanham o escopo ampliado da página, que deixou de
+tratar apenas de microcopy. A URL anterior, `/ui/microcopy`, redireciona para
+`/ui/communication`, preservando links existentes sem manter o nome antigo na navegação ou na
+fonte materializada.
+
 ## 11.1.0 — 2026-08-21
 
 O Opus passa a distribuir a skill `write-product-communication` para orientar documentação,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "11.1.0",
+  "version": "11.1.1",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/registry/skills/write-product-communication/SKILL.md

@@ -25,4 +25,4 @@ permite que a pessoa compreenda ou prossiga sem decodificar a linguagem interna
 
 ## Referência canônica
 
-<!-- opus-doc: microcopy.md -->
+<!-- opus-doc: communication.md -->

package/src/ui/docs/DocBrowser.tsx

@@ -1,6 +1,6 @@
 /**
  * DocBrowser — a VERDADE VISUAL da casa, como doc completa. Seção multi-página: conceitos
- * (Introdução, Tokens & Tema, Microcopy, Customização) + uma página por componente do
+ * (Introdução, Tokens & Tema, Comunicação, Customização) + uma página por componente do
  * opus/ui, agrupados por seção. O que você vê aqui é o que os apps entregam (o site
  * do shadcn é catálogo do que existe; a expectativa visual nasce aqui).
  *
@@ -35,6 +35,8 @@ export interface DocBrowserProps {
   path?: string
   /** Seções a exibir (seção → grupo → página). Default = catálogo inteiro. */
   sections?: DocSection[]
+  /** Slugs antigos que devem abrir e substituir a URL pela página canônica. */
+  redirects?: Readonly<Record<string, string>>
   /** Monta o `document.title` a partir do título da página atual (ex.: `(t) => `${t} · Opus``).
    *  Ausente = não mexe no title. */
   documentTitle?: (pageTitle: string) => string
@@ -44,6 +46,7 @@ export function DocBrowser({
   basePath = '/docs',
   path: controlledPath,
   sections = DOC_SECTIONS,
+  redirects = {},
   documentTitle,
 }: DocBrowserProps): React.ReactElement {
   // Standalone: o path vem do router da casa (`usePathname` — pathname É o estado).
@@ -56,13 +59,18 @@ export function DocBrowser({
   // Slug = TODOS os segmentos após o basePath, unidos (rota aninhada: `/docs/guias/deploy`
   // → `guias/deploy`). Slug flat de 1 segmento continua igual (`join` de 1 elemento = ele).
   const rel = path.startsWith(basePath) ? path.slice(basePath.length) : ''
-  const slug = rel.split('/').filter(Boolean).join('/') || defaultSlug
+  const requestedSlug = rel.split('/').filter(Boolean).join('/') || defaultSlug
+  const slug = redirects[requestedSlug] ?? requestedSlug
   const page = findPage(sections, slug) ?? findPage(sections, defaultSlug)
 
   // `navigate` emite `popstate`, então o host é notificado nos dois modos — inclusive o
   // que ainda escuta o evento na unha, que era como este componente avisava antes.
   const go = (to: string): void => navigate(to)
 
+  useEffect(() => {
+    if (requestedSlug !== slug) navigate(`${basePath}/${slug}`, { replace: true })
+  }, [basePath, requestedSlug, slug])
+
   // O title da aba acompanha a página atual (quando o host fornece o formato).
   useEffect(() => {
     if (page && documentTitle) document.title = documentTitle(page.title)

package/src/ui/docs/registry.tsx

@@ -39,7 +39,7 @@ import runtimeMd from './content/runtime.md?raw'
 import uiMd from './content/ui.md?raw'
 import cliMd from './content/cli.md?raw'
 import tokensMd from './content/tokens.md?raw'
-import microcopyMd from './content/microcopy.md?raw'
+import communicationMd from './content/communication.md?raw'
 import customizationMd from './content/customization.md?raw'
 
 // — Componentes —
@@ -267,7 +267,7 @@ export const UI_SECTIONS: DocSection[] = [
       {
         pages: [
           { slug: 'tokens', title: 'Tokens & Tema', render: doc(tokensMd) },
-          { slug: 'microcopy', title: 'Comunicação', render: doc(microcopyMd) },
+          { slug: 'communication', title: 'Comunicação', render: doc(communicationMd) },
           { slug: 'customization', title: 'Customização', render: doc(customizationMd) },
         ],
       },