Function maxDate

packages/forms/signals/src/api/rules/validation/max_date.ts:32–72

(
  path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,
  maxDateValue: Date | LogicFn<TValue, Date | undefined, TPathKind>,
  config?: BaseValidatorConfig<TValue, TPathKind>,
)

 * @publicApi 22.0
 */
export function maxDate<TValue extends Date | null, TPathKind extends PathKind = PathKind.Root>(
  path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>,
  maxDateValue: Date | LogicFn<TValue, Date | undefined, TPathKind>,
  config?: BaseValidatorConfig<TValue, TPathKind>,
): void {
  const MAX_MEMO = createMetadataKey<Date | undefined>();

  // Memoize the maximum valid date.
  metadata(path, MAX_MEMO, (ctx) => {
    if (config?.when && !config.when(ctx)) {
      return undefined;
    }
    return typeof maxDateValue === 'function' ? maxDateValue(ctx) : maxDateValue;
  });

  // Publish the memoized maximum date for aggregation.
  metadata(path, MAX_DATE, ({state}) => state.metadata(MAX_MEMO)!());

  // Use `MAX_DATE` to define the `max` property of the field.
  metadata(path, MAX, () => MAX_DATE as LimitKey<TValue>);

  // Validate that the field value is not greater than the maximum date.
  validate(path, (ctx) => {
    const value = ctx.value();
    if (value === null || Number.isNaN(value.getTime())) {
      return undefined;
    }
    const max = ctx.state.metadata(MAX_MEMO)!();
    if (max === undefined || Number.isNaN(max.getTime())) {
      return undefined;
    }
    if (value > max) {
      if (config?.error) {
        return getOption(config.error, ctx);
      } else {
        return maxDateError(max, {message: getOption(config?.message, ctx)});
      }
    }
    return undefined;
  });
}