partials_fx 0.0.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0412f26bb891f999fbc9b1f0d168017a52da64f5e6aec18d707dea8802092eea
-  data.tar.gz: fff0afad8ee5daccc5573ff5b566f1a5dabe9f71965901eaf6f1816d2d773cf2
+  metadata.gz: 76058417759f42122463669fea7eff9aae7871f62de129df795641bb592ecaff
+  data.tar.gz: 8673f99b6704a51ce92a3bcf7f108c51988695cf77a0b5495310071fa4a6f33e
 SHA512:
-  metadata.gz: 6e71768ddf891cef92915b52aa2dd37b368db77458fe4415cfc13e4a1c1684936644a647ac71ee4dbe12504b186744b8fe3f8a981d4cbcffac26ee12795faf4c
-  data.tar.gz: e82617f39b47d8f46bd9f0e317191c8c662b3434513b8d28fb01eba47221bd16daacd680803bf0b5bb53be8e52173d9bee04b75869596d47ad6869c7c35d8734
+  metadata.gz: b23685132aa916fc0ff3632ea3990c05dc2d3bf01e08a14a205674c2a56f26a6834a3b834ec13ab5e56dd84d69dec1a3584e380e947a95d148359360c8d1e976
+  data.tar.gz: 20a5b2495d7702b3c27c7a0fe770e70d9cb5dba976333542c27cc628608432f5ce7c9ec2db0637f2ba6e6bc6d5f0b34dd18fd6db06837de963f9c760e297619e

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in partials_fx.gemspec
+gemspec
+
+gem "irb"
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.25", ">= 5.25.5"
+gem "standard", "~> 1.50"

data/Gemfile.lock

@@ -0,0 +1,243 @@
+PATH
+  remote: .
+  specs:
+    partials_fx (0.5.0)
+      rails (>= 7.2, < 8.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actioncable (8.0.2)
+      actionpack (= 8.0.2)
+      activesupport (= 8.0.2)
+      nio4r (~> 2.0)
+      websocket-driver (>= 0.6.1)
+      zeitwerk (~> 2.6)
+    actionmailbox (8.0.2)
+      actionpack (= 8.0.2)
+      activejob (= 8.0.2)
+      activerecord (= 8.0.2)
+      activestorage (= 8.0.2)
+      activesupport (= 8.0.2)
+      mail (>= 2.8.0)
+    actionmailer (8.0.2)
+      actionpack (= 8.0.2)
+      actionview (= 8.0.2)
+      activejob (= 8.0.2)
+      activesupport (= 8.0.2)
+      mail (>= 2.8.0)
+      rails-dom-testing (~> 2.2)
+    actionpack (8.0.2)
+      actionview (= 8.0.2)
+      activesupport (= 8.0.2)
+      nokogiri (>= 1.8.5)
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+      useragent (~> 0.16)
+    actiontext (8.0.2)
+      actionpack (= 8.0.2)
+      activerecord (= 8.0.2)
+      activestorage (= 8.0.2)
+      activesupport (= 8.0.2)
+      globalid (>= 0.6.0)
+      nokogiri (>= 1.8.5)
+    actionview (8.0.2)
+      activesupport (= 8.0.2)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activejob (8.0.2)
+      activesupport (= 8.0.2)
+      globalid (>= 0.3.6)
+    activemodel (8.0.2)
+      activesupport (= 8.0.2)
+    activerecord (8.0.2)
+      activemodel (= 8.0.2)
+      activesupport (= 8.0.2)
+      timeout (>= 0.4.0)
+    activestorage (8.0.2)
+      actionpack (= 8.0.2)
+      activejob (= 8.0.2)
+      activerecord (= 8.0.2)
+      activesupport (= 8.0.2)
+      marcel (~> 1.0)
+    activesupport (8.0.2)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    ast (2.4.3)
+    base64 (0.2.0)
+    benchmark (0.4.0)
+    bigdecimal (3.1.9)
+    builder (3.3.0)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.3)
+    crass (1.0.6)
+    date (3.4.1)
+    drb (2.2.1)
+    erubi (1.13.1)
+    globalid (1.2.1)
+      activesupport (>= 6.1)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    io-console (0.8.0)
+    irb (1.15.2)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.11.3)
+    language_server-protocol (3.17.0.4)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    loofah (2.24.1)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    mail (2.8.1)
+      mini_mime (>= 0.1.1)
+      net-imap
+      net-pop
+      net-smtp
+    marcel (1.0.4)
+    mini_mime (1.1.5)
+    minitest (5.25.5)
+    net-imap (0.5.8)
+      date
+      net-protocol
+    net-pop (0.1.2)
+      net-protocol
+    net-protocol (0.2.2)
+      timeout
+    net-smtp (0.5.1)
+      net-protocol
+    nio4r (2.7.4)
+    nokogiri (1.18.8-arm64-darwin)
+      racc (~> 1.4)
+    parallel (1.27.0)
+    parser (3.3.8.0)
+      ast (~> 2.4.1)
+      racc
+    pp (0.6.2)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.4.0)
+    psych (5.2.3)
+      date
+      stringio
+    racc (1.8.1)
+    rack (3.1.14)
+    rack-session (2.1.1)
+      base64 (>= 0.1.0)
+      rack (>= 3.0.0)
+    rack-test (2.2.0)
+      rack (>= 1.3)
+    rackup (2.2.1)
+      rack (>= 3)
+    rails (8.0.2)
+      actioncable (= 8.0.2)
+      actionmailbox (= 8.0.2)
+      actionmailer (= 8.0.2)
+      actionpack (= 8.0.2)
+      actiontext (= 8.0.2)
+      actionview (= 8.0.2)
+      activejob (= 8.0.2)
+      activemodel (= 8.0.2)
+      activerecord (= 8.0.2)
+      activestorage (= 8.0.2)
+      activesupport (= 8.0.2)
+      bundler (>= 1.15.0)
+      railties (= 8.0.2)
+    rails-dom-testing (2.2.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.2)
+      loofah (~> 2.21)
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
+    railties (8.0.2)
+      actionpack (= 8.0.2)
+      activesupport (= 8.0.2)
+      irb (~> 1.13)
+      rackup (>= 1.0.0)
+      rake (>= 12.2)
+      thor (~> 1.0, >= 1.2.2)
+      zeitwerk (~> 2.6)
+    rainbow (3.1.1)
+    rake (13.2.1)
+    rdoc (6.13.1)
+      psych (>= 4.0.0)
+    regexp_parser (2.10.0)
+    reline (0.6.1)
+      io-console (~> 0.5)
+    rubocop (1.75.8)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.44.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    standard (1.50.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.75.5)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.8.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.25.0)
+    stringio (3.1.7)
+    thor (1.3.2)
+    timeout (0.4.3)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    uri (1.0.3)
+    useragent (0.16.11)
+    websocket-driver (0.7.7)
+      base64
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.5)
+    zeitwerk (2.7.2)
+
+PLATFORMS
+  arm64-darwin-23
+
+DEPENDENCIES
+  irb
+  minitest (~> 5.25, >= 5.25.5)
+  partials_fx!
+  rake (~> 13.0)
+  standard (~> 1.50)
+
+BUNDLED WITH
+   2.6.8

data/README.md

@@ -0,0 +1,146 @@
+# Partials Fx
+
+Partials FX extends Rails' partials to make them quack more like components. Each partial, located in `app/views/components/`, is backed by a Ruby class with the same name. It also supports CSS modules, meaning you define CSS in the component class and it gets “scoped” to that component only. It is powering the [self-hosted Community Software, Forge](https://forge.railsdesigner.com/).
+
+
+## Installation
+
+```bash
+bundle add partials_fx
+```
+
+
+## Usage
+
+`bin/rails generate component Avatar`
+
+This creates two files:
+- `app/views/components/_avatar_component.html.erb`;
+- `app/views/components/avatar_component.rb`.
+
+They could look like this:
+```erb
+<span id="user-avatar" class="<%= component_class %> <%= avatar_size %>">
+  <% if avatar.attached? %>
+    <%= image_tag avatar.variant(avatar_variant), alt: alt_text %>
+  <% else %>
+    <%= tag.span name.first.upcase, class: "initial" %>
+  <% end %>
+</span>
+```
+
+```ruby
+# app/views/components/avatar_component.rb
+class AvatarComponent < PartialsFx::Component
+  attribute :user, required: true
+  attribute :size, :string, default: "md", inquiry: true
+  attribute :variant, :string, default: "thumb", inquiry: true
+
+  def avatar_size
+    return "avatar-profile" if variant.profile?
+
+    class_names(
+      "avatar-xs": size.xs?,
+      "avatar-sm": size.sm?,
+      "avatar-md": size.md?,
+      "avatar-lg": size.lg?,
+      "avatar-xl": size.xl?
+    )
+  end
+
+  def name
+    @name ||= user.decorate.name
+  end
+
+  def avatar = profile.avatar
+
+  def alt_text = "Avatar for #{name}"
+
+  def avatar_variant
+    variant.thumb? ? :thumb : :profile
+  end
+
+  private
+
+  def profile
+    @profile ||= user.profile
+  end
+end
+```
+
+In views:
+```erb
+<%= render AvatarComponent.new user: Current.user %>
+```
+
+
+## CSS modules
+
+A powerful feature of Partials FX is support for “CSS modules”. Meaning that styles are locally scoped by default, preventing style conflicts across components. This allows the use of the same class names in different components without worrying about collisions, as Partials FX automatically generates unique class names, for the parent element, during compilation. CSS modules improve maintainability by creating a clear connection between components and their styles, making it easier to manage complex UI systems.
+
+It works like this. First define a `styles` block in the class:
+```ruby
+class AvatarComponent < PartialsFx::Component
+  # …
+
+  styles do
+    <<~CSS
+      .component {
+      }
+    CSS
+  end
+
+  # …
+end
+```
+
+Then add the `component_class` method to the the component partial:
+```erb
+<span id="user-avatar" class="<%= component_class %> <%= avatar_size %>">
+</span>
+```
+
+You can now add any CSS selector in the `.component` selector, which itself will compile to something like:
+```css
+/* app/assets/stylesheets/components.partialsfx.css */
+.c-9af2b949 {
+  --avatar-font-size-fallback:
+    clamp(.75rem, calc(var(--avatar-height) * .8), 2rem);
+  display: inline flex;
+  align-items: center;
+  justify-content: center;
+  height: var(--avatar-height, 1rem);
+  /* … */
+
+  .initial {
+    font-size: var(--avatar-font-size, var(--avatar-font-size-fallback));
+    font-weight: 600;
+    color: var(--avatar-color, var(--base-60));
+  }
+
+  &.avatar-profile {}
+
+  /* … */
+}
+```
+
+Inside the component partial, `component_class` will be replaced with the unique selector `.c-9af2b949`. Because [nested selectors are available in CSS](https://developer.mozilla.org/en-US/docs/Web/CSS/Nesting_selector) this will work smoothly. Keeping your selectors scoped to the one component. Making your app's CSS way more maintainable.
+
+Make sure to import the automatically-created CSS file from Partials FX into your `application.css`, e.g.
+```css
+@layer reset, components, utilities;
+
+/* … */
+@import url("./components.partialsfx.css") layer(components);
+/* … */
+```
+
+
+# Contributing
+
+This project uses [Standard](https://github.com/testdouble/standard) for formatting Ruby code. Please make sure to run `be standardrb` before submitting pull requests. Run tests via `rails test`.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "standard/rake"
+
+task default: %i[test standard]

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "partials_fx"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/release

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+VERSION=$1
+
+if [ -z "$VERSION" ]; then
+  echo "Error: The version number is required."
+  echo "Usage: $0 <version-number>"
+  exit 1
+fi
+
+printf "module PartialsFx\n  VERSION = \"$VERSION\"\nend\n" > ./lib/partials_fx/version.rb
+bundle
+git add Gemfile.lock lib/partials_fx/version.rb
+git commit -m "Bump version for $VERSION"
+git push
+git tag v$VERSION
+git push --tags
+gem build partials_fx.gemspec
+gem push "partials_fx-$VERSION.gem"

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/generators/USAGE

@@ -0,0 +1,9 @@
+Description:
+    Creates a new component with a view template and Ruby class
+
+Example:
+    rails generate component Avatar
+
+    This will create:
+      app/views/components/_avatar_component.html.erb
+      app/views/components/avatar_component.rb

data/lib/generators/component_generator.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/named_base"
+
+class ComponentGenerator < Rails::Generators::NamedBase
+  source_root File.expand_path("templates", __dir__)
+
+  check_class_collision suffix: "Component"
+
+  class_option :component_styles, type: :boolean, default: PartialsFx.configuration.enable_component_styles
+
+  def copy_component_file
+    template "component.rb", File.join(PartialsFx.configuration.components_path, class_path, "#{file_name}_component.rb")
+    template "component.html.erb", File.join(PartialsFx.configuration.components_path, class_path, "_#{file_name}_component.html.erb")
+  end
+
+  private
+
+  def parent_class = defined?(ApplicationComponent) ? ApplicationComponent : PartialsFx::Component
+end

data/lib/generators/templates/component.html.erb.tt

@@ -0,0 +1,4 @@
+<%%# Component class: <%= PartialsFx.configuration.components_path %>/<%= file_path %>_component.rb %>
+<div<%- if options["component_styles"] %> class="<%%= component_class %>"<%- end %>>
+  <%%# Your component here %>
+</div>

data/lib/generators/templates/component.rb.tt

@@ -0,0 +1,10 @@
+class <%= class_name %>Component < <%= parent_class %>
+<%- if options["component_styles"] -%>
+  styles do
+    <<~CSS
+      .component {
+      }
+    CSS
+  end
+<%- end -%>
+end

data/lib/partials_fx/component/attributes.rb

@@ -0,0 +1,35 @@
+module PartialsFx
+  class Component
+    module Attributes
+      module ClassMethods
+        def attribute(name, *arguments, required: false, inquiry: false, **options)
+          track_required_attribute(name) if required
+
+          super(name, *arguments, **options)
+
+          return unless inquiry
+
+          define_method(name) do
+            value = super()
+
+            return value if value.nil?
+
+            ActiveSupport::StringInquirer.new(value.to_s)
+          end
+        end
+
+        def required_attributes
+          @required_attributes || []
+        end
+
+        private
+
+        def track_required_attribute(attribute_name)
+          @required_attributes ||= []
+
+          @required_attributes << attribute_name
+        end
+      end
+    end
+  end
+end

data/lib/partials_fx/component/render.rb

@@ -0,0 +1,27 @@
+module PartialsFx
+  class Component
+    module Render
+      def render_in(view_context, &block)
+        @view_context = view_context
+
+        capture_content_if_block_given(&block)
+
+        partial_path = build_partial_path
+
+        view_context.render(partial: partial_path, locals: to_locals)
+      end
+
+      private
+
+      def capture_content_if_block_given(&block)
+        return unless block_given?
+
+        @content = @view_context.capture do
+          yield self
+        end
+      end
+
+      def build_partial_path = "components/#{self.class.name.underscore}"
+    end
+  end
+end

data/lib/partials_fx/component/slots.rb

@@ -0,0 +1,21 @@
+module PartialsFx
+  class Component
+    module Slots
+      module ClassMethods
+        def slot(slot_name, default: nil)
+          define_method(slot_name) do |&block|
+            @slots ||= {}
+
+            if block
+              @slots[slot_name] = view_context.capture(&block)
+
+              nil # Prevent output during capture
+            else
+              @slots[slot_name] || (default.is_a?(Symbol) ? send(default) : default)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/partials_fx/component/styles.rb

@@ -0,0 +1,63 @@
+module PartialsFx
+  class Component
+    module Styles
+      module ClassMethods
+        def styles(&block)
+          @styles_block = block
+
+          register_styles_if_rails_loaded
+        end
+
+        def component_styles
+          return @component_styles if defined?(@component_styles)
+          return nil unless @styles_block
+
+          generate_component_styles
+        end
+
+        def register_styles
+          return unless @styles_block
+
+          Stylist.register(self)
+        end
+
+        private
+
+        def register_styles_if_rails_loaded
+          register_styles if defined?(Rails) && Rails.root
+        end
+
+        def generate_component_styles
+          styles_content = @styles_block.call
+
+          @component_id = generate_component_id(styles_content)
+          @component_styles = process_styles_with_component_id(styles_content)
+        end
+
+        def generate_component_id(styles_content)
+          hash = Digest::MD5.hexdigest(styles_content)[0..7]
+
+          "c-#{hash}"
+        end
+
+        def process_styles_with_component_id(styles_content)
+          styles_content.gsub(/\.component\b/, ".#{@component_id}")
+        end
+      end
+
+      def component_class
+        return nil unless component_has_styles?
+
+        self.class.component_styles
+        self.class.instance_variable_get(:@component_id)
+      end
+
+      private
+
+      def component_has_styles?
+        self.class.instance_variable_defined?(:@styles_block) &&
+          self.class.instance_variable_get(:@styles_block)
+      end
+    end
+  end
+end

data/lib/partials_fx/component.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require "active_model"
+require "action_view"
+
+require "partials_fx/component/attributes"
+require "partials_fx/component/slots"
+require "partials_fx/component/styles"
+require "partials_fx/component/render"
+
+module PartialsFx
+  class Component
+    include ActiveModel::Model
+    include ActionView::Helpers::TagHelper
+    include ActiveModel::Attributes
+
+    include Styles
+    include Render
+
+    extend Attributes::ClassMethods
+    extend Slots::ClassMethods
+    extend Styles::ClassMethods
+
+    attr_accessor :content, :view_context
+
+    class << self
+      def inherited(subclass)
+        super
+
+        subclass.instance_eval do
+          @pending_registration = true
+        end
+      end
+    end
+
+    def initialize(**component_attributes)
+      validate_required_attributes(component_attributes)
+
+      super
+    end
+
+    def to_locals
+      base_locals = attributes.transform_keys(&:to_sym)
+
+      base_locals
+        .merge(public_methods(false).to_h { [_1, public_send(_1)] })
+        .merge(slot_locals)
+        .merge(content: content, component_class: component_class)
+    end
+
+    def method_missing(method, *arguments, &block)
+      if respond_to_missing?(method)
+        public_send(method, *arguments, &block)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method, include_private = false)
+      public_methods.include?(method) || super
+    end
+
+    private
+
+    def validate_required_attributes(component_attributes)
+      self.class.required_attributes.each do |required_attribute|
+        unless component_attributes.key?(required_attribute)
+          raise MissingRequiredAttributeError.new(required_attribute)
+        end
+      end
+    end
+
+    def slot_locals
+      @slots || {}
+    end
+  end
+end

data/lib/partials_fx/configuration.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module PartialsFx
+  class Configuration
+    attr_accessor :components_path, :enable_component_styles, :components_layer
+
+    def initialize
+      @components_path = File.join("app", "views", "components")
+      @enable_component_styles = true
+      @components_layer = nil # e.g. "components"
+    end
+  end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure = yield(configuration)
+  end
+end

data/lib/partials_fx/errors.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module PartialsFx
+  class Error < StandardError; end
+
+  class MissingRequiredAttributeError < Error
+    def initialize(attribute_name)
+      super("Missing required attribute: #{attribute_name}")
+    end
+  end
+end

data/lib/partials_fx/railtie.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "rails/railtie"
+
+module PartialsFx
+  class Railtie < Rails::Railtie
+    initializer "partials_fx.autoload", before: :set_autoload_paths do |app|
+      app.config.autoload_paths << app.root.join(PartialsFx.configuration.components_path)
+    end
+
+    config.after_initialize do
+      PartialsFx::Railtie.load_and_register_components if PartialsFx.configuration.enable_component_styles
+    end
+
+    if Rails.env.development?
+      config.to_prepare do
+        PartialsFx::Railtie.register_all_components if PartialsFx.configuration.enable_component_styles
+      end
+    end
+
+    class << self
+      def components_glob = Rails.root.join(PartialsFx.configuration.components_path, "**/*_component.rb")
+
+      def load_and_register_components
+        Dir[components_glob].each { require_dependency _1 }
+
+        register_all_components
+      end
+
+      def register_all_components
+        ObjectSpace.each_object(Class)
+          .select { _1 < PartialsFx::Component }
+          .each(&:register_styles)
+      end
+    end
+  end
+end

data/lib/partials_fx/stylist/writer.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module PartialsFx
+  class Stylist
+    class Writer
+      def self.print(component_class)
+        new.print!(component_class)
+      end
+
+      def print!(component_class)
+        component_name = component_class.name
+        component_class.instance_variable_get(:@component_id)
+        styles = component_class.component_styles
+
+        ensure_stylesheet_exists!
+
+        update_stylesheet_with(component_name, styles)
+      end
+
+      private
+
+      def ensure_stylesheet_exists!
+        return if File.exist?(stylesheet_path)
+
+        FileUtils.mkdir_p(File.dirname(stylesheet_path))
+        File.write(stylesheet_path, initial_content)
+      end
+
+      def update_stylesheet_with(component_name, styles)
+        content = File.read(stylesheet_path)
+        updated_content = merge_styles_into(content, component_name, styles)
+
+        write_atomically(updated_content)
+
+        notify_asset_pipeline!
+      end
+
+      def merge_styles_into(content, component_name, styles)
+        wrapped_styles = wrap_with(component_name, styles)
+        pattern = style_pattern_for(component_name)
+
+        if content.match?(pattern)
+          content.gsub(pattern, wrapped_styles.strip)
+        else
+          append_styles_to(content, wrapped_styles)
+        end
+      end
+
+      def write_atomically(content)
+        if PartialsFx.configuration.components_layer
+          content = content.rstrip + "\n}\n"
+        end
+
+        temp_file = "#{stylesheet_path}.tmp"
+
+        File.write(temp_file, content)
+        FileUtils.mv(temp_file, stylesheet_path)
+      end
+
+      def notify_asset_pipeline! = FileUtils.touch(stylesheet_path)
+
+      def wrap_with(component_name, styles)
+        start_marker = "/* #{component_name} */\n"
+        end_marker = "/* /#{component_name} */"
+
+        "#{start_marker}#{styles}#{end_marker}"
+      end
+
+      def style_pattern_for(component_name)
+        /\/\* #{Regexp.escape(component_name)} \*\/\n.*?\/\* \/#{Regexp.escape(component_name)} \*\//m
+      end
+
+      def append_styles_to(content, wrapped_styles)
+        [content.chomp, wrapped_styles, "\n"].join("\n")
+      end
+
+      def initial_content
+        content = "/* Generated by PartialsFx - Do not edit manually */\n"
+
+        if (layer = PartialsFx.configuration.components_layer)
+          content += "@layer #{layer} {\n"
+        end
+
+        content
+      end
+
+      def stylesheet_path
+        @stylesheet_path ||= Rails.root.join("app/assets/stylesheets/components.partialsfx.css")
+      end
+    end
+  end
+end

data/lib/partials_fx/stylist.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "partials_fx/stylist/writer"
+
+module PartialsFx
+  class Stylist
+    def self.register(component_class)
+      return if unstyled?(component_class)
+
+      Writer.print(component_class)
+    end
+
+    private_class_method def self.unstyled?(component_class)
+      !component_class.component_styles &&
+        !component_class.instance_variable_get(:@component_id)
+    end
+  end
+end

data/lib/partials_fx/version.rb

@@ -1,3 +1,3 @@
 module PartialsFx
-  VERSION = "0.0.1"
+  VERSION = "0.5.0"
 end

data/lib/partials_fx.rb

@@ -1,4 +1,12 @@
+# frozen_string_literal: true
+
 require "partials_fx/version"
+require "partials_fx/configuration"
+require "generators/component_generator"
+require "partials_fx/errors"
+require "partials_fx/component"
+require "partials_fx/stylist"
+require "partials_fx/railtie"
 
 module PartialsFx
 end

data/partials_fx.gemspec

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "lib/partials_fx/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "partials_fx"
+  spec.version = PartialsFx::VERSION
+  spec.authors = ["Rails Designer"]
+  spec.email = ["devs@railsdesigner.com"]
+
+  spec.summary = "Extends Rails' partials to make them quack more like components"
+  spec.description = "Partials FX extends Rails' partials to make them quack more like components. Each partial, located in app/views/components/, is backed by a Ruby class with the same name. It also supports CSS modules, meaning you define CSS in the component class and it gets “scoped” to that component only."
+  spec.homepage = "https://railsdesigner.com/partials-fx/"
+  spec.license = "MIT"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/Rails-Designer/partials_fx/"
+
+  spec.files = Dir["{bin,lib}/**/*", "Rakefile", "README.md", "partials_fx.gemspec", "Gemfile", "Gemfile.lock"]
+
+  spec.required_ruby_version = ">= 3.4.0"
+
+  spec.add_dependency "rails", ">= 7.2", "< 8.1"
+end

metadata

@@ -1,26 +1,74 @@
 --- !ruby/object:Gem::Specification
 name: partials_fx
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Rails Designer
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+description: Partials FX extends Rails' partials to make them quack more like components.
+  Each partial, located in app/views/components/, is backed by a Ruby class with the
+  same name. It also supports CSS modules, meaning you define CSS in the component
+  class and it gets “scoped” to that component only.
 email:
 - devs@railsdesigner.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/release
+- bin/setup
+- lib/generators/USAGE
+- lib/generators/component_generator.rb
+- lib/generators/templates/component.html.erb.tt
+- lib/generators/templates/component.rb.tt
 - lib/partials_fx.rb
+- lib/partials_fx/component.rb
+- lib/partials_fx/component/attributes.rb
+- lib/partials_fx/component/render.rb
+- lib/partials_fx/component/slots.rb
+- lib/partials_fx/component/styles.rb
+- lib/partials_fx/configuration.rb
+- lib/partials_fx/errors.rb
+- lib/partials_fx/railtie.rb
+- lib/partials_fx/stylist.rb
+- lib/partials_fx/stylist/writer.rb
 - lib/partials_fx/version.rb
-homepage: https://railsdesigner.com/
+- partials_fx.gemspec
+homepage: https://railsdesigner.com/partials-fx/
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://railsdesigner.com/partials-fx/
+  source_code_uri: https://github.com/Rails-Designer/partials_fx/
 rdoc_options: []
 require_paths:
 - lib
@@ -28,14 +76,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
-summary: Rails partials enhanced.
+summary: Extends Rails' partials to make them quack more like components
 test_files: []