przn 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bc9623dc391c5dee0540aeca9adb3dd20ad090299e5ff5f9395a37fe7643416
-  data.tar.gz: 743ecab777fa5729e4fb23f1b140963060335e8f88a03760524637195fd99b17
+  metadata.gz: b33677433cd4802ee75ef9d7eb821d2dbb6faf8b1d2364d535b6aa28bffa6eb3
+  data.tar.gz: 930ecad39096eea771759134cd6c7e4a83c55a00ae98c59ead5afea1dcc46f17
 SHA512:
-  metadata.gz: 8db1ed813eb6ba4d9e40f49bc31064a1acc736e3b37fc2bdf28dd11bacf79fe396cb01e92cc2956f80f25ee978b8a256c600c82289aeefde4601e59ace3448d2
-  data.tar.gz: a6fafabc2e40c4b8d1bb20e82ad0098a9b25b3e7413ffe3ba77bc64e04208510df2ffdfb5cb328953476a15b58fffada16c9d2d7c7a30421747145205e6d150d
+  metadata.gz: 08eafdea3c2f55a29ccfd879b3bfa1541576be74fbb042cc33c527e39289e3dcf1375a10df033820e37f69e9f6726f580cd19ae468d633d73c9d65a23736674b
+  data.tar.gz: fcbf194e2a090de86a823fd8a0076977db73cf69f857cea6f4406f9fe31c2f44dab60120d61dbda7f10545e2fd750089df8e34233f0808fefd096bcec3cc25e1

data/README.md

@@ -25,13 +25,20 @@ Out-of-range numbers are clamped to the last slide, so `@9999` jumps to the end.
 
 ### PDF export
 
+Two flavors:
+
 ```
-przn --export your_slides.md
+przn --export your_slides.md                       # vector capture (default)
 przn --export pdf your_slides.md
 przn --export pdf -o output.pdf your_slides.md
+
+przn --export prawn your_slides.md                 # Prawn (headless fallback)
+przn --export prawn -o output.pdf your_slides.md
 ```
 
-Requires a TrueType font (with `glyf` outlines) for proper rendering. Prawn does not support CFF-based fonts (most `.otf` files). Fonts are auto-detected in this order: NotoSansJP TTF, HackGen, Arial Unicode.
+**`--export pdf`** (default) drives the live renderer for each slide and asks the terminal to save the rendered pane as a one-page **vector PDF**, then concatenates the per-slide PDFs into a single multi-page PDF. Output is an exact match of what's on screen — gradients, proportional fonts, OSC 66 sized text, custom bullets, all show up exactly as you'd see them — but vector, so the file stays small, scales infinitely, and text remains selectable. Requires running inside a terminal that implements the OSC 7772 `capture` command to a `.pdf` path (currently [Echoes](https://github.com/amatsuda/echoes)). The slides flicker through the visible pane during export.
+
+**`--export prawn`** is the headless fallback: it renders the deck directly into a vector PDF via Prawn, without touching the terminal. Useful for CI or environments where Echoes isn't available, but diverges from the on-screen rendering for any feature the live renderer adds (OSC 66 sized text, OSC 7772 backgrounds, proportional fonts). Requires a TrueType font (with `glyf` outlines) for proper rendering — Prawn does not support CFF-based fonts (most `.otf` files). Fonts are auto-detected in this order: NotoSansJP TTF, HackGen, Arial Unicode.
 
 ### Key bindings
 
@@ -249,39 +256,48 @@ Self-closing presentation flow marker, consumed at parse time:
 
 ## Theming
 
-Pass a YAML file via `--theme path/to/theme.yml`. All keys are optional — anything you don't set falls back to the defaults baked in at `default_theme.yml`.
+Theme resolution:
 
-```yaml
-colors:
-  background: "000000"
-  foreground: "ffffff"
-  heading:                # falls back to foreground
-  code_bg: "313244"
-  dim: "6c7086"
-  inline_code: "a6e3a1"
+1. **`theme.yml` in the deck's directory** — loaded automatically if present. No flag needed.
+2. **`--theme path/to/your.yml`** — overrides step 1 with any other file you point to.
+3. **`default_theme.yml`** (the file bundled with the gem) — used when neither of the above is found.
 
+All keys are optional — anything you don't set falls back to the bundled defaults.
+
+```yaml
 font:
   family:                 # body text font; terminal: OSC 66 f=, PDF: Prawn font
   size: 18                # base PDF font size in pt
+  color:                  # body text color; named ANSI or 6-digit hex
 
-bullet: "・"              # unordered-list marker; also h2–h6 prefix
-bullet_size:              # OSC 66 scale (1–7) for the bullet glyph
+title:                    # h1 typography (slide titles)
+  family:                 # font family
+  size:                   # OSC 66 scale: numeric (1–7) or named (xx-small … xxxx-large); default x-large
+  color:                  # named ANSI or 6-digit hex
 
-heading_face:             # font family for h1 (slide titles)
+bullet:                   # unordered-list marker; also h2–h6 prefix
+  text: "・"              # the glyph
+  size:                   # OSC 66 scale (1–7) for the bullet; default = body text's scale
 
-bg:                       # default slide background (Echoes OSC 7772)
+background:               # default slide background (Echoes OSC 7772)
   color:                  # solid, e.g. "#1a1a2e"
   from:                   # gradient endpoint
   to:                     # gradient endpoint
   angle:                  # gradient angle in degrees
+
+colors:
+  code_bg: "313244"
+  dim: "6c7086"
+  inline_code: "a6e3a1"
 ```
 
 Notes:
 
-- **`bullet`** / **`bullet_size`** — `bullet` is the character; `bullet_size` is the OSC 66 scale used to render it. When smaller than the body text scale, the bullet is rendered with fractional scaling and vertical centering so it still aligns with the body line.
+- **`font.color`** — deck-wide default text color (terminal: ANSI fg; PDF: Prawn fg). Inline `<color=...>` / `<font color="...">` runs still win per-segment.
+- **`bullet`** — `bullet.text` is the character; `bullet.size` is the OSC 66 scale used to render it. When `bullet.size` is smaller than the body text scale, the bullet is rendered with fractional scaling and vertical centering so it still aligns with the body line.
 - **`font.family`** — applied to body text (terminal: via OSC 66 `f=`, requires Echoes; PDF: registered via fontconfig). Inline `<font face="...">` runs override it per-segment.
-- **`heading_face`** — independent from `font.family`. h1 uses `heading_face` if set, else falls back to the terminal's default font (it does **not** silently inherit `font.family`). h2–h6 are body text. When the chosen face is proportional, every h1 OSC 66 sequence is emitted with `h=2` so a terminal that honors centered horizontal alignment ([Echoes](https://github.com/amatsuda/echoes)) keeps the title visually centered against its reserved cell block.
-- **`bg`** — the deck-wide default background. A per-slide `<bg .../>` directive overrides it for that slide.
+- **`title`** — h1 typography. Each attribute is independent from `font`: `title.family` does **not** inherit `font.family`, `title.color` does **not** inherit `font.color`. `title.size` defaults to x-large (OSC 66 `s=4`). When `title.family` is proportional, every h1 OSC 66 sequence is emitted with `h=2` so a terminal that honors centered horizontal alignment ([Echoes](https://github.com/amatsuda/echoes)) keeps the title visually centered against its reserved cell block. h2–h6 stay body text.
+- **`background`** — the deck-wide default background. A per-slide `<bg .../>` directive overrides it for that slide. The Prawn fallback paints the PDF page in `background.color` when set; otherwise it leaves the page Prawn's default (white).
 
 ## License
 

data/default_theme.yml

@@ -1,31 +1,35 @@
-# Default przn theme
+# Default przn theme. Used when there's neither a `theme.yml` alongside the
+# deck nor a `--theme path/to/file.yml` flag.
 #
-# Copy this file and pass your copy via --theme to customize.
+# To customize: drop a `theme.yml` next to your deck (loaded automatically),
+# or pass `--theme path/to/your.yml` to override that.
 # All keys are optional — unspecified values fall back to these defaults.
 
-colors:
-  background: "000000"
-  foreground: "ffffff"
-  heading:              # falls back to foreground
-  code_bg: "313244"
-  dim: "6c7086"
-  inline_code: "a6e3a1"
-
 font:
   family:               # body text font; terminal: OSC 66 f= (Echoes); PDF: Prawn font (auto-detected if blank)
   size: 18              # base font size in pt for PDF export
+  color:                # body text color (terminal: ANSI fg, PDF: Prawn fg); named ANSI or 6-digit hex
 
-bullet: "・"            # used as the unordered-list marker and the h2–h6 heading prefix
-bullet_size:            # OSC 66 scale (1–7) for the bullet glyph; default = the body text's scale
+title:                  # h1 typography (slide titles); each attribute is independent of `font`
+  family:               # font family (terminal: OSC 66 f=, requires Echoes)
+  size:                 # OSC 66 scale: numeric (1–7) or named (xx-small … xxxx-large); default x-large (4)
+  color:                # named ANSI or 6-digit hex; falls back to the terminal's default fg when unset
 
-heading_face:           # font family for h1 (slide titles); inline <font face="..."> still wins per-run
+bullet:                 # unordered-list marker; also h2–h6 heading prefix
+  text: "・"            # the glyph
+  size:                 # OSC 66 scale (1–7) for the bullet; default = body text's scale
 
 # Default slide background, applied when a slide has no <bg .../> directive.
 # Echoes-only (OSC 7772). Use either `color` (solid) or `from`/`to`/`angle`
 # (linear gradient). Both unset = no background override.
-bg:
+background:
   color:                # solid color, e.g. "#1a1a2e"
   from:                 # gradient endpoint, e.g. "#1a1a2e"
   to:                   # gradient endpoint, e.g. "#16213e"
   angle:                # gradient angle in degrees (0 = left→right, 90 = bottom→top)
   type:                 # gradient type; defaults to "linear"
+
+colors:
+  code_bg: "313244"
+  dim: "6c7086"
+  inline_code: "a6e3a1"

data/exe/przn

@@ -8,7 +8,7 @@ require 'optparse'
 options = {}
 OptionParser.new do |opts|
   opts.banner = "Usage: przn [options] <presentation.md>"
-  opts.on('--export [FORMAT]', 'Export to a format (default: pdf)') { |v|
+  opts.on('--export [FORMAT]', 'Export to a format (pdf | prawn; default: pdf)') { |v|
     if v && v.end_with?('.md')
       ARGV.unshift(v)
       options[:export] = 'pdf'
@@ -42,11 +42,19 @@ unless file
   exit 1
 end
 
-theme = options[:theme] ? Przn::Theme.load(options[:theme]) : nil
+theme = if options[:theme]
+  Przn::Theme.load(options[:theme])
+else
+  Przn::Theme.auto_discover(near: file)
+end
 
-if options[:export] == 'pdf'
+case options[:export]
+when 'pdf'
   output = options[:output] || File.basename(file, File.extname(file)) + '.pdf'
   Przn.export_pdf(file, output, theme: theme)
+when 'prawn'
+  output = options[:output] || File.basename(file, File.extname(file)) + '.pdf'
+  Przn.export_pdf_prawn(file, output, theme: theme)
 else
   Przn.start(file, theme: theme, start_at: start_at).run
 end

data/lib/przn/pdf_exporter.rb

@@ -55,12 +55,11 @@ module Przn
       @presentation = presentation
       @base_dir = base_dir
       @theme = theme || Theme.default
-      @bg_color = @theme.colors[:background]
-      @fg_color = @theme.colors[:foreground]
+      @bg_color = @theme.background && @theme.background[:color]
+      @fg_color = @theme.font[:color] || "000000"
       @code_bg = @theme.colors[:code_bg]
       @dim_color = @theme.colors[:dim]
       @inline_code_color = @theme.colors[:inline_code]
-      @heading_color = @theme.colors[:heading] || @fg_color
       base = (@theme.font[:size] || DEFAULT_FONT_SIZE).to_f
       ratio = base / DEFAULT_FONT_SIZE
       @scale_to_pt = DEFAULT_SCALE_TO_PT.transform_values { |v| v * ratio }
@@ -288,6 +287,8 @@ module Przn
     end
 
     def draw_background(pdf)
+      return unless @bg_color
+
       pdf.canvas do
         pdf.fill_color @bg_color
         pdf.fill_rectangle [0, PAGE_HEIGHT], PAGE_WIDTH, PAGE_HEIGHT
@@ -321,7 +322,7 @@ module Przn
         y - h - heading_margin(pt)
       else
         pt = @scale_to_pt[DEFAULT_SCALE]
-        prefix = [{text: bullet, size: pt, color: @heading_color, styles: [:bold]}]
+        prefix = [{text: bullet, size: pt, color: @fg_color, styles: [:bold]}]
         formatted = prefix + build_formatted_text(text, pt)
         h = render_formatted(pdf, formatted, at: [margin_x, y], width: content_width)
         y - h - 4
@@ -608,7 +609,7 @@ module Przn
     end
 
     def bullet
-      @font_registered ? @theme.bullet : "-"
+      @font_registered ? @theme.bullet[:text] : "-"
     end
 
   end

data/lib/przn/renderer.rb

@@ -101,7 +101,7 @@ module Przn
     # Other terminals ignore the OSC code, so this is a no-op outside Echoes.
     def apply_slide_background(slide)
       block = slide.blocks.find { |b| b[:type] == :bg }
-      attrs = block ? block[:attrs] : (@theme.bg || {})
+      attrs = block ? block[:attrs] : (@theme.background || {})
 
       @terminal.write "\e]7772;bg-clear\a"
       return if attrs.empty?
@@ -123,8 +123,10 @@ module Przn
       text = block[:content]
 
       if block[:level] == 1
-        scale = KittyText::HEADING_SCALES[1]
-        face = @theme.heading_face
+        title = @theme.title || {}
+        scale = (title[:size] && Parser::SIZE_SCALES[title[:size].to_s]) || KittyText::HEADING_SCALES[1]
+        face = title[:family]
+        color = title[:color]
         max_w = max_text_width(width, 0, scale)
         segments = Parser.parse_inline(text)
         wrapped = wrap_segments(segments, max_w, scale)
@@ -133,13 +135,13 @@ module Przn
           vis = segments_visible_cells(line_segs, scale)
           pad = [(width - vis) / 2, 0].max
           @terminal.move_to(row, pad + 1)
-          @terminal.write "#{ANSI[:bold]}#{render_segments_scaled(line_segs, scale, default_face: face, default_h: 2)}#{ANSI[:reset]}"
+          @terminal.write "#{ANSI[:bold]}#{render_segments_scaled(line_segs, scale, default_face: face, default_h: 2, default_color: color)}#{ANSI[:reset]}"
           row += scale
         end
         row + 4
       else
         left = content_left(width)
-        prefix = @theme.bullet
+        prefix = @theme.bullet[:text]
         prefix_w = display_width(prefix)
         max_w = max_text_width(width, left, DEFAULT_SCALE) - prefix_w
         segments = Parser.parse_inline(text)
@@ -205,7 +207,7 @@ module Przn
       block[:items].each do |item|
         depth = item[:depth] || 0
         indent = "  " * depth
-        prefix = "#{indent}#{@theme.bullet}"
+        prefix = "#{indent}#{@theme.bullet[:text]}"
         prefix_w = display_width(prefix)
         max_w = max_text_width(width, left, DEFAULT_SCALE) - prefix_w
 
@@ -465,7 +467,7 @@ module Przn
     # centered. Plain `s=N` for a smaller bullet would top-align it inside
     # the row, which looks wrong against the larger body text.
     def render_bullet(prefix)
-      size = @theme.bullet_size
+      size = @theme.bullet[:size]
       if size && size < DEFAULT_SCALE
         KittyText.sized(prefix, s: DEFAULT_SCALE, n: size, d: DEFAULT_SCALE, v: 2)
       else
@@ -485,22 +487,25 @@ module Przn
       "#{color_code(color)}#{base}#{ANSI[:reset]}"
     end
 
-    # `default_face:` lets a caller (currently h1 rendering) override every
-    # OSC 66 emit's `f=` attribute. When unset, body text falls back to
-    # `theme.font.family`. To opt out of that body fallback (so a heading can
-    # render in the terminal's default font when its own `heading_face` is
-    # unset), pass `default_face:` explicitly — even `nil` is honored.
-    # Inline `<font face="...">` runs still win for their own segments.
+    # `default_face:` / `default_color:` let a caller (currently h1 rendering)
+    # override the OSC 66 `f=` and the ANSI fg for every emit on the line.
+    # When unset, body text falls back to `theme.font.family` / `theme.font.color`.
+    # To opt out of that body fallback (so a heading can render in the
+    # terminal's defaults even when body text is themed), pass the keyword
+    # explicitly — even `nil` is honored. Inline `<font face/color>` and
+    # `<color=...>` runs still win for their own segments.
     #
     # `default_h:` threads an OSC 66 `h=` (horizontal alignment) into every
-    # emit on the line. h1 uses h=2 so a proportional `heading_face` is
+    # emit on the line. h1 uses h=2 so a proportional `title.family` is
     # centered within the reserved cell block — without it the glyphs left-
     # align inside the block and the visible text drifts left of the center
     # column we computed.
-    def render_segments_scaled(segments, para_scale, default_face: :body, default_h: nil)
+    def render_segments_scaled(segments, para_scale, default_face: :body, default_h: nil, default_color: :body)
       f = default_face == :body ? @theme.font[:family] : default_face
       h = default_h
-      segments.map { |segment|
+      c = default_color == :body ? @theme.font[:color] : default_color
+      body_open = c ? color_code(c) : ""
+      inner = segments.map { |segment|
         type = segment[0]
         content = segment[1]
         case type
@@ -509,19 +514,20 @@ module Przn
           if (scale = Parser::SIZE_SCALES[tag_name])
             KittyText.sized(content, s: scale, f: f, h: h)
           elsif Parser::NAMED_COLORS.key?(tag_name)
-            "#{color_code(tag_name)}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}"
+            "#{color_code(tag_name)}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
           else
             KittyText.sized(content, s: para_scale, f: f, h: h)
           end
-        when :font          then render_font_segment(content, segment[2] || {}, para_scale, default_face: f, default_h: h)
-        when :note          then "#{ANSI[:dim]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}"
-        when :bold          then "#{ANSI[:bold]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}"
-        when :italic        then "#{ANSI[:italic]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}"
-        when :strikethrough then "#{ANSI[:strikethrough]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}"
-        when :code          then "#{ANSI[:gray_bg]}#{KittyText.sized(" #{content} ", s: para_scale, f: f, h: h)}#{ANSI[:reset]}"
+        when :font          then "#{render_font_segment(content, segment[2] || {}, para_scale, default_face: f, default_h: h)}#{(segment[2] || {})[:color] ? body_open : ''}"
+        when :note          then "#{ANSI[:dim]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
+        when :bold          then "#{ANSI[:bold]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
+        when :italic        then "#{ANSI[:italic]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
+        when :strikethrough then "#{ANSI[:strikethrough]}#{KittyText.sized(content, s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
+        when :code          then "#{ANSI[:gray_bg]}#{KittyText.sized(" #{content} ", s: para_scale, f: f, h: h)}#{ANSI[:reset]}#{body_open}"
         when :text          then KittyText.sized(content, s: para_scale, f: f, h: h)
         end
       }.join
+      body_open.empty? ? inner : "#{body_open}#{inner}#{ANSI[:reset]}"
     end
 
     def render_inline_scaled(text, para_scale)

data/lib/przn/screenshot_pdf_exporter.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require 'tmpdir'
+require 'fileutils'
+
+module Przn
+  # Renders each slide live to the user's terminal, asks the terminal to save
+  # the current pane as a vector PDF via Echoes' OSC 7772 `capture` command,
+  # then concatenates the per-slide PDFs into a single multi-page PDF.
+  #
+  # Trade-off vs the Prawn-based PdfExporter:
+  #   - Pixel-perfect match with what's on screen (gradients, fonts, OSC 66
+  #     sized text, bullet glyphs, the lot) — but vector, so the result is
+  #     small, sharp at any zoom, and text stays selectable.
+  #   - Requires running inside a terminal that implements OSC 7772 capture
+  #     to a `.pdf` path (i.e. Echoes). Won't work in CI or any terminal that
+  #     doesn't honor the command.
+  #
+  # Echoes-side wire format (independent of przn):
+  #   ESC ] 7772 ; capture ; <absolute_path> BEL
+  #   On receipt, Echoes saves the current pane to the path. The file
+  #   extension picks the format — `.pdf` produces a single-page vector PDF
+  #   by replaying the same drawing pipeline into a CGPDFContext instead of
+  #   the screen's NSGraphicsContext.
+  class ScreenshotPdfExporter
+    OSC = "\e]7772".freeze
+    BEL = "\a".freeze
+
+    POLL_INTERVAL = 0.05  # seconds between file-existence checks
+    CAPTURE_TIMEOUT = 10  # seconds per slide before giving up
+
+    def initialize(presentation, base_dir: '.', theme: nil, terminal: nil)
+      @presentation = presentation
+      @base_dir = base_dir
+      @theme = theme || Theme.default
+      @terminal = terminal || Terminal.new
+      @renderer = Renderer.new(@terminal, base_dir: base_dir, theme: theme)
+    end
+
+    def export(output_path)
+      require 'hexapdf'
+
+      Dir.mktmpdir('przn-capture') do |dir|
+        pdf_paths = capture_all_slides(dir)
+        merge_pdfs(pdf_paths, output_path)
+      end
+    end
+
+    private
+
+    def capture_all_slides(dir)
+      paths = []
+      @terminal.enter_alt_screen
+      @terminal.hide_cursor
+      @presentation.slides.each_with_index do |slide, i|
+        pdf_path = File.join(dir, format("slide-%04d.pdf", i))
+        @renderer.render(slide, current: i, total: @presentation.total)
+        request_capture(pdf_path)
+        wait_for_capture(pdf_path)
+        paths << pdf_path
+      end
+      paths
+    ensure
+      @terminal.write "#{OSC};bg-clear#{BEL}"
+      @terminal.show_cursor
+      @terminal.leave_alt_screen
+      @terminal.flush
+    end
+
+    def request_capture(path)
+      @terminal.write "#{OSC};capture;#{path}#{BEL}"
+      @terminal.flush
+    end
+
+    def wait_for_capture(path)
+      deadline = Time.now + CAPTURE_TIMEOUT
+      until File.exist?(path) && File.size?(path).to_i.positive?
+        if Time.now > deadline
+          raise "Capture timed out for #{path}. " \
+                "Is Echoes running and recent enough to honor OSC 7772 `capture` to a .pdf path?"
+        end
+        sleep POLL_INTERVAL
+      end
+      # Small grace period to ensure the PDF write is fully flushed.
+      sleep POLL_INTERVAL
+    end
+
+    def merge_pdfs(pdf_paths, output_path)
+      raise "No slides captured" if pdf_paths.empty?
+
+      output = HexaPDF::Document.new
+      pdf_paths.each do |path|
+        src = HexaPDF::Document.open(path)
+        src.pages.each do |page|
+          output.pages << output.import(page)
+        end
+      end
+      output.write(output_path)
+    end
+  end
+end

data/lib/przn/theme.rb

@@ -6,7 +6,7 @@ module Przn
   class Theme
     DEFAULT_PATH = File.expand_path('../../../default_theme.yml', __FILE__)
 
-    attr_reader :colors, :font, :bullet, :bullet_size, :bg, :heading_face
+    attr_reader :colors, :font, :bullet, :background, :title
 
     def self.load(path)
       raise ArgumentError, "Theme file not found: #{path}" unless File.exist?(path)
@@ -16,10 +16,9 @@ module Przn
       merged = {
         colors: defaults[:colors].merge(overrides[:colors] || {}),
         font: defaults[:font].merge(overrides[:font] || {}),
-        bullet: overrides[:bullet] || defaults[:bullet],
-        bullet_size: overrides[:bullet_size] || defaults[:bullet_size],
-        bg: defaults[:bg].merge(overrides[:bg] || {}),
-        heading_face: overrides[:heading_face] || defaults[:heading_face],
+        bullet: defaults[:bullet].merge(overrides[:bullet] || {}),
+        background: defaults[:background].merge(overrides[:background] || {}),
+        title: defaults[:title].merge(overrides[:title] || {}),
       }
       new(merged)
     end
@@ -28,15 +27,23 @@ module Przn
       new(load_yaml(DEFAULT_PATH))
     end
 
+    # Look for a sibling `theme.yml` next to the given file and load it if
+    # present, so a deck can ship its theme alongside the markdown without
+    # the user having to pass `--theme` explicitly. Returns nil if no file
+    # is found.
+    def self.auto_discover(near:)
+      candidate = File.join(File.dirname(File.expand_path(near)), 'theme.yml')
+      File.exist?(candidate) ? load(candidate) : nil
+    end
+
     def self.load_yaml(path)
       data = YAML.safe_load_file(path, symbolize_names: true) || {}
       {
         colors: data[:colors] || {},
         font: data[:font] || {},
-        bullet: data[:bullet],
-        bullet_size: data[:bullet_size],
-        bg: (data[:bg] || {}).compact,
-        heading_face: data[:heading_face],
+        bullet: (data[:bullet] || {}).compact,
+        background: (data[:background] || {}).compact,
+        title: (data[:title] || {}).compact,
       }
     end
     private_class_method :load_yaml
@@ -45,9 +52,8 @@ module Przn
       @colors = config[:colors]
       @font = config[:font]
       @bullet = config[:bullet]
-      @bullet_size = config[:bullet_size]
-      @bg = config[:bg]
-      @heading_face = config[:heading_face]
+      @background = config[:background]
+      @title = config[:title]
     end
   end
 end

data/lib/przn/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Przn
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/przn.rb

@@ -10,6 +10,7 @@ require_relative "przn/terminal"
 require_relative "przn/renderer"
 require_relative "przn/controller"
 require_relative "przn/pdf_exporter"
+require_relative "przn/screenshot_pdf_exporter"
 require_relative "przn/theme"
 
 module Przn
@@ -25,7 +26,25 @@ module Przn
     Controller.new(presentation, terminal, renderer)
   end
 
+  # Default PDF export: drives the live renderer, asks the terminal to save
+  # each rendered slide as a one-page vector PDF via OSC 7772 `capture`,
+  # then concatenates the per-slide PDFs into a single multi-page PDF.
+  # Requires Echoes (or any terminal that implements the same capture
+  # command); use `export_pdf_prawn` instead for environments where that's
+  # not possible (CI, headless).
   def self.export_pdf(file, output, theme: nil)
+    markdown = File.read(file)
+    presentation = Parser.parse(markdown)
+    base_dir = File.dirname(File.expand_path(file))
+    ScreenshotPdfExporter.new(presentation, base_dir: base_dir, theme: theme).export(output)
+    puts "Generated: #{output}"
+  end
+
+  # Legacy PDF export via Prawn — renders the deck directly into a vector
+  # PDF without touching the terminal. Diverges from what's on screen for
+  # any feature the live renderer adds (OSC 66 sized text, OSC 7772
+  # backgrounds, proportional fonts) but works headlessly.
+  def self.export_pdf_prawn(file, output, theme: nil)
     markdown = File.read(file)
     presentation = Parser.parse(markdown)
     base_dir = File.dirname(File.expand_path(file))

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: przn
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
   - Akira Matsuda
@@ -25,6 +25,22 @@ dependencies:
           - ">="
           - !ruby/object:Gem::Version
             version: "0"
+  - !ruby/object:Gem::Dependency
+    name: hexapdf
+    requirement: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ">="
+          - !ruby/object:Gem::Version
+            version: "0"
+    type: :runtime
+    prerelease: false
+    version_requirements: !ruby/object:Gem::Requirement
+      requirements:
+        -
+          - ">="
+          - !ruby/object:Gem::Version
+            version: "0"
 description: A terminal-based presentation tool that renders Markdown slides with Kitty text sizing protocol support for beautifully scaled headers
 email:
   - ronnie@dio.jp
@@ -46,6 +62,7 @@ files:
   - lib/przn/pdf_exporter.rb
   - lib/przn/presentation.rb
   - lib/przn/renderer.rb
+  - lib/przn/screenshot_pdf_exporter.rb
   - lib/przn/slide.rb
   - lib/przn/terminal.rb
   - lib/przn/theme.rb