sirena 0.1.0

data/lib/sirena/parser/grammars/state_diagram.rb

@@ -0,0 +1,172 @@
+# frozen_string_literal: true
+
+require_relative 'common'
+
+module Sirena
+  module Parser
+    module Grammars
+      # Parslet grammar for State diagrams.
+      #
+      # Handles State diagram syntax including states, transitions,
+      # composite states, special state markers (choice, fork, join),
+      # and concurrent states.
+      class StateDiagram < Common
+        root(:diagram)
+
+        # Main diagram structure
+        rule(:diagram) do
+          ws? >>
+            header >>
+            ws? >>
+            statements.maybe >>
+            ws?
+        end
+
+        rule(:header) do
+          (str('stateDiagram-v2') | str('stateDiagram')).as(:header) >>
+            ws? >>
+            direction.maybe.as(:direction)
+        end
+
+        rule(:direction) do
+          (str('TD') | str('TB') | str('LR') | str('RL')).as(:dir_value)
+        end
+
+        rule(:statements) do
+          (statement >> ws?).repeat(1)
+        end
+
+        rule(:statement) do
+          state_declaration |
+            transition |
+            note_statement |
+            standalone_state
+        end
+
+        # State declaration with description, marker, or composite body
+        rule(:state_declaration) do
+          str('state').as(:keyword) >> space >>
+            state_id.as(:state_id) >> space? >>
+            (
+              state_marker.as(:marker) |
+              state_description.as(:description) |
+              composite_body.as(:composite)
+            ).maybe >>
+            line_end
+        end
+
+        # Transition between states
+        rule(:transition) do
+          from_state.as(:from) >> space? >>
+            arrow >>
+            space? >>
+            to_state.as(:to) >>
+            transition_label.maybe.as(:label) >>
+            (
+              space? >> arrow >> space? >> to_state.as(:chain_to)
+            ).repeat.as(:chain) >>
+            line_end
+        end
+
+        # Note statement
+        rule(:note_statement) do
+          str('note').as(:note_keyword) >> space >>
+            note_position.as(:position) >> space >>
+            str('of') >> space >>
+            state_id.as(:note_target) >> space? >>
+            (colon >> space? >> note_text.as(:note_text)).maybe >>
+            line_end
+        end
+
+        # Standalone state (just an identifier)
+        rule(:standalone_state) do
+          state_id.as(:state_id) >> line_end
+        end
+
+        # From state in transition
+        rule(:from_state) do
+          start_end_marker | state_id
+        end
+
+        # To state in transition
+        rule(:to_state) do
+          start_end_marker | state_id
+        end
+
+        # Start/end marker [*]
+        rule(:start_end_marker) do
+          lbracket >> asterisk >> rbracket
+        end
+
+        # State ID (identifier or quoted string)
+        rule(:state_id) do
+          string | identifier
+        end
+
+        # State description (after colon)
+        rule(:state_description) do
+          colon >> space? >>
+            (line_end.absent? >> lbrace.absent? >> any).repeat(1)
+        end
+
+        # State marker: <<choice>>, <<fork>>, <<join>>
+        rule(:state_marker) do
+          str('<<') >>
+            (str('choice') | str('fork') | str('join')).as(:marker_type) >>
+            str('>>')
+        end
+
+        # Composite state body with nested statements
+        rule(:composite_body) do
+          lbrace >> ws? >>
+            composite_statements.maybe >>
+            ws? >> rbrace
+        end
+
+        # Statements within composite state
+        rule(:composite_statements) do
+          (composite_statement >> ws?).repeat(1)
+        end
+
+        rule(:composite_statement) do
+          concurrent_separator |
+            state_declaration |
+            transition |
+            note_statement |
+            standalone_state
+        end
+
+        # Concurrent state separator
+        rule(:concurrent_separator) do
+          str('--').as(:concurrent_sep) >> line_end
+        end
+
+        # Arrow for transitions
+        rule(:arrow) do
+          str('-->').as(:arrow)
+        end
+
+        # Transition label (after colon)
+        rule(:transition_label) do
+          space? >> colon >> space? >>
+            (line_end.absent? >> arrow.absent? >> any).repeat(1).as(:label_text)
+        end
+
+        # Note position
+        rule(:note_position) do
+          str('left') | str('right')
+        end
+
+        # Note text
+        rule(:note_text) do
+          (line_end.absent? >> any).repeat(1)
+        end
+
+        # Line terminators for State diagrams
+        rule(:line_end) do
+          semicolon.maybe >> space? >> (comment.maybe >> newline | eof)
+        end
+      end
+    end
+  end
+end

data/lib/sirena/parser/grammars/timeline.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require_relative "common"
+
+module Sirena
+  module Parser
+    module Grammars
+      # Parslet grammar for timeline diagrams.
+      #
+      # Handles timeline syntax including title, sections, events with
+      # timestamps and descriptions, and accessibility features.
+      #
+      # @example Simple timeline
+      #   timeline
+      #     title History of Social Media
+      #     2002 : LinkedIn
+      #     2004 : Facebook : Google
+      #     2005 : YouTube
+      #
+      # @example Timeline with sections
+      #   timeline
+      #     section 20th Century
+      #       1903 : Wright Brothers flight
+      #     section 21st Century
+      #       2007 : iPhone released
+      class Timeline < Common
+        root(:diagram)
+
+        # Main diagram structure
+        rule(:diagram) do
+          ws? >>
+            header >>
+            ws? >>
+            statements.maybe >>
+            ws?
+        end
+
+        # Header: timeline
+        rule(:header) do
+          str("timeline").as(:header) >> ws?
+        end
+
+        # Statements (title, sections, events, tasks)
+        rule(:statements) do
+          (statement >> ws?).repeat(1)
+        end
+
+        rule(:statement) do
+          acc_title_declaration |
+            acc_descr_declaration |
+            title_declaration |
+            section_declaration |
+            event_entry |
+            task_entry |
+            comment >> line_end
+        end
+
+        # Title
+        rule(:title_declaration) do
+          str("title") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:title) >>
+            line_end
+        end
+
+        # Accessibility title
+        rule(:acc_title_declaration) do
+          str("accTitle") >> space? >> colon >> space? >>
+            (line_end.absent? >> any).repeat.as(:acc_title) >>
+            line_end
+        end
+
+        # Accessibility description (single or multi-line)
+        rule(:acc_descr_declaration) do
+          acc_descr_single_line | acc_descr_multi_line
+        end
+
+        rule(:acc_descr_single_line) do
+          str("accDescr") >> space? >> colon >> space? >>
+            (line_end.absent? >> any).repeat.as(:acc_descr) >>
+            line_end
+        end
+
+        rule(:acc_descr_multi_line) do
+          str("accDescr") >> space? >> lbrace >> ws? >>
+            (rbrace.absent? >> any).repeat.as(:acc_descr) >>
+            ws? >> rbrace >> line_end
+        end
+
+        # Section declaration
+        rule(:section_declaration) do
+          str("section") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:section) >>
+            line_end
+        end
+
+        # Event entry: time : description(s)
+        # Can have multiple descriptions separated by colons
+        # Example: 2004 : Facebook : Google
+        rule(:event_entry) do
+          (space? >> event_time.as(:time) >>
+            space? >> colon >>
+            event_descriptions.as(:descriptions) >>
+            line_end).as(:event_entry) |
+            (space? >> colon >>
+              event_descriptions.as(:descriptions) >>
+              line_end).as(:continuation_entry)
+        end
+
+        # Event time (year, date, task name, or any time identifier)
+        # Can include spaces, alphanumeric, and common punctuation
+        rule(:event_time) do
+          (colon.absent? >> line_end.absent? >> any).repeat(1)
+        end
+
+        # Event descriptions (one or more, separated by colons)
+        rule(:event_descriptions) do
+          event_description.as(:desc) >>
+            (space? >> colon >> space? >> event_description.as(:desc)).repeat
+        end
+
+        # Single event description (can include HTML tags like <br>)
+        rule(:event_description) do
+          space? >>
+            (colon.absent? >> line_end.absent? >> any).repeat(1) >>
+            space?
+        end
+
+        # Task entry (plain text without colon, for sections)
+        rule(:task_entry) do
+          (colon.absent? >>
+            str("section").absent? >>
+            str("title").absent? >>
+            str("accTitle").absent? >>
+            str("accDescr").absent? >>
+            line_end.absent? >>
+            any).repeat(1).as(:task) >>
+          line_end
+        end
+      end
+    end
+  end
+end

data/lib/sirena/parser/grammars/treemap.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require 'parslet'
+
+module Sirena
+  module Parser
+    module Grammars
+      # Parslet grammar for treemap diagrams
+      class Treemap < Parslet::Parser
+        rule(:space) { match[' \t'] }
+        rule(:space?) { space.maybe }
+        rule(:spaces) { space.repeat(1) }
+        rule(:spaces?) { space.repeat }
+        rule(:newline) { str("\n") | str("\r\n") }
+        rule(:newlines) { newline.repeat(1) }
+        rule(:newlines?) { newline.repeat }
+        rule(:eof) { any.absent? }
+
+        # Comments
+        rule(:comment) { str('%%') >> (newline.absent? >> any).repeat }
+
+        # Numbers
+        rule(:number) do
+          (match['-'].maybe >> match['0-9'].repeat(1) >>
+           (str('.') >> match['0-9'].repeat(1)).maybe).as(:number)
+        end
+
+        # Quoted strings
+        rule(:quoted_string) do
+          str('"') >> (
+            str('\\') >> any |
+            str('"').absent? >> any
+          ).repeat.as(:string) >> str('"')
+        end
+
+        # Identifiers
+        rule(:identifier) do
+          (match['a-zA-Z_'] >> match['a-zA-Z0-9_-'].repeat).as(:identifier)
+        end
+
+        # Keywords
+        rule(:treemap_keyword) do
+          (str('treemap-beta') | str('treemap')).as(:keyword)
+        end
+
+        # Title declaration
+        rule(:title_decl) do
+          str('title') >> spaces >> (newline.absent? >> any).repeat(1).as(:title)
+        end
+
+        # Accessibility declarations
+        rule(:acc_title) do
+          str('accTitle:') >> spaces? >> (newline.absent? >> any).repeat(1).as(:acc_title)
+        end
+
+        rule(:acc_descr) do
+          str('accDescr') >> spaces? >> str(':').maybe >> spaces? >>
+            (newline.absent? >> any).repeat(1).as(:acc_descr)
+        end
+
+        # CSS class reference
+        rule(:css_class) do
+          str(':::') >> identifier.as(:css_class)
+        end
+
+        # Value separator (: or ,) with optional spaces before and after
+        rule(:value_separator) { spaces? >> (str(':') | str(',')) >> spaces? }
+
+        # Node with optional value and CSS class
+        rule(:node_value) do
+          quoted_string.as(:label) >>
+            (value_separator >> number.as(:value)).maybe >>
+            css_class.maybe
+        end
+
+        # Capture leading spaces as a string to count indentation
+        rule(:indent_str) do
+          match[' '].repeat.as(:indent)
+        end
+
+        # Node line (with indentation captured)
+        rule(:node_line) do
+          indent_str >> node_value >> spaces? >>
+            (comment.maybe >> (newline | eof))
+        end
+
+        # Class definition
+        rule(:class_def) do
+          str('classDef') >> spaces >>
+            identifier.as(:class_name) >> spaces >>
+            (str(';').absent? >> any).repeat(1).as(:class_styles) >>
+            str(';').maybe
+        end
+
+        # Statement (title, acc, node, or class def)
+        rule(:statement) do
+          (
+            title_decl >> spaces? |
+            acc_title >> spaces? |
+            acc_descr >> spaces? |
+            class_def.as(:class_def) >> spaces? |
+            node_line.as(:node) |
+            comment >> spaces? |
+            spaces? >> newline
+          )
+        end
+
+        # Main diagram
+        rule(:diagram) do
+          treemap_keyword >>
+            spaces? >> newline >>
+            statement.repeat.as(:statements) >>
+            spaces? >> eof
+        end
+
+        root(:diagram)
+      end
+    end
+  end
+end

data/lib/sirena/parser/grammars/xy_chart.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require "parslet"
+require_relative "common"
+
+module Sirena
+  module Parser
+    module Grammars
+      # Grammar for parsing Mermaid xychart-beta syntax
+      class XYChart < Common
+
+        rule(:diagram_type) { str("xychart-beta") >> space? }
+
+        # Common line patterns
+        rule(:eol) { line_end }
+        rule(:indent?) { space? }
+        rule(:comment_line) { comment >> newline }
+        rule(:empty_line) { space? >> newline }
+        rule(:text) { match['[^"\n\r]'].repeat(1) }
+
+        rule(:title_line) do
+          str("title") >> space >> quoted_string.as(:title) >> eol
+        end
+
+        # X-axis: x-axis [jan, feb, mar] or x-axis "Label" [1, 2, 3]
+        rule(:axis_value) do
+          space? >>
+            (integer.as(:value) | identifier.as(:value)) >>
+            space?
+        end
+
+        rule(:axis_values) do
+          str("[") >>
+            axis_value >> (str(",") >> axis_value).repeat >>
+            str("]")
+        end
+
+        rule(:x_axis_line) do
+          str("x-axis") >>
+            (space >> quoted_string.as(:x_label)).maybe >>
+            space >> axis_values.as(:x_values) >>
+            eol
+        end
+
+        # Y-axis: y-axis "Label" min --> max or y-axis min --> max
+        rule(:range_separator) { str("-->") }
+
+        rule(:y_axis_line) do
+          str("y-axis") >>
+            (space >> quoted_string.as(:y_label)).maybe >>
+            space >> integer.as(:y_min) >>
+            space >> range_separator >>
+            space >> integer.as(:y_max) >>
+            eol
+        end
+
+        # Dataset values: [1, 2, 3, 4] or [1.5, 2.7, 3.2]
+        rule(:number_value) do
+          space? >>
+            (
+              integer >> (str(".") >> match["0-9"].repeat(1)).maybe
+            ).as(:value) >>
+            space?
+        end
+
+        rule(:value_array) do
+          str("[") >>
+            number_value >> (str(",") >> number_value).repeat >>
+            str("]")
+        end
+
+        # Line dataset: line [values]
+        rule(:line_dataset) do
+          str("line") >>
+            space >> value_array.as(:line_values) >>
+            eol
+        end
+
+        # Bar dataset: bar [values]
+        rule(:bar_dataset) do
+          str("bar") >>
+            space >> value_array.as(:bar_values) >>
+            eol
+        end
+
+        # Named dataset: dataset "Name" [values]
+        rule(:named_dataset) do
+          str("dataset") >>
+            space >> quoted_string.as(:dataset_label) >>
+            space >> value_array.as(:dataset_values) >>
+            eol
+        end
+
+        rule(:dataset_line) do
+          line_dataset | bar_dataset | named_dataset
+        end
+
+        rule(:statement) do
+          indent? >> (
+            title_line |
+            x_axis_line |
+            y_axis_line |
+            dataset_line |
+            comment_line |
+            empty_line
+          )
+        end
+
+        rule(:body) { statement.repeat }
+
+        rule(:xychart_diagram) do
+          diagram_type >> eol >>
+            body.as(:statements)
+        end
+
+        root(:xychart_diagram)
+      end
+    end
+  end
+end

data/lib/sirena/parser/info.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+require_relative 'grammars/info'
+require_relative 'transforms/info'
+require_relative '../diagram/info'
+
+module Sirena
+  module Parser
+    # Info diagram parser for Mermaid info diagram syntax.
+    #
+    # Uses Parslet grammar-based parsing to handle simple info diagrams.
+    #
+    # Parses info diagrams with support for:
+    # - Basic info keyword
+    # - Optional showInfo flag
+    #
+    # @example Parse a simple info diagram
+    #   parser = InfoParser.new
+    #   diagram = parser.parse("info")
+    #
+    # @example Parse info diagram with showInfo
+    #   parser = InfoParser.new
+    #   diagram = parser.parse("info showInfo")
+    class InfoParser < Base
+      # Parses info diagram source into an Info diagram model.
+      #
+      # @param source [String] the Mermaid info diagram source
+      # @return [Diagram::Info] the parsed info diagram
+      # @raise [ParseError] if syntax is invalid
+      def parse(source)
+        grammar = Grammars::Info.new
+
+        begin
+          parse_tree = grammar.parse(source)
+        rescue Parslet::ParseFailed => e
+          raise ParseError, "Syntax error at #{e.parse_failure_cause.pos}: " \
+                           "#{e.parse_failure_cause}"
+        end
+
+        # Transform parse tree to diagram model
+        transform = Transforms::Info.new
+        diagram = transform.apply(parse_tree)
+
+        diagram
+      end
+    end
+  end
+end

data/lib/sirena/parser/kanban.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require_relative "grammars/kanban"
+require_relative "transforms/kanban"
+require_relative "../diagram/kanban"
+
+module Sirena
+  module Parser
+    # Kanban parser for Mermaid kanban diagram syntax.
+    #
+    # Uses Parslet grammar-based parsing to handle kanban syntax
+    # with columns, cards, and metadata.
+    #
+    # Parses kanban boards with support for:
+    # - Column definitions: id[Title]
+    # - Card definitions: id[Text]
+    # - Metadata: @{ key: 'value' }
+    # - Properties: assigned, ticket, icon, label, priority
+    #
+    # @example Parse a simple kanban board
+    #   parser = KanbanParser.new
+    #   source = <<~MERMAID
+    #     kanban
+    #       id1[Todo]
+    #         docs[Create Documentation]
+    #       id2[Done]
+    #         release[Release v1.0]
+    #   MERMAID
+    #   diagram = parser.parse(source)
+    class KanbanParser < Base
+      # Parses kanban diagram source into a Kanban model.
+      #
+      # @param source [String] the Mermaid kanban diagram source
+      # @return [Diagram::Kanban] the parsed kanban diagram
+      # @raise [ParseError] if syntax is invalid
+      def parse(source)
+        grammar = Grammars::Kanban.new
+
+        begin
+          parse_tree = grammar.parse(source)
+        rescue Parslet::ParseFailed => e
+          raise ParseError, "Syntax error at #{e.parse_failure_cause.pos}: " \
+                           "#{e.parse_failure_cause}"
+        end
+
+        # Transform parse tree to diagram model
+        transform = Transforms::Kanban.new
+        result = transform.apply(parse_tree)
+
+        # Create the diagram model
+        create_diagram(result)
+      end
+
+      private
+
+      def create_diagram(result)
+        diagram = Diagram::Kanban.new
+
+        # Build columns and cards
+        result[:columns]&.each do |column_data|
+          column = build_column(column_data)
+          diagram.add_column(column)
+        end
+
+        diagram
+      end
+
+      def build_column(column_data)
+        column = Diagram::KanbanColumn.new(
+          id: column_data[:id],
+          title: column_data[:title]
+        )
+
+        # Add cards to column
+        column_data[:cards]&.each do |card_data|
+          card = build_card(card_data)
+          column.add_card(card)
+        end
+
+        column
+      end
+
+      def build_card(card_data)
+        Diagram::KanbanCard.new(
+          id: card_data[:id],
+          text: card_data[:text],
+          assigned: card_data[:assigned],
+          ticket: card_data[:ticket],
+          icon: card_data[:icon],
+          label: card_data[:label],
+          priority: card_data[:priority]
+        )
+      end
+    end
+  end
+end