@design-edito/tools 0.5.2 → 0.5.4

package/agnostic/html/deep-select/index.js

@@ -1,10 +1,12 @@
 import * as Window from '../../misc/crossenv/window/index.js';
 import { deepGetProperty } from '../../objects/deep-get-property/index.js';
+import { isRecord } from '../../objects/is-record/index.js';
 const yieldToMain = async (windowLike) => {
-    const yild = deepGetProperty(windowLike, 'scheduler.yield');
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+    const scheduler = deepGetProperty(windowLike, 'scheduler');
+    const yild = isRecord(scheduler) ? scheduler.yield : undefined;
+    // `scheduler.yield` must run with `scheduler` as its `this` — a detached reference throws "Illegal invocation".
     if (typeof yild === 'function')
-        yild();
+        await yild.call(scheduler);
     else
         await new Promise(resolve => { setTimeout(resolve, 0); });
 };

package/agnostic/html/hyper-json/smart-tags/coalesced/index.d.ts

@@ -5,19 +5,19 @@ export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as call from './call/index.js'
 export * as clone from './clone/index.js'
-export * as equals from './equals/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
+export * as equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
-export * as hjstringify from './hjstringify/index.js'
 export * as hjparse from './hjparse/index.js'
+export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
 export * as initialize from './initialize/index.js'
 export * as join from './join/index.js'
 export * as length from './length/index.js'
-export * as map from './map/index.js'
 export * as negate from './negate/index.js'
+export * as map from './map/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
@@ -26,27 +26,27 @@ export * as print from './print/index.js'
 export * as push from './push/index.js'
 export * as pusheach from './pusheach/index.js'
 export * as recordtoarray from './recordtoarray/index.js'
-export * as removeclass from './removeclass/index.js'
 export * as removeattribute from './removeattribute/index.js'
+export * as removeclass from './removeclass/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
-export * as set from './set/index.js'
 export * as select from './select/index.js'
+export * as set from './set/index.js'
 export * as setattribute from './setattribute/index.js'
+export * as setproperty from './setproperty/index.js'
 export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
 export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
+export * as toboolean from './toboolean/index.js'
 export * as toelement from './toelement/index.js'
-export * as setproperty from './setproperty/index.js'
 export * as toggleclass from './toggleclass/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonull from './tonull/index.js'
-export * as toboolean from './toboolean/index.js'
-export * as toref from './toref/index.js'
+export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
+export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as tonumber from './tonumber/index.js'

package/agnostic/html/hyper-json/smart-tags/coalesced/index.js

@@ -5,19 +5,19 @@ export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as call from './call/index.js'
 export * as clone from './clone/index.js'
-export * as equals from './equals/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
+export * as equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
 export * as getproperties from './getproperties/index.js'
 export * as getproperty from './getproperty/index.js'
-export * as hjstringify from './hjstringify/index.js'
 export * as hjparse from './hjparse/index.js'
+export * as hjstringify from './hjstringify/index.js'
 export * as if from './if/index.js'
 export * as initialize from './initialize/index.js'
 export * as join from './join/index.js'
 export * as length from './length/index.js'
-export * as map from './map/index.js'
 export * as negate from './negate/index.js'
+export * as map from './map/index.js'
 export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
@@ -26,27 +26,27 @@ export * as print from './print/index.js'
 export * as push from './push/index.js'
 export * as pusheach from './pusheach/index.js'
 export * as recordtoarray from './recordtoarray/index.js'
-export * as removeclass from './removeclass/index.js'
 export * as removeattribute from './removeattribute/index.js'
+export * as removeclass from './removeclass/index.js'
 export * as renameproperty from './renameproperty/index.js'
 export * as replace from './replace/index.js'
-export * as set from './set/index.js'
 export * as select from './select/index.js'
+export * as set from './set/index.js'
 export * as setattribute from './setattribute/index.js'
+export * as setproperty from './setproperty/index.js'
 export * as sorton from './sorton/index.js'
 export * as split from './split/index.js'
 export * as spread from './spread/index.js'
 export * as toarray from './toarray/index.js'
+export * as toboolean from './toboolean/index.js'
 export * as toelement from './toelement/index.js'
-export * as setproperty from './setproperty/index.js'
 export * as toggleclass from './toggleclass/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonull from './tonull/index.js'
-export * as toboolean from './toboolean/index.js'
-export * as toref from './toref/index.js'
+export * as tonumber from './tonumber/index.js'
 export * as torecord from './torecord/index.js'
+export * as toref from './toref/index.js'
 export * as tostring from './tostring/index.js'
 export * as totext from './totext/index.js'
 export * as transformselected from './transformselected/index.js'
 export * as trim from './trim/index.js'
-export * as tonumber from './tonumber/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.d.ts

@@ -1,13 +1,13 @@
 export * as any from './any/index.js'
+export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
 export * as element from './element/index.js'
 export * as get from './get/index.js'
 export * as guess from './guess/index.js'
-export * as nodelist from './nodelist/index.js'
 export * as null from './null/index.js'
 export * as number from './number/index.js'
+export * as nodelist from './nodelist/index.js'
 export * as record from './record/index.js'
 export * as ref from './ref/index.js'
-export * as text from './text/index.js'
 export * as string from './string/index.js'
-export * as array from './array/index.js'
+export * as text from './text/index.js'

package/agnostic/html/hyper-json/smart-tags/isolated/index.js

@@ -1,13 +1,13 @@
 export * as any from './any/index.js'
+export * as array from './array/index.js'
 export * as boolean from './boolean/index.js'
 export * as element from './element/index.js'
 export * as get from './get/index.js'
 export * as guess from './guess/index.js'
-export * as nodelist from './nodelist/index.js'
 export * as null from './null/index.js'
 export * as number from './number/index.js'
+export * as nodelist from './nodelist/index.js'
 export * as record from './record/index.js'
 export * as ref from './ref/index.js'
-export * as text from './text/index.js'
 export * as string from './string/index.js'
-export * as array from './array/index.js'
+export * as text from './text/index.js'

package/agnostic/html/index.d.ts

@@ -6,5 +6,5 @@ export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'
-export * as watchSelection from './watch-selection/index.js'
 export * as stringToNodes from './string-to-nodes/index.js'
+export * as watchSelection from './watch-selection/index.js'

package/agnostic/html/index.js

@@ -6,5 +6,5 @@ export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
 export * as selectorToElement from './selector-to-element/index.js'
-export * as watchSelection from './watch-selection/index.js'
 export * as stringToNodes from './string-to-nodes/index.js'
+export * as watchSelection from './watch-selection/index.js'

package/agnostic/index.d.ts

@@ -1,7 +1,6 @@
 export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
-export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
 export * as misc from './misc/index.js'
@@ -10,7 +9,8 @@ export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
-export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
+export * as sanitization from './sanitization/index.js'
 export * as time from './time/index.js'
 export * as typescript from './typescript/index.js'
+export * as css from './css/index.js'

package/agnostic/index.js

@@ -1,7 +1,6 @@
 export * as arrays from './arrays/index.js'
 export * as booleans from './booleans/index.js'
 export * as colors from './colors/index.js'
-export * as css from './css/index.js'
 export * as errors from './errors/index.js'
 export * as html from './html/index.js'
 export * as misc from './misc/index.js'
@@ -10,7 +9,8 @@ export * as objects from './objects/index.js'
 export * as optim from './optim/index.js'
 export * as random from './random/index.js'
 export * as regexps from './regexps/index.js'
-export * as sanitization from './sanitization/index.js'
 export * as strings from './strings/index.js'
+export * as sanitization from './sanitization/index.js'
 export * as time from './time/index.js'
 export * as typescript from './typescript/index.js'
+export * as css from './css/index.js'

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
 export * as assert from './assert/index.js'
-export * as connection from './connection/index.js'
 export * as cast from './cast/index.js'
+export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
 export * as crossenv from './crossenv/index.js'
+export * as dataSize from './data-size/index.js'
+export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as isNullish from './is-nullish/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'
-export * as dataSize from './data-size/index.js'
-export * as isConstructorFunction from './is-constructor-function/index.js'

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
 export * as assert from './assert/index.js'
-export * as connection from './connection/index.js'
 export * as cast from './cast/index.js'
+export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
 export * as crossenv from './crossenv/index.js'
+export * as dataSize from './data-size/index.js'
+export * as isConstructorFunction from './is-constructor-function/index.js'
 export * as isNullish from './is-nullish/index.js'
 export * as logs from './logs/index.js'
 export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
 export * as outcome from './outcome/index.js'
-export * as dataSize from './data-size/index.js'
-export * as isConstructorFunction from './is-constructor-function/index.js'

package/agnostic/misc/logs/index.d.ts

@@ -1,3 +1,3 @@
-export * as logger from './logger/index.js'
 export * as makeTextBlock from './make-text-block/index.js'
 export * as styles from './styles/index.js'
+export * as logger from './logger/index.js'

package/agnostic/misc/logs/index.js

@@ -1,3 +1,3 @@
-export * as logger from './logger/index.js'
 export * as makeTextBlock from './make-text-block/index.js'
 export * as styles from './styles/index.js'
+export * as logger from './logger/index.js'

package/agnostic/numbers/index.d.ts

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
 export * as approximateRational from './approximate-rational/index.js'
 export * as clamp from './clamp/index.js'
+export * as interpolate from './interpolate/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as round from './round/index.js'
-export * as interpolate from './interpolate/index.js'

package/agnostic/numbers/index.js

@@ -1,6 +1,6 @@
 export * as absoluteModulo from './absolute-modulo/index.js'
 export * as approximateRational from './approximate-rational/index.js'
 export * as clamp from './clamp/index.js'
+export * as interpolate from './interpolate/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as round from './round/index.js'
-export * as interpolate from './interpolate/index.js'

package/agnostic/optim/index.d.ts

@@ -1,2 +1,2 @@
-export * as throttleDebounce from './throttle-debounce/index.js'
 export * as memoize from './memoize/index.js'
+export * as throttleDebounce from './throttle-debounce/index.js'

package/agnostic/optim/index.js

@@ -1,2 +1,2 @@
-export * as throttleDebounce from './throttle-debounce/index.js'
 export * as memoize from './memoize/index.js'
+export * as throttleDebounce from './throttle-debounce/index.js'

package/agnostic/strings/index.d.ts

@@ -1,8 +1,8 @@
-export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
+export * as charCodes from './char-codes/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
 export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
-export * as toAlphanum from './to-alphanum/index.js'
 export * as splitTrim from './split-trim/index.js'
+export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'

package/agnostic/strings/index.js

@@ -1,8 +1,8 @@
-export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
+export * as charCodes from './char-codes/index.js'
 export * as normalizeIndent from './normalize-indent/index.js'
 export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
-export * as toAlphanum from './to-alphanum/index.js'
 export * as splitTrim from './split-trim/index.js'
+export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'

package/agnostic/time/dates/format-date/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Formats a `Date` object into a string according to a custom template and locale.
+ * Formats a `Date` into a string according to a custom template and locale.
  *
  * Supported tokens (placeholders must be wrapped in `{{...}}`):
  *
@@ -42,7 +42,9 @@
  * @param date - The `Date` object to format.
  * @param format - The template string containing tokens.
  * @param locale - Optional locale code (default: `'en'`).
- * @returns Formatted date string.
+ * @returns Formatted date string. An unknown token is left untouched, braces
+ * included.
+ * @see {@link getDateParts} to reach the same parts as plain values, unpadded.
  *
  * @example
  * formatDate(new Date(2026, 0, 1, 15, 5), '{{YYYY}}-{{MM}}-{{DD}} {{hh}}:{{mm}} {{A}}')

package/agnostic/time/dates/format-date/index.js

@@ -1,5 +1,42 @@
+import { getDateParts } from './parts.js';
+// Alternation is ordered, and the first branch that fits wins — so the longest
+// tokens come first. `MM` ahead of `MMMM` would only work by backtracking off the
+// closing braces, which is true but not something a reader should have to derive.
+const tokenRegexp = /\{\{(MMMM|YYYY|MMM|DD|dd|MM|YY|HH|hh|mm|ss|th|ms|D|d|M|H|h|m|s|A|a)\}\}/gv;
+function pad(value, length) {
+    return `${value}`.padStart(length, '0');
+}
+/**
+ * How each token renders the parts it reads. This is where padding and
+ * truncation live — {@link getDateParts} hands over plain quantities, and the
+ * padded tokens are the same quantity written differently.
+ */
+const renderers = {
+    'D': parts => `${parts.D}`,
+    'DD': parts => pad(parts.D, 2),
+    'd': parts => parts.d,
+    'dd': parts => parts.dd,
+    'M': parts => `${parts.M}`,
+    'MM': parts => pad(parts.M, 2),
+    'MMM': parts => parts.MMM,
+    'MMMM': parts => parts.MMMM,
+    'YY': parts => `${parts.YYYY}`.slice(-2),
+    'YYYY': parts => `${parts.YYYY}`,
+    'H': parts => `${parts.H}`,
+    'HH': parts => pad(parts.H, 2),
+    'h': parts => `${parts.h}`,
+    'hh': parts => pad(parts.h, 2),
+    'm': parts => `${parts.m}`,
+    'mm': parts => pad(parts.m, 2),
+    's': parts => `${parts.s}`,
+    'ss': parts => pad(parts.s, 2),
+    'ms': parts => pad(parts.ms, 3),
+    'A': parts => parts.A,
+    'a': parts => parts.a,
+    'th': parts => parts.th
+};
 /**
- * Formats a `Date` object into a string according to a custom template and locale.
+ * Formats a `Date` into a string according to a custom template and locale.
  *
  * Supported tokens (placeholders must be wrapped in `{{...}}`):
  *
@@ -42,103 +79,15 @@
  * @param date - The `Date` object to format.
  * @param format - The template string containing tokens.
  * @param locale - Optional locale code (default: `'en'`).
- * @returns Formatted date string.
+ * @returns Formatted date string. An unknown token is left untouched, braces
+ * included.
+ * @see {@link getDateParts} to reach the same parts as plain values, unpadded.
  *
  * @example
  * formatDate(new Date(2026, 0, 1, 15, 5), '{{YYYY}}-{{MM}}-{{DD}} {{hh}}:{{mm}} {{A}}')
  * // => "2026-01-01 03:05 PM"
  */
 export function formatDate(date, format, locale = 'en') {
-    if (Intl
-        .DateTimeFormat
-        .supportedLocalesOf(locale).length === 0) {
-        // eslint-disable-next-line no-param-reassign
-        locale = 'en';
-    }
-    const day = date.getDate();
-    const dayOfWeek = date.getDay();
-    const month = date.getMonth();
-    const year = date.getFullYear();
-    const hours = date.getHours();
-    const minutes = date.getMinutes();
-    const seconds = date.getSeconds();
-    const isPM = hours >= 12;
-    const shortDateNames = [...Array(7)].map((_, i) => new Intl.DateTimeFormat(locale, { weekday: 'short' }).format(new Date(2023, 0, i + 1)));
-    const dateNames = [...Array(7)].map((_, i) => new Intl.DateTimeFormat(locale, { weekday: 'long' }).format(new Date(2023, 0, i + 1)));
-    const shortMonthNames = [...Array(12)].map((_, i) => new Intl.DateTimeFormat(locale, { month: 'short' }).format(new Date(2023, i, 1)));
-    const monthNames = [...Array(12)].map((_, i) => new Intl.DateTimeFormat(locale, { month: 'long' }).format(new Date(2023, i, 1)));
-    const replacements = {
-        'DD': () => String(day).padStart(2, '0'),
-        'D': () => String(day),
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        'dd': () => dateNames[dayOfWeek],
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        'd': () => shortDateNames[dayOfWeek],
-        'MM': () => String(month + 1).padStart(2, '0'),
-        'M': () => String(month + 1),
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        'MMMM': () => monthNames[month],
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        'MMM': () => shortMonthNames[month],
-        'YYYY': () => String(year),
-        'YY': () => String(year).slice(-2),
-        'hh': () => String(hours % 12 !== 0 ? hours % 12 : 12).padStart(2, '0'),
-        'h': () => String(hours % 12 !== 0 ? hours % 12 : 12),
-        'HH': () => String(hours).padStart(2, '0'),
-        'H': () => String(hours),
-        'mm': () => String(minutes).padStart(2, '0'),
-        'm': () => String(minutes),
-        'ss': () => String(seconds).padStart(2, '0'),
-        's': () => String(seconds),
-        'ms': () => String(date.getMilliseconds()).padStart(3, '0'),
-        'A': () => (isPM ? 'PM' : 'AM'),
-        'a': () => (isPM ? 'pm' : 'am'),
-        'th': () => {
-            if (locale.startsWith('fr') && day === 1)
-                return 'er';
-            if (locale.startsWith('en')) {
-                const mod10 = day % 10;
-                const mod100 = day % 100;
-                if (mod10 === 1 && mod100 !== 11)
-                    return 'st';
-                if (mod10 === 2 && mod100 !== 12)
-                    return 'nd';
-                if (mod10 === 3 && mod100 !== 13)
-                    return 'rd';
-                return 'th';
-            }
-            return '';
-        }
-    };
-    const regexp = /\{\{(DD|D|dd|d|MM|M|MMMM|MMM|YYYY|YY|HH|H|hh|h|mm|m|ss|s|A|a|th|ms)\}\}/gv;
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    return format.replace(regexp, (match, token) => replacements[token]?.() ?? match);
+    const parts = getDateParts(date, locale);
+    return format.replace(tokenRegexp, (_match, token) => renderers[token](parts));
 }
-// [WIP] this was removed since JavaScript's Date object don't hold timezone data
-// those templates would only reflect the curent client's timezone, no matter what the input Date obj was
-// 'ZZ': () => {
-//   const timezoneOffset = date.getTimezoneOffset()
-//   const offsetHours = Math.floor(Math.abs(timezoneOffset) / 60)
-//   const offsetMinutes = Math.abs(timezoneOffset) % 60
-//   const sign = timezoneOffset > 0 ? '-' : '+'
-//   return `${sign}${String(offsetHours).padStart(2, '0')}:${String(offsetMinutes).padStart(2, '0')}`
-// },
-// 'Z': () => {
-//   const timezoneOffset = date.getTimezoneOffset()
-//   if (timezoneOffset === 0) return 'Z'
-//   const offsetHours = Math.floor(Math.abs(timezoneOffset) / 60)
-//   const offsetMinutes = Math.abs(timezoneOffset) % 60
-//   const sign = timezoneOffset > 0 ? '-' : '+'
-//   return `${sign}${String(offsetHours).padStart(2, '0')}:${String(offsetMinutes).padStart(2, '0')}`
-// },
-// 'z': () => {
-//   return Intl.DateTimeFormat(locale, { timeZoneName: 'short' })
-//     .formatToParts(date)
-//     .find(part => part.type === 'timeZoneName')?.value || ''
-// },
-// 'zz': () => {
-//   return Intl.DateTimeFormat(locale, { timeZoneName: 'long' })
-//     .formatToParts(date)
-//     .find(part => part.type === 'timeZoneName')?.value || ''
-// },
-// 'tz': () => Intl.DateTimeFormat().resolvedOptions().timeZone || ''

package/agnostic/time/dates/format-date/index.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect } from 'vitest';
+import { formatDate } from './index.js';
+import { getDateParts } from './parts.js';
+// Thursday, January 1st 2026, 15:05:09.042 — read in the runtime's own timezone,
+// which is also the one the fixture is built in, so the tests hold anywhere.
+const thursdayAfternoon = new Date(2026, 0, 1, 15, 5, 9, 42);
+describe('formatDate', () => {
+    describe('template', () => {
+        it('fills a template with the parts of the date', () => {
+            expect(formatDate(thursdayAfternoon, '{{YYYY}}-{{MM}}-{{DD}} {{hh}}:{{mm}} {{A}}'))
+                .toBe('2026-01-01 03:05 PM');
+        });
+        it('keeps whatever sits outside the placeholders', () => {
+            expect(formatDate(thursdayAfternoon, 'le {{D}} {{MMMM}} {{YYYY}}', 'fr'))
+                .toBe('le 1 janvier 2026');
+        });
+        it('does not substitute a bare letter outside a placeholder', () => {
+            expect(formatDate(thursdayAfternoon, 'D M Y {{D}}')).toBe('D M Y 1');
+        });
+        it('substitutes every occurrence of a repeated token', () => {
+            expect(formatDate(thursdayAfternoon, '{{D}}/{{D}}')).toBe('1/1');
+        });
+        it('leaves an unknown token untouched, braces included', () => {
+            expect(formatDate(thursdayAfternoon, '{{ZZ}} {{YYYY}}')).toBe('{{ZZ}} 2026');
+        });
+    });
+    describe('padding', () => {
+        it('pads the doubled tokens to two digits', () => {
+            expect(formatDate(thursdayAfternoon, '{{DD}} {{MM}} {{HH}} {{hh}} {{mm}} {{ss}}'))
+                .toBe('01 01 15 03 05 09');
+        });
+        it('leaves the bare twins unpadded', () => {
+            expect(formatDate(thursdayAfternoon, '{{D}} {{M}} {{H}} {{h}} {{m}} {{s}}'))
+                .toBe('1 1 15 3 5 9');
+        });
+        it('pads milliseconds to three digits', () => {
+            expect(formatDate(thursdayAfternoon, '{{ms}}')).toBe('042');
+        });
+        it('truncates YY to the last two digits of the year', () => {
+            expect(formatDate(thursdayAfternoon, '{{YY}}')).toBe('26');
+        });
+    });
+    describe('12-hour clock', () => {
+        it('writes midnight as 12 AM', () => {
+            expect(formatDate(new Date(2026, 0, 1, 0, 30), '{{h}}:{{mm}} {{A}}')).toBe('12:30 AM');
+        });
+        it('writes noon as 12 PM', () => {
+            expect(formatDate(new Date(2026, 0, 1, 12, 30), '{{h}}:{{mm}} {{A}}')).toBe('12:30 PM');
+        });
+        it('starts the afternoon back at 1', () => {
+            expect(formatDate(new Date(2026, 0, 1, 13), '{{h}} {{a}}')).toBe('1 pm');
+        });
+    });
+    describe('locales', () => {
+        it('names the weekday and the month in English by default', () => {
+            expect(formatDate(thursdayAfternoon, '{{dd}} {{d}} {{MMMM}} {{MMM}}'))
+                .toBe('Thursday Thu January Jan');
+        });
+        it('names them in the requested locale', () => {
+            expect(formatDate(thursdayAfternoon, '{{dd}} {{MMMM}}', 'fr')).toBe('jeudi janvier');
+        });
+    });
+    describe('ordinal suffix', () => {
+        it('follows the English rule', () => {
+            const suffix = (day) => formatDate(new Date(2026, 0, day), '{{D}}{{th}}');
+            expect(suffix(1)).toBe('1st');
+            expect(suffix(2)).toBe('2nd');
+            expect(suffix(3)).toBe('3rd');
+            expect(suffix(4)).toBe('4th');
+            expect(suffix(21)).toBe('21st');
+            expect(suffix(22)).toBe('22nd');
+            expect(suffix(23)).toBe('23rd');
+        });
+        it('keeps the teens on th, where the last digit would say otherwise', () => {
+            const suffix = (day) => formatDate(new Date(2026, 0, day), '{{D}}{{th}}');
+            expect(suffix(11)).toBe('11th');
+            expect(suffix(12)).toBe('12th');
+            expect(suffix(13)).toBe('13th');
+        });
+        it('marks only the 1st in French', () => {
+            expect(formatDate(new Date(2026, 0, 1), '{{D}}{{th}}', 'fr')).toBe('1er');
+            expect(formatDate(new Date(2026, 0, 2), '{{D}}{{th}}', 'fr')).toBe('2');
+        });
+    });
+});
+describe('getDateParts', () => {
+    describe('quantities', () => {
+        it('hands over plain numbers, unpadded', () => {
+            expect(getDateParts(thursdayAfternoon)).toMatchObject({
+                D: 1,
+                M: 1,
+                YYYY: 2026,
+                H: 15,
+                h: 3,
+                m: 5,
+                s: 9,
+                ms: 42
+            });
+        });
+        it('numbers the months from 1, where Date numbers them from 0', () => {
+            expect(getDateParts(new Date(2026, 11, 25)).M).toBe(12);
+        });
+        it('reaches every part under its readable name too', () => {
+            const parts = getDateParts(thursdayAfternoon);
+            expect(parts).toMatchObject({
+                dayOfMonth: parts.D,
+                shortWeekdayName: parts.d,
+                fullWeekdayName: parts.dd,
+                monthNumber: parts.M,
+                shortMonthName: parts.MMM,
+                fullMonthName: parts.MMMM,
+                year: parts.YYYY,
+                hours24: parts.H,
+                hours12: parts.h,
+                minutes: parts.m,
+                seconds: parts.s,
+                milliseconds: parts.ms,
+                upperCaseMeridiem: parts.A,
+                lowerCaseMeridiem: parts.a,
+                dayOrdinalSuffix: parts.th
+            });
+        });
+    });
+    describe('12-hour clock', () => {
+        it('reads both midnight and noon as 12', () => {
+            expect(getDateParts(new Date(2026, 0, 1, 0)).h).toBe(12);
+            expect(getDateParts(new Date(2026, 0, 1, 12)).h).toBe(12);
+        });
+        it('splits the meridiem at noon', () => {
+            expect(getDateParts(new Date(2026, 0, 1, 11, 59))).toMatchObject({ A: 'AM', a: 'am' });
+            expect(getDateParts(new Date(2026, 0, 1, 12, 0))).toMatchObject({ A: 'PM', a: 'pm' });
+        });
+    });
+    describe('locales', () => {
+        it('localises the weekday and month names', () => {
+            expect(getDateParts(thursdayAfternoon, 'fr')).toMatchObject({
+                d: 'jeu.',
+                dd: 'jeudi',
+                MMM: 'janv.',
+                MMMM: 'janvier'
+            });
+        });
+        it('falls back to English on a locale the runtime does not support', () => {
+            expect(getDateParts(thursdayAfternoon, 'xx')).toMatchObject({
+                dd: 'Thursday',
+                MMMM: 'January',
+                th: 'st'
+            });
+        });
+        it('leaves the ordinal suffix empty for a locale that has no rule here', () => {
+            expect(getDateParts(thursdayAfternoon, 'es').th).toBe('');
+        });
+    });
+});