@honeydeck/honeydeck 0.4.0 → 0.6.0

package/docs/index.json

@@ -0,0 +1,258 @@
+{
+  "generatedFrom": "packages/docs/content/docs",
+  "pages": [
+    {
+      "slug": "getting-started",
+      "title": "Getting started",
+      "description": "Getting started documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Start",
+        "Getting started"
+      ],
+      "file": "getting-started.md",
+      "sourcePath": "packages/docs/content/docs/(start)/getting-started.mdx"
+    },
+    {
+      "slug": "deeper-dive",
+      "title": "Deeper dive",
+      "description": "Deeper dive documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Start",
+        "Deeper dive"
+      ],
+      "file": "deeper-dive.md",
+      "sourcePath": "packages/docs/content/docs/(start)/deeper-dive.mdx"
+    },
+    {
+      "slug": "slides",
+      "title": "Slides",
+      "description": "Slides documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Slides"
+      ],
+      "file": "slides.md",
+      "sourcePath": "packages/docs/content/docs/(core)/slides.mdx"
+    },
+    {
+      "slug": "configuration",
+      "title": "Configuration",
+      "description": "Configuration documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Configuration"
+      ],
+      "file": "configuration.md",
+      "sourcePath": "packages/docs/content/docs/(core)/configuration.mdx"
+    },
+    {
+      "slug": "steps-and-reveals",
+      "title": "Steps and reveals",
+      "description": "Steps and reveals documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Steps and reveals"
+      ],
+      "file": "steps-and-reveals.md",
+      "sourcePath": "packages/docs/content/docs/(core)/steps-and-reveals.mdx"
+    },
+    {
+      "slug": "customization",
+      "title": "Customization",
+      "description": "Customization documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Customization"
+      ],
+      "file": "customization.md",
+      "sourcePath": "packages/docs/content/docs/(core)/customization.mdx"
+    },
+    {
+      "slug": "navigation",
+      "title": "Navigation",
+      "description": "Navigation documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Navigation"
+      ],
+      "file": "navigation.md",
+      "sourcePath": "packages/docs/content/docs/(core)/navigation.mdx"
+    },
+    {
+      "slug": "mobile",
+      "title": "Mobile and touch",
+      "description": "Mobile and touch documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Mobile and touch"
+      ],
+      "file": "mobile.md",
+      "sourcePath": "packages/docs/content/docs/(core)/mobile.mdx"
+    },
+    {
+      "slug": "presenter-mode",
+      "title": "Presenter mode",
+      "description": "Presenter mode documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "Presenter mode"
+      ],
+      "file": "presenter-mode.md",
+      "sourcePath": "packages/docs/content/docs/(core)/presenter-mode.mdx"
+    },
+    {
+      "slug": "pdf-export",
+      "title": "PDF export",
+      "description": "PDF export documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Core",
+        "PDF export"
+      ],
+      "file": "pdf-export.md",
+      "sourcePath": "packages/docs/content/docs/(core)/pdf-export.mdx"
+    },
+    {
+      "slug": "components",
+      "title": "Components",
+      "description": "Core Honeydeck components for timelines, presenter notes, browser frames, keyboard shortcuts, and styled lists.",
+      "breadcrumbs": [
+        "Components",
+        "Components"
+      ],
+      "file": "components.md",
+      "sourcePath": "packages/docs/content/docs/(components)/components.mdx"
+    },
+    {
+      "slug": "reveal",
+      "title": "Reveal",
+      "description": "Reveal documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "Reveal"
+      ],
+      "file": "reveal.md",
+      "sourcePath": "packages/docs/content/docs/(components)/reveal.mdx"
+    },
+    {
+      "slug": "reveal-with",
+      "title": "RevealWith",
+      "description": "RevealWith documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "RevealWith"
+      ],
+      "file": "reveal-with.md",
+      "sourcePath": "packages/docs/content/docs/(components)/reveal-with.mdx"
+    },
+    {
+      "slug": "reveal-group",
+      "title": "RevealGroup",
+      "description": "RevealGroup documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "RevealGroup"
+      ],
+      "file": "reveal-group.md",
+      "sourcePath": "packages/docs/content/docs/(components)/reveal-group.mdx"
+    },
+    {
+      "slug": "timeline-steps",
+      "title": "TimelineSteps",
+      "description": "TimelineSteps documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "TimelineSteps"
+      ],
+      "file": "timeline-steps.md",
+      "sourcePath": "packages/docs/content/docs/(components)/timeline-steps.mdx"
+    },
+    {
+      "slug": "list-style",
+      "title": "ListStyle",
+      "description": "ListStyle documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "ListStyle"
+      ],
+      "file": "list-style.md",
+      "sourcePath": "packages/docs/content/docs/(components)/list-style.mdx"
+    },
+    {
+      "slug": "keyboard",
+      "title": "Keyboard",
+      "description": "Keyboard documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "Keyboard"
+      ],
+      "file": "keyboard.md",
+      "sourcePath": "packages/docs/content/docs/(components)/keyboard.mdx"
+    },
+    {
+      "slug": "browser-frame",
+      "title": "BrowserFrame",
+      "description": "BrowserFrame documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "BrowserFrame"
+      ],
+      "file": "browser-frame.md",
+      "sourcePath": "packages/docs/content/docs/(components)/browser-frame.mdx"
+    },
+    {
+      "slug": "notes",
+      "title": "Notes",
+      "description": "Notes documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Components",
+        "Notes"
+      ],
+      "file": "notes.md",
+      "sourcePath": "packages/docs/content/docs/(components)/notes.mdx"
+    },
+    {
+      "slug": "local-development",
+      "title": "Local development",
+      "description": "Local development documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Develop",
+        "Local development"
+      ],
+      "file": "local-development.md",
+      "sourcePath": "packages/docs/content/docs/(develop)/local-development.mdx"
+    },
+    {
+      "slug": "skills",
+      "title": "Skills",
+      "description": "Skills documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Advanced",
+        "Skills"
+      ],
+      "file": "skills.md",
+      "sourcePath": "packages/docs/content/docs/(advanced)/skills.mdx"
+    },
+    {
+      "slug": "slidev-migration",
+      "title": "Slidev migration",
+      "description": "Slidev migration documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Advanced",
+        "Slidev migration"
+      ],
+      "file": "slidev-migration.md",
+      "sourcePath": "packages/docs/content/docs/(advanced)/slidev-migration.mdx"
+    },
+    {
+      "slug": "mermaid",
+      "title": "Mermaid",
+      "description": "Mermaid documentation for Honeydeck.",
+      "breadcrumbs": [
+        "Advanced",
+        "Mermaid"
+      ],
+      "file": "mermaid.md",
+      "sourcePath": "packages/docs/content/docs/(advanced)/mermaid.mdx"
+    }
+  ]
+}

package/docs/keyboard.md

@@ -0,0 +1,35 @@
+<!-- Generated from packages/docs/content/docs/(components)/keyboard.mdx. Do not edit by hand. -->
+
+# Keyboard
+
+Use `<Keyboard>` to show one key or a shortcut in slide prose.
+
+<KeyboardPlayground />
+
+```mdx
+import { Keyboard } from '@honeydeck/honeydeck'
+
+Press <Keyboard>Esc</Keyboard> to close overview.
+
+Advance with <Keyboard keys="Space" />.
+
+Open command palette with <Keyboard keys={["Ctrl", "Shift", "P"]} />.
+```
+
+`keys` accepts a single value or an ordered array. When `keys` is omitted, `children` is rendered as one key. Array values render one `<kbd>` per key, separated by `+` by default:
+
+```mdx
+<Keyboard keys={["⌘", "K"]} />
+<Keyboard keys={["Ctrl", "Alt", "Delete"]} separator=" " />
+```
+
+## Props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `keys` | `ReactNode \| ReactNode[]` | — | Key label or ordered shortcut key labels. |
+| `children` | `ReactNode` | — | Single key label when `keys` is omitted. |
+| `separator` | `ReactNode` | `+` | Separator rendered between array entries. |
+| `className` | `string` | — | Custom class for the outer wrapper. |
+
+The component uses semantic `<kbd>` markup, is inline by default, uses Honeydeck theme styling, and does not add timeline steps.

package/docs/list-style.md

@@ -0,0 +1,53 @@
+<!-- Generated from packages/docs/content/docs/(components)/list-style.mdx. Do not edit by hand. -->
+
+# ListStyle
+
+Use `<ListStyle>` to style Markdown, HTML, or JSX lists inside a wrapper.
+
+<ListStylePlayground />
+
+By default it removes native markers:
+
+```mdx
+import { ListStyle } from '@honeydeck/honeydeck'
+
+<ListStyle>
+  - No marker
+  - Still aligned
+</ListStyle>
+```
+
+Pass `bullets` to render custom markers:
+
+```mdx
+import { ListStyle } from '@honeydeck/honeydeck'
+import { CheckIcon, CircleIcon } from 'lucide-react'
+
+<ListStyle bullets={[<CheckIcon />, <CircleIcon />]}>
+  - Level one uses a check icon
+    - Level two uses a circle icon
+</ListStyle>
+
+<ListStyle bullets={["→", "–", "·"]}>
+  - Level one
+    - Level two
+      - Level three
+</ListStyle>
+```
+
+## Props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | — | List content to style. |
+| `bullets` | `ReactNode \| ReactNode[] \| false \| "none" \| null` | `undefined` | Marker config. Omit it, pass `false`, `"none"`, or `null` for markerless lists. |
+| `className` | `string` | — | Custom class for the wrapper. |
+| `style` | `CSSProperties` | — | Inline style for the wrapper. |
+
+## Behavior
+
+- Native list markers are removed for all nested lists in the wrapper.
+- A single `bullets` value is reused for every nesting level.
+- An array uses one marker per nesting level.
+- Deeper levels reuse the last configured marker.
+- Custom markers apply to authored list elements passed as children.

package/docs/local-development.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(develop)/local-development.mdx. Do not edit by hand. -->
+
 # Local development
 
 This guide explains how to test Honeydeck locally before it is published to npm.
@@ -19,7 +21,7 @@ npm install
 npm run dev
 ```
 
-Root `npm run dev` starts the private showcase deck package and the marketing/docs site together.
+Root `npm run dev` starts the private showcase deck package and the docs site together.
 
 To run only the showcase deck:
 

package/docs/mermaid.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(advanced)/mermaid.mdx. Do not edit by hand. -->
+
 # Mermaid
 
 Mermaid is not part of Honeydeck core. Use it as a normal project dependency and render diagrams through a local React component that you import from your deck.

package/docs/mobile.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/mobile.mdx. Do not edit by hand. -->
+
 # Mobile and Touch
 
 Honeydeck works on phones and tablets, but mobile presentation mode behaves differently from desktop so touch gestures stay reliable.

package/docs/navigation.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/navigation.mdx. Do not edit by hand. -->
+
 # Navigation
 
 ## Keyboard Shortcuts
@@ -9,7 +11,7 @@
 | `↓` / `s` | Next slide |
 | `↑` / `w` | Previous slide |
 | `o` | Toggle overview mode |
-| `p` | Open presenter mode (new window) |
+| `p` | Open presenter mode (same tab) |
 | `f` | Toggle fullscreen |
 | `Escape` | Exit overview / exit fullscreen |
 

package/docs/notes.md

@@ -0,0 +1,40 @@
+<!-- Generated from packages/docs/content/docs/(components)/notes.mdx. Do not edit by hand. -->
+
+# Notes
+
+Use `<Notes>` to add presenter-only speaker notes to a slide.
+
+<NotesPlayground />
+
+```mdx
+import { Notes } from '@honeydeck/honeydeck'
+
+# Launch plan
+
+- What changed
+- Why it matters
+
+<Notes>
+  # Demo cue
+
+  - Demo the interactive component.
+  - Mention PDF export.
+</Notes>
+```
+
+Notes render nothing in audience view, overview thumbnails, and normal PDF output. In presenter mode, Markdown inside `<Notes>` renders as formatted speaker notes, including headings, paragraphs, lists, links, inline code, code blocks, and block quotes.
+
+## Props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | — | Speaker-note content collected by presenter mode. |
+
+## Behavior
+
+- `<Notes>` is a no-op outside presenter mode.
+- Notes are collected from the current slide preview in presenter mode.
+- Updating the slide notes updates the presenter notes panel.
+- You can use Markdown inside Notes.
+
+See [Presenter mode](presenter-mode.md) for the full presenter workflow.

package/docs/pdf-export.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/pdf-export.mdx. Do not edit by hand. -->
+
 # PDF Export
 
 ## How It Works
@@ -51,14 +53,16 @@ Honeydeck builds an ordered capture plan before taking screenshots. The final PD
 
 When `pdfSteps: all`:
 
-- Each `Reveal`/`RevealGroup` step becomes a separate page.
+- Each `Reveal`/`RevealGroup` step becomes a separate page. `RevealWith` appears on the page for its target step and adds no extra page.
 - Stepped code blocks show their first highlight group on the baseline page; each later code highlight group becomes a separate page.
-- Both use the same underlying timeline.
+- Magic Code blocks show their first inner code fence on the baseline page; later line-highlight states and code morph states become separate pages according to the same timeline.
+- Reveals, stepped code blocks, Magic Code, and custom `TimelineSteps` blocks use the same underlying timeline.
 
 When `pdfSteps: final` (default):
 
 - All reveals shown in final (visible) state.
 - Code blocks shown with final highlight applied.
+- Magic Code blocks shown at their final code state with final highlight applied.
 - `useTimeline()` and `useTimelineSteps()` expose `isPdfFinalRender: true`, so
   custom step-driven components can render an all-open/all-visible PDF state.
 

package/docs/presenter-mode.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/presenter-mode.mdx. Do not edit by hand. -->
+
 # Presenter Mode
 
 ## Overview
@@ -29,6 +31,7 @@ Includes:
 - Slide number / step counter
 - Wall clock
 - Button to open audience view in a new tab/window
+- Button to cast the audience view to a secondary display when supported; the same control becomes a stop button while casting and is disabled with a hint when unsupported
 - Navigation buttons that move through the timeline while staying in presenter mode
 
 ## Speaker Notes
@@ -58,11 +61,11 @@ Content here.
 
 ## Opening Presenter Mode
 
-- Keyboard shortcut `p` from normal presentation → opens in a new window/tab.
+- Keyboard shortcut `p` from normal presentation → opens presenter mode in the current tab.
 - Navigation controls button in normal presentation.
 - Direct URL: `/#/presenter/1/0`
 
-Pressing `p` opens presenter mode in a **new window** so the audience view stays on the projector.
+Pressing `p` opens presenter mode in the **current tab**.
 
 ## Navigation
 
@@ -85,10 +88,12 @@ When no next timeline state exists, the `Next` preview shows an end-of-deck plac
 
 ## Presenter/Audience Sync
 
-Presenter mode and audience view synchronize navigation via `BroadcastChannel` in the same browser/profile.
+Presenter mode and audience view synchronize navigation via `BroadcastChannel` and, when supported, the Presentation API.
 
 - Presenter mode acts as the controller.
 - Audience view (opened from presenter mode) listens for navigation updates.
+- The cast audience sends a `sync-request` as soon as the receiver connection appears; the presenter replies with the current slide/step in a `sync-response` so late connections resync immediately.
+- The cast audience follows presenter navigation through Presentation API receiver messages.
 - No server, internet, WebSocket, or device pairing required.
 - If `BroadcastChannel` is unavailable, both views function independently.
 

package/docs/reveal-group.md

@@ -0,0 +1,60 @@
+<!-- Generated from packages/docs/content/docs/(components)/reveal-group.mdx. Do not edit by hand. -->
+
+# RevealGroup
+
+Use `<RevealGroup>` when a short sequence should appear one item at a time.
+
+```mdx
+import { RevealGroup } from '@honeydeck/honeydeck'
+
+<RevealGroup>
+  - First point
+  - Second point
+  - Third point
+</RevealGroup>
+```
+
+Each meaningful direct child becomes one timeline step. Whitespace-only text children are ignored. Markdown, HTML, and JSX lists are special: each top-level list item is revealed one after another while preserving the list container.
+
+Use `listRevealMode="nested"` when nested list items should also become individual steps:
+
+```mdx
+<RevealGroup listRevealMode="nested">
+  - Parent
+    - Child A
+    - Child B
+  - Sibling
+</RevealGroup>
+```
+
+Timeline: parent → child A → child B → sibling. The default mode is `"direct"`, which keeps nested items grouped with their parent.
+
+To reveal multiple elements together, wrap them in one direct child:
+
+```mdx
+<RevealGroup>
+  <div>
+    <h3>One idea</h3>
+    <p>Supporting context appears with it.</p>
+  </div>
+  <div>Next idea</div>
+</RevealGroup>
+```
+
+Nested timeline entries inside a group target are flattened after that target and before the following group target:
+
+```mdx
+<RevealGroup>
+  <div>
+    Parent item
+    <Reveal>Nested detail</Reveal>
+  </div>
+  <div>Sibling item</div>
+</RevealGroup>
+```
+
+**Timeline:**
+
+1. Parent item appears
+2. Nested detail appears
+3. Sibling item appears

package/docs/reveal-with.md

@@ -0,0 +1,39 @@
+<!-- Generated from packages/docs/content/docs/(components)/reveal-with.mdx. Do not edit by hand. -->
+
+# RevealWith
+
+Use `<RevealWith>` when content should appear at the same timeline step as a named `<Reveal>` or any existing numeric slide step. It never adds a new step.
+
+````mdx
+import { Reveal, RevealWith } from '@honeydeck/honeydeck'
+
+<Reveal name="intro">Intro appears first</Reveal>
+<RevealWith target="intro">This appears with the intro reveal</RevealWith>
+
+```ts {1|2|3}
+const answer = 42
+console.log(answer)
+```
+
+<RevealWith at={2}>This appears with step 2</RevealWith>
+````
+
+## Props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `target` | `string` | — | Same-slide `<Reveal name="...">` target. Must be a literal non-empty string. Use exactly one of `target` or `at`. |
+| `at` | `number` | resolved/injected | Existing 1-based slide-local timeline step. Must be a literal positive integer when authored. Use exactly one of `target` or `at`. |
+| `children` | `ReactNode` | — | Content to reveal with the target step. |
+| `className` | `string` | — | Custom class for styling or transitions. |
+| `as` | `"div" | "span"` | injected | Wrapper element. Honeydeck injects this to keep valid MDX/HTML around block or inline content. |
+
+## Behavior
+
+- `RevealWith` is cumulative like `Reveal`: once visible, it stays visible.
+- `target` supports forward references to named reveals later on the same slide.
+- `at` can target any existing slide step, including a `RevealGroup` item, code highlight, Magic Code state, or `TimelineSteps` state.
+- Hidden content reserves layout space and uses the same fade/future-preview behavior as `Reveal`.
+- Invalid targets, duplicate reveal names, non-literal values, and out-of-range numeric steps are build errors.
+
+See [Steps and reveals](steps-and-reveals.md#revealwith) for timeline ordering examples.

package/docs/reveal.md

@@ -0,0 +1,35 @@
+<!-- Generated from packages/docs/content/docs/(components)/reveal.mdx. Do not edit by hand. -->
+
+# Reveal
+
+Use `<Reveal>` when content should appear at the next timeline step.
+
+```mdx
+import { Reveal } from '@honeydeck/honeydeck'
+
+<Reveal>Start with Markdown</Reveal>
+<Reveal>Enhance with React</Reveal>
+<Reveal>Export to PDF</Reveal>
+```
+
+Reveals are cumulative: once visible, they stay visible while you advance through the slide. Hidden reveal content reserves layout space, so the slide does not jump when the content appears.
+
+## Props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | — | Content to reveal. |
+| `name` | `string` | — | Optional slide-local target for [`RevealWith target="..."`](reveal-with.md). Must be a literal non-empty string. |
+| `className` | `string` | — | Custom class for styling or transitions. |
+| `at` | `number` | injected | Timeline step. Honeydeck injects this during compilation; author-authored values are build errors. Use [`RevealWith`](reveal-with.md) to sync with an existing step. |
+| `as` | `"div" \| "span"` | injected | Wrapper element. Honeydeck injects this to keep valid MDX/HTML around block or inline content. |
+
+## Behavior
+
+- Reveals fade in.
+- Hidden content uses `visibility: hidden` plus `opacity: 0`, not `display: none`.
+- Nested reveals are supported.
+- Inline reveals inside paragraphs render inline wrappers.
+- Optional `name="..."` creates a slide-local target for [`RevealWith`](reveal-with.md).
+
+See [Steps and reveals](steps-and-reveals.md) for timeline ordering examples.

package/docs/skills.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(advanced)/skills.mdx. Do not edit by hand. -->
+
 # Skills
 
 Honeydeck ships optional agent skills that help AI coding agents work with presentations more reliably. They are plain skill files bundled with the `@honeydeck/honeydeck` package, so you can install them into a deck project or into your global agent setup.
@@ -31,9 +33,9 @@ npx skills add <honeydeck-repo-url> --copy --skill slidev-migration
 
 | Skill | Use it for |
 | --- | --- |
-| `honeydeck` | Honeydeck-specific guidance for MDX decks, layouts, CSS imports, presenter notes, reveals, code steps, PDF export, and package docs. |
+| `honeydeck` | Honeydeck-specific guidance for MDX decks, layouts, CSS imports, presenter notes, reveals, code steps, Magic Code, PDF export, public docs, and package specs. |
 | `presentation-writing` | Framework-agnostic help with audience, storyline, slide headlines, speaker notes, timing, and review heuristics. |
-| `slidev-migration` | Migrating Slidev decks to Honeydeck while preserving source files until you approve cleanup. |
+| `slidev-migration` | Migrating Slidev decks to Honeydeck, including rewriting Slidev `md magic-move` blocks to Honeydeck `md magic-code`, while preserving source files until you approve cleanup. |
 
 The `honeydeck` and `presentation-writing` skills work well together: one keeps the agent inside Honeydeck conventions, while the other improves the story and delivery. Add `slidev-migration` when you are converting an existing Slidev project.
 
@@ -48,7 +50,7 @@ For example, an agent with the `honeydeck` skill should prefer:
 - slide frontmatter for layouts
 - explicit imports from `@honeydeck/honeydeck`
 - `<Notes>` for speaker notes
-- `<Reveal>`, `<RevealGroup>`, and code metadata for steps
+- `<Reveal>`, `<RevealGroup>`, code metadata, and Magic Code for steps
 - `honeydeck pdf` for PDF export
 
 The skills also point agents back to the packaged docs and specs, so generated deck changes can stay aligned with the installed Honeydeck version.

package/docs/slides.md

@@ -1,3 +1,5 @@
+<!-- Generated from packages/docs/content/docs/(core)/slides.mdx. Do not edit by hand. -->
+
 # Slides
 
 ## Basics