markawesome 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c03fbaecd8dec3c16fa5e2ddeb07b12d2eb35ad2fbc8389a49b725d77a3c2cf
-  data.tar.gz: 6b530bf8caae7b8717411b111e6e3e6f9fb6766373d0b80238cb3fa4ec7f98d6
+  metadata.gz: 0ed0214570dcd6897e7433e6a2891a5f1d7fdc69650a7c0d11a0265924c5376b
+  data.tar.gz: c44001d3a303f7c59eb0d29f8335a08ad52e82f6b1bdc613a2977a65b6279247
 SHA512:
-  metadata.gz: 6e2b2e8804309e702139068db433be5cbb62132eede58ff45a25d871b721bc2adab4a23d34b820ed8dda26907de2d51ab277b30a13f5d9037e3d26efd123d91f
-  data.tar.gz: 8ba50a46d31a068af6ae3d2dc28c2832d26b665e4a006fc74b34f5c59ee0a12596f4f8a7a1a98d7412f0150fe25215d3772521fe6fcaff5f1154c69ac91fc684
+  metadata.gz: c374b8048b195255d1779d09efbd3de1a4e5fbbd0264b72940e75b73f9fd2a3517e0710a2414c4f0f411028064ea3f3b17066285a1c17d6558e57e533a9e1a85
+  data.tar.gz: f362ad4bdcde37cf129dd5f9a83ef006d8eb11dd6f06a1bd2a6b410e22ee83b32c518909a0e3b083b8cded3c7b56d4b7f37e85cdb448f30517f68824d628eeae

data/CHANGELOG.md

@@ -4,12 +4,31 @@ 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.6.0] - 2026-02-14
+## [0.8.0] - 2026-03-12
+
+### Added
+
+- **PopoverTransformer**: New `&&&` syntax for `wa-popover` floating content component
+  - Trigger text and popover content separated by `>>>` (same pattern as dialog/details)
+  - Placement options: `top` (default), `bottom`, `left`, `right`
+  - `without-arrow` flag to hide the popover arrow
+  - `distance:N` parameter for custom trigger-to-popover distance in pixels
+  - `link` flag to render trigger as a link-styled element instead of a button
+  - Unique anchor IDs generated via MD5 hash for trigger/popover pairing
+  - Alternative `:::wa-popover` syntax supported
+  - Markdown content support in popover body via Kramdown
+  - HTML escaping for trigger text (XSS prevention)
+
+## [0.7.0]
 
 ### Changed
 
 - **BREAKING: Card header syntax** — Card headers now use `**bold text**` instead of `# heading`. The first bold-only line inside a card block becomes the header slot. This avoids markdownlint warnings about multiple top-level headings (MD025) and incorrect heading levels (MD001), and better reflects that card titles are not semantic document headings.
 
+## [0.6.0] - 2026-02-14
+
+_(Version bump included LayoutTransformer and icon slot syntax — see 0.5.0 and 0.4.0 entries below.)_
+
 ## [0.5.0] - 2026-02-10
 
 ### Added

data/README.md

@@ -25,6 +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 |
 | **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/transformer.rb

@@ -24,6 +24,7 @@ module Markawesome
       end
 
       content = DialogTransformer.transform(content)
+      content = PopoverTransformer.transform(content)
       content = IconTransformer.transform(content)
       content = TagTransformer.transform(content)
       TabsTransformer.transform(content)

data/lib/markawesome/transformers/popover_transformer.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require 'digest'
+require_relative 'base_transformer'
+require_relative '../attribute_parser'
+
+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:::
+  #
+  # Params: space-separated tokens (order doesn't matter)
+  # Placement: top (default), bottom, left, right
+  # Flags: without-arrow
+  # Distance: distance:N (e.g., distance:10)
+  class PopoverTransformer < BaseTransformer
+    POPOVER_ATTRIBUTES = {
+      placement: %w[top bottom left right],
+      without_arrow: %w[without-arrow],
+      trigger_style: %w[link]
+    }.freeze
+
+    def self.transform(content)
+      primary_regex = /^&&&([^\n]*)$\n(.*?)\n^>>>$\n(.*?)\n^&&&$/m
+      alternative_regex = /^:::wa-popover([^\n]*)$\n(.*?)\n^>>>$\n(.*?)\n^:::$/m
+
+      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)
+
+        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
+
+      patterns = dual_syntax_patterns(primary_regex, alternative_regex, transform_proc)
+      apply_multiple_patterns(content, patterns)
+    end
+
+    class << self
+      private
+
+      def parse_parameters(params_string)
+        return ['top', false, nil, false] if params_string.nil? || params_string.strip.empty?
+
+        attributes = AttributeParser.parse(params_string, POPOVER_ATTRIBUTES)
+        placement = attributes[:placement] || 'top'
+        without_arrow = attributes[:without_arrow] == 'without-arrow'
+        link_style = attributes[:trigger_style] == 'link'
+
+        # Look for distance:N parameter
+        tokens = params_string.strip.split(/\s+/)
+        distance_token = tokens.find { |token| token.match?(/^distance:\d+$/) }
+        distance = distance_token&.sub('distance:', '')
+
+        [placement, without_arrow, distance, link_style]
+      end
+
+      def generate_popover_id(trigger_text, content)
+        hash_input = "#{trigger_text}#{content}"
+        hash = Digest::MD5.hexdigest(hash_input)
+        "popover-#{hash[0..7]}"
+      end
+
+      def build_popover_html(popover_id, trigger_text, content_html, options)
+        # Escape trigger text for security
+        trigger_content = escape_html(trigger_text)
+
+        # Build popover attributes
+        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, options[:link_style])
+
+        html = []
+        html << trigger
+        html << "<wa-popover #{popover_attrs.join(' ')}>"
+        html << content_html
+        html << '</wa-popover>'
+        html.join("\n")
+      end
+
+      def build_trigger(popover_id, trigger_content, link_style)
+        if link_style
+          link_style_attr = 'background: none; border: none; padding: 0; ' \
+                            'color: inherit; text-decoration: underline; ' \
+                            'cursor: pointer; font: inherit;'
+          "<button id='#{popover_id}' style='#{link_style_attr}'>#{trigger_content}</button>"
+        else
+          "<wa-button id='#{popover_id}' variant='text'>#{trigger_content}</wa-button>"
+        end
+      end
+
+      def escape_html(text)
+        text.gsub('&', '&amp;')
+            .gsub('<', '&lt;')
+            .gsub('>', '&gt;')
+            .gsub('"', '&quot;')
+            .gsub("'", '&#39;')
+      end
+    end
+  end
+end

data/lib/markawesome/transformers.rb

@@ -16,5 +16,6 @@ require_relative 'transformers/dialog_transformer'
 require_relative 'transformers/icon_transformer'
 require_relative 'transformers/image_dialog_transformer'
 require_relative 'transformers/layout_transformer'
+require_relative 'transformers/popover_transformer'
 require_relative 'transformers/tabs_transformer'
 require_relative 'transformers/tag_transformer'

data/lib/markawesome/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: markawesome
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Janne Waren
@@ -108,6 +108,7 @@ files:
 - lib/markawesome/transformers/icon_transformer.rb
 - lib/markawesome/transformers/image_dialog_transformer.rb
 - lib/markawesome/transformers/layout_transformer.rb
+- lib/markawesome/transformers/popover_transformer.rb
 - lib/markawesome/transformers/tabs_transformer.rb
 - lib/markawesome/transformers/tag_transformer.rb
 - lib/markawesome/version.rb