@tycoworks/tycoslide 0.11.0 → 0.11.2

package/README.md

@@ -16,6 +16,8 @@ Create editable, on-brand PowerPoint slides from markdown.
 npm install @tycoworks/tycoslide
 ```
 
+Installing also downloads Chromium (~554MB), via `@playwright/browser-chromium`, which tycoslide uses to render mermaid diagrams. If you install with `--ignore-scripts`, run `npx playwright install chromium-headless-shell` before building a deck with diagrams.
+
 Create `deck.md`:
 
 ```markdown

package/SKILL.md

@@ -162,7 +162,6 @@ Build the deck again ([Build](#build)) and read the output carefully. Common err
 | YAML parse error | Fix the YAML syntax in the slide's frontmatter |
 | `Skipped setting relation target` | The asset image couldn't be placed; check the path and file |
 | `forbidden style directive` | Remove `style`, `classDef`, `linkStyle`, or `%%{init}` from your mermaid block -- use `class` for grouping instead |
-| `Mermaid render failed` | The engine renders diagrams with Playwright's Chromium; install it once with `npx playwright install chromium` |
 | `no "mermaid" block` | The theme has no mermaid color config -- add a `mermaid` section to theme.json |
 
 ### Verification Loop

package/dist/cli.js

@@ -79,7 +79,8 @@ program
     // Bundle the WHOLE theme so the skill is self-contained: unzip ->
     // `npm install` (pulls the engine + its deps) -> `npx tycoslide build`.
     const zipFile = `${skillName}.zip`;
-    writeFileSync(resolve(process.cwd(), zipFile), await zipDir(process.cwd(), skillName));
+    const generated = [opts.config, MANIFEST_FILE, SKILL_FILE, SYNTAX_FILE];
+    writeFileSync(resolve(process.cwd(), zipFile), await zipDir(process.cwd(), skillName, config, generated));
     console.log(`WROTE ${zipFile}`);
 });
 await program.parseAsync(process.argv);

package/dist/engine/generate.js

@@ -33,7 +33,7 @@ import { Automizer, modify } from "pptx-automizer";
 import { FILLERS } from "./fillers/filler.js";
 import { isImageFill } from "./fillers/image.js";
 import { applyNotesToSlide, sweepOrphanNotes } from "./notes.js";
-import { SlotType } from "./types.js";
+import { SlotType, TEMPLATE_DIR, } from "./types.js";
 /**
  * Generate a PPTX file from a deck definition and a theme configuration.
  *
@@ -53,7 +53,7 @@ export async function generate(deck, config, options = {}) {
     const outDir = dirname(deck.output);
     const outFile = basename(deck.output);
     const automizer = new Automizer({
-        templateDir: resolve(rootDir, "template"),
+        templateDir: resolve(rootDir, TEMPLATE_DIR),
         outputDir: outDir,
         removeExistingSlides: true,
         autoImportSlideMasters: true,

package/dist/engine/index.d.ts

@@ -6,4 +6,4 @@ export { fillText, isTextFill } from "./fillers/text.js";
 export type { GenerateOptions } from "./generate.js";
 export { generate } from "./generate.js";
 export type { Block, BodyRows, Config, Deck, DeckStep, Frame, ImageFill, Layout, Slot, StyledParagraph, TableFill, TemplateFill, TemplateSegment, TextFill, TextRun, ThemeConfig, } from "./types.js";
-export { ImageFit, SlotType } from "./types.js";
+export { ImageFit, SlotType, TEMPLATE_DIR } from "./types.js";

package/dist/engine/index.js

@@ -4,4 +4,4 @@ export { fillTable, isTableFill } from "./fillers/table.js";
 export { fillTemplate } from "./fillers/template.js";
 export { fillText, isTextFill } from "./fillers/text.js";
 export { generate } from "./generate.js";
-export { ImageFit, SlotType } from "./types.js";
+export { ImageFit, SlotType, TEMPLATE_DIR } from "./types.js";

package/dist/engine/types.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Theme subdirectory holding the source `.pptx` template. Fixed by convention:
+ * `theme.json` names only the file, so the engine resolves the template under
+ * this directory and packaging reads it from the same place.
+ */
+export declare const TEMPLATE_DIR = "template";
 /**
  * Fill-strategy discriminator carried on every Slot. Required — there is no
  * silent default. The engine dispatches to fillTemplate / fillText / fillTable /

package/dist/engine/types.js

@@ -1,3 +1,9 @@
+/**
+ * Theme subdirectory holding the source `.pptx` template. Fixed by convention:
+ * `theme.json` names only the file, so the engine resolves the template under
+ * this directory and packaging reads it from the same place.
+ */
+export const TEMPLATE_DIR = "template";
 /**
  * Fill-strategy discriminator carried on every Slot. Required — there is no
  * silent default. The engine dispatches to fillTemplate / fillText / fillTable /

package/dist/skillZip.d.ts

@@ -1,3 +1,4 @@
+import type { CompilerThemeConfig } from "./markdown/types.js";
 /**
  * Rewrite the `name:` value in a skill.md's leading YAML frontmatter so the
  * packaged skill is named after the consuming theme, not the source template.
@@ -6,12 +7,10 @@
  */
 export declare function renameSkill(md: string, name: string): string;
 /**
- * Zip an entire theme directory into an uploadable Agent Skill archive whose
- * entries all live under a single root folder (e.g. `mz-slides/theme.json`),
- * matching Anthropic's custom-skill format. Recursively includes every file
- * except node_modules, hidden entries (any name starting with `.`), and
- * top-level build artifacts (.pptx/.pdf/.zip at the repo root; the template
- * .pptx under template/ is kept). Subdirectory structure is preserved with
- * POSIX slashes. Fails fast if nothing is left to zip.
+ * Zip a theme into an uploadable Agent Skill archive whose entries all live
+ * under a single root folder (e.g. `mz-slides/theme.json`), matching Anthropic's
+ * custom-skill format. `generated` names the files the caller just wrote (the
+ * config, manifest, skill.md, syntax.md). Optional support files are skipped
+ * when absent; anything the config declares but that is missing is an error.
  */
-export declare function zipDir(rootDir: string, folderName: string): Promise<Buffer>;
+export declare function zipDir(rootDir: string, folderName: string, config: CompilerThemeConfig, generated: string[]): Promise<Buffer>;

package/dist/skillZip.js

@@ -1,6 +1,7 @@
-import { readdirSync, readFileSync } from "node:fs";
-import { extname, join, relative, sep } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 import JSZip from "jszip";
+import { TEMPLATE_DIR } from "./engine/index.js";
 const FRONTMATTER = /^---\n([\s\S]*?)\n---/;
 const NAME_LINE = /^name:[ \t]*.*$/m;
 /**
@@ -17,47 +18,50 @@ export function renameSkill(md, name) {
         throw new Error('skill.md frontmatter has no "name:" line');
     return md.replace(block[0], block[0].replace(NAME_LINE, `name: ${name}`));
 }
-// Never packaged: dependencies (npm install rebuilds them) and hidden entries
-// (name starting with "." — covers VCS, tooling, caches, secrets like .env/.npmrc).
-const EXCLUDE_DIRS = new Set(["node_modules"]);
-// Build artifacts, dropped ONLY at the repo root: decks build to cwd
-// (showcase.pptx, deck.pptx, the output .zip), while the template .pptx lives
-// under template/ and must be kept — so these extensions are pruned top-level only.
-const ROOT_ARTIFACT_EXTS = new Set([".pptx", ".pdf", ".zip"]);
 /**
- * Zip an entire theme directory into an uploadable Agent Skill archive whose
- * entries all live under a single root folder (e.g. `mz-slides/theme.json`),
- * matching Anthropic's custom-skill format. Recursively includes every file
- * except node_modules, hidden entries (any name starting with `.`), and
- * top-level build artifacts (.pptx/.pdf/.zip at the repo root; the template
- * .pptx under template/ is kept). Subdirectory structure is preserved with
- * POSIX slashes. Fails fast if nothing is left to zip.
+ * Files a packaged skill needs beyond the theme's own declarations. `package.json`
+ * matters most: the unzip flow is `npm install` -> `npx tycoslide build`, so it
+ * restores the engine and any npm-resolved brand fonts. The lockfile is taken
+ * when present so that install is reproducible.
  */
-export async function zipDir(rootDir, folderName) {
+const SUPPORT_FILES = ["package.json", "package-lock.json"];
+/**
+ * Every path a packaged theme needs, relative to `rootDir` and POSIX-separated.
+ *
+ * Derived from the theme config rather than filtered out of a directory walk:
+ * the config already declares its template and its whole asset catalog, so an
+ * allowlist stays correct no matter what else sits in the working directory --
+ * built decks, PDFs, slide PNGs, scratch files. Font paths are deliberately
+ * absent: they resolve from node_modules, which `npm install` restores.
+ */
+function skillPaths(config, generated) {
+    const assets = Object.values(config.assets).flatMap((category) => Object.values(category).map((entry) => entry.path));
+    return [...SUPPORT_FILES, ...generated, `${TEMPLATE_DIR}/${config.template}`, ...assets];
+}
+/**
+ * Zip a theme into an uploadable Agent Skill archive whose entries all live
+ * under a single root folder (e.g. `mz-slides/theme.json`), matching Anthropic's
+ * custom-skill format. `generated` names the files the caller just wrote (the
+ * config, manifest, skill.md, syntax.md). Optional support files are skipped
+ * when absent; anything the config declares but that is missing is an error.
+ */
+export async function zipDir(rootDir, folderName, config, generated) {
     const zip = new JSZip();
     const folder = zip.folder(folderName);
     if (!folder)
         throw new Error(`Failed to create zip folder: ${folderName}`);
+    const optional = new Set(SUPPORT_FILES);
     let count = 0;
-    const walk = (dir) => {
-        const atRoot = dir === rootDir;
-        for (const entry of readdirSync(dir, { withFileTypes: true })) {
-            if (entry.name.startsWith("."))
+    for (const rel of skillPaths(config, generated)) {
+        const abs = join(rootDir, ...rel.split("/"));
+        if (!existsSync(abs)) {
+            if (optional.has(rel))
                 continue;
-            const abs = join(dir, entry.name);
-            if (entry.isDirectory()) {
-                if (!EXCLUDE_DIRS.has(entry.name))
-                    walk(abs);
-            }
-            else if (entry.isFile()) {
-                if (atRoot && ROOT_ARTIFACT_EXTS.has(extname(entry.name)))
-                    continue;
-                folder.file(relative(rootDir, abs).split(sep).join("/"), readFileSync(abs));
-                count++;
-            }
+            throw new Error(`Theme declares "${rel}", but no such file exists`);
         }
-    };
-    walk(rootDir);
+        folder.file(rel, readFileSync(abs));
+        count++;
+    }
     if (count === 0)
         throw new Error(`No files to zip in directory: ${rootDir}`);
     return zip.generateAsync({ type: "nodebuffer" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tycoworks/tycoslide",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Create editable, on-brand PowerPoint slides from markdown.",
   "type": "module",
   "main": "dist/index.js",
@@ -23,12 +23,13 @@
     "format": "biome format --write ."
   },
   "dependencies": {
+    "@playwright/browser-chromium": "^1.62.1",
     "@xmldom/xmldom": "^0.9.10",
     "commander": "^15.0.0",
     "image-size": "^2.0.2",
     "jszip": "^3.10.1",
     "mermaid": "^11.16.1",
-    "playwright": "^1.58.2",
+    "playwright": "^1.62.1",
     "pptx-automizer": "^0.8.2",
     "remark-gfm": "^4.0.1",
     "remark-ins": "^1.2.5",