feat(slides): import slidey-flavored markdown decks

CHANGELOG.md

@@ -4,6 +4,12 @@
 
 ### Added
 
+- `slides create-from-markdown`: import slidey-flavored decks — per-slide
+  YAML frontmatter (`layout:`, `content:`), `## Notes` speaker notes,
+  Font Awesome icon shortcodes (jsDelivr CDN), mermaid diagrams (local
+  `mmdc`), `::cols::`/`::col2::`/`::col3::`/`::right::` columns, and
+  `::boxes::`/`::arrows::` icon-row blocks. New flags: `--fa-style`,
+  `--mmdc`, `--strict`, `--keep-temp-images`, `--no-notes`.
 - Drive: add `drive share --notify` for invite targets that require a Drive notification email.
 - Calendar: keep `calendar appointments` as an explicit diagnostic because the Calendar API still rejects `eventTypes=appointmentSchedule`. (#329)
 - CLI: add nested `docs tabs ...` and `forms questions ...` aliases for consistent sub-item command patterns while preserving existing flat commands. (#433)

docs/commands/gog-slides-create-from-markdown.md

@@ -28,15 +28,20 @@ gog slides (slide) create-from-markdown <title> [flags]
 | `--disable-commands` | `string` |  | Comma-separated list of disabled commands; dot paths allowed |
 | `-n`<br>`--dry-run`<br>`--dryrun`<br>`--noop`<br>`--preview` | `bool` |  | Do not make changes; print intended actions and exit successfully |
 | `--enable-commands` | `string` |  | Comma-separated list of enabled commands; dot paths allowed (restricts CLI) |
+| `--fa-style` | `string` | solid | Default Font Awesome style when shortcode has no prefix |
 | `-y`<br>`--force`<br>`--assume-yes`<br>`--yes` | `bool` |  | Skip confirmations for destructive commands |
 | `--gmail-no-send` | `bool` | false | Block Gmail send operations (agent safety) |
 | `-h`<br>`--help` | `kong.helpFlag` |  | Show context-sensitive help. |
 | `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
+| `--keep-temp-images` | `bool` |  | Don't delete temporary Drive uploads after import |
+| `--mmdc` | `string` | mmdc | Path to mermaid CLI (mmdc); empty disables diagram rendering |
 | `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` |  | Never prompt; fail instead (useful for CI) |
+| `--no-notes` | `bool` |  | Discard `## Notes` sections instead of inserting as speaker notes |
 | `--parent` | `string` |  | Destination folder ID |
 | `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
 | `--results-only` | `bool` |  | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
 | `--select`<br>`--pick`<br>`--project` | `string` |  | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
+| `--strict` | `bool` |  | Treat skipped FA/diagram assets as fatal |
 | `-v`<br>`--verbose` | `bool` |  | Enable verbose logging |
 | `--version` | `kong.VersionFlag` |  | Print version and exit |
 | `--wrap-untrusted` | `bool` | false | In JSON/raw output, wrap fetched text fields in external untrusted-content markers |

docs/slides-markdown.md

@@ -1,43 +1,107 @@
 # Google Slides from Markdown
 
-`gog slides create-from-markdown` creates a new Google Slides deck from a small Markdown subset.
+`gog slides create-from-markdown` accepts both vanilla and slidey-flavored
+markdown. Slidey conventions are documented here.
+
+## Per-slide frontmatter
+
+Each slide may begin with a YAML frontmatter block. Recognized keys:
+
+| Key       | Values                                                | Behavior |
+|-----------|-------------------------------------------------------|----------|
+| `layout`  | `title`, `hero`, `statement`, `center`, `default`, `two-cols`, `three-cols` | Picks the slide's visual treatment. Unknown values fall back to `default`. |
+| `content` | `wide`, `narrow`                                       | Parsed but not yet applied (Slides has fixed text-box widths). |
 
-```bash
-gog slides create-from-markdown "Roadmap" --content-file ./slides.md
 ```
+---
+layout: hero
+---
+
+# univrs
 
-## File Structure
+Unfolding Nested Intent · Valid · Reliable · Safe
+```
 
-Separate slides with a line containing only `---`. Each slide needs a `##` heading; slides without a heading are ignored.
+A bare `---` line is a slide separator unless it opens a frontmatter block
+(see the design spec §4.1 for the exact disambiguation rule).
 
-````markdown
-## Roadmap
+## Speaker notes
 
-- Ship auth migration
-- Polish backup restore
-- Review raw API PRs
+A trailing `## Notes` (or `### Notes`) section becomes the slide's speaker
+notes. The heading and everything after it are removed from the body. FA
+icon shortcodes inside notes are stripped to plain text.
 
----
+```
+## Topic
 
-## Launch Notes
+body
 
-Short paragraphs become body text.
+## Notes
 
----
+- speaker hint one
+- speaker hint two
+```
+
+## Font Awesome icons
+
+Inline shortcodes `:fa-name:`, `:fas-name:`, `:far-name:`, `:fab-name:`,
+`:fal-name:`, `:fad-name:` resolve to FA Free SVGs fetched from
+`cdn.jsdelivr.net` and inserted as images. Style derivation:
+
+| Prefix  | Resolved style |
+|---------|----------------|
+| `fa-`   | `--fa-style` (default `solid`) |
+| `fas-`  | `solid`        |
+| `far-`  | `regular`      |
+| `fab-`  | `brands`       |
+| `fal-`, `fad-` | `solid` (FA Free has no light/duotone) |
+
+Icons placed at the start of a bullet item render as a small inline image
+to the left of the bullet text. Mid-paragraph icons are dropped.
+
+## Mermaid diagrams
 
-## CLI Example
+Fenced code blocks tagged `mermaid` are rendered to PNG via the local
+`mmdc` binary (configurable with `--mmdc`) and inserted as a full-width
+image. If `mmdc` is missing, the diagram is skipped with a warning;
+`--strict` makes it fatal.
 
-```text
-gog auth doctor --check
+## Multi-column layouts
+
+```
+::cols::
+
+left column markdown
+
+::col2::
+
+middle / right column markdown
+
+::col3::
+
+third column markdown
+
+::/cols::
 ```
-````
 
-## Supported Markdown
+`::right::` is accepted as a synonym for `::col2::` (slidey-style).
 
-- `## Heading` becomes the slide title.
-- `- item` and `* item` become bullet lists.
-- Plain lines become body text.
-- Fenced code blocks become code text.
-- Inline emphasis markers such as `**bold**`, `_italic_`, and backticks are stripped to plain text.
+## ::boxes:: and ::arrows::
+
+```
+::boxes::
+:fa-rectangle-ad: Campaigns
+:fa-headset: Support Tickets
+::/boxes::
+
+::arrows::
+
+### Step One
+
+### Step Two
+
+::/arrows::
+```
 
-The command is intentionally layout-light: it creates title/body slides from text content. Use `slides create-from-template` when you need exact branding, placeholder replacement, or predesigned layouts.
+Both render as bulleted lists in the body. Boxes use bullet glyphs;
+arrows use `→`.