markawesome 0.8.0 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ed0214570dcd6897e7433e6a2891a5f1d7fdc69650a7c0d11a0265924c5376b
-  data.tar.gz: c44001d3a303f7c59eb0d29f8335a08ad52e82f6b1bdc613a2977a65b6279247
+  metadata.gz: f905b53dab8aa3e46a07e23a535027fdc95f290fa195ed7bc7e3700cb5b28434
+  data.tar.gz: 858f36fb5b797fddb06d9ce73b586a67088b9c41d48f58dd3e5755c537e7f6dc
 SHA512:
-  metadata.gz: c374b8048b195255d1779d09efbd3de1a4e5fbbd0264b72940e75b73f9fd2a3517e0710a2414c4f0f411028064ea3f3b17066285a1c17d6558e57e533a9e1a85
-  data.tar.gz: f362ad4bdcde37cf129dd5f9a83ef006d8eb11dd6f06a1bd2a6b410e22ee83b32c518909a0e3b083b8cded3c7b56d4b7f37e85cdb448f30517f68824d628eeae
+  metadata.gz: 33be24fab1f053e5c26f854d748c59b324b9c02e08a61622d89cd57674551865de9497cc67e8ecb736c04f999cb1ae6cde3924ff0a2f14e265565d2fe5e5cb46
+  data.tar.gz: fff7882f369664e224277d97599311e19c17c3308eb02dff69ade5b945b01cf5bca0d4ab1f0ccffe389ca939c8efc8e9595632121bf3efcaecfd8b80cbe4f5fa

data/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.1] - 2026-03-12
+
+### Changed
+
+- Link-style popover triggers now use dotted underline (`text-decoration-style: dotted`) to visually distinguish them from navigation links
+
+## [0.9.0] - 2026-03-12
+
+### Added
+
+- **PopoverTransformer**: Inline syntax `&&&trigger text >>> popover content&&&` for use within sentences
+  - Always renders as link-styled trigger (underlined text button)
+  - Supports all parameters: placement, `without-arrow`, `distance:N`
+  - Parameters placed before trigger text, separated by spaces
+  - Plain text content (HTML-escaped, no markdown processing)
+  - Multiple inline popovers supported on the same line
+
 ## [0.8.0] - 2026-03-12
 
 ### Added

data/README.md

@@ -25,7 +25,7 @@ Used as the transformation engine for the [jekyll-webawesome](https://github.com
 | **Dialog** | `???params?` | `:::wa-dialog params?` | `<wa-dialog>` with trigger button and content |
 | **Icon** | `$$$icon-name` | `:::wa-icon icon-name` | `<wa-icon name="icon-name"></wa-icon>` |
 | **Image Dialog** | `![alt](url)` | — | Wraps images in clickable `<wa-dialog>` overlays |
-| **Popover** | `&&&params?` | `:::wa-popover params?` | `<wa-popover>` with trigger button and content |
+| **Popover** | `&&&params?` or inline `&&&trigger >>> content&&&` | `:::wa-popover params?` | `<wa-popover>` with trigger button and content |
 | **Tab Group** | `++++++` | `:::wa-tabs` | `<wa-tab-group><wa-tab>content</wa-tab></wa-tab-group>` |
 | **Tag** | `@@@brand` | `:::wa-tag brand` | `<wa-tag variant="brand">content</wa-tag>` |
 

data/lib/markawesome/transformers/popover_transformer.rb

@@ -8,6 +8,7 @@ module Markawesome
   # Transforms popover syntax into wa-popover elements with trigger buttons
   # Primary syntax: &&&params\ntrigger text\n>>>\ncontent\n&&&
   # Alternative syntax: :::wa-popover params\ntrigger text\n>>>\ncontent\n:::
+  # Inline syntax: &&&params? trigger text >>> popover content&&&
   #
   # Params: space-separated tokens (order doesn't matter)
   # Placement: top (default), bottom, left, right
@@ -21,9 +22,32 @@ module Markawesome
     }.freeze
 
     def self.transform(content)
+      # 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)
+
+          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
@@ -39,7 +63,11 @@ module Markawesome
                              distance: distance, link_style: link_style })
       end
 
-      patterns = dual_syntax_patterns(primary_regex, alternative_regex, transform_proc)
+      # 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
 
@@ -68,6 +96,50 @@ module Markawesome
         "popover-#{hash[0..7]}"
       end
 
+      def parse_inline_trigger_and_params(combined_string)
+        tokens = combined_string.strip.split(/\s+/)
+        param_tokens = []
+        trigger_tokens = []
+        found_content = false
+
+        tokens.each do |token|
+          if !found_content && popover_param?(token)
+            param_tokens << token
+          else
+            found_content = true
+            trigger_tokens << token
+          end
+        end
+
+        trigger_text = trigger_tokens.join(' ')
+
+        # If no trigger text remains, treat entire string as trigger (no params)
+        if trigger_text.empty?
+          ['', combined_string.strip]
+        else
+          [param_tokens.join(' '), trigger_text]
+        end
+      end
+
+      def popover_param?(token)
+        POPOVER_ATTRIBUTES.any? { |_attr, values| values.include?(token) } ||
+          token.match?(/^distance:\d+$/)
+      end
+
+      def build_inline_popover_html(popover_id, trigger_text, content_text, options)
+        trigger_content = escape_html(trigger_text)
+        content_escaped = escape_html(content_text)
+
+        popover_attrs = ["for='#{popover_id}'"]
+        popover_attrs << "placement='#{options[:placement]}'"
+        popover_attrs << 'without-arrow' if options[:without_arrow]
+        popover_attrs << "distance='#{options[:distance]}'" if options[:distance]
+
+        trigger = build_trigger(popover_id, trigger_content, true)
+
+        "#{trigger}<wa-popover #{popover_attrs.join(' ')}>#{content_escaped}</wa-popover>"
+      end
+
       def build_popover_html(popover_id, trigger_text, content_html, options)
         # Escape trigger text for security
         trigger_content = escape_html(trigger_text)
@@ -92,6 +164,7 @@ module Markawesome
         if link_style
           link_style_attr = 'background: none; border: none; padding: 0; ' \
                             'color: inherit; text-decoration: underline; ' \
+                            'text-decoration-style: dotted; ' \
                             'cursor: pointer; font: inherit;'
           "<button id='#{popover_id}' style='#{link_style_attr}'>#{trigger_content}</button>"
         else

data/lib/markawesome/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Markawesome
-  VERSION = '0.8.0'
+  VERSION = '0.9.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: markawesome
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.1
 platform: ruby
 authors:
 - Janne Waren