eclair 0.0.0

data/lib/eclair.rb

@@ -0,0 +1,83 @@
+# typed: strict
+require "sorbet-runtime"
+require "cgi"
+
+require_relative "./eclair/element"
+require_relative "./eclair/html"
+
+module Eclair
+  extend T::Sig
+  extend T::Helpers
+  final!
+
+  sig(:final) do
+    params(
+      tag: Symbol,
+      attributes: T::Hash[Symbol, Element::AttributeValue],
+      children: Element::Children
+    )
+      .returns(Element)
+  end
+  def self.element(tag, attributes, children)
+    Element.new(
+      tag: tag,
+      attributes: attributes,
+      children: children
+    )
+  end
+
+  sig(:final) { params(element: Element).returns(String) }
+  def self.render(element)
+    attributes = element
+      .attributes
+      .map do |key, value|
+        if !value
+          next
+        end
+
+        attr_name = escape_html(key.to_s)
+        rendered_value = case value
+        when TrueClass
+          next attr_name
+        when String
+          escape_html(value)
+        else
+          T.absurd(value)
+        end
+
+        "#{attr_name}=\"#{rendered_value}\""
+      end
+      .compact
+      .join(" ")
+
+    start_tag_open = if attributes.empty?
+      "<#{element.tag}"
+    else
+      "<#{element.tag} #{attributes}"
+    end
+
+    if (c = element.children) == Element::Void
+      return "#{start_tag_open}>"
+    end
+
+    rendered_children = c.map do |child|
+      case child
+      when Element
+        render(child)
+      when Element::DangerousUnescapedHtml
+        child.html
+      when String
+        escape_html(child)
+      else
+        T.absurd(child)
+      end
+    end
+
+    "#{start_tag_open}>#{rendered_children.join}</#{element.tag}>"
+  end
+
+  sig(:final) { params(str: String).returns(String) }
+  private_class_method def self.escape_html(str)
+    ::CGI.escape_html(str)
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: eclair
+version: !ruby/object:Gem::Version
+  version: 0.0.0
+platform: ruby
+authors:
+- Chris Andrejewski
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-10-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.9204
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.9204
+description: The main entrypoint for using Eclair
+email: christopher.andrejewski@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/eclair.rb
+- lib/eclair/element.rb
+- lib/eclair/html.rb
+homepage: https://github.com/andrejewski/eclair
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.3
+signing_key:
+specification_version: 4
+summary: Declarative HTML building for Ruby
+test_files: []