markawesome 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ed0214570dcd6897e7433e6a2891a5f1d7fdc69650a7c0d11a0265924c5376b
-  data.tar.gz: c44001d3a303f7c59eb0d29f8335a08ad52e82f6b1bdc613a2977a65b6279247
+  metadata.gz: aad59927898fc25ed0af9ae66614cf194c64e89ae06d9ac08dc1b82d810f9c07
+  data.tar.gz: 0e54e43e57692c1041fe898e972b703030e09dadb569f5c8cc57a9c385599e79
 SHA512:
-  metadata.gz: c374b8048b195255d1779d09efbd3de1a4e5fbbd0264b72940e75b73f9fd2a3517e0710a2414c4f0f411028064ea3f3b17066285a1c17d6558e57e533a9e1a85
-  data.tar.gz: f362ad4bdcde37cf129dd5f9a83ef006d8eb11dd6f06a1bd2a6b410e22ee83b32c518909a0e3b083b8cded3c7b56d4b7f37e85cdb448f30517f68824d628eeae
+  metadata.gz: ad7fccbc59895042fd63920d75dc6c4cd7505852226736af79dc9b5cf94feb2fca824e5973f68487d41494dd27d22193f2d35b84e3170222bd2e4dcae8fbdc6b
+  data.tar.gz: 47dab2727e5dc838ad25ead4a7f882e6ee8245e6e31ac8d5454654ec1b0d24f5b176747ba6d9673b043a2daf53f9e79c28ceff1e1dd90f298a1ea3b4467bd2fd

data/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.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)

data/lib/markawesome/version.rb

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

metadata

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