bbortcodes 0.1.0

data/lib/bbortcodes/transform.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "parslet"
+
+module BBortcodes
+  class Transform < Parslet::Transform
+    # Transform plain text nodes
+    rule(text: simple(:text)) { {type: :text, value: text.to_s} }
+
+    # Transform attribute
+    rule(name: simple(:name), value: {string: simple(:value)}) do
+      {name.to_s => value.to_s}
+    end
+
+    # Transform self-closing shortcode
+    rule(name: simple(:name), attributes: subtree(:attrs)) do
+      attributes = Array(attrs).reduce({}, :merge)
+      {
+        type: :shortcode,
+        name: name.to_s,
+        attributes: attributes,
+        content: nil,
+        self_closing: true
+      }
+    end
+
+    # Transform self-closing shortcode without attributes
+    rule(name: simple(:name)) do
+      {
+        type: :shortcode,
+        name: name.to_s,
+        attributes: {},
+        content: nil,
+        self_closing: true
+      }
+    end
+
+    # Transform paired shortcode
+    rule(
+      opening: {tag_name: simple(:name), attributes: subtree(:attrs)},
+      closing: {tag_name: simple(:close_name)},
+      content: subtree(:content)
+    ) do
+      attributes = Array(attrs).reduce({}, :merge)
+      {
+        type: :shortcode,
+        name: name.to_s,
+        attributes: attributes,
+        content: Array(content),
+        self_closing: false
+      }
+    end
+
+    # Transform paired shortcode without attributes
+    rule(
+      opening: {tag_name: simple(:name)},
+      closing: {tag_name: simple(:close_name)},
+      content: subtree(:content)
+    ) do
+      {
+        type: :shortcode,
+        name: name.to_s,
+        attributes: {},
+        content: Array(content),
+        self_closing: false
+      }
+    end
+
+    # Transform paired shortcode without content
+    rule(
+      opening: {tag_name: simple(:name), attributes: subtree(:attrs)},
+      closing: {tag_name: simple(:close_name)}
+    ) do
+      attributes = Array(attrs).reduce({}, :merge)
+      {
+        type: :shortcode,
+        name: name.to_s,
+        attributes: attributes,
+        content: [],
+        self_closing: false
+      }
+    end
+
+    # Transform paired shortcode without attributes and content
+    rule(
+      opening: {tag_name: simple(:name)},
+      closing: {tag_name: simple(:close_name)}
+    ) do
+      {
+        type: :shortcode,
+        name: name.to_s,
+        attributes: {},
+        content: [],
+        self_closing: false
+      }
+    end
+
+    # Transform document
+    rule(document: subtree(:elements)) { Array(elements) }
+  end
+end

data/lib/bbortcodes/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module BBortcodes
+  VERSION = "0.1.0"
+end

data/lib/bbortcodes.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "zeitwerk"
+
+# Load version and errors manually
+require_relative "bbortcodes/version"
+require_relative "bbortcodes/errors"
+
+loader = Zeitwerk::Loader.for_gem
+loader.inflector.inflect("bbortcodes" => "BBortcodes")
+loader.ignore("#{__dir__}/bbortcodes/version.rb")
+loader.ignore("#{__dir__}/bbortcodes/errors.rb")
+loader.setup
+
+module BBortcodes
+  class << self
+    # Global registry instance
+    def registry
+      @registry ||= Registry.new
+    end
+
+    # Global config instance
+    def config
+      @config ||= Config.new
+    end
+
+    # Configure the gem
+    # @yield [Config] The global config instance
+    def configure
+      yield config
+    end
+
+    # Register a shortcode class in the global registry
+    # @param shortcode_class [Class] A class that inherits from Shortcode
+    def register(shortcode_class)
+      registry.register(shortcode_class)
+    end
+
+    # Parse text with the global registry and config
+    # @param text [String] The text to parse
+    # @param context [Context, Hash, nil] The rendering context
+    # @param only [Array<String>, nil] Only process these shortcode types
+    # @return [Array<String, Array<Shortcode>>] The processed text and array of shortcode instances
+    def parse(text, context: nil, only: nil)
+      parser = Parser.new(registry: registry, config: config)
+      parser.parse(text, context: context, only: only)
+    end
+
+    # Create a new parser instance
+    # @param registry [Registry, nil] Custom registry (uses global if nil)
+    # @param config [Config, nil] Custom config (uses global if nil)
+    # @return [Parser]
+    def parser(registry: nil, config: nil)
+      Parser.new(registry: registry, config: config)
+    end
+  end
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: bbortcodes
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Stefan Exner
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-10-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: anyway_config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: literal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: parslet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: Parse and render WordPress-like shortcodes with type safety, nested support,
+  and grammar-based parsing using Parslet
+email:
+- stex@stex.codes
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/bbortcodes.rb
+- lib/bbortcodes/config.rb
+- lib/bbortcodes/context.rb
+- lib/bbortcodes/errors.rb
+- lib/bbortcodes/grammar.rb
+- lib/bbortcodes/parser.rb
+- lib/bbortcodes/registry.rb
+- lib/bbortcodes/shortcode.rb
+- lib/bbortcodes/transform.rb
+- lib/bbortcodes/version.rb
+homepage: https://gitlab.com/lopo-tech/bbortcodes
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://gitlab.com/lopo-tech/bbortcodes
+  source_code_uri: https://gitlab.com/lopo-tech/bbortcodes
+  changelog_uri: https://gitlab.com/lopo-tech/bbortcodes/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: A WordPress-like shortcode parser with grammar-based parsing
+test_files: []