pdf 0.1.0 → 0.1.1

data/lib/pdf/header_evaluator.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Pdf
+  class HeaderEvaluator
+    def initialize(context, renderer)
+      @context = context
+      @renderer = renderer
+      @resolver = Resolver.new(context)
+    end
+
+    def evaluate(blueprint)
+      blueprint.elements.each { |el| evaluate_element(el) }
+    end
+
+    private
+
+    def evaluate_element(element)
+      type = element[:type]
+      args = element[:args]
+      options = element[:options]
+
+      case type
+      when :logo
+        component(:logo).render(args.first, **options)
+
+      when :qr_code
+        # QR code generates from data, not file path
+        data = @resolver.resolve(options[:data])
+        component(:qr_code).render(data: data, **options.except(:data))
+
+      when :context
+        lines = @resolver.resolve(args.first)
+        component(:context).render(lines, **options)
+
+      when :header_text
+        content = @resolver.resolve(args.first)
+        component(:paragraph).render(content, **options)
+
+      else
+        render_custom_component(type, args, options)
+      end
+    end
+
+    def render_custom_component(type, args, options)
+      return unless Pdf.component_registered?(type)
+
+      comp = component(type)
+      resolved_args = args.map { |a| @resolver.resolve(a) }
+      comp.render(*resolved_args, **options)
+    end
+
+    def component(type)
+      Pdf.component(type).new(@renderer.pdf)
+    end
+  end
+end

data/lib/pdf/layout.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Pdf
+  class Layout
+    class << self
+      def inherited(subclass)
+        subclass.instance_variable_set(:@header_blueprint, nil)
+        subclass.instance_variable_set(:@footer_blueprint, nil)
+        subclass.instance_variable_set(:@margins_config, Pdf::DEFAULT_MARGINS.dup)
+      end
+
+      def header(&block)
+        builder = Builders::HeaderBuilder.new
+        builder.instance_eval(&block)
+        @header_blueprint = builder.blueprint
+      end
+
+      def footer(&block)
+        builder = Builders::FooterBuilder.new
+        builder.instance_eval(&block)
+        @footer_blueprint = builder.blueprint
+      end
+
+      def margins(**options)
+        @margins_config = Pdf::DEFAULT_MARGINS.merge(options)
+      end
+
+      attr_reader :header_blueprint, :footer_blueprint
+
+      def margins_config
+        @margins_config || Pdf::DEFAULT_MARGINS
+      end
+    end
+
+    attr_reader :view
+
+    def initialize(view)
+      @view = view
+    end
+
+    def render(renderer)
+      renderer.setup(margins: self.class.margins_config)
+
+      render_header(renderer) if self.class.header_blueprint
+      view.render_content(renderer)
+      setup_footer(renderer) if self.class.footer_blueprint
+    end
+
+    private
+
+    def render_header(renderer)
+      evaluator = HeaderEvaluator.new(view, renderer)
+      evaluator.evaluate(self.class.header_blueprint)
+    end
+
+    def setup_footer(renderer)
+      evaluator = FooterEvaluator.new(view, renderer)
+      evaluator.setup(self.class.footer_blueprint)
+    end
+  end
+end

data/lib/pdf/renderer.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+require "prawn"
+require "prawn/table"
+
+module Pdf
+  # Default margins used by both Renderer and Layout
+  DEFAULT_MARGINS = { top: 72, right: 36, bottom: 72, left: 36 }.freeze
+
+  class Renderer
+    attr_reader :pdf
+
+    def initialize
+      @pdf = nil
+      @footer_callback = nil
+    end
+
+    def setup(margins: {})
+      m = Pdf::DEFAULT_MARGINS.merge(margins)
+      @pdf = Prawn::Document.new(
+        margin: [m[:top], m[:right], m[:bottom], m[:left]]
+      )
+      setup_fonts
+      self
+    end
+
+    def finalize
+      apply_footer if @footer_callback
+      @pdf.render
+    end
+
+    # --- Primitives ---
+
+    def text(content, **options)
+      @pdf.text content.to_s, **options
+    end
+
+    def text_box(content, at:, **options)
+      @pdf.text_box content.to_s, at: at, **options
+    end
+
+    def move_down(amount)
+      @pdf.move_down amount
+    end
+
+    def stroke_horizontal_rule
+      @pdf.stroke_horizontal_rule
+    end
+
+    def start_new_page
+      @pdf.start_new_page
+    end
+
+    def cursor
+      @pdf.cursor
+    end
+
+    def bounds
+      @pdf.bounds
+    end
+
+    def bounding_box(point, **options, &block)
+      @pdf.bounding_box(point, **options, &block)
+    end
+
+    def canvas(&block)
+      @pdf.canvas(&block)
+    end
+
+    def float(&block)
+      @pdf.float(&block)
+    end
+
+    # Image embedding - raises if file not found (no silent failures)
+    def image(path, **options)
+      raise Pdf::FileNotFoundError, "Image not found: #{path}" unless File.exist?(path)
+
+      @pdf.image path, **options
+    end
+
+    # Image from string data (for generated images like QR codes)
+    def image_data(data, **options)
+      @pdf.image StringIO.new(data), **options
+    end
+
+    def fill_color(color)
+      @pdf.fill_color color
+    end
+
+    def stroke_color(color)
+      @pdf.stroke_color color
+    end
+
+    def line_width(width)
+      @pdf.line_width width
+    end
+
+    def fill_and_stroke_rounded_rectangle(point, width, height, radius)
+      @pdf.fill_and_stroke_rounded_rectangle point, width, height, radius
+    end
+
+    def draw_text(content, at:, **options)
+      @pdf.draw_text content.to_s, at: at, **options
+    end
+
+    def width_of(content, **options)
+      @pdf.width_of content.to_s, **options
+    end
+
+    def height_of(content, **options)
+      @pdf.height_of content.to_s, **options
+    end
+
+    def table(data, **options, &block)
+      @pdf.table(data, **options, &block)
+    end
+
+    def page_number
+      @pdf.page_number
+    end
+
+    def page_count
+      @pdf.page_count
+    end
+
+    def repeat(page_filter, options = {}, &block)
+      @pdf.repeat(page_filter, options, &block)
+    end
+
+    # --- Escape hatch for direct Prawn access ---
+
+    def raw(&block)
+      yield @pdf
+    end
+
+    # --- Footer setup (deferred) ---
+
+    def setup_footer(&block)
+      @footer_callback = block
+    end
+
+    private
+
+    def setup_fonts
+      # Use Helvetica by default (built into Prawn)
+      # Users can override in their app
+    end
+
+    def apply_footer
+      @footer_callback&.call(@pdf)
+    end
+  end
+end

data/lib/pdf/resolver.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Pdf
+  class ResolutionError < StandardError; end
+
+  class Resolver
+    def initialize(context)
+      @context = context
+    end
+
+    def resolve(value)
+      case value
+      when Symbol then resolve_symbol(value)
+      when Proc then @context.instance_exec(&value)
+      when Array then value.map { |v| resolve(v) }
+      when Hash then value.transform_values { |v| resolve(v) }
+      else value
+      end
+    end
+
+    private
+
+    def resolve_symbol(sym)
+      if @context.respond_to?(sym, true)
+        return @context.send(sym)
+      end
+
+      if @context.respond_to?(:data) && @context.data.is_a?(Hash)
+        return @context.data[sym] if @context.data.key?(sym)
+        return @context.data[sym.to_s] if @context.data.key?(sym.to_s)
+      end
+
+      raise ResolutionError, "Cannot resolve :#{sym}"
+    end
+  end
+end

data/lib/pdf/version.rb

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

data/lib/pdf/view.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module Pdf
+  class View
+    class << self
+      def inherited(subclass)
+        # CRITICAL: Inherit parent's blueprint via dup, not empty blueprint
+        # This allows child views to extend parent views
+        parent_blueprint = @blueprint || Blueprint.new
+        subclass.instance_variable_set(:@blueprint, parent_blueprint.dup)
+        subclass.instance_variable_set(:@content_builder, nil)
+      end
+
+      def blueprint
+        @blueprint ||= Blueprint.new
+      end
+
+      def layout(klass)
+        blueprint.set_layout(klass)
+      end
+
+      # DSL methods - delegate to ContentBuilder
+      %i[title subtitle date heading paragraph span hr spacer alert table page_break].each do |method|
+        define_method(method) do |*args, **options, &block|
+          content_builder.send(method, *args, **options, &block)
+        end
+      end
+
+      def section(title_text, **options, &block)
+        content_builder.section(title_text, **options, &block)
+      end
+
+      def each(source, **options, &block)
+        content_builder.each(source, **options, &block)
+      end
+
+      def partial(method_name)
+        content_builder.partial(method_name)
+      end
+
+      def page_break_if(threshold:)
+        content_builder.page_break_if(threshold: threshold)
+      end
+
+      def render_if(condition, &block)
+        content_builder.render_if(condition, &block)
+      end
+
+      def render_unless(condition, &block)
+        content_builder.render_unless(condition, &block)
+      end
+
+      def raw(&block)
+        content_builder.raw(&block)
+      end
+
+      # Dynamic component support via DynamicComponents pattern
+      def method_missing(name, *args, **options, &block)
+        if Pdf.component_registered?(name)
+          content_builder.send(name, *args, **options, &block)
+        else
+          super
+        end
+      end
+
+      def respond_to_missing?(name, include_private = false)
+        Pdf.component_registered?(name) || super
+      end
+
+      private
+
+      def content_builder
+        @content_builder ||= Builders::ContentBuilder.new(blueprint)
+      end
+    end
+
+    attr_reader :data
+
+    def initialize(data = {})
+      @data = data.is_a?(Hash) ? symbolize_keys(data) : data
+    end
+
+    def to_pdf
+      renderer = Renderer.new
+      layout_class = self.class.blueprint.layout_class
+
+      if layout_class
+        layout = layout_class.new(self)
+        layout.render(renderer)
+      else
+        renderer.setup
+        render_content(renderer)
+      end
+
+      renderer.finalize
+    end
+
+    def to_file(path)
+      File.binwrite(path, to_pdf)
+    end
+
+    def render_content(renderer)
+      evaluator = ContentEvaluator.new(self, renderer)
+      evaluator.evaluate(self.class.blueprint)
+    end
+
+    private
+
+    def symbolize_keys(hash)
+      hash.transform_keys { |k| k.is_a?(String) ? k.to_sym : k }
+    end
+  end
+end

data/lib/pdf.rb

@@ -2,7 +2,80 @@
 
 require_relative "pdf/version"
 
+# Core
+require_relative "pdf/blueprint"
+require_relative "pdf/resolver"
+require_relative "pdf/component"
+require_relative "pdf/dynamic_components"
+require_relative "pdf/renderer"
+
+# Components
+require_relative "pdf/components/title"
+require_relative "pdf/components/subtitle"
+require_relative "pdf/components/heading"
+require_relative "pdf/components/paragraph"
+require_relative "pdf/components/span"
+require_relative "pdf/components/date"
+require_relative "pdf/components/hr"
+require_relative "pdf/components/spacer"
+require_relative "pdf/components/alert"
+require_relative "pdf/components/table"
+require_relative "pdf/components/logo"
+require_relative "pdf/components/qr_code"
+require_relative "pdf/components/context"
+
+# Builders
+require_relative "pdf/builders/content_builder"
+require_relative "pdf/builders/header_builder"
+require_relative "pdf/builders/footer_builder"
+
+# Evaluators
+require_relative "pdf/content_evaluator"
+require_relative "pdf/header_evaluator"
+require_relative "pdf/footer_evaluator"
+
+# View & Layout
+require_relative "pdf/view"
+require_relative "pdf/layout"
+
 module Pdf
   class Error < StandardError; end
-  # Your code goes here...
+  class FileNotFoundError < Error; end
+
+  class << self
+    def components
+      @components ||= {}
+    end
+
+    def register_component(name, klass)
+      unless klass < Component
+        raise ArgumentError, "#{klass} must inherit from Pdf::Component"
+      end
+
+      components[name.to_sym] = klass
+    end
+
+    def component(name)
+      components[name.to_sym] || raise(Error, "Unknown component: #{name}")
+    end
+
+    def component_registered?(name)
+      components.key?(name.to_sym)
+    end
+  end
+
+  # Register built-in components
+  register_component :title, Components::Title
+  register_component :subtitle, Components::Subtitle
+  register_component :heading, Components::Heading
+  register_component :paragraph, Components::Paragraph
+  register_component :span, Components::Span
+  register_component :date, Components::Date
+  register_component :hr, Components::Hr
+  register_component :spacer, Components::Spacer
+  register_component :alert, Components::Alert
+  register_component :table, Components::Table
+  register_component :logo, Components::Logo
+  register_component :qr_code, Components::QrCode
+  register_component :context, Components::Context
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pdf
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Ben
@@ -9,7 +9,91 @@ autorequire:
 bindir: exe
 cert_chain: []
 date: 2025-12-15 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: prawn-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: rqrcode
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
 description: A Ruby library for generating and manipulating PDF documents
 email:
 - ben@dee.mx
@@ -17,6 +101,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".claude/execution/00-overview.md"
+- ".claude/execution/01-core.md"
+- ".claude/execution/02-renderer.md"
+- ".claude/execution/03-components.md"
+- ".claude/execution/04-builders.md"
+- ".claude/execution/05-view-layout.md"
+- ".claude/execution/06-evaluators.md"
+- ".claude/execution/07-entry-extensibility.md"
+- ".claude/execution/08-integration-tests.md"
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
@@ -24,8 +117,40 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- examples/01_basic_invoice.rb
+- examples/02_report_with_layout.rb
+- examples/03_inherited_views.rb
+- examples/04_conditional_content.rb
+- examples/05_custom_components.rb
+- examples/README.md
 - lib/pdf.rb
+- lib/pdf/blueprint.rb
+- lib/pdf/builders/content_builder.rb
+- lib/pdf/builders/footer_builder.rb
+- lib/pdf/builders/header_builder.rb
+- lib/pdf/component.rb
+- lib/pdf/components/alert.rb
+- lib/pdf/components/context.rb
+- lib/pdf/components/date.rb
+- lib/pdf/components/heading.rb
+- lib/pdf/components/hr.rb
+- lib/pdf/components/logo.rb
+- lib/pdf/components/paragraph.rb
+- lib/pdf/components/qr_code.rb
+- lib/pdf/components/spacer.rb
+- lib/pdf/components/span.rb
+- lib/pdf/components/subtitle.rb
+- lib/pdf/components/table.rb
+- lib/pdf/components/title.rb
+- lib/pdf/content_evaluator.rb
+- lib/pdf/dynamic_components.rb
+- lib/pdf/footer_evaluator.rb
+- lib/pdf/header_evaluator.rb
+- lib/pdf/layout.rb
+- lib/pdf/renderer.rb
+- lib/pdf/resolver.rb
 - lib/pdf/version.rb
+- lib/pdf/view.rb
 - sig/pdf.rbs
 homepage: https://github.com/getnvoi/pdf
 licenses: