@design-edito/tools 0.5.13 → 0.5.15

package/agnostic/colors/index.d.ts

@@ -7,6 +7,6 @@ export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
 export * as luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
-export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
+export * as rotate from './rotate/index.js'
 export * as typechecks from './typechecks/index.js'

package/agnostic/colors/index.js

@@ -7,6 +7,6 @@ export * as invert from './invert/index.js'
 export * as lerp from './lerp/index.js'
 export * as luminance from './luminance/index.js'
 export * as palette from './palette/index.js'
-export * as rotate from './rotate/index.js'
 export * as tidy from './tidy/index.js'
+export * as rotate from './rotate/index.js'
 export * as typechecks from './typechecks/index.js'

package/agnostic/css/index.d.ts

@@ -1,6 +1,6 @@
-export * as bem from './bem/index.js'
 export * as clss from './clss/index.js'
-export * as generateNiceColor from './generate-nice-color/index.js'
+export * as bem from './bem/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
+export * as generateNiceColor from './generate-nice-color/index.js'
 export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'

package/agnostic/css/index.js

@@ -1,6 +1,6 @@
-export * as bem from './bem/index.js'
 export * as clss from './clss/index.js'
-export * as generateNiceColor from './generate-nice-color/index.js'
+export * as bem from './bem/index.js'
 export * as isValidCssClassName from './is-valid-css-class-name/index.js'
+export * as generateNiceColor from './generate-nice-color/index.js'
 export * as scale from './scale/index.js'
 export * as stylesSet from './styles-set/index.js'

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

@@ -1,23 +1,24 @@
-export * as addclass from './addclass/index.js'
 export * as add from './add/index.js'
+export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
+export * as call from './call/index.js'
 export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
-export * as call from './call/index.js'
 export * as equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
-export * as getproperty from './getproperty/index.js'
+export * as getproperties from './getproperties/index.js'
 export * as hjparse from './hjparse/index.js'
 export * as hjstringify from './hjstringify/index.js'
+export * as getproperty from './getproperty/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 getproperties from './getproperties/index.js'
-export * as length from './length/index.js'
 export * as map from './map/index.js'
-export * as initialize from './initialize/index.js'
+export * as length from './length/index.js'
 export * as negate from './negate/index.js'
+export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
 export * as populate from './populate/index.js'
@@ -25,28 +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 notrailing from './notrailing/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 removeclass from './removeclass/index.js'
 export * as select from './select/index.js'
 export * as set from './set/index.js'
-export * as setproperty from './setproperty/index.js'
 export * as setattribute from './setattribute/index.js'
-export * as split from './split/index.js'
 export * as sorton from './sorton/index.js'
-export * as toarray from './toarray/index.js'
+export * as setproperty from './setproperty/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 toggleclass from './toggleclass/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonull from './tonull/index.js'
 export * as tonumber from './tonumber/index.js'
-export * as toref from './toref/index.js'
 export * as torecord from './torecord/index.js'
-export * as tostring from './tostring/index.js'
+export * as toref from './toref/index.js'
 export * as totext from './totext/index.js'
-export * as transformselected from './transformselected/index.js'
+export * as tostring from './tostring/index.js'
 export * as trim from './trim/index.js'
+export * as transformselected from './transformselected/index.js'

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

@@ -1,23 +1,24 @@
-export * as addclass from './addclass/index.js'
 export * as add from './add/index.js'
+export * as addclass from './addclass/index.js'
 export * as and from './and/index.js'
+export * as call from './call/index.js'
 export * as append from './append/index.js'
 export * as at from './at/index.js'
 export * as clone from './clone/index.js'
 export * as deleteproperties from './deleteproperties/index.js'
-export * as call from './call/index.js'
 export * as equals from './equals/index.js'
 export * as getattribute from './getattribute/index.js'
-export * as getproperty from './getproperty/index.js'
+export * as getproperties from './getproperties/index.js'
 export * as hjparse from './hjparse/index.js'
 export * as hjstringify from './hjstringify/index.js'
+export * as getproperty from './getproperty/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 getproperties from './getproperties/index.js'
-export * as length from './length/index.js'
 export * as map from './map/index.js'
-export * as initialize from './initialize/index.js'
+export * as length from './length/index.js'
 export * as negate from './negate/index.js'
+export * as notrailing from './notrailing/index.js'
 export * as or from './or/index.js'
 export * as pickrandom from './pickrandom/index.js'
 export * as populate from './populate/index.js'
@@ -25,28 +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 notrailing from './notrailing/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 removeclass from './removeclass/index.js'
 export * as select from './select/index.js'
 export * as set from './set/index.js'
-export * as setproperty from './setproperty/index.js'
 export * as setattribute from './setattribute/index.js'
-export * as split from './split/index.js'
 export * as sorton from './sorton/index.js'
-export * as toarray from './toarray/index.js'
+export * as setproperty from './setproperty/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 toggleclass from './toggleclass/index.js'
 export * as tonodelist from './tonodelist/index.js'
 export * as tonull from './tonull/index.js'
 export * as tonumber from './tonumber/index.js'
-export * as toref from './toref/index.js'
 export * as torecord from './torecord/index.js'
-export * as tostring from './tostring/index.js'
+export * as toref from './toref/index.js'
 export * as totext from './totext/index.js'
-export * as transformselected from './transformselected/index.js'
+export * as tostring from './tostring/index.js'
 export * as trim from './trim/index.js'
+export * as transformselected from './transformselected/index.js'

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

@@ -1,10 +1,10 @@
-export * as any from './any/index.js'
 export * as array from './array/index.js'
-export * as element from './element/index.js'
 export * as boolean from './boolean/index.js'
+export * as any from './any/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 guess from './guess/index.js'
 export * as null from './null/index.js'
 export * as number from './number/index.js'
 export * as record from './record/index.js'

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

@@ -1,10 +1,10 @@
-export * as any from './any/index.js'
 export * as array from './array/index.js'
-export * as element from './element/index.js'
 export * as boolean from './boolean/index.js'
+export * as any from './any/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 guess from './guess/index.js'
 export * as null from './null/index.js'
 export * as number from './number/index.js'
 export * as record from './record/index.js'

package/agnostic/html/index.d.ts

@@ -4,7 +4,7 @@ export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
-export * as selectorToElement from './selector-to-element/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
-export * as stringToNodes from './string-to-nodes/index.js'
 export * as watchSelection from './watch-selection/index.js'
+export * as stringToNodes from './string-to-nodes/index.js'
+export * as selectorToElement from './selector-to-element/index.js'

package/agnostic/html/index.js

@@ -4,7 +4,7 @@ export * as getPositionInsideParent from './get-position-inside-parent/index.js'
 export * as hyperJson from './hyper-json/index.js'
 export * as insertNode from './insert-node/index.js'
 export * as placeholders from './placeholders/index.js'
-export * as selectorToElement from './selector-to-element/index.js'
 export * as replaceInElement from './replace-in-element/index.js'
-export * as stringToNodes from './string-to-nodes/index.js'
 export * as watchSelection from './watch-selection/index.js'
+export * as stringToNodes from './string-to-nodes/index.js'
+export * as selectorToElement from './selector-to-element/index.js'

package/agnostic/index.d.ts

@@ -1,9 +1,8 @@
-export * as booleans from './booleans/index.js'
 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'
 export * as numbers from './numbers/index.js'
 export * as objects from './objects/index.js'
@@ -11,6 +10,7 @@ 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 html from './html/index.js'
 export * as strings from './strings/index.js'
 export * as subtitles from './subtitles/index.js'
 export * as time from './time/index.js'

package/agnostic/index.js

@@ -1,9 +1,8 @@
-export * as booleans from './booleans/index.js'
 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'
 export * as numbers from './numbers/index.js'
 export * as objects from './objects/index.js'
@@ -11,6 +10,7 @@ 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 html from './html/index.js'
 export * as strings from './strings/index.js'
 export * as subtitles from './subtitles/index.js'
 export * as time from './time/index.js'

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
 export * as assert from './assert/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 connection from './connection/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 isConstructorFunction from './is-constructor-function/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
+export * as loremIpsum from './lorem-ipsum/index.js'
 export * as outcome from './outcome/index.js'

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
 export * as assert from './assert/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 connection from './connection/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 isConstructorFunction from './is-constructor-function/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'
+export * as loremIpsum from './lorem-ipsum/index.js'
 export * as outcome from './outcome/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 approximateRational from './approximate-rational/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as round from './round/index.js'
+export * as interpolate from './interpolate/index.js'
+export * as absoluteModulo from './absolute-modulo/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 approximateRational from './approximate-rational/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
 export * as round from './round/index.js'
+export * as interpolate from './interpolate/index.js'
+export * as absoluteModulo from './absolute-modulo/index.js'

package/agnostic/objects/index.d.ts

@@ -1,9 +1,9 @@
 export * as deepGetProperty from './deep-get-property/index.js'
-export * as flattenGetters from './flatten-getters/index.js'
 export * as enums from './enums/index.js'
-export * as isRecord from './is-record/index.js'
+export * as flattenGetters from './flatten-getters/index.js'
 export * as isObject from './is-object/index.js'
 export * as recordFormat from './record-format/index.js'
-export * as sortKeys from './sort-keys/index.js'
+export * as isRecord from './is-record/index.js'
 export * as recordMap from './record-map/index.js'
+export * as sortKeys from './sort-keys/index.js'
 export * as validation from './validation/index.js'

package/agnostic/objects/index.js

@@ -1,9 +1,9 @@
 export * as deepGetProperty from './deep-get-property/index.js'
-export * as flattenGetters from './flatten-getters/index.js'
 export * as enums from './enums/index.js'
-export * as isRecord from './is-record/index.js'
+export * as flattenGetters from './flatten-getters/index.js'
 export * as isObject from './is-object/index.js'
 export * as recordFormat from './record-format/index.js'
-export * as sortKeys from './sort-keys/index.js'
+export * as isRecord from './is-record/index.js'
 export * as recordMap from './record-map/index.js'
+export * as sortKeys from './sort-keys/index.js'
 export * as validation from './validation/index.js'

package/agnostic/optim/index.d.ts

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

package/agnostic/optim/index.js

@@ -1,2 +1,2 @@
-export * as memoize from './memoize/index.js'
 export * as throttleDebounce from './throttle-debounce/index.js'
+export * as memoize from './memoize/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 normalizeIndent from './normalize-indent/index.js'
+export * as charCodes from './char-codes/index.js'
 export * as parseTable from './parse-table/index.js'
-export * as splitTrim from './split-trim/index.js'
+export * as normalizeIndent from './normalize-indent/index.js'
+export * as replaceAll from './replace-all/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'
-export * as replaceAll from './replace-all/index.js'
+export * as splitTrim from './split-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 normalizeIndent from './normalize-indent/index.js'
+export * as charCodes from './char-codes/index.js'
 export * as parseTable from './parse-table/index.js'
-export * as splitTrim from './split-trim/index.js'
+export * as normalizeIndent from './normalize-indent/index.js'
+export * as replaceAll from './replace-all/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'
-export * as replaceAll from './replace-all/index.js'
+export * as splitTrim from './split-trim/index.js'

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

@@ -4,10 +4,10 @@
  * Supported tokens (placeholders must be wrapped in `{{...}}`):
  *
  * **Day**
- * - `D` : Day of month (1–31)
- * - `DD` : Day of month, padded (01–31)
- * - `d` : Short weekday name (Mon, Tue, ...)
- * - `dd` : Full weekday name (Monday, Tuesday, ...)
+ * - `D` / `d` : Day of month (1–31)
+ * - `DD` / `dd` : Day of month, padded (01–31)
+ * - `ddd` : Short weekday name (Mon, Tue, ...)
+ * - `dddd` : Full weekday name (Monday, Tuesday, ...)
  *
  * **Month**
  * - `M` : Month number (1–12)
@@ -45,6 +45,21 @@
  * @returns Formatted date string. An unknown token is left untouched, braces
  * included.
  * @see {@link getDateParts} to reach the same parts as plain values, unpadded.
+ * @see {@link formatDuration} — the same template grammar, for a length of time
+ * rather than a point in it.
+ *
+ * @remarks
+ * This function and `formatDuration` share one grammar, so a reader who has learnt
+ * either knows the other: tokens are delimited by `{{…}}` and everything outside
+ * them is literal; the bare token is the plain number and the doubled one is that
+ * same number padded to two digits; `ms` is padded to three; and an unknown token
+ * is left as written rather than blanked, so a typo shows.
+ *
+ * No token means two different kinds of thing across the two. What differs is only
+ * what each domain has to offer: a date has a meridiem, an ordinal suffix and a
+ * 12-hour clock (`h`/`hh`, against `H`/`HH` for the 24-hour one), while a duration
+ * has weeks and frames. The weekday names are `ddd`/`dddd`, mirroring `MMM`/`MMMM`
+ * — `d`/`dd` are the day number, as they are in a duration.
  *
  * @example
  * formatDate(new Date(2026, 0, 1, 15, 5), '{{YYYY}}-{{MM}}-{{DD}} {{hh}}:{{mm}} {{A}}')

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

@@ -2,7 +2,7 @@ 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;
+const tokenRegexp = /\{\{(MMMM|YYYY|dddd|MMM|ddd|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');
 }
@@ -14,8 +14,10 @@ function pad(value, length) {
 const renderers = {
     'D': parts => `${parts.D}`,
     'DD': parts => pad(parts.D, 2),
-    'd': parts => parts.d,
-    'dd': parts => parts.dd,
+    'd': parts => `${parts.D}`,
+    'dd': parts => pad(parts.D, 2),
+    'ddd': parts => parts.ddd,
+    'dddd': parts => parts.dddd,
     'M': parts => `${parts.M}`,
     'MM': parts => pad(parts.M, 2),
     'MMM': parts => parts.MMM,
@@ -41,10 +43,10 @@ const renderers = {
  * Supported tokens (placeholders must be wrapped in `{{...}}`):
  *
  * **Day**
- * - `D` : Day of month (1–31)
- * - `DD` : Day of month, padded (01–31)
- * - `d` : Short weekday name (Mon, Tue, ...)
- * - `dd` : Full weekday name (Monday, Tuesday, ...)
+ * - `D` / `d` : Day of month (1–31)
+ * - `DD` / `dd` : Day of month, padded (01–31)
+ * - `ddd` : Short weekday name (Mon, Tue, ...)
+ * - `dddd` : Full weekday name (Monday, Tuesday, ...)
  *
  * **Month**
  * - `M` : Month number (1–12)
@@ -82,6 +84,21 @@ const renderers = {
  * @returns Formatted date string. An unknown token is left untouched, braces
  * included.
  * @see {@link getDateParts} to reach the same parts as plain values, unpadded.
+ * @see {@link formatDuration} — the same template grammar, for a length of time
+ * rather than a point in it.
+ *
+ * @remarks
+ * This function and `formatDuration` share one grammar, so a reader who has learnt
+ * either knows the other: tokens are delimited by `{{…}}` and everything outside
+ * them is literal; the bare token is the plain number and the doubled one is that
+ * same number padded to two digits; `ms` is padded to three; and an unknown token
+ * is left as written rather than blanked, so a typo shows.
+ *
+ * No token means two different kinds of thing across the two. What differs is only
+ * what each domain has to offer: a date has a meridiem, an ordinal suffix and a
+ * 12-hour clock (`h`/`hh`, against `H`/`HH` for the 24-hour one), while a duration
+ * has weeks and frames. The weekday names are `ddd`/`dddd`, mirroring `MMM`/`MMMM`
+ * — `d`/`dd` are the day number, as they are in a duration.
  *
  * @example
  * formatDate(new Date(2026, 0, 1, 15, 5), '{{YYYY}}-{{MM}}-{{DD}} {{hh}}:{{mm}} {{A}}')

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

@@ -53,11 +53,24 @@ describe('formatDate', () => {
     });
     describe('locales', () => {
         it('names the weekday and the month in English by default', () => {
-            expect(formatDate(thursdayAfternoon, '{{dd}} {{d}} {{MMMM}} {{MMM}}'))
+            expect(formatDate(thursdayAfternoon, '{{dddd}} {{ddd}} {{MMMM}} {{MMM}}'))
                 .toBe('Thursday Thu January Jan');
         });
         it('names them in the requested locale', () => {
-            expect(formatDate(thursdayAfternoon, '{{dd}} {{MMMM}}', 'fr')).toBe('jeudi janvier');
+            expect(formatDate(thursdayAfternoon, '{{dddd}} {{MMMM}}', 'fr')).toBe('jeudi janvier');
+        });
+    });
+    describe('day of month', () => {
+        it('reads the day number under d as well as under D', () => {
+            expect(formatDate(thursdayAfternoon, '{{d}} {{D}}')).toBe('1 1');
+            expect(formatDate(thursdayAfternoon, '{{dd}} {{DD}}')).toBe('01 01');
+        });
+        // The whole point of moving the weekday names to `ddd`/`dddd`: `{{d}}` and
+        // `{{dd}}` now read as a number here and in `formatDuration` alike, and the
+        // doubled form is the padded twin of the bare one everywhere.
+        it('does not let the shorter spellings swallow the weekday names', () => {
+            expect(formatDate(thursdayAfternoon, '{{ddd}}')).toBe('Thu');
+            expect(formatDate(thursdayAfternoon, '{{dddd}}')).toBe('Thursday');
         });
     });
     describe('ordinal suffix', () => {
@@ -104,8 +117,8 @@ describe('getDateParts', () => {
             const parts = getDateParts(thursdayAfternoon);
             expect(parts).toMatchObject({
                 dayOfMonth: parts.D,
-                shortWeekdayName: parts.d,
-                fullWeekdayName: parts.dd,
+                shortWeekdayName: parts.ddd,
+                fullWeekdayName: parts.dddd,
                 monthNumber: parts.M,
                 shortMonthName: parts.MMM,
                 fullMonthName: parts.MMMM,
@@ -134,15 +147,15 @@ describe('getDateParts', () => {
     describe('locales', () => {
         it('localises the weekday and month names', () => {
             expect(getDateParts(thursdayAfternoon, 'fr')).toMatchObject({
-                d: 'jeu.',
-                dd: 'jeudi',
+                ddd: 'jeu.',
+                dddd: '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',
+                dddd: 'Thursday',
                 MMMM: 'January',
                 th: 'st'
             });

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

@@ -68,9 +68,9 @@ export function getDateParts(date, locale = 'en') {
     const tokens = {
         'D': day,
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        'd': weekdayNames(safeLocale, 'short')[dayOfWeek],
+        'ddd': weekdayNames(safeLocale, 'short')[dayOfWeek],
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        'dd': weekdayNames(safeLocale, 'long')[dayOfWeek],
+        'dddd': weekdayNames(safeLocale, 'long')[dayOfWeek],
         'M': month + 1,
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         'MMM': monthNames(safeLocale, 'short')[month],
@@ -89,8 +89,8 @@ export function getDateParts(date, locale = 'en') {
     return {
         ...tokens,
         dayOfMonth: tokens.D,
-        shortWeekdayName: tokens.d,
-        fullWeekdayName: tokens.dd,
+        shortWeekdayName: tokens.ddd,
+        fullWeekdayName: tokens.dddd,
         monthNumber: tokens.M,
         shortMonthName: tokens.MMM,
         fullMonthName: tokens.MMMM,

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

@@ -1,21 +1,21 @@
 /** Every token `formatDate` substitutes in a template. */
-export type DateToken = 'D' | 'DD' | 'd' | 'dd' | 'M' | 'MM' | 'MMM' | 'MMMM' | 'YY' | 'YYYY' | 'H' | 'HH' | 'h' | 'hh' | 'm' | 'mm' | 's' | 'ss' | 'ms' | 'A' | 'a' | 'th';
+export type DateToken = 'D' | 'DD' | 'd' | 'dd' | 'ddd' | 'dddd' | 'M' | 'MM' | 'MMM' | 'MMMM' | 'YY' | 'YYYY' | 'H' | 'HH' | 'h' | 'hh' | 'm' | 'mm' | 's' | 'ss' | 'ms' | 'A' | 'a' | 'th';
 /**
  * A date's parts, keyed by unit token.
  *
  * Quantities are **numbers** — a day of month is `1`, not `'01'`. Padding and
  * truncation are rendering concerns and belong to `formatDate`, which is why the
- * `DD`, `MM`, `YY`, `HH`, `hh`, `mm` and `ss` tokens have no entry here: they
- * render the same quantity as their unpadded twin. The parts that are localised
- * text rather than a quantity stay strings.
+ * `d`, `dd`, `DD`, `MM`, `YY`, `HH`, `hh`, `mm` and `ss` tokens have no entry
+ * here: they render the same quantity as the bare token they double. The parts
+ * that are localised text rather than a quantity stay strings.
  */
 export type DateTokenParts = {
-    /** Day of month, 1–31. */
+    /** Day of month, 1–31. Rendered by `D`, `DD`, `d` and `dd` alike. */
     D: number;
     /** Short weekday name, localised. */
-    d: string;
+    ddd: string;
     /** Full weekday name, localised. */
-    dd: string;
+    dddd: string;
     /** Month number, 1–12 — January is `1`, not `0`. */
     M: number;
     /** Short month name, localised. */
@@ -51,9 +51,9 @@ export type DateTokenParts = {
 export type NamedDateParts = {
     /** {@link DateTokenParts.D} */
     dayOfMonth: number;
-    /** {@link DateTokenParts.d} */
+    /** {@link DateTokenParts.ddd} */
     shortWeekdayName: string;
-    /** {@link DateTokenParts.dd} */
+    /** {@link DateTokenParts.dddd} */
     fullWeekdayName: string;
     /** {@link DateTokenParts.M} */
     monthNumber: number;