@dereekb/date 9.24.46 → 9.25.0

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

@@ -1,23 +1,30 @@
-import { DayOfWeek, RequiredOnKeys, IndexNumber, IndexRange, IndexRef, UniqueModel, FactoryWithRequiredInput, FilterFunction, Milliseconds, Hours, MapFunction, SortCompareFunction, ArrayOrValue, Maybe, TimezoneString, ISO8601DayString, FractionalHour, DateRelativeState } from '@dereekb/util';
+import { DayOfWeek, RequiredOnKeys, IndexNumber, IndexRange, IndexRef, UniqueModel, FactoryWithRequiredInput, FilterFunction, Milliseconds, Hours, MapFunction, SortCompareFunction, ArrayOrValue, Maybe, TimezoneString, ISO8601DayString, FractionalHour, DateRelativeState, TimezoneStringRef } from '@dereekb/util';
 import { DateRange, DateRangeDayDistanceInput, DateRangeStart } from './date.range';
 import { DateDurationSpan } from './date.duration';
 import { DateTimezoneUtcNormalFunctionInput, DateTimezoneUtcNormalInstance, DateTimezoneConversionConfigUseSystemTimezone } from './date.timezone';
 /**
  * Index from 0 of which day this block represents.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockIndex = number;
 /**
  * Returns true if the index is a non-negative integer.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  */
 export declare function isValidDateBlockIndex(input: DateBlockIndex): boolean;
 /**
  * Input type that is either a Date or a DateBlockIndex.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateOrDateBlockIndex = Date | DateBlockIndex;
 /**
  * A duration-span block.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface DateBlock extends IndexRef {
     i: DateBlockIndex;
@@ -29,16 +36,21 @@ export declare class DateBlock {
 /**
  * Converts the input number or DateBlock to a DateBlock.
  *
+ * @deprecated use DateCell implementation instead.
  * @param dateBlockOrIndex
  * @returns
  */
 export declare function dateBlock(dateBlockOrIndex: DateBlockIndex | DateBlock): DateBlock;
 /**
  * An array of DateBlock-like values.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockArray<B extends DateBlock = DateBlock> = B[];
 /**
  * Reference to a DateBlockArray
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockArrayRef<B extends DateBlock = DateBlock> = {
     blocks: DateBlockArray<B>;
@@ -47,20 +59,28 @@ export declare type DateBlockArrayRef<B extends DateBlock = DateBlock> = {
  * DateBlockTiming with only the start time.
  *
  * The start time is midnight of what timezone it is in, and can be used to infer the target timezone offset for that date.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingStart = DateRangeStart;
 /**
  * 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.
  */
 export declare const 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.
  */
 export declare const MIN_DATE_BLOCK_TIMING_OFFSET_HOURS = -12;
 /**
  * The DateBlockTimingStart and startsAt times
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingStartAndStartsAt = DateBlockTimingStart & Pick<DateBlockTiming, 'startsAt'>;
 /**
@@ -74,30 +94,50 @@ export declare type DateBlockTimingStartAndStartsAt = DateBlockTimingStart & Pic
  * - The startsAt time should be greater than or equal to the normalized start
  * - The startsAt time should be on the same date as normalized start
  * - The end time should equal the ending date/time of the final end duration.
+ * - (Recommended, Optional) The timezone the date block timing is for. This timezone is required for areas that experience daylight savings in order to properly handle the offsets.
+ *
+ * @deprecated use DateCell implementation instead.
  */
-export interface DateBlockTiming extends DateBlockTimingStart, DateRange, DateDurationSpan {
+export interface DateBlockTiming extends DateBlockTimingStart, DateRange, DateDurationSpan, Partial<TimezoneStringRef> {
 }
 /**
  * The DateRange component for a DateBlockTiming. The start date is a DateBlockTimingStart.
+ *
+ * @deprecated use DateCell implementation instead.
  */
-export declare type DateBlockTimingStartEndRange = DateBlockTimingStart & Pick<DateBlockTiming, 'end'>;
+export declare type DateBlockTimingStartEndRange = DateBlockTimingStart & Pick<DateBlockTiming, 'end' | 'timezone'>;
 /**
  * The start date of a DateBlockTimingStart, along with the endDay which is a normalized day that is at midnight of the last day in the timezone.
  *
  * They are expected to both be in the same timezone.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingStartEndDayDateRange = DateBlockTimingStart & {
     endDay: Date;
 };
+/**
+ * The startsAt time of the event.
+ *
+ * @deprecated use DateCell implementation instead.
+ */
+export declare type DateBlockTimingEventStartsAt = Pick<DateBlockTiming, 'startsAt'>;
 /**
  * A startsAt time and duration.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingEvent = Pick<DateBlockTiming, 'startsAt' | 'duration'>;
 export declare class DateBlockTiming extends DateDurationSpan {
     start: Date;
     end: Date;
+    timezone?: TimezoneString;
     constructor(template?: DateBlockTiming);
 }
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface CurrentDateBlockTimingUtcData {
     /**
      * Non-normalized start date in the system time.
@@ -108,6 +148,10 @@ export interface CurrentDateBlockTimingUtcData {
      */
     originalUtcOffsetInHours: Hours;
 }
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface CurrentDateBlockTimingOffsetData extends CurrentDateBlockTimingUtcData {
     offset: Milliseconds;
     currentTimezoneOffsetInHours: Hours;
@@ -115,6 +159,7 @@ export interface CurrentDateBlockTimingOffsetData extends CurrentDateBlockTiming
 /**
  * Returns true if the two timings are equivalent.
  *
+ * @deprecated use DateCell implementation instead.
  * @param a
  * @param b
  */
@@ -122,6 +167,7 @@ export declare function isSameDateBlockTiming(a: Maybe<DateBlockTiming>, b: Mayb
 /**
  * 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
  */
@@ -129,20 +175,50 @@ export declare function dateBlockTimingFullRange(timing: Pick<DateBlockTiming, '
 /**
  * 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
  */
 export declare function dateBlockTimingEventRange(timing: Pick<DateBlockTiming, 'startsAt' | 'end'>): DateRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
 export declare function getCurrentDateBlockTimingUtcData(timing: DateRangeStart): CurrentDateBlockTimingUtcData;
 /**
  * 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
  */
 export declare function getCurrentDateBlockTimingOffsetData(timing: DateRangeStart): CurrentDateBlockTimingOffsetData;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
 export declare function getCurrentDateBlockTimingOffset(timing: DateRangeStart): Milliseconds;
+/**
+ * @deprecated use DateCell implementation instead.
+ */
 export declare type TimingIsExpectedTimezoneFunction = (timing: DateRangeStart) => boolean;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timezone
+ * @returns
+ */
 export declare function timingIsInExpectedTimezoneFunction(timezone: DateTimezoneUtcNormalFunctionInput): (timing: DateRangeStart) => boolean;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @param timezone
+ * @returns
+ */
 export declare function timingIsInExpectedTimezone(timing: DateRangeStart, timezone: DateTimezoneUtcNormalFunctionInput): boolean;
 /**
  * Returns the total minutes between the start of the first event and the end of the last event.
@@ -154,6 +230,7 @@ export declare function getDateBlockTimingFirstEventDateRange(timing: Pick<DateB
 /**
  * Returns the fractional hours in the event.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
@@ -162,6 +239,7 @@ export declare type TimingDateTimezoneUtcNormalInput = DateRangeStart | DateTime
 /**
  * Creates a DateTimezoneUtcNormalInstance from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -169,6 +247,7 @@ export declare function timingDateTimezoneUtcNormal(input: TimingDateTimezoneUtc
 /**
  * Convenience function that extends timingDateTimezoneUtcNormal() but also asserts the that the timing matches it.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @param timing
  * @returns
@@ -177,23 +256,23 @@ export declare function assertedTimingDateTimezoneUtcNormal(input: TimingDateTim
 /**
  * Converts a DateBlockTimingStartEndRange and DateBlockTimingEvent that originated from the same DateBlockTiming back to the original DateBlockTiming.
  *
+ * This does not check for validity of the input event, and as such can return an invalid timing. Instead, use safeDateBlockTimingFromDateRangeAndEvent() for enforced validity and return of a valid timing.
+ *
  * The timezone is recommended to be provided if available, otherwise daylight savings might be impacted.
  *
+ * @deprecated use DateCell implementation instead.
  * @param dateBlockTimingStartEndRange
  * @param event
  * @param timezone
  * @returns
  */
-export declare function dateBlockTimingFromDateRangeAndEvent(dateBlockTimingStartEndRange: DateBlockTimingStartEndRange, event: DateBlockTimingEvent, timezone: DateTimezoneUtcNormalInstance | TimezoneString): DateBlockTiming;
-/**
- * @deprecated timezone should be provided, as it will behave properly for daylight savings changes.
- */
-export declare function dateBlockTimingFromDateRangeAndEvent(dateBlockTimingStartEndRange: DateBlockTimingStartEndRange, event: DateBlockTimingEvent, timezone?: DateTimezoneUtcNormalInstance | TimezoneString): DateBlockTiming;
+export declare function dateBlockTimingFromDateRangeAndEvent(dateBlockTimingStartEndRange: DateBlockTimingStartEndRange, event: DateBlockTimingEvent): DateBlockTiming;
 /**
  * Converts a DateBlockTimingStartEndRange and a DateBlockTimingEvent to a DateBlockTiming.
  *
- * The input event does not have to be from the original DateBlockTimingStartEndRange. The DateBlockTiming's end value will be updated to fit the DateBlockTimingEvent info.
+ * The input event does not have to be from the original DateBlockTimingStartEndRange, but the start date is always retained, and the same end day is retained, but may be updated to reflect a new end date/time.
  *
+ * @deprecated use DateCell implementation instead.
  * @param dateBlockTimingStartEndRange
  * @param event
  * @param timezone
@@ -207,20 +286,18 @@ export declare function safeDateBlockTimingFromDateRangeAndEvent(dateBlockTiming
 /**
  * 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
  */
 export declare function dateBlockTimingFromDateBlockTimingStartEndDayDateRange(dateBlockTimingStartEndDayDateRange: DateBlockTimingStartEndDayDateRange, event: DateBlockTimingEvent, timezone: DateTimezoneUtcNormalInstance | TimezoneString): DateBlockTiming;
-/**
- * @deprecated timezone should be provided, as it will behave properly for daylight savings changes.
- */
-export declare function dateBlockTimingFromDateBlockTimingStartEndDayDateRange(dateBlockTimingStartEndDayDateRange: DateBlockTimingStartEndDayDateRange, event: DateBlockTimingEvent, timezone?: DateTimezoneUtcNormalInstance | TimezoneString): DateBlockTiming;
 /**
  * Returns a copy of the input timing with the start time timezone in the given timezone.
  *
  * The start time is a normal, and should still refer to the same UTC date, but with the given timing's offset.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  */
 export declare type ChangeTimingToTimezoneFunction = (<T extends DateRangeStart>(timing: T) => T) & {
@@ -229,12 +306,31 @@ export declare type ChangeTimingToTimezoneFunction = (<T extends DateRangeStart>
 /**
  * Creates a ChangeTimingToTimezoneFunction from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
 export declare function changeTimingToTimezoneFunction(input: TimingDateTimezoneUtcNormalInput): ChangeTimingToTimezoneFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @param timezone
+ * @returns
+ */
 export declare function changeTimingToTimezone<T extends DateRangeStart>(timing: T, timezone: TimingDateTimezoneUtcNormalInput): T;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
 export declare function changeTimingToSystemTimezone<T extends DateRangeStart>(timing: T): T;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @returns
+ */
 export declare function dateBlockTimingStartForNowInSystemTimezone(): DateBlockTimingStart;
 /**
  * Creates a DateBlockTimingStart for now in the given timezone.
@@ -246,18 +342,29 @@ export declare function dateBlockTimingStartForNowInTimezone(timezoneInput: Timi
 /**
  * Returns the start date in the current/system timezone for the given date.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  */
 export declare function getCurrentDateBlockTimingStartDate(timing: DateBlockTimingStart): Date;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param date
+ * @returns
+ */
 export declare function isValidDateBlockTimingStartDate(date: Date): boolean;
 /**
  * DateBlockTimingRelativeIndexFactory input. Can be a Date, DateBlockIndex, or ISO8601DayString
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingRelativeIndexFactoryInput = DateOrDateBlockIndex | ISO8601DayString;
 /**
  * Returns the DateBlockIndex of the input date relative to the configured Date.
  *
  * Input dates should be in system time zone and not normalized to a different timezone.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingRelativeIndexFactory<T extends DateBlockTimingStart = DateBlockTimingStart> = ((input: DateBlockTimingRelativeIndexFactoryInput) => DateBlockIndex) & {
     readonly _timing: T;
@@ -266,6 +373,7 @@ export declare type DateBlockTimingRelativeIndexFactory<T extends DateBlockTimin
 /**
  * Returns true if the input is a DateBlockTimingRelativeIndexFactory.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -273,12 +381,15 @@ export declare function isDateBlockTimingRelativeIndexFactory<T extends DateBloc
 /**
  * Creates a DateBlockTimingRelativeIndexFactory from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
 export declare function dateBlockTimingRelativeIndexFactory<T extends DateBlockTimingStart = DateBlockTimingStart>(input: T | DateBlockTimingRelativeIndexFactory<T>): DateBlockTimingRelativeIndexFactory<T>;
 /**
  * Function that wraps a DateBlockTimingRelativeIndexFactory and converts multuple Date/DateBlockIndex/DateBlockRange values into an array of DateBlockIndex values.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingRelativeIndexArrayFactory<T extends DateBlockTimingStart = DateBlockTimingStart> = ((input: ArrayOrValue<DateOrDateRangeOrDateBlockIndexOrDateBlockRange>) => DateBlockIndex[]) & {
     readonly _indexFactory: DateBlockTimingRelativeIndexFactory<T>;
@@ -286,16 +397,22 @@ export declare type DateBlockTimingRelativeIndexArrayFactory<T extends DateBlock
 /**
  * Creates a DateBlockTimingRelativeIndexArrayFactory from the input DateBlockTimingRelativeIndexFactory.
  *
+ * @deprecated use DateCell implementation instead.
  * @param indexFactory
  */
 export declare function dateBlockTimingRelativeIndexArrayFactory<T extends DateBlockTimingStart = DateBlockTimingStart>(indexFactory: DateBlockTimingRelativeIndexFactory<T>): DateBlockTimingRelativeIndexArrayFactory<T>;
 /**
  * Gets the relative index of the input date compared to the input timing.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @param date
  */
 export declare function getRelativeIndexForDateBlockTiming(timing: DateBlockTimingStart, date?: DateOrDateBlockIndex): DateBlockIndex;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface GetNextDateBlockTimingIndexInput<T extends DateBlockRange> {
     /**
      * Relevant index for now.
@@ -306,6 +423,10 @@ export interface GetNextDateBlockTimingIndexInput<T extends DateBlockRange> {
      */
     readonly ranges: ArrayOrValue<T>;
 }
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface GetNextDateBlockTimingIndexResult<T extends DateBlockRange> {
     /**
      * The item that matches the current index first out of the options.
@@ -335,12 +456,14 @@ export interface GetNextDateBlockTimingIndexResult<T extends DateBlockRange> {
 /**
  * Computes a GetNextDateBlockTimingIndexResult from the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  */
 export declare function getNextDateBlockTimingIndex<T extends DateBlockRange>(input: GetNextDateBlockTimingIndexInput<T>): GetNextDateBlockTimingIndexResult<T>;
 /**
  * Returns the DateRelativeState for the given index and range.
  *
+ * @deprecated use DateCell implementation instead.
  * @param nowIndex
  * @param range
  */
@@ -349,6 +472,8 @@ export declare function dateRelativeStateForDateBlockRangeComparedToIndex(range:
  * Similar to the DateBlockTimingRelativeIndexFactory, but returns a date instead of an index for the input.
  *
  * If an index is input, returns a date with the hours and minutes for now for the given date returned.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingDateFactory<T extends DateBlockTimingStart = DateBlockTimingStart> = ((input: DateOrDateBlockIndex) => Date) & {
     readonly _timing: T;
@@ -356,16 +481,23 @@ export declare type DateBlockTimingDateFactory<T extends DateBlockTimingStart =
 /**
  * Creates a DateBlockTimingDateFactory.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
 export declare function dateBlockTimingDateFactory<T extends DateBlockTimingStart = DateBlockTimingStart>(timing: T): DateBlockTimingDateFactory<T>;
 /**
  * Returns the start time of the input date or index.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingStartDateFactory<T extends DateBlockTimingStart = DateBlockTimingStart> = ((input: DateOrDateBlockIndex) => Date) & {
     readonly _indexFactory: DateBlockTimingRelativeIndexFactory<T>;
 };
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export declare type DateBlockTimingUseSystemAndIgnoreEnforcement = DateTimezoneConversionConfigUseSystemTimezone & {
     /**
      * Skips the assertion that the timezone matches. This defaults to true if not provided.
@@ -375,12 +507,15 @@ export declare type DateBlockTimingUseSystemAndIgnoreEnforcement = DateTimezoneC
 /**
  * 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
  */
-export declare function dateBlockTimingStartDateFactory<T extends DateBlockTimingStart = DateBlockTimingStart>(input: T | DateBlockTimingRelativeIndexFactory<T>, timezone: TimezoneString | DateTimezoneConversionConfigUseSystemTimezone | DateBlockTimingUseSystemAndIgnoreEnforcement): DateBlockTimingStartDateFactory<T>;
+export declare function dateBlockTimingStartDateFactory<T extends DateBlockTimingStart = DateBlockTimingStart>(input: T | DateBlockTimingRelativeIndexFactory<T>, timezone: TimezoneString | DateTimezoneConversionConfigUseSystemTimezone | DateBlockTimingUseSystemAndIgnoreEnforcement | DateTimezoneUtcNormalInstance): DateBlockTimingStartDateFactory<T>;
 /**
  * Returns the startsAt time of the input date or index.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingStartsAtDateFactory<T extends DateBlockTimingStart = DateBlockTimingStart> = ((input: DateOrDateBlockIndex) => Date) & {
     readonly _indexFactory: DateBlockTimingRelativeIndexFactory<T>;
@@ -388,21 +523,35 @@ export declare type DateBlockTimingStartsAtDateFactory<T extends DateBlockTiming
 /**
  * Creates a DateBlockTimingStartsAtDateFactory.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
-export declare function dateBlockTimingStartsAtDateFactory<T extends DateBlockTimingStartAndStartsAt = DateBlockTimingStartAndStartsAt>(input: T | DateBlockTimingRelativeIndexFactory<T>): DateBlockTimingStartsAtDateFactory<T>;
+export declare function dateBlockTimingStartsAtDateFactory<T extends DateBlockTimingStartAndStartsAt = DateBlockTimingStartAndStartsAt>(input: T | DateBlockTimingRelativeIndexFactory<T>, timezone: TimezoneString | DateTimezoneConversionConfigUseSystemTimezone | DateBlockTimingUseSystemAndIgnoreEnforcement | DateTimezoneUtcNormalInstance): DateBlockTimingStartsAtDateFactory<T>;
+/**
+ * @deprecated use DateCell implementation instead.
+ * @param input
+ * @param timezone
+ */
+export declare function dateBlockTimingStartsAtDateFactory<T extends DateBlockTimingStartAndStartsAt = DateBlockTimingStartAndStartsAt>(input: T | DateBlockTimingRelativeIndexFactory<T>, timezone?: TimezoneString | DateTimezoneConversionConfigUseSystemTimezone | DateBlockTimingUseSystemAndIgnoreEnforcement | DateTimezoneUtcNormalInstance): DateBlockTimingStartsAtDateFactory<T>;
 /**
  * Returns the date of the input index.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @param date
  */
 export declare function getRelativeDateForDateBlockTiming(timing: DateBlockTimingStart, input: DateOrDateBlockIndex): Date;
 /**
  * The DateRange input for dateBlockTiming()
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingRangeInput = Pick<DateRangeDayDistanceInput, 'distance'> | DateRange | number;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface DateBlockTimingOptions {
     /**
      * Timezone to evaluate the startsAt time in.
@@ -424,16 +573,37 @@ export interface DateBlockTimingOptions {
  * 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.
  */
 export declare function dateBlockTiming(durationInput: DateDurationSpan, inputRange: DateBlockTimingRangeInput, options?: DateBlockTimingOptions): DateBlockTiming;
 /**
  * Creates a DateBlockTiming from the DateDurationSpan and range input with the start offset set in the pre-configured timezone.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockTimingInTimezoneFunction = ((durationInput: DateDurationSpan, inputRange: DateBlockTimingRangeInput) => DateBlockTiming) & {
     readonly _timezoneInstance: DateTimezoneUtcNormalInstance;
 };
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param input
+ * @returns
+ */
 export declare function dateBlockTimingInTimezoneFunction(input: TimingDateTimezoneUtcNormalInput): DateBlockTimingInTimezoneFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param durationInput
+ * @param inputRange
+ * @param timezone
+ * @returns
+ */
 export declare function dateBlockTimingInTimezone(durationInput: DateDurationSpan, inputRange: DateBlockTimingRangeInput, timezone: TimingDateTimezoneUtcNormalInput): DateBlockTiming;
+/**
+ * @deprecated use DateCell implementation instead.
+ */
 export interface IsValidDateBlockTimingInfo {
     readonly isValid: boolean;
     readonly isStartRoundedToSeconds: boolean;
@@ -446,7 +616,13 @@ export interface IsValidDateBlockTimingInfo {
     readonly isExpectedValidEnd: boolean;
     readonly isPlausiblyValidEnd: boolean;
 }
-export declare function isValidDateBlockTimingInfo(timing: DateBlockTiming, timezone?: TimezoneString): {
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param timing
+ * @returns
+ */
+export declare function isValidDateBlockTimingInfo(timing: DateBlockTiming): {
     isValid: boolean;
     isStartRoundedToSeconds: boolean;
     msDifference: number;
@@ -460,39 +636,50 @@ export declare function isValidDateBlockTimingInfo(timing: DateBlockTiming, time
 };
 /**
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @returns
  */
 export declare function isValidDateBlockTiming(timing: DateBlockTiming): boolean;
 /**
  * Converts the input index into the DayOfWeek that it represents.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockDayOfWeekFactory = MapFunction<DateBlockIndex, DayOfWeek>;
 /**
  * Creates a DateBlockDayOfWeekFactory
  *
+ * @deprecated use DateCell implementation instead.
  * @param dayForIndexZero
  * @returns
  */
 export declare function dateBlockDayOfWeekFactory(inputDayForIndexZero: DayOfWeek | Date): DateBlockDayOfWeekFactory;
 /**
  * Reference to a DateBlockTiming
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface DateBlockTimingRef {
     timing: DateBlockTiming;
 }
 /**
  * An object that implements DateBlockTimingRef and DateBlockArrayRef
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface DateBlockCollection<B extends DateBlock = DateBlock> extends DateBlockTimingRef, DateBlockArrayRef<B> {
 }
 /**
  * An expanded DateBlock that implements DateDurationSpan and contains the DateBlock values.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockDurationSpan<B extends DateBlock = DateBlock> = DateDurationSpan & B;
 /**
  * Convenience function for calling expandDateBlocks() with the input DateBlockCollection.
  *
+ * @deprecated use DateCell implementation instead.
  * @param collection
  * @returns
  */
@@ -500,16 +687,27 @@ export declare function expandDateBlockCollection<B extends DateBlock = DateBloc
 /**
  * Convenience function for calling dateBlocksExpansionFactory() then passing the blocks.
  *
+ * @deprecated use DateCell implementation instead.
  * @param blocks
  * @param timing
  * @returns
  */
 export declare function expandDateBlocks<B extends DateBlock = DateBlock>(timing: DateBlockTiming, blocks: B[]): DateBlockDurationSpan<B>[];
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export declare type DateBlocksExpansionFactoryInput<B extends DateBlock | DateBlockRange = DateBlock> = DateBlockArrayRef<B> | DateBlockArray<B>;
 /**
  * Used to convert the input DateBlocksExpansionFactoryInput into an array of DateBlockDurationSpan values
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlocksExpansionFactory<B extends DateBlock | DateBlockRange = DateBlock> = (input: DateBlocksExpansionFactoryInput<B>) => DateBlockDurationSpan<B>[];
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface DateBlocksExpansionFactoryConfig<B extends DateBlock | DateBlockRange = DateBlock> {
     /**
      * Timing to use in the configuration.
@@ -542,11 +740,20 @@ export interface DateBlocksExpansionFactoryConfig<B extends DateBlock | DateBloc
 /**
  * Creates a DateBlocksExpansionFactory
  *
+ * @deprecated use DateCell implementation instead.
  * @param config
  * @returns
  */
 export declare function dateBlocksExpansionFactory<B extends DateBlock | DateBlockRange = DateBlock>(config: DateBlocksExpansionFactoryConfig): DateBlocksExpansionFactory<B>;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export declare type DateBlockDayTimingInfoFactoryConfig = Pick<DateBlocksExpansionFactoryConfig, 'timing' | 'rangeLimit'>;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface DateBlockDayTimingInfo {
     /**
      * Input date or calculated date if provided a dayIndex.
@@ -611,22 +818,45 @@ export interface DateBlockDayTimingInfo {
  * The date may not exist within the range, but will still compute values using the input date and timing configuration.
  *
  * Can optionally specify a now that is used for checking the inProgress functionality.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockDayTimingInfoFactory = (date: DateOrDateBlockIndex, now?: Date) => DateBlockDayTimingInfo;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param config
+ * @returns
+ */
 export declare function dateBlockDayTimingInfoFactory(config: DateBlockDayTimingInfoFactoryConfig): DateBlockDayTimingInfoFactory;
 /**
  * IndexRange used with DateBlocks.
  *
  * It has an exclusive max range. It is similar to a DateBlockRange.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockIndexRange = IndexRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @returns
+ */
 export declare function dateBlockRangeToDateBlockIndexRange(range: DateBlockRange): DateBlockIndexRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @returns
+ */
 export declare function dateBlockIndexRangeToDateBlockRange(range: DateBlockIndexRange): DateBlockRangeWithRange;
 /**
  * Generates a DateBlockIndexRange based on the input timing.
  *
  * An arbitrary limit can also be applied.
  *
+ * @deprecated use DateCell implementation instead.
  * @param timing
  * @param limit
  * @param fitToTimingRange
@@ -635,20 +865,33 @@ export declare function dateBlockIndexRange(timing: DateBlockTiming, limit?: Dat
 /**
  * Returns blocks that are only in the given DateBlockRange.
  *
+ * @deprecated use DateCell implementation instead.
  * @param blocks
  * @param range
  * @returns
  */
 export declare function filterDateBlocksInDateBlockRange<T extends DateBlock | DateBlockRange>(blocks: T[], range: DateBlockRangeWithRange): T[];
+/**
+ * @deprecated use DateCell implementation instead.
+ */
 export declare type IsDateBlockWithinDateBlockRangeInput = DateBlockOrDateBlockIndexOrDateBlockRange;
 /**
  * Function that returns true if the input range is equal or falls within the configured DateBlockRange.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type IsDateBlockWithinDateBlockRangeFunction = (input: IsDateBlockWithinDateBlockRangeInput) => boolean;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param inputRange
+ * @returns
+ */
 export declare function isDateBlockWithinDateBlockRangeFunction(inputRange: IsDateBlockWithinDateBlockRangeInput): IsDateBlockWithinDateBlockRangeFunction;
 /**
  * Returns true if the first DateBlock or DateBlockRange contains the second input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param range
  * @param isContainedWithin
  * @returns
@@ -656,12 +899,20 @@ export declare function isDateBlockWithinDateBlockRangeFunction(inputRange: IsDa
 export declare function isDateBlockWithinDateBlockRange(range: IsDateBlockWithinDateBlockRangeInput, contains: IsDateBlockWithinDateBlockRangeInput): boolean;
 /**
  * Input for a IsDateWithinDateBlockRangeFunction
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type IsDateWithinDateBlockRangeInput = DateOrDateBlockIndex | DateRangeStart | DateRange | DateBlock | DateBlockRange;
 /**
  * Function that returns true if the input range is equal or falls within the configured DateBlockRange.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type IsDateWithinDateBlockRangeFunction = (input: IsDateWithinDateBlockRangeInput) => boolean;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface IsDateWithinDateBlockRangeConfig {
     /**
      * Optional date to make the indexes relative to when converting date values.
@@ -674,9 +925,17 @@ export interface IsDateWithinDateBlockRangeConfig {
      */
     range: IsDateWithinDateBlockRangeInput;
 }
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param config
+ * @returns
+ */
 export declare function isDateWithinDateBlockRangeFunction(config: IsDateWithinDateBlockRangeConfig): IsDateWithinDateBlockRangeFunction;
 /**
  * Represents a range of DateBlock values.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface DateBlockRange extends DateBlock {
     /**
@@ -686,17 +945,24 @@ export interface DateBlockRange extends DateBlock {
      */
     to?: DateBlockIndex;
 }
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export declare class DateBlockRange extends DateBlock {
     to?: DateBlockIndex;
     constructor(template?: DateBlockRange);
 }
 /**
  * A DateBlockIndex, DateBlock, or DateBlockRange
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockOrDateBlockIndexOrDateBlockRange = DateBlockIndex | DateBlock | DateBlockRange;
 /**
  * Returns true if the input is a valid DateBlockRange.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -704,6 +970,7 @@ export declare function isValidDateBlockRange(input: DateBlockRange): boolean;
 /**
  * Returns true if the input is a sorted DateBlockRange array and there are no repeat indexes.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -712,12 +979,16 @@ export declare function isValidDateBlockRangeSeries(input: DateBlockRange[]): bo
  * 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.
  */
 export declare function getLeastDateBlockIndexInDateBlockRanges(input: (DateBlock | DateBlockRange)[]): DateBlockIndex;
 /**
  * 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.
  */
 export declare function getGreatestDateBlockIndexInDateBlockRanges(input: (DateBlock | DateBlockRange)[]): DateBlockIndex;
 export interface LeastAndGreatestDateBlockIndexResult<T> {
@@ -730,20 +1001,33 @@ export interface LeastAndGreatestDateBlockIndexResult<T> {
  * 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.
  */
 export declare function getLeastAndGreatestDateBlockIndexInDateBlockRanges<T extends DateBlockRange>(input: T[]): Maybe<LeastAndGreatestDateBlockIndexResult<T>>;
 /**
  * Input type used for cases where a DateRange or a DateBlockRange are allowed as input but used the start/end parameters in DateRange.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface DateBlockRangeOrDateRange {
     start?: Maybe<DateOrDateBlockIndex>;
     end?: Maybe<DateOrDateBlockIndex>;
 }
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export declare type DateOrDateBlockIndexOrDateBlockRange = DateOrDateBlockIndex | DateBlockRange;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export declare type DateOrDateRangeOrDateBlockIndexOrDateBlockRange = DateRange | DateOrDateBlockIndexOrDateBlockRange;
 /**
  * Creates a DateBlockRange
  *
+ * @deprecated use DateCell implementation instead.
  * @param i
  * @param to
  * @returns
@@ -752,6 +1036,7 @@ export declare function dateBlockRange(i: number, to?: number): DateBlockRangeWi
 /**
  * Creates a DateBlockRangeWithRange from the input DateBlockIndex.
  *
+ * @deprecated use DateCell implementation instead.
  * @param dateBlockIndex
  * @returns
  */
@@ -759,6 +1044,7 @@ export declare function dateBlockRangeWithRangeFromIndex(dateBlockIndex: DateBlo
 /**
  * Creates a DateBlockRangeWithRange from the input DateBlockIndex, DateBlock, or DateBlockRange.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
@@ -770,17 +1056,21 @@ export declare type DateBlockRangeIncludedByRangeFunction = (range: DateBlockOrD
 /**
  * Creates a DateBlockRangeIncludedByRangeFunction
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputRange
  * @returns
  */
 export declare function dateBlockRangeIncludedByRangeFunction(inputRange: DateBlockOrDateBlockIndexOrDateBlockRange): DateBlockRangeIncludedByRangeFunction;
 /**
  * Function that returns true if the input range overlaps the range of the configured DateBlockRange.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockRangeOverlapsRangeFunction = (range: DateBlockOrDateBlockIndexOrDateBlockRange) => boolean;
 /**
  * Creates a DateBlockRangeOverlapsRangeFunction
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputRange
  * @returns
  */
@@ -788,6 +1078,7 @@ export declare function dateBlockRangeOverlapsRangeFunction(inputRange: DateBloc
 /**
  * Returns true if either of the ranges overlap eachother.
  *
+ * @deprecated use DateCell implementation instead.
  * @param rangeA
  * @param rangeB
  * @returns
@@ -798,37 +1089,49 @@ export declare function dateBlockRangeOverlapsRange(rangeA: DateBlockOrDateBlock
  *
  * In many cases sortAscendingIndexNumberRefFunction may be preferential since
  *
+ * @deprecated use DateCell implementation instead.
  * @returns
  */
 export declare function sortDateBlockRangeAndSizeFunction<T extends DateBlockRange>(): SortCompareFunction<T>;
 /**
  * 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
  */
 export declare function sortDateBlockRanges<T extends DateBlockRange>(input: T[]): T[];
 /**
  * DateBlockRange that is known to have a to value.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockRangeWithRange = RequiredOnKeys<DateBlockRange, 'to'>;
 /**
  * Groups the input values into DateBlockRange values.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  */
 export declare function groupToDateBlockRanges(input: (DateBlock | DateBlockRange)[]): DateBlockRangeWithRange[];
 /**
  * Returns an array containing all indexes in the date block range.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare function allIndexesInDateBlockRange(input: DateBlockRange): DateBlockIndex[];
 /**
  * Returns the set of all indexes within the input.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
 export declare function allIndexesInDateBlockRanges(input: (DateBlockIndex | DateBlockRange)[]): Set<DateBlockIndex>;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface DateBlockRangeBlockCountInfo {
     /**
      * Total number of blocks.
@@ -846,6 +1149,7 @@ export interface DateBlockRangeBlockCountInfo {
 /**
  * Counts the number of blocks in the input range.
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputDateBlockRange
  * @returns
  */
@@ -853,17 +1157,21 @@ export declare function dateBlockRangeBlocksCountInfo(inputDateBlockRange: Array
 /**
  * Counts the number of blocks in the input range.
  *
+ * @deprecated use DateCell implementation instead.
  * @param inputDateBlockRange
  * @returns
  */
 export declare function dateBlockRangeBlocksCount(inputDateBlockRange: ArrayOrValue<DateBlock | DateBlockRange>): number;
 /**
  * Checks whether or not the input range is fully included by the configured ranges.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type DateBlockRangesFullyCoverDateBlockRangeFunction = (range: DateBlockRange) => boolean;
 /**
  * Creates a dateBlockRangesFullyCoverDateBlockRangeFunction
  *
+ * @deprecated use DateCell implementation instead.
  * @param ranges
  * @returns
  */
@@ -871,35 +1179,44 @@ export declare function dateBlockRangesFullyCoverDateBlockRangeFunction(ranges:
 /**
  * Expands a DateBlockRange into an array of DateBlock values.
  *
+ * @deprecated use DateCell implementation instead.
  * @param block
  * @returns
  */
 export declare function expandDateBlockRange<B extends DateBlockRange | DateBlockRangeWithRange>(block: B): B[];
 /**
  * A DateBlock that also has the potential for a unique identifier.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface UniqueDateBlock extends DateBlock, UniqueModel {
 }
 /**
  * Represents a range of UniqueDateBlock values keyed by a similar identifier (or lack of identifier).
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface UniqueDateBlockRange extends UniqueDateBlock, DateBlockRange {
 }
 /**
  * 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
  */
 export declare function dateBlockRangeHasRange(input: DateBlockRange | UniqueDateBlock): input is DateBlockRangeWithRange;
 /**
  * Reads the to index if it exists, or returns the block's index itself.
  *
+ * @deprecated use DateCell implementation instead.
  * @param input
  * @returns
  */
 export declare function dateBlockEndIndex(input: DateBlockRange | UniqueDateBlock): IndexNumber;
 /**
  * A grouping of UniqueDateBlock values, sorted by date range.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export interface UniqueDateBlockRangeGroup<B extends DateBlockRange | UniqueDateBlock> extends DateBlockRange {
     /**
@@ -909,20 +1226,30 @@ export interface UniqueDateBlockRangeGroup<B extends DateBlockRange | UniqueDate
 }
 /**
  * Groups all input DateBlockRange or UniqueDateBlock values into a UniqueDateBlockRangeGroup value amd sorts the input.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare function groupUniqueDateBlocks<B extends DateBlockRange | UniqueDateBlock>(input: B[]): UniqueDateBlockRangeGroup<B>;
 /**
  * Determines how to "fill" a DateRange when an empty range is detected.
  * - extend: extends the previous block to fill the range.
  * - fill: creates a new value using a factory.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type ExpandUniqueDateBlocksFillOption = 'extend' | 'fill';
 /**
  * Determines how overwrite block values that are completely overlapping eachother.
  * - current: keeps the "current" value
  * - next: the next/new value overwrites the previous one
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type ExpandUniqueDateBlocksRetainOverlapOption = 'current' | 'next';
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface ExpandUniqueDateBlocksConfig<B extends DateBlockRange | UniqueDateBlock> {
     /**
      * The expected start index.
@@ -954,6 +1281,10 @@ export interface ExpandUniqueDateBlocksConfig<B extends DateBlockRange | UniqueD
      */
     fillFactory?: FactoryWithRequiredInput<B, DateBlockRangeWithRange>;
 }
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ */
 export interface ExpandUniqueDateBlocksResult<B extends DateBlockRange | UniqueDateBlock> extends UniqueDateBlockRangeGroup<B> {
     /**
      * Blocks that were competely removed. Some blocks stay partially retained.
@@ -964,18 +1295,44 @@ export interface ExpandUniqueDateBlocksResult<B extends DateBlockRange | UniqueD
  * Expansion function used to sort/merge/replace DateBlockRange values by block.
  *
  * Can optionally specify a second array/group of blocks that are treated as "next" blocks which can take priority or not depending on the retain options.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type ExpandUniqueDateBlocksFunction<B extends DateBlockRange | UniqueDateBlock> = (input: B[] | UniqueDateBlockRangeGroup<B>, newBlocks?: B[] | UniqueDateBlockRangeGroup<B>) => ExpandUniqueDateBlocksResult<B>;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param config
+ * @returns
+ */
 export declare function expandUniqueDateBlocksFunction<B extends DateBlockRange | UniqueDateBlock>(config: ExpandUniqueDateBlocksConfig<B>): ExpandUniqueDateBlocksFunction<B>;
 /**
  * Modifies or filter out any blocks that are outside the range to fit within the configured range.
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare type ModifyDateBlocksToFitRangeFunction = <B extends DateBlock | DateBlockRange | UniqueDateBlock>(input: B[]) => B[];
 /**
  * Creatse a ModifyDateBlocksToFitRangeFunction
+ *
+ * @deprecated use DateCell implementation instead.
  */
 export declare function modifyDateBlocksToFitRangeFunction(range: DateBlockRange): ModifyDateBlocksToFitRangeFunction;
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @param input
+ * @returns
+ */
 export declare function modifyDateBlocksToFitRange<B extends DateBlock | DateBlockRange | UniqueDateBlock>(range: DateBlockRange, input: B[]): B[];
+/**
+ *
+ * @deprecated use DateCell implementation instead.
+ * @param range
+ * @param input
+ * @returns
+ */
 export declare function modifyDateBlockToFitRange<B extends DateBlock | DateBlockRange | UniqueDateBlock>(range: DateBlockRange, input: B): Maybe<B>;
 /**
  * @deprecated use dateBlocksInDateBlockRange instead.