etassia 0.1.0

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

@@ -0,0 +1,198 @@
+# frozen_string_literal: true
+
+require_relative "common"
+
+module Etassia
+  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 |
+            weekend_declaration |
+            inclusive_end_dates_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
+
+        # Weekend day (which day of the week rendering treats as the
+        # weekend start, e.g. "weekend friday")
+        rule(:weekend_declaration) do
+          str("weekend") >> space.repeat(1) >>
+            (line_end.absent? >> any).repeat(1).as(:weekend) >>
+            line_end
+        end
+
+        # Inclusive end dates: a bare flag, no argument
+        rule(:inclusive_end_dates_declaration) do
+          str("inclusiveEndDates").as(:inclusive_end_dates) >> 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 are a comma-separated list of fields, in any order
+        # mermaid allows: status tags (done/active/crit/milestone), an id,
+        # "after <id...>", "until <id>", a date, and a duration. The grammar
+        # only captures the raw fields; it does not classify them. Mermaid
+        # classifies by POSITION when exactly three value fields remain
+        # after tags are stripped (id, start, end/duration, in that order),
+        # and by SHAPE otherwise — fields are not freely interchangeable
+        # (mmdc rejects "3d, 2024-01-10" with "Invalid date:3d"). See
+        # Builders::Gantt#process_task_details for the actual rule.
+        rule(:task_details) do
+          (
+            task_field.as(:field) >>
+              (space? >> comma >> space? >> task_field.as(:field)).repeat
+          ).as(:parts)
+        end
+
+        rule(:task_field) do
+          (comma.absent? >> line_end.absent? >> any).repeat(1)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+require_relative "common"
+
+module Etassia
+  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") >>
+            ((space? >> direction >> space? >> str(":")) | str(":")).maybe >>
+            ws?
+        end
+
+        rule(:direction) do
+          (str("TB") | str("LR") | str("BT")).as(:direction)
+        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 |
+            acc_title_stmt |
+            acc_descr_stmt
+        end
+
+        rule(:acc_title_stmt) do
+          str("accTitle") >> space? >> colon >> space? >>
+            (line_end.absent? >> any).repeat.as(:acc_title) >>
+            line_end
+        end
+
+        rule(:acc_descr_stmt) 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") >> whitespace? >> lbrace >> ws? >>
+            (rbrace.absent? >> any).repeat.as(:acc_descr) >>
+            rbrace >> line_end
+        end
+
+        rule(:commit_stmt) do
+          (
+            str("commit") >>
+            commit_options.maybe.as(:options)
+          ).as(:commit) >>
+            line_end
+        end
+
+        # A quoted message may follow `commit` directly: `commit"msg"`.
+        rule(:commit_options) do
+          (space.repeat(1) | (str('"') | str("'")).present?) >>
+            (commit_option >> space?).repeat(1)
+        end
+
+        rule(:commit_option) do
+          commit_id | commit_type | commit_tag | commit_message
+        end
+
+        # `commit "msg"` and `commit msg: "msg"` both set the message.
+        rule(:commit_message) do
+          (str("msg:") >> space? >> quoted_text(:message)) |
+            quoted_text(:message)
+        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") >>
+            branch_ref(:name) >>
+            branch_options.maybe.as(:options)
+          ).as(:branch) >>
+            line_end
+        end
+
+        # mermaid accepts git's own branch-name characters, not just an
+        # identifier — `release/1.0.0` is a real branch name a source can
+        # check out. A word char first, a word char or hyphen last, so
+        # `.foo`, `/foo`, `foo.`, `foo/` are all rejected; do not replace
+        # this with `match('[...]').repeat`, which cannot express that
+        # boundary. Use `TrimmedRun`, not a plain `GreedyRun`, for the
+        # tail: see `atoms/trimmed_run.rb`.
+        rule(:branch_name) do
+          match['\w'] >> TrimmedRun.new('[-.\/\w]', '[.\/]')
+        end
+
+        # The branch operand of a statement, with the whitespace after its
+        # keyword. A quoted name allows spaces and any other character but the
+        # closing quote, and may follow the keyword directly (`branch"a b"`);
+        # a bare name needs at least one space. Not a `rule`: the capture name
+        # differs per statement.
+        def branch_ref(key)
+          (space? >> quoted_text(key)) |
+            (space.repeat(1) >> branch_name.as(key))
+        end
+
+        # A backslash escapes the character after it, except a line break, so
+        # `"a\\"` is a complete string; State.unquote resolves the escapes
+        # afterwards. An unescaped line break is part of the string.
+        def quoted_text(key)
+          quoted_by('"', key) | quoted_by("'", key)
+        end
+
+        def quoted_by(quote, key)
+          body = quoted_escape | match("[^#{quote}\\\\]")
+
+          str(quote) >> body.repeat.as(key) >> str(quote)
+        end
+
+        rule(:quoted_escape) { str("\\") >> match('[^\n\r\u2028\u2029]') }
+
+        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") >>
+            branch_ref(:branch)
+          ).as(:checkout) >>
+            line_end
+        end
+
+        rule(:switch_stmt) do
+          (
+            str("switch") >>
+            branch_ref(:branch)
+          ).as(:switch) >>
+            line_end
+        end
+
+        rule(:merge_stmt) do
+          str("merge") >>
+            (
+              branch_ref(: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

data/lib/etassia/parser/grammars/info.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative "common"
+
+module Etassia
+  module Parser
+    module Grammars
+      # Parslet grammar for info diagrams.
+      #
+      # Handles simple info diagram syntax with optional showInfo flag.
+      #
+      # @example Simple info diagram
+      #   info
+      #
+      # @example Info diagram with showInfo flag
+      #   info showInfo
+      class Info < Common
+        root(:diagram)
+
+        # Main diagram structure
+        rule(:diagram) do
+          ws? >>
+            header >>
+            ws? >>
+            body.maybe >>
+            ws?
+        end
+
+        # Header: info [showInfo]. Mermaid's lexer rejects any other word.
+        rule(:header) do
+          str("info").as(:header) >>
+            (space.repeat(1) >> show_info_inline).maybe.as(:show_info_inline) >>
+            ws?
+        end
+
+        # showInfo on same line as info
+        rule(:show_info_inline) do
+          str("showInfo").as(:show_info)
+        end
+
+        # Body: showInfo on separate line
+        rule(:body) do
+          (space.repeat >> show_info_statement >> line_end)
+            .repeat(1).as(:show_info_body)
+        end
+
+        rule(:show_info_statement) do
+          str("showInfo")
+        end
+      end
+    end
+  end
+end