Class: Markawesome::PopoverTransformer

Inherits:
BaseTransformer show all
Defined in:
lib/markawesome/transformers/popover_transformer.rb

Overview

Transforms popover syntax into wa-popover elements with trigger buttons Primary syntax: &&&paramsntrigger textn>>>ncontentn&&&

Alternative syntax: :::wa-popover paramsntrigger textn>>>ncontentn:

Inline syntax: &&&params? trigger text >>> popover content&&&

Params: space-separated tokens (order doesn’t matter) Placement: top (default), bottom, left, right Flags: without-arrow Distance: distance:N (e.g., distance:10)

Constant Summary collapse

POPOVER_ATTRIBUTES = 
{
  placement: %w[top bottom left right],
  without_arrow: %w[without-arrow],
  trigger_style: %w[link]
}.freeze

Class Method Summary collapse

Class Method Details

.render_as_markdown(content, _options = {}) ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
 
# File 'lib/markawesome/transformers/popover_transformer.rb', line 79

def self.render_as_markdown(content, _options = {})
  inline_regex = /&&&[ \t]*([^\r\n]*?)[ \t]*>>>[ \t]*([^\r\n]+?)[ \t]*&&&/
  primary_regex = /^&&&([^\n]*)$\n(.*?)\n^>>>$\n(.*?)\n^&&&$/m
  alternative_regex = /^:::wa-popover([^\n]*)$\n(.*?)\n^>>>$\n(.*?)\n^:::$/m

  inline_transform = {
    regex: inline_regex,
    block: proc do |_match, matchdata|
      combined = matchdata[1]
      popover_content = matchdata[2].strip
      _params, trigger_text = parse_inline_trigger_and_params(combined)
      "**#{trigger_text}** (#{popover_content})"
    end
  }

  block_transform_proc = proc do |_params_string, trigger_text, popover_content|
    "**#{trigger_text.to_s.strip}**\n\n#{popover_content.to_s.strip}"
  end

  patterns = [
    inline_transform,
    *dual_syntax_patterns(primary_regex, alternative_regex, block_transform_proc)
  ]
  apply_multiple_patterns(content, patterns)
end

.transform(content) ⇒ Object 



24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/markawesome/transformers/popover_transformer.rb', line 24

def self.transform(content)
  # Tracks ID base usage within this transform call so repeated popovers
  # (same trigger + content) get disambiguated suffixes instead of
  # colliding on the page.
  seen_ids = Hash.new(0)

  # Inline regex (single-line, no newlines allowed)
  inline_regex = /&&&[ \t]*([^\r\n]*?)[ \t]*>>>[ \t]*([^\r\n]+?)[ \t]*&&&/

  # Block regexes (multiline)
  primary_regex = /^&&&([^\n]*)$\n(.*?)\n^>>>$\n(.*?)\n^&&&$/m
  alternative_regex = /^:::wa-popover([^\n]*)$\n(.*?)\n^>>>$\n(.*?)\n^:::$/m

  # Inline transformation (always link style, plain text content)
  inline_transform = {
    regex: inline_regex,
    block: proc do |_match, matchdata|
      combined = matchdata[1]
      popover_content = matchdata[2].strip

      params_string, trigger_text = parse_inline_trigger_and_params(combined)
      placement, without_arrow, distance, _link_style = parse_parameters(params_string)

      popover_id = generate_popover_id(trigger_text, popover_content, seen_ids)

      build_inline_popover_html(popover_id, trigger_text, popover_content,
                                { placement: placement, without_arrow: without_arrow,
                                  distance: distance })
    end
  }

  # Block transformation (existing)
  transform_proc = proc do |params_string, trigger_text, popover_content|
    trigger_text = trigger_text.strip
    popover_content = popover_content.strip

    placement, without_arrow, distance, link_style = parse_parameters(params_string)

    popover_id = generate_popover_id(trigger_text, popover_content, seen_ids)

    content_html = markdown_to_html(popover_content)

    build_popover_html(popover_id, trigger_text, content_html,
                       { placement: placement, without_arrow: without_arrow,
                         distance: distance, link_style: link_style })
  end

  # Inline patterns first to avoid conflicts with block patterns
  patterns = [
    inline_transform,
    *dual_syntax_patterns(primary_regex, alternative_regex, transform_proc)
  ]
  apply_multiple_patterns(content, patterns)
end