@tycoworks/tycoslide 0.9.0 → 0.10.1

package/README.md

@@ -1,14 +1,14 @@
 # tycoslide
 
-Let AI agents build slides from existing PowerPoint (`.pptx`) files.
+Create editable, on-brand PowerPoint slides from markdown.
 
 > **Early release** — tycoslide is under active development.
 
 ## How it works
 
-1. **tycoslide wraps your PowerPoint file as an agent skill.**
-2. **Your agents use the skill to write slides in markdown.**
-3. **tycoslide builds a finished PowerPoint file from the markdown.**
+1. **tycoslide wraps existing PowerPoint files as reusable templates.**
+2. **You (or an agent) write slides in markdown.**
+3. **tycoslide builds new PowerPoint files.**
 
 ## Quick Start
 
@@ -42,16 +42,15 @@ title: Highlights
 Build:
 
 ```bash
-tycoslide build deck.md                   # → deck.pptx
+npx tycoslide build deck.md               # → deck.pptx
 ```
 
 ## CLI
 
 ```bash
-tycoslide build deck.md       # markdown → PPTX (theme resolved from deck frontmatter)
-tycoslide build deck.md --no-notes   # omit speaker notes from the output
-tycoslide plugin              # generate AI agent plugin package
-tycoslide manifest            # print layout + asset catalog to stdout
+npx tycoslide build deck.md       # markdown → PPTX (theme resolved from deck frontmatter)
+npx tycoslide build deck.md --no-notes   # omit speaker notes from the output
+npx tycoslide package             # regenerate skill.md/syntax.md/manifest.json + zip the whole theme into a self-contained <package-name>.zip
 ```
 
 ## Theme Structure
@@ -65,6 +64,10 @@ my-theme/
   assets/icons/
   theme.json
   package.json
+  skill.md          # generated by `tycoslide package`
+  syntax.md         # generated by `tycoslide package`
+  manifest.json     # generated by `tycoslide package`
+  <package-name>.zip  # uploadable Agent Skill bundle
 ```
 
 **Template** — the PPTX file with named shapes that tycoslide fills.

package/SKILL.md

@@ -1,17 +1,15 @@
 ---
 name: slides
 description: >
-  Use this skill any time the user wants to create branded slides, presentations,
-  pitch decks, or sales collateral as a .pptx. Trigger whenever the user mentions "deck," "slides,"
-  "presentation," "pitch," or .pptx output. Also trigger when the user says "build me a deck,"
-  "make slides about X," or "turn this into a presentation."
+  Build branded slides, presentations, pitch decks, or sales collateral as a .pptx.
+  Trigger on "deck," "slides," "presentation," "pitch," ".pptx," or "build me a deck."
 ---
 
 # slides
 
 ## Setup
 
-Before first use, install dependencies from the plugin root:
+Before first use, install dependencies from the theme root:
 
 ```bash
 npm install
@@ -48,7 +46,7 @@ A layout's inputs split two ways (see [syntax.md](syntax.md) for details):
 
 A single physical slide may back multiple layouts. When two manifest entries share the same `slideNumber`, they render into the same underlying PPTX shapes but declare their fill differently -- e.g. one layout exposing the fill as an `image` parameter and a sibling exposing it as a `mermaid` slot. Pick between them by naming the layout you want in frontmatter (`layout: Full bleed diagram` vs `layout: Full bleed image`); the declaration is unambiguous per layout, so the compiler always knows how to interpret the content you provide.
 
-Study each layout's `whenToUse` and `limit`s before writing any slides. These are your primary guide for matching content to layouts.
+Study each layout's `slots` and `limit`s before writing any slides.
 
 ---
 
@@ -131,7 +129,7 @@ The deck is written to your current working directory (not inside the skill).
 
 ### For Each Slide
 
-**Every slide communicates one idea.** If you're writing more than 5 bullets or 3 paragraphs, split into two slides.
+**Every slide communicates one idea.** If you're writing more than 5 bullets or 3 paragraphs, split into two slides. Put the takeaway in the headline, then support it.
 
 Check each layout's `limit` in the manifest for content density constraints. When content overflows, split across slides.
 
@@ -143,6 +141,7 @@ Check each layout's `limit` in the manifest for content density constraints. Whe
 - **Don't open with a body/content layout** -- use the Title layout for impact
 - **Don't skip section dividers** -- for decks over 5 slides, use Section title layouts to group sections
 - **Don't restyle the layout** -- the theme owns all design; you only fill slots
+- **Don't use an image that's wrong for the slot** -- a small slot wants a simple icon, not a dense illustration; if the build warns an image shrank to a small %, swap it for a simpler one
 - **Don't invent layout or asset names** -- only use what exists in the manifest
 - **Don't leave required parameters or slots empty** -- and don't leave a placeholder logo or dummy text in an image parameter you care about
 - **Don't mix dark and light** -- keep one variant across the deck

package/dist/cli.js

@@ -1,20 +1,20 @@
-import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Command } from "commander";
 import { buildDeck } from "./index.js";
 import { generateManifest } from "./manifest.js";
 import { compileDeck, loadThemeConfig, parseSlideDocument, RESERVED_KEY } from "./markdown/index.js";
+import { renameSkill, zipDir } from "./skillZip.js";
 const DEFAULT_CONFIG = "theme.json";
-const SKILL_DIR = "skills/slides";
-const PLUGIN_DIR = ".claude-plugin";
-const PLUGIN_FILE = "plugin.json";
 const MANIFEST_FILE = "manifest.json";
-const SKILL_FILE = "SKILL.md";
+// The theme skill is written as lowercase skill.md (copied from tycoslide's own
+// SKILL.md), so the skill folder can live at the theme repo root.
+const SKILL_FILE = "skill.md";
 const SYNTAX_FILE = "syntax.md";
 const BUILD_COMMAND = "npx tycoslide build";
 const sdkDir = dirname(fileURLToPath(import.meta.url));
-const skillMdPath = resolve(sdkDir, "..", SKILL_FILE);
+const skillMdPath = resolve(sdkDir, "..", "SKILL.md");
 const syntaxMdPath = resolve(sdkDir, "..", SYNTAX_FILE);
 const pkg = JSON.parse(readFileSync(resolve(sdkDir, "..", "package.json"), "utf-8"));
 const program = new Command().name("tycoslide").description("PPTX template engine CLI").version(pkg.version);
@@ -50,49 +50,36 @@ program
     await buildDeck(deck, config, { excludeNotes: !opts.notes });
 });
 program
-    .command("manifest")
-    .description("Generate manifest.json from theme config")
+    .command("package")
+    .description("Generate the Agent Skill (manifest.json, SKILL.md, syntax.md) for AI agents")
     .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
-    .option(`-o, --out <file>`, "write to file instead of stdout")
     .action(async (opts) => {
     const config = loadThemeConfig(resolve(process.cwd(), opts.config));
-    const json = generateManifest(config, { build: { command: BUILD_COMMAND } });
-    if (opts.out) {
-        writeFileSync(resolve(process.cwd(), opts.out), `${json}\n`);
-        console.log(`WROTE ${opts.out}`);
+    const themePkg = JSON.parse(readFileSync(resolve(process.cwd(), "package.json"), "utf-8"));
+    if (!themePkg.name) {
+        throw new Error('Cannot name the skill: the theme\'s package.json has no "name" field.');
     }
-    else {
-        process.stdout.write(`${json}\n`);
+    // basename drops any npm scope, e.g. "@acme/mz-slides" -> "mz-slides".
+    const skillName = basename(themePkg.name);
+    const manifestJson = `${generateManifest(config, { build: { command: BUILD_COMMAND } })}\n`;
+    writeFileSync(resolve(process.cwd(), MANIFEST_FILE), manifestJson);
+    console.log(`WROTE ${MANIFEST_FILE}`);
+    let skillMd;
+    try {
+        skillMd = renameSkill(readFileSync(skillMdPath, "utf-8"), skillName);
     }
-});
-program
-    .command("plugin")
-    .description("Generate plugin package (plugin.json, manifest.json, SKILL.md, syntax.md) for AI agents")
-    .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
-    .action(async (opts) => {
-    const config = loadThemeConfig(resolve(process.cwd(), opts.config));
-    const cwd = process.cwd();
-    const pkg = JSON.parse(readFileSync(resolve(cwd, "package.json"), "utf-8"));
-    const pluginMeta = {
-        name: pkg.name,
-        version: pkg.version,
-        description: pkg.description ?? "",
-        skills: "./skills",
-    };
-    if (pkg.author)
-        pluginMeta.author = pkg.author;
-    const pluginDir = resolve(cwd, PLUGIN_DIR);
-    mkdirSync(pluginDir, { recursive: true });
-    writeFileSync(resolve(pluginDir, PLUGIN_FILE), `${JSON.stringify(pluginMeta, null, 2)}\n`);
-    console.log(`WROTE ${PLUGIN_DIR}/${PLUGIN_FILE}`);
-    const skillDir = resolve(cwd, SKILL_DIR);
-    mkdirSync(skillDir, { recursive: true });
-    const json = generateManifest(config, { build: { command: BUILD_COMMAND } });
-    writeFileSync(resolve(skillDir, MANIFEST_FILE), `${json}\n`);
-    console.log(`WROTE ${SKILL_DIR}/${MANIFEST_FILE}`);
-    copyFileSync(skillMdPath, resolve(skillDir, SKILL_FILE));
-    console.log(`WROTE ${SKILL_DIR}/${SKILL_FILE}`);
-    copyFileSync(syntaxMdPath, resolve(skillDir, SYNTAX_FILE));
-    console.log(`WROTE ${SKILL_DIR}/${SYNTAX_FILE}`);
+    catch (err) {
+        throw new Error(`${skillMdPath}: ${err.message}`);
+    }
+    writeFileSync(resolve(process.cwd(), SKILL_FILE), skillMd);
+    console.log(`WROTE ${SKILL_FILE}`);
+    const syntaxMd = readFileSync(syntaxMdPath, "utf-8");
+    writeFileSync(resolve(process.cwd(), SYNTAX_FILE), syntaxMd);
+    console.log(`WROTE ${SYNTAX_FILE}`);
+    // 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));
+    console.log(`WROTE ${zipFile}`);
 });
 await program.parseAsync(process.argv);

package/dist/markdown/blocks/code.d.ts

@@ -4,8 +4,10 @@ import { type BlockHandler } from "../types.js";
  * Recognize a fenced code block (any language except mermaid) at a region's top
  * level, folding it to a Text fill, and compile it by Shiki-highlighting its
  * source into a TextFill. Theme resolution is strict: the theme MUST declare a
- * `codeTheme` (one style per theme — the design-system framing); a deck with
- * code fences but no theme-level `codeTheme` throws, naming the offending slot.
+ * `codeTheme` — either one Shiki id (one style per theme — the design-system
+ * framing) or a `{ light, dark }` pair the layout's `variant` selects (a pair
+ * with no layout `variant` throws). A deck with code fences but no theme-level
+ * `codeTheme` throws, naming the offending slot.
  */
 export declare const CODE: BlockHandler;
 /**

package/dist/markdown/blocks/code.js

@@ -5,8 +5,10 @@ import { MERMAID_LANG } from "./mermaid.js";
  * Recognize a fenced code block (any language except mermaid) at a region's top
  * level, folding it to a Text fill, and compile it by Shiki-highlighting its
  * source into a TextFill. Theme resolution is strict: the theme MUST declare a
- * `codeTheme` (one style per theme — the design-system framing); a deck with
- * code fences but no theme-level `codeTheme` throws, naming the offending slot.
+ * `codeTheme` — either one Shiki id (one style per theme — the design-system
+ * framing) or a `{ light, dark }` pair the layout's `variant` selects (a pair
+ * with no layout `variant` throws). A deck with code fences but no theme-level
+ * `codeTheme` throws, naming the offending slot.
  */
 export const CODE = {
     match: (node) => node.type === MdastType.Code && node.lang !== MERMAID_LANG,
@@ -19,11 +21,24 @@ export const CODE = {
             throw new Error(`Slide ${ctx.slideIdx}: layout "${ctx.layoutName}" slot content (from ${ctx.source}) has a code fence ` +
                 "with no language; add one after the opening ``` (e.g. ```sql).");
         }
-        const theme = ctx.config.codeTheme;
-        if (!theme) {
+        const codeTheme = ctx.config.codeTheme;
+        if (!codeTheme) {
             throw new Error(`Layout "${ctx.layoutName}" slot content (from ${ctx.source}): deck contains a code fence but the theme ` +
                 'declares no "codeTheme". Add a theme-level "codeTheme" (a Shiki theme id) to theme.json.');
         }
+        // A single string is one style for every code layout; a `{ light, dark }`
+        // pair requires the layout to declare which via `variant` — no default.
+        let theme;
+        if (typeof codeTheme === "string") {
+            theme = codeTheme;
+        }
+        else if (ctx.layoutVariant) {
+            theme = codeTheme[ctx.layoutVariant];
+        }
+        else {
+            throw new Error(`Layout "${ctx.layoutName}" slot content (from ${ctx.source}): the theme's "codeTheme" is a ` +
+                '{ light, dark } pair, but this layout declares no "variant". Add variant: "light" or "dark" to the layout.');
+        }
         return { paragraphs: await highlightCode(code.value, code.lang, theme) };
     },
 };

package/dist/markdown/deckCompiler.js

@@ -223,6 +223,7 @@ async function compileStep(slide, config, assetTypeByPath, resolveAssetRef) {
             slideIdx: index,
             source: "body content",
             config,
+            layoutVariant: layoutDef.variant,
         });
         // Validate the slot accepts this region's type BEFORE running the (possibly
         // expensive — Shiki, Playwright) fill: a mismatched region fails fast without
@@ -238,7 +239,14 @@ async function compileStep(slide, config, assetTypeByPath, resolveAssetRef) {
                 `Valid slots: ${[...slotsByKey.keys()].join(", ")}`);
         }
         const source = `::${name}::`;
-        const parsed = parseSlotContent(text, { resolveAssetRef, layoutName, slideIdx: index, source, config });
+        const parsed = parseSlotContent(text, {
+            resolveAssetRef,
+            layoutName,
+            slideIdx: index,
+            source,
+            config,
+            layoutVariant: layoutDef.variant,
+        });
         assertSlotRegion(slot, parsed.acceptType, layoutName, index, source);
         content[name] = await parsed.fill();
     }

package/dist/markdown/schema/themeConfigSchema.d.ts

@@ -7,6 +7,10 @@ export declare const ThemeConfigSchema: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         whenToUse: z.ZodOptional<z.ZodString>;
         whenNotToUse: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>;
         parameters: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             shapeName: z.ZodString;
             limit: z.ZodOptional<z.ZodObject<{
@@ -79,7 +83,10 @@ export declare const ThemeConfigSchema: z.ZodObject<{
         path: z.ZodString;
         weight: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>>;
-    codeTheme: z.ZodOptional<z.ZodString>;
+    codeTheme: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        light: z.ZodString;
+        dark: z.ZodString;
+    }, z.core.$strict>]>>;
     mermaidVariant: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 /**

package/dist/markdown/schema/themeConfigSchema.js

@@ -1,7 +1,7 @@
 import { readFileSync } from "node:fs";
 import { basename, dirname } from "node:path";
 import * as z from "zod";
-import { AcceptType, AssetType, ParameterType } from "../types.js";
+import { AcceptType, AssetType, ParameterType, Variant, } from "../types.js";
 import { strict } from "./strict.js";
 /**
  * Fail-fast runtime validation for a `theme.json`. The hand-written types in
@@ -23,6 +23,7 @@ import { strict } from "./strict.js";
 // Reuse the const-object enums as runtime values — no third copy of the literals.
 const acceptTypeSchema = z.enum(Object.values(AcceptType));
 const assetTypeSchema = z.enum(Object.values(AssetType));
+const variantSchema = z.enum(Object.values(Variant));
 // Re-declared here (not imported from the engine) so the schema layer never
 // depends on the engine — mirrors engine `Frame`, guarded by `_drift`.
 const FrameSchema = strict({
@@ -98,6 +99,7 @@ const LayoutSchema = strict({
     description: z.string().optional(),
     whenToUse: z.string().optional(),
     whenNotToUse: z.string().optional(),
+    variant: variantSchema.optional(),
     parameters: z.array(ParameterSchema),
     slots: z.array(SlotSchema),
 });
@@ -108,7 +110,7 @@ export const ThemeConfigSchema = strict({
     outputDir: z.string().optional(),
     mermaid: MermaidConfigSchema.optional(),
     fonts: z.array(ThemeFontSchema).optional(),
-    codeTheme: z.string().optional(),
+    codeTheme: z.union([z.string(), strict({ light: z.string().min(1), dark: z.string().min(1) })]).optional(),
     mermaidVariant: z.string().optional(),
 });
 const _drift = true;

package/dist/markdown/types.d.ts

@@ -54,6 +54,17 @@ export declare const AcceptType: {
     readonly Image: "image";
 };
 export type AcceptType = (typeof AcceptType)[keyof typeof AcceptType];
+/**
+ * The tonal surface a layout sits on. A code layout on a light panel needs a
+ * light Shiki theme (dark syntax would wash out); one on a dark panel needs a
+ * dark theme. A layout declares its `variant`; the code compile resolves a
+ * `{ light, dark }` `codeTheme` pair against it (a pair with no `variant` throws).
+ */
+export declare const Variant: {
+    readonly Light: "light";
+    readonly Dark: "dark";
+};
+export type Variant = (typeof Variant)[keyof typeof Variant];
 /**
  * The four engine content shapes a slot's compiled content can be — the value
  * `compile` produces and the engine fills. ImageFill carries a `.type`
@@ -85,6 +96,12 @@ export type BlockContext = {
     slideIdx: number;
     source: string;
     config: CompilerConfig;
+    /**
+     * The current layout's tonal surface, threaded from its `variant`. The code
+     * compile reads it to pick the arm of a `{ light, dark }` `codeTheme` pair;
+     * a pair with no `variant` throws (no default).
+     */
+    layoutVariant?: Variant;
 };
 /**
  * A block handler recognizes one content kind at the region's top level, folds
@@ -233,6 +250,11 @@ export type CompilerLayout = {
     description?: string;
     whenToUse?: string;
     whenNotToUse?: string;
+    /**
+     * The layout's tonal surface. Selects the arm of a `{ light, dark }` `codeTheme`
+     * pair for code fences on this layout. Required when `codeTheme` is a pair.
+     */
+    variant?: Variant;
     /** Frontmatter inputs (template, image) — one value per `key: value` line. */
     parameters: CompilerParameter[];
     /** Body regions — the default body or `::name::` regions; each `accepts` blocks. */
@@ -276,9 +298,14 @@ export type CompilerThemeConfig = {
      * Theme-level defaults for the two content types the compiler resolves before
      * the engine sees them. One code style and one mermaid style per theme (the
      * design-system framing) — they can't sit on a multi-type slot. `codeTheme` is
-     * a Shiki theme id; `mermaidVariant` names an entry in `mermaid`.
+     * a Shiki theme id, or a `{ light, dark }` pair when the theme has both light
+     * and dark code layouts (each layout's `variant` picks the arm);
+     * `mermaidVariant` names an entry in `mermaid`.
      */
-    codeTheme?: string;
+    codeTheme?: string | {
+        light: string;
+        dark: string;
+    };
     mermaidVariant?: string;
 };
 export type CompilerConfig = CompilerThemeConfig & {

package/dist/markdown/types.js

@@ -37,6 +37,17 @@ export const AcceptType = {
     Table: SlotType.Table,
     Image: SlotType.Image,
 };
+// ── Variant discriminator (a layout's light/dark surface) ─────────────────────
+/**
+ * The tonal surface a layout sits on. A code layout on a light panel needs a
+ * light Shiki theme (dark syntax would wash out); one on a dark panel needs a
+ * dark theme. A layout declares its `variant`; the code compile resolves a
+ * `{ light, dark }` `codeTheme` pair against it (a pair with no `variant` throws).
+ */
+export const Variant = {
+    Light: "light",
+    Dark: "dark",
+};
 /**
  * Reserved keys in a deck's frontmatter — global (theme, output) and per-slide
  * (layout, body). Exported so callers (e.g. cli.ts) reference the constants

package/dist/skillZip.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ * Only the leading `---`…`---` block is touched; the body is left byte-for-byte.
+ * Throws if there is no frontmatter or no `name:` line — the caller names the file.
+ */
+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.
+ */
+export declare function zipDir(rootDir: string, folderName: string): Promise<Buffer>;

package/dist/skillZip.js

@@ -0,0 +1,64 @@
+import { readdirSync, readFileSync } from "node:fs";
+import { extname, join, relative, sep } from "node:path";
+import JSZip from "jszip";
+const FRONTMATTER = /^---\n([\s\S]*?)\n---/;
+const NAME_LINE = /^name:[ \t]*.*$/m;
+/**
+ * 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.
+ * Only the leading `---`…`---` block is touched; the body is left byte-for-byte.
+ * Throws if there is no frontmatter or no `name:` line — the caller names the file.
+ */
+export function renameSkill(md, name) {
+    const block = md.match(FRONTMATTER);
+    if (!block)
+        throw new Error("skill.md has no YAML frontmatter block");
+    if (!NAME_LINE.test(block[1]))
+        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.
+ */
+export async function zipDir(rootDir, folderName) {
+    const zip = new JSZip();
+    const folder = zip.folder(folderName);
+    if (!folder)
+        throw new Error(`Failed to create zip folder: ${folderName}`);
+    let count = 0;
+    const walk = (dir) => {
+        const atRoot = dir === rootDir;
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name.startsWith("."))
+                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++;
+            }
+        }
+    };
+    walk(rootDir);
+    if (count === 0)
+        throw new Error(`No files to zip in directory: ${rootDir}`);
+    return zip.generateAsync({ type: "nodebuffer" });
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@tycoworks/tycoslide",
-  "version": "0.9.0",
+  "version": "0.10.1",
+  "description": "Create editable, on-brand PowerPoint slides from markdown.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -25,6 +26,7 @@
     "@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",
     "pptx-automizer": "^0.8.2",
@@ -39,7 +41,6 @@
   "devDependencies": {
     "@biomejs/biome": "^2.5.1",
     "@types/node": "^22.20.0",
-    "jszip": "^3.10.1",
     "typescript": "^5.8.0"
   }
 }

package/syntax.md

@@ -238,7 +238,7 @@ notes: |
 ---
 ```
 
-To build with all speaker notes omitted, pass `--no-notes` to `tycoslide build` (see [README](README.md#cli)).
+To build with all speaker notes omitted, pass `--no-notes` to `npx tycoslide build` (see [README](README.md#cli)).
 
 ---