pdf 0.1.0 → 0.1.1

data/examples/04_conditional_content.rb

@@ -0,0 +1,421 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Example 04: Conditional Content
+# Run: ruby examples/04_conditional_content.rb
+#
+# Demonstrates:
+# - render_if for conditional sections
+# - render_unless for inverse conditions
+# - Complex boolean logic in conditions
+# - Nested conditionals
+# - Dynamic content based on data state
+# - Different outputs from same view class
+
+require_relative "../lib/pdf"
+
+# --- Order Confirmation with Conditional Sections ---
+
+class OrderConfirmation < Pdf::View
+  title "Order Confirmation"
+  date :order_date
+
+  spacer amount: 10
+
+  # Order status alert - color varies by status
+  alert :status_alert
+
+  hr
+
+  section "Order Details" do
+    paragraph :order_info
+  end
+
+  section "Items Ordered" do
+    table :order_items, columns: [
+      { key: :name, label: "Item" },
+      { key: :qty, label: "Qty" },
+      { key: :price, label: "Price" }
+    ]
+  end
+
+  # Only show discount section if there's a discount
+  render_if(:has_discount) do
+    section "Discount Applied" do
+      alert :discount_alert
+    end
+  end
+
+  # Show gift message only for gift orders
+  render_if(:is_gift) do
+    section "Gift Message" do
+      paragraph :gift_message_text
+      render_if(:gift_wrap_selected) do
+        span "Gift wrapping: Yes (+$5.00)", size: 9, color: "666666"
+      end
+    end
+  end
+
+  section "Order Summary" do
+    paragraph :subtotal_text
+    render_if(:has_discount) do
+      paragraph :discount_text
+    end
+    render_if(:has_shipping_cost) do
+      paragraph :shipping_text
+    end
+    render_unless(:free_shipping) do
+      span "(Free shipping on orders over $100)", size: 8, color: "888888"
+    end
+    paragraph :tax_text
+    heading :total_text, size: 14
+  end
+
+  hr
+
+  # Shipping info only for physical orders
+  render_unless(:digital_only) do
+    section "Shipping Information" do
+      paragraph :shipping_address
+      paragraph :estimated_delivery
+
+      render_if(:express_shipping) do
+        alert title: "Express Shipping Selected", description: "Priority handling - 1-2 business days", color: "blue"
+      end
+
+      render_if(:signature_required) do
+        span "Signature required upon delivery", size: 9
+      end
+    end
+  end
+
+  # Digital delivery info for digital orders
+  render_if(:has_digital_items) do
+    section "Digital Delivery" do
+      paragraph :digital_delivery_text
+      render_if(:requires_activation) do
+        alert title: "Activation Required", description: "Product keys will be emailed within 24 hours", color: "orange"
+      end
+    end
+  end
+
+  # Loyalty section only for members
+  render_if(:loyalty_member) do
+    section "Loyalty Rewards" do
+      alert :loyalty_alert
+      paragraph :points_earned_text
+    end
+  end
+
+  # Special instructions if any
+  render_if(:has_special_instructions) do
+    section "Special Instructions" do
+      paragraph :special_instructions
+    end
+  end
+
+  spacer amount: 20
+
+  span :footer_text, size: 8, color: "666666"
+
+  # --- Condition Methods ---
+
+  def has_discount
+    (data[:discount_percent] || 0) > 0 || (data[:discount_amount] || 0) > 0
+  end
+
+  def is_gift
+    data[:gift] == true
+  end
+
+  def gift_wrap_selected
+    data[:gift_wrap] == true
+  end
+
+  def has_shipping_cost
+    !digital_only && (data[:shipping_cost] || 0) > 0
+  end
+
+  def free_shipping
+    digital_only || subtotal >= 10000 # $100 in cents
+  end
+
+  def digital_only
+    data[:items]&.all? { |i| i[:digital] }
+  end
+
+  def has_digital_items
+    data[:items]&.any? { |i| i[:digital] }
+  end
+
+  def express_shipping
+    data[:shipping_method] == "express"
+  end
+
+  def signature_required
+    data[:signature_required] == true
+  end
+
+  def requires_activation
+    data[:items]&.any? { |i| i[:requires_activation] }
+  end
+
+  def loyalty_member
+    data[:loyalty_tier].to_s.length > 0
+  end
+
+  def has_special_instructions
+    data[:special_instructions].to_s.strip.length > 0
+  end
+
+  # --- Data Methods ---
+
+  def order_date
+    data[:date] || Date.today
+  end
+
+  def status_alert
+    status = data[:status] || "pending"
+    colors = { "confirmed" => "green", "processing" => "blue", "pending" => "orange", "on_hold" => "red" }
+    {
+      title: "Order Status: #{status.capitalize}",
+      description: status_description(status),
+      color: colors[status] || "blue"
+    }
+  end
+
+  def order_info
+    "Order #: #{data[:order_id]}\nCustomer: #{data[:customer_name]}\nEmail: #{data[:email]}"
+  end
+
+  def order_items
+    data[:items].map do |item|
+      {
+        name: item[:name] + (item[:digital] ? " (Digital)" : ""),
+        qty: item[:quantity],
+        price: format_currency(item[:price_cents] * item[:quantity])
+      }
+    end
+  end
+
+  def discount_alert
+    if data[:discount_percent]
+      { title: "#{data[:discount_percent]}% Off Applied!", description: "Code: #{data[:discount_code]}", color: "green" }
+    else
+      { title: "Discount: #{format_currency(data[:discount_amount])}", description: "Code: #{data[:discount_code]}", color: "green" }
+    end
+  end
+
+  def gift_message_text
+    "\"#{data[:gift_message]}\"\n- #{data[:gift_from] || 'Anonymous'}"
+  end
+
+  def subtotal_text
+    "Subtotal: #{format_currency(subtotal)}"
+  end
+
+  def discount_text
+    amount = data[:discount_percent] ? (subtotal * data[:discount_percent] / 100.0).round : data[:discount_amount]
+    "Discount: -#{format_currency(amount)}"
+  end
+
+  def shipping_text
+    "Shipping: #{format_currency(data[:shipping_cost])}"
+  end
+
+  def tax_text
+    "Tax: #{format_currency(data[:tax_cents] || 0)}"
+  end
+
+  def total_text
+    "TOTAL: #{format_currency(calculate_total)}"
+  end
+
+  def shipping_address
+    addr = data[:shipping_address]
+    "#{addr[:name]}\n#{addr[:street]}\n#{addr[:city]}, #{addr[:state]} #{addr[:zip]}\n#{addr[:country]}"
+  end
+
+  def estimated_delivery
+    days = express_shipping ? "1-2" : "5-7"
+    "Estimated Delivery: #{days} business days"
+  end
+
+  def digital_delivery_text
+    "Download links will be sent to: #{data[:email]}"
+  end
+
+  def loyalty_alert
+    tier = data[:loyalty_tier]
+    { title: "#{tier.capitalize} Member", description: "Thank you for being a valued customer!", color: "blue" }
+  end
+
+  def points_earned_text
+    points = (calculate_total / 100.0).round
+    "Points earned on this order: #{points}\nTotal points balance: #{data[:loyalty_points] || 0}"
+  end
+
+  def special_instructions
+    data[:special_instructions]
+  end
+
+  def footer_text
+    "Thank you for your order! Questions? Contact support@example.com or call 1-800-EXAMPLE"
+  end
+
+  private
+
+  def subtotal
+    data[:items].sum { |i| i[:price_cents] * i[:quantity] }
+  end
+
+  def calculate_total
+    total = subtotal
+    total -= (data[:discount_percent] ? (subtotal * data[:discount_percent] / 100.0).round : (data[:discount_amount] || 0))
+    total += (data[:shipping_cost] || 0) unless digital_only || free_shipping
+    total += (data[:tax_cents] || 0)
+    total += 500 if is_gift && gift_wrap_selected # gift wrap fee
+    total
+  end
+
+  def status_description(status)
+    {
+      "confirmed" => "Your order has been confirmed and will be processed shortly.",
+      "processing" => "Your order is being prepared for shipment.",
+      "pending" => "Your order is awaiting payment confirmation.",
+      "on_hold" => "Your order is on hold. Please contact support."
+    }[status] || "Status update pending."
+  end
+
+  def format_currency(cents)
+    "$#{'%.2f' % (cents / 100.0)}"
+  end
+end
+
+# --- Generate Multiple Variations ---
+
+puts "Generating conditional content examples...\n\n"
+
+# 1. Simple digital order (minimal sections)
+digital_order = {
+  order_id: "ORD-001-DIG",
+  date: Date.today,
+  status: "confirmed",
+  customer_name: "Jane Doe",
+  email: "jane@example.com",
+  items: [
+    { name: "E-Book: Ruby Mastery", quantity: 1, price_cents: 2999, digital: true },
+    { name: "Video Course: Rails Pro", quantity: 1, price_cents: 9999, digital: true, requires_activation: true }
+  ],
+  tax_cents: 1040
+}
+
+digital_path = "/tmp/order_digital.pdf"
+OrderConfirmation.new(digital_order).to_file(digital_path)
+puts "Generated Digital Order: #{digital_path}"
+
+# 2. Gift order with discount and express shipping
+gift_order = {
+  order_id: "ORD-002-GIFT",
+  date: Date.today,
+  status: "processing",
+  customer_name: "John Smith",
+  email: "john@example.com",
+  gift: true,
+  gift_wrap: true,
+  gift_message: "Happy Birthday! Hope you enjoy this!",
+  gift_from: "Your Secret Santa",
+  discount_percent: 15,
+  discount_code: "BDAY15",
+  shipping_method: "express",
+  signature_required: true,
+  shipping_cost: 1499,
+  tax_cents: 890,
+  shipping_address: {
+    name: "Mary Johnson",
+    street: "456 Oak Avenue, Apt 7B",
+    city: "Boston",
+    state: "MA",
+    zip: "02101",
+    country: "USA"
+  },
+  items: [
+    { name: "Wireless Headphones", quantity: 1, price_cents: 7999 },
+    { name: "Phone Case", quantity: 1, price_cents: 2499 }
+  ],
+  loyalty_tier: "gold",
+  loyalty_points: 1250
+}
+
+gift_path = "/tmp/order_gift.pdf"
+OrderConfirmation.new(gift_order).to_file(gift_path)
+puts "Generated Gift Order: #{gift_path}"
+
+# 3. Mixed order (physical + digital) with special instructions
+mixed_order = {
+  order_id: "ORD-003-MIX",
+  date: Date.today,
+  status: "confirmed",
+  customer_name: "Alex Rivera",
+  email: "alex@example.com",
+  discount_amount: 1000,
+  discount_code: "SAVE10",
+  shipping_cost: 599,
+  tax_cents: 1234,
+  shipping_address: {
+    name: "Alex Rivera",
+    street: "789 Pine Street",
+    city: "San Francisco",
+    state: "CA",
+    zip: "94102",
+    country: "USA"
+  },
+  items: [
+    { name: "Programming Keyboard", quantity: 1, price_cents: 14999 },
+    { name: "USB-C Hub", quantity: 2, price_cents: 3999 },
+    { name: "IDE License Key", quantity: 1, price_cents: 9999, digital: true, requires_activation: true }
+  ],
+  loyalty_tier: "silver",
+  loyalty_points: 450,
+  special_instructions: "Please leave package at the back door if no one is home. " \
+                        "Ring doorbell twice. Fragile items - handle with care!"
+}
+
+mixed_path = "/tmp/order_mixed.pdf"
+OrderConfirmation.new(mixed_order).to_file(mixed_path)
+puts "Generated Mixed Order: #{mixed_path}"
+
+# 4. On-hold order (shows warning state)
+hold_order = {
+  order_id: "ORD-004-HOLD",
+  date: Date.today - 2,
+  status: "on_hold",
+  customer_name: "Pat Wilson",
+  email: "pat@example.com",
+  shipping_cost: 0,
+  tax_cents: 500,
+  shipping_address: {
+    name: "Pat Wilson",
+    street: "321 Elm Road",
+    city: "Chicago",
+    state: "IL",
+    zip: "60601",
+    country: "USA"
+  },
+  items: [
+    { name: "Basic Widget", quantity: 3, price_cents: 1999 }
+  ]
+}
+
+hold_path = "/tmp/order_on_hold.pdf"
+OrderConfirmation.new(hold_order).to_file(hold_path)
+puts "Generated On-Hold Order: #{hold_path}"
+
+puts "\nOpening all four order variations..."
+system("open", digital_path)
+sleep 0.3
+system("open", gift_path)
+sleep 0.3
+system("open", mixed_path)
+sleep 0.3
+system("open", hold_path)