@aivorynet/slaide 1.0.1 → 1.0.3

package/skills/slaide/themes.md

@@ -1,6 +1,6 @@
 # slaide master / theme authoring
 
-A **master** is a YAML file defining the whole visual system as data, so one theme serves many decks and an agent can both *use* and *author* it. Reference it from a deck with `master: ./your-theme.slaide.yaml` (omit → bundled `aurora`).
+A **master** is a YAML file defining the whole visual system as data, so one theme serves many decks and an agent can both *use* and *author* it. Reference it from a deck with `master: ./your-theme.slaide.yaml`, or use a bundled theme by name (`master: aurora`); omit `master:` and you get `aurora`.
 
 ## Top-level shape
 
@@ -23,6 +23,50 @@ layouts:   { … }          # grid templates with typed slots
 
 Sizes are in canvas px; the runtime scales each slide to fit (letterboxed). Match your source design (e.g. `1920×1080`) so px == design pt.
 
+## Minimal master (copy, then customise)
+
+A complete, compiling starter. Swap the palette + fonts for the brand, add layouts as needed.
+
+```yaml
+schema: slaide/1
+name: my-theme
+canvas: { aspect: "16:9", width: 1280, height: 720 }
+fonts:
+  sans:    { family: "Inter",    provider: google, weights: [400, 600, 700] }
+  display: { family: "Fraunces", provider: google, weights: [600, 900] }
+typeScale:
+  base: "26px"
+  ratio: 1.2
+  steps: { h1: 4, h2: 3, h3: 2, body: 0, caption: -1 }
+colors:
+  palette: { ink: "#0B1220", paper: "#F8FAFC", brand: "#3B82F6" }
+  roles:
+    background: "{palette.ink}"
+    text:       "{palette.paper}"
+    heading:    "{palette.paper}"
+    accent:     "{palette.brand}"
+layouts:
+  cover:
+    align: center
+    areas: ["title", "subtitle"]
+    rows: "auto auto"
+    slots:
+      title:    { type: title,    style: { font: display, size: h1, weight: "900" } }
+      subtitle: { type: subtitle, style: { size: h3, color: accent } }
+  title-content:
+    areas: ["title", "body"]
+    rows: "auto 1fr"
+    slots:
+      title: { type: title, style: { size: h2 } }
+      body:  { type: body }
+  section:
+    align: center
+    areas: ["title"]
+    rows: "1fr"
+    slots:
+      title: { type: title, style: { font: display, size: h1, align: center } }
+```
+
 ## fonts / typeScale
 
 **Use real Google Fonts only** (`provider: google`) — pick families that actually exist on Google Fonts and embed (avoid **JetBrains Mono**, which doesn't). A `display` (headings) + a `sans` (body) is plenty; add a `mono` role only if the deck shows code. A `provider: system`/`local` font that isn't a common system font (Arial, Calibri, Georgia…) **warns** (`non-embeddable-font`): it won't embed in the `.pptx`, so PowerPoint substitutes it off your machine.

package/skills/slaide/examples/branded-deck.slaide

@@ -1,198 +0,0 @@
----
-master: ./vela.slaide.yaml
-title: Vela
-company: Vela, Inc.
-date: "2026"
-author: Vela team
-~transition: fade
----
-layout: cover
----
-:: brand ::
-```svg
-<svg width="150" height="42" viewBox="0 0 120 40"><text x="0" y="31" font-family="Open Sans, Inter, sans-serif" font-size="30" font-weight="800" letter-spacing="2" fill="currentColor">VELA</text></svg>
-```
-
-:: title ::
-[Smart Route]{.grad}
-
-:: sub ::
-The spot market for AI compute
-
-:: diagram ::
-![Routing diagram](assets/diagram.svg)
-
----
-layout: team
-chrome: header
----
-:: title ::
-[Hi!]{.teal} We are
-
-:: lname ::
-![Alex Rivera](assets/avatar-a.svg){.round anchor:"24% 22% 18% 32%"}
-[Alex]{.blue}<br>Rivera
-
-:: lbio ::
-Built developer tooling and inference platforms for a decade. Shipped APIs used by thousands of teams.
-
-Background across the full stack, from kernels to billing.
-
-:: rname ::
-![Sam Chen](assets/avatar-b.svg){.round anchor:"73.5% 22% 18% 32%"}
-[Sam]{.teal}<br>Chen
-
-:: rbio ::
-Software engineer and product lead. Specializes in user experience and turning messy infra into simple products.
-
-M.Sc. in distributed systems.
-
-:: logos ::
-**We worked with** &nbsp;&nbsp; ![Acme](assets/clients/acme.svg){.logo height=30px} &nbsp; ![Globex](assets/clients/globex.svg){.logo height=30px} &nbsp; ![Hooli](assets/clients/hooli.svg){.logo height=30px} &nbsp; ![Initech](assets/clients/initech.svg){.logo height=30px} &nbsp; ![Umbra](assets/clients/umbra.svg){.logo height=30px} &nbsp; ![Vandel](assets/clients/vandel.svg){.logo height=30px}
-
----
-layout: content-aside
-footer: "We want to be **the router for compute**"
----
-:: title ::
-We offer: [Developer Tooling In The Age of AI]{.purple}
-
-:: body ::
-| Product | Traction | Status |
-|---|---|---|
-| **Route** — smart inference | [2,000+]{.blue.lg} teams | Paying customers |
-| **Forge** — spot brokering | [300+]{.green.lg} clusters | Paid pilots |
-| **Atlas** — capacity float | [18,000+]{.purple.lg} GPUs | Paying customers |
-
-:: aside ::
-We test the market and improve the offering. So far, all organic growth.
-
-**Zero ad spend.**
-
----
-layout: statement
-footer: "Everyone is building supply. **Nobody is routing demand.**"
----
-:: title ::
-$765 billion in GPUs. [½ sit idle.]{.blue}
-
-:: s1 ::
-[40-80%]{.grad-purple.huge}
-
-### Capacity Idle
-
-[Inference workloads dip to 15–30% off-peak. A rack of GPUs costs $4M. At 40% utilization, half that investment earns nothing.]{.sm .muted}
-
-:: s2 ::
-[10x]{.grad-teal.huge}
-
-### Price Spread
-
-[Same GPU, same hour: $1.49 to $10.00. Up to 14.5× on spot.]{.sm .muted}
-
-:: s3 ::
-[60+]{.grad-blue.huge}
-
-### Providers
-
-[Tracked and growing. No aggregated spot market exists yet.]{.sm .muted}
-
----
-layout: two-col
-footer: "We take a cut of the spread. **Everybody wins.**"
----
-:: title ::
-Route the [tokens.]{.orange} Or rent the [GPU.]{.orange}
-
-:: left ::
-**Smart inference routing**
-
-Drop-in OpenAI-compatible API. **Change one line of code.** Every request scored and routed to the cheapest healthy provider, with auto-failover.
-
-**GPU spot brokering**
-
-We find and provision the **cheapest spot GPU** for your model. Same scoring, same reliability layer, automatic migration. Up to **80%+ discount**.
-
-:: right ::
-| GPU | Pool | $/hr | Trend |
-|---|---|---|---|
-| **B300** · 2100 GB | bolt | **$2.99** | ▲ 20% |
-| **B200** · 1440 GB | bolt | **$2.44** | ▲ 13% |
-| **H200** · 1128 GB | drift | **$0.60** | ▼ 5% |
-| **A100** · 640 GB | bolt | **$0.71** | ▲ 10% |
-| **H100** · 640 GB | bolt | **$1.30** | ▲ 23% |
-| **L40S** · 384 GB | bolt | **$0.55** | ▲ 37% |
-
----
-layout: two-col
-footer: "One line of code. **Every provider.**"
----
-:: title ::
-How [Smart Route]{.grad} works
-
-:: left ::
-```mermaid
-flowchart TD
-  C([Your app]) -->|OpenAI-compatible API| R{Smart Route}
-  R -->|cheapest healthy| A[Provider A]
-  R -->|auto-failover| B[Provider B]
-  R -->|spot broker| S[(Spot GPU pool)]
-  A --> O([Cheapest healthy token])
-  B --> O
-  S --> O
-```
-
-:: right ::
-**Drop-in.** Change one line of code. Every request is scored on **price and health**, then routed to the cheapest healthy provider.
-
-**Resilient.** Automatic failover and live migration across **60+ providers** — no lock-in, no babysitting.
-
----
-layout: title-content
-footer: "Same GPU, same hour — **up to 10× apart.**"
----
-:: title ::
-Spot price by GPU [($/hr)]{.muted}
-
-:: body ::
-```echart
-{
-  "grid": { "left": 64, "right": 28, "top": 28, "bottom": 48 },
-  "xAxis": { "type": "category", "data": ["L40S", "H200", "A100", "H100", "B200", "B300"] },
-  "yAxis": { "type": "value" },
-  "series": [
-    {
-      "type": "bar",
-      "data": [0.55, 0.60, 0.71, 1.30, 2.44, 2.99],
-      "barWidth": "52%",
-      "itemStyle": { "borderRadius": [10, 10, 0, 0] }
-    }
-  ]
-}
-```
-
----
-layout: media-split
-footer: "Everyone is building supply."
----
-:: media ::
-![Rows of servers in a data center](assets/datacenter.jpg)
-
-:: copy ::
-## $765B in racks — [half of it idle.]{.blue}
-
-The world is racing to build compute. We make the idle half **earn its keep.**
-
-[Photo by Taylor Vick on Unsplash]{.sm .muted}
-
----
-layout: closing
----
-:: card ::
-```svg
-<svg width="160" height="46" viewBox="0 0 120 40"><text x="0" y="31" font-family="Open Sans, Inter, sans-serif" font-size="30" font-weight="800" letter-spacing="2" fill="currentColor">VELA</text></svg>
-```
-
-#### The router for AI compute
-
-**Vela, Inc.** · hello@vela.dev · vela.dev

package/skills/slaide/examples/branded-theme.slaide.yaml

@@ -1,187 +0,0 @@
-# yaml-language-server: $schema=https://getslaide.com/schema/v1.json
-schema: slaide/1
-name: vela
-description: A dark pitch-deck theme — Open Sans, navy ground, multi-accent gradient highlights.
-
-canvas: { aspect: "16:9", width: 1920, height: 1080 }
-
-fonts:
-  sans:    { family: "Open Sans",      provider: google, weights: [300, 400, 600, 700] }
-  display: { family: "Open Sans",      provider: google, weights: [800] }
-  mono:    { family: "IBM Plex Mono",  provider: google, weights: [400, 600] }
-
-typeScale:
-  base: "24px"
-  ratio: 1.2
-  steps:
-    stat:    "110px"
-    hero:    "80px"
-    h1:      "72px"
-    h2:      "44px"
-    h3:      "36px"
-    h4:      "28px"
-    body:    "24px"
-    caption: "22px"
-    small:   "18px"
-
-colors:
-  palette:
-    navy:   "#0B1220"
-    panel:  "#121A2B"
-    ink:    "#050810"
-    white:  "#F8FAFC"
-    muted:  "#8B93A7"
-    blue:   "#5B8CFF"
-    purple: "#A855F7"
-    teal:   "#2DD4BF"
-    green:  "#34D399"
-    orange: "#FB923C"
-    pink:   "#EC4899"
-  roles:
-    background: "{palette.navy}"
-    surface:    "{palette.panel}"
-    text:       "{palette.white}"
-    heading:    "{palette.white}"
-    accent:     "{palette.blue}"
-    link:       "{palette.blue}"
-    muted:      "{palette.muted}"
-
-gradients:
-  brand:  "linear-gradient(100deg, #5B8CFF 0%, #A855F7 50%, #2DD4BF 100%)"
-  purple: "linear-gradient(120deg, #A855F7, #EC4899)"
-  teal:   "linear-gradient(120deg, #2DD4BF, #5B8CFF)"
-  blue:   "linear-gradient(120deg, #5B8CFF, #818CF8)"
-
-tokens:
-  "--slide-padding": "120px"
-  "--chrome-pad": "120px"
-  "--chrome-top": "44px"
-  "--chrome-bottom": "44px"
-  "--chrome-size": "22px"
-  "--chrome-foot-size": "40px"
-  "--chrome-page-size": "22px"
-  "--logo-h": "34px"
-  # ordered colour cycle for ```echart data series (falls back to a default palette)
-  "--chart-colors": "#5B8CFF, #A855F7, #2DD4BF, #34D399, #FB923C, #EC4899"
-
-backgrounds:
-  navy:  { type: solid, color: "{palette.navy}" }
-  team:  { type: gradient, stops: ["#0B1220 0%", "#0B1220 50%", "#05070D 50%", "#05070D 100%"], angle: 90 }
-  paper: { type: solid, color: "#EEEFF1" }
-
-variants:
-  light:
-    roles: { background: "#EEEFF1", surface: "#FFFFFF", text: "#0B1220", heading: "#0B1220", muted: "#5A6072" }
-
-transitions: { default: fade, duration: 420 }
-
-chrome:
-  header: { right: "{{date}}  |  © {{company}}" }
-  footer: { left: "{{footer}}", right: "{{pagePadded}} / {{totalPadded}}" }
-  logoPos: top-left
-  logo: '<svg viewBox="0 0 120 40"><text x="0" y="31" font-family="Open Sans, Inter, sans-serif" font-size="30" font-weight="800" letter-spacing="2" fill="currentColor">VELA</text></svg>'
-
-layouts:
-  cover:
-    background: navy
-    chrome: header
-    logo: false
-    align: start
-    areas: [". diagram", "brand diagram", "title diagram", "sub diagram"]
-    rows: "1fr auto auto auto"
-    cols: "1.1fr 0.9fr"
-    gap: "0.3em 3em"
-    slots:
-      brand:   { type: body, style: { align: left } }
-      title:   { type: title, style: { font: display, size: hero, weight: "800", leading: "0.98", maxw: "7ch" } }
-      sub:     { type: subtitle, style: { size: "32px", color: white, weight: "400" } }
-      diagram: { type: image, style: { valign: center } }
-
-  statement:
-    background: navy
-    align: center
-    areas: ["title title title", "s1 s2 s3"]
-    rows: "auto 1fr"
-    cols: "1fr 1fr 1fr"
-    gap: "1.4em"
-    slots:
-      title: { type: title, style: { size: "80px", weight: "800" } }
-      s1: { type: body, style: { align: center, valign: center } }
-      s2: { type: body, style: { align: center, valign: center } }
-      s3: { type: body, style: { align: center, valign: center } }
-
-  title-content:
-    background: navy
-    areas: ["title", "body"]
-    rows: "auto 1fr"
-    slots:
-      title: { type: title, style: { size: h1, weight: "800" } }
-      body:  { type: body }
-
-  content-aside:
-    background: navy
-    areas: ["title title", "body aside"]
-    rows: "auto 1fr"
-    cols: "1.45fr 1fr"
-    gap: "3em"
-    slots:
-      title: { type: title, style: { size: h1, weight: "800" } }
-      body:  { type: body }
-      aside: { type: body, style: { color: muted, size: caption } }
-
-  two-col:
-    background: navy
-    areas: ["title title", "left right"]
-    rows: "auto 1fr"
-    cols: "1fr 1fr"
-    gap: "3em"
-    slots:
-      title: { type: title, style: { size: h1, weight: "800" } }
-      left:  { type: body }
-      right: { type: body }
-
-  team:
-    background: team
-    areas:
-      - "title title"
-      - "lname rname"
-      - "lbio  rbio"
-      - "logos logos"
-    rows: "auto 400px 1fr auto"
-    cols: "1fr 1fr"
-    gap: "0.2em 2.4em"
-    slots:
-      title: { type: title, style: { size: "54px", weight: "800" } }
-      lname: { type: title, style: { size: "72px", weight: "800", leading: "0.95", valign: center } }
-      lbio:  { type: body,  style: { size: "28px", color: muted, valign: top } }
-      rname: { type: title, style: { size: "72px", weight: "800", leading: "0.95", valign: center } }
-      rbio:  { type: body,  style: { size: "28px", color: muted, valign: top } }
-      logos: { type: body,  style: { valign: bottom } }
-
-  closing:
-    chrome: false
-    background: paper
-    align: center
-    areas: ["card"]
-    rows: "1fr"
-    cols: "1fr"
-    slots:
-      card: { type: body, style: { box: ink, color: white, align: center, valign: center, justify: center, maxw: "60%" } }
-
-  section:
-    background: navy
-    align: center
-    areas: ["title"]
-    rows: "1fr"
-    slots:
-      title: { type: title, style: { size: hero, weight: "800", align: center } }
-
-  media-split:
-    background: navy
-    areas: ["media copy"]
-    rows: "1fr"
-    cols: "1.25fr 1fr"
-    gap: "3.4em"
-    slots:
-      media: { type: media }
-      copy:  { type: body, style: { valign: center } }

package/skills/slaide/examples/sample.slaide

@@ -1,98 +0,0 @@
----
-master: ../themes/aurora.slaide.yaml
-title: slaide — Q3 Roadmap
-author: The slaide team
-~transition: slide-left
----
-layout: cover
-transition: fade
----
-:: title ::
-slaide
-
-:: subtitle ::
-slides that AI can actually write — and humans love to watch
-
-??? Open warm. The whole pitch: plain text in, beautiful deck out.
-
----
-layout: title-content
----
-## Why a new language
-
-- PowerPoint's `.pptx` is a zip of namespaced XML — **bulky and overloaded**   >>>
-- Markdown is what language models write most reliably   >>>
-- A forgiving parser means **no broken decks**   >>>
-- One small header defines the entire visual system   >>>
-
-??? Land the contrast: OOXML vs. a single readable file.
-
----
-layout: two-cols
----
-:: title ::
-## Input vs. output
-
-:: left ::
-**You write this**
-
-```
----
-layout: image-right
----
-## The pipeline
-1. Parse
-2. Compile
-3. Render
-```
-
-:: right ::
-**Your audience sees**
-
-> A typographic, animated, full-bleed presentation — on the web or as a crisp PDF.
-
----
-layout: image-right
-morph: hero
----
-:: title ::
-## The pipeline
-
-:: body ::
-1. **Parse** the deck + master   >>>
-2. **Compile** to a portable IR   >>>
-3. **Validate** against the schema   >>>
-4. **Render** to web or PDF   >>>
-
-:: image ::
-![Pipeline diagram](./assets/pipeline.svg){#hero}
-
----
-layout: image-left
-transition: morph
----
-:: title ::
-## One IR, many renderers
-
-:: image ::
-![Pipeline diagram](./assets/pipeline.svg){#hero}
-
-:: body ::
-The compiled **deck.ir.json** is the durable asset.
-
-Web and PDF are just *consumers* of it — so they can never drift apart.
-
----
-layout: quote
-variant: light
-transition: zoom
----
-:: quote ::
-> "The best format is the one your tools can write flawlessly **and** your audience never thinks about."
-
----
-layout: section
-transition: zoom
----
-:: title ::
-Let's build.