ktsu.Semantics.Color 2.7.3

Prefix Reserved

There is a newer version of this package available.
See the version list below for details.

dotnet add package ktsu.Semantics.Color --version 2.7.3

NuGet\Install-Package ktsu.Semantics.Color -Version 2.7.3

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="ktsu.Semantics.Color" Version="2.7.3" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="ktsu.Semantics.Color" Version="2.7.3" />
                    

                            Directory.Packages.props

<PackageReference Include="ktsu.Semantics.Color" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add ktsu.Semantics.Color --version 2.7.3

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: ktsu.Semantics.Color, 2.7.3"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package ktsu.Semantics.Color@2.7.3

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=ktsu.Semantics.Color&version=2.7.3
                    

                            Install as a Cake Addin

#tool nuget:?package=ktsu.Semantics.Color&version=2.7.3
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ktsu.Semantics.Color

A physically-grounded color type with linear-RGB math, perceptual Oklab operations, and built-in WCAG accessibility checks.

ktsu.Semantics.Color is one package in the ktsu.Semantics family. Start at the root README for the family overview.

Introduction

ktsu.Semantics.Color treats color the way rendering and color science do: the canonical Color type stores linear (non gamma-encoded) RGB plus straight alpha, each channel in 0..1, and all math happens in linear space. Gamma-encoded sRGB is a separate type (Srgb) that you cross into only when you convert. That distinction is the difference between correct blending, mixing, and luminance and the subtly-wrong results you get from doing arithmetic on gamma-encoded values.

On top of that foundation the package adds perceptual operations in the Oklab color space, hex and byte interop, System.Numerics vector output, and WCAG contrast tooling that can rate a color pair and automatically nudge a color until it meets a target conformance level.

Features

Linear RGB as the hub: Color stores linear RGBA in 0..1, and all mixing, interpolation, and luminance math happens there.
Color spaces: sRGB (Srgb), HSL (Hsl), HSV (Hsv), Oklab (Oklab), and Oklch (Oklch). Every color type (including Color) converts directly to and from every other through From* / To* methods. Each hop is routed through the nearest shared hub, so a conversion crosses the gamma boundary at most once and never takes a redundant gamma round-trip.
Interop: hex parse and format (#RGB, #RRGGBB, #RRGGBBAA), 8-bit byte tuples, and linear or sRGB Vector3 / Vector4 output (the sRGB vectors are what ImGui expects).
WCAG accessibility: relative luminance, contrast ratio (1..21), conformance rating against a background, and AdjustForContrast which binary-searches Oklab lightness to hit a target while preserving hue and chroma.
Perceptual operations: Oklab distance (DistanceTo), perceptually uniform mixing (MixOklab), and Oklab gradients (Gradient), alongside plain linear Lerp.
Adjustments: lighten/darken, saturate/desaturate, hue offset, grayscale, and invert. HSL-based on Color, Hsl, and Srgb; perceptually-uniform (lightness/chroma) variants on Oklch.
Named colors: a CSS/X11 subset with case-insensitive lookup.

Installation

Package Manager Console

Install-Package ktsu.Semantics.Color

.NET CLI

dotnet add package ktsu.Semantics.Color

Package Reference

<PackageReference Include="ktsu.Semantics.Color" Version="x.y.z" />

Usage Examples

Basic Example: accessible text color

using ktsu.Semantics.Color;

Color text = Color.FromHex("#777777");
Color background = NamedColors.White;

double ratio = text.ContrastRatio(background);                        // ~4.48
AccessibilityLevel level = text.AccessibilityLevelAgainst(background); // Fail for AA body text

if (level < AccessibilityLevel.AA)
{
    // darkens or lightens in Oklab, preserving hue and chroma, until AA is met
    text = text.AdjustForContrast(background, AccessibilityLevel.AA);
}

Console.WriteLine(text.ToHex());

Perceptually uniform gradients

using ktsu.Semantics.Color;

Color start = Color.FromSrgb(0.9, 0.1, 0.2);   // sRGB input, stored as linear
Color end = NamedColors.Blue;

// Oklab interpolation, inclusive of both endpoints; steps must be >= 2
IReadOnlyList<Color> ramp = start.Gradient(end, 5);

foreach (Color c in ramp)
{
    (byte r, byte g, byte b, byte a) = c.ToBytes();
    Console.WriteLine($"{c.ToHex()}  rgba({r},{g},{b},{a})");
}

Space conversions and vector interop

using System.Numerics;
using ktsu.Semantics.Color;

Color c = NamedColors.Orange;

Hsl hsl = c.ToHsl();                                            // H in degrees, S/L in 0..1
Color complementary = Color.FromHsl(hsl with { H = (hsl.H + 180) % 360 });

Oklch lch = c.ToOklch();                                        // perceptual lightness/chroma/hue
Color brighter = Color.FromOklch(lch with { L = lch.L + 0.1 });

Vector4 imguiColor = complementary.ToSrgbVector4();             // gamma-encoded RGBA for ImGui

Conversions are not limited to Color. Any color type converts straight to any other, so you can stay in whichever space fits the task:

using ktsu.Semantics.Color;

Hsl hsl = Color.FromHex("#3366CC").ToHsl();

Oklab lab = hsl.ToOklab();          // sRGB family -> perceptual family, through linear Color
Hsv hsv = lab.ToHsv();              // and back again
Srgb srgb = Oklch.FromHsl(hsl).ToSrgb();
Color linear = hsl.ToColor();       // every satellite also has ToColor() / FromColor()

Adjusting colors

using ktsu.Semantics.Color;

Color c = Color.FromHex("#3366CC");

Color hover = c.LightenBy(0.1);          // HSL lightness, alpha preserved
Color muted = c.DesaturateBy(0.3);       // HSL saturation
Color accent = c.OffsetHue(30);          // rotate hue 30 degrees
Color negative = c.Invert();             // per-channel negative in sRGB

// For perceptually-uniform tinting, adjust in Oklch instead of HSL
Color perceptualHover = c.ToOklch().LightenBy(0.1).ToColor(c.A);

API Reference

`Color`

The canonical color: linear RGBA, each channel double in 0..1. A readonly record struct with positional properties R, G, B, A.

Construction and conversion

Name	Return Type	Description
`FromLinear(r, g, b, a = 1)`	`Color`	From linear RGBA.
`FromSrgb(r, g, b, a = 1)` / `FromSrgb(Srgb, a = 1)`	`Color`	From gamma-encoded sRGB.
`FromBytes(r, g, b, a = 255)`	`Color`	From 8-bit channels.
`FromHex(string)`	`Color`	Parse `#RGB`, `#RRGGBB`, or `#RRGGBBAA` (the `#` is optional).
`FromOklab` / `FromOklch` / `FromHsl` / `FromHsv`	`Color`	From the named space.
`ToSrgb()` / `ToOklab()` / `ToOklch()` / `ToHsl()` / `ToHsv()`	space type	Convert out.
`ToHex()`	`string`	`#RRGGBB`, or `#RRGGBBAA` when alpha is not full.
`ToBytes()`	`(byte, byte, byte, byte)`	Rounded 8-bit RGBA.
`ToLinearVector3/4()` / `ToSrgbVector3/4()`	`Vector3` / `Vector4`	`System.Numerics` interop.
`WithAlpha(a)` / `Clamp()`	`Color`	Copy helpers.

Operations

Name	Return Type	Description
`RelativeLuminance`	`double`	WCAG luminance.
`ContrastRatio(other)`	`double`	WCAG ratio, 1..21.
`AccessibilityLevelAgainst(background, largeText = false)`	`AccessibilityLevel`	Conformance rating.
`AdjustForContrast(background, target, largeText = false)`	`Color`	Nudge lightness to meet a target level.
`DistanceTo(other)`	`double`	Perceptual Oklab distance.
`MixOklab(other, t)`	`Color`	Perceptually uniform mix (`t = 0` returns this, `t = 1` returns other).
`Lerp(other, t)`	`Color`	Linear-RGB interpolation.
`Gradient(to, steps)`	`IReadOnlyList<Color>`	Oklab gradient, inclusive of endpoints (`steps >= 2`).

Adjustments

Convenience adjustments on Color operate in HSL and preserve alpha; for perceptually-uniform lightness and chroma use the Oklch equivalents via ToOklch(). All are also available natively on Hsl (returning Hsl) and Srgb (returning Srgb).

Name	Return Type	Description
`WithSaturation(s)` / `SaturateBy(a)` / `DesaturateBy(a)` / `MultiplySaturation(f)`	`Color`	Set or shift HSL saturation (clamped to 0..1).
`WithLightness(l)` / `LightenBy(a)` / `DarkenBy(a)` / `MultiplyLightness(f)`	`Color`	Set or shift HSL lightness (clamped to 0..1).
`OffsetHue(degrees)`	`Color`	Rotate hue around the wheel (wraps at 360).
`ToGrayscale()`	`Color`	Drop saturation, keeping lightness.
`Invert()`	`Color`	Per-channel negative, computed in gamma-encoded sRGB.

Supporting types

Type	Description	Base conversion
`Srgb`	Gamma-encoded sRGB, the only gamma-boundary crossing.	`ToLinear()` / `FromLinear(Color)` (also as `ToColor()` / `FromColor()`)
`Hsl` / `Hsv`	Hue in degrees, saturation and lightness/value in 0..1, defined over sRGB.	`FromSrgb` / `ToSrgb`
`Oklab`	Perceptual color space (Ottosson 2020).	`FromColor` / `ToColor`; polar via `ToOklch` / `FromOklch`
`Oklch`	Polar form of Oklab.	`ToOklab` / `FromOklab`
`AccessibilityLevel`	enum: `Fail = 0`, `AA = 1`, `AAA = 2`.	—
`NamedColors`	Common colors (`Black`, `White`, `Red`, `Orange`, `Transparent`, ...), plus `All` and `TryGet(name, out color)` with case-insensitive keys.	—

The satellite spaces carry their own adjustments: Hsl and Srgb have the full HSL set (saturation/lightness/hue/grayscale; Srgb routes these through HSL and also adds Invert()), while Oklch exposes perceptually-uniform WithLightness/LightenBy/DarkenBy, chroma ops (WithChroma/MultiplyChroma/SaturateBy/DesaturateBy/ToGrayscale), and OffsetHue. Color's adjustment methods forward to Hsl.

Converting between spaces

Beyond the base conversion listed above, every color type (including Color) exposes To{Space}() and From{Space}(...) for every other space, plus a uniform ToColor() / FromColor(Color) pair. Those extra methods are one-liners that reuse the base conversions rather than reimplementing any color math, routed through the nearest shared hub:

Within the sRGB family (Srgb, Hsl, Hsv) conversions route through Srgb, so no gamma decode/encode happens.
Within the perceptual family (Oklab, Oklch) conversions route through Oklab.
Across the two families conversions route through the linear Color hub, crossing the gamma boundary exactly once.

So srgb.ToHsl() is the direct HSL definition, while hsl.ToOklab() goes Hsl → Srgb → linear Color → Oklab. Because the satellite spaces carry no alpha, cross-space conversions preserve only the color; use the Color overloads (or WithAlpha) when you need alpha.

FromHex throws ArgumentException for lengths other than 3, 6, or 8, and Gradient throws ArgumentException for steps < 2.

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests.

License

This project is licensed under the MIT License. See the LICENSE.md file for details.

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.
.NET Core	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 is compatible.
.NET Framework	net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen40 was computed. tizen60 was computed.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETStandard 2.0
- System.Numerics.Vectors (>= 4.6.1)
.NETStandard 2.1
- No dependencies.
net10.0
- No dependencies.
net8.0
- No dependencies.
net9.0
- No dependencies.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on ktsu.Semantics.Color:

Package	Downloads
ktsu.ThemeProvider A semantic color theming library for .NET applications that provides 44+ beautiful themes with intelligent color mapping, framework integration, and accessibility-first design. Features include theme discovery through a centralized registry, semantic color specifications (meaning + priority instead of hardcoded colors), built-in Dear ImGui support, and advanced color science with perceptually uniform color spaces.	16.1K
ktsu.ThemeProvider.ImGui A semantic color theming library for .NET applications that provides 44+ beautiful themes with intelligent color mapping, framework integration, and accessibility-first design. Features include theme discovery through a centralized registry, semantic color specifications (meaning + priority instead of hardcoded colors), built-in Dear ImGui support, and advanced color science with perceptually uniform color spaces.	14.1K
ktsu.ImGui.Styler A powerful styling library for ImGui.NET interfaces featuring 50+ built-in themes (Catppuccin, Tokyo Night, Gruvbox, Dracula, Nord, and more), interactive theme browser, scoped styling system for colors and style variables, advanced color manipulation with hex support and accessibility features, automatic content alignment and centering, semantic text colors, button alignment, and indentation utilities.	12.0K
ktsu.ImGui.Widgets A comprehensive library of custom widgets and UI components for ImGui.NET, featuring radial progress bars with countdown/count-up timers, tabbed interfaces with drag-and-drop support, type-safe combo boxes, resizable divider containers, powerful search boxes with fuzzy matching, icons with event handling, flexible grid layouts, and scoped utilities for IDs and disabling elements.	11.4K
ktsu.ImGui.Color A comprehensive .NET library suite for building desktop applications with Dear ImGui. Provides application scaffolding with PID-controlled frame limiting, custom widgets (TabPanel, SearchBox, Knob, RadialProgressBar, DividerContainer, Grid), modal dialogs (file browser, input prompts, searchable lists), a theming system with 50+ built-in themes and scoped styling, and an attribute-based node graph editor with physics-based layout. Built on Hexa.NET.ImGui bindings and Silk.NET for cross-platform windowing.	2.4K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
2.7.4	0	7/20/2026
2.7.3	55	7/17/2026
2.7.2	95	7/16/2026
2.7.1	125	7/15/2026
2.7.0	711	7/14/2026
2.6.0	88	7/14/2026
2.5.5	564	7/8/2026
2.5.4	380	7/7/2026
2.5.3	298	7/6/2026
2.5.2	291	7/3/2026
2.5.1	358	7/2/2026
2.5.0	285	7/1/2026
2.4.0	206	7/1/2026
2.3.1	95	6/30/2026
2.3.0	462	6/29/2026

## v2.7.3 (patch)

Changes since v2.7.2:

- Bump the ktsu group with 2 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.7.2 (patch)

Changes since v2.7.1:

- Bump the ktsu group with 3 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.7.1 (patch)

Changes since v2.7.0:

- Bump the system group with 1 update ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump the microsoft group with 1 update ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump the ktsu group with 2 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.7.0 (minor)

Changes since v2.6.0:

- [minor] Add color adjustment operations across color spaces ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.6.0 (minor)

Changes since v2.5.0:

- [patch] Fix Oklch assertion in color cross-conversion tests ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] Add cross-space conversions between all color types ([@matt-edmondson](https://github.com/matt-edmondson))
- fix(music): use ValueTuple.GetHashCode instead of System.HashCode for netstandard2.0 compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- refactor(music): split Progression.TryParse into helpers to cut cognitive complexity and remove always-true check (SonarQube S3776/S2583) ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(music): update examples and references for Parse/TryParse rename and chart-style progressions ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): chart-style Arrangement ToString + Parse/TryParse + structural equality ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): chart-style Section ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music)!: replace bar-delimited Progression.Parse with chart-style ToString/Parse/TryParse + structural equality; migrate call sites ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): rename Form.FromPattern to Parse/TryParse, canonical ToString, structural equality ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Rest canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Note canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): ChordEvent canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): canonical Chord ToString, TryParse, ParseRoot via Notation ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Key canonical ToString + Parse/TryParse; roman-numeral accidental via Notation ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Scale canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Tempo canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Velocity canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): TimeSignature canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Duration canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Interval canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): rename Mode.FromName to Parse/TryParse, canonical ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): typed Pitch factory, rename FromName to Parse/TryParse, canonical ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): typed PitchClass factory, Parse/TryParse, canonical ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add NoteLetter and Accidental enums ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: implementation plan for music type-safe factories and canonical round-trip ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: revise music factories spec with canonical round-trip ToString and chart-style aggregate format ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: design spec for music type-safe factories and Parse/TryParse convention ([@matt-edmondson](https://github.com/matt-edmondson))
- [patch] docs: add per-package READMEs and turn root README into a family index ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.5.4 (patch)

Changes since v2.5.3:

- Bump the ktsu group with 2 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.5.3 (patch)

Changes since v2.5.2:

- Bump Microsoft.CodeAnalysis.Analyzers and Microsoft.CodeAnalysis.CSharp ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.5.2 (patch)

Changes since v2.5.1:

- Bump the ktsu group with 2 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.5.1 (patch)

Changes since v2.5.0:

- fix(music): use ValueTuple.GetHashCode instead of System.HashCode for netstandard2.0 compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- refactor(music): split Progression.TryParse into helpers to cut cognitive complexity and remove always-true check (SonarQube S3776/S2583) ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(music): update examples and references for Parse/TryParse rename and chart-style progressions ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): chart-style Arrangement ToString + Parse/TryParse + structural equality ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): chart-style Section ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music)!: replace bar-delimited Progression.Parse with chart-style ToString/Parse/TryParse + structural equality; migrate call sites ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): rename Form.FromPattern to Parse/TryParse, canonical ToString, structural equality ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Rest canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Note canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): ChordEvent canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): canonical Chord ToString, TryParse, ParseRoot via Notation ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Key canonical ToString + Parse/TryParse; roman-numeral accidental via Notation ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Scale canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Tempo canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Velocity canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): TimeSignature canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Duration canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): Interval canonical ToString + Parse/TryParse ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): rename Mode.FromName to Parse/TryParse, canonical ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): typed Pitch factory, rename FromName to Parse/TryParse, canonical ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): typed PitchClass factory, Parse/TryParse, canonical ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add NoteLetter and Accidental enums ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: implementation plan for music type-safe factories and canonical round-trip ToString ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: revise music factories spec with canonical round-trip ToString and chart-style aggregate format ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: design spec for music type-safe factories and Parse/TryParse convention ([@matt-edmondson](https://github.com/matt-edmondson))
- [patch] docs: add per-package READMEs and turn root README into a family index ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.5.0 (minor)

Changes since v2.4.0:

- docs(music): document the analysis aggregate layer ([@matt-edmondson](https://github.com/matt-edmondson))
- test(music): lock guard/coverage contracts; dedupe chromatic scale check ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Form pattern extraction and named-form recognition ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Arrangement container ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Section structural unit ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add chromatic chord identification ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add key inference by diatonic fit ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(music): switch key inference to quality-weighted scoring ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add cadence detection ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add roman-numeral labeling and functional classification ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Progression.Parse bar-delimited chord syntax ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Progression core (construction, totals, empty rejection) ([@matt-edmondson](https://github.com/matt-edmondson))
- fix(music): drop CA1859 pragma; use IMusicalEvent helper in ChordEvent test ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add ChordEvent harmonic event type ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(music): implementation plan for analysis aggregate layer ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(music): design spec for analysis aggregate layer ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.4.0 (minor)

Changes since v2.3.0:

- test(strings): add As<T> round-trip test for Uuid ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(strings): reconcile spec As<T> test bullet with implemented roster ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(strings): document Identifiers package in README ([@matt-edmondson](https://github.com/matt-edmondson))
- chore(strings): finalize Identifiers package and document it ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(strings): add JwtToken identifier type ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(strings): add Iban identifier type ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(strings): add Isbn identifier type ([@matt-edmondson](https://github.com/matt-edmondson))
- style(strings): add trailing newline to IsCreditCardNumberAttribute.cs ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(strings): use pattern-matching form in Tasks 5-6 (IDE0078) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(strings): add CreditCardNumber identifier type ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(strings): add Ulid identifier type ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(strings): align plan Tasks 3-7 with repo conventions (ThrowsExactly, no using System, Ensure.NotNull) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(strings): add Uuid identifier type ([@matt-edmondson](https://github.com/matt-edmondson))
- chore(strings): scaffold Semantics.Strings.Identifiers package ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(strings): correct empty-string handling in spec; add implementation plan ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(strings): spec for Semantics.Strings.Identifiers (Phase 0) ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.3.1 (patch)

Changes since v2.3.0:

- Bump the system group with 1 update ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump the ktsu group with 10 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))

## v2.3.0 (minor)

Changes since v2.2.0:

- docs(color): correct Oklab round-trip tolerance note in plan ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): add NamedColors and gamma-regression tests ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): add Oklab mix, lerp, distance, and gradient ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): add WCAG luminance, contrast, and accessibility adjustment ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): add HSL and HSV conversions ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): add Oklab and Oklch perceptual spaces ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): add hex and byte conversions (sRGB-interpreted) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): add Srgb space and gamma-correct sRGB<->linear boundary ([@matt-edmondson](https://github.com/matt-edmondson))
- docs(color): add semantic-domains roadmap, Semantics.Color spec and plan ([@matt-edmondson](https://github.com/matt-edmondson))
- style(color): strip UTF-8 BOM and add final newline (editorconfig) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(color): scaffold Semantics.Color with canonical linear Color type ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.2.0 (minor)

Changes since v2.1.0:

- docs: cover Semantics.Music score primitives, frequency, inversions, roman parsing ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] feat(music): score primitives, frequency bridge, inversions/transpose, roman-numeral parsing ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): parse roman numerals back into chords (inverse of RomanNumeralOf) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add chord inversions and Transpose on Chord/Scale/Key ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Pitch<->frequency (A440) and interval cents ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add score primitives (Velocity, Tempo, Note, Rest) with real-time conversion ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.1.0 (minor)

Changes since v2.0.0:

- Merge feature/semantics-music-types: musical value types ([@matt-edmondson](https://github.com/matt-edmondson))
- [minor] feat(music): musical value types (pitch, interval, scale, chord, key, duration) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Key with roman-numeral function; spell chromatic degrees conventionally (flat-preference) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Chord engine with parsing, tones, and voicing (full HeatDeathRomance vocabulary) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add TimeSignature with bar and beat durations ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add rational Duration with arithmetic and dotted/tuplet support ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Scale and ScaleDegree with degree resolution ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Mode with full standard scale catalog (diatonic, jazz, symmetric, pentatonic) ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Interval with octave folding and pitch difference ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): add Pitch with MIDI/name conversion and transpose ([@matt-edmondson](https://github.com/matt-edmondson))
- feat(music): scaffold Semantics.Music with PitchClass ([@matt-edmondson](https://github.com/matt-edmondson))
- fix(packaging): unblock the 2.0 release pipeline [patch] ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.0.2 (patch)

Changes since v2.0.1:

- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))

## v2.0.1 (patch)

Changes since v2.0.0:

- fix(packaging): unblock the 2.0 release pipeline [patch] ([@matt-edmondson](https://github.com/matt-edmondson))

## v2.0.0 (major)

Changes since v1.0.0:

- Revert "Update pack supressions" ([@matt-edmondson](https://github.com/matt-edmondson))
- Update pack supressions ([@matt-edmondson](https://github.com/matt-edmondson))
- release: ktsu.Semantics 2.0.0 — unified vector quantities [major] ([@matt-edmondson](https://github.com/matt-edmondson))
- fix: drop unreferenced SourceLink package versions (KTSU0005 under ktsu.Sdk 2.11.0) ([@matt-edmondson](https://github.com/matt-edmondson))
- fix: restore icon.png as LFS pointer after main merge ([@matt-edmondson](https://github.com/matt-edmondson))
- Merge remote-tracking branch 'origin/main' into vectors ([@matt-edmondson](https://github.com/matt-edmondson))
- fix(generator): annotate nullable referenceExpr to clear CS8600 ([@matt-edmondson](https://github.com/matt-edmondson))
- docs: reflect 2.0 state, rebrand to 'semantic quantities', document alias packages ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: storage-type alias packages for ktsu.Semantics.Quantities ([@matt-edmondson](https://github.com/matt-edmondson))
- chore: sync stale Units.g.cs and add generated-files CI guard ([@matt-edmondson](https://github.com/matt-edmondson))
- fix: close V0 release blockers and drop out-of-support TFMs ([@matt-edmondson](https://github.com/matt-edmondson))
- fix(build): make vectors build under .NET 10 SDK ([@matt-edmondson](https://github.com/matt-edmondson))
- Merge remote-tracking branch 'origin/main' into vectors-merge-trial ([@matt-edmondson](https://github.com/matt-edmondson))
- Add System.Text.Json package reference to project files ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ktsu.Sdk versions to 2.10.2 ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ktsu.Sdk versions to 2.10.1 ([@matt-edmondson](https://github.com/matt-edmondson))
- refactor(generator): use singular-lemma factory names, drop factoryName ([@Claude](https://github.com/Claude))
- docs: log scales are metadata-generated; Percent/Gain convergence ([@Claude](https://github.com/Claude))
- refactor(quantities): converge log scales and audio types on metadata ([@Claude](https://github.com/Claude))
- feat(generator): LogarithmicScalesGenerator — log scales from logarithmic.json ([@Claude](https://github.com/Claude))
- refactor(quantities): align audio-engineering types with the vectors branch ([@Claude](https://github.com/Claude))
- docs: add 1.x → 2.0 migration guide ([@Claude](https://github.com/Claude))
- test(quantities): cover backfilled dimensions and log-scale companions ([@Claude](https://github.com/Claude))
- feat(quantities): hand-written logarithmic-scale companions ([@Claude](https://github.com/Claude))
- feat(quantities): backfill missing dimensions and acoustic overloads from main ([@Claude](https://github.com/Claude))
- Update NuGet package versions in Directory.Packages.props ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix IDE0370 build errors from .NET 10 SDK analyzer ([@Claude](https://github.com/Claude))
- feat(quantities): backfill unit catalog and constants domains from main ([@Claude](https://github.com/Claude))
- fix(generator): materialise Generic constants via PreciseNumber.To<T>() ([@Claude](https://github.com/Claude))
- chore: refresh generated snapshots ([@Claude](https://github.com/Claude))
- feat(generator): declare Frequency x Length = Velocity wave relationship ([@Claude](https://github.com/Claude))
- fix(quantities): add comparison operators to PhysicalQuantity (CA1036) ([@Claude](https://github.com/Claude))
- Merge remote-tracking branch 'origin/main' into claude/vectors-sync-progress-ofoith ([@Claude](https://github.com/Claude))
- Add audio-engineering quantities and normalized parameter tapers ([@Claude](https://github.com/Claude))
- chore: drop unnecessary null-forgiving operators + silence coverage warning ([@Claude](https://github.com/Claude))
- feat(quantities): canonical IPhysicalQuantity surface + typed In() (closes #59) ([@Claude](https://github.com/Claude))
- docs(architecture): document physics generator pipeline (closes #61) ([@Claude](https://github.com/Claude))
- feat(generator): SEM004 — flag dimensions.json units missing from units.json ([@Claude](https://github.com/Claude))
- docs: fix stale README + guides — plural factories, V3 object-init, real PhysicalConstants surface ([@Claude](https://github.com/Claude))
- feat(quantities): per-overload physicalConstraints + EnsurePositive guard (closes #51) ([@Claude](https://github.com/Claude))
- test(quantities): generator-output invariants — no duplicate signatures, commutative * (closes #57) ([@Claude](https://github.com/Claude))
- feat(generator): SEM003 diagnostic + form-specific relationships (closes #58) ([@Claude](https://github.com/Claude))
- feat(generator): plural From{Unit} factory naming + form matrix docs (closes #49) ([@Claude](https://github.com/Claude))
- Merge vectors (post #70) into rebase-issue-48: combine multi-unit factories with SEM002 + AnalyzerReleases ([@Claude](https://github.com/Claude))
- Merge vectors into work/issue-48: combine multi-unit factories with V0 non-negativity ([@Claude](https://github.com/Claude))
- feat(generator): add SEM002 metadata validation; refresh stale generator output ([@Claude](https://github.com/Claude))
- Merge remote-tracking branch 'origin/vectors' into work/issue-48 ([@Claude](https://github.com/Claude))
- feat(quantities): enforce V0 non-negativity and absolute V0-V0 subtraction ([@Claude](https://github.com/Claude))
- feat(generator): emit From{Unit} factory for every availableUnit ([@Claude](https://github.com/Claude))
- test: cover IVector*/Magnitude/Dot/Cross and overload conversions ([@Claude](https://github.com/Claude))
- feat(generator): emit SEM001 when relationship references unknown dimension ([@Claude](https://github.com/Claude))
- Pass 2: drop main-imported tests that reference removed hand-written types ([@Claude](https://github.com/Claude))
- Merge main into vectors (structural reconciliation) ([@Claude](https://github.com/Claude))
- docs: align docs with unified vector model and current API ([@Claude](https://github.com/Claude))
- feat: Add new skill for creating physics quantity types with metadata-driven process ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance project configuration: enable compiler-generated files and set output path; remove specific generated files from compilation ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Add new unit categories and conversion factors for fluid mechanics and chemistry ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Enhance dimensions and units metadata with additional overloads and derived units ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Update CodeBlocker package version and refactor scope usage in generators and templates ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor dimensions metadata structure and enhance vector form definitions ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Update dimensions.json schema to unify vector representation and enhance dimensional relationships ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Enhance cross-dimensional operations and relationships in unified vector representation ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Define proposed base types and naming patterns for unified vector representation of quantities ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Add strategy document for unified vector representation of quantities ([@matt-edmondson](https://github.com/matt-edmondson))
- refactor: Simplify vector method implementations by removing unnecessary scope blocks ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Implement QuantitiesGenerator for generating scalar and vector quantity types from dimensions.json ([@matt-edmondson](https://github.com/matt-edmondson))
- refactor: Remove unused using directives for ktsu.Semantics.Strings in test files ([@matt-edmondson](https://github.com/matt-edmondson))
- feat: Add Microsoft.Bcl.AsyncInterfaces package and refactor path handling ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove obsolete validation attributes and related files for path and text validation ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove .cursorindexingignore to eliminate unnecessary indexing rules ([@matt-edmondson](https://github.com/matt-edmondson))
- Update project file to target .NET 10.0 and remove obsolete configurations ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove legacy build scripts ([@matt-edmondson](https://github.com/matt-edmondson))
- Add ktsu.RoundTripStringJsonConverter package reference and update SemanticString to use its JsonConverter ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor validation strategy null checks to use Ensure.NotNull for consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance test assertions with descriptive messages for clarity ([@matt-edmondson](https://github.com/matt-edmondson))
- Update suppression targets in CompatibilitySuppressions.xml for attribute consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove unnecessary blank line in PerformanceRegressionTests class ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove performance variance checks from quantity creation test for consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Update .NET version to 10.0 and adjust coverage reporting for SonarQube integration ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor validation attributes and update path-related records for consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Update System.Memory package version to 4.6.3 ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor null checks to use Ensure instead of Guard; update target frameworks and package references ([@matt-edmondson](https://github.com/matt-edmondson))
- Increase performance variance threshold in regression tests to 70% for CI environment consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove Polyfill package references and update test assertions for clarity ([@matt-edmondson](https://github.com/matt-edmondson))
- Add DirectoryName type and improve path validation semantics ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance project detection logic to support multi-project solutions ([@matt-edmondson](https://github.com/matt-edmondson))
- Add compatibility supression files ([@matt-edmondson](https://github.com/matt-edmondson))
- Modernize codebase and simplify multi-framework support ([@matt-edmondson](https://github.com/matt-edmondson))
- Update project configurations and SDK versions ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor testing and coverage configuration ([@matt-edmondson](https://github.com/matt-edmondson))
- Add unit tests for AcousticOperator and PhysicalDimension extensions ([@matt-edmondson](https://github.com/matt-edmondson))
- Update Invoke-DotNetTest function to remove unnecessary `--no-build` flag from dotnet test command for improved test execution. ([@matt-edmondson](https://github.com/matt-edmondson))
- Add unit tests for AcousticImpedance, ReflectionCoefficient, and SoundSpeed classes ([@matt-edmondson](https://github.com/matt-edmondson))
- Add unit tests for AcousticDirectionalityIndex functionality ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove obsolete cursor ignore files to streamline project structure ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor Exposure calculations to use CoulombPerKilogram unit ([@matt-edmondson](https://github.com/matt-edmondson))
- Add unit tests for various SemanticString validators ([@matt-edmondson](https://github.com/matt-edmondson))
- Add unit tests for casing and line count validators in SemanticString ([@matt-edmondson](https://github.com/matt-edmondson))
- Add unit tests for Casing and Contracts validation in SemanticString ([@matt-edmondson](https://github.com/matt-edmondson))
- Update RegexMatchAttribute to include a timeout in Regex matching for improved performance and reliability. This change ensures that the regex operation does not hang indefinitely by setting a one-second timeout, enhancing the overall validation process. ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SemanticDirectoryPath class to improve content retrieval method naming and enhance error handling. The `Contents` property has been renamed to `GetContents` for clarity, and synchronous handling has been implemented to ensure compatibility with older .NET versions. ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix argument exception message assertion in SemanticStringAdditionalTests for improved clarity ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove obsolete files and clean up project structure ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance validation error messages in ContainsAttribute, EndsWithAttribute, and StartsWithAttribute classes ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor PhysicalDimensions class to use IReadOnlySet for standard physical dimensions and update test classes to static for consistency. This improves clarity and aligns with coding standards across the project. ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove unnecessary using directives from test files for improved clarity ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor directory path content retrieval methods for consistency and clarity ([@matt-edmondson](https://github.com/matt-edmondson))
- Fix missing usings ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor path handling code for improved readability and consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor directory path implementations to support synchronous enumeration for older .NET versions ([@matt-edmondson](https://github.com/matt-edmondson))
- Add System.Memory package and implement path polyfills for .NET compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance null argument validation in RelativeFilePath for .NET compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement polyfill for ArgumentNullException in path classes for compatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- Add path-related polyfills and refactor namespaces for clarity ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SemanticString methods to utilize WeakString for span-based operations ([@matt-edmondson](https://github.com/matt-edmondson))
- Update project configuration and refine string handling methods ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance semantic string handling with read-only span support ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor validation framework and introduce new path semantics ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor validation attributes to enhance initialization and validation logic ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor validation attributes to remove FluentValidation dependency ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor project structure and update SDK versions ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor project configuration and enhance SDK management ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance project configuration and code generation capabilities ([@matt-edmondson](https://github.com/matt-edmondson))
- Code generation ([@matt-edmondson](https://github.com/matt-edmondson))
- Add new static factory methods for length and position quantities in micrometers, nanometers, and various vector dimensions ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance quantity classes with additional static factory methods for creating instances from nanometers and molar concentrations ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement static factory methods for float quantity classes across various domains ([@matt-edmondson](https://github.com/matt-edmondson))
- Add extension methods for double and float physical quantities ([@matt-edmondson](https://github.com/matt-edmondson))
- Implement static factory methods for quantity classes in acoustic, chemical, electrical, fluid dynamics, mechanics, nuclear, optical, and thermal domains ([@matt-edmondson](https://github.com/matt-edmondson))
- Add new quantity classes and methods for acoustic, chemical, electrical, fluid dynamics, mechanics, nuclear, optical, and thermal domains ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor and enhance quantity classes and tests ([@matt-edmondson](https://github.com/matt-edmondson))
- Update package versions and enhance build scripts ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor exception assertions in unit tests for consistency ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor performance regression tests to set CI-friendly targets ([@matt-edmondson](https://github.com/matt-edmondson))
- Update package versions and refine project metadata ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance path handling and testing for directory and file combinations ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance semantic string type conversions and path handling ([@matt-edmondson](https://github.com/matt-edmondson))
- Update copyright notice, package versions, and enhance winget manifest generation script ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance performance regression tests with updated targets and optimizations ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove BenchmarkMemoryAllocation Test Due to Incompatibility ([@matt-edmondson](https://github.com/matt-edmondson))
- Optimize Performance Benchmarks to Reduce Memory Allocation ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance Performance Benchmarks and Derived Cursor Rules ([@matt-edmondson](https://github.com/matt-edmon... (truncated due to NuGet length limits)