histropediajs 1.6.1 → 1.6.2

package/dist/histropedia.esm.js

@@ -1,5 +1,5 @@
 /*!
-HistropediaJS v1.6.1 | Histropedia Ltd. (c) 2026 | https://js.histropedia.com
+HistropediaJS v1.6.2 | Histropedia Ltd. (c) 2026 | https://js.histropedia.com
 Use of this software is subject to our End User Licence Agreement: https://js.histropedia.com/licence.html
 */
 var __defProp = Object.defineProperty;
@@ -905,6 +905,11 @@ function getDatePrecision(parts) {
 }
 __name(getDatePrecision, "getDatePrecision");
 function getHistoricalPeriodBounds(year, size) {
+  if (year <= 0) {
+    const historicalYear = 1 - year;
+    const oldestYear = Math.ceil(historicalYear / size) * size;
+    return { startYear: 1 - oldestYear, endYear: size - oldestYear };
+  }
   const endYear = Math.ceil(year / size) * size;
   return {
     startYear: endYear - size + 1,
@@ -912,6 +917,15 @@ function getHistoricalPeriodBounds(year, size) {
   };
 }
 __name(getHistoricalPeriodBounds, "getHistoricalPeriodBounds");
+function getDecadeBounds(year) {
+  if (year <= 0) {
+    const decade = Math.floor((1 - year) / 10) * 10;
+    return { startYear: 1 - (decade + 9), endYear: 1 - Math.max(1, decade) };
+  }
+  const startYear = Math.floor(year / 10) * 10;
+  return { startYear: Math.max(1, startYear), endYear: startYear + 9 };
+}
+__name(getDecadeBounds, "getDecadeBounds");
 function clampInteger(value, fallback, minimum, maximum) {
   const parsed = Number(value);
   if (!Number.isFinite(parsed)) {
@@ -1277,11 +1291,19 @@ Dmy.CreateAsStartOfPeriod = function(isoDmy, precision) {
   if (precision === "month") {
     return new Dmy(isoYear, month, 1);
   }
-  if (precision === "year" || precision === "million-years" || precision === "billion-years") {
+  if (precision === "year") {
     return new Dmy(isoYear, 1, 1);
   }
+  if (precision === "million-years" || precision === "billion-years") {
+    const size = precision === "million-years" ? 1e6 : 1e9;
+    return new Dmy(
+      isoYear <= 0 ? getHistoricalPeriodBounds(isoYear, size).startYear : isoYear,
+      1,
+      1
+    );
+  }
   if (precision === "decade") {
-    return new Dmy(Math.floor(isoYear / 10) * 10, 1, 1);
+    return new Dmy(getDecadeBounds(isoYear).startYear, 1, 1);
   }
   if (precision === "century") {
     return new Dmy(getHistoricalPeriodBounds(isoYear, 100).startYear, 1, 1);
@@ -1318,7 +1340,7 @@ Dmy.CreateAsEndOfPeriod = function(isoDmy, precision) {
     return new Dmy(isoYear, 12, 31);
   }
   if (precision === "decade") {
-    return new Dmy(Math.floor(isoYear / 10) * 10 + 9, 12, 31);
+    return new Dmy(getDecadeBounds(isoYear).endYear, 12, 31);
   }
   if (precision === "century") {
     return new Dmy(getHistoricalPeriodBounds(isoYear, 100).endYear, 12, 31);
@@ -1326,11 +1348,13 @@ Dmy.CreateAsEndOfPeriod = function(isoDmy, precision) {
   if (precision === "millennium") {
     return new Dmy(getHistoricalPeriodBounds(isoYear, 1e3).endYear, 12, 31);
   }
-  if (precision === "million-years") {
-    return new Dmy(isoYear + 999999, 12, 31);
-  }
-  if (precision === "billion-years") {
-    return new Dmy(isoYear + 999999999, 12, 31);
+  if (precision === "million-years" || precision === "billion-years") {
+    const size = precision === "million-years" ? 1e6 : 1e9;
+    return new Dmy(
+      isoYear <= 0 ? getHistoricalPeriodBounds(isoYear, size).endYear : isoYear + size - 1,
+      12,
+      31
+    );
   }
   Logger.error("precision is not implemented");
   return new Dmy(isoYear, month, day);
@@ -5850,14 +5874,8 @@ function getParentIntervalStart(value, unit) {
       return new Dmy(value.year, value.month, 1);
     case ZOOM_YEAR:
       return new Dmy(value.year, 1, 1);
-    case ZOOM_DECADE: {
-      if (value.year > 0) {
-        return new Dmy(Math.floor(value.year / 10) * 10, 1, 1);
-      }
-      const displayedYear = 1 - value.year;
-      const displayedDecade = Math.floor(displayedYear / 10) * 10;
-      return new Dmy(1 - (displayedDecade + 9), 1, 1);
-    }
+    case ZOOM_DECADE:
+      return Dmy.CreateAsStartOfPeriod(value, "decade");
     case ZOOM_CENTURY:
       return Dmy.CreateAsStartOfPeriod(value, "century");
     case ZOOM_MILLENNIUM:
@@ -5882,7 +5900,7 @@ function getNextParentInterval(start, unit) {
     case ZOOM_YEAR:
       return start.addYears(1);
     case ZOOM_DECADE:
-      return start.addYears(10);
+      return Dmy.CreateAsExclusiveEndOfPeriod(start, "decade");
     case ZOOM_CENTURY:
       return Dmy.CreateAsExclusiveEndOfPeriod(start, "century");
     case ZOOM_MILLENNIUM:
@@ -6019,6 +6037,9 @@ TimescaleManager.prototype.formatParentContextLabel = function(value, unit) {
     case ZOOM_DECADE: {
       const displayedYear = value.year <= 0 ? 1 - value.year : value.year;
       const decade = Math.floor(displayedYear / 10) * 10;
+      if (decade === 0) {
+        return value.year <= 0 ? `9–1${options.bceText}` : "1–9";
+      }
       const formattedDecade = new Dmy(decade, 1, 1).format("YYYY", {
         thousandsSeparator: options.thousandsSeparator,
         bceText: ""
@@ -8129,15 +8150,6 @@ function getFitZoomForInternalDates(timeline, internalStart, internalEnd, paddin
   return normaliseZoomForManager(manager, targetZoom);
 }
 __name(getFitZoomForInternalDates, "getFitZoomForInternalDates");
-function getFitZoom(timeline, startDate, endDate, padding) {
-  return getFitZoomForInternalDates(
-    timeline,
-    timeline.getDmyFromInput(normaliseDateInput(startDate)),
-    timeline.getDmyFromInput(normaliseDateInput(endDate)),
-    padding
-  );
-}
-__name(getFitZoom, "getFitZoom");
 function normaliseBoundDate(timeline, date) {
   if (date == null) {
     return null;
@@ -8482,10 +8494,8 @@ function animateDateRangeFit(timeline, targetStartDate, targetEndDate, targetZoo
   const fitPixelSpan = getFitPixelSpan(timeline, padding);
   const startPointAtPadding = getDayPointAtPixel(timeline, padding.left);
   const startEndPointAtPadding = getDayPointAtPixel(timeline, padding.left + fitPixelSpan);
-  const targetInternalStart = timeline.getDmyFromInput(normaliseDateInput(targetStartDate));
-  const targetInternalEnd = timeline.getDmyFromInput(normaliseDateInput(targetEndDate));
-  const targetPoint = getDayPoint(targetInternalStart);
-  const targetEndPoint = getDayPoint(targetInternalEnd);
+  const targetPoint = getDayPoint(targetStartDate);
+  const targetEndPoint = getDayPoint(targetEndDate);
   const canInterpolateBoundaries = compareDayPoints(startEndPointAtPadding, startPointAtPadding) > 0 && compareDayPoints(targetEndPoint, targetPoint) > 0;
   const rangeTween = tween({
     from: 0,
@@ -8518,7 +8528,7 @@ function animateDateRangeFit(timeline, targetStartDate, targetEndDate, targetZoo
       if (targetZoom !== timeline.timescaleManager.zoom) {
         timeline.timescaleManager.setZoom(targetZoom);
       }
-      setInternalStartDate(timeline, targetInternalStart, padding.left, true);
+      setInternalStartDate(timeline, targetStartDate, padding.left, true);
       timeline.isPanning = false;
     }
   });
@@ -12425,24 +12435,31 @@ Timeline.prototype.getZoom = function() {
 Timeline.prototype.setCentreDate = function(dmy, pixelOffset) {
   this.setStartDate(dmy, { padding: this.getWidth() / 2 + (pixelOffset || 0) });
 };
-Timeline.prototype.fitDateRange = /* @__PURE__ */ __name(function fitDateRange(start, end, options = {}) {
+function fitInternalDateRange(timeline, startDate, endDate, options = {}) {
   const padding = normalisePadding(options.padding);
+  const targetZoom = getFitZoomForInternalDates(timeline, startDate, endDate, padding);
+  if (options.animation?.active) {
+    animateDateRangeFit(timeline, startDate, endDate, targetZoom, padding, options.animation);
+    return;
+  }
+  if (targetZoom !== timeline.timescaleManager.zoom) {
+    timeline.setZoom(targetZoom);
+  }
+  setInternalStartDate(timeline, startDate, padding.left, true);
+}
+__name(fitInternalDateRange, "fitInternalDateRange");
+Timeline.prototype.fitDateRange = /* @__PURE__ */ __name(function fitDateRange(start, end, options = {}) {
   let startRange = normaliseDateRangeInput(start);
   let endRange = normaliseDateRangeInput(end);
   if (startRange.start.compare(endRange.start) > 0) {
     [startRange, endRange] = [endRange, startRange];
   }
-  const startDate = startRange.start;
-  const endDate = endRange.end;
-  const targetZoom = getFitZoom(this, startDate, endDate, padding);
-  if (options.animation?.active) {
-    animateDateRangeFit(this, startDate, endDate, targetZoom, padding, options.animation);
-    return;
-  }
-  if (targetZoom !== this.timescaleManager.zoom) {
-    this.setZoom(targetZoom);
-  }
-  this.setStartDate(startDate, { padding: padding.left });
+  fitInternalDateRange(
+    this,
+    this.getDmyFromInput(startRange.start),
+    this.getDmyFromInput(endRange.end),
+    options
+  );
 }, "fitDateRange");
 Timeline.prototype.settleDateBounds = /* @__PURE__ */ __name(function settleDateBounds(options = {}) {
   let correction = getDateBoundCorrection(this);
@@ -12499,7 +12516,7 @@ Timeline.prototype.fitArticleRange = /* @__PURE__ */ __name(function fitArticleR
   if (!article?.period?.from || !article.period.to) {
     return false;
   }
-  this.fitDateRange(article.period.from, article.period.to, {
+  fitInternalDateRange(this, article.period.from, article.period.to, {
     padding: options.padding,
     animation: options.animation
   });
@@ -12518,7 +12535,7 @@ Timeline.prototype.fitArticles = /* @__PURE__ */ __name(function fitArticles(opt
     left: requestedPadding.left + articleRange.maxCardLeftOffset,
     right: requestedPadding.right + articleRange.maxCardRightOffset
   };
-  this.fitDateRange(articleRange.earliest, articleRange.latest, {
+  fitInternalDateRange(this, articleRange.earliest, articleRange.latest, {
     padding: fitPadding,
     animation: options.animation
   });

package/dist/histropedia.umd.js

@@ -1,5 +1,5 @@
 /*!
-HistropediaJS v1.6.1 | Histropedia Ltd. (c) 2026 | https://js.histropedia.com
+HistropediaJS v1.6.2 | Histropedia Ltd. (c) 2026 | https://js.histropedia.com
 Use of this software is subject to our End User Licence Agreement: https://js.histropedia.com/licence.html
 */
 (function(global, factory) {
@@ -927,6 +927,11 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
   }
   __name(getDatePrecision, "getDatePrecision");
   function getHistoricalPeriodBounds(year, size) {
+    if (year <= 0) {
+      const historicalYear = 1 - year;
+      const oldestYear = Math.ceil(historicalYear / size) * size;
+      return { startYear: 1 - oldestYear, endYear: size - oldestYear };
+    }
     const endYear = Math.ceil(year / size) * size;
     return {
       startYear: endYear - size + 1,
@@ -934,6 +939,15 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
     };
   }
   __name(getHistoricalPeriodBounds, "getHistoricalPeriodBounds");
+  function getDecadeBounds(year) {
+    if (year <= 0) {
+      const decade = Math.floor((1 - year) / 10) * 10;
+      return { startYear: 1 - (decade + 9), endYear: 1 - Math.max(1, decade) };
+    }
+    const startYear = Math.floor(year / 10) * 10;
+    return { startYear: Math.max(1, startYear), endYear: startYear + 9 };
+  }
+  __name(getDecadeBounds, "getDecadeBounds");
   function clampInteger(value, fallback, minimum, maximum) {
     const parsed = Number(value);
     if (!Number.isFinite(parsed)) {
@@ -1299,11 +1313,19 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
     if (precision === "month") {
       return new Dmy(isoYear, month, 1);
     }
-    if (precision === "year" || precision === "million-years" || precision === "billion-years") {
+    if (precision === "year") {
       return new Dmy(isoYear, 1, 1);
     }
+    if (precision === "million-years" || precision === "billion-years") {
+      const size = precision === "million-years" ? 1e6 : 1e9;
+      return new Dmy(
+        isoYear <= 0 ? getHistoricalPeriodBounds(isoYear, size).startYear : isoYear,
+        1,
+        1
+      );
+    }
     if (precision === "decade") {
-      return new Dmy(Math.floor(isoYear / 10) * 10, 1, 1);
+      return new Dmy(getDecadeBounds(isoYear).startYear, 1, 1);
     }
     if (precision === "century") {
       return new Dmy(getHistoricalPeriodBounds(isoYear, 100).startYear, 1, 1);
@@ -1340,7 +1362,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
       return new Dmy(isoYear, 12, 31);
     }
     if (precision === "decade") {
-      return new Dmy(Math.floor(isoYear / 10) * 10 + 9, 12, 31);
+      return new Dmy(getDecadeBounds(isoYear).endYear, 12, 31);
     }
     if (precision === "century") {
       return new Dmy(getHistoricalPeriodBounds(isoYear, 100).endYear, 12, 31);
@@ -1348,11 +1370,13 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
     if (precision === "millennium") {
       return new Dmy(getHistoricalPeriodBounds(isoYear, 1e3).endYear, 12, 31);
     }
-    if (precision === "million-years") {
-      return new Dmy(isoYear + 999999, 12, 31);
-    }
-    if (precision === "billion-years") {
-      return new Dmy(isoYear + 999999999, 12, 31);
+    if (precision === "million-years" || precision === "billion-years") {
+      const size = precision === "million-years" ? 1e6 : 1e9;
+      return new Dmy(
+        isoYear <= 0 ? getHistoricalPeriodBounds(isoYear, size).endYear : isoYear + size - 1,
+        12,
+        31
+      );
     }
     Logger.error("precision is not implemented");
     return new Dmy(isoYear, month, day);
@@ -5893,14 +5917,8 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
         return new Dmy(value.year, value.month, 1);
       case ZOOM_YEAR:
         return new Dmy(value.year, 1, 1);
-      case ZOOM_DECADE: {
-        if (value.year > 0) {
-          return new Dmy(Math.floor(value.year / 10) * 10, 1, 1);
-        }
-        const displayedYear = 1 - value.year;
-        const displayedDecade = Math.floor(displayedYear / 10) * 10;
-        return new Dmy(1 - (displayedDecade + 9), 1, 1);
-      }
+      case ZOOM_DECADE:
+        return Dmy.CreateAsStartOfPeriod(value, "decade");
       case ZOOM_CENTURY:
         return Dmy.CreateAsStartOfPeriod(value, "century");
       case ZOOM_MILLENNIUM:
@@ -5925,7 +5943,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
       case ZOOM_YEAR:
         return start.addYears(1);
       case ZOOM_DECADE:
-        return start.addYears(10);
+        return Dmy.CreateAsExclusiveEndOfPeriod(start, "decade");
       case ZOOM_CENTURY:
         return Dmy.CreateAsExclusiveEndOfPeriod(start, "century");
       case ZOOM_MILLENNIUM:
@@ -6064,6 +6082,9 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
       case ZOOM_DECADE: {
         const displayedYear = value.year <= 0 ? 1 - value.year : value.year;
         const decade = Math.floor(displayedYear / 10) * 10;
+        if (decade === 0) {
+          return value.year <= 0 ? `9–1${options.bceText}` : "1–9";
+        }
         const formattedDecade = new Dmy(decade, 1, 1).format("YYYY", {
           thousandsSeparator: options.thousandsSeparator,
           bceText: ""
@@ -8181,15 +8202,6 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
     return normaliseZoomForManager(manager, targetZoom);
   }
   __name(getFitZoomForInternalDates, "getFitZoomForInternalDates");
-  function getFitZoom(timeline, startDate, endDate, padding) {
-    return getFitZoomForInternalDates(
-      timeline,
-      timeline.getDmyFromInput(normaliseDateInput(startDate)),
-      timeline.getDmyFromInput(normaliseDateInput(endDate)),
-      padding
-    );
-  }
-  __name(getFitZoom, "getFitZoom");
   function normaliseBoundDate(timeline, date) {
     if (date == null) {
       return null;
@@ -8539,10 +8551,8 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
     const fitPixelSpan = getFitPixelSpan(timeline, padding);
     const startPointAtPadding = getDayPointAtPixel(timeline, padding.left);
     const startEndPointAtPadding = getDayPointAtPixel(timeline, padding.left + fitPixelSpan);
-    const targetInternalStart = timeline.getDmyFromInput(normaliseDateInput(targetStartDate));
-    const targetInternalEnd = timeline.getDmyFromInput(normaliseDateInput(targetEndDate));
-    const targetPoint = getDayPoint(targetInternalStart);
-    const targetEndPoint = getDayPoint(targetInternalEnd);
+    const targetPoint = getDayPoint(targetStartDate);
+    const targetEndPoint = getDayPoint(targetEndDate);
     const canInterpolateBoundaries = compareDayPoints(startEndPointAtPadding, startPointAtPadding) > 0 && compareDayPoints(targetEndPoint, targetPoint) > 0;
     const rangeTween = tween({
       from: 0,
@@ -8575,7 +8585,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
         if (targetZoom !== timeline.timescaleManager.zoom) {
           timeline.timescaleManager.setZoom(targetZoom);
         }
-        setInternalStartDate(timeline, targetInternalStart, padding.left, true);
+        setInternalStartDate(timeline, targetStartDate, padding.left, true);
         timeline.isPanning = false;
       }
     });
@@ -12523,25 +12533,32 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
   Timeline.prototype.setCentreDate = function(dmy, pixelOffset) {
     this.setStartDate(dmy, { padding: this.getWidth() / 2 + (pixelOffset || 0) });
   };
-  Timeline.prototype.fitDateRange = /* @__PURE__ */ __name(function fitDateRange(start, end, options = {}) {
+  function fitInternalDateRange(timeline, startDate, endDate, options = {}) {
     var _a;
     const padding = normalisePadding(options.padding);
+    const targetZoom = getFitZoomForInternalDates(timeline, startDate, endDate, padding);
+    if ((_a = options.animation) == null ? void 0 : _a.active) {
+      animateDateRangeFit(timeline, startDate, endDate, targetZoom, padding, options.animation);
+      return;
+    }
+    if (targetZoom !== timeline.timescaleManager.zoom) {
+      timeline.setZoom(targetZoom);
+    }
+    setInternalStartDate(timeline, startDate, padding.left, true);
+  }
+  __name(fitInternalDateRange, "fitInternalDateRange");
+  Timeline.prototype.fitDateRange = /* @__PURE__ */ __name(function fitDateRange(start, end, options = {}) {
     let startRange = normaliseDateRangeInput(start);
     let endRange = normaliseDateRangeInput(end);
     if (startRange.start.compare(endRange.start) > 0) {
       [startRange, endRange] = [endRange, startRange];
     }
-    const startDate = startRange.start;
-    const endDate = endRange.end;
-    const targetZoom = getFitZoom(this, startDate, endDate, padding);
-    if ((_a = options.animation) == null ? void 0 : _a.active) {
-      animateDateRangeFit(this, startDate, endDate, targetZoom, padding, options.animation);
-      return;
-    }
-    if (targetZoom !== this.timescaleManager.zoom) {
-      this.setZoom(targetZoom);
-    }
-    this.setStartDate(startDate, { padding: padding.left });
+    fitInternalDateRange(
+      this,
+      this.getDmyFromInput(startRange.start),
+      this.getDmyFromInput(endRange.end),
+      options
+    );
   }, "fitDateRange");
   Timeline.prototype.settleDateBounds = /* @__PURE__ */ __name(function settleDateBounds(options = {}) {
     var _a;
@@ -12600,7 +12617,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
     if (!((_a = article == null ? void 0 : article.period) == null ? void 0 : _a.from) || !article.period.to) {
       return false;
     }
-    this.fitDateRange(article.period.from, article.period.to, {
+    fitInternalDateRange(this, article.period.from, article.period.to, {
       padding: options.padding,
       animation: options.animation
     });
@@ -12620,7 +12637,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
       left: requestedPadding.left + articleRange.maxCardLeftOffset,
       right: requestedPadding.right + articleRange.maxCardRightOffset
     };
-    this.fitDateRange(articleRange.earliest, articleRange.latest, {
+    fitInternalDateRange(this, articleRange.earliest, articleRange.latest, {
       padding: fitPadding,
       animation: options.animation
     });