calcpace 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b4581502040b195baf42c3dbf64bdb8cc6902d2fd1f4011d7982c18961bbf5f
-  data.tar.gz: 0dff0cbdd1604680521987db6a08b96ec136546074d76fe7f45b7d4028f9f8bf
+  metadata.gz: def270498a0b653086ac234f0eb1ad4337f961cc2b93729a4bf32c7e48df78ba
+  data.tar.gz: '075049703348c3cea1194b90a9f64f6cc37552fe360ce51e0d446a9edca5e729'
 SHA512:
-  metadata.gz: 0d4106b957c4da8334d470d67aa5a350f243bac65d0ca5767a356f93e62063a197f7fe338fa2474dcf4079bc5e366f3cfb3a98125820020f3b4bacdb7c4fd856
-  data.tar.gz: d8f85dd081aa9e1941bcea8931d70d994bb195f9dd5e46fbc47cb2a3ace57df99c545c8283ba76f0a3b4e53b35ff880e8f663d6a464cc85276a3a03e3e7ab1b1
+  metadata.gz: '083ff71a2666e55994ef03bd8184c435b1006c2029c4af97ab3546683f2d64e1422fb140c6828c001f00ad630bfc05f1caf98af53fbb9ab4d29ec603cad6ef04'
+  data.tar.gz: '00833e0d9c636730852506c360e08cfec7ecc1de2b1993a4a2560dd0f0941328c48c79e6047ca143babe3545f4b57bfd8e1e47b7c1f864c10d42ab85133390e0'

data/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.18.0] - 2026-09-06
+
+### Changed
+- `age_grade_label(percent)` — and therefore `age_grade`'s `:category` — splits
+  the old single `"Developing"` band below 60% into three: `"Intermediate"`
+  (50–59.9%), `"Recreational"` (40–49.9%) and `"Active Beginner"` (below 40%).
+  Most recreational runners grade under 60%, so the old catch-all told nearly
+  every one of them the same thing.
+
+  ```ruby
+  calc.age_grade_label(55.0) # => "Intermediate"      (was "Developing")
+  calc.age_grade_label(45.0) # => "Recreational"      (was "Developing")
+  calc.age_grade_label(30.0) # => "Active Beginner"   (was "Developing")
+  ```
+
+  The bands at 60% and above are untouched, and no numeric output changes —
+  `age_grade_percent`, `age_graded_time_seconds` and the rest are identical.
+  This is a label-only change, so callers that match on the string
+  `"Developing"` need updating.
+
 ## [1.17.0] - 2026-09-05
 
 ### Added

data/README.md

@@ -2,10 +2,12 @@
 
 A Ruby gem for runners: pace, time, and distance calculations, unit conversions, race predictions, GPS track analysis, age grading, VO2max estimation, and training zones.
 
+> **See it in action:** [calcpace.app](https://calcpace.app) — free running calculators, race predictors and a training log, all powered by this gem.
+
 ## Installation
 
 ```ruby
-gem 'calcpace', '~> 1.12.0'
+gem 'calcpace', '~> 1.18.0'
 ```
 
 ## Usage
@@ -261,6 +263,24 @@ calc.age_grade_percent(5.0, '00:22:30', age: 40, sex: :female) # => 65.2
 calc.age_grade_label(65.2)                                      # => "Local Class"
 ```
 
+`category` (and `age_grade_label`) returns one of:
+
+| Age grade | Category |
+| --- | --- |
+| 100%+ | Approximate World Record Level |
+| 90–99.9% | World Class |
+| 80–89.9% | National Class |
+| 70–79.9% | Regional Class |
+| 60–69.9% | Local Class |
+| 50–59.9% | Intermediate |
+| 40–49.9% | Recreational |
+| below 40% | Active Beginner |
+
+The bands from Local Class up are the WMA / Alan Jones convention. Those tables
+define nothing below Local Class, so the three bands under 60% are calcpace's
+own extension — most recreational runners land there, and one catch-all label
+for everybody under 60% tells them nothing.
+
 Supported distances: 5K, 10K, half marathon, marathon.
 
 A numeric distance within **2%** of one of those is graded as that standard —

data/lib/calcpace/data/wma_2023_open_standards.yml

@@ -3,6 +3,10 @@ meta:
   url: "https://howardgrubb.co.uk/athletics/wmatnf23.html"
   table_version: "WMA_2023_ONE_YEAR_FACTORS_V1"
 
+# The bands from Local Class up follow the WMA / Alan Jones convention. The
+# WMA tables define nothing below Local Class, so the three bands under 60%
+# are Calcpace's own extension, added to give recreational runners a
+# meaningful label instead of a single catch-all.
 age_grade_classifications:
   - min: 100.0
     label: "Approximate World Record Level"
@@ -14,8 +18,12 @@ age_grade_classifications:
     label: "Regional Class"
   - min: 60.0
     label: "Local Class"
+  - min: 50.0
+    label: "Intermediate"
+  - min: 40.0
+    label: "Recreational"
   - min: 0.0
-    label: "Developing"
+    label: "Active Beginner"
 
 open_standards_seconds:
   M:

data/lib/calcpace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Calcpace
-  VERSION = '1.17.0'
+  VERSION = '1.18.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: calcpace
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.18.0
 platform: ruby
 authors:
 - João Gilberto Saraiva