@cyber-dash-tech/revela 0.5.1 → 0.6.1

package/README.md

@@ -114,7 +114,7 @@ Before the agent writes `decks/humanoid-robotics.html`, it must update `DECKS.js
 /revela review humanoid-robotics
 ```
 
-Export when needed:
+Export when needed, either manually or by asking the agent to export:
 
 ```text
 /revela pdf decks/humanoid-robotics.html
@@ -600,13 +600,17 @@ PDF export:
 /revela pdf decks/my-deck.html
 ```
 
+LLM tool equivalent: `revela-pdf` with `{ "file": "decks/my-deck.html" }`.
+
 Editable PPTX export:
 
 ```text
 /revela pptx decks/my-deck.html
 ```
 
-Both commands write output beside the source HTML deck.
+LLM tool equivalent: `revela-pptx` with `{ "file": "decks/my-deck.html" }`.
+
+Both commands and tools write output beside the source HTML deck. Use the tools when you want the agent to run export as part of the deck workflow instead of asking the user to invoke `/revela pdf` or `/revela pptx` manually.
 
 ---
 

package/README.zh-CN.md

@@ -113,7 +113,7 @@ Create a 6-slide HTML deck on humanoid robotics supply chains. Cite the main mar
 /revela review humanoid-robotics
 ```
 
-需要导出时：
+需要导出时，可以手动调用，也可以让 agent 直接导出：
 
 ```text
 /revela pdf decks/humanoid-robotics.html
@@ -565,13 +565,17 @@ PDF 导出：
 /revela pdf decks/my-deck.html
 ```
 
+对应的 LLM tool：`revela-pdf`，参数为 `{ "file": "decks/my-deck.html" }`。
+
 可编辑 PPTX 导出：
 
 ```text
 /revela pptx decks/my-deck.html
 ```
 
-两种导出都会把结果写到源 HTML deck 同目录。
+对应的 LLM tool：`revela-pptx`，参数为 `{ "file": "decks/my-deck.html" }`。
+
+命令和 tool 都会把结果写到源 HTML deck 同目录。如果希望 agent 在 deck 工作流中自动完成导出，可以让它调用 tool，而不需要用户手动执行 `/revela pdf` 或 `/revela pptx`。
 
 ---
 

package/designs/monet/DESIGN.md

@@ -171,8 +171,8 @@ Recommended reusable primitives:
 - Every slide uses `.slide-canvas` sized to `1920px x 1080px`, scaled by JS.
 - Every `<section class="slide">` must include `slide-qa="true"` or `slide-qa="false"`.
 - Use `slide-qa="true"` for dense content layouts and `slide-qa="false"` for structural or intentionally sparse layouts.
-- Default canvas padding: `10px` (minimal frame; the page nearly fills the canvas).
-- The paper page should usually sit inside the canvas with `padding: 56px 64px 64px`.
+- `.slide-canvas` is the export surface and must keep `padding: 0`.
+- Put safe-area spacing on `.page` or inner layout containers, not on `.slide-canvas`.
 - Target strong fill on content-heavy slides while preserving editorial whitespace.
 
 ### HTML Structure
@@ -240,7 +240,7 @@ body {
     transform-origin: center center;
     position: relative;
     overflow: hidden;
-    padding: 10px;
+    padding: 0;
 }
 
 .page {

package/designs/monet/preview.html

@@ -65,7 +65,7 @@
       transform-origin: center center;
       position: relative;
       overflow: hidden;
-      padding: 10px;
+      padding: 0;
     }
 
     .page {

package/designs/starter/DESIGN.md

@@ -89,7 +89,7 @@ For photography, UI screenshots, webpages, and product surfaces, do not convert
 
 - The browser viewport is a neutral dark frame.
 - The slide page is a light neutral surface.
-- Default canvas padding is compact: `10px`, so preview and generated decks have a large usable page.
+- `.slide-canvas` is the export surface and must keep `padding: 0`; put safe-area spacing on `.page` or inner layout containers.
 - Use page edge, rules, cards, panels, and quiet geometry as neutral structure. Avoid built-in industry-specific imagery.
 
 ### Grid System
@@ -132,7 +132,7 @@ Every generated presentation must use this exact HTML skeleton:
 html { scroll-snap-type: y mandatory; overflow-y: scroll; height: 100%; }
 body { background: var(--bg-frame); color: var(--text-primary); font-family: var(--font-body); -webkit-font-smoothing: antialiased; height: 100%; }
 .slide { min-height: 100dvh; scroll-snap-align: start; display: flex; align-items: center; justify-content: center; overflow: hidden; background: var(--bg-frame); }
-.slide-canvas { width: 1920px; height: 1080px; flex-shrink: 0; transform-origin: center center; position: relative; overflow: hidden; padding: 10px; }
+.slide-canvas { width: 1920px; height: 1080px; flex-shrink: 0; transform-origin: center center; position: relative; overflow: hidden; padding: 0; }
 .page { position: relative; width: 100%; height: 100%; background: var(--bg-page); color: var(--text-primary); padding: 56px 64px 64px; box-shadow: 0 24px 80px var(--shadow-soft); display: flex; flex-direction: column; overflow: hidden; }
 .page.alt { background: var(--bg-page-alt); }
 .eyebrow, .caption, .meta-label { font-size: var(--font-size-meta); line-height: 1.4; letter-spacing: 0.12em; text-transform: uppercase; color: var(--text-muted); }

package/designs/starter/preview.html

@@ -35,7 +35,7 @@
     html { scroll-snap-type: y mandatory; overflow-y: scroll; height: 100%; }
     body { background: var(--bg-frame); color: var(--text-primary); font-family: var(--font-body); -webkit-font-smoothing: antialiased; height: 100%; }
     .slide { min-height: 100dvh; scroll-snap-align: start; display: flex; align-items: center; justify-content: center; overflow: hidden; background: var(--bg-frame); }
-    .slide-canvas { width: 1920px; height: 1080px; flex-shrink: 0; transform-origin: center center; position: relative; overflow: hidden; padding: 10px; }
+    .slide-canvas { width: 1920px; height: 1080px; flex-shrink: 0; transform-origin: center center; position: relative; overflow: hidden; padding: 0; }
     .page { position: relative; width: 100%; height: 100%; background: var(--bg-page); color: var(--text-primary); padding: 56px 64px 64px; box-shadow: 0 24px 80px var(--shadow-soft); display: flex; flex-direction: column; overflow: hidden; }
     .page.alt { background: var(--bg-page-alt); }
     .eyebrow, .caption, .meta-label { font-size: var(--font-size-meta); line-height: 1.4; letter-spacing: 0.12em; text-transform: uppercase; color: var(--text-muted); }

package/designs/summit/DESIGN.md

@@ -109,8 +109,8 @@ All sizes are fixed `px` for the 1920x1080 canvas. JS `transform: scale()` handl
 - Every slide uses `.slide-canvas` sized to `1920px x 1080px`, scaled by JS.
 - Every `<section class="slide">` must include `slide-qa="true"` or `slide-qa="false"`.
 - Use `slide-qa="true"` for dense content layouts and `slide-qa="false"` for structural or intentionally sparse layouts.
-- Default canvas padding: `72px 80px`.
-- The paper page should usually sit inside the canvas with `padding: 56px 64px 64px`.
+- `.slide-canvas` is the export surface and must keep `padding: 0`.
+- Put safe-area spacing on `.page` or inner layout containers, not on `.slide-canvas`.
 - Target strong fill on content-heavy slides while preserving editorial whitespace.
 
 ### HTML Structure
@@ -178,7 +178,7 @@ body {
     transform-origin: center center;
     position: relative;
     overflow: hidden;
-    padding: 72px 80px;
+    padding: 0;
 }
 
 .page {

package/designs/summit/preview.html

@@ -59,7 +59,7 @@
       transform-origin: center center;
       position: relative;
       overflow: hidden;
-      padding: 72px 80px;
+      padding: 0;
     }
 
     .page {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyber-dash-tech/revela",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "OpenCode plugin that turns AI into an HTML slide deck generator",
   "type": "module",
   "main": "./index.ts",

package/plugin.ts

@@ -82,6 +82,8 @@ import researchSaveTool from "./tools/research-save"
 import workspaceScanTool from "./tools/workspace-scan"
 import extractDocumentMaterialsTool from "./tools/extract-document-materials"
 import qaTool from "./tools/qa"
+import pdfTool from "./tools/pdf"
+import pptxTool from "./tools/pptx"
 import { RESEARCH_PROMPT, RESEARCH_AGENT_SIGNATURE } from "./lib/agents/research-prompt"
 import { runQA, formatReport } from "./lib/qa"
 import { extractDesignClasses } from "./lib/design/designs"
@@ -331,6 +333,8 @@ const server: Plugin = (async (pluginCtx) => {
       "revela-workspace-scan": workspaceScanTool,
       "revela-extract-document-materials": extractDocumentMaterialsTool,
       "revela-qa": qaTool,
+      "revela-pdf": pdfTool,
+      "revela-pptx": pptxTool,
     },
 
     // ── chat.message: intercept @-referenced / pasted binary files ────────

package/tools/pdf.ts

@@ -0,0 +1,43 @@
+/**
+ * tools/pdf.ts
+ *
+ * revela-pdf — Export a Revela HTML slide deck to PDF.
+ */
+
+import { tool } from "@opencode-ai/plugin"
+import { existsSync } from "fs"
+import { resolve } from "path"
+import { exportToPdf } from "../lib/pdf/export"
+
+export default tool({
+  description:
+    "Export a Revela-generated HTML slide deck to PDF. " +
+    "Use this after the deck HTML has been written and layout QA has passed. " +
+    "Output is written beside the input file with the same basename and a .pdf extension.",
+  args: {
+    file: tool.schema
+      .string()
+      .describe(
+        "Path to the HTML slide file to export. " +
+        "Can be absolute or relative to the current working directory."
+      ),
+  },
+  async execute({ file }, { directory }) {
+    const filePath = resolve(directory || process.cwd(), file)
+
+    if (!existsSync(filePath)) {
+      return JSON.stringify({ ok: false, error: `File not found: ${filePath}` })
+    }
+
+    if (!/\.html?$/i.test(filePath)) {
+      return JSON.stringify({ ok: false, error: `File must be an HTML file: ${filePath}` })
+    }
+
+    try {
+      const result = await exportToPdf(filePath)
+      return JSON.stringify({ ok: true, ...result }, null, 2)
+    } catch (e: any) {
+      return JSON.stringify({ ok: false, error: e?.message ?? String(e) })
+    }
+  },
+})

package/tools/pptx.ts

@@ -0,0 +1,49 @@
+/**
+ * tools/pptx.ts
+ *
+ * revela-pptx — Export a Revela HTML slide deck to editable PPTX.
+ */
+
+import { tool } from "@opencode-ai/plugin"
+import { existsSync } from "fs"
+import { resolve } from "path"
+import { exportToPptx } from "../lib/pptx/export"
+
+export default tool({
+  description:
+    "Export a Revela-generated HTML slide deck to editable PPTX. " +
+    "Use this after the deck HTML has been written and layout QA has passed. " +
+    "Output is written beside the input file with the same basename and a .pptx extension.",
+  args: {
+    file: tool.schema
+      .string()
+      .describe(
+        "Path to the HTML slide file to export. " +
+        "Can be absolute or relative to the current working directory."
+      ),
+  },
+  async execute({ file }, { directory }) {
+    const filePath = resolve(directory || process.cwd(), file)
+
+    if (!existsSync(filePath)) {
+      return JSON.stringify({ ok: false, error: `File not found: ${filePath}` })
+    }
+
+    if (!/\.html?$/i.test(filePath)) {
+      return JSON.stringify({ ok: false, error: `File must be an HTML file: ${filePath}` })
+    }
+
+    const progress: string[] = []
+
+    try {
+      const result = await exportToPptx(filePath, {
+        onProgress: (event) => {
+          progress.push(event.message)
+        },
+      })
+      return JSON.stringify({ ok: true, ...result, progress }, null, 2)
+    } catch (e: any) {
+      return JSON.stringify({ ok: false, error: e?.message ?? String(e), progress })
+    }
+  },
+})