scriptorium 0.0.2 → 0.6.1

data/lib/scriptorium/contract.rb

@@ -0,0 +1,33 @@
+module Scriptorium::Contract
+  def self.enabled?
+    !ENV['DBC_DISABLED']
+  end
+  
+  def assume(condition = nil, message = nil, &block)
+    return unless Scriptorium::Contract.enabled?
+    if block_given?
+      raise "Precondition violated: #{message}" unless instance_eval(&block)
+    else
+      raise "Precondition violated: #{message}" unless condition
+    end
+  end
+  
+  def verify(condition = nil, message = nil, &block)
+    return unless Scriptorium::Contract.enabled?
+    if block_given?
+      raise "Postcondition violated: #{message}" unless instance_eval(&block)
+    else
+      raise "Postcondition violated: #{message}" unless condition
+    end
+  end
+  
+  def invariant(&block)
+    @invariants ||= []
+    @invariants << block
+  end
+  
+  def check_invariants
+    return unless Scriptorium::Contract.enabled?
+    @invariants&.each { |invariant| raise "Invariant violated" unless instance_eval(&invariant) }
+  end
+end 

data/lib/scriptorium/exceptions.rb

@@ -0,0 +1,174 @@
+module Scriptorium::Exceptions
+
+  def make_exception(sym, str, target_class = Object)
+    return if target_class.constants.include?(sym)
+    klass = sym   # :"#{sym}_Class"
+    target_class.const_set(klass, StandardError)
+    define_method(sym) do |*args|
+      args = [] unless args.first
+      msg = str.dup
+      args.each.with_index {|arg, i| msg.sub!("%#{i+1}", arg.to_s) }
+      target_class.class_eval(klass.to_s).new(msg)
+    end
+  end
+
+  make_exception :TestModeOnly, "Test mode only"
+  make_exception :ViewDirAlreadyExists, "View directory already exists: %1"
+  make_exception :RepoDirAlreadyExists, "Repository directory already exists: %1"
+  make_exception :ViewDirDoesntExist, "View directory doesn't exist: %1"
+  make_exception :MoreThanOneResult, "More than one result found for: %1"
+  make_exception :CannotLookupView, "Cannot lookup view: %1"
+  make_exception :ThemeDoesntExist, "Theme doesn't exist: %1" 
+  make_exception :ThemeFileNotFound, "Theme file not found: %1"
+  make_exception :LayoutHasUnknownTag, "Layout has unknown tag: %1"
+  make_exception :LayoutHasDuplicateTags, "Layout has duplicate tags: %1"
+  make_exception :LayoutFileMissing, "Layout file missing: %1"
+  make_exception :AssetNotFound, "Asset not found: %1"
+  make_exception :NoGemPath, "No gem path"
+  
+  # Validation errors
+  make_exception :NilValueError, "Value is nil: %1"
+  make_exception :EmptyValueError, "Value is empty or whitespace-only: %1"
+  make_exception :InvalidFormatError, "Invalid format '%1': %2"
+  
+  # Specific validation errors
+  make_exception :CannotCreateViewNameNil, "Cannot create view: name is nil"
+  make_exception :CannotCreateViewNameEmpty, "Cannot create view: name is empty or whitespace-only"
+  make_exception :CannotCreateViewNameInvalid, "Cannot create view: invalid name '%1' (only alphanumeric, hyphen, and underscore allowed)"
+  make_exception :CannotCreateViewTitleNil, "Cannot create view: title is nil"
+  make_exception :CannotCreateViewTitleEmpty, "Cannot create view: title is empty or whitespace-only"
+  
+  make_exception :CannotLookupViewTargetNil, "Cannot lookup view: target is nil"
+  make_exception :CannotLookupViewTargetEmpty, "Cannot lookup view: target is empty or whitespace-only"
+  
+  make_exception :CannotGetPostIdNil, "Cannot get post: id is nil"
+  make_exception :CannotGetPostIdEmpty, "Cannot get post: id is empty or whitespace-only"
+  make_exception :CannotGetPostIdInvalid, "Cannot get post: invalid id '%1' (must be numeric)"
+  
+  make_exception :CannotCreatePostRepoNil, "Cannot create post: repo is nil"
+  make_exception :CannotCreatePostNumNil, "Cannot create post: num is nil"
+  make_exception :CannotCreatePostNumEmpty, "Cannot create post: num is empty or whitespace-only"
+  make_exception :CannotCreatePostNumInvalid, "Cannot create post: invalid num '%1' (must be numeric)"
+  
+  make_exception :CannotSetPubdateYmdNil, "Cannot set pubdate: ymd is nil"
+  make_exception :CannotSetPubdateYmdEmpty, "Cannot set pubdate: ymd is empty or whitespace-only"
+  make_exception :CannotSetPubdateInvalidFormat, "Cannot set pubdate: invalid date format '%1' (expected YYYY-MM-DD)"
+  
+  make_exception :CannotBuildWidgetsArgNil, "Cannot build widgets: argument is nil"
+  make_exception :CannotBuildWidgetsArgEmpty, "Cannot build widgets: argument is empty or whitespace-only"
+  make_exception :CannotBuildWidgetNameNil, "Cannot build widget: widget name is nil or empty"
+  make_exception :CannotBuildWidgetNameInvalid, "Cannot build widget: invalid widget name '%1' (only alphanumeric and underscore allowed)"
+  
+  # File/IO errors
+  make_exception :FileNotFoundError, "File not found: %1"
+  make_exception :PermissionDeniedError, "Permission denied: %1"
+  make_exception :DiskFullError, "Disk full: %1"
+  make_exception :DirectoryNotFoundError, "Directory not found: %1"
+  
+  # Specific file/IO errors
+  make_exception :CannotWriteFilePathNil, "Cannot write file: file path is nil"
+  make_exception :CannotWriteFilePathEmpty, "Cannot write file: file path is empty or whitespace-only"
+  make_exception :CannotWriteFilePermissionDenied, "Cannot write file %1: permission denied (%2)"
+  make_exception :CannotWriteFileDiskFull, "Cannot write file %1: disk full (%2)"
+  make_exception :CannotWriteFileDirectoryNotFound, "Cannot write file %1: directory not found (%2)"
+  make_exception :CannotWriteFileError, "Cannot write file %1: %2"
+  
+  make_exception :CannotCreateDirectoryPathNil, "Cannot create directory: directory path is nil"
+  make_exception :CannotCreateDirectoryPathEmpty, "Cannot create directory: directory path is empty or whitespace-only"
+  make_exception :CannotCreateDirectoryPermissionDenied, "Cannot create directory %1: permission denied (%2)"
+  make_exception :CannotCreateDirectoryParentNotFound, "Cannot create directory %1: parent directory not found (%2)"
+  make_exception :CannotCreateDirectoryDiskFull, "Cannot create directory %1: disk full (%2)"
+  make_exception :CannotCreateDirectoryError, "Cannot create directory %1: %2"
+  
+  make_exception :CannotReadFilePathNil, "Cannot read file: file path is nil"
+  make_exception :CannotReadFilePathEmpty, "Cannot read file: file path is empty or whitespace-only"
+  make_exception :CannotReadFileNotFound, "Cannot read file %1: file not found (%2)"
+  make_exception :CannotReadFilePermissionDenied, "Cannot read file %1: permission denied (%2)"
+  make_exception :CannotReadFileError, "Cannot read file %1: %2"
+  
+  make_exception :CannotEditFilePathNil, "Cannot edit file: file path is nil"
+  make_exception :CannotEditFilePathEmpty, "Cannot edit file: file path is empty or whitespace-only"
+  
+  make_exception :CannotRequirePathNil, "Cannot require %1: path is nil"
+  make_exception :CannotRequirePathEmpty, "Cannot require %1: path is empty or whitespace-only"
+  make_exception :RequiredFileNotFound, "Required %1 not found: %2"
+  make_exception :InvalidType, "Invalid type: %1 (must be :file or :dir)"
+  
+  # View errors
+  make_exception :CannotCreateView, "Cannot create view: %1"
+  make_exception :CannotBuildWidget, "Cannot build widget: %1"
+  
+  # Post errors
+  make_exception :CannotCreatePost, "Cannot create post: %1"
+  make_exception :CannotGetPost, "Cannot get post: %1"
+  make_exception :CannotSetPubdate, "Cannot set pubdate: %1"
+  
+  # Banner SVG errors
+  make_exception :CannotHandleBackground, "Cannot handle background: %1"
+  make_exception :CannotHandleGradient, "Cannot handle gradient: %1"
+  make_exception :CannotHandleImage, "Cannot handle image: %1"
+  make_exception :CannotHandleAspect, "Cannot handle aspect: %1"
+  make_exception :CannotHandleFont, "Cannot handle font: %1"
+  make_exception :CannotHandleColor, "Cannot handle color: %1"
+  make_exception :CannotHandleAlign, "Cannot handle align: %1"
+  make_exception :CannotHandleXY, "Cannot handle xy: %1"
+  
+  # Specific Banner SVG errors
+  make_exception :CannotHandleBackgroundNoArgs, "Cannot handle background: no arguments provided"
+  make_exception :CannotHandleBackgroundFirstArgNil, "Cannot handle background: first argument is nil"
+  make_exception :CannotHandleBackgroundFirstArgEmpty, "Cannot handle background: first argument is empty or whitespace-only"
+  
+  make_exception :CannotHandleLinearGradientNoArgs, "Cannot handle linear gradient: no arguments provided"
+  make_exception :CannotHandleLinearGradientStartColorNil, "Cannot handle linear gradient: start color is nil or empty"
+  make_exception :CannotHandleLinearGradientArgEmpty, "Cannot handle linear gradient: argument %1 is empty or whitespace-only"
+  
+  make_exception :CannotHandleRadialGradientNoArgs, "Cannot handle radial gradient: no arguments provided"
+  make_exception :CannotHandleRadialGradientStartColorNil, "Cannot handle radial gradient: start color is nil or empty"
+  make_exception :CannotHandleRadialGradientArgEmpty, "Cannot handle radial gradient: argument %1 is empty or whitespace-only"
+  
+  make_exception :CannotHandleImageBackgroundNoArgs, "Cannot handle image background: no arguments provided"
+  make_exception :CannotHandleImageBackgroundFirstArgNil, "Cannot handle image background: first argument is nil"
+  make_exception :CannotHandleImageBackgroundFirstArgEmpty, "Cannot handle image background: first argument is empty or whitespace-only"
+  
+  make_exception :CannotHandleAspectNoArgs, "Cannot handle aspect: no arguments provided"
+  make_exception :CannotHandleAspectFirstArgNil, "Cannot handle aspect: first argument is nil"
+  make_exception :CannotHandleAspectFirstArgEmpty, "Cannot handle aspect: first argument is empty or whitespace-only"
+  make_exception :CannotHandleAspectInvalidValue, "Cannot handle aspect: invalid aspect value '%1' (must be numeric)"
+  
+  make_exception :CannotHandleFontArgsNil, "Cannot handle font: arguments are nil"
+  make_exception :CannotHandleFontArgNil, "Cannot handle font: argument %1 is nil"
+  make_exception :CannotHandleFontArgEmpty, "Cannot handle font: argument %1 is empty or whitespace-only"
+  
+  make_exception :CannotHandleTextColorNoArgs, "Cannot handle text color: no arguments provided"
+  make_exception :CannotHandleTextColorFirstArgNil, "Cannot handle text color: first argument is nil"
+  make_exception :CannotHandleTextColorFirstArgEmpty, "Cannot handle text color: first argument is empty or whitespace-only"
+  
+  make_exception :CannotHandleXYWhichNil, "Cannot handle xy: which is nil"
+  make_exception :CannotHandleXYWhichEmpty, "Cannot handle xy: which is empty or whitespace-only"
+  make_exception :CannotHandleXYInvalidWhich, "Cannot handle xy: invalid which '%1' (must be 'title' or 'subtitle')"
+  
+  make_exception :CannotHandleAlignNoArgs, "Cannot handle align: no arguments provided"
+  make_exception :CannotHandleAlignDirectionNil, "Cannot handle align: direction is nil or empty"
+  make_exception :CannotHandleAlignInvalidDirection, "Cannot handle align: invalid direction '%1' (must be 'left', 'center', or 'right')"
+  make_exception :CannotHandleAlignArgEmpty, "Cannot handle align: argument %1 is empty or whitespace-only"
+  
+  make_exception :CannotHandleColorNoArgs, "Cannot handle color: no arguments provided"
+  make_exception :CannotHandleColorFirstArgNil, "Cannot handle color: first argument is nil"
+  make_exception :CannotHandleColorFirstArgEmpty, "Cannot handle color: first argument is empty or whitespace-only"
+  
+
+  
+  # Command errors
+  make_exception :CommandFailed, "Command failed: %1"
+  make_exception :CannotExecuteCommand, "Cannot execute command: %1"
+  
+  # Specific command errors
+  make_exception :CannotExecuteCommandNil, "Cannot execute command: command is nil"
+  make_exception :CannotExecuteCommandEmpty, "Cannot execute command: command is empty or whitespace-only"
+  make_exception :CommandFailedWithDesc, "Command failed%1: %2"
+  
+  # Section/Output errors
+  make_exception :SectionOutputError, "Section output error: %1 (section: %2) - %3"
+  make_exception :FailedToWriteFrontPage, "Failed to write front page: %1"
+
+end

data/lib/scriptorium/helpers.rb

@@ -0,0 +1,475 @@
+# Path magic
+
+module PathSep
+  def /(right)
+    s1 = self.to_s.dup
+    s2 = right.to_s.dup
+    s1 << "/" unless s1.end_with?("/") || s2.start_with?("/")
+    path = s1 + s2
+    path.gsub!("//", "/")
+    path
+  end
+end
+
+String.include(PathSep)
+Symbol.include(PathSep)
+
+## Helpers
+
+module Scriptorium::Helpers
+  include Scriptorium::Exceptions
+  def getvars(file)
+    lines = read_file(file, lines: true)
+    lines.map! {|line| line.sub(/# .*$/, "").strip }
+    lines.reject! {|line| line.empty? }
+    vhash = Hash.new("")
+    lines.each do |line|
+      var, val = line.split(" ", 2)
+      vhash[var.to_sym] = val
+    end
+    vhash
+  end
+
+  def d4(num)
+    "%04d" % num
+  end
+
+  def view_dir(name)
+    @root/:views/name
+  end
+
+  def write_file(file, content)
+    # Input validation
+    raise CannotWriteFilePathNil if file.nil?
+    
+    raise CannotWriteFilePathEmpty if file.to_s.strip.empty?
+    
+    # Ensure parent directory exists
+    FileUtils.mkdir_p(File.dirname(file))
+    
+    # Write the file with error handling
+    begin
+      File.open(file, "w") do |f|
+        f.puts content
+      end
+    rescue Errno::ENOSPC => e
+      raise CannotWriteFileDiskFull(file, e.message)
+    rescue Errno::EACCES => e
+      raise CannotWriteFilePermissionDenied(file, e.message)
+    rescue Errno::ENOENT => e
+      raise CannotWriteFileDirectoryNotFound(file, e.message)
+    rescue => e
+      raise CannotWriteFileError(file, e.message)
+    end
+  end
+
+  def write_file!(file, *lines)
+    # Convert nil values to empty strings for proper joining
+    processed_lines = lines.map { |line| line.nil? ? "" : line.to_s }
+    content = processed_lines.join("\n")
+    # Always add a newline at the end to ensure there's an empty line
+    content += "\n"
+    write_file(file, content)
+  end
+
+  def make_dir(dir, create_parents = false)
+    # Input validation
+    raise CannotCreateDirectoryPathNil if dir.nil?
+    
+    raise CannotCreateDirectoryPathEmpty if dir.to_s.strip.empty?
+    
+    # Create parent directories if requested
+    if create_parents
+      FileUtils.mkdir_p(dir)
+    else
+      # Create single directory with error handling
+      begin
+        Dir.mkdir(dir)
+      rescue Errno::ENOSPC => e
+        raise CannotCreateDirectoryDiskFull(dir, e.message)
+      rescue Errno::EACCES => e
+        raise CannotCreateDirectoryPermissionDenied(dir, e.message)
+      rescue Errno::ENOENT => e
+        raise CannotCreateDirectoryParentNotFound(dir, e.message)
+      rescue Errno::EEXIST => e
+        # Directory already exists - this is usually not an error
+        # But we could make this configurable if needed
+      rescue => e
+        raise CannotCreateDirectoryError(dir, e.message)
+      end
+    end
+  end
+
+  def system!(command, description = nil)
+    # Input validation
+    raise CannotExecuteCommandNil if command.nil?
+    
+    raise CannotExecuteCommandEmpty if command.to_s.strip.empty?
+    
+    # Execute command with error handling
+    success = system(command)
+    
+    unless success
+      desc = description ? " (#{description})" : ""
+      raise CommandFailedWithDesc(desc, command)
+    end
+    
+    success
+  end
+
+  def need(type, path, exception_class = RuntimeError)
+    # Input validation
+    raise CannotRequirePathNil(type) if path.nil?
+    
+    raise CannotRequirePathEmpty(type) if path.to_s.strip.empty?
+    
+    # Check if file/directory exists
+    exists = case type
+             when :file
+               File.exist?(path)
+             when :dir
+               Dir.exist?(path)
+             else
+               raise InvalidType(type)
+             end
+    
+    unless exists
+      raise RequiredFileNotFound(type, path) if exception_class == RuntimeError
+      
+      # Exception class - try to call it as a method first, then as constructor
+      raise exception_class.call(path) if exception_class.respond_to?(:call)
+      raise exception_class.new(path)
+    end
+    
+    path
+  end
+
+  def read_file(file, options = {})
+    # Input validation
+    raise CannotReadFilePathNil if file.nil?
+    
+    raise CannotReadFilePathEmpty if file.to_s.strip.empty?
+    
+    # Handle missing file with fallback
+    if options[:missing_fallback]
+      return options[:missing_fallback] unless File.exist?(file)
+    end
+    
+    # Read the file with error handling
+    begin
+      if options[:lines]
+        # Read as lines
+        if options[:chomp]
+          File.readlines(file, chomp: true)
+        else
+          File.readlines(file)
+        end
+      else
+        # Read as content
+        File.read(file)
+      end
+    rescue Errno::ENOENT => e
+      if options[:missing_fallback]
+        return options[:missing_fallback]
+      else
+        raise CannotReadFileNotFound(file, e.message)
+      end
+    rescue Errno::EACCES => e
+      raise CannotReadFilePermissionDenied(file, e.message)
+    rescue => e
+      raise CannotReadFileError(file, e.message)
+    end
+  end
+
+
+
+  def change_config(file_path, target_key, new_value)
+    pattern = /
+      ^(?<leading>\s*#{Regexp.escape(target_key)}\s+)  # key and spacing
+      (?<old_value>[^\#]*?)                            # value (non-greedy up to comment)
+      (?<trailing>\s*)                                 # trailing space
+      (?<comment>\#.*)?$                               # optional comment
+    /x
+  
+    lines = read_file(file_path, lines: true)
+    updated_lines = lines.map do |line|
+      if match = pattern.match(line)
+        leading  = match[:leading]
+        trailing = match[:trailing]
+        comment  = match[:comment] || ''
+        "#{leading}#{new_value}#{trailing}#{comment}\n"
+      else
+        line
+      end
+    end
+  
+    write_file(file_path, updated_lines.join)
+  end
+  
+  def slugify(id, title)
+    slug = title.downcase.strip
+               .gsub(/[^a-z0-9\s_-]/, '')  # remove punctuation
+               .gsub(/[\s_-]+/, '-')       # replace spaces and underscores with hyphen
+               .gsub(/^-+|-+$/, '')        # trim leading/trailing hyphens
+    "#{d4(id)}-#{slug}"
+  end
+
+  def clean_slugify(title)
+    return "title-is-missing" if title.nil?
+    
+    slug = title.downcase.strip
+               .gsub(/[^a-z0-9\s_-]/, '')  # remove punctuation
+               .gsub(/[\s_-]+/, '-')       # replace spaces and underscores with hyphen
+               .gsub(/^-+|-+$/, '')        # trim leading/trailing hyphens
+    slug
+  end
+  
+  def ymdhms
+    Time.now.strftime("%Y-%m-%d-%H-%M-%S")
+  end
+
+  def see_file(file)   # Really from TestHelpers
+    puts "----- File: #{file}"
+    system!("cat #{file}", "displaying file contents")
+    puts "-----"
+  end
+
+  def see(label, var)
+    puts "#{label} = \n<<<\n#{var}\n>>>"
+  end
+
+  def make_tree(base, text)
+    lines = text.split("\n").map(&:chomp)
+    lines.each {|line| line.gsub!(/ *#.*$/, "") }
+    entries = []
+  
+    # Determine the root name
+    first_line = lines.shift
+    root = first_line.strip.sub(/\/$/, "") # remove trailing slash
+    root_path = File.join(base, root)
+    make_dir(root_path) unless File.exist?(root_path)
+  
+    # Prepare stack starting from root
+    stack = [root_path]
+  
+    # Parse the remaining lines
+    lines.each do |line|
+      if (i = line.index(/ [a-zA-Z0-9_.]/))
+        name = line[(i + 1)..-1]
+        level = i / 4
+      else
+        name = line.strip
+        level = 0
+      end
+      entries << [level, name]
+    end
+  
+    entries.each do |level, name|
+      stack = stack[0..level]
+      full_path = File.join(stack.last, name)
+  
+      if name.end_with?("/")
+        make_dir(full_path) unless File.exist?(full_path)
+        stack << full_path
+      else
+        write_file(full_path, "Empty file generated at #{Time.now}")
+      end
+    end
+  end            
+
+  def substitute(obj, text)
+    vars = obj.is_a?(Hash) ? obj : obj.vars
+    text % vars
+  end
+
+  def escape_html(str)
+    str.gsub(/&/, '&amp;')
+       .gsub(/</, '&lt;')
+       .gsub(/>/, '&gt;')
+       .gsub(/"/, '&quot;')
+       .gsub(/'/, '&#39;')
+  end
+  
+  def read_commented_file(file_path)
+    return [] unless File.exist?(file_path)
+    lines = read_file(file_path, lines: true)  # Read file and remove newline characters
+    lines.reject! do |line|    # Remove empty lines and comments
+      line.strip.empty? || line.strip.start_with?("#")
+    end
+    lines.map! do |line|       # Strip trailing comments + preceding spaces
+      line.sub(/# .*$/, "").strip  
+    end
+    lines  # Return cleaned lines
+  end
+      
+  def cf_time(t1, t2)
+    t1 = t1.split(/- :/, 6)
+    t2 = t2.split(/- :/, 6)
+    t1 = Time.new(*t1)
+    t2 = Time.new(*t2)
+    t1 <=> t2
+  end
+
+  def get_asset_path(name)
+    if Scriptorium::Repo.testing
+      # Development/testing: Check dev_assets first, then local assets
+      if File.exist?("dev_assets/#{name}")
+        return "dev_assets/#{name}"
+      elsif File.exist?("assets/#{name}")
+        return "assets/#{name}"
+      else
+        raise AssetNotFound(name)
+      end
+    else  # Production
+      # Production: Check user assets first, then gem assets
+      
+      # Check user assets first (highest priority)
+      if File.exist?("assets/#{name}")
+        return "assets/#{name}"
+      end
+      
+      # Then check gem assets (fallback)
+      begin
+        gem_spec = Gem.loaded_specs['scriptorium']
+        if gem_spec
+          gem_asset_path = "#{gem_spec.full_gem_path}/assets/#{name}"
+          if File.exist?(gem_asset_path)
+            return gem_asset_path
+          end
+        end
+      rescue => e
+        # If gem lookup fails, continue without gem assets
+      end
+      
+      # Asset not found
+      raise AssetNotFound(name)
+    end
+  end
+
+  def generate_missing_asset_svg(filename, width: 200, height: 150)
+    # Truncate filename if too long for display
+    display_name = filename.length > 20 ? filename[0..16] + "..." : filename
+    
+    # Generate SVG with broken image icon and filename
+    svg = <<~SVG
+      <svg width="#{width}" height="#{height}" xmlns="http://www.w3.org/2000/svg">
+        <!-- Background -->
+        <rect fill="#f8f9fa" stroke="#ddd" stroke-width="1" width="#{width}" height="#{height}" rx="4"/>
+        
+        <!-- Broken image icon -->
+        <g transform="translate(#{width/2}, #{height/2 - 20})">
+          <!-- Image frame -->
+          <rect x="-15" y="-10" width="30" height="20" fill="none" stroke="#999" stroke-width="1"/>
+          <!-- Broken corner -->
+          <path d="M 15 -10 L 25 -20 M 15 -10 L 25 0" stroke="#999" stroke-width="1" fill="none"/>
+          <!-- Image icon -->
+          <rect x="-12" y="-7" width="24" height="14" fill="#e9ecef"/>
+          <circle cx="-5" cy="-2" r="2" fill="#999"/>
+          <polygon points="-8,8 -2,2 2,6 8,0" fill="#999"/>
+        </g>
+        
+        <!-- Filename -->
+        <text x="#{width/2}" y="#{height/2 + 15}" text-anchor="middle" fill="#666" font-family="Arial, sans-serif" font-size="11">
+          #{escape_html(display_name)}
+        </text>
+        
+        <!-- "Asset not found" message -->
+        <text x="#{width/2}" y="#{height/2 + 30}" text-anchor="middle" fill="#999" font-family="Arial, sans-serif" font-size="9">
+          Asset not found
+        </text>
+      </svg>
+    SVG
+    
+    svg.strip
+  end
+
+  def list_gem_assets
+    assets = []
+    begin
+      gem_spec = Gem.loaded_specs['scriptorium']
+      if gem_spec
+        gem_assets_dir = "#{gem_spec.full_gem_path}/assets"
+        if Dir.exist?(gem_assets_dir)
+          Dir.glob("#{gem_assets_dir}/**/*").each do |file|
+            next unless File.file?(file)
+            relative_path = file.sub("#{gem_assets_dir}/", "")
+            assets << relative_path
+          end
+        end
+      end
+    rescue => e
+      # If gem lookup fails, return empty array
+    end
+    assets.sort
+  end
+
+  def copy_gem_asset_to_user(asset_name, target_dir = "assets")
+    begin
+      gem_spec = Gem.loaded_specs['scriptorium']
+      if gem_spec
+        gem_asset_path = "#{gem_spec.full_gem_path}/assets/#{asset_name}"
+        if File.exist?(gem_asset_path)
+          # Create target directory if it doesn't exist
+          FileUtils.mkdir_p(target_dir) unless Dir.exist?(target_dir)
+          
+          # Copy the asset
+          target_path = "#{target_dir}/#{File.basename(asset_name)}"
+          FileUtils.cp(gem_asset_path, target_path)
+          return target_path
+        end
+      end
+    rescue => e
+      # If gem lookup fails, return nil
+    end
+    nil
+  end
+
+  # Clipboard helper methods
+  def copy_to_clipboard(text)
+    begin
+      require 'clipboard'
+      Clipboard.copy(text)
+      true
+    rescue LoadError => e
+      # Fallback to system commands if clipboard gem not available
+      case RbConfig::CONFIG['host_os']
+      when /darwin/     # macOS
+        system("echo '#{text}' | pbcopy")
+      when /linux/      # Linux
+        system("echo '#{text}' | xclip -selection clipboard")
+      when /mswin|mingw|cygwin/  # Windows
+        system("echo '#{text}' | clip")
+      else
+        puts "Clipboard not supported on this OS"
+        false
+      end
+    rescue => e
+      puts "Failed to copy to clipboard: #{e.message}"
+      false
+    end
+  end
+
+  def get_from_clipboard
+    begin
+      require 'clipboard'
+      Clipboard.paste
+    rescue LoadError => e
+      # Fallback to system commands if clipboard gem not available
+      case RbConfig::CONFIG['host_os']
+      when /darwin/     # macOS
+        `pbpaste`
+      when /linux/      # Linux
+        `xclip -selection clipboard -o`
+      when /mswin|mingw|cygwin/  # Windows
+        `powershell -command "Get-Clipboard"`
+      else
+        puts "Clipboard not supported on this OS"
+        nil
+      end
+    rescue => e
+      puts "Failed to read from clipboard: #{e.message}"
+      nil
+    end
+  end
+end
+