@tycoworks/bon 0.1.0 → 0.1.2

package/SKILL.md

@@ -9,6 +9,18 @@ description: >
 
 # slides
 
+## Setup
+
+Before first use, install dependencies from the plugin root:
+
+```bash
+npm install
+```
+
+This installs the bon engine and its dependencies. You only need to do this once.
+
+## Overview
+
 This skill builds on-brand decks from a deck file. The theme provides slide layouts that control design. Your job: pick the right layouts, fill them with content, and build. You never restyle the layout; the engine clones the real slides, so brand, layout, fonts, and chrome come for free.
 
 For brand voice and naming guidelines, read `brand.md` if it exists alongside this skill.
@@ -89,7 +101,7 @@ Build:
 
 ```bash
 # Run the command from manifest.json's build.command
-# e.g.: node src/run-spec.ts deck.json my-deck.pptx
+# e.g.: npx bon build deck.json
 ```
 
 The deck is written to your current working directory (not inside the skill).
@@ -137,7 +149,7 @@ Your first draft almost never comes out clean. Approach QA as a debugging sessio
 Run the command from `manifest.json`'s `build.command`:
 
 ```bash
-# e.g.: node src/run-spec.ts deck.json my-deck.pptx
+# e.g.: npx bon build deck.json
 ```
 
 Read output carefully. Common errors and fixes:
@@ -210,7 +222,7 @@ If the subagent finds issues, fix them and rebuild.
 
 ```bash
 # Build a deck (use command from manifest.json's build.command)
-# e.g.: node src/run-spec.ts deck.json my-deck.pptx
+# e.g.: npx bon build deck.json
 
 # Render to images for visual QA
 soffice --headless --convert-to pdf --outdir . <deck>.pptx

package/bin/bon.js

@@ -1,2 +1,2 @@
-#!/usr/bin/env node --experimental-strip-types --no-warnings
-import("../src/cli.ts");
+#!/usr/bin/env node
+import("../dist/cli.js");

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -0,0 +1,92 @@
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { generate } from "@tycoworks/bon-core";
+import { Command } from "commander";
+import { generateManifest } from "./manifest.js";
+import { smokeSteps } from "./smoke.js";
+const DEFAULT_CONFIG = "theme.config.ts";
+const DEFAULT_SMOKE_OUTPUT = "smoke-all.pptx";
+const SKILL_DIR = "skills/slides";
+const MANIFEST_FILE = "manifest.json";
+const SKILL_FILE = "SKILL.md";
+const BUILD_COMMAND = "npx bon build";
+const sdkDir = dirname(fileURLToPath(import.meta.url));
+const skillMdPath = resolve(sdkDir, "..", SKILL_FILE);
+async function loadConfig(configPath) {
+    const abs = resolve(process.cwd(), configPath);
+    let mod;
+    try {
+        mod = await import(abs);
+    }
+    catch {
+        throw new Error(`Config file not found: ${configPath}`);
+    }
+    const raw = (mod.default ?? mod.config);
+    if (!raw) {
+        throw new Error(`${configPath} must export a default or named "config" of type ThemeConfig`);
+    }
+    return { ...raw, rootDir: dirname(abs) };
+}
+const program = new Command().name("bon").description("PPTX template engine CLI").version("0.1.0");
+program
+    .command("build")
+    .description("Build a PPTX deck from a JSON spec")
+    .argument("<deck>", "path to deck JSON file")
+    .argument("[output]", "output PPTX filename")
+    .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
+    .action(async (deckPath, output, opts) => {
+    const config = await loadConfig(opts.config);
+    let deck;
+    try {
+        const raw = readFileSync(resolve(process.cwd(), deckPath), "utf-8");
+        deck = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to read deck file: ${deckPath} (${err.message})`);
+    }
+    if (output)
+        deck.output = output;
+    await generate(deck, config);
+});
+program
+    .command("manifest")
+    .description("Generate manifest.json from theme config")
+    .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 = await loadConfig(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}`);
+    }
+    else {
+        process.stdout.write(`${json}\n`);
+    }
+});
+program
+    .command("smoke")
+    .description("Generate one smoke-test slide per layout")
+    .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
+    .option(`-o, --out <file>`, "output PPTX filename", DEFAULT_SMOKE_OUTPUT)
+    .action(async (opts) => {
+    const config = await loadConfig(opts.config);
+    const steps = smokeSteps(config);
+    await generate({ output: opts.out, steps }, config);
+});
+program
+    .command("plugin")
+    .description("Generate plugin package (manifest.json + SKILL.md) for AI agents")
+    .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
+    .action(async (opts) => {
+    const config = await loadConfig(opts.config);
+    const outDir = resolve(process.cwd(), SKILL_DIR);
+    mkdirSync(outDir, { recursive: true });
+    const json = generateManifest(config, { build: { command: BUILD_COMMAND } });
+    writeFileSync(resolve(outDir, MANIFEST_FILE), `${json}\n`);
+    console.log(`WROTE ${SKILL_DIR}/${MANIFEST_FILE}`);
+    copyFileSync(skillMdPath, resolve(outDir, SKILL_FILE));
+    console.log(`WROTE ${SKILL_DIR}/${SKILL_FILE}`);
+});
+await program.parseAsync(process.argv);

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import type { ThemeConfig } from "@tycoworks/bon-core";
+export declare function defineConfig(config: ThemeConfig): ThemeConfig;

package/dist/config.js

@@ -0,0 +1,3 @@
+export function defineConfig(config) {
+    return config;
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { AssetCatalog, AssetEntry, AssetSlot, Config, ContentSlot, Deck, DeckStep, Layout, ParagraphSelector, ThemeConfig, } from "@tycoworks/bon-core";
+export { AssetType, Fit, generate, SlotType } from "@tycoworks/bon-core";
+export { defineConfig } from "./config.js";
+export type { ManifestOptions } from "./manifest.js";
+export { generateManifest } from "./manifest.js";
+export { smokeSteps } from "./smoke.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { AssetType, Fit, generate, SlotType } from "@tycoworks/bon-core";
+export { defineConfig } from "./config.js";
+export { generateManifest } from "./manifest.js";
+export { smokeSteps } from "./smoke.js";

package/dist/manifest.d.ts

@@ -0,0 +1,7 @@
+import type { Config } from "@tycoworks/bon-core";
+export type ManifestOptions = {
+    build?: {
+        command: string;
+    };
+};
+export declare function generateManifest(config: Config, options?: ManifestOptions): string;

package/dist/manifest.js

@@ -0,0 +1,53 @@
+function stripContentSlot(slot) {
+    const result = { key: slot.key, type: slot.type };
+    if (slot.limit) {
+        result.limit = slot.limit;
+    }
+    return result;
+}
+function stripAssetSlot(slot) {
+    const result = { key: slot.key, accepts: slot.accepts };
+    if (slot.required) {
+        result.required = true;
+    }
+    return result;
+}
+export function generateManifest(config, options) {
+    const layouts = config.layouts.map((layout) => ({
+        name: layout.name,
+        description: layout.description,
+        whenToUse: layout.whenToUse,
+        whenNotToUse: layout.whenNotToUse,
+        contentSlots: layout.contentSlots.map(stripContentSlot),
+        assetSlots: (layout.assetSlots ?? []).map(stripAssetSlot),
+    }));
+    const assets = {};
+    for (const [category, entries] of Object.entries(config.assets)) {
+        assets[category] = {};
+        for (const [name, entry] of Object.entries(entries)) {
+            const manifestEntry = {
+                path: entry.path,
+                type: entry.type,
+                description: entry.description,
+            };
+            if (entry.whenToUse) {
+                manifestEntry.whenToUse = entry.whenToUse;
+            }
+            assets[category][name] = manifestEntry;
+        }
+    }
+    const manifest = {
+        version: 1,
+        layouts,
+        assets,
+        build: {
+            command: options?.build?.command ?? "npx bon build",
+            deckFormat: "json",
+            deckSchema: {
+                output: "string",
+                steps: "array of { layout, content, assets }",
+            },
+        },
+    };
+    return JSON.stringify(manifest, null, 2);
+}

package/dist/smoke.d.ts

@@ -0,0 +1,2 @@
+import type { Config, DeckStep } from "@tycoworks/bon-core";
+export declare function smokeSteps(config: Config): DeckStep[];

package/dist/smoke.js

@@ -0,0 +1,36 @@
+import { SlotType } from "@tycoworks/bon-core";
+function pickAsset(config, slot) {
+    for (const group of Object.values(config.assets)) {
+        for (const entry of Object.values(group)) {
+            if (entry.type === slot.accepts)
+                return entry.path;
+        }
+    }
+    return undefined;
+}
+export function smokeSteps(config) {
+    return config.layouts.map((layout) => {
+        const content = {};
+        for (const s of layout.contentSlots) {
+            if (s.type === SlotType.Prose) {
+                content[s.key] = ["Sample intro line for this block.", "- First point", "- Second point"];
+            }
+            else if (s.type === SlotType.Lines) {
+                content[s.key] = ["Sample Name", "Sample Role, Company"];
+            }
+            else if (s.key.includes("value")) {
+                content[s.key] = "42%";
+            }
+            else {
+                content[s.key] = `Sample ${s.key.replace(/_/g, " ")}`;
+            }
+        }
+        const assets = {};
+        for (const a of layout.assetSlots ?? []) {
+            const path = pickAsset(config, a);
+            if (path)
+                assets[a.key] = path;
+        }
+        return { layout: layout.name, content, assets };
+    });
+}

package/package.json

@@ -1,16 +1,19 @@
 {
   "name": "@tycoworks/bon",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
-  "main": "src/index.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
     "bon": "bin/bon.js"
   },
+  "files": ["dist", "bin", "SKILL.md"],
   "scripts": {
+    "build": "tsc --build",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@tycoworks/bon-core": "^0.1.0",
+    "@tycoworks/bon-core": "^0.1.1",
     "commander": "^15.0.0"
   },
   "devDependencies": {

package/src/cli.ts

@@ -1,98 +0,0 @@
-import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import type { Config, ThemeConfig } from "@tycoworks/bon-core";
-import { generate } from "@tycoworks/bon-core";
-import { Command } from "commander";
-import { generateManifest } from "./manifest.ts";
-import { smokeSteps } from "./smoke.ts";
-
-const DEFAULT_CONFIG = "theme.config.ts";
-const DEFAULT_SMOKE_OUTPUT = "smoke-all.pptx";
-const SKILL_DIR = "skills/slides";
-const MANIFEST_FILE = "manifest.json";
-const SKILL_FILE = "SKILL.md";
-const BUILD_COMMAND = "npx bon build";
-
-const sdkDir = dirname(fileURLToPath(import.meta.url));
-const skillMdPath = resolve(sdkDir, "..", SKILL_FILE);
-
-async function loadConfig(configPath: string): Promise<Config> {
-  const abs = resolve(process.cwd(), configPath);
-  let mod: Record<string, unknown>;
-  try {
-    mod = await import(abs);
-  } catch {
-    throw new Error(`Config file not found: ${configPath}`);
-  }
-  const raw = (mod.default ?? mod.config) as ThemeConfig | undefined;
-  if (!raw) {
-    throw new Error(`${configPath} must export a default or named "config" of type ThemeConfig`);
-  }
-  return { ...raw, rootDir: dirname(abs) };
-}
-
-const program = new Command().name("bon").description("PPTX template engine CLI").version("0.1.0");
-
-program
-  .command("build")
-  .description("Build a PPTX deck from a JSON spec")
-  .argument("<deck>", "path to deck JSON file")
-  .argument("[output]", "output PPTX filename")
-  .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
-  .action(async (deckPath: string, output: string | undefined, opts: { config: string }) => {
-    const config = await loadConfig(opts.config);
-    let deck: Record<string, unknown>;
-    try {
-      const raw = readFileSync(resolve(process.cwd(), deckPath), "utf-8");
-      deck = JSON.parse(raw);
-    } catch (err) {
-      throw new Error(`Failed to read deck file: ${deckPath} (${(err as Error).message})`);
-    }
-    if (output) deck.output = output;
-    await generate(deck as any, config);
-  });
-
-program
-  .command("manifest")
-  .description("Generate manifest.json from theme config")
-  .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
-  .option(`-o, --out <file>`, "write to file instead of stdout")
-  .action(async (opts: { config: string; out?: string }) => {
-    const config = await loadConfig(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}`);
-    } else {
-      process.stdout.write(`${json}\n`);
-    }
-  });
-
-program
-  .command("smoke")
-  .description("Generate one smoke-test slide per layout")
-  .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
-  .option(`-o, --out <file>`, "output PPTX filename", DEFAULT_SMOKE_OUTPUT)
-  .action(async (opts: { config: string; out: string }) => {
-    const config = await loadConfig(opts.config);
-    const steps = smokeSteps(config);
-    await generate({ output: opts.out, steps }, config);
-  });
-
-program
-  .command("plugin")
-  .description("Generate plugin package (manifest.json + SKILL.md) for AI agents")
-  .option(`-c, --config <path>`, "path to theme config file", DEFAULT_CONFIG)
-  .action(async (opts: { config: string }) => {
-    const config = await loadConfig(opts.config);
-    const outDir = resolve(process.cwd(), SKILL_DIR);
-    mkdirSync(outDir, { recursive: true });
-    const json = generateManifest(config, { build: { command: BUILD_COMMAND } });
-    writeFileSync(resolve(outDir, MANIFEST_FILE), `${json}\n`);
-    console.log(`WROTE ${SKILL_DIR}/${MANIFEST_FILE}`);
-    copyFileSync(skillMdPath, resolve(outDir, SKILL_FILE));
-    console.log(`WROTE ${SKILL_DIR}/${SKILL_FILE}`);
-  });
-
-await program.parseAsync(process.argv);

package/src/config.ts

@@ -1,5 +0,0 @@
-import type { ThemeConfig } from "@tycoworks/bon-core";
-
-export function defineConfig(config: ThemeConfig): ThemeConfig {
-  return config;
-}

package/src/index.ts

@@ -1,17 +0,0 @@
-export type {
-  AssetCatalog,
-  AssetEntry,
-  AssetSlot,
-  Config,
-  ContentSlot,
-  Deck,
-  DeckStep,
-  Layout,
-  ParagraphSelector,
-  ThemeConfig,
-} from "@tycoworks/bon-core";
-export { AssetType, Fit, generate, SlotType } from "@tycoworks/bon-core";
-export { defineConfig } from "./config.ts";
-export type { ManifestOptions } from "./manifest.ts";
-export { generateManifest } from "./manifest.ts";
-export { smokeSteps } from "./smoke.ts";

package/src/manifest.ts

@@ -1,106 +0,0 @@
-import type { Config } from "@tycoworks/bon-core";
-
-export type ManifestOptions = {
-  build?: { command: string };
-};
-
-type ManifestContentSlot = {
-  key: string;
-  type: string;
-  limit?: { maxChars?: number; maxLines?: number; maxItems?: number };
-};
-
-type ManifestAssetSlot = {
-  key: string;
-  accepts: string;
-  required?: true;
-};
-
-type ManifestLayout = {
-  name: string;
-  description: string;
-  whenToUse: string;
-  whenNotToUse: string;
-  contentSlots: ManifestContentSlot[];
-  assetSlots: ManifestAssetSlot[];
-};
-
-type ManifestAssetEntry = {
-  path: string;
-  type: string;
-  description: string;
-  whenToUse?: string;
-};
-
-type Manifest = {
-  version: 1;
-  layouts: ManifestLayout[];
-  assets: Record<string, Record<string, ManifestAssetEntry>>;
-  build: {
-    command: string;
-    deckFormat: "json";
-    deckSchema: {
-      output: "string";
-      steps: "array of { layout, content, assets }";
-    };
-  };
-};
-
-function stripContentSlot(slot: { key: string; type: string; limit?: object }): ManifestContentSlot {
-  const result: ManifestContentSlot = { key: slot.key, type: slot.type };
-  if (slot.limit) {
-    result.limit = slot.limit;
-  }
-  return result;
-}
-
-function stripAssetSlot(slot: { key: string; accepts: string; required?: boolean }): ManifestAssetSlot {
-  const result: ManifestAssetSlot = { key: slot.key, accepts: slot.accepts };
-  if (slot.required) {
-    result.required = true;
-  }
-  return result;
-}
-
-export function generateManifest(config: Config, options?: ManifestOptions): string {
-  const layouts: ManifestLayout[] = config.layouts.map((layout) => ({
-    name: layout.name,
-    description: layout.description,
-    whenToUse: layout.whenToUse,
-    whenNotToUse: layout.whenNotToUse,
-    contentSlots: layout.contentSlots.map(stripContentSlot),
-    assetSlots: (layout.assetSlots ?? []).map(stripAssetSlot),
-  }));
-
-  const assets: Record<string, Record<string, ManifestAssetEntry>> = {};
-  for (const [category, entries] of Object.entries(config.assets)) {
-    assets[category] = {};
-    for (const [name, entry] of Object.entries(entries)) {
-      const manifestEntry: ManifestAssetEntry = {
-        path: entry.path,
-        type: entry.type,
-        description: entry.description,
-      };
-      if (entry.whenToUse) {
-        manifestEntry.whenToUse = entry.whenToUse;
-      }
-      assets[category][name] = manifestEntry;
-    }
-  }
-
-  const manifest: Manifest = {
-    version: 1,
-    layouts,
-    assets,
-    build: {
-      command: options?.build?.command ?? "npx bon build",
-      deckFormat: "json",
-      deckSchema: {
-        output: "string",
-        steps: "array of { layout, content, assets }",
-      },
-    },
-  };
-
-  return JSON.stringify(manifest, null, 2);
-}

package/src/smoke.ts

@@ -1,34 +0,0 @@
-import type { Config, DeckStep } from "@tycoworks/bon-core";
-import { SlotType } from "@tycoworks/bon-core";
-
-function pickAsset(config: Config, slot: { key: string; accepts: string }): string | undefined {
-  for (const group of Object.values(config.assets)) {
-    for (const entry of Object.values(group)) {
-      if (entry.type === slot.accepts) return entry.path;
-    }
-  }
-  return undefined;
-}
-
-export function smokeSteps(config: Config): DeckStep[] {
-  return config.layouts.map((layout) => {
-    const content: Record<string, string | string[]> = {};
-    for (const s of layout.contentSlots) {
-      if (s.type === SlotType.Prose) {
-        content[s.key] = ["Sample intro line for this block.", "- First point", "- Second point"];
-      } else if (s.type === SlotType.Lines) {
-        content[s.key] = ["Sample Name", "Sample Role, Company"];
-      } else if (s.key.includes("value")) {
-        content[s.key] = "42%";
-      } else {
-        content[s.key] = `Sample ${s.key.replace(/_/g, " ")}`;
-      }
-    }
-    const assets: Record<string, string> = {};
-    for (const a of layout.assetSlots ?? []) {
-      const path = pickAsset(config, a);
-      if (path) assets[a.key] = path;
-    }
-    return { layout: layout.name, content, assets };
-  });
-}

package/tsconfig.json

@@ -1,19 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "es2022",
-    "lib": ["es2023"],
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "erasableSyntaxOnly": true,
-    "declaration": true,
-    "declarationDir": "dist",
-    "emitDeclarationOnly": true,
-    "strict": true,
-    "skipLibCheck": true,
-    "composite": true
-  },
-  "include": ["src/**/*.ts"],
-  "references": [{ "path": "../core" }]
-}