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, plus the eight aligned

variants (top-start, top-end, right-start, …) — the full wa-popover surface

Flags: without-arrow Distance: distance:N (e.g., distance:10) — offset away from the target Skidding: skidding:N (e.g., skidding:12, skidding:-4) — offset along the target

Constant Summary collapse

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

Class Method Summary collapse

Class Method Details

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



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

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 



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
78
79
80
 
# File 'lib/markawesome/transformers/popover_transformer.rb', line 27

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, skidding = 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, skidding: skidding })
    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, skidding = 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, skidding: skidding })
  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