abachrome 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99a27f5afff0a908be9991f71c1a96ead0f226b7d0a4308e1227912e508afa82
-  data.tar.gz: 861c7bc3b6a13cdb869d986a6b6fadd17369a960cab52c0e7a930dc019e052e5
+  metadata.gz: fb85b148dce0bd2caf5ee135348d4b3733123ba4e139aad387c20071e9a3fb0d
+  data.tar.gz: 9f2f1fab202ceaa5f448b49c44fb5d6d8ecd91fbb9998878aa0f397f5a228745
 SHA512:
-  metadata.gz: a050c327bb501c5cd4da1855cc62b4894241eabed1869317c5d326a82d1a556c8298d5ef063d97be2b8d3f1aa9f456293f34f00926b0c9e749ef24b72c5e383b
-  data.tar.gz: 217f2987d6df4251fb6c8a211c59c1b1f4bdb66f3107e62ed755a9b05e794d5f0c14da9653175b90a25728ade13dceb1411082f123713dca57aa0e809ed4c0f3
+  metadata.gz: 71ff411b276fc51c075d15c19d88db9b177850b194c55dab03b053f17d0c77d32de63ef1e5d4f2d3fb01a7873efcc22f7055307b2b44a72c6e4089a91c924cda
+  data.tar.gz: 7744046e683c0bff375b03888917c74b98a6a62d9dba24c52c6c9b7c39a5f450c07e6eb1dbc510f11c3e2378a67b5fc3fe1252d5da716c25ef75463c20950e12

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.1.3] - 2025-10-12
+
+- Enhanced color parsing with support for additional CSS formats
+- Improved documentation with comprehensive user guides
+- Added LICENSE file for compliance
+- Security contact information added to README
+
 ## [0.1.0] - 2025-02-09
 
-- Initial release
+- Initial release with core color manipulation functionality
+- Support for RGB, OKLAB, OKLCH color spaces
+- Basic color conversion and gamut mapping
+- CSS color output formatting
+- High-precision calculations using BigDecimal

data/CLA.md

@@ -0,0 +1,45 @@
+# Contributor License Agreement
+
+This Contributor License Agreement ("Agreement") is entered into between the undersigned contributor ("Contributor") and Durable Programming, LLC ("Company").
+
+## Recitals
+
+WHEREAS, Contributor desires to contribute to the abachrome project ("Project");
+
+WHEREAS, Company desires to receive contributions to the Project;
+
+NOW, THEREFORE, in consideration of the mutual promises contained herein, the parties agree as follows:
+
+## Grant of Copyright
+
+Contributor hereby assigns to Company all right, title, and interest in and to the copyright in the contributions made by Contributor to the Project, including all modifications, enhancements, and derivative works thereof.
+
+## Scope
+
+This Agreement applies to all contributions made by Contributor to the Project, whether made before or after the date of this Agreement.
+
+## Representations and Warranties
+
+Contributor represents and warrants that:
+
+1. Contributor has the right to enter into this Agreement and to grant the rights granted herein.
+
+2. The contributions are original works of Contributor and do not infringe any third-party rights.
+
+3. Contributor has not assigned or licensed the contributions to any other party.
+
+## Governing Law
+
+This Agreement shall be governed by the laws of the State of Delaware, without regard to conflict of laws principles.
+
+## Entire Agreement
+
+This Agreement constitutes the entire agreement between the parties and supersedes all prior agreements.
+
+IN WITNESS WHEREOF, the parties have executed this Agreement as of the date first above written.
+
+Contributor: ___________________________ Date: __________
+
+Company: Durable Programming, LLC
+
+By: ___________________________ Date: __________

data/CODE-OF-CONDUCT.md

@@ -0,0 +1,9 @@
+# Code of Conduct
+
+This document provides community guidelines for a safe, respectful, productive, and collaborative place for any person who is willing to contribute to the Abachrome community. It applies to all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.).
+
+- Participants will be tolerant of opposing views.
+- Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
+- When interpreting the words and actions of others, participants should always assume good intentions.
+- Behaviour which can be reasonably considered harassment will not be tolerated.
+

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2023 Durable Programming
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,5 +1,15 @@
 # Abachrome
 
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Ruby](https://img.shields.io/badge/ruby-3.0+-red.svg)](https://www.ruby-lang.org/en/)
+[![Gem Version](https://badge.fury.io/rb/abachrome.svg)](https://badge.fury.io/rb/abachrome)
+[![Downloads](https://img.shields.io/gem/dt/abachrome)](https://rubygems.org/gems/abachrome)
+[![GitHub repo size](https://img.shields.io/github/repo-size/durableprogramming/abachrome)](https://github.com/durableprogramming/abachrome)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
+[![RuboCop](https://img.shields.io/badge/code_style-rubocop-orange.svg)](https://github.com/rubocop/rubocop)
+[![Maturity Level](https://img.shields.io/badge/Maturity-Level%202%20--%20First%20Release-yellowgreen.svg)](https://github.com/tophat/getting-started/blob/master/scorecard.md)
+[![Website](https://img.shields.io/website-up-down-green-red/http/durableprogramming.com.svg)](https://durableprogramming.com)
+
 Abachrome is a Ruby gem for parsing, manipulating, and managing colors. It provides a robust set of tools for working with various color formats including hex, RGB, HSL, and named colors.
 
 ![Abachrome Logo](logo.png)
@@ -67,20 +77,112 @@ color = Abachrome.from_rgb(1.2, -0.1, 0.5)
 mapped_color = srgb_gamut.map(color.coordinates)    # Map color to gamut
 ```
 
+### Parsing Colors
+
+Abachrome supports parsing colors from various string formats using the CSS parser:
+
+```ruby
+# Hex colors
+color = Abachrome::Parsers::CSS.parse('#ff0000')
+color = Abachrome::Parsers::CSS.parse('#f00')     # Short hex
+
+# RGB and HSL strings
+color = Abachrome::Parsers::CSS.parse('rgb(255, 0, 0)')
+color = Abachrome::Parsers::CSS.parse('rgba(255, 0, 0, 0.5)')
+color = Abachrome::Parsers::CSS.parse('hsl(0, 100%, 50%)')
+
+# Named colors
+color = Abachrome::Parsers::CSS.parse('red')
+
+# Advanced formats
+color = Abachrome::Parsers::CSS.parse('oklab(0.5 0.2 -0.1)')
+color = Abachrome::Parsers::CSS.parse('oklch(0.5 0.2 120)')
+```
+
+### Color Manipulation
+
+Abachrome provides methods for blending and adjusting colors:
+
+```ruby
+color1 = Abachrome.from_rgb(1.0, 0.0, 0.0)
+color2 = Abachrome.from_rgb(0.0, 1.0, 0.0)
+
+# Blend two colors
+blended = color1.blend(color2, 0.5)  # 50% blend
+
+# Adjust lightness
+lighter = color1.lighten(0.2)        # Lighten by 20%
+```
+
+### Working with Palettes
+
+Create and manipulate color palettes:
+
+```ruby
+palette = Abachrome::Palette.new([color1, color2])
+
+# Interpolate between colors
+interpolated = palette.interpolate(steps: 5)  # Add 5 interpolated colors between each pair
+```
+
+### Advanced Gamut Mapping
+
+Map colors to different color gamuts for accurate display:
+
+```ruby
+srgb_gamut = Abachrome::Gamut::SRGB.new
+p3_gamut = Abachrome::Gamut::P3.new
+
+out_of_gamut = Abachrome.from_rgb(1.2, -0.1, 0.5)
+mapped_srgb = srgb_gamut.map(out_of_gamut.coordinates)
+mapped_p3 = p3_gamut.map(out_of_gamut.coordinates)
+```
+
 ## Features
 
-- Support for multiple color spaces (RGB, HSL, Lab, Oklab)
-- Color space conversion
-- Gamut mapping
-- CSS color parsing and formatting
+- Support for multiple color spaces (RGB, HSL, Lab, Oklab, OKLCH, XYZ, LMS)
+- Color space conversion between all supported spaces
+- Advanced gamut mapping for sRGB, P3, and Rec.2020
+- Comprehensive CSS color parsing and formatting
 - Support for CSS named colors
+- Color blending and lightness adjustments
+- Palette creation and interpolation
 - High-precision color calculations using BigDecimal
-- Alpha channel support
+- Alpha channel support throughout all operations
 
 ## Requirements
 
 - Ruby >= 3.0.0
 
+## Dependencies
+
+Abachrome has minimal dependencies to maintain performance and compatibility:
+
+### Runtime Dependencies
+- **dry-inflector** (~> 1.0): Provides utilities for dynamic class loading and color space management
+
+### Development Dependencies
+- Testing framework (minitest)
+- Code quality tools (rubocop)
+
+### Dependency Management
+Dependencies are specified in `abachrome.gemspec` and managed via Bundler.
+
+To check for dependency updates:
+```bash
+bundle outdated
+```
+
+To update dependencies:
+```bash
+bundle update
+```
+
+All dependencies are selected based on:
+- Active maintenance and community support
+- Minimal footprint and performance impact
+- Compatibility with Ruby 3.0+ requirements
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
@@ -91,9 +193,113 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`.
 
+### Testing
+
+Tests are run automatically in CI/CD pipelines for all pull requests and pushes to the main branch. The test suite includes:
+
+- Unit tests for all color models and converters
+- Integration tests for parsing and output functionality
+- Performance benchmarks for critical operations
+
+To run tests locally:
+```bash
+rake test
+```
+
+Tests must pass before any changes can be merged to the main branch.
+
+### Testing Policy
+
+- **All changes**: Must not break existing tests
+- **New features**: Must include comprehensive unit tests
+- **Bug fixes**: Must include regression tests
+- **Major changes**: Require code review and may need additional integration tests
+- **Performance changes**: Must include benchmark comparisons
+
+All pull requests require tests to pass CI checks before merging.
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/durableprogramming/abachrome.
+We welcome contributions from the community! Here's how you can help:
+
+### Reporting Issues
+
+Please use GitHub issues to report bugs or request features.
+
+### Contributing Code
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Make your changes
+4. Ensure tests pass (`rake test`)
+5. Follow the code style (run `rubocop` if available)
+6. Commit your changes
+7. Push to your fork
+8. Open a pull request
+
+### Code Style
+
+- Follow Ruby style guidelines
+- Use meaningful variable and method names
+- Add tests for new functionality
+- Update documentation as needed
+
+### Testing
+
+All contributions must include appropriate tests. Run the test suite with `rake test`.
+
+### Developer Certificate of Origin
+
+By contributing to this project, you agree to the Developer Certificate of Origin (DCO). To certify your contribution, add a sign-off to your commits:
+
+```
+git commit -s -m "Your commit message"
+```
+
+This adds `Signed-off-by: Your Name <your.email@example.com>` to certify that you have the right to submit the work.
+
+## Reporting Defects
+
+To report bugs or defects, please use GitHub issues at https://github.com/durableprogramming/abachrome/issues. Provide as much detail as possible, including:
+
+- Steps to reproduce the issue
+- Expected behavior
+- Actual behavior
+- Ruby version and gem version
+- Any relevant code snippets
+
+## Security
+
+For security-related issues, please contact us directly at commercial@durableprogramming.com instead of using public issues.
+
+We take security seriously and will respond to vulnerability reports within 48 hours.
+
+## Governance
+
+### Project Members
+- **Durable Programming**: Lead developer and maintainer (commercial@durableprogramming.com)
+
+### Roles and Responsibilities
+- **Maintainer**: Responsible for code reviews, releases, and overall project direction
+- **Security Contact**: Handles security vulnerability reports and coordinates responses
+
+### Sensitive Resources
+Access to the following resources is limited to project maintainers:
+- GitHub repository (push access)
+- RubyGems publishing credentials
+- CI/CD pipeline configurations
+
+### Contributor Permissions Policy
+
+Before granting elevated permissions (write access, maintainer status):
+
+1. **Review Process**: Contributors must demonstrate consistent quality contributions over at least 3 months
+2. **Code Quality**: All contributions must follow project standards and pass CI checks
+3. **Security Review**: Security-related contributions receive additional scrutiny
+4. **Community Engagement**: Active participation in issue discussions and reviews
+5. **Maintainer Approval**: Final decision by existing maintainers via consensus
+
+New contributors start with read-only access and issue reporting. Permissions are escalated gradually based on demonstrated responsibility.
 
 # Acknowledgement
 

data/Rakefile

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
-require "rake/testtask"
+require "minitest/test_task"
 
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb", 'test/**/test_*.rb']
+Minitest::TestTask.create do |t|
+
+  t.test_prelude = %(require "simplecov"; SimpleCov.start { add_filter %p }) % ['/test/']
+  t.test_globs = FileList["test/**/*_test.rb", 'test/**/test_*.rb']
+  t.framework = %(require "test/test_helper.rb")
 end
 
+
 task default: :test
+

data/SECURITY.md

@@ -0,0 +1,94 @@
+# Security Policy
+
+## Reporting Vulnerabilities
+
+If you discover a security vulnerability in Abachrome, please report it to us as follows:
+
+### Contact
+Email: security@durableprogramming.com
+
+### Response Time
+We will acknowledge receipt of your report within 72 hours and provide a more detailed response within 7 days indicating our next steps.
+
+### Disclosure
+We ask that you do not publicly disclose the vulnerability until we have had a chance to address it. We will work with you to determine an appropriate disclosure timeline.
+
+## Vulnerability Management
+
+### Classification
+Vulnerabilities are classified as:
+- **Critical**: Immediate threat to user data or system security
+- **High**: Significant security risk
+- **Medium**: Moderate security concern
+- **Low**: Minor security issue
+
+### Remediation Timeline
+- **Critical**: Within 48 hours
+- **High**: Within 7 days
+- **Medium**: Within 30 days
+- **Low**: Within 90 days
+
+### Process
+1. Report received and acknowledged
+2. Assessment and classification
+3. Development of fix
+4. Testing and validation
+5. Release of patched version
+6. Public disclosure (if applicable)
+
+## Automated Security Scanning
+
+### SCA (Software Composition Analysis)
+- **Tool**: bundle-audit
+- **Frequency**: Run on all CI builds and weekly scheduled scans
+- **Threshold**: All vulnerabilities must be addressed before release
+- **Policy**: Critical and High severity vulnerabilities must be fixed immediately. Medium severity within 30 days. Low severity tracked but may be accepted with risk assessment.
+
+### SAST (Static Application Security Testing)
+- **Tool**: Brakeman
+- **Frequency**: Run on all CI builds
+- **Threshold**: All warnings must be reviewed. High-confidence findings must be fixed. False positives documented.
+- **Policy**: Security findings block releases. Code review required for waivers.
+
+### Dependency Updates
+- **Process**: Automated PRs for patch updates. Manual review for minor/major updates.
+- **Testing**: Full test suite run on dependency updates.
+- **Rollback**: Ability to rollback if issues discovered post-update.
+
+## Security Updates
+Security updates will be released as patch versions with descriptive changelogs. Subscribe to releases on GitHub to stay informed.
+
+## Verifying Releases
+
+To ensure the integrity and authenticity of Abachrome releases:
+
+1. **Checksum Verification**: Each release includes SHA256 checksums for all assets. Download the checksum file and verify using:
+   ```
+   sha256sum -c abachrome-<version>.gem.sha256
+   ```
+
+2. **Signature Verification** (future): Releases will be signed with GPG. Verify using:
+   ```
+   gpg --verify abachrome-<version>.gem.asc abachrome-<version>.gem
+   ```
+
+3. **Source Verification**: Always build from the official GitHub repository source.
+
+## Support and Maintenance
+
+### Support Scope
+Abachrome provides support for:
+- Current stable Ruby versions (3.0+)
+- Reported security vulnerabilities
+- Critical bugs affecting core functionality
+
+### Support Duration
+- **Active Support**: Latest major version receives full support
+- **Security Support**: Versions receive security updates for 1 year after release
+- **End of Life**: Versions without security support are documented in release notes
+
+### Security Update Policy
+Security updates are provided for the current major version and the previous major version for up to 1 year after the new major version's release. Older versions may receive critical security fixes at our discretion.
+
+## Current Known Vulnerabilities
+None at this time.

data/abachrome.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "lib/abachrome/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "abachrome"
+  spec.version = Abachrome::VERSION
+  spec.authors = ["Durable Programming"]
+  spec.email = ["commercial@durableprogramming.com"]
+
+  spec.summary = "A Ruby gem for parsing, manipulating, and managing colors"
+  spec.description = "Abachrome provides a robust set of tools for working with various color formats including hex, RGB, HSL, and named colors. Features support for multiple color spaces (RGB, HSL, Lab, Oklab), color space conversion, gamut mapping, CSS color parsing and formatting, and high-precision color calculations using BigDecimal."
+  spec.homepage = "https://github.com/durableprogramming/abachrome"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.0.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = "https://github.com/durableprogramming/abachrome"
+  spec.metadata["changelog_uri"] = "https://github.com/durableprogramming/abachrome/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+
+  # Runtime dependencies
+  spec.add_dependency "dry-inflector", "~> 1.0"
+
+end
+

data/devenv.lock

@@ -3,10 +3,10 @@
     "devenv": {
       "locked": {
         "dir": "src/modules",
-        "lastModified": 1749202057,
+        "lastModified": 1760162706,
         "owner": "cachix",
         "repo": "devenv",
-        "rev": "1c28c31f09f8a5ab134e1943b29b9d2f302cfbcd",
+        "rev": "0d5ad578728fe4bce66eb4398b8b1e66deceb4e4",
         "type": "github"
       },
       "original": {
@@ -72,10 +72,10 @@
         ]
       },
       "locked": {
-        "lastModified": 1747372754,
+        "lastModified": 1759523803,
         "owner": "cachix",
         "repo": "git-hooks.nix",
-        "rev": "80479b6ec16fefd9c1db3ea13aeb038c60530f46",
+        "rev": "cfc9f7bb163ad8542029d303e599c0f7eee09835",
         "type": "github"
       },
       "original": {
@@ -106,10 +106,10 @@
     },
     "nixpkgs": {
       "locked": {
-        "lastModified": 1746807397,
+        "lastModified": 1758532697,
         "owner": "cachix",
         "repo": "devenv-nixpkgs",
-        "rev": "c5208b594838ea8e6cca5997fbf784b7cca1ca90",
+        "rev": "207a4cb0e1253c7658c6736becc6eb9cace1f25f",
         "type": "github"
       },
       "original": {
@@ -128,10 +128,10 @@
         ]
       },
       "locked": {
-        "lastModified": 1747288354,
+        "lastModified": 1759902829,
         "owner": "bobvanderlinden",
         "repo": "nixpkgs-ruby",
-        "rev": "5d7598f3059fff0cbd0dc4756f9d87f8cb7f3f7c",
+        "rev": "5fba6c022a63f1e76dee4da71edddad8959f088a",
         "type": "github"
       },
       "original": {

data/lib/abachrome/abc_decimal.rb

@@ -23,7 +23,7 @@ module Abachrome
 
     attr_accessor :value, :precision
 
-    def_delegators :@value, :to_i, :zero?, :nonzero?
+    def_delegators :@value, :to_i, :zero?, :nonzero?, :finite?
 
     # Initializes a new AbcDecimal object with the specified value and precision.
     # 
@@ -352,4 +352,4 @@ end
 # AD("2.718") # => #<Abachrome::AbcDecimal:0x... @value=2.718>
 def AD(*args)
   Abachrome::AbcDecimal.new(*args)
-end
+end

data/lib/abachrome/color.rb

@@ -62,6 +62,18 @@ module Abachrome
       new(space, [r, g, b], a)
     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)
+    # @param a [Numeric] The alpha (opacity) component value (0-1), defaults to 1.0 (fully opaque)
+    # @return [Abachrome::Color] A new Color instance in the sRGB color space
+    def self.from_lrgb(r, g, b, a = 1.0)
+      space = ColorSpace.find(:lrgb)
+      new(space, [r, g, b], a)
+    end
+
     # Creates a new Color object with OKLAB values.
     # 
     # @param l [Float] The lightness component (L) of the OKLAB color space
@@ -146,4 +158,4 @@ module Abachrome
             "Expected #{color_space.coordinates.size} coordinates for #{color_space.name}, got #{coordinates.size}"
     end
   end
-end
+end

data/lib/abachrome/color_models/lms.rb

@@ -0,0 +1,34 @@
+# Abachrome::ColorModels::Lms - LMS color space model definition
+#
+# This module defines the LMS color model within the Abachrome color manipulation library.
+# LMS represents the response of the three types of cone cells in the human eye (Long, Medium, Short)
+# and serves as an intermediate color space in the OKLAB transformation pipeline. The LMS color space
+# provides a foundation for perceptually uniform color representations by modeling human visual perception
+# at the photoreceptor level.
+#
+# Key features:
+# - Registers the LMS color space with coordinate names [l, m, s]
+# - Represents cone cell responses for Long, Medium, and Short wavelength sensitivity
+# - Serves as intermediate color space for OKLAB and linear RGB conversions
+# - Uses normalized values for consistency with other color models in the library
+# - Maintains high precision through AbcDecimal arithmetic for color transformations
+# - Provides validation for LMS coordinate ranges to ensure valid color representations
+#
+# The LMS model is particularly important in the color science pipeline as it bridges the gap
+# between linear RGB representations and perceptually uniform color spaces like OKLAB, enabling
+# accurate color transformations that better match human visual perception characteristics.
+
+module Abachrome
+  module ColorModels
+    class Lms
+    end
+  end
+end
+
+ColorSpace.register(
+  :lms,
+  "LMS",
+  %w[l m s],
+  nil,
+  []
+)

data/lib/abachrome/color_models/xyz.rb

@@ -0,0 +1,28 @@
+# Abachrome::ColorModels::Xyz - XYZ color space model definition
+#
+# This module defines the XYZ color model within the Abachrome color manipulation library.
+# XYZ is the CIE 1931 color space that forms the basis for most other color space definitions
+# and serves as a device-independent reference color space. The XYZ color space represents
+# colors using tristimulus values that correspond to the response of the human visual system
+# to light stimuli, making it fundamental to color science and accurate color reproduction.
+#
+# Key features:
+# - Registers the XYZ color space with coordinate names [x, y, z]
+# - Represents tristimulus values for device-independent color specification
+# - Serves as intermediate color space for conversions between different color models
+# - Uses normalized values for consistency with other color models in the library
+# - Maintains high precision through AbcDecimal arithmetic for color transformations
+# - Provides validation for XYZ coordinate ranges to ensure valid color representations
+#
+# The XYZ model is particularly important in the color science pipeline as it provides
+# a standardized reference for color matching and serves as the foundation for defining
+# other color spaces like LAB, making it essential for accurate color transformations
+# that maintain consistency across different devices and viewing conditions.
+
+module Abachrome
+  module ColorModels
+    class Xyz
+    end
+  end
+end
+