date-vir 3.0.0 → 4.0.1

package/dist/esm/extra-utils/has-date-props.js

@@ -0,0 +1,20 @@
+export function hasDateProps(dateInput, keys) {
+    try {
+        assertHasDateProps(dateInput, keys);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+export function assertHasDateProps(dateInput, keys) {
+    const missingKeys = [];
+    keys.forEach((key) => {
+        if (dateInput[key] == undefined) {
+            missingKeys.push(key);
+        }
+    });
+    if (missingKeys.length) {
+        throw new Error(`Missing required FullDate key(s): ${missingKeys.join(', ')}`);
+    }
+}

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

@@ -1,4 +1,4 @@
-import { toTimestamp } from '../full-date/primitive-conversions';
+import { toTimestamp } from '../formatting/timestamp';
 export function toJsDate(fullDate) {
     return new Date(toTimestamp(fullDate));
 }

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

@@ -1,4 +1,4 @@
+import { UtcIsoString } from '../formatting/string-format-types';
 import { FullDate } from '../full-date/full-date-shape';
-import { UtcIsoString } from '../full-date/string-format-types';
 export declare function getNowInIsoString(): UtcIsoString;
 export declare function getNowInUserTimezone(): FullDate;

package/dist/esm/extra-utils/now.js

@@ -1,5 +1,5 @@
+import { toIsoString } from '../formatting/timestamp';
 import { getNowFullDate } from '../full-date/create-full-date';
-import { toIsoString } from '../full-date/primitive-conversions';
 import { userTimezone, utcTimezone } from '../timezone/timezones';
 export function getNowInIsoString() {
     /**

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

@@ -16,6 +16,6 @@ export declare const zeroTime: Pick<{
     minute: 0;
     second: 0;
     millisecond: 0;
-}, "hour" | "minute" | "second" | "millisecond">;
+}, "millisecond" | "second" | "minute" | "hour">;
 export declare function clearTime(inputFullDate: Readonly<FullDate>): FullDate;
 export declare function clearParts(inputFullDate: Readonly<FullDate>, parts: ReadonlyArray<Exclude<keyof FullDate, 'timezone'>>): FullDate;

package/dist/esm/formatting/formatted-string.d.ts

@@ -0,0 +1,14 @@
+import { PartialAndUndefined } from '@augment-vir/common';
+import { FullDate } from '../full-date/full-date-shape';
+/** Converts the given FullDate into a string in the user's locale, or the given localeOverride. */
+export declare function toLocaleString(fullDate: FullDate, formatOptions?: (Intl.DateTimeFormatOptions & PartialAndUndefined<{
+    locale: string;
+}>) | undefined): string;
+/**
+ * Provides arbitrary date formatting using Luxon. For full details on the options for the format
+ * string input, see https://moment.github.io/luxon/#/formatting?id=table-of-tokens
+ *
+ * You probably should **prefer toLocaleString** so your users see the format they expect. It
+ * already has many formatting options.
+ */
+export declare function toFormattedString(fullDate: FullDate, format: string, localeOverride?: string): string;

package/dist/esm/formatting/formatted-string.js

@@ -0,0 +1,29 @@
+import { toLuxonDateTime } from '../full-date/luxon-date-time-conversion';
+import { userLocale } from '../locales';
+/**
+ * Chromium has a weird behavior where the "NARROW NO-BREAK SPACE" character (code 8239) is used
+ * instead of a space (code 32) before AM/PM.
+ */
+function fixChromiumSpace(original) {
+    return original.replace(new RegExp(String.fromCharCode(8239), 'g'), ' ');
+}
+/** Converts the given FullDate into a string in the user's locale, or the given localeOverride. */
+export function toLocaleString(fullDate, formatOptions) {
+    const localeString = toLuxonDateTime(fullDate).toLocaleString({
+        ...formatOptions,
+    }, {
+        locale: formatOptions?.locale ?? userLocale,
+    });
+    return fixChromiumSpace(localeString);
+}
+/**
+ * Provides arbitrary date formatting using Luxon. For full details on the options for the format
+ * string input, see https://moment.github.io/luxon/#/formatting?id=table-of-tokens
+ *
+ * You probably should **prefer toLocaleString** so your users see the format they expect. It
+ * already has many formatting options.
+ */
+export function toFormattedString(fullDate, format, localeOverride = userLocale) {
+    const formattedString = toLuxonDateTime(fullDate).toFormat(format, { locale: localeOverride });
+    return fixChromiumSpace(formattedString);
+}

package/dist/esm/{full-date/primitive-conversions.d.ts → formatting/html-input.d.ts}

@@ -1,22 +1,5 @@
-import { PartialAndUndefined } from '@augment-vir/common';
-import { FullDate, FullDatePartEnum, OnlyDatePart, OnlyHourMinutePart, OnlyHourMinuteSecondPart } from './full-date-shape';
-import { DateTimeString, DateTimeWithSeconds, JustDateString, JustTimeString, JustTimeWithSecondsString, UtcIsoString } from './string-format-types';
-/** Convert a FullDate into a unix timestamp with milliseconds. */
-export declare function toTimestamp(fullDate: FullDate): number;
-/** Convert a FullDate into an ISO string in UTC; always ends in Z. */
-export declare function toIsoString(fullDate: FullDate): UtcIsoString;
-/** Converts the given FullDate into a string in the user's locale, or the given localeOverride. */
-export declare function toLocaleString(fullDate: FullDate, formatOptions?: (Intl.DateTimeFormatOptions & PartialAndUndefined<{
-    locale: string;
-}>) | undefined): string;
-/**
- * Provides arbitrary date formatting using Luxon. For full details on the options for the format
- * string input, see https://moment.github.io/luxon/#/formatting?id=table-of-tokens
- *
- * You probably should **prefer toLocaleString** so your users see the format they expect. It
- * already has many formatting options.
- */
-export declare function toFormattedString(fullDate: FullDate, format: string, localeOverride?: string): string;
+import { FullDate, FullDatePartEnum, OnlyDatePart, OnlyHourMinutePart, OnlyHourMinuteSecondPart } from '../full-date/full-date-shape';
+import { DateTimeString, DateTimeWithSeconds, JustDateString, JustTimeString, JustTimeWithSecondsString } from './string-format-types';
 /**
  * Converts a FullDate object into a string that is understood by type="date" or type="time"
  * HTMLInputElement instances. Can optionally include seconds as well for type="time".

package/dist/esm/formatting/html-input.js

@@ -0,0 +1,33 @@
+import { getEnumTypedValues } from '@augment-vir/common';
+import { assertHasDateProps } from '../extra-utils/has-date-props';
+import { FullDatePartEnum, } from '../full-date/full-date-shape';
+import { toSimpleDatePartString, toSimpleTimePartString } from './simple-strings';
+export function toHtmlInputString(fullDate, inputType, includeSeconds) {
+    const internalFullDate = fullDate;
+    if (inputType === FullDatePartEnum.Date) {
+        assertHasDateProps(internalFullDate, [
+            'year',
+            'month',
+            'day',
+        ]);
+        return toSimpleDatePartString(internalFullDate);
+    }
+    else if (inputType === FullDatePartEnum.Time) {
+        if (includeSeconds && internalFullDate.second == undefined) {
+            throw new Error('Tried to include seconds in the time string but no seconds were provided.');
+        }
+        assertHasDateProps(internalFullDate, [
+            'hour',
+            'minute',
+        ]);
+        return toSimpleTimePartString(internalFullDate, !!includeSeconds);
+    }
+    else if (inputType === FullDatePartEnum.DateTime) {
+        const datePart = toHtmlInputString(fullDate, FullDatePartEnum.Date);
+        const timePart = toHtmlInputString(fullDate, FullDatePartEnum.Time, includeSeconds);
+        return `${datePart}T${timePart}`;
+    }
+    else {
+        throw new Error(`Unexpected inputTyped: '${inputType}'. Expected usage of FullDatePartEnum or one of ${getEnumTypedValues(FullDatePartEnum).join(', ')}.`);
+    }
+}

package/dist/esm/formatting/relative-string.d.ts

@@ -0,0 +1,25 @@
+import { PartialAndUndefined } from '@augment-vir/common';
+import { DurationUnit } from '../duration';
+import { FullDate } from '../full-date/full-date-shape';
+export type RelativeStringOptions = {
+    /**
+     * The relative units that the relative string function is not allowed to use. By default, all
+     * units are allowed. Thus, you can use this to selectively disable some of them.
+     */
+    blockedRelativeUnits: ReadonlyArray<DurationUnit>;
+    /**
+     * The number of digits to round the relative number value to. Defaults to 0, meaning there will
+     * be no decimal digits.
+     *
+     * Example output: {decimalDigitCount: 4} can result in values like 5.6789 whereas
+     * {decimalDigitCount: 0} will result in values like 6.
+     */
+    decimalDigitCount: number;
+    /** Set this to true to block the 'just now' relative string. By default, that string is allowed. */
+    blockJustNow: true;
+};
+export declare function toRelativeString({ fullDate, relativeTo, options, }: {
+    fullDate: Readonly<FullDate>;
+    relativeTo: Readonly<FullDate>;
+    options?: PartialAndUndefined<RelativeStringOptions>;
+}): string | undefined;

package/dist/esm/formatting/relative-string.js

@@ -0,0 +1,49 @@
+import { mapObjectValues, round } from '@augment-vir/common';
+import { diffDatesAllUnits } from '../date-operations/diff-dates';
+import { DurationUnit, orderedDurationUnits, singularDurationUnitNames } from '../duration';
+export function toRelativeString({ fullDate, relativeTo, options = {}, }) {
+    const roundingDigits = options.decimalDigitCount || 0;
+    const allUnitDiffs = diffDatesAllUnits({
+        start: fullDate,
+        end: relativeTo,
+    });
+    const unitsWithinBounds = mapObjectValues(allUnitDiffs, (durationUnit, duration) => {
+        const isAboveZero = Math.floor(Math.abs(round({ digits: 1, number: duration }))) > 0;
+        return isAboveZero;
+    });
+    const unitToUse = orderedDurationUnits.reduce((chosenUnit, currentUnit) => {
+        const isUnitAllowed = !options.blockedRelativeUnits?.includes(currentUnit);
+        if (isUnitAllowed && unitsWithinBounds[currentUnit]) {
+            return currentUnit;
+        }
+        else {
+            return chosenUnit;
+        }
+    }, undefined);
+    const shouldUseJustNow = options.blockJustNow
+        ? false
+        : (unitToUse === DurationUnit.Minutes && allUnitDiffs.minutes < 2) ||
+            (unitToUse === DurationUnit.Seconds && allUnitDiffs.seconds < 11) ||
+            (unitToUse === DurationUnit.Milliseconds && allUnitDiffs.milliseconds < 710);
+    /** Some short circuits. */
+    if (unitToUse == undefined) {
+        return undefined;
+    }
+    else if (shouldUseJustNow) {
+        return 'just now';
+    }
+    const duration = allUnitDiffs[unitToUse];
+    const roundedAbsoluteDuration = Math.abs(round({ digits: roundingDigits, number: duration }));
+    const isDurationSingular = roundedAbsoluteDuration === 1;
+    const unitName = [
+        singularDurationUnitNames[unitToUse],
+        isDurationSingular ? '' : 's',
+    ].join('');
+    const value = isDurationSingular ? 'a' : roundedAbsoluteDuration;
+    if (duration < 0) {
+        return `in ${value} ${unitName}`;
+    }
+    else {
+        return `${value} ${unitName} ago`;
+    }
+}

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

@@ -0,0 +1,71 @@
+import { FullDate } from '../full-date/full-date-shape';
+import { JustDateString, JustTimeString, JustTimeWithSecondsString } from './string-format-types';
+/**
+ * Create a string based on just the date parts of a FullDate.
+ *
+ * CAUTION: this does not user locale setting and should therefore not be used for user-facing date
+ * formatting. Prefer using `toLocaleString` instead for user-facing strings.
+ *
+ * Example output: `'2023-12-05'`
+ */
+export declare function toSimpleDatePartString(fullDate: Pick<FullDate, 'year' | 'month' | 'day'>): JustDateString;
+/**
+ * Creates a string based on just the time parts of a FullDate.
+ *
+ * CAUTION: this does not user locale setting and should therefore not be used for user-facing date
+ * formatting. Prefer using `toLocaleString` instead for user-facing strings.
+ *
+ * Example output: `'05:32:21'`
+ */
+export declare function toSimpleTimePartString(fullDate: Pick<FullDate, 'hour' | 'minute' | 'second'>, includeSeconds: true): JustTimeWithSecondsString;
+export declare function toSimpleTimePartString(fullDate: Pick<FullDate, 'hour' | 'minute'>, includeSeconds: false): JustTimeString;
+export declare function toSimpleTimePartString(fullDate: Pick<FullDate, 'hour' | 'minute' | 'second'> | Pick<FullDate, 'hour' | 'minute'>, includeSeconds: boolean): JustTimeWithSecondsString | JustTimeString;
+export type FullDateForParts = Omit<FullDate, 'millisecond'>;
+/**
+ * Splits a FullDate up into multiple formatted string representations.
+ *
+ * CAUTION: this does not user locale setting and should therefore not be used for user-facing date
+ * formatting. Prefer using `toLocaleString` instead for user-facing strings.
+ *
+ * This does not expand month names into the full names, it just uses numbers for everything. The
+ * output of this will look like:
+ *
+ * ```typescript
+ * {
+ *     "date": "2012-12-05",
+ *     "time": "05:32:21",
+ *     "timezone": "UTC"
+ * }
+ * ```
+ */
+export declare function toSimplePartStrings(fullDate: FullDateForParts, options: {
+    includeSeconds: true;
+}): {
+    date: JustDateString;
+    time: JustTimeWithSecondsString;
+    timezone: string;
+};
+export declare function toSimplePartStrings(fullDate: FullDateForParts, options: {
+    includeSeconds: false;
+}): {
+    date: JustDateString;
+    time: JustTimeString;
+    timezone: string;
+};
+export declare function toSimplePartStrings(fullDate: FullDateForParts, options: {
+    includeSeconds: boolean;
+}): {
+    date: JustDateString;
+    time: JustTimeWithSecondsString | JustTimeString;
+    timezone: string;
+};
+/**
+ * Converts a date into a simple, unambiguous date string.
+ *
+ * CAUTION: this does not user locale setting and should therefore not be used for user-facing date
+ * formatting. Prefer using `toLocaleString` instead for user-facing strings.
+ */
+export declare function toSimpleString(fullDate: FullDateForParts, options: {
+    includeSeconds: boolean;
+    includeTimezone: boolean;
+}): string;

package/dist/esm/formatting/simple-strings.js

@@ -0,0 +1,51 @@
+import { isTruthy, typedHasProperty } from '@augment-vir/common';
+/**
+ * Create a string based on just the date parts of a FullDate.
+ *
+ * CAUTION: this does not user locale setting and should therefore not be used for user-facing date
+ * formatting. Prefer using `toLocaleString` instead for user-facing strings.
+ *
+ * Example output: `'2023-12-05'`
+ */
+export function toSimpleDatePartString(fullDate) {
+    const dateParts = [
+        String(Math.abs(fullDate.year)).padStart(4, '0'),
+        String(Math.abs(fullDate.month)).padStart(2, '0'),
+        String(Math.abs(fullDate.day)).padStart(2, '0'),
+    ];
+    const dateString = dateParts.join('-');
+    return dateString;
+}
+export function toSimpleTimePartString(fullDate, includeSeconds) {
+    const seconds = typedHasProperty(fullDate, 'second') && includeSeconds
+        ? String(Math.abs(fullDate.second)).padStart(2, '0')
+        : undefined;
+    const timeParts = [
+        String(Math.abs(fullDate.hour)).padStart(2, '0'),
+        String(Math.abs(fullDate.minute)).padStart(2, '0'),
+        seconds,
+    ].filter(isTruthy);
+    return timeParts.join(':');
+}
+export function toSimplePartStrings(fullDate, options) {
+    return {
+        date: toSimpleDatePartString(fullDate),
+        time: toSimpleTimePartString(fullDate, options.includeSeconds),
+        timezone: fullDate.timezone,
+    };
+}
+/**
+ * Converts a date into a simple, unambiguous date string.
+ *
+ * CAUTION: this does not user locale setting and should therefore not be used for user-facing date
+ * formatting. Prefer using `toLocaleString` instead for user-facing strings.
+ */
+export function toSimpleString(fullDate, options) {
+    const parts = toSimplePartStrings(fullDate, options);
+    const stringParts = [
+        parts.date,
+        parts.time,
+        options.includeTimezone && `(${parts.timezone})`,
+    ].filter(isTruthy);
+    return stringParts.join(' ');
+}

package/dist/esm/formatting/timestamp.d.ts

@@ -0,0 +1,6 @@
+import { FullDate } from '../full-date/full-date-shape';
+import { UtcIsoString } from './string-format-types';
+/** Convert a FullDate into a unix timestamp with milliseconds. */
+export declare function toTimestamp(fullDate: FullDate): number;
+/** Convert a FullDate into an ISO string in UTC; always ends in Z. */
+export declare function toIsoString(fullDate: FullDate): UtcIsoString;

package/dist/esm/formatting/timestamp.js

@@ -0,0 +1,16 @@
+import { toLuxonDateTime } from '../full-date/luxon-date-time-conversion';
+import { utcTimezone } from '../timezone/timezones';
+/** Convert a FullDate into a unix timestamp with milliseconds. */
+export function toTimestamp(fullDate) {
+    return toLuxonDateTime(fullDate).toMillis();
+}
+/** Convert a FullDate into an ISO string in UTC; always ends in Z. */
+export function toIsoString(fullDate) {
+    const isoString = toLuxonDateTime(fullDate).setZone(utcTimezone).toISO();
+    /** Ignore this edge case in the types and idk how to trigger it. */
+    /* c8 ignore next 3 */
+    if (!isoString) {
+        throw new Error(`Unable to get ISO string for '${JSON.stringify(fullDate)}'`);
+    }
+    return isoString;
+}

package/dist/esm/index.d.ts

@@ -1,12 +1,18 @@
-export * from './augments/type';
 export * from './date-operations/calculate-relative-date';
 export * from './date-operations/combine-dates';
 export * from './date-operations/diff-dates';
 export * from './duration';
 export * from './extra-utils/date-transforms';
+export * from './extra-utils/has-date-props';
 export * from './extra-utils/js-date-conversion';
 export * from './extra-utils/now';
 export * from './extra-utils/zero';
+export * from './formatting/formatted-string';
+export * from './formatting/html-input';
+export * from './formatting/relative-string';
+export * from './formatting/simple-strings';
+export * from './formatting/string-format-types';
+export * from './formatting/timestamp';
 export * from './full-date/create-full-date';
 export * from './full-date/date-like';
 export * from './full-date/format-presets';
@@ -14,8 +20,6 @@ export * from './full-date/full-date-shape';
 export * from './full-date/is-valid-full-date';
 export * from './full-date/luxon-date-time-conversion';
 export * from './full-date/parsing';
-export * from './full-date/primitive-conversions';
-export * from './full-date/string-format-types';
 export * from './locales';
 export * from './timezone/timezone-checks';
 export * from './timezone/timezone-names';

package/dist/esm/index.js

@@ -1,12 +1,18 @@
-export * from './augments/type';
 export * from './date-operations/calculate-relative-date';
 export * from './date-operations/combine-dates';
 export * from './date-operations/diff-dates';
 export * from './duration';
 export * from './extra-utils/date-transforms';
+export * from './extra-utils/has-date-props';
 export * from './extra-utils/js-date-conversion';
 export * from './extra-utils/now';
 export * from './extra-utils/zero';
+export * from './formatting/formatted-string';
+export * from './formatting/html-input';
+export * from './formatting/relative-string';
+export * from './formatting/simple-strings';
+export * from './formatting/string-format-types';
+export * from './formatting/timestamp';
 export * from './full-date/create-full-date';
 export * from './full-date/date-like';
 export * from './full-date/format-presets';
@@ -14,8 +20,6 @@ export * from './full-date/full-date-shape';
 export * from './full-date/is-valid-full-date';
 export * from './full-date/luxon-date-time-conversion';
 export * from './full-date/parsing';
-export * from './full-date/primitive-conversions';
-export * from './full-date/string-format-types';
 export * from './locales';
 export * from './timezone/timezone-checks';
 export * from './timezone/timezone-names';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "date-vir",
-    "version": "3.0.0",
+    "version": "4.0.1",
     "description": "Easy and explicit dates and times",
     "keywords": [
         "date",
@@ -41,41 +41,45 @@
         "test:watch": "web-test-runner --watch --color --config configs/web-test-runner.config.mjs"
     },
     "dependencies": {
-        "@augment-vir/common": "^21.3.6",
-        "@types/luxon": "^3.3.3",
-        "luxon": "^3.4.3",
-        "object-shape-tester": "^1.0.0",
-        "type-fest": "^4.6.0"
+        "@augment-vir/common": "^21.6.0",
+        "@types/luxon": "^3.3.4",
+        "luxon": "^3.4.4",
+        "object-shape-tester": "^1.0.1",
+        "type-fest": "^4.7.1"
     },
     "devDependencies": {
-        "@augment-vir/browser": "^21.3.6",
-        "@augment-vir/browser-testing": "^21.3.6",
-        "@open-wc/testing": "^3.2.0",
-        "@types/chai": "^4.3.9",
-        "@types/mocha": "^10.0.3",
-        "@web/dev-server-esbuild": "^0.4.3",
-        "@web/test-runner": "^0.17.2",
-        "@web/test-runner-commands": "^0.8.2",
-        "@web/test-runner-playwright": "^0.10.2",
-        "@web/test-runner-visual-regression": "^0.8.2",
-        "cspell": "^7.3.8",
-        "dependency-cruiser": "^15.0.0",
-        "element-vir": "^16.5.1",
+        "@augment-vir/browser": "^21.6.0",
+        "@augment-vir/browser-testing": "^21.6.0",
+        "@open-wc/testing": "^4.0.0",
+        "@types/chai": "^4.3.10",
+        "@types/mocha": "^10.0.4",
+        "@web/dev-server-esbuild": "^1.0.0",
+        "@web/test-runner": "^0.18.0",
+        "@web/test-runner-commands": "^0.9.0",
+        "@web/test-runner-playwright": "^0.11.0",
+        "@web/test-runner-visual-regression": "^0.9.0",
+        "cspell": "^8.0.0",
+        "dependency-cruiser": "^15.3.0",
+        "element-vir": "^16.5.2",
         "esbuild": "^0.19.5",
         "istanbul-smart-text-reporter": "^1.1.2",
         "markdown-code-example-inserter": "^0.3.2",
         "npm-check-updates": "~16.12.3",
-        "prettier": "^3.0.3",
+        "prettier": "^3.1.0",
         "prettier-plugin-interpolated-html-tags": "^1.0.2",
         "prettier-plugin-jsdoc": "^1.1.1",
         "prettier-plugin-multiline-arrays": "^3.0.0",
-        "prettier-plugin-organize-imports": "^3.2.3",
+        "prettier-plugin-organize-imports": "^3.2.4",
         "prettier-plugin-packagejson": "^2.4.6",
         "prettier-plugin-sort-json": "^3.1.0",
         "prettier-plugin-toml": "^1.0.0",
         "run-time-assertions": "^0.1.3",
-        "typedoc": "^0.25.2",
+        "typedoc": "^0.25.3",
         "typescript": "^5.2.2",
-        "virmator": "^10.0.0"
+        "virmator": "^11.1.0"
+    },
+    "overrides": {
+        "@open-wc/scoped-elements": "2.2.3",
+        "@open-wc/testing-helpers": "2.3.1"
     }
 }

package/dist/cjs/augments/type.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/full-date/primitive-conversions.js

@@ -1,102 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toHtmlInputString = exports.toFormattedString = exports.toLocaleString = exports.toIsoString = exports.toTimestamp = void 0;
-const common_1 = require("@augment-vir/common");
-const locales_1 = require("../locales");
-const timezones_1 = require("../timezone/timezones");
-const full_date_shape_1 = require("./full-date-shape");
-const luxon_date_time_conversion_1 = require("./luxon-date-time-conversion");
-/** Convert a FullDate into a unix timestamp with milliseconds. */
-function toTimestamp(fullDate) {
-    return (0, luxon_date_time_conversion_1.toLuxonDateTime)(fullDate).toMillis();
-}
-exports.toTimestamp = toTimestamp;
-/** Convert a FullDate into an ISO string in UTC; always ends in Z. */
-function toIsoString(fullDate) {
-    const isoString = (0, luxon_date_time_conversion_1.toLuxonDateTime)(fullDate).setZone(timezones_1.utcTimezone).toISO();
-    /** Ignore this edge case in the types and idk how to trigger it. */
-    /* c8 ignore next 3 */
-    if (!isoString) {
-        throw new Error(`Unable to get ISO string for '${JSON.stringify(fullDate)}'`);
-    }
-    return isoString;
-}
-exports.toIsoString = toIsoString;
-/**
- * Chromium has a weird behavior where the "NARROW NO-BREAK SPACE" character (code 8239) is used
- * instead of a space (code 32) before AM/PM.
- */
-function fixChromiumSpace(original) {
-    return original.replace(new RegExp(String.fromCharCode(8239), 'g'), ' ');
-}
-/** Converts the given FullDate into a string in the user's locale, or the given localeOverride. */
-function toLocaleString(fullDate, formatOptions) {
-    const localeString = (0, luxon_date_time_conversion_1.toLuxonDateTime)(fullDate).toLocaleString({
-        ...formatOptions,
-    }, {
-        locale: formatOptions?.locale ?? locales_1.userLocale,
-    });
-    return fixChromiumSpace(localeString);
-}
-exports.toLocaleString = toLocaleString;
-/**
- * Provides arbitrary date formatting using Luxon. For full details on the options for the format
- * string input, see https://moment.github.io/luxon/#/formatting?id=table-of-tokens
- *
- * You probably should **prefer toLocaleString** so your users see the format they expect. It
- * already has many formatting options.
- */
-function toFormattedString(fullDate, format, localeOverride = locales_1.userLocale) {
-    const formattedString = (0, luxon_date_time_conversion_1.toLuxonDateTime)(fullDate).toFormat(format, { locale: localeOverride });
-    return fixChromiumSpace(formattedString);
-}
-exports.toFormattedString = toFormattedString;
-function toHtmlInputString(fullDate, inputType, includeSeconds) {
-    const internalFullDate = fullDate;
-    if (inputType === full_date_shape_1.FullDatePartEnum.Date) {
-        if (internalFullDate.year == undefined) {
-            throw new Error(`Tried to create date string but no year was provided.`);
-        }
-        if (internalFullDate.month == undefined) {
-            throw new Error(`Tried to create date string but no month was provided.`);
-        }
-        if (internalFullDate.day == undefined) {
-            throw new Error(`Tried to create date string but no day was provided.`);
-        }
-        const dateParts = [
-            String(Math.abs(internalFullDate.year)).padStart(4, '0'),
-            String(Math.abs(internalFullDate.month)).padStart(2, '0'),
-            String(Math.abs(internalFullDate.day)).padStart(2, '0'),
-        ];
-        return dateParts.join('-');
-    }
-    else if (inputType === full_date_shape_1.FullDatePartEnum.Time) {
-        const seconds = includeSeconds
-            ? String(Math.abs(internalFullDate.second ?? 0)).padStart(2, '0')
-            : undefined;
-        if (includeSeconds && internalFullDate.second == undefined) {
-            throw new Error('Tried to include seconds in the time string but no seconds were provided.');
-        }
-        if (internalFullDate.hour == undefined) {
-            throw new Error(`Tried to create time string but no hour was provided.`);
-        }
-        if (internalFullDate.minute == undefined) {
-            throw new Error(`Tried to create time string but no minutes were provided.`);
-        }
-        const timeParts = [
-            String(Math.abs(internalFullDate.hour)).padStart(2, '0'),
-            String(Math.abs(internalFullDate.minute)).padStart(2, '0'),
-            seconds,
-        ].filter((entry) => entry != undefined);
-        return timeParts.join(':');
-    }
-    else if (inputType === full_date_shape_1.FullDatePartEnum.DateTime) {
-        const datePart = toHtmlInputString(fullDate, full_date_shape_1.FullDatePartEnum.Date);
-        const timePart = toHtmlInputString(fullDate, full_date_shape_1.FullDatePartEnum.Time, includeSeconds);
-        return `${datePart}T${timePart}`;
-    }
-    else {
-        throw new Error(`Unexpected inputTyped: '${inputType}'. Expected usage of FullDatePartEnum or one of ${(0, common_1.getEnumTypedValues)(full_date_shape_1.FullDatePartEnum).join(', ')}.`);
-    }
-}
-exports.toHtmlInputString = toHtmlInputString;

package/dist/esm/augments/type.d.ts

@@ -1,2 +0,0 @@
-import { AtLeastTuple } from '@augment-vir/common';
-export type MaybeTuple<T> = T | AtLeastTuple<T, 1>;

package/dist/esm/augments/type.js

@@ -1 +0,0 @@
-export {};