abachrome-float 0.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b60f07aeb2dcb4db6f2c95e76a491996a4dc205d8b444d4576cad57f1cac6a5f
+  data.tar.gz: 95f3bffe2123ad4822630e57290694c581bae13b1980f1b8d36f1ad273c958e8
+SHA512:
+  metadata.gz: 276d7d23e132c01463f2a17802bd645ac2764634b7b756e421de98c0c42409c6eac3bcd693c4da84ef865b43b01ca1ac47bafe7e3fca6c4923420cf014b207d7
+  data.tar.gz: 546090227f1340344b14815c53573bf779f962251515a61480f90a2a4bd5bc860ba65f05330f02d2577876f17ae6a7471d9003c7d19d5fc18d18c5374db476e1

data/.envrc

@@ -0,0 +1,3 @@
+source_url "https://raw.githubusercontent.com/cachix/devenv/95f329d49a8a5289d31e0982652f7058a189bfca/direnvrc" "sha256-d+8cBpDfDBj41inrADaJt+bDWhOktwslgoP5YiGJ1v0="
+
+use devenv

data/.rubocop.yml

@@ -0,0 +1,10 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.0
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+

data/CHANGELOG.md

@@ -0,0 +1,21 @@
+## [Unreleased]
+
+## [0.1.4] - 2025-10-12
+
+- Added `Color#to_hex` method for convenient hex string output
+- Added `Abachrome.parse` method for parsing CSS color strings
+
+## [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 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

@@ -0,0 +1,315 @@
+# 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)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'abachrome'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install abachrome
+```
+
+## Usage
+
+### Basic Color Creation
+
+```ruby
+# Create colors in different ways
+color = Abachrome.from_rgb(1.0, 0.0, 0.0)           # Red using RGB values
+color = Abachrome.from_hex('#FF0000')               # Red using hex
+color = Abachrome.from_name('red')                  # Red using CSS color name
+
+# Create color with alpha
+color = Abachrome.from_rgb(1.0, 0.0, 0.0, 0.5)     # Semi-transparent red
+```
+
+### Color Space Conversion
+
+```ruby
+# Convert between color spaces
+rgb_color = Abachrome.from_rgb(1.0, 0.0, 0.0)
+oklab_color = rgb_color.to_oklab                    # Convert to Oklab
+rgb_again = oklab_color.to_rgb                      # Convert back to RGB
+```
+
+### Color Output Formats
+
+```ruby
+color = Abachrome.from_rgb(1.0, 0.0, 0.0)
+
+# Different output formats
+color.rgb_hex                                       # => "#ff0000"
+Abachrome::Outputs::CSS.format(color)              # => "#ff0000"
+Abachrome::Outputs::CSS.format_rgb(color)          # => "rgb(255, 0, 0)"
+```
+
+### Working with Color Gamuts
+
+```ruby
+# Check if color is within gamut
+srgb_gamut = Abachrome::Gamut::SRGB.new
+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, 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 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).
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests.
+
+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
+
+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
+
+We'd like to thank the excellent Color.js and culori color libraries, which helped inspire this project and
+inform its design.
+
+# Commercial Support
+
+Commercial support for this tool is available from Durable Programming, LLC. You can find out more at [durableprogramming.com](https://durableprogramming.com/) or via email at [commercial@durableprogramming.com](mailto:commercial@durableprogramming.com).
+
+# Copyright
+
+Copyright 2025, Durable Programming LLC. All rights reserved.

data/Rakefile

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+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-float.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "lib/abachrome/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "abachrome-float"
+  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 native float-based color calculations."
+  spec.homepage = "https://github.com/durableprogramming/abachrome-float"
+  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-float"
+  spec.metadata["changelog_uri"] = "https://github.com/durableprogramming/abachrome-float/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
+