@onlyworlds/sdk 4.42.0 → 4.42.2

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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).
+
+### Fixed
+- **`readCalendarValue` / `readCalendarConfig` no longer throw on a falsy `eras` or `intercalary`** (`false`, `0`, `""`): it threw a `TypeError` where the profile says a reader refuses and shows bare numbers. It now returns `null`.
+- **A step is an integer, so the reader now refuses** an era whose `start` or `end` is not a whole number, a `year_base` other than `0` or `1` (a string `"1"` printed as `"01"` before), and month or weekday names that are not strings. Atlas writes none of these; the Unity SDK refuses them the same way.
+
 ## [4.42.0] - 2026-10-20
 
 Schema 00.32.02 (Skeld, OW Council h58 #8811): repinned to schema-dist v0.32.2-dist.29.

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

@@ -3001,18 +3001,21 @@ function readCalendarConfig(value) {
   const cfg = value;
   if (cfg.version !== 1 || typeof cfg.grain !== "string") return null;
   const months = cfg.bundles?.months;
-  if (months && (!Array.isArray(months.names) || !Array.isArray(months.lengths) || months.names.length !== months.lengths.length || months.names.length === 0)) return null;
-  if (cfg.eras && !Array.isArray(cfg.eras)) return null;
-  if (cfg.eras?.some((e) => typeof e?.name !== "string" || !Number.isFinite(e?.start))) return null;
-  if (cfg.intercalary && (!Array.isArray(cfg.intercalary) || cfg.intercalary.some((i) => typeof i?.name !== "string" || !Number.isInteger(i?.after_month)))) return null;
+  if (months && (!Array.isArray(months.names) || !Array.isArray(months.lengths) || months.names.length !== months.lengths.length || months.names.length === 0 || !months.names.every(isString))) return null;
+  if (cfg.eras != null && !Array.isArray(cfg.eras)) return null;
+  if (cfg.eras?.some((e) => typeof e?.name !== "string" || !Number.isSafeInteger(e?.start) || e.end != null && !Number.isSafeInteger(e.end) || e.year_base != null && e.year_base !== 0 && e.year_base !== 1)) return null;
+  if (cfg.intercalary != null && (!Array.isArray(cfg.intercalary) || cfg.intercalary.some((i) => typeof i?.name !== "string" || !Number.isInteger(i?.after_month)))) return null;
   if (months && !months.lengths.every(isPositiveInt)) return null;
   const year = cfg.bundles?.year;
   if (year != null && !isPositiveInt(year.steps)) return null;
   const week = cfg.bundles?.week;
-  if (week != null && (!isPositiveInt(week.length) || !Array.isArray(week.names))) return null;
+  if (week != null && (!isPositiveInt(week.length) || !Array.isArray(week.names) || !week.names.every(isString))) return null;
   if (cfg.intercalary?.some((i) => i.every_years != null && !isPositiveInt(i.every_years))) return null;
   return cfg;
 }
+function isString(s) {
+  return typeof s === "string";
+}
 function isPositiveInt(n) {
   return Number.isSafeInteger(n) && n >= 1;
 }
@@ -3075,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) {
@@ -3083,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.0",
+  "version": "4.42.2",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {