abachrome 0.1.5 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9600763490f935450197f31388435f33c7d82c6dbcf854a8f2d01d8c5a301367
-  data.tar.gz: 0e5fb3f804f9dd1332e37311f1e63e17b50aa6e204b67944c5338e18879b0ee8
+  metadata.gz: adfda90185a392dcd8859acac1f53b7ac4d9ace7a083b1b643baeeea49de76b8
+  data.tar.gz: b7b66f5e35f5f7f16b1704fced9de7cb85b2088b98afaf6c9aa0f31ad8e4fdb2
 SHA512:
-  metadata.gz: 660d4f26b871b165eeb5bbf17c380ebe1ec8ba950746b409d6e44a26dab04c3ae95e3e8952ff9e60dccaef6d7cc5d2386bd8e24730214cabbbab2593b1bbe128
-  data.tar.gz: 101a8a42a9509aedd238b96e5327441b4d4f79efc33715d857b88f8614f4d72ec1fe0c6af41f629f0c53b8db888ec7cc448ec603e6a0c4d379ff7a0b609af23f
+  metadata.gz: adaebc43ce61184e91852927c83f371234fdde03aeff491570b35146d0f899bb7919336c0f5908c23d80b8233c1a9327a7d8fe5a54da83eac1b32a3d04c7d26e
+  data.tar.gz: 4088bd45b14da9b2d7c475a07cd9ee5797df50abe03701f48f64f7c684edaac8b24736a53b0d49aac5fca88d4e45b21535c86fbfd927e7d2095d11b515e57ed8

data/abachrome.gemspec

@@ -30,6 +30,7 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
 
   # Runtime dependencies
+  spec.add_dependency "bigdecimal", "~> 3.1"
   spec.add_dependency "dry-inflector", "~> 1.0"
 
 end

data/devenv.nix

@@ -5,7 +5,7 @@
   env.GREET = "devenv";
 
   # https://devenv.sh/packages/
-  packages = [ pkgs.git];
+  packages = [ pkgs.git pkgs.ncurses];
 
 	languages.ruby.enable = true;
 	languages.ruby.version = "3.3.2";

data/lib/abachrome/abc_decimal.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::AbcDecimal - High-precision decimal arithmetic for color calculations
 #
 # This class provides a wrapper around Ruby's BigDecimal to ensure consistent precision
@@ -19,6 +21,7 @@ require "forwardable"
 module Abachrome
   class AbcDecimal
     extend Forwardable
+
     DEFAULT_PRECISION = (ENV["ABC_DECIMAL_PRECISION"] || "24").to_i
 
     attr_accessor :value, :precision
@@ -26,7 +29,7 @@ module Abachrome
     def_delegators :@value, :to_i, :zero?, :nonzero?, :finite?
 
     # Initializes a new AbcDecimal object with the specified value and precision.
-    # 
+    #
     # @param value [AbcDecimal, BigDecimal, Rational, #to_s] The numeric value to represent.
     # If an AbcDecimal is provided, its internal value is used.
     # If a BigDecimal or Rational is provided, it's used directly.
@@ -49,11 +52,11 @@ module Abachrome
     end
 
     # Returns a string representation of the decimal value.
-    # 
+    #
     # This method converts the internal value to a String, using a fixed-point
     # notation format. If the internal value is a Rational, it's first converted
     # to a BigDecimal with the configured precision before string conversion.
-    # 
+    #
     # @return [String] The decimal value as a string in fixed-point notation
     def to_s
       if @value.is_a?(Rational)
@@ -64,14 +67,14 @@ module Abachrome
     end
 
     # Converts the decimal value to a floating-point number.
-    # 
+    #
     # @return [Float] the floating-point representation of the AbcDecimal value
     def to_f
       @value.to_f
     end
 
     # Creates a new AbcDecimal from a string representation of a number.
-    # 
+    #
     # @param str [String] The string representation of a number to convert to an AbcDecimal
     # @param precision [Integer] The precision to use for the decimal value (number of significant digits after the decimal point). Defaults to DEFAULT_PRECISION
     # @return [AbcDecimal] A new AbcDecimal instance initialized with the given string value and precision
@@ -80,7 +83,7 @@ module Abachrome
     end
 
     # Creates a new AbcDecimal from a Rational number.
-    # 
+    #
     # @param rational [Rational] The rational number to convert to an AbcDecimal
     # @param precision [Integer] The precision to use for the decimal representation, defaults to DEFAULT_PRECISION
     # @return [AbcDecimal] A new AbcDecimal instance with the value of the given rational number
@@ -89,7 +92,7 @@ module Abachrome
     end
 
     # Creates a new AbcDecimal instance from a float value.
-    # 
+    #
     # @param float [Float] The floating point number to convert to an AbcDecimal
     # @param precision [Integer] The precision to use for the decimal representation (default: DEFAULT_PRECISION)
     # @return [AbcDecimal] A new AbcDecimal instance representing the given float value
@@ -98,7 +101,7 @@ module Abachrome
     end
 
     # Creates a new AbcDecimal from an integer value.
-    # 
+    #
     # @param integer [Integer] The integer value to convert to an AbcDecimal
     # @param precision [Integer] The precision to use for the decimal, defaults to DEFAULT_PRECISION
     # @return [AbcDecimal] A new AbcDecimal instance with the specified integer value and precision
@@ -119,7 +122,7 @@ module Abachrome
     end
 
     # Subtracts another numeric value from this AbcDecimal.
-    # 
+    #
     # @param other [AbcDecimal, Numeric] The value to subtract from this AbcDecimal.
     # @return [AbcDecimal] A new AbcDecimal representing the result of the subtraction.
     def -(other)
@@ -128,14 +131,14 @@ module Abachrome
     end
 
     # Multiplies this AbcDecimal by another value.
-    # 
+    #
     # @param other [Object] The value to multiply by. If not an AbcDecimal, it will be converted to one.
     # @return [AbcDecimal] A new AbcDecimal instance representing the product of this decimal and the other value.
     # @example
     # dec1 = AbcDecimal.new(5)
     # dec2 = AbcDecimal.new(2)
     # result = dec1 * dec2 # => AbcDecimal representing 10
-    # 
+    #
     # # With a non-AbcDecimal value
     # result = dec1 * 3 # => AbcDecimal representing 15
     def *(other)
@@ -144,7 +147,7 @@ module Abachrome
     end
 
     # Divides this decimal by another value.
-    # 
+    #
     # @param other [Numeric, AbcDecimal] The divisor, which can be an AbcDecimal instance or any numeric value
     # @return [AbcDecimal] A new AbcDecimal representing the result of the division
     # @example
@@ -157,7 +160,7 @@ module Abachrome
     end
 
     # Performs modulo operation with another value.
-    # 
+    #
     # @param other [Numeric, AbcDecimal] The divisor for the modulo operation
     # @return [AbcDecimal] A new AbcDecimal containing the remainder after division
     def %(other)
@@ -166,7 +169,7 @@ module Abachrome
     end
 
     # Constrains the value to be between the specified minimum and maximum values.
-    # 
+    #
     # @param min [Numeric, AbcDecimal] The minimum value to clamp to
     # @param max [Numeric, AbcDecimal] The maximum value to clamp to
     # @return [AbcDecimal] A new AbcDecimal within the specified range
@@ -174,14 +177,14 @@ module Abachrome
     # AbcDecimal(5).clamp(0, 10)   # => 5
     # AbcDecimal(15).clamp(0, 10)  # => 10
     # AbcDecimal(-5).clamp(0, 10)  # => 0
-    def clamp(min,max)
-      @value.clamp(AbcDecimal(min),AbcDecimal(max))
+    def clamp(min, max)
+      @value.clamp(AbcDecimal(min), AbcDecimal(max))
     end
 
     # Raises self to the power of another value.
     # This method handles different input types, including Rational values and
     # other AbcDecimal instances.
-    # 
+    #
     # @param other [Numeric, Rational, AbcDecimal] The exponent to raise this value to
     # @return [AbcDecimal] A new AbcDecimal representing self raised to the power of other
     def **(other)
@@ -194,7 +197,7 @@ module Abachrome
     end
 
     # Allows for mixed arithmetic operations between AbcDecimal and other numeric types.
-    # 
+    #
     # @param other [Numeric] The other number to be coerced into an AbcDecimal object
     # @return [Array<AbcDecimal>] A two-element array containing the coerced value and self,
     # allowing Ruby to perform arithmetic operations with mixed types
@@ -205,7 +208,7 @@ module Abachrome
     # Returns a string representation of the decimal value for inspection purposes.
     # This method returns a formatted string that includes the class name and
     # the string representation of the decimal value itself.
-    # 
+    #
     # @return [String] A string in the format "ClassName('value')"
     def inspect
       "#{self.class}('#{self}')"
@@ -213,7 +216,7 @@ module Abachrome
 
     # Compares this decimal value with another value for equality.
     # Attempts to convert the other value to an AbcDecimal if it isn't one already.
-    # 
+    #
     # @param other [Object] The value to compare against this AbcDecimal
     # @return [Boolean] True if the values are equal, false otherwise
     def ==(other)
@@ -222,7 +225,7 @@ module Abachrome
 
     # Compares this AbcDecimal instance with another AbcDecimal or a value that can be
     # converted to an AbcDecimal.
-    # 
+    #
     # @param other [Object] The value to compare with this AbcDecimal.
     # If not an AbcDecimal, it will be converted using AbcDecimal().
     # @return [Integer, nil] Returns -1 if self is less than other,
@@ -234,7 +237,7 @@ module Abachrome
     end
 
     # Compares this decimal with another value.
-    # 
+    #
     # @param other [Object] The value to compare with. Can be an AbcDecimal or any value
     # convertible to AbcDecimal
     # @return [Boolean] true if this decimal is greater than the other value, false otherwise
@@ -243,7 +246,7 @@ module Abachrome
     end
 
     # Compares this decimal value with another value.
-    # 
+    #
     # @param other [Object] The value to compare against. If not an AbcDecimal,
     # it will be converted to one.
     # @return [Boolean] true if this decimal is greater than or equal to the other value,
@@ -253,7 +256,7 @@ module Abachrome
     end
 
     # Compares this decimal with another value.
-    # 
+    #
     # @param other [Object] The value to compare with. Will be coerced to AbcDecimal if not already an instance.
     # @return [Boolean] true if this decimal is less than the other value, false otherwise.
     # @example
@@ -266,7 +269,7 @@ module Abachrome
     end
 
     # Compares this AbcDecimal with another value.
-    # 
+    #
     # @param other [AbcDecimal, Numeric] The value to compare with. If not an AbcDecimal,
     # it will be converted to one.
     # @return [Boolean] true if this AbcDecimal is less than or equal to the other value,
@@ -277,7 +280,7 @@ module Abachrome
 
     # @overload round(*args)
     # Rounds this decimal to a specified precision.
-    # 
+    #
     # @param args [Array] Arguments to be passed to BigDecimal#round. Can include
     # the number of decimal places to round to and the rounding mode.
     # @return [AbcDecimal] A new AbcDecimal instance with the rounded value
@@ -292,9 +295,9 @@ module Abachrome
     end
 
     # Returns the absolute value (magnitude) of the decimal number.
-    # 
+    #
     # Wraps BigDecimal#abs to ensure return values are properly converted to AbcDecimal.
-    # 
+    #
     # @param args [Array] Optional arguments to pass to BigDecimal#abs
     # @return [AbcDecimal] The absolute value of the decimal number
     def abs(*args)
@@ -304,23 +307,27 @@ module Abachrome
     # Returns the square root of the AbcDecimal value.
     # Calculates the square root by using Ruby's built-in Math.sqrt function
     # and converting the result back to an AbcDecimal.
-    # 
+    #
     # @return [AbcDecimal] A new AbcDecimal representing the square root of the value
     def sqrt
       AbcDecimal(Math.sqrt(@value))
     end
 
     # Returns true if the internal value is negative, false otherwise.
-    # 
+    #
     # @return [Boolean] true if the value is negative, false otherwise
     def negative?
       @value.negative?
     end
 
+    def positive?
+      @value > 0
+    end
+
     # Calculates the arctangent of y/x using the signs of the arguments to determine the quadrant.
     # Unlike the standard Math.atan2, this method accepts AbcDecimal objects or any values
     # that can be converted to AbcDecimal.
-    # 
+    #
     # @param y [AbcDecimal, Numeric] The y coordinate
     # @param x [AbcDecimal, Numeric] The x coordinate
     # @return [AbcDecimal] The angle in radians between the positive x-axis and the ray to the point (x,y)
@@ -333,10 +340,10 @@ module Abachrome
 end
 
 # Creates a new AbcDecimal instance.
-# 
+#
 # This is a convenience method that allows creating AbcDecimal objects
 # without explicitly referencing the Abachrome namespace.
-# 
+#
 # @param args [Array] Arguments to pass to the AbcDecimal constructor
 # @return [Abachrome::AbcDecimal] A new AbcDecimal instance
 def AbcDecimal(*args)
@@ -344,7 +351,7 @@ def AbcDecimal(*args)
 end
 
 # Creates a new AbcDecimal instance.
-# 
+#
 # @param args [Array] Arguments to pass to AbcDecimal.new
 # @return [Abachrome::AbcDecimal] A new AbcDecimal instance
 # @example
@@ -354,4 +361,4 @@ def AD(*args)
   Abachrome::AbcDecimal.new(*args)
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::Color - Core color representation class
 #
 # This is the central color class that represents colors across multiple color spaces
@@ -27,7 +29,7 @@ module Abachrome
     attr_reader :color_space, :coordinates, :alpha
 
     # Initializes a new Color object with the specified color space, coordinates, and alpha value.
-    # 
+    #
     # @param color_space [ColorSpace] The color space for this color instance
     # @param coordinates [Array<Numeric, String>] The color coordinates in the specified color space
     # @param alpha [Numeric, String] The alpha (opacity) value, between 0.0 and 1.0 (default: 1.0)
@@ -51,7 +53,7 @@ module Abachrome
     end
 
     # Creates a new Color instance from RGB values
-    # 
+    #
     # @param r [Numeric] The red component value (typically 0-1)
     # @param g [Numeric] The green component value (typically 0-1)
     # @param b [Numeric] The blue component value (typically 0-1)
@@ -63,7 +65,7 @@ module Abachrome
     end
 
     # Creates a new Color instance from LRGB values
-    # 
+    #
     # @param r [Numeric] The red component value (typically 0-1)
     # @param g [Numeric] The green component value (typically 0-1)
     # @param b [Numeric] The blue component value (typically 0-1)
@@ -75,7 +77,7 @@ module Abachrome
     end
 
     # Creates a new Color object with OKLAB values.
-    # 
+    #
     # @param l [Float] The lightness component (L) of the OKLAB color space
     # @param a [Float] The green-red component (a) of the OKLAB color space
     # @param b [Float] The blue-yellow component (b) of the OKLAB color space
@@ -87,7 +89,7 @@ module Abachrome
     end
 
     # Creates a new color instance in the OKLCH color space.
-    # 
+    #
     # @param l [Numeric] The lightness component (L), typically in range 0..1
     # @param c [Numeric] The chroma component (C), typically starting from 0 with no upper bound
     # @param h [Numeric] The hue component (H) in degrees, typically in range 0..360
@@ -98,11 +100,60 @@ module Abachrome
       new(space, [l, c, h], alpha)
     end
 
+    # Creates a new Color instance from YIQ values
+    #
+    # @param y [Numeric] The luma (brightness) component, typically in range 0 to 1
+    # @param i [Numeric] The in-phase component (orange-blue), typically in range -0.5957 to 0.5957
+    # @param q [Numeric] The quadrature component (purple-green), typically in range -0.5226 to 0.5226
+    # @param alpha [Numeric] The alpha (opacity) component value (0-1), defaults to 1.0 (fully opaque)
+    # @return [Abachrome::Color] A new Color instance in the YIQ color space
+    def self.from_yiq(y, i, q, alpha = 1.0)
+      space = ColorSpace.find(:yiq)
+      new(space, [y, i, q], alpha)
+    end
+
+    # Creates a new Color instance from CMYK values
+    #
+    # @param c [Numeric] The cyan component, typically in range 0 to 1
+    # @param m [Numeric] The magenta component, typically in range 0 to 1
+    # @param y [Numeric] The yellow component, typically in range 0 to 1
+    # @param k [Numeric] The key/black component, typically in range 0 to 1
+    # @param alpha [Numeric] The alpha (opacity) component value (0-1), defaults to 1.0 (fully opaque)
+    # @return [Abachrome::Color] A new Color instance in the CMYK color space
+    def self.from_cmyk(c, m, y, k, alpha = 1.0)
+      space = ColorSpace.find(:cmyk)
+      new(space, [c, m, y, k], alpha)
+    end
+
+    # Creates a new Color instance from XYZ values
+    #
+    # @param x [Numeric] The X tristimulus value representing the CIE RGB red primary
+    # @param y [Numeric] The Y tristimulus value representing luminance
+    # @param z [Numeric] The Z tristimulus value representing the CIE RGB blue primary
+    # @param alpha [Numeric] The alpha (opacity) component value (0-1), defaults to 1.0 (fully opaque)
+    # @return [Abachrome::Color] A new Color instance in the XYZ color space
+    def self.from_xyz(x, y, z, alpha = 1.0)
+      space = ColorSpace.find(:xyz)
+      new(space, [x, y, z], alpha)
+    end
+
+    # Creates a new Color instance from LMS values
+    #
+    # @param l [Numeric] The long wavelength (L) cone response component
+    # @param m [Numeric] The medium wavelength (M) cone response component
+    # @param s [Numeric] The short wavelength (S) cone response component
+    # @param alpha [Numeric] The alpha (opacity) component value (0-1), defaults to 1.0 (fully opaque)
+    # @return [Abachrome::Color] A new Color instance in the LMS color space
+    def self.from_lms(l, m, s, alpha = 1.0)
+      space = ColorSpace.find(:lms)
+      new(space, [l, m, s], alpha)
+    end
+
     # Compares this color instance with another for equality.
-    # 
+    #
     # Two colors are considered equal if they have the same color space,
     # coordinates, and alpha value.
-    # 
+    #
     # @param other [Object] The object to compare with
     # @return [Boolean] true if the colors are equal, false otherwise
     def ==(other)
@@ -114,7 +165,7 @@ module Abachrome
     end
 
     # Checks if this color is equal to another color object.
-    # 
+    #
     # @param other [Object] The object to compare with
     # @return [Boolean] true if the two colors are equal, false otherwise
     # @see ==
@@ -126,7 +177,7 @@ module Abachrome
     # based on its color space, coordinates, and alpha value.
     # The method first converts these components to strings,
     # then computes a hash of the resulting array.
-    # 
+    #
     # @return [Integer] a hash code that can be used for equality comparison
     # and as a hash key in Hash objects
     def hash
@@ -168,4 +219,4 @@ module Abachrome
   end
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_mixins/blend.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Abachrome::ColorMixins::Blend - Color blending and mixing functionality
 #
 # This mixin provides methods for blending and mixing colors together in various color spaces.
@@ -58,7 +60,7 @@ module Abachrome
       # Blends this color with another color by the specified amount.
       # This is a destructive version of the blend method, modifying the current
       # color in place.
-      # 
+      #
       # @param other [Abachrome::Color] The color to blend with
       # @param amount [Float] The blend amount, between 0.0 and 1.0, where 0.0 is
       # this color and 1.0 is the other color (default: 0.5)
@@ -72,7 +74,7 @@ module Abachrome
       end
 
       # Alias for the blend method that mixes two colors together.
-      # 
+      #
       # @param other [Abachrome::Color] The color to mix with
       # @param amount [Float] The amount to mix, between 0.0 and 1.0, where 0.0 returns the original color and 1.0 returns the other color (default: 0.5)
       # @return [Abachrome::Color] A new color resulting from the mix of the two colors
@@ -81,10 +83,10 @@ module Abachrome
       end
 
       # Mix the current color with another color.
-      # 
+      #
       # This method is an alias for blend!. It combines the current color with
       # the provided color at the specified amount.
-      # 
+      #
       # @param other [Abachrome::Color] The color to mix with the current color
       # @param amount [Numeric] The amount of the other color to mix in, from 0 to 1 (default: 0.5)
       # @return [self] Returns the modified color object
@@ -95,4 +97,4 @@ module Abachrome
   end
 end
 
-# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.

data/lib/abachrome/color_mixins/harmonies.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+# Abachrome::ColorMixins::Harmonies - Color Harmony Generation Module
+#
+# This module provides methods for generating color harmonies based on color theory.
+# Color harmonies are sets of colors that work well together according to established
+# design principles. The module uses OKLCH color space for hue manipulation, which
+# provides perceptually uniform results.
+#
+# Key features:
+# - Analogous harmony: Colors adjacent on the color wheel (±30°)
+# - Complementary harmony: Colors opposite on the color wheel (180°)
+# - Triadic harmony: Three colors evenly spaced around the color wheel (120° intervals)
+# - Tetradic/Square harmony: Four colors evenly spaced (90° intervals)
+# - Split-complementary harmony: Base color plus two colors adjacent to its complement (150°, 210°)
+# - Option to generate harmonies in different color spaces (HSL or OKLCH)
+#
+# All harmonies preserve the lightness and chroma of the base color while rotating
+# the hue to create harmonious color combinations.
+#
+# References:
+# - Color Theory: https://en.wikipedia.org/wiki/Color_theory
+# - Color Harmony: https://en.wikipedia.org/wiki/Harmony_(color)
+
+module Abachrome
+  module ColorMixins
+    module Harmonies
+      # Generates an analogous color harmony.
+      # Analogous colors are adjacent to each other on the color wheel,
+      # typically within ±30 degrees. This creates a harmonious, cohesive palette.
+      #
+      # @param angle [Numeric] The hue angle offset in degrees (default: 30)
+      # @param space [Symbol] The color space to use for hue manipulation (:hsl or :oklch, default: :oklch)
+      # @return [Array<Abachrome::Color>] An array of three colors: [color at -angle, original, color at +angle]
+      def analogous(angle: 30, space: :oklch)
+        original_space = color_space
+
+        # Convert to the specified space for hue manipulation
+        color_in_space = space == color_space.id ? self : to_color_space(space)
+        l, c, h = color_in_space.coordinates
+
+        # Generate analogous colors by rotating hue
+        color_minus = create_harmony_color(l, c, h - angle, space)
+        color_plus = create_harmony_color(l, c, h + angle, space)
+
+        # Convert back to original color space
+        [
+          color_minus.to_color_space(original_space.id),
+          self,
+          color_plus.to_color_space(original_space.id)
+        ]
+      end
+
+      # Generates a complementary color harmony.
+      # Complementary colors are opposite each other on the color wheel (180° apart).
+      # They create maximum contrast and vibrant combinations.
+      #
+      # @param space [Symbol] The color space to use for hue manipulation (:hsl or :oklch, default: :oklch)
+      # @return [Array<Abachrome::Color>] An array of two colors: [original, complement]
+      def complementary(space: :oklch)
+        original_space = color_space
+
+        # Convert to the specified space for hue manipulation
+        color_in_space = space == color_space.id ? self : to_color_space(space)
+        l, c, h = color_in_space.coordinates
+
+        # Generate complementary color by rotating hue 180°
+        complement = create_harmony_color(l, c, h + 180, space)
+
+        # Convert back to original color space
+        [
+          self,
+          complement.to_color_space(original_space.id)
+        ]
+      end
+
+      # Generates a triadic color harmony.
+      # Triadic colors are evenly spaced around the color wheel at 120° intervals.
+      # They create vibrant, balanced palettes with good contrast.
+      #
+      # @param space [Symbol] The color space to use for hue manipulation (:hsl or :oklch, default: :oklch)
+      # @return [Array<Abachrome::Color>] An array of three colors evenly spaced around the color wheel
+      def triadic(space: :oklch)
+        original_space = color_space
+
+        # Convert to the specified space for hue manipulation
+        color_in_space = space == color_space.id ? self : to_color_space(space)
+        l, c, h = color_in_space.coordinates
+
+        # Generate triadic colors by rotating hue 120° and 240°
+        color_1 = create_harmony_color(l, c, h + 120, space)
+        color_2 = create_harmony_color(l, c, h + 240, space)
+
+        # Convert back to original color space
+        [
+          self,
+          color_1.to_color_space(original_space.id),
+          color_2.to_color_space(original_space.id)
+        ]
+      end
+
+      # Generates a tetradic (square) color harmony.
+      # Tetradic colors are evenly spaced around the color wheel at 90° intervals.
+      # They create rich, varied palettes with multiple complementary pairs.
+      #
+      # @param space [Symbol] The color space to use for hue manipulation (:hsl or :oklch, default: :oklch)
+      # @return [Array<Abachrome::Color>] An array of four colors evenly spaced around the color wheel
+      def tetradic(space: :oklch)
+        original_space = color_space
+
+        # Convert to the specified space for hue manipulation
+        color_in_space = space == color_space.id ? self : to_color_space(space)
+        l, c, h = color_in_space.coordinates
+
+        # Generate tetradic colors by rotating hue 90°, 180°, and 270°
+        color_1 = create_harmony_color(l, c, h + 90, space)
+        color_2 = create_harmony_color(l, c, h + 180, space)
+        color_3 = create_harmony_color(l, c, h + 270, space)
+
+        # Convert back to original color space
+        [
+          self,
+          color_1.to_color_space(original_space.id),
+          color_2.to_color_space(original_space.id),
+          color_3.to_color_space(original_space.id)
+        ]
+      end
+
+      # Generates a split-complementary color harmony.
+      # Split-complementary uses the base color plus two colors adjacent to its complement
+      # (at 150° and 210° from the base). This creates strong visual contrast while being
+      # more subtle than a pure complementary scheme.
+      #
+      # @param space [Symbol] The color space to use for hue manipulation (:hsl or :oklch, default: :oklch)
+      # @return [Array<Abachrome::Color>] An array of three colors: [original, complement-30°, complement+30°]
+      def split_complementary(space: :oklch)
+        original_space = color_space
+
+        # Convert to the specified space for hue manipulation
+        color_in_space = space == color_space.id ? self : to_color_space(space)
+        l, c, h = color_in_space.coordinates
+
+        # Generate split-complementary colors at 150° and 210° (complement ± 30°)
+        color_1 = create_harmony_color(l, c, h + 150, space)
+        color_2 = create_harmony_color(l, c, h + 210, space)
+
+        # Convert back to original color space
+        [
+          self,
+          color_1.to_color_space(original_space.id),
+          color_2.to_color_space(original_space.id)
+        ]
+      end
+
+      private
+
+      # Helper method to create a harmony color with normalized hue
+      #
+      # @param l [AbcDecimal] The lightness value
+      # @param c [AbcDecimal] The chroma value
+      # @param h [Numeric] The hue angle in degrees (will be normalized to 0-360)
+      # @param space [Symbol] The color space (:hsl or :oklch)
+      # @return [Abachrome::Color] A new color in the specified color space
+      def create_harmony_color(l, c, h, space)
+        # Normalize hue to 0-360 range
+        normalized_hue = h % 360
+
+        case space
+        when :oklch
+          Abachrome::Color.from_oklch(l, c, normalized_hue, alpha)
+        when :hsl
+          # For HSL, assuming coordinates are [h, s, l]
+          # Note: HSL hue is first coordinate
+          Abachrome::Color.new(
+            Abachrome::ColorSpace.find(:hsl),
+            [normalized_hue, c, l],
+            alpha
+          )
+        else
+          raise ArgumentError, "Unsupported color space for harmonies: #{space}. Use :oklch or :hsl"
+        end
+      end
+    end
+  end
+end
+
+# Copyright (c) 2025 Durable Programming, LLC. All rights reserved.