sagadeck 1.11.5 → 1.11.6

package/docs/ANDAMENTO.md

@@ -8,6 +8,33 @@ começar. Trabalho em curso vai para o GitHub (commit + push) a cada etapa, nunc
 
 ---
 
+## 1.11.6: rodada de uso real — 23/10/2026 (branch `claude/parada-e-fotos`)
+
+Quatro pedidos reais no sagadeck-dev (conta de teste `verificacao`, tópico "Rodada de uso real"), pelo caminho da
+biblioteca (Nova › Com IA, `POST /api/library/decks/ai`), com o modelo do servidor (deepseek-v4.1-flash): aula de
+vigas de concreto (20 min, com exemplo numérico), pitch de automação da conciliação (5 min), guia de Git (consulta) e
+palestra sobre burnout (15 min). Os quatro saíram em 4 a 9 min cada, variados (11, 3, 12 e 9 layouts diferentes). A
+revisão automática deixou avisos; cada um foi conferido no YAML e na foto do slide:
+- **Bug: `stats` ignorava `prefix`/`suffix`** (o pitch mostrava "4" por "4%"). Corrigido em `elements.js`, com
+  REFERENCIA e formulário do Studio. Teste no `engine.test.js`.
+- **Bug: código quebrava a linha no hífen** (`--no-` / `edit` no dossier do guia). `noHyphenBreak` (markup.js) põe
+  cada hífen num `<span class="hy">`, e o CSS um word joiner por `::after` (não vai na cópia); vale no `code()` e no
+  código do dossier. Testes: `engine.test.js` e `test/code-hyphen.test.js` (no Chrome, com o slide do guia; falha sem a
+  correção).
+- **Bug: barra com `color: hi` usava o marca-texto claro** (palestra, tema editorial: destaque mais fraco que o fundo).
+  `charts.js` usa `--hi-ink`, como o texto. Teste no `engine.test.js`.
+- **Bug: variedade cobrava impacto/respiro/tom de material de consulta**, contra a REFERENCIA. `variety.js` só cobra
+  isso fora de `purpose: consulta`. Teste no `engine.test.js`.
+- **Alarmes falsos da revisão (não mexidos)**: "barras de 48% e 43% quase iguais" (estão proporcionais) e "nota em
+  cinza escuro no preto" (é cinza claro, legível). Ficam como observação: a revisão por imagem ainda erra em proporção
+  e contraste; se voltar a aparecer, olhar a resolução das fotos que vão para ela.
+- Conteúdo, para a IA corrigir (Corrigir tudo com IA): coeficiente 0,68 sem a origem (0,85 × 0,8) e diagrama pequeno
+  na aula; quarto risco só nas notas do pitch.
+- **Testes com o modelo de verdade (1.11.6 é múltipla de 3)**: 25 de 27 de primeira em 25 min, nenhum quebrado.
+  Instáveis (passaram na repetição): "refinamento: conversa e depois 'pode fazer'" (o modelo trocou o slide por outro
+  texto em vez de aplicar o combinado; já tinha aparecido antes) e "gerar deck: sai variado" (estourou os 10 min do
+  teste esperando o provedor; não é a regra da variedade, que só mudou para `consulta`).
+
 ## 1.11.5: parada do servidor, biblioteca no OneDrive — 23/10/2026 (branch `claude/parada-e-fotos`)
 
 - **Parada**: o Playwright, ao abrir o Chrome, instala um tratador de SIGTERM que só fecha o navegador; com ele, o

package/docs/REFERENCIA.md

@@ -93,7 +93,7 @@ Tabela em markdown no meio de um texto (`problem`, `body`, `text`, passo do `sol
 | `hub` | `kicker, title, question, options: [{icon, title, text, meta, goto}], cols, build` | mapa de caminhos: cada opção leva (`goto`) à parte da apresentação daquele caminho; ver [Navegação por caminhos](#navegação-por-caminhos-hub-goto-back-next) |
 | `onepage` | `kicker, title, subtitle, journey: [texto ou {icon, title, text, goto}], journeyTitle, problem: {title, text, numbers: [{value, label}], items}, solution: {…}, dashboard: {numbers: [{value, label, trend, title}], figures: [gráfico ou ufmap, com title]}` | tudo numa página (jornada, problema, solução, painel); ver [One-page](#one-page-onepage) |
 | `status` | `kicker, title, health: ok\|risco\|atrasado, healthLabel, progress (0–100), highlight, done, doing, blocked, risks, upcoming: [texto ou {text, owner, due}], shots: [{image, caption}]` | status semanal; ver [Status semanal](#status-semanal-status) |
-| `stats` | `title, stats: [{value, label, text, icon, trend, trendUp, color}], cols, build` | indicadores (KPIs) em cartões, com tendência (`trend: "+12%"`) |
+| `stats` | `title, stats: [{value, prefix, suffix, label, text, icon, trend, trendUp, color}], cols, build` | indicadores (KPIs) em cartões, com tendência (`trend: "+12%"`) |
 | `timeline` | `title, events: [{when, title, text, tag, more}], highlight, after, build` | linha do tempo; `more` põe um botão + no marco que abre um balão (ver abaixo) |
 | `chart` | `title, chart: {…}, side (texto ou elemento), chartHeight` | gráfico + comentário |
 | `table` | `title, head, rows, style, color, highlight, total, side, caption, source` | tabela de verdade nas cores do tema |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sagadeck",
-  "version": "1.11.5",
+  "version": "1.11.6",
   "description": "Gerador de apresentações: YAML -> HTML animado + PowerPoint editável, com temas e figuras geradas na hora.",
   "type": "module",
   "bin": {

package/src/adaptive-layouts.js

@@ -1,4 +1,4 @@
-import {md,esc} from './markup.js';
+import {md,esc,noHyphenBreak} from './markup.js';
 import {iconSVG} from './figures/icons.js';
 export function adaptiveGrid(items=[],variant='mosaic') {
   const n=items.length;
@@ -14,5 +14,5 @@ export function adaptiveHTML(s,variant) {
   <div class="adaptive-index f-label">${item.icon?iconSVG(item.icon,{size:38}):String(i+1).padStart(2,'0')}</div>
   ${item.value!=null?`<div class="adaptive-value t f-display">${md(String(item.value))}</div>`:''}
   <h3 class="t f-heading">${md(item.title||'')}</h3>${item.text?`<div class="adaptive-text t f-body">${md(item.text)}</div>`:''}
-  ${item.code?`<pre class="adaptive-code f-mono">${esc(item.code)}</pre>`:''}${item.foot?`<div class="adaptive-foot t f-label">${md(item.foot)}</div>`:''}</article>`).join('')}</div>`;
+  ${item.code?`<pre class="adaptive-code f-mono">${noHyphenBreak(esc(item.code))}</pre>`:''}${item.foot?`<div class="adaptive-foot t f-label">${md(item.foot)}</div>`:''}</article>`).join('')}</div>`;
 }

package/src/ai/variety.js

@@ -25,10 +25,16 @@ export function varietyReport(spec) {
   if (n >= 6) {
     const want = Math.min(8, Math.ceil(n * 0.5));
     if (distinct < want) problems.push(`só ${distinct} layouts diferentes em ${n} slides de conteúdo (bom: ${want} ou mais)`);
-    const listy = body.filter((s) => LISTY.has(s.layout)).length;
-    if (listy / n > 0.45) problems.push(`${listy} de ${n} slides são listas/cartões — falta respiro (manchete, número grande, imagem, pergunta)`);
-    if (!body.some((s) => IMPACT.has(s.layout))) problems.push("nenhum slide de impacto (manchete, número grande, frase, página inteira, pergunta)");
-    if (new Set(slides.map((s) => s.tone)).size === 1) problems.push(`todos os slides no mesmo tom (${slides[0].tone}) — alterne com escuro/destaque nos momentos-chave`);
+    // material de consulta (purpose: consulta) é para estudar depois: sem "número de impacto" nem slide só de título
+    // (REFERENCIA), e lista é o normal. Cobrar respiro e impacto ali era aviso falso, e a revisão empurrava a IA a pôr
+    // slides que o propósito pede para não ter (rodada de uso real, guia de Git, 23/10/2026)
+    if (spec?.purpose !== "consulta") {
+      const listy = body.filter((s) => LISTY.has(s.layout)).length;
+      if (listy / n > 0.45) problems.push(`${listy} de ${n} slides são listas/cartões — falta respiro (manchete, número grande, imagem, pergunta)`);
+      if (!body.some((s) => IMPACT.has(s.layout))) problems.push("nenhum slide de impacto (manchete, número grande, frase, página inteira, pergunta)");
+      // consulta pode ficar toda clara (imprime e lê bem); a regra do tom é de palco
+      if (new Set(slides.map((s) => s.tone)).size === 1) problems.push(`todos os slides no mesmo tom (${slides[0].tone}) — alterne com escuro/destaque nos momentos-chave`);
+    }
   }
   const counts = {};
   body.forEach((s) => (counts[s.layout] = (counts[s.layout] || 0) + 1));

package/src/elements.js

@@ -9,7 +9,7 @@ import katex from "katex";
 import { formatNumber, decimalSeparator } from "./locale.js";
 import fs from "node:fs";
 import path from "node:path";
-import { md, esc, plain } from "./markup.js";
+import { md, esc, plain, noHyphenBreak } from "./markup.js";
 import { iconSVG } from "./figures/icons.js";
 import { picto } from "./figures/pictos.js";
 import { diagram } from "./figures/diagrams.js";
@@ -551,7 +551,7 @@ export function stats(e, ctx) {
         ${iconHtml}
         ${trendHtml}
       </div>
-      <div class="st-val t f-display" style="${valColor}">${md(String(st.value ?? st.stat ?? ""))}</div>
+      <div class="st-val t f-display" style="${valColor}">${md(`${st.prefix ?? ""}${st.value ?? st.stat ?? ""}${st.suffix ?? ""}`)}</div>
       ${st.label ? `<div class="st-lab t f-heading">${md(st.label)}</div>` : ""}
       ${st.text ? `<div class="st-sub t f-body">${md(st.text)}</div>` : ""}
     </div>`;
@@ -619,7 +619,7 @@ export function code(e) {
   const language = resolveCodeLanguage(e.language, e.filename);
   const lines = language ? highlightCode(source, language) : source.split("\n").map(esc);
   const hl = new Set([].concat(e.highlight || []));
-  const body = lines.map((l, i) => `<div class="cl${hl.has(i + 1) ? " hl" : ""}"><span class="cn">${i + 1}</span><span class="cc">${l || " "}</span></div>`).join("");
+  const body = lines.map((l, i) => `<div class="cl${hl.has(i + 1) ? " hl" : ""}"><span class="cn">${i + 1}</span><span class="cc">${noHyphenBreak(l) || " "}</span></div>`).join("");
   return `<div${attrs(e, "code f-mono", `font-size:${e.size || 34}px;`)}${language ? ` data-language="${esc(language)}"` : ""}>${body}</div>`;
 }
 

package/src/figures/charts.js

@@ -21,6 +21,10 @@ const cvar = (c, d) => {
   if (/^#?[0-9a-f]{6}$/i.test(c)) return `#${String(c).replace("#", "")}`;
   // paleta do tema é namespaced (--c-c1…): nome pelado ("c3") viraria var indefinida = preto
   if (/^c[1-9]\d*$/.test(c) || /^(accent|alert|ink|paper)$/.test(c)) return `var(--c-${c})`;
+  // "hi" é a cor do marca-texto, clara nos temas de papel: a barra em destaque saía rosa-claro, quase sumindo, e as
+  // de fundo (muted) mais fortes que ela. Como no texto (elements.js: textColorVal), a marca usa a versão com
+  // contraste (--hi-ink: o hi se ele aparece no fundo, senão a ênfase). Rodada de uso real, 23/10/2026.
+  if (c === "hi") return "var(--hi-ink,var(--hi))";
   return `var(--${c})`;
 };
 const fmt = (v, o) => {

package/src/markup.js

@@ -16,6 +16,12 @@ export function esc(s) {
     .replace(/"/g, """);
 }
 
+// Código que quebra linha (pre-wrap): o navegador quebra depois do hífen, e "git commit --amend --no-edit" saía como
+// "--no-" / "edit" (quem copia do slide digita errado). Cada hífen vira <span class="hy">, e o CSS põe um "word joiner"
+// (U+2060) depois dele por ::after: a linha não quebra ali, e o texto copiado continua o mesmo (o ::after não é copiado).
+// Recebe HTML já escapado ou realçado: só troca o hífen fora das tags.
+export const noHyphenBreak = (html) => String(html).replace(/(<[^>]*>)|-/g, (m, tag) => tag || '<span class="hy">-</span>');
+
 // tabela em markdown no meio do texto (uma linha "| a | b |" por linha, com ou sem a linha "|---|---|" depois do
 // cabeçalho): vira tabela de verdade (src/table.js), não texto com barras
 const PIPE_TABLE = /(^|\n)((?:[ \t]*\|[^\n]*\|[ \t]*(?:\n|$)){2,})/g;

package/src/runtime/base.css

@@ -333,6 +333,8 @@ html[data-motion="none"] .flip-in,.export .flip-in{transition:none}
 .cl.hl{background:color-mix(in srgb,var(--c-accent) 26%,transparent);box-shadow:inset 8px 0 0 var(--c-accent)}
 .cn{width:2.2em;color:#777;flex:none}
 .cc{white-space:pre}
+/* hífen do código sem quebra de linha depois dele (markup.js: noHyphenBreak); o ::after não vai na cópia */
+.hy::after{content:"\2060"}
 .code.code-wrap .cl{min-width:0!important}.code.code-wrap .cc{white-space:pre-wrap;overflow-wrap:anywhere;flex:1;min-width:0}.code.code-scroll{overflow:auto;scrollbar-width:thin}
 .tok-keyword{color:#c792ea}
 .tok-string{color:#c3e88d}

package/src/studio/public/slide-form.js

@@ -70,7 +70,7 @@
       { addLabel: "Adicionar turno", newItem: () => ({ who: 1, commit: "" }) })];
   const CARD = [f.icon("icon", "Ícone"), f.text("title", "Título"), f.area("text", "Texto"), f.area("flip", "Verso (o cartão vira no clique)"),
     f.more([f.text("number", "Número"), f.text("foot", "Rodapé"), f.text("badge", "Selo"), f.bool("hl", "Destacar"), f.num("step", "Aparece no clique"), f.text("goto", "Ao clicar, ir para", { hint: "Id do slide de destino (ou o número dele): navegação por caminhos." })])];
-  const STAT = [f.text("value", "Valor"), f.text("label", "Rótulo"), f.text("trend", "Tendência"), f.icon("icon", "Ícone"),
+  const STAT = [f.text("value", "Valor"), f.text("prefix", "Antes do valor", { hint: "Ex.: R$ " }), f.text("suffix", "Depois do valor", { hint: "Ex.: %, h, mil" }), f.text("label", "Rótulo"), f.text("trend", "Tendência"), f.icon("icon", "Ícone"),
     f.more([f.bool("trendUp", "Tendência positiva"), f.color("color", "Cor")])];
   const STEP = [f.text("title", "Título"), f.area("text", "Texto"), f.icon("icon", "Ícone"), f.more([f.text("tag", "Etiqueta"), f.text("goto", "Ao clicar, ir para", { hint: "Id do slide de destino (ou o número dele): navegação por caminhos." })])];
   // bloco do one-page (problema, solução): texto, números grandes e tópicos