hadar 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4faa68921b499534d3fd9985fa24680fa9a63bd95664bb808e7f1d072527ea75
-  data.tar.gz: e9c02868a90d8e5f479cef86f1b1a76d826c34509c71a2c6ef9c1dda76b10c2f
+  metadata.gz: d7b4c769b40f5836617885858a50bc58e93ef8072b97430520ec2315ed81edbb
+  data.tar.gz: e8379cf1cc2f8039429d0fba6a650d8d7f059801e30c0df69864bf5ed94be8b0
 SHA512:
-  metadata.gz: 6f3a0b49bcd1a6a8d436421cc05965bcf6e6ca71910810d2e0c05a49b3e97949dc49248e7352b184b251ca3f5d654a1a844683791238e4c6684abb03abb9daeb
-  data.tar.gz: c79aaf224353506b80a6a7d0162fcc935fa9201d39a55e877495c1807b47980d2d9788ecff65ae04810563aa828f1a10c0cdca138e0b1fd01ad13bda5c0c3364
+  metadata.gz: b44313439e6fcc8a411c8b7fbc379a2050c843b8758dfa42352c4f007f5334141b45ced44d8d139a14dc030332d826744feaab621678e7e671760710f2ee1edd
+  data.tar.gz: 46f5d21160a6b804ba95067906abcc9f0277bf263a5aa51281ebe93ae0c1712982d8ebf0f328a3ca0dc2670a3f0a7573d67509b75f1787f6f477a64de1714d61

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.0 - 2026-09-24
+
+- Add APNG export for slide decks.
+
 ## 0.1.0 - 2026-09-23
 
 - Initial release.

data/README.md

@@ -23,8 +23,8 @@ Missing, unreadable, and unsupported images fail preview construction with a
 saving continues to write only the Markdown source. Its window host polls for
 external Markdown edits and can show a next-slide, notes, and elapsed-time
 presenter view. The host supports slide navigation, fullscreen, a fuzzy command
-palette, and PNG-sequence export. When a secondary display is available, the
-owned presenter window opens there fullscreen.
+palette, PNG-sequence, and APNG export. When a secondary display is available,
+the owned presenter window opens there fullscreen.
 
 ## Installation
 
@@ -160,6 +160,13 @@ Zaniah's headless renderer. It refuses to overwrite existing frames:
 app.export_png_sequence("slides-png", width: 1280, height: 720)
 ```
 
+Animated PNG export holds each slide for three seconds by default, loops forever,
+and refuses to replace an existing target unless `overwrite: true` is passed:
+
+```ruby
+app.export_apng("slides.apng", width: 1280, height: 720, duration_ms: 2500)
+```
+
 Speaker notes can be written as a one-line or multiline HTML comment. Their
 Markdown remains in the source unchanged and does not appear in slide slots or
 the preview tree:
@@ -219,15 +226,15 @@ directory rather than copying the file.
 `Zaniah::UniformList`; `build(width:, height:)` returns the Zaniah element for
 embedding in an application layout. Its `select(index)` method updates the
 selection and invokes the optional `on_select` callback. Wezen is not involved
-in live thumbnails; it encodes raster frames for export workflows.
+in live thumbnails; it encodes rendered slide frames as APNG.
 
 ## Development
 
 Run the specs with `bundle exec rake`. Check the 100-slide virtual-list
 layout/scene-build budget with `BUDGET=1 bundle exec ruby bench/slide_list.rb`;
 the headless benchmark skips software pixel rasterization. Hadar depends on
-Beid, Antares, Kochab, Okab, Spica, Xamidimura, and Zaniah; its declarative `Describe`,
-`UniformList`, and input keymap APIs are reused directly.
+Beid, Antares, Kochab, Okab, Spica, Wezen, Xamidimura, and Zaniah; its
+declarative `Describe`, `UniformList`, and input keymap APIs are reused directly.
 
 ## License
 

data/lib/hadar/application.rb

@@ -115,7 +115,12 @@ module Hadar
     def command_palette = @command_palette
 
     def export_png_sequence(directory, width: 1280, height: 720)
-      PNGSequence.write(deck, directory, renderer: renderer, width: width, height: height)
+      Export::PNGSequence.write(deck, directory, renderer: renderer, width: width, height: height)
+    end
+
+    def export_apng(path, width: 1280, height: 720, duration_ms: Export::APNG::DEFAULT_DURATION_MS, loop: 0, overwrite: false)
+      Export::APNG.write(deck, path, renderer: renderer, width: width, height: height,
+        duration_ms: duration_ms, loop: loop, overwrite: overwrite)
     end
 
     def save(path = nil, overwrite: false)
@@ -393,7 +398,8 @@ module Hadar
         "Toggle presentation" => ->(*) { presenter.started? ? stop_presentation : start_presentation },
         "Toggle fullscreen" => ->(*) { toggle_fullscreen(window: :main) },
         "Save" => ->(*) { save },
-        "Export PNG sequence…" => ->(*) { prompt_png_sequence_directory }
+        "Export PNG sequence…" => ->(*) { prompt_png_sequence_directory },
+        "Export APNG…" => ->(*) { prompt_apng_path }
       }
     end
 
@@ -406,6 +412,18 @@ module Hadar
       export_png_sequence(directory) if directory && !directory.empty?
     end
 
+    def prompt_apng_path
+      unless @main_window.respond_to?(:prompt_for_paths)
+        raise Error, "this window backend cannot choose a file; call export_apng(path)"
+      end
+
+      path = @main_window.prompt_for_paths(save: true).first
+      return unless path && !path.empty?
+
+      path = "#{path}.apng" if File.extname(path).empty?
+      export_apng(path, overwrite: true)
+    end
+
     def slot_editor_for_selected_slide
       return [nil, nil] unless selected_index
       unless selected_slot_name

data/lib/hadar/export/apng.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require "tempfile"
+
+module Hadar
+  module Export
+    class APNG
+      MAX_PIXELS = 32_000_000
+      DEFAULT_DURATION_MS = 3_000
+
+      def self.render(deck, renderer: Renderer.new, width: 1280, height: 720,
+        duration_ms: DEFAULT_DURATION_MS, loop: 0)
+        raise TypeError, "deck must be a Hadar::Deck" unless deck.is_a?(Deck)
+        raise Error, "cannot export an empty deck" if deck.empty?
+        raise TypeError, "renderer must respond to build" unless renderer.respond_to?(:build)
+        unless [width, height].all? { |dimension| dimension.is_a?(Integer) && dimension.positive? } && width * height <= MAX_PIXELS
+          raise ArgumentError, "APNG dimensions must be positive integers totaling at most #{MAX_PIXELS} pixels"
+        end
+        raise ArgumentError, "duration_ms must be a positive Integer" unless duration_ms.is_a?(Integer) && duration_ms.positive?
+        if duration_ms / duration_ms.gcd(1_000) > 65_535
+          raise ArgumentError, "duration_ms exceeds the APNG frame-delay limit"
+        end
+        raise ArgumentError, "loop must be a non-negative Integer" unless loop.is_a?(Integer) && loop >= 0
+
+        animation = Wezen::Animation.new(width: width, height: height, loop: loop)
+        window = Zaniah::Platform.open_window(backend: :headless, width: width, height: height)
+        window.text_system = Zaniah::TextSystem::Renderer.new
+        deck.slides.each do |slide|
+          window.render(renderer.build(slide), clear: slide.theme.colors.fetch("background"))
+          animation.add(window.device.pixels, delay_ms: duration_ms)
+        end
+        Wezen::APNG.encode(animation)
+      ensure
+        window&.close
+      end
+
+      def self.write(deck, path, overwrite: false, **options)
+        raise TypeError, "path must be a String" unless path.is_a?(String)
+        raise ArgumentError, "path must not be empty or contain NUL" if path.empty? || path.include?("\0")
+        raise TypeError, "overwrite must be true or false" unless overwrite == true || overwrite == false
+
+        target = File.expand_path(path)
+        existing = begin
+          File.lstat(target)
+        rescue Errno::ENOENT
+          nil
+        end
+        raise Error, "refusing to write through a symbolic link" if existing&.symlink?
+        raise Error, "APNG target must be a regular file" if existing && !existing.file?
+        raise Error, "APNG target already exists; pass overwrite: true to replace it" if existing && !overwrite
+
+        bytes = render(deck, **options)
+        mode = existing ? existing.mode & 0o777 : (0o666 & ~File.umask)
+        Tempfile.create([".#{File.basename(target)}.", ".tmp"], File.dirname(target)) do |file|
+          file.binmode
+          file.write(bytes)
+          file.flush
+          file.chmod(mode)
+          file.fsync
+          file.close
+          overwrite ? File.rename(file.path, target) : File.link(file.path, target)
+        end
+        path
+      rescue SystemCallError => error
+        raise Error, "cannot write APNG: #{error.message}"
+      end
+    end
+  end
+end

data/lib/hadar/version.rb

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

data/lib/hadar.rb

@@ -7,6 +7,7 @@ require "antares"
 require "kochab"
 require "okab"
 require "xamidimura"
+require "wezen"
 require "zaniah"
 require "zaniah/ui"
 
@@ -29,3 +30,4 @@ end
 
 require_relative "hadar/export/pdf"
 require_relative "hadar/export/png_sequence"
+require_relative "hadar/export/apng"

data/sig/hadar.rbs

@@ -131,6 +131,7 @@ module Hadar
     def main_view: (width: Numeric, height: Numeric) -> Zaniah::Element
     def command_palette: () -> CommandPalette?
     def export_png_sequence: (String directory, ?width: Integer, ?height: Integer) -> Array[String]
+    def export_apng: (String path, ?width: Integer, ?height: Integer, ?duration_ms: Integer, ?loop: Integer, ?overwrite: bool) -> String
     def save: (?String path, ?overwrite: bool) -> Deck
     def selected_slot: () -> Slot?
     def select_slot: (String | Symbol name) -> Slot
@@ -201,6 +202,16 @@ module Hadar
   end
 
   module Export
+    class APNG
+      MAX_PIXELS: Integer
+      DEFAULT_DURATION_MS: Integer
+
+      def self.render: (Deck deck, ?renderer: Renderer, ?width: Integer, ?height: Integer,
+        ?duration_ms: Integer, ?loop: Integer) -> String
+      def self.write: (Deck deck, String path, ?overwrite: bool, ?renderer: Renderer, ?width: Integer,
+        ?height: Integer, ?duration_ms: Integer, ?loop: Integer) -> String
+    end
+
     class PNGSequence
       MAX_PIXELS: Integer
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hadar
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -93,6 +93,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: wezen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 - !ruby/object:Gem::Dependency
   name: zaniah
   requirement: !ruby/object:Gem::Requirement
@@ -127,6 +141,7 @@ files:
 - lib/hadar/command_palette.rb
 - lib/hadar/deck.rb
 - lib/hadar/deck_watcher.rb
+- lib/hadar/export/apng.rb
 - lib/hadar/export/pdf.rb
 - lib/hadar/export/png_sequence.rb
 - lib/hadar/layout.rb
@@ -162,7 +177,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Markdown-backed presentation editor and preview
 test_files: []