@dereekb/date 10.1.4 → 10.1.6

package/index.cjs.js

@@ -5805,9 +5805,20 @@ function dateCellDayTimingInfoFactory(config) {
     const startsAtOnDay = startsAtFactory(dayIndex); // convert back to the proper date
     const endsAtOnDay = dateFns.addMinutes(startsAtOnDay, duration);
     const potentiallyInProgress = !dateFns.isAfter(startsAtOnDay, now); // is potentially in progress if the now is equal-to or after the start time.
-    const isInProgress = potentiallyInProgress && !dateFns.isAfter(now, endsAtOnDay);
-    const hasOccuredToday = potentiallyInProgress && !isInProgress;
-    const currentIndex = isInProgress || hasOccuredToday ? dayIndex : dayIndex - 1; // If not in progress and hasn't occured today, current index is the previous index.
+    const isInProgressForDayIndex = potentiallyInProgress && !dateFns.isAfter(now, endsAtOnDay);
+    const hasOccuredToday = potentiallyInProgress && !isInProgressForDayIndex;
+    const currentIndex = isInProgressForDayIndex || hasOccuredToday ? dayIndex : dayIndex - 1; // If not in progress and hasn't occured today, current index is the previous index.
+    let isInProgress = false;
+    if (isInProgressForDayIndex) {
+      isInProgress = true;
+    } else if (currentIndex < dayIndex) {
+      const expectedStartForCurrentIndex = startsAtFactory(currentIndex);
+      if (!dateFns.isBefore(now, expectedStartForCurrentIndex)) {
+        // if now is after the expected start time, then check that the end time hasn't occured yet.
+        const expectedEndTime = dateFns.addMinutes(expectedStartForCurrentIndex, duration);
+        isInProgress = !dateFns.isAfter(now, expectedEndTime);
+      }
+    }
     const nextIndex = currentIndex + 1;
     const nextIndexInRange = checkIsInRange(nextIndex) ? nextIndex : undefined;
     const isComplete = currentIndex >= 0 && !nextIndexInRange && (!isInRange || hasOccuredToday);
@@ -5819,6 +5830,7 @@ function dateCellDayTimingInfoFactory(config) {
       nextIndex,
       hasOccuredToday,
       isInProgress,
+      isInProgressForDayIndex,
       isInRange,
       startsAtOnDay,
       endsAtOnDay,
@@ -5934,11 +5946,11 @@ function dateCellTimingDateFactory(timing) {
   } = dateCellTimingStartPair(timing);
   const utcStartDate = normalInstance.baseDateToTargetDate(start);
   const startUtcHours = start.getUTCHours();
-  const factory = input => {
+  const factory = (input, inputNow) => {
     if (util.isDate(input)) {
       return input;
     } else {
-      const now = new Date();
+      const now = inputNow !== null && inputNow !== void 0 ? inputNow : new Date();
       const nowHours = now.getUTCHours();
       const utcStartDateWithNowTime = new Date(Date.UTC(utcStartDate.getUTCFullYear(), utcStartDate.getUTCMonth(), utcStartDate.getUTCDate(), nowHours, now.getUTCMinutes(), now.getUTCSeconds(), now.getUTCMilliseconds()));
       // if the current hours are less than the UTC offset hours, then bump one extra day forward to be sure we're in the correct day.
@@ -7089,7 +7101,7 @@ function dateCellScheduleDateFilter(config) {
   const startsAtInSystem = normalInstance.systemDateToTargetDate(startsAt); // convert to the system date
   const firstDateDay = dateFns.getDay(startsAtInSystem);
   const dayForIndex = dateCellDayOfWeekFactory(firstDateDay);
-  const dateIndexForDate = dateCellTimingRelativeIndexFactory({
+  const _dateCellTimingRelativeIndexFactory = dateCellTimingRelativeIndexFactory({
     startsAt,
     timezone
   });
@@ -7106,22 +7118,59 @@ function dateCellScheduleDateFilter(config) {
     end = expectedFinalStartsAt;
   }
   const indexFloor = setStartAsMinDate ? 0 : Number.MIN_SAFE_INTEGER;
-  const minAllowedIndex = (minMaxDateRange === null || minMaxDateRange === void 0 ? void 0 : minMaxDateRange.start) != null ? Math.max(indexFloor, dateIndexForDate(minMaxDateRange.start)) : indexFloor; // start date should be the min inde
-  const maxAllowedIndex = end != null ? dateIndexForDate(end) : (minMaxDateRange === null || minMaxDateRange === void 0 ? void 0 : minMaxDateRange.end) != null ? dateIndexForDate(minMaxDateRange.end) : Number.MAX_SAFE_INTEGER; // max "to" value
+  const minAllowedIndex = (minMaxDateRange === null || minMaxDateRange === void 0 ? void 0 : minMaxDateRange.start) != null ? Math.max(indexFloor, _dateCellTimingRelativeIndexFactory(minMaxDateRange.start)) : indexFloor; // start date should be the min inde
+  const maxAllowedIndex = end != null ? _dateCellTimingRelativeIndexFactory(end) : (minMaxDateRange === null || minMaxDateRange === void 0 ? void 0 : minMaxDateRange.end) != null ? _dateCellTimingRelativeIndexFactory(minMaxDateRange.end) : Number.MAX_SAFE_INTEGER; // max "to" value
   const includedIndexes = new Set(config.d);
   const excludedIndexes = new Set(config.ex);
-  return input => {
+  const fn = input => {
     let i;
     let day;
     if (typeof input === 'number') {
       i = input;
     } else {
-      i = dateIndexForDate(input);
+      i = _dateCellTimingRelativeIndexFactory(input);
     }
     day = dayForIndex(i);
     const result = i >= minAllowedIndex && i <= maxAllowedIndex && allowedDays.has(day) && !excludedIndexes.has(i) || includedIndexes.has(i);
     return result;
   };
+  fn._dateCellTimingRelativeIndexFactory = _dateCellTimingRelativeIndexFactory;
+  return fn;
+}
+/**
+ * Passes a number of day values until it reaches an open day on a schedule. There's a maximum distance it searches in a direction before returning null.
+ *
+ * @param date
+ * @param filter
+ * @param maxDistance
+ */
+function findNextDateInDateCellScheduleFilter(config) {
+  const {
+    date,
+    filter,
+    direction,
+    maxDistance,
+    excludeInputDate
+  } = config;
+  const {
+    _dateCellTimingRelativeIndexFactory
+  } = filter;
+  const firstDateIndex = _dateCellTimingRelativeIndexFactory(date);
+  const offsetDelta = direction === 'past' ? -1 : 1;
+  let nextDatePair;
+  for (let offset = excludeInputDate ? 1 : 0; offset < maxDistance; offset += 1) {
+    const i = firstDateIndex + offset * offsetDelta;
+    if (filter(i)) {
+      const dateFactory = dateCellTimingDateFactory(_dateCellTimingRelativeIndexFactory._timing);
+      nextDatePair = {
+        i,
+        date: dateFactory(i, isDate(date) ? date : undefined) // pass back the "now" time
+      };
+
+      break;
+    }
+  }
+  return nextDatePair;
 }
 /**
  * Creates a DateCellScheduleDateCellTimingFilter.
@@ -7653,7 +7702,7 @@ class DateTimeMinuteInstance {
     this._date = (dateOverride == undefined ? config.date : dateOverride) || new Date();
     this._step = (_a = config.step) !== null && _a !== void 0 ? _a : 1;
     this._limit = new LimitDateTimeInstance(config);
-    this._dateFilter = config.schedule ? dateCellScheduleDateFilter(config.schedule) : () => true;
+    this._dateFilter = config.schedule ? dateCellScheduleDateFilter(config.schedule) : undefined;
   }
   get date() {
     return this._date;
@@ -7721,7 +7770,7 @@ class DateTimeMinuteInstance {
       inPast = dateFns.isBefore(date, now);
     }
     // Schedule
-    isInSchedule = this._dateFilter(date);
+    isInSchedule = this._dateFilter ? this._dateFilter(date) : true; // default
     return {
       isBeforeMaximum,
       isAfterMinimum,
@@ -7741,9 +7790,70 @@ class DateTimeMinuteInstance {
     }
     return date;
   }
-  clamp(date = this.date) {
+  clamp(date = this.date, maxClampDistance) {
+    return this.clampToSchedule(this.clampToLimit(date), maxClampDistance);
+  }
+  clampToLimit(date = this.date) {
     return this._limit.clamp(date);
   }
+  clampToSchedule(date = this.date, maxClampDistance = 370) {
+    let nextAvailableDate;
+    if (this._dateFilter != null) {
+      const maxLimitedDateRange = this._limit.dateRange();
+      if (this._dateFilter(date)) {
+        nextAvailableDate = date;
+      } else {
+        const maxPastDistance = Math.min(maxClampDistance, maxLimitedDateRange.start ? Math.abs(dateFns.differenceInDays(date, maxLimitedDateRange.start)) : maxClampDistance); // max future
+        const maxFutureDistance = Math.min(maxClampDistance, maxLimitedDateRange.end ? Math.abs(dateFns.differenceInDays(date, maxLimitedDateRange.end)) : maxClampDistance); // max future
+        const nextFutureDate = findNextDateInDateCellScheduleFilter({
+          date,
+          filter: this._dateFilter,
+          direction: 'future',
+          maxDistance: maxFutureDistance,
+          excludeInputDate: true
+        });
+        if (nextFutureDate != null) {
+          nextAvailableDate = nextFutureDate.date;
+        } else {
+          // check the past date clamp
+          const previousPastDate = findNextDateInDateCellScheduleFilter({
+            date,
+            filter: this._dateFilter,
+            direction: 'past',
+            maxDistance: maxPastDistance,
+            excludeInputDate: true
+          });
+          if (previousPastDate != null) {
+            nextAvailableDate = previousPastDate.date;
+          }
+        }
+        // set a default from the given input if applicable
+        if (nextAvailableDate == null) {
+          nextAvailableDate = this.clampToLimit(date);
+        }
+      }
+    }
+    return nextAvailableDate !== null && nextAvailableDate !== void 0 ? nextAvailableDate : date;
+  }
+  findNextAvailableDayInSchedule(date, direction, maxDistance = 370) {
+    let nextAvailableDate;
+    if (this._dateFilter) {
+      const result = findNextDateInDateCellScheduleFilter({
+        date,
+        filter: this._dateFilter,
+        direction,
+        maxDistance: maxDistance,
+        excludeInputDate: true
+      });
+      if (result != null) {
+        nextAvailableDate = result.date;
+      }
+    }
+    return nextAvailableDate;
+  }
+  isInSchedule(date) {
+    return this._dateFilter ? this._dateFilter(date) : true;
+  }
   _takeBoundedDate(date = this.date) {
     return this._takeMaximumBoundedDate(this._takeMinimumBoundedDate(date));
   }
@@ -9373,6 +9483,7 @@ exports.expandUniqueDateCellsFunction = expandUniqueDateCellsFunction;
 exports.filterDateCellsInDateCellRange = filterDateCellsInDateCellRange;
 exports.findMaxDate = findMaxDate;
 exports.findMinDate = findMinDate;
+exports.findNextDateInDateCellScheduleFilter = findNextDateInDateCellScheduleFilter;
 exports.fitDateRangeToDayPeriod = fitDateRangeToDayPeriod;
 exports.fitDateRangeToDayPeriodFunction = fitDateRangeToDayPeriodFunction;
 exports.fitUTCDateRangeToDayPeriod = fitUTCDateRangeToDayPeriod;

package/index.esm.js

@@ -4533,6 +4533,10 @@ function isValidDateCellIndex(input) {
  * Input type that is either a Date or a DateCellIndex.
  */
 
+/**
+ * A date and the relative date index.
+ */
+
 /**
  * A duration-span block.
  */
@@ -6406,9 +6410,22 @@ function dateCellDayTimingInfoFactory(config) {
     const endsAtOnDay = addMinutes(startsAtOnDay, duration);
     const potentiallyInProgress = !isAfter$1(startsAtOnDay, now); // is potentially in progress if the now is equal-to or after the start time.
 
-    const isInProgress = potentiallyInProgress && !isAfter$1(now, endsAtOnDay);
-    const hasOccuredToday = potentiallyInProgress && !isInProgress;
-    const currentIndex = isInProgress || hasOccuredToday ? dayIndex : dayIndex - 1; // If not in progress and hasn't occured today, current index is the previous index.
+    const isInProgressForDayIndex = potentiallyInProgress && !isAfter$1(now, endsAtOnDay);
+    const hasOccuredToday = potentiallyInProgress && !isInProgressForDayIndex;
+    const currentIndex = isInProgressForDayIndex || hasOccuredToday ? dayIndex : dayIndex - 1; // If not in progress and hasn't occured today, current index is the previous index.
+
+    let isInProgress = false;
+    if (isInProgressForDayIndex) {
+      isInProgress = true;
+    } else if (currentIndex < dayIndex) {
+      const expectedStartForCurrentIndex = startsAtFactory(currentIndex);
+      if (!isBefore(now, expectedStartForCurrentIndex)) {
+        // if now is after the expected start time, then check that the end time hasn't occured yet.
+
+        const expectedEndTime = addMinutes(expectedStartForCurrentIndex, duration);
+        isInProgress = !isAfter$1(now, expectedEndTime);
+      }
+    }
     const nextIndex = currentIndex + 1;
     const nextIndexInRange = checkIsInRange(nextIndex) ? nextIndex : undefined;
     const isComplete = currentIndex >= 0 && !nextIndexInRange && (!isInRange || hasOccuredToday);
@@ -6420,6 +6437,7 @@ function dateCellDayTimingInfoFactory(config) {
       nextIndex,
       hasOccuredToday,
       isInProgress,
+      isInProgressForDayIndex,
       isInRange,
       startsAtOnDay,
       endsAtOnDay,
@@ -6561,11 +6579,11 @@ function dateCellTimingDateFactory(timing) {
   } = dateCellTimingStartPair(timing);
   const utcStartDate = normalInstance.baseDateToTargetDate(start);
   const startUtcHours = start.getUTCHours();
-  const factory = input => {
+  const factory = (input, inputNow) => {
     if (isDate$2(input)) {
       return input;
     } else {
-      const now = new Date();
+      const now = inputNow != null ? inputNow : new Date();
       const nowHours = now.getUTCHours();
       const utcStartDateWithNowTime = new Date(Date.UTC(utcStartDate.getUTCFullYear(), utcStartDate.getUTCMonth(), utcStartDate.getUTCDate(), nowHours, now.getUTCMinutes(), now.getUTCSeconds(), now.getUTCMilliseconds()));
 
@@ -7947,7 +7965,7 @@ function dateCellScheduleDateFilter(config) {
   const startsAtInSystem = normalInstance.systemDateToTargetDate(startsAt); // convert to the system date
   const firstDateDay = getDay(startsAtInSystem);
   const dayForIndex = dateCellDayOfWeekFactory(firstDateDay);
-  const dateIndexForDate = dateCellTimingRelativeIndexFactory({
+  const _dateCellTimingRelativeIndexFactory = dateCellTimingRelativeIndexFactory({
     startsAt,
     timezone
   });
@@ -7964,23 +7982,60 @@ function dateCellScheduleDateFilter(config) {
     end = expectedFinalStartsAt;
   }
   const indexFloor = setStartAsMinDate ? 0 : Number.MIN_SAFE_INTEGER;
-  const minAllowedIndex = (minMaxDateRange == null ? void 0 : minMaxDateRange.start) != null ? Math.max(indexFloor, dateIndexForDate(minMaxDateRange.start)) : indexFloor; // start date should be the min inde
-  const maxAllowedIndex = end != null ? dateIndexForDate(end) : (minMaxDateRange == null ? void 0 : minMaxDateRange.end) != null ? dateIndexForDate(minMaxDateRange.end) : Number.MAX_SAFE_INTEGER; // max "to" value
+  const minAllowedIndex = (minMaxDateRange == null ? void 0 : minMaxDateRange.start) != null ? Math.max(indexFloor, _dateCellTimingRelativeIndexFactory(minMaxDateRange.start)) : indexFloor; // start date should be the min inde
+  const maxAllowedIndex = end != null ? _dateCellTimingRelativeIndexFactory(end) : (minMaxDateRange == null ? void 0 : minMaxDateRange.end) != null ? _dateCellTimingRelativeIndexFactory(minMaxDateRange.end) : Number.MAX_SAFE_INTEGER; // max "to" value
 
   const includedIndexes = new Set(config.d);
   const excludedIndexes = new Set(config.ex);
-  return input => {
+  const fn = input => {
     let i;
     let day;
     if (typeof input === 'number') {
       i = input;
     } else {
-      i = dateIndexForDate(input);
+      i = _dateCellTimingRelativeIndexFactory(input);
     }
     day = dayForIndex(i);
     const result = i >= minAllowedIndex && i <= maxAllowedIndex && allowedDays.has(day) && !excludedIndexes.has(i) || includedIndexes.has(i);
     return result;
   };
+  fn._dateCellTimingRelativeIndexFactory = _dateCellTimingRelativeIndexFactory;
+  return fn;
+}
+/**
+ * Passes a number of day values until it reaches an open day on a schedule. There's a maximum distance it searches in a direction before returning null.
+ *
+ * @param date
+ * @param filter
+ * @param maxDistance
+ */
+function findNextDateInDateCellScheduleFilter(config) {
+  const {
+    date,
+    filter,
+    direction,
+    maxDistance,
+    excludeInputDate
+  } = config;
+  const {
+    _dateCellTimingRelativeIndexFactory
+  } = filter;
+  const firstDateIndex = _dateCellTimingRelativeIndexFactory(date);
+  const offsetDelta = direction === 'past' ? -1 : 1;
+  let nextDatePair;
+  for (let offset = excludeInputDate ? 1 : 0; offset < maxDistance; offset += 1) {
+    const i = firstDateIndex + offset * offsetDelta;
+    if (filter(i)) {
+      const dateFactory = dateCellTimingDateFactory(_dateCellTimingRelativeIndexFactory._timing);
+      nextDatePair = {
+        i,
+        date: dateFactory(i, isDate(date) ? date : undefined) // pass back the "now" time
+      };
+
+      break;
+    }
+  }
+  return nextDatePair;
 }
 
 // MARK: DateCellScheduleDateCellTimingFilter
@@ -8567,7 +8622,7 @@ class DateTimeMinuteInstance {
     this._date = (dateOverride == undefined ? config.date : dateOverride) || new Date();
     this._step = (_config$step = config.step) != null ? _config$step : 1;
     this._limit = new LimitDateTimeInstance(config);
-    this._dateFilter = config.schedule ? dateCellScheduleDateFilter(config.schedule) : () => true;
+    this._dateFilter = config.schedule ? dateCellScheduleDateFilter(config.schedule) : undefined;
   }
   get date() {
     return this._date;
@@ -8640,7 +8695,8 @@ class DateTimeMinuteInstance {
     }
 
     // Schedule
-    isInSchedule = this._dateFilter(date);
+    isInSchedule = this._dateFilter ? this._dateFilter(date) : true; // default
+
     return {
       isBeforeMaximum,
       isAfterMinimum,
@@ -8660,9 +8716,73 @@ class DateTimeMinuteInstance {
     }
     return date;
   }
-  clamp(date = this.date) {
+  clamp(date = this.date, maxClampDistance) {
+    return this.clampToSchedule(this.clampToLimit(date), maxClampDistance);
+  }
+  clampToLimit(date = this.date) {
     return this._limit.clamp(date);
   }
+  clampToSchedule(date = this.date, maxClampDistance = 370) {
+    var _nextAvailableDate;
+    let nextAvailableDate;
+    if (this._dateFilter != null) {
+      const maxLimitedDateRange = this._limit.dateRange();
+      if (this._dateFilter(date)) {
+        nextAvailableDate = date;
+      } else {
+        const maxPastDistance = Math.min(maxClampDistance, maxLimitedDateRange.start ? Math.abs(differenceInDays(date, maxLimitedDateRange.start)) : maxClampDistance); // max future
+        const maxFutureDistance = Math.min(maxClampDistance, maxLimitedDateRange.end ? Math.abs(differenceInDays(date, maxLimitedDateRange.end)) : maxClampDistance); // max future
+
+        const nextFutureDate = findNextDateInDateCellScheduleFilter({
+          date,
+          filter: this._dateFilter,
+          direction: 'future',
+          maxDistance: maxFutureDistance,
+          excludeInputDate: true
+        });
+        if (nextFutureDate != null) {
+          nextAvailableDate = nextFutureDate.date;
+        } else {
+          // check the past date clamp
+          const previousPastDate = findNextDateInDateCellScheduleFilter({
+            date,
+            filter: this._dateFilter,
+            direction: 'past',
+            maxDistance: maxPastDistance,
+            excludeInputDate: true
+          });
+          if (previousPastDate != null) {
+            nextAvailableDate = previousPastDate.date;
+          }
+        }
+
+        // set a default from the given input if applicable
+        if (nextAvailableDate == null) {
+          nextAvailableDate = this.clampToLimit(date);
+        }
+      }
+    }
+    return (_nextAvailableDate = nextAvailableDate) != null ? _nextAvailableDate : date;
+  }
+  findNextAvailableDayInSchedule(date, direction, maxDistance = 370) {
+    let nextAvailableDate;
+    if (this._dateFilter) {
+      const result = findNextDateInDateCellScheduleFilter({
+        date,
+        filter: this._dateFilter,
+        direction,
+        maxDistance: maxDistance,
+        excludeInputDate: true
+      });
+      if (result != null) {
+        nextAvailableDate = result.date;
+      }
+    }
+    return nextAvailableDate;
+  }
+  isInSchedule(date) {
+    return this._dateFilter ? this._dateFilter(date) : true;
+  }
   _takeBoundedDate(date = this.date) {
     return this._takeMaximumBoundedDate(this._takeMinimumBoundedDate(date));
   }
@@ -10308,4 +10428,4 @@ class ModelRecurrenceInfoUtility {
   }
 }
 
-export { AnyIterResult, CalendarDate, CalendarDateType, DATE_CELL_SCHEDULE_ENCODED_WEEK_REGEX, DATE_TODAY_END_VALUE, DATE_TODAY_START_VALUE, DATE_WEEK_END_VALUE, DATE_WEEK_START_VALUE, DEFAULT_EXPAND_DAYS_FOR_DATE_RANGE_MAX_EXPANSION_SIZE, DEFAULT_FULL_DATE_SCHEDULE_RANGE_DURATION, DEFAULT_ITERATE_DAYS_IN_DATE_RANGE_MAX_ITERATIONS, DEFAULT_LAST_ITER_RESULT_MAX_ITERATIONS_ALLOWED, DateCell, DateCellRange, DateCellSchedule, DateCellScheduleDayCode, DateCellTiming, DateDurationSpan, DateRRule, DateRRuleInstance, DateRRuleParseUtility, DateRRuleUtility, DateRange, DateRangeParams, DateRangeType, DateSet, DateTimeMinuteInstance, DateTimeUtilityInstance, DateTimezoneUtcNormalInstance, IsKnownTimezone, IsValidDateCellRange, IsValidDateCellRangeSeries, IsValidDateCellTiming, IterateDaysInDateRangeFunctionBailError, LastIterResult, LimitDateTimeInstance, MAX_FUTURE_DATE, ModelRecurrenceInfo, ModelRecurrenceInfoUtility, NextIterResult, RRuleStringSplitter, SYSTEM_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, UNKNOWN_YEAR_WEEK_CODE, UTC_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, allIndexesInDateCellRange, allIndexesInDateCellRanges, allKnownTimezoneStrings, allTimezoneInfos, allTimezoneStrings, anyHaveExpired, atleastOneNotExpired, baseDateToTargetDate, calculateAllConversions, calculateExpectedDateCellTimingDuration, calculateExpectedDateCellTimingDurationPair, calculateTimezoneOffset, calendarDate, calendarDateFactory, calendarDateForDateDurationSpan, changeDateCellScheduleDateRangeToTimezone, changeDateCellScheduleDateRangeToTimezoneFunction, clampDateFunction, clampDateRangeFunction, clampDateRangeToDateRange, clampDateToDateRange, copyDateCellScheduleDateFilterConfig, copyHoursAndMinutesFromDate, copyHoursAndMinutesFromDateToToday, copyHoursAndMinutesFromDateWithTimezoneNormal, copyHoursAndMinutesFromNow, copyHoursAndMinutesFromNowWithTimezoneNormal, copyHoursAndMinutesFromUTCDate, copyHoursAndMinutesToDate, copyHoursAndMinutesToToday, dateCell, dateCellDayOfWeekFactory, dateCellDayTimingInfoFactory, dateCellDurationSpanHasEndedFilterFunction, dateCellDurationSpanHasNotEndedFilterFunction, dateCellDurationSpanHasNotStartedFilterFunction, dateCellDurationSpanHasStartedFilterFunction, dateCellEndIndex, dateCellIndexRange, dateCellIndexRangeToDateCellRange, dateCellIndexYearWeekCodeFactory, dateCellIndexYearWeekCodeGroupFactory, dateCellIndexsForDateCellScheduleDayCodes, dateCellRange, dateCellRangeBlocksCount, dateCellRangeBlocksCountInfo, dateCellRangeHasRange, dateCellRangeIncludedByRangeFunction, dateCellRangeOfTiming, dateCellRangeOfTimingFactory, dateCellRangeOverlapsRange, dateCellRangeOverlapsRangeFunction, dateCellRangeToDateCellIndexRange, dateCellRangeWithRange, dateCellRangeWithRangeFromIndex, dateCellRangesFullyCoverDateCellRangeFunction, dateCellScheduleDateCellTimingFilter, dateCellScheduleDateFilter, dateCellScheduleDateRange, dateCellScheduleDayCodeFactory, dateCellScheduleDayCodesAreSetsEquivalent, dateCellScheduleDayCodesFromEnabledDays, dateCellScheduleDayCodesSetFromDaysOfWeek, dateCellScheduleEncodedWeek, dateCellTiming, dateCellTimingCompletedTimeRange, dateCellTimingDateFactory, dateCellTimingDateRange, dateCellTimingEndDateFactory, dateCellTimingEndIndex, dateCellTimingEventRange, dateCellTimingExpansionFactory, dateCellTimingFinalStartsAtEvent, dateCellTimingFromDateCellTimingStartsAtEndRange, dateCellTimingLatestCompletedIndex, dateCellTimingRelativeIndexArrayFactory, dateCellTimingRelativeIndexFactory, dateCellTimingStart, dateCellTimingStartDateFactory, dateCellTimingStartPair, dateCellTimingStartsAtDateFactory, dateCellTimingStartsAtForStartOfDay, dateCellTimingTimezoneNormalInstance, dateDurationSpanEndDate, dateFromDateOrTimeNumber, dateFromLogicalDate, dateInterval, dateMonthDayStringFormat, dateOrDateRangeToDateRange, dateOrDayStringRangeToDateRange, dateOrDayStringRangeToISO8601DayStringRange, dateRange, dateRangeDaysCount, dateRangeOverlapsDateRange, dateRangeOverlapsDateRangeFunction, dateRangeRelativeState, dateRelativeStateForDateCellRangeComparedToIndex, dateShortDateAndTimeStringFormat, dateShortDateStringFormat, dateTimeInstance, dateTimeInstanceUtc, dateTimeMinuteDecisionFunction, dateTimeMinuteWholeDayDecisionFunction, dateTimeStringFormat, dateTimezoneUtcNormal, daysToMinutes, durationSpanDateRelativeState, durationSpanToDateRange, earliestDate, enabledDaysFromDateCellScheduleDayCodes, endItreateDaysInDateRangeEarly, expandDateCellCollection, expandDateCellRange, expandDateCellSchedule, expandDateCellScheduleDayCodes, expandDateCellScheduleDayCodesToDayCodesSet, expandDateCellScheduleDayCodesToDayOfWeekSet, expandDateCellScheduleFactory, expandDateCellScheduleRange, expandDateCellScheduleRangeToDateCellRanges, expandDateCellTiming, expandDaysForDateRange, expandDaysForDateRangeFunction, expandUniqueDateCellsFunction, filterDateCellsInDateCellRange, findMaxDate, findMinDate, fitDateRangeToDayPeriod, fitDateRangeToDayPeriodFunction, fitUTCDateRangeToDayPeriod, forEachDayInDateRange, formatDateDistance, formatDateRange, formatDateRangeDistance, formatDateRangeDistanceFunction, formatDateRangeFunction, formatStartedEndedDistanceString, formatToDateString, formatToDayRangeString, formatToDayTimeRangeString, formatToISO8601DateString, formatToISO8601DayString, formatToISO8601DayStringForSystem, formatToISO8601DayStringForUTC, formatToMonthDayString, formatToShortDateAndTimeString, formatToShortDateString, formatToTimeAndDurationString, formatToTimeRangeString, formatToTimeString, fractionalHoursInDurationSpan, fullDateCellScheduleRange, fullDateCellTiming, fullDateCellTimingTimezonePair, fullWeekDateCellScheduleDayCodes, getCurrentSystemOffsetInHours, getCurrentSystemOffsetInMinutes, getCurrentSystemOffsetInMs, getDateCellTimingFirstEventDateRange, getDateCellTimingHoursInEvent, getDaysOfWeekInDateRange, getExpiration, getGreatestDateCellIndexInDateCellRanges, getLeastAndGreatestDateCellIndexInDateCellRanges, getLeastDateCellIndexInDateCellRanges, getNextDateCellTimingIndex, getRelativeDateForDateCellTiming, getRelativeIndexForDateCellTiming, getTimeAM, getTimezoneAbbreviation, getTimezoneLongName, groupDateRangesByDateRelativeState, groupToDateCellRanges, groupUniqueDateCells, guessCurrentTimezone, hasExpired, hoursToMs, inverseDateTimezoneUtcNormalInstanceTransformType, isAfter, isDate, isDateCellRange, isDateCellSchedule, isDateCellScheduleDateRange, isDateCellScheduleEncodedWeek, isDateCellScheduleStartOfDayDateRange, isDateCellTiming, isDateCellTimingRelativeIndexFactory, isDateCellWithinDateCellRange, isDateCellWithinDateCellRangeFunction, isDateInDateRange, isDateInDateRangeFunction, isDateRange, isDateRangeInDateRange, isDateRangeInDateRangeFunction, isDateRangeStart, isDateWithinDateCellRangeFunction, isEmptyDateCellScheduleEncodedWeek, isFullDateCellScheduleDateRange, isFullDateCellTiming, isFullDateRange, isInfiniteDateRange, isKnownTimezone, isLogicalDateStringCode, isMaxFutureDate, isPartialDateRange, isSameDate, isSameDateCellSchedule, isSameDateCellScheduleDateRange, isSameDateCellScheduleEventRange, isSameDateCellTiming, isSameDateCellTimingEventStartsAtEndRange, isSameDateDay, isSameDateDayRange, isSameDateHoursAndMinutes, isSameDateRange, isSameDateTimezoneConversionConfig, isSameDurationSpan, isSameFullDateCellScheduleDateRange, isSameFullDateCellTiming, isStartOfDayForSystem, isStartOfDayInUTC, isValidDateCellIndex, isValidDateCellRange, isValidDateCellRangeSeries, isValidDateCellTiming, isValidDateCellTimingInfo, isValidDateCellTimingStartDate, isValidDateFromTimestringResult, isValidDateTimezoneConversionConfig, isValidFullDateCellTiming, isValidFullDateCellTimingInfo, iterateDaysInDateRange, iterateDaysInDateRangeFunction, latestDate, latestMinute, limitDateTime, limitDateTimeInstance, logicalDateStringCodeDateFactory, makeDateQueryForDateItemRangeFilter, makeDateQueryForDateStartsEndsFilter, makeDateQueryForOccuringFilter, makeDaysAndTimeFiltersFunction, makeMongoDBLikeDateQueryBuilder, maxFutureDate, mergeMongoDBLikeRangeFilters, minutesToMs, modifyDateCellToFitRange, modifyDateCellsToFitRange, modifyDateCellsToFitRangeFunction, msToMinutes, msToSeconds, nowInterval, parseISO8601DayStringToDate, parseJsDateString, parseReadableTimeString, rawDateCellScheduleDayCodes, readDaysOfWeek, readDaysOfWeekNames, readableTimeStringToDate, reduceDatesFunction, requireCurrentTimezone, roundDateTimeDown, roundDateTimeDownToSteps, roundDownToHour, roundDownToMinute, roundToMinuteSteps, safeFormatToISO8601DateString, safeToJsDate, searchTimezoneInfos, shiftDateCellTimingToSystemTimezone, shiftDateCellTimingToTimezone, shiftDateCellTimingToTimezoneFunction, shiftDateCellTimingToUTCTimezone, simplifyDateCellScheduleDayCodes, skipAfterExpiration, skipExpired, skipUntilExpiration, skipUntilTimeElapsedAfterLastEmission, sortByDateFunction, sortByISO8601DateStringFunction, sortByISO8601DateStrings, sortDateCellRangeAndSizeFunction, sortDateCellRanges, sortDateRangeStartAscendingCompareFunction, startOfDayInTimezoneDayStringFactory, startOfDayInTimezoneFromISO8601DayString, startOfWeekForYearWeekCode, systemBaseDateToNormalDate, systemBaseDateToNormalDateOffset, systemDateTimezoneUtcNormal, systemExperiencesDaylightSavings, systemNormalDateToBaseDate, systemNormalDateToBaseDateOffset, takeAfterTimeElapsedSinceLastEmission, takeNextUpcomingTime, targetDateToBaseDate, timeHasExpired, timezoneInfoForSystem, timezoneStringToSearchableString, timezoneStringToTimezoneInfo, toExpiration, toExpires, toISO8601DayString, toISO8601DayStringForSystem, toISO8601DayStringForUTC, toISODateString, toJsDate, toJsDayDate, toLocalReadableTimeString, toReadableTimeString, transformDateInTimezoneNormalFunction, transformDateRangeDatesFunction, transformDateRangeInTimezoneNormalFunction, transformDateRangeToTimezoneFunction, transformDateRangeWithStartOfDay, unixTimeNumberForNow, unixTimeNumberFromDate, unixTimeNumberFromDateOrTimeNumber, unixTimeNumberToDate, updateDateCellTimingToSystemTimezone, updateDateCellTimingToTimezone, updateDateCellTimingToTimezoneFunction, updateDateCellTimingToUTCTimezone, updateDateCellTimingWithDateCellTimingEvent, utcDayForDate, weekdayDateCellScheduleDayCodes, weekendDateCellScheduleDayCodes, yearWeekCode, yearWeekCodeDateFactory, yearWeekCodeDateTimezoneInstance, yearWeekCodeFactory, yearWeekCodeForCalendarMonth, yearWeekCodeForCalendarMonthFactory, yearWeekCodeForDateRange, yearWeekCodeForDateRangeFactory, yearWeekCodeForDateRangeInTimezone, yearWeekCodeFromDate, yearWeekCodeFromPair, yearWeekCodeGroupFactory, yearWeekCodeIndex, yearWeekCodePair, yearWeekCodePairFromDate };
+export { AnyIterResult, CalendarDate, CalendarDateType, DATE_CELL_SCHEDULE_ENCODED_WEEK_REGEX, DATE_TODAY_END_VALUE, DATE_TODAY_START_VALUE, DATE_WEEK_END_VALUE, DATE_WEEK_START_VALUE, DEFAULT_EXPAND_DAYS_FOR_DATE_RANGE_MAX_EXPANSION_SIZE, DEFAULT_FULL_DATE_SCHEDULE_RANGE_DURATION, DEFAULT_ITERATE_DAYS_IN_DATE_RANGE_MAX_ITERATIONS, DEFAULT_LAST_ITER_RESULT_MAX_ITERATIONS_ALLOWED, DateCell, DateCellRange, DateCellSchedule, DateCellScheduleDayCode, DateCellTiming, DateDurationSpan, DateRRule, DateRRuleInstance, DateRRuleParseUtility, DateRRuleUtility, DateRange, DateRangeParams, DateRangeType, DateSet, DateTimeMinuteInstance, DateTimeUtilityInstance, DateTimezoneUtcNormalInstance, IsKnownTimezone, IsValidDateCellRange, IsValidDateCellRangeSeries, IsValidDateCellTiming, IterateDaysInDateRangeFunctionBailError, LastIterResult, LimitDateTimeInstance, MAX_FUTURE_DATE, ModelRecurrenceInfo, ModelRecurrenceInfoUtility, NextIterResult, RRuleStringSplitter, SYSTEM_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, UNKNOWN_YEAR_WEEK_CODE, UTC_DATE_TIMEZONE_UTC_NORMAL_INSTANCE, allIndexesInDateCellRange, allIndexesInDateCellRanges, allKnownTimezoneStrings, allTimezoneInfos, allTimezoneStrings, anyHaveExpired, atleastOneNotExpired, baseDateToTargetDate, calculateAllConversions, calculateExpectedDateCellTimingDuration, calculateExpectedDateCellTimingDurationPair, calculateTimezoneOffset, calendarDate, calendarDateFactory, calendarDateForDateDurationSpan, changeDateCellScheduleDateRangeToTimezone, changeDateCellScheduleDateRangeToTimezoneFunction, clampDateFunction, clampDateRangeFunction, clampDateRangeToDateRange, clampDateToDateRange, copyDateCellScheduleDateFilterConfig, copyHoursAndMinutesFromDate, copyHoursAndMinutesFromDateToToday, copyHoursAndMinutesFromDateWithTimezoneNormal, copyHoursAndMinutesFromNow, copyHoursAndMinutesFromNowWithTimezoneNormal, copyHoursAndMinutesFromUTCDate, copyHoursAndMinutesToDate, copyHoursAndMinutesToToday, dateCell, dateCellDayOfWeekFactory, dateCellDayTimingInfoFactory, dateCellDurationSpanHasEndedFilterFunction, dateCellDurationSpanHasNotEndedFilterFunction, dateCellDurationSpanHasNotStartedFilterFunction, dateCellDurationSpanHasStartedFilterFunction, dateCellEndIndex, dateCellIndexRange, dateCellIndexRangeToDateCellRange, dateCellIndexYearWeekCodeFactory, dateCellIndexYearWeekCodeGroupFactory, dateCellIndexsForDateCellScheduleDayCodes, dateCellRange, dateCellRangeBlocksCount, dateCellRangeBlocksCountInfo, dateCellRangeHasRange, dateCellRangeIncludedByRangeFunction, dateCellRangeOfTiming, dateCellRangeOfTimingFactory, dateCellRangeOverlapsRange, dateCellRangeOverlapsRangeFunction, dateCellRangeToDateCellIndexRange, dateCellRangeWithRange, dateCellRangeWithRangeFromIndex, dateCellRangesFullyCoverDateCellRangeFunction, dateCellScheduleDateCellTimingFilter, dateCellScheduleDateFilter, dateCellScheduleDateRange, dateCellScheduleDayCodeFactory, dateCellScheduleDayCodesAreSetsEquivalent, dateCellScheduleDayCodesFromEnabledDays, dateCellScheduleDayCodesSetFromDaysOfWeek, dateCellScheduleEncodedWeek, dateCellTiming, dateCellTimingCompletedTimeRange, dateCellTimingDateFactory, dateCellTimingDateRange, dateCellTimingEndDateFactory, dateCellTimingEndIndex, dateCellTimingEventRange, dateCellTimingExpansionFactory, dateCellTimingFinalStartsAtEvent, dateCellTimingFromDateCellTimingStartsAtEndRange, dateCellTimingLatestCompletedIndex, dateCellTimingRelativeIndexArrayFactory, dateCellTimingRelativeIndexFactory, dateCellTimingStart, dateCellTimingStartDateFactory, dateCellTimingStartPair, dateCellTimingStartsAtDateFactory, dateCellTimingStartsAtForStartOfDay, dateCellTimingTimezoneNormalInstance, dateDurationSpanEndDate, dateFromDateOrTimeNumber, dateFromLogicalDate, dateInterval, dateMonthDayStringFormat, dateOrDateRangeToDateRange, dateOrDayStringRangeToDateRange, dateOrDayStringRangeToISO8601DayStringRange, dateRange, dateRangeDaysCount, dateRangeOverlapsDateRange, dateRangeOverlapsDateRangeFunction, dateRangeRelativeState, dateRelativeStateForDateCellRangeComparedToIndex, dateShortDateAndTimeStringFormat, dateShortDateStringFormat, dateTimeInstance, dateTimeInstanceUtc, dateTimeMinuteDecisionFunction, dateTimeMinuteWholeDayDecisionFunction, dateTimeStringFormat, dateTimezoneUtcNormal, daysToMinutes, durationSpanDateRelativeState, durationSpanToDateRange, earliestDate, enabledDaysFromDateCellScheduleDayCodes, endItreateDaysInDateRangeEarly, expandDateCellCollection, expandDateCellRange, expandDateCellSchedule, expandDateCellScheduleDayCodes, expandDateCellScheduleDayCodesToDayCodesSet, expandDateCellScheduleDayCodesToDayOfWeekSet, expandDateCellScheduleFactory, expandDateCellScheduleRange, expandDateCellScheduleRangeToDateCellRanges, expandDateCellTiming, expandDaysForDateRange, expandDaysForDateRangeFunction, expandUniqueDateCellsFunction, filterDateCellsInDateCellRange, findMaxDate, findMinDate, findNextDateInDateCellScheduleFilter, fitDateRangeToDayPeriod, fitDateRangeToDayPeriodFunction, fitUTCDateRangeToDayPeriod, forEachDayInDateRange, formatDateDistance, formatDateRange, formatDateRangeDistance, formatDateRangeDistanceFunction, formatDateRangeFunction, formatStartedEndedDistanceString, formatToDateString, formatToDayRangeString, formatToDayTimeRangeString, formatToISO8601DateString, formatToISO8601DayString, formatToISO8601DayStringForSystem, formatToISO8601DayStringForUTC, formatToMonthDayString, formatToShortDateAndTimeString, formatToShortDateString, formatToTimeAndDurationString, formatToTimeRangeString, formatToTimeString, fractionalHoursInDurationSpan, fullDateCellScheduleRange, fullDateCellTiming, fullDateCellTimingTimezonePair, fullWeekDateCellScheduleDayCodes, getCurrentSystemOffsetInHours, getCurrentSystemOffsetInMinutes, getCurrentSystemOffsetInMs, getDateCellTimingFirstEventDateRange, getDateCellTimingHoursInEvent, getDaysOfWeekInDateRange, getExpiration, getGreatestDateCellIndexInDateCellRanges, getLeastAndGreatestDateCellIndexInDateCellRanges, getLeastDateCellIndexInDateCellRanges, getNextDateCellTimingIndex, getRelativeDateForDateCellTiming, getRelativeIndexForDateCellTiming, getTimeAM, getTimezoneAbbreviation, getTimezoneLongName, groupDateRangesByDateRelativeState, groupToDateCellRanges, groupUniqueDateCells, guessCurrentTimezone, hasExpired, hoursToMs, inverseDateTimezoneUtcNormalInstanceTransformType, isAfter, isDate, isDateCellRange, isDateCellSchedule, isDateCellScheduleDateRange, isDateCellScheduleEncodedWeek, isDateCellScheduleStartOfDayDateRange, isDateCellTiming, isDateCellTimingRelativeIndexFactory, isDateCellWithinDateCellRange, isDateCellWithinDateCellRangeFunction, isDateInDateRange, isDateInDateRangeFunction, isDateRange, isDateRangeInDateRange, isDateRangeInDateRangeFunction, isDateRangeStart, isDateWithinDateCellRangeFunction, isEmptyDateCellScheduleEncodedWeek, isFullDateCellScheduleDateRange, isFullDateCellTiming, isFullDateRange, isInfiniteDateRange, isKnownTimezone, isLogicalDateStringCode, isMaxFutureDate, isPartialDateRange, isSameDate, isSameDateCellSchedule, isSameDateCellScheduleDateRange, isSameDateCellScheduleEventRange, isSameDateCellTiming, isSameDateCellTimingEventStartsAtEndRange, isSameDateDay, isSameDateDayRange, isSameDateHoursAndMinutes, isSameDateRange, isSameDateTimezoneConversionConfig, isSameDurationSpan, isSameFullDateCellScheduleDateRange, isSameFullDateCellTiming, isStartOfDayForSystem, isStartOfDayInUTC, isValidDateCellIndex, isValidDateCellRange, isValidDateCellRangeSeries, isValidDateCellTiming, isValidDateCellTimingInfo, isValidDateCellTimingStartDate, isValidDateFromTimestringResult, isValidDateTimezoneConversionConfig, isValidFullDateCellTiming, isValidFullDateCellTimingInfo, iterateDaysInDateRange, iterateDaysInDateRangeFunction, latestDate, latestMinute, limitDateTime, limitDateTimeInstance, logicalDateStringCodeDateFactory, makeDateQueryForDateItemRangeFilter, makeDateQueryForDateStartsEndsFilter, makeDateQueryForOccuringFilter, makeDaysAndTimeFiltersFunction, makeMongoDBLikeDateQueryBuilder, maxFutureDate, mergeMongoDBLikeRangeFilters, minutesToMs, modifyDateCellToFitRange, modifyDateCellsToFitRange, modifyDateCellsToFitRangeFunction, msToMinutes, msToSeconds, nowInterval, parseISO8601DayStringToDate, parseJsDateString, parseReadableTimeString, rawDateCellScheduleDayCodes, readDaysOfWeek, readDaysOfWeekNames, readableTimeStringToDate, reduceDatesFunction, requireCurrentTimezone, roundDateTimeDown, roundDateTimeDownToSteps, roundDownToHour, roundDownToMinute, roundToMinuteSteps, safeFormatToISO8601DateString, safeToJsDate, searchTimezoneInfos, shiftDateCellTimingToSystemTimezone, shiftDateCellTimingToTimezone, shiftDateCellTimingToTimezoneFunction, shiftDateCellTimingToUTCTimezone, simplifyDateCellScheduleDayCodes, skipAfterExpiration, skipExpired, skipUntilExpiration, skipUntilTimeElapsedAfterLastEmission, sortByDateFunction, sortByISO8601DateStringFunction, sortByISO8601DateStrings, sortDateCellRangeAndSizeFunction, sortDateCellRanges, sortDateRangeStartAscendingCompareFunction, startOfDayInTimezoneDayStringFactory, startOfDayInTimezoneFromISO8601DayString, startOfWeekForYearWeekCode, systemBaseDateToNormalDate, systemBaseDateToNormalDateOffset, systemDateTimezoneUtcNormal, systemExperiencesDaylightSavings, systemNormalDateToBaseDate, systemNormalDateToBaseDateOffset, takeAfterTimeElapsedSinceLastEmission, takeNextUpcomingTime, targetDateToBaseDate, timeHasExpired, timezoneInfoForSystem, timezoneStringToSearchableString, timezoneStringToTimezoneInfo, toExpiration, toExpires, toISO8601DayString, toISO8601DayStringForSystem, toISO8601DayStringForUTC, toISODateString, toJsDate, toJsDayDate, toLocalReadableTimeString, toReadableTimeString, transformDateInTimezoneNormalFunction, transformDateRangeDatesFunction, transformDateRangeInTimezoneNormalFunction, transformDateRangeToTimezoneFunction, transformDateRangeWithStartOfDay, unixTimeNumberForNow, unixTimeNumberFromDate, unixTimeNumberFromDateOrTimeNumber, unixTimeNumberToDate, updateDateCellTimingToSystemTimezone, updateDateCellTimingToTimezone, updateDateCellTimingToTimezoneFunction, updateDateCellTimingToUTCTimezone, updateDateCellTimingWithDateCellTimingEvent, utcDayForDate, weekdayDateCellScheduleDayCodes, weekendDateCellScheduleDayCodes, yearWeekCode, yearWeekCodeDateFactory, yearWeekCodeDateTimezoneInstance, yearWeekCodeFactory, yearWeekCodeForCalendarMonth, yearWeekCodeForCalendarMonthFactory, yearWeekCodeForDateRange, yearWeekCodeForDateRangeFactory, yearWeekCodeForDateRangeInTimezone, yearWeekCodeFromDate, yearWeekCodeFromPair, yearWeekCodeGroupFactory, yearWeekCodeIndex, yearWeekCodePair, yearWeekCodePairFromDate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/date",
-  "version": "10.1.4",
+  "version": "10.1.6",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

package/src/lib/date/date.cell.d.ts

@@ -20,6 +20,12 @@ export declare function isValidDateCellIndex(input: DateCellIndex): boolean;
  * Input type that is either a Date or a DateCellIndex.
  */
 export type DateOrDateCellIndex = Date | DateCellIndex;
+/**
+ * A date and the relative date index.
+ */
+export interface DateCellIndexDatePair extends Readonly<IndexRef> {
+    readonly date: Date;
+}
 /**
  * A duration-span block.
  */

package/src/lib/date/date.cell.factory.d.ts

@@ -159,59 +159,65 @@ export interface DateCellDayTimingInfo {
     /**
      * Input date or calculated date if provided a dayIndex.
      */
-    date: Date;
+    readonly date: Date;
     /**
      * Index for the day for the input date.
      */
-    dayIndex: DateCellIndex;
+    readonly dayIndex: DateCellIndex;
     /**
      * Index for the previous index/current index depending on the TimingInfo's daily execution.
      *
      * If the index is currently in progress given the timing, this will return the dayIndex.
      */
-    currentIndex: DateCellIndex;
+    readonly currentIndex: DateCellIndex;
     /**
      * Index for the next execution. Does not check if it is in range.
      *
      * If the index is currently in progress given the timing, this will return the dayIndex + 1.
      */
-    nextIndex: DateCellIndex;
+    readonly nextIndex: DateCellIndex;
     /**
      * Index for the next execution, if in the range, otherwise undefined.
      *
      * If the index is currently in progress given the timing, this will return the dayIndex + 1.
      */
-    nextIndexInRange: Maybe<DateCellIndex>;
+    readonly nextIndexInRange: Maybe<DateCellIndex>;
     /**
      * Whether or not there are any inProgress or upcoming executions.
      *
      * True if nextIndexInRange is undefined and isInProgress is false.
      */
-    isComplete: boolean;
+    readonly isComplete: boolean;
     /**
      * Whether or not today's timing has already occured in it's entirety.
      */
-    hasOccuredToday: boolean;
+    readonly hasOccuredToday: boolean;
     /**
-     * Whether or not today's timing is currently in progress.
+     * Whether or not a timing is currently in progress.
+     *
+     * This can be true when isInProgressForDayIndex is false for cases where the timing starts at the previous day index and rolls on over into the next day.
+     */
+    readonly isInProgress: boolean;
+    /**
+     * Whether or not today's timing is currently in progress for the input dayIndex.
      */
-    isInProgress: boolean;
+    readonly isInProgressForDayIndex: boolean;
     /**
      * Whether or not the block is within the configured range.
      */
-    isInRange: boolean;
+    readonly isInRange: boolean;
     /**
      * Time the timing starts on the input day.
      */
-    startsAtOnDay: Date;
+    readonly startsAtOnDay: Date;
     /**
      * Time the timing ends on the input day.
      */
-    endsAtOnDay: Date;
+    readonly endsAtOnDay: Date;
     /**
      * "now" value used for considering current progress.
      */
-    now: Date;
+    readonly now: Date;
 }
 /**
  * Generates DateCellDayTimingInfo about the input date relative to the input timing and range limit.
@@ -276,7 +282,7 @@ export declare function getRelativeIndexForDateCellTiming(timing: DateCellTiming
  *
  * Returns a date with the hours and minutes for "now" for the given date returned if an index is input.
  */
-export type DateCellTimingDateFactory<T extends DateCellTimingStartsAt = DateCellTimingStartsAt> = ((input: DateOrDateCellIndex) => Date) & {
+export type DateCellTimingDateFactory<T extends DateCellTimingStartsAt = DateCellTimingStartsAt> = ((input: DateOrDateCellIndex, now?: Date) => Date) & {
     readonly _timing: T;
 };
 /**

package/src/lib/date/date.cell.schedule.d.ts

@@ -1,7 +1,7 @@
 import { type DateRange } from '@dereekb/date';
-import { type StringOrder, type Maybe, type DayOfWeek, type DecisionFunction, type FilterFunction, type IndexRange, type EnabledDays, type ArrayOrValue, type TimezoneStringRef } from '@dereekb/util';
-import { type DateCell, type DateCellDurationSpan, type DateCellIndex, type DateCellTiming, type DateCellTimingDateRange, type DateCellTimingStartsAtEndRange, type FullDateCellTiming, type DateCellTimingEventStartsAt, type DateCellTimingTimezoneInput } from './date.cell';
-import { type DateCellTimingRelativeIndexFactoryInput, type DateCellTimingExpansionFactory } from './date.cell.factory';
+import { type StringOrder, type Maybe, type DayOfWeek, type DecisionFunction, type FilterFunction, type IndexRange, type EnabledDays, type ArrayOrValue, type TimezoneStringRef, type Days, type DateRelativeDirection } from '@dereekb/util';
+import { type DateCell, type DateCellDurationSpan, type DateCellIndex, type DateCellTiming, type DateCellTimingDateRange, type DateCellTimingStartsAtEndRange, type FullDateCellTiming, type DateCellTimingEventStartsAt, type DateCellTimingTimezoneInput, type DateCellIndexDatePair } from './date.cell';
+import { type DateCellTimingRelativeIndexFactoryInput, type DateCellTimingExpansionFactory, type DateCellTimingRelativeIndexFactory } from './date.cell.factory';
 import { type DateCellRangeOrDateRange, type DateCellRangeWithRange } from './date.cell.index';
 import { type DateTimezoneUtcNormalInstance } from './date.timezone';
 import { type YearWeekCodeConfig } from './date.week';
@@ -309,7 +309,9 @@ export type DateCellScheduleDateFilterInput = DateCellTimingRelativeIndexFactory
 /**
  * Returns true if the date falls within the schedule.
  */
-export type DateCellScheduleDateFilter = DecisionFunction<DateCellScheduleDateFilterInput>;
+export type DateCellScheduleDateFilter = DecisionFunction<DateCellScheduleDateFilterInput> & {
+    readonly _dateCellTimingRelativeIndexFactory: DateCellTimingRelativeIndexFactory;
+};
 /**
  * dateCellScheduleDateFilter() configuration.
  */
@@ -317,11 +319,11 @@ export interface DateCellScheduleDateFilterConfig extends DateCellSchedule, Part
     /**
      * The min/max date range for the filter.
      */
-    minMaxDateRange?: Maybe<Partial<DateCellRangeOrDateRange>>;
+    readonly minMaxDateRange?: Maybe<Partial<DateCellRangeOrDateRange>>;
     /**
      * Whether or not to restrict the start as the min date if a min date is not set in minMaxDateRange. True by default.
      */
-    setStartAsMinDate?: boolean;
+    readonly setStartAsMinDate?: boolean;
 }
 export declare function copyDateCellScheduleDateFilterConfig(inputFilter: DateCellScheduleDateFilterConfig): DateCellScheduleDateFilterConfig;
 /**
@@ -331,6 +333,24 @@ export declare function copyDateCellScheduleDateFilterConfig(inputFilter: DateCe
  * @returns
  */
 export declare function dateCellScheduleDateFilter(config: DateCellScheduleDateFilterConfig): DateCellScheduleDateFilter;
+export interface FindNextDateInDateCellScheduleFilterInput {
+    readonly date: DateCellScheduleDateFilterInput;
+    readonly filter: DateCellScheduleDateFilter;
+    readonly direction: DateRelativeDirection;
+    readonly maxDistance: Days;
+    /**
+     * Whether or not to exclude the input date. False by default.
+     */
+    readonly excludeInputDate?: boolean;
+}
+/**
+ * Passes a number of day values until it reaches an open day on a schedule. There's a maximum distance it searches in a direction before returning null.
+ *
+ * @param date
+ * @param filter
+ * @param maxDistance
+ */
+export declare function findNextDateInDateCellScheduleFilter(config: FindNextDateInDateCellScheduleFilterInput): Maybe<DateCellIndexDatePair>;
 export type DateCellScheduleDateCellTimingFilter<B extends DateCell = DateCell> = DecisionFunction<B>;
 /**
  * Configuration for dateCellScheduleDateCellTimingFilter()
@@ -355,11 +375,11 @@ export interface DateCellScheduleDateCellTimingFilterConfig {
      */
     now?: Date;
     /**
-     * (Optional) filters in blocks that have not yet started. Can be combined with the other filters.
+     * (Optional) filters in blocks that have started. Can be combined with the other filters.
      */
     onlyBlocksThatHaveStarted?: boolean;
     /**
-     * (Optional) filters in blocks that have not yet ended. Can be combined with the other filters.
+     * (Optional) filters in blocks that have ended. Can be combined with the other filters.
      */
     onlyBlocksThatHaveEnded?: boolean;
     /**

package/src/lib/date/date.time.minute.d.ts

@@ -1,33 +1,33 @@
-import { type Minutes, type DecisionFunction } from '@dereekb/util';
+import { type Minutes, type DecisionFunction, type DateRelativeDirection, type Days, type Maybe } from '@dereekb/util';
 import { type StepRoundDateTimeDown } from './date.round';
-import { type DateCellScheduleDateFilterConfig } from './date.cell.schedule';
+import { type DateCellScheduleDateFilterConfig, type DateCellScheduleDateFilterInput } from './date.cell.schedule';
 import { type LimitDateTimeConfig } from './date.time.limit';
 export interface DateTimeMinuteConfig extends LimitDateTimeConfig {
     /**
      * Default date to consider.
      */
-    date?: Date;
+    readonly date?: Date;
     /**
      * Number of minutes each "step" is.
      */
-    step?: Minutes;
+    readonly step?: Minutes;
     /**
      * Additional behavior
      */
-    behavior?: {
+    readonly behavior?: {
         /**
          * Whether or not to set the date to the min if the steps go above it.
          */
-        capToMinLimit?: boolean;
+        readonly capToMinLimit?: boolean;
         /**
          * Whether or not to set the date to the max if the steps go above it.
          */
-        capToMaxLimit?: boolean;
+        readonly capToMaxLimit?: boolean;
     };
     /**
      * Schedule to filter the days to.
      */
-    schedule?: DateCellScheduleDateFilterConfig;
+    readonly schedule?: DateCellScheduleDateFilterConfig;
 }
 /**
  * Current state of the date in the instance.
@@ -36,30 +36,30 @@ export interface DateTimeMinuteDateStatus {
     /**
      * If the date is at the minimum value.
      */
-    isAfterMinimum: boolean;
+    readonly isAfterMinimum: boolean;
     /**
      * If thte date is at the maximum value.
      */
-    isBeforeMaximum: boolean;
+    readonly isBeforeMaximum: boolean;
     /**
      * If the date is in the future.
      */
-    inFuture: boolean;
+    readonly inFuture: boolean;
     /**
      * If the date is in the future at the minimum number of future minutes requested.
      */
-    inFutureMinutes: boolean;
+    readonly inFutureMinutes: boolean;
     /**
      * If the date is in the past.
      */
-    inPast: boolean;
+    readonly inPast: boolean;
     /**
      * If the date is on a schedule day.
      */
-    isInSchedule: boolean;
+    readonly isInSchedule: boolean;
 }
 export interface RoundDateTimeMinute extends StepRoundDateTimeDown {
-    roundToBound?: boolean;
+    readonly roundToBound?: boolean;
 }
 /**
  * Instance for working with a single date/time.
@@ -93,7 +93,11 @@ export declare class DateTimeMinuteInstance {
     isValid(date?: Date): boolean;
     getStatus(date?: Date): DateTimeMinuteDateStatus;
     round(round: RoundDateTimeMinute): Date;
-    clamp(date?: Date): Date;
+    clamp(date?: Date, maxClampDistance?: Days): Date;
+    clampToLimit(date?: Date): Date;
+    clampToSchedule(date?: Date, maxClampDistance?: Days): Date;
+    findNextAvailableDayInSchedule(date: DateCellScheduleDateFilterInput, direction: DateRelativeDirection, maxDistance?: Days): Maybe<Date>;
+    isInSchedule(date: DateCellScheduleDateFilterInput): boolean;
     protected _takeBoundedDate(date?: Date): Date;
     protected _takeMinimumBoundedDate(date?: Date): Date;
     protected _takeMaximumBoundedDate(date?: Date): Date;