date-vir 8.6.4 → 9.1.0

package/README.md

@@ -37,24 +37,24 @@ import {
     getNowFullDate,
     parseDateStringWithPattern,
     parseInputElementValue,
-    Timezone,
+    TimezoneName,
 } from 'date-vir';
 
 /**
  * Creates a FullDate from a wide range of possible inputs. See TypeScript types for full details on
  * available inputs.
  */
-createFullDate('2023-06-05', Timezone['Europe/Rome']);
+createFullDate('2023-06-05', TimezoneName['Europe/Rome']);
 
 /** Get the current date and time right now in the given timezone. */
-getNowFullDate(Timezone['America/Argentina/Buenos_Aires']);
+getNowFullDate(TimezoneName['America/Argentina/Buenos_Aires']);
 
 /**
  * Parsed the value of an <input> element directly from the element itself. This is intended to be
  * used for type="date" or type="time" <input> elements, but any input element with a valid date or
  * time string will work.
  */
-parseInputElementValue(document.querySelector('input'), Timezone['Asia/Tokyo']);
+parseInputElementValue(document.querySelector('input'), TimezoneName['Asia/Tokyo']);
 
 /**
  * If you have a really oddly formatted date/time string and createFullDate does not suffice, you
@@ -65,7 +65,7 @@ parseInputElementValue(document.querySelector('input'), Timezone['Asia/Tokyo']);
 parseDateStringWithPattern({
     dateString: '870-0-14-19 5 2023 6',
     formatString: 'S-s-h-m d yyyy M',
-    timezone: Timezone['America/Cancun'],
+    timezone: TimezoneName['America/Cancun'],
 });
 ```
 
@@ -80,14 +80,14 @@ import {
     createFullDate,
     formatPresets,
     FullDatePart,
-    Timezone,
+    TimezoneName,
     toHtmlInputString,
     toLocaleString,
     toTimestamp,
     toUtcIsoString,
 } from 'date-vir';
 
-const myFullDate = createFullDate('2023-06-05T14:19:00.870Z', Timezone['America/Chicago']);
+const myFullDate = createFullDate('2023-06-05T14:19:00.870Z', TimezoneName['America/Chicago']);
 
 /**
  * Converts the given FullDate into a UTC unix timestamp with milliseconds. Since the output is a
@@ -123,11 +123,11 @@ toHtmlInputString(myFullDate, FullDatePart.Date); // returns '2023-06-05'
 <!-- example-link: src/readme-examples/timezones.example.ts -->
 
 ```TypeScript
-import {Timezone, userTimezone, utcTimezone} from 'date-vir';
+import {TimezoneName, userTimezone, utcTimezone} from 'date-vir';
 
-Timezone['Africa/Abidjan'];
-Timezone['America/Los_Angeles'];
-Timezone['Etc/GMT+1'];
+TimezoneName['Africa/Abidjan'];
+TimezoneName['America/Los_Angeles'];
+TimezoneName['Etc/GMT+1'];
 
 utcTimezone;
 userTimezone;
@@ -142,9 +142,9 @@ The parsing and timezone conversions in `date-vir` utilize the [`luxon`](https:/
 <!-- example-link: src/readme-examples/luxon-conversion.example.ts -->
 
 ```TypeScript
-import {createFullDate, Timezone, toLuxonDateTime} from 'date-vir';
+import {createFullDate, TimezoneName, toLuxonDateTime} from 'date-vir';
 
-const myFullDate = createFullDate('2023-06-05T14:19:00.870Z', Timezone['America/Chicago']);
+const myFullDate = createFullDate('2023-06-05T14:19:00.870Z', TimezoneName['America/Chicago']);
 
 toLuxonDateTime(myFullDate);
 ```

package/dist/date-operations/calculate-relative-date.d.ts

@@ -1,5 +1,6 @@
 import { type AnyDuration } from '@date-vir/duration';
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Calculates a new date starting at the given fullDate and adding the given offsets. Offsets can be
  * negative to go backwards in time.
@@ -13,4 +14,4 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  * calculateRelativeDate(getNowInUserTimezone(), {days: 2});
  * ```
  */
-export declare function calculateRelativeDate<const SpecificTimezone extends string>(fullDate: Readonly<FullDate<SpecificTimezone>>, offset: Readonly<AnyDuration>): FullDate<SpecificTimezone>;
+export declare function calculateRelativeDate<const SpecificTimezone extends Timezone>(fullDate: Readonly<FullDate<SpecificTimezone>>, offset: Readonly<AnyDuration>): FullDate<SpecificTimezone>;

package/dist/date-operations/combine-dates.d.ts

@@ -1,11 +1,12 @@
 import { type FullDatePart } from '../full-date/full-date-parts.js';
 import { type DatePart, type FullDate, type TimePart } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * An object containing date and/or time parts or neither. Used for {@link combineDateParts}
  *
  * @category Internal
  */
-export type MaybeDateParts<SpecificTimezone extends string> = Partial<{
+export type MaybeDateParts<SpecificTimezone extends Timezone> = Partial<{
     [FullDatePart.Date]: DatePart<SpecificTimezone> | undefined | Partial<FullDate<SpecificTimezone>>;
     [FullDatePart.Time]: TimePart<SpecificTimezone> | undefined | Partial<FullDate<SpecificTimezone>>;
 }>;
@@ -14,8 +15,8 @@ export type MaybeDateParts<SpecificTimezone extends string> = Partial<{
  *
  * @category Internal
  */
-export type MaybeDatePart<SpecificTimezone extends string> = FullDate<SpecificTimezone> | Partial<FullDate<SpecificTimezone>> | DatePart<SpecificTimezone> | TimePart<SpecificTimezone> | undefined;
-export declare function combineDateParts<const SpecificTimezone extends string>(maybeDateParts: {
+export type MaybeDatePart<SpecificTimezone extends Timezone> = FullDate<SpecificTimezone> | Partial<FullDate<SpecificTimezone>> | DatePart<SpecificTimezone> | TimePart<SpecificTimezone> | undefined;
+export declare function combineDateParts<const SpecificTimezone extends Timezone>(maybeDateParts: {
     [FullDatePart.Date]: DatePart<SpecificTimezone>;
     [FullDatePart.Time]: TimePart<SpecificTimezone>;
 }): FullDate<SpecificTimezone>;
@@ -23,20 +24,20 @@ export declare function combineDateParts(maybeDateParts: {
     [FullDatePart.Date]?: undefined;
     [FullDatePart.Time]?: undefined;
 }): undefined;
-export declare function combineDateParts<const SpecificTimezone extends string>(maybeDateParts: {
+export declare function combineDateParts<const SpecificTimezone extends Timezone>(maybeDateParts: {
     [FullDatePart.Date]: DatePart<SpecificTimezone>;
     [FullDatePart.Time]?: undefined;
 }): DatePart<SpecificTimezone>;
-export declare function combineDateParts<const SpecificTimezone extends string>(maybeDateParts: {
+export declare function combineDateParts<const SpecificTimezone extends Timezone>(maybeDateParts: {
     [FullDatePart.Date]: DatePart<SpecificTimezone>;
     [FullDatePart.Time]?: TimePart<SpecificTimezone> | undefined | Partial<FullDate<SpecificTimezone>>;
 }): FullDate<SpecificTimezone> | DatePart<SpecificTimezone>;
-export declare function combineDateParts<const SpecificTimezone extends string>(maybeDateParts: {
+export declare function combineDateParts<const SpecificTimezone extends Timezone>(maybeDateParts: {
     [FullDatePart.Date]?: undefined;
     [FullDatePart.Time]: TimePart<SpecificTimezone>;
 }): TimePart<SpecificTimezone>;
-export declare function combineDateParts<const SpecificTimezone extends string>(maybeDateParts: {
+export declare function combineDateParts<const SpecificTimezone extends Timezone>(maybeDateParts: {
     [FullDatePart.Date]?: DatePart<SpecificTimezone> | undefined | Partial<FullDate<SpecificTimezone>>;
     [FullDatePart.Time]: TimePart<SpecificTimezone>;
 }): FullDate<SpecificTimezone> | TimePart<SpecificTimezone>;
-export declare function combineDateParts<const SpecificTimezone extends string>(maybeDateParts: MaybeDateParts<SpecificTimezone>): MaybeDatePart<SpecificTimezone>;
+export declare function combineDateParts<const SpecificTimezone extends Timezone>(maybeDateParts: MaybeDateParts<SpecificTimezone>): MaybeDatePart<SpecificTimezone>;

package/dist/date-operations/date-position.d.ts

@@ -1,5 +1,6 @@
 import { DateUnit } from '@date-vir/duration';
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Get the {@link DateUnit} value of a {@link FullDate}.
  *
@@ -53,7 +54,7 @@ export declare function getDateUnit(date: Readonly<FullDate>, unit: DateUnit): n
  * ); // outputs {year: 2024, month: 11, day: 1, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: utcTimezone}
  * ```
  */
-export declare function getStartDate<const SpecificTimezone extends string>(date: Readonly<FullDate<SpecificTimezone>>, unit: DateUnit): FullDate<SpecificTimezone>;
+export declare function getStartDate<const SpecificTimezone extends Timezone>(date: Readonly<FullDate<SpecificTimezone>>, unit: DateUnit): FullDate<SpecificTimezone>;
 /**
  * Get the end date of a specific {@link DateUnit} based on a given {@link FullDate}.
  *
@@ -80,7 +81,7 @@ export declare function getStartDate<const SpecificTimezone extends string>(date
  * ); // outputs {year: 2024, month: 11, day: 30, hour: 23, minute: 59, second: 59, millisecond: 999, timezone: utcTimezone}
  * ```
  */
-export declare function getEndDate<const SpecificTimezone extends string>(date: Readonly<FullDate<SpecificTimezone>>, unit: DateUnit): FullDate<SpecificTimezone>;
+export declare function getEndDate<const SpecificTimezone extends Timezone>(date: Readonly<FullDate<SpecificTimezone>>, unit: DateUnit): FullDate<SpecificTimezone>;
 /**
  * Shape definition for all valid date position calculations. Used for {@link calculateDatePosition}.
  *

package/dist/date-operations/diff-dates.d.ts

@@ -13,7 +13,7 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  * @example
  *
  * ```ts
- * import {diffDates, DurationUnit} from 'date-vir';
+ * import {diffDates, DurationUnit, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -23,7 +23,7 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * // get the diff in days
@@ -59,7 +59,7 @@ units: SelectedUnits, options?: Readonly<RoundOptions>): DurationBySelection<Sel
  * @example
  *
  * ```ts
- * import {isDateAfter, type FullDate} from 'date-vir';
+ * import {isDateAfter, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -69,7 +69,7 @@ units: SelectedUnits, options?: Readonly<RoundOptions>): DurationBySelection<Sel
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * isDateAfter({

package/dist/date-operations/diff-dates.js

@@ -31,7 +31,7 @@ function getHighestPriorityConversionAccuracy(units) {
  * @example
  *
  * ```ts
- * import {diffDates, DurationUnit} from 'date-vir';
+ * import {diffDates, DurationUnit, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -41,7 +41,7 @@ function getHighestPriorityConversionAccuracy(units) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * // get the diff in days
@@ -85,7 +85,7 @@ units, options = {}) {
  * @example
  *
  * ```ts
- * import {isDateAfter, type FullDate} from 'date-vir';
+ * import {isDateAfter, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -95,7 +95,7 @@ units, options = {}) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * isDateAfter({

package/dist/duration-shape.d.ts

@@ -5,3 +5,297 @@ import { DurationUnit } from '@date-vir/duration';
  * @category Duration
  */
 export declare const anyDurationShape: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<Partial<Record<DurationUnit, number>>>>;
+/**
+ * A shape definition for {@link AtLeastOneDuration}.
+ *
+ * @category Duration
+ */
+export declare const atLeastOneDurationShape: (defaultValue?: (((Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Months>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Weeks>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Days>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Hours>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Minutes>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Seconds>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Milliseconds>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds>>)) & {}) | undefined) => import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<((Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Months>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Weeks>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Days>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Hours>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Minutes | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Minutes>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Seconds | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Seconds>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Milliseconds>>) | (Required<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Milliseconds>> & Partial<Pick<{
+    years: number;
+    months: number;
+    weeks: number;
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    milliseconds: number;
+}, DurationUnit.Years | DurationUnit.Months | DurationUnit.Weeks | DurationUnit.Days | DurationUnit.Hours | DurationUnit.Minutes | DurationUnit.Seconds>>)) & {}>>;

package/dist/duration-shape.js

@@ -1,5 +1,6 @@
+import { check } from '@augment-vir/assert';
 import { DurationUnit } from '@date-vir/duration';
-import { enumShape, recordShape } from 'object-shape-tester';
+import { checkValidShape, createCustomShape, enumShape, recordShape } from 'object-shape-tester';
 /**
  * A shape definition for `AnyDuration`.
  *
@@ -10,3 +11,19 @@ export const anyDurationShape = recordShape({
     values: -1,
     partial: true,
 });
+/**
+ * A shape definition for {@link AtLeastOneDuration}.
+ *
+ * @category Duration
+ */
+export const atLeastOneDurationShape = createCustomShape({
+    default: {
+        milliseconds: 0,
+    },
+    name: 'AtLeastOneDuration',
+    checkValue(value) {
+        return (checkValidShape(value, anyDurationShape, {
+            preventExtraKeys: true,
+        }) && !check.isEmpty(value));
+    },
+});

package/dist/extra-utils/has-date-props.d.ts

@@ -1,5 +1,6 @@
 import { type PartialWithUndefined, type SetRequiredAndNotNull } from '@augment-vir/common';
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Checks that the input has all the requested {@link FullDate} keys.
  *
@@ -13,7 +14,7 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  * hasFullDateKeys({year: 2024}, ['day']); // `false`
  * ```
  */
-export declare function hasFullDateKeys<SpecificTimezone extends string, PartialFullDate extends PartialWithUndefined<FullDate<SpecificTimezone>>, 
+export declare function hasFullDateKeys<SpecificTimezone extends Timezone, PartialFullDate extends PartialWithUndefined<FullDate<SpecificTimezone>>, 
 /** A union of strings. */
 RequiredKeys extends keyof FullDate<SpecificTimezone>>(partialFullDate: PartialWithUndefined<FullDate<SpecificTimezone>>, keys: ReadonlyArray<RequiredKeys>): partialFullDate is SetRequiredAndNotNull<PartialFullDate, RequiredKeys>;
 /**
@@ -29,6 +30,6 @@ RequiredKeys extends keyof FullDate<SpecificTimezone>>(partialFullDate: PartialW
  * assertHasFullDateKeys({year: 2024}, ['day']); // fails
  * ```
  */
-export declare function assertHasFullDateKeys<SpecificTimezone extends string, PartialFullDate extends PartialWithUndefined<FullDate<SpecificTimezone>>, 
+export declare function assertHasFullDateKeys<SpecificTimezone extends Timezone, PartialFullDate extends PartialWithUndefined<FullDate<SpecificTimezone>>, 
 /** A union of strings. */
 RequiredKeys extends keyof FullDate<SpecificTimezone>>(partialFullDate: PartialWithUndefined<FullDate<SpecificTimezone>>, keys: ReadonlyArray<RequiredKeys>): asserts partialFullDate is SetRequiredAndNotNull<PartialFullDate, RequiredKeys>;

package/dist/extra-utils/js-date-conversion.d.ts

@@ -7,7 +7,7 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  * @example
  *
  * ```ts
- * import {toJsDate, type FullDate} from 'date-vir';
+ * import {toJsDate, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -17,7 +17,7 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toJsDate(exampleDate);

package/dist/extra-utils/js-date-conversion.js

@@ -8,7 +8,7 @@ import { userTimezone } from '../timezone/timezones.js';
  * @example
  *
  * ```ts
- * import {toJsDate, type FullDate} from 'date-vir';
+ * import {toJsDate, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -18,7 +18,7 @@ import { userTimezone } from '../timezone/timezones.js';
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toJsDate(exampleDate);

package/dist/extra-utils/now.d.ts

@@ -1,6 +1,6 @@
 import { type UtcIsoString } from '../formatting/string-format-types.js';
 import { type FullDate } from '../full-date/full-date-shape.js';
-import { type UtcTimezone } from '../timezone/timezones.js';
+import { type Timezone, type UtcTimezone } from '../timezone/timezones.js';
 /**
  * Get the time right now as a UTC ISO.
  *
@@ -47,10 +47,10 @@ export declare function getNowInUtcTimezone(): FullDate<UtcTimezone>;
  * @example
  *
  * ```ts
- * import {getNowFullDate, utcTimezone, timezones} from 'date-vir';
+ * import {getNowFullDate, TimezoneName, utcTimezone} from 'date-vir';
  *
  * getNowFullDate(utcTimezone);
- * getNowFullDate(timezones['Australia/Brisbane']);
+ * getNowFullDate(TimezoneName['Australia/Brisbane']);
  * ```
  */
-export declare function getNowFullDate<const SpecificTimezone extends string>(timezone: SpecificTimezone): FullDate<SpecificTimezone>;
+export declare function getNowFullDate<const SpecificTimezone extends Timezone>(timezone: SpecificTimezone): FullDate<SpecificTimezone>;

package/dist/extra-utils/now.js

@@ -57,10 +57,10 @@ export function getNowInUtcTimezone() {
  * @example
  *
  * ```ts
- * import {getNowFullDate, utcTimezone, timezones} from 'date-vir';
+ * import {getNowFullDate, TimezoneName, utcTimezone} from 'date-vir';
  *
  * getNowFullDate(utcTimezone);
- * getNowFullDate(timezones['Australia/Brisbane']);
+ * getNowFullDate(TimezoneName['Australia/Brisbane']);
  * ```
  */
 export function getNowFullDate(timezone) {