sirena 0.1.0

data/examples/user_journey/README.adoc

@@ -0,0 +1,81 @@
+= User Journey Examples
+
+== Purpose
+
+User journey diagrams map user experiences and interactions with a system, showing tasks, satisfaction levels, and different actors involved in each step.
+
+== When to Use
+
+* User experience (UX) design
+* Customer journey mapping
+* Service design documentation
+* Stakeholder engagement visualization
+* Process improvement analysis
+
+== Syntax Overview
+
+[source,mermaid]
+----
+journey
+    title My Journey
+    section Section 1
+        Task 1: 5: Actor 1
+        Task 2: 3: Actor 1, Actor 2
+----
+
+**Satisfaction Levels**: 1 (low) to 5 (high)
+
+== Examples
+
+=== 01: Simple Journey
+
+Demonstrates basic user journey with single actor and satisfaction scoring.
+
+**File**: link:01-simple-journey.mmd[01-simple-journey.mmd]
+
+[source,mermaid]
+----
+include::01-simple-journey.mmd[]
+----
+
+image::01-simple-journey.svg[]
+
+=== 02: Multi-Actor
+
+Showcases complex journey with multiple actors and sections.
+
+**File**: link:02-multi-actor.mmd[02-multi-actor.mmd]
+
+[source,mermaid]
+----
+include::02-multi-actor.mmd[]
+----
+
+image::02-multi-actor.svg[]
+
+== Features Demonstrated
+
+[%header,cols="1,1"]
+|===
+| Feature | Example
+
+| Basic journey mapping
+| 01, 02
+
+| Satisfaction scoring
+| 01, 02
+
+| Multiple actors
+| 02
+
+| Section grouping
+| 01, 02
+
+| Task visualization
+| 01, 02
+|===
+
+== Additional Resources
+
+* link:../../README.adoc[Main Documentation]
+* https://mermaid.js.org/syntax/userJourney.html[Mermaid User Journey Documentation]

data/examples/xychart/01-line-chart.mmd

@@ -0,0 +1,5 @@
+xychart-beta
+    title "Monthly Sales Performance"
+    x-axis [Jan, Feb, Mar, Apr, May, Jun]
+    y-axis "Sales ($1000)" 0 --> 100
+    line [45, 52, 68, 75, 82, 90]

data/examples/xychart/01-line-chart.svg

@@ -0,0 +1,43 @@
+<svg
+ width="800.0"
+ height="500.0"
+ viewBox="0 0 800.0 500.0"
+ version="1.2"
+ xmlns="http://www.w3.org/2000/svg"
+>
+<text fill="#000000" x="400.0" y="30.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="16.0" font-weight="bold">Monthly Sales Performance</text>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="80.0" x2="740.0" y2="80.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="148.0" x2="740.0" y2="148.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="216.0" x2="740.0" y2="216.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="284.0" x2="740.0" y2="284.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="352.0" x2="740.0" y2="352.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="153.0" y1="80.0" x2="153.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="259.0" y1="80.0" x2="259.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="365.0" y1="80.0" x2="365.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="471.0" y1="80.0" x2="471.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="577.0" y1="80.0" x2="577.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="683.0" y1="80.0" x2="683.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#000000" stroke-width="2" x1="100.0" y1="420.0" x2="740.0" y2="420.0"/>
+<line stroke="#000000" stroke-width="2" x1="100.0" y1="80.0" x2="100.0" y2="420.0"/>
+<polyline fill="none" stroke="#2563eb" stroke-width="2"/>
+<circle fill="#2563eb" stroke="#ffffff" stroke-width="2" cx="153.0" cy="267.0" r="4.0"/>
+<circle fill="#2563eb" stroke="#ffffff" stroke-width="2" cx="259.0" cy="243.2" r="4.0"/>
+<circle fill="#2563eb" stroke="#ffffff" stroke-width="2" cx="365.0" cy="188.79999999999998" r="4.0"/>
+<circle fill="#2563eb" stroke="#ffffff" stroke-width="2" cx="471.0" cy="165.0" r="4.0"/>
+<circle fill="#2563eb" stroke="#ffffff" stroke-width="2" cx="577.0" cy="141.2" r="4.0"/>
+<circle fill="#2563eb" stroke="#ffffff" stroke-width="2" cx="683.0" cy="114.0" r="4.0"/>
+<text fill="#000000" x="153.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Jan</text>
+<text fill="#000000" x="259.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Feb</text>
+<text fill="#000000" x="365.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Mar</text>
+<text fill="#000000" x="471.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Apr</text>
+<text fill="#000000" x="577.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">May</text>
+<text fill="#000000" x="683.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Jun</text>
+<text transform="rotate(-90, 20, 250)" fill="#000000" x="20.0" y="250.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="14.0" font-weight="bold">Sales ($1000)</text>
+<text fill="#000000" x="90.0" y="84.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">100.0</text>
+<text fill="#000000" x="90.0" y="152.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">80.0</text>
+<text fill="#000000" x="90.0" y="220.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">60.0</text>
+<text fill="#000000" x="90.0" y="288.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">40.0</text>
+<text fill="#000000" x="90.0" y="356.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">20.0</text>
+<rect fill="#2563eb" stroke="none" x="650.0" y="52.0" width="15.0" height="15.0"/>
+<text fill="#000000" x="670.0" y="64.0" text-anchor="start" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Line</text>
+</svg>

data/examples/xychart/02-bar-chart.mmd

@@ -0,0 +1,7 @@
+xychart-beta
+    title "Quarterly Revenue Comparison"
+    x-axis [Q1, Q2, Q3, Q4]
+    y-axis "Revenue (Million USD)" 0 --> 100
+    bar [65, 75, 85, 95]
+    bar [55, 70, 80, 90]
+    bar [45, 60, 75, 85]

data/examples/xychart/02-bar-chart.svg

@@ -0,0 +1,48 @@
+<svg
+ width="800.0"
+ height="500.0"
+ viewBox="0 0 800.0 500.0"
+ version="1.2"
+ xmlns="http://www.w3.org/2000/svg"
+>
+<text fill="#000000" x="400.0" y="30.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="16.0" font-weight="bold">Quarterly Revenue Comparison</text>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="80.0" x2="740.0" y2="80.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="148.0" x2="740.0" y2="148.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="216.0" x2="740.0" y2="216.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="284.0" x2="740.0" y2="284.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="100.0" y1="352.0" x2="740.0" y2="352.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="180.0" y1="80.0" x2="180.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="340.0" y1="80.0" x2="340.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="500.0" y1="80.0" x2="500.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#e5e7eb" stroke-width="1" x1="660.0" y1="80.0" x2="660.0" y2="420.0" stroke-dasharray="3,3"/>
+<line stroke="#000000" stroke-width="2" x1="100.0" y1="420.0" x2="740.0" y2="420.0"/>
+<line stroke="#000000" stroke-width="2" x1="100.0" y1="80.0" x2="100.0" y2="420.0"/>
+<rect fill="#2563eb" fill-opacity="0.8" stroke="#2563eb" stroke-width="1" x="132.0" y="199.0" width="96.0" height="221.0" fill-opacity="0.8"/>
+<rect fill="#2563eb" fill-opacity="0.8" stroke="#2563eb" stroke-width="1" x="292.0" y="165.0" width="96.0" height="255.0" fill-opacity="0.8"/>
+<rect fill="#2563eb" fill-opacity="0.8" stroke="#2563eb" stroke-width="1" x="452.0" y="131.0" width="96.0" height="289.0" fill-opacity="0.8"/>
+<rect fill="#2563eb" fill-opacity="0.8" stroke="#2563eb" stroke-width="1" x="612.0" y="97.0" width="96.0" height="323.0" fill-opacity="0.8"/>
+<rect fill="#7c3aed" fill-opacity="0.8" stroke="#7c3aed" stroke-width="1" x="132.0" y="232.99999999999997" width="96.0" height="187.00000000000003" fill-opacity="0.8"/>
+<rect fill="#7c3aed" fill-opacity="0.8" stroke="#7c3aed" stroke-width="1" x="292.0" y="182.00000000000003" width="96.0" height="237.99999999999997" fill-opacity="0.8"/>
+<rect fill="#7c3aed" fill-opacity="0.8" stroke="#7c3aed" stroke-width="1" x="452.0" y="148.0" width="96.0" height="272.0" fill-opacity="0.8"/>
+<rect fill="#7c3aed" fill-opacity="0.8" stroke="#7c3aed" stroke-width="1" x="612.0" y="114.0" width="96.0" height="306.0" fill-opacity="0.8"/>
+<rect fill="#db2777" fill-opacity="0.8" stroke="#db2777" stroke-width="1" x="132.0" y="267.0" width="96.0" height="153.0" fill-opacity="0.8"/>
+<rect fill="#db2777" fill-opacity="0.8" stroke="#db2777" stroke-width="1" x="292.0" y="216.0" width="96.0" height="204.0" fill-opacity="0.8"/>
+<rect fill="#db2777" fill-opacity="0.8" stroke="#db2777" stroke-width="1" x="452.0" y="165.0" width="96.0" height="255.0" fill-opacity="0.8"/>
+<rect fill="#db2777" fill-opacity="0.8" stroke="#db2777" stroke-width="1" x="612.0" y="131.0" width="96.0" height="289.0" fill-opacity="0.8"/>
+<text fill="#000000" x="180.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Q1</text>
+<text fill="#000000" x="340.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Q2</text>
+<text fill="#000000" x="500.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Q3</text>
+<text fill="#000000" x="660.0" y="440.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Q4</text>
+<text transform="rotate(-90, 20, 250)" fill="#000000" x="20.0" y="250.0" text-anchor="middle" font-family="Arial, Helvetica, sans-serif" font-size="14.0" font-weight="bold">Revenue (Million USD)</text>
+<text fill="#000000" x="90.0" y="84.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">100.0</text>
+<text fill="#000000" x="90.0" y="152.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">80.0</text>
+<text fill="#000000" x="90.0" y="220.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">60.0</text>
+<text fill="#000000" x="90.0" y="288.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">40.0</text>
+<text fill="#000000" x="90.0" y="356.0" text-anchor="end" font-family="Arial, Helvetica, sans-serif" font-size="12.0">20.0</text>
+<rect fill="#2563eb" stroke="none" x="650.0" y="52.0" width="15.0" height="15.0"/>
+<text fill="#000000" x="670.0" y="64.0" text-anchor="start" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Bar</text>
+<rect fill="#7c3aed" stroke="none" x="650.0" y="77.0" width="15.0" height="15.0"/>
+<text fill="#000000" x="670.0" y="89.0" text-anchor="start" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Bar</text>
+<rect fill="#db2777" stroke="none" x="650.0" y="102.0" width="15.0" height="15.0"/>
+<text fill="#000000" x="670.0" y="114.0" text-anchor="start" font-family="Arial, Helvetica, sans-serif" font-size="12.0">Bar</text>
+</svg>

data/examples/xychart/README.adoc

@@ -0,0 +1,80 @@
+= XY Chart Examples
+
+== Purpose
+
+XY charts display data using x and y coordinates, supporting line and bar chart variations for trend visualization.
+
+== When to Use
+
+* Time series data visualization
+* Statistical trend analysis  
+* Performance metrics over time
+* Comparative data analysis
+* Revenue/sales tracking
+
+== Syntax Overview
+
+[source,mermaid]
+----
+xychart-beta
+    title "Chart Title"
+    x-axis [Q1, Q2, Q3, Q4]
+    y-axis "Revenue" 0 --> 100
+    line [20, 40, 60, 80]
+    bar [15, 35, 55, 75]
+----
+
+== Examples
+
+=== 01: Line Chart
+
+Demonstrates basic XY line chart with labeled axes.
+
+**File**: link:01-line-chart.mmd[01-line-chart.mmd]
+
+[source,mermaid]
+----
+include::01-line-chart.mmd[]
+----
+
+image::01-line-chart.svg[]
+
+=== 02: Bar Chart
+
+Showcases bar chart variation with multiple series.
+
+**File**: link:02-bar-chart.mmd[02-bar-chart.mmd]
+
+[source,mermaid]
+----
+include::02-bar-chart.mmd[]
+----
+
+image::02-bar-chart.svg[]
+
+== Features Demonstrated
+
+[%header,cols="1,1"]
+|===
+| Feature | Example
+
+| Line charts
+| 01
+
+| Bar charts
+| 02
+
+| Axis labeling
+| 01, 02
+
+| Multiple data series
+| 02
+
+| Value ranges
+| 01, 02
+|===
+
+== Additional Resources
+
+* link:../../README.adoc[Main Documentation]
+* https://mermaid.js.org/syntax/xychart.html[Mermaid XY Chart Documentation]

data/exe/sirena

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/sirena'
+require_relative '../lib/sirena/cli'
+
+Sirena::Cli.start(ARGV)

data/lib/sirena/cli.rb

@@ -0,0 +1,138 @@
+# frozen_string_literal: true
+
+require 'thor'
+
+module Sirena
+  # Command-line interface for sirena.
+  #
+  # Provides commands for rendering Mermaid diagrams to SVG and
+  # managing diagram types.
+  class Cli < Thor
+    def self.exit_on_failure?
+      true
+    end
+
+    desc 'render [FILE]', 'Render a Mermaid diagram to SVG'
+    long_desc <<~DESC
+      Renders a Mermaid diagram from FILE or stdin to SVG format.
+
+      If FILE is not provided or is "-", reads from stdin.
+      Output is written to stdout by default, or to the file specified
+      with --output.
+
+      Examples:
+        sirena render diagram.mmd
+        sirena render diagram.mmd --output diagram.svg
+        sirena render diagram.mmd --theme dark
+        sirena render diagram.mmd --theme /path/to/custom-theme.yml
+        cat diagram.mmd | sirena render
+        sirena render --verbose diagram.mmd
+    DESC
+    method_option :output,
+                  aliases: '-o',
+                  type: :string,
+                  desc: 'Output file path (default: stdout)'
+    method_option :format,
+                  aliases: '-f',
+                  type: :string,
+                  default: 'svg',
+                  desc: 'Output format (only svg supported)'
+    method_option :theme,
+                  aliases: '-t',
+                  type: :string,
+                  desc: 'Theme name or path to theme file ' \
+                        '(default, dark, light, high_contrast)'
+    method_option :verbose,
+                  aliases: '-v',
+                  type: :boolean,
+                  default: false,
+                  desc: 'Enable verbose output'
+    def render(file = '-')
+      require_relative 'commands/render'
+      Commands::RenderCommand.new(file, options).run
+    rescue StandardError => e
+      handle_error(e)
+    end
+
+    desc 'types', 'List supported diagram types'
+    long_desc <<~DESC
+      Lists all diagram types currently supported by sirena.
+
+      Examples:
+        sirena types
+    DESC
+    def types
+      require_relative 'commands/types'
+      Commands::TypesCommand.new(options).run
+    rescue StandardError => e
+      handle_error(e)
+    end
+
+    desc 'batch', 'Batch render multiple Mermaid diagrams'
+    long_desc <<~DESC
+      Renders all Mermaid diagrams in a directory to SVG format.
+
+      Recursively finds all .mmd files in the input directory and
+      generates corresponding SVG files in the output directory.
+
+      Examples:
+        sirena batch --input docs/diagrams --output docs/images
+        sirena batch -i diagrams -o output --theme dark
+        sirena batch -i docs -o output -v
+    DESC
+    method_option :input,
+                  aliases: '-i',
+                  type: :string,
+                  default: '.',
+                  desc: 'Input directory or file'
+    method_option :output,
+                  aliases: '-o',
+                  type: :string,
+                  default: 'output',
+                  desc: 'Output directory'
+    method_option :theme,
+                  aliases: '-t',
+                  type: :string,
+                  desc: 'Theme name or path to theme file'
+    method_option :verbose,
+                  aliases: '-v',
+                  type: :boolean,
+                  default: false,
+                  desc: 'Enable verbose output'
+    def batch
+      require_relative 'commands/batch'
+      Commands::BatchCommand.new(options).run
+    rescue StandardError => e
+      handle_error(e)
+    end
+
+    desc 'version', 'Show sirena version'
+    long_desc <<~DESC
+      Displays the current version of sirena.
+
+      Examples:
+        sirena version
+    DESC
+    def version
+      require_relative 'commands/version'
+      Commands::VersionCommand.new(options).run
+    rescue StandardError => e
+      handle_error(e)
+    end
+
+    # Make version available as --version flag
+    map %w[--version -V] => :version
+
+    private
+
+    # Handles errors and exits with appropriate code.
+    #
+    # @param error [StandardError] the error to handle
+    # @return [void]
+    def handle_error(error)
+      warn "Error: #{error.message}"
+      warn error.backtrace.join("\n") if options[:verbose]
+      exit 1
+    end
+  end
+end

data/lib/sirena/commands/batch.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+
+module Sirena
+  module Commands
+    # Batch command for rendering multiple Mermaid diagrams.
+    #
+    # Processes entire directories of .mmd files and generates
+    # corresponding SVG output files.
+    class BatchCommand
+      attr_reader :options
+
+      def initialize(options = {})
+        @options = options
+        @stats = { success: 0, failed: 0, errors: [] }
+      end
+
+      # Execute the batch rendering command.
+      #
+      # @return [void]
+      def run
+        input_path = options[:input] || '.'
+        output_path = options[:output] || 'output'
+
+        puts "Sirena Batch Renderer"
+        puts "=" * 60
+        puts "Input:  #{input_path}"
+        puts "Output: #{output_path}"
+        puts "Theme:  #{options[:theme] || 'default'}"
+        puts
+
+        files = find_mermaid_files(input_path)
+
+        if files.empty?
+          puts "No .mmd files found in: #{input_path}"
+          return
+        end
+
+        puts "Found #{files.length} diagram files"
+        puts
+
+        FileUtils.mkdir_p(output_path)
+
+        files.each_with_index do |file, idx|
+          process_file(file, input_path, output_path, idx + 1, files.length)
+        end
+
+        print_summary
+      end
+
+      private
+
+      def find_mermaid_files(path)
+        if File.directory?(path)
+          Dir.glob(File.join(path, '**', '*.mmd'))
+        elsif File.file?(path)
+          [path]
+        else
+          []
+        end
+      end
+
+      def process_file(file, input_base, output_base, current, total)
+        # Calculate relative path
+        relative = file.sub(/^#{Regexp.escape(input_base)}\/?/, '')
+        output_file = File.join(output_base, relative.sub(/\.mmd$/, '.svg'))
+
+        print "[#{current}/#{total}] #{relative}... "
+
+        begin
+          source = File.read(file)
+          svg = Sirena.render(source,
+                             theme: options[:theme],
+                             verbose: options[:verbose])
+
+          FileUtils.mkdir_p(File.dirname(output_file))
+          File.write(output_file, svg)
+
+          @stats[:success] += 1
+          puts "✅"
+        rescue => e
+          @stats[:failed] += 1
+          @stats[:errors] << { file: relative, error: e.message }
+          puts "❌ #{e.class.name}"
+          puts "   #{e.message}" if options[:verbose]
+        end
+      end
+
+      def print_summary
+        puts "\n" + "=" * 60
+        puts "BATCH RENDERING SUMMARY"
+        puts "=" * 60
+        puts "✅ Success: #{@stats[:success]}"
+        puts "❌ Failed:  #{@stats[:failed]}"
+        puts "   Total:   #{@stats[:success] + @stats[:failed]}"
+
+        if @stats[:failed] > 0
+          puts "\nErrors:"
+          @stats[:errors].first(5).each do |err|
+            puts "  #{err[:file]}: #{err[:error].lines.first.strip}"
+          end
+          if @stats[:errors].length > 5
+            puts "  ... and #{@stats[:errors].length - 5} more errors"
+          end
+          puts "\nUse --verbose to see full error details"
+        end
+
+        if @stats[:success] + @stats[:failed] > 0
+          success_rate = (@stats[:success].to_f /
+                         (@stats[:success] + @stats[:failed]) * 100).round(1)
+          puts "\nSuccess rate: #{success_rate}%"
+        end
+      end
+    end
+  end
+end

data/lib/sirena/commands/render.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Sirena
+  module Commands
+    # Command to render Mermaid diagrams to SVG.
+    class RenderCommand
+      attr_reader :file, :options
+
+      # Creates a new render command.
+      #
+      # @param file [String] input file path or '-' for stdin
+      # @param options [Hash] command options
+      def initialize(file, options = {})
+        @file = file
+        @options = options
+      end
+
+      # Executes the render command.
+      #
+      # @return [void]
+      def run
+        validate_format!
+
+        source = read_input
+        engine = Engine.new(
+          verbose: options[:verbose],
+          theme: options[:theme]
+        )
+        svg = engine.render(source)
+
+        write_output(svg)
+      end
+
+      private
+
+      # Validates the output format option.
+      #
+      # @return [void]
+      # @raise [ArgumentError] if format is not supported
+      def validate_format!
+        return if options[:format] == 'svg'
+
+        raise ArgumentError,
+              "Unsupported format: #{options[:format]}. " \
+              'Only SVG format is currently supported.'
+      end
+
+      # Reads input from file or stdin.
+      #
+      # @return [String] Mermaid source code
+      def read_input
+        if file == '-' || file.nil?
+          $stdin.read
+        else
+          File.read(file)
+        end
+      rescue Errno::ENOENT
+        raise ArgumentError, "File not found: #{file}"
+      rescue Errno::EACCES
+        raise ArgumentError, "Permission denied: #{file}"
+      end
+
+      # Writes output to file or stdout.
+      #
+      # @param svg [String] SVG content
+      # @return [void]
+      def write_output(svg)
+        if options[:output]
+          File.write(options[:output], svg)
+          puts "SVG written to #{options[:output]}" if options[:verbose]
+        else
+          puts svg
+        end
+      rescue Errno::EACCES
+        raise ArgumentError,
+              "Permission denied writing to: #{options[:output]}"
+      end
+    end
+  end
+end

data/lib/sirena/commands/types.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Sirena
+  module Commands
+    # Command to list supported diagram types.
+    class TypesCommand
+      attr_reader :options
+
+      # Creates a new types command.
+      #
+      # @param options [Hash] command options
+      def initialize(options = {})
+        @options = options
+      end
+
+      # Executes the types command.
+      #
+      # @return [void]
+      def run
+        puts 'Supported diagram types:'
+        puts
+
+        DiagramRegistry.types.each do |type|
+          puts "  #{type}"
+        end
+      end
+    end
+  end
+end

data/lib/sirena/commands/version.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Sirena
+  module Commands
+    # Command to display the gem version.
+    class VersionCommand
+      attr_reader :options
+
+      # Creates a new version command.
+      #
+      # @param options [Hash] command options
+      def initialize(options = {})
+        @options = options
+      end
+
+      # Executes the version command.
+      #
+      # @return [void]
+      def run
+        puts "sirena version #{Sirena::VERSION}"
+      end
+    end
+  end
+end