@slotted/angular 0.1.0-beta.8 → 0.1.0-beta.9

package/docs/code-block.json

@@ -84,103 +84,103 @@
           "part": "root",
           "element": "div",
           "required": true,
-          "purpose": "A moldura: o fundo afundado, a aresta e o raio que prose já desenha numa cerca. Carrega data-ui=\"code-block\", data-language, data-wrap, data-revealed, data-line-numbers, data-loading, data-marks e os quatro valores de runtime."
+          "purpose": "The frame: the sunken background, the edge and the radius that prose already draws on a fence. Carries data-ui=\"code-block\", data-language, data-wrap, data-revealed, data-line-numbers, data-loading, data-marks and the four runtime values."
         },
         {
           "part": "header",
           "element": "div",
           "required": false,
-          "purpose": "O nome do ficheiro, a linguagem no fim e os controles. Existe quando há título, linguagem, cópia ou ações do consumidor. Mantém a direção da página."
+          "purpose": "The file name, the language at the end and the controls. Exists when there is a title, a language, copy or consumer actions. Keeps the page direction."
         },
         {
           "part": "icon",
           "element": "span",
           "required": false,
-          "purpose": "O glifo da espécie do ficheiro ao lado do título, escolhido por fileKind a partir do nome."
+          "purpose": "The glyph of the file kind next to the title, chosen by fileKind from the name."
         },
         {
           "part": "title",
           "element": "span",
           "required": false,
-          "purpose": "O nome do ficheiro, em mono, truncado com reticências. É o nome da região de rolagem."
+          "purpose": "The file name, in mono, truncated with an ellipsis. It is the name of the scroll region."
         },
         {
           "part": "language",
           "element": "span",
           "required": false,
-          "purpose": "A linguagem em maiúsculas pequenas, no fim do cabeçalho."
+          "purpose": "The language in small caps, at the end of the header."
         },
         {
           "part": "actions",
           "element": "div",
           "required": false,
-          "purpose": "Os controles: os do consumidor, projetados por slCodeBlockAction, o wrap e o copy. Sem cabeçalho flutua sobre a primeira linha, no fundo do bloco."
+          "purpose": "The controls: the consumer’s, projected by slCodeBlockAction, wrap and copy. Without a header it floats over the first line, at the end of the block."
         },
         {
           "part": "wrap",
           "element": "button",
           "required": false,
-          "purpose": "aria-pressed: quebra as linhas na caixa. Desenhado só enquanto uma linha transborda, ou enquanto já está quebrado."
+          "purpose": "aria-pressed: wraps the lines in the box. Drawn only while a line overflows, or while it is already wrapped."
         },
         {
           "part": "copy",
           "element": "button",
           "required": false,
-          "purpose": "O controle de description-list: escreve o código, não o DOM, sem as linhas removidas; data-complete por dois segundos com o check no lugar das folhas."
+          "purpose": "The copy control: writes the code, not the DOM, without the removed lines; data-complete for two seconds with the check in place of the sheets."
         },
         {
           "part": "body",
           "element": "div",
           "required": true,
-          "purpose": "Um scroll-area vestido como data-ui: a região com nome e parada de tabulação só enquanto o código transborda, a barra da plataforma, o véu na ponta."
+          "purpose": "A scroll-area dressed as data-ui: the named region and tab stop only while the code overflows, the platform scrollbar, the veil at the end."
         },
         {
           "part": "pre",
           "element": "pre",
           "required": true,
-          "purpose": "white-space: pre, direction: ltr seja qual for a página, pre-wrap sob data-wrap."
+          "purpose": "white-space: pre, direction: ltr whatever the page, pre-wrap under data-wrap."
         },
         {
           "part": "code",
           "element": "code",
           "required": true,
-          "purpose": "class=\"language-<x>\", a convenção da especificação HTML; uma grelha de linhas."
+          "purpose": "class=\"language-<x>\", the convention of the HTML specification; a grid of lines."
         },
         {
           "part": "line",
           "element": "span",
           "required": true,
-          "purpose": "Uma linha da grelha: número, marcador, texto. data-line, data-mark e data-dim; --slotted-code-block-indent sob wrap."
+          "purpose": "A row of the grid: number, marker, text. data-line, data-mark and data-dim; --slotted-code-block-indent under wrap."
         },
         {
           "part": "number",
           "element": "span",
           "required": true,
-          "purpose": "O número, aria-hidden e não selecionável; escondido sem lineNumbers, mas no DOM, para nada se mover ao ligar."
+          "purpose": "The number, aria-hidden and not selectable; hidden without lineNumbers, but in the DOM, so nothing moves when it is turned on."
         },
         {
           "part": "marker",
           "element": "span",
           "required": true,
-          "purpose": "A coluna do sinal: + e − nas linhas de diff, escritos por CSS e fora de qualquer seleção."
+          "purpose": "The sign column: + and − on diff lines, written by CSS and outside any selection."
         },
         {
           "part": "text",
           "element": "span",
           "required": true,
-          "purpose": "A corrida de tokens da linha, a terceira coluna. É o que um ng-template slCodeBlockLine substitui."
+          "purpose": "The token run of the line, the third column. It is what an ng-template slCodeBlockLine replaces."
         },
         {
           "part": "token",
           "element": "span",
           "required": false,
-          "purpose": "Um token com escopo, data-token entre os doze; um token sem escopo é texto puro."
+          "purpose": "A scoped token, data-token among the twelve; a token without a scope is plain text."
         },
         {
           "part": "reveal",
           "element": "button",
           "required": false,
-          "purpose": "\"Show n more lines\" quando collapseAfter esconde linhas; \"Show less\" quando reveladas. Escape no bloco revelado dobra-o."
+          "purpose": "\"Show n more lines\" when collapseAfter hides lines; \"Show less\" when they are revealed. Escape in the revealed block folds it."
         }
       ],
       "api": [
@@ -189,154 +189,154 @@
           "type": "string",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "A fonte, como texto. Nunca HTML"
+          "description": "The source, as text. Never HTML"
         },
         {
           "name": "language",
           "type": "string",
           "defaultValue": "text",
           "appliesTo": "CodeBlock",
-          "description": "data-language e class=\"language-<x>\""
+          "description": "data-language and class=\"language-<x>\""
         },
         {
           "name": "highlight",
           "type": "CodeHighlighter | null",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "O motor; null recusa o do injector"
+          "description": "The engine; null refuses the injector’s"
         },
         {
           "name": "tokens",
           "type": "CodeLine[]",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Linhas já tokenizadas pelo consumidor"
+          "description": "Lines the consumer already tokenized"
         },
         {
           "name": "title",
           "type": "string",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "O nome do ficheiro no cabeçalho, e o nome da região"
+          "description": "The file name in the header, and the region name"
         },
         {
           "name": "fileName",
           "type": "string",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "O nome para o glifo, quando o título não é o nome"
+          "description": "The name for the glyph, when the title is not the name"
         },
         {
           "name": "lineNumbers",
           "type": "boolean",
           "defaultValue": "false",
           "appliesTo": "CodeBlock",
-          "description": "O contador na goteira"
+          "description": "The counter in the gutter"
         },
         {
           "name": "start",
           "type": "number",
           "defaultValue": "1",
           "appliesTo": "CodeBlock",
-          "description": "O número da primeira linha"
+          "description": "The number of the first line"
         },
         {
           "name": "marks",
           "type": "CodeMarks",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "highlight, add, remove, focus, error, warning — intervalos \"1,4-6\" ou listas"
+          "description": "highlight, add, remove, focus, error, warning — ranges \"1,4-6\" or lists"
         },
         {
           "name": "wrap",
           "type": "model<boolean | undefined>",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "[(wrap)]: presente é controlado, para a vida do bloco"
+          "description": "[(wrap)]: present means controlled, for the life of the block"
         },
         {
           "name": "defaultWrap",
           "type": "boolean",
           "defaultValue": "false",
           "appliesTo": "CodeBlock",
-          "description": "Onde um bloco não controlado começa"
+          "description": "Where an uncontrolled block starts"
         },
         {
           "name": "collapseAfter",
           "type": "number",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Linhas visíveis antes do controle de revelar"
+          "description": "Visible lines before the reveal control"
         },
         {
           "name": "revealed",
           "type": "model<boolean | undefined>",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "[(revealed)]: presente é controlado"
+          "description": "[(revealed)]: present means controlled"
         },
         {
           "name": "defaultRevealed",
           "type": "boolean",
           "defaultValue": "false",
           "appliesTo": "CodeBlock",
-          "description": "Onde um bloco não controlado começa"
+          "description": "Where an uncontrolled block starts"
         },
         {
           "name": "maxLines",
           "type": "number",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Linhas antes de o corpo rolar"
+          "description": "Lines before the body scrolls"
         },
         {
           "name": "copy",
           "type": "boolean",
           "defaultValue": "true",
           "appliesTo": "CodeBlock",
-          "description": "O controle de cópia"
+          "description": "The copy control"
         },
         {
           "name": "copyRemoved",
           "type": "boolean",
           "defaultValue": "false",
           "appliesTo": "CodeBlock",
-          "description": "Mantém as linhas removidas na cópia"
+          "description": "Keeps the removed lines in the copy"
         },
         {
           "name": "loading",
           "type": "boolean",
           "defaultValue": "false",
           "appliesTo": "CodeBlock",
-          "description": "Skeletons na altura de seis linhas, aria-busy, sem cópia"
+          "description": "Skeletons at the height of six lines, aria-busy, no copy"
         },
         {
           "name": "tabSize",
           "type": "number",
           "defaultValue": "2",
           "appliesTo": "CodeBlock",
-          "description": "Largura de um tab, para o indent da continuação"
+          "description": "Width of a tab, for the continuation indent"
         },
         {
           "name": "messages",
           "type": "PartialMessages<CodeBlockMessages>",
           "defaultValue": "—",
           "appliesTo": "slCodeBlock",
-          "description": "As palavras da família sobre o idioma em vigor, chave a chave"
+          "description": "The family’s words over the current locale, key by key"
         },
         {
           "name": "ng-template[slCodeBlockLine]",
-          "type": "projeção",
+          "type": "projection",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Substitui a corrida de tokens de cada linha; recebe os tokens, o número, a marca e o esmaecer"
+          "description": "Replaces the token run of each line; receives the tokens, the number, the mark and the dimming"
         },
         {
           "name": "[slCodeBlockAction]",
-          "type": "projeção",
+          "type": "projection",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Controles do consumidor ao lado de copy e wrap"
+          "description": "Consumer controls next to copy and wrap"
         }
       ],
       "composition": [
@@ -345,72 +345,72 @@
           "type": "slCodeBlock",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Alcança a instância a partir da template: #block=\"slCodeBlock\" e block.copyCode() ou block.scrollToLine(12)"
+          "description": "Reaches the instance from the template: #block=\"slCodeBlock\" and block.copyCode() or block.scrollToLine(12)"
         },
         {
           "name": "ng-template[slCodeBlockLine]",
           "type": "let-tokens, let-number=\"number\", let-mark=\"mark\", let-dim=\"dim\"",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "A linha à maneira da aplicação; a goteira fica da família"
+          "description": "The line the application’s way; the gutter stays the family’s"
         },
         {
           "name": "[slCodeBlockAction]",
           "type": "ng-content",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Um \"Run\" ou um \"Open in editor\" ao lado dos controles"
+          "description": "A \"Run\" or an \"Open in editor\" next to the controls"
         },
         {
           "name": "provideCodeBlockDefaults()",
           "type": "highlight | lineNumbers | copy",
           "defaultValue": "—",
           "appliesTo": "Injector",
-          "description": "O motor carregado uma vez, para todos os blocos por baixo; um input no bloco ganha"
+          "description": "The engine loaded once, for every block below; an input on the block wins"
         },
         {
           "name": "slTabs",
-          "type": "composição",
+          "type": "composition",
           "defaultValue": "—",
-          "appliesTo": "em volta",
-          "description": "Vários ficheiros: um bloco por painel"
+          "appliesTo": "around",
+          "description": "Several files: one block per panel"
         },
         {
           "name": "id, aria-*, data-*, (keydown)",
-          "type": "atributos nativos",
+          "type": "native attributes",
           "defaultValue": "—",
           "appliesTo": "CodeBlock",
-          "description": "Ficam no elemento host; o listener do consumidor corre a par do da família"
+          "description": "Stay on the host element; the consumer’s listener runs alongside the family’s"
         }
       ],
       "events": [
         {
           "name": "(wrapChangeRequest)",
           "payload": "ChangeRequest<boolean>",
-          "when": "Antes de as linhas quebrarem ou desquebrarem; [(wrap)] é a outra metade, o valor. O pedido leva a razão — pointer, keyboard ou programmatic — e o evento de origem; cancelá-lo não move nada."
+          "when": "Before the lines wrap or unwrap; [(wrap)] is the other half, the value. The request carries the reason — pointer, keyboard or programmatic — and the source event; cancelling it moves nothing."
         },
         {
           "name": "(revealedChangeRequest)",
           "payload": "ChangeRequest<boolean>",
-          "when": "Antes de o bloco revelar ou dobrar as linhas escondidas; [(revealed)] é o valor. A razão é pointer, keyboard, escape ou programmatic."
+          "when": "Before the block reveals or folds the hidden lines; [(revealed)] is the value. The reason is pointer, keyboard, escape or programmatic."
         },
         {
           "name": "(copyRequest)",
           "payload": "{ value, copied, reason, source }",
-          "when": "Depois de o controle, ou copyCode(), escrever na área de transferência. copied é false quando a plataforma recusou."
+          "when": "After the control, or copyCode(), writes to the clipboard. copied is false when the platform refused."
         },
         {
           "name": "(highlightError)",
           "payload": "unknown",
-          "when": "Quando o motor rejeita. O texto puro fica."
+          "when": "When the engine rejects. The plain text stays."
         }
       ],
       "accessibility": [
-        "O bloco não tem papel: é texto, lido como texto. O role=\"textbox\" com aria-readonly do Carbon num bloco que ninguém edita é recusado por escrito no contrato.",
-        "O corpo é um scroll-area: role=\"region\", tabindex=\"0\" e um nome — o título, depois aria-label, depois \"Code\" — só enquanto o código transborda, que é o que SC 2.1.1 e scrollable-region-focusable pedem. As teclas de rolar são as da plataforma; a família não escreve nenhuma.",
-        "A goteira dos números e dos sinais é aria-hidden e user-select: none: um leitor de ecrã ouve o código e não uma contagem, e uma seleção pelo bloco copia código e nada mais.",
-        "O controle de cópia anuncia \"Copied\" ou \"Copy failed\" pelo live-announcer partilhado e troca o glifo além da cor; o de wrap é aria-pressed; o de revelar leva aria-expanded e aria-controls para o corpo.",
-        "Um HTML de motor nunca entra: os tokens são texto em spans, e um <script> numa amostra são os seis caracteres que é."
+        "The block has no role: it is text, read as text. Carbon’s role=\"textbox\" with aria-readonly on a block nobody edits is refused in writing in the contract.",
+        "The body is a scroll-area: role=\"region\", tabindex=\"0\" and a name — the title, then aria-label, then \"Code\" — only while the code overflows, which is what SC 2.1.1 and scrollable-region-focusable ask for. The scroll keys are the platform’s; the family writes none.",
+        "The gutter of numbers and signs is aria-hidden and user-select: none: a screen reader hears the code and not a count, and a selection across the block copies code and nothing else.",
+        "The copy control announces \"Copied\" or \"Copy failed\" through the shared live-announcer and swaps the glyph as well as the color; the wrap control is aria-pressed; the reveal control carries aria-expanded and aria-controls pointing to the body.",
+        "Engine HTML never enters: the tokens are text in spans, and a <script> in a sample is the six characters it is."
       ]
     }
   },
@@ -487,129 +487,129 @@
     {
       "id": "playground",
       "title": "Playground",
-      "note": "Um ficheiro TypeScript com título, números de linha e um intervalo realçado, movido pelos controlos por baixo do palco.",
+      "note": "A TypeScript file with a title, line numbers and a highlighted range, moved by the controls below the stage.",
       "language": "html",
       "source": "<div\n  slCodeBlock\n  [code]=\"source\"\n  language=\"ts\"\n  lineNumbers\n  [marks]=\"{ highlight: '5-6' }\"\n  title=\"group.ts\"\n></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "highlight",
-      "title": "Texto primeiro, tokens quando chegam",
-      "note": "O bloco desenha o texto puro no primeiro paint e troca os tokens linha a linha quando o motor responde: a altura não muda, porque cada linha é uma fila da grelha. As cores são a escala --slotted-code-* do tema, e mudam com o esquema.",
+      "title": "Text first, tokens when they arrive",
+      "note": "The block draws the plain text on the first paint and swaps in the tokens line by line when the engine answers: the height does not change, because each line is a row of the grid. The colors are the theme’s --slotted-code-* scale, and change with the scheme.",
       "language": "html",
       "source": "<div slCodeBlock [code]=\"source\" [highlight]=\"tokenise\" language=\"ts\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "engines",
-      "title": "Prism e Shiki entram pelos mapeamentos",
-      "note": "A família não carrega gramática nenhuma. fromPrismTokens dobra os nomes padrão do Prism sobre os doze escopos; fromShikiTokens lê o último escopo TextMate de cada token. Um HTML de motor nunca entra: o que chega é texto em spans.",
+      "title": "Prism and Shiki come in through the mappings",
+      "note": "The family loads no grammar. fromPrismTokens folds the standard Prism names onto the twelve scopes; fromShikiTokens reads the last TextMate scope of each token. Engine HTML never enters: what arrives is text in spans.",
       "language": "ts",
       "source": "const prism = (code, lang) => fromPrismTokens(Prism.tokenize(code, Prism.languages[lang]));\nconst shiki = async (code, lang) =>\n  fromShikiTokens(\n    await codeToTokens(code, { includeExplanation: 'scopeName', lang, theme: 'none' }),\n  );\n",
       "verdict": "excerpt"
     },
     {
       "id": "lineNumbers",
-      "title": "Números de linha",
-      "note": "lineNumbers desenha um contador numa goteira larga o bastante para o último número, medida em ch; start diz por onde começa. A goteira é aria-hidden e user-select: none, por isso uma seleção pelo bloco copia código e nada mais.",
+      "title": "Line numbers",
+      "note": "lineNumbers draws a counter in a gutter wide enough for the last number, measured in ch; start says where it begins. The gutter is aria-hidden and user-select: none, so a selection across the block copies code and nothing else.",
       "language": "html",
       "source": "<div slCodeBlock [code]=\"source\" language=\"ts\" lineNumbers start=\"98\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "marks",
-      "title": "Linhas marcadas",
-      "note": "marks toma intervalos \"1,4-6\" ou listas de números: highlight tinge com o acento e uma barra na ponta; error e warning com danger e warning. A tinta é do texto do tom a 7,5%, para nenhum escopo cair abaixo de 4,5:1.",
+      "title": "Marked lines",
+      "note": "marks takes ranges \"1,4-6\" or lists of numbers: highlight tints with the accent and a bar at the edge; error and warning with danger and warning. The tint is the tone’s text color at 7.5%, so no scope falls below 4.5:1.",
       "language": "html",
       "source": "<div\n  slCodeBlock\n  [code]=\"source\"\n  language=\"sh\"\n  [marks]=\"{ error: '3', highlight: '1', warning: [4] }\"\n></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "diff",
-      "title": "Um diff",
-      "note": "add e remove tingem com success e danger e escrevem + e − na goteira, por CSS. O controle de cópia deixa as linhas removidas de fora, porque o código depois da mudança é o que se cola; copyRemoved mantém-nas.",
+      "title": "A diff",
+      "note": "add and remove tint with success and danger and write + and − in the gutter, by CSS. The copy control leaves the removed lines out, because the code after the change is what gets pasted; copyRemoved keeps them.",
       "language": "html",
       "source": "<div\n  slCodeBlock\n  [code]=\"source\"\n  language=\"css\"\n  lineNumbers\n  [marks]=\"{ add: '4-6', remove: '2-3' }\"\n></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "focus",
-      "title": "Foco numa parte do bloco",
-      "note": "focus esmaece e desfoca as linhas fora do intervalo; o bloco levanta o véu com o ponteiro em cima ou o foco dentro, por isso quem quer o resto tem-no. Sob reduced-motion o desfoque sai e o esmaecer fica, porque é a informação.",
+      "title": "Focus on one part of the block",
+      "note": "focus dims and blurs the lines outside the range; the block lifts the veil with the pointer over it or focus inside, so whoever wants the rest gets it. Under reduced-motion the blur goes and the dimming stays, because the dimming is the information.",
       "language": "html",
       "source": "<div slCodeBlock [code]=\"source\" language=\"json\" [marks]=\"{ focus: '3-6' }\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "wrap",
-      "title": "Quebrar linhas longas",
-      "note": "O controle de wrap só aparece enquanto uma linha transborda — a regra do Docusaurus — e é um botão pressionado. A continuação de uma linha quebrada indenta-se ao próprio indent do código, medido uma vez por linha em ch.",
+      "title": "Wrapping long lines",
+      "note": "The wrap control appears only while a line overflows — the Docusaurus rule — and is a pressed button. The continuation of a wrapped line indents to the code’s own indent, measured once per line in ch.",
       "language": "html",
       "source": "<div\n  slCodeBlock\n  [code]=\"command\"\n  defaultWrap\n  language=\"sh\"\n  (wrapChangeRequest)=\"log($event.reason)\"\n></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "title",
-      "title": "Um ficheiro com nome",
-      "note": "title põe o cabeçalho com o nome em mono, o glifo da espécie do ficheiro — uma folha de texto para um .ts, uma folha de tabela para um .csv — e a linguagem no fim. O título é também o nome da região de rolagem.",
+      "title": "A named file",
+      "note": "title puts up the header with the name in mono, the glyph of the file kind — a text sheet for a .ts, a table sheet for a .csv — and the language at the end. The title is also the name of the scroll region.",
       "language": "html",
       "source": "<div slCodeBlock [code]=\"rows\" language=\"csv\" title=\"orders-2026-09.csv\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "collapse",
-      "title": "Dobrado atrás de \"Show more\"",
-      "note": "collapseAfter esconde o que passa de n linhas atrás de um controle; a última linha visível desvanece-se nele. revealed é o modelo de estado; Escape dentro do bloco revelado dobra-o e mantém o foco. As linhas escondidas ficam no DOM e numa seleção.",
+      "title": "Folded behind \"Show more\"",
+      "note": "collapseAfter hides what goes past n lines behind a control; the last visible line fades into it. revealed is the state model; Escape inside the revealed block folds it and keeps focus. The hidden lines stay in the DOM and in a selection.",
       "language": "html",
       "source": "<div\n  slCodeBlock\n  [code]=\"source\"\n  collapseAfter=\"6\"\n  language=\"json\"\n  [(revealed)]=\"revealed\"\n  (revealedChangeRequest)=\"track($event.value)\"\n></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "maxLines",
-      "title": "Rolar além de um máximo",
-      "note": "maxLines limita a altura do corpo e o scroll-area rola o resto, com a região nomeada e alcançável por Tab. Compõe com collapseAfter: um bloco dobrado a oito e, revelado, rolando além de quarenta.",
+      "title": "Scrolling past a maximum",
+      "note": "maxLines limits the body height and the scroll-area scrolls the rest, with the region named and reachable by Tab. It composes with collapseAfter: a block folded at eight and, revealed, scrolling past forty.",
       "language": "html",
       "source": "<div slCodeBlock [code]=\"log\" language=\"text\" lineNumbers maxLines=\"12\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "copy",
-      "title": "Copiar",
-      "note": "O controle escreve o código que o consumidor deu, nunca o texto do DOM: nem números, nem sinais, nem quebras. Terminado, o check fica dois segundos no lugar das folhas e \"Copied\" é anunciado; copy=\"false\" tira o controle; copyCode() copia sem ele.",
+      "title": "Copying",
+      "note": "The control writes the code the consumer gave, never the DOM text: no numbers, no signs, no wraps. When done, the check stays two seconds in place of the sheets and \"Copied\" is announced; copy=\"false\" removes the control; copyCode() copies without it.",
       "language": "html",
-      "source": "<div slCodeBlock [code]=\"source\" (copyRequest)=\"$event.copied && toast('Copiado')\"></div>\n",
+      "source": "<div slCodeBlock [code]=\"source\" (copyRequest)=\"$event.copied && toast('Copied')\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "loading",
-      "title": "Código a caminho, e nenhum código",
-      "note": "loading desenha a moldura à altura de seis linhas com skeletons dentro e aria-busy, sem controle de cópia — não um spinner, que é para uma região que já tem conteúdo. Uma string vazia é uma linha vazia com o seu número.",
+      "title": "Code on the way, and no code",
+      "note": "loading draws the frame at the height of six lines with skeletons inside and aria-busy, without a copy control — not a spinner, which is for a region that already has content. An empty string is an empty line with its number.",
       "language": "html",
       "source": "<div slCodeBlock code=\"\" loading title=\"deploy.log\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "content",
-      "title": "Conteúdo que a família não escolheu",
-      "note": "Uma linha de 400 caracteres rola e, sob wrap, parte-se num token indivisível em vez de escapar da caixa; código árabe numa página RTL lê-se da esquerda para a direita; um <script> na amostra são seis caracteres.",
+      "title": "Content the family did not choose",
+      "note": "A 400-character line scrolls and, under wrap, breaks inside an indivisible token instead of escaping the box; Arabic code on an RTL page reads from left to right; a <script> in the sample is six characters.",
       "language": "html",
       "source": "<div slCodeBlock [code]=\"'<script>alert(1)</script>'\" language=\"html\"></div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "composition",
-      "title": "Composição",
-      "note": "Vários ficheiros são tabs com um bloco por painel; uma ação do consumidor entra em actions ao lado do copy, por slCodeBlockAction; um ng-template slCodeBlockLine desenha uma linha à maneira da aplicação; provideCodeBlockDefaults entrega o motor uma vez ao injector.",
+      "title": "Composition",
+      "note": "Several files are tabs with one block per panel; a consumer action goes in actions next to copy, through slCodeBlockAction; an ng-template slCodeBlockLine draws a line the application’s way; provideCodeBlockDefaults hands the engine once to the injector.",
       "language": "ts",
       "source": "providers: [provideCodeBlockDefaults({ highlight: shiki, lineNumbers: true })];\n\n// <div slCodeBlock [code]=\"a\" language=\"ts\" title=\"a.ts\"></div>\n// <div slCodeBlock [code]=\"b\" language=\"css\" title=\"a.css\">\n//   <button slCodeBlockAction slButton size=\"xs\" variant=\"ghost\">Run</button>\n// </div>\n",
       "verdict": "excerpt"
     },
     {
       "id": "keyboard",
-      "title": "Teclado",
-      "note": "Tab: copy, wrap, reveal, e o corpo quando transborda. No corpo as setas, Page, Home, End e Space são os da plataforma; Enter e Space nos controles; Escape num bloco revelado dobra-o e mantém o foco.",
+      "title": "Keyboard",
+      "note": "Tab: copy, wrap, reveal, and the body when it overflows. In the body the arrows, Page, Home, End and Space are the platform’s; Enter and Space on the controls; Escape in a revealed block folds it and keeps focus.",
       "language": "html",
-      "source": "<!-- \"group.ts, region\" — o título, porque o corpo só é uma região com nome enquanto o código transborda. -->\n<div slCodeBlock [code]=\"wide\" language=\"ts\" title=\"group.ts\"></div>\n",
+      "source": "<!-- \"group.ts, region\" — the title, because the body is a named region only while the code overflows. -->\n<div slCodeBlock [code]=\"wide\" language=\"ts\" title=\"group.ts\"></div>\n",
       "verdict": "excerpt"
     }
   ]