markawesome 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a3394f03fff9ca20290650589ba70022b2f8ca71b5581f5d06cb4e06ac83f3f
-  data.tar.gz: d5af8667249a450c3119641dc38a9f148bbb2b30a1f8c76eae138c3765617fd5
+  metadata.gz: c1a813451ca32ebe286489c510fd9ebc0f161877d6e20bdc50c390c8e54669c8
+  data.tar.gz: fe1f091910a15ebf1f825769266fdaa1ff776e1ceace7a041e0fe71370b42817
 SHA512:
-  metadata.gz: c29d6692c8cd45f5f2a6a544de3505ff3a9af50a0d36468385f71b38daac30465ff23d15b5d94648f48690fae43d652cf495a4c7ea8d282bc96127a7376e22a3
-  data.tar.gz: c8134fa3a4a9344efe72ffa5d4a6504763ba9ebce4a4a9c6f7d8b0907de48506ebb9a7ae843bffd0898da5379ba2ebdf9bc100978f2b86add9cec722c4e3281e
+  metadata.gz: 1ddf1bc53111ca053bd5fe82040ee9387783dd95f0892658697a2f38f0b7a11ebd8fa1517df4e990fbda8aaa90f465f27bb1a6f46d673b8f6fc31a24acab5070
+  data.tar.gz: 83ac02b6ca5cb7744579661c068511c53666bf4ec8b550a6170050ab04f8911c053db46f1b87122b91aec2024b3a564f4e21d1a34e49189fdbb0e5152df99e49

data/CHANGELOG.md

@@ -4,6 +4,22 @@ 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.5.0] - 2026-02-10
+
+### Added
+
+- **LayoutTransformer**: New `::::` (quadruple colon) syntax for wrapping content in Web Awesome CSS layout containers
+  - Supports 6 layout types: `grid`, `stack`, `cluster`, `split`, `flank`, `frame`
+  - Common attributes: `gap:SIZE`, `align:VALUE`, `justify:VALUE` for all layouts
+  - Grid-specific: `min:CSS_VALUE` for custom minimum column size (`--min-column-size`)
+  - Split-specific: `row` and `column` direction modifiers
+  - Flank-specific: `start`/`end` position modifiers, `size:CSS_VALUE`, `content:PCT`
+  - Frame-specific: `landscape`/`portrait`/`square` aspect ratios, `radius:SIZE`
+  - Dual syntax: both `::::grid` and `::::wa-grid` work identically
+  - CSS value sanitization for user-provided values (strips quotes, angle brackets, semicolons)
+  - Inner content is not markdown-converted, allowing component `:::` syntax to be processed by subsequent transformers
+  - Runs first in the pipeline so layout containers wrap around component output
+
 ## [0.4.0] - 2026-02-09
 
 ### Added

data/lib/markawesome/transformer.rb

@@ -7,6 +7,7 @@ module Markawesome
   # Main transformer that orchestrates all component transformers
   class Transformer
     def self.process(content, options = {})
+      content = LayoutTransformer.transform(content)
       content = BadgeTransformer.transform(content)
       content = ButtonTransformer.transform(content)
       content = CalloutTransformer.transform(content)

data/lib/markawesome/transformers/layout_transformer.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require_relative 'base_transformer'
+
+module Markawesome
+  # Transforms layout syntax into CSS layout utility containers
+  # Primary syntax: ::::type params?\ncontent\n::::
+  # Alternative syntax: ::::wa-type params?\ncontent\n::::
+  # Supported types: grid, stack, cluster, split, flank, frame
+  #
+  # Common attributes (all layouts):
+  #   gap:SIZE - wa-gap-{SIZE} class (0, 3xs, 2xs, xs, s, m, l, xl, 2xl, 3xl)
+  #   align:VALUE - wa-align-items-{VALUE} class (start, end, center, stretch, baseline)
+  #   justify:VALUE - wa-justify-content-{VALUE} class (start, end, center, space-between, space-around, space-evenly)
+  #
+  # Grid-specific: min:CSS_VALUE - sets --min-column-size style
+  # Split-specific: row, column modifiers
+  # Flank-specific: start, end modifiers; size:CSS_VALUE, content:PCT
+  # Frame-specific: landscape, portrait, square modifiers; radius:SIZE
+  class LayoutTransformer < BaseTransformer
+    VALID_GAPS = %w[0 3xs 2xs xs s m l xl 2xl 3xl].freeze
+    VALID_ALIGNS = %w[start end center stretch baseline].freeze
+    VALID_JUSTIFIES = %w[start end center space-between space-around space-evenly].freeze
+    VALID_RADII = %w[s m l pill circle square].freeze
+
+    KEYWORD_MODIFIERS = {
+      split: %w[row column],
+      flank: %w[start end],
+      frame: %w[landscape portrait square]
+    }.freeze
+
+    COMMON_KEY_CLASS_MAP = {
+      'gap' => ->(v) { "wa-gap-#{v}" if VALID_GAPS.include?(v) },
+      'align' => ->(v) { "wa-align-items-#{v}" if VALID_ALIGNS.include?(v) },
+      'justify' => ->(v) { "wa-justify-content-#{v}" if VALID_JUSTIFIES.include?(v) }
+    }.freeze
+
+    def self.transform(content)
+      primary_regex = /^::::(grid|stack|cluster|split|flank|frame)[ \t]*([^\n]*)\n(.*?)\n::::/m
+      alternative_regex = /^::::wa-(grid|stack|cluster|split|flank|frame)[ \t]*([^\n]*)\n(.*?)\n::::/m
+
+      transform_proc = proc do |type, params_string, inner_content|
+        classes, styles = build_attributes(type, params_string)
+        build_html(classes, styles, inner_content)
+      end
+
+      patterns = dual_syntax_patterns(primary_regex, alternative_regex, transform_proc)
+      apply_multiple_patterns(content, patterns)
+    end
+
+    class << self
+      private
+
+      def build_attributes(type, params_string)
+        classes = ["wa-#{type}"]
+        styles = []
+
+        return [classes, styles] if params_string.nil? || params_string.strip.empty?
+
+        tokens = params_string.strip.split(/\s+/)
+
+        tokens.each do |token|
+          process_token(type, token, classes, styles)
+        end
+
+        [classes, styles]
+      end
+
+      def process_token(type, token, classes, styles)
+        if token.include?(':')
+          process_key_value(type, token, classes, styles)
+        else
+          process_keyword(type, token, classes)
+        end
+      end
+
+      def process_key_value(type, token, classes, styles)
+        key, value = token.split(':', 2)
+        return if value.nil? || value.empty?
+
+        if COMMON_KEY_CLASS_MAP.key?(key)
+          css_class = COMMON_KEY_CLASS_MAP[key].call(value)
+          classes << css_class if css_class
+        else
+          process_type_specific_key_value(type, key, value, classes, styles)
+        end
+      end
+
+      def process_type_specific_key_value(type, key, value, classes, styles)
+        case key
+        when 'min'
+          styles << "--min-column-size: #{sanitize_css(value)}" if type == 'grid'
+        when 'size'
+          styles << "--flank-size: #{sanitize_css(value)}" if type == 'flank'
+        when 'content'
+          styles << "--content-percentage: #{sanitize_css(value)}" if type == 'flank'
+        when 'radius'
+          classes << "wa-border-radius-#{value}" if type == 'frame' && VALID_RADII.include?(value)
+        end
+      end
+
+      def process_keyword(type, token, classes)
+        modifiers = KEYWORD_MODIFIERS[type.to_sym]
+        return unless modifiers&.include?(token)
+
+        classes[0] = "wa-#{type}:#{token}"
+      end
+
+      def sanitize_css(value)
+        value.gsub(/["'<>;]/, '')
+      end
+
+      def build_html(classes, styles, inner_content)
+        attr_parts = ["class=\"#{classes.join(' ')}\""]
+        attr_parts << "style=\"#{styles.join('; ')}\"" unless styles.empty?
+
+        "<div #{attr_parts.join(' ')}>\n#{inner_content}\n</div>"
+      end
+    end
+  end
+end

data/lib/markawesome/transformers.rb

@@ -15,5 +15,6 @@ require_relative 'transformers/details_transformer'
 require_relative 'transformers/dialog_transformer'
 require_relative 'transformers/icon_transformer'
 require_relative 'transformers/image_dialog_transformer'
+require_relative 'transformers/layout_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.4.0'
+  VERSION = '0.5.0'
 end

metadata

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