quantity

Releases

1. ▸▾5.0.01 Jun 20262 sources agree

   Dart 3+ Modernization: Applied sealed, base, and final modifiers to Number, Quantity, and Dimensions classes. Refactored map parsing and type determin

   • Dart 3+ Modernization: Applied sealed, base, and final modifiers to Number, Quantity, and Dimensions classes. Refactored map parsing and type determination using modern pattern matching and switch expressions.
     • Fluent DX & Unit Shortcuts: Added extension getters on num and Number (e.g., 5.meters, 75.tps) and unit shortcuts (inKilometers, inTps, inCelsius).
     • Registry Decoupling & Tree-Shaking: Decoupled the physical quantity registry by registering subclasses dynamically, allowing for clean tree-shaking. Added a lightweight core entrypoint lib/quantity_core.dart.
     • JSON Serialization: Added full toJson() and fromJson() support to Quantity, Number, and Dimensions hierarchies.
     • Decimal Interoperability: Integrated the decimal package directly, introducing valueSIAsDecimal, toDecimal(), and fromDecimal(Decimal) to allow high-precision decimal operations.
     • NIST Constants Sync: Added an automated script bin/update_nist_constants.dart to synchronize physical constants and uncertainties with the official NIST CODATA table.
     • AI Readiness & Natural Language Processing:
       • Added Quantity.parse(String text) for parsing natural language physical measurements (e.g., '120 km/h', '9.8 m/s^2').
       • Added Quantity.checkDimensionalConsistency to symbolically check math formula consistency (e.g., s = u * t + 0.5 * a * t^2).
       • Added Dimensions.describe returning human-readable dimensions (e.g. 'Length^1 / Time^2').
       • Exposed structured JSON schemas (Quantity.jsonSchema) for structured LLM function calling.
     • Computational & Digital Layout Quantities:
       • Introduced Token and TokenRate classes to support modeling, parsing, and arithmetic for NLP/LLM context tracking and throughput metrics.
       • Introduced Pixel, Resolution (pixels per length), and PixelDensity (pixels per area) classes to support spatial layout scaling, screen resolution calibration (PPI/DPI/DPCM), and graphics calculations with type-safe arithmetic operators.
     • Synonym Quantity Types: Added compile-time typedef aliases and dynamic runtime name registry mapping for 19 physical quantity synonyms across 12 distinct classes (e.g. Irradiance / EnergyFluxDensity / PowerFluxDensity synonymizing HeatFluxDensity, Stress synonymizing Pressure, Work synonymizing Energy, etc.).
     • Domain Collections: Added six domain library collections under lib/domain/ to group quantity types, units, and constants commonly encountered in specific fields: radiometry, atomic_nuclear, computing, chemistry, acoustics, and fluid_dynamics. Added corresponding unit tests for each domain.
     • Algebraic Property Verification: Established property-based testing for Dimensions algebra.
     • Test Coverage Boost: Significantly expanded unit test coverage across the package. Wrote comprehensive tests for previously untested parts including the Fraction number representation class, trig functions and constants in angle_ext, fluent utility extensions on num and Number, and verified variable mappings across all 40+ extension libraries. Further expanded coverage by testing astronomical time scale conversions, range math, exception string serialization, logarithmic level operations, and dynamically generated Unit constructors/derivatives across all 75+ physical quantity classes. Raised overall repository code coverage to 90.7% (surpassing the targets of 70% and 85%).