klods-ruby 0.2.0

data/lib/klods/node.rb

@@ -0,0 +1,98 @@
+module Klods
+  class RawHtml
+    attr_reader :html
+    def initialize(html) = @html = html.to_s
+    def to_s = @html
+    def to_str = @html
+  end
+
+  class Node
+    attr_reader :tag, :attrs, :children
+
+    VOID_TAGS = %w[area base br col embed hr img input link meta source track wbr].freeze
+
+    def initialize(tag, attrs = {}, children = nil)
+      @tag = tag.to_s
+      @attrs = normalize_attrs(attrs)
+      @children = VOID_TAGS.include?(@tag) ? [] : flatten_children(children)
+    end
+
+    def to_s
+      parts = ["<#{@tag}"]
+
+      @attrs.each do |name, value|
+        next if value.nil? || value == false
+
+        if name == "class"
+          cls = resolve_class(value)
+          parts << %( class="#{escape_attr(cls)}") unless cls.empty?
+        elsif name == "style"
+          parts << %( style="#{escape_attr(style_to_s(value))}")
+        elsif value == true
+          parts << " #{name}"
+        else
+          parts << %( #{name}="#{escape_attr(value.to_s)}")
+        end
+      end
+
+      if VOID_TAGS.include?(@tag)
+        parts << " />"
+        return parts.join
+      end
+
+      parts << ">"
+      @children.each { |child| parts << child_to_s(child) }
+      parts << "</#{@tag}>"
+      parts.join
+    end
+
+    alias_method :to_str, :to_s
+
+    private
+
+    def normalize_attrs(attrs)
+      return {} if attrs.nil?
+      attrs.transform_keys(&:to_s)
+    end
+
+    def flatten_children(children)
+      return [] if children.nil?
+      case children
+      when Array then children.flatten.reject { |c| c.nil? || c == false || c == true }
+      when false, true then []
+      else [children]
+      end
+    end
+
+    def child_to_s(child)
+      case child
+      when Node then child.to_s
+      when RawHtml then child.html
+      else escape_html(child.to_s)
+      end
+    end
+
+    def escape_html(str)
+      str.gsub("&", "&amp;").gsub("<", "&lt;").gsub(">", "&gt;").gsub('"', "&quot;").gsub("'", "&#39;")
+    end
+
+    def escape_attr(str)
+      str.gsub("&", "&amp;").gsub('"', "&quot;")
+    end
+
+    def resolve_class(input)
+      case input
+      when nil then ""
+      when String then input.strip
+      when Array then input.flatten.filter_map { |c| resolve_class(c) unless resolve_class(c).empty? }.join(" ")
+      when Hash then input.filter_map { |k, v| k.to_s if v }.join(" ")
+      else input.to_s.strip
+      end
+    end
+
+    def style_to_s(style)
+      return style.to_s if style.is_a?(String)
+      style.filter_map { |k, v| "#{k.to_s.gsub(/([A-Z])/) { "-#{$1.downcase}" }}:#{v}" unless v.nil? || v == "" }.join(";")
+    end
+  end
+end

data/lib/klods/rails_safety.rb

@@ -0,0 +1,9 @@
+module Klods
+  module RailsSafety
+    def to_s
+      super.html_safe
+    end
+
+    alias_method :to_str, :to_s
+  end
+end

data/lib/klods/railtie.rb

@@ -0,0 +1,10 @@
+module Klods
+  class Railtie < Rails::Railtie
+    initializer "klods.include_helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include Klods::Builders
+        Klods::Node.prepend(Klods::RailsSafety)
+      end
+    end
+  end
+end

data/lib/klods/utilities.rb

@@ -0,0 +1,13 @@
+module Klods
+  module Utilities
+    def push(a = nil, b = nil)
+      props, children = Core.normalize_args(a, b)
+      Core.build(tag: "span", base: "klods-push", props: props, children: children)
+    end
+
+    def fill(a = nil, b = nil)
+      props, children = Core.normalize_args(a, b)
+      Core.build(tag: "div", base: "klods-fill", props: props, children: children)
+    end
+  end
+end

data/lib/klods/version.rb

@@ -0,0 +1,3 @@
+module Klods
+  VERSION = "0.2.0"
+end

data/lib/klods.rb

@@ -0,0 +1,11 @@
+require_relative "klods/version"
+require_relative "klods/node"
+require_relative "klods/core"
+require_relative "klods/html"
+require_relative "klods/layout"
+require_relative "klods/utilities"
+require_relative "klods/icons"
+require_relative "klods/components"
+require_relative "klods/builders"
+require_relative "klods/rails_safety"
+require_relative "klods/railtie" if defined?(Rails)

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: klods-ruby
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Drue Wilding
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-27 00:00:00.000000000 Z
+dependencies:
+- !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:
+email:
+- drue@wilding.dk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/klods.rb
+- lib/klods/builders.rb
+- lib/klods/components.rb
+- lib/klods/components/alert.rb
+- lib/klods/components/avatar.rb
+- lib/klods/components/badge.rb
+- lib/klods/components/box.rb
+- lib/klods/components/breadcrumb.rb
+- lib/klods/components/button.rb
+- lib/klods/components/card.rb
+- lib/klods/components/code.rb
+- lib/klods/components/details.rb
+- lib/klods/components/dl.rb
+- lib/klods/components/form.rb
+- lib/klods/components/list.rb
+- lib/klods/components/modal.rb
+- lib/klods/components/nav.rb
+- lib/klods/components/prose.rb
+- lib/klods/components/table.rb
+- lib/klods/components/tabs.rb
+- lib/klods/components/toast.rb
+- lib/klods/components/tooltip.rb
+- lib/klods/core.rb
+- lib/klods/html.rb
+- lib/klods/icons.rb
+- lib/klods/layout.rb
+- lib/klods/node.rb
+- lib/klods/rails_safety.rb
+- lib/klods/railtie.rb
+- lib/klods/utilities.rb
+- lib/klods/version.rb
+homepage: https://github.com/druewilding/klods-ruby
+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.1'
+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: Ruby builder API for klods — same components, same call shapes, same HTML
+  output.
+test_files: []