utility_palettes 1.0.3 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4dd0760b2f72cc78a687afcbf878d4e88a936cc4503bba60d46c73e1df21467c
-  data.tar.gz: a85e503c4b282647c6001446950e58ebcf32bef6549e0f68a8e226264fb8e14f
+  metadata.gz: 23332faf82c72ba20e4cf27ddfd3d9f1518b78b2f94ebc561fe69a5e881f2743
+  data.tar.gz: 2f636967a325e694deb98ec7960dff63d62bfce4c25dd966452ccb288cca9f4d
 SHA512:
-  metadata.gz: 4c5569c8bc1bc5eb3eb2916dd45b29fc211eb4bae211c10d7aeae20c933e79b7efc4dc9e0af27a6654ecc256890645758949c66424f46573df18f1e4f3003aff
-  data.tar.gz: ff3a66f8ed5839f3b25608ecf6836aaeae7ba99ae02bd67dccfb3b2f2797a5f5d3f98456d557ac22efbe521fb4769e67fdd59cebaf2c5a09a51913629ad96ff8
+  metadata.gz: 71f73653beeb5ccb1566dd1561510de4f53cb91c35271a2a7c80658783c0e20f0f9cb93facf97c16bf15e7a7e7ab48db80084d0e5e030be01584c303328f9d6b
+  data.tar.gz: 34499831e9976f15d273c626506adfc3083ad563553b4639f1376967565fefdd6e31f6dd4ba692b4515a0006c8d38433be59bd15eabbeb6893a93d16345850da

data/README.md

@@ -1,6 +1,6 @@
 # UtilityPalettes
 
-![Static Badge](https://img.shields.io/badge/Gem_Version-1.0.1-blue)
+![Static Badge](https://img.shields.io/badge/Gem_Version-1.0.5-blue)
 [![Static Badge](https://img.shields.io/badge/RubyGems-red)](https://rubygems.org/gems/utility_palettes)
 
 > Generate your own colour palettes in an instance.
@@ -110,7 +110,8 @@ The value can be;
 
 - a string such as '#ff0000' or 'rgb(51, 102, 204)',
 - a hash of colour space keys and values such as { r: 51, g: 102, b: 204 } or { h: 30, s: 50, l: 75 },
-- a 'reference' to a colour the is previously defined be using that colour name as the value but prepended with '$', such as '$red' (this felt useful if there are colours if you re-use the same colours under different use names)
+- a 'reference' to a colour the is also defined in one of your config be using that colour name as the value but prepended with '$', such as '$red' (this felt useful if there are colours if you re-use the same colours under different use names)
+ - currently you can only reference colours defined in the config, not colours that would be generated as part of the palette generator process
 
 | Option    | Default | Possible Values                       |
 | :-------- | :-----: | :-----------------------------------: |

data/lib/generators/utility_palettes/config_generator.rb

@@ -1,13 +1,20 @@
-# frozen_string_literal: true
-
-module UtilityPalettes
-  module Generators
-    class ConfigGenerator < Rails::Generators::Base
-      source_root File.expand_path('../../..', __dir__)
-
-      def copy_config
-        copy_file 'lib/generators/templates/config/utility_palettes.rb', 'config/initializers/utility_palettes.rb'
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+begin
+  require 'rails/generators'
+  require 'rails/generators/base'
+rescue LoadError => e
+  raise LoadError, "railties gem is required for generators. Add 'railties' to your Gemfile: #{e.message}"
+end
+
+module UtilityPalettes
+  module Generators
+    class ConfigGenerator < Rails::Generators::Base
+      source_root File.expand_path('../../..', __dir__)
+
+      def copy_config
+        copy_file 'lib/generators/templates/config/utility_palettes.rb', 'config/initializers/utility_palettes.rb'
+      end
+    end
+  end
+end

data/lib/generators/utility_palettes/generate_generator.rb

@@ -1,29 +1,36 @@
-# frozen_string_literal: true
-
-module UtilityPalettes
-  module Generators
-    class GenerateGenerator < Rails::Generators::Base
-      def generate_utility_palettes
-        self.class.config_format_warn if File.exist?('config/utility_palettes.yml') || File.exist?('config/utility_palettes.json')
-
-        if UtilityPalettes.configuration.enable_environments.include?(Rails.env.to_sym)
-          UtilityPalettes::Palettes.generate
-        else
-          self.class.disabled_warn
-        end
-      end
-
-      private
-
-      # TODO: add links to README for migration
-      def self.config_format_warn
-        warn 'WARNING: Utility Palettes now uses an initializer to set config. You need to migrate and remove your YML/JSON file.'
-      end
-
-      # TODO: add links to README for environment setting
-      def self.disabled_warn
-        warn 'ERROR: Utility Palettes is disabled for this environment. Palettes will not be generated.'
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+begin
+  require 'rails/generators'
+  require 'rails/generators/base'
+rescue LoadError => e
+  raise LoadError, "railties gem is required for generators. Add 'railties' to your Gemfile: #{e.message}"
+end
+
+module UtilityPalettes
+  module Generators
+    class GenerateGenerator < Rails::Generators::Base
+      def generate_utility_palettes
+        self.class.config_format_warn if File.exist?('config/utility_palettes.yml') || File.exist?('config/utility_palettes.json')
+
+        if UtilityPalettes.configuration.enable_environments.include?(Rails.env.to_sym)
+          UtilityPalettes::Palettes.generate
+        else
+          self.class.disabled_warn
+        end
+      end
+
+      private
+
+      # TODO: add links to README for migration
+      def self.config_format_warn
+        warn 'WARNING: Utility Palettes now uses an initializer to set config. You need to migrate and remove your YML/JSON file.'
+      end
+
+      # TODO: add links to README for environment setting
+      def self.disabled_warn
+        warn 'ERROR: Utility Palettes is disabled for this environment. Palettes will not be generated.'
+      end
+    end
+  end
+end

data/lib/utility_palettes/outputs.rb

@@ -65,7 +65,7 @@ module UtilityPalettes
       FileUtils.mkdir_p(File.dirname(filepath))
       File.write(filepath, content)
 
-      puts 'Exporting utility palettes JSON...'
+      puts "Exporting utility palettes JSON to #{filepath}..."
       true
     end
 
@@ -77,7 +77,7 @@ module UtilityPalettes
       FileUtils.mkdir_p(File.dirname(filepath))
       File.write(filepath, content)
 
-      puts 'Exporting utility palettes SCSS...'
+      puts "Exporting utility palettes SCSS to #{filepath}..."
       true
     end
 
@@ -89,7 +89,7 @@ module UtilityPalettes
       FileUtils.mkdir_p(File.dirname(filepath))
       File.write(filepath, content)
 
-      puts 'Exporting utility palettes CSS...'
+      puts "Exporting utility palettes CSS to #{filepath}..."
       true
     end
 

data/lib/utility_palettes/palettes.rb

@@ -64,8 +64,17 @@ module UtilityPalettes
       basic_hash.each do |label, colour|
         begin
           if colour.is_a?(String) && colour.start_with?('$')
-            # if the colour label begins with $ then it is a reference to a different defined colour, so must be looked up in the main
-            colourized_hash[label] = ColorConverters::Color.new(@combined_samples.dig(colour.slice(1..-1).to_sym))
+            colour_ref_array = [colour]
+
+            # if the colour label begins with $ then it is a reference to a different defined colour, so must be looked up in the main hash
+            while colour_ref_array.last.is_a?(String) && colour_ref_array.last.start_with?('$')
+              colour_ref = @combined_samples.dig(colour_ref_array.last.slice(1..-1))
+              raise UtilityPalettes::Error, "Circular reference detected for colour '#{label}': #{colour_ref_array.join(' -> ')}" if colour_ref_array.include?(colour_ref)
+
+              colour_ref_array << colour_ref
+            end
+
+            colourized_hash[label] = ColorConverters::Color.new(colour_ref)
           else
             colourized_hash[label] = ColorConverters::Color.new(colour)
           end
@@ -76,6 +85,8 @@ module UtilityPalettes
           #   hash[colourized_hash[label].name] = hash.delete(label)
           #   puts "Blank colour #{colour} has been given the name: #{colourized_hash[label].name}"
           # end
+        rescue UtilityPalettes::Error => e
+          warn "Error processing colour #{label}: #{e.message}"
         rescue ColorConverters::InvalidColorError => e
           warn "Error processing colour #{label} with value #{colour}: #{e.message}"
         end

data/lib/utility_palettes/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module UtilityPalettes
-  VERSION = '1.0.3'
+  VERSION = '1.0.5'
 end

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: utility_palettes
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.5
 platform: ruby
 authors:
 - Louis Davis
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-05 00:00:00.000000000 Z
+date: 2026-01-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: color_converters
@@ -66,6 +67,7 @@ metadata:
   homepage_uri: https://github.com/louiswdavis/utility_palettes
   source_code_uri: https://github.com/louiswdavis/utility_palettes
   changelog_uri: https://github.com/louiswdavis/utility_palettes/blob/master/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -80,7 +82,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.3
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Quickly build colour palettes based on default or supplied colour swatches,
   and export them for use in stylesheets.