style_capsule 1.0.2

data/lib/tasks/style_capsule.rake

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+namespace :style_capsule do
+  desc "Build StyleCapsule CSS files from components (similar to Tailwind CSS build)"
+  task build: :environment do
+    require "style_capsule/css_file_writer"
+
+    # Ensure output directory exists
+    StyleCapsule::CssFileWriter.ensure_output_directory
+
+    # Collect all component classes that use StyleCapsule
+    component_classes = []
+
+    # Find Phlex components
+    if defined?(Phlex::HTML)
+      ObjectSpace.each_object(Class) do |klass|
+        if klass < Phlex::HTML && klass.included_modules.include?(StyleCapsule::Component)
+          component_classes << klass
+        end
+      end
+    end
+
+    # Find ViewComponent components
+    # Wrap in begin/rescue to handle ViewComponent loading errors (e.g., version compatibility issues)
+    begin
+      if defined?(ViewComponent::Base)
+        ObjectSpace.each_object(Class) do |klass|
+          if klass < ViewComponent::Base && klass.included_modules.include?(StyleCapsule::ViewComponent)
+            component_classes << klass
+          end
+        rescue
+          # Skip this class if checking inheritance triggers ViewComponent loading errors
+          # (e.g., ViewComponent 2.83.0 has a bug with Gem::Version#to_f)
+          next
+        end
+      end
+    rescue
+      # ViewComponent may have loading issues (e.g., version compatibility)
+      # Silently skip ViewComponent components if there's an error
+      # This allows the rake task to continue with Phlex components
+    end
+
+    # Generate CSS files for each component
+    component_classes.each do |component_class|
+      next unless component_class.inline_cache_strategy == :file
+      # Check for class method component_styles (required for file caching)
+      next unless component_class.respond_to?(:component_styles, false)
+
+      begin
+        # Use class method component_styles for file caching
+        css_content = component_class.component_styles
+        next if css_content.nil? || css_content.to_s.strip.empty?
+
+        # Create a temporary instance to get capsule
+        # Some components might require arguments, so we catch errors
+        instance = component_class.new
+        capsule_id = instance.component_capsule
+        scoped_css = instance.send(:scope_css, css_content)
+
+        # Write CSS file
+        file_path = StyleCapsule::CssFileWriter.write_css(
+          css_content: scoped_css,
+          component_class: component_class,
+          capsule_id: capsule_id
+        )
+
+        puts "Generated: #{file_path}" if file_path
+      rescue ArgumentError, NoMethodError => e
+        # Component requires arguments or has dependencies - skip it
+        puts "Skipped #{component_class.name}: #{e.message}"
+        next
+      end
+    end
+
+    puts "StyleCapsule CSS files built successfully"
+  end
+
+  desc "Clear StyleCapsule generated CSS files"
+  task clear: :environment do
+    require "style_capsule/css_file_writer"
+    StyleCapsule::CssFileWriter.clear_files
+    puts "StyleCapsule CSS files cleared"
+  end
+end
+
+# Hook into Rails asset precompilation (similar to Tailwind CSS)
+if defined?(Rails)
+  Rake::Task["assets:precompile"].enhance(["style_capsule:build"]) if Rake::Task.task_defined?("assets:precompile")
+end

data/sig/style_capsule.rbs

@@ -0,0 +1,110 @@
+module StyleCapsule
+  VERSION: String
+
+  module CssProcessor
+    def self.scope_selectors: (String css_string, String capsule_id) -> String
+    def self.scope_with_nesting: (String css_string, String capsule_id) -> String
+    def self.strip_comments: (String css) -> String
+  end
+
+  class CssFileWriter
+    def self.configure: (?output_dir: String | Pathname, ?filename_pattern: Proc, ?enabled: bool) -> void
+    def self.write_css: (css_content: String, component_class: Class, capsule_id: String) -> String?
+    def self.file_exists?: (component_class: Class, capsule_id: String) -> bool
+    def self.file_path_for: (component_class: Class, capsule_id: String) -> String?
+    def self.ensure_output_directory: () -> void
+    def self.clear_files: () -> void
+    def self.enabled?: () -> bool
+  end
+
+  class StylesheetRegistry < ActiveSupport::CurrentAttributes
+    DEFAULT_NAMESPACE: Symbol
+
+    def self.normalize_namespace: (Symbol | String | nil namespace) -> Symbol
+    def self.register: (String file_path, ?namespace: Symbol | String | nil, **Hash[untyped, untyped] options) -> void
+    def self.register_inline: (String css_content, ?namespace: Symbol | String | nil, ?capsule_id: String | nil, ?cache_key: String | nil, ?cache_strategy: Symbol, ?cache_ttl: Integer | ActiveSupport::Duration | nil, ?cache_proc: Proc | nil, ?component_class: Class | nil, ?stylesheet_link_options: Hash[untyped, untyped] | nil) -> void
+    def self.cached_inline: (String cache_key, cache_strategy: Symbol, ?cache_ttl: Integer | ActiveSupport::Duration | nil, ?cache_proc: Proc | nil, ?css_content: String | nil, ?capsule_id: String | nil, ?namespace: Symbol | nil) -> String | nil
+    def self.cache_inline_css: (String cache_key, String css_content, cache_strategy: Symbol, ?cache_ttl: Integer | ActiveSupport::Duration | nil, ?cache_proc: Proc | nil, ?capsule_id: String | nil, ?namespace: Symbol | nil) -> void
+    def self.clear_inline_cache: (?String cache_key) -> void
+    def self.cleanup_expired_cache: () -> Integer
+    def self.manifest_files: () -> Hash[Symbol, Set[Hash[Symbol, untyped]]]
+    def self.request_inline_stylesheets: () -> Hash[Symbol, Array[Hash[Symbol, untyped]]]
+    def self.stylesheets_for: (?namespace: Symbol | String | nil) -> Array[Hash[Symbol, untyped]]
+    def self.clear: (?namespace: Symbol | String | nil) -> void
+    def self.clear_manifest: (?namespace: Symbol | String | nil) -> void
+    def self.render_head_stylesheets: (?ActionView::Base | nil view_context, ?namespace: Symbol | String | nil) -> String
+    def self.any?: (?namespace: Symbol | String | nil) -> bool
+  end
+
+  module Component
+    module ClassMethods
+      def css_cache: () -> Hash[String, String]
+      def clear_css_cache: () -> void
+      def capsule_id: () -> String | nil
+      def capsule_id: (String capsule_id) -> String
+      def stylesheet_registry: (?namespace: Symbol | String | nil, ?cache_strategy: Symbol, ?cache_ttl: Integer | ActiveSupport::Duration | nil, ?cache_proc: Proc | nil) -> void
+      def head_rendering!: () -> void  # deprecated
+      def head_rendering?: () -> bool
+      def stylesheet_namespace: () -> Symbol | String | nil
+      def custom_capsule_id: () -> String | nil
+      def inline_cache_strategy: () -> Symbol | nil
+      def inline_cache_strategy: (Symbol strategy, ?ttl: Integer | nil, ?cache_proc: Proc | nil) -> Symbol
+      def inline_cache_ttl: () -> Integer | ActiveSupport::Duration | nil
+      def inline_cache_proc: () -> Proc | nil
+      def stylesheet_link_options: () -> Hash[untyped, untyped] | nil
+      def stylesheet_link_options: (Hash[untyped, untyped] options) -> Hash[untyped, untyped]
+      def css_scoping_strategy: () -> Symbol
+      def css_scoping_strategy: (Symbol strategy) -> Symbol
+    end
+
+    def component_capsule: () -> String
+    def head_rendering?: () -> bool
+  end
+
+  module ViewComponent
+    module ClassMethods
+      def css_cache: () -> Hash[String, String]
+      def clear_css_cache: () -> void
+      def capsule_id: () -> String | nil
+      def capsule_id: (String capsule_id) -> String
+      def stylesheet_registry: (?namespace: Symbol | String | nil, ?cache_strategy: Symbol, ?cache_ttl: Integer | ActiveSupport::Duration | nil, ?cache_proc: Proc | nil) -> void
+      def head_rendering!: () -> void  # deprecated
+      def head_rendering?: () -> bool
+      def stylesheet_namespace: () -> Symbol | String | nil
+      def custom_capsule_id: () -> String | nil
+      def inline_cache_strategy: () -> Symbol | nil
+      def inline_cache_strategy: (Symbol strategy, ?ttl: Integer | nil, ?cache_proc: Proc | nil) -> Symbol
+      def inline_cache_ttl: () -> Integer | ActiveSupport::Duration | nil
+      def inline_cache_proc: () -> Proc | nil
+      def stylesheet_link_options: () -> Hash[untyped, untyped] | nil
+      def stylesheet_link_options: (Hash[untyped, untyped] options) -> Hash[untyped, untyped]
+      def css_scoping_strategy: () -> Symbol
+      def css_scoping_strategy: (Symbol strategy) -> Symbol
+    end
+
+    def component_capsule: () -> String
+    def head_rendering?: () -> bool
+  end
+
+  module ViewComponentHelper
+    def register_stylesheet: (String file_path, ?namespace: Symbol | String | nil, **Hash[untyped, untyped] options) -> void
+    def stylesheet_registrymap_tags: (?namespace: Symbol | String | nil) -> String
+  end
+
+  module Helper
+    def generate_capsule_id: (String css_content) -> String
+    def scope_css: (String css_content, String capsule_id) -> String
+    def style_capsule: (?String css_content, ?capsule_id: String | nil) { () -> String } -> String
+    def register_stylesheet: (String file_path, ?namespace: Symbol | String | nil, **Hash[untyped, untyped] options) -> void
+    def stylesheet_registrymap_tags: (?namespace: Symbol | String | nil) -> String
+  end
+
+  module PhlexHelper
+    def register_stylesheet: (String file_path, ?namespace: Symbol | String | nil, **Hash[untyped, untyped] options) -> void
+    def stylesheet_registrymap_tags: (?namespace: Symbol | String | nil) -> void
+  end
+
+  class Railtie < Rails::Railtie
+  end
+end
+

metadata

@@ -0,0 +1,305 @@
+--- !ruby/object:Gem::Specification
+name: style_capsule
+version: !ruby/object:Gem::Version
+  version: 1.0.2
+platform: ruby
+authors:
+- Andrei Makarov
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-11-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: rspec_junit_formatter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: simplecov-cobertura
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: standard-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: standard-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: memory_profiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: phlex-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: view_component
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: Provides component-scoped CSS encapsulation using [data-capsule] attributes
+  for Phlex components, ViewComponent components, and ERB templates. Styles are automatically
+  scoped to prevent leakage between components. Inspired by component-based CSS approaches
+  like Angular's view encapsulation and CSS modules.
+email:
+- contact@kiskolabs.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.md
+- README.md
+- SECURITY.md
+- lib/style_capsule.rb
+- lib/style_capsule/component.rb
+- lib/style_capsule/component_styles_support.rb
+- lib/style_capsule/css_file_writer.rb
+- lib/style_capsule/css_processor.rb
+- lib/style_capsule/helper.rb
+- lib/style_capsule/phlex_helper.rb
+- lib/style_capsule/railtie.rb
+- lib/style_capsule/stylesheet_registry.rb
+- lib/style_capsule/version.rb
+- lib/style_capsule/view_component.rb
+- lib/style_capsule/view_component_helper.rb
+- lib/tasks/style_capsule.rake
+- sig/style_capsule.rbs
+homepage: https://github.com/amkisko/style_capsule.rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/amkisko/style_capsule.rb
+  changelog_uri: https://github.com/amkisko/style_capsule.rb/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/amkisko/style_capsule.rb/issues
+  documentation_uri: https://github.com/amkisko/style_capsule.rb#readme
+  rubygems_mfa_required: 'true'
+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.5.9
+signing_key:
+specification_version: 4
+summary: Attribute-based CSS scoping for Phlex, ViewComponent, and ERB templates.
+test_files: []