sirena 0.1.0

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

@@ -0,0 +1,298 @@
+# frozen_string_literal: true
+
+require_relative 'common'
+
+module Sirena
+  module Parser
+    module Grammars
+      # Parslet grammar for Flowchart diagrams.
+      #
+      # Handles flowchart syntax including nodes with various shapes,
+      # edges with labels, edge chaining, subgraphs, and styling directives.
+      class Flowchart < Common
+        root(:diagram)
+
+        # Main diagram structure
+        rule(:diagram) do
+          ws? >>
+            header >>
+            ws? >>
+            statements.maybe >>
+            ws?
+        end
+
+        rule(:header) do
+          (str('flowchart') | str('graph')).as(:header) >>
+            ws? >>
+            direction.maybe.as(:direction)
+        end
+
+        rule(:direction) do
+          (str('TD') | str('TB') | str('LR') | str('RL') | str('BT')).as(:dir_value)
+        end
+
+        rule(:statements) do
+          (statement >> ws?).repeat(1)
+        end
+
+        rule(:statement) do
+          subgraph_statement |
+            style_statement |
+            class_def_statement |
+            class_assignment_statement |
+            click_statement |
+            node_edge_statement |
+            standalone_node
+        end
+
+        # Subgraph: subgraph id [title] ... end
+        rule(:subgraph_statement) do
+          str('subgraph').as(:subgraph_keyword) >> space >>
+            node_id.as(:subgraph_id) >>
+            (space >> subgraph_title.as(:subgraph_title)).maybe >>
+            ws? >>
+            statements.maybe.as(:subgraph_statements) >>
+            ws? >>
+            str('end').as(:subgraph_end) >>
+            line_end
+        end
+
+        rule(:subgraph_title) do
+          lbracket >> (rbracket.absent? >> any).repeat(1) >> rbracket
+        end
+
+        # Style: style nodeId fill:#f9f
+        rule(:style_statement) do
+          str('style').as(:style_keyword) >> space >>
+            node_id.as(:style_target) >>
+            (space >> style_property).repeat(1).as(:style_props) >>
+            line_end
+        end
+
+        rule(:style_property) do
+          (line_end.absent? >> comma.absent? >> any).repeat(1)
+        end
+
+        # ClassDef: classDef className fill:#f9f
+        rule(:class_def_statement) do
+          str('classDef').as(:classdef_keyword) >> space >>
+            identifier.as(:class_name) >>
+            (space >> style_property).repeat(1).as(:class_props) >>
+            line_end
+        end
+
+        # Class assignment: class nodeId className
+        rule(:class_assignment_statement) do
+          str('class').as(:class_keyword) >> space >>
+            node_id.as(:class_target) >> space >>
+            identifier.as(:class_name) >>
+            line_end
+        end
+
+        # Click: click nodeId href (may not fully implement, just parse)
+        rule(:click_statement) do
+          str('click').as(:click_keyword) >> space >>
+            node_id.as(:click_target) >>
+            (space >> (line_end.absent? >> any).repeat(1)).maybe.as(:click_action) >>
+            line_end
+        end
+
+        # Node with optional shape and edges
+        rule(:node_edge_statement) do
+          node_with_shape.as(:node) >>
+            (ws? >> edge_chain).maybe.as(:edges) >>
+            line_end
+        end
+
+        # Standalone node (just an identifier)
+        rule(:standalone_node) do
+          node_id.as(:node_id) >> line_end
+        end
+
+        # Node with optional shape definition
+        rule(:node_with_shape) do
+          node_id.as(:node_id) >>
+            (ws? >> inline_class.as(:inline_class)).maybe >>
+            (ws? >> node_shape.as(:shape)).maybe
+        end
+
+        # Inline class syntax: :::className
+        rule(:inline_class) do
+          str(':::') >> identifier
+        end
+
+        # Node shape with label
+        rule(:node_shape) do
+          # Order matters: try longer delimiters first
+          shape_triple_circle |
+            shape_stadium |
+            shape_subroutine |
+            shape_cylindrical |
+            shape_double_circle |
+            shape_hexagon |
+            shape_parallelogram |
+            shape_parallelogram_alt |
+            shape_trapezoid |
+            shape_trapezoid_alt |
+            shape_asymmetric |
+            shape_rectangle |
+            shape_rounded |
+            shape_rhombus
+        end
+
+        # Shape definitions (15+ shapes)
+        # Rectangle: [label]
+        rule(:shape_rectangle) do
+          lbracket.as(:open) >>
+            (rbracket.absent? >> any).repeat.as(:label) >>
+            rbracket.as(:close)
+        end
+
+        # Rounded: (label)
+        rule(:shape_rounded) do
+          lparen.as(:open) >>
+            (rparen.absent? >> any).repeat.as(:label) >>
+            rparen.as(:close)
+        end
+
+        # Stadium: ([label])
+        rule(:shape_stadium) do
+          str('([').as(:open) >>
+            (str('])').absent? >> any).repeat.as(:label) >>
+            str('])').as(:close)
+        end
+
+        # Subroutine: [[label]]
+        rule(:shape_subroutine) do
+          str('[[').as(:open) >>
+            (str(']]').absent? >> any).repeat.as(:label) >>
+            str(']]').as(:close)
+        end
+
+        # Cylindrical/Database: [(label)]
+        rule(:shape_cylindrical) do
+          str('[(').as(:open) >>
+            (str(')]').absent? >> any).repeat.as(:label) >>
+            str(')]').as(:close)
+        end
+
+        # Circle: ((label))
+        rule(:shape_double_circle) do
+          str('((').as(:open) >>
+            (str('))').absent? >> any).repeat.as(:label) >>
+            str('))').as(:close)
+        end
+
+        # Triple Circle: (((label)))
+        rule(:shape_triple_circle) do
+          str('(((').as(:open) >>
+            (str(')))').absent? >> any).repeat.as(:label) >>
+            str(')))').as(:close)
+        end
+
+        # Asymmetric: >label]
+        rule(:shape_asymmetric) do
+          str('>').as(:open) >>
+            (rbracket.absent? >> any).repeat.as(:label) >>
+            rbracket.as(:close)
+        end
+
+        # Rhombus/Diamond: {label}
+        rule(:shape_rhombus) do
+          lbrace.as(:open) >>
+            (rbrace.absent? >> any).repeat.as(:label) >>
+            rbrace.as(:close)
+        end
+
+        # Hexagon: {{label}}
+        rule(:shape_hexagon) do
+          str('{{').as(:open) >>
+            (str('}}').absent? >> any).repeat.as(:label) >>
+            str('}}').as(:close)
+        end
+
+        # Parallelogram: [/label/]
+        rule(:shape_parallelogram) do
+          str('[/').as(:open) >>
+            (str('/]').absent? >> any).repeat.as(:label) >>
+            str('/]').as(:close)
+        end
+
+        # Parallelogram Alt: [\label\]
+        rule(:shape_parallelogram_alt) do
+          str('[\\').as(:open) >>
+            (str('\\]').absent? >> any).repeat.as(:label) >>
+            str('\\]').as(:close)
+        end
+
+        # Trapezoid: [/label\]
+        rule(:shape_trapezoid) do
+          str('[/').as(:open) >>
+            (str('\\]').absent? >> any).repeat.as(:label) >>
+            str('\\]').as(:close)
+        end
+
+        # Trapezoid Alt: [\label/]
+        rule(:shape_trapezoid_alt) do
+          str('[\\').as(:open) >>
+            (str('/]').absent? >> any).repeat.as(:label) >>
+            str('/]').as(:close)
+        end
+
+        # Edge chain: can have multiple edges from one node
+        rule(:edge_chain) do
+          edge >> (ws? >> edge).repeat
+        end
+
+        # Single edge with optional label
+        rule(:edge) do
+          arrow.as(:arrow) >>
+            ws? >>
+            edge_label.maybe.as(:label) >>
+            ws? >>
+            node_with_shape.as(:target)
+        end
+
+        # Arrow types
+        rule(:arrow) do
+          thick_arrow | dotted_arrow | plain_arrow
+        end
+
+        # Thick arrow: ==> or ==
+        rule(:thick_arrow) do
+          (str('==>') | str('==')).as(:thick)
+        end
+
+        # Dotted arrow: -.-> or -.-
+        rule(:dotted_arrow) do
+          (str('-.->') | str('-.-')).as(:dotted)
+        end
+
+        # Plain arrow: --> or --- or ->
+        rule(:plain_arrow) do
+          (str('-->') | str('---') | str('->')).as(:plain)
+        end
+
+        # Edge label: can be in pipes |label|
+        rule(:edge_label) do
+          pipe_label
+        end
+
+        # Pipe label: |label|
+        rule(:pipe_label) do
+          pipe >> (pipe.absent? >> any).repeat(1) >> pipe
+        end
+
+        # Node identifier
+        rule(:node_id) do
+          quoted_string | identifier
+        end
+
+        # Line terminator
+        rule(:line_end) do
+          semicolon.maybe >> space? >> (comment.maybe >> newline | eof)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,252 @@
+# frozen_string_literal: true
+
+require_relative "common"
+
+module Sirena
+  module Parser
+    module Grammars
+      # Parslet grammar for Gantt chart diagrams.
+      #
+      # Handles Gantt chart syntax including title, date formatting,
+      # sections, tasks with dependencies, and timeline configuration.
+      #
+      # @example Simple Gantt chart
+      #   gantt
+      #     title Project Timeline
+      #     dateFormat YYYY-MM-DD
+      #     section Planning
+      #     Task 1 :a1, 2024-01-01, 30d
+      #     Task 2 :after a1, 20d
+      class Gantt < Common
+        root(:diagram)
+
+        # Main diagram structure
+        rule(:diagram) do
+          ws? >>
+            header >>
+            ws? >>
+            statements.maybe >>
+            ws?
+        end
+
+        # Header: gantt
+        rule(:header) do
+          str("gantt").as(:header) >> ws?
+        end
+
+        # Statements (configuration, sections, tasks, clicks)
+        rule(:statements) do
+          (ws? >> statement >> ws?).repeat(1)
+        end
+
+        rule(:statement) do
+          acc_title_declaration |
+            acc_descr_declaration |
+            title_declaration |
+            date_format_declaration |
+            axis_format_declaration |
+            tick_interval_declaration |
+            excludes_declaration |
+            today_marker_declaration |
+            section_declaration |
+            click_declaration |
+            task_entry |
+            comment
+        end
+
+        # Title
+        rule(:title_declaration) do
+          str("title") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:title) >>
+            line_end
+        end
+
+        # Date format
+        rule(:date_format_declaration) do
+          str("dateFormat") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:date_format) >>
+            line_end
+        end
+
+        # Axis format
+        rule(:axis_format_declaration) do
+          str("axisFormat") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:axis_format) >>
+            line_end
+        end
+
+        # Tick interval
+        rule(:tick_interval_declaration) do
+          str("tickInterval") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:tick_interval) >>
+            line_end
+        end
+
+        # Excludes (weekends, weekdays, or specific dates)
+        rule(:excludes_declaration) do
+          str("excludes") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:excludes) >>
+            line_end
+        end
+
+        # Today marker
+        rule(:today_marker_declaration) do
+          str("todayMarker") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:today_marker) >>
+            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
+
+        # Click declaration for interactivity
+        rule(:click_declaration) do
+          str("click") >> space.repeat(1) >>
+            identifier.as(:click_id) >>
+            space.repeat(1) >>
+            (click_href | click_callback) >>
+            line_end
+        end
+
+        rule(:click_href) do
+          str("href") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:href)
+        end
+
+        rule(:click_callback) do
+          str("call") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:callback)
+        end
+
+        # Task entry with various formats
+        rule(:task_entry) do
+          (task_description.as(:description) >>
+            space? >> colon >> space? >>
+            task_details.as(:task_details) >>
+            line_end).as(:task_entry)
+        end
+
+        rule(:task_description) do
+          (colon.absent? >> line_end.absent? >> any).repeat(1)
+        end
+
+        # Task details can have multiple formats:
+        # :tag, date, duration
+        # :id, after other_id, duration
+        # :id, start, end
+        # :after id, duration
+        # :duration
+        rule(:task_details) do
+          task_with_tags |
+            task_with_id_and_dependency |
+            task_with_dependency |
+            task_with_dates |
+            task_with_duration_only
+        end
+
+        # Task with tags (done, active, crit, milestone)
+        rule(:task_with_tags) do
+          tags.as(:tags) >>
+            (space? >> comma >> space? >> task_timing).maybe
+        end
+
+        # Task with ID and after dependency (:id, after other_id, duration)
+        rule(:task_with_id_and_dependency) do
+          task_id.as(:id) >> space? >> comma >> space? >>
+            str("after") >> space.repeat(1) >>
+            task_id.as(:after_task) >>
+            (space? >> comma >> space? >> (task_end_date | task_duration)).maybe
+        end
+
+        # Task with after dependency (after other_id, duration)
+        rule(:task_with_dependency) do
+          str("after") >> space.repeat(1) >>
+            task_id.as(:after_task) >>
+            (space? >> comma >> space? >> (task_end_date | task_duration)).maybe
+        end
+
+        # Task with until dependency
+        rule(:task_with_until) do
+          task_date.as(:start_date) >>
+            comma >> space? >>
+            str("until") >> space.repeat(1) >>
+            task_id.as(:until_task)
+        end
+
+        # Task with explicit dates
+        rule(:task_with_dates) do
+          task_id.as(:id) >> space? >> comma >> space? >> task_timing
+        end
+
+        # Task with duration only
+        rule(:task_with_duration_only) do
+          space? >> task_timing
+        end
+
+        # Task timing (dates or duration)
+        rule(:task_timing) do
+          task_date.as(:start_date) >>
+            (space? >> comma >> space? >> (task_end_date | task_duration)).maybe |
+            task_duration.as(:duration)
+        end
+
+        rule(:task_end_date) do
+          str("until") >> space.repeat(1) >> task_id.as(:until_task) |
+            task_date.as(:end_date)
+        end
+
+        # Tags (space-separated only, no comma between tags)
+        rule(:tags) do
+          space? >> task_tag >> (space.repeat(1) >> task_tag).repeat
+        end
+
+        rule(:task_tag) do
+          str("done") | str("active") | str("crit") | str("milestone")
+        end
+
+        # Task ID
+        rule(:task_id) do
+          match["a-zA-Z0-9_-"].repeat(1)
+        end
+
+        # Date in various formats (must contain date separator)
+        rule(:task_date) do
+          match["0-9"].repeat(1) >> match["-/:"] >> match["0-9-/:"].repeat
+        end
+
+        # Duration (e.g., 30d, 2w, 48h, 1M)
+        rule(:task_duration) do
+          match["0-9"].repeat(1) >> match["dwMh"]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+require_relative "common"
+
+module Sirena
+  module Parser
+    module Grammars
+      # Parslet grammar for Git Graph diagrams
+      class GitGraph < Common
+
+        rule(:diagram) do
+          ws? >>
+            header >>
+            ws? >>
+            statements.maybe.as(:statements) >>
+            ws?
+        end
+
+        rule(:header) do
+          str("gitGraph") >>
+            (str(" TB:") | str(" LR:") | str("TB:") | str("LR:") | str(":")).maybe >>
+            ws?
+        end
+
+        rule(:statements) do
+          (statement >> ws?).repeat(1)
+        end
+
+        rule(:statement) do
+          commit_stmt |
+          branch_stmt |
+          checkout_stmt |
+          switch_stmt |
+          merge_stmt |
+          cherry_pick_stmt
+        end
+
+        rule(:commit_stmt) do
+          (
+            str("commit") >>
+            commit_options.maybe.as(:options)
+          ).as(:commit) >>
+            line_end
+        end
+
+        rule(:commit_options) do
+          space >> (commit_option >> space?).repeat(1)
+        end
+
+        rule(:commit_option) do
+          commit_id | commit_type | commit_tag
+        end
+
+        rule(:commit_id) do
+          str("id:") >> space? >>
+            (str('"') >> match('[^"]').repeat(1).as(:id) >> str('"') |
+             str("'") >> match("[^']").repeat(1).as(:id) >> str("'") |
+             match('[^\s,]').repeat(1).as(:id))
+        end
+
+        rule(:commit_type) do
+          str("type:") >> space? >>
+            (str("NORMAL") | str("REVERSE") | str("HIGHLIGHT")).as(:type)
+        end
+
+        rule(:commit_tag) do
+          str("tag:") >> space? >>
+            (str('"') >> match('[^"]').repeat(1).as(:tag) >> str('"') |
+             str("'") >> match("[^']").repeat(1).as(:tag) >> str("'") |
+             match('[^\s,]').repeat(1).as(:tag))
+        end
+
+        rule(:branch_stmt) do
+          (
+            str("branch") >> space >>
+            branch_name.as(:name) >>
+            branch_options.maybe.as(:options)
+          ).as(:branch) >>
+            line_end
+        end
+
+        rule(:branch_name) do
+          match('[a-zA-Z0-9_-]').repeat(1)
+        end
+
+        rule(:branch_options) do
+          space >> (branch_option >> space?).repeat(1)
+        end
+
+        rule(:branch_option) do
+          str("order:") >> space? >> match('[0-9]').repeat(1).as(:order)
+        end
+
+        rule(:checkout_stmt) do
+          (
+            str("checkout") >> space >>
+            branch_name.as(:branch)
+          ).as(:checkout) >>
+            line_end
+        end
+
+        rule(:switch_stmt) do
+          (
+            str("switch") >> space >>
+            branch_name.as(:branch)
+          ).as(:switch) >>
+            line_end
+        end
+
+        rule(:merge_stmt) do
+          str("merge") >> space >>
+            (
+              branch_name.as(:branch) >>
+              merge_options.maybe.as(:options)
+            ).as(:merge) >>
+            line_end
+        end
+
+        rule(:merge_options) do
+          space >> (merge_option >> space?).repeat(1)
+        end
+
+        rule(:merge_option) do
+          commit_id | commit_type | commit_tag |
+          (str("random:") >> quoted_string)
+        end
+
+        rule(:cherry_pick_stmt) do
+          (
+            str("cherry-pick") >> space >>
+            cherry_pick_options.as(:options)
+          ).as(:cherry_pick) >>
+            line_end
+        end
+
+        rule(:cherry_pick_options) do
+          (cherry_pick_option >> space?).repeat(1)
+        end
+
+        rule(:cherry_pick_option) do
+          cherry_pick_id | cherry_pick_parent | commit_tag
+        end
+
+        rule(:cherry_pick_id) do
+          str("id:") >> space? >>
+            (str('"') >> match('[^"]').repeat(1).as(:id) >> str('"') |
+             str("'") >> match("[^']").repeat(1).as(:id) >> str("'") |
+             match('[^\s,]').repeat(1).as(:id))
+        end
+
+        rule(:cherry_pick_parent) do
+          str("parent:") >> space? >>
+            (str('"') >> match('[^"]').repeat(1).as(:parent) >> str('"') |
+             str("'") >> match("[^']").repeat(1).as(:parent) >> str("'") |
+             match('[^\s,]').repeat(1).as(:parent))
+        end
+
+        rule(:quoted_string) do
+          str('"') >> match('[^"]').repeat(0) >> str('"') |
+          str("'") >> match("[^']").repeat(0) >> str("'")
+        end
+
+        root(:diagram)
+      end
+    end
+  end
+end