@dereekb/date 9.24.47 → 9.25.0

package/src/lib/date/date.block.js

@@ -12,9 +12,11 @@ const class_transformer_1 = require("class-transformer");
 const date_timezone_1 = require("./date.timezone");
 const class_validator_1 = require("class-validator");
 const date_format_1 = require("./date.format");
+const date_range_timezone_1 = require("./date.range.timezone");
 /**
  * Returns true if the index is a non-negative integer.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  */
 function isValidDateBlockIndex(input) {
@@ -38,6 +40,7 @@ exports.DateBlock = DateBlock;
 /**
  * Converts the input number or DateBlock to a DateBlock.
  *
+ * @deprecated use DateCell implementation instead.
  * @param dateBlockOrIndex
  * @returns
  */
@@ -49,10 +52,14 @@ exports.dateBlock = dateBlock;
  * The maximum number of hours that a DateBlockTiming's start can be offset. This means a max timezone of UTC+12.
  *
  * The timezones UTC+13 and UTC+14 are not supported, and will experience undetermined behavior.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 exports.MAX_DATE_BLOCK_TIMING_OFFSET_HOURS = 12;
 /**
  * The minimum number of hours that a DateBlockTiming's start can be offset. This means a min timezone of UTC-12.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 exports.MIN_DATE_BLOCK_TIMING_OFFSET_HOURS = -12;
 class DateBlockTiming extends date_duration_1.DateDurationSpan {
@@ -76,10 +83,16 @@ tslib_1.__decorate([
     (0, class_transformer_1.Type)(() => Date),
     tslib_1.__metadata("design:type", Date)
 ], DateBlockTiming.prototype, "end", void 0);
+tslib_1.__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    tslib_1.__metadata("design:type", String)
+], DateBlockTiming.prototype, "timezone", void 0);
 exports.DateBlockTiming = DateBlockTiming;
 /**
  * Returns true if the two timings are equivalent.
  *
+ * @deprecated use DateCell implementation instead.
  * @param a
  * @param b
  */
@@ -90,6 +103,7 @@ exports.isSameDateBlockTiming = isSameDateBlockTiming;
 /**
  * Returns the date range from the start of the first event to the end time of the last event.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
@@ -100,6 +114,7 @@ exports.dateBlockTimingFullRange = dateBlockTimingFullRange;
 /**
  * Returns the date range from the start of the first event to the end time of the last event.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
@@ -107,6 +122,12 @@ function dateBlockTimingEventRange(timing) {
     return { start: timing.startsAt, end: timing.end };
 }
 exports.dateBlockTimingEventRange = dateBlockTimingEventRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
 function getCurrentDateBlockTimingUtcData(timing) {
     const start = timing.start;
     const dateHours = start.getUTCHours();
@@ -122,6 +143,7 @@ exports.getCurrentDateBlockTimingUtcData = getCurrentDateBlockTimingUtcData;
 /**
  * The offset in milliseconds to the "real start date", the first second in the target day on in the system timezone.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  */
 function getCurrentDateBlockTimingOffsetData(timing) {
@@ -140,10 +162,22 @@ function getCurrentDateBlockTimingOffsetData(timing) {
     };
 }
 exports.getCurrentDateBlockTimingOffsetData = getCurrentDateBlockTimingOffsetData;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
 function getCurrentDateBlockTimingOffset(timing) {
     return getCurrentDateBlockTimingOffsetData(timing).offset;
 }
 exports.getCurrentDateBlockTimingOffset = getCurrentDateBlockTimingOffset;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timezone
+ * @returns
+ */
 function timingIsInExpectedTimezoneFunction(timezone) {
     const normal = (0, date_timezone_1.dateTimezoneUtcNormal)(timezone);
     return (timing) => {
@@ -154,6 +188,13 @@ function timingIsInExpectedTimezoneFunction(timezone) {
     };
 }
 exports.timingIsInExpectedTimezoneFunction = timingIsInExpectedTimezoneFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @param timezone
+ * @returns
+ */
 function timingIsInExpectedTimezone(timing, timezone) {
     return timingIsInExpectedTimezoneFunction(timezone)(timing);
 }
@@ -165,12 +206,13 @@ exports.timingIsInExpectedTimezone = timingIsInExpectedTimezone;
  * @returns
  */
 function getDateBlockTimingFirstEventDateRange(timing) {
-    return (0, date_range_1.fitDateRangeToDayPeriod)({ start: timing.startsAt, end: timing.end });
+    return (0, date_range_timezone_1.fitDateRangeToDayPeriod)({ start: timing.startsAt, end: timing.end });
 }
 exports.getDateBlockTimingFirstEventDateRange = getDateBlockTimingFirstEventDateRange;
 /**
  * Returns the fractional hours in the event.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
@@ -182,6 +224,7 @@ exports.getDateBlockTimingHoursInEvent = getDateBlockTimingHoursInEvent;
 /**
  * Creates a DateTimezoneUtcNormalInstance from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -194,6 +237,7 @@ exports.timingDateTimezoneUtcNormal = timingDateTimezoneUtcNormal;
 /**
  * Convenience function that extends timingDateTimezoneUtcNormal() but also asserts the that the timing matches it.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @param timing
  * @returns
@@ -206,12 +250,12 @@ function assertedTimingDateTimezoneUtcNormal(input, timing) {
     return timezoneInstance;
 }
 exports.assertedTimingDateTimezoneUtcNormal = assertedTimingDateTimezoneUtcNormal;
-function dateBlockTimingFromDateRangeAndEvent(dateBlockTimingStartEndRange, event, timezone) {
+function dateBlockTimingFromDateRangeAndEvent(dateBlockTimingStartEndRange, event) {
     const { start, end } = dateBlockTimingStartEndRange;
     const { startsAt: eventStartsAt, duration } = event;
     // need the timezone instance to compute against the normal and convert to the system time, before going back.
     // this is necessary because the start is a timezone normal for UTC, and the minutes need to be converted back properly adjusting for timezones.
-    const timezoneInstance = assertedTimingDateTimezoneUtcNormal(timezone !== null && timezone !== void 0 ? timezone : dateBlockTimingStartEndRange, dateBlockTimingStartEndRange);
+    const timezoneInstance = timingDateTimezoneUtcNormal(dateBlockTimingStartEndRange);
     // compute startsAt, the start time for the first event
     const startsAt = (0, date_timezone_1.copyHoursAndMinutesFromDateWithTimezoneNormal)(start, eventStartsAt, timezoneInstance);
     const timing = {
@@ -226,13 +270,20 @@ exports.dateBlockTimingFromDateRangeAndEvent = dateBlockTimingFromDateRangeAndEv
 function safeDateBlockTimingFromDateRangeAndEvent(dateBlockTimingStartEndRange, event, timezone) {
     const { start, end } = dateBlockTimingStartEndRange;
     const timezoneInstance = assertedTimingDateTimezoneUtcNormal(timezone !== null && timezone !== void 0 ? timezone : dateBlockTimingStartEndRange, dateBlockTimingStartEndRange);
-    const systemTimezoneEnd = timezoneInstance.systemDateToTargetDate(end); // normalize it so it is back in it's original timezone hours/minutes
-    const endNormal = (0, date_fns_1.startOfDay)(systemTimezoneEnd); // get the start of the day
-    const endDay = timezoneInstance.targetDateToSystemDate(endNormal); // get the end of the day
+    // const startDayFactory = dateBlockTimingStartDateFactory({ start }, timezoneInstance);
+    const endDay = end; // get midnight of the day the job usually ends at
     const endDayDateRange = { start, endDay };
     return _dateBlockTimingFromDateBlockTimingStartEndDayDateRange(endDayDateRange, event, timezoneInstance);
 }
 exports.safeDateBlockTimingFromDateRangeAndEvent = safeDateBlockTimingFromDateRangeAndEvent;
+/**
+ * Converts a DateBlockTimingStartEndDayDateRange and DateBlockTimingEvent to a DateBlockTiming. The event is used to derive the startsAt, duration and end time. The timezone offset is retained.
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param dateBlockTimingStartEndDayDateRange
+ * @param event
+ * @returns
+ */
 function dateBlockTimingFromDateBlockTimingStartEndDayDateRange(dateBlockTimingStartEndDayDateRange, event, timezone) {
     // need the timezone instance to compute against the normal and convert to the system time, before going back.
     // this is necessary because the start is a timezone normal for UTC, and the minutes need to be converted back properly adjusting for timezones.
@@ -246,6 +297,7 @@ exports.dateBlockTimingFromDateBlockTimingStartEndDayDateRange = dateBlockTiming
  *
  * See dateBlockTimingFromDateBlockTimingStartEndDayDateRange() for details.
  *
+ * @deprecated use DateCell implementation instead.
  * @param dateBlockTimingStartEndDayDateRange
  * @param event
  * @param timezoneInstance
@@ -257,18 +309,21 @@ function _dateBlockTimingFromDateBlockTimingStartEndDayDateRange(dateBlockTiming
     // compute startsAt, the start time for the first event
     const startsAt = (0, date_timezone_1.copyHoursAndMinutesFromDateWithTimezoneNormal)(start, eventStartsAt, timezoneInstance);
     // compute end, the end time for the last event using the last day
-    const end = (0, date_fns_1.addMinutes)((0, date_timezone_1.copyHoursAndMinutesFromDateWithTimezoneNormal)(endDay, eventStartsAt, timezoneInstance), duration);
+    const lastDayStartsAt = dateBlockTimingStartsAtDateFactory({ start, startsAt }, timezoneInstance)(endDay);
+    const end = (0, date_fns_1.addMinutes)(lastDayStartsAt, duration);
     const timing = {
         start,
         end,
         startsAt,
         duration
     };
+    // console.log({ timezoneInstance, startsAt, eventStartsAt, lastDayStartsAt, dateBlockTimingStartEndDayDateRange, event, timing });
     return timing;
 }
 /**
  * Creates a ChangeTimingToTimezoneFunction from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -285,14 +340,32 @@ function changeTimingToTimezoneFunction(input) {
     return fn;
 }
 exports.changeTimingToTimezoneFunction = changeTimingToTimezoneFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @param timezone
+ * @returns
+ */
 function changeTimingToTimezone(timing, timezone) {
     return changeTimingToTimezoneFunction(timezone)(timing);
 }
 exports.changeTimingToTimezone = changeTimingToTimezone;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
 function changeTimingToSystemTimezone(timing) {
     return changeTimingToTimezoneFunction(date_timezone_1.SYSTEM_DATE_TIMEZONE_UTC_NORMAL_INSTANCE)(timing);
 }
 exports.changeTimingToSystemTimezone = changeTimingToSystemTimezone;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @returns
+ */
 function dateBlockTimingStartForNowInSystemTimezone() {
     return {
         start: (0, date_fns_1.startOfDay)(new Date())
@@ -313,6 +386,7 @@ exports.dateBlockTimingStartForNowInTimezone = dateBlockTimingStartForNowInTimez
 /**
  * Returns the start date in the current/system timezone for the given date.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  */
 function getCurrentDateBlockTimingStartDate(timing) {
@@ -320,6 +394,12 @@ function getCurrentDateBlockTimingStartDate(timing) {
     return (0, date_fns_1.addMilliseconds)(timing.start, offset);
 }
 exports.getCurrentDateBlockTimingStartDate = getCurrentDateBlockTimingStartDate;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param date
+ * @returns
+ */
 function isValidDateBlockTimingStartDate(date) {
     return (0, date_fns_1.getMinutes)(date) === 0 && (0, date_fns_1.getSeconds)(date) === 0 && (0, date_fns_1.getMilliseconds)(date) === 0;
 }
@@ -327,6 +407,7 @@ exports.isValidDateBlockTimingStartDate = isValidDateBlockTimingStartDate;
 /**
  * Returns true if the input is a DateBlockTimingRelativeIndexFactory.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -337,6 +418,7 @@ exports.isDateBlockTimingRelativeIndexFactory = isDateBlockTimingRelativeIndexFa
 /**
  * Creates a DateBlockTimingRelativeIndexFactory from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -378,6 +460,7 @@ exports.dateBlockTimingRelativeIndexFactory = dateBlockTimingRelativeIndexFactor
 /**
  * Creates a DateBlockTimingRelativeIndexArrayFactory from the input DateBlockTimingRelativeIndexFactory.
  *
+ * @deprecated use DateCell implementation instead.
  * @param indexFactory
  */
 function dateBlockTimingRelativeIndexArrayFactory(indexFactory) {
@@ -409,6 +492,7 @@ exports.dateBlockTimingRelativeIndexArrayFactory = dateBlockTimingRelativeIndexA
 /**
  * Gets the relative index of the input date compared to the input timing.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @param date
  */
@@ -419,6 +503,7 @@ exports.getRelativeIndexForDateBlockTiming = getRelativeIndexForDateBlockTiming;
 /**
  * Computes a GetNextDateBlockTimingIndexResult from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  */
 function getNextDateBlockTimingIndex(input) {
@@ -461,6 +546,7 @@ exports.getNextDateBlockTimingIndex = getNextDateBlockTimingIndex;
 /**
  * Returns the DateRelativeState for the given index and range.
  *
+ * @deprecated use DateCell implementation instead.
  * @param nowIndex
  * @param range
  */
@@ -482,6 +568,7 @@ exports.dateRelativeStateForDateBlockRangeComparedToIndex = dateRelativeStateFor
 /**
  * Creates a DateBlockTimingDateFactory.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
@@ -511,6 +598,7 @@ exports.dateBlockTimingDateFactory = dateBlockTimingDateFactory;
 /**
  * Creates a DateBlockTimingDateFactory. The timezone is required to properly compute the accurate startsAt date for locations that experience daylight savings.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
@@ -531,19 +619,18 @@ function dateBlockTimingStartDateFactory(input, timezone) {
     return factory;
 }
 exports.dateBlockTimingStartDateFactory = dateBlockTimingStartDateFactory;
-/**
- * Creates a DateBlockTimingStartsAtDateFactory.
- *
- * @param timing
- * @returns
- */
-function dateBlockTimingStartsAtDateFactory(input) {
+function dateBlockTimingStartsAtDateFactory(input, timezone) {
     const indexFactory = dateBlockTimingRelativeIndexFactory(input);
-    const { startsAt: baseTimingStartsAt } = indexFactory._timing;
+    const { start, startsAt: baseTimingStartsAt } = indexFactory._timing;
+    const timezoneInstance = timingDateTimezoneUtcNormal(timezone !== null && timezone !== void 0 ? timezone : { start });
+    if (timezoneInstance.config.assertTimingMatchesTimezone !== false && !timingIsInExpectedTimezone(indexFactory._timing, timezoneInstance)) {
+        throw new Error(`unexpected timezone "${timezone}" for start date "${indexFactory._timing.start}" for dateBlockTimingStartsAtDateFactory(). Is expected to match the timezones.`);
+    }
+    const baseStartsAtInUtc = timezoneInstance.baseDateToTargetDate(baseTimingStartsAt);
     const factory = ((input) => {
         const index = indexFactory(input); // get the index
-        const hoursOffset = index * util_1.HOURS_IN_DAY;
-        return (0, date_fns_1.addHours)(baseTimingStartsAt, hoursOffset);
+        const startAtInUtc = (0, date_fns_1.addHours)(baseStartsAtInUtc, index * util_1.HOURS_IN_DAY);
+        return timezoneInstance.targetDateToBaseDate(startAtInUtc);
     });
     factory._indexFactory = indexFactory;
     return factory;
@@ -552,6 +639,7 @@ exports.dateBlockTimingStartsAtDateFactory = dateBlockTimingStartsAtDateFactory;
 /**
  * Returns the date of the input index.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @param date
  */
@@ -572,6 +660,8 @@ exports.getRelativeDateForDateBlockTiming = getRelativeDateForDateBlockTiming;
  * The end date is used just to determine the number of days, but a minimum of 1 day is always enforced as a DateBlockTiming must contain atleast 1 day.
  *
  * The start date from the inputDate is considered to to have the offset noted in DateBlock, and will be retained.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 function dateBlockTiming(durationInput, inputRange, options) {
     const { duration } = durationInput;
@@ -617,9 +707,12 @@ function dateBlockTiming(durationInput, inputRange, options) {
         // numberOfBlockedDays = numberOfBlockedDays - 1; // reduce number of applied days by 1
     }
     const start = range.start;
-    startsAt = timezoneInstance ? timezoneInstance.targetDateToSystemDate(startsAt) : startsAt;
+    let lastStart = (0, date_fns_1.addDays)(startsAt, numberOfBlockedDays); // add days so the system can change for daylight savings
+    if (timezoneInstance) {
+        startsAt = timezoneInstance.targetDateToSystemDate(startsAt);
+        lastStart = timezoneInstance.targetDateToSystemDate(lastStart); // may be affected by daylight savings
+    }
     // calculate end to be the ending date/time of the final duration span
-    const lastStart = (0, date_fns_1.addDays)(startsAt, numberOfBlockedDays);
     const end = (0, date_fns_1.addMinutes)(lastStart, duration);
     return {
         start,
@@ -629,6 +722,12 @@ function dateBlockTiming(durationInput, inputRange, options) {
     };
 }
 exports.dateBlockTiming = dateBlockTiming;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param input
+ * @returns
+ */
 function dateBlockTimingInTimezoneFunction(input) {
     const changeTimezoneFunction = changeTimingToTimezoneFunction(input);
     const fn = ((durationInput, inputRange) => {
@@ -639,12 +738,26 @@ function dateBlockTimingInTimezoneFunction(input) {
     return fn;
 }
 exports.dateBlockTimingInTimezoneFunction = dateBlockTimingInTimezoneFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param durationInput
+ * @param inputRange
+ * @param timezone
+ * @returns
+ */
 function dateBlockTimingInTimezone(durationInput, inputRange, timezone) {
     return dateBlockTimingInTimezoneFunction(timezone)(durationInput, inputRange);
 }
 exports.dateBlockTimingInTimezone = dateBlockTimingInTimezone;
-function isValidDateBlockTimingInfo(timing, timezone) {
-    const { end, start, startsAt, duration } = timing;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
+function isValidDateBlockTimingInfo(timing) {
+    const { end, start, startsAt, duration, timezone } = timing;
     const { currentTimezoneOffsetInHours: startOffsetInHours // offset as computed on the given date.
      } = getCurrentDateBlockTimingOffsetData(timing);
     const isStartRoundedToSeconds = start.getMilliseconds() === 0; // should have no milliseconds specified
@@ -657,6 +770,7 @@ function isValidDateBlockTimingInfo(timing, timezone) {
     let isValid = false;
     let isExpectedValidEnd = false;
     let isPlausiblyValidEnd = false;
+    let isTimezoneValidatedEnd = false;
     if (isStartRoundedToSeconds &&
         endIsAfterTheStartsAtTime && // end must be after the startsAt time
         durationLessThan24Hours &&
@@ -667,12 +781,17 @@ function isValidDateBlockTimingInfo(timing, timezone) {
         const endOffset = (0, date_timezone_1.getCurrentSystemOffsetInHours)(timing.end);
         const timezoneOffsetDelta = endOffset - startOffsetInHours;
         const expectedFinalStartTime = (0, date_fns_1.addHours)((0, date_fns_1.addMinutes)(end, -duration), timezoneOffsetDelta);
-        const difference = (0, date_fns_1.differenceInMilliseconds)(startsAt, expectedFinalStartTime) % util_1.MS_IN_DAY;
+        const finalMsDifference = (0, date_fns_1.differenceInMilliseconds)(startsAt, expectedFinalStartTime);
+        const hoursDifference = Math.abs((finalMsDifference % util_1.MS_IN_DAY) / util_1.MS_IN_HOUR);
+        const difference = hoursDifference === 23 ? -1 : hoursDifference; // depending on daylight savings, may be off by 1 hour
         isExpectedValidEnd = difference === 0;
-        isPlausiblyValidEnd = isExpectedValidEnd || Math.abs(difference) === util_1.MS_IN_HOUR;
+        isPlausiblyValidEnd = isExpectedValidEnd || Math.abs(difference) === 1;
         isValid = isPlausiblyValidEnd;
+        if (isPlausiblyValidEnd && timezone) {
+            // TODO: validate properly for the timezone...
+        }
     }
-    return {
+    const result = {
         isValid,
         isStartRoundedToSeconds,
         msDifference,
@@ -684,10 +803,12 @@ function isValidDateBlockTimingInfo(timing, timezone) {
         isExpectedValidEnd,
         isPlausiblyValidEnd
     };
+    return result;
 }
 exports.isValidDateBlockTimingInfo = isValidDateBlockTimingInfo;
 /**
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
@@ -699,6 +820,7 @@ exports.isValidDateBlockTiming = isValidDateBlockTiming;
 /**
  * Creates a DateBlockDayOfWeekFactory
  *
+ * @deprecated use DateCell implementation instead.
  * @param dayForIndexZero
  * @returns
  */
@@ -710,6 +832,7 @@ exports.dateBlockDayOfWeekFactory = dateBlockDayOfWeekFactory;
 /**
  * Convenience function for calling expandDateBlocks() with the input DateBlockCollection.
  *
+ * @deprecated use DateCell implementation instead.
  * @param collection
  * @returns
  */
@@ -720,6 +843,7 @@ exports.expandDateBlockCollection = expandDateBlockCollection;
 /**
  * Convenience function for calling dateBlocksExpansionFactory() then passing the blocks.
  *
+ * @deprecated use DateCell implementation instead.
  * @param blocks
  * @param timing
  * @returns
@@ -731,6 +855,7 @@ exports.expandDateBlocks = expandDateBlocks;
 /**
  * Creates a DateBlocksExpansionFactory
  *
+ * @deprecated use DateCell implementation instead.
  * @param config
  * @returns
  */
@@ -782,6 +907,12 @@ function dateBlocksExpansionFactory(config) {
     };
 }
 exports.dateBlocksExpansionFactory = dateBlocksExpansionFactory;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param config
+ * @returns
+ */
 function dateBlockDayTimingInfoFactory(config) {
     const { timing, rangeLimit } = config;
     const { duration } = timing;
@@ -821,11 +952,23 @@ function dateBlockDayTimingInfoFactory(config) {
     };
 }
 exports.dateBlockDayTimingInfoFactory = dateBlockDayTimingInfoFactory;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @returns
+ */
 function dateBlockRangeToDateBlockIndexRange(range) {
     var _a;
     return { minIndex: range.i, maxIndex: ((_a = range.to) !== null && _a !== void 0 ? _a : range.i) + 1 };
 }
 exports.dateBlockRangeToDateBlockIndexRange = dateBlockRangeToDateBlockIndexRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @returns
+ */
 function dateBlockIndexRangeToDateBlockRange(range) {
     return { i: range.minIndex, to: range.maxIndex - 1 };
 }
@@ -835,6 +978,7 @@ exports.dateBlockIndexRangeToDateBlockRange = dateBlockIndexRangeToDateBlockRang
  *
  * An arbitrary limit can also be applied.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @param limit
  * @param fitToTimingRange
@@ -863,6 +1007,7 @@ exports.dateBlockIndexRange = dateBlockIndexRange;
 /**
  * Returns blocks that are only in the given DateBlockRange.
  *
+ * @deprecated use DateCell implementation instead.
  * @param blocks
  * @param range
  * @returns
@@ -872,6 +1017,12 @@ function filterDateBlocksInDateBlockRange(blocks, range) {
     return blocks.filter(dateBlockIsWithinDateBlockRange);
 }
 exports.filterDateBlocksInDateBlockRange = filterDateBlocksInDateBlockRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param inputRange
+ * @returns
+ */
 function isDateBlockWithinDateBlockRangeFunction(inputRange) {
     const range = dateBlockRangeWithRange(inputRange);
     return (input) => {
@@ -890,6 +1041,7 @@ exports.isDateBlockWithinDateBlockRangeFunction = isDateBlockWithinDateBlockRang
 /**
  * Returns true if the first DateBlock or DateBlockRange contains the second input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param range
  * @param isContainedWithin
  * @returns
@@ -898,6 +1050,12 @@ function isDateBlockWithinDateBlockRange(range, contains) {
     return isDateBlockWithinDateBlockRangeFunction(range)(dateBlockRangeWithRange(contains));
 }
 exports.isDateBlockWithinDateBlockRange = isDateBlockWithinDateBlockRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param config
+ * @returns
+ */
 function isDateWithinDateBlockRangeFunction(config) {
     const { start: inputStart, range: inputRange } = config;
     let start = inputStart;
@@ -957,6 +1115,10 @@ function isDateWithinDateBlockRangeFunction(config) {
     };
 }
 exports.isDateWithinDateBlockRangeFunction = isDateWithinDateBlockRangeFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 class DateBlockRange extends DateBlock {
     constructor(template) {
         super(template);
@@ -976,6 +1138,7 @@ exports.DateBlockRange = DateBlockRange;
 /**
  * Returns true if the input is a valid DateBlockRange.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -993,6 +1156,7 @@ exports.isValidDateBlockRange = isValidDateBlockRange;
 /**
  * Returns true if the input is a sorted DateBlockRange array and there are no repeat indexes.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -1022,6 +1186,8 @@ exports.isValidDateBlockRangeSeries = isValidDateBlockRangeSeries;
  * Returns the lowest index between all the input date block ranges. Returns 0 by default if there is no minimum or input blocks.
  *
  * The input range is not expected to be sorted.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 function getLeastDateBlockIndexInDateBlockRanges(input) {
     var _a, _b;
@@ -1032,6 +1198,8 @@ exports.getLeastDateBlockIndexInDateBlockRanges = getLeastDateBlockIndexInDateBl
  * Returns the largest index between all the input date block ranges. Returns 0 by default.
  *
  * The input range is not expected to be sorted.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 function getGreatestDateBlockIndexInDateBlockRanges(input) {
     var _a, _b;
@@ -1042,6 +1210,8 @@ exports.getGreatestDateBlockIndexInDateBlockRanges = getGreatestDateBlockIndexIn
  * Returns the largest index between all the input date block ranges. Returns null if the input is empty.
  *
  * The input range is not expected to be sorted.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 function getLeastAndGreatestDateBlockIndexInDateBlockRanges(input) {
     if (!input.length) {
@@ -1075,6 +1245,7 @@ exports.getLeastAndGreatestDateBlockIndexInDateBlockRanges = getLeastAndGreatest
 /**
  * Creates a DateBlockRange
  *
+ * @deprecated use DateCell implementation instead.
  * @param i
  * @param to
  * @returns
@@ -1086,6 +1257,7 @@ exports.dateBlockRange = dateBlockRange;
 /**
  * Creates a DateBlockRangeWithRange from the input DateBlockIndex.
  *
+ * @deprecated use DateCell implementation instead.
  * @param dateBlockIndex
  * @returns
  */
@@ -1096,6 +1268,7 @@ exports.dateBlockRangeWithRangeFromIndex = dateBlockRangeWithRangeFromIndex;
 /**
  * Creates a DateBlockRangeWithRange from the input DateBlockIndex, DateBlock, or DateBlockRange.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -1111,6 +1284,7 @@ exports.dateBlockRangeWithRange = dateBlockRangeWithRange;
 /**
  * Creates a DateBlockRangeIncludedByRangeFunction
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputRange
  * @returns
  */
@@ -1126,6 +1300,7 @@ exports.dateBlockRangeIncludedByRangeFunction = dateBlockRangeIncludedByRangeFun
 /**
  * Creates a DateBlockRangeOverlapsRangeFunction
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputRange
  * @returns
  */
@@ -1141,6 +1316,7 @@ exports.dateBlockRangeOverlapsRangeFunction = dateBlockRangeOverlapsRangeFunctio
 /**
  * Returns true if either of the ranges overlap eachother.
  *
+ * @deprecated use DateCell implementation instead.
  * @param rangeA
  * @param rangeB
  * @returns
@@ -1154,6 +1330,7 @@ exports.dateBlockRangeOverlapsRange = dateBlockRangeOverlapsRange;
  *
  * In many cases sortAscendingIndexNumberRefFunction may be preferential since
  *
+ * @deprecated use DateCell implementation instead.
  * @returns
  */
 function sortDateBlockRangeAndSizeFunction() {
@@ -1163,6 +1340,7 @@ exports.sortDateBlockRangeAndSizeFunction = sortDateBlockRangeAndSizeFunction;
 /**
  * Sorts the input date ranges. This will retain the before/after order while also sorting items by index.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -1173,6 +1351,7 @@ exports.sortDateBlockRanges = sortDateBlockRanges;
 /**
  * Groups the input values into DateBlockRange values.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  */
 function groupToDateBlockRanges(input) {
@@ -1211,6 +1390,8 @@ function groupToDateBlockRanges(input) {
 exports.groupToDateBlockRanges = groupToDateBlockRanges;
 /**
  * Returns an array containing all indexes in the date block range.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 function allIndexesInDateBlockRange(input) {
     return input.to != null ? (0, util_1.range)(input.i, input.to + 1) : [input.i];
@@ -1219,6 +1400,7 @@ exports.allIndexesInDateBlockRange = allIndexesInDateBlockRange;
 /**
  * Returns the set of all indexes within the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -1239,6 +1421,7 @@ exports.allIndexesInDateBlockRanges = allIndexesInDateBlockRanges;
 /**
  * Counts the number of blocks in the input range.
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputDateBlockRange
  * @returns
  */
@@ -1262,6 +1445,7 @@ exports.dateBlockRangeBlocksCountInfo = dateBlockRangeBlocksCountInfo;
 /**
  * Counts the number of blocks in the input range.
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputDateBlockRange
  * @returns
  */
@@ -1272,6 +1456,7 @@ exports.dateBlockRangeBlocksCount = dateBlockRangeBlocksCount;
 /**
  * Creates a dateBlockRangesFullyCoverDateBlockRangeFunction
  *
+ * @deprecated use DateCell implementation instead.
  * @param ranges
  * @returns
  */
@@ -1286,6 +1471,7 @@ exports.dateBlockRangesFullyCoverDateBlockRangeFunction = dateBlockRangesFullyCo
 /**
  * Expands a DateBlockRange into an array of DateBlock values.
  *
+ * @deprecated use DateCell implementation instead.
  * @param block
  * @returns
  */
@@ -1298,6 +1484,7 @@ exports.expandDateBlockRange = expandDateBlockRange;
 /**
  * Returns true if the input DateBlockRange is longer than 1 block (I.E. has a "to" value greater than it's "i" value).
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  */
 function dateBlockRangeHasRange(input) {
@@ -1307,6 +1494,7 @@ exports.dateBlockRangeHasRange = dateBlockRangeHasRange;
 /**
  * Reads the to index if it exists, or returns the block's index itself.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -1317,6 +1505,8 @@ function dateBlockEndIndex(input) {
 exports.dateBlockEndIndex = dateBlockEndIndex;
 /**
  * Groups all input DateBlockRange or UniqueDateBlock values into a UniqueDateBlockRangeGroup value amd sorts the input.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 function groupUniqueDateBlocks(input) {
     var _a;
@@ -1337,6 +1527,12 @@ function groupUniqueDateBlocks(input) {
     };
 }
 exports.groupUniqueDateBlocks = groupUniqueDateBlocks;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param config
+ * @returns
+ */
 function expandUniqueDateBlocksFunction(config) {
     const { startAtIndex = 0, endAtIndex, fillOption: fill, fillFactory: inputFillFactory, retainOnOverlap: inputRetainOnOverlap } = config;
     const retainOnOverlap = inputRetainOnOverlap !== null && inputRetainOnOverlap !== void 0 ? inputRetainOnOverlap : 'next';
@@ -1568,6 +1764,8 @@ function expandUniqueDateBlocksFunction(config) {
 exports.expandUniqueDateBlocksFunction = expandUniqueDateBlocksFunction;
 /**
  * Creatse a ModifyDateBlocksToFitRangeFunction
+ *
+ * @deprecated use DateCell implementation instead.
  */
 function modifyDateBlocksToFitRangeFunction(range) {
     const { i, to } = dateBlockRangeWithRange(range);
@@ -1593,10 +1791,24 @@ function modifyDateBlocksToFitRangeFunction(range) {
     }));
 }
 exports.modifyDateBlocksToFitRangeFunction = modifyDateBlocksToFitRangeFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @param input
+ * @returns
+ */
 function modifyDateBlocksToFitRange(range, input) {
     return modifyDateBlocksToFitRangeFunction(range)(input);
 }
 exports.modifyDateBlocksToFitRange = modifyDateBlocksToFitRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @param input
+ * @returns
+ */
 function modifyDateBlockToFitRange(range, input) {
     return modifyDateBlocksToFitRange(range, [input])[0];
 }