sagadeck 1.2.0

package/src/mcp/server.js

@@ -0,0 +1,371 @@
+// sagadeck · Servidor MCP (Model Context Protocol) para IDEs Agênticos
+// Permite que Cursor, Claude Code, Windsurf, Cline, Roo Code etc. descubram e invoquem
+// ferramentas do sagadeck via protocolo JSON-RPC 2.0 padrão sobre stdio.
+
+import readline from "node:readline";
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { loadSpec, buildHTML, buildFile } from "../build.js";
+import { autofixDeck } from "../fiscal/autofix.js";
+import { THEMES } from "../themes.js";
+import { LAYOUTS } from "../layouts.js";
+import { createStudioServer } from "../studio/server.js";
+import { newDeckPath } from "../library.js";
+import { writeDeckFile } from "../deck-file.js";
+
+const TOOLS = [
+  {
+    name: "sagadeck_read_deck",
+    description: "Lê e analisa a estrutura de um arquivo de apresentação Sagadeck (.yaml), retornando título, tema, slides e notas.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Caminho do arquivo .yaml da apresentação" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "sagadeck_inspect_deck",
+    description: "Fiscal de layout: inspeciona o deck procurando sobreposição de elementos, transgressão de margens seguras (120px), texto estourado e excesso de palavras (anti-sono).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Caminho do arquivo .yaml a ser fiscalizado" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "sagadeck_autofix_deck",
+    description: "Auto-cura do Sagadeck: analisa a geometria dos slides e repara automaticamente sobreposições, quebras de margem e excessos de texto no arquivo YAML.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Caminho do arquivo .yaml" },
+        out: { type: "string", description: "Caminho de saída opcional (sobrescreve se omitido)" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "sagadeck_build_html",
+    description: "Compila o arquivo .yaml em uma apresentação .html standalone interativa, com suporte a modo apresentador (P), animações e offline.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Caminho do arquivo .yaml" },
+        out: { type: "string", description: "Caminho de saída do .html (opcional)" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "sagadeck_text_to_visual",
+    description: "Transforma texto bruto, notas de reunião ou tópicos em um diagrama visual inteligente (estilo Napkin AI: steps, stats, compare, cards, statement). Detecta o padrão semântico ideal sem alucinação.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        text: { type: "string", description: "Texto bruto, lista de tópicos ou notas a converter em diagrama" },
+        title: { type: "string", description: "Título opcional para o slide" },
+        kicker: { type: "string", description: "Kicker/chapeuzinho opcional (ex: PROCESSO, MÉTRICAS)" },
+        theme: { type: "string", description: "Tema do deck se for gerar apresentação completa" },
+        tone: { type: "string", enum: ["dark", "light", "accent"], description: "Tom visual do slide" },
+      },
+      required: ["text"],
+    },
+  },
+  {
+    name: "sagadeck_scaffold_deck",
+    description: "Gera um esqueleto narrativo pronto de alta qualidade (cover -> statement -> stats -> steps -> cards -> end) para preenchimento direto. Economiza até 80% dos tokens de saída da IA.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME/~/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
+        title: { type: "string", description: "Título provisório da apresentação" },
+        theme: {
+          type: "string",
+          enum: ["prata", "rabisco", "oceano", "pop", "aurora", "sinal", "editorial", "noite"],
+          description: "Tema visual (padrão: prata)",
+        },
+        type: {
+          type: "string",
+          enum: ["keynote", "pitch", "palestra"],
+          description: "Tipo narrativo do esqueleto (padrão: keynote)",
+        },
+        author: { type: "string", description: "Nome do autor ou palestrante" },
+      },
+      required: ["path"],
+    },
+  },
+  {
+    name: "sagadeck_create_deck",
+    description: "Cria uma nova apresentação Sagadeck com tema e estrutura inicial.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME/~/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
+        title: { type: "string", description: "Título da apresentação" },
+        theme: {
+          type: "string",
+          enum: ["sinal", "prata", "rabisco", "oceano", "pop", "aurora", "editorial", "noite", "bauhaus", "terminal", "jornal"],
+          description: "Tema visual do Sagadeck (ex.: prata para Apple Keynote, rabisco para artesanal, oceano para azul elétrico)",
+        },
+        author: { type: "string", description: "Nome do autor ou palestrante" },
+      },
+      required: ["path", "title"],
+    },
+  },
+  {
+    name: "sagadeck_web_search",
+    description: "Pesquisa na web via DuckDuckGo (sem bloqueio de CAPTCHA/Google bot) para enriquecer o conteúdo dos slides com dados reais, estatísticas e fontes confiáveis.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Termo de busca na web" },
+        limit: { type: "number", description: "Número de resultados desejados (padrão: 5)" },
+      },
+      required: ["query"],
+    },
+  },
+  {
+    name: "sagadeck_launch_studio",
+    description: "Inicia o SagaDeck Studio (página web estilo PowerPoint com canvas visual, edição WYSIWYG e chat lateral com IA).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "Caminho do arquivo .yaml a carregar no Studio" },
+        port: { type: "number", description: "Porta HTTP (padrão: 3000)" },
+      },
+    },
+  },
+];
+
+export { TOOLS, handleToolCall };
+export function runMCPServer() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: false,
+  });
+
+  const send = (obj) => {
+    process.stdout.write(JSON.stringify(obj) + "\n");
+  };
+
+  rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+
+    let req;
+    try {
+      req = JSON.parse(trimmed);
+    } catch {
+      return;
+    }
+
+    const { id, method, params } = req;
+
+    if (method === "initialize") {
+      send({
+        jsonrpc: "2.0",
+        id,
+        result: {
+          protocolVersion: "2024-11-05",
+          serverInfo: { name: "sagadeck-mcp", version: "1.1.0" },
+          capabilities: { tools: {} },
+        },
+      });
+      return;
+    }
+
+    if (method === "tools/list") {
+      send({
+        jsonrpc: "2.0",
+        id,
+        result: { tools: TOOLS },
+      });
+      return;
+    }
+
+    if (method === "tools/call") {
+      const toolName = params?.name;
+      const args = params?.arguments || {};
+
+      try {
+        const result = await handleToolCall(toolName, args);
+        send({
+          jsonrpc: "2.0",
+          id,
+          result: {
+            content: [{ type: "text", text: typeof result === "string" ? result : JSON.stringify(result, null, 2) }],
+          },
+        });
+      } catch (err) {
+        send({
+          jsonrpc: "2.0",
+          id,
+          error: { code: -32000, message: err.message },
+        });
+      }
+      return;
+    }
+
+    // Ping / notifications
+    if (method === "ping") {
+      send({ jsonrpc: "2.0", id, result: {} });
+    }
+  });
+}
+
+async function handleToolCall(name, args) {
+  switch (name) {
+    case "sagadeck_read_deck": {
+      const spec = loadSpec(path.resolve(args.path));
+      return {
+        title: spec.title,
+        theme: spec.theme,
+        duration: spec.duration,
+        slidesCount: spec.slides?.length || 0,
+        slides: spec.slides,
+      };
+    }
+
+    case "sagadeck_inspect_deck": {
+      const spec = loadSpec(path.resolve(args.path));
+      const res = buildHTML(spec);
+      const warnings = res.warnings || [];
+      const issues = [];
+      // Anti-sleep & boundary checks
+      spec.slides.forEach((s, idx) => {
+        const words = (JSON.stringify(s).match(/\b\w+\b/g) || []).length;
+        if (words > 40) {
+          issues.push({ slide: idx + 1, kind: "anti-sono", detail: `${words} palavras (limite 40)` });
+        }
+        if (s.title && s.title.length > 55 && !s.titleSize) {
+          issues.push({ slide: idx + 1, kind: "titulo-longo", detail: "Título longo sem titleSize explícito (risco de sobreposição)" });
+        }
+      });
+      return {
+        clean: warnings.length === 0 && issues.length === 0,
+        warnings,
+        issues,
+      };
+    }
+
+    case "sagadeck_autofix_deck": {
+      const targetPath = path.resolve(args.path);
+      const spec = loadSpec(targetPath);
+      const fixResult = autofixDeck(spec);
+      const outPath = args.out ? path.resolve(args.out) : targetPath;
+      writeDeckFile(outPath, fixResult.spec);
+      return {
+        ok: true,
+        savedTo: outPath,
+        modifiedSlidesCount: fixResult.modifiedSlidesCount,
+        actions: fixResult.actions,
+      };
+    }
+
+    case "sagadeck_build_html": {
+      const targetPath = path.resolve(args.path);
+      const outPath = args.out ? path.resolve(args.out) : targetPath.replace(/\.ya?ml$/i, ".html");
+      const res = buildFile(targetPath, outPath);
+      return {
+        ok: true,
+        htmlPath: outPath,
+        slidesCount: res.meta.slides.length,
+        theme: res.theme.name,
+      };
+    }
+
+    case "sagadeck_text_to_visual": {
+      const { textToVisualSlide } = await import("../diagram/napkin.js");
+      const YAML = (await import("yaml")).default;
+      const res = textToVisualSlide(args.text, {
+        title: args.title,
+        kicker: args.kicker,
+        theme: args.theme,
+        tone: args.tone,
+      });
+      return {
+        ok: true,
+        detectedType: res.detectedType,
+        confidence: res.confidence,
+        rationale: res.rationale,
+        slide: res.slide,
+        slideYaml: YAML.stringify(res.slide, { indent: 2 }),
+      };
+    }
+
+    case "sagadeck_scaffold_deck": {
+      // sempre na biblioteca, sem sobrescrever (ver newDeckPath)
+      const targetPath = newDeckPath(args.path, { title: args.title, unique: true });
+      const { generateScaffold } = await import("../templates/scaffold.js");
+      const YAML = (await import("yaml")).default;
+      const spec = generateScaffold({
+        title: args.title || "Nova Apresentação",
+        theme: args.theme || "prata",
+        type: args.type || "keynote",
+        author: args.author || "Seu Nome",
+      });
+      fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+      fs.writeFileSync(targetPath, YAML.stringify(spec, { indent: 2 }), "utf8");
+      return {
+        ok: true,
+        path: targetPath,
+        theme: spec.theme,
+        slidesCount: spec.slides.length,
+        message: `Esqueleto narrativo gerado com sucesso (${spec.slides.length} slides). Economiza 80% dos tokens da IA.`,
+      };
+    }
+
+    case "sagadeck_create_deck": {
+      const targetPath = newDeckPath(args.path, { title: args.title, unique: true });
+      const content = {
+        title: args.title || "Nova Apresentação",
+        theme: args.theme || "sinal",
+        author: args.author || "Autor",
+        duration: 15,
+        slides: [
+          {
+            layout: "cover",
+            title: args.title || "Nova Apresentação",
+            subtitle: "Apresentação estruturada com Sagadeck",
+            author: args.author || "Autor",
+          },
+          {
+            layout: "statement",
+            kicker: "Ponto Principal",
+            text: "Uma mensagem clara e memorável por slide.",
+            tone: "accent",
+          },
+        ],
+      };
+      fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+      fs.writeFileSync(targetPath, YAML.stringify(content, { indent: 2 }), "utf8");
+      return { ok: true, created: targetPath };
+    }
+
+    case "sagadeck_launch_studio": {
+      const port = args.port || 3000;
+      const server = createStudioServer(args.path, { port });
+      server.listen(port, "0.0.0.0");
+      return { ok: true, url: `http://localhost:${port}`, message: "Studio ativo" };
+    }
+
+    case "sagadeck_web_search": {
+      const { searchDuckDuckGo } = await import("../research/duckduckgo.js");
+      const results = await searchDuckDuckGo(args.query, { limit: args.limit || 5 });
+      return {
+        query: args.query,
+        count: results.length,
+        results,
+      };
+    }
+
+    default:
+      throw new Error(`Ferramenta desconhecida: ${name}`);
+  }
+}

package/src/meeting.js

@@ -0,0 +1,42 @@
+import {esc} from './markup.js';
+
+export function meetingSpec(raw, audience = raw?.audience || 'organization') {
+ if(!Array.isArray(raw?.slides))return raw;
+ if(audience!=='participants'&&!raw.slides.some(s=>(s.layout==='poll'&&s.manual)||s.audience==='organization'))return raw;
+ const spec=structuredClone(raw),decisions=spec.slides.filter(s=>s.layout==='poll'&&s.manual&&s.decision?.approved),approved=new Map(decisions.map(s=>[s.id,s.options?.[s.decision.selected]])),numbers=new Map(decisions.map(s=>[s.id,s.values?.[s.decision.selected]]));
+ for(const s of spec.slides)for(const input of Object.values(s.inputs||{}))if(input&&typeof input==='object'&&Number.isFinite(numbers.get(input.decision)))input.value=numbers.get(input.decision);
+ const known=new Set(spec.slides.filter(s=>s.layout==='poll'&&s.manual).map(s=>s.id));
+ const replace=v=>typeof v==='string'?v.replace(/\{\{decision:([^}]+)\}\}/g,(literal,id)=>known.has(id)?approved.get(id)||'Em definição':literal):Array.isArray(v)?v.map(replace):v&&typeof v==='object'?Object.fromEntries(Object.entries(v).map(([k,x])=>[k,replace(x)])):v;
+ spec.slides=spec.slides.flatMap(s=>{
+  if(audience!=='participants')return [s];
+  if(s.audience==='organization')return [];
+  if(s.layout==='poll'&&s.manual){if(!s.decision?.approved)return [];return [{layout:'statement',id:s.id,title:s.participantTitle||s.question,text:s.options[s.decision.selected],kicker:'REGRA APROVADA',tone:s.tone,notes:s.participantNotes||''}];}
+  return [{...s,notes:s.participantNotes||''}];
+ }).map(replace);spec.audience=audience;return spec;
+}
+
+export function manualPollHTML(s,head){
+ if(!s.id||!s.options?.length)throw new Error('Votação manual precisa de id e opções.');
+ const d=s.decision||{},votes=s.options.map((_,i)=>Number(d.votes?.[i])||0);
+ return `<div class="L-meeting f-body" data-meeting="${esc(s.id)}">${head({...s,title:s.question||s.title})}<p class="meeting-context">${esc(s.context||'Registre os votos da reunião. A maioria apurada é uma proposta até a aprovação explícita.')}</p><div class="meeting-options">${s.options.map((label,i)=>`<label class="meeting-option"><span>${esc(label)}</span><input aria-label="Votos: ${esc(label)}" type="number" min="0" max="100000" step="1" data-vote="${i}" value="${votes[i]}"><span class="meeting-bar"><i></i></span></label>`).join('')}</div><div class="meeting-actions"><label>Abstenções <input type="number" min="0" max="100000" step="1" data-abstain value="${Number(d.abstentions)||0}"></label><button data-meeting-approve>Aprovar resultado</button><button data-meeting-reopen>Reabrir decisão</button><output aria-live="polite" data-meeting-status></output></div><script type="application/json" class="meeting-state">${JSON.stringify(d).replace(/</g,'\\u003c')}</script></div>`;
+}
+
+export function meetingPreview(html,spec,audience){
+ const link=spec.slides.some(s=>s.manual)&&audience!=='participants'?'<details style="position:fixed;right:20px;top:10px;z-index:9999;background:#182234;color:white;padding:10px 16px;border-radius:10px;font:14px system-ui"><summary style="cursor:pointer">Versão para participantes</summary><nav style="display:grid;gap:12px;padding-top:14px"><a style="color:white" href="/preview?audience=participants" data-participant-preview>Ver prévia</a><a style="color:white" href="/api/export/html?audience=participants">Baixar HTML interativo</a><a style="color:white" href="/api/export/pdf?audience=participants">Baixar PDF</a><a style="color:white" href="/api/export/pptx?audience=participants">Baixar PowerPoint</a></nav></details>':'';
+ return html.replace('</body>',link+'</body>');
+}
+
+export async function meetingRoutes({req,res,pathname,W,readJSON,persist}){
+ if(pathname!=='/api/meeting')return false;
+ const send=(status,data)=>{res.writeHead(status,{'Content-Type':'application/json'});res.end(JSON.stringify(data));};
+ if(req.method!=='POST'){send(405,{error:'Use POST.'});return true;}
+ const b=await readJSON(req),s=W.spec?.slides.find(s=>s.layout==='poll'&&s.manual&&s.id===b.id);
+ if(!W.file){send(409,{error:'Salve uma cópia na biblioteca antes de registrar decisões.'});return true;}
+ if(!s){send(404,{error:'Votação não encontrada.'});return true;}
+ const valid=n=>Number.isSafeInteger(n)&&n>=0&&n<=100000;
+ if(!Array.isArray(b.votes)||b.votes.length!==s.options.length||!b.votes.every(valid)||!valid(b.abstentions)){send(400,{error:'Informe contagens inteiras entre zero e 100000.'});return true;}
+ const max=Math.max(...b.votes),winners=b.votes.flatMap((v,i)=>v===max?[i]:[]);
+ if(b.approved&&(max===0||winners.length!==1)){send(400,{error:'Sem votos ou empate: a decisão permanece aberta.'});return true;}
+ const before=s.decision;s.decision={votes:b.votes,abstentions:b.abstentions,approved:!!b.approved,selected:b.approved?winners[0]:null};
+ try{persist(W);send(200,{ok:true,decision:s.decision,...(s.decision.approved&&Number.isFinite(s.values?.[s.decision.selected])?{value:s.values[s.decision.selected]}:{})});}catch(e){s.decision=before;send(500,{error:e.message});}return true;
+}

package/src/motion.js

@@ -0,0 +1,56 @@
+import {esc} from './markup.js';
+import {playgroundDocument} from './playground.js';
+import {drawHologram} from './hologram.js';
+const number=(x,f,min,max)=>Math.min(max,Math.max(min,Number.isFinite(Number(x))?Number(x):f));
+const color=(x,f)=>/^#?[0-9a-f]{6}$/i.test(x||'')?'#'+String(x).replace('#',''):f;
+export function motionOptions(value,colors={}){
+ const o=typeof value==='string'?{type:value}:value||{};
+ if(!['wireframe','hologram','trace','requests','flow','chat','terminal'].includes(o.type))throw new Error('motion.type: wireframe, hologram, trace, requests, flow, chat ou terminal.');
+ const aliases={fg:'ink',bg:'paper',hi:'accent',em:'alert'};
+ const resolved=(v,f)=>color(colors[aliases[v]||v]||v,f);
+ const trace=(Array.isArray(o.path)&&o.path.length>=2?o.path:[[.05,.5],[.95,.5]]).slice(0,64).map(p=>[number(Array.isArray(p)?p[0]:p?.x,0,0,1),number(Array.isArray(p)?p[1]:p?.y,0,0,1)]);
+ const transparent=o.background==='transparent';
+ const layers=(Array.isArray(o.layers)&&o.layers.length?o.layers:[{shape:o.shape,x:.5,y:.5,scale:.24}]).slice(0,6).map(l=>({shape:['sphere','cube','plane','ring'].includes(l.shape)?l.shape:'sphere',x:number(l.x,.5,-.5,1.5),y:number(l.y,.5,-.5,1.5),scale:number(l.scale,.24,.03,1),speed:number(l.speed,1,.1,4),rotation:number(l.rotation,0,-10,10)}));
+ return {type:o.type,path:trace,closed:o.closed===true,pulses:Math.round(number(o.pulses,2,1,8)),lineWidth:number(o.lineWidth,1.2,.5,6),layers,opacity:number(o.opacity,.7,.05,1),lines:Array.isArray(o.lines)?o.lines.map(String):String(o.code||'').split('\n'),fontSize:number(o.fontSize,16,10,40),shape:o.shape==='cube'?'cube':'sphere',speed:number(o.speed,1,.1,8),recognition:number(o.recognition,1,0,10),thinking:number(o.thinking,.8,0,10),read:number(o.read,2,0,15),typing:number(o.typing,.035,.01,.2),caption:String(o.caption||''),user:String(o.user||''),assistant:String(o.assistant||''),background:transparent?'transparent':resolved(o.background,'#111e30'),foreground:resolved(o.foreground,transparent?color(colors.ink,'#182642'):'#b5c9db'),accent:resolved(o.accent,color(colors.alert,'#cc092f')),secondary:resolved(o.secondary,transparent?color(colors.accent,'#3769e8'):'#aa9ccf'),manual:o.start!=='auto',finish:['next','video','hold'].includes(o.finish)?o.finish:'hold'};
+}
+function drawTrace(ctx,o,t,w,h){
+ const points=o.path.map(p=>[p[0]*w,p[1]*h]);if(o.closed)points.push(points[0]);
+ const lengths=points.slice(1).map((p,i)=>Math.hypot(p[0]-points[i][0],p[1]-points[i][1])),total=lengths.reduce((a,b)=>a+b,0);if(!total)return;
+ const at=distance=>{let d=((distance%total)+total)%total;for(let i=0;i<lengths.length;i++){if(d<=lengths[i]&&lengths[i]){const f=d/lengths[i];return[points[i][0]+(points[i+1][0]-points[i][0])*f,points[i][1]+(points[i+1][1]-points[i][1])*f];}d-=lengths[i];}return points[0];};
+ ctx.save();ctx.lineWidth=o.lineWidth;ctx.globalAlpha=o.opacity*.22;ctx.strokeStyle=o.foreground;ctx.beginPath();points.forEach((p,i)=>i?ctx.lineTo(...p):ctx.moveTo(...p));ctx.stroke();
+ for(let k=0;k<o.pulses;k++){const head=(t*.1+k/o.pulses)*total;for(let j=12;j>=0;j--){const p=at(head-j*Math.min(4,total/150));ctx.globalAlpha=o.opacity*(1-j/13);ctx.fillStyle=o.accent;ctx.beginPath();ctx.arc(...p,j===0?2.4:1.2,0,Math.PI*2);ctx.fill();}}
+ ctx.restore();
+}
+function scene(o){
+ let active=o.type!=='chat',started=false,epoch=performance.now(),serial=0,phase='idle',elapsed=0,previous=0;let reduced=matchMedia('(prefers-reduced-motion:reduce)').matches;const main=document.querySelector('main'),canvas=document.querySelector('canvas'),ctx=canvas.getContext('2d');
+ const message=(kind)=>parent.postMessage({sagaMotion:kind},'*');
+ const chat=document.querySelector('.chat'),input=document.querySelector('.input'),thread=document.querySelector('.thread'),status=document.querySelector('.status');
+ function reset(){started=false;phase='idle';elapsed=0;chat.hidden=true;input.textContent='';thread.replaceChildren();status.textContent='';}
+ window.addEventListener('message',e=>{if(e.source!==parent)return;if(e.data?.sagaMotion==='poster'){reduced=true;if(o.type==='terminal')document.querySelector('.feed').textContent=o.lines.join('\n');}if(e.data?.sagaMotion==='active')active=!!e.data.active;if(e.data?.sagaMotion==='reset')reset();if(e.data?.sagaMotion==='start'){reset();started=true;active=true;phase='recognize';chat.hidden=false;}});
+ if(o.type==='chat'&&o.manual){const request=e=>{if(!active)return;if(e.type==='keydown'&&![' ','Enter','ArrowRight','PageDown'].includes(e.key))return;e.preventDefault();message('start-request');};document.addEventListener('click',request);document.addEventListener('keydown',request);}
+ if(o.type==='chat'&&!o.manual){started=true;phase='recognize';chat.hidden=false;}
+ function bubble(text,kind){const el=document.createElement('div');el.className='bubble '+kind;el.textContent=text;thread.append(el);return el;}
+ let terminalElapsed=0;const terminalText=o.lines.join('\n');
+ let bot;
+ function tickChat(dt){if(!started||phase==='done')return;elapsed+=dt;
+ if(phase==='recognize'&&elapsed>=o.recognition){phase='input';elapsed=0;}
+ if(phase==='input'){input.textContent=o.user.slice(0,Math.floor(elapsed/o.typing));if(elapsed>=o.user.length*o.typing+.35){bubble(o.user,'user');input.textContent='';status.textContent='Pensando…';phase='thinking';elapsed=0;}}
+ else if(phase==='thinking'&&elapsed>=o.thinking){status.textContent='';bot=bubble('','assistant');phase='answer';elapsed=0;}
+ else if(phase==='answer'){bot.textContent=o.assistant.slice(0,Math.floor(elapsed/o.typing));if(elapsed>=o.assistant.length*o.typing){phase='read';elapsed=0;}}
+ else if(phase==='read'&&elapsed>=o.read){phase='done';message('done');}}
+ function requestLine(){serial++;const ops=['GET /silent-cloud','POST /paper-moon','PUT /silver-orbit','PATCH /soft-vector','GET /tiny-comet','DELETE /ghost-frame'];const el=document.createElement('div');el.textContent=String(serial).padStart(6,'0')+' '+ops[(serial*7+Math.floor(serial/9))%ops.length].padEnd(23,' ')+' '+(serial*2654435761>>>0).toString(16)+' '+(17+serial*37%981)+'ms 200 OK';document.querySelector('.feed').append(el);while(document.querySelector('.feed').children.length>14)document.querySelector('.feed').firstChild.remove();document.querySelector('.feed').scrollTop=1e6;}
+ if(o.type==='requests'){for(let i=0;i<8;i++)requestLine();setInterval(()=>{if(active&&!document.hidden&&!reduced){requestLine();requestLine();}},Math.max(35,240/o.speed));}
+ function draw(ts){requestAnimationFrame(draw);if(!active||document.hidden){previous=ts;return;}const dt=Math.min(.1,(ts-(previous||ts))/1000);previous=ts;if(o.type==='chat'){tickChat(dt);return;}if(o.type==='terminal'){terminalElapsed+=dt*o.speed;const count=reduced?terminalText.length:Math.floor(terminalElapsed/o.typing);document.querySelector('.feed').textContent=terminalText.slice(0,count)+(count<terminalText.length?'_':'');document.querySelector('.feed').scrollTop=1e6;if(count>terminalText.length+3/o.typing)terminalElapsed=0;return;}if(o.type==='requests'||(reduced&&serial))return;serial++;
+ const w=main.clientWidth,h=main.clientHeight,dpr=devicePixelRatio||1;if(canvas.width!==Math.round(w*dpr)||canvas.height!==Math.round(h*dpr)){canvas.width=Math.round(w*dpr);canvas.height=Math.round(h*dpr);}ctx.setTransform(dpr,0,0,dpr,0,0);ctx.clearRect(0,0,w,h);const t=reduced?0:(ts-epoch)/1000*o.speed,r=Math.min(w*.25,h*.32),cy=h*.55;if(o.type==='hologram'){drawHologram(ctx,o,t,w,h);return;}if(o.type==='trace'){drawTrace(ctx,o,t,w,h);return;}
+ function p(x,y,z){let a=t*.15+.4,xx=x*Math.cos(a)+z*Math.sin(a),zz=-x*Math.sin(a)+z*Math.cos(a),yy=y*Math.cos(.3)-zz*Math.sin(.3);const f=4/(4+zz);return[w/2+xx*r*f,cy+yy*r*f];}
+ function line(v,c){ctx.beginPath();v.forEach((q,i)=>{let a=p(...q);i?ctx.lineTo(...a):ctx.moveTo(...a);});ctx.strokeStyle=c;ctx.lineWidth=.9;ctx.stroke();}
+ if(o.type==='flow'){let y=h*.55,x1=w*.12,x2=w*.5,x3=w*.88;ctx.strokeStyle=o.foreground;ctx.lineWidth=1.2;ctx.beginPath();ctx.moveTo(x1,y-18);ctx.bezierCurveTo(w*.35,y-18,w*.35,y,x2,y);ctx.lineTo(x3,y);ctx.moveTo(x1,y+18);ctx.bezierCurveTo(w*.35,y+18,w*.35,y,x2,y);ctx.stroke();for(const [x,yy]of[[x1,y-18],[x1,y+18],[x2,y],[x3,y]]){ctx.fillStyle=x===x3?o.accent:o.background;ctx.fillRect(x-7,yy-7,14,14);ctx.strokeRect(x-7,yy-7,14,14);}for(let j=0;j<2;j++){let n=(t*.15+j*.5)%1;ctx.fillStyle=o.secondary;ctx.beginPath();ctx.arc(x1+n*(x3-x1),y+(j?-18:18)*Math.max(0,1-n*3),2.5,0,Math.PI*2);ctx.fill();}return;}
+ if(o.shape==='cube'){const v=[[-1,-1,-1],[1,-1,-1],[1,1,-1],[-1,1,-1],[-1,-1,1],[1,-1,1],[1,1,1],[-1,1,1]];for(const [a,b]of[[0,1],[1,2],[2,3],[3,0],[4,5],[5,6],[6,7],[7,4],[0,4],[1,5],[2,6],[3,7]])line([v[a],v[b]],o.foreground);}
+ else{for(let j=-3;j<=3;j++){let v=[],phi=j*Math.PI/9;for(let n=0;n<=60;n++){let a=n*Math.PI/30;v.push([Math.cos(phi)*Math.cos(a),Math.sin(phi),Math.cos(phi)*Math.sin(a)]);}line(v,o.foreground);}for(let j=0;j<10;j++){let v=[],a=j*Math.PI/5;for(let n=0;n<=60;n++){let phi=-Math.PI/2+n*Math.PI/60;v.push([Math.cos(phi)*Math.cos(a),Math.sin(phi),Math.cos(phi)*Math.sin(a)]);}line(v,o.foreground);}}
+ let v=[];for(let n=0;n<=80;n++){let a=n*Math.PI/40;v.push([1.4*Math.cos(a),.3*Math.sin(a),.8*Math.sin(a)]);}line(v,o.secondary);const q=p(Math.cos(t*.15),0,Math.sin(t*.15));ctx.fillStyle=o.accent;ctx.fillRect(q[0]-2,q[1]-2,4,4);
+ }
+ requestAnimationFrame(draw);
+}
+export function motionHTML(value,colors){const o=motionOptions(value,colors);const css=`html,body{height:100%;background:${o.type==='chat'?'transparent':o.background};color:${o.foreground};overflow:hidden}main{height:100%;position:relative}canvas{position:absolute;inset:0;width:100%;height:100%}.caption{position:absolute;top:12px;left:16px;color:${o.secondary};font:11px monospace;letter-spacing:1.5px}.feed{position:absolute;top:36px;left:16px;right:16px;bottom:12px;overflow:hidden;font:${o.type==='terminal'?o.fontSize:12}px/1.5 monospace;white-space:pre}.chat{position:absolute;inset:0;border:1px solid ${o.secondary};border-radius:16px;padding:18px;background:${o.background};display:flex;flex-direction:column;gap:12px}.chat[hidden]{display:none}.thread{flex:1;overflow:auto;display:flex;flex-direction:column;gap:12px}.bubble{font:18px/1.45 system-ui;max-width:90%;padding:10px 14px;border-radius:10px;white-space:pre-wrap}.user{align-self:flex-end;background:#263a51}.assistant{align-self:flex-start}.status{font:14px system-ui;color:${o.secondary};min-height:18px}.input{border:1px solid #51617b;border-radius:9px;min-height:48px;padding:12px;font:17px system-ui;white-space:pre-wrap}.chat-title{font:12px system-ui;letter-spacing:2px;color:${o.secondary}}`;
+ const html=`<main><canvas aria-hidden="true"></canvas><div class="caption">${esc(o.type==='chat'?'':o.caption)}</div><div class="feed" aria-hidden="true"></div><section class="chat" hidden><div class="chat-title">${esc(o.caption||'ASSISTENTE')}</div><div class="thread" aria-live="polite"></div><div class="status"></div><div class="input" aria-label="Mensagem digitada"></div></section></main>`;
+ const doc=playgroundDocument({html,css,javascript:`${drawHologram.toString()}\n${drawTrace.toString()}\n(${scene.toString()})(${JSON.stringify(o)});`});return `<iframe data-motion="${o.type}" data-motion-manual="${o.manual}" data-motion-finish="${o.finish}" title="${esc(o.caption||'Detalhe animado')}" sandbox="allow-scripts" style="width:100%;height:100%;border:0" srcdoc="${esc(doc)}"></iframe>`;}

package/src/package.js

@@ -0,0 +1,116 @@
+// Formato .sagadeck: a apresentação inteira num arquivo só — o YAML + todos os arquivos locais que ele
+// usa (imagens, CSS, widgets). Por dentro é um .zip (como .pptx e .docx):
+//
+//   sagadeck.json        manifesto: { format: "sagadeck", version, main, title, created, generator }
+//   <nome>.yaml          a apresentação (sem campos internos da máquina de quem salvou)
+//   imagens/, widgets/…  os arquivos, nos mesmos caminhos relativos do YAML
+//   assets/              arquivos que estavam FORA da pasta do deck (o YAML do pacote aponta para cá)
+//   FALTANDO.txt         o que o deck usa mas não existia ao salvar
+//
+// Também abre um .zip comum com um .yaml dentro (versão sem manifesto).
+//
+//   deckAssets(spec, baseDir)            -> [{ ref, rel, abs, exists }]   o que o deck usa do disco
+//   packDeck(spec, { baseDir, name })    -> { zip: Buffer, files, missing }
+//   unpackDeck(buffer, destDir)          -> { file, dir, manifest }       (caminho do .yaml extraído)
+import fs from "node:fs";
+import path from "node:path";
+import JSZip from "jszip";
+import YAML from "yaml";
+
+export const EXTENSION = ".sagadeck";
+export const MIME = "application/vnd.sagadeck+zip";
+export const FORMAT_VERSION = 1; // sobe quando o formato mudar de um jeito que versões antigas não entendam
+
+const isLocal = (v) => typeof v === "string" && v.trim() && !/^(https?:|data:|\/\/)/i.test(v.trim());
+const posix = (p) => p.split(path.sep).join("/");
+
+// percorre o deck achando referências a arquivos: css, widgets e qualquer `image`
+function refsOf(spec) {
+  const out = [];
+  const add = (v, where) => { if (isLocal(v)) out.push({ ref: v.trim(), where }); };
+  [].concat(spec.css || []).forEach((c) => add(c, "css"));
+  [].concat(spec.widgets || []).forEach((w) => add(w, "widget"));
+  const walk = (v) => {
+    if (Array.isArray(v)) return v.forEach(walk);
+    if (!v || typeof v !== "object") return;
+    for (const [k, x] of Object.entries(v)) {
+      if (k === "image") add(x, "image");
+      else if (typeof x === "object") walk(x);
+    }
+  };
+  walk(spec.slides || []);
+  return out;
+}
+
+export function deckAssets(spec, baseDir) {
+  const seen = new Map();
+  for (const { ref, where } of refsOf(spec)) {
+    if (seen.has(ref)) continue;
+    const abs = path.resolve(baseDir, ref);
+    const inside = !path.relative(baseDir, abs).startsWith("..") && !path.isAbsolute(path.relative(baseDir, abs));
+    // dentro da pasta do deck: mesmo caminho relativo; fora: assets/<nome> (sem colidir)
+    let rel = inside ? posix(path.relative(baseDir, abs)) : `assets/${path.basename(abs)}`;
+    if (!inside) for (let n = 2; [...seen.values()].some((a) => a.rel === rel); n++) rel = `assets/${n}-${path.basename(abs)}`;
+    seen.set(ref, { ref, where, rel, abs, exists: fs.existsSync(abs) && fs.statSync(abs).isFile() });
+  }
+  return [...seen.values()];
+}
+
+// YAML do pacote: sem campos internos (_dir, _file…) e com os caminhos que mudaram (arquivos de fora)
+function packagedSpec(spec, assets) {
+  const moved = new Map(assets.filter((a) => a.ref !== a.rel).map((a) => [a.ref, a.rel]));
+  const clean = (v, key) => {
+    if (Array.isArray(v)) return v.map((x) => clean(x, key));
+    if (typeof v === "string") return (key === "image" || key === "css" || key === "widgets") && moved.has(v.trim()) ? moved.get(v.trim()) : v;
+    if (!v || typeof v !== "object") return v;
+    return Object.fromEntries(Object.entries(v).filter(([k]) => !k.startsWith("_")).map(([k, x]) => [k, clean(x, k)]));
+  };
+  return clean(spec);
+}
+
+export async function packDeck(spec, { baseDir, name = "apresentacao", generator = "sagadeck" } = {}) {
+  const dir = baseDir || spec._dir || process.cwd();
+  const assets = deckAssets(spec, dir);
+  const zip = new JSZip();
+  const root = zip;
+  const main = `${name}.yaml`;
+  root.file("sagadeck.json", JSON.stringify({ format: "sagadeck", version: FORMAT_VERSION, main, title: spec.title || name,
+    created: new Date().toISOString(), generator }, null, 2));
+  root.file(main, YAML.stringify(packagedSpec(spec, assets), { indent: 2, lineWidth: 0 }));
+  const files = [], missing = [];
+  for (const a of assets) {
+    if (a.exists) { root.file(a.rel, fs.readFileSync(a.abs)); files.push(a.rel); }
+    else missing.push(a.ref);
+  }
+  if (missing.length) {
+    root.file("FALTANDO.txt", `Estes arquivos são usados pela apresentação, mas não foram encontrados em ${dir}:\n\n` +
+      missing.map((m) => `- ${m}`).join("\n") + "\n\nColoque-os nesta pasta (mesmo caminho) para a apresentação ficar completa.\n");
+  }
+  return { zip: await zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE" }), files, missing };
+}
+
+// Extrai um pacote numa pasta nova (nunca sobrescreve) e devolve o .yaml principal.
+export async function unpackDeck(buffer, destDir) {
+  const zip = await JSZip.loadAsync(buffer);
+  const entries = Object.values(zip.files).filter((f) => !f.dir);
+  for (const f of entries) {
+    const norm = path.posix.normalize(f.name.replace(/\\/g, "/"));
+    if (norm.startsWith("../") || norm.startsWith("/") || /^[a-z]:/i.test(norm)) throw new Error(`Pacote inválido: caminho "${f.name}" sai da pasta`);
+  }
+  let manifest = null;
+  const mf = zip.file("sagadeck.json");
+  if (mf) {
+    try { manifest = JSON.parse(await mf.async("string")); } catch { throw new Error("Arquivo .sagadeck com manifesto (sagadeck.json) inválido."); }
+    if (manifest.version > FORMAT_VERSION) throw new Error(`Este arquivo foi salvo por uma versão mais nova do sagadeck (formato ${manifest.version}; esta entende até ${FORMAT_VERSION}). Atualize o sagadeck.`);
+  }
+  const yamls = manifest?.main && zip.file(manifest.main) ? [manifest.main]
+    : entries.map((f) => f.name).filter((n) => /\.ya?ml$/i.test(n)).sort((a, b) => a.split("/").length - b.split("/").length);
+  if (!yamls.length) throw new Error("O arquivo não tem nenhuma apresentação (.yaml) dentro.");
+  fs.mkdirSync(destDir, { recursive: true });
+  for (const f of entries) {
+    const target = path.join(destDir, ...path.posix.normalize(f.name).split("/"));
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    fs.writeFileSync(target, await f.async("nodebuffer"));
+  }
+  return { file: path.join(destDir, ...yamls[0].split("/")), dir: destDir, manifest };
+}

package/src/playground.js

@@ -0,0 +1,19 @@
+import { esc } from './markup.js';
+
+// Conteúdo executável tem uma origem opaca e nenhuma permissão de rede ou do pai.
+export function playgroundDocument(s) {
+  const policy = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data: blob:; font-src data:; media-src data: blob:; connect-src 'none'";
+  const bridge = `const report=(kind,text)=>parent.postMessage({sagaPlayground:true,kind,text:String(text).slice(0,4000)},'*');window.addEventListener('error',e=>report('error',e.message));window.addEventListener('unhandledrejection',e=>report('error',e.reason));console.log=(...x)=>report('log',x.join(' '));window.sagaActive=true;window.addEventListener('message',e=>{if(e.source===parent&&typeof e.data?.sagaActive==='boolean')window.sagaActive=e.data.sagaActive});const interval=window.setInterval;window.setInterval=(fn,ms,...args)=>interval(()=>{if(window.sagaActive)fn(...args)},ms);`;
+  const script = String(s.javascript || '').replace(/<\/script/gi, '<\\/script');
+  return `<!doctype html><html lang="pt-BR"><head><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="${esc(policy)}"><style>html,body{margin:0;height:100%;font-family:system-ui;background:#f6f7fa;color:#202432}*{box-sizing:border-box}${s.css || ''}</style></head><body>${s.html || ''}<script>${bridge}\n${script}</script></body></html>`;
+}
+export function playgroundHTML(s, ctx, head) {
+  return `<div class="L-playground f-body" data-playground>${head(s)}<div class="pg-toolbar"><button data-pg-reset>Reiniciar experiência</button><output data-pg-status aria-live="polite"></output></div><iframe class="pg-frame" title="${esc(s.title || 'Experiência interativa')}" sandbox="allow-scripts" srcdoc="${esc(playgroundDocument(s))}"></iframe>${s.explanation ? `<p class="gl-explanation">${esc(s.explanation)}</p>` : ''}</div>`;
+}
+export const playgroundExample = {
+  layout: 'playground', title: 'Uma fila. Dois ritmos.',
+  html: '<main><h2>Chegadas e atendimento</h2><label>Capacidade <input id="capacity" type="range" min="1" max="8" value="3"></label><button id="add">Chegaram mais cinco pedidos</button><p id="stats"></p><div id="queue"></div></main>',
+  css: 'main{padding:32px}#queue{display:flex;flex-wrap:wrap;gap:12px;margin-top:24px}.job{width:48px;height:48px;background:#7756dc;border-radius:12px;transition:opacity .5s,transform .5s}button,input{margin:12px}button{padding:12px}',
+  javascript: `let next=0,done=0;const q=document.querySelector('#queue');function add(){for(let i=0;i<5;i++){const e=document.createElement('div');e.className='job';e.title='Pedido '+(++next);q.append(e)}paint()}function paint(){document.querySelector('#stats').textContent=q.children.length+' na fila; '+done+' atendidos'}document.querySelector('#add').onclick=add;setInterval(()=>{const n=Number(document.querySelector('#capacity').value);for(const e of [...q.children].slice(0,n)){e.style.opacity=0;e.style.transform='translateY(-20px)';setTimeout(()=>{e.remove();done++;paint()},500)}},1600);add();`,
+  explanation: 'Aumente as chegadas e altere a capacidade. Em que condições a fila consegue diminuir?',
+};