sirena 0.1.0

data/lib/sirena/transform/xy_chart.rb

@@ -0,0 +1,273 @@
+# frozen_string_literal: true
+
+module Sirena
+  module Transform
+    # Transforms an XYChart diagram into a positioned layout structure.
+    #
+    # The layout algorithm handles:
+    # - Chart area calculation and margins
+    # - Axis positioning and scaling
+    # - Data point coordinate mapping
+    # - Grid line calculations
+    #
+    # @example Transform an XY chart
+    #   transform = Transform::XYChart.new
+    #   layout = transform.to_graph(diagram)
+    class XYChart
+      # Default chart dimensions
+      DEFAULT_WIDTH = 800
+      DEFAULT_HEIGHT = 500
+
+      # Margins around the chart
+      MARGIN_TOP = 80
+      MARGIN_RIGHT = 60
+      MARGIN_BOTTOM = 80
+      MARGIN_LEFT = 100
+
+      # Transforms the diagram into a layout structure.
+      #
+      # @param diagram [Diagram::XYChart] the XY chart diagram
+      # @return [Hash] layout data with axes, datasets, and dimensions
+      def to_graph(diagram)
+        # Calculate plot area
+        plot_width = DEFAULT_WIDTH - MARGIN_LEFT - MARGIN_RIGHT
+        plot_height = DEFAULT_HEIGHT - MARGIN_TOP - MARGIN_BOTTOM
+
+        # Position axes
+        x_axis_layout = position_x_axis(diagram.x_axis, plot_width)
+        y_axis_layout = position_y_axis(diagram.y_axis, plot_height)
+
+        # Position datasets
+        datasets_layout = position_datasets(
+          diagram.datasets,
+          x_axis_layout,
+          y_axis_layout,
+          plot_width,
+          plot_height
+        )
+
+        {
+          width: DEFAULT_WIDTH,
+          height: DEFAULT_HEIGHT,
+          plot_x: MARGIN_LEFT,
+          plot_y: MARGIN_TOP,
+          plot_width: plot_width,
+          plot_height: plot_height,
+          x_axis: x_axis_layout,
+          y_axis: y_axis_layout,
+          datasets: datasets_layout,
+          title: diagram.title
+        }
+      end
+
+      private
+
+      # Positions the X-axis.
+      #
+      # @param axis [Diagram::XYAxis] X-axis
+      # @param width [Numeric] plot width
+      # @return [Hash] X-axis layout
+      def position_x_axis(axis, width)
+        return default_x_axis(width) unless axis
+
+        if axis.categorical?
+          position_categorical_axis(axis, width)
+        else
+          position_numeric_axis(axis, width)
+        end
+      end
+
+      # Positions a categorical X-axis.
+      #
+      # @param axis [Diagram::XYAxis] axis
+      # @param width [Numeric] plot width
+      # @return [Hash] axis layout
+      def position_categorical_axis(axis, width)
+        num_categories = axis.values.length
+        return default_x_axis(width) if num_categories == 0
+
+        # Calculate spacing between categories
+        spacing = width / [num_categories, 1].max
+
+        # Position each category
+        positions = axis.values.map.with_index do |label, idx|
+          {
+            label: label,
+            position: idx * spacing + spacing / 2,
+            index: idx
+          }
+        end
+
+        {
+          label: axis.label,
+          type: :categorical,
+          positions: positions,
+          min: 0,
+          max: num_categories - 1,
+          width: width
+        }
+      end
+
+      # Positions a numeric X-axis.
+      #
+      # @param axis [Diagram::XYAxis] axis
+      # @param width [Numeric] plot width
+      # @return [Hash] axis layout
+      def position_numeric_axis(axis, width)
+        min, max = axis.range
+
+        {
+          label: axis.label,
+          type: :numeric,
+          min: min,
+          max: max,
+          width: width,
+          scale: width / (max - min).to_f
+        }
+      end
+
+      # Returns a default X-axis layout.
+      #
+      # @param width [Numeric] plot width
+      # @return [Hash] default axis layout
+      def default_x_axis(width)
+        {
+          label: nil,
+          type: :numeric,
+          min: 0,
+          max: 10,
+          width: width,
+          scale: width / 10.0
+        }
+      end
+
+      # Positions the Y-axis.
+      #
+      # @param axis [Diagram::XYAxis] Y-axis
+      # @param height [Numeric] plot height
+      # @return [Hash] Y-axis layout
+      def position_y_axis(axis, height)
+        return default_y_axis(height) unless axis
+
+        min = axis.min || 0
+        max = axis.max || 100
+
+        {
+          label: axis.label,
+          min: min,
+          max: max,
+          height: height,
+          scale: height / (max - min).to_f
+        }
+      end
+
+      # Returns a default Y-axis layout.
+      #
+      # @param height [Numeric] plot height
+      # @return [Hash] default axis layout
+      def default_y_axis(height)
+        {
+          label: nil,
+          min: 0,
+          max: 100,
+          height: height,
+          scale: height / 100.0
+        }
+      end
+
+      # Positions all datasets.
+      #
+      # @param datasets [Array<Diagram::XYDataset>] datasets
+      # @param x_axis [Hash] X-axis layout
+      # @param y_axis [Hash] Y-axis layout
+      # @param width [Numeric] plot width
+      # @param height [Numeric] plot height
+      # @return [Array<Hash>] positioned datasets
+      def position_datasets(datasets, x_axis, y_axis, width, height)
+        datasets.map do |dataset|
+          points = position_dataset_points(
+            dataset,
+            x_axis,
+            y_axis,
+            width,
+            height
+          )
+
+          {
+            id: dataset.id,
+            label: dataset.label,
+            chart_type: dataset.chart_type,
+            points: points
+          }
+        end
+      end
+
+      # Positions points for a single dataset.
+      #
+      # @param dataset [Diagram::XYDataset] dataset
+      # @param x_axis [Hash] X-axis layout
+      # @param y_axis [Hash] Y-axis layout
+      # @param width [Numeric] plot width
+      # @param height [Numeric] plot height
+      # @return [Array<Hash>] positioned points
+      def position_dataset_points(dataset, x_axis, y_axis, width, height)
+        dataset.values.map.with_index do |y_value, idx|
+          x = calculate_x_position(idx, x_axis, width)
+          y = calculate_y_position(y_value, y_axis, height)
+
+          {
+            x: x,
+            y: y,
+            value: y_value,
+            index: idx
+          }
+        end
+      end
+
+      # Calculates X position for a data point.
+      #
+      # @param index [Integer] data point index
+      # @param x_axis [Hash] X-axis layout
+      # @param width [Numeric] plot width
+      # @return [Numeric] X coordinate
+      def calculate_x_position(index, x_axis, width)
+        if x_axis[:type] == :categorical && x_axis[:positions]
+          # Use pre-calculated positions for categories
+          position = x_axis[:positions][index]
+          position ? position[:position] : 0
+        else
+          # Distribute points evenly across width
+          num_points = 1 # Will be overridden by caller if needed
+          spacing = width / [index + 1, 1].max
+          index * spacing
+        end
+      end
+
+      # Calculates Y position for a data point.
+      #
+      # @param value [Numeric] Y value
+      # @param y_axis [Hash] Y-axis layout
+      # @param height [Numeric] plot height
+      # @return [Numeric] Y coordinate (inverted, 0 is top)
+      def calculate_y_position(value, y_axis, height)
+        # Normalize value to 0-1 range
+        normalized = normalize_value(value, y_axis[:min], y_axis[:max])
+
+        # Convert to pixel position (inverted, 0 is top)
+        height - (normalized * height)
+      end
+
+      # Normalizes a value to the 0-1 range.
+      #
+      # @param value [Numeric] value to normalize
+      # @param min_value [Numeric] minimum value
+      # @param max_value [Numeric] maximum value
+      # @return [Numeric] normalized value
+      def normalize_value(value, min_value, max_value)
+        return 0 if max_value == min_value
+
+        ((value - min_value).to_f / (max_value - min_value)).clamp(0, 1)
+      end
+    end
+  end
+end

data/lib/sirena/transform.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative 'transform/base'
+
+module Sirena
+  module Transform
+  end
+end

data/lib/sirena/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Sirena
+  VERSION = '0.1.0'
+end

data/lib/sirena.rb

@@ -0,0 +1,328 @@
+# frozen_string_literal: true
+
+require_relative 'sirena/version'
+
+module Sirena
+  class Error < StandardError; end
+
+  # Convenience method for rendering mermaid diagrams to SVG
+  #
+  # @param mermaid_source [String] Mermaid diagram source code
+  # @param options [Hash] Rendering options
+  # @return [String] SVG output
+  def self.render(mermaid_source, options = {})
+    Engine.new.render(mermaid_source, options)
+  end
+end
+
+# Load modules in dependency order
+require_relative 'sirena/text_measurement'
+require_relative 'sirena/diagram_registry'
+require_relative 'sirena/theme'
+require_relative 'sirena/theme/registry'
+require_relative 'sirena/svg'
+require_relative 'sirena/parser'
+require_relative 'sirena/diagram'
+require_relative 'sirena/transform'
+require_relative 'sirena/renderer'
+require_relative 'sirena/engine'
+
+# Initialize theme registry with built-in themes
+Sirena::Theme::Registry.load_builtin_themes
+
+# Convenience method for rendering mermaid diagrams to SVG
+#
+# @param mermaid_source [String] Mermaid diagram source code
+# @param options [Hash] Rendering options
+# @return [String] SVG output
+def self.render(mermaid_source, options = {})
+  Engine.new.render(mermaid_source, options)
+end
+
+# Load and register flowchart handlers
+require_relative 'sirena/parser/flowchart'
+require_relative 'sirena/transform/flowchart'
+require_relative 'sirena/renderer/flowchart'
+
+Sirena::DiagramRegistry.register(
+  :flowchart,
+  parser: Sirena::Parser::FlowchartParser,
+  transform: Sirena::Transform::FlowchartTransform,
+  renderer: Sirena::Renderer::FlowchartRenderer
+)
+
+# Load and register sequence diagram handlers
+require_relative 'sirena/parser/sequence'
+require_relative 'sirena/transform/sequence'
+require_relative 'sirena/renderer/sequence'
+
+Sirena::DiagramRegistry.register(
+  :sequence,
+  parser: Sirena::Parser::SequenceParser,
+  transform: Sirena::Transform::SequenceTransform,
+  renderer: Sirena::Renderer::SequenceRenderer
+)
+
+# Load and register class diagram handlers
+require_relative 'sirena/parser/class_diagram'
+require_relative 'sirena/transform/class_diagram'
+require_relative 'sirena/renderer/class_diagram'
+
+Sirena::DiagramRegistry.register(
+  :class_diagram,
+  parser: Sirena::Parser::ClassDiagramParser,
+  transform: Sirena::Transform::ClassDiagramTransform,
+  renderer: Sirena::Renderer::ClassDiagramRenderer
+)
+
+# Load and register state diagram handlers
+require_relative 'sirena/parser/state_diagram'
+require_relative 'sirena/transform/state_diagram'
+require_relative 'sirena/renderer/state_diagram'
+
+Sirena::DiagramRegistry.register(
+  :state_diagram,
+  parser: Sirena::Parser::StateDiagramParser,
+  transform: Sirena::Transform::StateDiagramTransform,
+  renderer: Sirena::Renderer::StateDiagramRenderer
+)
+
+# Load and register ER diagram handlers
+require_relative 'sirena/parser/er_diagram'
+require_relative 'sirena/transform/er_diagram'
+require_relative 'sirena/renderer/er_diagram'
+
+Sirena::DiagramRegistry.register(
+  :er_diagram,
+  parser: Sirena::Parser::ErDiagramParser,
+  transform: Sirena::Transform::ErDiagramTransform,
+  renderer: Sirena::Renderer::ErDiagramRenderer
+)
+
+# Load and register user journey diagram handlers
+require_relative 'sirena/parser/user_journey'
+require_relative 'sirena/transform/user_journey'
+require_relative 'sirena/renderer/user_journey'
+
+Sirena::DiagramRegistry.register(
+  :user_journey,
+  parser: Sirena::Parser::UserJourneyParser,
+  transform: Sirena::Transform::UserJourneyTransform,
+  renderer: Sirena::Renderer::UserJourneyRenderer
+)
+
+# Load and register pie chart diagram handlers
+require_relative 'sirena/parser/pie'
+require_relative 'sirena/transform/pie'
+require_relative 'sirena/renderer/pie'
+
+Sirena::DiagramRegistry.register(
+  :pie,
+  parser: Sirena::Parser::PieParser,
+  transform: Sirena::Transform::PieTransform,
+  renderer: Sirena::Renderer::PieRenderer
+)
+
+# Load and register Gantt chart diagram handlers
+require_relative 'sirena/parser/gantt'
+require_relative 'sirena/transform/gantt'
+require_relative 'sirena/renderer/gantt'
+
+Sirena::DiagramRegistry.register(
+  :gantt,
+  parser: Sirena::Parser::GanttParser,
+  transform: Sirena::Transform::GanttTransform,
+  renderer: Sirena::Renderer::GanttRenderer
+)
+
+# Load and register Timeline diagram handlers
+require_relative 'sirena/parser/timeline'
+require_relative 'sirena/transform/timeline'
+require_relative 'sirena/renderer/timeline'
+
+Sirena::DiagramRegistry.register(
+  :timeline,
+  parser: Sirena::Parser::TimelineParser,
+  transform: Sirena::Transform::TimelineTransform,
+  renderer: Sirena::Renderer::TimelineRenderer
+)
+
+# Load and register Quadrant chart diagram handlers
+require_relative 'sirena/parser/quadrant'
+require_relative 'sirena/transform/quadrant'
+require_relative 'sirena/renderer/quadrant'
+
+Sirena::DiagramRegistry.register(
+  :quadrant,
+  parser: Sirena::Parser::QuadrantParser,
+  transform: Sirena::Transform::QuadrantTransform,
+  renderer: Sirena::Renderer::QuadrantRenderer
+)
+
+# Load and register Git Graph diagram handlers
+require_relative 'sirena/parser/git_graph'
+require_relative 'sirena/transform/git_graph'
+require_relative 'sirena/renderer/git_graph'
+
+Sirena::DiagramRegistry.register(
+  :git_graph,
+  parser: Sirena::Parser::GitGraphParser,
+  transform: Sirena::Transform::GitGraph,
+  renderer: Sirena::Renderer::GitGraph
+)
+
+# Load and register Mindmap diagram handlers
+require_relative 'sirena/parser/mindmap'
+require_relative 'sirena/transform/mindmap'
+require_relative 'sirena/renderer/mindmap'
+
+Sirena::DiagramRegistry.register(
+  :mindmap,
+  parser: Sirena::Parser::MindmapParser,
+  transform: Sirena::Transform::Mindmap,
+  renderer: Sirena::Renderer::Mindmap
+)
+
+# Load and register Kanban diagram handlers
+require_relative 'sirena/parser/kanban'
+require_relative 'sirena/transform/kanban'
+require_relative 'sirena/renderer/kanban'
+
+Sirena::DiagramRegistry.register(
+  :kanban,
+  parser: Sirena::Parser::KanbanParser,
+  transform: Sirena::Transform::Kanban,
+  renderer: Sirena::Renderer::Kanban
+)
+
+# Load and register Radar chart diagram handlers
+require_relative 'sirena/parser/radar'
+require_relative 'sirena/transform/radar'
+require_relative 'sirena/renderer/radar'
+
+Sirena::DiagramRegistry.register(
+  :radar,
+  parser: Sirena::Parser::RadarParser,
+  transform: Sirena::Transform::Radar,
+  renderer: Sirena::Renderer::Radar
+)
+
+# Load and register Block diagram handlers
+require_relative 'sirena/parser/block'
+require_relative 'sirena/transform/block'
+require_relative 'sirena/renderer/block'
+
+Sirena::DiagramRegistry.register(
+  :block,
+  parser: Sirena::Parser::BlockParser,
+  transform: Sirena::Transform::BlockTransform,
+  renderer: Sirena::Renderer::BlockRenderer
+)
+
+
+# Load and register Requirement diagram handlers
+require_relative 'sirena/parser/requirement'
+require_relative 'sirena/transform/requirement'
+require_relative 'sirena/renderer/requirement'
+
+Sirena::DiagramRegistry.register(
+  :requirement,
+  parser: Sirena::Parser::RequirementParser,
+  transform: Sirena::Transform::RequirementTransform,
+  renderer: Sirena::Renderer::RequirementRenderer
+)
+
+# Load and register XY Chart diagram handlers
+require_relative 'sirena/parser/xy_chart'
+require_relative 'sirena/transform/xy_chart'
+require_relative 'sirena/renderer/xy_chart'
+
+Sirena::DiagramRegistry.register(
+  :xychart,
+  parser: Sirena::Parser::XYChartParser,
+  transform: Sirena::Transform::XYChart,
+  renderer: Sirena::Renderer::XYChart
+)
+
+# Load and register Architecture diagram handlers
+require_relative 'sirena/parser/architecture'
+require_relative 'sirena/transform/architecture'
+require_relative 'sirena/renderer/architecture'
+
+Sirena::DiagramRegistry.register(
+  :architecture,
+  parser: Sirena::Parser::Architecture,
+  transform: Sirena::Transform::ArchitectureTransform,
+  renderer: Sirena::Renderer::ArchitectureRenderer
+)
+
+# Load and register Sankey diagram handlers
+require_relative 'sirena/parser/sankey'
+require_relative 'sirena/transform/sankey'
+require_relative 'sirena/renderer/sankey'
+
+Sirena::DiagramRegistry.register(
+  :sankey,
+  parser: Sirena::Parser::SankeyParser,
+  transform: Sirena::Transform::SankeyTransform,
+  renderer: Sirena::Renderer::SankeyRenderer
+)
+# Load and register Packet diagram handlers
+require_relative 'sirena/parser/packet'
+require_relative 'sirena/transform/packet'
+require_relative 'sirena/renderer/packet'
+
+Sirena::DiagramRegistry.register(
+  :packet,
+  parser: Sirena::Parser::PacketParser,
+  transform: Sirena::Transform::Packet,
+  renderer: Sirena::Renderer::Packet
+)
+
+# Load and register Treemap diagram handlers
+require_relative 'sirena/parser/treemap'
+require_relative 'sirena/transform/treemap'
+require_relative 'sirena/renderer/treemap'
+
+Sirena::DiagramRegistry.register(
+  :treemap,
+  parser: Sirena::Parser::TreemapParser,
+  transform: Sirena::Transform::Treemap,
+  renderer: Sirena::Renderer::Treemap
+)
+
+# Load and register C4 diagram handlers
+require_relative 'sirena/parser/c4'
+require_relative 'sirena/transform/c4'
+require_relative 'sirena/renderer/c4'
+
+Sirena::DiagramRegistry.register(
+  :c4,
+  parser: Sirena::Parser::C4Parser,
+  transform: Sirena::Transform::C4Transform,
+  renderer: Sirena::Renderer::C4Renderer
+)
+
+# Load and register Info diagram handlers
+require_relative 'sirena/parser/info'
+require_relative 'sirena/transform/info'
+require_relative 'sirena/renderer/info'
+
+Sirena::DiagramRegistry.register(
+  :info,
+  parser: Sirena::Parser::InfoParser,
+  transform: Sirena::Transform::InfoTransform,
+  renderer: Sirena::Renderer::InfoRenderer
+)
+
+# Load and register Error diagram handlers
+require_relative 'sirena/parser/error'
+require_relative 'sirena/transform/error'
+require_relative 'sirena/renderer/error'
+
+Sirena::DiagramRegistry.register(
+  :error,
+  parser: Sirena::Parser::ErrorParser,
+  transform: Sirena::Transform::ErrorTransform,
+  renderer: Sirena::Renderer::ErrorRenderer
+)