@softize/opus 27.0.0 → 28.0.0

package/CHANGELOG.md

@@ -7,6 +7,79 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 28.0.0 — 2026-10-13
+
+### Breaking
+
+Page passa a usar `surfaceLayout="sectioned"` por padrão; `continuous` remove os divisores.
+`className` de Page configura a moldura externa e o de PageBody, o viewport. Migre ajustes
+internos de largura e alinhamento para `contentClassName`, disponível nos dois.
+PageShell preserva rolagem de contingência para fallbacks; wrappers de rota devem propagar
+altura para manter o header da Page fixo. Presentation fora do shell mantém largura total.
+TabsPanel com `forceMount` preserva a montagem, mas oculta o painel inativo.
+
+
+A composição e a escala das superfícies mudam. Migre os consumidores conforme a ADR 0060 e remova os recuos locais substituídos pelo body.
+
+DrawerTitle e DialogTitle na intro acompanham a escala do PageTitle; o header compacto
+preserva seu título menor.
+
+Surface, Page, Dialog, Drawer e Tabs compartilham ritmo vertical de 1rem. Superfícies delimitadas
+fecham com padding inferior; corpos sem moldura ficam alinhados ao hospedeiro. Tabs framed
+fornece os recuos do painel. Remova overrides locais que reconstruíam esses espaçamentos.
+
+IconCatalogProvider permite catálogo assíncrono e renderização de assets sob demanda no IconPicker,
+com busca no índice completo, grade de oito colunas com scroll infinito e tentativa após erro.
+
+IconPicker apresenta uma grade sem nomes visíveis, com nomes acessíveis e busca por nomes e sinônimos
+em português. O scroll do popover não se propaga ao modal. `searchTerms` personaliza a busca
+sem modificar identificadores salvos. A paleta inclui Carro, pesquisável também por veículo e automóvel.
+
+Toggle `outline` volta a distinguir o preenchimento ativo da borda, com fundo semitransparente
+e preservação do formato conectado.
+
+ActionList oferece `viewControls` para controles específicos da visualização ativa,
+imediatamente após seu seletor. As configurações da lista aparecem antes dos seletores.
+
+### Escala dos controles e composição
+
+Corrigida a altura de `icon-sm`: 2rem, igual a `sm`, preservando o glifo de 0,875rem.
+PaginationLink respeita o tamanho textual declarado; números, setas e elipse do pager
+de ActionList usam 2rem. Remova compensações locais que fixavam esses controles em 1,75rem.
+
+Page, Dialog, Drawer e Surface delimitada compartilham header com padding de 1rem e
+linha mínima de 2rem. Ações de header usam `sm`/`icon-sm`, inclusive criação de coleções
+e comandos de Presentation. Rodapés mantêm a escala anterior. Consumidores devem remover
+compensações de altura/padding e declarar a escala compacta nos botões das barras.
+
+Presentation em página passa a delegar padding e rolagem ao PageBody, evitando conteúdo
+recortado e recuos duplicados. Ações de headers compactos sem navegação permanecem no
+extremo oposto ao título.
+
+Page oferece `PageIntro` e `PageIntroActions`, seguindo a separação entre controles da superfície
+e conteúdo já disponível em Dialog e Drawer. A forma curta passa a colocar título e orientação
+na intro, mantendo ações no header. Headers sem controles não reservam espaço. A forma explícita
+compacta continua válida. A mudança visual exige migração coordenada dos consumidores (ADR 0060).
+Page mantém header e footer fora da rolagem; o body rola em flow e repassa a altura à lista em fill.
+
+## 27.1.0 — 2026-10-13
+
+Portais documentais podem oferecer navegação recolhível em telas estreitas com
+`DocBrowser.collapsibleNavigation`. O menu ocupa a área disponível, preserva os ramos
+abertos e mostra os resultados da busca; selecionar um destino interno ou pressionar
+Escape retorna à leitura. A composição desktop e consumidores sem a opção não mudam.
+
+**Ao adotar:** remova as regras CSS móveis do host que limitavam `Split` e `Pane` a
+uma faixa curta. Preserve a instância de `DocBrowser` entre áreas, sem uma `key`
+que remonte o navegador a cada troca; isso mantém a busca, os ramos abertos e o foco.
+Mapas distintos usam `basePath` distintos para preservar a abertura dos ramos de cada
+área. Uma consulta já preenchida na montagem não abre o menu; editar a busca revela
+os resultados.
+
+`DocSection.readingSequence: false` mantém uma seção na navegação e na busca, mas a retira
+dos links de leitura anterior/próxima. Isso permite consultar registros históricos sem
+apresentá-los como continuidade de guias vigentes.
+
 ## 27.0.0 — 2026-10-13
 
 O aplicativo passa a saber, na recusa de um anexo, o que entrou na mesma ação, e o glob do runtime

package/bin/lib/check.mjs

@@ -93,7 +93,11 @@ const KINDS = new Set(["simple", "form", "list", "view"]);
 const ASSISTANT_RESOURCE_RE = /^[a-z][a-zA-Z0-9]*$/;
 const ASSISTANT_SKILL_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 const ASSISTANT_CONTEXT_MIN = 1000;
-const ASSISTANT_RESERVED_SEGMENTS = new Set(["__proto__", "constructor", "prototype"]);
+const ASSISTANT_RESERVED_SEGMENTS = new Set([
+  "__proto__",
+  "constructor",
+  "prototype",
+]);
 const ASSISTANT_CONTEXT_MAX = 16000;
 const ASSISTANT_REQUIRED = {
   label: "`label`, o nome do assistente para pessoas",
@@ -150,9 +154,11 @@ const UI_SURFACE_PAIRS = new Map([
 const UI_STRUCTURAL_PARENTS = new Map([
   ["PageHeader", new Set(["Page"])],
   ["PageBody", new Set(["Page"])],
+  ["PageIntro", new Set(["PageBody"])],
+  ["PageIntroActions", new Set(["PageIntro"])],
   ["PageFooter", new Set(["Page"])],
-  ["PageTitle", new Set(["PageHeader"])],
-  ["PageDescription", new Set(["PageHeader"])],
+  ["PageTitle", new Set(["PageHeader", "PageIntro"])],
+  ["PageDescription", new Set(["PageHeader", "PageIntro"])],
   ["PageBack", new Set(["PageHeader"])],
   ["PageNavigation", new Set(["PageHeader"])],
   ["PageActions", new Set(["PageHeader"])],
@@ -311,7 +317,6 @@ const UI_REMOVED_PROPS = new Map([
       ["variant", "o cabeçalho da página tem uma única apresentação rolável"],
     ]),
   ],
-
 ]);
 
 const UI_REMOVED_COMPONENTS = new Map([
@@ -323,7 +328,6 @@ const UI_REMOVED_COMPONENTS = new Map([
   ["PaneTitle", "use `SurfaceTitle` dentro de `SurfaceHeader`"],
   ["PaneDescription", "use `SurfaceDescription` dentro de `SurfaceHeader`"],
   ["PaneActions", "use `SurfaceActions` dentro de `SurfaceHeader`"],
-  ["PageIntro", "use `PageHeader` como a única introdução estrutural"],
   // Content e Card deram lugar a Surface (ADR 0045).
   [
     "Content",
@@ -356,6 +360,14 @@ const UI_REMOVED_COMPONENTS = new Map([
 const UI_STRUCTURAL_CONTAINERS = new Set(["PageShell"]);
 
 const UI_STRUCTURAL_HEADERS = new Map([
+  [
+    "PageIntro",
+    {
+      title: "PageTitle",
+      optional: new Set(["PageIntroActions", "PageDescription"]),
+      shorthand: new Set(),
+    },
+  ],
   [
     "DialogIntro",
     {
@@ -376,7 +388,12 @@ const UI_STRUCTURAL_HEADERS = new Map([
     "PageHeader",
     {
       title: "PageTitle",
-      optional: new Set(["PageBack", "PageNavigation", "PageActions", "PageDescription"]),
+      optional: new Set([
+        "PageBack",
+        "PageNavigation",
+        "PageActions",
+        "PageDescription",
+      ]),
       exclusive: [new Set(["PageBack", "PageNavigation"])],
       shorthand: new Set(),
       titleRequired: false,
@@ -568,7 +585,8 @@ export function parseRetention(fileName, sourceText) {
       if (item === undefined) return undefined;
       if (!ts.isPropertyAssignment(item)) return null;
       const init = item.initializer;
-      return ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)
+      return ts.isStringLiteral(init) ||
+        ts.isNoSubstitutionTemplateLiteral(init)
         ? init.text
         : null;
     };
@@ -797,7 +815,9 @@ function checkRetention(retention) {
         if (batch !== null && (!Number.isInteger(batch) || batch < 1))
           at("`batchSize` precisa ser um inteiro positivo.");
         else if (batch !== null && batch > MAX_PURGE_BATCH_SIZE)
-          at(`\`batchSize\` aceita no máximo ${MAX_PURGE_BATCH_SIZE} linhas por lote.`);
+          at(
+            `\`batchSize\` aceita no máximo ${MAX_PURGE_BATCH_SIZE} linhas por lote.`,
+          );
         const inDomain =
           entity.inlineInDomain ||
           (entity.ident !== null && entityRefs.has(entity.ident));
@@ -813,7 +833,9 @@ function checkRetention(retention) {
     for (const purge of parsed.purges) {
       const subject = `bindPurge(${purge.entityRef ?? "?"})`;
       const entity =
-        purge.entityRef === null ? undefined : entitiesByIdent.get(purge.entityRef);
+        purge.entityRef === null
+          ? undefined
+          : entitiesByIdent.get(purge.entityRef);
       if (
         entity !== undefined &&
         entity !== "ambiguous" &&
@@ -982,15 +1004,20 @@ export function parseActions(fileName, sourceText) {
   /** `ai` literal → "enabled" | "disabled"; ausente → null; não literal → "unknown". */
   function aiState(obj) {
     const p = prop(obj, "ai");
-    if (!p) return obj.properties.some((pr) => pr.name?.getText(sf) === "ai") ? "unknown" : null;
+    if (!p)
+      return obj.properties.some((pr) => pr.name?.getText(sf) === "ai")
+        ? "unknown"
+        : null;
     const value = p.initializer;
     if (value.kind === ts.SyntaxKind.TrueKeyword) return "enabled";
     if (value.kind === ts.SyntaxKind.FalseKeyword) return "disabled";
     if (ts.isObjectLiteralExpression(value)) {
       const enabled = prop(value, "enabled");
       if (!enabled) return "enabled";
-      if (enabled.initializer.kind === ts.SyntaxKind.FalseKeyword) return "disabled";
-      if (enabled.initializer.kind === ts.SyntaxKind.TrueKeyword) return "enabled";
+      if (enabled.initializer.kind === ts.SyntaxKind.FalseKeyword)
+        return "disabled";
+      if (enabled.initializer.kind === ts.SyntaxKind.TrueKeyword)
+        return "enabled";
     }
     return "unknown";
   }
@@ -1007,14 +1034,17 @@ export function parseActions(fileName, sourceText) {
       if (!found) return { present: objKeys(value).includes(key), text: null };
       return {
         present: true,
-        text: ts.isStringLiteralLike(found.initializer) ? found.initializer.text : null,
+        text: ts.isStringLiteralLike(found.initializer)
+          ? found.initializer.text
+          : null,
       };
     };
     const limit = prop(value, "maxContextChars");
     let maxContextChars = null;
     if (limit) {
       const node = limit.initializer;
-      if (ts.isNumericLiteral(node)) maxContextChars = Number(node.text.replace(/_/g, ""));
+      if (ts.isNumericLiteral(node))
+        maxContextChars = Number(node.text.replace(/_/g, ""));
       else if (
         ts.isPrefixUnaryExpression(node) &&
         node.operator === ts.SyntaxKind.MinusToken &&
@@ -1025,7 +1055,9 @@ export function parseActions(fileName, sourceText) {
     const contextNode = prop(value, "context");
     const contextPaths =
       contextNode && ts.isArrayLiteralExpression(contextNode.initializer)
-        ? contextNode.initializer.elements.filter(ts.isStringLiteralLike).map((element) => element.text)
+        ? contextNode.initializer.elements
+            .filter(ts.isStringLiteralLike)
+            .map((element) => element.text)
         : [];
     return {
       readable: true,
@@ -1110,17 +1142,27 @@ function assistantMessages(a) {
   if (!assistant.readable) return out;
   const { resource, skill } = assistant;
   if (!resource.present)
-    out.push("O assistente precisa declarar `resource`, o tipo de recurso de que a action é dona.");
+    out.push(
+      "O assistente precisa declarar `resource`, o tipo de recurso de que a action é dona.",
+    );
   else if (resource.text !== null && !ASSISTANT_RESOURCE_RE.test(resource.text))
-    out.push(`\`resource: "${resource.text}"\` precisa estar em camelCase, como \`customer\` ou \`aftersaleOpportunity\`.`);
+    out.push(
+      `\`resource: "${resource.text}"\` precisa estar em camelCase, como \`customer\` ou \`aftersaleOpportunity\`.`,
+    );
   if (!skill.present)
-    out.push("O assistente precisa declarar `skill`, a chave do procedimento que a IA segue.");
+    out.push(
+      "O assistente precisa declarar `skill`, a chave do procedimento que a IA segue.",
+    );
   else if (skill.text !== null && !ASSISTANT_SKILL_RE.test(skill.text))
-    out.push(`\`skill: "${skill.text}"\` precisa estar em minúsculas com hífen, como \`review-customer\`.`);
+    out.push(
+      `\`skill: "${skill.text}"\` precisa estar em minúsculas com hífen, como \`review-customer\`.`,
+    );
   const reserved = [assistant.title.text, ...assistant.contextPaths].filter(
     (path) =>
       typeof path === "string" &&
-      path.split(".").some((segment) => ASSISTANT_RESERVED_SEGMENTS.has(segment)),
+      path
+        .split(".")
+        .some((segment) => ASSISTANT_RESERVED_SEGMENTS.has(segment)),
   );
   if (reserved.length > 0)
     out.push(
@@ -1129,12 +1171,16 @@ function assistantMessages(a) {
   const limit = assistant.maxContextChars;
   if (
     limit !== null &&
-    (!Number.isInteger(limit) || limit < ASSISTANT_CONTEXT_MIN || limit > ASSISTANT_CONTEXT_MAX)
+    (!Number.isInteger(limit) ||
+      limit < ASSISTANT_CONTEXT_MIN ||
+      limit > ASSISTANT_CONTEXT_MAX)
   )
     out.push(
       `\`maxContextChars: ${limit}\` precisa ser um inteiro de 1.000 a 16.000; sem ele, o teto é de 4.000 caracteres.`,
     );
-  const missing = Object.keys(ASSISTANT_REQUIRED).filter((key) => !assistant.keys.includes(key));
+  const missing = Object.keys(ASSISTANT_REQUIRED).filter(
+    (key) => !assistant.keys.includes(key),
+  );
   if (missing.length > 0)
     out.push(
       `O assistente precisa declarar ${missing.map((key) => ASSISTANT_REQUIRED[key]).join("; ")}.`,
@@ -1402,7 +1448,9 @@ export function checkProject(sources) {
 
   for (const [resource, owners] of assistantResources) {
     if (owners.length < 2) continue;
-    const names = owners.map(({ item }) => item.name ?? item.ident ?? "(sem name)");
+    const names = owners.map(
+      ({ item }) => item.name ?? item.ident ?? "(sem name)",
+    );
     for (const { item, file } of owners) {
       findings.push({
         rule: "assistant-declaration",
@@ -1707,6 +1755,22 @@ function directStructuralChildren(node, imports) {
   for (const child of node.children) {
     if (ts.isJsxText(child) && child.text.trim() === "") continue;
     if (ts.isJsxExpression(child) && child.expression === undefined) continue;
+    if (
+      ts.isJsxExpression(child) &&
+      child.expression &&
+      ts.isConditionalExpression(child.expression)
+    ) {
+      const branches = [child.expression.whenTrue, child.expression.whenFalse];
+      const slots = branches.map((branch) =>
+        ts.isJsxElement(branch) || ts.isJsxSelfClosingElement(branch)
+          ? imports.get(jsxLocalName(branch))
+          : undefined,
+      );
+      if (slots[0] !== undefined && slots[0] === slots[1]) {
+        names.push(slots[0]);
+        continue;
+      }
+    }
     if (ts.isJsxElement(child) || ts.isJsxSelfClosingElement(child)) {
       const local = jsxLocalName(child);
       const imported = local === null ? null : imports.get(local);
@@ -1957,6 +2021,7 @@ function countPageHeadingSources(page, imports) {
           local !== null &&
           ((imports.get(local) === "Surface" &&
             jsxNumericAttribute(node, "level") === 1) ||
+            imports.get(local) === "PageIntro" ||
             imports.get(local) === "PageState")
         ) {
           if (imports.get(local) === "PageState") states += 1;
@@ -2095,11 +2160,55 @@ export function checkUiStructure(file, text) {
         }
       }
 
-      if (component !== null && UI_STRUCTURAL_BODIES.has(component)) {
-        const overridden = jsxStringAttributeValues(
-          jsxOpening(node),
-          "className",
-        )
+      if (["PageBody", "DialogBody", "DrawerBody"].includes(component)) {
+        const intro = component.replace("Body", "Intro");
+        const visible = (children) =>
+          children.flatMap((child) => {
+            if (ts.isJsxText(child)) return child.text.trim() ? [child] : [];
+            if (ts.isJsxFragment(child)) return visible(child.children);
+            if (
+              ts.isJsxExpression(child) &&
+              (!child.expression ||
+                [
+                  ts.SyntaxKind.NullKeyword,
+                  ts.SyntaxKind.FalseKeyword,
+                  ts.SyntaxKind.TrueKeyword,
+                ].includes(child.expression.kind))
+            )
+              return [];
+            return [child];
+          });
+        const children = ts.isJsxElement(node) ? visible(node.children) : [];
+        const indexes = children.flatMap((child, index) =>
+          (ts.isJsxElement(child) || ts.isJsxSelfClosingElement(child)) &&
+          imports.get(jsxLocalName(child)) === intro
+            ? [index]
+            : [],
+        );
+        if (indexes.length > 1 || (indexes.length === 1 && indexes[0] !== 0)) {
+          add(
+            node,
+            component,
+            `${intro} deve ser o primeiro e único bloco introdutório de ${component}.`,
+            "ui-structure-intro-order",
+          );
+        }
+      }
+
+      if (
+        component !== null &&
+        (UI_STRUCTURAL_BODIES.has(component) || component === "Page")
+      ) {
+        const attributes =
+          component === "Page"
+            ? ["contentClassName"]
+            : component === "PageBody"
+              ? ["className", "contentClassName"]
+              : ["className"];
+        const overridden = attributes
+          .flatMap((attribute) =>
+            jsxStringAttributeValues(jsxOpening(node), attribute),
+          )
           .flatMap((value) => value.trim().split(/\s+/))
           .filter((token) => UI_BODY_RHYTHM_CLASS.test(token));
         if (overridden.length > 0) {
@@ -2686,8 +2795,8 @@ export async function scanDir(rootDir) {
   for (const file of files) {
     const text = readProjectFile(rootDir, path.relative(rootDir, file)).content;
     if (
-      ![...ACTION_MARKERS, ...DATA_PRODUCT_MARKERS, ...RETENTION_MARKERS].some((m) =>
-        text.includes(m),
+      ![...ACTION_MARKERS, ...DATA_PRODUCT_MARKERS, ...RETENTION_MARKERS].some(
+        (m) => text.includes(m),
       )
     )
       continue;

package/docs/adr/0015-action-size-follows-interaction-density.md

@@ -1,5 +1,7 @@
 # ADR 0015 — O tamanho da ação acompanha a densidade da interação
 
+> Parcialmente substituída pela [ADR 0060](0060-surface-composition-separates-chrome-and-intro.md), que define a composição e a escala atuais dos headers.
+
 - **Status:** aceita.
 - **Data:** 2026-09-12.
 

package/docs/adr/0017-ui-assumes-a-fixed-desktop-layout.md

@@ -2,7 +2,7 @@
 
 - **Status:** aceita.
 - **Data:** 2026-09-15.
-- **Emenda:** 2026-10-07; portal documental delimitado pela ADR 0057.
+- **Emendas:** 2026-10-07 e 2026-10-13; portal documental delimitado pela ADR 0057.
 
 ## Contexto
 
@@ -32,8 +32,9 @@ nesse caso, o cancelamento usa `outline`.
 ### Exceção: portal de documentação
 
 O portal documental tem uma jornada de leitura distinta da UI operacional das aplicações. Conforme
-a ADR 0057, `DocHeader`, a leitura editorial de `DocBrowser` e `DocCatalog`/`DocRecordDetail`
-podem adaptar cabeçalho, espaçamento e sumário à largura da tela. A exceção foi aprovada para
+a ADR 0057, `DocHeader`, a leitura editorial e a navegação móvel opcional de `DocBrowser`,
+além de `DocCatalog`/`DocRecordDetail`, podem adaptar cabeçalho, navegação, espaçamento e
+sumário à largura da tela. A exceção foi aprovada para
 preservar a composição validada nos portais do Opus e da Grand Brasil.
 
 A exceção não torna responsivos `Split`, `Sidebar`, formulários, tabelas ou outros componentes da
@@ -41,9 +42,13 @@ UI das aplicações. O host documental continua responsável pela composição d
 estreita. Exemplos vivos usam o mesmo contrato desktop dos componentes demonstrados; o portal não
 promete que todos os exemplos sejam adequados a telas menores que `64rem`.
 
-O gate permite variantes de viewport somente nos três arquivos documentais identificados na ADR
-0057. Arquivos novos, mesmo dentro de `docs/`, continuam sujeitos à regra até uma decisão explícita.
-Container queries não entram na exceção.
+O gate permite variantes de viewport somente nas funções editoriais identificadas pela ADR 0057.
+A consulta direta de largura via `matchMedia` tem uma exceção separada: somente os helpers
+`subscribeCompactNavigation` e `compactNavigationSnapshot` de `DocBrowser.tsx` podem consultar
+a constante `compactNavigationQuery`, fixada em `(max-width: 48rem)`. Isso não libera variantes
+na função `DocBrowser`. Chamadas diretas com consultas dinâmicas não identificáveis são recusadas;
+preferências explícitas continuam permitidas. Arquivos novos, mesmo dentro de `docs/`, seguem
+a regra. Container queries não entram na exceção.
 
 ## Consequências
 
@@ -67,7 +72,8 @@ Container queries não entram na exceção.
 ## Verificação
 
 - Um teste de inventário reprova variantes de largura e container queries na UI viva.
-- O mesmo teste delimita a exceção documental por arquivo e comprova que ela não alcança componentes
-  da aplicação, outros arquivos documentais ou container queries.
+- O mesmo teste delimita a exceção documental por função e verifica chamadas diretas de `matchMedia`,
+  inclusive constantes e consultas dinâmicas. Mutações fora dos helpers, do arquivo ou do breakpoint
+  documentados reprovam; a exceção não alcança componentes da aplicação nem container queries.
 - Testes estruturais fixam layouts, larguras de modal e distribuição dos footers.
 - Documentação pública declara a largura mínima, o default por conteúdo e a exceção `equal`.

package/docs/adr/0029-page-header-is-the-single-page-introduction.md

@@ -1,6 +1,8 @@
 # ADR 0029 — PageHeader é a única introdução estrutural da página
 
-- **Status:** aceita.
+> Parcialmente substituída pela [ADR 0060](0060-surface-composition-separates-chrome-and-intro.md), que define a composição e a escala atuais dos headers.
+
+- **Status:** substituída parcialmente pela ADR 0060 na versão 28.0.0 da composição com intro.
 - **Data:** 2026-09-28.
 - **Substitui:** ADR 0011, quanto à barra persistente e à separação entre `PageHeader` e
   `PageIntro`.

package/docs/adr/0057-doc-browser-permite-busca-no-chrome-do-consumidor.md

@@ -1,8 +1,37 @@
 # ADR 0057 — Portal documental compartilha navegação, busca e leitura
 
-- **Status:** aceita para implementação local; publicação pendente.
+- **Status:** aceita; composição original em 25.7.0, subgrupos e abertura em nova aba em 26.2.0,
+  navegação recolhível e sequência de leitura em 27.1.0.
 - **Data:** 2026-10-07.
 
+> **Emenda — 2026-10-13, versão 27.1.0:** a composição anterior reúne as entregas
+> das versões 25.7.0 e 26.2.0. Esta extensão separa presença no mapa de participação na leitura:
+> `DocSection.readingSequence: false` retira a seção dos links anterior/próxima, mas
+> preserva busca, contexto e URLs. A omissão mantém a sequência existente. Excluir o
+> arquivo histórico da árvore impediria sua descoberta; duplicar o mapa para calcular
+> continuidade criaria duas ordens concorrentes.
+>
+> `DocBrowser.collapsibleNavigation` é opcional e começa desligado. Quando ligado, em
+> telas de até `48rem`, oferece um botão de navegação e começa recolhido. Ao abrir,
+> a árvore ocupa a área disponível no lugar da leitura, sem a faixa fixa de `14rem`.
+> A seleção de um destino interno e a tecla Escape recolhem o menu; editar a busca revela
+> seus resultados. A consulta preenchida na montagem não abre o menu sobre a leitura.
+> A árvore permanece montada para preservar ramos abertos. Acima
+> desse limite, a lateral continua visível. `Split` e `Sidebar` não mudam de contrato.
+> O host preserva a instância também entre Documentação e UI: remontá-la descartaria
+> o botão que recebeu o foco e o estado dos ramos. Mapas distintos usam `basePath`
+> distintos; as chaves dos ramos incluem essa identidade antes da posição no mapa.
+> Assim, abrir um capítulo em Documentação não abre outro na mesma posição em UI,
+> e voltar restaura a abertura manual. A ordem interna de cada mapa permanece estável.
+> Escape retorna
+> o foco ao botão Navegação, inclusive quando acionado pela busca externa; a consulta
+> permanece para permitir retomar os mesmos resultados.
+> Esta composição substitui os ajustes CSS duplicados nos dois portais, estendendo
+> a exceção documental à montagem do navegador, não aos exemplos ou demais telas.
+> A alternativa de manter uma lateral curta preservaria a rolagem que esconde destinos
+> globais. Testes de teclado, redimensionamento, busca, rotas e sequência de leitura,
+> além de inspeção visual nos dois consumidores, verificam a extensão antes de publicar.
+
 ## Contexto
 
 Portais de documentação precisam apresentar guias, decisões e entregas sem trocar o mapa de
@@ -114,10 +143,14 @@ A composição documental é uma exceção explícita à ADR 0017: `DocHeader.ts
 (na leitura editorial) e `DocCatalog.tsx` (incluindo `DocRecordDetail`) podem usar variantes de
 viewport para organizar cabeçalho, sumário e espaçamento. A exceção fica restrita a esses arquivos;
 não libera toda a pasta `docs/` nem container queries. O gate verifica as funções de composição
-permitidas, sem liberar outras funções ou a montagem de `Split` no mesmo arquivo.
+permitidas. A emenda de 13/10 admite a consulta de largura via `matchMedia` apenas nos helpers
+`subscribeCompactNavigation` e `compactNavigationSnapshot`, em `DocBrowser.tsx`, usando a
+constante `compactNavigationQuery` fixada em `(max-width: 48rem)`. Variantes de viewport
+continuam proibidas na função `DocBrowser`; consultas diretas dinâmicas não identificáveis
+também reprovam. Preferências explícitas de acessibilidade e tema permanecem permitidas.
 
 Essa adaptação foi aprovada para o portal de leitura, não para a UI das aplicações. O host organiza
-sua moldura em telas estreitas; `Split`, `Sidebar` e os exemplos vivos não ganham um contrato
+sua moldura; o navegador pode oferecer sua navegação móvel opcional. `Split`, `Sidebar` e os exemplos vivos não ganham um contrato
 responsivo por estarem dentro da documentação. Manter o portal inteiramente desktop descartaria
 a composição já validada; ampliar a exceção para toda a UI alteraria uma decisão fora deste escopo.
 
@@ -159,8 +192,9 @@ e separa a consulta documental da consulta local.
 - Os dois portais compartilham cabeçalho e catálogos sem compartilhar sua taxonomia específica.
 - Guias, índices e fontes acessíveis por URL direta precisam ser filtrados antes de chegar ao
   navegador quando houver restrição de acesso. Esta composição não é uma fronteira de segurança.
-- A consolidação é um candidato local. A publicação e a adoção pela Grand Brasil são etapas
-  distintas, posteriores à revisão independente.
+- A composição original integra a versão 25.7.0; subgrupos e abertura em nova aba, a 26.2.0;
+  a navegação recolhível e a sequência de leitura, a 27.1.0. A adoção por cada portal é uma
+  etapa própria.
 
 ## Verificação