@onlyworlds/sdk 4.42.1 → 4.42.2

package/CHANGELOG.md

@@ -5,6 +5,14 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.42.2] - 2026-10-20
+
+Two calendar reading fixes, found writing the `atlas_calendar` profile's conformance fixture (OW Council h58 #8943, #8946).
+
+### Fixed
+- **A down era has no year zero, even when its pivot falls mid-year.** Its year is now counted from the year holding the step just before the pivot, which reads `year_base` (1 by default). With the pivot mid-year, the earlier steps of the pivot's own year read year 0 ("0 BG") and every year before it one lower; with the pivot on a year's first step, nothing changes. The mirror of an up era, whose first partial year is year 1.
+- **Equal-start eras resolve by a stated rule:** an up era over a down one, then the later era in the list. The comparator returned `-1` for any pair led by an up era, so two eras of one direction came out in the sort's order rather than the list's.
+
 ## [4.42.1] - 2026-10-20
 
 The calendar reader refuses what the `atlas_calendar` profile refuses (schema-dist `profiles/calendar.md`; Quillon's Unity read, OW Council h58 #8917).

package/dist/index.d.ts

@@ -3999,7 +3999,12 @@ interface EraDomain {
     hi: number;
 }
 declare function resolveEraDomains(eras: CalendarEra[]): EraDomain[];
-/** The era owning a step: domain containment; wild overlaps resolve to latest start (up wins ties). */
+/**
+ * The era owning a step: domain containment; overlaps resolve to the latest start, then an
+ * up era over a down one, then the later era in the list (the profile, calendar.md). The
+ * comparator was `up ? -1 : 1` before 4.42.2: inconsistent for two eras of one direction,
+ * so their order was the sort's, not the list's.
+ */
 declare function eraForStep(cfg: CalendarConfig, step: number): CalendarEra | null;
 /** The display year for a step under an era (or the absolute year without one). */
 declare function displayYear(cfg: CalendarConfig, step: number, era: CalendarEra | null): number;

package/dist/index.js

@@ -3078,7 +3078,9 @@ function eraForStep(cfg, step) {
   if (eras.length === 0) return null;
   const holding = resolveEraDomains(eras).filter((d) => step >= d.lo && step < d.hi);
   if (holding.length === 0) return null;
-  holding.sort((a, b) => b.era.start - a.era.start || ((a.era.direction ?? "up") === "up" ? -1 : 1));
+  const place = new Map(eras.map((e, i) => [e, i]));
+  const down = (e) => (e.direction ?? "up") === "down" ? 1 : 0;
+  holding.sort((a, b) => b.era.start - a.era.start || down(a.era) - down(b.era) || (place.get(b.era) ?? 0) - (place.get(a.era) ?? 0));
   return holding[0].era;
 }
 function displayYear(cfg, step, era) {
@@ -3086,7 +3088,7 @@ function displayYear(cfg, step, era) {
   if (!era || era.restart === false) return abs;
   const base = era.year_base ?? 1;
   if ((era.direction ?? "up") === "down") {
-    return absoluteYear(cfg, era.start) - abs + base - 1;
+    return absoluteYear(cfg, era.start - 1) - abs + base;
   }
   return abs - absoluteYear(cfg, era.start) + base;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlyworlds/sdk",
-  "version": "4.42.1",
+  "version": "4.42.2",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {