date-vir 5.3.1 → 6.0.1

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export * from './date-operations/calculate-relative-date.js';
+export * from './date-operations/combine-dates.js';
+export * from './date-operations/diff-dates.js';
+export * from './extra-utils/has-date-props.js';
+export * from './extra-utils/js-date-conversion.js';
+export * from './extra-utils/now.js';
+export * from './extra-utils/override-date.js';
+export * from './extra-utils/zero.js';
+export * from './formatting/formatted-string.js';
+export * from './formatting/html-input.js';
+export * from './formatting/relative-string.js';
+export * from './formatting/simple-strings.js';
+export * from './formatting/string-format-types.js';
+export * from './formatting/timestamp.js';
+export * from './full-date/create-full-date.js';
+export * from './full-date/date-like.js';
+export * from './full-date/format-presets.js';
+export * from './full-date/full-date-parts.js';
+export * from './full-date/full-date-shape.js';
+export * from './full-date/is-valid-full-date.js';
+export * from './full-date/luxon-date-time-conversion.js';
+export * from './full-date/parsing.js';
+export * from './locales.js';
+export * from './timezone/timezone-checks.js';
+export * from './timezone/timezone-names.js';
+export * from './timezone/timezones.js';
+export * from '@date-vir/duration';

package/dist/index.js

@@ -0,0 +1,27 @@
+export * from './date-operations/calculate-relative-date.js';
+export * from './date-operations/combine-dates.js';
+export * from './date-operations/diff-dates.js';
+export * from './extra-utils/has-date-props.js';
+export * from './extra-utils/js-date-conversion.js';
+export * from './extra-utils/now.js';
+export * from './extra-utils/override-date.js';
+export * from './extra-utils/zero.js';
+export * from './formatting/formatted-string.js';
+export * from './formatting/html-input.js';
+export * from './formatting/relative-string.js';
+export * from './formatting/simple-strings.js';
+export * from './formatting/string-format-types.js';
+export * from './formatting/timestamp.js';
+export * from './full-date/create-full-date.js';
+export * from './full-date/date-like.js';
+export * from './full-date/format-presets.js';
+export * from './full-date/full-date-parts.js';
+export * from './full-date/full-date-shape.js';
+export * from './full-date/is-valid-full-date.js';
+export * from './full-date/luxon-date-time-conversion.js';
+export * from './full-date/parsing.js';
+export * from './locales.js';
+export * from './timezone/timezone-checks.js';
+export * from './timezone/timezone-names.js';
+export * from './timezone/timezones.js';
+export * from '@date-vir/duration';

package/dist/locales.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The current user's default locale, useful for formatting purposes.
+ *
+ * @category Formatting
+ */
+export declare const userLocale: string;

package/dist/locales.js

@@ -0,0 +1,7 @@
+import { Settings } from 'luxon';
+/**
+ * The current user's default locale, useful for formatting purposes.
+ *
+ * @category Formatting
+ */
+export const userLocale = Settings.defaultLocale;

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

@@ -0,0 +1,21 @@
+import { Timezone } from './timezones.js';
+/**
+ * Asserts that the given input is a valid timezone name.
+ *
+ * Note that this may actually allow names beyond what is currently in the exact {@link Timezone}
+ * type, because this function checks to see if the given timezone can be used to construct a date,
+ * regardless of whether it's in our typed list or not.
+ *
+ * @category Assertion
+ */
+export declare function assertValidTimezone(potentialTimezone: string, userMessage?: string | undefined): asserts potentialTimezone is Timezone;
+/**
+ * Checks that the given timezone is valid.
+ *
+ * Note that this may actually allow names beyond what is currently in the exact {@link Timezone}
+ * type, because this function checks to see if the given timezone can be used to construct a date,
+ * regardless of whether it's in our typed list or not.
+ *
+ * @category Assertion
+ */
+export declare function isValidTimezone(potentialTimezone: string): potentialTimezone is Timezone;

package/dist/timezone/timezone-checks.js

@@ -0,0 +1,34 @@
+import { AssertionError } from '@augment-vir/assert';
+import { Info } from 'luxon';
+/**
+ * Asserts that the given input is a valid timezone name.
+ *
+ * Note that this may actually allow names beyond what is currently in the exact {@link Timezone}
+ * type, because this function checks to see if the given timezone can be used to construct a date,
+ * regardless of whether it's in our typed list or not.
+ *
+ * @category Assertion
+ */
+export function assertValidTimezone(potentialTimezone, userMessage) {
+    if (!Info.isValidIANAZone(potentialTimezone)) {
+        throw new AssertionError(`'${potentialTimezone}' is not a valid time zone`, userMessage);
+    }
+}
+/**
+ * Checks that the given timezone is valid.
+ *
+ * Note that this may actually allow names beyond what is currently in the exact {@link Timezone}
+ * type, because this function checks to see if the given timezone can be used to construct a date,
+ * regardless of whether it's in our typed list or not.
+ *
+ * @category Assertion
+ */
+export function isValidTimezone(potentialTimezone) {
+    try {
+        assertValidTimezone(potentialTimezone);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/{esm/timezone → timezone}/timezone-names.d.ts

@@ -1,9 +1,15 @@
-import { ArrayElement } from '@augment-vir/common';
 /**
- * This list was generated from Firefox 106.0.2 (which gave me the longest list out of all the
- * browsers I had immediately available to me at the time) with the following code:
+ * All valid timezone names.
  *
- * Intl.supportedValuesOf('timeZone').map(zone => `'${zone}'`).join(',')
+ * The list of timezone names was generated from Firefox 106.0.2 (which gave me the longest list out
+ * of all the browsers I had available to me) with the following code:
+ *
+ * ```ts
+ * Intl.supportedValuesOf('timeZone')
+ *     .map((zone) => `'${zone}'`)
+ *     .join(',');
+ * ```
+ *
+ * @category Timezone
  */
 export declare const allTimezoneNames: readonly ["Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", "Africa/Asmara", "Africa/Bamako", "Africa/Bangui", "Africa/Banjul", "Africa/Bissau", "Africa/Blantyre", "Africa/Brazzaville", "Africa/Bujumbura", "Africa/Cairo", "Africa/Casablanca", "Africa/Ceuta", "Africa/Conakry", "Africa/Dakar", "Africa/Dar_es_Salaam", "Africa/Djibouti", "Africa/Douala", "Africa/El_Aaiun", "Africa/Freetown", "Africa/Gaborone", "Africa/Harare", "Africa/Johannesburg", "Africa/Juba", "Africa/Kampala", "Africa/Khartoum", "Africa/Kigali", "Africa/Kinshasa", "Africa/Lagos", "Africa/Libreville", "Africa/Lome", "Africa/Luanda", "Africa/Lubumbashi", "Africa/Lusaka", "Africa/Malabo", "Africa/Maputo", "Africa/Maseru", "Africa/Mbabane", "Africa/Mogadishu", "Africa/Monrovia", "Africa/Nairobi", "Africa/Ndjamena", "Africa/Niamey", "Africa/Nouakchott", "Africa/Ouagadougou", "Africa/Porto-Novo", "Africa/Sao_Tome", "Africa/Timbuktu", "Africa/Tripoli", "Africa/Tunis", "Africa/Windhoek", "America/Adak", "America/Anchorage", "America/Anguilla", "America/Antigua", "America/Araguaina", "America/Argentina/Buenos_Aires", "America/Argentina/Catamarca", "America/Argentina/ComodRivadavia", "America/Argentina/Cordoba", "America/Argentina/Jujuy", "America/Argentina/La_Rioja", "America/Argentina/Mendoza", "America/Argentina/Rio_Gallegos", "America/Argentina/Salta", "America/Argentina/San_Juan", "America/Argentina/San_Luis", "America/Argentina/Tucuman", "America/Argentina/Ushuaia", "America/Aruba", "America/Asuncion", "America/Atikokan", "America/Bahia", "America/Bahia_Banderas", "America/Barbados", "America/Belem", "America/Belize", "America/Blanc-Sablon", "America/Boa_Vista", "America/Bogota", "America/Boise", "America/Cambridge_Bay", "America/Campo_Grande", "America/Cancun", "America/Caracas", "America/Cayenne", "America/Cayman", "America/Chicago", "America/Chihuahua", "America/Coral_Harbour", "America/Costa_Rica", "America/Creston", "America/Cuiaba", "America/Curacao", "America/Danmarkshavn", "America/Dawson", "America/Dawson_Creek", "America/Denver", "America/Detroit", "America/Dominica", "America/Edmonton", "America/Eirunepe", "America/El_Salvador", "America/Ensenada", "America/Fort_Nelson", "America/Fortaleza", "America/Glace_Bay", "America/Goose_Bay", "America/Grand_Turk", "America/Grenada", "America/Guadeloupe", "America/Guatemala", "America/Guayaquil", "America/Guyana", "America/Halifax", "America/Havana", "America/Hermosillo", "America/Indiana/Indianapolis", "America/Indiana/Knox", "America/Indiana/Marengo", "America/Indiana/Petersburg", "America/Indiana/Tell_City", "America/Indiana/Vevay", "America/Indiana/Vincennes", "America/Indiana/Winamac", "America/Inuvik", "America/Iqaluit", "America/Jamaica", "America/Juneau", "America/Kentucky/Louisville", "America/Kentucky/Monticello", "America/La_Paz", "America/Lima", "America/Los_Angeles", "America/Maceio", "America/Managua", "America/Manaus", "America/Martinique", "America/Matamoros", "America/Mazatlan", "America/Menominee", "America/Merida", "America/Metlakatla", "America/Mexico_City", "America/Miquelon", "America/Moncton", "America/Monterrey", "America/Montevideo", "America/Montreal", "America/Montserrat", "America/Nassau", "America/New_York", "America/Nipigon", "America/Nome", "America/Noronha", "America/North_Dakota/Beulah", "America/North_Dakota/Center", "America/North_Dakota/New_Salem", "America/Nuuk", "America/Ojinaga", "America/Panama", "America/Pangnirtung", "America/Paramaribo", "America/Phoenix", "America/Port-au-Prince", "America/Port_of_Spain", "America/Porto_Velho", "America/Puerto_Rico", "America/Punta_Arenas", "America/Rainy_River", "America/Rankin_Inlet", "America/Recife", "America/Regina", "America/Resolute", "America/Rio_Branco", "America/Rosario", "America/Santarem", "America/Santiago", "America/Santo_Domingo", "America/Sao_Paulo", "America/Scoresbysund", "America/Sitka", "America/St_Johns", "America/St_Kitts", "America/St_Lucia", "America/St_Thomas", "America/St_Vincent", "America/Swift_Current", "America/Tegucigalpa", "America/Thule", "America/Thunder_Bay", "America/Tijuana", "America/Toronto", "America/Tortola", "America/Vancouver", "America/Whitehorse", "America/Winnipeg", "America/Yakutat", "America/Yellowknife", "Antarctica/Casey", "Antarctica/Davis", "Antarctica/DumontDUrville", "Antarctica/Macquarie", "Antarctica/Mawson", "Antarctica/McMurdo", "Antarctica/Palmer", "Antarctica/Rothera", "Antarctica/Syowa", "Antarctica/Troll", "Antarctica/Vostok", "Asia/Aden", "Asia/Almaty", "Asia/Amman", "Asia/Anadyr", "Asia/Aqtau", "Asia/Aqtobe", "Asia/Ashgabat", "Asia/Atyrau", "Asia/Baghdad", "Asia/Bahrain", "Asia/Baku", "Asia/Bangkok", "Asia/Barnaul", "Asia/Beirut", "Asia/Bishkek", "Asia/Brunei", "Asia/Chita", "Asia/Choibalsan", "Asia/Chongqing", "Asia/Colombo", "Asia/Damascus", "Asia/Dhaka", "Asia/Dili", "Asia/Dubai", "Asia/Dushanbe", "Asia/Famagusta", "Asia/Gaza", "Asia/Harbin", "Asia/Hebron", "Asia/Ho_Chi_Minh", "Asia/Hong_Kong", "Asia/Hovd", "Asia/Irkutsk", "Asia/Jakarta", "Asia/Jayapura", "Asia/Jerusalem", "Asia/Kabul", "Asia/Kamchatka", "Asia/Karachi", "Asia/Kashgar", "Asia/Kathmandu", "Asia/Khandyga", "Asia/Kolkata", "Asia/Krasnoyarsk", "Asia/Kuala_Lumpur", "Asia/Kuching", "Asia/Kuwait", "Asia/Macau", "Asia/Magadan", "Asia/Makassar", "Asia/Manila", "Asia/Muscat", "Asia/Nicosia", "Asia/Novokuznetsk", "Asia/Novosibirsk", "Asia/Omsk", "Asia/Oral", "Asia/Phnom_Penh", "Asia/Pontianak", "Asia/Pyongyang", "Asia/Qatar", "Asia/Qostanay", "Asia/Qyzylorda", "Asia/Riyadh", "Asia/Sakhalin", "Asia/Samarkand", "Asia/Seoul", "Asia/Shanghai", "Asia/Singapore", "Asia/Srednekolymsk", "Asia/Taipei", "Asia/Tashkent", "Asia/Tbilisi", "Asia/Tehran", "Asia/Tel_Aviv", "Asia/Thimphu", "Asia/Tokyo", "Asia/Tomsk", "Asia/Ulaanbaatar", "Asia/Urumqi", "Asia/Ust-Nera", "Asia/Vientiane", "Asia/Vladivostok", "Asia/Yakutsk", "Asia/Yangon", "Asia/Yekaterinburg", "Asia/Yerevan", "Atlantic/Azores", "Atlantic/Bermuda", "Atlantic/Canary", "Atlantic/Cape_Verde", "Atlantic/Faroe", "Atlantic/Jan_Mayen", "Atlantic/Madeira", "Atlantic/Reykjavik", "Atlantic/South_Georgia", "Atlantic/St_Helena", "Atlantic/Stanley", "Australia/Adelaide", "Australia/Brisbane", "Australia/Broken_Hill", "Australia/Currie", "Australia/Darwin", "Australia/Eucla", "Australia/Hobart", "Australia/Lindeman", "Australia/Lord_Howe", "Australia/Melbourne", "Australia/Perth", "Australia/Sydney", "CET", "CST6CDT", "EET", "EST", "EST5EDT", "Etc/GMT+1", "Etc/GMT+10", "Etc/GMT+11", "Etc/GMT+12", "Etc/GMT+2", "Etc/GMT+3", "Etc/GMT+4", "Etc/GMT+5", "Etc/GMT+6", "Etc/GMT+7", "Etc/GMT+8", "Etc/GMT+9", "Etc/GMT-1", "Etc/GMT-10", "Etc/GMT-11", "Etc/GMT-12", "Etc/GMT-13", "Etc/GMT-14", "Etc/GMT-2", "Etc/GMT-3", "Etc/GMT-4", "Etc/GMT-5", "Etc/GMT-6", "Etc/GMT-7", "Etc/GMT-8", "Etc/GMT-9", "Europe/Amsterdam", "Europe/Andorra", "Europe/Astrakhan", "Europe/Athens", "Europe/Belfast", "Europe/Belgrade", "Europe/Berlin", "Europe/Brussels", "Europe/Bucharest", "Europe/Budapest", "Europe/Chisinau", "Europe/Copenhagen", "Europe/Dublin", "Europe/Gibraltar", "Europe/Guernsey", "Europe/Helsinki", "Europe/Isle_of_Man", "Europe/Istanbul", "Europe/Jersey", "Europe/Kaliningrad", "Europe/Kirov", "Europe/Kyiv", "Europe/Lisbon", "Europe/Ljubljana", "Europe/London", "Europe/Luxembourg", "Europe/Madrid", "Europe/Malta", "Europe/Minsk", "Europe/Monaco", "Europe/Moscow", "Europe/Oslo", "Europe/Paris", "Europe/Prague", "Europe/Riga", "Europe/Rome", "Europe/Samara", "Europe/Sarajevo", "Europe/Saratov", "Europe/Simferopol", "Europe/Skopje", "Europe/Sofia", "Europe/Stockholm", "Europe/Tallinn", "Europe/Tirane", "Europe/Tiraspol", "Europe/Ulyanovsk", "Europe/Uzhgorod", "Europe/Vaduz", "Europe/Vienna", "Europe/Vilnius", "Europe/Volgograd", "Europe/Warsaw", "Europe/Zagreb", "Europe/Zaporozhye", "Europe/Zurich", "Factory", "HST", "Indian/Antananarivo", "Indian/Chagos", "Indian/Christmas", "Indian/Cocos", "Indian/Comoro", "Indian/Kerguelen", "Indian/Mahe", "Indian/Maldives", "Indian/Mauritius", "Indian/Mayotte", "Indian/Reunion", "MET", "MST", "MST7MDT", "PST8PDT", "Pacific/Apia", "Pacific/Auckland", "Pacific/Bougainville", "Pacific/Chatham", "Pacific/Chuuk", "Pacific/Easter", "Pacific/Efate", "Pacific/Enderbury", "Pacific/Fakaofo", "Pacific/Fiji", "Pacific/Funafuti", "Pacific/Galapagos", "Pacific/Gambier", "Pacific/Guadalcanal", "Pacific/Guam", "Pacific/Honolulu", "Pacific/Johnston", "Pacific/Kanton", "Pacific/Kiritimati", "Pacific/Kosrae", "Pacific/Kwajalein", "Pacific/Majuro", "Pacific/Marquesas", "Pacific/Midway", "Pacific/Nauru", "Pacific/Niue", "Pacific/Norfolk", "Pacific/Noumea", "Pacific/Pago_Pago", "Pacific/Palau", "Pacific/Pitcairn", "Pacific/Pohnpei", "Pacific/Port_Moresby", "Pacific/Rarotonga", "Pacific/Saipan", "Pacific/Tahiti", "Pacific/Tarawa", "Pacific/Tongatapu", "Pacific/Wake", "Pacific/Wallis", "UTC", "WET"];
-export type Timezone = ArrayElement<typeof allTimezoneNames>;

package/dist/{esm/timezone → timezone}/timezone-names.js

@@ -1,8 +1,16 @@
 /**
- * This list was generated from Firefox 106.0.2 (which gave me the longest list out of all the
- * browsers I had immediately available to me at the time) with the following code:
+ * All valid timezone names.
  *
- * Intl.supportedValuesOf('timeZone').map(zone => `'${zone}'`).join(',')
+ * The list of timezone names was generated from Firefox 106.0.2 (which gave me the longest list out
+ * of all the browsers I had available to me) with the following code:
+ *
+ * ```ts
+ * Intl.supportedValuesOf('timeZone')
+ *     .map((zone) => `'${zone}'`)
+ *     .join(',');
+ * ```
+ *
+ * @category Timezone
  */
 export const allTimezoneNames = [
     'Africa/Abidjan',

package/dist/timezone/timezones.d.ts

@@ -0,0 +1,42 @@
+import type { ArrayElement } from '@augment-vir/common';
+import { allTimezoneNames } from './timezone-names.js';
+/**
+ * All possible timezone names.
+ *
+ * @category Timezone
+ * @see {@link allTimezoneNames}
+ */
+export type Timezone = ArrayElement<typeof allTimezoneNames>;
+/**
+ * An enum of all possible timezone names.
+ *
+ * @category Timezone
+ * @example
+ *
+ * ```ts
+ * import {Timezone} from 'date-vir';
+ *
+ * Timezone['Africa/Bamako'];
+ * ```
+ */
+export declare const Timezone: Readonly<{
+    [SpecificTimezoneName in Timezone]: SpecificTimezoneName;
+}>;
+/**
+ * The timezone of the current user's environment.
+ *
+ * @category Timezone
+ */
+export declare const userTimezone: Timezone;
+/**
+ * The UTC timezone.
+ *
+ * @category Timezone
+ */
+export declare const utcTimezone: "UTC";
+/**
+ * The UTC timezone as a type.
+ *
+ * @category Timezone
+ */
+export type UtcTimezone = typeof utcTimezone;

package/dist/timezone/timezones.js

@@ -0,0 +1,31 @@
+/* eslint-disable sonarjs/no-redeclare */
+import { Settings } from 'luxon';
+import { allTimezoneNames } from './timezone-names.js';
+/**
+ * An enum of all possible timezone names.
+ *
+ * @category Timezone
+ * @example
+ *
+ * ```ts
+ * import {Timezone} from 'date-vir';
+ *
+ * Timezone['Africa/Bamako'];
+ * ```
+ */
+export const Timezone = allTimezoneNames.reduce((accum, timezoneName) => {
+    accum[timezoneName] = timezoneName;
+    return accum;
+}, {});
+/**
+ * The timezone of the current user's environment.
+ *
+ * @category Timezone
+ */
+export const userTimezone = Settings.defaultZone.name;
+/**
+ * The UTC timezone.
+ *
+ * @category Timezone
+ */
+export const utcTimezone = Timezone.UTC;

package/package.json

@@ -1,10 +1,12 @@
 {
     "name": "date-vir",
-    "version": "5.3.1",
-    "description": "Easy and explicit dates and times",
+    "version": "6.0.1",
+    "description": "Easy and explicit dates and times.",
     "keywords": [
         "date",
+        "duration",
         "time",
+        "util",
         "vir"
     ],
     "homepage": "https://github.com/electrovir/date-vir",
@@ -13,69 +15,49 @@
     },
     "repository": {
         "type": "git",
-        "url": "https://github.com/electrovir/date-vir"
+        "url": "git+https://github.com/electrovir/date-vir.git"
     },
     "license": "(MIT or CC0 1.0)",
     "author": {
         "name": "electrovir",
         "url": "https://github.com/electrovir"
     },
-    "main": "dist/cjs/index.js",
-    "module": "dist/esm/index.js",
-    "types": "dist/esm/index.d.ts",
+    "type": "module",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
     "scripts": {
-        "compile": "rm -rf dist && concurrently --colors --kill-others-on-fail -c auto --names esm,cjs \"tsc --project tsconfig.json\" \"tsc --project tsconfig.cjs.json\"",
-        "docs": "virmator docs --index src/index.ts README.md",
-        "format": "virmator format",
-        "publish": "virmator publish \"npm run compile && npm run test:all\"",
-        "start": "npm install && virmator frontend",
-        "test": "virmator test-web",
-        "test:all": "concurrently --colors --kill-others-on-fail -c auto --names types,tests,spelling,format,docs,deps \"npm run test:types\" \"npm run test:coverage\" \"npm run test:spelling\" \"npm run test:format\" \"npm run test:docs\" \"npm run test:deps\"",
+        "compile": "virmator compile",
+        "docs": "virmator docs",
+        "test": "virmator test web",
         "test:coverage": "npm run test coverage",
-        "test:debug": "web-test-runner --watch --color --config configs/web-test-runner.config.mjs --only-one-browser",
-        "test:deps": "virmator deps check",
-        "test:docs": "virmator docs check --index src/index.ts README.md",
-        "test:format": "virmator format check",
-        "test:spelling": "virmator spellcheck",
-        "test:types": "tsc --noEmit",
-        "test:watch": "web-test-runner --watch --color --config configs/web-test-runner.config.mjs"
+        "test:docs": "virmator docs check"
     },
     "dependencies": {
-        "@augment-vir/common": "^28.0.2",
+        "@augment-vir/assert": "^30.1.0",
+        "@augment-vir/common": "^30.1.0",
+        "@date-vir/duration": "^6.0.0",
         "@types/luxon": "^3.4.2",
-        "luxon": "^3.4.4",
-        "object-shape-tester": "^2.3.2",
-        "type-fest": "^4.18.3"
+        "luxon": "^3.5.0",
+        "object-shape-tester": "^3.0.0",
+        "type-fest": "^4.26.1"
     },
     "devDependencies": {
-        "@augment-vir/browser": "^28.0.2",
-        "@augment-vir/browser-testing": "^28.0.2",
-        "@open-wc/testing": "^4.0.0",
-        "@types/chai": "^4.3.16",
-        "@types/mocha": "^10.0.6",
+        "@augment-vir/test": "^30.1.0",
         "@web/dev-server-esbuild": "^1.0.2",
-        "@web/test-runner": "^0.18.2",
+        "@web/test-runner": "^0.19.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.8.3",
-        "dependency-cruiser": "^16.3.2",
+        "@web/test-runner-visual-regression": "^0.10.0",
         "element-vir": "^22.2.2",
-        "esbuild": "^0.21.4",
         "istanbul-smart-text-reporter": "^1.1.4",
-        "markdown-code-example-inserter": "^1.0.0",
-        "npm-check-updates": "~16.12.3",
-        "prettier": "^3.2.5",
-        "prettier-plugin-interpolated-html-tags": "^1.0.5",
-        "prettier-plugin-jsdoc": "^1.3.0",
-        "prettier-plugin-multiline-arrays": "^3.0.4",
-        "prettier-plugin-organize-imports": "^3.2.4",
-        "prettier-plugin-packagejson": "^2.5.0",
-        "prettier-plugin-sort-json": "^4.0.0",
-        "prettier-plugin-toml": "^2.0.1",
-        "run-time-assertions": "^1.5.1",
-        "typedoc": "^0.25.13",
-        "typescript": "^5.4.5",
-        "virmator": "^11.5.2"
+        "markdown-code-example-inserter": "^3.0.0",
+        "typedoc": "^0.26.7"
+    },
+    "engines": {
+        "node": ">=22"
+    },
+    "publishConfig": {
+        "access": "public"
     }
 }

package/cspell.config.cjs

@@ -1,13 +0,0 @@
-const {baseConfig} = require('virmator/base-configs/base-cspell.js');
-
-module.exports = {
-    ...baseConfig,
-    ignorePaths: [
-        ...baseConfig.ignorePaths,
-    ],
-    words: [
-        ...baseConfig.words,
-        'datetime',
-        'longterm',
-    ],
-};

package/dist/cjs/date-operations/calculate-relative-date.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateRelativeDate = void 0;
-const luxon_date_time_conversion_1 = require("../full-date/luxon-date-time-conversion");
-/**
- * Calculates a new date starting at the given fullDate and adding the given offsets. Offsets can be
- * negative to go backwards in time.
- */
-function calculateRelativeDate(fullDate, offset) {
-    return (0, luxon_date_time_conversion_1.parseLuxonDateTime)((0, luxon_date_time_conversion_1.toLuxonDateTime)(fullDate).plus(offset));
-}
-exports.calculateRelativeDate = calculateRelativeDate;

package/dist/cjs/date-operations/combine-dates.js

@@ -1,50 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.combineDateParts = void 0;
-const object_shape_tester_1 = require("object-shape-tester");
-const full_date_shape_1 = require("../full-date/full-date-shape");
-/**
- * Combine two parts of a FullDate objects into a filled-in FullDate. Note that the timezones must
- * match for both inputs. If two complete FullDate objects are passed in, only the respective parts
- * of each is used.
- */
-function combineDateParts(maybeDateParts) {
-    const timePart = (0, object_shape_tester_1.isValidShape)(maybeDateParts.time, full_date_shape_1.timePartShape, {
-        allowExtraKeys: true,
-    })
-        ? {
-            hour: maybeDateParts.time.hour,
-            minute: maybeDateParts.time.minute,
-            second: maybeDateParts.time.second,
-            millisecond: maybeDateParts.time.millisecond,
-            timezone: maybeDateParts.time.timezone,
-        }
-        : undefined;
-    const datePart = (0, object_shape_tester_1.isValidShape)(maybeDateParts.date, full_date_shape_1.datePartShape, {
-        allowExtraKeys: true,
-    })
-        ? {
-            year: maybeDateParts.date.year,
-            month: maybeDateParts.date.month,
-            day: maybeDateParts.date.day,
-            timezone: maybeDateParts.date.timezone,
-        }
-        : undefined;
-    if (timePart && datePart) {
-        if (timePart.timezone !== datePart.timezone) {
-            throw new Error(`Time and date parts have mismatching timezones. Got '${timePart.timezone}' and '${datePart.timezone}'.`);
-        }
-        return {
-            ...timePart,
-            ...datePart,
-        };
-    }
-    if (timePart) {
-        return timePart;
-    }
-    if (datePart) {
-        return datePart;
-    }
-    return undefined;
-}
-exports.combineDateParts = combineDateParts;

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

@@ -1,105 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDateAfter = exports.diffDates = exports.DiffType = void 0;
-const common_1 = require("@augment-vir/common");
-const duration_unit_1 = require("../duration/duration-unit");
-const duration_utils_1 = require("../duration/duration-utils");
-const luxon_date_time_conversion_1 = require("../full-date/luxon-date-time-conversion");
-const accuracyPriority = {
-    longterm: 1,
-    casual: 0,
-};
-const conversionAccuracies = {
-    [duration_unit_1.DurationUnit.Years]: 'longterm',
-    [duration_unit_1.DurationUnit.Quarters]: 'longterm',
-    [duration_unit_1.DurationUnit.Months]: 'longterm',
-    [duration_unit_1.DurationUnit.Weeks]: 'casual',
-    [duration_unit_1.DurationUnit.Days]: 'casual',
-    [duration_unit_1.DurationUnit.Hours]: 'casual',
-    [duration_unit_1.DurationUnit.Minutes]: 'casual',
-    [duration_unit_1.DurationUnit.Seconds]: 'casual',
-    [duration_unit_1.DurationUnit.Milliseconds]: 'casual',
-};
-function getHighestPriorityConversionAccuracy(units) {
-    const currentConversionAccuracies = units.map((unit) => conversionAccuracies[unit]);
-    const highestPriorityAccuracy = currentConversionAccuracies.reduce((priorityAccuracy, currentAccuracy) => {
-        if (accuracyPriority[currentAccuracy] > accuracyPriority[priorityAccuracy]) {
-            return currentAccuracy;
-        }
-        else {
-            return priorityAccuracy;
-        }
-    });
-    return highestPriorityAccuracy;
-}
-var DiffType;
-(function (DiffType) {
-    /**
-     * Causes the diffDates function to output the diff split between each unit provided. To get the
-     * full duration, each output unit needs to be added together.
-     */
-    DiffType["AdditiveUnits"] = "additive-units";
-    /**
-     * Causes the diffDates function to output the diff in each unit provided with each unit being
-     * equivalent in value. Meaning, each unit will be the same duration of time converted into that
-     * unit.
-     */
-    DiffType["EquivalentUnits"] = "equivalent-units";
-})(DiffType || (exports.DiffType = DiffType = {}));
-function diffDates({ start, end, units: unitsInput, unit: unitInput, diffType: diffTypeInput, decimalCount, }) {
-    const luxonDateStart = (0, luxon_date_time_conversion_1.toLuxonDateTime)(start);
-    const luxonDateEnd = (0, luxon_date_time_conversion_1.toLuxonDateTime)(end);
-    const units = (unitsInput ?? [unitInput]);
-    const diffType = units.length === 1
-        ? /**
-           * When only one unit is provided, it doesn't matter which diff type we use so lets just use this
-           * one.
-           */
-            DiffType.EquivalentUnits
-        : diffTypeInput;
-    if (!diffType) {
-        throw new Error('Failed to diff dates: no diffType was provided.');
-    }
-    if (diffType === DiffType.AdditiveUnits) {
-        const conversionAccuracy = getHighestPriorityConversionAccuracy(units);
-        const additiveDiff = luxonDateEnd
-            .diff(luxonDateStart, (0, common_1.makeWritable)(units), {
-            conversionAccuracy,
-        })
-            .toObject();
-        return (0, duration_utils_1.roundDuration)(additiveDiff, decimalCount);
-    }
-    else if (diffType === DiffType.EquivalentUnits) {
-        const allUnitDiffEntries = units.map((durationUnit) => {
-            const diff = luxonDateEnd
-                .diff(luxonDateStart, durationUnit, {
-                conversionAccuracy: conversionAccuracies[durationUnit],
-            })
-                .toObject();
-            const duration = diff[durationUnit];
-            /** Ignore this edge case in coverage cause its for type guarding. */
-            /* c8 ignore next 5 */
-            if (duration == undefined) {
-                throw new Error(`Internal date-vir error: failed to find duration for '${durationUnit}'`);
-            }
-            return [
-                durationUnit,
-                duration,
-            ];
-        });
-        const equivalentDiff = (0, common_1.typedObjectFromEntries)(allUnitDiffEntries);
-        return (0, duration_utils_1.roundDuration)(equivalentDiff, decimalCount);
-    }
-    else {
-        throw new Error(`Failed to diff dates: provided diffType is invalid: '${diffType}'`);
-    }
-}
-exports.diffDates = diffDates;
-function isDateAfter({ relativeTo, fullDate, }) {
-    return (diffDates({
-        start: relativeTo,
-        end: fullDate,
-        unit: duration_unit_1.DurationUnit.Milliseconds,
-    }).milliseconds >= 0);
-}
-exports.isDateAfter = isDateAfter;

package/dist/cjs/duration/duration-unit.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.orderedDurationUnits = exports.singularDurationUnitNames = exports.DurationUnit = void 0;
-var DurationUnit;
-(function (DurationUnit) {
-    DurationUnit["Years"] = "years";
-    DurationUnit["Quarters"] = "quarters";
-    DurationUnit["Months"] = "months";
-    DurationUnit["Weeks"] = "weeks";
-    DurationUnit["Days"] = "days";
-    DurationUnit["Hours"] = "hours";
-    DurationUnit["Minutes"] = "minutes";
-    DurationUnit["Seconds"] = "seconds";
-    DurationUnit["Milliseconds"] = "milliseconds";
-})(DurationUnit || (exports.DurationUnit = DurationUnit = {}));
-exports.singularDurationUnitNames = {
-    [DurationUnit.Milliseconds]: 'millisecond',
-    [DurationUnit.Seconds]: 'second',
-    [DurationUnit.Minutes]: 'minute',
-    [DurationUnit.Hours]: 'hour',
-    [DurationUnit.Days]: 'day',
-    [DurationUnit.Weeks]: 'week',
-    [DurationUnit.Months]: 'month',
-    [DurationUnit.Quarters]: 'quarter',
-    [DurationUnit.Years]: 'year',
-};
-/**
- * Array of DurationUnit values: from smallest unit (milliseconds at index 0) to longest unit
- * (years).
- */
-exports.orderedDurationUnits = [
-    DurationUnit.Milliseconds,
-    DurationUnit.Seconds,
-    DurationUnit.Minutes,
-    DurationUnit.Hours,
-    DurationUnit.Days,
-    DurationUnit.Weeks,
-    DurationUnit.Months,
-    DurationUnit.Quarters,
-    DurationUnit.Years,
-];