date-vir 8.6.2 → 8.6.3

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.2",
+    "version": "8.6.3",
     "description": "Easy and explicit dates and times.",
     "keywords": [
         "date",
@@ -22,6 +22,7 @@
         "name": "electrovir",
         "url": "https://github.com/electrovir"
     },
+    "sideEffects": false,
     "type": "module",
     "main": "dist/index.js",
     "module": "dist/index.js",
@@ -34,25 +35,25 @@
         "test:docs": "virmator docs check"
     },
     "dependencies": {
-        "@augment-vir/assert": "^32.0.0",
-        "@augment-vir/common": "^32.0.0",
-        "@date-vir/duration": "^8.6.2",
-        "@types/luxon": "^3.7.2",
+        "@augment-vir/assert": "^32.2.1",
+        "@augment-vir/common": "^32.2.1",
+        "@date-vir/duration": "^8.6.3",
+        "@types/luxon": "^3.7.3",
         "luxon": "^3.7.2",
-        "object-shape-tester": "^6.14.0",
-        "type-fest": "^5.7.0"
+        "object-shape-tester": "^6.14.1",
+        "type-fest": "^5.8.0"
     },
     "devDependencies": {
-        "@augment-vir/test": "^32.0.0",
-        "@web/dev-server-esbuild": "^1.0.5",
-        "@web/test-runner": "^0.20.2",
-        "@web/test-runner-commands": "^0.9.0",
-        "@web/test-runner-playwright": "^0.11.1",
-        "@web/test-runner-visual-regression": "^0.10.0",
-        "element-vir": "^26.17.0",
+        "@augment-vir/test": "^32.2.1",
+        "@web/dev-server-esbuild": "^2.0.0",
+        "@web/test-runner": "^1.0.0",
+        "@web/test-runner-commands": "^1.0.1",
+        "@web/test-runner-playwright": "^1.0.0",
+        "@web/test-runner-visual-regression": "^1.0.1",
+        "element-vir": "^26.17.3",
         "istanbul-smart-text-reporter": "^1.1.5",
         "markdown-code-example-inserter": "^3.0.6",
-        "typedoc": "^0.28.19",
+        "typedoc": "^0.28.20",
         "typescript": "^6.0.3"
     },
     "engines": {