@cuppacue/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CuppaTech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# CuppaCue CLI
+
+Developer-first presentation tool — turn markdown into animated slides.
+
+*"Right on cue."*
+
+## Quick Start
+
+```bash
+# Create a new presentation
+cuppacue init my-talk
+
+# Build to .cup file
+cuppacue build slides.md
+
+# Start dev server with hot reload
+cuppacue serve slides.md
+
+# Export to standalone HTML
+cuppacue export slides.cup --out talk.html
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `init [name]` | Create a new presentation project |
+| `build <file.md>` | Compile markdown to `.cup` file |
+| `serve <file>` | Dev server with hot reload |
+| `validate <file>` | Validate a presentation |
+| `export <file>` | Export as HTML or PDF |
+| `ai <prompt>` | Generate a presentation with AI |
+| `preview <url>` | Preview a GitHub README (experimental) |
+
+## The `.cup` Format
+
+A `.cup` file is a ZIP archive containing:
+
+```
+presentation.cup
+├── manifest.json    # Metadata (title, author, scene count)
+├── content.json     # Scenes and elements
+├── timesheet.json   # Animation timeline
+└── theme.json       # Colors, fonts, typography
+```
+
+## Markdown Authoring
+
+Write slides in markdown with `---` separators:
+
+```markdown
+---
+title: My Talk
+author: Jane
+theme: dark
+---
+
+# Welcome
+
+### A presentation built with CuppaCue
+
+---
+
+## Key Points
+
+- Markdown-first authoring
+- Timeline-driven animations
+- AI-powered generation
+
+---
+
+## Code Example
+
+` ` `typescript
+function greet(name: string) {
+  return `Hello, ${name}!`;
+}
+` ` `
+```
+
+## Requirements
+
+- Node.js >= 20
+- Optional: `playwright` for PDF export
+- Optional: Anthropic API key for AI generation

package/dist/ai/__tests__/generate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate.test.d.ts.map

package/dist/ai/__tests__/generate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.test.d.ts","sourceRoot":"","sources":["../../../src/ai/__tests__/generate.test.ts"],"names":[],"mappings":""}

package/dist/ai/__tests__/generate.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from "vitest";
+import { DEFAULT_THEME } from "@cuppacue/format";
+import { extractJson, autoFix } from "../generate.js";
+// We test extractJson and autoFix directly (no API calls needed).
+// The generate() function itself is tested via integration tests.
+function validCupData() {
+    return {
+        manifest: { version: 1, title: "Test", sceneCount: 1 },
+        content: {
+            scenes: [
+                {
+                    id: "s1",
+                    elements: [
+                        { id: "e1", type: "text", content: "Hello", role: "title" },
+                    ],
+                },
+            ],
+        },
+        timesheet: {
+            timeline: [
+                {
+                    sceneId: "s1",
+                    duration: 3000,
+                    events: [{ elementId: "e1", animation: "fadeIn", at: 0 }],
+                },
+            ],
+        },
+        theme: { ...DEFAULT_THEME },
+    };
+}
+describe("extractJson", () => {
+    it("extracts JSON from markdown code fences", () => {
+        const response = '```json\n{"manifest": {"title": "Test"}}\n```';
+        const result = extractJson(response);
+        expect(JSON.parse(result)).toEqual({ manifest: { title: "Test" } });
+    });
+    it("extracts JSON from fences without language tag", () => {
+        const response = '```\n{"key": "value"}\n```';
+        const result = extractJson(response);
+        expect(JSON.parse(result)).toEqual({ key: "value" });
+    });
+    it("extracts bare JSON object", () => {
+        const response = '{"manifest": {"title": "Hello"}}';
+        const result = extractJson(response);
+        expect(JSON.parse(result)).toEqual({ manifest: { title: "Hello" } });
+    });
+    it("handles surrounding text around JSON", () => {
+        const response = 'Here is your presentation:\n{"manifest": {"title": "Test"}}\nHope you like it!';
+        const result = extractJson(response);
+        expect(JSON.parse(result)).toEqual({ manifest: { title: "Test" } });
+    });
+    it("prefers code fence over bare JSON", () => {
+        const response = 'Some text {"bad": true}\n```json\n{"good": true}\n```\nMore text';
+        const result = extractJson(response);
+        expect(JSON.parse(result)).toEqual({ good: true });
+    });
+});
+describe("autoFix", () => {
+    it("fixes incorrect sceneCount", () => {
+        const data = validCupData();
+        data.manifest.sceneCount = 99;
+        const cup = autoFix(data);
+        expect(cup.manifest.sceneCount).toBe(1);
+    });
+    it("adds missing element IDs", () => {
+        const data = validCupData();
+        data.content.scenes[0].elements[0].id = "";
+        const cup = autoFix(data);
+        expect(cup.content.scenes[0].elements[0].id).toBeTruthy();
+    });
+    it("adds missing scene IDs", () => {
+        const data = validCupData();
+        data.content.scenes[0].id = "";
+        const cup = autoFix(data);
+        expect(cup.content.scenes[0].id).toBeTruthy();
+    });
+    it("regenerates timesheet on invalid timeline", () => {
+        const data = validCupData();
+        // Invalid: reference to non-existent element
+        data.timesheet.timeline[0].events[0].elementId = "nonexistent";
+        const cup = autoFix(data);
+        // After autoFix, timesheet should reference the actual element
+        expect(cup.timesheet.timeline[0].events[0].elementId).toBe("e1");
+    });
+    it("preserves valid timesheet", () => {
+        const data = validCupData();
+        const originalDuration = data.timesheet.timeline[0].duration;
+        const cup = autoFix(data);
+        expect(cup.timesheet.timeline[0].duration).toBe(originalDuration);
+    });
+    it("adds layout to scenes without one", () => {
+        const data = validCupData();
+        // Scene has a single title element, no layout set → infers "intro"
+        const cup = autoFix(data);
+        expect(cup.content.scenes[0].layout).toBeDefined();
+        expect(cup.content.scenes[0].layout).toBe("intro");
+    });
+    it("preserves existing layout", () => {
+        const data = validCupData();
+        data.content.scenes[0].layout = "header-body";
+        const cup = autoFix(data);
+        expect(cup.content.scenes[0].layout).toBe("header-body");
+    });
+    it("marks placeholder images as placeholder: true", () => {
+        const data = validCupData();
+        data.content.scenes[0].elements.push({
+            id: "img1",
+            type: "image",
+            src: "placeholder",
+            alt: "test image",
+        });
+        const cup = autoFix(data);
+        const img = cup.content.scenes[0].elements.find((e) => e.type === "image");
+        expect(img.placeholder).toBe(true);
+    });
+    it("does not mark valid URL images as placeholder", () => {
+        const data = validCupData();
+        data.content.scenes[0].elements.push({
+            id: "img1",
+            type: "image",
+            src: "https://example.com/photo.jpg",
+            alt: "real photo",
+        });
+        const cup = autoFix(data);
+        const img = cup.content.scenes[0].elements.find((e) => e.type === "image");
+        expect(img.placeholder).toBeUndefined();
+    });
+});
+//# sourceMappingURL=generate.test.js.map

package/dist/ai/__tests__/generate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.test.js","sourceRoot":"","sources":["../../../src/ai/__tests__/generate.test.ts"],"names":[],"mappings":"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"}

package/dist/ai/__tests__/images.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=images.test.d.ts.map

package/dist/ai/__tests__/images.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.test.d.ts","sourceRoot":"","sources":["../../../src/ai/__tests__/images.test.ts"],"names":[],"mappings":""}

package/dist/ai/__tests__/images.test.js

@@ -0,0 +1,186 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { resolveImages } from "../images.js";
+import { DEFAULT_THEME } from "@cuppacue/format";
+function makeCup(elements) {
+    return {
+        manifest: { version: 1, title: "Test", sceneCount: 1 },
+        content: {
+            scenes: [
+                {
+                    id: "s1",
+                    elements: elements,
+                },
+            ],
+        },
+        timesheet: {
+            timeline: [
+                {
+                    sceneId: "s1",
+                    duration: 3000,
+                    events: [],
+                },
+            ],
+        },
+        theme: { ...DEFAULT_THEME },
+    };
+}
+function placeholderImage(overrides = {}) {
+    return {
+        id: "img1",
+        type: "image",
+        src: "placeholder",
+        alt: "modern server room",
+        placeholder: true,
+        ...overrides,
+    };
+}
+describe("resolveImages", () => {
+    const savedPexels = process.env.PEXELS_API_KEY;
+    const savedUnsplash = process.env.UNSPLASH_ACCESS_KEY;
+    beforeEach(() => {
+        delete process.env.PEXELS_API_KEY;
+        delete process.env.UNSPLASH_ACCESS_KEY;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        if (savedPexels !== undefined) {
+            process.env.PEXELS_API_KEY = savedPexels;
+        }
+        else {
+            delete process.env.PEXELS_API_KEY;
+        }
+        if (savedUnsplash !== undefined) {
+            process.env.UNSPLASH_ACCESS_KEY = savedUnsplash;
+        }
+        else {
+            delete process.env.UNSPLASH_ACCESS_KEY;
+        }
+    });
+    it("returns unchanged cup when no placeholders exist", async () => {
+        const cup = makeCup([
+            {
+                id: "img1",
+                type: "image",
+                src: "https://example.com/photo.jpg",
+                alt: "a photo",
+            },
+        ]);
+        const before = JSON.stringify(cup);
+        await resolveImages(cup);
+        expect(JSON.stringify(cup)).toBe(before);
+    });
+    it("skips resolution when no API key is set", async () => {
+        const cup = makeCup([placeholderImage()]);
+        const spy = vi.spyOn(globalThis, "fetch");
+        await resolveImages(cup);
+        expect(spy).not.toHaveBeenCalled();
+        expect(cup.content.scenes[0].elements[0]
+            .placeholder).toBe(true);
+    });
+    it("keeps placeholder on fetch failure", async () => {
+        process.env.PEXELS_API_KEY = "test-key";
+        const cup = makeCup([placeholderImage({ alt: "abstract art" })]);
+        vi.spyOn(globalThis, "fetch").mockRejectedValue(new Error("Network error"));
+        await resolveImages(cup);
+        const img = cup.content.scenes[0].elements[0];
+        expect(img.placeholder).toBe(true);
+        expect(img.src).toBe("placeholder");
+    });
+    it("skips non-placeholder images", async () => {
+        process.env.PEXELS_API_KEY = "test-key";
+        const cup = makeCup([
+            {
+                id: "img1",
+                type: "image",
+                src: "https://example.com/real.jpg",
+                alt: "a real photo",
+            },
+            placeholderImage({ id: "img2", alt: "placeholder photo" }),
+        ]);
+        vi.spyOn(globalThis, "fetch").mockResolvedValue({
+            ok: true,
+            json: async () => ({
+                photos: [{ src: { large2x: "https://images.pexels.com/resolved" } }],
+            }),
+        });
+        await resolveImages(cup);
+        const img1 = cup.content.scenes[0].elements[0];
+        const img2 = cup.content.scenes[0].elements[1];
+        expect(img1.src).toBe("https://example.com/real.jpg");
+        expect(img2.src).toBe("https://images.pexels.com/resolved");
+    });
+    describe("Pexels provider", () => {
+        it("resolves placeholder images via Pexels API", async () => {
+            process.env.PEXELS_API_KEY = "pexels-key";
+            const cup = makeCup([placeholderImage()]);
+            vi.spyOn(globalThis, "fetch").mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    photos: [{ src: { large2x: "https://images.pexels.com/photo-456" } }],
+                }),
+            });
+            await resolveImages(cup);
+            const img = cup.content.scenes[0].elements[0];
+            expect(img.src).toBe("https://images.pexels.com/photo-456");
+            expect(img.placeholder).toBe(false);
+        });
+        it("calls Pexels API with correct Authorization header", async () => {
+            process.env.PEXELS_API_KEY = "my-pexels-key";
+            const cup = makeCup([placeholderImage()]);
+            const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    photos: [{ src: { large2x: "https://images.pexels.com/img.jpg" } }],
+                }),
+            });
+            await resolveImages(cup);
+            expect(fetchSpy).toHaveBeenCalledWith(expect.stringContaining("api.pexels.com"), expect.objectContaining({
+                headers: { Authorization: "my-pexels-key" },
+            }));
+        });
+        it("prefers Pexels over Unsplash when both keys are set", async () => {
+            process.env.PEXELS_API_KEY = "pexels-key";
+            process.env.UNSPLASH_ACCESS_KEY = "unsplash-key";
+            const cup = makeCup([placeholderImage()]);
+            const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    photos: [{ src: { large2x: "https://images.pexels.com/photo.jpg" } }],
+                }),
+            });
+            await resolveImages(cup);
+            expect(fetchSpy).toHaveBeenCalledWith(expect.stringContaining("pexels.com"), expect.any(Object));
+        });
+    });
+    describe("Unsplash provider", () => {
+        it("resolves placeholder images via Unsplash API", async () => {
+            process.env.UNSPLASH_ACCESS_KEY = "unsplash-key";
+            const cup = makeCup([placeholderImage()]);
+            vi.spyOn(globalThis, "fetch").mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    results: [{ urls: { regular: "https://images.unsplash.com/photo-123" } }],
+                }),
+            });
+            await resolveImages(cup);
+            const img = cup.content.scenes[0].elements[0];
+            expect(img.src).toBe("https://images.unsplash.com/photo-123");
+            expect(img.placeholder).toBe(false);
+        });
+        it("calls Unsplash API with correct Authorization header", async () => {
+            process.env.UNSPLASH_ACCESS_KEY = "my-unsplash-key";
+            const cup = makeCup([placeholderImage()]);
+            const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue({
+                ok: true,
+                json: async () => ({
+                    results: [{ urls: { regular: "https://example.com/img.jpg" } }],
+                }),
+            });
+            await resolveImages(cup);
+            expect(fetchSpy).toHaveBeenCalledWith(expect.stringContaining("unsplash.com"), expect.objectContaining({
+                headers: { Authorization: "Client-ID my-unsplash-key" },
+            }));
+        });
+    });
+});
+//# sourceMappingURL=images.test.js.map

package/dist/ai/__tests__/images.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.test.js","sourceRoot":"","sources":["../../../src/ai/__tests__/images.test.ts"],"names":[],"mappings":"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"}

package/dist/ai/__tests__/prompt.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt.test.d.ts.map

package/dist/ai/__tests__/prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.test.d.ts","sourceRoot":"","sources":["../../../src/ai/__tests__/prompt.test.ts"],"names":[],"mappings":""}

package/dist/ai/__tests__/prompt.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect } from "vitest";
+import { buildGeneratePrompt, buildRefinePrompt } from "../prompt.js";
+import { FORMAT_SCHEMA } from "../schema.js";
+import { EXAMPLE_CUPFILE } from "../example.js";
+import { DEFAULT_THEME } from "@cuppacue/format";
+function validCupFile() {
+    return {
+        manifest: { version: 1, title: "Test", sceneCount: 1 },
+        content: {
+            scenes: [
+                {
+                    id: "s1",
+                    elements: [{ id: "e1", type: "text", content: "Hello" }],
+                },
+            ],
+        },
+        timesheet: {
+            timeline: [
+                {
+                    sceneId: "s1",
+                    duration: 3000,
+                    events: [{ elementId: "e1", animation: "fadeIn", at: 0 }],
+                },
+            ],
+        },
+        theme: { ...DEFAULT_THEME },
+    };
+}
+describe("buildGeneratePrompt", () => {
+    it("includes format schema in system prompt", () => {
+        const { system } = buildGeneratePrompt("test prompt");
+        expect(system).toContain(FORMAT_SCHEMA);
+    });
+    it("includes example CupFile in system prompt", () => {
+        const { system } = buildGeneratePrompt("test prompt");
+        expect(system).toContain(EXAMPLE_CUPFILE);
+    });
+    it("includes user text in user prompt", () => {
+        const { user } = buildGeneratePrompt("Explain OAuth 2.0");
+        expect(user).toContain("Explain OAuth 2.0");
+    });
+    it("includes source content when provided", () => {
+        const { user } = buildGeneratePrompt("make a talk", "# My Notes\nSome content");
+        expect(user).toContain("make a talk");
+        expect(user).toContain("# My Notes\nSome content");
+    });
+    it("omits source content section when not provided", () => {
+        const { user } = buildGeneratePrompt("just a prompt");
+        expect(user).toBe("just a prompt");
+    });
+});
+describe("buildRefinePrompt", () => {
+    it("includes current CupFile JSON in user prompt", () => {
+        const cup = validCupFile();
+        const { user } = buildRefinePrompt(cup, "add a slide");
+        expect(user).toContain('"title": "Test"');
+        expect(user).toContain('"sceneCount": 1');
+    });
+    it("includes refinement instruction in user prompt", () => {
+        const cup = validCupFile();
+        const { user } = buildRefinePrompt(cup, "add a code example to slide 3");
+        expect(user).toContain("add a code example to slide 3");
+    });
+    it("includes format schema in system prompt", () => {
+        const cup = validCupFile();
+        const { system } = buildRefinePrompt(cup, "change something");
+        expect(system).toContain(FORMAT_SCHEMA);
+    });
+});
+describe("prompt guidelines", () => {
+    it("generate prompt includes image guidelines", () => {
+        const { system } = buildGeneratePrompt("test");
+        expect(system).toContain("placeholder");
+        expect(system).toContain("ImageElements");
+    });
+    it("generate prompt includes references guidelines", () => {
+        const { system } = buildGeneratePrompt("test");
+        expect(system).toContain("References");
+        expect(system).toContain("Learn More");
+    });
+    it("refine prompt includes image guidance", () => {
+        const cup = validCupFile();
+        const { system } = buildRefinePrompt(cup, "test");
+        expect(system).toContain("placeholder");
+    });
+    it("generate prompt includes typography guidelines", () => {
+        const { system } = buildGeneratePrompt("test");
+        expect(system).toContain("Typography");
+        expect(system).toContain("elegant");
+        expect(system).toContain("minimal");
+        expect(system).toContain("bold");
+    });
+    it("generate prompt recommends revealDown for code", () => {
+        const { system } = buildGeneratePrompt("test");
+        expect(system).toContain("revealDown for code");
+    });
+});
+//# sourceMappingURL=prompt.test.js.map

package/dist/ai/__tests__/prompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.test.js","sourceRoot":"","sources":["../../../src/ai/__tests__/prompt.test.ts"],"names":[],"mappings":"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"}

package/dist/ai/__tests__/refine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=refine.test.d.ts.map

package/dist/ai/__tests__/refine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine.test.d.ts","sourceRoot":"","sources":["../../../src/ai/__tests__/refine.test.ts"],"names":[],"mappings":""}