supadeck 0.0.1

package/README.md

@@ -0,0 +1,338 @@
+# Supadeck
+
+Supadeck is a zero-config presentation toolkit for writing slide decks in MDX. You author your deck in `deck.mdx`, mix Markdown with React components, get a hot-reloading Vite runtime while you edit, pick from built-in themes or bring your own, and export the finished deck to PDF when it is ready to share.
+
+## Quickstart
+
+```bash
+npx supadeck
+```
+
+That single command looks for `deck.mdx` in the current directory, creates `deck.mdx` if it does not exist yet, and starts the local presentation runtime. As you edit the deck or update local components imported from your workspace, the deck reloads immediately.
+
+![Default theme preview](.github/assets/readme/theme-supabase.png)
+
+## Why Supadeck
+
+- Write a deck in one `deck.mdx` file.
+- Mix Markdown, JSX, and local React imports in the same slide deck.
+- Use a themeable runtime instead of a fixed presentation shell.
+- Start with built-in themes and switch with frontmatter or `--theme`.
+- Use GitHub Flavored Markdown features like tables, task lists, and strikethrough.
+- Navigate with the keyboard or directly via slide hashes like `#3`.
+- Export the rendered deck to PDF with one command.
+
+## What's Supported
+
+### Authoring
+
+- Frontmatter-driven deck config: `title`, `theme`, `aspectRatio`, `showSlideNumbers`, `transition`, and `sections`.
+- Slide content written in MDX with JSX support.
+- Optional import prelude after frontmatter for local components and helpers.
+- Slide boundaries defined by thematic breaks (`---`).
+- Built-in MDX components for headings, lists, tables, callouts, layout helpers, and more.
+- GitHub Flavored Markdown through `remark-gfm`, including tables, task lists, and strikethrough.
+
+### Runtime
+
+- Interactive browser presentation runtime powered by Vite and React.
+- Keyboard navigation with `Arrow` keys, `PageUp`, `PageDown`, `Home`, `End`, and `Space`.
+- URL hash navigation so slide state is reflected in the address bar.
+- Theme-controlled deck rendering for both default and custom layouts.
+- Interactive mode for presenting and print mode for export.
+
+### Export
+
+- `supadeck export` builds the deck to HTML first, then prints it to PDF.
+- PDF export uses Playwright Chromium in headless mode.
+- Slide backgrounds are preserved during PDF generation.
+
+### Customization
+
+- Theme selection by built-in id, relative theme file path, or theme directory.
+- Theme-provided MDX component overrides and custom deck layouts.
+- Workspace component imports inside `deck.mdx`.
+- Theme setup hooks for runtime styling and root-level behavior.
+
+## Built-in Themes
+
+Supadeck currently ships with two built-in themes:
+
+| Theme | Best for | What makes it distinct |
+| --- | --- | --- |
+| `default` | Branded product or pitch decks | Custom stage layout, footer breadcrumbs, branded components, and optional section navigation. |
+| `sunset` | Brighter keynote-style decks | Reuses the exported `DefaultDeck` shell with a warmer visual treatment and color palette. |
+
+![Default theme preview](.github/assets/readme/theme-supabase.png)
+![Sunset theme preview](.github/assets/readme/theme-sunset.png)
+
+For the `default` theme, `sections` in frontmatter define 1-based inclusive slide ranges. 
+
+```yaml
+---
+title: supalite
+theme: default
+sections:
+  - label: Intro
+    start: 1
+    end: 1
+  - label: Goals
+    start: 2
+    end: 4
+---
+```
+
+Those ranges are normalized onto the deck and used to render the footer breadcrumb navigation.
+
+![Supabase footer sections preview](.github/assets/readme/supabase-sections.png)
+
+## Quick Deck Authoring
+
+Here is a compact `deck.mdx` that shows the core authoring model: frontmatter, a local React import, theme-provided components, GitHub Flavored Markdown, and a code block.
+
+````mdx
+---
+title: Ship Review
+theme: sunset
+aspectRatio: 16:9
+showSlideNumbers: true
+transition: fade
+---
+
+import ExampleCard from "./ExampleCard.tsx";
+
+# Ship Review
+
+<Callout tone="accent">
+  One file for the whole deck, with local components when you need them.
+</Callout>
+
+<Columns
+  left={
+    <ExampleCard title="Status">
+      Ready for internal review.
+    </ExampleCard>
+  }
+  right={
+    <Disclosure title="Next step">
+      Export a PDF for async feedback.
+    </Disclosure>
+  }
+/>
+
+---
+
+## Rollout snapshot
+
+| Area | Status |
+| --- | --- |
+| Runtime | Ready |
+| Theme | Sunset |
+| Export | PDF |
+
+- [x] Deck authored in MDX
+- [ ] Final rehearsal
+
+```ts
+export function ship() {
+  return "present";
+}
+```
+````
+
+## Deck File Format
+
+Supadeck reads `deck.mdx` using this model:
+
+1. Optional YAML frontmatter at the top defines deck config.
+2. An optional import prelude can come immediately after frontmatter.
+3. Slides are split by thematic breaks written as `---`.
+4. If no slide separators are present, the full file becomes a single slide.
+5. Anything imported in the prelude is available inside slide JSX and MDX.
+
+Slide splitting is syntax-aware. A literal `---` inside fenced code does not create a new slide.
+
+## CLI Reference
+
+### Start a deck in the current directory
+
+```bash
+npx supadeck
+```
+
+Looks for `./deck.mdx` and scaffolds a starter deck unless you pass `--no-create`.
+
+### Start a deck from a workspace directory
+
+```bash
+npx supadeck ./talks/keynote
+```
+
+If the input has no extension, Supadeck resolves it as `./talks/keynote/deck.mdx`.
+
+### Start with overrides
+
+```bash
+npx supadeck ./talks/keynote --theme sunset --open --port 4000
+```
+
+### Export the current deck
+
+```bash
+npx supadeck export
+```
+
+Exports to a PDF next to the input deck. For `deck.mdx`, the default output is `deck.pdf`.
+
+### Export a specific deck to a custom path
+
+```bash
+npx supadeck export ./talks/keynote --output keynote.pdf
+```
+
+Supadeck supports these CLI flags today:
+
+| Flag | Meaning |
+| --- | --- |
+| `--open` | Open the dev server in a browser. |
+| `--no-create` | Skip starter deck scaffolding in dev mode. |
+| `--port <number>` | Choose the Vite dev server port. |
+| `--output <path>` | Choose the PDF output path during export. |
+| `--theme <id-or-path>` | Override the deck theme from the CLI. |
+
+## Custom Components
+
+There are two supported ways to bring custom UI into a deck:
+
+1. Import local components directly inside `deck.mdx`.
+2. Expose components from a theme via `theme.components`.
+
+One way to bring in your own component is a local import:
+
+```mdx
+import ExampleCard from "./ExampleCard.tsx";
+
+<ExampleCard title="Local import">
+  Your own React component.
+</ExampleCard>
+```
+
+When you edit imported workspace components, Supadeck updates the deck runtime as part of the normal development loop.
+
+Themes can also inject components directly into MDX so you can write things like `<Callout />`, `<Disclosure />`, or a theme-specific component such as `<SupabaseMark />` without importing each usage manually.
+
+## GitHub Flavored Markdown
+
+Supadeck enables GitHub Flavored Markdown through `remark-gfm`, so the following features work in deck content:
+
+```md
+| Name | Value |
+| --- | --- |
+| Cold start | <1s |
+
+~~deprecated copy~~
+
+- [x] Ship deck
+- [ ] Rehearse
+
+> This quote renders through the deck's blockquote component.
+```
+
+These features render through the active theme's MDX component mapping, so tables and other elements pick up theme styling instead of falling back to unstyled raw HTML.
+
+## Creating Your Own Theme
+
+A custom theme is just a module that matches the `ThemeModule` shape. It can provide a custom deck renderer, MDX components, and a setup hook.
+
+Create a theme file such as `./themes/my-theme/index.tsx`:
+
+```tsx
+import type { ThemeModule } from "supadeck";
+import { DefaultDeck, createDefaultComponents } from "supadeck";
+import "./theme.css";
+
+const myTheme: ThemeModule = {
+  Deck: DefaultDeck,
+  components: {
+    ...createDefaultComponents(),
+    h1: (props) => <h1 className="text-7xl font-black tracking-tight" {...props} />,
+  },
+  setup({ config, rootElement, helpers }) {
+    rootElement.style.setProperty(
+      "--slide-aspect-ratio",
+      helpers.parseAspectRatio(config.aspectRatio)
+    );
+    rootElement.dataset.transition = config.transition ?? "fade";
+  },
+};
+
+export default myTheme;
+```
+
+Then point your deck at it:
+
+```yaml
+---
+theme: ./themes/my-theme
+---
+```
+
+Theme resolution supports:
+
+- Built-in ids like `default` and `sunset`
+- Relative theme files like `./my-theme.tsx`
+- Theme directories with an `index.tsx`, `index.ts`, `index.jsx`, or `index.js`
+
+The `ThemeModule` contract supports these keys:
+
+- `Deck` for a custom deck renderer
+- `components` for MDX tag overrides and theme-provided components
+- `setup` for runtime initialization and cleanup
+
+Import your CSS from the theme entry so the theme can own its visual system in one place.
+
+## Public Runtime Exports for Theme Authors
+
+Supadeck also exports a small toolbox for theme authors:
+
+- `createDefaultComponents`
+- `mergeComponents`
+- `useCurrentSlide`
+- `SlideFrame`
+- `DeckSlide`
+- `DeckChrome`
+- `DeckNavigation`
+- `DeckProgress`
+- `DeckTitle`
+- `DefaultDeck`
+- `Callout`
+- `Columns`
+- `Disclosure`
+- `Frame`
+
+`DefaultDeck` is the reusable base deck shell used by `sunset` and available to custom theme authors as a building block.
+
+## Exporting to PDF
+
+```bash
+npx supadeck export
+```
+
+Export runs the deck in print mode, builds the static HTML output, opens it in headless Chromium, and writes a PDF with backgrounds enabled.
+
+If Chromium is not available locally, install it first:
+
+```bash
+npx playwright install chromium
+```
+
+## Limits / Current Boundaries
+
+- PDF export depends on Playwright Chromium being installed and available locally.
+- Only the documented built-in themes ship with the package.
+- Supadeck supports the current theme transition model; it does not currently document speaker notes, presenter tools, remote control, or richer animation systems.
+
+## Examples
+
+- [`examples/dev/deck.mdx`](examples/dev/deck.mdx)
+- [`examples/default/deck.mdx`](examples/default/deck.mdx)

package/dist/cli/export.d.ts

@@ -0,0 +1,7 @@
+interface RunExportOptions {
+    deckPath: string;
+    outputPath: string;
+    themeOverride?: string;
+}
+export declare function runExport({ deckPath, outputPath, themeOverride, }: RunExportOptions): Promise<void>;
+export {};

package/dist/cli/export.js

@@ -0,0 +1,36 @@
+import { build, preview } from "vite";
+import { exportDeckToPdf } from "../export/pdf.js";
+import { createSupadeckViteConfig } from "../runtime/vite-config.js";
+export async function runExport({ deckPath, outputPath, themeOverride, }) {
+    const config = createSupadeckViteConfig({
+        deckPath,
+        themeOverride,
+        outputDirName: ".supadeck-dist",
+    });
+    await build(config);
+    const previewServer = await preview({
+        ...config,
+        preview: {
+            host: "127.0.0.1",
+            port: 4173,
+            strictPort: false,
+        },
+    });
+    const urls = previewServer.resolvedUrls?.local ?? [];
+    const baseUrl = urls[0];
+    if (!baseUrl) {
+        await previewServer.httpServer?.close();
+        throw new Error("Unable to determine preview URL for PDF export.");
+    }
+    try {
+        await exportDeckToPdf({
+            url: `${baseUrl}?print=1`,
+            outputPath,
+        });
+    }
+    finally {
+        await previewServer.httpServer?.close();
+    }
+    console.log(`[supadeck] PDF exported to ${outputPath}`);
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/cli/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAQrE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAC7B,QAAQ,EACR,UAAU,EACV,aAAa,GACG;IAChB,MAAM,MAAM,GAAG,wBAAwB,CAAC;QACrC,QAAQ;QACR,aAAa;QACb,aAAa,EAAE,gBAAgB;KACjC,CAAC,CAAC;IAEH,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;IAEpB,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC;QACjC,GAAG,MAAM;QACT,OAAO,EAAE;YACN,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,KAAK;SACnB;KACH,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC,OAAO,EAAE,CAAC;QACZ,MAAM,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,CAAC;QACF,MAAM,eAAe,CAAC;YACnB,GAAG,EAAE,GAAG,OAAO,UAAU;YACzB,UAAU;SACZ,CAAC,CAAC;IACN,CAAC;YAAS,CAAC;QACR,MAAM,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,8BAA8B,UAAU,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+export interface CliOptions {
+    open: boolean;
+    create: boolean;
+    port: number | undefined;
+    output: string | undefined;
+    theme: string | undefined;
+    input: string | undefined;
+}
+export interface ParsedArguments {
+    command: "dev" | "export";
+    options: CliOptions;
+}
+export declare function parseArguments(argv: string[]): ParsedArguments;

package/dist/cli/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import path from "node:path";
+import process from "node:process";
+import { pathToFileURL } from "node:url";
+import { runDevServer } from "./serve.js";
+import { runExport } from "./export.js";
+import { ensureStarterDeck, resolveDeckPath } from "./workspace.js";
+export function parseArguments(argv) {
+    const args = [...argv];
+    const command = args[0] === "export" ? "export" : "dev";
+    if (command === "export") {
+        args.shift();
+    }
+    const options = {
+        open: false,
+        create: true,
+        port: undefined,
+        output: undefined,
+        theme: undefined,
+        input: undefined,
+    };
+    while (args.length > 0) {
+        const token = args.shift();
+        if (!token) {
+            continue;
+        }
+        if (token === "--open") {
+            options.open = true;
+            continue;
+        }
+        if (token === "--no-create") {
+            options.create = false;
+            continue;
+        }
+        if (token === "--port") {
+            const value = args.shift();
+            options.port = value ? Number(value) : undefined;
+            continue;
+        }
+        if (token.startsWith("--port=")) {
+            options.port = Number(token.slice("--port=".length));
+            continue;
+        }
+        if (token === "--output") {
+            options.output = args.shift();
+            continue;
+        }
+        if (token.startsWith("--output=")) {
+            options.output = token.slice("--output=".length);
+            continue;
+        }
+        if (token === "--theme") {
+            options.theme = args.shift();
+            continue;
+        }
+        if (token.startsWith("--theme=")) {
+            options.theme = token.slice("--theme=".length);
+            continue;
+        }
+        if (token.startsWith("--")) {
+            throw new Error(`Unknown option: ${token}`);
+        }
+        if (!options.input) {
+            options.input = token;
+            continue;
+        }
+        throw new Error(`Unexpected argument: ${token}`);
+    }
+    return { command, options };
+}
+async function main() {
+    const { command, options } = parseArguments(process.argv.slice(2));
+    const deckPath = resolveDeckPath(options.input, process.cwd(), process.env.SUPADECK_DEFAULT_INPUT);
+    if (command === "dev" && options.create) {
+        await ensureStarterDeck(deckPath);
+    }
+    if (command === "export") {
+        await runExport({
+            deckPath,
+            outputPath: options.output
+                ? path.resolve(process.cwd(), options.output)
+                : path.resolve(path.dirname(deckPath), `${path.basename(deckPath, path.extname(deckPath))}.pdf`),
+            themeOverride: options.theme,
+        });
+        return;
+    }
+    await runDevServer({
+        deckPath,
+        port: options.port,
+        open: options.open,
+        themeOverride: options.theme,
+    });
+}
+if (process.argv[1] &&
+    pathToFileURL(process.argv[1]).href === import.meta.url) {
+    main().catch((error) => {
+        console.error(`\n[supadeck] ${error instanceof Error ? error.message : String(error)}`);
+        if (process.env.DEBUG) {
+            console.error(error);
+        }
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/serve.d.ts

@@ -0,0 +1,8 @@
+interface RunDevServerOptions {
+    deckPath: string;
+    port?: number;
+    open?: boolean;
+    themeOverride?: string;
+}
+export declare function runDevServer({ deckPath, port, open, themeOverride, }: RunDevServerOptions): Promise<void>;
+export {};

package/dist/cli/serve.js

@@ -0,0 +1,13 @@
+import { createServer } from "vite";
+import { createSupadeckViteConfig } from "../runtime/vite-config.js";
+export async function runDevServer({ deckPath, port, open, themeOverride, }) {
+    const server = await createServer(createSupadeckViteConfig({
+        deckPath,
+        port,
+        open,
+        themeOverride,
+    }));
+    await server.listen();
+    server.printUrls();
+}
+//# sourceMappingURL=serve.js.map

package/dist/cli/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/cli/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AASrE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAChC,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,aAAa,GACM;IACnB,MAAM,MAAM,GAAG,MAAM,YAAY,CAC9B,wBAAwB,CAAC;QACtB,QAAQ;QACR,IAAI;QACJ,IAAI;QACJ,aAAa;KACf,CAAC,CACJ,CAAC;IAEF,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,SAAS,EAAE,CAAC;AACtB,CAAC"}

package/dist/cli/templates.d.ts

@@ -0,0 +1 @@
+export declare function starterDeckTemplate(): string;

package/dist/cli/templates.js

@@ -0,0 +1,36 @@
+export function starterDeckTemplate() {
+    return `---
+title: Supadeck
+theme: default
+aspectRatio: 16:9
+showSlideNumbers: true
+transition: fade
+---
+
+# Supadeck
+
+Write presentations in one \`deck.mdx\` file.
+
+<Callout tone="accent">
+  Edit this file and the deck will hot reload automatically.
+</Callout>
+
+---
+
+## Custom components
+
+<Columns
+  left={<Frame label="Local imports">Import your own React components only when you need them.</Frame>}
+  right={<Disclosure title="Theme-provided components">Themes can expose components directly to MDX.</Disclosure>}
+/>
+
+---
+
+## Export
+
+- Run \`npx supadeck export\`
+- The deck is rendered as HTML first
+- Then exported to PDF with headless Chromium
+`;
+}
+//# sourceMappingURL=templates.js.map

package/dist/cli/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/cli/templates.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCT,CAAC;AACF,CAAC"}

package/dist/cli/workspace.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveDeckPath(input?: string, cwd?: string, defaultInput?: string): string;
+export declare function ensureStarterDeck(deckPath: string): Promise<void>;

package/dist/cli/workspace.js

@@ -0,0 +1,27 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { starterDeckTemplate } from './templates.js';
+export function resolveDeckPath(input, cwd = process.cwd(), defaultInput) {
+    const resolvedInput = input ?? defaultInput;
+    if (!resolvedInput) {
+        return path.resolve(cwd, 'deck.mdx');
+    }
+    const candidate = path.resolve(cwd, resolvedInput);
+    if (path.extname(candidate)) {
+        return candidate;
+    }
+    return path.join(candidate, 'deck.mdx');
+}
+async function writeFileIfMissing(filePath, contents) {
+    try {
+        await fs.access(filePath);
+    }
+    catch {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, contents, 'utf8');
+    }
+}
+export async function ensureStarterDeck(deckPath) {
+    await writeFileIfMissing(deckPath, starterDeckTemplate());
+}
+//# sourceMappingURL=workspace.js.map

package/dist/cli/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/cli/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,EACnB,YAAqB;IAErB,MAAM,aAAa,GAAG,KAAK,IAAI,YAAY,CAAC;IAE5C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,QAAgB;IAClE,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,MAAM,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/content/parse-deck.d.ts

@@ -0,0 +1,36 @@
+import type React from 'react';
+export interface DeckConfig {
+    title: string;
+    theme: string;
+    aspectRatio: string;
+    showSlideNumbers: boolean;
+    transition: 'none' | 'fade' | 'slide' | string;
+    sections?: DeckSection[];
+}
+export interface DeckSection {
+    label: string;
+    start: number;
+    end: number;
+}
+export interface DeckSlide {
+    index: number;
+    body: string;
+}
+export interface ParsedDeck {
+    frontmatter: Record<string, unknown>;
+    config: DeckConfig;
+    prelude: string;
+    slides: DeckSlide[];
+    rawContent: string;
+}
+export interface DeckModule extends Omit<ParsedDeck, 'prelude' | 'rawContent' | 'frontmatter'> {
+    slides: Array<DeckSlide & {
+        Component: React.ComponentType<{
+            components?: Record<string, React.ComponentType<any>>;
+        }>;
+    }>;
+}
+export declare function normalizeDeckConfig(frontmatter?: Record<string, unknown>, themeOverride?: string): DeckConfig;
+export declare function parseDeck(source: string, options?: {
+    themeOverride?: string;
+}): ParsedDeck;