date-vir 8.6.4 → 9.0.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/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) {

package/dist/extra-utils/override-date.d.ts

@@ -1,4 +1,5 @@
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Override the initial provided FullDate with all subsequent FullDate parts.
  *
@@ -6,7 +7,7 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  * @example
  *
  * ```ts
- * import {overrideDateParts, type FullDate} from 'date-vir';
+ * import {overrideDateParts, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -16,11 +17,11 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * overrideDateParts(exampleDate, {day: 20}, {second: 10});
- * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
-export declare function overrideDateParts<const SpecificTimezone extends string>(date: FullDate<SpecificTimezone>, ...overrides: Partial<FullDate<SpecificTimezone>>[]): FullDate<SpecificTimezone>;
+export declare function overrideDateParts<const SpecificTimezone extends Timezone>(date: FullDate<SpecificTimezone>, ...overrides: Partial<FullDate<SpecificTimezone>>[]): FullDate<SpecificTimezone>;

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

@@ -5,7 +5,7 @@
  * @example
  *
  * ```ts
- * import {overrideDateParts, type FullDate} from 'date-vir';
+ * import {overrideDateParts, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -15,11 +15,11 @@
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * overrideDateParts(exampleDate, {day: 20}, {second: 10});
- * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
 export function overrideDateParts(date, ...overrides) {

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

@@ -1,5 +1,6 @@
 import { TimeKey } from '../full-date/full-date-parts.js';
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * A {@link FullDate} instance that has the lowest, valid, non-negative, value for each property.
  *
@@ -50,7 +51,7 @@ export declare const zeroTime: Pick<{
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -60,14 +61,14 @@ export declare const zeroTime: Pick<{
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearTime(exampleDate);
- * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: utcTimezone}`
  * ```
  */
-export declare function clearTime<const SpecificTimezone extends string>(inputFullDate: Readonly<FullDate<SpecificTimezone>>): FullDate<SpecificTimezone>;
+export declare function clearTime<const SpecificTimezone extends Timezone>(inputFullDate: Readonly<FullDate<SpecificTimezone>>): FullDate<SpecificTimezone>;
 /**
  * Clear all the selected parts of {@link FullDate} by setting them each to their lowest, valid
  * value. See {@link zeroDate} for the lowest valid values for each property.
@@ -76,7 +77,7 @@ export declare function clearTime<const SpecificTimezone extends string>(inputFu
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -86,17 +87,17 @@ export declare function clearTime<const SpecificTimezone extends string>(inputFu
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearParts(exampleDate, [
  *     'year',
  *     'day',
  * ]);
- * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
-export declare function clearParts<const SpecificTimezone extends string>(inputFullDate: Readonly<FullDate<SpecificTimezone>>, parts: ReadonlyArray<Exclude<keyof FullDate, 'timezone'>>): {
+export declare function clearParts<const SpecificTimezone extends Timezone>(inputFullDate: Readonly<FullDate<SpecificTimezone>>, parts: ReadonlyArray<Exclude<keyof FullDate, 'timezone'>>): {
     year: number;
     month: import("@date-vir/duration").MonthNumber;
     day: import("@date-vir/duration").DayOfMonth;

package/dist/extra-utils/zero.js

@@ -35,7 +35,7 @@ export const zeroTime = pickObjectKeys(zeroDate, getEnumValues(TimeKey));
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -45,11 +45,11 @@ export const zeroTime = pickObjectKeys(zeroDate, getEnumValues(TimeKey));
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearTime(exampleDate);
- * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: utcTimezone}`
  * ```
  */
 export function clearTime(inputFullDate) {
@@ -63,7 +63,7 @@ export function clearTime(inputFullDate) {
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -73,14 +73,14 @@ export function clearTime(inputFullDate) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearParts(exampleDate, [
  *     'year',
  *     'day',
  * ]);
- * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
 export function clearParts(inputFullDate, parts) {

package/dist/formatting/simple-strings.d.ts

@@ -1,5 +1,6 @@
 import { type SetOptionalAndNullable } from '@augment-vir/common';
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 import { type JustDateString, type JustTimeString, type JustTimeWithSecondsString } from './string-format-types.js';
 /**
  * Create a string based on just the date parts of a FullDate.
@@ -57,7 +58,7 @@ export type FullDateForParts = SetOptionalAndNullable<FullDate, 'millisecond'>;
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */
@@ -66,7 +67,7 @@ export declare function toDatePartStrings(fullDate: FullDateForParts, options: {
 }): {
     date: JustDateString;
     time: JustTimeWithSecondsString;
-    timezone: string;
+    timezone: Timezone;
 };
 /**
  * Splits a FullDate up into multiple formatted string representations.
@@ -98,7 +99,7 @@ export declare function toDatePartStrings(fullDate: FullDateForParts, options: {
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */
@@ -107,7 +108,7 @@ export declare function toDatePartStrings(fullDate: SetOptionalAndNullable<FullD
 }): {
     date: JustDateString;
     time: JustTimeString;
-    timezone: string;
+    timezone: Timezone;
 };
 /**
  * Splits a FullDate up into multiple formatted string representations.
@@ -139,7 +140,7 @@ export declare function toDatePartStrings(fullDate: SetOptionalAndNullable<FullD
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */
@@ -148,7 +149,7 @@ export declare function toDatePartStrings(fullDate: FullDateForParts, options: {
 }): {
     date: JustDateString;
     time: JustTimeWithSecondsString | JustTimeString;
-    timezone: string;
+    timezone: Timezone;
 };
 /**
  * Converts a date into a simple, unambiguous date string.

package/dist/formatting/simple-strings.js

@@ -67,7 +67,7 @@ export function toSimpleTimePartString(fullDate, includeSeconds) {
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */

package/dist/formatting/timestamp.d.ts

@@ -8,7 +8,7 @@ import { type HttpDateString, type UtcIsoString } from './string-format-types.js
  * @example
  *
  * ```ts
- * import {toTimestamp} from 'date-vir';
+ * import {toTimestamp, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -18,7 +18,7 @@ import { type HttpDateString, type UtcIsoString } from './string-format-types.js
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toTimestamp(exampleDate); // `1704416461001`
@@ -37,7 +37,7 @@ export declare function toTimestamp(fullDate: FullDate): number;
  * @example
  *
  * ```ts
- * import {toUtcIsoString} from 'date-vir';
+ * import {toUtcIsoString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -47,7 +47,7 @@ export declare function toTimestamp(fullDate: FullDate): number;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toUtcIsoString(exampleDate); // `'2024-01-05T01:01:01.001Z'`
@@ -93,7 +93,7 @@ dateLike: Readonly<DateLike>): UtcIsoString;
  * @example
  *
  * ```ts
- * import {toHttpDateString} from 'date-vir';
+ * import {toHttpDateString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -103,7 +103,7 @@ dateLike: Readonly<DateLike>): UtcIsoString;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toHttpDateString(exampleDate); // `'Fri, 05 Jan 2024 01:01:01 GMT'`

package/dist/formatting/timestamp.js

@@ -8,7 +8,7 @@ import { utcTimezone } from '../timezone/timezones.js';
  * @example
  *
  * ```ts
- * import {toTimestamp} from 'date-vir';
+ * import {toTimestamp, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -18,7 +18,7 @@ import { utcTimezone } from '../timezone/timezones.js';
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toTimestamp(exampleDate); // `1704416461001`
@@ -39,7 +39,7 @@ export function toTimestamp(fullDate) {
  * @example
  *
  * ```ts
- * import {toUtcIsoString} from 'date-vir';
+ * import {toUtcIsoString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -49,7 +49,7 @@ export function toTimestamp(fullDate) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toUtcIsoString(exampleDate); // `'2024-01-05T01:01:01.001Z'`
@@ -105,7 +105,7 @@ dateLike) {
  * @example
  *
  * ```ts
- * import {toHttpDateString} from 'date-vir';
+ * import {toHttpDateString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -115,7 +115,7 @@ dateLike) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toHttpDateString(exampleDate); // `'Fri, 05 Jan 2024 01:01:01 GMT'`

package/dist/full-date/create-full-date.d.ts

@@ -1,4 +1,4 @@
-import { type UtcTimezone } from '../timezone/timezones.js';
+import { type Timezone, type UtcTimezone } from '../timezone/timezones.js';
 import { type DateLike } from './date-like.js';
 import { type FullDate } from './full-date-shape.js';
 /**
@@ -45,16 +45,16 @@ export declare function createUtcFullDate(dateLike: Readonly<DateLike>): FullDat
  * @example
  *
  * ```ts
- * import {createFullDate, timezones, utcTimezone} from 'date-vir';
+ * import {createFullDate, TimezoneName, utcTimezone} from 'date-vir';
  *
  * createFullDate('June 1, 2024', utcTimezone);
- * createFullDate(new Date(), timezones['Australia/Brisbane']);
- * createFullDate(112300120, timezones['Etc/GMT-11']);
+ * createFullDate(new Date(), TimezoneName['Australia/Brisbane']);
+ * createFullDate(112300120, TimezoneName['Etc/GMT-11']);
  * ```
  *
  * @throws Error: if a valid date cannot be created.
  */
-export declare function createFullDate<const SpecificTimezone extends string>(
+export declare function createFullDate<const SpecificTimezone extends Timezone>(
 /** The original date representation to be converted into a FullDate. */
 dateLike: Readonly<DateLike>, 
 /** The timezone that this date/time is meant for / originated from. */
@@ -67,7 +67,7 @@ timezone: SpecificTimezone): FullDate<SpecificTimezone>;
  * @example
  *
  * ```ts
- * import {toNewTimezone} from 'date-vir';
+ * import {toNewTimezone, TimezoneName, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -77,10 +77,10 @@ timezone: SpecificTimezone): FullDate<SpecificTimezone>;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
- * let result = toNewTimezone(exampleDate, timezones['Australia/Brisbane']);
+ * let result = toNewTimezone(exampleDate, TimezoneName['Australia/Brisbane']);
  * // output:
  * result = {
  *     year: 2024,
@@ -90,8 +90,8 @@ timezone: SpecificTimezone): FullDate<SpecificTimezone>;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: timezones['Australia/Brisbane'],
+ *     timezone: TimezoneName['Australia/Brisbane'],
  * };
  * ```
  */
-export declare function toNewTimezone<const SpecificTimezone extends string>(fullDate: Readonly<FullDate>, timezone: SpecificTimezone): FullDate<SpecificTimezone>;
+export declare function toNewTimezone<const SpecificTimezone extends Timezone>(fullDate: Readonly<FullDate>, timezone: SpecificTimezone): FullDate<SpecificTimezone>;

package/dist/full-date/create-full-date.js

@@ -53,11 +53,11 @@ export function createUtcFullDate(dateLike) {
  * @example
  *
  * ```ts
- * import {createFullDate, timezones, utcTimezone} from 'date-vir';
+ * import {createFullDate, TimezoneName, utcTimezone} from 'date-vir';
  *
  * createFullDate('June 1, 2024', utcTimezone);
- * createFullDate(new Date(), timezones['Australia/Brisbane']);
- * createFullDate(112300120, timezones['Etc/GMT-11']);
+ * createFullDate(new Date(), TimezoneName['Australia/Brisbane']);
+ * createFullDate(112300120, TimezoneName['Etc/GMT-11']);
  * ```
  *
  * @throws Error: if a valid date cannot be created.
@@ -81,7 +81,7 @@ timezone) {
  * @example
  *
  * ```ts
- * import {toNewTimezone} from 'date-vir';
+ * import {toNewTimezone, TimezoneName, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -91,10 +91,10 @@ timezone) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
- * let result = toNewTimezone(exampleDate, timezones['Australia/Brisbane']);
+ * let result = toNewTimezone(exampleDate, TimezoneName['Australia/Brisbane']);
  * // output:
  * result = {
  *     year: 2024,
@@ -104,7 +104,7 @@ timezone) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: timezones['Australia/Brisbane'],
+ *     timezone: TimezoneName['Australia/Brisbane'],
  * };
  * ```
  */

package/dist/full-date/date-like.d.ts

@@ -1,8 +1,9 @@
 import { type DateTime } from 'luxon';
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Types that can be converted into {@link FullDate} instances.
  *
  * @category Internal
  */
-export type DateLike<SpecificTimezone extends string = string> = string | Date | number | DateTime | FullDate<SpecificTimezone>;
+export type DateLike<SpecificTimezone extends Timezone = Timezone> = string | Date | number | DateTime | FullDate<SpecificTimezone>;

package/dist/full-date/full-date-shape.d.ts

@@ -1,6 +1,7 @@
 import { type Overwrite, type SetRequired } from '@augment-vir/common';
 import { type DayOfMonth, type Hour, type Minute, type MonthNumber, type Second } from '@date-vir/duration';
 import { type Simplify } from 'type-fest';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Time part of {@link FullDate} represented in a shape definition.
  *
@@ -16,14 +17,14 @@ export declare const timePartShape: import("object-shape-tester").Shape<{
     /** Millisecond of the second: 0-999 */
     millisecond: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<number>>;
     /** The timezone that this date/time is meant for / originated from. */
-    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<string>>;
+    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<Timezone>>;
 }>;
 /**
  * Time part of a {@link FullDate}.
  *
  * @category Internal
  */
-export type TimePart<SpecificTimezone extends string = string> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof timePartShape)['runtimeType']>;
+export type TimePart<SpecificTimezone extends Timezone = Timezone> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof timePartShape)['runtimeType']>;
 /**
  * Date part of {@link FullDate} represented in a shape definition.
  *
@@ -41,14 +42,14 @@ export declare const datePartShape: import("object-shape-tester").Shape<{
     /** A day of the month: 1-31 depending on the month */
     day: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<DayOfMonth>>;
     /** The timezone that this date/time is meant for / originated from. */
-    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<string>>;
+    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<Timezone>>;
 }>;
 /**
  * Date part of {@link FullDate}.
  *
  * @category Internal
  */
-export type DatePart<SpecificTimezone extends string = string> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof datePartShape)['runtimeType']>;
+export type DatePart<SpecificTimezone extends Timezone = Timezone> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof datePartShape)['runtimeType']>;
 /**
  * The complete {@link FullDate} represented in a shape definition.
  *
@@ -59,12 +60,12 @@ export declare const fullDateShape: import("object-shape-tester").Shape<import("
     minute: Minute;
     second: Minute;
     millisecond: number;
-    timezone: string;
+    timezone: Timezone;
 } & {
     year: number;
     month: MonthNumber;
     day: DayOfMonth;
-    timezone: string;
+    timezone: Timezone;
 }>>>;
 /**
  * A serializable object that completely specifies how any given date should be represented,
@@ -75,7 +76,7 @@ export declare const fullDateShape: import("object-shape-tester").Shape<import("
  * @example
  *
  * ```ts
- * import {FullDate, timezones} from 'date-vir';
+ * import {FullDate, TimezoneName} from 'date-vir';
  *
  * const myDate: FullDate = {
  *     year: 2024,
@@ -87,11 +88,11 @@ export declare const fullDateShape: import("object-shape-tester").Shape<import("
  *     second: 12,
  *
  *     milliseconds: 94,
- *     timezone: timezones['Australia/Brisbane'],
+ *     timezone: TimezoneName['Australia/Brisbane'],
  * };
  * ```
  */
-export type FullDate<SpecificTimezone extends string = string> = Simplify<Overwrite<(typeof fullDateShape)['runtimeType'], {
+export type FullDate<SpecificTimezone extends Timezone = Timezone> = Simplify<Overwrite<(typeof fullDateShape)['runtimeType'], {
     second: Second;
     timezone: SpecificTimezone;
 }>>;

package/dist/full-date/is-valid-full-date.d.ts

@@ -1,3 +1,4 @@
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Asserts that the input is a valid {@link FullDate}.
@@ -17,4 +18,4 @@ export declare function isValidFullDate(input: unknown): input is FullDate;
  *
  * @category Assertion
  */
-export declare function hasTimezone<const SpecificTimezone extends string>(input: FullDate, timezone: SpecificTimezone): input is FullDate<SpecificTimezone>;
+export declare function hasTimezone<const SpecificTimezone extends Timezone>(input: FullDate, timezone: SpecificTimezone): input is FullDate<SpecificTimezone>;

package/dist/full-date/luxon-date-time-conversion.d.ts

@@ -1,4 +1,5 @@
 import { DateTime } from 'luxon';
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Converts a {@link FullDate} object into a Luxon DateTime library. This is only needed if you need
@@ -15,4 +16,4 @@ export declare function toLuxonDateTime(fullDateInput: Readonly<FullDate>): Date
  *
  * @category Internal
  */
-export declare function parseLuxonDateTime<const SpecificTimezone extends string>(dateTimeInput: Readonly<DateTime>, forcedTimezone?: SpecificTimezone): FullDate<SpecificTimezone>;
+export declare function parseLuxonDateTime<const SpecificTimezone extends Timezone>(dateTimeInput: Readonly<DateTime>, forcedTimezone?: SpecificTimezone): FullDate<SpecificTimezone>;

package/dist/full-date/luxon-date-time-conversion.js

@@ -1,4 +1,4 @@
-import { omitObjectKeys } from '@augment-vir/common';
+import { applyBrand, omitObjectKeys } from '@augment-vir/common';
 import { assertWrapDayOfMonth, assertWrapHour, assertWrapMillisecond, assertWrapMinute, assertWrapMonthNumber, assertWrapSecond, } from '@date-vir/duration';
 import { DateTime } from 'luxon';
 /**
@@ -30,6 +30,11 @@ export function parseLuxonDateTime(dateTimeInput, forcedTimezone) {
     if (!dateTimeInput.isValid) {
         throw new Error(`Invalid input: '${dateTimeInput.toISO()}'`);
     }
+    const zoneName = dateTimeInput.zoneName;
+    if (zoneName == undefined) {
+        throw new Error('Valid Luxon dates must have a timezone.');
+    }
+    const brandedZoneName = applyBrand(zoneName);
     return {
         day: assertWrapDayOfMonth(dateTimeInput.day),
         month: assertWrapMonthNumber(dateTimeInput.month),
@@ -38,6 +43,6 @@ export function parseLuxonDateTime(dateTimeInput, forcedTimezone) {
         minute: assertWrapMinute(dateTimeInput.minute),
         second: assertWrapSecond(dateTimeInput.second),
         millisecond: assertWrapMillisecond(dateTimeInput.millisecond),
-        timezone: forcedTimezone ?? dateTimeInput.zoneName,
+        timezone: forcedTimezone ?? brandedZoneName,
     };
 }

package/dist/full-date/maybe-create-date.d.ts

@@ -1,3 +1,4 @@
+import { type Timezone } from '../timezone/timezones.js';
 import { type DateLike } from './date-like.js';
 import { type FullDate } from './full-date-shape.js';
 /**
@@ -5,7 +6,7 @@ import { type FullDate } from './full-date-shape.js';
  * timezone. If the conversion fails or the input {@link DateLike} is empty, `undefined` is
  * returned.
  */
-export declare function maybeCreateFullDate<const SpecificTimezone extends string>(
+export declare function maybeCreateFullDate<const SpecificTimezone extends Timezone>(
 /** The original date representation to be converted into a FullDate. */
 dateLike: Readonly<DateLike> | undefined | null, 
 /** The timezone that this date/time is meant for / originated from. */

package/dist/full-date/parsing.d.ts

@@ -1,3 +1,4 @@
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Parses any date string into a {@link FullDate} using the specified pattern and timezone. Prefer
@@ -11,7 +12,7 @@ import { type FullDate } from './full-date-shape.js';
  *
  * @category FullDate
  */
-export declare function parseDateStringWithPattern<const SpecificTimezone extends string>({ dateString, formatString, timezone, }: {
+export declare function parseDateStringWithPattern<const SpecificTimezone extends Timezone>({ dateString, formatString, timezone, }: {
     /** The date string to be parsed. */
     dateString: string;
     /**
@@ -29,4 +30,4 @@ export declare function parseDateStringWithPattern<const SpecificTimezone extend
  * @category FullDate
  * @category HTML
  */
-export declare function parseInputElementValue<const SpecificTimezone extends string>(elementOrValue: Readonly<Pick<HTMLInputElement, 'value'>> | string | null | undefined, timezone: SpecificTimezone): FullDate<SpecificTimezone> | undefined;
+export declare function parseInputElementValue<const SpecificTimezone extends Timezone>(elementOrValue: Readonly<Pick<HTMLInputElement, 'value'>> | string | null | undefined, timezone: SpecificTimezone): FullDate<SpecificTimezone> | undefined;

package/dist/full-date/string-parsing.d.ts

@@ -1,8 +1,9 @@
 import { DateTime } from 'luxon';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Tries extra known formats for parsing date strings, even those that browsers do not natively
  * support.
  *
  * @category Internal
  */
-export declare function parseDateString(dateString: string, timezone: string): DateTime | undefined;
+export declare function parseDateString(dateString: string, timezone: Timezone): DateTime | undefined;

package/dist/full-date/string-parsing.js

@@ -1,4 +1,3 @@
-/* eslint-disable @virmator/prefer-params-object */
 import { DateTime } from 'luxon';
 /**
  * These formats are for luxon, documented here:

package/dist/timezone/timezone-checks.d.ts

@@ -1,3 +1,4 @@
+import { type Timezone } from './timezones.js';
 /**
  * Checks that the given timezone is valid.
  *
@@ -7,7 +8,7 @@
  *
  * @category Assertion
  */
-export declare function isValidTimezone(potentialTimezone: string): boolean;
+export declare function isValidTimezone(raw: string): raw is Timezone;
 /**
  * Asserts that the given input is a valid timezone name.
  *
@@ -17,4 +18,16 @@ export declare function isValidTimezone(potentialTimezone: string): boolean;
  *
  * @category Assertion
  */
-export declare function assertValidTimezone(potentialTimezone: string, userMessage?: string | undefined): void;
+export declare function assertValidTimezone(raw: string, userMessage?: string | undefined): asserts raw is Timezone;
+/**
+ * Asserts that the given input is a valid timezone name and returns it.
+ *
+ * @category Assertion
+ */
+export declare function assertWrapValidTimezone(raw: string, userMessage?: string | undefined): Timezone;
+/**
+ * Checks that the given input is a valid timezone name and returns it when valid.
+ *
+ * @category Assertion
+ */
+export declare function checkWrapValidTimezone(raw: string): Timezone | undefined;

package/dist/timezone/timezone-checks.js

@@ -19,16 +19,16 @@ const ianaValidityCache = new Map();
  *
  * @category Assertion
  */
-export function isValidTimezone(potentialTimezone) {
-    if (knownTimezones.has(potentialTimezone)) {
+export function isValidTimezone(raw) {
+    if (knownTimezones.has(raw)) {
         return true;
     }
-    const cached = ianaValidityCache.get(potentialTimezone);
+    const cached = ianaValidityCache.get(raw);
     if (cached != undefined) {
         return cached;
     }
-    const isValid = Info.isValidIANAZone(potentialTimezone);
-    ianaValidityCache.set(potentialTimezone, isValid);
+    const isValid = Info.isValidIANAZone(raw);
+    ianaValidityCache.set(raw, isValid);
     return isValid;
 }
 /**
@@ -40,8 +40,25 @@ export function isValidTimezone(potentialTimezone) {
  *
  * @category Assertion
  */
-export function assertValidTimezone(potentialTimezone, userMessage) {
-    if (!isValidTimezone(potentialTimezone)) {
-        throw new AssertionError(`'${potentialTimezone}' is not a valid time zone`, userMessage);
+export function assertValidTimezone(raw, userMessage) {
+    if (!isValidTimezone(raw)) {
+        throw new AssertionError(`'${raw}' is not a valid time zone`, userMessage);
     }
 }
+/**
+ * Asserts that the given input is a valid timezone name and returns it.
+ *
+ * @category Assertion
+ */
+export function assertWrapValidTimezone(raw, userMessage) {
+    assertValidTimezone(raw, userMessage);
+    return raw;
+}
+/**
+ * Checks that the given input is a valid timezone name and returns it when valid.
+ *
+ * @category Assertion
+ */
+export function checkWrapValidTimezone(raw) {
+    return isValidTimezone(raw) ? raw : undefined;
+}

package/dist/timezone/timezone-shape.d.ts

@@ -1,12 +1,13 @@
+import { type Timezone } from './timezones.js';
 /**
  * A shape for a timezone value.
  *
  * Unlike a strict enum check against the typed {@link Timezone} list, this validates at runtime via
  * {@link isValidTimezone} (i.e. any valid IANA zone name). It therefore accepts valid IANA names
  * that aren't in the typed list, such as legacy aliases like `'America/Indianapolis'` that some
- * environments (notably Safari) still report from `Intl`. The static type is `string` so that
- * timezone inputs are not restricted to the {@link Timezone} enum.
+ * environments (notably Safari) still report from `Intl`. The branded {@link Timezone} type allows
+ * timezone inputs that are not restricted to the {@link Timezone} list.
  *
  * @category Shape
  */
-export declare const timezoneShape: (defaultValue?: string | undefined) => import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<string>>;
+export declare const timezoneShape: (defaultValue?: Timezone | undefined) => import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<Timezone>>;

package/dist/timezone/timezone-shape.js

@@ -8,8 +8,8 @@ import { utcTimezone } from './timezones.js';
  * Unlike a strict enum check against the typed {@link Timezone} list, this validates at runtime via
  * {@link isValidTimezone} (i.e. any valid IANA zone name). It therefore accepts valid IANA names
  * that aren't in the typed list, such as legacy aliases like `'America/Indianapolis'` that some
- * environments (notably Safari) still report from `Intl`. The static type is `string` so that
- * timezone inputs are not restricted to the {@link Timezone} enum.
+ * environments (notably Safari) still report from `Intl`. The branded {@link Timezone} type allows
+ * timezone inputs that are not restricted to the {@link Timezone} list.
  *
  * @category Shape
  */

package/dist/timezone/timezones.d.ts

@@ -1,12 +1,25 @@
-import { type ArrayElement } from '@augment-vir/common';
+import { type ArrayElement, type Branded } from '@augment-vir/common';
 import { allTimezoneNames } from './timezone-names.js';
 /**
- * All possible timezone names.
+ * All known timezone names.
  *
  * @category Timezone
  * @see {@link allTimezoneNames}
  */
-export type Timezone = ArrayElement<typeof allTimezoneNames>;
+export type TimezoneName = ArrayElement<typeof allTimezoneNames>;
+/**
+ * A branded string for any timezone
+ *
+ * @category Timezone
+ * @see {@link allTimezoneNames}
+ */
+export type TimezoneString = Branded<string, 'timezone-string'>;
+/**
+ * Any known or unknown timezone.
+ *
+ * @category Timezone
+ */
+export type Timezone = TimezoneString | TimezoneName;
 /**
  * An enum of all possible timezone names.
  *
@@ -14,20 +27,20 @@ export type Timezone = ArrayElement<typeof allTimezoneNames>;
  * @example
  *
  * ```ts
- * import {Timezone} from 'date-vir';
+ * import {TimezoneName} from 'date-vir';
  *
- * Timezone['Africa/Bamako'];
+ * TimezoneName['Africa/Bamako'];
  * ```
  */
-export declare const Timezone: Readonly<{
-    [SpecificTimezoneName in Timezone]: SpecificTimezoneName;
+export declare const TimezoneName: Readonly<{
+    [SpecificTimezoneName in TimezoneName]: SpecificTimezoneName;
 }>;
 /**
  * The timezone of the current user's environment.
  *
  * @category Timezone
  */
-export declare const userTimezone: string;
+export declare const userTimezone: NoInfer<TimezoneString>;
 /**
  * The UTC timezone.
  *

package/dist/timezone/timezones.js

@@ -1,3 +1,4 @@
+import { applyBrand } from '@augment-vir/common';
 import { Settings } from 'luxon';
 import { allTimezoneNames } from './timezone-names.js';
 /**
@@ -7,12 +8,12 @@ import { allTimezoneNames } from './timezone-names.js';
  * @example
  *
  * ```ts
- * import {Timezone} from 'date-vir';
+ * import {TimezoneName} from 'date-vir';
  *
- * Timezone['Africa/Bamako'];
+ * TimezoneName['Africa/Bamako'];
  * ```
  */
-export const Timezone = allTimezoneNames.reduce((accum, timezoneName) => {
+export const TimezoneName = allTimezoneNames.reduce((accum, timezoneName) => {
     accum[timezoneName] = timezoneName;
     return accum;
 }, {});
@@ -21,10 +22,10 @@ export const Timezone = allTimezoneNames.reduce((accum, timezoneName) => {
  *
  * @category Timezone
  */
-export const userTimezone = Settings.defaultZone.name;
+export const userTimezone = applyBrand(Settings.defaultZone.name);
 /**
  * The UTC timezone.
  *
  * @category Timezone
  */
-export const utcTimezone = Timezone.UTC;
+export const utcTimezone = TimezoneName.UTC;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "date-vir",
-    "version": "8.6.4",
+    "version": "9.0.0",
     "description": "Easy and explicit dates and times.",
     "keywords": [
         "date",
@@ -37,7 +37,7 @@
     "dependencies": {
         "@augment-vir/assert": "^32.2.1",
         "@augment-vir/common": "^32.2.1",
-        "@date-vir/duration": "^8.6.4",
+        "@date-vir/duration": "^9.0.0",
         "@types/luxon": "^3.7.3",
         "luxon": "^3.7.2",
         "object-shape-tester": "^6.14.1",