@tycoworks/tycoslide 0.10.0 → 0.10.1

package/README.md

@@ -50,7 +50,7 @@ npx tycoslide build deck.md               # → deck.pptx
 ```bash
 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             # generate the Agent Skill (skill.md, syntax.md, manifest.json at the theme root) + an uploadable <package-name>.zip
+npx tycoslide package             # regenerate skill.md/syntax.md/manifest.json + zip the whole theme into a self-contained <package-name>.zip
 ```
 
 ## Theme Structure

package/dist/cli.js

@@ -5,7 +5,7 @@ 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, zipSkill } from "./skillZip.js";
+import { renameSkill, zipDir } from "./skillZip.js";
 const DEFAULT_CONFIG = "theme.json";
 const MANIFEST_FILE = "manifest.json";
 // The theme skill is written as lowercase skill.md (copied from tycoslide's own
@@ -76,13 +76,10 @@ program
     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`;
-    const zipBuf = await zipSkill(skillName, [
-        { name: SKILL_FILE, content: skillMd },
-        { name: SYNTAX_FILE, content: syntaxMd },
-        { name: MANIFEST_FILE, content: manifestJson },
-    ]);
-    writeFileSync(resolve(process.cwd(), zipFile), zipBuf);
+    writeFileSync(resolve(process.cwd(), zipFile), await zipDir(process.cwd(), skillName));
     console.log(`WROTE ${zipFile}`);
 });
 await program.parseAsync(process.argv);

package/dist/skillZip.d.ts

@@ -6,12 +6,12 @@
  */
 export declare function renameSkill(md: string, name: string): string;
 /**
- * Build an uploadable Agent Skill zip whose entries live under a single root
- * folder (e.g. `mz-slides/skill.md`), matching Anthropic's custom-skill format.
- * Each entry is written from an explicit in-memory list rather than a directory
- * scan, so the zip contains exactly the files the caller passes — nothing else.
+ * 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 zipSkill(folderName: string, files: {
-    name: string;
-    content: string | Buffer;
-}[]): Promise<Buffer>;
+export declare function zipDir(rootDir: string, folderName: string): Promise<Buffer>;

package/dist/skillZip.js

@@ -1,3 +1,5 @@
+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;
@@ -15,21 +17,48 @@ 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"]);
 /**
- * Build an uploadable Agent Skill zip whose entries live under a single root
- * folder (e.g. `mz-slides/skill.md`), matching Anthropic's custom-skill format.
- * Each entry is written from an explicit in-memory list rather than a directory
- * scan, so the zip contains exactly the files the caller passes — nothing else.
+ * 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 zipSkill(folderName, files) {
-    if (files.length === 0)
-        throw new Error(`No files to zip for skill folder: ${folderName}`);
+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}`);
-    for (const file of files) {
-        folder.file(file.name, file.content);
-    }
+    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,6 @@
 {
   "name": "@tycoworks/tycoslide",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Create editable, on-brand PowerPoint slides from markdown.",
   "type": "module",
   "main": "dist/index.js",